1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * (C) Copyright 2008 4 * Marvell Semiconductor <www.marvell.com> 5 * Written-by: Prafulla Wadaskar <prafulla@marvell.com> 6 */ 7 8 #ifndef _KWBIMAGE_H_ 9 #define _KWBIMAGE_H_ 10 11 #include <compiler.h> 12 #include <stdint.h> 13 14 #define KWBIMAGE_MAX_CONFIG ((0x1dc - 0x20)/sizeof(struct reg_config)) 15 #define MAX_TEMPBUF_LEN 32 16 17 /* NAND ECC Mode */ 18 #define IBR_HDR_ECC_DEFAULT 0x00 19 #define IBR_HDR_ECC_FORCED_HAMMING 0x01 20 #define IBR_HDR_ECC_FORCED_RS 0x02 21 #define IBR_HDR_ECC_DISABLED 0x03 22 23 /* Boot Type - block ID */ 24 #define IBR_HDR_I2C_ID 0x4D 25 #define IBR_HDR_SPI_ID 0x5A 26 #define IBR_HDR_NAND_ID 0x8B 27 #define IBR_HDR_SATA_ID 0x78 28 #define IBR_HDR_PEX_ID 0x9C 29 #define IBR_HDR_UART_ID 0x69 30 #define IBR_DEF_ATTRIB 0x00 31 32 #define ALIGN_SUP(x, a) (((x) + (a - 1)) & ~(a - 1)) 33 34 /* Structure of the main header, version 0 (Kirkwood, Dove) */ 35 struct main_hdr_v0 { 36 uint8_t blockid; /* 0x0 */ 37 uint8_t nandeccmode; /* 0x1 */ 38 uint16_t nandpagesize; /* 0x2-0x3 */ 39 uint32_t blocksize; /* 0x4-0x7 */ 40 uint32_t rsvd1; /* 0x8-0xB */ 41 uint32_t srcaddr; /* 0xC-0xF */ 42 uint32_t destaddr; /* 0x10-0x13 */ 43 uint32_t execaddr; /* 0x14-0x17 */ 44 uint8_t satapiomode; /* 0x18 */ 45 uint8_t rsvd3; /* 0x19 */ 46 uint16_t ddrinitdelay; /* 0x1A-0x1B */ 47 uint16_t rsvd2; /* 0x1C-0x1D */ 48 uint8_t ext; /* 0x1E */ 49 uint8_t checksum; /* 0x1F */ 50 }; 51 52 struct ext_hdr_v0_reg { 53 uint32_t raddr; 54 uint32_t rdata; 55 }; 56 57 #define EXT_HDR_V0_REG_COUNT ((0x1dc - 0x20) / sizeof(struct ext_hdr_v0_reg)) 58 59 struct ext_hdr_v0 { 60 uint32_t offset; 61 uint8_t reserved[0x20 - sizeof(uint32_t)]; 62 struct ext_hdr_v0_reg rcfg[EXT_HDR_V0_REG_COUNT]; 63 uint8_t reserved2[7]; 64 uint8_t checksum; 65 }; 66 67 struct kwb_header { 68 struct main_hdr_v0 kwb_hdr; 69 struct ext_hdr_v0 kwb_exthdr; 70 }; 71 72 /* Structure of the main header, version 1 (Armada 370/38x/XP) */ 73 struct main_hdr_v1 { 74 uint8_t blockid; /* 0x0 */ 75 uint8_t flags; /* 0x1 */ 76 uint16_t reserved2; /* 0x2-0x3 */ 77 uint32_t blocksize; /* 0x4-0x7 */ 78 uint8_t version; /* 0x8 */ 79 uint8_t headersz_msb; /* 0x9 */ 80 uint16_t headersz_lsb; /* 0xA-0xB */ 81 uint32_t srcaddr; /* 0xC-0xF */ 82 uint32_t destaddr; /* 0x10-0x13 */ 83 uint32_t execaddr; /* 0x14-0x17 */ 84 uint8_t options; /* 0x18 */ 85 uint8_t nandblocksize; /* 0x19 */ 86 uint8_t nandbadblklocation; /* 0x1A */ 87 uint8_t reserved4; /* 0x1B */ 88 uint16_t reserved5; /* 0x1C-0x1D */ 89 uint8_t ext; /* 0x1E */ 90 uint8_t checksum; /* 0x1F */ 91 }; 92 93 /* 94 * Main header options 95 */ 96 #define MAIN_HDR_V1_OPT_BAUD_DEFAULT 0 97 #define MAIN_HDR_V1_OPT_BAUD_2400 0x1 98 #define MAIN_HDR_V1_OPT_BAUD_4800 0x2 99 #define MAIN_HDR_V1_OPT_BAUD_9600 0x3 100 #define MAIN_HDR_V1_OPT_BAUD_19200 0x4 101 #define MAIN_HDR_V1_OPT_BAUD_38400 0x5 102 #define MAIN_HDR_V1_OPT_BAUD_57600 0x6 103 #define MAIN_HDR_V1_OPT_BAUD_115200 0x7 104 105 /* 106 * Header for the optional headers, version 1 (Armada 370, Armada XP) 107 */ 108 struct opt_hdr_v1 { 109 uint8_t headertype; 110 uint8_t headersz_msb; 111 uint16_t headersz_lsb; 112 char data[0]; 113 }; 114 115 /* 116 * Public Key data in DER format 117 */ 118 struct pubkey_der_v1 { 119 uint8_t key[524]; 120 }; 121 122 /* 123 * Signature (RSA 2048) 124 */ 125 struct sig_v1 { 126 uint8_t sig[256]; 127 }; 128 129 /* 130 * Structure of secure header (Armada 38x) 131 */ 132 struct secure_hdr_v1 { 133 uint8_t headertype; /* 0x0 */ 134 uint8_t headersz_msb; /* 0x1 */ 135 uint16_t headersz_lsb; /* 0x2 - 0x3 */ 136 uint32_t reserved1; /* 0x4 - 0x7 */ 137 struct pubkey_der_v1 kak; /* 0x8 - 0x213 */ 138 uint8_t jtag_delay; /* 0x214 */ 139 uint8_t reserved2; /* 0x215 */ 140 uint16_t reserved3; /* 0x216 - 0x217 */ 141 uint32_t boxid; /* 0x218 - 0x21B */ 142 uint32_t flashid; /* 0x21C - 0x21F */ 143 struct sig_v1 hdrsig; /* 0x220 - 0x31F */ 144 struct sig_v1 imgsig; /* 0x320 - 0x41F */ 145 struct pubkey_der_v1 csk[16]; /* 0x420 - 0x24DF */ 146 struct sig_v1 csksig; /* 0x24E0 - 0x25DF */ 147 uint8_t next; /* 0x25E0 */ 148 uint8_t reserved4; /* 0x25E1 */ 149 uint16_t reserved5; /* 0x25E2 - 0x25E3 */ 150 }; 151 152 /* 153 * Various values for the opt_hdr_v1->headertype field, describing the 154 * different types of optional headers. The "secure" header contains 155 * informations related to secure boot (encryption keys, etc.). The 156 * "binary" header contains ARM binary code to be executed prior to 157 * executing the main payload (usually the bootloader). This is 158 * typically used to execute DDR3 training code. The "register" header 159 * allows to describe a set of (address, value) tuples that are 160 * generally used to configure the DRAM controller. 161 */ 162 #define OPT_HDR_V1_SECURE_TYPE 0x1 163 #define OPT_HDR_V1_BINARY_TYPE 0x2 164 #define OPT_HDR_V1_REGISTER_TYPE 0x3 165 166 #define KWBHEADER_V1_SIZE(hdr) \ 167 (((hdr)->headersz_msb << 16) | le16_to_cpu((hdr)->headersz_lsb)) 168 169 enum kwbimage_cmd { 170 CMD_INVALID, 171 CMD_BOOT_FROM, 172 CMD_NAND_ECC_MODE, 173 CMD_NAND_PAGE_SIZE, 174 CMD_SATA_PIO_MODE, 175 CMD_DDR_INIT_DELAY, 176 CMD_DATA 177 }; 178 179 enum kwbimage_cmd_types { 180 CFG_INVALID = -1, 181 CFG_COMMAND, 182 CFG_DATA0, 183 CFG_DATA1 184 }; 185 186 /* 187 * functions 188 */ 189 void init_kwb_image_type (void); 190 191 /* 192 * Byte 8 of the image header contains the version number. In the v0 193 * header, byte 8 was reserved, and always set to 0. In the v1 header, 194 * byte 8 has been changed to a proper field, set to 1. 195 */ 196 static inline unsigned int image_version(void *header) 197 { 198 unsigned char *ptr = header; 199 return ptr[8]; 200 } 201 202 #endif /* _KWBIMAGE_H_ */ 203