nRF5 SDK v17.1.0
Enumerations | Functions
Firmware activation

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

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_NONEIf no update was found.
ACTIVATION_SUCCESSIf the firmware update was successfully activated.
ACTIVATION_SUCCESS_EXPECT_ADDITIONAL_UPDATEIf the firmware update was successfully activated, but there are likely more updates to be transferred.
ACTIVATION_ERRORIf the firmware update could not be activated.

Documentation feedback | Developer Zone | Subscribe | Updated