]> git.sur5r.net Git - u-boot/blob - arch/arm/lib/board.c
arm: Add CONFIG_DELAY_ENVIRONMENT to delay environment loading
[u-boot] / arch / arm / lib / board.c
1 /*
2  * (C) Copyright 2002-2006
3  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4  *
5  * (C) Copyright 2002
6  * Sysgo Real-Time Solutions, GmbH <www.elinos.com>
7  * Marius Groeger <mgroeger@sysgo.de>
8  *
9  * See file CREDITS for list of people who contributed to this
10  * project.
11  *
12  * This program is free software; you can redistribute it and/or
13  * modify it under the terms of the GNU General Public License as
14  * published by the Free Software Foundation; either version 2 of
15  * the License, or (at your option) any later version.
16  *
17  * This program is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20  * GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
25  * MA 02111-1307 USA
26  */
27
28 /*
29  * To match the U-Boot user interface on ARM platforms to the U-Boot
30  * standard (as on PPC platforms), some messages with debug character
31  * are removed from the default U-Boot build.
32  *
33  * Define DEBUG here if you want additional info as shown below
34  * printed upon startup:
35  *
36  * U-Boot code: 00F00000 -> 00F3C774  BSS: -> 00FC3274
37  * IRQ Stack: 00ebff7c
38  * FIQ Stack: 00ebef7c
39  */
40
41 #include <common.h>
42 #include <command.h>
43 #include <environment.h>
44 #include <malloc.h>
45 #include <stdio_dev.h>
46 #include <version.h>
47 #include <net.h>
48 #include <serial.h>
49 #include <nand.h>
50 #include <onenand_uboot.h>
51 #include <mmc.h>
52 #include <libfdt.h>
53 #include <fdtdec.h>
54 #include <post.h>
55 #include <logbuff.h>
56
57 #ifdef CONFIG_BITBANGMII
58 #include <miiphy.h>
59 #endif
60
61 DECLARE_GLOBAL_DATA_PTR;
62
63 ulong monitor_flash_len;
64
65 #ifdef CONFIG_HAS_DATAFLASH
66 extern int  AT91F_DataflashInit(void);
67 extern void dataflash_print_info(void);
68 #endif
69
70 #if defined(CONFIG_HARD_I2C) || \
71     defined(CONFIG_SOFT_I2C)
72 #include <i2c.h>
73 #endif
74
75 /************************************************************************
76  * Coloured LED functionality
77  ************************************************************************
78  * May be supplied by boards if desired
79  */
80 inline void __coloured_LED_init(void) {}
81 void coloured_LED_init(void)
82         __attribute__((weak, alias("__coloured_LED_init")));
83 inline void __red_led_on(void) {}
84 void red_led_on(void) __attribute__((weak, alias("__red_led_on")));
85 inline void __red_led_off(void) {}
86 void red_led_off(void) __attribute__((weak, alias("__red_led_off")));
87 inline void __green_led_on(void) {}
88 void green_led_on(void) __attribute__((weak, alias("__green_led_on")));
89 inline void __green_led_off(void) {}
90 void green_led_off(void) __attribute__((weak, alias("__green_led_off")));
91 inline void __yellow_led_on(void) {}
92 void yellow_led_on(void) __attribute__((weak, alias("__yellow_led_on")));
93 inline void __yellow_led_off(void) {}
94 void yellow_led_off(void) __attribute__((weak, alias("__yellow_led_off")));
95 inline void __blue_led_on(void) {}
96 void blue_led_on(void) __attribute__((weak, alias("__blue_led_on")));
97 inline void __blue_led_off(void) {}
98 void blue_led_off(void) __attribute__((weak, alias("__blue_led_off")));
99
100 /*
101  ************************************************************************
102  * Init Utilities                                                       *
103  ************************************************************************
104  * Some of this code should be moved into the core functions,
105  * or dropped completely,
106  * but let's get it working (again) first...
107  */
108
109 #if defined(CONFIG_ARM_DCC) && !defined(CONFIG_BAUDRATE)
110 #define CONFIG_BAUDRATE 115200
111 #endif
112
113 static int init_baudrate(void)
114 {
115         gd->baudrate = getenv_ulong("baudrate", 10, CONFIG_BAUDRATE);
116         return 0;
117 }
118
119 static int display_banner(void)
120 {
121         printf("\n\n%s\n\n", version_string);
122         debug("U-Boot code: %08lX -> %08lX  BSS: -> %08lX\n",
123                _TEXT_BASE,
124                _bss_start_ofs + _TEXT_BASE, _bss_end_ofs + _TEXT_BASE);
125 #ifdef CONFIG_MODEM_SUPPORT
126         debug("Modem Support enabled\n");
127 #endif
128 #ifdef CONFIG_USE_IRQ
129         debug("IRQ Stack: %08lx\n", IRQ_STACK_START);
130         debug("FIQ Stack: %08lx\n", FIQ_STACK_START);
131 #endif
132
133         return (0);
134 }
135
136 /*
137  * WARNING: this code looks "cleaner" than the PowerPC version, but
138  * has the disadvantage that you either get nothing, or everything.
139  * On PowerPC, you might see "DRAM: " before the system hangs - which
140  * gives a simple yet clear indication which part of the
141  * initialization if failing.
142  */
143 static int display_dram_config(void)
144 {
145         int i;
146
147 #ifdef DEBUG
148         puts("RAM Configuration:\n");
149
150         for (i = 0; i < CONFIG_NR_DRAM_BANKS; i++) {
151                 printf("Bank #%d: %08lx ", i, gd->bd->bi_dram[i].start);
152                 print_size(gd->bd->bi_dram[i].size, "\n");
153         }
154 #else
155         ulong size = 0;
156
157         for (i = 0; i < CONFIG_NR_DRAM_BANKS; i++)
158                 size += gd->bd->bi_dram[i].size;
159
160         puts("DRAM:  ");
161         print_size(size, "\n");
162 #endif
163
164         return (0);
165 }
166
167 #if defined(CONFIG_HARD_I2C) || defined(CONFIG_SOFT_I2C)
168 static int init_func_i2c(void)
169 {
170         puts("I2C:   ");
171         i2c_init(CONFIG_SYS_I2C_SPEED, CONFIG_SYS_I2C_SLAVE);
172         puts("ready\n");
173         return (0);
174 }
175 #endif
176
177 #if defined(CONFIG_CMD_PCI) || defined (CONFIG_PCI)
178 #include <pci.h>
179 static int arm_pci_init(void)
180 {
181         pci_init();
182         return 0;
183 }
184 #endif /* CONFIG_CMD_PCI || CONFIG_PCI */
185
186 /*
187  * Breathe some life into the board...
188  *
189  * Initialize a serial port as console, and carry out some hardware
190  * tests.
191  *
192  * The first part of initialization is running from Flash memory;
193  * its main purpose is to initialize the RAM so that we
194  * can relocate the monitor code to RAM.
195  */
196
197 /*
198  * All attempts to come up with a "common" initialization sequence
199  * that works for all boards and architectures failed: some of the
200  * requirements are just _too_ different. To get rid of the resulting
201  * mess of board dependent #ifdef'ed code we now make the whole
202  * initialization sequence configurable to the user.
203  *
204  * The requirements for any new initalization function is simple: it
205  * receives a pointer to the "global data" structure as it's only
206  * argument, and returns an integer return code, where 0 means
207  * "continue" and != 0 means "fatal error, hang the system".
208  */
209 typedef int (init_fnc_t) (void);
210
211 int print_cpuinfo(void);
212
213 void __dram_init_banksize(void)
214 {
215         gd->bd->bi_dram[0].start = CONFIG_SYS_SDRAM_BASE;
216         gd->bd->bi_dram[0].size =  gd->ram_size;
217 }
218 void dram_init_banksize(void)
219         __attribute__((weak, alias("__dram_init_banksize")));
220
221 int __arch_cpu_init(void)
222 {
223         return 0;
224 }
225 int arch_cpu_init(void)
226         __attribute__((weak, alias("__arch_cpu_init")));
227
228 int __power_init_board(void)
229 {
230         return 0;
231 }
232 int power_init_board(void)
233         __attribute__((weak, alias("__power_init_board")));
234
235 init_fnc_t *init_sequence[] = {
236         arch_cpu_init,          /* basic arch cpu dependent setup */
237 #ifdef CONFIG_OF_CONTROL
238         fdtdec_check_fdt,
239 #endif
240 #if defined(CONFIG_BOARD_EARLY_INIT_F)
241         board_early_init_f,
242 #endif
243         timer_init,             /* initialize timer */
244 #ifdef CONFIG_BOARD_POSTCLK_INIT
245         board_postclk_init,
246 #endif
247 #ifdef CONFIG_FSL_ESDHC
248         get_clocks,
249 #endif
250         env_init,               /* initialize environment */
251         init_baudrate,          /* initialze baudrate settings */
252         serial_init,            /* serial communications setup */
253         console_init_f,         /* stage 1 init of console */
254         display_banner,         /* say that we are here */
255 #if defined(CONFIG_DISPLAY_CPUINFO)
256         print_cpuinfo,          /* display cpu info (and speed) */
257 #endif
258 #if defined(CONFIG_DISPLAY_BOARDINFO)
259         checkboard,             /* display board info */
260 #endif
261 #if defined(CONFIG_HARD_I2C) || defined(CONFIG_SOFT_I2C)
262         init_func_i2c,
263 #endif
264         dram_init,              /* configure available RAM banks */
265         NULL,
266 };
267
268 void board_init_f(ulong bootflag)
269 {
270         bd_t *bd;
271         init_fnc_t **init_fnc_ptr;
272         gd_t *id;
273         ulong addr, addr_sp;
274 #ifdef CONFIG_PRAM
275         ulong reg;
276 #endif
277         void *new_fdt = NULL;
278         size_t fdt_size = 0;
279
280         bootstage_mark_name(BOOTSTAGE_ID_START_UBOOT_F, "board_init_f");
281
282         memset((void *)gd, 0, sizeof(gd_t));
283
284         gd->mon_len = _bss_end_ofs;
285 #ifdef CONFIG_OF_EMBED
286         /* Get a pointer to the FDT */
287         gd->fdt_blob = _binary_dt_dtb_start;
288 #elif defined CONFIG_OF_SEPARATE
289         /* FDT is at end of image */
290         gd->fdt_blob = (void *)(_end_ofs + _TEXT_BASE);
291 #endif
292         /* Allow the early environment to override the fdt address */
293         gd->fdt_blob = (void *)getenv_ulong("fdtcontroladdr", 16,
294                                                 (uintptr_t)gd->fdt_blob);
295
296         for (init_fnc_ptr = init_sequence; *init_fnc_ptr; ++init_fnc_ptr) {
297                 if ((*init_fnc_ptr)() != 0) {
298                         hang ();
299                 }
300         }
301
302 #ifdef CONFIG_OF_CONTROL
303         /* For now, put this check after the console is ready */
304         if (fdtdec_prepare_fdt()) {
305                 panic("** CONFIG_OF_CONTROL defined but no FDT - please see "
306                         "doc/README.fdt-control");
307         }
308 #endif
309
310         debug("monitor len: %08lX\n", gd->mon_len);
311         /*
312          * Ram is setup, size stored in gd !!
313          */
314         debug("ramsize: %08lX\n", gd->ram_size);
315 #if defined(CONFIG_SYS_MEM_TOP_HIDE)
316         /*
317          * Subtract specified amount of memory to hide so that it won't
318          * get "touched" at all by U-Boot. By fixing up gd->ram_size
319          * the Linux kernel should now get passed the now "corrected"
320          * memory size and won't touch it either. This should work
321          * for arch/ppc and arch/powerpc. Only Linux board ports in
322          * arch/powerpc with bootwrapper support, that recalculate the
323          * memory size from the SDRAM controller setup will have to
324          * get fixed.
325          */
326         gd->ram_size -= CONFIG_SYS_MEM_TOP_HIDE;
327 #endif
328
329         addr = CONFIG_SYS_SDRAM_BASE + gd->ram_size;
330
331 #ifdef CONFIG_LOGBUFFER
332 #ifndef CONFIG_ALT_LB_ADDR
333         /* reserve kernel log buffer */
334         addr -= (LOGBUFF_RESERVE);
335         debug("Reserving %dk for kernel logbuffer at %08lx\n", LOGBUFF_LEN,
336                 addr);
337 #endif
338 #endif
339
340 #ifdef CONFIG_PRAM
341         /*
342          * reserve protected RAM
343          */
344         reg = getenv_ulong("pram", 10, CONFIG_PRAM);
345         addr -= (reg << 10);            /* size is in kB */
346         debug("Reserving %ldk for protected RAM at %08lx\n", reg, addr);
347 #endif /* CONFIG_PRAM */
348
349 #if !(defined(CONFIG_SYS_ICACHE_OFF) && defined(CONFIG_SYS_DCACHE_OFF))
350         /* reserve TLB table */
351         gd->tlb_size = 4096 * 4;
352         addr -= gd->tlb_size;
353
354         /* round down to next 64 kB limit */
355         addr &= ~(0x10000 - 1);
356
357         gd->tlb_addr = addr;
358         debug("TLB table from %08lx to %08lx\n", addr, addr + gd->tlb_size);
359 #endif
360
361         /* round down to next 4 kB limit */
362         addr &= ~(4096 - 1);
363         debug("Top of RAM usable for U-Boot at: %08lx\n", addr);
364
365 #ifdef CONFIG_LCD
366 #ifdef CONFIG_FB_ADDR
367         gd->fb_base = CONFIG_FB_ADDR;
368 #else
369         /* reserve memory for LCD display (always full pages) */
370         addr = lcd_setmem(addr);
371         gd->fb_base = addr;
372 #endif /* CONFIG_FB_ADDR */
373 #endif /* CONFIG_LCD */
374
375         /*
376          * reserve memory for U-Boot code, data & bss
377          * round down to next 4 kB limit
378          */
379         addr -= gd->mon_len;
380         addr &= ~(4096 - 1);
381
382         debug("Reserving %ldk for U-Boot at: %08lx\n", gd->mon_len >> 10, addr);
383
384 #ifndef CONFIG_SPL_BUILD
385         /*
386          * reserve memory for malloc() arena
387          */
388         addr_sp = addr - TOTAL_MALLOC_LEN;
389         debug("Reserving %dk for malloc() at: %08lx\n",
390                         TOTAL_MALLOC_LEN >> 10, addr_sp);
391         /*
392          * (permanently) allocate a Board Info struct
393          * and a permanent copy of the "global" data
394          */
395         addr_sp -= sizeof (bd_t);
396         bd = (bd_t *) addr_sp;
397         gd->bd = bd;
398         debug("Reserving %zu Bytes for Board Info at: %08lx\n",
399                         sizeof (bd_t), addr_sp);
400
401 #ifdef CONFIG_MACH_TYPE
402         gd->bd->bi_arch_number = CONFIG_MACH_TYPE; /* board id for Linux */
403 #endif
404
405         addr_sp -= sizeof (gd_t);
406         id = (gd_t *) addr_sp;
407         debug("Reserving %zu Bytes for Global Data at: %08lx\n",
408                         sizeof (gd_t), addr_sp);
409
410 #if defined(CONFIG_OF_SEPARATE) && defined(CONFIG_OF_CONTROL)
411         /*
412          * If the device tree is sitting immediate above our image then we
413          * must relocate it. If it is embedded in the data section, then it
414          * will be relocated with other data.
415          */
416         if (gd->fdt_blob) {
417                 fdt_size = ALIGN(fdt_totalsize(gd->fdt_blob) + 0x1000, 32);
418
419                 addr_sp -= fdt_size;
420                 new_fdt = (void *)addr_sp;
421                 debug("Reserving %zu Bytes for FDT at: %08lx\n",
422                       fdt_size, addr_sp);
423         }
424 #endif
425
426         /* setup stackpointer for exeptions */
427         gd->irq_sp = addr_sp;
428 #ifdef CONFIG_USE_IRQ
429         addr_sp -= (CONFIG_STACKSIZE_IRQ+CONFIG_STACKSIZE_FIQ);
430         debug("Reserving %zu Bytes for IRQ stack at: %08lx\n",
431                 CONFIG_STACKSIZE_IRQ+CONFIG_STACKSIZE_FIQ, addr_sp);
432 #endif
433         /* leave 3 words for abort-stack    */
434         addr_sp -= 12;
435
436         /* 8-byte alignment for ABI compliance */
437         addr_sp &= ~0x07;
438 #else
439         addr_sp += 128; /* leave 32 words for abort-stack   */
440         gd->irq_sp = addr_sp;
441 #endif
442
443         debug("New Stack Pointer is: %08lx\n", addr_sp);
444
445 #ifdef CONFIG_POST
446         post_bootmode_init();
447         post_run(NULL, POST_ROM | post_bootmode_get(0));
448 #endif
449
450         gd->bd->bi_baudrate = gd->baudrate;
451         /* Ram ist board specific, so move it to board code ... */
452         dram_init_banksize();
453         display_dram_config();  /* and display it */
454
455         gd->relocaddr = addr;
456         gd->start_addr_sp = addr_sp;
457         gd->reloc_off = addr - _TEXT_BASE;
458         debug("relocation Offset is: %08lx\n", gd->reloc_off);
459         if (new_fdt) {
460                 memcpy(new_fdt, gd->fdt_blob, fdt_size);
461                 gd->fdt_blob = new_fdt;
462         }
463         memcpy(id, (void *)gd, sizeof(gd_t));
464 }
465
466 #if !defined(CONFIG_SYS_NO_FLASH)
467 static char *failed = "*** failed ***\n";
468 #endif
469
470 /*
471  * Tell if it's OK to load the environment early in boot.
472  *
473  * If CONFIG_OF_CONFIG is defined, we'll check with the FDT to see
474  * if this is OK (defaulting to saying it's not OK).
475  *
476  * NOTE: Loading the environment early can be a bad idea if security is
477  *       important, since no verification is done on the environment.
478  *
479  * @return 0 if environment should not be loaded, !=0 if it is ok to load
480  */
481 static int should_load_env(void)
482 {
483 #ifdef CONFIG_OF_CONTROL
484         return fdtdec_get_config_int(gd->fdt_blob, "load-environment", 0);
485 #elif defined CONFIG_DELAY_ENVIRONMENT
486         return 0;
487 #else
488         return 1;
489 #endif
490 }
491
492 /************************************************************************
493  *
494  * This is the next part if the initialization sequence: we are now
495  * running from RAM and have a "normal" C environment, i. e. global
496  * data can be written, BSS has been cleared, the stack size in not
497  * that critical any more, etc.
498  *
499  ************************************************************************
500  */
501
502 void board_init_r(gd_t *id, ulong dest_addr)
503 {
504         ulong malloc_start;
505 #if !defined(CONFIG_SYS_NO_FLASH)
506         ulong flash_size;
507 #endif
508
509         gd->flags |= GD_FLG_RELOC;      /* tell others: relocation done */
510         bootstage_mark_name(BOOTSTAGE_ID_START_UBOOT_R, "board_init_r");
511
512         monitor_flash_len = _end_ofs;
513
514         /* Enable caches */
515         enable_caches();
516
517         debug("monitor flash len: %08lX\n", monitor_flash_len);
518         board_init();   /* Setup chipselects */
519         /*
520          * TODO: printing of the clock inforamtion of the board is now
521          * implemented as part of bdinfo command. Currently only support for
522          * davinci SOC's is added. Remove this check once all the board
523          * implement this.
524          */
525 #ifdef CONFIG_CLOCKS
526         set_cpu_clk_info(); /* Setup clock information */
527 #endif
528         serial_initialize();
529
530         debug("Now running in RAM - U-Boot at: %08lx\n", dest_addr);
531
532 #ifdef CONFIG_LOGBUFFER
533         logbuff_init_ptrs();
534 #endif
535 #ifdef CONFIG_POST
536         post_output_backlog();
537 #endif
538
539         /* The Malloc area is immediately below the monitor copy in DRAM */
540         malloc_start = dest_addr - TOTAL_MALLOC_LEN;
541         mem_malloc_init (malloc_start, TOTAL_MALLOC_LEN);
542
543 #ifdef CONFIG_ARCH_EARLY_INIT_R
544         arch_early_init_r();
545 #endif
546         power_init_board();
547
548 #if !defined(CONFIG_SYS_NO_FLASH)
549         puts("Flash: ");
550
551         flash_size = flash_init();
552         if (flash_size > 0) {
553 # ifdef CONFIG_SYS_FLASH_CHECKSUM
554                 print_size(flash_size, "");
555                 /*
556                  * Compute and print flash CRC if flashchecksum is set to 'y'
557                  *
558                  * NOTE: Maybe we should add some WATCHDOG_RESET()? XXX
559                  */
560                 if (getenv_yesno("flashchecksum") == 1) {
561                         printf("  CRC: %08X", crc32(0,
562                                 (const unsigned char *) CONFIG_SYS_FLASH_BASE,
563                                 flash_size));
564                 }
565                 putc('\n');
566 # else  /* !CONFIG_SYS_FLASH_CHECKSUM */
567                 print_size(flash_size, "\n");
568 # endif /* CONFIG_SYS_FLASH_CHECKSUM */
569         } else {
570                 puts(failed);
571                 hang();
572         }
573 #endif
574
575 #if defined(CONFIG_CMD_NAND)
576         puts("NAND:  ");
577         nand_init();            /* go init the NAND */
578 #endif
579
580 #if defined(CONFIG_CMD_ONENAND)
581         onenand_init();
582 #endif
583
584 #ifdef CONFIG_GENERIC_MMC
585        puts("MMC:   ");
586        mmc_initialize(gd->bd);
587 #endif
588
589 #ifdef CONFIG_HAS_DATAFLASH
590         AT91F_DataflashInit();
591         dataflash_print_info();
592 #endif
593
594         /* initialize environment */
595         if (should_load_env())
596                 env_relocate();
597         else
598                 set_default_env(NULL);
599
600 #if defined(CONFIG_CMD_PCI) || defined(CONFIG_PCI)
601         arm_pci_init();
602 #endif
603
604         stdio_init();   /* get the devices list going. */
605
606         jumptable_init();
607
608 #if defined(CONFIG_API)
609         /* Initialize API */
610         api_init();
611 #endif
612
613         console_init_r();       /* fully init console as a device */
614
615 #if defined(CONFIG_ARCH_MISC_INIT)
616         /* miscellaneous arch dependent initialisations */
617         arch_misc_init();
618 #endif
619 #if defined(CONFIG_MISC_INIT_R)
620         /* miscellaneous platform dependent initialisations */
621         misc_init_r();
622 #endif
623
624          /* set up exceptions */
625         interrupt_init();
626         /* enable exceptions */
627         enable_interrupts();
628
629         /* Initialize from environment */
630         load_addr = getenv_ulong("loadaddr", 16, load_addr);
631
632 #ifdef CONFIG_BOARD_LATE_INIT
633         board_late_init();
634 #endif
635
636 #ifdef CONFIG_BITBANGMII
637         bb_miiphy_init();
638 #endif
639 #if defined(CONFIG_CMD_NET)
640         puts("Net:   ");
641         eth_initialize(gd->bd);
642 #if defined(CONFIG_RESET_PHY_R)
643         debug("Reset Ethernet PHY\n");
644         reset_phy();
645 #endif
646 #endif
647
648 #ifdef CONFIG_POST
649         post_run(NULL, POST_RAM | post_bootmode_get(0));
650 #endif
651
652 #if defined(CONFIG_PRAM) || defined(CONFIG_LOGBUFFER)
653         /*
654          * Export available size of memory for Linux,
655          * taking into account the protected RAM at top of memory
656          */
657         {
658                 ulong pram = 0;
659                 uchar memsz[32];
660
661 #ifdef CONFIG_PRAM
662                 pram = getenv_ulong("pram", 10, CONFIG_PRAM);
663 #endif
664 #ifdef CONFIG_LOGBUFFER
665 #ifndef CONFIG_ALT_LB_ADDR
666                 /* Also take the logbuffer into account (pram is in kB) */
667                 pram += (LOGBUFF_LEN + LOGBUFF_OVERHEAD) / 1024;
668 #endif
669 #endif
670                 sprintf((char *)memsz, "%ldk", (gd->ram_size / 1024) - pram);
671                 setenv("mem", (char *)memsz);
672         }
673 #endif
674
675         /* main_loop() can return to retry autoboot, if so just run it again. */
676         for (;;) {
677                 main_loop();
678         }
679
680         /* NOTREACHED - no way out of command loop except booting */
681 }
682
683 void hang(void)
684 {
685         puts("### ERROR ### Please RESET the board ###\n");
686         for (;;);
687 }