nRF51 SDK - S120 SoftDevice
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Assert Handler for debug purposes.

Module for handling of assert during application development when debugging. More...

Functions

void ble_debug_assert_handler (uint32_t error_code, uint32_t line_num, const uint8_t *p_file_name)
 Function for handling the Debug assert, which can be called from an error handler. To be used only for debugging purposes. More...
 

Detailed Description

Module for handling of assert during application development when debugging.

This module may be used during development of an application to facilitate debugging. It contains a function to write file name, line number and the Stack Memory to flash. This module is ONLY for debugging purposes and must never be used in final product.

Function Documentation

void ble_debug_assert_handler ( uint32_t  error_code,
uint32_t  line_num,
const uint8_t *  p_file_name 
)

Function for handling the Debug assert, which can be called from an error handler. To be used only for debugging purposes.

This code will copy the filename and line number into local variables for them to always be accessible in Keil debugger. The function will also write the ARM Cortex-M0 stack memory into flash where it can be retrieved and manually un-winded in order to back-trace the location where the error ocured.

Warning
ALL INTERRUPTS WILL BE DISABLED.
Note
This function will never return but loop forever for debug purposes.
Parameters
[in]error_codeError code supplied to the handler.
[in]line_numLine number where the original handler is called.
[in]p_file_namePointer to the file name.