DFU from SD card APIs

Typedefs
typedef void(*	dfu_exfat_progress_cb_t) (size_t copied, size_t total)
	Progress callback for DFU copy.

Functions
int	dfu_exfat_app_upgrade_exists (const struct device *dev, struct mcuboot_img_sem_ver *upgrade)
	Check whether a valid DFU file exists on the filesystem.
int	dfu_exfat_app_upgrade_copy (const struct device *dev, struct mcuboot_img_sem_ver upgrade, uint8_t flash_area_id, dfu_exfat_progress_cb_t progress_cb)
	Copy DFU file from filesystem onto flash area.

Detailed Description

Typedef Documentation

dfu_exfat_progress_cb_t

typedef void(* dfu_exfat_progress_cb_t) (size_t copied, size_t total)

#include <infuse/dfu/exfat.h>

Progress callback for DFU copy.

Parameters

copied	Number of bytes that have been copied so far
total	Total number of bytes to be copied

Function Documentation

dfu_exfat_app_upgrade_copy()

int dfu_exfat_app_upgrade_copy	(	const struct device *	dev,
		struct mcuboot_img_sem_ver	upgrade,
		uint8_t	flash_area_id,
		dfu_exfat_progress_cb_t	progress_cb )

#include <infuse/dfu/exfat.h>

Copy DFU file from filesystem onto flash area.

Parameters

dev	exFAT data logger device
upgrade	New version from dfu_exfat_app_upgrade_exists
flash_area_id	Output flash area ID
progress_cb	Optional progress callback

Return values

0	On success
-errno	On error

dfu_exfat_app_upgrade_exists()

int dfu_exfat_app_upgrade_exists	(	const struct device *	dev,
		struct mcuboot_img_sem_ver *	upgrade )

#include <infuse/dfu/exfat.h>

Check whether a valid DFU file exists on the filesystem.

Expected usage:

const struct device *logger = DEVICE_DT_GET_ONE(embeint_data_logger_exfat);
uint8_t upgrade_partition = FIXED_PARTITION_ID(slot1_partition);
struct infuse_version upgrade_version;
 
if (dfu_exfat_app_upgrade_exists(logger, &upgrade_version) == 1) {
  if (dfu_exfat_app_upgrade_copy(logger, upgrade_version, upgrade_partition, NULL) == 0) {
    if (boot_request_upgrade_multi(0, 0) == 0) {
      infuse_reboot(INFUSE_REBOOT_DFU, 0x00, 0x00);
    }
  }
}

Parameters

dev	exFAT data logger device
upgrade	Storage location for upgrade version

Return values

0	No valid upgrade file exists
1	Valid upgrade file exists, upgrade is valid
-errno	On error