Revert "global: Remove CONFIG_SYS_EXTRA_OPTIONS support"
[platform/kernel/u-boot.git] / boot / Kconfig
1 menu "Boot options"
2
3 menu "Boot images"
4
5 config ANDROID_BOOT_IMAGE
6         bool "Enable support for Android Boot Images"
7         default y if FASTBOOT
8         help
9           This enables support for booting images which use the Android
10           image format header.
11
12 config FIT
13         bool "Support Flattened Image Tree"
14         select HASH
15         select MD5
16         select SHA1
17         imply SHA256
18         help
19           This option allows you to boot the new uImage structure,
20           Flattened Image Tree.  FIT is formally a FDT, which can include
21           images of various types (kernel, FDT blob, ramdisk, etc.)
22           in a single blob.  To boot this new uImage structure,
23           pass the address of the blob to the "bootm" command.
24           FIT is very flexible, supporting compression, multiple images,
25           multiple configurations, verification through hashing and also
26           verified boot (secure boot using RSA).
27
28 config TIMESTAMP
29         bool "Show image date and time when displaying image information"
30         default y if CMD_DATE
31         help
32           When CONFIG_TIMESTAMP is selected, the timestamp (date and time) of
33           an image is printed by image commands like bootm or iminfo. This
34           is shown as 'Timestamp: xxx' and 'Created: xxx'. If this option is
35           enabled, then U-Boot requires FITs to have a timestamp. If a FIT is
36           loaded that does not, the message 'Wrong FIT format: no timestamp'
37           is shown.
38
39 if FIT
40
41 config FIT_EXTERNAL_OFFSET
42         hex "FIT external data offset"
43         default 0x0
44         help
45           This specifies a data offset in fit image.
46           The offset is from data payload offset to the beginning of
47           fit image header. When specifies a offset, specific data
48           could be put in the hole between data payload and fit image
49           header, such as CSF data on i.MX platform.
50
51 config FIT_FULL_CHECK
52         bool "Do a full check of the FIT before using it"
53         default y
54         help
55           Enable this do a full check of the FIT to make sure it is valid. This
56           helps to protect against carefully crafted FITs which take advantage
57           of bugs or omissions in the code. This includes a bad structure,
58           multiple root nodes and the like.
59
60 config FIT_SIGNATURE
61         bool "Enable signature verification of FIT uImages"
62         depends on DM
63         select HASH
64         imply RSA
65         imply RSA_VERIFY
66         select IMAGE_SIGN_INFO
67         select FIT_FULL_CHECK
68         help
69           This option enables signature verification of FIT uImages,
70           using a hash signed and verified using RSA. If
71           CONFIG_SHA_PROG_HW_ACCEL is defined, i.e support for progressive
72           hashing is available using hardware, then the RSA library will use
73           it. See doc/uImage.FIT/signature.txt for more details.
74
75           WARNING: When relying on signed FIT images with a required signature
76           check the legacy image format is disabled by default, so that
77           unsigned images cannot be loaded. If a board needs the legacy image
78           format support in this case, enable it using
79           CONFIG_LEGACY_IMAGE_FORMAT.
80
81 config FIT_SIGNATURE_MAX_SIZE
82         hex "Max size of signed FIT structures"
83         depends on FIT_SIGNATURE
84         default 0x10000000
85         help
86           This option sets a max size in bytes for verified FIT uImages.
87           A sane value of 256MB protects corrupted DTB structures from overlapping
88           device memory. Assure this size does not extend past expected storage
89           space.
90
91 config FIT_RSASSA_PSS
92         bool "Support rsassa-pss signature scheme of FIT image contents"
93         depends on FIT_SIGNATURE
94         help
95           Enable this to support the pss padding algorithm as described
96           in the rfc8017 (https://tools.ietf.org/html/rfc8017).
97
98 config FIT_CIPHER
99         bool "Enable ciphering data in a FIT uImages"
100         depends on DM
101         select AES
102         help
103           Enable the feature of data ciphering/unciphering in the tool mkimage
104           and in the u-boot support of the FIT image.
105
106 config FIT_VERBOSE
107         bool "Show verbose messages when FIT images fail"
108         help
109           Generally a system will have valid FIT images so debug messages
110           are a waste of code space. If you are debugging your images then
111           you can enable this option to get more verbose information about
112           failures.
113
114 config FIT_BEST_MATCH
115         bool "Select the best match for the kernel device tree"
116         help
117           When no configuration is explicitly selected, default to the
118           one whose fdt's compatibility field best matches that of
119           U-Boot itself. A match is considered "best" if it matches the
120           most specific compatibility entry of U-Boot's fdt's root node.
121           The order of entries in the configuration's fdt is ignored.
122
123 config FIT_IMAGE_POST_PROCESS
124         bool "Enable post-processing of FIT artifacts after loading by U-Boot"
125         depends on TI_SECURE_DEVICE || SOCFPGA_SECURE_VAB_AUTH
126         help
127           Allows doing any sort of manipulation to blobs after they got extracted
128           from FIT images like stripping off headers or modifying the size of the
129           blob, verification, authentication, decryption etc. in a platform or
130           board specific way. In order to use this feature a platform or board-
131           specific implementation of board_fit_image_post_process() must be
132           provided. Also, anything done during this post-processing step would
133           need to be comprehended in how the images were prepared before being
134           injected into the FIT creation (i.e. the blobs would have been pre-
135           processed before being added to the FIT image).
136
137 config FIT_PRINT
138         bool "Support FIT printing"
139         default y
140         help
141           Support printing the content of the fitImage in a verbose manner.
142
143 if SPL
144
145 config SPL_FIT
146         bool "Support Flattened Image Tree within SPL"
147         depends on SPL
148         select SPL_HASH
149         select SPL_OF_LIBFDT
150
151 config SPL_FIT_PRINT
152         bool "Support FIT printing within SPL"
153         depends on SPL_FIT
154         help
155           Support printing the content of the fitImage in a verbose manner in SPL.
156
157 config SPL_FIT_FULL_CHECK
158         bool "Do a full check of the FIT before using it"
159         help
160           Enable this do a full check of the FIT to make sure it is valid. This
161           helps to protect against carefully crafted FITs which take advantage
162           of bugs or omissions in the code. This includes a bad structure,
163           multiple root nodes and the like.
164
165
166 config SPL_FIT_SIGNATURE
167         bool "Enable signature verification of FIT firmware within SPL"
168         depends on SPL_DM
169         depends on SPL_LOAD_FIT || SPL_LOAD_FIT_FULL
170         select FIT_SIGNATURE
171         select SPL_FIT
172         select SPL_CRYPTO
173         select SPL_HASH
174         imply SPL_RSA
175         imply SPL_RSA_VERIFY
176         select SPL_IMAGE_SIGN_INFO
177         select SPL_FIT_FULL_CHECK
178
179 config SPL_FIT_SIGNATURE_MAX_SIZE
180         hex "Max size of signed FIT structures in SPL"
181         depends on SPL_FIT_SIGNATURE
182         default 0x10000000
183         help
184           This option sets a max size in bytes for verified FIT uImages.
185           A sane value of 256MB protects corrupted DTB structures from overlapping
186           device memory. Assure this size does not extend past expected storage
187           space.
188
189 config SPL_FIT_RSASSA_PSS
190         bool "Support rsassa-pss signature scheme of FIT image contents in SPL"
191         depends on SPL_FIT_SIGNATURE
192         help
193           Enable this to support the pss padding algorithm as described
194           in the rfc8017 (https://tools.ietf.org/html/rfc8017) in SPL.
195
196 config SPL_LOAD_FIT
197         bool "Enable SPL loading U-Boot as a FIT (basic fitImage features)"
198         select SPL_FIT
199         help
200           Normally with the SPL framework a legacy image is generated as part
201           of the build. This contains U-Boot along with information as to
202           where it should be loaded. This option instead enables generation
203           of a FIT (Flat Image Tree) which provides more flexibility. In
204           particular it can handle selecting from multiple device tree
205           and passing the correct one to U-Boot.
206
207           This path has the following limitations:
208
209           1. "loadables" images, other than FDTs, which do not have a "load"
210              property will not be loaded. This limitation also applies to FPGA
211              images with the correct "compatible" string.
212           2. For FPGA images, only the "compatible" = "u-boot,fpga-legacy"
213              loading method is supported.
214           3. FDTs are only loaded for images with an "os" property of "u-boot".
215              "linux" images are also supported with Falcon boot mode.
216
217 config SPL_LOAD_FIT_ADDRESS
218         hex "load address of fit image"
219         depends on SPL_LOAD_FIT
220         default 0x0
221         help
222           Specify the load address of the fit image that will be loaded
223           by SPL.
224
225 config SPL_LOAD_FIT_APPLY_OVERLAY
226         bool "Enable SPL applying DT overlays from FIT"
227         depends on SPL_LOAD_FIT
228         select OF_LIBFDT_OVERLAY
229         help
230           The device tree is loaded from the FIT image. Allow the SPL is to
231           also load device-tree overlays from the FIT image an apply them
232           over the device tree.
233
234 config SPL_LOAD_FIT_APPLY_OVERLAY_BUF_SZ
235         depends on SPL_LOAD_FIT_APPLY_OVERLAY
236         default 0x10000
237         hex "size of temporary buffer used to load the overlays"
238         help
239           The size of the area where the overlays will be loaded and
240           uncompress. Must be at least as large as biggest overlay
241           (uncompressed)
242
243 config SPL_LOAD_FIT_FULL
244         bool "Enable SPL loading U-Boot as a FIT (full fitImage features)"
245         select SPL_FIT
246         help
247           Normally with the SPL framework a legacy image is generated as part
248           of the build. This contains U-Boot along with information as to
249           where it should be loaded. This option instead enables generation
250           of a FIT (Flat Image Tree) which provides more flexibility. In
251           particular it can handle selecting from multiple device tree
252           and passing the correct one to U-Boot.
253
254 config SPL_FIT_IMAGE_POST_PROCESS
255         bool "Enable post-processing of FIT artifacts after loading by the SPL"
256         depends on SPL_LOAD_FIT
257         help
258           Allows doing any sort of manipulation to blobs after they got extracted
259           from the U-Boot FIT image like stripping off headers or modifying the
260           size of the blob, verification, authentication, decryption etc. in a
261           platform or board specific way. In order to use this feature a platform
262           or board-specific implementation of board_fit_image_post_process() must
263           be provided. Also, anything done during this post-processing step would
264           need to be comprehended in how the images were prepared before being
265           injected into the FIT creation (i.e. the blobs would have been pre-
266           processed before being added to the FIT image).
267
268 config SPL_FIT_SOURCE
269         string ".its source file for U-Boot FIT image"
270         depends on SPL_FIT
271         help
272           Specifies a (platform specific) FIT source file to generate the
273           U-Boot FIT image. This could specify further image to load and/or
274           execute.
275
276 config USE_SPL_FIT_GENERATOR
277         bool "Use a script to generate the .its script"
278         default y if SPL_FIT && (!ARCH_SUNXI && !RISCV)
279
280 config SPL_FIT_GENERATOR
281         string ".its file generator script for U-Boot FIT image"
282         depends on USE_SPL_FIT_GENERATOR
283         default "arch/arm/mach-rockchip/make_fit_atf.py" if SPL_LOAD_FIT && ARCH_ROCKCHIP
284         default "arch/arm/mach-zynqmp/mkimage_fit_atf.sh" if SPL_LOAD_FIT && ARCH_ZYNQMP
285         help
286           Specifies a (platform specific) script file to generate the FIT
287           source file used to build the U-Boot FIT image file. This gets
288           passed a list of supported device tree file stub names to
289           include in the generated image.
290
291 endif # SPL
292
293 endif # FIT
294
295 config LEGACY_IMAGE_FORMAT
296         bool "Enable support for the legacy image format"
297         default y if !FIT_SIGNATURE
298         help
299           This option enables the legacy image format. It is enabled by
300           default for backward compatibility, unless FIT_SIGNATURE is
301           set where it is disabled so that unsigned images cannot be
302           loaded. If a board needs the legacy image format support in this
303           case, enable it here.
304
305 config SUPPORT_RAW_INITRD
306         bool "Enable raw initrd images"
307         help
308           Note, defining the SUPPORT_RAW_INITRD allows user to supply
309           kernel with raw initrd images. The syntax is slightly different, the
310           address of the initrd must be augmented by it's size, in the following
311           format: "<initrd address>:<initrd size>".
312
313 config OF_BOARD_SETUP
314         bool "Set up board-specific details in device tree before boot"
315         depends on OF_LIBFDT
316         help
317           This causes U-Boot to call ft_board_setup() before booting into
318           the Operating System. This function can set up various
319           board-specific information in the device tree for use by the OS.
320           The device tree is then passed to the OS.
321
322 config OF_SYSTEM_SETUP
323         bool "Set up system-specific details in device tree before boot"
324         depends on OF_LIBFDT
325         help
326           This causes U-Boot to call ft_system_setup() before booting into
327           the Operating System. This function can set up various
328           system-specific information in the device tree for use by the OS.
329           The device tree is then passed to the OS.
330
331 config OF_STDOUT_VIA_ALIAS
332         bool "Update the device-tree stdout alias from U-Boot"
333         depends on OF_LIBFDT
334         help
335           This uses U-Boot's serial alias from the aliases node to update
336           the device tree passed to the OS. The "linux,stdout-path" property
337           in the chosen node is set to point to the correct serial node.
338           This option currently references CONFIG_CONS_INDEX, which is
339           incorrect when used with device tree as this option does not
340           exist / should not be used.
341
342 config SYS_EXTRA_OPTIONS
343         string "Extra Options (DEPRECATED)"
344         help
345           The old configuration infrastructure (= mkconfig + boards.cfg)
346           provided the extra options field. If you have something like
347           "HAS_BAR,BAZ=64", the optional options
348             #define CONFIG_HAS
349             #define CONFIG_BAZ  64
350           will be defined in include/config.h.
351           This option was prepared for the smooth migration from the old
352           configuration to Kconfig. Since this option will be removed sometime,
353           new boards should not use this option.
354
355 config HAVE_SYS_TEXT_BASE
356         bool
357         depends on !NIOS2 && !XTENSA
358         depends on !EFI_APP
359         default y
360
361 config SYS_TEXT_BASE
362         depends on HAVE_SYS_TEXT_BASE
363         default 0x0 if POSITION_INDEPENDENT
364         default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
365         default 0x81700000 if MACH_SUNIV
366         default 0x2a000000 if MACH_SUN9I
367         default 0x42e00000 if MACH_SUN8I_V3S
368         default 0x4a000000 if ARCH_SUNXI
369         hex "Text Base"
370         help
371           The address in memory that U-Boot will be running from, initially.
372
373 config HAVE_SYS_MONITOR_BASE
374         bool
375         depends on ARC || MIPS || M68K || NIOS2 || PPC || XTENSA || X86 \
376                 || FLASH_PIC32 || ENV_IS_IN_FLASH || MTD_NOR_FLASH
377         depends on !EFI_APP
378         default y
379
380 config SYS_MONITOR_BASE
381         depends on HAVE_SYS_MONITOR_BASE
382         hex "Physical start address of boot monitor code"
383         default SYS_TEXT_BASE
384         help
385           The physical start address of boot monitor code (which is the same as
386           CONFIG_SYS_TEXT_BASE when linking) and the same as CONFIG_SYS_FLASH_BASE
387           when booting from flash.
388
389 config SPL_SYS_MONITOR_BASE
390         depends on MPC85xx && SPL && HAVE_SYS_MONITOR_BASE
391         hex "Physical start address of SPL monitor code"
392         default SPL_TEXT_BASE
393
394 config TPL_SYS_MONITOR_BASE
395         depends on MPC85xx && TPL && HAVE_SYS_MONITOR_BASE
396         hex "Physical start address of TPL monitor code"
397
398 config DYNAMIC_SYS_CLK_FREQ
399         bool "Determine CPU clock frequency at run-time"
400         help
401           Implement a get_board_sys_clk function that will determine the CPU
402           clock frequency at run time, rather than define it statically.
403
404 config SYS_CLK_FREQ
405         depends on !DYNAMIC_SYS_CLK_FREQ
406         int "CPU clock frequency"
407         default 125000000 if ARCH_LS1012A
408         default 100000000 if ARCH_P2020 || ARCH_T1024 || ARCH_T1042 || \
409                              ARCH_LS1021A || FSL_LSCH2 || FSL_LSCH3
410         default 66666666 if ARCH_P1010 || ARCH_P1020 || ARCH_T4240
411         default 66660000 if ARCH_T2080
412         default 33333333 if RCAR_GEN3
413         default 24000000 if ARCH_EXYNOS
414         default 20000000 if RCAR_GEN2
415         default 0
416         help
417           A static value for the CPU frequency.  Note that if not required
418           for a given SoC, this can be left at 0.
419
420 config ARCH_FIXUP_FDT_MEMORY
421         bool "Enable arch_fixup_memory_banks() call"
422         default y
423         help
424           Enable FDT memory map syncup before OS boot. This feature can be
425           used for booting OS with different memory setup where the part of
426           the memory location should be used for different purpose.
427
428 config CHROMEOS
429         bool "Support booting Chrome OS"
430         help
431           Chrome OS requires U-Boot to set up a table indicating the boot mode
432           (e.g. Developer mode) and a few other things. Enable this if you are
433           booting on a Chromebook to avoid getting an error about an invalid
434           firmware ID.
435
436 config CHROMEOS_VBOOT
437         bool "Support Chrome OS verified boot"
438         help
439           This is intended to enable the full Chrome OS verified boot support
440           in U-Boot. It is not actually implemented in the U-Boot source code
441           at present, so this option is always set to 'n'. It allows
442           distinguishing between booting Chrome OS in a basic way (developer
443           mode) and a full boot.
444
445 config RAMBOOT_PBL
446         bool "Freescale PBL(pre-boot loader) image format support"
447         help
448           Some SoCs use PBL to load RCW and/or pre-initialization instructions.
449           For more details refer to doc/README.pblimage
450
451 choice
452         prompt "Freescale PBL load location"
453         depends on RAMBOOT_PBL || ((TARGET_P1010RDB_PA || TARGET_P1010RDB_PB \
454                 || TARGET_P1020RDB_PC || TARGET_P1020RDB_PD || TARGET_P2020RDB) \
455                 && !CMD_NAND)
456
457 config SDCARD
458         bool "Freescale PBL is found on SD card"
459
460 config SPIFLASH
461         bool "Freescale PBL is found on SPI flash"
462
463 endchoice
464
465 config SYS_FSL_PBL_PBI
466         string "PBI(pre-boot instructions) commands for the PBL image"
467         depends on RAMBOOT_PBL
468         help
469           PBI commands can be used to configure SoC before it starts the execution.
470           Please refer doc/README.pblimage for more details.
471
472 config SYS_FSL_PBL_RCW
473         string "Aadditional RCW (Power on reset configuration) for the PBL image"
474         depends on RAMBOOT_PBL
475         help
476           Enables addition of RCW (Power on reset configuration) in built image.
477           Please refer doc/README.pblimage for more details.
478
479 endmenu         # Boot images
480
481 menu "Boot timing"
482
483 config BOOTSTAGE
484         bool "Boot timing and reporting"
485         help
486           Enable recording of boot time while booting. To use it, insert
487           calls to bootstage_mark() with a suitable BOOTSTAGE_ID from
488           bootstage.h. Only a single entry is recorded for each ID. You can
489           give the entry a name with bootstage_mark_name(). You can also
490           record elapsed time in a particular stage using bootstage_start()
491           before starting and bootstage_accum() when finished. Bootstage will
492           add up all the accumulated time and report it.
493
494           Normally, IDs are defined in bootstage.h but a small number of
495           additional 'user' IDs can be used by passing BOOTSTAGE_ID_ALLOC
496           as the ID.
497
498           Calls to show_boot_progress() will also result in log entries but
499           these will not have names.
500
501 config SPL_BOOTSTAGE
502         bool "Boot timing and reported in SPL"
503         depends on BOOTSTAGE
504         help
505           Enable recording of boot time in SPL. To make this visible to U-Boot
506           proper, enable BOOTSTAGE_STASH as well. This will stash the timing
507           information when SPL finishes and load it when U-Boot proper starts
508           up.
509
510 config TPL_BOOTSTAGE
511         bool "Boot timing and reported in TPL"
512         depends on BOOTSTAGE
513         help
514           Enable recording of boot time in SPL. To make this visible to U-Boot
515           proper, enable BOOTSTAGE_STASH as well. This will stash the timing
516           information when TPL finishes and load it when U-Boot proper starts
517           up.
518
519 config BOOTSTAGE_REPORT
520         bool "Display a detailed boot timing report before booting the OS"
521         depends on BOOTSTAGE
522         help
523           Enable output of a boot time report just before the OS is booted.
524           This shows how long it took U-Boot to go through each stage of the
525           boot process. The report looks something like this:
526
527                 Timer summary in microseconds:
528                        Mark    Elapsed  Stage
529                           0          0  reset
530                   3,575,678  3,575,678  board_init_f start
531                   3,575,695         17  arch_cpu_init A9
532                   3,575,777         82  arch_cpu_init done
533                   3,659,598     83,821  board_init_r start
534                   3,910,375    250,777  main_loop
535                  29,916,167 26,005,792  bootm_start
536                  30,361,327    445,160  start_kernel
537
538 config BOOTSTAGE_RECORD_COUNT
539         int "Number of boot stage records to store"
540         depends on BOOTSTAGE
541         default 30
542         help
543           This is the size of the bootstage record list and is the maximum
544           number of bootstage records that can be recorded.
545
546 config SPL_BOOTSTAGE_RECORD_COUNT
547         int "Number of boot stage records to store for SPL"
548         depends on SPL_BOOTSTAGE
549         default 5
550         help
551           This is the size of the bootstage record list and is the maximum
552           number of bootstage records that can be recorded.
553
554 config TPL_BOOTSTAGE_RECORD_COUNT
555         int "Number of boot stage records to store for TPL"
556         depends on TPL_BOOTSTAGE
557         default 5
558         help
559           This is the size of the bootstage record list and is the maximum
560           number of bootstage records that can be recorded.
561
562 config BOOTSTAGE_FDT
563         bool "Store boot timing information in the OS device tree"
564         depends on BOOTSTAGE
565         help
566           Stash the bootstage information in the FDT. A root 'bootstage'
567           node is created with each bootstage id as a child. Each child
568           has a 'name' property and either 'mark' containing the
569           mark time in microseconds, or 'accum' containing the
570           accumulated time for that bootstage id in microseconds.
571           For example:
572
573                 bootstage {
574                         154 {
575                                 name = "board_init_f";
576                                 mark = <3575678>;
577                         };
578                         170 {
579                                 name = "lcd";
580                                 accum = <33482>;
581                         };
582                 };
583
584           Code in the Linux kernel can find this in /proc/devicetree.
585
586 config BOOTSTAGE_STASH
587         bool "Stash the boot timing information in memory before booting OS"
588         depends on BOOTSTAGE
589         help
590           Some OSes do not support device tree. Bootstage can instead write
591           the boot timing information in a binary format at a given address.
592           This happens through a call to bootstage_stash(), typically in
593           the CPU's cleanup_before_linux() function. You can use the
594           'bootstage stash' and 'bootstage unstash' commands to do this on
595           the command line.
596
597 config BOOTSTAGE_STASH_ADDR
598         hex "Address to stash boot timing information"
599         default 0
600         help
601           Provide an address which will not be overwritten by the OS when it
602           starts, so that it can read this information when ready.
603
604 config BOOTSTAGE_STASH_SIZE
605         hex "Size of boot timing stash region"
606         default 0x1000
607         help
608           This should be large enough to hold the bootstage stash. A value of
609           4096 (4KiB) is normally plenty.
610
611 config SHOW_BOOT_PROGRESS
612         bool "Show boot progress in a board-specific manner"
613         help
614           Defining this option allows to add some board-specific code (calling
615           a user-provided function show_boot_progress(int) that enables you to
616           show the system's boot progress on some display (for example, some
617           LEDs) on your board. At the moment, the following checkpoints are
618           implemented:
619
620           Legacy uImage format:
621
622           Arg   Where                   When
623             1   common/cmd_bootm.c      before attempting to boot an image
624            -1   common/cmd_bootm.c      Image header has bad     magic number
625             2   common/cmd_bootm.c      Image header has correct magic number
626            -2   common/cmd_bootm.c      Image header has bad     checksum
627             3   common/cmd_bootm.c      Image header has correct checksum
628            -3   common/cmd_bootm.c      Image data   has bad     checksum
629             4   common/cmd_bootm.c      Image data   has correct checksum
630            -4   common/cmd_bootm.c      Image is for unsupported architecture
631             5   common/cmd_bootm.c      Architecture check OK
632            -5   common/cmd_bootm.c      Wrong Image Type (not kernel, multi)
633             6   common/cmd_bootm.c      Image Type check OK
634            -6   common/cmd_bootm.c      gunzip uncompression error
635            -7   common/cmd_bootm.c      Unimplemented compression type
636             7   common/cmd_bootm.c      Uncompression OK
637             8   common/cmd_bootm.c      No uncompress/copy overwrite error
638            -9   common/cmd_bootm.c      Unsupported OS (not Linux, BSD, VxWorks, QNX)
639
640             9   common/image.c          Start initial ramdisk verification
641           -10   common/image.c          Ramdisk header has bad     magic number
642           -11   common/image.c          Ramdisk header has bad     checksum
643            10   common/image.c          Ramdisk header is OK
644           -12   common/image.c          Ramdisk data   has bad     checksum
645            11   common/image.c          Ramdisk data   has correct checksum
646            12   common/image.c          Ramdisk verification complete, start loading
647           -13   common/image.c          Wrong Image Type (not PPC Linux ramdisk)
648            13   common/image.c          Start multifile image verification
649            14   common/image.c          No initial ramdisk, no multifile, continue.
650
651            15   arch/<arch>/lib/bootm.c All preparation done, transferring control to OS
652
653           -30   arch/powerpc/lib/board.c        Fatal error, hang the system
654           -31   post/post.c             POST test failed, detected by post_output_backlog()
655           -32   post/post.c             POST test failed, detected by post_run_single()
656
657            34   common/cmd_doc.c        before loading a Image from a DOC device
658           -35   common/cmd_doc.c        Bad usage of "doc" command
659            35   common/cmd_doc.c        correct usage of "doc" command
660           -36   common/cmd_doc.c        No boot device
661            36   common/cmd_doc.c        correct boot device
662           -37   common/cmd_doc.c        Unknown Chip ID on boot device
663            37   common/cmd_doc.c        correct chip ID found, device available
664           -38   common/cmd_doc.c        Read Error on boot device
665            38   common/cmd_doc.c        reading Image header from DOC device OK
666           -39   common/cmd_doc.c        Image header has bad magic number
667            39   common/cmd_doc.c        Image header has correct magic number
668           -40   common/cmd_doc.c        Error reading Image from DOC device
669            40   common/cmd_doc.c        Image header has correct magic number
670            41   common/cmd_ide.c        before loading a Image from a IDE device
671           -42   common/cmd_ide.c        Bad usage of "ide" command
672            42   common/cmd_ide.c        correct usage of "ide" command
673           -43   common/cmd_ide.c        No boot device
674            43   common/cmd_ide.c        boot device found
675           -44   common/cmd_ide.c        Device not available
676            44   common/cmd_ide.c        Device available
677           -45   common/cmd_ide.c        wrong partition selected
678            45   common/cmd_ide.c        partition selected
679           -46   common/cmd_ide.c        Unknown partition table
680            46   common/cmd_ide.c        valid partition table found
681           -47   common/cmd_ide.c        Invalid partition type
682            47   common/cmd_ide.c        correct partition type
683           -48   common/cmd_ide.c        Error reading Image Header on boot device
684            48   common/cmd_ide.c        reading Image Header from IDE device OK
685           -49   common/cmd_ide.c        Image header has bad magic number
686            49   common/cmd_ide.c        Image header has correct magic number
687           -50   common/cmd_ide.c        Image header has bad     checksum
688            50   common/cmd_ide.c        Image header has correct checksum
689           -51   common/cmd_ide.c        Error reading Image from IDE device
690            51   common/cmd_ide.c        reading Image from IDE device OK
691            52   common/cmd_nand.c       before loading a Image from a NAND device
692           -53   common/cmd_nand.c       Bad usage of "nand" command
693            53   common/cmd_nand.c       correct usage of "nand" command
694           -54   common/cmd_nand.c       No boot device
695            54   common/cmd_nand.c       boot device found
696           -55   common/cmd_nand.c       Unknown Chip ID on boot device
697            55   common/cmd_nand.c       correct chip ID found, device available
698           -56   common/cmd_nand.c       Error reading Image Header on boot device
699            56   common/cmd_nand.c       reading Image Header from NAND device OK
700           -57   common/cmd_nand.c       Image header has bad magic number
701            57   common/cmd_nand.c       Image header has correct magic number
702           -58   common/cmd_nand.c       Error reading Image from NAND device
703            58   common/cmd_nand.c       reading Image from NAND device OK
704
705           -60   common/env_common.c     Environment has a bad CRC, using default
706
707            64   net/eth.c               starting with Ethernet configuration.
708           -64   net/eth.c               no Ethernet found.
709            65   net/eth.c               Ethernet found.
710
711           -80   common/cmd_net.c        usage wrong
712            80   common/cmd_net.c        before calling net_loop()
713           -81   common/cmd_net.c        some error in net_loop() occurred
714            81   common/cmd_net.c        net_loop() back without error
715           -82   common/cmd_net.c        size == 0 (File with size 0 loaded)
716            82   common/cmd_net.c        trying automatic boot
717            83   common/cmd_net.c        running "source" command
718           -83   common/cmd_net.c        some error in automatic boot or "source" command
719            84   common/cmd_net.c        end without errors
720
721           FIT uImage format:
722
723           Arg   Where                   When
724           100   common/cmd_bootm.c      Kernel FIT Image has correct format
725           -100  common/cmd_bootm.c      Kernel FIT Image has incorrect format
726           101   common/cmd_bootm.c      No Kernel subimage unit name, using configuration
727           -101  common/cmd_bootm.c      Can't get configuration for kernel subimage
728           102   common/cmd_bootm.c      Kernel unit name specified
729           -103  common/cmd_bootm.c      Can't get kernel subimage node offset
730           103   common/cmd_bootm.c      Found configuration node
731           104   common/cmd_bootm.c      Got kernel subimage node offset
732           -104  common/cmd_bootm.c      Kernel subimage hash verification failed
733           105   common/cmd_bootm.c      Kernel subimage hash verification OK
734           -105  common/cmd_bootm.c      Kernel subimage is for unsupported architecture
735           106   common/cmd_bootm.c      Architecture check OK
736           -106  common/cmd_bootm.c      Kernel subimage has wrong type
737           107   common/cmd_bootm.c      Kernel subimage type OK
738           -107  common/cmd_bootm.c      Can't get kernel subimage data/size
739           108   common/cmd_bootm.c      Got kernel subimage data/size
740           -108  common/cmd_bootm.c      Wrong image type (not legacy, FIT)
741           -109  common/cmd_bootm.c      Can't get kernel subimage type
742           -110  common/cmd_bootm.c      Can't get kernel subimage comp
743           -111  common/cmd_bootm.c      Can't get kernel subimage os
744           -112  common/cmd_bootm.c      Can't get kernel subimage load address
745           -113  common/cmd_bootm.c      Image uncompress/copy overwrite error
746
747           120   common/image.c          Start initial ramdisk verification
748           -120  common/image.c          Ramdisk FIT image has incorrect format
749           121   common/image.c          Ramdisk FIT image has correct format
750           122   common/image.c          No ramdisk subimage unit name, using configuration
751           -122  common/image.c          Can't get configuration for ramdisk subimage
752           123   common/image.c          Ramdisk unit name specified
753           -124  common/image.c          Can't get ramdisk subimage node offset
754           125   common/image.c          Got ramdisk subimage node offset
755           -125  common/image.c          Ramdisk subimage hash verification failed
756           126   common/image.c          Ramdisk subimage hash verification OK
757           -126  common/image.c          Ramdisk subimage for unsupported architecture
758           127   common/image.c          Architecture check OK
759           -127  common/image.c          Can't get ramdisk subimage data/size
760           128   common/image.c          Got ramdisk subimage data/size
761           129   common/image.c          Can't get ramdisk load address
762           -129  common/image.c          Got ramdisk load address
763
764           -130  common/cmd_doc.c        Incorrect FIT image format
765           131   common/cmd_doc.c        FIT image format OK
766
767           -140  common/cmd_ide.c        Incorrect FIT image format
768           141   common/cmd_ide.c        FIT image format OK
769
770           -150  common/cmd_nand.c       Incorrect FIT image format
771           151   common/cmd_nand.c       FIT image format OK
772
773 config SPL_SHOW_BOOT_PROGRESS
774         bool "Show boot progress in a board-specific manner in SPL"
775         depends on SPL
776         help
777           Defining this option allows to add some board-specific code (calling
778           a user-provided function show_boot_progress(int) that enables you to
779           show the system's boot progress on some display (for example, some
780           LEDs) on your board. For details see SHOW_BOOT_PROGRESS.
781
782 endmenu
783
784 menu "Boot media"
785
786 config NOR_BOOT
787         bool "Support for booting from NOR flash"
788         depends on NOR
789         help
790           Enabling this will make a U-Boot binary that is capable of being
791           booted via NOR.  In this case we will enable certain pinmux early
792           as the ROM only partially sets up pinmux.  We also default to using
793           NOR for environment.
794
795 config NAND_BOOT
796         bool "Support for booting from NAND flash"
797         imply MTD_RAW_NAND
798         help
799           Enabling this will make a U-Boot binary that is capable of being
800           booted via NAND flash. This is not a must, some SoCs need this,
801           some not.
802
803 config ONENAND_BOOT
804         bool "Support for booting from ONENAND"
805         imply MTD_RAW_NAND
806         help
807           Enabling this will make a U-Boot binary that is capable of being
808           booted via ONENAND. This is not a must, some SoCs need this,
809           some not.
810
811 config QSPI_BOOT
812         bool "Support for booting from QSPI flash"
813         help
814           Enabling this will make a U-Boot binary that is capable of being
815           booted via QSPI flash. This is not a must, some SoCs need this,
816           some not.
817
818 config SATA_BOOT
819         bool "Support for booting from SATA"
820         help
821           Enabling this will make a U-Boot binary that is capable of being
822           booted via SATA. This is not a must, some SoCs need this,
823           some not.
824
825 config SD_BOOT
826         bool "Support for booting from SD/EMMC"
827         help
828           Enabling this will make a U-Boot binary that is capable of being
829           booted via SD/EMMC. This is not a must, some SoCs need this,
830           some not.
831
832 config SD_BOOT_QSPI
833         bool "Support for booting from SD/EMMC and enable QSPI"
834         help
835           Enabling this will make a U-Boot binary that is capable of being
836           booted via SD/EMMC while enabling QSPI on the platform as well. This
837           is not a must, some SoCs need this, some not.
838
839 config SPI_BOOT
840         bool "Support for booting from SPI flash"
841         help
842           Enabling this will make a U-Boot binary that is capable of being
843           booted via SPI flash. This is not a must, some SoCs need this,
844           some not.
845
846 endmenu
847
848 menu "Autoboot options"
849
850 config AUTOBOOT
851         bool "Autoboot"
852         default y
853         help
854           This enables the autoboot.  See doc/README.autoboot for detail.
855
856 config BOOTDELAY
857         int "delay in seconds before automatically booting"
858         default 2
859         depends on AUTOBOOT
860         help
861           Delay before automatically running bootcmd;
862           set to 0 to autoboot with no delay, but you can stop it by key input.
863           set to -1 to disable autoboot.
864           set to -2 to autoboot with no delay and not check for abort
865
866           If this value is >= 0 then it is also used for the default delay
867           before starting the default entry in bootmenu. If it is < 0 then
868           a default value of 10s is used.
869
870           See doc/README.autoboot for details.
871
872 config AUTOBOOT_KEYED
873         bool "Stop autobooting via specific input key / string"
874         help
875           This option enables stopping (aborting) of the automatic
876           boot feature only by issuing a specific input key or
877           string. If not enabled, any input key will abort the
878           U-Boot automatic booting process and bring the device
879           to the U-Boot prompt for user input.
880
881 config AUTOBOOT_FLUSH_STDIN
882         bool "Enable flushing stdin before starting to read the password"
883         depends on AUTOBOOT_KEYED && !SANDBOX
884         help
885           When this option is enabled stdin buffer will be flushed before
886           starting to read the password.
887           This can't be enabled for the sandbox as flushing stdin would
888           break the autoboot unit tests.
889
890 config AUTOBOOT_PROMPT
891         string "Autoboot stop prompt"
892         depends on AUTOBOOT_KEYED
893         default "Autoboot in %d seconds\\n"
894         help
895           This string is displayed before the boot delay selected by
896           CONFIG_BOOTDELAY starts. If it is not defined there is no
897           output indicating that autoboot is in progress.
898
899           Note that this define is used as the (only) argument to a
900           printf() call, so it may contain '%' format specifications,
901           provided that it also includes, sepearated by commas exactly
902           like in a printf statement, the required arguments. It is
903           the responsibility of the user to select only such arguments
904           that are valid in the given context.
905
906 config AUTOBOOT_ENCRYPTION
907         bool "Enable encryption in autoboot stopping"
908         depends on AUTOBOOT_KEYED
909         help
910           This option allows a string to be entered into U-Boot to stop the
911           autoboot.
912           The behavior depends whether CONFIG_CRYPT_PW from lib is enabled
913           or not.
914           In case CONFIG_CRYPT_PW is enabled, the string will be forwarded
915           to the crypt-based functionality and be compared against the
916           string in the environment variable 'bootstopkeycrypt'.
917           In case CONFIG_CRYPT_PW is disabled the string itself is hashed
918           and compared against the hash in the environment variable
919           'bootstopkeysha256'.
920           If it matches in either case then boot stops and
921           a command-line prompt is presented.
922           This provides a way to ship a secure production device which can also
923           be accessed at the U-Boot command line.
924
925 config AUTOBOOT_SHA256_FALLBACK
926         bool "Allow fallback from crypt-hashed password to sha256"
927         depends on AUTOBOOT_ENCRYPTION && CRYPT_PW
928         help
929           This option adds support to fall back from crypt-hashed
930           passwords to checking a SHA256 hashed password in case the
931           'bootstopusesha256' environment variable is set to 'true'.
932
933 config AUTOBOOT_DELAY_STR
934         string "Delay autobooting via specific input key / string"
935         depends on AUTOBOOT_KEYED && !AUTOBOOT_ENCRYPTION
936         help
937           This option delays the automatic boot feature by issuing
938           a specific input key or string. If CONFIG_AUTOBOOT_DELAY_STR
939           or the environment variable "bootdelaykey" is specified
940           and this string is received from console input before
941           autoboot starts booting, U-Boot gives a command prompt. The
942           U-Boot prompt will time out if CONFIG_BOOT_RETRY_TIME is
943           used, otherwise it never times out.
944
945 config AUTOBOOT_STOP_STR
946         string "Stop autobooting via specific input key / string"
947         depends on AUTOBOOT_KEYED && !AUTOBOOT_ENCRYPTION
948         help
949           This option enables stopping (aborting) of the automatic
950           boot feature only by issuing a specific input key or
951           string. If CONFIG_AUTOBOOT_STOP_STR or the environment
952           variable "bootstopkey" is specified and this string is
953           received from console input before autoboot starts booting,
954           U-Boot gives a command prompt. The U-Boot prompt never
955           times out, even if CONFIG_BOOT_RETRY_TIME is used.
956
957 config AUTOBOOT_KEYED_CTRLC
958         bool "Enable Ctrl-C autoboot interruption"
959         depends on AUTOBOOT_KEYED && !AUTOBOOT_ENCRYPTION
960         help
961           This option allows for the boot sequence to be interrupted
962           by ctrl-c, in addition to the "bootdelaykey" and "bootstopkey".
963           Setting this variable provides an escape sequence from the
964           limited "password" strings.
965
966 config AUTOBOOT_NEVER_TIMEOUT
967         bool "Make the password entry never time-out"
968         depends on AUTOBOOT_KEYED && AUTOBOOT_ENCRYPTION && CRYPT_PW
969         help
970           This option removes the timeout from the password entry
971           when the user first presses the <Enter> key before entering
972           any other character.
973
974 config AUTOBOOT_STOP_STR_ENABLE
975         bool "Enable fixed string to stop autobooting"
976         depends on AUTOBOOT_KEYED && AUTOBOOT_ENCRYPTION
977         help
978           This option enables the feature to add a fixed stop
979           string that is defined at compile time.
980           In every case it will be tried to load the stop
981           string from the environment.
982           In case this is enabled and there is no stop string
983           in the environment, this will be used as default value.
984
985 config AUTOBOOT_STOP_STR_CRYPT
986         string "Stop autobooting via crypt-hashed password"
987         depends on AUTOBOOT_STOP_STR_ENABLE && CRYPT_PW
988         help
989           This option adds the feature to only stop the autobooting,
990           and therefore boot into the U-Boot prompt, when the input
991           string / password matches a values that is hashed via
992           one of the supported crypt-style password hashing options
993           and saved in the environment variable "bootstopkeycrypt".
994
995 config AUTOBOOT_STOP_STR_SHA256
996         string "Stop autobooting via SHA256 hashed password"
997         depends on AUTOBOOT_STOP_STR_ENABLE
998         help
999           This option adds the feature to only stop the autobooting,
1000           and therefore boot into the U-Boot prompt, when the input
1001           string / password matches a values that is encypted via
1002           a SHA256 hash and saved in the environment variable
1003           "bootstopkeysha256". If the value in that variable
1004           includes a ":", the portion prior to the ":" will be treated
1005           as a salt value.
1006
1007 config AUTOBOOT_USE_MENUKEY
1008         bool "Allow a specify key to run a menu from the environment"
1009         depends on !AUTOBOOT_KEYED
1010         help
1011           If a specific key is pressed to stop autoboot, then the commands in
1012           the environment variable 'menucmd' are executed before boot starts.
1013
1014 config AUTOBOOT_MENUKEY
1015         int "ASCII value of boot key to show a menu"
1016         default 0
1017         depends on AUTOBOOT_USE_MENUKEY
1018         help
1019           If this key is pressed to stop autoboot, then the commands in the
1020           environment variable 'menucmd' will be executed before boot starts.
1021           For example, 33 means "!" in ASCII, so pressing ! at boot would take
1022           this action.
1023
1024 config AUTOBOOT_MENU_SHOW
1025         bool "Show a menu on boot"
1026         depends on CMD_BOOTMENU
1027         help
1028           This enables the boot menu, controlled by environment variables
1029           defined by the board. The menu starts after running the 'preboot'
1030           environmnent variable (if enabled) and before handling the boot delay.
1031           See README.bootmenu for more details.
1032
1033 config BOOT_RETRY
1034         bool "Boot retry feature"
1035         help
1036           Allow for having the U-Boot command prompt time out and attempt
1037           to boot again.  If the environment variable "bootretry" is found then
1038           its value is used, otherwise the retry timeout is
1039           CONFIG_BOOT_RETRY_TIME.  CONFIG_BOOT_RETRY_MIN is optional and
1040           defaults to CONFIG_BOOT_RETRY_TIME. All times are in seconds.
1041
1042 config BOOT_RETRY_TIME
1043         int "Timeout in seconds before attempting to boot again"
1044         depends on BOOT_RETRY
1045         help
1046           Time in seconds before the U-Boot prompt will timeout and boot will
1047           be attempted again.
1048
1049 config BOOT_RETRY_MIN
1050         int "Minimum timeout in seconds for 'bootretry'"
1051         depends on BOOT_RETRY
1052         default BOOT_RETRY_TIME
1053         help
1054           The minimum time in seconds that "bootretry" can be set to.
1055
1056 config RESET_TO_RETRY
1057         bool "Reset the board to retry autoboot"
1058         depends on BOOT_RETRY
1059         help
1060           After the countdown timed out, the board will be reset to restart
1061           again.
1062
1063 endmenu
1064
1065 menu "Image support"
1066
1067 config IMAGE_PRE_LOAD
1068         bool "Image pre-load support"
1069         help
1070           Enable an image pre-load stage in the SPL.
1071           This pre-load stage allows to do some manipulation
1072           or check (for example signature check) on an image
1073           before launching it.
1074
1075 config SPL_IMAGE_PRE_LOAD
1076         bool "Image pre-load support within SPL"
1077         depends on SPL && IMAGE_PRE_LOAD
1078         help
1079           Enable an image pre-load stage in the SPL.
1080           This pre-load stage allows to do some manipulation
1081           or check (for example signature check) on an image
1082           before launching it.
1083
1084 config IMAGE_PRE_LOAD_SIG
1085         bool "Image pre-load signature support"
1086         depends on IMAGE_PRE_LOAD
1087         select FIT_SIGNATURE
1088         select RSA
1089         select RSA_VERIFY_WITH_PKEY
1090         help
1091           Enable signature check support in the pre-load stage.
1092           For this feature a very simple header is added before
1093           the image with few fields:
1094           - a magic
1095           - the image size
1096           - the signature
1097           All other information (header size, type of signature,
1098           ...) are provided in the node /image/pre-load/sig of
1099           u-boot.
1100
1101 config SPL_IMAGE_PRE_LOAD_SIG
1102         bool "Image pre-load signature support witin SPL"
1103         depends on SPL_IMAGE_PRE_LOAD && IMAGE_PRE_LOAD_SIG
1104         select SPL_FIT_SIGNATURE
1105         select SPL_RSA
1106         select SPL_RSA_VERIFY_WITH_PKEY
1107         help
1108           Enable signature check support in the pre-load stage in the SPL.
1109           For this feature a very simple header is added before
1110           the image with few fields:
1111           - a magic
1112           - the image size
1113           - the signature
1114           All other information (header size, type of signature,
1115           ...) are provided in the node /image/pre-load/sig of
1116           u-boot.
1117
1118 endmenu
1119
1120 config USE_BOOTARGS
1121         bool "Enable boot arguments"
1122         help
1123           Provide boot arguments to bootm command. Boot arguments are specified
1124           in CONFIG_BOOTARGS option. Enable this option to be able to specify
1125           CONFIG_BOOTARGS string. If this option is disabled, CONFIG_BOOTARGS
1126           will be undefined and won't take any space in U-Boot image.
1127
1128 config BOOTARGS
1129         string "Boot arguments"
1130         depends on USE_BOOTARGS && !USE_DEFAULT_ENV_FILE
1131         help
1132           This can be used to pass arguments to the bootm command. The value of
1133           CONFIG_BOOTARGS goes into the environment value "bootargs". Note that
1134           this value will also override the "chosen" node in FDT blob.
1135
1136 config BOOTARGS_SUBST
1137         bool "Support substituting strings in boot arguments"
1138         help
1139           This allows substituting string values in the boot arguments. These
1140           are applied after the commandline has been built.
1141
1142           One use for this is to insert the root-disk UUID into the command
1143           line where bootargs contains "root=${uuid}"
1144
1145                 setenv bootargs "console= root=${uuid}"
1146                 # Set the 'uuid' environment variable
1147                 part uuid mmc 2:2 uuid
1148
1149                 # Command-line substitution will put the real uuid into the
1150                 # kernel command line
1151                 bootm
1152
1153 config USE_BOOTCOMMAND
1154         bool "Enable a default value for bootcmd"
1155         help
1156           Provide a default value for the bootcmd entry in the environment.  If
1157           autoboot is enabled this is what will be run automatically.  Enable
1158           this option to be able to specify CONFIG_BOOTCOMMAND as a string.  If
1159           this option is disabled, CONFIG_BOOTCOMMAND will be undefined and
1160           won't take any space in U-Boot image.
1161
1162 config BOOTCOMMAND
1163         string "bootcmd value"
1164         depends on USE_BOOTCOMMAND && !USE_DEFAULT_ENV_FILE
1165         default "run distro_bootcmd" if DISTRO_DEFAULTS
1166         help
1167           This is the string of commands that will be used as bootcmd and if
1168           AUTOBOOT is set, automatically run.
1169
1170 config USE_PREBOOT
1171         bool "Enable preboot"
1172         help
1173           When this option is enabled, the existence of the environment
1174           variable "preboot" will be checked immediately before starting the
1175           CONFIG_BOOTDELAY countdown and/or running the auto-boot command resp.
1176           entering interactive mode.
1177
1178           This feature is especially useful when "preboot" is automatically
1179           generated or modified. For example, the boot code can modify the
1180           "preboot" when a user holds down a certain combination of keys.
1181
1182 config PREBOOT
1183         string "preboot default value"
1184         depends on USE_PREBOOT && !USE_DEFAULT_ENV_FILE
1185         default "usb start" if USB_KEYBOARD
1186         default ""
1187         help
1188           This is the default of "preboot" environment variable.
1189
1190 config DEFAULT_FDT_FILE
1191         string "Default fdt file"
1192         help
1193           This option is used to set the default fdt file to boot OS.
1194
1195 endmenu         # Booting