[thirdparty/u-boot.git] / tools / zynqimage.c

// SPDX-License-Identifier: GPL-2.0+
/*
 * Copyright (C) 2015 Nathan Rossi <nathan@nathanrossi.com>
 *
 * The following Boot Header format/structures and values are defined in the
 * following documents:
 *   * Xilinx Zynq-7000 Technical Reference Manual (Section 6.3)
 *   * Xilinx Zynq-7000 Software Developers Guide (Appendix A.7 and A.8)
 *
 * Expected Header Size = 0x8C0
 * Forced as 'little' endian, 32-bit words
 *
 *  0x  0 - Interrupt Table (8 words)
 *  ...     (Default value = 0xeafffffe)
 *  0x 1f
 *  0x 20 - Width Detection
 *         * DEFAULT_WIDTHDETECTION    0xaa995566
 *  0x 24 - Image Identifier
 *         * DEFAULT_IMAGEIDENTIFIER   0x584c4e58
 *  0x 28 - Encryption
 *         * 0x00000000 - None
 *         * 0xa5c3c5a3 - eFuse
 *         * 0x3a5c3c5a - bbRam
 *  0x 2C - User Field
 *  0x 30 - Image Offset
 *  0x 34 - Image Size
 *  0x 38 - Reserved (0x00000000) (according to spec)
 *          * FSBL defines this field for Image Destination Address.
 *  0x 3C - Image Load
 *  0x 40 - Image Stored Size
 *  0x 44 - Reserved (0x00000000) (according to spec)
 *          * FSBL defines this field for QSPI configuration Data.
 *  0x 48 - Checksum
 *  0x 4c - Unused (21 words)
 *  ...
 *  0x 9c
 *  0x a0 - Register Initialization, 256 Address and Data word pairs
 *         * List is terminated with an address of 0xffffffff or
 *  ...    * at the max number of entries
 *  0x89c
 *  0x8a0 - Unused (8 words)
 *  ...
 *  0x8bf
 *  0x8c0 - Data/Image starts here or above
 */

#include "imagetool.h"
#include "mkimage.h"
#include <image.h>

#define HEADER_INTERRUPT_DEFAULT (cpu_to_le32(0xeafffffe))
#define HEADER_REGINIT_NULL (cpu_to_le32(0xffffffff))
#define HEADER_WIDTHDETECTION (cpu_to_le32(0xaa995566))
#define HEADER_IMAGEIDENTIFIER (cpu_to_le32(0x584c4e58))

enum {
	ENCRYPTION_EFUSE = 0xa5c3c5a3,
	ENCRYPTION_BBRAM = 0x3a5c3c5a,
	ENCRYPTION_NONE = 0x0,
};

struct zynq_reginit {
	uint32_t address;
	uint32_t data;
};

#define HEADER_INTERRUPT_VECTORS 8
#define HEADER_REGINITS 256

struct zynq_header {
	uint32_t interrupt_vectors[HEADER_INTERRUPT_VECTORS]; /* 0x0 */
	uint32_t width_detection; /* 0x20 */
	uint32_t image_identifier; /* 0x24 */
	uint32_t encryption; /* 0x28 */
	uint32_t user_field; /* 0x2c */
	uint32_t image_offset; /* 0x30 */
	uint32_t image_size; /* 0x34 */
	uint32_t __reserved1; /* 0x38 */
	uint32_t image_load; /* 0x3c */
	uint32_t image_stored_size; /* 0x40 */
	uint32_t __reserved2; /* 0x44 */
	uint32_t checksum; /* 0x48 */
	uint32_t __reserved3[21]; /* 0x4c */
	struct zynq_reginit register_init[HEADER_REGINITS]; /* 0xa0 */
	uint32_t __reserved4[8]; /* 0x8a0 */
};

static struct zynq_header zynqimage_header;

