1 // SPDX-License-Identifier: GPL-2.0+
3 * (C) Copyright 2000-2009
18 #include <asm/byteorder.h>
19 #include <asm/global_data.h>
20 #include <linux/ctype.h>
21 #include <linux/err.h>
22 #include <u-boot/zlib.h>
25 DECLARE_GLOBAL_DATA_PTR;
27 #if defined(CONFIG_CMD_IMI)
28 static int image_info(unsigned long addr);
31 #if defined(CONFIG_CMD_IMLS)
33 #include <mtd/cfi_flash.h>
34 extern flash_info_t flash_info[]; /* info for FLASH chips */
37 #if defined(CONFIG_CMD_IMLS) || defined(CONFIG_CMD_IMLS_NAND)
38 static int do_imls(struct cmd_tbl *cmdtp, int flag, int argc,
42 /* we overload the cmd field with our state machine info instead of a
44 static struct cmd_tbl cmd_bootm_sub[] = {
45 U_BOOT_CMD_MKENT(start, 0, 1, (void *)BOOTM_STATE_START, "", ""),
46 U_BOOT_CMD_MKENT(loados, 0, 1, (void *)BOOTM_STATE_LOADOS, "", ""),
47 #ifdef CONFIG_CMD_BOOTM_PRE_LOAD
48 U_BOOT_CMD_MKENT(preload, 0, 1, (void *)BOOTM_STATE_PRE_LOAD, "", ""),
50 #ifdef CONFIG_SYS_BOOT_RAMDISK_HIGH
51 U_BOOT_CMD_MKENT(ramdisk, 0, 1, (void *)BOOTM_STATE_RAMDISK, "", ""),
53 #ifdef CONFIG_OF_LIBFDT
54 U_BOOT_CMD_MKENT(fdt, 0, 1, (void *)BOOTM_STATE_FDT, "", ""),
56 U_BOOT_CMD_MKENT(cmdline, 0, 1, (void *)BOOTM_STATE_OS_CMDLINE, "", ""),
57 U_BOOT_CMD_MKENT(bdt, 0, 1, (void *)BOOTM_STATE_OS_BD_T, "", ""),
58 U_BOOT_CMD_MKENT(prep, 0, 1, (void *)BOOTM_STATE_OS_PREP, "", ""),
59 U_BOOT_CMD_MKENT(fake, 0, 1, (void *)BOOTM_STATE_OS_FAKE_GO, "", ""),
60 U_BOOT_CMD_MKENT(go, 0, 1, (void *)BOOTM_STATE_OS_GO, "", ""),
63 #if defined(CONFIG_CMD_BOOTM_PRE_LOAD)
64 static ulong bootm_get_addr(int argc, char *const argv[])
69 addr = hextoul(argv[0], NULL);
71 addr = image_load_addr;
77 static int do_bootm_subcommand(struct cmd_tbl *cmdtp, int flag, int argc,
84 c = find_cmd_tbl(argv[0], &cmd_bootm_sub[0], ARRAY_SIZE(cmd_bootm_sub));
89 if (state == BOOTM_STATE_START)
90 state |= BOOTM_STATE_PRE_LOAD | BOOTM_STATE_FINDOS |
91 BOOTM_STATE_FINDOTHER;
92 #if defined(CONFIG_CMD_BOOTM_PRE_LOAD)
93 if (state == BOOTM_STATE_PRE_LOAD)
94 state |= BOOTM_STATE_START;
97 /* Unrecognized command */
101 if (((state & BOOTM_STATE_START) != BOOTM_STATE_START) &&
102 images.state >= state) {
103 printf("Trying to execute a command out of order\n");
104 return CMD_RET_USAGE;
107 ret = do_bootm_states(cmdtp, flag, argc, argv, state, &images, 0);
109 #if defined(CONFIG_CMD_BOOTM_PRE_LOAD)
110 if (!ret && (state & BOOTM_STATE_PRE_LOAD))
111 env_set_hex("loadaddr_verified",
112 bootm_get_addr(argc, argv) + image_load_offset);
118 /*******************************************************************/
119 /* bootm - boot application image from image in memory */
120 /*******************************************************************/
122 int do_bootm(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[])
124 #ifdef CONFIG_NEEDS_MANUAL_RELOC
125 static int relocated = 0;
130 /* relocate names of sub-command table */
131 for (i = 0; i < ARRAY_SIZE(cmd_bootm_sub); i++)
132 cmd_bootm_sub[i].name += gd->reloc_off;
138 /* determine if we have a sub command */
143 hextoul(argv[0], &endp);
144 /* endp pointing to NULL means that argv[0] was just a
145 * valid number, pass it along to the normal bootm processing
147 * If endp is ':' or '#' assume a FIT identifier so pass
148 * along for normal processing.
150 * Right now we assume the first arg should never be '-'
152 if ((*endp != 0) && (*endp != ':') && (*endp != '#'))
153 return do_bootm_subcommand(cmdtp, flag, argc, argv);
156 return do_bootm_states(cmdtp, flag, argc, argv, BOOTM_STATE_START |
157 BOOTM_STATE_FINDOS | BOOTM_STATE_PRE_LOAD | BOOTM_STATE_FINDOTHER |
159 #ifdef CONFIG_SYS_BOOT_RAMDISK_HIGH
160 BOOTM_STATE_RAMDISK |
162 #if defined(CONFIG_PPC) || defined(CONFIG_MIPS)
163 BOOTM_STATE_OS_CMDLINE |
165 BOOTM_STATE_OS_PREP | BOOTM_STATE_OS_FAKE_GO |
166 BOOTM_STATE_OS_GO, &images, 1);
169 int bootm_maybe_autostart(struct cmd_tbl *cmdtp, const char *cmd)
171 if (env_get_autostart()) {
173 local_args[0] = (char *)cmd;
174 local_args[1] = NULL;
175 printf("Automatic boot of image at addr 0x%08lX ...\n",
177 return do_bootm(cmdtp, 0, 1, local_args);
183 #ifdef CONFIG_SYS_LONGHELP
184 static char bootm_help_text[] =
185 "[addr [arg ...]]\n - boot application image stored in memory\n"
186 "\tpassing arguments 'arg ...'; when booting a Linux kernel,\n"
187 "\t'arg' can be the address of an initrd image\n"
188 #if defined(CONFIG_OF_LIBFDT)
189 "\tWhen booting a Linux kernel which requires a flat device-tree\n"
190 "\ta third argument is required which is the address of the\n"
191 "\tdevice-tree blob. To boot that kernel without an initrd image,\n"
192 "\tuse a '-' for the second argument. If you do not pass a third\n"
193 "\ta bd_info struct will be passed instead\n"
195 #if defined(CONFIG_FIT)
196 "\t\nFor the new multi component uImage format (FIT) addresses\n"
197 "\tmust be extended to include component or configuration unit name:\n"
198 "\taddr:<subimg_uname> - direct component image specification\n"
199 "\taddr#<conf_uname> - configuration specification\n"
200 "\tUse iminfo command to get the list of existing component\n"
201 "\timages and configurations.\n"
203 "\nSub-commands to do part of the bootm sequence. The sub-commands "
205 "issued in the order below (it's ok to not issue all sub-commands):\n"
206 "\tstart [addr [arg ...]]\n"
207 #if defined(CONFIG_CMD_BOOTM_PRE_LOAD)
208 "\tpreload [addr [arg ..]] - run only the preload stage\n"
210 "\tloados - load OS image\n"
211 #if defined(CONFIG_SYS_BOOT_RAMDISK_HIGH)
212 "\tramdisk - relocate initrd, set env initrd_start/initrd_end\n"
214 #if defined(CONFIG_OF_LIBFDT)
215 "\tfdt - relocate flat device tree\n"
217 "\tcmdline - OS specific command line processing/setup\n"
218 "\tbdt - OS specific bd_info processing\n"
219 "\tprep - OS specific prep before relocation or go\n"
220 #if defined(CONFIG_TRACE)
221 "\tfake - OS specific fake start without go\n"
227 bootm, CONFIG_SYS_MAXARGS, 1, do_bootm,
228 "boot application image from memory", bootm_help_text
231 /*******************************************************************/
232 /* bootd - boot default image */
233 /*******************************************************************/
234 #if defined(CONFIG_CMD_BOOTD)
235 int do_bootd(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[])
237 return run_command(env_get("bootcmd"), flag);
241 boot, 1, 1, do_bootd,
242 "boot default, i.e., run 'bootcmd'",
246 /* keep old command name "bootd" for backward compatibility */
248 bootd, 1, 1, do_bootd,
249 "boot default, i.e., run 'bootcmd'",
256 /*******************************************************************/
257 /* iminfo - print header info for a requested image */
258 /*******************************************************************/
259 #if defined(CONFIG_CMD_IMI)
260 static int do_iminfo(struct cmd_tbl *cmdtp, int flag, int argc,
268 return image_info(image_load_addr);
271 for (arg = 1; arg < argc; ++arg) {
272 addr = hextoul(argv[arg], NULL);
273 if (image_info(addr) != 0)
279 static int image_info(ulong addr)
281 void *hdr = (void *)map_sysmem(addr, 0);
283 printf("\n## Checking Image at %08lx ...\n", addr);
285 switch (genimg_get_format(hdr)) {
286 #if defined(CONFIG_LEGACY_IMAGE_FORMAT)
287 case IMAGE_FORMAT_LEGACY:
288 puts(" Legacy image found\n");
289 if (!image_check_magic(hdr)) {
290 puts(" Bad Magic Number\n");
295 if (!image_check_hcrc(hdr)) {
296 puts(" Bad Header Checksum\n");
301 image_print_contents(hdr);
303 puts(" Verifying Checksum ... ");
304 if (!image_check_dcrc(hdr)) {
305 puts(" Bad Data CRC\n");
313 #if defined(CONFIG_ANDROID_BOOT_IMAGE)
314 case IMAGE_FORMAT_ANDROID:
315 puts(" Android image found\n");
316 android_print_contents(hdr);
320 #if defined(CONFIG_FIT)
321 case IMAGE_FORMAT_FIT:
322 puts(" FIT image found\n");
324 if (fit_check_format(hdr, IMAGE_SIZE_INVAL)) {
325 puts("Bad FIT image format!\n");
330 fit_print_contents(hdr);
332 if (!fit_all_image_verify(hdr)) {
333 puts("Bad hash in FIT image!\n");
342 puts("Unknown image format!\n");
351 iminfo, CONFIG_SYS_MAXARGS, 1, do_iminfo,
352 "print header information for application image",
354 " - print header information for application image starting at\n"
355 " address 'addr' in memory; this includes verification of the\n"
356 " image contents (magic number, header and payload checksums)"
361 /*******************************************************************/
362 /* imls - list all images found in flash */
363 /*******************************************************************/
364 #if defined(CONFIG_CMD_IMLS)
365 static int do_imls_nor(void)
371 for (i = 0, info = &flash_info[0];
372 i < CFI_FLASH_BANKS; ++i, ++info) {
374 if (info->flash_id == FLASH_UNKNOWN)
376 for (j = 0; j < info->sector_count; ++j) {
378 hdr = (void *)info->start[j];
382 switch (genimg_get_format(hdr)) {
383 #if defined(CONFIG_LEGACY_IMAGE_FORMAT)
384 case IMAGE_FORMAT_LEGACY:
385 if (!image_check_hcrc(hdr))
388 printf("Legacy Image at %08lX:\n", (ulong)hdr);
389 image_print_contents(hdr);
391 puts(" Verifying Checksum ... ");
392 if (!image_check_dcrc(hdr)) {
393 puts("Bad Data CRC\n");
399 #if defined(CONFIG_FIT)
400 case IMAGE_FORMAT_FIT:
401 if (fit_check_format(hdr, IMAGE_SIZE_INVAL))
404 printf("FIT Image at %08lX:\n", (ulong)hdr);
405 fit_print_contents(hdr);
420 #if defined(CONFIG_CMD_IMLS_NAND)
421 static int nand_imls_legacyimage(struct mtd_info *mtd, int nand_dev,
422 loff_t off, size_t len)
427 imgdata = malloc(len);
429 printf("May be a Legacy Image at NAND device %d offset %08llX:\n",
431 printf(" Low memory(cannot allocate memory for image)\n");
435 ret = nand_read_skip_bad(mtd, off, &len, NULL, mtd->size, imgdata);
436 if (ret < 0 && ret != -EUCLEAN) {
441 if (!image_check_hcrc(imgdata)) {
446 printf("Legacy Image at NAND device %d offset %08llX:\n",
448 image_print_contents(imgdata);
450 puts(" Verifying Checksum ... ");
451 if (!image_check_dcrc(imgdata))
452 puts("Bad Data CRC\n");
461 static int nand_imls_fitimage(struct mtd_info *mtd, int nand_dev, loff_t off,
467 imgdata = malloc(len);
469 printf("May be a FIT Image at NAND device %d offset %08llX:\n",
471 printf(" Low memory(cannot allocate memory for image)\n");
475 ret = nand_read_skip_bad(mtd, off, &len, NULL, mtd->size, imgdata);
476 if (ret < 0 && ret != -EUCLEAN) {
481 if (fit_check_format(imgdata, IMAGE_SIZE_INVAL)) {
486 printf("FIT Image at NAND device %d offset %08llX:\n", nand_dev, off);
488 fit_print_contents(imgdata);
494 static int do_imls_nand(void)
496 struct mtd_info *mtd;
497 int nand_dev = nand_curr_device;
502 if (nand_dev < 0 || nand_dev >= CONFIG_SYS_MAX_NAND_DEVICE) {
503 puts("\nNo NAND devices available\n");
509 for (nand_dev = 0; nand_dev < CONFIG_SYS_MAX_NAND_DEVICE; nand_dev++) {
510 mtd = get_nand_dev_by_index(nand_dev);
511 if (!mtd->name || !mtd->size)
514 for (off = 0; off < mtd->size; off += mtd->erasesize) {
515 const image_header_t *header;
518 if (nand_block_isbad(mtd, off))
521 len = sizeof(buffer);
523 ret = nand_read(mtd, off, &len, (u8 *)buffer);
524 if (ret < 0 && ret != -EUCLEAN) {
525 printf("NAND read error %d at offset %08llX\n",
530 switch (genimg_get_format(buffer)) {
531 #if defined(CONFIG_LEGACY_IMAGE_FORMAT)
532 case IMAGE_FORMAT_LEGACY:
533 header = (const image_header_t *)buffer;
535 len = image_get_image_size(header);
536 nand_imls_legacyimage(mtd, nand_dev, off, len);
539 #if defined(CONFIG_FIT)
540 case IMAGE_FORMAT_FIT:
541 len = fit_get_size(buffer);
542 nand_imls_fitimage(mtd, nand_dev, off, len);
553 #if defined(CONFIG_CMD_IMLS) || defined(CONFIG_CMD_IMLS_NAND)
554 static int do_imls(struct cmd_tbl *cmdtp, int flag, int argc,
557 int ret_nor = 0, ret_nand = 0;
559 #if defined(CONFIG_CMD_IMLS)
560 ret_nor = do_imls_nor();
563 #if defined(CONFIG_CMD_IMLS_NAND)
564 ret_nand = do_imls_nand();
578 "list all images found in flash",
580 " - Prints information about all images found at sector/block\n"
581 " boundaries in nor/nand flash."