img_mgmt.h File Reference

#include <inttypes.h>
#include <zephyr/mgmt/mcumgr/mgmt/mgmt.h>
#include <zephyr/mgmt/mcumgr/smp/smp.h>
#include <zephyr/mgmt/mcumgr/grp/img_mgmt/image.h>
#include <zcbor_common.h>

Go to the source code of this file.

Data Structures
struct	img_mgmt_upload_req
struct	img_mgmt_state
struct	img_mgmt_upload_action

Macros
#define	IMG_MGMT_HASH_STR   48
#define	IMG_MGMT_HASH_LEN   32
#define	IMG_MGMT_DATA_SHA_LEN   32 /* SHA256 */
#define	IMG_MGMT_STATE_F_PENDING   0x01
#define	IMG_MGMT_STATE_F_CONFIRMED   0x02
#define	IMG_MGMT_STATE_F_ACTIVE   0x04
#define	IMG_MGMT_STATE_F_PERMANENT   0x08
#define	IMG_MGMT_VER_MAX_STR_LEN   (sizeof("255.255.65535.4294967295"))
#define	IMG_MGMT_SWAP_TYPE_NONE   0
#define	IMG_MGMT_SWAP_TYPE_TEST   1
#define	IMG_MGMT_SWAP_TYPE_PERM   2
#define	IMG_MGMT_SWAP_TYPE_REVERT   3
#define	IMG_MGMT_SWAP_TYPE_UNKNOWN   255
#define	IMG_MGMT_ID_STATE   0
#define	IMG_MGMT_ID_UPLOAD   1
#define	IMG_MGMT_ID_FILE   2
#define	IMG_MGMT_ID_CORELIST   3
#define	IMG_MGMT_ID_CORELOAD   4
#define	IMG_MGMT_ID_ERASE   5
#define	IMG_MGMT_UPLOAD_ACTION_SET_RC_RSN(action, rsn)
#define	IMG_MGMT_UPLOAD_ACTION_RC_RSN(action)   NULL

Enumerations
enum	img_mgmt_ret_code_t {   IMG_MGMT_RET_RC_OK = 0 , IMG_MGMT_RET_RC_UNKNOWN , IMG_MGMT_RET_RC_FLASH_CONFIG_QUERY_FAIL , IMG_MGMT_RET_RC_NO_IMAGE ,   IMG_MGMT_RET_RC_NO_TLVS , IMG_MGMT_RET_RC_INVALID_TLV , IMG_MGMT_RET_RC_TLV_MULTIPLE_HASHES_FOUND , IMG_MGMT_RET_RC_TLV_INVALID_SIZE ,   IMG_MGMT_RET_RC_HASH_NOT_FOUND , IMG_MGMT_RET_RC_NO_FREE_SLOT , IMG_MGMT_RET_RC_FLASH_OPEN_FAILED , IMG_MGMT_RET_RC_FLASH_READ_FAILED ,   IMG_MGMT_RET_RC_FLASH_WRITE_FAILED , IMG_MGMT_RET_RC_FLASH_ERASE_FAILED , IMG_MGMT_RET_RC_INVALID_SLOT , IMG_MGMT_RET_RC_NO_FREE_MEMORY ,   IMG_MGMT_RET_RC_FLASH_CONTEXT_ALREADY_SET , IMG_MGMT_RET_RC_FLASH_CONTEXT_NOT_SET , IMG_MGMT_RET_RC_FLASH_AREA_DEVICE_NULL , IMG_MGMT_RET_RC_INVALID_PAGE_OFFSET ,   IMG_MGMT_RET_RC_INVALID_OFFSET , IMG_MGMT_RET_RC_INVALID_LENGTH , IMG_MGMT_RET_RC_INVALID_IMAGE_HEADER , IMG_MGMT_RET_RC_INVALID_IMAGE_HEADER_MAGIC ,   IMG_MGMT_RET_RC_INVALID_HASH , IMG_MGMT_RET_RC_INVALID_FLASH_ADDRESS , IMG_MGMT_RET_RC_VERSION_GET_FAILED , IMG_MGMT_RET_RC_CURRENT_VERSION_IS_NEWER ,   IMG_MGMT_RET_RC_IMAGE_ALREADY_PENDING , IMG_MGMT_RET_RC_INVALID_IMAGE_VECTOR_TABLE }
enum	img_mgmt_id_upload_t { IMG_MGMT_ID_UPLOAD_STATUS_START = 0 , IMG_MGMT_ID_UPLOAD_STATUS_ONGOING , IMG_MGMT_ID_UPLOAD_STATUS_COMPLETE }

Functions
int	img_mgmt_read_info (int image_slot, struct image_version *ver, uint8_t *hash, uint32_t *flags)
int	img_mgmt_my_version (struct image_version *ver)
	Get the image version of the currently running application. More...
int	img_mgmt_ver_str (const struct image_version *ver, char *dst)
	Format version string from struct image_version. More...
int	img_mgmt_active_slot (int image)
	Get active, running application slot number for an image. More...
int	img_mgmt_active_image (void)
	Get active image number. More...
int	img_mgmt_slot_in_use (int slot)
	Check if the image slot is in use. More...
int	img_mgmt_state_any_pending (void)
	Check if any slot is in MCUboot pending state. More...
uint8_t	img_mgmt_state_flags (int query_slot)
	Returns state flags set to slot. More...
int	img_mgmt_state_set_pending (int slot, int permanent)
	Sets the pending flag for the specified image slot. More...
int	img_mgmt_state_confirm (void)
	Confirms the current image state. More...
int	img_mgmt_vercmp (const struct image_version *a, const struct image_version *b)

Variables
int	boot_current_slot
struct img_mgmt_state	g_img_mgmt_state