static uint32_t zynqimage_checksum(struct zynq_header *ptr)
{
	uint32_t checksum = 0;

	if (ptr == NULL)
		return 0;

	checksum += le32_to_cpu(ptr->width_detection);
	checksum += le32_to_cpu(ptr->image_identifier);
	checksum += le32_to_cpu(ptr->encryption);
	checksum += le32_to_cpu(ptr->user_field);
	checksum += le32_to_cpu(ptr->image_offset);
	checksum += le32_to_cpu(ptr->image_size);
	checksum += le32_to_cpu(ptr->__reserved1);
	checksum += le32_to_cpu(ptr->image_load);
	checksum += le32_to_cpu(ptr->image_stored_size);
	checksum += le32_to_cpu(ptr->__reserved2);
	checksum = ~checksum;

	return cpu_to_le32(checksum);
}

static void zynqimage_default_header(struct zynq_header *ptr)
{
	int i;

	if (ptr == NULL)
		return;

	ptr->width_detection = HEADER_WIDTHDETECTION;
	ptr->image_identifier = HEADER_IMAGEIDENTIFIER;
	ptr->encryption = cpu_to_le32(ENCRYPTION_NONE);

	/* Setup not-supported/constant/reserved fields */
	for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++)
		ptr->interrupt_vectors[i] = HEADER_INTERRUPT_DEFAULT;

	for (i = 0; i < HEADER_REGINITS; i++) {
		ptr->register_init[i].address = HEADER_REGINIT_NULL;
		ptr->register_init[i].data = HEADER_REGINIT_NULL;
	}

	/*
	 * Certain reserved fields are required to be set to 0, ensure they are
	 * set as such.
	 */
	ptr->__reserved1 = 0x0;
	ptr->__reserved2 = 0x0;
}

/* mkimage glue functions */
static int zynqimage_verify_header(unsigned char *ptr, int image_size,
		struct image_tool_params *params)
{
	struct zynq_header *zynqhdr = (struct zynq_header *)ptr;

	if (image_size < sizeof(struct zynq_header))
		return -1;

	if (zynqhdr->__reserved1 != 0)
		return -1;

	if (zynqhdr->__reserved2 != 0)
		return -1;

	if (zynqhdr->width_detection != HEADER_WIDTHDETECTION)
		return -1;
	if (zynqhdr->image_identifier != HEADER_IMAGEIDENTIFIER)
		return -1;

	if (zynqimage_checksum(zynqhdr) != zynqhdr->checksum)
		return -1;

	return 0;
}

static void zynqimage_print_header(const void *ptr)
{
	struct zynq_header *zynqhdr = (struct zynq_header *)ptr;
	int i;

	printf("Image Type   : Xilinx Zynq Boot Image support\n");
	printf("Image Offset : 0x%08x\n", le32_to_cpu(zynqhdr->image_offset));
	printf("Image Size   : %lu bytes (%lu bytes packed)\n",
	       (unsigned long)le32_to_cpu(zynqhdr->image_size),
	       (unsigned long)le32_to_cpu(zynqhdr->image_stored_size));
	printf("Image Load   : 0x%08x\n", le32_to_cpu(zynqhdr->image_load));
	printf("User Field   : 0x%08x\n", le32_to_cpu(zynqhdr->user_field));
	printf("Checksum     : 0x%08x\n", le32_to_cpu(zynqhdr->checksum));

	for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++) {
		if (zynqhdr->interrupt_vectors[i] == HEADER_INTERRUPT_DEFAULT)
			continue;

		printf("Modified Interrupt Vector Address [%d]: 0x%08x\n", i,
		       le32_to_cpu(zynqhdr->interrupt_vectors[i]));
	}

	for (i = 0; i < HEADER_REGINITS; i++) {
		if (zynqhdr->register_init[i].address == HEADER_REGINIT_NULL)
			break;

		if (i == 0)
			printf("Custom Register Initialization:\n");

		printf("    @ 0x%08x -> 0x%08x\n",
		       le32_to_cpu(zynqhdr->register_init[i].address),
		       le32_to_cpu(zynqhdr->register_init[i].data));
	}
}

