6 This is the library functionality to provide a text-based menu of
7 choices for the user to make choices with.
10 bool "Console recording"
12 This provides a way to record console output (and provide console
13 input) through circular buffers. This is mostly useful for testing.
14 Console output is recorded even when the console is silent.
15 To enable console recording, call console_record_reset_enable()
18 config CONSOLE_RECORD_INIT_F
19 bool "Enable console recording during pre-relocation init"
20 depends on CONSOLE_RECORD && SYS_MALLOC_F
23 This option enables console recording during pre-relocation init.
24 CONFIG_SYS_MALLOC_F must be enabled to use this feature.
26 config CONSOLE_RECORD_OUT_SIZE
27 hex "Output buffer size"
28 depends on CONSOLE_RECORD
29 default 0x400 if CONSOLE_RECORD
31 Set the size of the console output buffer. When this fills up, no
32 more data will be recorded until some is removed. The buffer is
33 allocated immediately after the malloc() region is ready.
35 config CONSOLE_RECORD_OUT_SIZE_F
36 hex "Output buffer size before relocation"
37 depends on CONSOLE_RECORD
38 default 0x400 if CONSOLE_RECORD
40 Set the size of the console output buffer before relocation. When
41 this fills up, no more data will be recorded until some is removed.
42 The buffer is allocated immediately after the early malloc() region is
45 config CONSOLE_RECORD_IN_SIZE
46 hex "Input buffer size"
47 depends on CONSOLE_RECORD
48 default 0x100 if CONSOLE_RECORD
50 Set the size of the console input buffer. When this contains data,
51 tstc() and getc() will use this in preference to real device input.
52 The buffer is allocated immediately after the malloc() region is
55 config DISABLE_CONSOLE
56 bool "Add functionality to disable console completely"
58 Disable console (in & out).
61 string "Board specific string to be added to uboot version string"
63 This options adds the board specific name to u-boot version.
70 All Messages with a loglevel smaller than the console loglevel will
71 be compiled in. The loglevels are defined as follows:
82 9 - debug hardware I/O
93 bool "Support a silent console"
95 This option allows the console to be silenced, meaning that no
96 output will appear on the console devices. This is controlled by
97 setting the environment variable 'silent' to a non-empty value.
98 Note this also silences the console when booting Linux.
100 When the console is set up, the variable is checked, and the
101 GD_FLG_SILENT flag is set. Changing the environment variable later
102 will update the flag.
104 config SILENT_U_BOOT_ONLY
105 bool "Only silence the U-Boot console"
106 depends on SILENT_CONSOLE
108 Normally when the U-Boot console is silenced, Linux's console is
109 also silenced (assuming the board boots into Linux). This option
110 allows the linux console to operate normally, even if U-Boot's
113 config SILENT_CONSOLE_UPDATE_ON_SET
114 bool "Changes to the 'silent' environment variable update immediately"
115 depends on SILENT_CONSOLE
116 default y if SILENT_CONSOLE
118 When the 'silent' environment variable is changed, update the
119 console silence flag immediately. This allows 'setenv' to be used
120 to silence or un-silence the console.
122 The effect is that any change to the variable will affect the
125 config SILENT_CONSOLE_UPDATE_ON_RELOC
126 bool "Allow flags to take effect on relocation"
127 depends on SILENT_CONSOLE
129 In some cases the environment is not available until relocation
130 (e.g. NAND). This option makes the value of the 'silent'
131 environment variable take effect at relocation.
133 config PRE_CONSOLE_BUFFER
134 bool "Buffer characters before the console is available"
136 Prior to the console being initialised (i.e. serial UART
137 initialised etc) all console output is silently discarded.
138 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
139 buffer any console messages prior to the console being
140 initialised to a buffer. The buffer is a circular buffer, so
141 if it overflows, earlier output is discarded.
143 Note that this is not currently supported in SPL. It would be
144 useful to be able to share the pre-console buffer with SPL.
146 config PRE_CON_BUF_SZ
147 int "Sets the size of the pre-console buffer"
148 depends on PRE_CONSOLE_BUFFER
151 The size of the pre-console buffer affects how much console output
152 can be held before it overflows and starts discarding earlier
153 output. Normally there is very little output at this early stage,
154 unless debugging is enabled, so allow enough for ~10 lines of
157 This is a useful feature if you are using a video console and
158 want to see the full boot output on the console. Without this
159 option only the post-relocation output will be displayed.
161 config PRE_CON_BUF_ADDR
162 hex "Address of the pre-console buffer"
163 depends on PRE_CONSOLE_BUFFER
164 default 0x2f000000 if ARCH_SUNXI && MACH_SUN9I
165 default 0x4f000000 if ARCH_SUNXI && !MACH_SUN9I
166 default 0x0f000000 if ROCKCHIP_RK3288
167 default 0x0f200000 if ROCKCHIP_RK3399
169 This sets the start address of the pre-console buffer. This must
170 be in available memory and is accessed before relocation and
171 possibly before DRAM is set up. Therefore choose an address
174 We should consider removing this option and allocating the memory
175 in board_init_f_init_reserve() instead.
178 bool "Enable console multiplexing"
179 default y if DM_VIDEO || VIDEO || LCD
181 This allows multiple devices to be used for each console 'file'.
182 For example, stdout can be set to go to serial and video.
183 Similarly, stdin can be set to come from serial and keyboard.
184 Input can be provided from either source. Console multiplexing
185 adds a small amount of size to U-Boot. Changes to the environment
186 variables stdout, stdin and stderr will take effect immediately.
188 config SYS_CONSOLE_IS_IN_ENV
189 bool "Select console devices from the environment"
190 default y if CONSOLE_MUX
192 This allows multiple input/output devices to be set at boot time.
193 For example, if stdout is set to "serial,vidconsole" then output
194 will be sent to both the serial and video devices on boot. The
195 environment variables can be updated after boot to change the
196 input/output devices.
198 config SYS_CONSOLE_OVERWRITE_ROUTINE
199 bool "Allow board control over console overwriting"
201 If this is enabled, and the board-specific function
202 overwrite_console() returns 1, the stdin, stderr and stdout are
203 switched to the serial port, else the settings in the environment
204 are used. If this is not enabled, the console will not be switched
207 config SYS_CONSOLE_ENV_OVERWRITE
208 bool "Update environment variables during console init"
210 The console environment variables (stdout, stdin, stderr) can be
211 used to determine the correct console devices on start-up. This
212 option writes the console devices to these variables on console
213 start-up (after relocation). This causes the environment to be
214 updated to match the console devices actually chosen.
216 config SYS_CONSOLE_INFO_QUIET
217 bool "Don't display the console devices on boot"
219 Normally U-Boot displays the current settings for stdout, stdin
220 and stderr on boot when the post-relocation console is set up.
221 Enable this option to suppress this output. It can be obtained by
222 calling stdio_print_current_devices() from board code.
224 config SYS_STDIO_DEREGISTER
225 bool "Allow deregistering stdio devices"
226 default y if USB_KEYBOARD
228 Generally there is no need to deregister stdio devices since they
229 are never deactivated. But if a stdio device is used which can be
230 removed (for example a USB keyboard) then this option can be
231 enabled to ensure this is handled correctly.
233 config SPL_SYS_STDIO_DEREGISTER
234 bool "Allow deregistering stdio devices in SPL"
236 Generally there is no need to deregister stdio devices since they
237 are never deactivated. But if a stdio device is used which can be
238 removed (for example a USB keyboard) then this option can be
239 enabled to ensure this is handled correctly. This is very rarely
242 config SYS_DEVICE_NULLDEV
243 bool "Enable a null device for stdio"
244 default y if SPLASH_SCREEN || SYS_STDIO_DEREGISTER
246 Enable creation of a "nulldev" stdio device. This allows silent
247 operation of the console by setting stdout to "nulldev". Enable
248 this to use a serial console under board control.
255 bool "Enable logging support"
258 This enables support for logging of status and debug messages. These
259 can be displayed on the console, recorded in a memory buffer, or
260 discarded if not needed. Logging supports various categories and
266 int "Maximum log level to record"
270 This selects the maximum log level that will be recorded. Any value
271 higher than this will be ignored. If possible log statements below
272 this level will be discarded at build time. Levels:
283 9 - debug hardware I/O
285 config LOG_DEFAULT_LEVEL
286 int "Default logging level to display"
287 default LOG_MAX_LEVEL
288 range 0 LOG_MAX_LEVEL
290 This is the default logging level set when U-Boot starts. It can
291 be adjusted later using the 'log level' command. Note that setting
292 this to a value above LOG_MAX_LEVEL will be ineffective, since the
293 higher levels are not compiled in to U-Boot.
304 9 - debug hardware I/O
307 bool "Allow log output to the console"
310 Enables a log driver which writes log records to the console.
311 Generally the console is the serial port or LCD display. Only the
312 log message is shown - other details like level, category, file and
313 line number are omitted.
316 bool "Show source file name in log messages by default"
318 Show the source file name in log messages by default. This value
319 can be overridden using the 'log format' command.
322 bool "Show source line number in log messages by default"
324 Show the source line number in log messages by default. This value
325 can be overridden using the 'log format' command.
328 bool "Show function name in log messages by default"
330 Show the function name in log messages by default. This value can
331 be overridden using the 'log format' command.
334 int "Number of characters to use for function"
337 Sets the field width to use when showing the function. Set this to
338 a larger value if you have lots of long function names, and want
342 bool "Log output to syslog server"
345 Enables a log driver which broadcasts log records via UDP port 514
349 bool "Enable logging support in SPL"
352 This enables support for logging of status and debug messages. These
353 can be displayed on the console, recorded in a memory buffer, or
354 discarded if not needed. Logging supports various categories and
359 config SPL_LOG_MAX_LEVEL
360 int "Maximum log level to record in SPL"
365 This selects the maximum log level that will be recorded. Any value
366 higher than this will be ignored. If possible log statements below
367 this level will be discarded at build time. Levels:
378 9 - debug hardware I/O
380 config SPL_LOG_CONSOLE
381 bool "Allow log output to the console in SPL"
384 Enables a log driver which writes log records to the console.
385 Generally the console is the serial port or LCD display. Only the
386 log message is shown - other details like level, category, file and
387 line number are omitted.
392 bool "Enable logging support in TPL"
395 This enables support for logging of status and debug messages. These
396 can be displayed on the console, recorded in a memory buffer, or
397 discarded if not needed. Logging supports various categories and
402 config TPL_LOG_MAX_LEVEL
403 int "Maximum log level to record in TPL"
408 This selects the maximum log level that will be recorded. Any value
409 higher than this will be ignored. If possible log statements below
410 this level will be discarded at build time. Levels:
421 9 - debug hardware I/O
423 config TPL_LOG_CONSOLE
424 bool "Allow log output to the console in TPL"
427 Enables a log driver which writes log records to the console.
428 Generally the console is the serial port or LCD display. Only the
429 log message is shown - other details like level, category, file and
430 line number are omitted.
434 config LOG_ERROR_RETURN
435 bool "Log all functions which return an error"
437 When an error is returned in U-Boot it is sometimes difficult to
438 figure out the root cause. For example, reading from SPI flash may
439 fail due to a problem in the SPI controller or due to the flash part
440 not returning the expected information. This option changes
441 log_ret() to log any errors it sees. With this option disabled,
444 You can add log_ret() to all functions which return an error code.
447 bool "Provide a test for logging"
451 This enables a 'log test' command to test logging. It is normally
452 executed from a pytest and simply outputs logging information
453 in various different ways to test that the logging system works
454 correctly with various settings.
463 bool "Call get_board_type() to get and display the board type"
465 If this option is enabled, checkboard() will call get_board_type()
466 to get a string containing the board type and this will be
467 displayed immediately after the model is shown on the console
470 config DISPLAY_CPUINFO
471 bool "Display information about the CPU during start up"
472 default y if ARC|| ARM || NIOS2 || X86 || XTENSA || M68K
474 Display information about the CPU that U-Boot is running on
475 when U-Boot starts up. The function print_cpuinfo() is called
478 config DISPLAY_BOARDINFO
479 bool "Display information about the board during early start up"
480 default y if ARC || ARM || M68K || MIPS || PPC || SANDBOX || XTENSA
482 Display information about the board that U-Boot is running on
483 when U-Boot starts up. The board function checkboard() is called
486 config DISPLAY_BOARDINFO_LATE
487 bool "Display information about the board during late start up"
489 Display information about the board that U-Boot is running on after
490 the relocation phase. The board function checkboard() is called to do
493 menu "Start-up hooks"
496 bool "General-purpose event-handling mechanism"
499 This enables sending and processing of events, to allow interested
500 parties to be alerted when something happens. This is an attempt to
501 step the flow of weak functions, hooks, functions in board_f.c
502 and board_r.c and the Kconfig options below.
504 See doc/develop/event.rst for more information.
509 bool "Support event registration at runtime"
512 Enable this to support adding an event spy at runtime, without adding
513 it to the EVENT_SPy() linker list. This increases code size slightly
514 but provides more flexibility for boards and subsystems that need it.
517 bool "Enable event debugging assistance"
520 Enable this get usefui features for seeing what is happening with
521 events, such as event-type names. This adds to the code size of
522 U-Boot so can be turned off for production builds.
526 config ARCH_EARLY_INIT_R
527 bool "Call arch-specific init soon after relocation"
529 With this option U-Boot will call arch_early_init_r() soon after
530 relocation. Driver model is running by this point, and the cache
531 is on. Note that board_early_init_r() is called first, if
532 enabled. This can be used to set up architecture-specific devices.
534 config ARCH_MISC_INIT
535 bool "Call arch-specific init after relocation, when console is ready"
537 With this option U-Boot will call arch_misc_init() after
538 relocation to allow miscellaneous arch-dependent initialisation
539 to be performed. This function should be defined by the board
540 and will be called after the console is set up, after relocation.
542 config BOARD_EARLY_INIT_F
543 bool "Call board-specific init before relocation"
545 Some boards need to perform initialisation as soon as possible
546 after boot. With this option, U-Boot calls board_early_init_f()
547 after driver model is ready in the pre-relocation init sequence.
548 Note that the normal serial console is not yet set up, but the
549 debug UART will be available if enabled.
551 config BOARD_EARLY_INIT_R
552 bool "Call board-specific init after relocation"
554 Some boards need to perform initialisation as directly after
555 relocation. With this option, U-Boot calls board_early_init_r()
556 in the post-relocation init sequence.
558 config BOARD_POSTCLK_INIT
559 bool "Call board_postclk_init"
561 Some boards need this to initialize select items, after clocks /
562 timebase and before env / serial.
564 config BOARD_LATE_INIT
565 bool "Execute Board late init"
567 Sometimes board require some initialization code that might
568 require once the actual init done, example saving board specific env,
569 boot-modes etc. which eventually done at late.
571 So this config enable the late init code with the help of board_late_init
572 function which should defined on respective boards.
575 bool "Call set_cpu_clk_info"
580 depends on ARCH_LS1021A || FSL_LSCH2 || FSL_LSCH3 || \
581 (FSL_ESDHC_IMX && (ARCH_MX5 || ARCH_MX6 || ARCH_MX7))
584 Enable to call get_clocks() in board_init_f() for platforms other
585 than PowerPC or M68k. This is a legacy option. If not TARGET_BRPPT2
587 config LAST_STAGE_INIT
588 bool "Call board-specific as last setup step"
590 Some boards need to perform initialisation immediately before control
591 is passed to the command-line interpreter (e.g. for initializations
592 that depend on later phases in the init sequence). With this option,
593 U-Boot calls last_stage_init() before the command-line interpreter is
597 bool "Execute Misc Init"
598 default y if ARCH_KEYSTONE || ARCH_SUNXI || MPC85xx
599 default y if ARCH_OMAP2PLUS && !AM33XX
601 Enabling this option calls 'misc_init_r' function
604 bool "Enable I2C connected system identifier EEPROM"
606 A number of different systems and vendors enable a vendor-specified
607 EEPROM that contains various identifying features.
610 bool "Enumerate PCI buses during init"
613 With this option U-Boot will call pci_init() soon after relocation,
614 which will enumerate PCI buses. This is needed, for instance, in the
615 case of DM PCI-based Ethernet devices, which will not be detected
616 without having the enumeration performed earlier.
619 bool "Reset ethernet PHY during init"
621 Implement reset_phy() in board code if required to reset the ethernet
626 endmenu # Init options
628 menu "Security support"
631 bool # "Support hashing API (SHA1, SHA256, etc.)"
633 This provides a way to hash data in memory using various supported
634 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
635 and the algorithms it supports are defined in common/hash.c. See
636 also CMD_HASH for command-line access.
639 bool "Build Android Verified Boot operations"
642 depends on PARTITION_UUIDS
644 This option enables compilation of bootloader-dependent operations,
645 used by Android Verified Boot 2.0 library (libavb). Includes:
646 * Helpers to process strings in order to build OS bootargs.
647 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
648 * Helpers to alloc/init/free avb ops.
653 hex "Define AVB buffer address"
654 default FASTBOOT_BUF_ADDR
656 AVB requires a buffer for memory transactions. This variable defines the
660 hex "Define AVB buffer SIZE"
661 default FASTBOOT_BUF_SIZE
663 AVB requires a buffer for memory transactions. This variable defines the
669 bool "Build SCP03 - Secure Channel Protocol O3 - controls"
670 depends on OPTEE || SANDBOX
673 This option allows U-Boot to enable and or provision SCP03 on an OPTEE
674 controlled Secured Element.
677 bool # "Support hashing API (SHA1, SHA256, etc.)"
679 This provides a way to hash data in memory using various supported
680 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
681 and the algorithms it supports are defined in common/hash.c. See
682 also CMD_HASH for command-line access.
685 bool # "Support hashing API (SHA1, SHA256, etc.)"
687 This provides a way to hash data in memory using various supported
688 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
689 and the algorithms it supports are defined in common/hash.c. See
690 also CMD_HASH for command-line access.
692 config STACKPROTECTOR
693 bool "Stack Protector buffer overflow detection"
695 Enable stack smash detection through compiler's stack-protector
698 config SPL_STACKPROTECTOR
699 bool "Stack Protector buffer overflow detection for SPL"
700 depends on STACKPROTECTOR && SPL
702 config TPL_STACKPROTECTOR
703 bool "Stack Protector buffer overflow detection for TPL"
704 depends on STACKPROTECTOR && TPL
708 menu "Update support"
715 bool "Auto-update using fitImage via TFTP"
719 This option allows performing update of NOR with data in fitImage
722 config UPDATE_TFTP_CNT_MAX
723 int "The number of connection retries during auto-update"
725 depends on UPDATE_TFTP
727 config UPDATE_TFTP_MSEC_MAX
728 int "Delay in mSec to wait for the TFTP server during auto-update"
730 depends on UPDATE_TFTP
733 bool "Firmware update using fitImage"
738 This option allows performing update of DFU-capable storage with
742 bool "Android A/B updates"
744 If enabled, adds support for the new Android A/B update model. This
745 allows the bootloader to select which slot to boot from based on the
746 information provided by userspace via the Android boot_ctrl HAL. This
747 allows a bootloader to try a new version of the system but roll back
748 to previous version if the new one didn't boot all the way.
755 bool "Support for a bloblist"
757 This enables support for a bloblist in U-Boot, which can be passed
758 from TPL to SPL to U-Boot proper (and potentially to Linux). The
759 blob list supports multiple binary blobs of data, each with a tag,
760 so that different U-Boot components can store data which can survive
761 through to the next phase of the boot.
764 bool "Support for a bloblist in SPL"
768 This enables a bloblist in SPL. If this is the first part of U-Boot
769 to run, then the bloblist is set up in SPL and passed to U-Boot
770 proper. If TPL also has a bloblist, then SPL uses the one from there.
773 bool "Support for a bloblist in TPL"
777 This enables a bloblist in TPL. The bloblist is set up in TPL and
778 passed to SPL and U-Boot proper.
783 prompt "Bloblist location"
785 Select the location of the bloblist, via various means.
787 config BLOBLIST_FIXED
788 bool "Place bloblist at a fixed address in memory"
790 Select this to used a fixed memory address for the bloblist. If the
791 bloblist exists at this address from a previous phase, it used as is.
792 If not it is created at this address in U-Boot.
794 config BLOBLIST_ALLOC
795 bool "Allocate bloblist"
797 Allocate the bloblist using malloc(). This avoids the need to
798 specify a fixed address on systems where this is unknown or can
804 hex "Address of bloblist"
805 default 0xc000 if SANDBOX
806 depends on BLOBLIST_FIXED
808 Sets the address of the bloblist, set up by the first part of U-Boot
809 which runs. Subsequent U-Boot phases typically use the same address.
811 This is not used if BLOBLIST_ALLOC is selected.
814 hex "Size of bloblist"
817 Sets the size of the bloblist in bytes. This must include all
818 overhead (alignment, bloblist header, record header). The bloblist
819 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
820 proper), and this sane bloblist is used for subsequent phases.
822 config BLOBLIST_SIZE_RELOC
823 hex "Size of bloblist after relocation"
824 default BLOBLIST_SIZE if BLOBLIST_FIXED || BLOBLIST_ALLOC
825 default 0 if BLOBLIST_PASSAGE
827 Sets the size of the bloblist in bytes after relocation. Since U-Boot
828 has a lot more memory available then, it is possible to use a larger
829 size than the one set up by SPL. This bloblist is set up during the
837 prompt "Bloblist location in SPL"
839 Select the location of the bloblist, via various means. Typically
840 you should use the same value for SPL as for U-Boot, since they need
841 to look in the same place. But if BLOBLIST_ALLOC is used, then a
842 fresh bloblist will be created each time, since there is no shared
843 address (between phases) for the bloblist.
845 config SPL_BLOBLIST_FIXED
846 bool "Place bloblist at a fixed address in memory"
848 Select this to used a fixed memory address for the bloblist. If the
849 bloblist exists at this address from a previous phase, it used as is.
850 If not it is created at this address in SPL.
852 config SPL_BLOBLIST_ALLOC
853 bool "Allocate bloblist"
855 Allocate the bloblist using malloc(). This avoids the need to
856 specify a fixed address on systems where this is unknown or can
866 prompt "Bloblist location in TPL"
868 Select the location of the bloblist, via various means. Typically
869 you should use the same value for SPL as for U-Boot, since they need
870 to look in the same place. But if BLOBLIST_ALLOC is used, then a
871 fresh bloblist will be created each time, since there is no shared
872 address (between phases) for the bloblist.
874 config TPL_BLOBLIST_FIXED
875 bool "Place bloblist at a fixed address in memory"
877 Select this to used a fixed memory address for the bloblist. If the
878 bloblist exists at this address from a previous phase, it used as is.
879 If not it is created at this address in TPL.
881 config TPL_BLOBLIST_ALLOC
882 bool "Allocate bloblist"
884 Allocate the bloblist using malloc(). This avoids the need to
885 specify a fixed address on systems where this is unknown or can
894 source "common/spl/Kconfig"
896 config IMAGE_SIGN_INFO
901 Enable image_sign_info helper functions.
905 config SPL_IMAGE_SIGN_INFO
910 Enable image_sign_info helper functions in SPL.
915 bool "FDT tools for simplefb support"
918 Enable the fdt tools to manage the simple fb nodes in device tree.
919 These functions can be used by board to indicate to the OS
920 the presence of the simple frame buffer with associated reserved