2021-05-09 22:56:51 -04:00
|
|
|
/*
|
2024-01-02 09:19:49 -05:00
|
|
|
* SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
|
2021-05-09 22:56:51 -04:00
|
|
|
*
|
|
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
|
|
*/
|
2019-04-29 00:25:50 -04:00
|
|
|
#pragma once
|
|
|
|
|
2020-09-07 06:00:00 -04:00
|
|
|
#include <inttypes.h>
|
2022-10-13 00:01:27 -04:00
|
|
|
#include "esp_assert.h"
|
2020-09-07 06:00:00 -04:00
|
|
|
|
2024-06-01 11:48:58 -04:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2019-09-15 23:47:23 -04:00
|
|
|
/**
|
|
|
|
* @brief ESP chip ID
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
typedef enum {
|
|
|
|
ESP_CHIP_ID_ESP32 = 0x0000, /*!< chip ID: ESP32 */
|
2020-01-15 08:50:19 -05:00
|
|
|
ESP_CHIP_ID_ESP32S2 = 0x0002, /*!< chip ID: ESP32-S2 */
|
2020-11-26 03:56:13 -05:00
|
|
|
ESP_CHIP_ID_ESP32C3 = 0x0005, /*!< chip ID: ESP32-C3 */
|
2021-06-02 00:14:13 -04:00
|
|
|
ESP_CHIP_ID_ESP32S3 = 0x0009, /*!< chip ID: ESP32-S3 */
|
2023-04-13 05:06:40 -04:00
|
|
|
ESP_CHIP_ID_ESP32C2 = 0x000C, /*!< chip ID: ESP32-C2 */
|
2022-07-08 04:46:11 -04:00
|
|
|
ESP_CHIP_ID_ESP32C6 = 0x000D, /*!< chip ID: ESP32-C6 */
|
2023-05-30 05:49:21 -04:00
|
|
|
ESP_CHIP_ID_ESP32H2 = 0x0010, /*!< chip ID: ESP32-H2 */
|
2023-06-09 08:31:22 -04:00
|
|
|
ESP_CHIP_ID_ESP32P4 = 0x0012, /*!< chip ID: ESP32-P4 */
|
2024-06-11 03:31:03 -04:00
|
|
|
ESP_CHIP_ID_ESP32C5 = 0x0017, /*!< chip ID: ESP32-C5 */
|
2019-09-15 23:47:23 -04:00
|
|
|
ESP_CHIP_ID_INVALID = 0xFFFF /*!< Invalid chip ID (we defined it to make sure the esp_chip_id_t is 2 bytes size) */
|
|
|
|
} __attribute__((packed)) esp_chip_id_t;
|
|
|
|
|
|
|
|
/** @cond */
|
2022-10-13 00:01:27 -04:00
|
|
|
ESP_STATIC_ASSERT(sizeof(esp_chip_id_t) == 2, "esp_chip_id_t should be 16 bit");
|
2019-09-15 23:47:23 -04:00
|
|
|
/** @endcond */
|
|
|
|
|
2019-04-29 00:25:50 -04:00
|
|
|
/**
|
|
|
|
* @brief SPI flash mode, used in esp_image_header_t
|
|
|
|
*/
|
|
|
|
typedef enum {
|
|
|
|
ESP_IMAGE_SPI_MODE_QIO, /*!< SPI mode QIO */
|
|
|
|
ESP_IMAGE_SPI_MODE_QOUT, /*!< SPI mode QOUT */
|
|
|
|
ESP_IMAGE_SPI_MODE_DIO, /*!< SPI mode DIO */
|
|
|
|
ESP_IMAGE_SPI_MODE_DOUT, /*!< SPI mode DOUT */
|
|
|
|
ESP_IMAGE_SPI_MODE_FAST_READ, /*!< SPI mode FAST_READ */
|
|
|
|
ESP_IMAGE_SPI_MODE_SLOW_READ /*!< SPI mode SLOW_READ */
|
|
|
|
} esp_image_spi_mode_t;
|
|
|
|
|
|
|
|
/**
|
2022-04-12 04:37:40 -04:00
|
|
|
* @brief SPI flash clock division factor.
|
2019-04-29 00:25:50 -04:00
|
|
|
*/
|
|
|
|
typedef enum {
|
2022-04-12 04:37:40 -04:00
|
|
|
ESP_IMAGE_SPI_SPEED_DIV_2, /*!< The SPI flash clock frequency is divided by 2 of the clock source */
|
|
|
|
ESP_IMAGE_SPI_SPEED_DIV_3, /*!< The SPI flash clock frequency is divided by 3 of the clock source */
|
|
|
|
ESP_IMAGE_SPI_SPEED_DIV_4, /*!< The SPI flash clock frequency is divided by 4 of the clock source */
|
|
|
|
ESP_IMAGE_SPI_SPEED_DIV_1 = 0xF /*!< The SPI flash clock frequency equals to the clock source */
|
2019-04-29 00:25:50 -04:00
|
|
|
} esp_image_spi_freq_t;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Supported SPI flash sizes
|
|
|
|
*/
|
|
|
|
typedef enum {
|
|
|
|
ESP_IMAGE_FLASH_SIZE_1MB = 0, /*!< SPI flash size 1 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_2MB, /*!< SPI flash size 2 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_4MB, /*!< SPI flash size 4 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_8MB, /*!< SPI flash size 8 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_16MB, /*!< SPI flash size 16 MB */
|
2021-10-13 16:37:10 -04:00
|
|
|
ESP_IMAGE_FLASH_SIZE_32MB, /*!< SPI flash size 32 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_64MB, /*!< SPI flash size 64 MB */
|
|
|
|
ESP_IMAGE_FLASH_SIZE_128MB, /*!< SPI flash size 128 MB */
|
2019-04-29 00:25:50 -04:00
|
|
|
ESP_IMAGE_FLASH_SIZE_MAX /*!< SPI flash size MAX */
|
|
|
|
} esp_image_flash_size_t;
|
|
|
|
|
|
|
|
#define ESP_IMAGE_HEADER_MAGIC 0xE9 /*!< The magic word for the esp_image_header_t structure. */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Main header of binary image
|
|
|
|
*/
|
|
|
|
typedef struct {
|
|
|
|
uint8_t magic; /*!< Magic word ESP_IMAGE_HEADER_MAGIC */
|
|
|
|
uint8_t segment_count; /*!< Count of memory segments */
|
|
|
|
uint8_t spi_mode; /*!< flash read mode (esp_image_spi_mode_t as uint8_t) */
|
|
|
|
uint8_t spi_speed: 4; /*!< flash frequency (esp_image_spi_freq_t as uint8_t) */
|
|
|
|
uint8_t spi_size: 4; /*!< flash chip size (esp_image_flash_size_t as uint8_t) */
|
|
|
|
uint32_t entry_addr; /*!< Entry address */
|
|
|
|
uint8_t wp_pin; /*!< WP pin when SPI pins set via efuse (read by ROM bootloader,
|
|
|
|
* the IDF bootloader uses software to configure the WP
|
|
|
|
* pin and sets this field to 0xEE=disabled) */
|
|
|
|
uint8_t spi_pin_drv[3]; /*!< Drive settings for the SPI flash pins (read by ROM bootloader) */
|
2019-09-15 23:47:23 -04:00
|
|
|
esp_chip_id_t chip_id; /*!< Chip identification number */
|
2022-03-17 09:58:15 -04:00
|
|
|
uint8_t min_chip_rev; /*!< Minimal chip revision supported by image
|
|
|
|
* After the Major and Minor revision eFuses were introduced into the chips, this field is no longer used.
|
|
|
|
* But for compatibility reasons, we keep this field and the data in it.
|
|
|
|
* Use min_chip_rev_full instead.
|
|
|
|
* The software interprets this as a Major version for most of the chips and as a Minor version for the ESP32-C3.
|
|
|
|
*/
|
|
|
|
uint16_t min_chip_rev_full; /*!< Minimal chip revision supported by image, in format: major * 100 + minor */
|
|
|
|
uint16_t max_chip_rev_full; /*!< Maximal chip revision supported by image, in format: major * 100 + minor */
|
|
|
|
uint8_t reserved[4]; /*!< Reserved bytes in additional header space, currently unused */
|
2019-04-29 00:25:50 -04:00
|
|
|
uint8_t hash_appended; /*!< If 1, a SHA256 digest "simple hash" (of the entire image) is appended after the checksum.
|
|
|
|
* Included in image length. This digest
|
|
|
|
* is separate to secure boot and only used for detecting corruption.
|
|
|
|
* For secure boot signed images, the signature
|
|
|
|
* is appended after this (and the simple hash is included in the signed data). */
|
|
|
|
} __attribute__((packed)) esp_image_header_t;
|
|
|
|
|
|
|
|
/** @cond */
|
2022-10-13 00:01:27 -04:00
|
|
|
ESP_STATIC_ASSERT(sizeof(esp_image_header_t) == 24, "binary image header should be 24 bytes");
|
2019-04-29 00:25:50 -04:00
|
|
|
/** @endcond */
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Header of binary image segment
|
|
|
|
*/
|
|
|
|
typedef struct {
|
|
|
|
uint32_t load_addr; /*!< Address of segment */
|
|
|
|
uint32_t data_len; /*!< Length of data */
|
|
|
|
} esp_image_segment_header_t;
|
|
|
|
|
|
|
|
#define ESP_IMAGE_MAX_SEGMENTS 16 /*!< Max count of segments in the image. */
|
2024-06-01 11:48:58 -04:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|