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 doc v1.4 (Chapter 11, Table 11-4) 10 * * ug1137 ZynqMP Software Developer Guide v6.0 (Chapter 16) 11 */ 12 13 #ifndef _ZYNQMPIMAGE_H_ 14 #define _ZYNQMPIMAGE_H_ 15 16 #include <stdint.h> 17 18 #define HEADER_INTERRUPT_DEFAULT (cpu_to_le32(0xeafffffe)) 19 #define HEADER_REGINIT_NULL (cpu_to_le32(0xffffffff)) 20 #define HEADER_WIDTHDETECTION (cpu_to_le32(0xaa995566)) 21 #define HEADER_IMAGEIDENTIFIER (cpu_to_le32(0x584c4e58)) 22 #define HEADER_CPU_SELECT_MASK (0x3 << 10) 23 #define HEADER_CPU_SELECT_R5_SINGLE (0x0 << 10) 24 #define HEADER_CPU_SELECT_A53_32BIT (0x1 << 10) 25 #define HEADER_CPU_SELECT_A53_64BIT (0x2 << 10) 26 #define HEADER_CPU_SELECT_R5_DUAL (0x3 << 10) 27 28 enum { 29 ENCRYPTION_EFUSE = 0xa5c3c5a3, 30 ENCRYPTION_OEFUSE = 0xa5c3c5a7, 31 ENCRYPTION_BBRAM = 0x3a5c3c5a, 32 ENCRYPTION_OBBRAM = 0xa35c7ca5, 33 ENCRYPTION_NONE = 0x0, 34 }; 35 36 struct zynqmp_reginit { 37 uint32_t address; 38 uint32_t data; 39 }; 40 41 #define HEADER_INTERRUPT_VECTORS 8 42 #define HEADER_REGINITS 256 43 44 struct image_header_table { 45 uint32_t version; /* 0x00 */ 46 uint32_t nr_parts; /* 0x04 */ 47 uint32_t partition_header_offset; /* 0x08, divided by 4 */ 48 uint32_t image_header_offset; /* 0x0c, divided by 4 */ 49 uint32_t auth_certificate_offset; /* 0x10 */ 50 uint32_t boot_device; /* 0x14 */ 51 uint32_t __reserved1[9]; /* 0x18 - 0x38 */ 52 uint32_t checksum; /* 0x3c */ 53 }; 54 55 #define PART_ATTR_VEC_LOCATION 0x800000 56 #define PART_ATTR_BS_BLOCK_SIZE_MASK 0x700000 57 #define PART_ATTR_BS_BLOCK_SIZE_DEFAULT 0x000000 58 #define PART_ATTR_BS_BLOCK_SIZE_8MB 0x400000 59 #define PART_ATTR_BIG_ENDIAN 0x040000 60 #define PART_ATTR_PART_OWNER_MASK 0x030000 61 #define PART_ATTR_PART_OWNER_FSBL 0x000000 62 #define PART_ATTR_PART_OWNER_UBOOT 0x010000 63 #define PART_ATTR_RSA_SIG 0x008000 64 #define PART_ATTR_CHECKSUM_MASK 0x007000 65 #define PART_ATTR_CHECKSUM_NONE 0x000000 66 #define PART_ATTR_CHECKSUM_MD5 0x001000 67 #define PART_ATTR_CHECKSUM_SHA2 0x002000 68 #define PART_ATTR_CHECKSUM_SHA3 0x003000 69 #define PART_ATTR_DEST_CPU_SHIFT 8 70 #define PART_ATTR_DEST_CPU_MASK 0x000f00 71 #define PART_ATTR_DEST_CPU_NONE 0x000000 72 #define PART_ATTR_DEST_CPU_A53_0 0x000100 73 #define PART_ATTR_DEST_CPU_A53_1 0x000200 74 #define PART_ATTR_DEST_CPU_A53_2 0x000300 75 #define PART_ATTR_DEST_CPU_A53_3 0x000400 76 #define PART_ATTR_DEST_CPU_R5_0 0x000500 77 #define PART_ATTR_DEST_CPU_R5_1 0x000600 78 #define PART_ATTR_DEST_CPU_R5_L 0x000700 79 #define PART_ATTR_DEST_CPU_PMU 0x000800 80 #define PART_ATTR_ENCRYPTED 0x000080 81 #define PART_ATTR_DEST_DEVICE_SHIFT 4 82 #define PART_ATTR_DEST_DEVICE_MASK 0x000070 83 #define PART_ATTR_DEST_DEVICE_NONE 0x000000 84 #define PART_ATTR_DEST_DEVICE_PS 0x000010 85 #define PART_ATTR_DEST_DEVICE_PL 0x000020 86 #define PART_ATTR_DEST_DEVICE_PMU 0x000030 87 #define PART_ATTR_DEST_DEVICE_XIP 0x000040 88 #define PART_ATTR_A53_EXEC_AARCH32 0x000008 89 #define PART_ATTR_TARGET_EL_SHIFT 1 90 #define PART_ATTR_TARGET_EL_MASK 0x000006 91 #define PART_ATTR_TZ_SECURE 0x000001 92 93 static const char *dest_cpus[0x10] = { 94 "none", "a5x-0", "a5x-1", "a5x-2", "a5x-3", "r5-0", "r5-1", 95 "r5-lockstep", "pmu", "unknown", "unknown", "unknown", "unknown", 96 "unknown", "unknown", "unknown" 97 }; 98 99 struct partition_header { 100 uint32_t len_enc; /* 0x00, divided by 4 */ 101 uint32_t len_unenc; /* 0x04, divided by 4 */ 102 uint32_t len; /* 0x08, divided by 4 */ 103 uint32_t next_partition_offset; /* 0x0c */ 104 uint64_t entry_point; /* 0x10 */ 105 uint64_t load_address; /* 0x18 */ 106 uint32_t offset; /* 0x20, divided by 4 */ 107 uint32_t attributes; /* 0x24 */ 108 uint32_t __reserved1; /* 0x28 */ 109 uint32_t checksum_offset; /* 0x2c, divided by 4 */ 110 uint32_t __reserved2; /* 0x30 */ 111 uint32_t auth_certificate_offset; /* 0x34 */ 112 uint32_t __reserved3; /* 0x38 */ 113 uint32_t checksum; /* 0x3c */ 114 }; 115 116 struct zynqmp_header { 117 uint32_t interrupt_vectors[HEADER_INTERRUPT_VECTORS]; /* 0x0 */ 118 uint32_t width_detection; /* 0x20 */ 119 uint32_t image_identifier; /* 0x24 */ 120 uint32_t encryption; /* 0x28 */ 121 uint32_t image_load; /* 0x2c */ 122 uint32_t image_offset; /* 0x30 */ 123 uint32_t pfw_image_length; /* 0x34 */ 124 uint32_t total_pfw_image_length; /* 0x38 */ 125 uint32_t image_size; /* 0x3c */ 126 uint32_t image_stored_size; /* 0x40 */ 127 uint32_t image_attributes; /* 0x44 */ 128 uint32_t checksum; /* 0x48 */ 129 uint32_t __reserved1[19]; /* 0x4c */ 130 uint32_t image_header_table_offset; /* 0x98 */ 131 uint32_t __reserved2[7]; /* 0x9c */ 132 struct zynqmp_reginit register_init[HEADER_REGINITS]; /* 0xb8 */ 133 uint32_t __reserved4[66]; /* 0x9c0 */ 134 }; 135 136 void zynqmpimage_default_header(struct zynqmp_header *ptr); 137 void zynqmpimage_print_header(const void *ptr); 138 139 #endif /* _ZYNQMPIMAGE_H_ */ 140