blob: 785b189bf3be77aad74ac35eb300a36f7eaeab2d [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
Sam Wu6ebc4b22023-03-03 14:45:03 +0800701 default y if ARCH_MESON && !AML_PRODUCT_MODE
Simon Glass7e349e92020-09-10 20:21:23 -0600702 help
703 Enabling this option calls 'misc_init_r' function
704
Tom Rini167f6992022-05-12 16:45:08 -0400705config SYS_MALLOC_BOOTPARAMS
706 bool "Malloc a buffer to use for bootparams"
707 help
708 In some cases rather than using a known location to store the
709 bi_boot_params portion of gd we need to allocate it from our malloc pool.
710
711config SYS_BOOTPARAMS_LEN
712 hex "Size of the bootparam buffer to malloc in bytes"
713 depends on SYS_MALLOC_BOOTPARAMS
714 default 0x20000 if MIPS || RCAR_GEN3
715 default 0x10000
716
Tom Rinid7d40f62021-08-17 17:59:41 -0400717config ID_EEPROM
718 bool "Enable I2C connected system identifier EEPROM"
719 help
720 A number of different systems and vendors enable a vendor-specified
721 EEPROM that contains various identifying features.
722
Tom Riniadf13bc2022-08-10 10:29:27 -0400723config SYS_EEPROM_BUS_NUM
724 int "I2C bus number of the system identifier EEPROM"
725 depends on ID_EEPROM
726 default 0
727
728choice
729 prompt "EEPROM starts with 'CCID' or 'NXID'"
730 depends on ID_EEPROM && (PPC || ARCH_LS1021A || FSL_LAYERSCAPE)
731 default SYS_I2C_EEPROM_NXID
732 help
733 Specify if the Freescale / NXP ID EEPROM starts with 'CCID' or 'NXID'
734 ASCII literal string.
735
736config SYS_I2C_EEPROM_CCID
737 bool "EEPROM starts with 'CCID'"
738
739config SYS_I2C_EEPROM_NXID
740 bool "EEPROM starts with 'NXID'"
741
742endchoice
743
Ovidiu Panait98bf46f2020-05-06 20:38:44 +0300744config PCI_INIT_R
745 bool "Enumerate PCI buses during init"
746 depends on PCI
Ovidiu Panait98bf46f2020-05-06 20:38:44 +0300747 help
748 With this option U-Boot will call pci_init() soon after relocation,
749 which will enumerate PCI buses. This is needed, for instance, in the
750 case of DM PCI-based Ethernet devices, which will not be detected
751 without having the enumeration performed earlier.
752
Tom Rini29cc2b52022-03-18 08:38:20 -0400753config RESET_PHY_R
754 bool "Reset ethernet PHY during init"
755 help
756 Implement reset_phy() in board code if required to reset the ethernet
757 PHY.
758
Simon Glassa4211922017-01-23 13:31:19 -0700759endmenu
760
Simon Glass38663132020-09-10 20:21:22 -0600761endmenu # Init options
762
Simon Glassd70f9192017-05-17 09:05:34 -0600763menu "Security support"
764
765config HASH
766 bool # "Support hashing API (SHA1, SHA256, etc.)"
767 help
768 This provides a way to hash data in memory using various supported
769 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
770 and the algorithms it supports are defined in common/hash.c. See
771 also CMD_HASH for command-line access.
772
Igor Opaniukb0aa74a2018-07-17 14:33:25 +0300773config AVB_VERIFY
774 bool "Build Android Verified Boot operations"
Usama Arife61b4152020-08-11 15:46:03 +0100775 depends on LIBAVB
Heinrich Schuchardt9c3808d2021-01-25 12:17:57 +0100776 depends on MMC
Eugeniu Rosca87c814d2018-08-14 02:43:05 +0200777 depends on PARTITION_UUIDS
Igor Opaniukb0aa74a2018-07-17 14:33:25 +0300778 help
779 This option enables compilation of bootloader-dependent operations,
780 used by Android Verified Boot 2.0 library (libavb). Includes:
781 * Helpers to process strings in order to build OS bootargs.
782 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
783 * Helpers to alloc/init/free avb ops.
784
Usama Arife61b4152020-08-11 15:46:03 +0100785if AVB_VERIFY
786
787config AVB_BUF_ADDR
788 hex "Define AVB buffer address"
789 default FASTBOOT_BUF_ADDR
790 help
791 AVB requires a buffer for memory transactions. This variable defines the
792 buffer address.
793
794config AVB_BUF_SIZE
795 hex "Define AVB buffer SIZE"
796 default FASTBOOT_BUF_SIZE
797 help
798 AVB requires a buffer for memory transactions. This variable defines the
799 buffer size.
800
801endif # AVB_VERIFY
802
Jorge Ramirez-Ortiz166363f2021-02-14 16:27:23 +0100803config SCP03
804 bool "Build SCP03 - Secure Channel Protocol O3 - controls"
805 depends on OPTEE || SANDBOX
806 depends on TEE
807 help
808 This option allows U-Boot to enable and or provision SCP03 on an OPTEE
809 controlled Secured Element.
810
Simon Glassc0126bd2018-11-06 15:21:28 -0700811config SPL_HASH
812 bool # "Support hashing API (SHA1, SHA256, etc.)"
813 help
814 This provides a way to hash data in memory using various supported
815 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
816 and the algorithms it supports are defined in common/hash.c. See
817 also CMD_HASH for command-line access.
818
819config TPL_HASH
820 bool # "Support hashing API (SHA1, SHA256, etc.)"
821 help
822 This provides a way to hash data in memory using various supported
823 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
824 and the algorithms it supports are defined in common/hash.c. See
825 also CMD_HASH for command-line access.
826
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200827config STACKPROTECTOR
828 bool "Stack Protector buffer overflow detection"
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200829 help
830 Enable stack smash detection through compiler's stack-protector
831 canary logic
832
833config SPL_STACKPROTECTOR
834 bool "Stack Protector buffer overflow detection for SPL"
835 depends on STACKPROTECTOR && SPL
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200836
837config TPL_STACKPROTECTOR
838 bool "Stack Protector buffer overflow detection for TPL"
839 depends on STACKPROTECTOR && TPL
Joel Peshkin4e9bce12021-04-11 11:21:58 +0200840
Rasmus Villemoes6dca1d92022-08-22 09:34:23 +0200841config BOARD_RNG_SEED
842 bool "Provide /chosen/rng-seed property to the linux kernel"
843 help
844 Selecting this option requires the board to define a
845 board_rng_seed() function, which should return a buffer
846 which will be used to populate the /chosen/rng-seed property
847 in the device tree for the OS being booted.
848
849 It is up to the board code (and more generally the whole
850 BSP) where and how to store (or generate) such a seed, how
851 to ensure a given seed is only used once, how to create a
852 new seed for use on subsequent boots, and whether or not the
853 kernel should account any entropy from the given seed.
854
Simon Glassd70f9192017-05-17 09:05:34 -0600855endmenu
856
Marek Vasutb254c522018-02-10 16:22:06 +0100857menu "Update support"
858
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900859config UPDATE_COMMON
860 bool
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900861 select DFU_WRITE_ALT
862
Marek Vasutb254c522018-02-10 16:22:06 +0100863config UPDATE_TFTP
864 bool "Auto-update using fitImage via TFTP"
865 depends on FIT
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900866 select UPDATE_COMMON
Marek Vasutb254c522018-02-10 16:22:06 +0100867 help
868 This option allows performing update of NOR with data in fitImage
869 sent via TFTP boot.
870
871config UPDATE_TFTP_CNT_MAX
872 int "The number of connection retries during auto-update"
873 default 0
874 depends on UPDATE_TFTP
875
876config UPDATE_TFTP_MSEC_MAX
877 int "Delay in mSec to wait for the TFTP server during auto-update"
878 default 100
879 depends on UPDATE_TFTP
880
AKASHI Takahiro3149e522020-10-29 13:47:43 +0900881config UPDATE_FIT
882 bool "Firmware update using fitImage"
883 depends on FIT
884 depends on DFU
885 select UPDATE_COMMON
886 help
887 This option allows performing update of DFU-capable storage with
888 data in fitImage.
889
Ruslan Trofymenkod65e8da2019-07-05 15:37:32 +0300890config ANDROID_AB
891 bool "Android A/B updates"
Ruslan Trofymenkod65e8da2019-07-05 15:37:32 +0300892 help
893 If enabled, adds support for the new Android A/B update model. This
894 allows the bootloader to select which slot to boot from based on the
895 information provided by userspace via the Android boot_ctrl HAL. This
896 allows a bootloader to try a new version of the system but roll back
897 to previous version if the new one didn't boot all the way.
898
Marek Vasutb254c522018-02-10 16:22:06 +0100899endmenu
900
Simon Glass9f407d42018-11-15 18:43:50 -0700901menu "Blob list"
902
903config BLOBLIST
904 bool "Support for a bloblist"
905 help
906 This enables support for a bloblist in U-Boot, which can be passed
907 from TPL to SPL to U-Boot proper (and potentially to Linux). The
908 blob list supports multiple binary blobs of data, each with a tag,
909 so that different U-Boot components can store data which can survive
Simon Glass5938d652022-01-12 19:26:21 -0700910 through to the next phase of the boot.
Simon Glass9f407d42018-11-15 18:43:50 -0700911
912config SPL_BLOBLIST
913 bool "Support for a bloblist in SPL"
Simon Glass3c0d5ea2022-04-30 00:56:48 -0600914 depends on BLOBLIST && SPL_LIBGENERIC_SUPPORT && SPL_LIBCOMMON_SUPPORT
Simon Glass9f407d42018-11-15 18:43:50 -0700915 default y if SPL
916 help
917 This enables a bloblist in SPL. If this is the first part of U-Boot
918 to run, then the bloblist is set up in SPL and passed to U-Boot
919 proper. If TPL also has a bloblist, then SPL uses the one from there.
920
921config TPL_BLOBLIST
922 bool "Support for a bloblist in TPL"
Simon Glass3c0d5ea2022-04-30 00:56:48 -0600923 depends on BLOBLIST && TPL_LIBGENERIC_SUPPORT && TPL_LIBCOMMON_SUPPORT
Simon Glass9f407d42018-11-15 18:43:50 -0700924 default y if TPL
925 help
926 This enables a bloblist in TPL. The bloblist is set up in TPL and
927 passed to SPL and U-Boot proper.
928
Simon Glass747093d2022-04-30 00:56:53 -0600929config VPL_BLOBLIST
930 bool "Support for a bloblist in VPL"
931 depends on BLOBLIST && VPL_LIBGENERIC_SUPPORT && VPL_LIBCOMMON_SUPPORT
932 default y if VPL
933 help
934 This enables a bloblist in VPL. The bloblist is set up in VPL and
935 passed to SPL and U-Boot proper.
936
Simon Glassd5b6e912021-11-03 21:09:20 -0600937if BLOBLIST
938
Simon Glass99047f52022-01-12 19:26:22 -0700939choice
940 prompt "Bloblist location"
Simon Glass9f407d42018-11-15 18:43:50 -0700941 help
Simon Glass99047f52022-01-12 19:26:22 -0700942 Select the location of the bloblist, via various means.
943
944config BLOBLIST_FIXED
945 bool "Place bloblist at a fixed address in memory"
946 help
947 Select this to used a fixed memory address for the bloblist. If the
948 bloblist exists at this address from a previous phase, it used as is.
949 If not it is created at this address in U-Boot.
Simon Glass9f407d42018-11-15 18:43:50 -0700950
Simon Glassd5b6e912021-11-03 21:09:20 -0600951config BLOBLIST_ALLOC
952 bool "Allocate bloblist"
953 help
954 Allocate the bloblist using malloc(). This avoids the need to
955 specify a fixed address on systems where this is unknown or can
956 change at runtime.
957
Simon Glass99047f52022-01-12 19:26:22 -0700958endchoice
959
Simon Glass9f407d42018-11-15 18:43:50 -0700960config BLOBLIST_ADDR
961 hex "Address of bloblist"
Simon Glassecc1ed92021-07-05 16:32:48 -0600962 default 0xc000 if SANDBOX
Simon Glass99047f52022-01-12 19:26:22 -0700963 depends on BLOBLIST_FIXED
Simon Glass9f407d42018-11-15 18:43:50 -0700964 help
965 Sets the address of the bloblist, set up by the first part of U-Boot
Simon Glass5938d652022-01-12 19:26:21 -0700966 which runs. Subsequent U-Boot phases typically use the same address.
Simon Glass9f407d42018-11-15 18:43:50 -0700967
Simon Glassd5b6e912021-11-03 21:09:20 -0600968 This is not used if BLOBLIST_ALLOC is selected.
969
Simon Glass99047f52022-01-12 19:26:22 -0700970config BLOBLIST_SIZE
971 hex "Size of bloblist"
972 default 0x400
973 help
974 Sets the size of the bloblist in bytes. This must include all
975 overhead (alignment, bloblist header, record header). The bloblist
976 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
977 proper), and this sane bloblist is used for subsequent phases.
978
Simon Glass9fe06462021-01-13 20:29:43 -0700979config BLOBLIST_SIZE_RELOC
980 hex "Size of bloblist after relocation"
Simon Glass99047f52022-01-12 19:26:22 -0700981 default BLOBLIST_SIZE if BLOBLIST_FIXED || BLOBLIST_ALLOC
982 default 0 if BLOBLIST_PASSAGE
Simon Glass9fe06462021-01-13 20:29:43 -0700983 help
984 Sets the size of the bloblist in bytes after relocation. Since U-Boot
985 has a lot more memory available then, it is possible to use a larger
986 size than the one set up by SPL. This bloblist is set up during the
987 relocation process.
988
Simon Glassd5b6e912021-11-03 21:09:20 -0600989endif # BLOBLIST
990
Simon Glass99047f52022-01-12 19:26:22 -0700991if SPL_BLOBLIST
992
993choice
994 prompt "Bloblist location in SPL"
995 help
996 Select the location of the bloblist, via various means. Typically
997 you should use the same value for SPL as for U-Boot, since they need
998 to look in the same place. But if BLOBLIST_ALLOC is used, then a
999 fresh bloblist will be created each time, since there is no shared
1000 address (between phases) for the bloblist.
1001
1002config SPL_BLOBLIST_FIXED
1003 bool "Place bloblist at a fixed address in memory"
1004 help
1005 Select this to used a fixed memory address for the bloblist. If the
1006 bloblist exists at this address from a previous phase, it used as is.
1007 If not it is created at this address in SPL.
1008
1009config SPL_BLOBLIST_ALLOC
1010 bool "Allocate bloblist"
1011 help
1012 Allocate the bloblist using malloc(). This avoids the need to
1013 specify a fixed address on systems where this is unknown or can
1014 change at runtime.
1015
1016endchoice
1017
1018endif # SPL_BLOBLIST
1019
1020if TPL_BLOBLIST
1021
1022choice
1023 prompt "Bloblist location in TPL"
1024 help
1025 Select the location of the bloblist, via various means. Typically
1026 you should use the same value for SPL as for U-Boot, since they need
1027 to look in the same place. But if BLOBLIST_ALLOC is used, then a
1028 fresh bloblist will be created each time, since there is no shared
1029 address (between phases) for the bloblist.
1030
1031config TPL_BLOBLIST_FIXED
1032 bool "Place bloblist at a fixed address in memory"
1033 help
1034 Select this to used a fixed memory address for the bloblist. If the
1035 bloblist exists at this address from a previous phase, it used as is.
1036 If not it is created at this address in TPL.
1037
1038config TPL_BLOBLIST_ALLOC
1039 bool "Allocate bloblist"
1040 help
1041 Allocate the bloblist using malloc(). This avoids the need to
1042 specify a fixed address on systems where this is unknown or can
1043 change at runtime.
1044
1045endchoice
1046
1047endif # TPL_BLOBLIST
1048
Simon Glass9f407d42018-11-15 18:43:50 -07001049endmenu
1050
Simon Glassc2ae7d82016-09-12 23:18:22 -06001051source "common/spl/Kconfig"
AKASHI Takahirob983cc22020-02-21 15:12:55 +09001052
1053config IMAGE_SIGN_INFO
1054 bool
1055 select SHA1
1056 select SHA256
1057 help
1058 Enable image_sign_info helper functions.
Heinrich Schuchardt64411642020-04-15 18:46:21 +02001059
1060if IMAGE_SIGN_INFO
1061
1062config SPL_IMAGE_SIGN_INFO
1063 bool
1064 select SHA1
1065 select SHA256
1066 help
1067 Enable image_sign_info helper functions in SPL.
1068
Simon Glass5981d612022-10-20 18:23:16 -06001069config VPL_IMAGE_SIGN_INFO
1070 bool
1071 select SHA1
1072 select SHA256
1073 help
1074 Enable image_sign_info helper functions in SPL.
1075
Heinrich Schuchardt64411642020-04-15 18:46:21 +02001076endif
Patrick Delaunayd71587c2021-11-15 16:32:17 +01001077
1078config FDT_SIMPLEFB
1079 bool "FDT tools for simplefb support"
1080 depends on OF_LIBFDT
1081 help
1082 Enable the fdt tools to manage the simple fb nodes in device tree.
1083 These functions can be used by board to indicate to the OS
1084 the presence of the simple frame buffer with associated reserved
1085 memory