blob: 04bce762c86c49a60a5f05be1f9289c2fabb6e17 [file] [log] [blame]
wdenk47d1a6e2002-11-03 00:01:44 +00001/*
Stefan Roese15940c92006-03-13 11:16:36 +01002 * (C) Copyright 2000-2006
wdenk47d1a6e2002-11-03 00:01:44 +00003 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4 *
5 * See file CREDITS for list of people who contributed to this
6 * project.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License as
10 * published by the Free Software Foundation; either version 2 of
11 * the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21 * MA 02111-1307 USA
22 */
23
24/*
25 * Boot support
26 */
27#include <common.h>
28#include <watchdog.h>
29#include <command.h>
wdenk47d1a6e2002-11-03 00:01:44 +000030#include <image.h>
31#include <malloc.h>
32#include <zlib.h>
wdenkc29fdfc2003-08-29 20:57:53 +000033#include <bzlib.h>
wdenk7f70e852003-05-20 14:25:27 +000034#include <environment.h>
wdenk47d1a6e2002-11-03 00:01:44 +000035#include <asm/byteorder.h>
wdenk8bde7f72003-06-27 21:31:46 +000036
Wolfgang Denkf57f70a2005-10-13 01:45:54 +020037#ifdef CONFIG_OF_FLAT_TREE
38#include <ft_build.h>
39#endif
40
Wolfgang Denkd87080b2006-03-31 18:32:53 +020041DECLARE_GLOBAL_DATA_PTR;
42
wdenk8bde7f72003-06-27 21:31:46 +000043 /*cmd_boot.c*/
44 extern int do_reset (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[]);
45
wdenk47d1a6e2002-11-03 00:01:44 +000046#if (CONFIG_COMMANDS & CFG_CMD_DATE) || defined(CONFIG_TIMESTAMP)
47#include <rtc.h>
48#endif
49
50#ifdef CFG_HUSH_PARSER
51#include <hush.h>
52#endif
53
54#ifdef CONFIG_SHOW_BOOT_PROGRESS
55# include <status_led.h>
56# define SHOW_BOOT_PROGRESS(arg) show_boot_progress(arg)
57#else
58# define SHOW_BOOT_PROGRESS(arg)
59#endif
60
61#ifdef CFG_INIT_RAM_LOCK
62#include <asm/cache.h>
63#endif
64
wdenk228f29a2002-12-08 09:53:23 +000065#ifdef CONFIG_LOGBUFFER
66#include <logbuff.h>
67#endif
68
wdenk2abbe072003-06-16 23:50:08 +000069#ifdef CONFIG_HAS_DATAFLASH
70#include <dataflash.h>
71#endif
72
wdenk47d1a6e2002-11-03 00:01:44 +000073/*
74 * Some systems (for example LWMON) have very short watchdog periods;
75 * we must make sure to split long operations like memmove() or
76 * crc32() into reasonable chunks.
77 */
78#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
79# define CHUNKSZ (64 * 1024)
80#endif
81
wdenkeedcd072004-09-08 22:03:11 +000082int gunzip (void *, int, unsigned char *, unsigned long *);
wdenk47d1a6e2002-11-03 00:01:44 +000083
84static void *zalloc(void *, unsigned, unsigned);
85static void zfree(void *, void *, unsigned);
86
87#if (CONFIG_COMMANDS & CFG_CMD_IMI)
88static int image_info (unsigned long addr);
89#endif
wdenk27b207f2003-07-24 23:38:38 +000090
91#if (CONFIG_COMMANDS & CFG_CMD_IMLS)
92#include <flash.h>
Marian Balakowicze6f2e902005-10-11 19:09:42 +020093extern flash_info_t flash_info[]; /* info for FLASH chips */
wdenk27b207f2003-07-24 23:38:38 +000094static int do_imls (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[]);
95#endif
96
wdenk47d1a6e2002-11-03 00:01:44 +000097static void print_type (image_header_t *hdr);
98
wdenk2262cfe2002-11-18 00:14:45 +000099#ifdef __I386__
100image_header_t *fake_header(image_header_t *hdr, void *ptr, int size);
101#endif
102
wdenk47d1a6e2002-11-03 00:01:44 +0000103/*
104 * Continue booting an OS image; caller already has:
105 * - copied image header to global variable `header'
106 * - checked header magic number, checksums (both header & image),
107 * - verified image architecture (PPC) and type (KERNEL or MULTI),
108 * - loaded (first part of) image to header load address,
109 * - disabled interrupts.
110 */
111typedef void boot_os_Fcn (cmd_tbl_t *cmdtp, int flag,
112 int argc, char *argv[],
113 ulong addr, /* of image to boot */
114 ulong *len_ptr, /* multi-file image length table */
115 int verify); /* getenv("verify")[0] != 'n' */
116
wdenk8bde7f72003-06-27 21:31:46 +0000117#ifdef DEBUG
118extern int do_bdinfo ( cmd_tbl_t *cmdtp, int flag, int argc, char *argv[]);
119#endif
120
wdenk2262cfe2002-11-18 00:14:45 +0000121#ifdef CONFIG_PPC
wdenk47d1a6e2002-11-03 00:01:44 +0000122static boot_os_Fcn do_bootm_linux;
123#else
124extern boot_os_Fcn do_bootm_linux;
125#endif
wdenkf72da342003-10-10 10:05:42 +0000126#ifdef CONFIG_SILENT_CONSOLE
127static void fixup_silent_linux (void);
128#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000129static boot_os_Fcn do_bootm_netbsd;
wdenkd791b1d2003-04-20 14:04:18 +0000130static boot_os_Fcn do_bootm_rtems;
wdenk47d1a6e2002-11-03 00:01:44 +0000131#if (CONFIG_COMMANDS & CFG_CMD_ELF)
132static boot_os_Fcn do_bootm_vxworks;
133static boot_os_Fcn do_bootm_qnxelf;
134int do_bootvx ( cmd_tbl_t *cmdtp, int flag, int argc, char *argv[] );
135int do_bootelf (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[] );
136#endif /* CFG_CMD_ELF */
wdenk7f70e852003-05-20 14:25:27 +0000137#if defined(CONFIG_ARTOS) && defined(CONFIG_PPC)
138static boot_os_Fcn do_bootm_artos;
139#endif
wdenk1f4bb372003-07-27 00:21:01 +0000140#ifdef CONFIG_LYNXKDI
141static boot_os_Fcn do_bootm_lynxkdi;
142extern void lynxkdi_boot( image_header_t * );
143#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000144
Stefan Roese15940c92006-03-13 11:16:36 +0100145#ifndef CFG_BOOTM_LEN
146#define CFG_BOOTM_LEN 0x800000 /* use 8MByte as default max gunzip size */
147#endif
148
wdenk47d1a6e2002-11-03 00:01:44 +0000149image_header_t header;
150
151ulong load_addr = CFG_LOAD_ADDR; /* Default Load Address */
152
153int do_bootm (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
154{
155 ulong iflag;
156 ulong addr;
157 ulong data, len, checksum;
158 ulong *len_ptr;
Stefan Roese15940c92006-03-13 11:16:36 +0100159 uint unc_len = CFG_BOOTM_LEN;
wdenk47d1a6e2002-11-03 00:01:44 +0000160 int i, verify;
161 char *name, *s;
wdenkb13fb012003-10-30 21:49:38 +0000162 int (*appl)(int, char *[]);
wdenk47d1a6e2002-11-03 00:01:44 +0000163 image_header_t *hdr = &header;
164
165 s = getenv ("verify");
166 verify = (s && (*s == 'n')) ? 0 : 1;
167
168 if (argc < 2) {
169 addr = load_addr;
170 } else {
171 addr = simple_strtoul(argv[1], NULL, 16);
172 }
173
174 SHOW_BOOT_PROGRESS (1);
175 printf ("## Booting image at %08lx ...\n", addr);
176
177 /* Copy header so we can blank CRC field for re-calculation */
wdenk2abbe072003-06-16 23:50:08 +0000178#ifdef CONFIG_HAS_DATAFLASH
179 if (addr_dataflash(addr)){
180 read_dataflash(addr, sizeof(image_header_t), (char *)&header);
181 } else
182#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000183 memmove (&header, (char *)addr, sizeof(image_header_t));
184
185 if (ntohl(hdr->ih_magic) != IH_MAGIC) {
wdenk2262cfe2002-11-18 00:14:45 +0000186#ifdef __I386__ /* correct image format not implemented yet - fake it */
187 if (fake_header(hdr, (void*)addr, -1) != NULL) {
188 /* to compensate for the addition below */
189 addr -= sizeof(image_header_t);
190 /* turnof verify,
191 * fake_header() does not fake the data crc
192 */
193 verify = 0;
194 } else
195#endif /* __I386__ */
196 {
wdenk4b9206e2004-03-23 22:14:11 +0000197 puts ("Bad Magic Number\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000198 SHOW_BOOT_PROGRESS (-1);
199 return 1;
wdenk2262cfe2002-11-18 00:14:45 +0000200 }
wdenk47d1a6e2002-11-03 00:01:44 +0000201 }
202 SHOW_BOOT_PROGRESS (2);
203
204 data = (ulong)&header;
205 len = sizeof(image_header_t);
206
207 checksum = ntohl(hdr->ih_hcrc);
208 hdr->ih_hcrc = 0;
209
Wolfgang Denk77ddac92005-10-13 16:45:02 +0200210 if (crc32 (0, (uchar *)data, len) != checksum) {
wdenk4b9206e2004-03-23 22:14:11 +0000211 puts ("Bad Header Checksum\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000212 SHOW_BOOT_PROGRESS (-2);
213 return 1;
214 }
215 SHOW_BOOT_PROGRESS (3);
216
Wolfgang Denkbccae902005-10-06 01:50:50 +0200217#ifdef CONFIG_HAS_DATAFLASH
218 if (addr_dataflash(addr)){
219 len = ntohl(hdr->ih_size) + sizeof(image_header_t);
220 read_dataflash(addr, len, (char *)CFG_LOAD_ADDR);
221 addr = CFG_LOAD_ADDR;
222 }
223#endif
224
225
wdenk47d1a6e2002-11-03 00:01:44 +0000226 /* for multi-file images we need the data part, too */
wdenka57a4962003-10-26 22:52:58 +0000227 print_image_hdr ((image_header_t *)addr);
wdenk47d1a6e2002-11-03 00:01:44 +0000228
229 data = addr + sizeof(image_header_t);
230 len = ntohl(hdr->ih_size);
231
232 if (verify) {
wdenk4b9206e2004-03-23 22:14:11 +0000233 puts (" Verifying Checksum ... ");
Wolfgang Denk77ddac92005-10-13 16:45:02 +0200234 if (crc32 (0, (uchar *)data, len) != ntohl(hdr->ih_dcrc)) {
wdenk47d1a6e2002-11-03 00:01:44 +0000235 printf ("Bad Data CRC\n");
236 SHOW_BOOT_PROGRESS (-3);
237 return 1;
238 }
wdenk4b9206e2004-03-23 22:14:11 +0000239 puts ("OK\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000240 }
241 SHOW_BOOT_PROGRESS (4);
242
243 len_ptr = (ulong *)data;
244
wdenk2262cfe2002-11-18 00:14:45 +0000245#if defined(__PPC__)
246 if (hdr->ih_arch != IH_CPU_PPC)
247#elif defined(__ARM__)
248 if (hdr->ih_arch != IH_CPU_ARM)
249#elif defined(__I386__)
250 if (hdr->ih_arch != IH_CPU_I386)
wdenk6069ff22003-02-28 00:49:47 +0000251#elif defined(__mips__)
wdenk8bde7f72003-06-27 21:31:46 +0000252 if (hdr->ih_arch != IH_CPU_MIPS)
wdenk4a551702003-10-08 23:26:14 +0000253#elif defined(__nios__)
254 if (hdr->ih_arch != IH_CPU_NIOS)
wdenk4e5ca3e2003-12-08 01:34:36 +0000255#elif defined(__M68K__)
256 if (hdr->ih_arch != IH_CPU_M68K)
wdenk507bbe32004-04-18 21:13:41 +0000257#elif defined(__microblaze__)
258 if (hdr->ih_arch != IH_CPU_MICROBLAZE)
wdenk5c952cf2004-10-10 21:27:30 +0000259#elif defined(__nios2__)
260 if (hdr->ih_arch != IH_CPU_NIOS2)
Wolfgang Denk0afe5192006-03-12 02:10:00 +0100261#elif defined(__blackfin__)
262 if (hdr->ih_arch != IH_CPU_BLACKFIN)
wdenk2262cfe2002-11-18 00:14:45 +0000263#else
264# error Unknown CPU type
265#endif
266 {
267 printf ("Unsupported Architecture 0x%x\n", hdr->ih_arch);
wdenk47d1a6e2002-11-03 00:01:44 +0000268 SHOW_BOOT_PROGRESS (-4);
269 return 1;
270 }
271 SHOW_BOOT_PROGRESS (5);
272
273 switch (hdr->ih_type) {
wdenkb13fb012003-10-30 21:49:38 +0000274 case IH_TYPE_STANDALONE:
275 name = "Standalone Application";
276 /* A second argument overwrites the load address */
277 if (argc > 2) {
wdenkb2532ef2005-06-20 10:17:34 +0000278 hdr->ih_load = htonl(simple_strtoul(argv[2], NULL, 16));
wdenkb13fb012003-10-30 21:49:38 +0000279 }
280 break;
281 case IH_TYPE_KERNEL:
282 name = "Kernel Image";
283 break;
wdenkd4ca31c2004-01-02 14:00:00 +0000284 case IH_TYPE_MULTI:
wdenkb13fb012003-10-30 21:49:38 +0000285 name = "Multi-File Image";
286 len = ntohl(len_ptr[0]);
287 /* OS kernel is always the first image */
288 data += 8; /* kernel_len + terminator */
289 for (i=1; len_ptr[i]; ++i)
290 data += 4;
291 break;
wdenk47d1a6e2002-11-03 00:01:44 +0000292 default: printf ("Wrong Image Type for %s command\n", cmdtp->name);
293 SHOW_BOOT_PROGRESS (-5);
294 return 1;
295 }
296 SHOW_BOOT_PROGRESS (6);
297
298 /*
299 * We have reached the point of no return: we are going to
300 * overwrite all exception vector code, so we cannot easily
301 * recover from any failures any more...
302 */
303
304 iflag = disable_interrupts();
305
wdenkc7de8292002-11-19 11:04:11 +0000306#ifdef CONFIG_AMIGAONEG3SE
307 /*
wdenk8bde7f72003-06-27 21:31:46 +0000308 * We've possible left the caches enabled during
wdenkc7de8292002-11-19 11:04:11 +0000309 * bios emulation, so turn them off again
310 */
311 icache_disable();
312 invalidate_l1_instruction_cache();
313 flush_data_cache();
314 dcache_disable();
315#endif
316
wdenk47d1a6e2002-11-03 00:01:44 +0000317 switch (hdr->ih_comp) {
318 case IH_COMP_NONE:
wdenk2262cfe2002-11-18 00:14:45 +0000319 if(ntohl(hdr->ih_load) == addr) {
wdenk47d1a6e2002-11-03 00:01:44 +0000320 printf (" XIP %s ... ", name);
321 } else {
322#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
323 size_t l = len;
324 void *to = (void *)ntohl(hdr->ih_load);
325 void *from = (void *)data;
326
327 printf (" Loading %s ... ", name);
328
329 while (l > 0) {
330 size_t tail = (l > CHUNKSZ) ? CHUNKSZ : l;
331 WATCHDOG_RESET();
332 memmove (to, from, tail);
333 to += tail;
334 from += tail;
335 l -= tail;
336 }
337#else /* !(CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG) */
338 memmove ((void *) ntohl(hdr->ih_load), (uchar *)data, len);
339#endif /* CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG */
340 }
341 break;
342 case IH_COMP_GZIP:
343 printf (" Uncompressing %s ... ", name);
wdenkc29fdfc2003-08-29 20:57:53 +0000344 if (gunzip ((void *)ntohl(hdr->ih_load), unc_len,
wdenkeedcd072004-09-08 22:03:11 +0000345 (uchar *)data, &len) != 0) {
wdenk4b9206e2004-03-23 22:14:11 +0000346 puts ("GUNZIP ERROR - must RESET board to recover\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000347 SHOW_BOOT_PROGRESS (-6);
348 do_reset (cmdtp, flag, argc, argv);
349 }
350 break;
wdenkc29fdfc2003-08-29 20:57:53 +0000351#ifdef CONFIG_BZIP2
352 case IH_COMP_BZIP2:
353 printf (" Uncompressing %s ... ", name);
wdenk5653fc32004-02-08 22:55:38 +0000354 /*
355 * If we've got less than 4 MB of malloc() space,
356 * use slower decompression algorithm which requires
357 * at most 2300 KB of memory.
358 */
wdenkc29fdfc2003-08-29 20:57:53 +0000359 i = BZ2_bzBuffToBuffDecompress ((char*)ntohl(hdr->ih_load),
wdenk5653fc32004-02-08 22:55:38 +0000360 &unc_len, (char *)data, len,
361 CFG_MALLOC_LEN < (4096 * 1024), 0);
wdenkc29fdfc2003-08-29 20:57:53 +0000362 if (i != BZ_OK) {
363 printf ("BUNZIP2 ERROR %d - must RESET board to recover\n", i);
364 SHOW_BOOT_PROGRESS (-6);
365 udelay(100000);
366 do_reset (cmdtp, flag, argc, argv);
367 }
368 break;
369#endif /* CONFIG_BZIP2 */
wdenk47d1a6e2002-11-03 00:01:44 +0000370 default:
371 if (iflag)
372 enable_interrupts();
373 printf ("Unimplemented compression type %d\n", hdr->ih_comp);
374 SHOW_BOOT_PROGRESS (-7);
375 return 1;
376 }
wdenk4b9206e2004-03-23 22:14:11 +0000377 puts ("OK\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000378 SHOW_BOOT_PROGRESS (7);
379
380 switch (hdr->ih_type) {
381 case IH_TYPE_STANDALONE:
wdenk47d1a6e2002-11-03 00:01:44 +0000382 if (iflag)
383 enable_interrupts();
384
wdenk4a6fd342003-04-12 23:38:12 +0000385 /* load (and uncompress), but don't start if "autostart"
386 * is set to "no"
387 */
wdenk4a551702003-10-08 23:26:14 +0000388 if (((s = getenv("autostart")) != NULL) && (strcmp(s,"no") == 0)) {
389 char buf[32];
390 sprintf(buf, "%lX", len);
391 setenv("filesize", buf);
wdenk4a6fd342003-04-12 23:38:12 +0000392 return 0;
wdenk4a551702003-10-08 23:26:14 +0000393 }
wdenkb13fb012003-10-30 21:49:38 +0000394 appl = (int (*)(int, char *[]))ntohl(hdr->ih_ep);
395 (*appl)(argc-1, &argv[1]);
wdenk4a6fd342003-04-12 23:38:12 +0000396 return 0;
wdenk47d1a6e2002-11-03 00:01:44 +0000397 case IH_TYPE_KERNEL:
398 case IH_TYPE_MULTI:
399 /* handled below */
400 break;
401 default:
402 if (iflag)
403 enable_interrupts();
404 printf ("Can't boot image type %d\n", hdr->ih_type);
405 SHOW_BOOT_PROGRESS (-8);
406 return 1;
407 }
408 SHOW_BOOT_PROGRESS (8);
409
410 switch (hdr->ih_os) {
411 default: /* handled by (original) Linux case */
412 case IH_OS_LINUX:
wdenkf72da342003-10-10 10:05:42 +0000413#ifdef CONFIG_SILENT_CONSOLE
414 fixup_silent_linux();
415#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000416 do_bootm_linux (cmdtp, flag, argc, argv,
417 addr, len_ptr, verify);
418 break;
419 case IH_OS_NETBSD:
420 do_bootm_netbsd (cmdtp, flag, argc, argv,
421 addr, len_ptr, verify);
422 break;
wdenk8bde7f72003-06-27 21:31:46 +0000423
wdenk1f4bb372003-07-27 00:21:01 +0000424#ifdef CONFIG_LYNXKDI
425 case IH_OS_LYNXOS:
426 do_bootm_lynxkdi (cmdtp, flag, argc, argv,
427 addr, len_ptr, verify);
428 break;
429#endif
430
wdenkd791b1d2003-04-20 14:04:18 +0000431 case IH_OS_RTEMS:
432 do_bootm_rtems (cmdtp, flag, argc, argv,
433 addr, len_ptr, verify);
434 break;
wdenk8bde7f72003-06-27 21:31:46 +0000435
wdenk47d1a6e2002-11-03 00:01:44 +0000436#if (CONFIG_COMMANDS & CFG_CMD_ELF)
437 case IH_OS_VXWORKS:
438 do_bootm_vxworks (cmdtp, flag, argc, argv,
439 addr, len_ptr, verify);
440 break;
441 case IH_OS_QNX:
442 do_bootm_qnxelf (cmdtp, flag, argc, argv,
443 addr, len_ptr, verify);
444 break;
445#endif /* CFG_CMD_ELF */
wdenk7f70e852003-05-20 14:25:27 +0000446#ifdef CONFIG_ARTOS
447 case IH_OS_ARTOS:
448 do_bootm_artos (cmdtp, flag, argc, argv,
449 addr, len_ptr, verify);
450 break;
451#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000452 }
453
454 SHOW_BOOT_PROGRESS (-9);
455#ifdef DEBUG
wdenk4b9206e2004-03-23 22:14:11 +0000456 puts ("\n## Control returned to monitor - resetting...\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000457 do_reset (cmdtp, flag, argc, argv);
458#endif
459 return 1;
460}
461
wdenk0d498392003-07-01 21:06:45 +0000462U_BOOT_CMD(
463 bootm, CFG_MAXARGS, 1, do_bootm,
wdenk8bde7f72003-06-27 21:31:46 +0000464 "bootm - boot application image from memory\n",
465 "[addr [arg ...]]\n - boot application image stored in memory\n"
wdenk9d5028c2004-11-21 00:06:33 +0000466 "\tpassing arguments 'arg ...'; when booting a Linux kernel,\n"
467 "\t'arg' can be the address of an initrd image\n"
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500468#ifdef CONFIG_OF_FLAT_TREE
469 "\tWhen booting a Linux kernel which requires a flat device-tree\n"
470 "\ta third argument is required which is the address of the of the\n"
471 "\tdevice-tree blob. To boot that kernel without an initrd image,\n"
472 "\tuse a '-' for the second argument. If you do not pass a third\n"
473 "\ta bd_info struct will be passed instead\n"
474#endif
wdenk8bde7f72003-06-27 21:31:46 +0000475);
476
wdenkf72da342003-10-10 10:05:42 +0000477#ifdef CONFIG_SILENT_CONSOLE
478static void
479fixup_silent_linux ()
480{
wdenkf72da342003-10-10 10:05:42 +0000481 char buf[256], *start, *end;
482 char *cmdline = getenv ("bootargs");
483
484 /* Only fix cmdline when requested */
485 if (!(gd->flags & GD_FLG_SILENT))
486 return;
487
488 debug ("before silent fix-up: %s\n", cmdline);
489 if (cmdline) {
490 if ((start = strstr (cmdline, "console=")) != NULL) {
491 end = strchr (start, ' ');
492 strncpy (buf, cmdline, (start - cmdline + 8));
493 if (end)
494 strcpy (buf + (start - cmdline + 8), end);
495 else
496 buf[start - cmdline + 8] = '\0';
497 } else {
498 strcpy (buf, cmdline);
499 strcat (buf, " console=");
500 }
501 } else {
502 strcpy (buf, "console=");
503 }
504
505 setenv ("bootargs", buf);
506 debug ("after silent fix-up: %s\n", buf);
507}
508#endif /* CONFIG_SILENT_CONSOLE */
509
wdenk2262cfe2002-11-18 00:14:45 +0000510#ifdef CONFIG_PPC
Matthew McClintockb2b78422006-08-23 13:32:45 -0500511static void __attribute__((noinline))
wdenk47d1a6e2002-11-03 00:01:44 +0000512do_bootm_linux (cmd_tbl_t *cmdtp, int flag,
513 int argc, char *argv[],
514 ulong addr,
515 ulong *len_ptr,
516 int verify)
517{
wdenk47d1a6e2002-11-03 00:01:44 +0000518 ulong sp;
519 ulong len, checksum;
520 ulong initrd_start, initrd_end;
521 ulong cmd_start, cmd_end;
522 ulong initrd_high;
523 ulong data;
wdenk38b99262003-05-23 23:18:21 +0000524 int initrd_copy_to_ram = 1;
wdenk47d1a6e2002-11-03 00:01:44 +0000525 char *cmdline;
526 char *s;
527 bd_t *kbd;
528 void (*kernel)(bd_t *, ulong, ulong, ulong, ulong);
529 image_header_t *hdr = &header;
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200530#ifdef CONFIG_OF_FLAT_TREE
Matthew McClintock25c751e2006-08-16 10:54:09 -0500531 char *of_flat_tree = NULL;
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200532#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000533
534 if ((s = getenv ("initrd_high")) != NULL) {
535 /* a value of "no" or a similar string will act like 0,
536 * turning the "load high" feature off. This is intentional.
537 */
538 initrd_high = simple_strtoul(s, NULL, 16);
wdenk38b99262003-05-23 23:18:21 +0000539 if (initrd_high == ~0)
540 initrd_copy_to_ram = 0;
wdenk228f29a2002-12-08 09:53:23 +0000541 } else { /* not set, no restrictions to load high */
wdenk47d1a6e2002-11-03 00:01:44 +0000542 initrd_high = ~0;
543 }
544
wdenk56f94be2002-11-05 16:35:14 +0000545#ifdef CONFIG_LOGBUFFER
wdenk6aff3112002-12-17 01:51:00 +0000546 kbd=gd->bd;
wdenk228f29a2002-12-08 09:53:23 +0000547 /* Prevent initrd from overwriting logbuffer */
548 if (initrd_high < (kbd->bi_memsize-LOGBUFF_LEN-LOGBUFF_OVERHEAD))
549 initrd_high = kbd->bi_memsize-LOGBUFF_LEN-LOGBUFF_OVERHEAD;
550 debug ("## Logbuffer at 0x%08lX ", kbd->bi_memsize-LOGBUFF_LEN);
wdenk56f94be2002-11-05 16:35:14 +0000551#endif
552
wdenk47d1a6e2002-11-03 00:01:44 +0000553 /*
554 * Booting a (Linux) kernel image
555 *
556 * Allocate space for command line and board info - the
557 * address should be as high as possible within the reach of
558 * the kernel (see CFG_BOOTMAPSZ settings), but in unused
559 * memory, which means far enough below the current stack
560 * pointer.
561 */
562
563 asm( "mr %0,1": "=r"(sp) : );
564
wdenk56f94be2002-11-05 16:35:14 +0000565 debug ("## Current stack ends at 0x%08lX ", sp);
566
wdenk47d1a6e2002-11-03 00:01:44 +0000567 sp -= 2048; /* just to be sure */
568 if (sp > CFG_BOOTMAPSZ)
569 sp = CFG_BOOTMAPSZ;
570 sp &= ~0xF;
571
wdenk56f94be2002-11-05 16:35:14 +0000572 debug ("=> set upper limit to 0x%08lX\n", sp);
573
wdenk47d1a6e2002-11-03 00:01:44 +0000574 cmdline = (char *)((sp - CFG_BARGSIZE) & ~0xF);
575 kbd = (bd_t *)(((ulong)cmdline - sizeof(bd_t)) & ~0xF);
576
577 if ((s = getenv("bootargs")) == NULL)
578 s = "";
579
580 strcpy (cmdline, s);
581
582 cmd_start = (ulong)&cmdline[0];
583 cmd_end = cmd_start + strlen(cmdline);
584
585 *kbd = *(gd->bd);
586
587#ifdef DEBUG
588 printf ("## cmdline at 0x%08lX ... 0x%08lX\n", cmd_start, cmd_end);
589
590 do_bdinfo (NULL, 0, 0, NULL);
591#endif
592
593 if ((s = getenv ("clocks_in_mhz")) != NULL) {
594 /* convert all clock information to MHz */
595 kbd->bi_intfreq /= 1000000L;
596 kbd->bi_busfreq /= 1000000L;
wdenk983fda82004-10-28 00:09:35 +0000597#if defined(CONFIG_MPC8220)
wdenk9d5028c2004-11-21 00:06:33 +0000598 kbd->bi_inpfreq /= 1000000L;
599 kbd->bi_pcifreq /= 1000000L;
600 kbd->bi_pevfreq /= 1000000L;
601 kbd->bi_flbfreq /= 1000000L;
602 kbd->bi_vcofreq /= 1000000L;
wdenk983fda82004-10-28 00:09:35 +0000603#endif
Jon Loeliger9c4c5ae2005-07-23 10:37:35 -0500604#if defined(CONFIG_CPM2)
wdenk47d1a6e2002-11-03 00:01:44 +0000605 kbd->bi_cpmfreq /= 1000000L;
606 kbd->bi_brgfreq /= 1000000L;
607 kbd->bi_sccfreq /= 1000000L;
608 kbd->bi_vco /= 1000000L;
Jon Loeliger9c4c5ae2005-07-23 10:37:35 -0500609#endif
wdenkcbd8a352004-02-24 02:00:03 +0000610#if defined(CONFIG_MPC5xxx)
wdenk945af8d2003-07-16 21:53:01 +0000611 kbd->bi_ipbfreq /= 1000000L;
612 kbd->bi_pcifreq /= 1000000L;
wdenkcbd8a352004-02-24 02:00:03 +0000613#endif /* CONFIG_MPC5xxx */
wdenk47d1a6e2002-11-03 00:01:44 +0000614 }
615
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100616 kernel = (void (*)(bd_t *, ulong, ulong, ulong, ulong)) ntohl(hdr->ih_ep);
wdenk47d1a6e2002-11-03 00:01:44 +0000617
618 /*
619 * Check if there is an initrd image
620 */
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500621
622#ifdef CONFIG_OF_FLAT_TREE
623 /* Look for a '-' which indicates to ignore the ramdisk argument */
624 if (argc >= 3 && strcmp(argv[2], "-") == 0) {
625 debug ("Skipping initrd\n");
626 data = 0;
627 }
628 else
629#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000630 if (argc >= 3) {
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500631 debug ("Not skipping initrd\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000632 SHOW_BOOT_PROGRESS (9);
633
634 addr = simple_strtoul(argv[2], NULL, 16);
635
636 printf ("## Loading RAMDisk Image at %08lx ...\n", addr);
637
638 /* Copy header so we can blank CRC field for re-calculation */
639 memmove (&header, (char *)addr, sizeof(image_header_t));
640
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100641 if (ntohl(hdr->ih_magic) != IH_MAGIC) {
wdenk4b9206e2004-03-23 22:14:11 +0000642 puts ("Bad Magic Number\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000643 SHOW_BOOT_PROGRESS (-10);
644 do_reset (cmdtp, flag, argc, argv);
645 }
646
647 data = (ulong)&header;
648 len = sizeof(image_header_t);
649
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100650 checksum = ntohl(hdr->ih_hcrc);
wdenk47d1a6e2002-11-03 00:01:44 +0000651 hdr->ih_hcrc = 0;
652
Wolfgang Denk77ddac92005-10-13 16:45:02 +0200653 if (crc32 (0, (uchar *)data, len) != checksum) {
wdenk4b9206e2004-03-23 22:14:11 +0000654 puts ("Bad Header Checksum\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000655 SHOW_BOOT_PROGRESS (-11);
656 do_reset (cmdtp, flag, argc, argv);
657 }
658
659 SHOW_BOOT_PROGRESS (10);
660
661 print_image_hdr (hdr);
662
663 data = addr + sizeof(image_header_t);
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100664 len = ntohl(hdr->ih_size);
wdenk47d1a6e2002-11-03 00:01:44 +0000665
666 if (verify) {
667 ulong csum = 0;
668#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
669 ulong cdata = data, edata = cdata + len;
670#endif /* CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG */
671
wdenk4b9206e2004-03-23 22:14:11 +0000672 puts (" Verifying Checksum ... ");
wdenk47d1a6e2002-11-03 00:01:44 +0000673
674#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
675
676 while (cdata < edata) {
677 ulong chunk = edata - cdata;
678
679 if (chunk > CHUNKSZ)
680 chunk = CHUNKSZ;
Wolfgang Denk77ddac92005-10-13 16:45:02 +0200681 csum = crc32 (csum, (uchar *)cdata, chunk);
wdenk47d1a6e2002-11-03 00:01:44 +0000682 cdata += chunk;
683
684 WATCHDOG_RESET();
685 }
686#else /* !(CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG) */
Wolfgang Denk77ddac92005-10-13 16:45:02 +0200687 csum = crc32 (0, (uchar *)data, len);
wdenk47d1a6e2002-11-03 00:01:44 +0000688#endif /* CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG */
689
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100690 if (csum != ntohl(hdr->ih_dcrc)) {
wdenk4b9206e2004-03-23 22:14:11 +0000691 puts ("Bad Data CRC\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000692 SHOW_BOOT_PROGRESS (-12);
693 do_reset (cmdtp, flag, argc, argv);
694 }
wdenk4b9206e2004-03-23 22:14:11 +0000695 puts ("OK\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000696 }
697
698 SHOW_BOOT_PROGRESS (11);
699
700 if ((hdr->ih_os != IH_OS_LINUX) ||
701 (hdr->ih_arch != IH_CPU_PPC) ||
702 (hdr->ih_type != IH_TYPE_RAMDISK) ) {
wdenk4b9206e2004-03-23 22:14:11 +0000703 puts ("No Linux PPC Ramdisk Image\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000704 SHOW_BOOT_PROGRESS (-13);
705 do_reset (cmdtp, flag, argc, argv);
706 }
707
708 /*
709 * Now check if we have a multifile image
710 */
711 } else if ((hdr->ih_type==IH_TYPE_MULTI) && (len_ptr[1])) {
712 u_long tail = ntohl(len_ptr[0]) % 4;
713 int i;
714
715 SHOW_BOOT_PROGRESS (13);
716
717 /* skip kernel length and terminator */
718 data = (ulong)(&len_ptr[2]);
719 /* skip any additional image length fields */
720 for (i=1; len_ptr[i]; ++i)
721 data += 4;
722 /* add kernel length, and align */
723 data += ntohl(len_ptr[0]);
724 if (tail) {
725 data += 4 - tail;
726 }
727
728 len = ntohl(len_ptr[1]);
729
730 } else {
731 /*
732 * no initrd image
733 */
734 SHOW_BOOT_PROGRESS (14);
735
736 len = data = 0;
737 }
738
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500739#ifdef CONFIG_OF_FLAT_TREE
Matthew McClintock86c8e172006-08-16 13:59:47 -0500740 if(argc > 3) {
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500741 of_flat_tree = (char *) simple_strtoul(argv[3], NULL, 16);
Matthew McClintock25c751e2006-08-16 10:54:09 -0500742 hdr = (image_header_t *)of_flat_tree;
743
744 if (*(ulong *)of_flat_tree == OF_DT_HEADER) {
745#ifndef CFG_NO_FLASH
746 if (addr2info((ulong)of_flat_tree) != NULL) {
747 printf ("Cannot modify flat device tree stored in flash\n" \
748 "Copy to memory before using the bootm command\n");
749 return;
750 }
751#endif
752 } else if (ntohl(hdr->ih_magic) == IH_MAGIC) {
753 printf("## Flat Device Tree Image at %08lX\n", hdr);
754 print_image_hdr(hdr);
755
756 if ((ntohl(hdr->ih_load) < ((unsigned long)hdr + ntohl(hdr->ih_size) + sizeof(hdr))) &&
757 ((ntohl(hdr->ih_load) + ntohl(hdr->ih_size)) > (unsigned long)hdr)) {
758 printf ("ERROR: Load address overwrites Flat Device Tree uImage\n");
759 return;
760 }
761
762 printf(" Verifying Checksum ... ");
763 memmove (&header, (char *)hdr, sizeof(image_header_t));
764 checksum = ntohl(header.ih_hcrc);
765 header.ih_hcrc = 0;
766
767 if(checksum != crc32(0, (uchar *)&header, sizeof(image_header_t))) {
768 printf("ERROR: Flat Device Tree header checksum is invalid\n");
769 return;
770 }
771
772 checksum = ntohl(hdr->ih_dcrc);
773 addr = (ulong)((uchar *)(hdr) + sizeof(image_header_t));
774 len = ntohl(hdr->ih_size);
775
776 if(checksum != crc32(0, (uchar *)addr, len)) {
777 printf("ERROR: Flat Device Tree checksum is invalid\n");
778 return;
779 }
780 printf("OK\n");
781
782 if (ntohl(hdr->ih_type) != IH_TYPE_FLATDT) {
783 printf ("ERROR: uImage not Flat Device Tree type\n");
784 return;
785 }
786 if (ntohl(hdr->ih_comp) != IH_COMP_NONE) {
787 printf("ERROR: uImage is not uncompressed\n");
788 return;
789 }
790 if (*((ulong *)(of_flat_tree + sizeof(image_header_t))) != OF_DT_HEADER) {
791 printf ("ERROR: uImage data is not a flat device tree\n");
792 return;
793 }
794
795 memmove((void *)ntohl(hdr->ih_load),
796 (void *)(of_flat_tree + sizeof(image_header_t)),
797 ntohl(hdr->ih_size));
798 of_flat_tree = (char *)ntohl(hdr->ih_load);
799 } else {
800 printf ("Did not find a flat flat device tree at address %08lX\n", of_flat_tree);
801 return;
802 }
803 printf (" Booting using flat device tree at 0x%x\n",
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500804 of_flat_tree);
Matthew McClintock86c8e172006-08-16 13:59:47 -0500805 } else if(getenv("disable_of") == NULL) {
806 printf ("ERROR: bootm needs flat device tree as third argument\n");
807 return;
Matthew McClintock98a9c4d2006-06-28 10:41:37 -0500808 }
809#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000810 if (!data) {
wdenk56f94be2002-11-05 16:35:14 +0000811 debug ("No initrd\n");
wdenk47d1a6e2002-11-03 00:01:44 +0000812 }
wdenk47d1a6e2002-11-03 00:01:44 +0000813
814 if (data) {
wdenk38b99262003-05-23 23:18:21 +0000815 if (!initrd_copy_to_ram) { /* zero-copy ramdisk support */
816 initrd_start = data;
817 initrd_end = initrd_start + len;
818 } else {
wdenk47d1a6e2002-11-03 00:01:44 +0000819 initrd_start = (ulong)kbd - len;
820 initrd_start &= ~(4096 - 1); /* align on page */
821
822 if (initrd_high) {
823 ulong nsp;
824
825 /*
826 * the inital ramdisk does not need to be within
827 * CFG_BOOTMAPSZ as it is not accessed until after
828 * the mm system is initialised.
829 *
830 * do the stack bottom calculation again and see if
831 * the initrd will fit just below the monitor stack
832 * bottom without overwriting the area allocated
833 * above for command line args and board info.
834 */
835 asm( "mr %0,1": "=r"(nsp) : );
836 nsp -= 2048; /* just to be sure */
837 nsp &= ~0xF;
838 if (nsp > initrd_high) /* limit as specified */
839 nsp = initrd_high;
840 nsp -= len;
841 nsp &= ~(4096 - 1); /* align on page */
842 if (nsp >= sp)
843 initrd_start = nsp;
844 }
845
846 SHOW_BOOT_PROGRESS (12);
wdenk56f94be2002-11-05 16:35:14 +0000847
848 debug ("## initrd at 0x%08lX ... 0x%08lX (len=%ld=0x%lX)\n",
wdenk47d1a6e2002-11-03 00:01:44 +0000849 data, data + len - 1, len, len);
wdenk56f94be2002-11-05 16:35:14 +0000850
wdenk47d1a6e2002-11-03 00:01:44 +0000851 initrd_end = initrd_start + len;
852 printf (" Loading Ramdisk to %08lx, end %08lx ... ",
853 initrd_start, initrd_end);
854#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
855 {
856 size_t l = len;
857 void *to = (void *)initrd_start;
858 void *from = (void *)data;
859
860 while (l > 0) {
861 size_t tail = (l > CHUNKSZ) ? CHUNKSZ : l;
862 WATCHDOG_RESET();
863 memmove (to, from, tail);
864 to += tail;
865 from += tail;
866 l -= tail;
867 }
868 }
869#else /* !(CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG) */
870 memmove ((void *)initrd_start, (void *)data, len);
871#endif /* CONFIG_HW_WATCHDOG || CONFIG_WATCHDOG */
wdenk4b9206e2004-03-23 22:14:11 +0000872 puts ("OK\n");
wdenk38b99262003-05-23 23:18:21 +0000873 }
wdenk47d1a6e2002-11-03 00:01:44 +0000874 } else {
875 initrd_start = 0;
876 initrd_end = 0;
877 }
878
wdenk56f94be2002-11-05 16:35:14 +0000879 debug ("## Transferring control to Linux (at address %08lx) ...\n",
wdenk47d1a6e2002-11-03 00:01:44 +0000880 (ulong)kernel);
wdenk56f94be2002-11-05 16:35:14 +0000881
wdenk47d1a6e2002-11-03 00:01:44 +0000882 SHOW_BOOT_PROGRESS (15);
883
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200884#ifndef CONFIG_OF_FLAT_TREE
885
wdenk42d1f032003-10-15 23:53:47 +0000886#if defined(CFG_INIT_RAM_LOCK) && !defined(CONFIG_E500)
wdenk47d1a6e2002-11-03 00:01:44 +0000887 unlock_ram_in_cache();
888#endif
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200889
wdenk47d1a6e2002-11-03 00:01:44 +0000890 /*
891 * Linux Kernel Parameters:
892 * r3: ptr to board info data
893 * r4: initrd_start or 0 if no initrd
894 * r5: initrd_end - unused if r4 is 0
895 * r6: Start of command line string
896 * r7: End of command line string
897 */
898 (*kernel) (kbd, initrd_start, initrd_end, cmd_start, cmd_end);
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200899
900#else
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200901
902#if defined(CFG_INIT_RAM_LOCK) && !defined(CONFIG_E500)
903 unlock_ram_in_cache();
904#endif
905 /*
906 * Linux Kernel Parameters:
907 * r3: ptr to OF flat tree, followed by the board info data
Kumar Galae559a692006-01-11 16:41:35 -0600908 * r4: physical pointer to the kernel itself
909 * r5: NULL
910 * r6: NULL
911 * r7: NULL
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200912 */
Kumar Galae559a692006-01-11 16:41:35 -0600913 if (getenv("disable_of") != NULL)
914 (*kernel) ((bd_t *)of_flat_tree, initrd_start, initrd_end,
915 cmd_start, cmd_end);
Matthew McClintockb2b78422006-08-23 13:32:45 -0500916 else {
917 ft_setup(of_flat_tree, kbd, initrd_start, initrd_end);
918 /* ft_dump_blob(of_flat_tree); */
Kumar Galae559a692006-01-11 16:41:35 -0600919 (*kernel) ((bd_t *)of_flat_tree, (ulong)kernel, 0, 0, 0);
Matthew McClintockb2b78422006-08-23 13:32:45 -0500920 }
921
Wolfgang Denkf57f70a2005-10-13 01:45:54 +0200922#endif
wdenk47d1a6e2002-11-03 00:01:44 +0000923}
wdenk1cb8e982003-03-06 21:55:29 +0000924#endif /* CONFIG_PPC */
wdenk47d1a6e2002-11-03 00:01:44 +0000925
926static void
927do_bootm_netbsd (cmd_tbl_t *cmdtp, int flag,
928 int argc, char *argv[],
929 ulong addr,
930 ulong *len_ptr,
931 int verify)
932{
wdenk47d1a6e2002-11-03 00:01:44 +0000933 image_header_t *hdr = &header;
934
935 void (*loader)(bd_t *, image_header_t *, char *, char *);
936 image_header_t *img_addr;
937 char *consdev;
938 char *cmdline;
939
940
941 /*
942 * Booting a (NetBSD) kernel image
943 *
944 * This process is pretty similar to a standalone application:
945 * The (first part of an multi-) image must be a stage-2 loader,
946 * which in turn is responsible for loading & invoking the actual
947 * kernel. The only differences are the parameters being passed:
948 * besides the board info strucure, the loader expects a command
949 * line, the name of the console device, and (optionally) the
950 * address of the original image header.
951 */
952
953 img_addr = 0;
954 if ((hdr->ih_type==IH_TYPE_MULTI) && (len_ptr[1]))
955 img_addr = (image_header_t *) addr;
956
957
958 consdev = "";
959#if defined (CONFIG_8xx_CONS_SMC1)
960 consdev = "smc1";
961#elif defined (CONFIG_8xx_CONS_SMC2)
962 consdev = "smc2";
963#elif defined (CONFIG_8xx_CONS_SCC2)
964 consdev = "scc2";
965#elif defined (CONFIG_8xx_CONS_SCC3)
966 consdev = "scc3";
967#endif
968
969 if (argc > 2) {
970 ulong len;
971 int i;
972
973 for (i=2, len=0 ; i<argc ; i+=1)
974 len += strlen (argv[i]) + 1;
975 cmdline = malloc (len);
976
977 for (i=2, len=0 ; i<argc ; i+=1) {
978 if (i > 2)
979 cmdline[len++] = ' ';
980 strcpy (&cmdline[len], argv[i]);
981 len += strlen (argv[i]);
982 }
983 } else if ((cmdline = getenv("bootargs")) == NULL) {
984 cmdline = "";
985 }
986
Wolfgang Denkdc013d42006-03-12 01:59:35 +0100987 loader = (void (*)(bd_t *, image_header_t *, char *, char *)) ntohl(hdr->ih_ep);
wdenk47d1a6e2002-11-03 00:01:44 +0000988
989 printf ("## Transferring control to NetBSD stage-2 loader (at address %08lx) ...\n",
990 (ulong)loader);
991
992 SHOW_BOOT_PROGRESS (15);
993
994 /*
995 * NetBSD Stage-2 Loader Parameters:
996 * r3: ptr to board info data
997 * r4: image address
998 * r5: console device
999 * r6: boot args string
1000 */
1001 (*loader) (gd->bd, img_addr, consdev, cmdline);
1002}
1003
wdenk7f70e852003-05-20 14:25:27 +00001004#if defined(CONFIG_ARTOS) && defined(CONFIG_PPC)
1005
1006/* Function that returns a character from the environment */
1007extern uchar (*env_get_char)(int);
1008
1009static void
1010do_bootm_artos (cmd_tbl_t *cmdtp, int flag,
1011 int argc, char *argv[],
1012 ulong addr,
1013 ulong *len_ptr,
1014 int verify)
1015{
wdenk7f70e852003-05-20 14:25:27 +00001016 ulong top;
1017 char *s, *cmdline;
1018 char **fwenv, **ss;
1019 int i, j, nxt, len, envno, envsz;
1020 bd_t *kbd;
1021 void (*entry)(bd_t *bd, char *cmdline, char **fwenv, ulong top);
1022 image_header_t *hdr = &header;
1023
1024 /*
1025 * Booting an ARTOS kernel image + application
1026 */
1027
1028 /* this used to be the top of memory, but was wrong... */
1029#ifdef CONFIG_PPC
1030 /* get stack pointer */
1031 asm volatile ("mr %0,1" : "=r"(top) );
1032#endif
1033 debug ("## Current stack ends at 0x%08lX ", top);
1034
1035 top -= 2048; /* just to be sure */
1036 if (top > CFG_BOOTMAPSZ)
1037 top = CFG_BOOTMAPSZ;
1038 top &= ~0xF;
1039
1040 debug ("=> set upper limit to 0x%08lX\n", top);
1041
1042 /* first check the artos specific boot args, then the linux args*/
1043 if ((s = getenv("abootargs")) == NULL && (s = getenv("bootargs")) == NULL)
1044 s = "";
1045
1046 /* get length of cmdline, and place it */
1047 len = strlen(s);
1048 top = (top - (len + 1)) & ~0xF;
1049 cmdline = (char *)top;
1050 debug ("## cmdline at 0x%08lX ", top);
1051 strcpy(cmdline, s);
1052
1053 /* copy bdinfo */
1054 top = (top - sizeof(bd_t)) & ~0xF;
1055 debug ("## bd at 0x%08lX ", top);
1056 kbd = (bd_t *)top;
1057 memcpy(kbd, gd->bd, sizeof(bd_t));
1058
1059 /* first find number of env entries, and their size */
1060 envno = 0;
1061 envsz = 0;
1062 for (i = 0; env_get_char(i) != '\0'; i = nxt + 1) {
1063 for (nxt = i; env_get_char(nxt) != '\0'; ++nxt)
1064 ;
1065 envno++;
1066 envsz += (nxt - i) + 1; /* plus trailing zero */
1067 }
1068 envno++; /* plus the terminating zero */
1069 debug ("## %u envvars total size %u ", envno, envsz);
1070
1071 top = (top - sizeof(char **)*envno) & ~0xF;
1072 fwenv = (char **)top;
1073 debug ("## fwenv at 0x%08lX ", top);
1074
1075 top = (top - envsz) & ~0xF;
1076 s = (char *)top;
1077 ss = fwenv;
1078
1079 /* now copy them */
1080 for (i = 0; env_get_char(i) != '\0'; i = nxt + 1) {
1081 for (nxt = i; env_get_char(nxt) != '\0'; ++nxt)
1082 ;
1083 *ss++ = s;
1084 for (j = i; j < nxt; ++j)
1085 *s++ = env_get_char(j);
1086 *s++ = '\0';
1087 }
1088 *ss++ = NULL; /* terminate */
1089
1090 entry = (void (*)(bd_t *, char *, char **, ulong))ntohl(hdr->ih_ep);
1091 (*entry)(kbd, cmdline, fwenv, top);
1092}
1093#endif
1094
1095
wdenk47d1a6e2002-11-03 00:01:44 +00001096#if (CONFIG_COMMANDS & CFG_CMD_BOOTD)
1097int do_bootd (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
1098{
1099 int rcode = 0;
1100#ifndef CFG_HUSH_PARSER
1101 if (run_command (getenv ("bootcmd"), flag) < 0) rcode = 1;
1102#else
1103 if (parse_string_outer(getenv("bootcmd"),
1104 FLAG_PARSE_SEMICOLON | FLAG_EXIT_FROM_LOOP) != 0 ) rcode = 1;
1105#endif
1106 return rcode;
1107}
wdenk8bde7f72003-06-27 21:31:46 +00001108
wdenk0d498392003-07-01 21:06:45 +00001109U_BOOT_CMD(
1110 boot, 1, 1, do_bootd,
wdenk9d2b18a2003-06-28 23:11:04 +00001111 "boot - boot default, i.e., run 'bootcmd'\n",
1112 NULL
1113);
1114
1115/* keep old command name "bootd" for backward compatibility */
wdenk0d498392003-07-01 21:06:45 +00001116U_BOOT_CMD(
1117 bootd, 1, 1, do_bootd,
wdenk8bde7f72003-06-27 21:31:46 +00001118 "bootd - boot default, i.e., run 'bootcmd'\n",
1119 NULL
1120);
1121
wdenk47d1a6e2002-11-03 00:01:44 +00001122#endif
1123
1124#if (CONFIG_COMMANDS & CFG_CMD_IMI)
1125int do_iminfo ( cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
1126{
1127 int arg;
1128 ulong addr;
1129 int rcode=0;
1130
1131 if (argc < 2) {
1132 return image_info (load_addr);
1133 }
1134
1135 for (arg=1; arg <argc; ++arg) {
1136 addr = simple_strtoul(argv[arg], NULL, 16);
1137 if (image_info (addr) != 0) rcode = 1;
1138 }
1139 return rcode;
1140}
1141
1142static int image_info (ulong addr)
1143{
1144 ulong data, len, checksum;
1145 image_header_t *hdr = &header;
1146
1147 printf ("\n## Checking Image at %08lx ...\n", addr);
1148
1149 /* Copy header so we can blank CRC field for re-calculation */
1150 memmove (&header, (char *)addr, sizeof(image_header_t));
1151
1152 if (ntohl(hdr->ih_magic) != IH_MAGIC) {
wdenk4b9206e2004-03-23 22:14:11 +00001153 puts (" Bad Magic Number\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001154 return 1;
1155 }
1156
1157 data = (ulong)&header;
1158 len = sizeof(image_header_t);
1159
1160 checksum = ntohl(hdr->ih_hcrc);
1161 hdr->ih_hcrc = 0;
1162
Wolfgang Denk77ddac92005-10-13 16:45:02 +02001163 if (crc32 (0, (uchar *)data, len) != checksum) {
wdenk4b9206e2004-03-23 22:14:11 +00001164 puts (" Bad Header Checksum\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001165 return 1;
1166 }
1167
1168 /* for multi-file images we need the data part, too */
1169 print_image_hdr ((image_header_t *)addr);
1170
1171 data = addr + sizeof(image_header_t);
1172 len = ntohl(hdr->ih_size);
1173
wdenk4b9206e2004-03-23 22:14:11 +00001174 puts (" Verifying Checksum ... ");
Wolfgang Denk77ddac92005-10-13 16:45:02 +02001175 if (crc32 (0, (uchar *)data, len) != ntohl(hdr->ih_dcrc)) {
wdenk4b9206e2004-03-23 22:14:11 +00001176 puts (" Bad Data CRC\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001177 return 1;
1178 }
wdenk4b9206e2004-03-23 22:14:11 +00001179 puts ("OK\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001180 return 0;
1181}
wdenk0d498392003-07-01 21:06:45 +00001182
1183U_BOOT_CMD(
1184 iminfo, CFG_MAXARGS, 1, do_iminfo,
wdenk8bde7f72003-06-27 21:31:46 +00001185 "iminfo - print header information for application image\n",
1186 "addr [addr ...]\n"
1187 " - print header information for application image starting at\n"
1188 " address 'addr' in memory; this includes verification of the\n"
1189 " image contents (magic number, header and payload checksums)\n"
1190);
1191
wdenk47d1a6e2002-11-03 00:01:44 +00001192#endif /* CFG_CMD_IMI */
1193
wdenk27b207f2003-07-24 23:38:38 +00001194#if (CONFIG_COMMANDS & CFG_CMD_IMLS)
1195/*-----------------------------------------------------------------------
1196 * List all images found in flash.
1197 */
1198int do_imls (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
1199{
1200 flash_info_t *info;
1201 int i, j;
1202 image_header_t *hdr;
wdenk5bb226e2003-11-17 21:14:37 +00001203 ulong data, len, checksum;
wdenk27b207f2003-07-24 23:38:38 +00001204
1205 for (i=0, info=&flash_info[0]; i<CFG_MAX_FLASH_BANKS; ++i, ++info) {
1206 if (info->flash_id == FLASH_UNKNOWN)
1207 goto next_bank;
Marian Balakowicze6f2e902005-10-11 19:09:42 +02001208 for (j=0; j<info->sector_count; ++j) {
wdenk27b207f2003-07-24 23:38:38 +00001209
1210 if (!(hdr=(image_header_t *)info->start[j]) ||
1211 (ntohl(hdr->ih_magic) != IH_MAGIC))
1212 goto next_sector;
1213
1214 /* Copy header so we can blank CRC field for re-calculation */
1215 memmove (&header, (char *)hdr, sizeof(image_header_t));
1216
1217 checksum = ntohl(header.ih_hcrc);
1218 header.ih_hcrc = 0;
1219
Wolfgang Denk77ddac92005-10-13 16:45:02 +02001220 if (crc32 (0, (uchar *)&header, sizeof(image_header_t))
wdenk27b207f2003-07-24 23:38:38 +00001221 != checksum)
1222 goto next_sector;
1223
1224 printf ("Image at %08lX:\n", (ulong)hdr);
1225 print_image_hdr( hdr );
wdenk5bb226e2003-11-17 21:14:37 +00001226
1227 data = (ulong)hdr + sizeof(image_header_t);
1228 len = ntohl(hdr->ih_size);
1229
wdenk4b9206e2004-03-23 22:14:11 +00001230 puts (" Verifying Checksum ... ");
Wolfgang Denk77ddac92005-10-13 16:45:02 +02001231 if (crc32 (0, (uchar *)data, len) != ntohl(hdr->ih_dcrc)) {
wdenk4b9206e2004-03-23 22:14:11 +00001232 puts (" Bad Data CRC\n");
wdenk5bb226e2003-11-17 21:14:37 +00001233 }
wdenk4b9206e2004-03-23 22:14:11 +00001234 puts ("OK\n");
wdenkbdccc4f2003-08-05 17:43:17 +00001235next_sector: ;
wdenk27b207f2003-07-24 23:38:38 +00001236 }
wdenkbdccc4f2003-08-05 17:43:17 +00001237next_bank: ;
wdenk27b207f2003-07-24 23:38:38 +00001238 }
1239
1240 return (0);
1241}
1242
1243U_BOOT_CMD(
1244 imls, 1, 1, do_imls,
1245 "imls - list all images found in flash\n",
1246 "\n"
1247 " - Prints information about all images found at sector\n"
1248 " boundaries in flash.\n"
1249);
1250#endif /* CFG_CMD_IMLS */
1251
wdenk47d1a6e2002-11-03 00:01:44 +00001252void
1253print_image_hdr (image_header_t *hdr)
1254{
1255#if (CONFIG_COMMANDS & CFG_CMD_DATE) || defined(CONFIG_TIMESTAMP)
1256 time_t timestamp = (time_t)ntohl(hdr->ih_time);
1257 struct rtc_time tm;
1258#endif
1259
1260 printf (" Image Name: %.*s\n", IH_NMLEN, hdr->ih_name);
1261#if (CONFIG_COMMANDS & CFG_CMD_DATE) || defined(CONFIG_TIMESTAMP)
1262 to_tm (timestamp, &tm);
1263 printf (" Created: %4d-%02d-%02d %2d:%02d:%02d UTC\n",
1264 tm.tm_year, tm.tm_mon, tm.tm_mday,
1265 tm.tm_hour, tm.tm_min, tm.tm_sec);
1266#endif /* CFG_CMD_DATE, CONFIG_TIMESTAMP */
wdenk4b9206e2004-03-23 22:14:11 +00001267 puts (" Image Type: "); print_type(hdr);
1268 printf ("\n Data Size: %d Bytes = ", ntohl(hdr->ih_size));
wdenk47d1a6e2002-11-03 00:01:44 +00001269 print_size (ntohl(hdr->ih_size), "\n");
wdenk4b9206e2004-03-23 22:14:11 +00001270 printf (" Load Address: %08x\n"
1271 " Entry Point: %08x\n",
1272 ntohl(hdr->ih_load), ntohl(hdr->ih_ep));
wdenk47d1a6e2002-11-03 00:01:44 +00001273
1274 if (hdr->ih_type == IH_TYPE_MULTI) {
1275 int i;
1276 ulong len;
1277 ulong *len_ptr = (ulong *)((ulong)hdr + sizeof(image_header_t));
1278
wdenk4b9206e2004-03-23 22:14:11 +00001279 puts (" Contents:\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001280 for (i=0; (len = ntohl(*len_ptr)); ++i, ++len_ptr) {
1281 printf (" Image %d: %8ld Bytes = ", i, len);
1282 print_size (len, "\n");
1283 }
1284 }
1285}
1286
1287
1288static void
1289print_type (image_header_t *hdr)
1290{
1291 char *os, *arch, *type, *comp;
1292
1293 switch (hdr->ih_os) {
1294 case IH_OS_INVALID: os = "Invalid OS"; break;
1295 case IH_OS_NETBSD: os = "NetBSD"; break;
1296 case IH_OS_LINUX: os = "Linux"; break;
1297 case IH_OS_VXWORKS: os = "VxWorks"; break;
1298 case IH_OS_QNX: os = "QNX"; break;
1299 case IH_OS_U_BOOT: os = "U-Boot"; break;
wdenkd791b1d2003-04-20 14:04:18 +00001300 case IH_OS_RTEMS: os = "RTEMS"; break;
wdenk7f70e852003-05-20 14:25:27 +00001301#ifdef CONFIG_ARTOS
1302 case IH_OS_ARTOS: os = "ARTOS"; break;
1303#endif
wdenk1f4bb372003-07-27 00:21:01 +00001304#ifdef CONFIG_LYNXKDI
1305 case IH_OS_LYNXOS: os = "LynxOS"; break;
1306#endif
wdenk47d1a6e2002-11-03 00:01:44 +00001307 default: os = "Unknown OS"; break;
1308 }
1309
1310 switch (hdr->ih_arch) {
1311 case IH_CPU_INVALID: arch = "Invalid CPU"; break;
1312 case IH_CPU_ALPHA: arch = "Alpha"; break;
1313 case IH_CPU_ARM: arch = "ARM"; break;
1314 case IH_CPU_I386: arch = "Intel x86"; break;
1315 case IH_CPU_IA64: arch = "IA64"; break;
1316 case IH_CPU_MIPS: arch = "MIPS"; break;
1317 case IH_CPU_MIPS64: arch = "MIPS 64 Bit"; break;
1318 case IH_CPU_PPC: arch = "PowerPC"; break;
1319 case IH_CPU_S390: arch = "IBM S390"; break;
1320 case IH_CPU_SH: arch = "SuperH"; break;
1321 case IH_CPU_SPARC: arch = "SPARC"; break;
1322 case IH_CPU_SPARC64: arch = "SPARC 64 Bit"; break;
wdenk8564acf2003-07-14 22:13:32 +00001323 case IH_CPU_M68K: arch = "M68K"; break;
wdenk507bbe32004-04-18 21:13:41 +00001324 case IH_CPU_MICROBLAZE: arch = "Microblaze"; break;
wdenkc1a11c12005-04-03 21:11:16 +00001325 case IH_CPU_NIOS: arch = "Nios"; break;
1326 case IH_CPU_NIOS2: arch = "Nios-II"; break;
wdenk47d1a6e2002-11-03 00:01:44 +00001327 default: arch = "Unknown Architecture"; break;
1328 }
1329
1330 switch (hdr->ih_type) {
1331 case IH_TYPE_INVALID: type = "Invalid Image"; break;
1332 case IH_TYPE_STANDALONE:type = "Standalone Program"; break;
1333 case IH_TYPE_KERNEL: type = "Kernel Image"; break;
1334 case IH_TYPE_RAMDISK: type = "RAMDisk Image"; break;
1335 case IH_TYPE_MULTI: type = "Multi-File Image"; break;
1336 case IH_TYPE_FIRMWARE: type = "Firmware"; break;
1337 case IH_TYPE_SCRIPT: type = "Script"; break;
Matthew McClintock25c751e2006-08-16 10:54:09 -05001338 case IH_TYPE_FLATDT: type = "Flat Device Tree"; break;
wdenk47d1a6e2002-11-03 00:01:44 +00001339 default: type = "Unknown Image"; break;
1340 }
1341
1342 switch (hdr->ih_comp) {
1343 case IH_COMP_NONE: comp = "uncompressed"; break;
1344 case IH_COMP_GZIP: comp = "gzip compressed"; break;
1345 case IH_COMP_BZIP2: comp = "bzip2 compressed"; break;
1346 default: comp = "unknown compression"; break;
1347 }
1348
1349 printf ("%s %s %s (%s)", arch, os, type, comp);
1350}
1351
1352#define ZALLOC_ALIGNMENT 16
1353
1354static void *zalloc(void *x, unsigned items, unsigned size)
1355{
1356 void *p;
1357
1358 size *= items;
1359 size = (size + ZALLOC_ALIGNMENT - 1) & ~(ZALLOC_ALIGNMENT - 1);
1360
1361 p = malloc (size);
1362
1363 return (p);
1364}
1365
1366static void zfree(void *x, void *addr, unsigned nb)
1367{
1368 free (addr);
1369}
1370
1371#define HEAD_CRC 2
1372#define EXTRA_FIELD 4
1373#define ORIG_NAME 8
1374#define COMMENT 0x10
1375#define RESERVED 0xe0
1376
1377#define DEFLATED 8
1378
wdenkeedcd072004-09-08 22:03:11 +00001379int gunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp)
wdenk47d1a6e2002-11-03 00:01:44 +00001380{
1381 z_stream s;
1382 int r, i, flags;
1383
1384 /* skip header */
1385 i = 10;
1386 flags = src[3];
1387 if (src[2] != DEFLATED || (flags & RESERVED) != 0) {
wdenk4b9206e2004-03-23 22:14:11 +00001388 puts ("Error: Bad gzipped data\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001389 return (-1);
1390 }
1391 if ((flags & EXTRA_FIELD) != 0)
1392 i = 12 + src[10] + (src[11] << 8);
1393 if ((flags & ORIG_NAME) != 0)
1394 while (src[i++] != 0)
1395 ;
1396 if ((flags & COMMENT) != 0)
1397 while (src[i++] != 0)
1398 ;
1399 if ((flags & HEAD_CRC) != 0)
1400 i += 2;
1401 if (i >= *lenp) {
wdenk4b9206e2004-03-23 22:14:11 +00001402 puts ("Error: gunzip out of data in header\n");
wdenk47d1a6e2002-11-03 00:01:44 +00001403 return (-1);
1404 }
1405
1406 s.zalloc = zalloc;
1407 s.zfree = zfree;
1408#if defined(CONFIG_HW_WATCHDOG) || defined(CONFIG_WATCHDOG)
1409 s.outcb = (cb_func)WATCHDOG_RESET;
1410#else
1411 s.outcb = Z_NULL;
1412#endif /* CONFIG_HW_WATCHDOG */
1413
1414 r = inflateInit2(&s, -MAX_WBITS);
1415 if (r != Z_OK) {
1416 printf ("Error: inflateInit2() returned %d\n", r);
1417 return (-1);
1418 }
1419 s.next_in = src + i;
1420 s.avail_in = *lenp - i;
1421 s.next_out = dst;
1422 s.avail_out = dstlen;
1423 r = inflate(&s, Z_FINISH);
1424 if (r != Z_OK && r != Z_STREAM_END) {
1425 printf ("Error: inflate() returned %d\n", r);
1426 return (-1);
1427 }
1428 *lenp = s.next_out - (unsigned char *) dst;
1429 inflateEnd(&s);
1430
1431 return (0);
1432}
1433
wdenkc29fdfc2003-08-29 20:57:53 +00001434#ifdef CONFIG_BZIP2
1435void bz_internal_error(int errcode)
1436{
1437 printf ("BZIP2 internal error %d\n", errcode);
1438}
1439#endif /* CONFIG_BZIP2 */
1440
wdenkd791b1d2003-04-20 14:04:18 +00001441static void
1442do_bootm_rtems (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[],
1443 ulong addr, ulong *len_ptr, int verify)
1444{
wdenkd791b1d2003-04-20 14:04:18 +00001445 image_header_t *hdr = &header;
1446 void (*entry_point)(bd_t *);
1447
Wolfgang Denkdc013d42006-03-12 01:59:35 +01001448 entry_point = (void (*)(bd_t *)) ntohl(hdr->ih_ep);
wdenkd791b1d2003-04-20 14:04:18 +00001449
1450 printf ("## Transferring control to RTEMS (at address %08lx) ...\n",
1451 (ulong)entry_point);
1452
1453 SHOW_BOOT_PROGRESS (15);
1454
1455 /*
1456 * RTEMS Parameters:
1457 * r3: ptr to board info data
1458 */
1459
1460 (*entry_point ) ( gd->bd );
1461}
1462
wdenk47d1a6e2002-11-03 00:01:44 +00001463#if (CONFIG_COMMANDS & CFG_CMD_ELF)
1464static void
1465do_bootm_vxworks (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[],
1466 ulong addr, ulong *len_ptr, int verify)
1467{
1468 image_header_t *hdr = &header;
1469 char str[80];
1470
Wolfgang Denkdc013d42006-03-12 01:59:35 +01001471 sprintf(str, "%x", ntohl(hdr->ih_ep)); /* write entry-point into string */
wdenk47d1a6e2002-11-03 00:01:44 +00001472 setenv("loadaddr", str);
1473 do_bootvx(cmdtp, 0, 0, NULL);
1474}
1475
1476static void
1477do_bootm_qnxelf (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[],
1478 ulong addr, ulong *len_ptr, int verify)
1479{
1480 image_header_t *hdr = &header;
1481 char *local_args[2];
1482 char str[16];
1483
Wolfgang Denkdc013d42006-03-12 01:59:35 +01001484 sprintf(str, "%x", ntohl(hdr->ih_ep)); /* write entry-point into string */
wdenk47d1a6e2002-11-03 00:01:44 +00001485 local_args[0] = argv[0];
1486 local_args[1] = str; /* and provide it via the arguments */
1487 do_bootelf(cmdtp, 0, 2, local_args);
1488}
1489#endif /* CFG_CMD_ELF */
wdenk1f4bb372003-07-27 00:21:01 +00001490
1491#ifdef CONFIG_LYNXKDI
1492static void
1493do_bootm_lynxkdi (cmd_tbl_t *cmdtp, int flag,
1494 int argc, char *argv[],
1495 ulong addr,
1496 ulong *len_ptr,
1497 int verify)
1498{
1499 lynxkdi_boot( &header );
1500}
1501
1502#endif /* CONFIG_LYNXKDI */