static int zynqimage_check_params(struct image_tool_params *params)
{
	if (!params)
		return 0;

	if (params->addr != 0x0) {
		fprintf(stderr, "Error: Load Address cannot be specified.\n");
		return -1;
	}

	/*
	 * If the entry point is specified ensure it is 64 byte aligned.
	 */
	if (params->eflag && (params->ep % 64 != 0)) {
		fprintf(stderr,
			"Error: Entry Point must be aligned to a 64-byte boundary.\n");
		return -1;
	}

	return !(params->lflag || params->dflag);
}

static int zynqimage_check_image_types(uint8_t type)
{
	if (type == IH_TYPE_ZYNQIMAGE)
		return EXIT_SUCCESS;
	return EXIT_FAILURE;
}

static void zynqimage_parse_initparams(struct zynq_header *zynqhdr,
	const char *filename)
{
	FILE *fp;
	struct zynq_reginit reginit;
	unsigned int reg_count = 0;
	int r, err;
	struct stat path_stat;

	/* Expect a table of register-value pairs, e.g. "0x12345678 0x4321" */
	fp = fopen(filename, "r");
	if (!fp) {
		fprintf(stderr, "Cannot open initparams file: %s\n", filename);
		exit(1);
	}

	err = fstat(fileno(fp), &path_stat);
	if (err) {
		fclose(fp);
		return;
	}

	if (!S_ISREG(path_stat.st_mode)) {
		fclose(fp);
		return;
	}

	do {
		r = fscanf(fp, "%x %x", &reginit.address, &reginit.data);
		if (r == 2) {
			zynqhdr->register_init[reg_count] = reginit;
			++reg_count;
		}
		r = fscanf(fp, "%*[^\n]\n"); /* Skip to next line */
	} while ((r != EOF) && (reg_count < HEADER_REGINITS));
	fclose(fp);
}

static void zynqimage_set_header(void *ptr, struct stat *sbuf, int ifd,
		struct image_tool_params *params)
{
	struct zynq_header *zynqhdr = (struct zynq_header *)ptr;
	zynqimage_default_header(zynqhdr);

	/* place image directly after header */
	zynqhdr->image_offset =
		cpu_to_le32((uint32_t)sizeof(struct zynq_header));
	zynqhdr->image_size = cpu_to_le32((uint32_t)sbuf->st_size);
	zynqhdr->image_stored_size = zynqhdr->image_size;
	zynqhdr->image_load = 0x0;
	if (params->eflag)
		zynqhdr->image_load = cpu_to_le32((uint32_t)params->ep);

	/* User can pass in text file with init list */
	if (strlen(params->imagename2))
		zynqimage_parse_initparams(zynqhdr, params->imagename2);

	zynqhdr->checksum = zynqimage_checksum(zynqhdr);
}

