Cefn Hoile / nRF51822

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   nrf51-sdk

Dependents:   microbit-dal

Fork of nRF51822 by Lancaster University

nordic-sdk/components/libraries/util/nrf_assert.h@343:6675661fa600, 2015-06-19 (annotated)

Committer:
rgrover1
Date:
Fri Jun 19 15:55:34 2015 +0100
Revision:
343:6675661fa600
Parent:
103:138bdc859cc9
Child:
345:dfde56236c36
Synchronized with git rev 6d1bf116

Author: Rohit Grover

fix #1: update license headers for all sources obtained from nordic-SDK using a new template obtained from Nordic.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 343:6675661fa600 1 /*
rgrover1 343:6675661fa600 2 * Copyright (c) Nordic Semiconductor ASA
rgrover1 343:6675661fa600 3 * All rights reserved.
rgrover1 343:6675661fa600 4 *
rgrover1 343:6675661fa600 5 * Redistribution and use in source and binary forms, with or without modification,
rgrover1 343:6675661fa600 6 * are permitted provided that the following conditions are met:
rgrover1 343:6675661fa600 7 *
rgrover1 343:6675661fa600 8 * 1. Redistributions of source code must retain the above copyright notice, this
rgrover1 343:6675661fa600 9 * list of conditions and the following disclaimer.
rgrover1 343:6675661fa600 10 *
rgrover1 343:6675661fa600 11 * 2. Redistributions in binary form must reproduce the above copyright notice, this
rgrover1 343:6675661fa600 12 * list of conditions and the following disclaimer in the documentation and/or
rgrover1 343:6675661fa600 13 * other materials provided with the distribution.
rgrover1 343:6675661fa600 14 *
rgrover1 343:6675661fa600 15 * 3. Neither the name of Nordic Semiconductor ASA nor the names of other
rgrover1 343:6675661fa600 16 * contributors to this software may be used to endorse or promote products
rgrover1 343:6675661fa600 17 * derived from this software without specific prior written permission.
rgrover1 343:6675661fa600 18 *
rgrover1 343:6675661fa600 19 *
rgrover1 343:6675661fa600 20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
rgrover1 343:6675661fa600 21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
rgrover1 343:6675661fa600 22 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
rgrover1 343:6675661fa600 23 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
rgrover1 343:6675661fa600 24 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
rgrover1 343:6675661fa600 25 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
rgrover1 343:6675661fa600 26 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
rgrover1 343:6675661fa600 27 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
rgrover1 343:6675661fa600 28 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
rgrover1 343:6675661fa600 29 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
rgrover1 343:6675661fa600 30 *
rgrover1 343:6675661fa600 31 */
rgrover1 343:6675661fa600 32
rgrover1 343:6675661fa600 33 /** @file
rgrover1 343:6675661fa600 34 * @brief Utilities for verifying program logic
rgrover1 343:6675661fa600 35 */
rgrover1 343:6675661fa600 36
rgrover1 343:6675661fa600 37 #ifndef NRF_ASSERT_H_
rgrover1 343:6675661fa600 38 #define NRF_ASSERT_H_
rgrover1 343:6675661fa600 39
rgrover1 343:6675661fa600 40 #include <stdint.h>
rgrover1 343:6675661fa600 41 #include "compiler_abstraction.h"
rgrover1 343:6675661fa600 42 #ifdef __cplusplus
rgrover1 343:6675661fa600 43 extern "C" {
rgrover1 343:6675661fa600 44 #endif
rgrover1 343:6675661fa600 45
rgrover1 343:6675661fa600 46 #if defined(DEBUG_NRF) || defined(DEBUG_NRF_USER)
rgrover1 343:6675661fa600 47
rgrover1 343:6675661fa600 48 /** @brief Function for handling assertions.
rgrover1 343:6675661fa600 49 *
rgrover1 343:6675661fa600 50 *
rgrover1 343:6675661fa600 51 * @note
rgrover1 343:6675661fa600 52 * This function is called when an assertion has triggered.
rgrover1 343:6675661fa600 53 *
rgrover1 343:6675661fa600 54 *
rgrover1 343:6675661fa600 55 * @post
rgrover1 343:6675661fa600 56 * All hardware is put into an idle non-emitting state (in particular the radio is highly
rgrover1 343:6675661fa600 57 * important to switch off since the radio might be in a state that makes it send
rgrover1 343:6675661fa600 58 * packets continiously while a typical final infinit ASSERT loop is executing).
rgrover1 343:6675661fa600 59 *
rgrover1 343:6675661fa600 60 *
rgrover1 343:6675661fa600 61 * @param line_num The line number where the assertion is called
rgrover1 343:6675661fa600 62 * @param file_name Pointer to the file name
rgrover1 343:6675661fa600 63 */
rgrover1 343:6675661fa600 64 void assert_nrf_callback(uint16_t line_num, const uint8_t *file_name);
rgrover1 343:6675661fa600 65
rgrover1 343:6675661fa600 66 /*lint -emacro(506, ASSERT) */ /* Suppress "Constant value Boolean */
rgrover1 343:6675661fa600 67 /*lint -emacro(774, ASSERT) */ /* Suppress "Boolean within 'if' always evaluates to True" */ \
rgrover1 343:6675661fa600 68
rgrover1 343:6675661fa600 69 /** @brief Function for checking intended for production code.
rgrover1 343:6675661fa600 70 *
rgrover1 343:6675661fa600 71 * Check passes if "expr" evaluates to true. */
rgrover1 343:6675661fa600 72 #define ASSERT(expr) \
rgrover1 343:6675661fa600 73 if (expr) \
rgrover1 343:6675661fa600 74 { \
rgrover1 343:6675661fa600 75 } \
rgrover1 343:6675661fa600 76 else \
rgrover1 343:6675661fa600 77 { \
rgrover1 343:6675661fa600 78 assert_nrf_callback((uint16_t)__LINE__, (uint8_t *)__FILE__); \
rgrover1 343:6675661fa600 79 }
rgrover1 343:6675661fa600 80 #else
rgrover1 343:6675661fa600 81 #define ASSERT(expr) //!< Assert empty when disabled
rgrover1 343:6675661fa600 82 __WEAK void assert_nrf_callback(uint16_t line_num, const uint8_t *file_name);
rgrover1 343:6675661fa600 83 #endif /* defined(DEBUG_NRF) || defined(DEBUG_NRF_USER) */
rgrover1 343:6675661fa600 84
rgrover1 343:6675661fa600 85 #ifdef __cplusplus
rgrover1 343:6675661fa600 86 }
rgrover1 343:6675661fa600 87 #endif
rgrover1 343:6675661fa600 88
rgrover1 343:6675661fa600 89 #endif /* NRF_ASSERT_H_ */