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.
73 bool "Store boot timing information in the OS device tree"
76 Stash the bootstage information in the FDT. A root 'bootstage'
77 node is created with each bootstage id as a child. Each child
78 has a 'name' property and either 'mark' containing the
79 mark time in microseconds, or 'accum' containing the
80 accumulated time for that bootstage id in microseconds.
85 name = "board_init_f";
94 Code in the Linux kernel can find this in /proc/devicetree.
96 config BOOTSTAGE_STASH
97 bool "Stash the boot timing information in memory before booting OS"
100 Some OSes do not support device tree. Bootstage can instead write
101 the boot timing information in a binary format at a given address.
102 This happens through a call to bootstage_stash(), typically in
103 the CPU's cleanup_before_linux() function. You can use the
104 'bootstage stash' and 'bootstage unstash' commands to do this on
107 config BOOTSTAGE_STASH_ADDR
108 hex "Address to stash boot timing information"
111 Provide an address which will not be overwritten by the OS when it
112 starts, so that it can read this information when ready.
114 config BOOTSTAGE_STASH_SIZE
115 hex "Size of boot timing stash region"
118 This should be large enough to hold the bootstage stash. A value of
119 4096 (4KiB) is normally plenty.
126 bool "Support for booting from NOR flash"
129 Enabling this will make a U-Boot binary that is capable of being
130 booted via NOR. In this case we will enable certain pinmux early
131 as the ROM only partially sets up pinmux. We also default to using
135 bool "Support for booting from NAND flash"
139 Enabling this will make a U-Boot binary that is capable of being
140 booted via NAND flash. This is not a must, some SoCs need this,
144 bool "Support for booting from ONENAND"
148 Enabling this will make a U-Boot binary that is capable of being
149 booted via ONENAND. This is not a must, some SoCs need this,
153 bool "Support for booting from QSPI flash"
156 Enabling this will make a U-Boot binary that is capable of being
157 booted via QSPI flash. This is not a must, some SoCs need this,
161 bool "Support for booting from SATA"
164 Enabling this will make a U-Boot binary that is capable of being
165 booted via SATA. This is not a must, some SoCs need this,
169 bool "Support for booting from SD/EMMC"
172 Enabling this will make a U-Boot binary that is capable of being
173 booted via SD/EMMC. This is not a must, some SoCs need this,
177 bool "Support for booting from SPI flash"
180 Enabling this will make a U-Boot binary that is capable of being
181 booted via SPI flash. This is not a must, some SoCs need this,
187 int "delay in seconds before automatically booting"
191 Delay before automatically running bootcmd;
192 set to 0 to autoboot with no delay, but you can stop it by key input.
193 set to -1 to disable autoboot.
194 set to -2 to autoboot with no delay and not check for abort
196 If this value is >= 0 then it is also used for the default delay
197 before starting the default entry in bootmenu. If it is < 0 then
198 a default value of 10s is used.
200 See doc/README.autoboot for details.
203 bool "Enable boot arguments"
205 Provide boot arguments to bootm command. Boot arguments are specified
206 in CONFIG_BOOTARGS option. Enable this option to be able to specify
207 CONFIG_BOOTARGS string. If this option is disabled, CONFIG_BOOTARGS
208 will be undefined and won't take any space in U-Boot image.
211 string "Boot arguments"
212 depends on USE_BOOTARGS
214 This can be used to pass arguments to the bootm command. The value of
215 CONFIG_BOOTARGS goes into the environment value "bootargs". Note that
216 this value will also override the "chosen" node in FDT blob.
218 config USE_BOOTCOMMAND
219 bool "Enable a default value for bootcmd"
221 Provide a default value for the bootcmd entry in the environment. If
222 autoboot is enabled this is what will be run automatically. Enable
223 this option to be able to specify CONFIG_BOOTCOMMAND as a string. If
224 this option is disabled, CONFIG_BOOTCOMMAND will be undefined and
225 won't take any space in U-Boot image.
228 string "bootcmd value"
229 depends on USE_BOOTCOMMAND
230 default "run distro_bootcmd" if DISTRO_DEFAULTS
232 This is the string of commands that will be used as bootcmd and if
233 AUTOBOOT is set, automatically run.
236 bool "Enable preboot"
238 When this option is enabled, the existence of the environment
239 variable "preboot" will be checked immediately before starting the
240 CONFIG_BOOTDELAY countdown and/or running the auto-boot command resp.
241 entering interactive mode.
243 This feature is especially useful when "preboot" is automatically
244 generated or modified. For example, the boot code can modify the
245 "preboot" when a user holds down a certain combination of keys.
248 string "preboot default value"
249 depends on USE_PREBOOT
252 This is the default of "preboot" environment variable.
259 This is the library functionality to provide a text-based menu of
260 choices for the user to make choices with.
262 config CONSOLE_RECORD
263 bool "Console recording"
265 This provides a way to record console output (and provide console
266 input) through circular buffers. This is mostly useful for testing.
267 Console output is recorded even when the console is silent.
268 To enable console recording, call console_record_reset_enable()
271 config CONSOLE_RECORD_OUT_SIZE
272 hex "Output buffer size"
273 depends on CONSOLE_RECORD
274 default 0x400 if CONSOLE_RECORD
276 Set the size of the console output buffer. When this fills up, no
277 more data will be recorded until some is removed. The buffer is
278 allocated immediately after the malloc() region is ready.
280 config CONSOLE_RECORD_IN_SIZE
281 hex "Input buffer size"
282 depends on CONSOLE_RECORD
283 default 0x100 if CONSOLE_RECORD
285 Set the size of the console input buffer. When this contains data,
286 tstc() and getc() will use this in preference to real device input.
287 The buffer is allocated immediately after the malloc() region is
290 config DISABLE_CONSOLE
291 bool "Add functionality to disable console completely"
293 Disable console (in & out).
296 string "Board specific string to be added to uboot version string"
298 This options adds the board specific name to u-boot version.
305 All Messages with a loglevel smaller than the console loglevel will
306 be compiled in. The loglevels are defined as follows:
317 9 - debug hardware I/O
327 config SILENT_CONSOLE
328 bool "Support a silent console"
330 This option allows the console to be silenced, meaning that no
331 output will appear on the console devices. This is controlled by
332 setting the environment variable 'silent' to a non-empty value.
333 Note this also silences the console when booting Linux.
335 When the console is set up, the variable is checked, and the
336 GD_FLG_SILENT flag is set. Changing the environment variable later
337 will update the flag.
339 config SILENT_U_BOOT_ONLY
340 bool "Only silence the U-Boot console"
341 depends on SILENT_CONSOLE
343 Normally when the U-Boot console is silenced, Linux's console is
344 also silenced (assuming the board boots into Linux). This option
345 allows the linux console to operate normally, even if U-Boot's
348 config SILENT_CONSOLE_UPDATE_ON_SET
349 bool "Changes to the 'silent' environment variable update immediately"
350 depends on SILENT_CONSOLE
351 default y if SILENT_CONSOLE
353 When the 'silent' environment variable is changed, update the
354 console silence flag immediately. This allows 'setenv' to be used
355 to silence or un-silence the console.
357 The effect is that any change to the variable will affect the
360 config SILENT_CONSOLE_UPDATE_ON_RELOC
361 bool "Allow flags to take effect on relocation"
362 depends on SILENT_CONSOLE
364 In some cases the environment is not available until relocation
365 (e.g. NAND). This option makes the value of the 'silent'
366 environment variable take effect at relocation.
368 config PRE_CONSOLE_BUFFER
369 bool "Buffer characters before the console is available"
371 Prior to the console being initialised (i.e. serial UART
372 initialised etc) all console output is silently discarded.
373 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
374 buffer any console messages prior to the console being
375 initialised to a buffer. The buffer is a circular buffer, so
376 if it overflows, earlier output is discarded.
378 Note that this is not currently supported in SPL. It would be
379 useful to be able to share the pre-console buffer with SPL.
381 config PRE_CON_BUF_SZ
382 int "Sets the size of the pre-console buffer"
383 depends on PRE_CONSOLE_BUFFER
386 The size of the pre-console buffer affects how much console output
387 can be held before it overflows and starts discarding earlier
388 output. Normally there is very little output at this early stage,
389 unless debugging is enabled, so allow enough for ~10 lines of
392 This is a useful feature if you are using a video console and
393 want to see the full boot output on the console. Without this
394 option only the post-relocation output will be displayed.
396 config PRE_CON_BUF_ADDR
397 hex "Address of the pre-console buffer"
398 depends on PRE_CONSOLE_BUFFER
399 default 0x2f000000 if ARCH_SUNXI && MACH_SUN9I
400 default 0x4f000000 if ARCH_SUNXI && !MACH_SUN9I
402 This sets the start address of the pre-console buffer. This must
403 be in available memory and is accessed before relocation and
404 possibly before DRAM is set up. Therefore choose an address
407 We should consider removing this option and allocating the memory
408 in board_init_f_init_reserve() instead.
411 bool "Enable console multiplexing"
412 default y if DM_VIDEO || VIDEO || LCD
414 This allows multiple devices to be used for each console 'file'.
415 For example, stdout can be set to go to serial and video.
416 Similarly, stdin can be set to come from serial and keyboard.
417 Input can be provided from either source. Console multiplexing
418 adds a small amount of size to U-Boot. Changes to the environment
419 variables stdout, stdin and stderr will take effect immediately.
421 config SYS_CONSOLE_IS_IN_ENV
422 bool "Select console devices from the environment"
423 default y if CONSOLE_MUX
425 This allows multiple input/output devices to be set at boot time.
426 For example, if stdout is set to "serial,video" then output will
427 be sent to both the serial and video devices on boot. The
428 environment variables can be updated after boot to change the
429 input/output devices.
431 config SYS_CONSOLE_OVERWRITE_ROUTINE
432 bool "Allow board control over console overwriting"
434 If this is enabled, and the board-specific function
435 overwrite_console() returns 1, the stdin, stderr and stdout are
436 switched to the serial port, else the settings in the environment
437 are used. If this is not enabled, the console will not be switched
440 config SYS_CONSOLE_ENV_OVERWRITE
441 bool "Update environment variables during console init"
443 The console environment variables (stdout, stdin, stderr) can be
444 used to determine the correct console devices on start-up. This
445 option writes the console devices to these variables on console
446 start-up (after relocation). This causes the environment to be
447 updated to match the console devices actually chosen.
449 config SYS_CONSOLE_INFO_QUIET
450 bool "Don't display the console devices on boot"
452 Normally U-Boot displays the current settings for stdout, stdin
453 and stderr on boot when the post-relocation console is set up.
454 Enable this option to suppress this output. It can be obtained by
455 calling stdio_print_current_devices() from board code.
457 config SYS_STDIO_DEREGISTER
458 bool "Allow deregistering stdio devices"
459 default y if USB_KEYBOARD
461 Generally there is no need to deregister stdio devices since they
462 are never deactivated. But if a stdio device is used which can be
463 removed (for example a USB keyboard) then this option can be
464 enabled to ensure this is handled correctly.
471 bool "Enable logging support"
474 This enables support for logging of status and debug messages. These
475 can be displayed on the console, recorded in a memory buffer, or
476 discarded if not needed. Logging supports various categories and
480 bool "Enable logging support in SPL"
483 This enables support for logging of status and debug messages. These
484 can be displayed on the console, recorded in a memory buffer, or
485 discarded if not needed. Logging supports various categories and
489 bool "Enable logging support in TPL"
492 This enables support for logging of status and debug messages. These
493 can be displayed on the console, recorded in a memory buffer, or
494 discarded if not needed. Logging supports various categories and
498 int "Maximum log level to record"
502 This selects the maximum log level that will be recorded. Any value
503 higher than this will be ignored. If possible log statements below
504 this level will be discarded at build time. Levels:
515 9 - debug hardware I/O
517 config SPL_LOG_MAX_LEVEL
518 int "Maximum log level to record in SPL"
522 This selects the maximum log level that will be recorded. Any value
523 higher than this will be ignored. If possible log statements below
524 this level will be discarded at build time. Levels:
535 9 - debug hardware I/O
537 config TPL_LOG_MAX_LEVEL
538 int "Maximum log level to record in TPL"
542 This selects the maximum log level that will be recorded. Any value
543 higher than this will be ignored. If possible log statements below
544 this level will be discarded at build time. Levels:
555 9 - debug hardware I/O
557 config LOG_DEFAULT_LEVEL
558 int "Default logging level to display"
561 This is the default logging level set when U-Boot starts. It can
562 be adjusted later using the 'log level' command. Note that setting
563 this to a value abnove LOG_MAX_LEVEL will be ineffective, since the
564 higher levels are not compiled in to U-Boot.
575 9 - debug hardware I/O
578 bool "Allow log output to the console"
582 Enables a log driver which writes log records to the console.
583 Generally the console is the serial port or LCD display. Only the
584 log message is shown - other details like level, category, file and
585 line number are omitted.
587 config SPL_LOG_CONSOLE
588 bool "Allow log output to the console in SPL"
592 Enables a log driver which writes log records to the console.
593 Generally the console is the serial port or LCD display. Only the
594 log message is shown - other details like level, category, file and
595 line number are omitted.
597 config TPL_LOG_CONSOLE
598 bool "Allow log output to the console in SPL"
602 Enables a log driver which writes log records to the console.
603 Generally the console is the serial port or LCD display. Only the
604 log message is shown - other details like level, category, file and
605 line number are omitted.
608 bool "Provide a test for logging"
612 This enables a 'log test' command to test logging. It is normally
613 executed from a pytest and simply outputs logging information
614 in various different ways to test that the logging system works
615 correctly with various settings.
617 config LOG_ERROR_RETURN
618 bool "Log all functions which return an error"
621 When an error is returned in U-Boot it is sometimes difficult to
622 figure out the root cause. For example, reading from SPI flash may
623 fail due to a problem in the SPI controller or due to the flash part
624 not returning the expected information. This option changes
625 log_ret() to log any errors it sees. With this option disabled,
628 You can add log_ret() to all functions which return an error code.
632 config SUPPORT_RAW_INITRD
633 bool "Enable raw initrd images"
635 Note, defining the SUPPORT_RAW_INITRD allows user to supply
636 kernel with raw initrd images. The syntax is slightly different, the
637 address of the initrd must be augmented by it's size, in the following
638 format: "<initrd address>:<initrd size>".
640 config DEFAULT_FDT_FILE
641 string "Default fdt file"
643 This option is used to set the default fdt file to boot OS.
646 bool "Execute Misc Init"
647 default y if ARCH_KEYSTONE || ARCH_SUNXI || MPC85xx
648 default y if ARCH_OMAP2PLUS && !AM33XX
650 Enabling this option calls 'misc_init_r' function
652 config VERSION_VARIABLE
653 bool "add U-Boot environment variable vers"
656 If this variable is defined, an environment variable
657 named "ver" is created by U-Boot showing the U-Boot
658 version as printed by the "version" command.
659 Any change to this variable will be reverted at the
662 config BOARD_LATE_INIT
663 bool "Execute Board late init"
665 Sometimes board require some initialization code that might
666 require once the actual init done, example saving board specific env,
667 boot-modes etc. which eventually done at late.
669 So this config enable the late init code with the help of board_late_init
670 function which should defined on respective boards.
672 config DISPLAY_CPUINFO
673 bool "Display information about the CPU during start up"
674 default y if ARC|| ARM || NIOS2 || X86 || XTENSA || M68K
676 Display information about the CPU that U-Boot is running on
677 when U-Boot starts up. The function print_cpuinfo() is called
680 config DISPLAY_BOARDINFO
681 bool "Display information about the board during early start up"
682 default y if ARC || ARM || M68K || MIPS || PPC || SANDBOX || XTENSA
684 Display information about the board that U-Boot is running on
685 when U-Boot starts up. The board function checkboard() is called
688 config DISPLAY_BOARDINFO_LATE
689 bool "Display information about the board during late start up"
691 Display information about the board that U-Boot is running on after
692 the relocation phase. The board function checkboard() is called to do
696 bool "Include bounce buffer API"
698 Some peripherals support DMA from a subset of physically
699 addressable memory only. To support such peripherals, the
700 bounce buffer API uses a temporary buffer: it copies data
701 to/from DMA regions while managing cache operations.
703 A second possible use of bounce buffers is their ability to
704 provide aligned buffers for DMA operations.
707 bool "Call get_board_type() to get and display the board type"
709 If this option is enabled, checkboard() will call get_board_type()
710 to get a string containing the board type and this will be
711 displayed immediately after the model is shown on the console
714 menu "Start-up hooks"
716 config ARCH_EARLY_INIT_R
717 bool "Call arch-specific init soon after relocation"
719 With this option U-Boot will call arch_early_init_r() soon after
720 relocation. Driver model is running by this point, and the cache
721 is on. Note that board_early_init_r() is called first, if
722 enabled. This can be used to set up architecture-specific devices.
724 config ARCH_MISC_INIT
725 bool "Call arch-specific init after relocation, when console is ready"
727 With this option U-Boot will call arch_misc_init() after
728 relocation to allow miscellaneous arch-dependent initialisation
729 to be performed. This function should be defined by the board
730 and will be called after the console is set up, after relocation.
732 config BOARD_EARLY_INIT_F
733 bool "Call board-specific init before relocation"
735 Some boards need to perform initialisation as soon as possible
736 after boot. With this option, U-Boot calls board_early_init_f()
737 after driver model is ready in the pre-relocation init sequence.
738 Note that the normal serial console is not yet set up, but the
739 debug UART will be available if enabled.
741 config BOARD_EARLY_INIT_R
742 bool "Call board-specific init after relocation"
744 Some boards need to perform initialisation as directly after
745 relocation. With this option, U-Boot calls board_early_init_r()
746 in the post-relocation init sequence.
748 config LAST_STAGE_INIT
749 bool "Call board-specific as last setup step"
751 Some boards need to perform initialisation immediately before control
752 is passed to the command-line interpreter (e.g. for initializations
753 that depend on later phases in the init sequence). With this option,
754 U-Boot calls last_stage_init() before the command-line interpreter is
759 menu "Security support"
762 bool # "Support hashing API (SHA1, SHA256, etc.)"
764 This provides a way to hash data in memory using various supported
765 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
766 and the algorithms it supports are defined in common/hash.c. See
767 also CMD_HASH for command-line access.
770 bool "Build Android Verified Boot operations"
771 depends on LIBAVB && FASTBOOT
772 depends on PARTITION_UUIDS
774 This option enables compilation of bootloader-dependent operations,
775 used by Android Verified Boot 2.0 library (libavb). Includes:
776 * Helpers to process strings in order to build OS bootargs.
777 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
778 * Helpers to alloc/init/free avb ops.
781 bool # "Support hashing API (SHA1, SHA256, etc.)"
783 This provides a way to hash data in memory using various supported
784 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
785 and the algorithms it supports are defined in common/hash.c. See
786 also CMD_HASH for command-line access.
789 bool # "Support hashing API (SHA1, SHA256, etc.)"
791 This provides a way to hash data in memory using various supported
792 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
793 and the algorithms it supports are defined in common/hash.c. See
794 also CMD_HASH for command-line access.
798 menu "Update support"
801 bool "Auto-update using fitImage via TFTP"
804 This option allows performing update of NOR with data in fitImage
807 config UPDATE_TFTP_CNT_MAX
808 int "The number of connection retries during auto-update"
810 depends on UPDATE_TFTP
812 config UPDATE_TFTP_MSEC_MAX
813 int "Delay in mSec to wait for the TFTP server during auto-update"
815 depends on UPDATE_TFTP
822 bool "Support for a bloblist"
824 This enables support for a bloblist in U-Boot, which can be passed
825 from TPL to SPL to U-Boot proper (and potentially to Linux). The
826 blob list supports multiple binary blobs of data, each with a tag,
827 so that different U-Boot components can store data which can survive
828 through to the next stage of the boot.
831 bool "Support for a bloblist in SPL"
835 This enables a bloblist in SPL. If this is the first part of U-Boot
836 to run, then the bloblist is set up in SPL and passed to U-Boot
837 proper. If TPL also has a bloblist, then SPL uses the one from there.
840 bool "Support for a bloblist in TPL"
844 This enables a bloblist in TPL. The bloblist is set up in TPL and
845 passed to SPL and U-Boot proper.
848 hex "Size of bloblist"
852 Sets the size of the bloblist in bytes. This must include all
853 overhead (alignment, bloblist header, record header). The bloblist
854 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
855 proper), and this sane bloblist is used for subsequent stages.
858 hex "Address of bloblist"
860 default 0xe000 if SANDBOX
862 Sets the address of the bloblist, set up by the first part of U-Boot
863 which runs. Subsequent U-Boot stages typically use the same address.
867 source "common/spl/Kconfig"