U_BOOT_IMAGE_TYPE(
	zynqimage,
	"Xilinx Zynq Boot Image support",
	sizeof(struct zynq_header),
	(void *)&zynqimage_header,
	zynqimage_check_params,
	zynqimage_verify_header,
	zynqimage_print_header,
	zynqimage_set_header,
	NULL,
	zynqimage_check_image_types,
	NULL,
	NULL
);
Commit	Line	Data
83d290c5	1	// SPDX-License-Identifier: GPL-2.0+
66eef1e7 NR	2	/*
	3	* Copyright (C) 2015 Nathan Rossi <nathan@nathanrossi.com>
	4	*
66eef1e7 NR	5	* The following Boot Header format/structures and values are defined in the
	6	* following documents:
	7	* * Xilinx Zynq-7000 Technical Reference Manual (Section 6.3)
	8	* * Xilinx Zynq-7000 Software Developers Guide (Appendix A.7 and A.8)
	9	*
	10	* Expected Header Size = 0x8C0
	11	* Forced as 'little' endian, 32-bit words
	12	*
	13	* 0x 0 - Interrupt Table (8 words)
	14	* ... (Default value = 0xeafffffe)
	15	* 0x 1f
	16	* 0x 20 - Width Detection
	17	* * DEFAULT_WIDTHDETECTION 0xaa995566
	18	* 0x 24 - Image Identifier
	19	* * DEFAULT_IMAGEIDENTIFIER 0x584c4e58
	20	* 0x 28 - Encryption
	21	* * 0x00000000 - None
	22	* * 0xa5c3c5a3 - eFuse
	23	* * 0x3a5c3c5a - bbRam
	24	* 0x 2C - User Field
	25	* 0x 30 - Image Offset
	26	* 0x 34 - Image Size
	27	* 0x 38 - Reserved (0x00000000) (according to spec)
	28	* * FSBL defines this field for Image Destination Address.
	29	* 0x 3C - Image Load
	30	* 0x 40 - Image Stored Size
	31	* 0x 44 - Reserved (0x00000000) (according to spec)
	32	* * FSBL defines this field for QSPI configuration Data.
	33	* 0x 48 - Checksum
	34	* 0x 4c - Unused (21 words)
	35	* ...
	36	* 0x 9c
	37	* 0x a0 - Register Initialization, 256 Address and Data word pairs
	38	* * List is terminated with an address of 0xffffffff or
	39	* ... * at the max number of entries
	40	* 0x89c
	41	* 0x8a0 - Unused (8 words)
	42	* ...
	43	* 0x8bf
	44	* 0x8c0 - Data/Image starts here or above
	45	*/
	46
	47	#include "imagetool.h"
	48	#include "mkimage.h"
	49	#include <image.h>
	50
	51	#define HEADER_INTERRUPT_DEFAULT (cpu_to_le32(0xeafffffe))
	52	#define HEADER_REGINIT_NULL (cpu_to_le32(0xffffffff))
	53	#define HEADER_WIDTHDETECTION (cpu_to_le32(0xaa995566))
	54	#define HEADER_IMAGEIDENTIFIER (cpu_to_le32(0x584c4e58))
	55
	56	enum {
	57	ENCRYPTION_EFUSE = 0xa5c3c5a3,
	58	ENCRYPTION_BBRAM = 0x3a5c3c5a,
	59	ENCRYPTION_NONE = 0x0,
	60	};
	61
	62	struct zynq_reginit {
	63	uint32_t address;
	64	uint32_t data;
	65	};
	66
	67	#define HEADER_INTERRUPT_VECTORS 8
	68	#define HEADER_REGINITS 256
