1 /* 2 * Copyright (C) 2016 Michal Simek <michals@xilinx.com> 3 * Copyright (C) 2015 Nathan Rossi <nathan@nathanrossi.com> 4 * 5 * SPDX-License-Identifier: GPL-2.0+ 6 * 7 * The following Boot Header format/structures and values are defined in the 8 * following documents: 9 * * ug1085 ZynqMP TRM (Chapter 9, Table 9-3) 10 * 11 * Expected Header Size = 0x9C0 12 * Forced as 'little' endian, 32-bit words 13 * 14 * 0x 0 - Interrupt table (8 words) 15 * ... (Default value = 0xeafffffe) 16 * 0x 1f 17 * 0x 20 - Width detection 18 * * DEFAULT_WIDTHDETECTION 0xaa995566 19 * 0x 24 - Image identifier 20 * * DEFAULT_IMAGEIDENTIFIER 0x584c4e58 21 * 0x 28 - Encryption 22 * * 0x00000000 - None 23 * * 0xa5c3c5a3 - eFuse 24 * * 0xa5c3c5a7 - obfuscated key in eFUSE 25 * * 0x3a5c3c5a - bbRam 26 * * 0xa35c7ca5 - obfuscated key in boot header 27 * 0x 2C - Image load 28 * 0x 30 - Image offset 29 * 0x 34 - PFW image length 30 * 0x 38 - Total PFW image length 31 * 0x 3C - Image length 32 * 0x 40 - Total image length 33 * 0x 44 - Image attributes 34 * 0x 48 - Header checksum 35 * 0x 4c - Obfuscated key 36 * ... 37 * 0x 68 38 * 0x 6c - Reserved 39 * 0x 70 - User defined 40 * ... 41 * 0x 9c 42 * 0x a0 - Secure header initialization vector 43 * ... 44 * 0x a8 45 * 0x ac - Obfuscated key initialization vector 46 * ... 47 * 0x b4 48 * 0x b8 - Register Initialization, 511 Address and Data word pairs 49 * * List is terminated with an address of 0xffffffff or 50 * ... * at the max number of entries 51 * 0x8b4 52 * 0x8b8 - Reserved 53 * ... 54 * 0x9bf 55 * 0x9c0 - Data/Image starts here or above 56 */ 57 58 #include "imagetool.h" 59 #include "mkimage.h" 60 #include <image.h> 61 62 #define HEADER_INTERRUPT_DEFAULT (cpu_to_le32(0xeafffffe)) 63 #define HEADER_REGINIT_NULL (cpu_to_le32(0xffffffff)) 64 #define HEADER_WIDTHDETECTION (cpu_to_le32(0xaa995566)) 65 #define HEADER_IMAGEIDENTIFIER (cpu_to_le32(0x584c4e58)) 66 67 enum { 68 ENCRYPTION_EFUSE = 0xa5c3c5a3, 69 ENCRYPTION_OEFUSE = 0xa5c3c5a7, 70 ENCRYPTION_BBRAM = 0x3a5c3c5a, 71 ENCRYPTION_OBBRAM = 0xa35c7ca5, 72 ENCRYPTION_NONE = 0x0, 73 }; 74 75 struct zynqmp_reginit { 76 uint32_t address; 77 uint32_t data; 78 }; 79 80 #define HEADER_INTERRUPT_VECTORS 8 81 #define HEADER_REGINITS 256 82 83 struct zynqmp_header { 84 uint32_t interrupt_vectors[HEADER_INTERRUPT_VECTORS]; /* 0x0 */ 85 uint32_t width_detection; /* 0x20 */ 86 uint32_t image_identifier; /* 0x24 */ 87 uint32_t encryption; /* 0x28 */ 88 uint32_t image_load; /* 0x2c */ 89 uint32_t image_offset; /* 0x30 */ 90 uint32_t pfw_image_length; /* 0x34 */ 91 uint32_t total_pfw_image_length; /* 0x38 */ 92 uint32_t image_size; /* 0x3c */ 93 uint32_t image_stored_size; /* 0x40 */ 94 uint32_t image_attributes; /* 0x44 */ 95 uint32_t checksum; /* 0x48 */ 96 uint32_t __reserved1[27]; /* 0x4c */ 97 struct zynqmp_reginit register_init[HEADER_REGINITS]; /* 0xb8 */ 98 uint32_t __reserved4[66]; /* 0x9c0 */ 99 }; 100 101 static struct zynqmp_header zynqmpimage_header; 102 103 static uint32_t zynqmpimage_checksum(struct zynqmp_header *ptr) 104 { 105 uint32_t checksum = 0; 106 107 if (ptr == NULL) 108 return 0; 109 110 checksum += le32_to_cpu(ptr->width_detection); 111 checksum += le32_to_cpu(ptr->image_identifier); 112 checksum += le32_to_cpu(ptr->encryption); 113 checksum += le32_to_cpu(ptr->image_load); 114 checksum += le32_to_cpu(ptr->image_offset); 115 checksum += le32_to_cpu(ptr->pfw_image_length); 116 checksum += le32_to_cpu(ptr->total_pfw_image_length); 117 checksum += le32_to_cpu(ptr->image_size); 118 checksum += le32_to_cpu(ptr->image_stored_size); 119 checksum += le32_to_cpu(ptr->image_attributes); 120 checksum = ~checksum; 121 122 return cpu_to_le32(checksum); 123 } 124 125 static void zynqmpimage_default_header(struct zynqmp_header *ptr) 126 { 127 int i; 128 129 if (ptr == NULL) 130 return; 131 132 ptr->width_detection = HEADER_WIDTHDETECTION; 133 ptr->image_attributes = 0x800; 134 ptr->image_identifier = HEADER_IMAGEIDENTIFIER; 135 ptr->encryption = cpu_to_le32(ENCRYPTION_NONE); 136 137 /* Setup not-supported/constant/reserved fields */ 138 for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++) 139 ptr->interrupt_vectors[i] = HEADER_INTERRUPT_DEFAULT; 140 141 for (i = 0; i < HEADER_REGINITS; i++) { 142 ptr->register_init[i].address = HEADER_REGINIT_NULL; 143 ptr->register_init[i].data = 0; 144 } 145 146 /* 147 * Certain reserved fields are required to be set to 0, ensure they are 148 * set as such. 149 */ 150 ptr->pfw_image_length = 0x0; 151 ptr->total_pfw_image_length = 0x0; 152 } 153 154 /* mkimage glue functions */ 155 static int zynqmpimage_verify_header(unsigned char *ptr, int image_size, 156 struct image_tool_params *params) 157 { 158 struct zynqmp_header *zynqhdr = (struct zynqmp_header *)ptr; 159 160 if (image_size < sizeof(struct zynqmp_header)) 161 return -1; 162 163 if (zynqhdr->width_detection != HEADER_WIDTHDETECTION) 164 return -1; 165 if (zynqhdr->image_identifier != HEADER_IMAGEIDENTIFIER) 166 return -1; 167 168 if (zynqmpimage_checksum(zynqhdr) != zynqhdr->checksum) 169 return -1; 170 171 return 0; 172 } 173 174 static void zynqmpimage_print_header(const void *ptr) 175 { 176 struct zynqmp_header *zynqhdr = (struct zynqmp_header *)ptr; 177 int i; 178 179 printf("Image Type : Xilinx Zynq Boot Image support\n"); 180 printf("Image Offset : 0x%08x\n", le32_to_cpu(zynqhdr->image_offset)); 181 printf("Image Size : %lu bytes (%lu bytes packed)\n", 182 (unsigned long)le32_to_cpu(zynqhdr->image_size), 183 (unsigned long)le32_to_cpu(zynqhdr->image_stored_size)); 184 printf("Image Load : 0x%08x\n", le32_to_cpu(zynqhdr->image_load)); 185 printf("Checksum : 0x%08x\n", le32_to_cpu(zynqhdr->checksum)); 186 187 for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++) { 188 if (zynqhdr->interrupt_vectors[i] == HEADER_INTERRUPT_DEFAULT) 189 continue; 190 191 printf("Modified Interrupt Vector Address [%d]: 0x%08x\n", i, 192 le32_to_cpu(zynqhdr->interrupt_vectors[i])); 193 } 194 195 for (i = 0; i < HEADER_REGINITS; i++) { 196 if (zynqhdr->register_init[i].address == HEADER_REGINIT_NULL) 197 break; 198 199 if (i == 0) 200 printf("Custom Register Initialization:\n"); 201 202 printf(" @ 0x%08x -> 0x%08x\n", 203 le32_to_cpu(zynqhdr->register_init[i].address), 204 le32_to_cpu(zynqhdr->register_init[i].data)); 205 } 206 } 207 208 static int zynqmpimage_check_params(struct image_tool_params *params) 209 { 210 if (!params) 211 return 0; 212 213 if (params->addr != 0x0) { 214 fprintf(stderr, "Error: Load Address cannot be specified.\n"); 215 return -1; 216 } 217 218 /* 219 * If the entry point is specified ensure it is 64 byte aligned. 220 */ 221 if (params->eflag && (params->ep % 64 != 0)) { 222 fprintf(stderr, 223 "Error: Entry Point must be aligned to a 64-byte boundary.\n"); 224 return -1; 225 } 226 227 return !(params->lflag || params->dflag); 228 } 229 230 static int zynqmpimage_check_image_types(uint8_t type) 231 { 232 if (type == IH_TYPE_ZYNQMPIMAGE) 233 return EXIT_SUCCESS; 234 return EXIT_FAILURE; 235 } 236 237 static void zynqmpimage_set_header(void *ptr, struct stat *sbuf, int ifd, 238 struct image_tool_params *params) 239 { 240 struct zynqmp_header *zynqhdr = (struct zynqmp_header *)ptr; 241 zynqmpimage_default_header(zynqhdr); 242 243 /* place image directly after header */ 244 zynqhdr->image_offset = 245 cpu_to_le32((uint32_t)sizeof(struct zynqmp_header)); 246 zynqhdr->image_size = cpu_to_le32(params->file_size - 247 sizeof(struct zynqmp_header)); 248 zynqhdr->image_stored_size = zynqhdr->image_size; 249 zynqhdr->image_load = 0xfffc0000; 250 if (params->eflag) 251 zynqhdr->image_load = cpu_to_le32((uint32_t)params->ep); 252 253 zynqhdr->checksum = zynqmpimage_checksum(zynqhdr); 254 } 255 256 U_BOOT_IMAGE_TYPE( 257 zynqmpimage, 258 "Xilinx ZynqMP Boot Image support", 259 sizeof(struct zynqmp_header), 260 (void *)&zynqmpimage_header, 261 zynqmpimage_check_params, 262 zynqmpimage_verify_header, 263 zynqmpimage_print_header, 264 zynqmpimage_set_header, 265 NULL, 266 zynqmpimage_check_image_types, 267 NULL, 268 NULL 269 ); 270