/*
 * SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
 *
 * SPDX-License-Identifier: Apache-2.0
 */

#pragma once

/* Magic is derived from sha256sum of the string "espmcuboot"
 * The application header magic must match this number
 */
#define ESP_LOAD_HEADER_MAGIC 0xace637d3
#define ESP_PROGRAM_HEADER_MAGIC ESP_LOAD_HEADER_MAGIC

/* Load header that should be a part of application image
 * for MCUboot-Espressif port booting.
 * The header can use up to 96 Bytes (or 24 DWords).
 */
typedef struct esp_program_header {
    uint32_t header_magic;             /* Magic for load header */
    uint32_t entry_addr;               /* Application entry address */
    uint32_t iram_dest_addr;           /* Destination address(VMA) for IRAM region */
    uint32_t iram_flash_offset;        /* Flash offset(LMA) for start of IRAM region */
    uint32_t iram_size;                /* Size of IRAM region */
    uint32_t dram_dest_addr;           /* Destination address(VMA) for DRAM region */
    uint32_t dram_flash_offset;        /* Flash offset(LMA) for start of DRAM region */
    uint32_t dram_size;                /* Size of DRAM region */
    uint32_t lp_rtc_iram_dest_addr;    /* Destination address (VMA) for LP_IRAM region */
    uint32_t lp_rtc_iram_flash_offset; /* Flash offset (LMA) for LP_IRAM region */
    uint32_t lp_rtc_iram_size;         /* Size of LP_IRAM region */
    uint32_t lp_rtc_dram_dest_addr;    /* Destination address (VMA) for LP_DRAM region */
    uint32_t lp_rtc_dram_flash_offset; /* Flash offset (LMA) for LP_DRAM region */
    uint32_t lp_rtc_dram_size;         /* Size of LP_DRAM region */
    uint32_t irom_map_addr;            /* Mapped address (VMA) for IROM region */
    uint32_t irom_flash_offset;        /* Flash offset (LMA) for IROM region */
    uint32_t irom_size;                /* Size of IROM region */
    uint32_t drom_map_addr;            /* Mapped address (VMA) for DROM region */
    uint32_t drom_flash_offset;        /* Flash offset (LMA) for DROM region */
    uint32_t drom_size;                /* Size of DROM region */
    uint32_t _reserved[4];             /* Up to 24 words reserved for the header */
} esp_program_header_t;

typedef esp_program_header_t esp_image_load_header_t;