nRF5 SDK v14.1.0
Data Fields
dfu_progress_t Struct Reference

DFU progress. More...

#include <nrf_dfu_types.h>

Data Fields

uint32_t command_size
 
uint32_t command_offset
 
uint32_t command_crc
 
uint32_t data_object_size
 
union {
   struct {
      uint32_t   firmware_image_crc
 
      uint32_t   firmware_image_crc_last
 
      uint32_t   firmware_image_offset
 
      uint32_t   firmware_image_offset_last
 
   } 
 
   struct {
      uint32_t   sd_start_address
 
   } 
 
}; 
 

Detailed Description

DFU progress.

Be aware of the difference between objects and firmware images. A firmware image consists of multiple objects, each of a maximum size DATA_OBJECT_MAX_SIZE.

Note
The union inside this struct is cleared when CREATE_OBJECT of command type is executed, and when there is a valid post-validation. In DFU activation (after reset) the sd_start_address will be used in case of a SD/SD+BL update.

Field Documentation

uint32_t dfu_progress_t::command_crc

The calculated CRC of the init command (calculated after the transfer is completed).

uint32_t dfu_progress_t::command_offset

The offset of the currently received init command data. The offset will increase as the init command is received.

uint32_t dfu_progress_t::command_size

The size of the current init command stored in the DFU settings.

uint32_t dfu_progress_t::data_object_size

The size of the last object created. Note that this size is not the size of the whole firmware image.

uint32_t dfu_progress_t::firmware_image_crc

CRC value of the current firmware (continuously calculated as data is received).

uint32_t dfu_progress_t::firmware_image_crc_last

The CRC of the last executed object.

uint32_t dfu_progress_t::firmware_image_offset

The offset of the current firmware image being transferred. Note that this offset is the offset in the entire firmware image and not only the current object.

uint32_t dfu_progress_t::firmware_image_offset_last

The offset of the last executed object from the start of the firmware image.

uint32_t dfu_progress_t::sd_start_address

Value indicating the start address of the SoftDevice source. Used for an SD/SD+BL update where the SD changes size or if the DFU process had a power loss when updating a SD with changed size.


The documentation for this struct was generated from the following file:

Documentation feedback | Developer Zone | Subscribe | Updated