GGTA team / 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.

Fork of nRF51822 by Nordic Semiconductor

nordic-sdk/components/libraries/util/app_error.h@103:138bdc859cc9, 2015-04-15 (annotated)

Committer:
rgrover1
Date:
Wed Apr 15 08:59:11 2015 +0100
Revision:
103:138bdc859cc9
Synchronized with git rev fa183c40

Author: Rohit Grover

updating to v7.1 of the Nordic SDK.

Re-organized file layout to match that from the SDK.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 103:138bdc859cc9 1 /* Copyright (c) 2013 Nordic Semiconductor. All Rights Reserved.
rgrover1 103:138bdc859cc9 2 *
rgrover1 103:138bdc859cc9 3 * The information contained herein is property of Nordic Semiconductor ASA.
rgrover1 103:138bdc859cc9 4 * Terms and conditions of usage are described in detail in NORDIC
rgrover1 103:138bdc859cc9 5 * SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT.
rgrover1 103:138bdc859cc9 6 *
rgrover1 103:138bdc859cc9 7 * Licensees are granted free, non-transferable use of the information. NO
rgrover1 103:138bdc859cc9 8 * WARRANTY of ANY KIND is provided. This heading must NOT be removed from
rgrover1 103:138bdc859cc9 9 * the file.
rgrover1 103:138bdc859cc9 10 *
rgrover1 103:138bdc859cc9 11 */
rgrover1 103:138bdc859cc9 12
rgrover1 103:138bdc859cc9 13 /** @file
rgrover1 103:138bdc859cc9 14 *
rgrover1 103:138bdc859cc9 15 * @defgroup app_error Common application error handler
rgrover1 103:138bdc859cc9 16 * @{
rgrover1 103:138bdc859cc9 17 * @ingroup app_common
rgrover1 103:138bdc859cc9 18 *
rgrover1 103:138bdc859cc9 19 * @brief Common application error handler and macros for utilizing a common error handler.
rgrover1 103:138bdc859cc9 20 */
rgrover1 103:138bdc859cc9 21
rgrover1 103:138bdc859cc9 22 #ifndef APP_ERROR_H__
rgrover1 103:138bdc859cc9 23 #define APP_ERROR_H__
rgrover1 103:138bdc859cc9 24
rgrover1 103:138bdc859cc9 25 #include <stdint.h>
rgrover1 103:138bdc859cc9 26 #include <stdbool.h>
rgrover1 103:138bdc859cc9 27 #include "nrf_error.h"
rgrover1 103:138bdc859cc9 28
rgrover1 103:138bdc859cc9 29 #ifdef __cplusplus
rgrover1 103:138bdc859cc9 30 extern "C" {
rgrover1 103:138bdc859cc9 31 #endif
rgrover1 103:138bdc859cc9 32
rgrover1 103:138bdc859cc9 33 /**@brief Function for error handling, which is called when an error has occurred.
rgrover1 103:138bdc859cc9 34 *
rgrover1 103:138bdc859cc9 35 * @param[in] error_code Error code supplied to the handler.
rgrover1 103:138bdc859cc9 36 * @param[in] line_num Line number where the handler is called.
rgrover1 103:138bdc859cc9 37 * @param[in] p_file_name Pointer to the file name.
rgrover1 103:138bdc859cc9 38 */
rgrover1 103:138bdc859cc9 39 void app_error_handler(uint32_t error_code, uint32_t line_num, const uint8_t * p_file_name);
rgrover1 103:138bdc859cc9 40
rgrover1 103:138bdc859cc9 41 #ifdef __cplusplus
rgrover1 103:138bdc859cc9 42 }
rgrover1 103:138bdc859cc9 43 #endif
rgrover1 103:138bdc859cc9 44
rgrover1 103:138bdc859cc9 45 /**@brief Macro for calling error handler function.
rgrover1 103:138bdc859cc9 46 *
rgrover1 103:138bdc859cc9 47 * @param[in] ERR_CODE Error code supplied to the error handler.
rgrover1 103:138bdc859cc9 48 */
rgrover1 103:138bdc859cc9 49 #ifdef DEBUG
rgrover1 103:138bdc859cc9 50 #define APP_ERROR_HANDLER(ERR_CODE) \
rgrover1 103:138bdc859cc9 51 do \
rgrover1 103:138bdc859cc9 52 { \
rgrover1 103:138bdc859cc9 53 app_error_handler((ERR_CODE), __LINE__, (uint8_t*) __FILE__); \
rgrover1 103:138bdc859cc9 54 } while (0)
rgrover1 103:138bdc859cc9 55 #else
rgrover1 103:138bdc859cc9 56 #define APP_ERROR_HANDLER(ERR_CODE) \
rgrover1 103:138bdc859cc9 57 do \
rgrover1 103:138bdc859cc9 58 { \
rgrover1 103:138bdc859cc9 59 app_error_handler((ERR_CODE), 0, 0); \
rgrover1 103:138bdc859cc9 60 } while (0)
rgrover1 103:138bdc859cc9 61 #endif
rgrover1 103:138bdc859cc9 62 /**@brief Macro for calling error handler function if supplied error code any other than NRF_SUCCESS.
rgrover1 103:138bdc859cc9 63 *
rgrover1 103:138bdc859cc9 64 * @param[in] ERR_CODE Error code supplied to the error handler.
rgrover1 103:138bdc859cc9 65 */
rgrover1 103:138bdc859cc9 66 #define APP_ERROR_CHECK(ERR_CODE) \
rgrover1 103:138bdc859cc9 67 do \
rgrover1 103:138bdc859cc9 68 { \
rgrover1 103:138bdc859cc9 69 const uint32_t LOCAL_ERR_CODE = (ERR_CODE); \
rgrover1 103:138bdc859cc9 70 if (LOCAL_ERR_CODE != NRF_SUCCESS) \
rgrover1 103:138bdc859cc9 71 { \
rgrover1 103:138bdc859cc9 72 APP_ERROR_HANDLER(LOCAL_ERR_CODE); \
rgrover1 103:138bdc859cc9 73 } \
rgrover1 103:138bdc859cc9 74 } while (0)
rgrover1 103:138bdc859cc9 75
rgrover1 103:138bdc859cc9 76 /**@brief Macro for calling error handler function if supplied boolean value is false.
rgrover1 103:138bdc859cc9 77 *
rgrover1 103:138bdc859cc9 78 * @param[in] BOOLEAN_VALUE Boolean value to be evaluated.
rgrover1 103:138bdc859cc9 79 */
rgrover1 103:138bdc859cc9 80 #define APP_ERROR_CHECK_BOOL(BOOLEAN_VALUE) \
rgrover1 103:138bdc859cc9 81 do \
rgrover1 103:138bdc859cc9 82 { \
rgrover1 103:138bdc859cc9 83 const uint32_t LOCAL_BOOLEAN_VALUE = (BOOLEAN_VALUE); \
rgrover1 103:138bdc859cc9 84 if (!LOCAL_BOOLEAN_VALUE) \
rgrover1 103:138bdc859cc9 85 { \
rgrover1 103:138bdc859cc9 86 APP_ERROR_HANDLER(0); \
rgrover1 103:138bdc859cc9 87 } \
rgrover1 103:138bdc859cc9 88 } while (0)
rgrover1 103:138bdc859cc9 89
rgrover1 103:138bdc859cc9 90 #endif // APP_ERROR_H__
rgrover1 103:138bdc859cc9 91
rgrover1 103:138bdc859cc9 92 /** @} */