69
70	struct zynq_header {
71	uint32_t interrupt_vectors[HEADER_INTERRUPT_VECTORS]; /* 0x0 */
72	uint32_t width_detection; /* 0x20 */
73	uint32_t image_identifier; /* 0x24 */
74	uint32_t encryption; /* 0x28 */
75	uint32_t user_field; /* 0x2c */
76	uint32_t image_offset; /* 0x30 */
77	uint32_t image_size; /* 0x34 */
78	uint32_t __reserved1; /* 0x38 */
79	uint32_t image_load; /* 0x3c */
80	uint32_t image_stored_size; /* 0x40 */
81	uint32_t __reserved2; /* 0x44 */
82	uint32_t checksum; /* 0x48 */
83	uint32_t __reserved3[21]; /* 0x4c */
84	struct zynq_reginit register_init[HEADER_REGINITS]; /* 0xa0 */
85	uint32_t __reserved4[8]; /* 0x8a0 */
86	};
87
88	static struct zynq_header zynqimage_header;
89
90	static uint32_t zynqimage_checksum(struct zynq_header *ptr)
91	{
92	uint32_t checksum = 0;
93
94	if (ptr == NULL)
95	return 0;
96
97	checksum += le32_to_cpu(ptr->width_detection);
98	checksum += le32_to_cpu(ptr->image_identifier);
99	checksum += le32_to_cpu(ptr->encryption);
100	checksum += le32_to_cpu(ptr->user_field);
101	checksum += le32_to_cpu(ptr->image_offset);
102	checksum += le32_to_cpu(ptr->image_size);
103	checksum += le32_to_cpu(ptr->__reserved1);
104	checksum += le32_to_cpu(ptr->image_load);
105	checksum += le32_to_cpu(ptr->image_stored_size);
106	checksum += le32_to_cpu(ptr->__reserved2);
107	checksum = ~checksum;
108
109	return cpu_to_le32(checksum);
110	}
111
112	static void zynqimage_default_header(struct zynq_header *ptr)
113	{
114	int i;
115
116	if (ptr == NULL)
117	return;
118
119	ptr->width_detection = HEADER_WIDTHDETECTION;
120	ptr->image_identifier = HEADER_IMAGEIDENTIFIER;
121	ptr->encryption = cpu_to_le32(ENCRYPTION_NONE);
122
123	/* Setup not-supported/constant/reserved fields */
124	for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++)
125	ptr->interrupt_vectors[i] = HEADER_INTERRUPT_DEFAULT;
126
127	for (i = 0; i < HEADER_REGINITS; i++) {
128	ptr->register_init[i].address = HEADER_REGINIT_NULL;
129	ptr->register_init[i].data = HEADER_REGINIT_NULL;
130	}
131
132	/*
133	* Certain reserved fields are required to be set to 0, ensure they are
134	* set as such.
135	*/
136	ptr->__reserved1 = 0x0;
137	ptr->__reserved2 = 0x0;
138	}
139
140	/* mkimage glue functions */
141	static int zynqimage_verify_header(unsigned char *ptr, int image_size,
142	struct image_tool_params *params)
143	{
144	struct zynq_header zynqhdr = (struct zynq_header )ptr;
145
146	if (image_size < sizeof(struct zynq_header))
147	return -1;
148
d28baea0 MS	149	if (zynqhdr->__reserved1 != 0)
	150	return -1;
	151
	152	if (zynqhdr->__reserved2 != 0)
	153	return -1;
	154
66eef1e7 NR	155	if (zynqhdr->width_detection != HEADER_WIDTHDETECTION)
	156	return -1;
	157	if (zynqhdr->image_identifier != HEADER_IMAGEIDENTIFIER)
	158	return -1;
	159
	160	if (zynqimage_checksum(zynqhdr) != zynqhdr->checksum)
	161	return -1;
	162
	163	return 0;
	164	}
	165
	166	static void zynqimage_print_header(const void *ptr)
	167	{
	168	struct zynq_header zynqhdr = (struct zynq_header )ptr;
	169	int i;
	170
	171	printf("Image Type : Xilinx Zynq Boot Image support\n");
	172	printf("Image Offset : 0x%08x\n", le32_to_cpu(zynqhdr->image_offset));
	173	printf("Image Size : %lu bytes (%lu bytes packed)\n",
	174	(unsigned long)le32_to_cpu(zynqhdr->image_size),
	175	(unsigned long)le32_to_cpu(zynqhdr->image_stored_size));
	176	printf("Image Load : 0x%08x\n", le32_to_cpu(zynqhdr->image_load));
	177	printf("User Field : 0x%08x\n", le32_to_cpu(zynqhdr->user_field));
	178	printf("Checksum : 0x%08x\n", le32_to_cpu(zynqhdr->checksum));
	179
	180	for (i = 0; i < HEADER_INTERRUPT_VECTORS; i++) {
	181	if (zynqhdr->interrupt_vectors[i] == HEADER_INTERRUPT_DEFAULT)
	182	continue;
	183
	184	printf("Modified Interrupt Vector Address [%d]: 0x%08x\n", i,
	185	le32_to_cpu(zynqhdr->interrupt_vectors[i]));
	186	}
	187
	188	for (i = 0; i < HEADER_REGINITS; i++) {
	189	if (zynqhdr->register_init[i].address == HEADER_REGINIT_NULL)
	190	break;
	191
	192	if (i == 0)
	193	printf("Custom Register Initialization:\n");
	194
	195	printf(" @ 0x%08x -> 0x%08x\n",
	196	le32_to_cpu(zynqhdr->register_init[i].address),
	197	le32_to_cpu(zynqhdr->register_init[i].data));
	198	}
	199	}
	200
	201	static int zynqimage_check_params(struct image_tool_params *params)
	202	{
	203	if (!params)
	204	return 0;
	205
	206	if (params->addr != 0x0) {
	207	fprintf(stderr, "Error: Load Address cannot be specified.\n");
	208	return -1;
	209	}
	210
	211	/*
	212	* If the entry point is specified ensure it is 64 byte aligned.
	213	*/
	214	if (params->eflag && (params->ep % 64 != 0)) {
	215	fprintf(stderr,
	216	"Error: Entry Point must be aligned to a 64-byte boundary.\n");
	217	return -1;
	218	}
219
bc366050	220	return !(params->lflag \|\| params->dflag);
66eef1e7 NR	221	}
	222
	223	static int zynqimage_check_image_types(uint8_t type)
	224	{
	225	if (type == IH_TYPE_ZYNQIMAGE)
	226	return EXIT_SUCCESS;
	227	return EXIT_FAILURE;
	228	}
	229
