Firmware activation

nRF5 SDK v15.0.0
Enumerations | Functions

Enumerations

enum nrf_bootloader_fw_activation_result_t {
ACTIVATION_NONE ,
ACTIVATION_SUCCESS ,
ACTIVATION_SUCCESS_EXPECT_ADDITIONAL_UPDATE ,
ACTIVATION_ERROR
}

Functions

nrf_bootloader_fw_activation_result_t nrf_bootloader_fw_activate (void)
Function for activating a firmware received during DFU. More...

Detailed Description

Enumeration Type Documentation

enum nrf_bootloader_fw_activation_result_t
Enumerator
ACTIVATION_NONE

No new update was found.

ACTIVATION_SUCCESS

Update was successfully activated.

ACTIVATION_SUCCESS_EXPECT_ADDITIONAL_UPDATE

Update was successfully activated, but there might be additional update(s) to be transferred.

ACTIVATION_ERROR

Activation of an update failed.

Function Documentation

nrf_bootloader_fw_activation_result_t nrf_bootloader_fw_activate ( void )

Function for activating a firmware received during DFU.

This function initiates or continues the DFU copy-back routines. These routines are fail-safe operations to activate either a new SoftDevice, bootloader, combination of SoftDevice and bootloader, or a new application.

This function relies on accessing MBR commands through supervisor calls. It does not rely on the SoftDevice for flash operations.

Note
When updating the bootloader or both bootloader and SoftDevice in combination, this function does not return, but rather initiates a reboot to activate the new bootloader.
Return values
ACTIVATION_NONE If no update was found.
ACTIVATION_SUCCESS If the firmware update was successfully activated.
ACTIVATION_SUCCESS_EXPECT_ADDITIONAL_UPDATE If the firmware update was successfully activated, but there are likely more updates to be transferred.
ACTIVATION_ERROR If the firmware update could not be activated.