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