blob: ec5b956490de451e60a2538266cedeec6cdab3d4 [file] [log] [blame]
Simon Glassb45b1632020-09-10 20:21:13 -06001menu "Boot options"
2
3menu "Boot images"
4
5config 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
12config FIT
13 bool "Support Flattened Image Tree"
Alexandru Gagniuc650b7862021-09-02 19:54:21 -050014 select HASH
Simon Glassb45b1632020-09-10 20:21:13 -060015 select MD5
16 select SHA1
Alexandru Gagniuc8d310ef2021-09-02 19:54:17 -050017 imply SHA256
Simon Glassb45b1632020-09-10 20:21:13 -060018 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
Simon Glass65831d92021-12-18 11:27:50 -070028config 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
Simon Glassb45b1632020-09-10 20:21:13 -060039if FIT
40
41config 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
Simon Glass244705b2021-02-15 17:08:10 -070051config 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
Simon Glassb45b1632020-09-10 20:21:13 -060060config FIT_SIGNATURE
61 bool "Enable signature verification of FIT uImages"
62 depends on DM
63 select HASH
Alexandru Gagniuc1f2e2312021-07-29 11:47:18 -050064 imply RSA
65 imply RSA_VERIFY
Simon Glassb45b1632020-09-10 20:21:13 -060066 select IMAGE_SIGN_INFO
Simon Glass244705b2021-02-15 17:08:10 -070067 select FIT_FULL_CHECK
Simon Glassb45b1632020-09-10 20:21:13 -060068 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
81config 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
Simon Glass66b00c82021-07-14 17:05:31 -050091config FIT_RSASSA_PSS
Simon Glassb45b1632020-09-10 20:21:13 -060092 bool "Support rsassa-pss signature scheme of FIT image contents"
93 depends on FIT_SIGNATURE
Simon Glassb45b1632020-09-10 20:21:13 -060094 help
95 Enable this to support the pss padding algorithm as described
96 in the rfc8017 (https://tools.ietf.org/html/rfc8017).
97
98config 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
106config 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
114config 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
123config FIT_IMAGE_POST_PROCESS
124 bool "Enable post-processing of FIT artifacts after loading by U-Boot"
Siew Chin Lim2492d592021-03-01 20:04:11 +0800125 depends on TI_SECURE_DEVICE || SOCFPGA_SECURE_VAB_AUTH
Simon Glassb45b1632020-09-10 20:21:13 -0600126 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
Ravik Hasija11dac412021-01-27 14:01:48 -0800137config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600143if SPL
144
145config SPL_FIT
146 bool "Support Flattened Image Tree within SPL"
147 depends on SPL
Alexandru Gagniuc650b7862021-09-02 19:54:21 -0500148 select SPL_HASH
Simon Glassb45b1632020-09-10 20:21:13 -0600149 select SPL_OF_LIBFDT
150
151config 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
Simon Glass244705b2021-02-15 17:08:10 -0700157config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600166config SPL_FIT_SIGNATURE
167 bool "Enable signature verification of FIT firmware within SPL"
168 depends on SPL_DM
Klaus Heinrich Kiwiae5073f2021-02-09 15:41:54 -0300169 depends on SPL_LOAD_FIT || SPL_LOAD_FIT_FULL
Klaus Heinrich Kiwic9796e62021-02-09 15:41:53 -0300170 select FIT_SIGNATURE
Simon Glassb45b1632020-09-10 20:21:13 -0600171 select SPL_FIT
Simon Glassa8437ce2021-07-10 21:14:25 -0600172 select SPL_CRYPTO
Alexandru Gagniuc97464ff2021-09-02 19:54:19 -0500173 select SPL_HASH
Alexandru Gagniuc1f2e2312021-07-29 11:47:18 -0500174 imply SPL_RSA
175 imply SPL_RSA_VERIFY
Simon Glassb45b1632020-09-10 20:21:13 -0600176 select SPL_IMAGE_SIGN_INFO
Simon Glass244705b2021-02-15 17:08:10 -0700177 select SPL_FIT_FULL_CHECK
Simon Glassb45b1632020-09-10 20:21:13 -0600178
Simon Glassc0cabbc2021-09-25 19:43:39 -0600179config 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
Philippe Reynes47f3eb22021-10-15 11:35:03 +0200189config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600196config 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
Alexandru Gagniuc064c9c22021-03-29 12:05:15 -0500207 This path has the following limitations:
208
Bin Meng91cdcb92021-05-10 20:23:29 +0800209 1. "loadables" images, other than FDTs, which do not have a "load"
Alexandru Gagniuc064c9c22021-03-29 12:05:15 -0500210 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
Simon Glassb45b1632020-09-10 20:21:13 -0600217config 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
225config 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
234config 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
243config 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
254config 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
268config 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
276config USE_SPL_FIT_GENERATOR
277 bool "Use a script to generate the .its script"
Bin Meng442d4462021-05-10 20:23:41 +0800278 default y if SPL_FIT && (!ARCH_SUNXI && !RISCV)
Simon Glassb45b1632020-09-10 20:21:13 -0600279
280config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600285 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
291endif # SPL
292
293endif # FIT
294
295config 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
Simon Glassf11d6132020-09-10 20:21:19 -0600305config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600313config 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
322config 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
331config 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
Tom Rinia23179e2022-04-02 18:18:57 -0400342config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600355config HAVE_SYS_TEXT_BASE
356 bool
357 depends on !NIOS2 && !XTENSA
358 depends on !EFI_APP
359 default y
360
361config SYS_TEXT_BASE
362 depends on HAVE_SYS_TEXT_BASE
Tom Rini63471d52021-07-09 10:39:21 -0400363 default 0x0 if POSITION_INDEPENDENT
Simon Glassb45b1632020-09-10 20:21:13 -0600364 default 0x80800000 if ARCH_OMAP2PLUS || ARCH_K3
Icenowy Zheng711fab32022-01-29 10:23:09 -0500365 default 0x81700000 if MACH_SUNIV
366 default 0x2a000000 if MACH_SUN9I
367 default 0x42e00000 if MACH_SUN8I_V3S
368 default 0x4a000000 if ARCH_SUNXI
Simon Glassb45b1632020-09-10 20:21:13 -0600369 hex "Text Base"
370 help
371 The address in memory that U-Boot will be running from, initially.
372
Tom Rini03becca2022-03-24 17:18:05 -0400373config 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
380config 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
389config 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
394config TPL_SYS_MONITOR_BASE
395 depends on MPC85xx && TPL && HAVE_SYS_MONITOR_BASE
396 hex "Physical start address of TPL monitor code"
397
Tom Rini8c70baa2021-12-14 13:36:40 -0500398config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600404config SYS_CLK_FREQ
Tom Rini8c70baa2021-12-14 13:36:40 -0500405 depends on !DYNAMIC_SYS_CLK_FREQ
Simon Glassb45b1632020-09-10 20:21:13 -0600406 int "CPU clock frequency"
Tom Rini8c70baa2021-12-14 13:36:40 -0500407 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
Simon Glassb45b1632020-09-10 20:21:13 -0600416 help
Tom Rini8c70baa2021-12-14 13:36:40 -0500417 A static value for the CPU frequency. Note that if not required
418 for a given SoC, this can be left at 0.
Simon Glassb45b1632020-09-10 20:21:13 -0600419
420config 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
Simon Glassd81f07f2020-11-04 09:57:35 -0700428config 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
436config 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
Tom Rini9ff815a2021-08-24 23:11:49 -0400445config 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
Tom Rini886e6e32022-03-23 17:20:03 -0400451choice
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
457config SDCARD
458 bool "Freescale PBL is found on SD card"
459
460config SPIFLASH
461 bool "Freescale PBL is found on SPI flash"
462
463endchoice
464
Tom Rini9ff815a2021-08-24 23:11:49 -0400465config 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
472config 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
Simon Glassb45b1632020-09-10 20:21:13 -0600479endmenu # Boot images
480
Simon Glassd02ddcf2020-09-10 20:21:14 -0600481menu "Boot timing"
482
483config 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
501config 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
510config 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
519config 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
538config BOOTSTAGE_RECORD_COUNT
539 int "Number of boot stage records to store"
Simon Glass051ddfb2021-02-03 06:00:49 -0700540 depends on BOOTSTAGE
Simon Glassd02ddcf2020-09-10 20:21:14 -0600541 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
546config SPL_BOOTSTAGE_RECORD_COUNT
547 int "Number of boot stage records to store for SPL"
Simon Glass051ddfb2021-02-03 06:00:49 -0700548 depends on SPL_BOOTSTAGE
Simon Glassd02ddcf2020-09-10 20:21:14 -0600549 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
554config TPL_BOOTSTAGE_RECORD_COUNT
555 int "Number of boot stage records to store for TPL"
Simon Glass051ddfb2021-02-03 06:00:49 -0700556 depends on TPL_BOOTSTAGE
Simon Glassd02ddcf2020-09-10 20:21:14 -0600557 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
562config 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
586config 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
597config 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
604config 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
611config 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
Marek Vasut98154342021-10-23 03:06:03 +0200773config SPL_SHOW_BOOT_PROGRESS
Jan Kiszka5780edb2021-11-03 15:09:36 +0100774 bool "Show boot progress in a board-specific manner in SPL"
Marek Vasut98154342021-10-23 03:06:03 +0200775 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
Simon Glassd02ddcf2020-09-10 20:21:14 -0600782endmenu
783
Simon Glasseebed782020-09-10 20:21:15 -0600784menu "Boot media"
785
786config 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
795config NAND_BOOT
796 bool "Support for booting from NAND flash"
Simon Glasseebed782020-09-10 20:21:15 -0600797 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
803config ONENAND_BOOT
804 bool "Support for booting from ONENAND"
Simon Glasseebed782020-09-10 20:21:15 -0600805 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
811config QSPI_BOOT
812 bool "Support for booting from QSPI flash"
Simon Glasseebed782020-09-10 20:21:15 -0600813 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
818config SATA_BOOT
819 bool "Support for booting from SATA"
Simon Glasseebed782020-09-10 20:21:15 -0600820 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
825config SD_BOOT
826 bool "Support for booting from SD/EMMC"
Simon Glasseebed782020-09-10 20:21:15 -0600827 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
Tom Rinia43bf4e2021-12-11 14:55:50 -0500832config 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
Simon Glasseebed782020-09-10 20:21:15 -0600839config SPI_BOOT
840 bool "Support for booting from SPI flash"
Simon Glasseebed782020-09-10 20:21:15 -0600841 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
846endmenu
847
Simon Glasse9d54d72020-09-10 20:21:16 -0600848menu "Autoboot options"
849
850config AUTOBOOT
851 bool "Autoboot"
852 default y
853 help
854 This enables the autoboot. See doc/README.autoboot for detail.
855
Simon Glass1b6cbaa2020-09-10 20:21:17 -0600856config 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
Simon Glasse9d54d72020-09-10 20:21:16 -0600872config AUTOBOOT_KEYED
873 bool "Stop autobooting via specific input key / string"
Simon Glasse9d54d72020-09-10 20:21:16 -0600874 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
Steffen Jaeckeldfc97322021-07-08 15:57:38 +0200881config 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
Simon Glasse9d54d72020-09-10 20:21:16 -0600890config 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
906config 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
Steffen Jaeckel6aa6bfb2021-07-08 15:57:35 +0200911 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.
Simon Glasse9d54d72020-09-10 20:21:16 -0600922 This provides a way to ship a secure production device which can also
923 be accessed at the U-Boot command line.
924
Steffen Jaeckel28be70d2021-07-08 15:57:39 +0200925config 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
Simon Glasse9d54d72020-09-10 20:21:16 -0600933config 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
945config 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
957config AUTOBOOT_KEYED_CTRLC
958 bool "Enable Ctrl-C autoboot interruption"
959 depends on AUTOBOOT_KEYED && !AUTOBOOT_ENCRYPTION
Simon Glasse9d54d72020-09-10 20:21:16 -0600960 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
Steffen Jaeckel792a13f2021-07-08 15:57:37 +0200966config 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
Steffen Jaeckel6aa6bfb2021-07-08 15:57:35 +0200974config 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
985config 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
Simon Glasse9d54d72020-09-10 20:21:16 -0600995config AUTOBOOT_STOP_STR_SHA256
Steffen Jaeckele1788f92021-07-08 15:57:40 +0200996 string "Stop autobooting via SHA256 hashed password"
Steffen Jaeckel6aa6bfb2021-07-08 15:57:35 +0200997 depends on AUTOBOOT_STOP_STR_ENABLE
Simon Glasse9d54d72020-09-10 20:21:16 -0600998 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
Joel Peshkin8b7bf532020-11-21 17:18:59 -08001002 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.
Simon Glasse9d54d72020-09-10 20:21:16 -06001006
1007config 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
1014config 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
1024config 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
Tom Rinia45a3ef2022-03-11 09:12:04 -05001033config 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
1042config 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
1049config 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
1056config 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
Simon Glasse9d54d72020-09-10 20:21:16 -06001063endmenu
1064
Philippe Reynesd28484e2022-03-28 22:56:59 +02001065menu "Image support"
1066
1067config 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
1075config 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
1084config 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
1101config 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
1118endmenu
1119
Simon Glass5e958642020-09-10 20:21:18 -06001120config 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
1128config 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
Simon Glass529e2082020-11-05 10:33:48 -07001136config 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
Simon Glass5e958642020-09-10 20:21:18 -06001153config 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
1162config 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
1170config 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
1182config PREBOOT
1183 string "preboot default value"
1184 depends on USE_PREBOOT && !USE_DEFAULT_ENV_FILE
Patrick Delaunaybb15d402020-10-12 09:47:50 +02001185 default "usb start" if USB_KEYBOARD
Simon Glass5e958642020-09-10 20:21:18 -06001186 default ""
1187 help
1188 This is the default of "preboot" environment variable.
1189
Simon Glassc10ddfd2020-09-10 20:21:20 -06001190config 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
Dzmitry Sankouskia3463062022-02-22 21:49:52 +03001195config SAVE_PREV_BL_FDT_ADDR
1196 depends on ARM
1197 bool "Saves fdt address, passed by the previous bootloader, to env var"
1198 help
1199 When u-boot is used as a chain-loaded bootloader (replacing OS kernel),
1200 enable this option to save fdt address, passed by the
1201 previous bootloader for future use.
1202 Address is saved to `prevbl_fdt_addr` environment variable.
1203
1204 If no fdt was provided by previous bootloader, no env variables
1205 will be created.
1206
1207config SAVE_PREV_BL_INITRAMFS_START_ADDR
1208 depends on ARM
1209 bool "Saves initramfs address, passed by the previous bootloader, to env var"
1210 help
1211 When u-boot is used as a chain-loaded bootloader(replacing OS kernel),
1212 enable this option to save initramfs address, passed by the
1213 previous bootloader for future use.
1214 Address is saved to `prevbl_initrd_start_addr` environment variable.
1215
1216 If no initramfs was provided by previous bootloader, no env variables
1217 will be created.
1218
Simon Glassb45b1632020-09-10 20:21:13 -06001219endmenu # Booting