4 bool "Boot timing and reporting"
6 Enable recording of boot time while booting. To use it, insert
7 calls to bootstage_mark() with a suitable BOOTSTAGE_ID from
8 bootstage.h. Only a single entry is recorded for each ID. You can
9 give the entry a name with bootstage_mark_name(). You can also
10 record elapsed time in a particular stage using bootstage_start()
11 before starting and bootstage_accum() when finished. Bootstage will
12 add up all the accumulated time and report it.
14 Normally, IDs are defined in bootstage.h but a small number of
15 additional 'user' IDs can be used by passing BOOTSTAGE_ID_ALLOC
18 Calls to show_boot_progress() will also result in log entries but
19 these will not have names.
22 bool "Boot timing and reported in SPL"
25 Enable recording of boot time in SPL. To make this visible to U-Boot
26 proper, enable BOOTSTAGE_STASH as well. This will stash the timing
27 information when SPL finishes and load it when U-Boot proper starts
31 bool "Boot timing and reported in TPL"
34 Enable recording of boot time in SPL. To make this visible to U-Boot
35 proper, enable BOOTSTAGE_STASH as well. This will stash the timing
36 information when TPL finishes and load it when U-Boot proper starts
39 config BOOTSTAGE_REPORT
40 bool "Display a detailed boot timing report before booting the OS"
43 Enable output of a boot time report just before the OS is booted.
44 This shows how long it took U-Boot to go through each stage of the
45 boot process. The report looks something like this:
47 Timer summary in microseconds:
50 3,575,678 3,575,678 board_init_f start
51 3,575,695 17 arch_cpu_init A9
52 3,575,777 82 arch_cpu_init done
53 3,659,598 83,821 board_init_r start
54 3,910,375 250,777 main_loop
55 29,916,167 26,005,792 bootm_start
56 30,361,327 445,160 start_kernel
58 config BOOTSTAGE_RECORD_COUNT
59 int "Number of boot stage records to store"
62 This is the size of the bootstage record list and is the maximum
63 number of bootstage records that can be recorded.
65 config SPL_BOOTSTAGE_RECORD_COUNT
66 int "Number of boot stage records to store for SPL"
69 This is the size of the bootstage record list and is the maximum
70 number of bootstage records that can be recorded.
72 config TPL_BOOTSTAGE_RECORD_COUNT
73 int "Number of boot stage records to store for TPL"
76 This is the size of the bootstage record list and is the maximum
77 number of bootstage records that can be recorded.
80 bool "Store boot timing information in the OS device tree"
83 Stash the bootstage information in the FDT. A root 'bootstage'
84 node is created with each bootstage id as a child. Each child
85 has a 'name' property and either 'mark' containing the
86 mark time in microseconds, or 'accum' containing the
87 accumulated time for that bootstage id in microseconds.
92 name = "board_init_f";
101 Code in the Linux kernel can find this in /proc/devicetree.
103 config BOOTSTAGE_STASH
104 bool "Stash the boot timing information in memory before booting OS"
107 Some OSes do not support device tree. Bootstage can instead write
108 the boot timing information in a binary format at a given address.
109 This happens through a call to bootstage_stash(), typically in
110 the CPU's cleanup_before_linux() function. You can use the
111 'bootstage stash' and 'bootstage unstash' commands to do this on
114 config BOOTSTAGE_STASH_ADDR
115 hex "Address to stash boot timing information"
118 Provide an address which will not be overwritten by the OS when it
119 starts, so that it can read this information when ready.
121 config BOOTSTAGE_STASH_SIZE
122 hex "Size of boot timing stash region"
125 This should be large enough to hold the bootstage stash. A value of
126 4096 (4KiB) is normally plenty.
133 bool "Support for booting from NOR flash"
136 Enabling this will make a U-Boot binary that is capable of being
137 booted via NOR. In this case we will enable certain pinmux early
138 as the ROM only partially sets up pinmux. We also default to using
142 bool "Support for booting from NAND flash"
146 Enabling this will make a U-Boot binary that is capable of being
147 booted via NAND flash. This is not a must, some SoCs need this,
151 bool "Support for booting from ONENAND"
155 Enabling this will make a U-Boot binary that is capable of being
156 booted via ONENAND. This is not a must, some SoCs need this,
160 bool "Support for booting from QSPI flash"
163 Enabling this will make a U-Boot binary that is capable of being
164 booted via QSPI flash. This is not a must, some SoCs need this,
168 bool "Support for booting from SATA"
171 Enabling this will make a U-Boot binary that is capable of being
172 booted via SATA. This is not a must, some SoCs need this,
176 bool "Support for booting from SD/EMMC"
179 Enabling this will make a U-Boot binary that is capable of being
180 booted via SD/EMMC. This is not a must, some SoCs need this,
184 bool "Support for booting from SPI flash"
187 Enabling this will make a U-Boot binary that is capable of being
188 booted via SPI flash. This is not a must, some SoCs need this,
194 int "delay in seconds before automatically booting"
198 Delay before automatically running bootcmd;
199 set to 0 to autoboot with no delay, but you can stop it by key input.
200 set to -1 to disable autoboot.
201 set to -2 to autoboot with no delay and not check for abort
203 If this value is >= 0 then it is also used for the default delay
204 before starting the default entry in bootmenu. If it is < 0 then
205 a default value of 10s is used.
207 See doc/README.autoboot for details.
210 bool "Enable boot arguments"
212 Provide boot arguments to bootm command. Boot arguments are specified
213 in CONFIG_BOOTARGS option. Enable this option to be able to specify
214 CONFIG_BOOTARGS string. If this option is disabled, CONFIG_BOOTARGS
215 will be undefined and won't take any space in U-Boot image.
218 string "Boot arguments"
219 depends on USE_BOOTARGS
221 This can be used to pass arguments to the bootm command. The value of
222 CONFIG_BOOTARGS goes into the environment value "bootargs". Note that
223 this value will also override the "chosen" node in FDT blob.
225 config USE_BOOTCOMMAND
226 bool "Enable a default value for bootcmd"
228 Provide a default value for the bootcmd entry in the environment. If
229 autoboot is enabled this is what will be run automatically. Enable
230 this option to be able to specify CONFIG_BOOTCOMMAND as a string. If
231 this option is disabled, CONFIG_BOOTCOMMAND will be undefined and
232 won't take any space in U-Boot image.
235 string "bootcmd value"
236 depends on USE_BOOTCOMMAND
237 default "run distro_bootcmd" if DISTRO_DEFAULTS
239 This is the string of commands that will be used as bootcmd and if
240 AUTOBOOT is set, automatically run.
243 bool "Enable preboot"
245 When this option is enabled, the existence of the environment
246 variable "preboot" will be checked immediately before starting the
247 CONFIG_BOOTDELAY countdown and/or running the auto-boot command resp.
248 entering interactive mode.
250 This feature is especially useful when "preboot" is automatically
251 generated or modified. For example, the boot code can modify the
252 "preboot" when a user holds down a certain combination of keys.
255 string "preboot default value"
256 depends on USE_PREBOOT
259 This is the default of "preboot" environment variable.
266 This is the library functionality to provide a text-based menu of
267 choices for the user to make choices with.
269 config CONSOLE_RECORD
270 bool "Console recording"
272 This provides a way to record console output (and provide console
273 input) through circular buffers. This is mostly useful for testing.
274 Console output is recorded even when the console is silent.
275 To enable console recording, call console_record_reset_enable()
278 config CONSOLE_RECORD_OUT_SIZE
279 hex "Output buffer size"
280 depends on CONSOLE_RECORD
281 default 0x400 if CONSOLE_RECORD
283 Set the size of the console output buffer. When this fills up, no
284 more data will be recorded until some is removed. The buffer is
285 allocated immediately after the malloc() region is ready.
287 config CONSOLE_RECORD_IN_SIZE
288 hex "Input buffer size"
289 depends on CONSOLE_RECORD
290 default 0x100 if CONSOLE_RECORD
292 Set the size of the console input buffer. When this contains data,
293 tstc() and getc() will use this in preference to real device input.
294 The buffer is allocated immediately after the malloc() region is
297 config DISABLE_CONSOLE
298 bool "Add functionality to disable console completely"
300 Disable console (in & out).
303 string "Board specific string to be added to uboot version string"
305 This options adds the board specific name to u-boot version.
312 All Messages with a loglevel smaller than the console loglevel will
313 be compiled in. The loglevels are defined as follows:
324 9 - debug hardware I/O
334 config SILENT_CONSOLE
335 bool "Support a silent console"
337 This option allows the console to be silenced, meaning that no
338 output will appear on the console devices. This is controlled by
339 setting the environment variable 'silent' to a non-empty value.
340 Note this also silences the console when booting Linux.
342 When the console is set up, the variable is checked, and the
343 GD_FLG_SILENT flag is set. Changing the environment variable later
344 will update the flag.
346 config SILENT_U_BOOT_ONLY
347 bool "Only silence the U-Boot console"
348 depends on SILENT_CONSOLE
350 Normally when the U-Boot console is silenced, Linux's console is
351 also silenced (assuming the board boots into Linux). This option
352 allows the linux console to operate normally, even if U-Boot's
355 config SILENT_CONSOLE_UPDATE_ON_SET
356 bool "Changes to the 'silent' environment variable update immediately"
357 depends on SILENT_CONSOLE
358 default y if SILENT_CONSOLE
360 When the 'silent' environment variable is changed, update the
361 console silence flag immediately. This allows 'setenv' to be used
362 to silence or un-silence the console.
364 The effect is that any change to the variable will affect the
367 config SILENT_CONSOLE_UPDATE_ON_RELOC
368 bool "Allow flags to take effect on relocation"
369 depends on SILENT_CONSOLE
371 In some cases the environment is not available until relocation
372 (e.g. NAND). This option makes the value of the 'silent'
373 environment variable take effect at relocation.
375 config PRE_CONSOLE_BUFFER
376 bool "Buffer characters before the console is available"
378 Prior to the console being initialised (i.e. serial UART
379 initialised etc) all console output is silently discarded.
380 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
381 buffer any console messages prior to the console being
382 initialised to a buffer. The buffer is a circular buffer, so
383 if it overflows, earlier output is discarded.
385 Note that this is not currently supported in SPL. It would be
386 useful to be able to share the pre-console buffer with SPL.
388 config PRE_CON_BUF_SZ
389 int "Sets the size of the pre-console buffer"
390 depends on PRE_CONSOLE_BUFFER
393 The size of the pre-console buffer affects how much console output
394 can be held before it overflows and starts discarding earlier
395 output. Normally there is very little output at this early stage,
396 unless debugging is enabled, so allow enough for ~10 lines of
399 This is a useful feature if you are using a video console and
400 want to see the full boot output on the console. Without this
401 option only the post-relocation output will be displayed.
403 config PRE_CON_BUF_ADDR
404 hex "Address of the pre-console buffer"
405 depends on PRE_CONSOLE_BUFFER
406 default 0x2f000000 if ARCH_SUNXI && MACH_SUN9I
407 default 0x4f000000 if ARCH_SUNXI && !MACH_SUN9I
409 This sets the start address of the pre-console buffer. This must
410 be in available memory and is accessed before relocation and
411 possibly before DRAM is set up. Therefore choose an address
414 We should consider removing this option and allocating the memory
415 in board_init_f_init_reserve() instead.
418 bool "Enable console multiplexing"
419 default y if DM_VIDEO || VIDEO || LCD
421 This allows multiple devices to be used for each console 'file'.
422 For example, stdout can be set to go to serial and video.
423 Similarly, stdin can be set to come from serial and keyboard.
424 Input can be provided from either source. Console multiplexing
425 adds a small amount of size to U-Boot. Changes to the environment
426 variables stdout, stdin and stderr will take effect immediately.
428 config SYS_CONSOLE_IS_IN_ENV
429 bool "Select console devices from the environment"
430 default y if CONSOLE_MUX
432 This allows multiple input/output devices to be set at boot time.
433 For example, if stdout is set to "serial,video" then output will
434 be sent to both the serial and video devices on boot. The
435 environment variables can be updated after boot to change the
436 input/output devices.
438 config SYS_CONSOLE_OVERWRITE_ROUTINE
439 bool "Allow board control over console overwriting"
441 If this is enabled, and the board-specific function
442 overwrite_console() returns 1, the stdin, stderr and stdout are
443 switched to the serial port, else the settings in the environment
444 are used. If this is not enabled, the console will not be switched
447 config SYS_CONSOLE_ENV_OVERWRITE
448 bool "Update environment variables during console init"
450 The console environment variables (stdout, stdin, stderr) can be
451 used to determine the correct console devices on start-up. This
452 option writes the console devices to these variables on console
453 start-up (after relocation). This causes the environment to be
454 updated to match the console devices actually chosen.
456 config SYS_CONSOLE_INFO_QUIET
457 bool "Don't display the console devices on boot"
459 Normally U-Boot displays the current settings for stdout, stdin
460 and stderr on boot when the post-relocation console is set up.
461 Enable this option to suppress this output. It can be obtained by
462 calling stdio_print_current_devices() from board code.
464 config SYS_STDIO_DEREGISTER
465 bool "Allow deregistering stdio devices"
466 default y if USB_KEYBOARD
468 Generally there is no need to deregister stdio devices since they
469 are never deactivated. But if a stdio device is used which can be
470 removed (for example a USB keyboard) then this option can be
471 enabled to ensure this is handled correctly.
478 bool "Enable logging support"
481 This enables support for logging of status and debug messages. These
482 can be displayed on the console, recorded in a memory buffer, or
483 discarded if not needed. Logging supports various categories and
487 bool "Enable logging support in SPL"
490 This enables support for logging of status and debug messages. These
491 can be displayed on the console, recorded in a memory buffer, or
492 discarded if not needed. Logging supports various categories and
496 bool "Enable logging support in TPL"
499 This enables support for logging of status and debug messages. These
500 can be displayed on the console, recorded in a memory buffer, or
501 discarded if not needed. Logging supports various categories and
505 int "Maximum log level to record"
509 This selects the maximum log level that will be recorded. Any value
510 higher than this will be ignored. If possible log statements below
511 this level will be discarded at build time. Levels:
522 9 - debug hardware I/O
524 config SPL_LOG_MAX_LEVEL
525 int "Maximum log level to record in SPL"
529 This selects the maximum log level that will be recorded. Any value
530 higher than this will be ignored. If possible log statements below
531 this level will be discarded at build time. Levels:
542 9 - debug hardware I/O
544 config TPL_LOG_MAX_LEVEL
545 int "Maximum log level to record in TPL"
549 This selects the maximum log level that will be recorded. Any value
550 higher than this will be ignored. If possible log statements below
551 this level will be discarded at build time. Levels:
562 9 - debug hardware I/O
564 config LOG_DEFAULT_LEVEL
565 int "Default logging level to display"
568 This is the default logging level set when U-Boot starts. It can
569 be adjusted later using the 'log level' command. Note that setting
570 this to a value above LOG_MAX_LEVEL will be ineffective, since the
571 higher levels are not compiled in to U-Boot.
582 9 - debug hardware I/O
585 bool "Allow log output to the console"
589 Enables a log driver which writes log records to the console.
590 Generally the console is the serial port or LCD display. Only the
591 log message is shown - other details like level, category, file and
592 line number are omitted.
594 config SPL_LOG_CONSOLE
595 bool "Allow log output to the console in SPL"
599 Enables a log driver which writes log records to the console.
600 Generally the console is the serial port or LCD display. Only the
601 log message is shown - other details like level, category, file and
602 line number are omitted.
604 config TPL_LOG_CONSOLE
605 bool "Allow log output to the console in SPL"
609 Enables a log driver which writes log records to the console.
610 Generally the console is the serial port or LCD display. Only the
611 log message is shown - other details like level, category, file and
612 line number are omitted.
615 bool "Provide a test for logging"
619 This enables a 'log test' command to test logging. It is normally
620 executed from a pytest and simply outputs logging information
621 in various different ways to test that the logging system works
622 correctly with various settings.
624 config LOG_ERROR_RETURN
625 bool "Log all functions which return an error"
628 When an error is returned in U-Boot it is sometimes difficult to
629 figure out the root cause. For example, reading from SPI flash may
630 fail due to a problem in the SPI controller or due to the flash part
631 not returning the expected information. This option changes
632 log_ret() to log any errors it sees. With this option disabled,
635 You can add log_ret() to all functions which return an error code.
639 config SUPPORT_RAW_INITRD
640 bool "Enable raw initrd images"
642 Note, defining the SUPPORT_RAW_INITRD allows user to supply
643 kernel with raw initrd images. The syntax is slightly different, the
644 address of the initrd must be augmented by it's size, in the following
645 format: "<initrd address>:<initrd size>".
647 config DEFAULT_FDT_FILE
648 string "Default fdt file"
650 This option is used to set the default fdt file to boot OS.
653 bool "Execute Misc Init"
654 default y if ARCH_KEYSTONE || ARCH_SUNXI || MPC85xx
655 default y if ARCH_OMAP2PLUS && !AM33XX
657 Enabling this option calls 'misc_init_r' function
659 config VERSION_VARIABLE
660 bool "add U-Boot environment variable vers"
663 If this variable is defined, an environment variable
664 named "ver" is created by U-Boot showing the U-Boot
665 version as printed by the "version" command.
666 Any change to this variable will be reverted at the
669 config BOARD_LATE_INIT
670 bool "Execute Board late init"
672 Sometimes board require some initialization code that might
673 require once the actual init done, example saving board specific env,
674 boot-modes etc. which eventually done at late.
676 So this config enable the late init code with the help of board_late_init
677 function which should defined on respective boards.
679 config DISPLAY_CPUINFO
680 bool "Display information about the CPU during start up"
681 default y if ARC|| ARM || NIOS2 || X86 || XTENSA || M68K
683 Display information about the CPU that U-Boot is running on
684 when U-Boot starts up. The function print_cpuinfo() is called
687 config DISPLAY_BOARDINFO
688 bool "Display information about the board during early start up"
689 default y if ARC || ARM || M68K || MIPS || PPC || SANDBOX || XTENSA
691 Display information about the board that U-Boot is running on
692 when U-Boot starts up. The board function checkboard() is called
695 config DISPLAY_BOARDINFO_LATE
696 bool "Display information about the board during late start up"
698 Display information about the board that U-Boot is running on after
699 the relocation phase. The board function checkboard() is called to do
703 bool "Include bounce buffer API"
705 Some peripherals support DMA from a subset of physically
706 addressable memory only. To support such peripherals, the
707 bounce buffer API uses a temporary buffer: it copies data
708 to/from DMA regions while managing cache operations.
710 A second possible use of bounce buffers is their ability to
711 provide aligned buffers for DMA operations.
714 bool "Call get_board_type() to get and display the board type"
716 If this option is enabled, checkboard() will call get_board_type()
717 to get a string containing the board type and this will be
718 displayed immediately after the model is shown on the console
721 menu "Start-up hooks"
723 config ARCH_EARLY_INIT_R
724 bool "Call arch-specific init soon after relocation"
726 With this option U-Boot will call arch_early_init_r() soon after
727 relocation. Driver model is running by this point, and the cache
728 is on. Note that board_early_init_r() is called first, if
729 enabled. This can be used to set up architecture-specific devices.
731 config ARCH_MISC_INIT
732 bool "Call arch-specific init after relocation, when console is ready"
734 With this option U-Boot will call arch_misc_init() after
735 relocation to allow miscellaneous arch-dependent initialisation
736 to be performed. This function should be defined by the board
737 and will be called after the console is set up, after relocation.
739 config BOARD_EARLY_INIT_F
740 bool "Call board-specific init before relocation"
742 Some boards need to perform initialisation as soon as possible
743 after boot. With this option, U-Boot calls board_early_init_f()
744 after driver model is ready in the pre-relocation init sequence.
745 Note that the normal serial console is not yet set up, but the
746 debug UART will be available if enabled.
748 config BOARD_EARLY_INIT_R
749 bool "Call board-specific init after relocation"
751 Some boards need to perform initialisation as directly after
752 relocation. With this option, U-Boot calls board_early_init_r()
753 in the post-relocation init sequence.
755 config LAST_STAGE_INIT
756 bool "Call board-specific as last setup step"
758 Some boards need to perform initialisation immediately before control
759 is passed to the command-line interpreter (e.g. for initializations
760 that depend on later phases in the init sequence). With this option,
761 U-Boot calls last_stage_init() before the command-line interpreter is
766 menu "Security support"
769 bool # "Support hashing API (SHA1, SHA256, etc.)"
771 This provides a way to hash data in memory using various supported
772 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
773 and the algorithms it supports are defined in common/hash.c. See
774 also CMD_HASH for command-line access.
777 bool "Build Android Verified Boot operations"
778 depends on LIBAVB && FASTBOOT
779 depends on PARTITION_UUIDS
781 This option enables compilation of bootloader-dependent operations,
782 used by Android Verified Boot 2.0 library (libavb). Includes:
783 * Helpers to process strings in order to build OS bootargs.
784 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
785 * Helpers to alloc/init/free avb ops.
788 bool # "Support hashing API (SHA1, SHA256, etc.)"
790 This provides a way to hash data in memory using various supported
791 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
792 and the algorithms it supports are defined in common/hash.c. See
793 also CMD_HASH for command-line access.
796 bool # "Support hashing API (SHA1, SHA256, etc.)"
798 This provides a way to hash data in memory using various supported
799 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
800 and the algorithms it supports are defined in common/hash.c. See
801 also CMD_HASH for command-line access.
805 menu "Update support"
808 bool "Auto-update using fitImage via TFTP"
811 This option allows performing update of NOR with data in fitImage
814 config UPDATE_TFTP_CNT_MAX
815 int "The number of connection retries during auto-update"
817 depends on UPDATE_TFTP
819 config UPDATE_TFTP_MSEC_MAX
820 int "Delay in mSec to wait for the TFTP server during auto-update"
822 depends on UPDATE_TFTP
825 bool "Android A/B updates"
828 If enabled, adds support for the new Android A/B update model. This
829 allows the bootloader to select which slot to boot from based on the
830 information provided by userspace via the Android boot_ctrl HAL. This
831 allows a bootloader to try a new version of the system but roll back
832 to previous version if the new one didn't boot all the way.
839 bool "Support for a bloblist"
841 This enables support for a bloblist in U-Boot, which can be passed
842 from TPL to SPL to U-Boot proper (and potentially to Linux). The
843 blob list supports multiple binary blobs of data, each with a tag,
844 so that different U-Boot components can store data which can survive
845 through to the next stage of the boot.
848 bool "Support for a bloblist in SPL"
852 This enables a bloblist in SPL. If this is the first part of U-Boot
853 to run, then the bloblist is set up in SPL and passed to U-Boot
854 proper. If TPL also has a bloblist, then SPL uses the one from there.
857 bool "Support for a bloblist in TPL"
861 This enables a bloblist in TPL. The bloblist is set up in TPL and
862 passed to SPL and U-Boot proper.
865 hex "Size of bloblist"
869 Sets the size of the bloblist in bytes. This must include all
870 overhead (alignment, bloblist header, record header). The bloblist
871 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
872 proper), and this sane bloblist is used for subsequent stages.
875 hex "Address of bloblist"
877 default 0xe000 if SANDBOX
879 Sets the address of the bloblist, set up by the first part of U-Boot
880 which runs. Subsequent U-Boot stages typically use the same address.
884 source "common/spl/Kconfig"