test
Fork of nrf51-sdk by
Handling of DFU BLE packets in the application. More...
Typedefs | |
typedef void(* | dfu_app_reset_prepare_t )(void) |
DFU application reset_prepare function. | |
Functions | |
void | dfu_app_on_dfu_evt (ble_dfu_t *p_dfu, ble_dfu_evt_t *p_evt) |
Function for handling events from the DFU Service. | |
void | dfu_app_reset_prepare_set (dfu_app_reset_prepare_t reset_prepare_func) |
Function for registering a function to prepare a reset. | |
void | dfu_app_dm_appl_instance_set (dm_application_instance_t app_instance) |
Function for setting the Device Manager application instance. |
Detailed Description
Handling of DFU BLE packets in the application.
This module implements the handling of DFU packets for switching from an application to the bootloader and start DFU mode. The DFU packets are transmitted over BLE. This module handles only the StartDFU packet, which allows a BLE application to expose support for the DFU Service. The actual DFU Service runs in a dedicated environment after a BLE disconnect and reset of the device. The host must reconnect and continue the update procedure with access to the full DFU Service.
- Note:
- The application must propagate DFU events to this module by calling dfu_app_on_dfu_evt from the ble_dfu_evt_handler_t callback.
Typedef Documentation
typedef void(* dfu_app_reset_prepare_t)(void) |
DFU application reset_prepare function.
This function is a callback that allows the application to prepare for an upcoming application reset.
Definition at line 68 of file dfu_app_handler.h.
Function Documentation
void dfu_app_dm_appl_instance_set | ( | dm_application_instance_t | app_instance ) |
Function for setting the Device Manager application instance.
This function allows to set the dm_application_instance_t value that is returned by the Device Manager when the application registers using dm_register. If this function is not called, it is not be possible to share bonding information from the application to the bootloader/DFU when entering DFU mode.
- Parameters:
-
[in] app_instance Value for the application instance in use.
Definition at line 206 of file dfu_app_handler.c.
void dfu_app_on_dfu_evt | ( | ble_dfu_t * | p_dfu, |
ble_dfu_evt_t * | p_evt | ||
) |
Function for handling events from the DFU Service.
The application must inject this function into the DFU Service or propagate DFU events to the dfu_app_handler module by calling this function in the application-specific DFU event handler.
- Parameters:
-
[in] p_dfu Pointer to the DFU Service structure to which the include event relates. [in] p_evt Pointer to the DFU event.
Definition at line 177 of file dfu_app_handler.c.
void dfu_app_reset_prepare_set | ( | dfu_app_reset_prepare_t | reset_prepare_func ) |
Function for registering a function to prepare a reset.
The provided function is executed before resetting the system into bootloader/DFU mode. By registering this function, the caller is notified before the reset and can thus prepare the application for reset. For example, the application can gracefully disconnect any peers on BLE, turn of LEDS, ensure that all pending flash operations have completed, and so on.
- Parameters:
-
[in] reset_prepare_func Function to be executed before a reset.
Definition at line 200 of file dfu_app_handler.c.
Generated on Tue Jul 12 2022 15:51:32 by 1.7.2