3b646080 ML	230	static void zynqimage_parse_initparams(struct zynq_header *zynqhdr,
	231	const char *filename)
	232	{
ebe0f53f	233	FILE *fp;
3b646080 ML	234	struct zynq_reginit reginit;
3b646080 ML	235	unsigned int reg_count = 0;
ebe0f53f MS	236	int r, err;
ebe0f53f MS	237	struct stat path_stat;
3b646080	238
ebe0f53f MS	239	/* Expect a table of register-value pairs, e.g. "0x12345678 0x4321" */
ebe0f53f MS	240	fp = fopen(filename, "r");
3b646080 ML	241	if (!fp) {
	242	fprintf(stderr, "Cannot open initparams file: %s\n", filename);
	243	exit(1);
	244	}
ebe0f53f MS	245
ebe0f53f MS	246	err = fstat(fileno(fp), &path_stat);
ac71d410 MS	247	if (err) {
ac71d410 MS	248	fclose(fp);
ebe0f53f	249	return;
ac71d410	250	}
ebe0f53f	251
ac71d410 MS	252	if (!S_ISREG(path_stat.st_mode)) {
ac71d410 MS	253	fclose(fp);
ebe0f53f	254	return;
ac71d410	255	}
ebe0f53f	256
3b646080 ML	257	do {
	258	r = fscanf(fp, "%x %x", &reginit.address, &reginit.data);
	259	if (r == 2) {
	260	zynqhdr->register_init[reg_count] = reginit;
	261	++reg_count;
	262	}
	263	r = fscanf(fp, "%[^\n]\n"); / Skip to next line */
	264	} while ((r != EOF) && (reg_count < HEADER_REGINITS));
	265	fclose(fp);
	266	}
	267
66eef1e7 NR	268	static void zynqimage_set_header(void ptr, struct stat sbuf, int ifd,
	269	struct image_tool_params *params)
	270	{
	271	struct zynq_header zynqhdr = (struct zynq_header )ptr;
	272	zynqimage_default_header(zynqhdr);
	273
	274	/* place image directly after header */
	275	zynqhdr->image_offset =
	276	cpu_to_le32((uint32_t)sizeof(struct zynq_header));
	277	zynqhdr->image_size = cpu_to_le32((uint32_t)sbuf->st_size);
	278	zynqhdr->image_stored_size = zynqhdr->image_size;
	279	zynqhdr->image_load = 0x0;
	280	if (params->eflag)
	281	zynqhdr->image_load = cpu_to_le32((uint32_t)params->ep);
	282
3b646080 ML	283	/* User can pass in text file with init list */
	284	if (strlen(params->imagename2))
	285	zynqimage_parse_initparams(zynqhdr, params->imagename2);
	286
66eef1e7 NR	287	zynqhdr->checksum = zynqimage_checksum(zynqhdr);
	288	}
	289
	290	U_BOOT_IMAGE_TYPE(
	291	zynqimage,
	292	"Xilinx Zynq Boot Image support",
	293	sizeof(struct zynq_header),
	294	(void *)&zynqimage_header,
	295	zynqimage_check_params,
	296	zynqimage_verify_header,
	297	zynqimage_print_header,
	298	zynqimage_set_header,
	299	NULL,
	300	zynqimage_check_image_types,
	301	NULL,
	302	NULL
	303	);