mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_TB_SENSE_1/TOOLCHAIN_IAR/em_assert.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_EFM32LG_STK3600/TARGET_Silicon_Labs/TARGET_EFM32/emlib/inc/em_assert.h@160:5571c4ff569f 
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 156:ff21514d8981 1 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 2 * @file em_assert.h
AnnaBridge 156:ff21514d8981 3 * @brief Emlib peripheral API "assert" implementation.
Anna Bridge 160:5571c4ff569f 4 * @version 5.3.3
AnnaBridge 156:ff21514d8981 5 *******************************************************************************
Anna Bridge 160:5571c4ff569f 6 * # License
AnnaBridge 156:ff21514d8981 7 * <b>Copyright 2016 Silicon Laboratories, Inc. http://www.silabs.com</b>
AnnaBridge 156:ff21514d8981 8 *******************************************************************************
AnnaBridge 156:ff21514d8981 9 *
AnnaBridge 156:ff21514d8981 10 * Permission is granted to anyone to use this software for any purpose,
AnnaBridge 156:ff21514d8981 11 * including commercial applications, and to alter it and redistribute it
AnnaBridge 156:ff21514d8981 12 * freely, subject to the following restrictions:
AnnaBridge 156:ff21514d8981 13 *
AnnaBridge 156:ff21514d8981 14 * 1. The origin of this software must not be misrepresented; you must not
AnnaBridge 156:ff21514d8981 15 * claim that you wrote the original software.
AnnaBridge 156:ff21514d8981 16 * 2. Altered source versions must be plainly marked as such, and must not be
AnnaBridge 156:ff21514d8981 17 * misrepresented as being the original software.
AnnaBridge 156:ff21514d8981 18 * 3. This notice may not be removed or altered from any source distribution.
AnnaBridge 156:ff21514d8981 19 *
AnnaBridge 156:ff21514d8981 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
AnnaBridge 156:ff21514d8981 21 * obligation to support this Software. Silicon Labs is providing the
AnnaBridge 156:ff21514d8981 22 * Software "AS IS", with no express or implied warranties of any kind,
AnnaBridge 156:ff21514d8981 23 * including, but not limited to, any implied warranties of merchantability
AnnaBridge 156:ff21514d8981 24 * or fitness for any particular purpose or warranties against infringement
AnnaBridge 156:ff21514d8981 25 * of any proprietary rights of a third party.
AnnaBridge 156:ff21514d8981 26 *
AnnaBridge 156:ff21514d8981 27 * Silicon Labs will not be liable for any consequential, incidental, or
AnnaBridge 156:ff21514d8981 28 * special damages, or any other relief, or for any claim by any third party,
AnnaBridge 156:ff21514d8981 29 * arising from your use of this Software.
AnnaBridge 156:ff21514d8981 30 *
AnnaBridge 156:ff21514d8981 31 ******************************************************************************/
AnnaBridge 156:ff21514d8981 32
AnnaBridge 156:ff21514d8981 33 #ifndef EM_ASSERT_H
AnnaBridge 156:ff21514d8981 34 #define EM_ASSERT_H
AnnaBridge 156:ff21514d8981 35
AnnaBridge 156:ff21514d8981 36 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 37 extern "C" {
AnnaBridge 156:ff21514d8981 38 #endif
AnnaBridge 156:ff21514d8981 39
AnnaBridge 156:ff21514d8981 40 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 41 * @addtogroup emlib
AnnaBridge 156:ff21514d8981 42 * @{
AnnaBridge 156:ff21514d8981 43 ******************************************************************************/
AnnaBridge 156:ff21514d8981 44
AnnaBridge 156:ff21514d8981 45 #if defined(DOXY_DOC_ONLY)
AnnaBridge 156:ff21514d8981 46 /** @brief Included for documentation purposes only. This define is not present by default.
Anna Bridge 160:5571c4ff569f 47 * @ref DEBUG_EFM should be defined from the compiler to enable the default internal
Anna Bridge 160:5571c4ff569f 48 * assert handler. */
AnnaBridge 156:ff21514d8981 49 #define DEBUG_EFM
AnnaBridge 156:ff21514d8981 50 /** @endcond */
AnnaBridge 156:ff21514d8981 51 #endif
AnnaBridge 156:ff21514d8981 52
AnnaBridge 156:ff21514d8981 53 #if defined(DEBUG_EFM) || defined(DEBUG_EFM_USER)
AnnaBridge 156:ff21514d8981 54 /***************************************************************************//**
AnnaBridge 156:ff21514d8981 55 * @addtogroup ASSERT
AnnaBridge 156:ff21514d8981 56 * @brief Error checking module.
AnnaBridge 156:ff21514d8981 57 * @details
AnnaBridge 156:ff21514d8981 58 * By default, EMLIB library assert usage is not included in order to reduce
AnnaBridge 156:ff21514d8981 59 * footprint and processing overhead. Further, EMLIB assert usage is decoupled
AnnaBridge 156:ff21514d8981 60 * from ISO C assert handling (NDEBUG usage), to allow a user to use ISO C
AnnaBridge 156:ff21514d8981 61 * assert without including EMLIB assert statements.
AnnaBridge 156:ff21514d8981 62 *
AnnaBridge 156:ff21514d8981 63 * Below are available defines for controlling EMLIB assert inclusion. The defines
AnnaBridge 156:ff21514d8981 64 * are typically defined for a project to be used by the preprocessor.
AnnaBridge 156:ff21514d8981 65 *
AnnaBridge 156:ff21514d8981 66 * @li If @ref DEBUG_EFM is defined, the internal EMLIB library assert handling will
AnnaBridge 156:ff21514d8981 67 * be used. This is implemented as a simple while(true) loop. @ref DEBUG_EFM is not
AnnaBridge 156:ff21514d8981 68 * defined by default.
AnnaBridge 156:ff21514d8981 69 *
AnnaBridge 156:ff21514d8981 70 * @li If DEBUG_EFM_USER is defined instead, the user must provide their own
AnnaBridge 156:ff21514d8981 71 * implementation of the assertEFM() function.
AnnaBridge 156:ff21514d8981 72 *
AnnaBridge 156:ff21514d8981 73 * @li If both @ref DEBUG_EFM and DEBUG_EFM_USER are undefined then all EFM_ASSERT()
AnnaBridge 156:ff21514d8981 74 * statements are no operation.
AnnaBridge 156:ff21514d8981 75 *
AnnaBridge 156:ff21514d8981 76 * @note
AnnaBridge 156:ff21514d8981 77 * The internal EMLIB assert is documented here because @ref DEBUG_EFM is defined in
AnnaBridge 156:ff21514d8981 78 * the doxygen configuration.
AnnaBridge 156:ff21514d8981 79 * @{
AnnaBridge 156:ff21514d8981 80 ******************************************************************************/
AnnaBridge 156:ff21514d8981 81 /* Due to footprint considerations, we only pass file name and line number, */
AnnaBridge 156:ff21514d8981 82 /* not the assert expression (nor function name (C99)) */
AnnaBridge 156:ff21514d8981 83 void assertEFM(const char *file, int line);
AnnaBridge 156:ff21514d8981 84 #define EFM_ASSERT(expr) ((expr) ? ((void)0) : assertEFM(__FILE__, __LINE__))
AnnaBridge 156:ff21514d8981 85
AnnaBridge 156:ff21514d8981 86 #else
AnnaBridge 156:ff21514d8981 87
AnnaBridge 156:ff21514d8981 88 /** Default assertion is no operation */
AnnaBridge 156:ff21514d8981 89 #define EFM_ASSERT(expr) ((void)(expr))
AnnaBridge 156:ff21514d8981 90
AnnaBridge 156:ff21514d8981 91 #endif /* defined(DEBUG_EFM) || defined(DEBUG_EFM_USER) */
AnnaBridge 156:ff21514d8981 92
AnnaBridge 156:ff21514d8981 93 /** @} (end addtogroup ASSERT) */
AnnaBridge 156:ff21514d8981 94 /** @} (end addtogroup emlib) */
AnnaBridge 156:ff21514d8981 95
AnnaBridge 156:ff21514d8981 96 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 97 }
AnnaBridge 156:ff21514d8981 98 #endif
AnnaBridge 156:ff21514d8981 99
AnnaBridge 156:ff21514d8981 100 #endif /* EM_ASSERT_H */