xref: /aosp_15_r20/external/arm-trusted-firmware/tools/stm32image/stm32image.c (revision 54fd6939e177f8ff529b10183254802c76df6d08)
1*54fd6939SJiyong Park /*
2*54fd6939SJiyong Park  * Copyright (c) 2017-2021, STMicroelectronics - All Rights Reserved
3*54fd6939SJiyong Park  *
4*54fd6939SJiyong Park  * SPDX-License-Identifier: BSD-3-Clause
5*54fd6939SJiyong Park  */
6*54fd6939SJiyong Park 
7*54fd6939SJiyong Park #include <asm/byteorder.h>
8*54fd6939SJiyong Park #include <errno.h>
9*54fd6939SJiyong Park #include <fcntl.h>
10*54fd6939SJiyong Park #include <stdint.h>
11*54fd6939SJiyong Park #include <stdio.h>
12*54fd6939SJiyong Park #include <stdlib.h>
13*54fd6939SJiyong Park #include <string.h>
14*54fd6939SJiyong Park #include <sys/mman.h>
15*54fd6939SJiyong Park #include <sys/stat.h>
16*54fd6939SJiyong Park #include <sys/types.h>
17*54fd6939SJiyong Park #include <unistd.h>
18*54fd6939SJiyong Park 
19*54fd6939SJiyong Park /* Magic = 'S' 'T' 'M' 0x32 */
20*54fd6939SJiyong Park #define HEADER_MAGIC		__be32_to_cpu(0x53544D32)
21*54fd6939SJiyong Park #define VER_MAJOR		2
22*54fd6939SJiyong Park #define VER_MINOR		1
23*54fd6939SJiyong Park #define VER_VARIANT		0
24*54fd6939SJiyong Park #define HEADER_VERSION_V1	0x1
25*54fd6939SJiyong Park #define TF_BINARY_TYPE		0x10
26*54fd6939SJiyong Park 
27*54fd6939SJiyong Park /* Default option : bit0 => no signature */
28*54fd6939SJiyong Park #define HEADER_DEFAULT_OPTION	(__cpu_to_le32(0x00000001))
29*54fd6939SJiyong Park 
30*54fd6939SJiyong Park struct stm32_header {
31*54fd6939SJiyong Park 	uint32_t magic_number;
32*54fd6939SJiyong Park 	uint8_t image_signature[64];
33*54fd6939SJiyong Park 	uint32_t image_checksum;
34*54fd6939SJiyong Park 	uint8_t  header_version[4];
35*54fd6939SJiyong Park 	uint32_t image_length;
36*54fd6939SJiyong Park 	uint32_t image_entry_point;
37*54fd6939SJiyong Park 	uint32_t reserved1;
38*54fd6939SJiyong Park 	uint32_t load_address;
39*54fd6939SJiyong Park 	uint32_t reserved2;
40*54fd6939SJiyong Park 	uint32_t version_number;
41*54fd6939SJiyong Park 	uint32_t option_flags;
42*54fd6939SJiyong Park 	uint32_t ecdsa_algorithm;
43*54fd6939SJiyong Park 	uint8_t ecdsa_public_key[64];
44*54fd6939SJiyong Park 	uint8_t padding[83];
45*54fd6939SJiyong Park 	uint8_t binary_type;
46*54fd6939SJiyong Park };
47*54fd6939SJiyong Park 
stm32image_default_header(struct stm32_header * ptr)48*54fd6939SJiyong Park static void stm32image_default_header(struct stm32_header *ptr)
49*54fd6939SJiyong Park {
50*54fd6939SJiyong Park 	if (!ptr) {
51*54fd6939SJiyong Park 		return;
52*54fd6939SJiyong Park 	}
53*54fd6939SJiyong Park 
54*54fd6939SJiyong Park 	ptr->magic_number = HEADER_MAGIC;
55*54fd6939SJiyong Park 	ptr->option_flags = HEADER_DEFAULT_OPTION;
56*54fd6939SJiyong Park 	ptr->ecdsa_algorithm = __cpu_to_le32(1);
57*54fd6939SJiyong Park 	ptr->version_number = __cpu_to_le32(0);
58*54fd6939SJiyong Park 	ptr->binary_type = TF_BINARY_TYPE;
59*54fd6939SJiyong Park }
60*54fd6939SJiyong Park 
stm32image_checksum(void * start,uint32_t len)61*54fd6939SJiyong Park static uint32_t stm32image_checksum(void *start, uint32_t len)
62*54fd6939SJiyong Park {
63*54fd6939SJiyong Park 	uint32_t csum = 0;
64*54fd6939SJiyong Park 	uint32_t hdr_len = sizeof(struct stm32_header);
65*54fd6939SJiyong Park 	uint8_t *p;
66*54fd6939SJiyong Park 
67*54fd6939SJiyong Park 	if (len < hdr_len) {
68*54fd6939SJiyong Park 		return 0;
69*54fd6939SJiyong Park 	}
70*54fd6939SJiyong Park 
71*54fd6939SJiyong Park 	p = (unsigned char *)start + hdr_len;
72*54fd6939SJiyong Park 	len -= hdr_len;
73*54fd6939SJiyong Park 
74*54fd6939SJiyong Park 	while (len > 0) {
75*54fd6939SJiyong Park 		csum += *p;
76*54fd6939SJiyong Park 		p++;
77*54fd6939SJiyong Park 		len--;
78*54fd6939SJiyong Park 	}
79*54fd6939SJiyong Park 
80*54fd6939SJiyong Park 	return csum;
81*54fd6939SJiyong Park }
82*54fd6939SJiyong Park 
stm32image_print_header(const void * ptr)83*54fd6939SJiyong Park static void stm32image_print_header(const void *ptr)
84*54fd6939SJiyong Park {
85*54fd6939SJiyong Park 	struct stm32_header *stm32hdr = (struct stm32_header *)ptr;
86*54fd6939SJiyong Park 
87*54fd6939SJiyong Park 	printf("Image Type   : ST Microelectronics STM32 V%d.%d\n",
88*54fd6939SJiyong Park 	       stm32hdr->header_version[VER_MAJOR],
89*54fd6939SJiyong Park 	       stm32hdr->header_version[VER_MINOR]);
90*54fd6939SJiyong Park 	printf("Image Size   : %lu bytes\n",
91*54fd6939SJiyong Park 	       (unsigned long)__le32_to_cpu(stm32hdr->image_length));
92*54fd6939SJiyong Park 	printf("Image Load   : 0x%08x\n",
93*54fd6939SJiyong Park 	       __le32_to_cpu(stm32hdr->load_address));
94*54fd6939SJiyong Park 	printf("Entry Point  : 0x%08x\n",
95*54fd6939SJiyong Park 	       __le32_to_cpu(stm32hdr->image_entry_point));
96*54fd6939SJiyong Park 	printf("Checksum     : 0x%08x\n",
97*54fd6939SJiyong Park 	       __le32_to_cpu(stm32hdr->image_checksum));
98*54fd6939SJiyong Park 	printf("Option     : 0x%08x\n",
99*54fd6939SJiyong Park 	       __le32_to_cpu(stm32hdr->option_flags));
100*54fd6939SJiyong Park 	printf("Version	   : 0x%08x\n",
101*54fd6939SJiyong Park 	       __le32_to_cpu(stm32hdr->version_number));
102*54fd6939SJiyong Park }
103*54fd6939SJiyong Park 
stm32image_set_header(void * ptr,struct stat * sbuf,int ifd,uint32_t loadaddr,uint32_t ep,uint32_t ver,uint32_t major,uint32_t minor)104*54fd6939SJiyong Park static void stm32image_set_header(void *ptr, struct stat *sbuf, int ifd,
105*54fd6939SJiyong Park 				  uint32_t loadaddr, uint32_t ep, uint32_t ver,
106*54fd6939SJiyong Park 				  uint32_t major, uint32_t minor)
107*54fd6939SJiyong Park {
108*54fd6939SJiyong Park 	struct stm32_header *stm32hdr = (struct stm32_header *)ptr;
109*54fd6939SJiyong Park 
110*54fd6939SJiyong Park 	stm32image_default_header(stm32hdr);
111*54fd6939SJiyong Park 
112*54fd6939SJiyong Park 	stm32hdr->header_version[VER_MAJOR] = major;
113*54fd6939SJiyong Park 	stm32hdr->header_version[VER_MINOR] = minor;
114*54fd6939SJiyong Park 	stm32hdr->load_address = __cpu_to_le32(loadaddr);
115*54fd6939SJiyong Park 	stm32hdr->image_entry_point = __cpu_to_le32(ep);
116*54fd6939SJiyong Park 	stm32hdr->image_length = __cpu_to_le32((uint32_t)sbuf->st_size -
117*54fd6939SJiyong Park 					     sizeof(struct stm32_header));
118*54fd6939SJiyong Park 	stm32hdr->image_checksum =
119*54fd6939SJiyong Park 		__cpu_to_le32(stm32image_checksum(ptr, sbuf->st_size));
120*54fd6939SJiyong Park 	stm32hdr->version_number = __cpu_to_le32(ver);
121*54fd6939SJiyong Park }
122*54fd6939SJiyong Park 
stm32image_create_header_file(char * srcname,char * destname,uint32_t loadaddr,uint32_t entry,uint32_t version,uint32_t major,uint32_t minor)123*54fd6939SJiyong Park static int stm32image_create_header_file(char *srcname, char *destname,
124*54fd6939SJiyong Park 					 uint32_t loadaddr, uint32_t entry,
125*54fd6939SJiyong Park 					 uint32_t version, uint32_t major,
126*54fd6939SJiyong Park 					 uint32_t minor)
127*54fd6939SJiyong Park {
128*54fd6939SJiyong Park 	int src_fd, dest_fd;
129*54fd6939SJiyong Park 	struct stat sbuf;
130*54fd6939SJiyong Park 	unsigned char *ptr;
131*54fd6939SJiyong Park 	struct stm32_header stm32image_header;
132*54fd6939SJiyong Park 
133*54fd6939SJiyong Park 	dest_fd = open(destname, O_RDWR | O_CREAT | O_TRUNC | O_APPEND, 0666);
134*54fd6939SJiyong Park 	if (dest_fd == -1) {
135*54fd6939SJiyong Park 		fprintf(stderr, "Can't open %s: %s\n", destname,
136*54fd6939SJiyong Park 			strerror(errno));
137*54fd6939SJiyong Park 		return -1;
138*54fd6939SJiyong Park 	}
139*54fd6939SJiyong Park 
140*54fd6939SJiyong Park 	src_fd = open(srcname, O_RDONLY);
141*54fd6939SJiyong Park 	if (src_fd == -1) {
142*54fd6939SJiyong Park 		fprintf(stderr, "Can't open %s: %s\n", srcname,
143*54fd6939SJiyong Park 			strerror(errno));
144*54fd6939SJiyong Park 		return -1;
145*54fd6939SJiyong Park 	}
146*54fd6939SJiyong Park 
147*54fd6939SJiyong Park 	if (fstat(src_fd, &sbuf) < 0) {
148*54fd6939SJiyong Park 		return -1;
149*54fd6939SJiyong Park 	}
150*54fd6939SJiyong Park 
151*54fd6939SJiyong Park 	ptr = mmap(NULL, sbuf.st_size, PROT_READ, MAP_SHARED, src_fd, 0);
152*54fd6939SJiyong Park 	if (ptr == MAP_FAILED) {
153*54fd6939SJiyong Park 		fprintf(stderr, "Can't read %s\n", srcname);
154*54fd6939SJiyong Park 		return -1;
155*54fd6939SJiyong Park 	}
156*54fd6939SJiyong Park 
157*54fd6939SJiyong Park 	memset(&stm32image_header, 0, sizeof(struct stm32_header));
158*54fd6939SJiyong Park 
159*54fd6939SJiyong Park 	if (write(dest_fd, &stm32image_header, sizeof(struct stm32_header)) !=
160*54fd6939SJiyong Park 	    sizeof(struct stm32_header)) {
161*54fd6939SJiyong Park 		fprintf(stderr, "Write error %s: %s\n", destname,
162*54fd6939SJiyong Park 			strerror(errno));
163*54fd6939SJiyong Park 		return -1;
164*54fd6939SJiyong Park 	}
165*54fd6939SJiyong Park 
166*54fd6939SJiyong Park 	if (write(dest_fd, ptr, sbuf.st_size) != sbuf.st_size) {
167*54fd6939SJiyong Park 		fprintf(stderr, "Write error on %s: %s\n", destname,
168*54fd6939SJiyong Park 			strerror(errno));
169*54fd6939SJiyong Park 		return -1;
170*54fd6939SJiyong Park 	}
171*54fd6939SJiyong Park 
172*54fd6939SJiyong Park 	munmap((void *)ptr, sbuf.st_size);
173*54fd6939SJiyong Park 	close(src_fd);
174*54fd6939SJiyong Park 
175*54fd6939SJiyong Park 	if (fstat(dest_fd, &sbuf) < 0) {
176*54fd6939SJiyong Park 		return -1;
177*54fd6939SJiyong Park 	}
178*54fd6939SJiyong Park 
179*54fd6939SJiyong Park 	ptr = mmap(0, sbuf.st_size, PROT_READ | PROT_WRITE, MAP_SHARED,
180*54fd6939SJiyong Park 		   dest_fd, 0);
181*54fd6939SJiyong Park 
182*54fd6939SJiyong Park 	if (ptr == MAP_FAILED) {
183*54fd6939SJiyong Park 		fprintf(stderr, "Can't write %s\n", destname);
184*54fd6939SJiyong Park 		return -1;
185*54fd6939SJiyong Park 	}
186*54fd6939SJiyong Park 
187*54fd6939SJiyong Park 	stm32image_set_header(ptr, &sbuf, dest_fd, loadaddr, entry, version,
188*54fd6939SJiyong Park 			      major, minor);
189*54fd6939SJiyong Park 
190*54fd6939SJiyong Park 	stm32image_print_header(ptr);
191*54fd6939SJiyong Park 
192*54fd6939SJiyong Park 	munmap((void *)ptr, sbuf.st_size);
193*54fd6939SJiyong Park 	close(dest_fd);
194*54fd6939SJiyong Park 	return 0;
195*54fd6939SJiyong Park }
196*54fd6939SJiyong Park 
main(int argc,char * argv[])197*54fd6939SJiyong Park int main(int argc, char *argv[])
198*54fd6939SJiyong Park {
199*54fd6939SJiyong Park 	int opt, loadaddr = -1, entry = -1, err = 0, version = 0;
200*54fd6939SJiyong Park 	int major = HEADER_VERSION_V1;
201*54fd6939SJiyong Park 	int minor = 0;
202*54fd6939SJiyong Park 	char *dest = NULL, *src = NULL;
203*54fd6939SJiyong Park 
204*54fd6939SJiyong Park 	while ((opt = getopt(argc, argv, ":s:d:l:e:v:m:n:")) != -1) {
205*54fd6939SJiyong Park 		switch (opt) {
206*54fd6939SJiyong Park 		case 's':
207*54fd6939SJiyong Park 			src = optarg;
208*54fd6939SJiyong Park 			break;
209*54fd6939SJiyong Park 		case 'd':
210*54fd6939SJiyong Park 			dest = optarg;
211*54fd6939SJiyong Park 			break;
212*54fd6939SJiyong Park 		case 'l':
213*54fd6939SJiyong Park 			loadaddr = strtol(optarg, NULL, 0);
214*54fd6939SJiyong Park 			break;
215*54fd6939SJiyong Park 		case 'e':
216*54fd6939SJiyong Park 			entry = strtol(optarg, NULL, 0);
217*54fd6939SJiyong Park 			break;
218*54fd6939SJiyong Park 		case 'v':
219*54fd6939SJiyong Park 			version = strtol(optarg, NULL, 0);
220*54fd6939SJiyong Park 			break;
221*54fd6939SJiyong Park 		case 'm':
222*54fd6939SJiyong Park 			major = strtol(optarg, NULL, 0);
223*54fd6939SJiyong Park 			break;
224*54fd6939SJiyong Park 		case 'n':
225*54fd6939SJiyong Park 			minor = strtol(optarg, NULL, 0);
226*54fd6939SJiyong Park 			break;
227*54fd6939SJiyong Park 		default:
228*54fd6939SJiyong Park 			fprintf(stderr,
229*54fd6939SJiyong Park 				"Usage : %s [-s srcfile] [-d destfile] [-l loadaddr] [-e entry_point] [-m major] [-n minor]\n",
230*54fd6939SJiyong Park 					argv[0]);
231*54fd6939SJiyong Park 			return -1;
232*54fd6939SJiyong Park 		}
233*54fd6939SJiyong Park 	}
234*54fd6939SJiyong Park 
235*54fd6939SJiyong Park 	if (!src) {
236*54fd6939SJiyong Park 		fprintf(stderr, "Missing -s option\n");
237*54fd6939SJiyong Park 		return -1;
238*54fd6939SJiyong Park 	}
239*54fd6939SJiyong Park 
240*54fd6939SJiyong Park 	if (!dest) {
241*54fd6939SJiyong Park 		fprintf(stderr, "Missing -d option\n");
242*54fd6939SJiyong Park 		return -1;
243*54fd6939SJiyong Park 	}
244*54fd6939SJiyong Park 
245*54fd6939SJiyong Park 	if (loadaddr == -1) {
246*54fd6939SJiyong Park 		fprintf(stderr, "Missing -l option\n");
247*54fd6939SJiyong Park 		return -1;
248*54fd6939SJiyong Park 	}
249*54fd6939SJiyong Park 
250*54fd6939SJiyong Park 	if (entry == -1) {
251*54fd6939SJiyong Park 		fprintf(stderr, "Missing -e option\n");
252*54fd6939SJiyong Park 		return -1;
253*54fd6939SJiyong Park 	}
254*54fd6939SJiyong Park 
255*54fd6939SJiyong Park 	err = stm32image_create_header_file(src, dest, loadaddr,
256*54fd6939SJiyong Park 					    entry, version, major, minor);
257*54fd6939SJiyong Park 
258*54fd6939SJiyong Park 	return err;
259*54fd6939SJiyong Park }
260