xref: /openbmc/u-boot/tools/aisimage.c (revision 03efcb05)
1 /*
2  * (C) Copyright 2011
3  * Stefano Babic, DENX Software Engineering, sbabic@denx.de.
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 /* Required to obtain the getline prototype from stdio.h */
9 #define _GNU_SOURCE
10 
11 #include "mkimage.h"
12 #include "aisimage.h"
13 #include <image.h>
14 
15 #define IS_FNC_EXEC(c)	(cmd_table[c].AIS_cmd == AIS_CMD_FNLOAD)
16 #define WORD_ALIGN0	4
17 #define WORD_ALIGN(len) (((len)+WORD_ALIGN0-1) & ~(WORD_ALIGN0-1))
18 #define MAX_CMD_BUFFER	4096
19 
20 static uint32_t ais_img_size;
21 
22 /*
23  * Supported commands for configuration file
24  */
25 static table_entry_t aisimage_cmds[] = {
26 	{CMD_DATA,		"DATA",		"Reg Write Data"},
27 	{CMD_FILL,		"FILL",		"Fill range with pattern"},
28 	{CMD_CRCON,		"CRCON",	"CRC Enable"},
29 	{CMD_CRCOFF,		"CRCOFF",	"CRC Disable"},
30 	{CMD_CRCCHECK,		"CRCCHECK",	"CRC Validate"},
31 	{CMD_JMPCLOSE,		"JMPCLOSE",	"Jump & Close"},
32 	{CMD_JMP,		"JMP",		"Jump"},
33 	{CMD_SEQREAD,		"SEQREAD",	"Sequential read"},
34 	{CMD_PLL0,		"PLL0",		"PLL0"},
35 	{CMD_PLL1,		"PLL1",		"PLL1"},
36 	{CMD_CLK,		"CLK",		"Clock configuration"},
37 	{CMD_DDR2,		"DDR2",		"DDR2 Configuration"},
38 	{CMD_EMIFA,		"EMIFA",	"EMIFA"},
39 	{CMD_EMIFA_ASYNC,	"EMIFA_ASYNC",	"EMIFA Async"},
40 	{CMD_PLL,		"PLL",		"PLL & Clock configuration"},
41 	{CMD_PSC,		"PSC",		"PSC setup"},
42 	{CMD_PINMUX,		"PINMUX",	"Pinmux setup"},
43 	{CMD_BOOTTABLE,		"BOOT_TABLE",	"Boot table command"},
44 	{-1,			"",		""},
45 };
46 
47 static struct ais_func_exec {
48 	uint32_t index;
49 	uint32_t argcnt;
50 } ais_func_table[] = {
51 	[CMD_PLL0] = {0, 2},
52 	[CMD_PLL1] = {1, 2},
53 	[CMD_CLK] = {2, 1},
54 	[CMD_DDR2] = {3, 8},
55 	[CMD_EMIFA] = {4, 5},
56 	[CMD_EMIFA_ASYNC] = {5, 5},
57 	[CMD_PLL] = {6, 3},
58 	[CMD_PSC] = {7, 1},
59 	[CMD_PINMUX] = {8, 3}
60 };
61 
62 static struct cmd_table_t {
63 	uint32_t nargs;
64 	uint32_t AIS_cmd;
65 } cmd_table[] = {
66 	[CMD_FILL]	 =	{	4,	AIS_CMD_FILL},
67 	[CMD_CRCON]	=	{	0,	AIS_CMD_ENCRC},
68 	[CMD_CRCOFF]	=	{	0,	AIS_CMD_DISCRC},
69 	[CMD_CRCCHECK]	=	{	2,	AIS_CMD_ENCRC},
70 	[CMD_JMPCLOSE]	=	{	1,	AIS_CMD_JMPCLOSE},
71 	[CMD_JMP]	=	{	1,	AIS_CMD_JMP},
72 	[CMD_SEQREAD]	=	{	0,	AIS_CMD_SEQREAD},
73 	[CMD_PLL0]	=	{	2,	AIS_CMD_FNLOAD},
74 	[CMD_PLL1]	=	{	2,	AIS_CMD_FNLOAD},
75 	[CMD_CLK]	=	{	1,	AIS_CMD_FNLOAD},
76 	[CMD_DDR2]	=	{	8,	AIS_CMD_FNLOAD},
77 	[CMD_EMIFA]	=	{	5,	AIS_CMD_FNLOAD},
78 	[CMD_EMIFA_ASYNC] =	{	5,	AIS_CMD_FNLOAD},
79 	[CMD_PLL]	=	{	3,	AIS_CMD_FNLOAD},
80 	[CMD_PSC]	=	{	1,	AIS_CMD_FNLOAD},
81 	[CMD_PINMUX]	=	{	3,	AIS_CMD_FNLOAD},
82 	[CMD_BOOTTABLE]	=	{	4,	AIS_CMD_BOOTTBL},
83 };
84 
85 static uint32_t get_cfg_value(char *token, char *name,  int linenr)
86 {
87 	char *endptr;
88 	uint32_t value;
89 
90 	errno = 0;
91 	value = strtoul(token, &endptr, 16);
92 	if (errno || (token == endptr)) {
93 		fprintf(stderr, "Error: %s[%d] - Invalid hex data(%s)\n",
94 			name,  linenr, token);
95 		exit(EXIT_FAILURE);
96 	}
97 	return value;
98 }
99 
100 static int get_ais_table_id(uint32_t *ptr)
101 {
102 
103 	int i;
104 	int func_no;
105 
106 	for (i = 0; i < ARRAY_SIZE(cmd_table); i++) {
107 		if (*ptr == cmd_table[i].AIS_cmd) {
108 			if (cmd_table[i].AIS_cmd != AIS_CMD_FNLOAD)
109 				return i;
110 
111 			func_no = ((struct ais_cmd_func *)ptr)->func_args
112 				& 0xFFFF;
113 			if (func_no == ais_func_table[i].index)
114 				return i;
115 		}
116 	}
117 
118 	return -1;
119 }
120 
121 static void aisimage_print_header(const void *hdr)
122 {
123 	struct ais_header *ais_hdr = (struct ais_header *)hdr;
124 	uint32_t *ptr;
125 	struct ais_cmd_load *ais_load;
126 	int id;
127 
128 	if (ais_hdr->magic != AIS_MAGIC_WORD) {
129 		fprintf(stderr, "Error: - AIS Magic Number not found\n");
130 		return;
131 	}
132 	fprintf(stdout, "Image Type:   TI Davinci AIS Boot Image\n");
133 	fprintf(stdout, "AIS magic :   %08x\n", ais_hdr->magic);
134 	ptr = (uint32_t *)&ais_hdr->magic;
135 	ptr++;
136 
137 	while (*ptr != AIS_CMD_JMPCLOSE) {
138 		/* Check if we find the image */
139 		if (*ptr == AIS_CMD_LOAD) {
140 			ais_load = (struct ais_cmd_load *)ptr;
141 			fprintf(stdout, "Image at  :   0x%08x size 0x%08x\n",
142 				ais_load->addr,
143 				ais_load->size);
144 			ptr = ais_load->data + ais_load->size / sizeof(*ptr);
145 			continue;
146 		}
147 
148 		id = get_ais_table_id(ptr);
149 		if (id < 0) {
150 			fprintf(stderr, "Error: -  AIS Image corrupted\n");
151 			return;
152 		}
153 		fprintf(stdout, "AIS cmd   :   %s\n",
154 			get_table_entry_name(aisimage_cmds, NULL, id));
155 		ptr += cmd_table[id].nargs + IS_FNC_EXEC(id) + 1;
156 		if (((void *)ptr - hdr) > ais_img_size) {
157 			fprintf(stderr,
158 				"AIS Image not terminated by JMPCLOSE\n");
159 			return;
160 		}
161 	}
162 }
163 
164 static uint32_t *ais_insert_cmd_header(uint32_t cmd, uint32_t nargs,
165 	uint32_t *parms, struct image_type_params *tparams,
166 	uint32_t *ptr)
167 {
168 	int i;
169 
170 	*ptr++ = cmd_table[cmd].AIS_cmd;
171 	if (IS_FNC_EXEC(cmd))
172 		*ptr++ = ((nargs & 0xFFFF) << 16) + ais_func_table[cmd].index;
173 
174 	/* Copy parameters */
175 	for (i = 0; i < nargs; i++)
176 		*ptr++ = cpu_to_le32(parms[i]);
177 
178 	return ptr;
179 
180 }
181 
182 static uint32_t *ais_alloc_buffer(struct mkimage_params *params)
183 {
184 	int dfd;
185 	struct stat sbuf;
186 	char *datafile = params->datafile;
187 	uint32_t *ptr;
188 
189 	dfd = open(datafile, O_RDONLY|O_BINARY);
190 	if (dfd < 0) {
191 		fprintf(stderr, "%s: Can't open %s: %s\n",
192 			params->cmdname, datafile, strerror(errno));
193 		exit(EXIT_FAILURE);
194 	}
195 
196 	if (fstat(dfd, &sbuf) < 0) {
197 		fprintf(stderr, "%s: Can't stat %s: %s\n",
198 			params->cmdname, datafile, strerror(errno));
199 		exit(EXIT_FAILURE);
200 	}
201 
202 	/*
203 	 * Place for header is allocated. The size is taken from
204 	 * the size of the datafile, that the ais_image_generate()
205 	 * will copy into the header. Copying the datafile
206 	 * is not left to the main program, because after the datafile
207 	 * the header must be terminated with the Jump & Close command.
208 	 */
209 	ais_img_size = WORD_ALIGN(sbuf.st_size) + MAX_CMD_BUFFER;
210 	ptr = (uint32_t *)malloc(WORD_ALIGN(sbuf.st_size) + MAX_CMD_BUFFER);
211 	if (!ptr) {
212 		fprintf(stderr, "%s: malloc return failure: %s\n",
213 			params->cmdname, strerror(errno));
214 		exit(EXIT_FAILURE);
215 	}
216 
217 	close(dfd);
218 
219 	return ptr;
220 }
221 
222 static uint32_t *ais_copy_image(struct mkimage_params *params,
223 	uint32_t *aisptr)
224 
225 {
226 	int dfd;
227 	struct stat sbuf;
228 	char *datafile = params->datafile;
229 	void *ptr;
230 
231 	dfd = open(datafile, O_RDONLY|O_BINARY);
232 	if (dfd < 0) {
233 		fprintf(stderr, "%s: Can't open %s: %s\n",
234 			params->cmdname, datafile, strerror(errno));
235 		exit(EXIT_FAILURE);
236 	}
237 
238 	if (fstat(dfd, &sbuf) < 0) {
239 		fprintf(stderr, "%s: Can't stat %s: %s\n",
240 			params->cmdname, datafile, strerror(errno));
241 		exit(EXIT_FAILURE);
242 	}
243 
244 	ptr = mmap(0, sbuf.st_size, PROT_READ, MAP_SHARED, dfd, 0);
245 	*aisptr++ = AIS_CMD_LOAD;
246 	*aisptr++ = params->ep;
247 	*aisptr++ = sbuf.st_size;
248 	memcpy((void *)aisptr, ptr, sbuf.st_size);
249 	aisptr += WORD_ALIGN(sbuf.st_size) / sizeof(uint32_t);
250 
251 	(void) munmap((void *)ptr, sbuf.st_size);
252 	(void) close(dfd);
253 
254 	return aisptr;
255 
256 }
257 
258 static int aisimage_generate(struct mkimage_params *params,
259 	struct image_type_params *tparams)
260 {
261 	FILE *fd = NULL;
262 	char *line = NULL;
263 	char *token, *saveptr1, *saveptr2;
264 	int lineno = 0;
265 	int fld;
266 	size_t len;
267 	int32_t cmd;
268 	uint32_t nargs, cmd_parms[10];
269 	uint32_t value, size;
270 	char *name = params->imagename;
271 	uint32_t *aishdr;
272 
273 	fd = fopen(name, "r");
274 	if (fd == 0) {
275 		fprintf(stderr,
276 			"Error: %s - Can't open AIS configuration\n", name);
277 		exit(EXIT_FAILURE);
278 	}
279 
280 	/*
281 	 * the size of the header is variable and is computed
282 	 * scanning the configuration file.
283 	 */
284 	tparams->header_size = 0;
285 
286 	/*
287 	 * Start allocating a buffer suitable for most command
288 	 * The buffer is then reallocated if it is too small
289 	 */
290 	aishdr = ais_alloc_buffer(params);
291 	tparams->hdr = aishdr;
292 	*aishdr++ = AIS_MAGIC_WORD;
293 
294 	/* Very simple parsing, line starting with # are comments
295 	 * and are dropped
296 	 */
297 	while ((getline(&line, &len, fd)) > 0) {
298 		lineno++;
299 
300 		token = strtok_r(line, "\r\n", &saveptr1);
301 		if (token == NULL)
302 			continue;
303 
304 		/* Check inside the single line */
305 		line = token;
306 		fld = CFG_COMMAND;
307 		cmd = CMD_INVALID;
308 		nargs = 0;
309 		while (token != NULL) {
310 			token = strtok_r(line, " \t", &saveptr2);
311 			if (token == NULL)
312 				break;
313 
314 			/* Drop all text starting with '#' as comments */
315 			if (token[0] == '#')
316 				break;
317 
318 			switch (fld) {
319 			case CFG_COMMAND:
320 				cmd = get_table_entry_id(aisimage_cmds,
321 					"aisimage commands", token);
322 				if (cmd < 0) {
323 					fprintf(stderr,
324 					"Error: %s[%d] - Invalid command"
325 					"(%s)\n", name, lineno, token);
326 
327 					exit(EXIT_FAILURE);
328 				}
329 				break;
330 			case CFG_VALUE:
331 				value = get_cfg_value(token, name, lineno);
332 				cmd_parms[nargs++] = value;
333 				if (nargs > cmd_table[cmd].nargs) {
334 					fprintf(stderr,
335 					 "Error: %s[%d] - too much arguments:"
336 						"(%s) for command %s\n", name,
337 						lineno, token,
338 						aisimage_cmds[cmd].sname);
339 					exit(EXIT_FAILURE);
340 				}
341 				break;
342 			}
343 			line = NULL;
344 			fld = CFG_VALUE;
345 		}
346 		if (cmd != CMD_INVALID) {
347 			/* Now insert the command into the header */
348 			aishdr = ais_insert_cmd_header(cmd, nargs, cmd_parms,
349 				tparams, aishdr);
350 		}
351 
352 	}
353 	fclose(fd);
354 
355 	aishdr = ais_copy_image(params, aishdr);
356 
357 	/* Add Jmp & Close */
358 	*aishdr++ = AIS_CMD_JMPCLOSE;
359 	*aishdr++ = params->ep;
360 
361 	size = (aishdr - (uint32_t *)tparams->hdr) * sizeof(uint32_t);
362 	tparams->header_size = size;
363 
364 	return 0;
365 }
366 
367 static int aisimage_check_image_types(uint8_t type)
368 {
369 	if (type == IH_TYPE_AISIMAGE)
370 		return EXIT_SUCCESS;
371 	else
372 		return EXIT_FAILURE;
373 }
374 
375 static int aisimage_verify_header(unsigned char *ptr, int image_size,
376 			struct mkimage_params *params)
377 {
378 	struct ais_header *ais_hdr = (struct ais_header *)ptr;
379 
380 	if (ais_hdr->magic != AIS_MAGIC_WORD)
381 		return -FDT_ERR_BADSTRUCTURE;
382 
383 	/* Store the total size to remember in print_hdr */
384 	ais_img_size = image_size;
385 
386 	return 0;
387 }
388 
389 static void aisimage_set_header(void *ptr, struct stat *sbuf, int ifd,
390 				struct mkimage_params *params)
391 {
392 }
393 
394 int aisimage_check_params(struct mkimage_params *params)
395 {
396 	if (!params)
397 		return CFG_INVALID;
398 	if (!strlen(params->imagename)) {
399 		fprintf(stderr, "Error: %s - Configuration file not specified, "
400 			"it is needed for aisimage generation\n",
401 			params->cmdname);
402 		return CFG_INVALID;
403 	}
404 	/*
405 	 * Check parameters:
406 	 * XIP is not allowed and verify that incompatible
407 	 * parameters are not sent at the same time
408 	 * For example, if list is required a data image must not be provided
409 	 */
410 	return	(params->dflag && (params->fflag || params->lflag)) ||
411 		(params->fflag && (params->dflag || params->lflag)) ||
412 		(params->lflag && (params->dflag || params->fflag)) ||
413 		(params->xflag) || !(strlen(params->imagename));
414 }
415 
416 /*
417  * aisimage parameters
418  */
419 static struct image_type_params aisimage_params = {
420 	.name		= "TI Davinci AIS Boot Image support",
421 	.header_size	= 0,
422 	.hdr		= NULL,
423 	.check_image_type = aisimage_check_image_types,
424 	.verify_header	= aisimage_verify_header,
425 	.print_header	= aisimage_print_header,
426 	.set_header	= aisimage_set_header,
427 	.check_params	= aisimage_check_params,
428 	.vrec_header	= aisimage_generate,
429 };
430 
431 void init_ais_image_type(void)
432 {
433 	mkimage_register(&aisimage_params);
434 }
435