1 /******************************************************************************
2 *  Filename:       debug.h
3 *  Revised:        2017-04-26 18:27:45 +0200 (Wed, 26 Apr 2017)
4 *  Revision:       48852
5 *
6 *  Description:    Macros for assisting debug of the driver library.
7 *
8 *  Copyright (c) 2015 - 2020, Texas Instruments Incorporated
9 *  All rights reserved.
10 *
11 *  Redistribution and use in source and binary forms, with or without
12 *  modification, are permitted provided that the following conditions are met:
13 *
14 *  1) Redistributions of source code must retain the above copyright notice,
15 *     this list of conditions and the following disclaimer.
16 *
17 *  2) Redistributions in binary form must reproduce the above copyright notice,
18 *     this list of conditions and the following disclaimer in the documentation
19 *     and/or other materials provided with the distribution.
20 *
21 *  3) Neither the name of the ORGANIZATION nor the names of its contributors may
22 *     be used to endorse or promote products derived from this software without
23 *     specific prior written permission.
24 *
25 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
26 *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
29 *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 *  POSSIBILITY OF SUCH DAMAGE.
36 *
37 ******************************************************************************/
38 
39 //*****************************************************************************
40 //
41 //! \addtogroup system_control_group
42 //! @{
43 //! \addtogroup debug_api
44 //! @{
45 //
46 //*****************************************************************************
47 
48 #ifndef __DEBUG_H__
49 #define __DEBUG_H__
50 
51 //*****************************************************************************
52 //
53 //! Function stub for allowing compile with DRIVERLIB_DEBUG flag asserted.
54 //
55 //*****************************************************************************
56 extern void __error__(char *pcFilename, uint32_t ui32Line);
57 
58 //*****************************************************************************
59 //
60 // The ASSERT macro, which does the actual assertion checking. Typically, this
61 // will be for procedure arguments.
62 //
63 //*****************************************************************************
64 #ifdef DRIVERLIB_DEBUG
65 #define ASSERT(expr) {                                      \
66                          if(!(expr))                        \
67                          {                                  \
68                              __error__(__FILE__, __LINE__); \
69                          }                                  \
70                      }
71 
72 #else
73 #define ASSERT(expr)
74 #endif
75 
76 #endif // __DEBUG_H__
77 
78 //*****************************************************************************
79 //
80 //! Close the Doxygen group.
81 //! @}
82 //! @}
83 //
84 //*****************************************************************************
85