include/imx8image.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Copyright 2018 NXP
   4  *
   5  * Peng Fan <peng.fan@nxp.com>
   6  */
   7
   8 #ifndef _IMX8IMAGE_H_
   9 #define _IMX8IMAGE_H_
  10
  11 #include <image.h>
  12 #include <inttypes.h>
  13 #include "imagetool.h"
  14
  15 #define __packed   __attribute__((packed))
  16
  17 #define IV_MAX_LEN                      32
  18 #define HASH_MAX_LEN                    64
  19 #define MAX_NUM_IMGS                    6
  20 #define MAX_NUM_SRK_RECORDS             4
  21
  22 #define IVT_HEADER_TAG_B0               0x87
  23 #define IVT_VERSION_B0                  0x00
  24
  25 #define IMG_FLAG_HASH_SHA256            0x000
  26 #define IMG_FLAG_HASH_SHA384            0x100
  27 #define IMG_FLAG_HASH_SHA512            0x200
  28
  29 #define IMG_FLAG_ENCRYPTED_MASK         0x400
  30 #define IMG_FLAG_ENCRYPTED_SHIFT        0x0A
  31
  32 #define IMG_FLAG_BOOTFLAGS_MASK         0xFFFF0000
  33 #define IMG_FLAG_BOOTFLAGS_SHIFT        0x10
  34
  35 #define IMG_ARRAY_ENTRY_SIZE            128
  36 #define HEADER_IMG_ARRAY_OFFSET         0x10
  37
  38 #define HASH_TYPE_SHA_256               256
  39 #define HASH_TYPE_SHA_384               384
  40 #define HASH_TYPE_SHA_512               512
  41
  42 #define IMAGE_HASH_ALGO_DEFAULT         384
  43 #define IMAGE_PADDING_DEFAULT           0x1000
  44
  45 #define DCD_ENTRY_ADDR_IN_SCFW          0x240
  46
  47 #define CONTAINER_ALIGNMENT             0x400
  48 #define CONTAINER_FLAGS_DEFAULT         0x10
  49 #define CONTAINER_FUSE_DEFAULT          0x0
  50
  51 #define SIGNATURE_BLOCK_HEADER_LENGTH   0x10
  52
  53 #define MAX_NUM_OF_CONTAINER            2
  54
  55 #define FIRST_CONTAINER_HEADER_LENGTH   0x400
  56
  57 #define BOOT_IMG_META_MU_RID_SHIFT      10
  58 #define BOOT_IMG_META_PART_ID_SHIFT     20
  59
  60 #define IMAGE_A35_DEFAULT_META(PART)    (((PART == 0) ? \
  61                                          PARTITION_ID_AP : PART) << \
  62                                          BOOT_IMG_META_PART_ID_SHIFT | \
  63                                          SC_R_MU_0A << \
  64                                          BOOT_IMG_META_MU_RID_SHIFT | \
  65                                          SC_R_A35_0)
  66
  67 #define IMAGE_A53_DEFAULT_META(PART)    (((PART == 0) ? \
  68                                          PARTITION_ID_AP : PART) << \
  69                                          BOOT_IMG_META_PART_ID_SHIFT | \
  70                                          SC_R_MU_0A << \
  71                                          BOOT_IMG_META_MU_RID_SHIFT | \
  72                                          SC_R_A53_0)
  73
  74 #define IMAGE_A72_DEFAULT_META(PART)    (((PART == 0) ? \
  75                                          PARTITION_ID_AP : PART) << \
  76                                          BOOT_IMG_META_PART_ID_SHIFT | \
  77                                          SC_R_MU_0A << \
  78                                          BOOT_IMG_META_MU_RID_SHIFT | \
  79                                          SC_R_A72_0)
  80
  81 #define IMAGE_M4_0_DEFAULT_META(PART)   (((PART == 0) ? \
  82                                          PARTITION_ID_M4 : PART) << \
  83                                          BOOT_IMG_META_PART_ID_SHIFT | \
  84                                          SC_R_M4_0_MU_1A << \
  85                                          BOOT_IMG_META_MU_RID_SHIFT | \
  86                                          SC_R_M4_0_PID0)
  87
  88 #define IMAGE_M4_1_DEFAULT_META(PART)   (((PART == 0) ? \
  89                                          PARTITION_ID_M4 : PART) << \
  90                                          BOOT_IMG_META_PART_ID_SHIFT | \
  91                                          SC_R_M4_1_MU_1A << \
  92                                          BOOT_IMG_META_MU_RID_SHIFT | \
  93                                          SC_R_M4_1_PID0)
  94
  95 #define CONTAINER_IMAGE_ARRAY_START_OFFSET      0x2000
  96
  97 typedef struct {
  98         uint8_t version;
  99         uint16_t length;
 100         uint8_t tag;
 101         uint16_t srk_table_offset;
 102         uint16_t cert_offset;
 103         uint16_t blob_offset;
 104         uint16_t signature_offset;
 105         uint32_t reserved;
 106 } __packed sig_blk_hdr_t;
 107
 108 typedef struct {
 109         uint32_t offset;
 110         uint32_t size;
 111         uint64_t dst;
 112         uint64_t entry;
 113         uint32_t hab_flags;
 114         uint32_t meta;
 115         uint8_t hash[HASH_MAX_LEN];
 116         uint8_t iv[IV_MAX_LEN];
 117 } __packed boot_img_t;
 118
 119 typedef struct {
 120         uint8_t version;
 121         uint16_t length;
 122         uint8_t tag;
 123         uint32_t flags;
 124         uint16_t sw_version;
 125         uint8_t fuse_version;
 126         uint8_t num_images;
 127         uint16_t sig_blk_offset;
 128         uint16_t reserved;
 129         boot_img_t img[MAX_NUM_IMGS];
 130         sig_blk_hdr_t sig_blk_hdr;
 131         uint32_t sigblk_size;
 132         uint32_t padding;
 133 } __packed flash_header_v3_t;
 134
 135 typedef struct {
 136         flash_header_v3_t fhdr[MAX_NUM_OF_CONTAINER];
 137 }  __packed imx_header_v3_t;
 138
 139 struct image_array {
 140         char *name;
 141         unsigned int core_type;
 142         unsigned int core_id;
 143         unsigned int load_addr;
 144 };
 145
 146 enum imx8image_cmd {
 147         CMD_INVALID,
 148         CMD_BOOT_FROM,
 149         CMD_FUSE_VERSION,
 150         CMD_SW_VERSION,
 151         CMD_MSG_BLOCK,
 152         CMD_FILEOFF,
 153         CMD_FLAG,
 154         CMD_APPEND,
 155         CMD_PARTITION,
 156         CMD_SOC_TYPE,
 157         CMD_CONTAINER,
 158         CMD_IMAGE,
 159         CMD_DATA
 160 };
 161
 162 enum imx8image_core_type {
 163         CFG_CORE_INVALID,
 164         CFG_SCU,
 165         CFG_M40,
 166         CFG_M41,
 167         CFG_A35,
 168         CFG_A53,
 169         CFG_A72
 170 };
 171
 172 enum imx8image_fld_types {
 173         CFG_INVALID = -1,
 174         CFG_COMMAND,
 175         CFG_CORE_TYPE,
 176         CFG_IMAGE_NAME,
 177         CFG_LOAD_ADDR
 178 };
 179
 180 typedef enum SOC_TYPE {
 181         NONE = 0,
 182         QX,
 183         QM
 184 } soc_type_t;
 185
 186 typedef enum option_type {
 187         NO_IMG = 0,
 188         DCD,
 189         SCFW,
 190         SECO,
 191         M40,
 192         M41,
 193         AP,
 194         OUTPUT,
 195         SCD,
 196         CSF,
 197         FLAG,
 198         DEVICE,
 199         NEW_CONTAINER,
 200         APPEND,
 201         DATA,
 202         PARTITION,
 203         FILEOFF,
 204         MSG_BLOCK
 205 } option_type_t;
 206
 207 typedef struct {
 208         option_type_t option;
 209         char *filename;
 210         uint64_t src;
 211         uint64_t dst;
 212         uint64_t entry;
 213         uint64_t ext;
 214 } image_t;
 215
 216 #define CORE_SC         1
 217 #define CORE_CM4_0      2
 218 #define CORE_CM4_1      3
 219 #define CORE_CA53       4
 220 #define CORE_CA35       4
 221 #define CORE_CA72       5
 222 #define CORE_SECO       6
 223
 224 #define SC_R_OTP        357U
 225 #define SC_R_DEBUG      354U
 226 #define SC_R_ROM_0      236U
 227
 228 #define MSG_DEBUG_EN    SC_R_DEBUG
 229 #define MSG_FUSE        SC_R_OTP
 230 #define MSG_FIELD       SC_R_ROM_0
 231
 232 #define IMG_TYPE_CSF     0x01   /* CSF image type */
 233 #define IMG_TYPE_SCD     0x02   /* SCD image type */
 234 #define IMG_TYPE_EXEC    0x03   /* Executable image type */
 235 #define IMG_TYPE_DATA    0x04   /* Data image type */
 236 #define IMG_TYPE_DCD_DDR 0x05   /* DCD/DDR image type */
 237 #define IMG_TYPE_SECO    0x06   /* SECO image type */
 238 #define IMG_TYPE_PROV    0x07   /* Provisioning image type */
 239 #define IMG_TYPE_DEK     0x08   /* DEK validation type */
 240
 241 #define IMG_TYPE_SHIFT   0
 242 #define IMG_TYPE_MASK    0x1f
 243 #define IMG_TYPE(x)      (((x) & IMG_TYPE_MASK) >> IMG_TYPE_SHIFT)
 244
 245 #define BOOT_IMG_FLAGS_CORE_MASK                0xF
 246 #define BOOT_IMG_FLAGS_CORE_SHIFT               0x04
 247 #define BOOT_IMG_FLAGS_CPU_RID_MASK             0x3FF0
 248 #define BOOT_IMG_FLAGS_CPU_RID_SHIFT            4
 249 #define BOOT_IMG_FLAGS_MU_RID_MASK              0xFFC000
 250 #define BOOT_IMG_FLAGS_MU_RID_SHIFT             14
 251 #define BOOT_IMG_FLAGS_PARTITION_ID_MASK        0x1F000000
 252 #define BOOT_IMG_FLAGS_PARTITION_ID_SHIFT       24
 253
 254 /* Resource id used in scfw */
 255 #define SC_R_A35_0              508
 256 #define SC_R_A53_0              1
 257 #define SC_R_A72_0              6
 258 #define SC_R_MU_0A              213
 259 #define SC_R_M4_0_PID0          278
 260 #define SC_R_M4_0_MU_1A         297
 261 #define SC_R_M4_1_PID0          298
 262 #define SC_R_M4_1_MU_1A         317
 263 #define PARTITION_ID_M4         0
 264 #define PARTITION_ID_AP         1
 265
 266 #define IMG_STACK_SIZE  32
 267
 268 #define append(p, s, l) do { \
 269         memcpy((p), (uint8_t *)(s), (l)); (p) += (l); \
 270         } while (0)
 271
 272 #endif