nRF51 SDK: Assert Handler for debug purposes.

| nRF51 SDK

- Home
- Related Pages
- API Reference
- Data Structures

All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Functions
Assert Handler for debug purposes.
BLE Libraries

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_code | Error code supplied to the handler.
  [in] | line_num | Line number where the original handler is called.
  [in] | p_file_name | Pointer to the file name.