Function esp_idf_svc::hal::sys::esp_image_verify

source ·
pub unsafe extern "C" fn esp_image_verify(
    mode: u32,
    part: *const esp_partition_pos_t,
    data: *mut esp_image_metadata_t,
) -> i32
Expand description

@brief Verify an app image.

If encryption is enabled, data will be transparently decrypted.

@param mode Mode of operation (verify, silent verify, or load). @param part Partition to load the app from. @param[inout] data Pointer to the image metadata structure which is be filled in by this function. ‘start_addr’ member should be set (to the start address of the image.) Other fields will all be initialised by this function.

Image validation checks:

  • Magic byte.
  • Partition smaller than 16MB.
  • All segments & image fit in partition.
  • 8 bit image checksum is valid.
  • SHA-256 of image is valid (if image has this appended).
  • (Signature) if signature verification is enabled.

@return

  • ESP_OK if verify or load was successful
  • ESP_ERR_IMAGE_FLASH_FAIL if a SPI flash error occurs
  • ESP_ERR_IMAGE_INVALID if the image appears invalid.
  • ESP_ERR_INVALID_ARG if the partition or data pointers are invalid.