blob: 21434c5cf16a7e1ba06d6cdbca625826a654fb1b [file] [log] [blame]
Simon Glass98af8792016-10-17 20:12:35 -06001menu "Console"
2
Tom Rini4880b022016-11-29 09:14:56 -05003config MENU
4 bool
5 help
6 This is the library functionality to provide a text-based menu of
7 choices for the user to make choices with.
8
Simon Glass9854a872015-11-08 23:47:48 -07009config CONSOLE_RECORD
10 bool "Console recording"
11 help
12 This provides a way to record console output (and provide console
Robert P. J. Day57247d92016-08-31 12:49:13 -040013 input) through circular buffers. This is mostly useful for testing.
Simon Glass9854a872015-11-08 23:47:48 -070014 Console output is recorded even when the console is silent.
15 To enable console recording, call console_record_reset_enable()
16 from your code.
17
Ovidiu Panait4e819202020-11-28 10:43:03 +020018config CONSOLE_RECORD_INIT_F
19 bool "Enable console recording during pre-relocation init"
20 depends on CONSOLE_RECORD && SYS_MALLOC_F
21 default y
22 help
23 This option enables console recording during pre-relocation init.
24 CONFIG_SYS_MALLOC_F must be enabled to use this feature.
25
Simon Glass9854a872015-11-08 23:47:48 -070026config CONSOLE_RECORD_OUT_SIZE
27 hex "Output buffer size"
28 depends on CONSOLE_RECORD
29 default 0x400 if CONSOLE_RECORD
30 help
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.
34
Simon Glass8ce465e2021-10-23 17:26:03 -060035config CONSOLE_RECORD_OUT_SIZE_F
36 hex "Output buffer size before relocation"
37 depends on CONSOLE_RECORD
38 default 0x400 if CONSOLE_RECORD
39 help
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
43 ready.
44
Simon Glass9854a872015-11-08 23:47:48 -070045config CONSOLE_RECORD_IN_SIZE
46 hex "Input buffer size"
47 depends on CONSOLE_RECORD
48 default 0x100 if CONSOLE_RECORD
49 help
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
53 ready.
Siva Durga Prasad Paladugu4d255072016-07-19 10:42:22 +053054
Christian Gmeiner83f6f602018-09-10 12:43:16 +020055config DISABLE_CONSOLE
56 bool "Add functionality to disable console completely"
57 help
58 Disable console (in & out).
59
Siva Durga Prasad Paladugua4d88922016-07-29 15:31:47 +053060config IDENT_STRING
61 string "Board specific string to be added to uboot version string"
62 help
63 This options adds the board specific name to u-boot version.
64
Masahiro Yamadab44b3022017-09-16 14:10:40 +090065config LOGLEVEL
66 int "loglevel"
Tom Rini6a3e65d2017-10-04 16:44:30 -040067 default 4
Marek Bykowski2aa69c92020-02-03 11:43:32 +010068 range 0 10
Masahiro Yamadab44b3022017-09-16 14:10:40 +090069 help
70 All Messages with a loglevel smaller than the console loglevel will
71 be compiled in. The loglevels are defined as follows:
72
Simon Glass6fc7e932019-02-16 20:24:34 -070073 0 - emergency
74 1 - alert
75 2 - critical
76 3 - error
77 4 - warning
78 5 - note
79 6 - info
80 7 - debug
81 8 - debug content
82 9 - debug hardware I/O
Masahiro Yamadab44b3022017-09-16 14:10:40 +090083
84config SPL_LOGLEVEL
85 int
Tom Rinib3401992022-06-10 23:03:09 -040086 depends on SPL
Masahiro Yamadab44b3022017-09-16 14:10:40 +090087 default LOGLEVEL
88
Simon Glass4d8d3052018-11-15 18:43:49 -070089config TPL_LOGLEVEL
90 int
Tom Rini8bea4bf2022-06-08 08:24:39 -040091 depends on TPL
Simon Glass4d8d3052018-11-15 18:43:49 -070092 default LOGLEVEL
93
Simon Glass747093d2022-04-30 00:56:53 -060094config VPL_LOGLEVEL
95 int "loglevel for VPL"
Tom Rini13ce3512022-06-08 08:24:40 -040096 depends on VPL
Simon Glass747093d2022-04-30 00:56:53 -060097 default LOGLEVEL
98 help
99 All Messages with a loglevel smaller than the console loglevel will
100 be compiled in to VPL. See LOGLEVEL for a list of available log
101 levels. Setting this to a value above 4 may increase the code size
102 significantly.
103
Simon Glass98af8792016-10-17 20:12:35 -0600104config SILENT_CONSOLE
105 bool "Support a silent console"
106 help
107 This option allows the console to be silenced, meaning that no
108 output will appear on the console devices. This is controlled by
Chris Packhamf7597732019-01-11 15:30:50 +1300109 setting the environment variable 'silent' to a non-empty value.
Simon Glass98af8792016-10-17 20:12:35 -0600110 Note this also silences the console when booting Linux.
111
112 When the console is set up, the variable is checked, and the
113 GD_FLG_SILENT flag is set. Changing the environment variable later
114 will update the flag.
115
Simon Glass6e55b112022-10-20 18:22:43 -0600116config SPL_SILENT_CONSOLE
117 bool "Use a silent console in SPL"
118 default y if SILENT_CONSOLE && !SANDBOX
119 help
120 This selects a silent console in SPL. When enabled it drops some
121 output messages. The GD_FLG_SILENT flag is not used in SPL so there
122 is no run-time control of console messages in SPL.
123
124 Future work may allow the SPL console to be silenced completely using
125 this option.
126
127config TPL_SILENT_CONSOLE
128 bool "Use a silent console in TPL"
129 default y if SILENT_CONSOLE && !SANDBOX
130 help
131 This selects a silent console in TPL. When enabled it drops some
132 output messages. The GD_FLG_SILENT flag is not used in TPL so there
133 is no run-time control of console messages in TPL.
134
135 Future work may allow the TPL console to be silenced completely using
136 this option.
137
Simon Glass98af8792016-10-17 20:12:35 -0600138config SILENT_U_BOOT_ONLY
139 bool "Only silence the U-Boot console"
140 depends on SILENT_CONSOLE
141 help
142 Normally when the U-Boot console is silenced, Linux's console is
143 also silenced (assuming the board boots into Linux). This option
144 allows the linux console to operate normally, even if U-Boot's
145 is silenced.
146
147config SILENT_CONSOLE_UPDATE_ON_SET
148 bool "Changes to the 'silent' environment variable update immediately"
149 depends on SILENT_CONSOLE
150 default y if SILENT_CONSOLE
151 help
152 When the 'silent' environment variable is changed, update the
153 console silence flag immediately. This allows 'setenv' to be used
154 to silence or un-silence the console.
155
156 The effect is that any change to the variable will affect the
157 GD_FLG_SILENT flag.
158
159config SILENT_CONSOLE_UPDATE_ON_RELOC
160 bool "Allow flags to take effect on relocation"
161 depends on SILENT_CONSOLE
162 help
163 In some cases the environment is not available until relocation
164 (e.g. NAND). This option makes the value of the 'silent'
165 environment variable take effect at relocation.
166
Simon Glass8f925582016-10-17 20:12:36 -0600167config PRE_CONSOLE_BUFFER
168 bool "Buffer characters before the console is available"
169 help
170 Prior to the console being initialised (i.e. serial UART
171 initialised etc) all console output is silently discarded.
172 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
173 buffer any console messages prior to the console being
174 initialised to a buffer. The buffer is a circular buffer, so
175 if it overflows, earlier output is discarded.
176
177 Note that this is not currently supported in SPL. It would be
178 useful to be able to share the pre-console buffer with SPL.
179
180config PRE_CON_BUF_SZ
181 int "Sets the size of the pre-console buffer"
182 depends on PRE_CONSOLE_BUFFER
183 default 4096
184 help
185 The size of the pre-console buffer affects how much console output
186 can be held before it overflows and starts discarding earlier
187 output. Normally there is very little output at this early stage,
188 unless debugging is enabled, so allow enough for ~10 lines of
189 text.
190
191 This is a useful feature if you are using a video console and
192 want to see the full boot output on the console. Without this
193 option only the post-relocation output will be displayed.
194
195config PRE_CON_BUF_ADDR
196 hex "Address of the pre-console buffer"
197 depends on PRE_CONSOLE_BUFFER
198 default 0x2f000000 if ARCH_SUNXI && MACH_SUN9I
199 default 0x4f000000 if ARCH_SUNXI && !MACH_SUN9I
Jagan Teki38070172020-01-23 19:42:19 +0530200 default 0x0f000000 if ROCKCHIP_RK3288
Jagan Teki61853a72020-04-02 17:11:23 +0530201 default 0x0f200000 if ROCKCHIP_RK3399
Simon Glass8f925582016-10-17 20:12:36 -0600202 help
203 This sets the start address of the pre-console buffer. This must
204 be in available memory and is accessed before relocation and
205 possibly before DRAM is set up. Therefore choose an address
206 carefully.
207
208 We should consider removing this option and allocating the memory
209 in board_init_f_init_reserve() instead.
210
Pali Rohár974f4832022-09-05 11:31:17 +0200211config CONSOLE_FLUSH_SUPPORT
212 bool "Enable console flush support"
213 default y
214 help
215 This enables compilation of flush() function for console flush support.
216
Simon Glassef26d602016-10-17 20:12:37 -0600217config CONSOLE_MUX
218 bool "Enable console multiplexing"
Simon Glassb86986c2022-10-18 07:46:31 -0600219 default y if VIDEO || VIDEO || LCD
Simon Glassef26d602016-10-17 20:12:37 -0600220 help
221 This allows multiple devices to be used for each console 'file'.
222 For example, stdout can be set to go to serial and video.
223 Similarly, stdin can be set to come from serial and keyboard.
224 Input can be provided from either source. Console multiplexing
225 adds a small amount of size to U-Boot. Changes to the environment
226 variables stdout, stdin and stderr will take effect immediately.
227
228config SYS_CONSOLE_IS_IN_ENV
229 bool "Select console devices from the environment"
230 default y if CONSOLE_MUX
231 help
232 This allows multiple input/output devices to be set at boot time.
Anatolij Gustschinde99e772021-10-04 16:04:32 +0200233 For example, if stdout is set to "serial,vidconsole" then output
234 will be sent to both the serial and video devices on boot. The
Simon Glassef26d602016-10-17 20:12:37 -0600235 environment variables can be updated after boot to change the
236 input/output devices.
237
Simon Glass84f2a5d2016-10-17 20:12:59 -0600238config SYS_CONSOLE_OVERWRITE_ROUTINE
239 bool "Allow board control over console overwriting"
240 help
241 If this is enabled, and the board-specific function
242 overwrite_console() returns 1, the stdin, stderr and stdout are
243 switched to the serial port, else the settings in the environment
244 are used. If this is not enabled, the console will not be switched
245 to serial.
246
Simon Glass3505bc52016-10-17 20:12:58 -0600247config SYS_CONSOLE_ENV_OVERWRITE
248 bool "Update environment variables during console init"
249 help
250 The console environment variables (stdout, stdin, stderr) can be
251 used to determine the correct console devices on start-up. This
252 option writes the console devices to these variables on console
253 start-up (after relocation). This causes the environment to be
254 updated to match the console devices actually chosen.
255
Simon Glassf3f3eff2016-10-17 20:13:00 -0600256config SYS_CONSOLE_INFO_QUIET
257 bool "Don't display the console devices on boot"
258 help
259 Normally U-Boot displays the current settings for stdout, stdin
260 and stderr on boot when the post-relocation console is set up.
Chris Packhamf7597732019-01-11 15:30:50 +1300261 Enable this option to suppress this output. It can be obtained by
Simon Glassf3f3eff2016-10-17 20:13:00 -0600262 calling stdio_print_current_devices() from board code.
263
Simon Glass869588d2016-10-17 20:13:02 -0600264config SYS_STDIO_DEREGISTER
265 bool "Allow deregistering stdio devices"
266 default y if USB_KEYBOARD
267 help
268 Generally there is no need to deregister stdio devices since they
269 are never deactivated. But if a stdio device is used which can be
270 removed (for example a USB keyboard) then this option can be
271 enabled to ensure this is handled correctly.
272
Simon Glass7e156382020-08-11 11:23:36 -0600273config SPL_SYS_STDIO_DEREGISTER
274 bool "Allow deregistering stdio devices in SPL"
275 help
276 Generally there is no need to deregister stdio devices since they
277 are never deactivated. But if a stdio device is used which can be
278 removed (for example a USB keyboard) then this option can be
279 enabled to ensure this is handled correctly. This is very rarely
280 needed in SPL.
281
282config SYS_DEVICE_NULLDEV
283 bool "Enable a null device for stdio"
Simon Glass3ca06092020-08-11 11:23:37 -0600284 default y if SPLASH_SCREEN || SYS_STDIO_DEREGISTER
Simon Glass7e156382020-08-11 11:23:36 -0600285 help
286 Enable creation of a "nulldev" stdio device. This allows silent
287 operation of the console by setting stdout to "nulldev". Enable
288 this to use a serial console under board control.
289
Simon Glass98af8792016-10-17 20:12:35 -0600290endmenu
291
Simon Glasse9c8d492017-12-04 13:48:24 -0700292menu "Logging"
293
294config LOG
295 bool "Enable logging support"
Michal Simek563273d2018-07-23 15:55:11 +0200296 depends on DM
Simon Glasse9c8d492017-12-04 13:48:24 -0700297 help
298 This enables support for logging of status and debug messages. These
299 can be displayed on the console, recorded in a memory buffer, or
300 discarded if not needed. Logging supports various categories and
301 levels of severity.
302
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200303if LOG
Simon Glasse9c8d492017-12-04 13:48:24 -0700304
305config LOG_MAX_LEVEL
306 int "Maximum log level to record"
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200307 default 6
308 range 0 9
Simon Glass4d8d3052018-11-15 18:43:49 -0700309 help
310 This selects the maximum log level that will be recorded. Any value
311 higher than this will be ignored. If possible log statements below
312 this level will be discarded at build time. Levels:
313
Simon Glass6fc7e932019-02-16 20:24:34 -0700314 0 - emergency
315 1 - alert
316 2 - critical
317 3 - error
318 4 - warning
319 5 - note
320 6 - info
Simon Glass4d8d3052018-11-15 18:43:49 -0700321 7 - debug
Simon Glass6fc7e932019-02-16 20:24:34 -0700322 8 - debug content
323 9 - debug hardware I/O
Simon Glass4d8d3052018-11-15 18:43:49 -0700324
Simon Glassf0b05c92019-02-16 20:24:35 -0700325config LOG_DEFAULT_LEVEL
326 int "Default logging level to display"
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200327 default LOG_MAX_LEVEL
328 range 0 LOG_MAX_LEVEL
Simon Glassf0b05c92019-02-16 20:24:35 -0700329 help
330 This is the default logging level set when U-Boot starts. It can
331 be adjusted later using the 'log level' command. Note that setting
Andy Shevchenko69264f42019-06-12 15:35:24 +0300332 this to a value above LOG_MAX_LEVEL will be ineffective, since the
Simon Glassf0b05c92019-02-16 20:24:35 -0700333 higher levels are not compiled in to U-Boot.
334
335 0 - emergency
336 1 - alert
337 2 - critical
338 3 - error
339 4 - warning
340 5 - note
341 6 - info
342 7 - debug
343 8 - debug content
344 9 - debug hardware I/O
345
Simon Glassc6d47532017-12-04 13:48:25 -0700346config LOG_CONSOLE
347 bool "Allow log output to the console"
Simon Glassc6d47532017-12-04 13:48:25 -0700348 default y
349 help
350 Enables a log driver which writes log records to the console.
351 Generally the console is the serial port or LCD display. Only the
352 log message is shown - other details like level, category, file and
353 line number are omitted.
354
Heinrich Schuchardt3c21d772020-06-17 21:52:44 +0200355config LOGF_FILE
356 bool "Show source file name in log messages by default"
357 help
358 Show the source file name in log messages by default. This value
359 can be overridden using the 'log format' command.
360
361config LOGF_LINE
362 bool "Show source line number in log messages by default"
363 help
364 Show the source line number in log messages by default. This value
365 can be overridden using the 'log format' command.
366
367config LOGF_FUNC
368 bool "Show function name in log messages by default"
369 help
370 Show the function name in log messages by default. This value can
371 be overridden using the 'log format' command.
372
Simon Glass72fa1ad2021-07-05 16:33:00 -0600373config LOGF_FUNC_PAD
374 int "Number of characters to use for function"
375 default 20
376 help
377 Sets the field width to use when showing the function. Set this to
378 a larger value if you have lots of long function names, and want
379 things to line up.
380
Heinrich Schuchardtbefadde2020-02-26 21:48:16 +0100381config LOG_SYSLOG
382 bool "Log output to syslog server"
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200383 depends on NET
Heinrich Schuchardtbefadde2020-02-26 21:48:16 +0100384 help
385 Enables a log driver which broadcasts log records via UDP port 514
386 to syslog servers.
387
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200388config SPL_LOG
389 bool "Enable logging support in SPL"
Tom Rinib3401992022-06-10 23:03:09 -0400390 depends on LOG && SPL
Simon Glassef11ed82017-12-04 13:48:27 -0700391 help
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200392 This enables support for logging of status and debug messages. These
393 can be displayed on the console, recorded in a memory buffer, or
394 discarded if not needed. Logging supports various categories and
395 levels of severity.
396
397if SPL_LOG
398
399config SPL_LOG_MAX_LEVEL
400 int "Maximum log level to record in SPL"
401 depends on SPL_LOG
402 default 3
403 range 0 9
404 help
405 This selects the maximum log level that will be recorded. Any value
406 higher than this will be ignored. If possible log statements below
407 this level will be discarded at build time. Levels:
408
409 0 - emergency
410 1 - alert
411 2 - critical
412 3 - error
413 4 - warning
414 5 - note
415 6 - info
416 7 - debug
417 8 - debug content
418 9 - debug hardware I/O
419
420config SPL_LOG_CONSOLE
421 bool "Allow log output to the console in SPL"
422 default y
423 help
424 Enables a log driver which writes log records to the console.
425 Generally the console is the serial port or LCD display. Only the
426 log message is shown - other details like level, category, file and
427 line number are omitted.
428
429endif
430
431config TPL_LOG
432 bool "Enable logging support in TPL"
Tom Rini8bea4bf2022-06-08 08:24:39 -0400433 depends on LOG && TPL
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200434 help
435 This enables support for logging of status and debug messages. These
436 can be displayed on the console, recorded in a memory buffer, or
437 discarded if not needed. Logging supports various categories and
438 levels of severity.
439
440if TPL_LOG
441
442config TPL_LOG_MAX_LEVEL
443 int "Maximum log level to record in TPL"
444 depends on TPL_LOG
445 default 3
446 range 0 9
447 help
448 This selects the maximum log level that will be recorded. Any value
449 higher than this will be ignored. If possible log statements below
450 this level will be discarded at build time. Levels:
451
452 0 - emergency
453 1 - alert
454 2 - critical
455 3 - error
456 4 - warning
457 5 - note
458 6 - info
459 7 - debug
460 8 - debug content
461 9 - debug hardware I/O
462
463config TPL_LOG_CONSOLE
464 bool "Allow log output to the console in TPL"
465 default y
466 help
467 Enables a log driver which writes log records to the console.
468 Generally the console is the serial port or LCD display. Only the
469 log message is shown - other details like level, category, file and
470 line number are omitted.
471
472endif
Simon Glassef11ed82017-12-04 13:48:27 -0700473
Simon Glass747093d2022-04-30 00:56:53 -0600474config VPL_LOG
475 bool "Enable logging support in VPL"
Tom Rini13ce3512022-06-08 08:24:40 -0400476 depends on LOG && VPL
Simon Glass747093d2022-04-30 00:56:53 -0600477 help
478 This enables support for logging of status and debug messages. These
479 can be displayed on the console, recorded in a memory buffer, or
480 discarded if not needed. Logging supports various categories and
481 levels of severity.
482
483if VPL_LOG
484
485config VPL_LOG_MAX_LEVEL
486 int "Maximum log level to record in VPL"
487 default 3
488 help
489 This selects the maximum log level that will be recorded. Any value
490 higher than this will be ignored. If possible log statements below
491 this level will be discarded at build time. Levels:
492
493 0 - emergency
494 1 - alert
495 2 - critical
496 3 - error
497 4 - warning
498 5 - note
499 6 - info
500 7 - debug
501 8 - debug content
502 9 - debug hardware I/O
503
504config VPL_LOG_CONSOLE
505 bool "Allow log output to the console in VPL"
506 default y
507 help
508 Enables a log driver which writes log records to the console.
509 Generally the console is the serial port or LCD display. Only the
510 log message is shown - other details like level, category, file and
511 line number are omitted.
512
513endif
514
Simon Glass3707c6e2017-12-28 13:14:23 -0700515config LOG_ERROR_RETURN
516 bool "Log all functions which return an error"
Simon Glass3707c6e2017-12-28 13:14:23 -0700517 help
518 When an error is returned in U-Boot it is sometimes difficult to
Chris Packhamf7597732019-01-11 15:30:50 +1300519 figure out the root cause. For example, reading from SPI flash may
Simon Glass3707c6e2017-12-28 13:14:23 -0700520 fail due to a problem in the SPI controller or due to the flash part
521 not returning the expected information. This option changes
522 log_ret() to log any errors it sees. With this option disabled,
523 log_ret() is a nop.
524
525 You can add log_ret() to all functions which return an error code.
526
Heinrich Schuchardt7b6c34c2020-05-31 15:34:22 +0200527config LOG_TEST
528 bool "Provide a test for logging"
529 depends on UNIT_TEST
530 default y if SANDBOX
531 help
532 This enables a 'log test' command to test logging. It is normally
533 executed from a pytest and simply outputs logging information
534 in various different ways to test that the logging system works
535 correctly with various settings.
536
537endif
538
Simon Glasse9c8d492017-12-04 13:48:24 -0700539endmenu
540
Simon Glass7df39e52020-09-10 20:21:21 -0600541menu "Init options"
542
Simon Glassa4c4ecf2020-09-10 20:21:26 -0600543config BOARD_TYPES
544 bool "Call get_board_type() to get and display the board type"
545 help
546 If this option is enabled, checkboard() will call get_board_type()
547 to get a string containing the board type and this will be
548 displayed immediately after the model is shown on the console
549 early in boot.
550
Lokesh Vutla19a97472016-10-08 14:41:44 -0400551config DISPLAY_CPUINFO
552 bool "Display information about the CPU during start up"
Alexey Brodkinf31414a2018-10-02 11:43:28 +0300553 default y if ARC|| ARM || NIOS2 || X86 || XTENSA || M68K
Lokesh Vutla19a97472016-10-08 14:41:44 -0400554 help
555 Display information about the CPU that U-Boot is running on
556 when U-Boot starts up. The function print_cpuinfo() is called
557 to do this.
558
Lokesh Vutla84351792016-10-11 21:33:46 -0400559config DISPLAY_BOARDINFO
Mario Six78eba692018-03-28 14:38:17 +0200560 bool "Display information about the board during early start up"
Alexey Brodkinf31414a2018-10-02 11:43:28 +0300561 default y if ARC || ARM || M68K || MIPS || PPC || SANDBOX || XTENSA
Lokesh Vutla84351792016-10-11 21:33:46 -0400562 help
563 Display information about the board that U-Boot is running on
564 when U-Boot starts up. The board function checkboard() is called
565 to do this.
566
Mario Six78eba692018-03-28 14:38:17 +0200567config DISPLAY_BOARDINFO_LATE
568 bool "Display information about the board during late start up"
569 help
570 Display information about the board that U-Boot is running on after
571 the relocation phase. The board function checkboard() is called to do
572 this.
573
Simon Glassa4211922017-01-23 13:31:19 -0700574menu "Start-up hooks"
575
Stefan Roesec2c69712022-09-02 13:57:48 +0200576config CYCLIC
577 bool "General-purpose cyclic execution mechanism"
578 help
579 This enables a general-purpose cyclic execution infrastructure,
580 to allow "small" (run-time wise) functions to be executed at
581 a specified frequency. Things like LED blinking or watchdog
582 triggering are examples for such tasks.
583
584if CYCLIC
585
586config CYCLIC_MAX_CPU_TIME_US
587 int "Sets the max allowed time for a cyclic function in us"
588 default 1000
589 help
590 The max allowed time for a cyclic function in us. If a functions
591 takes longer than this duration this function will get unregistered
592 automatically.
593
594endif # CYCLIC
595
Simon Glass87a5d1b2022-03-04 08:43:00 -0700596config EVENT
597 bool "General-purpose event-handling mechanism"
598 default y if SANDBOX
599 help
600 This enables sending and processing of events, to allow interested
601 parties to be alerted when something happens. This is an attempt to
Simon Glassf39e5b82022-09-06 20:26:55 -0600602 stem the flow of weak functions, hooks, functions in board_f.c
Simon Glass87a5d1b2022-03-04 08:43:00 -0700603 and board_r.c and the Kconfig options below.
604
605 See doc/develop/event.rst for more information.
606
607if EVENT
608
609config EVENT_DYNAMIC
610 bool "Support event registration at runtime"
611 default y if SANDBOX
612 help
613 Enable this to support adding an event spy at runtime, without adding
614 it to the EVENT_SPy() linker list. This increases code size slightly
615 but provides more flexibility for boards and subsystems that need it.
616
617config EVENT_DEBUG
618 bool "Enable event debugging assistance"
619 default y if SANDBOX
620 help
621 Enable this get usefui features for seeing what is happening with
622 events, such as event-type names. This adds to the code size of
623 U-Boot so can be turned off for production builds.
624
625endif # EVENT
626
Simon Glassa4211922017-01-23 13:31:19 -0700627config ARCH_EARLY_INIT_R
628 bool "Call arch-specific init soon after relocation"
Simon Glassa4211922017-01-23 13:31:19 -0700629 help
630 With this option U-Boot will call arch_early_init_r() soon after
631 relocation. Driver model is running by this point, and the cache
632 is on. Note that board_early_init_r() is called first, if
633 enabled. This can be used to set up architecture-specific devices.
634
Simon Glass45856012017-01-23 13:31:21 -0700635config ARCH_MISC_INIT
636 bool "Call arch-specific init after relocation, when console is ready"
637 help
638 With this option U-Boot will call arch_misc_init() after
639 relocation to allow miscellaneous arch-dependent initialisation
640 to be performed. This function should be defined by the board
Chris Packhamf7597732019-01-11 15:30:50 +1300641 and will be called after the console is set up, after relocation.
Simon Glass45856012017-01-23 13:31:21 -0700642
Simon Glassa5d67542017-01-23 13:31:20 -0700643config BOARD_EARLY_INIT_F
644 bool "Call board-specific init before relocation"
Simon Glassa5d67542017-01-23 13:31:20 -0700645 help
646 Some boards need to perform initialisation as soon as possible
647 after boot. With this option, U-Boot calls board_early_init_f()
648 after driver model is ready in the pre-relocation init sequence.
649 Note that the normal serial console is not yet set up, but the
650 debug UART will be available if enabled.
651
Mario Six02ddc142018-03-28 14:38:15 +0200652config BOARD_EARLY_INIT_R
653 bool "Call board-specific init after relocation"
654 help
655 Some boards need to perform initialisation as directly after
656 relocation. With this option, U-Boot calls board_early_init_r()
657 in the post-relocation init sequence.
658
Tom Rini6d21dd32022-02-25 11:19:47 -0500659config BOARD_POSTCLK_INIT
660 bool "Call board_postclk_init"
661 help
662 Some boards need this to initialize select items, after clocks /
663 timebase and before env / serial.
664
Simon Glass7e349e92020-09-10 20:21:23 -0600665config BOARD_LATE_INIT
666 bool "Execute Board late init"
667 help
668 Sometimes board require some initialization code that might
669 require once the actual init done, example saving board specific env,
670 boot-modes etc. which eventually done at late.
671
672 So this config enable the late init code with the help of board_late_init
673 function which should defined on respective boards.
674
Tom Rini15b4aed2022-03-23 17:20:08 -0400675config CLOCKS
676 bool "Call set_cpu_clk_info"
677 depends on ARM
678
Tom Riniada261f2021-12-12 22:12:34 -0500679config SYS_FSL_CLK
680 bool
681 depends on ARCH_LS1021A || FSL_LSCH2 || FSL_LSCH3 || \
682 (FSL_ESDHC_IMX && (ARCH_MX5 || ARCH_MX6 || ARCH_MX7))
683 default y
684 help
685 Enable to call get_clocks() in board_init_f() for platforms other
686 than PowerPC or M68k. This is a legacy option. If not TARGET_BRPPT2
687
Mario Six2aeb22d2018-03-28 14:38:16 +0200688config LAST_STAGE_INIT
689 bool "Call board-specific as last setup step"
690 help
691 Some boards need to perform initialisation immediately before control
692 is passed to the command-line interpreter (e.g. for initializations
693 that depend on later phases in the init sequence). With this option,
694 U-Boot calls last_stage_init() before the command-line interpreter is
695 started.
696
Simon Glass7e349e92020-09-10 20:21:23 -0600697config MISC_INIT_R
698 bool "Execute Misc Init"
699 default y if ARCH_KEYSTONE || ARCH_SUNXI || MPC85xx
700 default y if ARCH_OMAP2PLUS && !AM33XX
701 help
702 Enabling this option calls 'misc_init_r' function
703
Tom Rini167f6992022-05-12 16:45:08 -0400704config SYS_MALLOC_BOOTPARAMS
705 bool "Malloc a buffer to use for bootparams"
706 help
707 In some cases rather than using a known location to store the
708 bi_boot_params portion of gd we need to allocate it from our malloc pool.
709
710config SYS_BOOTPARAMS_LEN
711 hex "Size of the bootparam buffer to malloc in bytes"
712 depends on SYS_MALLOC_BOOTPARAMS
713 default 0x20000 if MIPS || RCAR_GEN3
714 default 0x10000
715
Tom Rinid7d40f62021-08-17 17:59:41 -0400716config ID_EEPROM
717 bool "Enable I2C connected system identifier EEPROM"
718 help
719 A number of different systems and vendors enable a vendor-specified
720 EEPROM that contains various identifying features.
721
Tom Riniadf13bc2022-08-10 10:29:27 -0400722config SYS_EEPROM_BUS_NUM
723 int "I2C bus number of the system identifier EEPROM"
724 depends on ID_EEPROM
725 default 0
726
727choice
728 prompt "EEPROM starts with 'CCID' or 'NXID'"
729 depends on ID_EEPROM && (PPC || ARCH_LS1021A || FSL_LAYERSCAPE)
730 default SYS_I2C_EEPROM_NXID
731 help
732 Specify if the Freescale / NXP ID EEPROM starts with 'CCID' or 'NXID'
733 ASCII literal string.
734
735config SYS_I2C_EEPROM_CCID
736 bool "EEPROM starts with 'CCID'"
737
738config SYS_I2C_EEPROM_NXID
739 bool "EEPROM starts with 'NXID'"
740
741endchoice
742
Ovidiu Panait98bf46f2020-05-06 20:38:44 +0300743config PCI_INIT_R
744 bool "Enumerate PCI buses during init"
745 depends on PCI
Ovidiu Panait98bf46f2020-05-06 20:38:44 +0300746 help
747 With this option U-Boot will call pci_init() soon after relocation,
748 which will enumerate PCI buses. This is needed, for instance, in the
749 case of DM PCI-based Ethernet devices, which will not be detected
750 without having the enumeration performed earlier.
751
Tom Rini29cc2b52022-03-18 08:38:20 -0400752config RESET_PHY_R
753 bool "Reset ethernet PHY during init"
754 help
755 Implement reset_phy() in board code if required to reset the ethernet
756 PHY.
757
Simon Glassa4211922017-01-23 13:31:19 -0700758endmenu
759
Simon Glass38663132020-09-10 20:21:22 -0600760endmenu # Init options
761
Simon Glassd70f9192017-05-17 09:05:34 -0600762menu "Security support"
763
764config HASH
765 bool # "Support hashing API (SHA1, SHA256, etc.)"
766 help
767 This provides a way to hash data in memory using various supported
768 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
769 and the algorithms it supports are defined in common/hash.c. See
770 also CMD_HASH for command-line access.
771
Igor Opaniukb0aa74a2018-07-17 14:33:25 +0300772config AVB_VERIFY
773 bool "Build Android Verified Boot operations"
Usama Arife61b4152020-08-11 15:46:03 +0100774 depends on LIBAVB
Heinrich Schuchardt9c3808d2021-01-25 12:17:57 +0100775 depends on MMC
Eugeniu Rosca87c814d2018-08-14 02:43:05 +0200776 depends on PARTITION_UUIDS
Igor Opaniukb0aa74a2018-07-17 14:33:25 +0300777 help
778 This option enables compilation of bootloader-dependent operations,
779 used by Android Verified Boot 2.0 library (libavb). Includes:
780 * Helpers to process strings in order to build OS bootargs.
781 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
782 * Helpers to alloc/init/free avb ops.
783
Usama Arife61b4152020-08-11 15:46:03 +0100784if AVB_VERIFY
785
786config AVB_BUF_ADDR
787 hex "Define AVB buffer address"
788 default FASTBOOT_BUF_ADDR
789 help
790 AVB requires a buffer for memory transactions. This variable defines the
791 buffer address.
792
793config AVB_BUF_SIZE
794 hex "Define AVB buffer SIZE"
795 default FASTBOOT_BUF_SIZE
796 help
797 AVB requires a buffer for memory transactions. This variable defines the
798 buffer size.
799
800endif # AVB_VERIFY
801
Jorge Ramirez-Ortiz166363f2021-02-14 16:27:23 +0100802config SCP03
803 bool "Build SCP03 - Secure Channel Protocol O3 - controls"
804 depends on OPTEE || SANDBOX
805 depends on TEE
806 help
807 This option allows U-Boot to enable and or provision SCP03 on an OPTEE
808 controlled Secured Element.
809
Simon Glassc0126bd2018-11-06 15:21:28 -0700810config SPL_HASH
811 bool # "Support hashing API (SHA1, SHA256, etc.)"
812 help
813 This provides a way to hash data in memory using various supported
814 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
815 and the algorithms it supports are defined in common/hash.c. See
816 also CMD_HASH for command-line access.
817
818config TPL_HASH
819 bool # "Support hashing API (SHA1, SHA256, etc.)"
820 help
821 This provides a way to hash data in memory using various supported
822 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
823 and the algorithms it supports are defined in common/hash.c. See
824 also CMD_HASH for command-line access.
825
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200826config STACKPROTECTOR
827 bool "Stack Protector buffer overflow detection"
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200828 help
829 Enable stack smash detection through compiler's stack-protector
830 canary logic
831
832config SPL_STACKPROTECTOR
833 bool "Stack Protector buffer overflow detection for SPL"
834 depends on STACKPROTECTOR && SPL
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200835
836config TPL_STACKPROTECTOR
837 bool "Stack Protector buffer overflow detection for TPL"
838 depends on STACKPROTECTOR && TPL
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200839
Rasmus Villemoes6dca1d92022-08-22 09:34:23 +0200840config BOARD_RNG_SEED
841 bool "Provide /chosen/rng-seed property to the linux kernel"
842 help
843 Selecting this option requires the board to define a
844 board_rng_seed() function, which should return a buffer
845 which will be used to populate the /chosen/rng-seed property
846 in the device tree for the OS being booted.
847
848 It is up to the board code (and more generally the whole
849 BSP) where and how to store (or generate) such a seed, how
850 to ensure a given seed is only used once, how to create a
851 new seed for use on subsequent boots, and whether or not the
852 kernel should account any entropy from the given seed.
853
Simon Glassd70f9192017-05-17 09:05:34 -0600854endmenu
855
Marek Vasutb254c522018-02-10 16:22:06 +0100856menu "Update support"
857
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900858config UPDATE_COMMON
859 bool
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900860 select DFU_WRITE_ALT
861
Marek Vasutb254c522018-02-10 16:22:06 +0100862config UPDATE_TFTP
863 bool "Auto-update using fitImage via TFTP"
864 depends on FIT
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900865 select UPDATE_COMMON
Marek Vasutb254c522018-02-10 16:22:06 +0100866 help
867 This option allows performing update of NOR with data in fitImage
868 sent via TFTP boot.
869
870config UPDATE_TFTP_CNT_MAX
871 int "The number of connection retries during auto-update"
872 default 0
873 depends on UPDATE_TFTP
874
875config UPDATE_TFTP_MSEC_MAX
876 int "Delay in mSec to wait for the TFTP server during auto-update"
877 default 100
878 depends on UPDATE_TFTP
879
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900880config UPDATE_FIT
881 bool "Firmware update using fitImage"
882 depends on FIT
883 depends on DFU
884 select UPDATE_COMMON
885 help
886 This option allows performing update of DFU-capable storage with
887 data in fitImage.
888
Ruslan Trofymenkod65e8da2019-07-05 15:37:32 +0300889config ANDROID_AB
890 bool "Android A/B updates"
Ruslan Trofymenkod65e8da2019-07-05 15:37:32 +0300891 help
892 If enabled, adds support for the new Android A/B update model. This
893 allows the bootloader to select which slot to boot from based on the
894 information provided by userspace via the Android boot_ctrl HAL. This
895 allows a bootloader to try a new version of the system but roll back
896 to previous version if the new one didn't boot all the way.
897
Marek Vasutb254c522018-02-10 16:22:06 +0100898endmenu
899
Simon Glass9f407d42018-11-15 18:43:50 -0700900menu "Blob list"
901
902config BLOBLIST
903 bool "Support for a bloblist"
904 help
905 This enables support for a bloblist in U-Boot, which can be passed
906 from TPL to SPL to U-Boot proper (and potentially to Linux). The
907 blob list supports multiple binary blobs of data, each with a tag,
908 so that different U-Boot components can store data which can survive
Simon Glass5938d652022-01-12 19:26:21 -0700909 through to the next phase of the boot.
Simon Glass9f407d42018-11-15 18:43:50 -0700910
911config SPL_BLOBLIST
912 bool "Support for a bloblist in SPL"
Simon Glass3c0d5ea2022-04-30 00:56:48 -0600913 depends on BLOBLIST && SPL_LIBGENERIC_SUPPORT && SPL_LIBCOMMON_SUPPORT
Simon Glass9f407d42018-11-15 18:43:50 -0700914 default y if SPL
915 help
916 This enables a bloblist in SPL. If this is the first part of U-Boot
917 to run, then the bloblist is set up in SPL and passed to U-Boot
918 proper. If TPL also has a bloblist, then SPL uses the one from there.
919
920config TPL_BLOBLIST
921 bool "Support for a bloblist in TPL"
Simon Glass3c0d5ea2022-04-30 00:56:48 -0600922 depends on BLOBLIST && TPL_LIBGENERIC_SUPPORT && TPL_LIBCOMMON_SUPPORT
Simon Glass9f407d42018-11-15 18:43:50 -0700923 default y if TPL
924 help
925 This enables a bloblist in TPL. The bloblist is set up in TPL and
926 passed to SPL and U-Boot proper.
927
Simon Glass747093d2022-04-30 00:56:53 -0600928config VPL_BLOBLIST
929 bool "Support for a bloblist in VPL"
930 depends on BLOBLIST && VPL_LIBGENERIC_SUPPORT && VPL_LIBCOMMON_SUPPORT
931 default y if VPL
932 help
933 This enables a bloblist in VPL. The bloblist is set up in VPL and
934 passed to SPL and U-Boot proper.
935
Simon Glassd5b6e912021-11-03 21:09:20 -0600936if BLOBLIST
937
Simon Glass99047f52022-01-12 19:26:22 -0700938choice
939 prompt "Bloblist location"
Simon Glass9f407d42018-11-15 18:43:50 -0700940 help
Simon Glass99047f52022-01-12 19:26:22 -0700941 Select the location of the bloblist, via various means.
942
943config BLOBLIST_FIXED
944 bool "Place bloblist at a fixed address in memory"
945 help
946 Select this to used a fixed memory address for the bloblist. If the
947 bloblist exists at this address from a previous phase, it used as is.
948 If not it is created at this address in U-Boot.
Simon Glass9f407d42018-11-15 18:43:50 -0700949
Simon Glassd5b6e912021-11-03 21:09:20 -0600950config BLOBLIST_ALLOC
951 bool "Allocate bloblist"
952 help
953 Allocate the bloblist using malloc(). This avoids the need to
954 specify a fixed address on systems where this is unknown or can
955 change at runtime.
956
Simon Glass99047f52022-01-12 19:26:22 -0700957endchoice
958
Simon Glass9f407d42018-11-15 18:43:50 -0700959config BLOBLIST_ADDR
960 hex "Address of bloblist"
Simon Glassecc1ed92021-07-05 16:32:48 -0600961 default 0xc000 if SANDBOX
Simon Glass99047f52022-01-12 19:26:22 -0700962 depends on BLOBLIST_FIXED
Simon Glass9f407d42018-11-15 18:43:50 -0700963 help
964 Sets the address of the bloblist, set up by the first part of U-Boot
Simon Glass5938d652022-01-12 19:26:21 -0700965 which runs. Subsequent U-Boot phases typically use the same address.
Simon Glass9f407d42018-11-15 18:43:50 -0700966
Simon Glassd5b6e912021-11-03 21:09:20 -0600967 This is not used if BLOBLIST_ALLOC is selected.
968
Simon Glass99047f52022-01-12 19:26:22 -0700969config BLOBLIST_SIZE
970 hex "Size of bloblist"
971 default 0x400
972 help
973 Sets the size of the bloblist in bytes. This must include all
974 overhead (alignment, bloblist header, record header). The bloblist
975 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
976 proper), and this sane bloblist is used for subsequent phases.
977
Simon Glass9fe06462021-01-13 20:29:43 -0700978config BLOBLIST_SIZE_RELOC
979 hex "Size of bloblist after relocation"
Simon Glass99047f52022-01-12 19:26:22 -0700980 default BLOBLIST_SIZE if BLOBLIST_FIXED || BLOBLIST_ALLOC
981 default 0 if BLOBLIST_PASSAGE
Simon Glass9fe06462021-01-13 20:29:43 -0700982 help
983 Sets the size of the bloblist in bytes after relocation. Since U-Boot
984 has a lot more memory available then, it is possible to use a larger
985 size than the one set up by SPL. This bloblist is set up during the
986 relocation process.
987
Simon Glassd5b6e912021-11-03 21:09:20 -0600988endif # BLOBLIST
989
Simon Glass99047f52022-01-12 19:26:22 -0700990if SPL_BLOBLIST
991
992choice
993 prompt "Bloblist location in SPL"
994 help
995 Select the location of the bloblist, via various means. Typically
996 you should use the same value for SPL as for U-Boot, since they need
997 to look in the same place. But if BLOBLIST_ALLOC is used, then a
998 fresh bloblist will be created each time, since there is no shared
999 address (between phases) for the bloblist.
1000
1001config SPL_BLOBLIST_FIXED
1002 bool "Place bloblist at a fixed address in memory"
1003 help
1004 Select this to used a fixed memory address for the bloblist. If the
1005 bloblist exists at this address from a previous phase, it used as is.
1006 If not it is created at this address in SPL.
1007
1008config SPL_BLOBLIST_ALLOC
1009 bool "Allocate bloblist"
1010 help
1011 Allocate the bloblist using malloc(). This avoids the need to
1012 specify a fixed address on systems where this is unknown or can
1013 change at runtime.
1014
1015endchoice
1016
1017endif # SPL_BLOBLIST
1018
1019if TPL_BLOBLIST
1020
1021choice
1022 prompt "Bloblist location in TPL"
1023 help
1024 Select the location of the bloblist, via various means. Typically
1025 you should use the same value for SPL as for U-Boot, since they need
1026 to look in the same place. But if BLOBLIST_ALLOC is used, then a
1027 fresh bloblist will be created each time, since there is no shared
1028 address (between phases) for the bloblist.
1029
1030config TPL_BLOBLIST_FIXED
1031 bool "Place bloblist at a fixed address in memory"
1032 help
1033 Select this to used a fixed memory address for the bloblist. If the
1034 bloblist exists at this address from a previous phase, it used as is.
1035 If not it is created at this address in TPL.
1036
1037config TPL_BLOBLIST_ALLOC
1038 bool "Allocate bloblist"
1039 help
1040 Allocate the bloblist using malloc(). This avoids the need to
1041 specify a fixed address on systems where this is unknown or can
1042 change at runtime.
1043
1044endchoice
1045
1046endif # TPL_BLOBLIST
1047
Simon Glass9f407d42018-11-15 18:43:50 -07001048endmenu
1049
Simon Glassc2ae7d82016-09-12 23:18:22 -06001050source "common/spl/Kconfig"
AKASHI Takahirob983cc22020-02-21 15:12:55 +09001051
1052config IMAGE_SIGN_INFO
1053 bool
1054 select SHA1
1055 select SHA256
1056 help
1057 Enable image_sign_info helper functions.
Heinrich Schuchardt64411642020-04-15 18:46:21 +02001058
1059if IMAGE_SIGN_INFO
1060
1061config SPL_IMAGE_SIGN_INFO
1062 bool
1063 select SHA1
1064 select SHA256
1065 help
1066 Enable image_sign_info helper functions in SPL.
1067
Simon Glass5981d612022-10-20 18:23:16 -06001068config VPL_IMAGE_SIGN_INFO
1069 bool
1070 select SHA1
1071 select SHA256
1072 help
1073 Enable image_sign_info helper functions in SPL.
1074
Heinrich Schuchardt64411642020-04-15 18:46:21 +02001075endif
Patrick Delaunayd71587c2021-11-15 16:32:17 +01001076
1077config FDT_SIMPLEFB
1078 bool "FDT tools for simplefb support"
1079 depends on OF_LIBFDT
1080 help
1081 Enable the fdt tools to manage the simple fb nodes in device tree.
1082 These functions can be used by board to indicate to the OS
1083 the presence of the simple frame buffer with associated reserved
1084 memory