blob: e7914ca750a3eb601a5d060aa31ad0c93ac07c24 [file] [log] [blame]
Simon Glass4458d3b2016-10-17 20:12:35 -06001menu "Console"
2
Tom Rini697f4732016-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 Glass1bb49232015-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. Daye9c629c2016-08-31 12:49:13 -040013 input) through circular buffers. This is mostly useful for testing.
Simon Glass1bb49232015-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 Panait6b165af2020-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 Glass1bb49232015-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 Glass9803ddf2021-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 Glass1bb49232015-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 Paladugu0b15e302016-07-19 10:42:22 +053054
Christian Gmeinerc7a88102018-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 Paladugu809438d2016-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 Yamadabf9c2932017-09-16 14:10:40 +090065config LOGLEVEL
66 int "loglevel"
Tom Rini10cbc1c2017-10-04 16:44:30 -040067 default 4
Marek Bykowski271159a2020-02-03 11:43:32 +010068 range 0 10
Masahiro Yamadabf9c2932017-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 Glass6e455c32019-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 Yamadabf9c2932017-09-16 14:10:40 +090083
84config SPL_LOGLEVEL
85 int
Tom Rini0a83cc22022-06-10 23:03:09 -040086 depends on SPL
Masahiro Yamadabf9c2932017-09-16 14:10:40 +090087 default LOGLEVEL
88
Simon Glassb56cdc02018-11-15 18:43:49 -070089config TPL_LOGLEVEL
90 int
Tom Rini36a4ca02022-06-08 08:24:39 -040091 depends on TPL
Simon Glassb56cdc02018-11-15 18:43:49 -070092 default LOGLEVEL
93
Simon Glasse7ca7da2022-04-30 00:56:53 -060094config VPL_LOGLEVEL
95 int "loglevel for VPL"
Tom Rini7fb323b2022-06-08 08:24:40 -040096 depends on VPL
Simon Glasse7ca7da2022-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 Glass4458d3b2016-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 Packham83ad2482019-01-11 15:30:50 +1300109 setting the environment variable 'silent' to a non-empty value.
Simon Glass4458d3b2016-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
116config SILENT_U_BOOT_ONLY
117 bool "Only silence the U-Boot console"
118 depends on SILENT_CONSOLE
119 help
120 Normally when the U-Boot console is silenced, Linux's console is
121 also silenced (assuming the board boots into Linux). This option
122 allows the linux console to operate normally, even if U-Boot's
123 is silenced.
124
125config SILENT_CONSOLE_UPDATE_ON_SET
126 bool "Changes to the 'silent' environment variable update immediately"
127 depends on SILENT_CONSOLE
128 default y if SILENT_CONSOLE
129 help
130 When the 'silent' environment variable is changed, update the
131 console silence flag immediately. This allows 'setenv' to be used
132 to silence or un-silence the console.
133
134 The effect is that any change to the variable will affect the
135 GD_FLG_SILENT flag.
136
137config SILENT_CONSOLE_UPDATE_ON_RELOC
138 bool "Allow flags to take effect on relocation"
139 depends on SILENT_CONSOLE
140 help
141 In some cases the environment is not available until relocation
142 (e.g. NAND). This option makes the value of the 'silent'
143 environment variable take effect at relocation.
144
Simon Glasse304a5e2016-10-17 20:12:36 -0600145config PRE_CONSOLE_BUFFER
146 bool "Buffer characters before the console is available"
147 help
148 Prior to the console being initialised (i.e. serial UART
149 initialised etc) all console output is silently discarded.
150 Defining CONFIG_PRE_CONSOLE_BUFFER will cause U-Boot to
151 buffer any console messages prior to the console being
152 initialised to a buffer. The buffer is a circular buffer, so
153 if it overflows, earlier output is discarded.
154
155 Note that this is not currently supported in SPL. It would be
156 useful to be able to share the pre-console buffer with SPL.
157
158config PRE_CON_BUF_SZ
159 int "Sets the size of the pre-console buffer"
160 depends on PRE_CONSOLE_BUFFER
161 default 4096
162 help
163 The size of the pre-console buffer affects how much console output
164 can be held before it overflows and starts discarding earlier
165 output. Normally there is very little output at this early stage,
166 unless debugging is enabled, so allow enough for ~10 lines of
167 text.
168
169 This is a useful feature if you are using a video console and
170 want to see the full boot output on the console. Without this
171 option only the post-relocation output will be displayed.
172
173config PRE_CON_BUF_ADDR
174 hex "Address of the pre-console buffer"
175 depends on PRE_CONSOLE_BUFFER
176 default 0x2f000000 if ARCH_SUNXI && MACH_SUN9I
177 default 0x4f000000 if ARCH_SUNXI && !MACH_SUN9I
Jagan Teki7b7cc952020-01-23 19:42:19 +0530178 default 0x0f000000 if ROCKCHIP_RK3288
Jagan Teki9249d5c2020-04-02 17:11:23 +0530179 default 0x0f200000 if ROCKCHIP_RK3399
Simon Glasse304a5e2016-10-17 20:12:36 -0600180 help
181 This sets the start address of the pre-console buffer. This must
182 be in available memory and is accessed before relocation and
183 possibly before DRAM is set up. Therefore choose an address
184 carefully.
185
186 We should consider removing this option and allocating the memory
187 in board_init_f_init_reserve() instead.
188
Simon Glass9fd2a022016-10-17 20:12:37 -0600189config CONSOLE_MUX
190 bool "Enable console multiplexing"
191 default y if DM_VIDEO || VIDEO || LCD
192 help
193 This allows multiple devices to be used for each console 'file'.
194 For example, stdout can be set to go to serial and video.
195 Similarly, stdin can be set to come from serial and keyboard.
196 Input can be provided from either source. Console multiplexing
197 adds a small amount of size to U-Boot. Changes to the environment
198 variables stdout, stdin and stderr will take effect immediately.
199
200config SYS_CONSOLE_IS_IN_ENV
201 bool "Select console devices from the environment"
202 default y if CONSOLE_MUX
203 help
204 This allows multiple input/output devices to be set at boot time.
Anatolij Gustschin5b2bc142021-10-04 16:04:32 +0200205 For example, if stdout is set to "serial,vidconsole" then output
206 will be sent to both the serial and video devices on boot. The
Simon Glass9fd2a022016-10-17 20:12:37 -0600207 environment variables can be updated after boot to change the
208 input/output devices.
209
Simon Glassac3ee422016-10-17 20:12:59 -0600210config SYS_CONSOLE_OVERWRITE_ROUTINE
211 bool "Allow board control over console overwriting"
212 help
213 If this is enabled, and the board-specific function
214 overwrite_console() returns 1, the stdin, stderr and stdout are
215 switched to the serial port, else the settings in the environment
216 are used. If this is not enabled, the console will not be switched
217 to serial.
218
Simon Glass217652f2016-10-17 20:12:58 -0600219config SYS_CONSOLE_ENV_OVERWRITE
220 bool "Update environment variables during console init"
221 help
222 The console environment variables (stdout, stdin, stderr) can be
223 used to determine the correct console devices on start-up. This
224 option writes the console devices to these variables on console
225 start-up (after relocation). This causes the environment to be
226 updated to match the console devices actually chosen.
227
Simon Glassbd5618d2016-10-17 20:13:00 -0600228config SYS_CONSOLE_INFO_QUIET
229 bool "Don't display the console devices on boot"
230 help
231 Normally U-Boot displays the current settings for stdout, stdin
232 and stderr on boot when the post-relocation console is set up.
Chris Packham83ad2482019-01-11 15:30:50 +1300233 Enable this option to suppress this output. It can be obtained by
Simon Glassbd5618d2016-10-17 20:13:00 -0600234 calling stdio_print_current_devices() from board code.
235
Simon Glass3110ece2016-10-17 20:13:02 -0600236config SYS_STDIO_DEREGISTER
237 bool "Allow deregistering stdio devices"
238 default y if USB_KEYBOARD
239 help
240 Generally there is no need to deregister stdio devices since they
241 are never deactivated. But if a stdio device is used which can be
242 removed (for example a USB keyboard) then this option can be
243 enabled to ensure this is handled correctly.
244
Simon Glass3d2a3dd2020-08-11 11:23:36 -0600245config SPL_SYS_STDIO_DEREGISTER
246 bool "Allow deregistering stdio devices in SPL"
247 help
248 Generally there is no need to deregister stdio devices since they
249 are never deactivated. But if a stdio device is used which can be
250 removed (for example a USB keyboard) then this option can be
251 enabled to ensure this is handled correctly. This is very rarely
252 needed in SPL.
253
254config SYS_DEVICE_NULLDEV
255 bool "Enable a null device for stdio"
Simon Glassd6336b32020-08-11 11:23:37 -0600256 default y if SPLASH_SCREEN || SYS_STDIO_DEREGISTER
Simon Glass3d2a3dd2020-08-11 11:23:36 -0600257 help
258 Enable creation of a "nulldev" stdio device. This allows silent
259 operation of the console by setting stdout to "nulldev". Enable
260 this to use a serial console under board control.
261
Simon Glass4458d3b2016-10-17 20:12:35 -0600262endmenu
263
Simon Glassd95645d2017-12-04 13:48:24 -0700264menu "Logging"
265
266config LOG
267 bool "Enable logging support"
Michal Simek4fcaf492018-07-23 15:55:11 +0200268 depends on DM
Simon Glassd95645d2017-12-04 13:48:24 -0700269 help
270 This enables support for logging of status and debug messages. These
271 can be displayed on the console, recorded in a memory buffer, or
272 discarded if not needed. Logging supports various categories and
273 levels of severity.
274
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200275if LOG
Simon Glassa4bea1f2018-11-06 15:21:28 -0700276
Simon Glassd95645d2017-12-04 13:48:24 -0700277config LOG_MAX_LEVEL
278 int "Maximum log level to record"
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200279 default 6
280 range 0 9
Simon Glassd95645d2017-12-04 13:48:24 -0700281 help
282 This selects the maximum log level that will be recorded. Any value
283 higher than this will be ignored. If possible log statements below
284 this level will be discarded at build time. Levels:
285
Simon Glass6e455c32019-02-16 20:24:34 -0700286 0 - emergency
287 1 - alert
288 2 - critical
289 3 - error
290 4 - warning
291 5 - note
292 6 - info
Simon Glassd95645d2017-12-04 13:48:24 -0700293 7 - debug
Simon Glass6e455c32019-02-16 20:24:34 -0700294 8 - debug content
295 9 - debug hardware I/O
Simon Glassd95645d2017-12-04 13:48:24 -0700296
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200297config LOG_DEFAULT_LEVEL
298 int "Default logging level to display"
299 default LOG_MAX_LEVEL
300 range 0 LOG_MAX_LEVEL
Simon Glassd95645d2017-12-04 13:48:24 -0700301 help
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200302 This is the default logging level set when U-Boot starts. It can
303 be adjusted later using the 'log level' command. Note that setting
304 this to a value above LOG_MAX_LEVEL will be ineffective, since the
305 higher levels are not compiled in to U-Boot.
Simon Glassd95645d2017-12-04 13:48:24 -0700306
Simon Glass6e455c32019-02-16 20:24:34 -0700307 0 - emergency
308 1 - alert
309 2 - critical
310 3 - error
311 4 - warning
312 5 - note
313 6 - info
Simon Glassd95645d2017-12-04 13:48:24 -0700314 7 - debug
Simon Glass6e455c32019-02-16 20:24:34 -0700315 8 - debug content
316 9 - debug hardware I/O
Simon Glassd95645d2017-12-04 13:48:24 -0700317
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200318config LOG_CONSOLE
319 bool "Allow log output to the console"
320 default y
321 help
322 Enables a log driver which writes log records to the console.
323 Generally the console is the serial port or LCD display. Only the
324 log message is shown - other details like level, category, file and
325 line number are omitted.
326
Heinrich Schuchardt2d349c72020-06-17 21:52:44 +0200327config LOGF_FILE
328 bool "Show source file name in log messages by default"
329 help
330 Show the source file name in log messages by default. This value
331 can be overridden using the 'log format' command.
332
333config LOGF_LINE
334 bool "Show source line number in log messages by default"
335 help
336 Show the source line number in log messages by default. This value
337 can be overridden using the 'log format' command.
338
339config LOGF_FUNC
340 bool "Show function name in log messages by default"
341 help
342 Show the function name in log messages by default. This value can
343 be overridden using the 'log format' command.
344
Simon Glass81cd0402021-07-05 16:33:00 -0600345config LOGF_FUNC_PAD
346 int "Number of characters to use for function"
347 default 20
348 help
349 Sets the field width to use when showing the function. Set this to
350 a larger value if you have lots of long function names, and want
351 things to line up.
352
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200353config LOG_SYSLOG
354 bool "Log output to syslog server"
355 depends on NET
356 help
357 Enables a log driver which broadcasts log records via UDP port 514
358 to syslog servers.
359
360config SPL_LOG
361 bool "Enable logging support in SPL"
Tom Rini0a83cc22022-06-10 23:03:09 -0400362 depends on LOG && SPL
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200363 help
364 This enables support for logging of status and debug messages. These
365 can be displayed on the console, recorded in a memory buffer, or
366 discarded if not needed. Logging supports various categories and
367 levels of severity.
368
369if SPL_LOG
370
371config SPL_LOG_MAX_LEVEL
372 int "Maximum log level to record in SPL"
373 depends on SPL_LOG
Simon Glassb56cdc02018-11-15 18:43:49 -0700374 default 3
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200375 range 0 9
Simon Glassb56cdc02018-11-15 18:43:49 -0700376 help
377 This selects the maximum log level that will be recorded. Any value
378 higher than this will be ignored. If possible log statements below
379 this level will be discarded at build time. Levels:
380
Simon Glass6e455c32019-02-16 20:24:34 -0700381 0 - emergency
382 1 - alert
383 2 - critical
384 3 - error
385 4 - warning
386 5 - note
387 6 - info
Simon Glassb56cdc02018-11-15 18:43:49 -0700388 7 - debug
Simon Glass6e455c32019-02-16 20:24:34 -0700389 8 - debug content
390 9 - debug hardware I/O
Simon Glassb56cdc02018-11-15 18:43:49 -0700391
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200392config SPL_LOG_CONSOLE
393 bool "Allow log output to the console in SPL"
394 default y
Simon Glass38617e82019-02-16 20:24:35 -0700395 help
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200396 Enables a log driver which writes log records to the console.
397 Generally the console is the serial port or LCD display. Only the
398 log message is shown - other details like level, category, file and
399 line number are omitted.
400
401endif
402
403config TPL_LOG
404 bool "Enable logging support in TPL"
Tom Rini36a4ca02022-06-08 08:24:39 -0400405 depends on LOG && TPL
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200406 help
407 This enables support for logging of status and debug messages. These
408 can be displayed on the console, recorded in a memory buffer, or
409 discarded if not needed. Logging supports various categories and
410 levels of severity.
411
412if TPL_LOG
413
414config TPL_LOG_MAX_LEVEL
415 int "Maximum log level to record in TPL"
416 depends on TPL_LOG
417 default 3
418 range 0 9
419 help
420 This selects the maximum log level that will be recorded. Any value
421 higher than this will be ignored. If possible log statements below
422 this level will be discarded at build time. Levels:
Simon Glass38617e82019-02-16 20:24:35 -0700423
424 0 - emergency
425 1 - alert
426 2 - critical
427 3 - error
428 4 - warning
429 5 - note
430 6 - info
431 7 - debug
432 8 - debug content
433 9 - debug hardware I/O
434
Simon Glassb56cdc02018-11-15 18:43:49 -0700435config TPL_LOG_CONSOLE
Simon South7f107fe2019-10-02 10:55:06 -0400436 bool "Allow log output to the console in TPL"
Simon Glassa68ce922017-12-04 13:48:25 -0700437 default y
438 help
439 Enables a log driver which writes log records to the console.
440 Generally the console is the serial port or LCD display. Only the
441 log message is shown - other details like level, category, file and
442 line number are omitted.
443
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200444endif
Simon Glass14c8a062017-12-04 13:48:27 -0700445
Simon Glasse7ca7da2022-04-30 00:56:53 -0600446config VPL_LOG
447 bool "Enable logging support in VPL"
Tom Rini7fb323b2022-06-08 08:24:40 -0400448 depends on LOG && VPL
Simon Glasse7ca7da2022-04-30 00:56:53 -0600449 help
450 This enables support for logging of status and debug messages. These
451 can be displayed on the console, recorded in a memory buffer, or
452 discarded if not needed. Logging supports various categories and
453 levels of severity.
454
455if VPL_LOG
456
457config VPL_LOG_MAX_LEVEL
458 int "Maximum log level to record in VPL"
459 default 3
460 help
461 This selects the maximum log level that will be recorded. Any value
462 higher than this will be ignored. If possible log statements below
463 this level will be discarded at build time. Levels:
464
465 0 - emergency
466 1 - alert
467 2 - critical
468 3 - error
469 4 - warning
470 5 - note
471 6 - info
472 7 - debug
473 8 - debug content
474 9 - debug hardware I/O
475
476config VPL_LOG_CONSOLE
477 bool "Allow log output to the console in VPL"
478 default y
479 help
480 Enables a log driver which writes log records to the console.
481 Generally the console is the serial port or LCD display. Only the
482 log message is shown - other details like level, category, file and
483 line number are omitted.
484
485endif
486
Simon Glassaa1d73b2017-12-28 13:14:23 -0700487config LOG_ERROR_RETURN
488 bool "Log all functions which return an error"
Simon Glassaa1d73b2017-12-28 13:14:23 -0700489 help
490 When an error is returned in U-Boot it is sometimes difficult to
Chris Packham83ad2482019-01-11 15:30:50 +1300491 figure out the root cause. For example, reading from SPI flash may
Simon Glassaa1d73b2017-12-28 13:14:23 -0700492 fail due to a problem in the SPI controller or due to the flash part
493 not returning the expected information. This option changes
494 log_ret() to log any errors it sees. With this option disabled,
495 log_ret() is a nop.
496
497 You can add log_ret() to all functions which return an error code.
498
Heinrich Schuchardt524956c2020-05-31 15:34:22 +0200499config LOG_TEST
500 bool "Provide a test for logging"
501 depends on UNIT_TEST
502 default y if SANDBOX
503 help
504 This enables a 'log test' command to test logging. It is normally
505 executed from a pytest and simply outputs logging information
506 in various different ways to test that the logging system works
507 correctly with various settings.
508
509endif
510
Simon Glassd95645d2017-12-04 13:48:24 -0700511endmenu
512
Simon Glass00311002020-09-10 20:21:21 -0600513menu "Init options"
514
Simon Glass36ada312020-09-10 20:21:26 -0600515config BOARD_TYPES
516 bool "Call get_board_type() to get and display the board type"
517 help
518 If this option is enabled, checkboard() will call get_board_type()
519 to get a string containing the board type and this will be
520 displayed immediately after the model is shown on the console
521 early in boot.
522
Lokesh Vutlafbad3702016-10-08 14:41:44 -0400523config DISPLAY_CPUINFO
524 bool "Display information about the CPU during start up"
Alexey Brodkinb550fd72018-10-02 11:43:28 +0300525 default y if ARC|| ARM || NIOS2 || X86 || XTENSA || M68K
Lokesh Vutlafbad3702016-10-08 14:41:44 -0400526 help
527 Display information about the CPU that U-Boot is running on
528 when U-Boot starts up. The function print_cpuinfo() is called
529 to do this.
530
Lokesh Vutla94d95e42016-10-11 21:33:46 -0400531config DISPLAY_BOARDINFO
Mario Sixf7055442018-03-28 14:38:17 +0200532 bool "Display information about the board during early start up"
Alexey Brodkinb550fd72018-10-02 11:43:28 +0300533 default y if ARC || ARM || M68K || MIPS || PPC || SANDBOX || XTENSA
Lokesh Vutla94d95e42016-10-11 21:33:46 -0400534 help
535 Display information about the board that U-Boot is running on
536 when U-Boot starts up. The board function checkboard() is called
537 to do this.
538
Mario Sixf7055442018-03-28 14:38:17 +0200539config DISPLAY_BOARDINFO_LATE
540 bool "Display information about the board during late start up"
541 help
542 Display information about the board that U-Boot is running on after
543 the relocation phase. The board function checkboard() is called to do
544 this.
545
Simon Glass62adede2017-01-23 13:31:19 -0700546menu "Start-up hooks"
547
Simon Glassaa4bce92022-03-04 08:43:00 -0700548config EVENT
549 bool "General-purpose event-handling mechanism"
550 default y if SANDBOX
551 help
552 This enables sending and processing of events, to allow interested
553 parties to be alerted when something happens. This is an attempt to
554 step the flow of weak functions, hooks, functions in board_f.c
555 and board_r.c and the Kconfig options below.
556
557 See doc/develop/event.rst for more information.
558
559if EVENT
560
561config EVENT_DYNAMIC
562 bool "Support event registration at runtime"
563 default y if SANDBOX
564 help
565 Enable this to support adding an event spy at runtime, without adding
566 it to the EVENT_SPy() linker list. This increases code size slightly
567 but provides more flexibility for boards and subsystems that need it.
568
569config EVENT_DEBUG
570 bool "Enable event debugging assistance"
571 default y if SANDBOX
572 help
573 Enable this get usefui features for seeing what is happening with
574 events, such as event-type names. This adds to the code size of
575 U-Boot so can be turned off for production builds.
576
577endif # EVENT
578
Simon Glass62adede2017-01-23 13:31:19 -0700579config ARCH_EARLY_INIT_R
580 bool "Call arch-specific init soon after relocation"
Simon Glass62adede2017-01-23 13:31:19 -0700581 help
582 With this option U-Boot will call arch_early_init_r() soon after
583 relocation. Driver model is running by this point, and the cache
584 is on. Note that board_early_init_r() is called first, if
585 enabled. This can be used to set up architecture-specific devices.
586
Simon Glass95d31412017-01-23 13:31:21 -0700587config ARCH_MISC_INIT
588 bool "Call arch-specific init after relocation, when console is ready"
589 help
590 With this option U-Boot will call arch_misc_init() after
591 relocation to allow miscellaneous arch-dependent initialisation
592 to be performed. This function should be defined by the board
Chris Packham83ad2482019-01-11 15:30:50 +1300593 and will be called after the console is set up, after relocation.
Simon Glass95d31412017-01-23 13:31:21 -0700594
Simon Glass7a99a872017-01-23 13:31:20 -0700595config BOARD_EARLY_INIT_F
596 bool "Call board-specific init before relocation"
Simon Glass7a99a872017-01-23 13:31:20 -0700597 help
598 Some boards need to perform initialisation as soon as possible
599 after boot. With this option, U-Boot calls board_early_init_f()
600 after driver model is ready in the pre-relocation init sequence.
601 Note that the normal serial console is not yet set up, but the
602 debug UART will be available if enabled.
603
Mario Six75b23ed2018-03-28 14:38:15 +0200604config BOARD_EARLY_INIT_R
605 bool "Call board-specific init after relocation"
606 help
607 Some boards need to perform initialisation as directly after
608 relocation. With this option, U-Boot calls board_early_init_r()
609 in the post-relocation init sequence.
610
Tom Rinid02971e2022-02-25 11:19:47 -0500611config BOARD_POSTCLK_INIT
612 bool "Call board_postclk_init"
613 help
614 Some boards need this to initialize select items, after clocks /
615 timebase and before env / serial.
616
Simon Glass227a1242020-09-10 20:21:23 -0600617config BOARD_LATE_INIT
618 bool "Execute Board late init"
619 help
620 Sometimes board require some initialization code that might
621 require once the actual init done, example saving board specific env,
622 boot-modes etc. which eventually done at late.
623
624 So this config enable the late init code with the help of board_late_init
625 function which should defined on respective boards.
626
Tom Rini2bfc77a2022-03-23 17:20:08 -0400627config CLOCKS
628 bool "Call set_cpu_clk_info"
629 depends on ARM
630
Tom Rini0a250692021-12-12 22:12:34 -0500631config SYS_FSL_CLK
632 bool
633 depends on ARCH_LS1021A || FSL_LSCH2 || FSL_LSCH3 || \
634 (FSL_ESDHC_IMX && (ARCH_MX5 || ARCH_MX6 || ARCH_MX7))
635 default y
636 help
637 Enable to call get_clocks() in board_init_f() for platforms other
638 than PowerPC or M68k. This is a legacy option. If not TARGET_BRPPT2
639
Mario Six8febc7a2018-03-28 14:38:16 +0200640config LAST_STAGE_INIT
641 bool "Call board-specific as last setup step"
642 help
643 Some boards need to perform initialisation immediately before control
644 is passed to the command-line interpreter (e.g. for initializations
645 that depend on later phases in the init sequence). With this option,
646 U-Boot calls last_stage_init() before the command-line interpreter is
647 started.
648
Simon Glass227a1242020-09-10 20:21:23 -0600649config MISC_INIT_R
650 bool "Execute Misc Init"
651 default y if ARCH_KEYSTONE || ARCH_SUNXI || MPC85xx
652 default y if ARCH_OMAP2PLUS && !AM33XX
653 help
654 Enabling this option calls 'misc_init_r' function
655
Tom Rini47805502022-05-12 16:45:08 -0400656config SYS_MALLOC_BOOTPARAMS
657 bool "Malloc a buffer to use for bootparams"
658 help
659 In some cases rather than using a known location to store the
660 bi_boot_params portion of gd we need to allocate it from our malloc pool.
661
662config SYS_BOOTPARAMS_LEN
663 hex "Size of the bootparam buffer to malloc in bytes"
664 depends on SYS_MALLOC_BOOTPARAMS
665 default 0x20000 if MIPS || RCAR_GEN3
666 default 0x10000
667
Tom Rini4abdf142021-08-17 17:59:41 -0400668config ID_EEPROM
669 bool "Enable I2C connected system identifier EEPROM"
670 help
671 A number of different systems and vendors enable a vendor-specified
672 EEPROM that contains various identifying features.
673
Ovidiu Panait6746c672020-05-06 20:38:44 +0300674config PCI_INIT_R
675 bool "Enumerate PCI buses during init"
676 depends on PCI
Ovidiu Panait6746c672020-05-06 20:38:44 +0300677 help
678 With this option U-Boot will call pci_init() soon after relocation,
679 which will enumerate PCI buses. This is needed, for instance, in the
680 case of DM PCI-based Ethernet devices, which will not be detected
681 without having the enumeration performed earlier.
682
Tom Rini356c6742022-03-18 08:38:20 -0400683config RESET_PHY_R
684 bool "Reset ethernet PHY during init"
685 help
686 Implement reset_phy() in board code if required to reset the ethernet
687 PHY.
688
Simon Glass62adede2017-01-23 13:31:19 -0700689endmenu
690
Simon Glassd613b2a2020-09-10 20:21:22 -0600691endmenu # Init options
692
Simon Glassb22ec7a2017-05-17 09:05:34 -0600693menu "Security support"
694
695config HASH
696 bool # "Support hashing API (SHA1, SHA256, etc.)"
697 help
698 This provides a way to hash data in memory using various supported
699 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
700 and the algorithms it supports are defined in common/hash.c. See
701 also CMD_HASH for command-line access.
702
Igor Opaniuke0df0352018-07-17 14:33:25 +0300703config AVB_VERIFY
704 bool "Build Android Verified Boot operations"
Usama Arifdf348b02020-08-11 15:46:03 +0100705 depends on LIBAVB
Heinrich Schuchardt9fb7c492021-01-25 12:17:57 +0100706 depends on MMC
Eugeniu Roscad6d35972018-08-14 02:43:05 +0200707 depends on PARTITION_UUIDS
Igor Opaniuke0df0352018-07-17 14:33:25 +0300708 help
709 This option enables compilation of bootloader-dependent operations,
710 used by Android Verified Boot 2.0 library (libavb). Includes:
711 * Helpers to process strings in order to build OS bootargs.
712 * Helpers to access MMC, similar to drivers/fastboot/fb_mmc.c.
713 * Helpers to alloc/init/free avb ops.
714
Usama Arifdf348b02020-08-11 15:46:03 +0100715if AVB_VERIFY
716
717config AVB_BUF_ADDR
718 hex "Define AVB buffer address"
719 default FASTBOOT_BUF_ADDR
720 help
721 AVB requires a buffer for memory transactions. This variable defines the
722 buffer address.
723
724config AVB_BUF_SIZE
725 hex "Define AVB buffer SIZE"
726 default FASTBOOT_BUF_SIZE
727 help
728 AVB requires a buffer for memory transactions. This variable defines the
729 buffer size.
730
731endif # AVB_VERIFY
732
Jorge Ramirez-Ortiz9127d8b2021-02-14 16:27:23 +0100733config SCP03
734 bool "Build SCP03 - Secure Channel Protocol O3 - controls"
735 depends on OPTEE || SANDBOX
736 depends on TEE
737 help
738 This option allows U-Boot to enable and or provision SCP03 on an OPTEE
739 controlled Secured Element.
740
Simon Glassa4bea1f2018-11-06 15:21:28 -0700741config SPL_HASH
742 bool # "Support hashing API (SHA1, SHA256, etc.)"
743 help
744 This provides a way to hash data in memory using various supported
745 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
746 and the algorithms it supports are defined in common/hash.c. See
747 also CMD_HASH for command-line access.
748
749config TPL_HASH
750 bool # "Support hashing API (SHA1, SHA256, etc.)"
751 help
752 This provides a way to hash data in memory using various supported
753 algorithms (such as SHA1, MD5, CRC32). The API is defined in hash.h
754 and the algorithms it supports are defined in common/hash.c. See
755 also CMD_HASH for command-line access.
756
Joel Peshkin369d87a2021-04-11 11:21:58 +0200757config STACKPROTECTOR
758 bool "Stack Protector buffer overflow detection"
Joel Peshkin369d87a2021-04-11 11:21:58 +0200759 help
760 Enable stack smash detection through compiler's stack-protector
761 canary logic
762
763config SPL_STACKPROTECTOR
764 bool "Stack Protector buffer overflow detection for SPL"
765 depends on STACKPROTECTOR && SPL
Joel Peshkin369d87a2021-04-11 11:21:58 +0200766
767config TPL_STACKPROTECTOR
768 bool "Stack Protector buffer overflow detection for TPL"
769 depends on STACKPROTECTOR && TPL
Joel Peshkin369d87a2021-04-11 11:21:58 +0200770
Simon Glassb22ec7a2017-05-17 09:05:34 -0600771endmenu
772
Marek Vasut055fc402018-02-10 16:22:06 +0100773menu "Update support"
774
AKASHI Takahiro768d58d2020-10-29 13:47:43 +0900775config UPDATE_COMMON
776 bool
AKASHI Takahiro768d58d2020-10-29 13:47:43 +0900777 select DFU_WRITE_ALT
778
Marek Vasut055fc402018-02-10 16:22:06 +0100779config UPDATE_TFTP
780 bool "Auto-update using fitImage via TFTP"
781 depends on FIT
AKASHI Takahiro768d58d2020-10-29 13:47:43 +0900782 select UPDATE_COMMON
Marek Vasut055fc402018-02-10 16:22:06 +0100783 help
784 This option allows performing update of NOR with data in fitImage
785 sent via TFTP boot.
786
787config UPDATE_TFTP_CNT_MAX
788 int "The number of connection retries during auto-update"
789 default 0
790 depends on UPDATE_TFTP
791
792config UPDATE_TFTP_MSEC_MAX
793 int "Delay in mSec to wait for the TFTP server during auto-update"
794 default 100
795 depends on UPDATE_TFTP
796
AKASHI Takahiro768d58d2020-10-29 13:47:43 +0900797config UPDATE_FIT
798 bool "Firmware update using fitImage"
799 depends on FIT
800 depends on DFU
801 select UPDATE_COMMON
802 help
803 This option allows performing update of DFU-capable storage with
804 data in fitImage.
805
Ruslan Trofymenko3b7dc912019-07-05 15:37:32 +0300806config ANDROID_AB
807 bool "Android A/B updates"
Ruslan Trofymenko3b7dc912019-07-05 15:37:32 +0300808 help
809 If enabled, adds support for the new Android A/B update model. This
810 allows the bootloader to select which slot to boot from based on the
811 information provided by userspace via the Android boot_ctrl HAL. This
812 allows a bootloader to try a new version of the system but roll back
813 to previous version if the new one didn't boot all the way.
814
Marek Vasut055fc402018-02-10 16:22:06 +0100815endmenu
816
Simon Glass712bd2d2018-11-15 18:43:50 -0700817menu "Blob list"
818
819config BLOBLIST
820 bool "Support for a bloblist"
821 help
822 This enables support for a bloblist in U-Boot, which can be passed
823 from TPL to SPL to U-Boot proper (and potentially to Linux). The
824 blob list supports multiple binary blobs of data, each with a tag,
825 so that different U-Boot components can store data which can survive
Simon Glasse94421b2022-01-12 19:26:21 -0700826 through to the next phase of the boot.
Simon Glass712bd2d2018-11-15 18:43:50 -0700827
828config SPL_BLOBLIST
829 bool "Support for a bloblist in SPL"
Simon Glass9b92ea42022-04-30 00:56:48 -0600830 depends on BLOBLIST && SPL_LIBGENERIC_SUPPORT && SPL_LIBCOMMON_SUPPORT
Simon Glass712bd2d2018-11-15 18:43:50 -0700831 default y if SPL
832 help
833 This enables a bloblist in SPL. If this is the first part of U-Boot
834 to run, then the bloblist is set up in SPL and passed to U-Boot
835 proper. If TPL also has a bloblist, then SPL uses the one from there.
836
837config TPL_BLOBLIST
838 bool "Support for a bloblist in TPL"
Simon Glass9b92ea42022-04-30 00:56:48 -0600839 depends on BLOBLIST && TPL_LIBGENERIC_SUPPORT && TPL_LIBCOMMON_SUPPORT
Simon Glass712bd2d2018-11-15 18:43:50 -0700840 default y if TPL
841 help
842 This enables a bloblist in TPL. The bloblist is set up in TPL and
843 passed to SPL and U-Boot proper.
844
Simon Glasse7ca7da2022-04-30 00:56:53 -0600845config VPL_BLOBLIST
846 bool "Support for a bloblist in VPL"
847 depends on BLOBLIST && VPL_LIBGENERIC_SUPPORT && VPL_LIBCOMMON_SUPPORT
848 default y if VPL
849 help
850 This enables a bloblist in VPL. The bloblist is set up in VPL and
851 passed to SPL and U-Boot proper.
852
Simon Glass5d2199d2021-11-03 21:09:20 -0600853if BLOBLIST
854
Simon Glassc6fcb942022-01-12 19:26:22 -0700855choice
856 prompt "Bloblist location"
Simon Glass712bd2d2018-11-15 18:43:50 -0700857 help
Simon Glassc6fcb942022-01-12 19:26:22 -0700858 Select the location of the bloblist, via various means.
859
860config BLOBLIST_FIXED
861 bool "Place bloblist at a fixed address in memory"
862 help
863 Select this to used a fixed memory address for the bloblist. If the
864 bloblist exists at this address from a previous phase, it used as is.
865 If not it is created at this address in U-Boot.
Simon Glass712bd2d2018-11-15 18:43:50 -0700866
Simon Glass5d2199d2021-11-03 21:09:20 -0600867config BLOBLIST_ALLOC
868 bool "Allocate bloblist"
869 help
870 Allocate the bloblist using malloc(). This avoids the need to
871 specify a fixed address on systems where this is unknown or can
872 change at runtime.
873
Simon Glassc6fcb942022-01-12 19:26:22 -0700874endchoice
875
Simon Glass712bd2d2018-11-15 18:43:50 -0700876config BLOBLIST_ADDR
877 hex "Address of bloblist"
Simon Glass1e198a62021-07-05 16:32:48 -0600878 default 0xc000 if SANDBOX
Simon Glassc6fcb942022-01-12 19:26:22 -0700879 depends on BLOBLIST_FIXED
Simon Glass712bd2d2018-11-15 18:43:50 -0700880 help
881 Sets the address of the bloblist, set up by the first part of U-Boot
Simon Glasse94421b2022-01-12 19:26:21 -0700882 which runs. Subsequent U-Boot phases typically use the same address.
Simon Glass712bd2d2018-11-15 18:43:50 -0700883
Simon Glass5d2199d2021-11-03 21:09:20 -0600884 This is not used if BLOBLIST_ALLOC is selected.
885
Simon Glassc6fcb942022-01-12 19:26:22 -0700886config BLOBLIST_SIZE
887 hex "Size of bloblist"
888 default 0x400
889 help
890 Sets the size of the bloblist in bytes. This must include all
891 overhead (alignment, bloblist header, record header). The bloblist
892 is set up in the first part of U-Boot to run (TPL, SPL or U-Boot
893 proper), and this sane bloblist is used for subsequent phases.
894
Simon Glassab7e7462021-01-13 20:29:43 -0700895config BLOBLIST_SIZE_RELOC
896 hex "Size of bloblist after relocation"
Simon Glassc6fcb942022-01-12 19:26:22 -0700897 default BLOBLIST_SIZE if BLOBLIST_FIXED || BLOBLIST_ALLOC
898 default 0 if BLOBLIST_PASSAGE
Simon Glassab7e7462021-01-13 20:29:43 -0700899 help
900 Sets the size of the bloblist in bytes after relocation. Since U-Boot
901 has a lot more memory available then, it is possible to use a larger
902 size than the one set up by SPL. This bloblist is set up during the
903 relocation process.
904
Simon Glass5d2199d2021-11-03 21:09:20 -0600905endif # BLOBLIST
906
Simon Glassc6fcb942022-01-12 19:26:22 -0700907if SPL_BLOBLIST
908
909choice
910 prompt "Bloblist location in SPL"
911 help
912 Select the location of the bloblist, via various means. Typically
913 you should use the same value for SPL as for U-Boot, since they need
914 to look in the same place. But if BLOBLIST_ALLOC is used, then a
915 fresh bloblist will be created each time, since there is no shared
916 address (between phases) for the bloblist.
917
918config SPL_BLOBLIST_FIXED
919 bool "Place bloblist at a fixed address in memory"
920 help
921 Select this to used a fixed memory address for the bloblist. If the
922 bloblist exists at this address from a previous phase, it used as is.
923 If not it is created at this address in SPL.
924
925config SPL_BLOBLIST_ALLOC
926 bool "Allocate bloblist"
927 help
928 Allocate the bloblist using malloc(). This avoids the need to
929 specify a fixed address on systems where this is unknown or can
930 change at runtime.
931
932endchoice
933
934endif # SPL_BLOBLIST
935
936if TPL_BLOBLIST
937
938choice
939 prompt "Bloblist location in TPL"
940 help
941 Select the location of the bloblist, via various means. Typically
942 you should use the same value for SPL as for U-Boot, since they need
943 to look in the same place. But if BLOBLIST_ALLOC is used, then a
944 fresh bloblist will be created each time, since there is no shared
945 address (between phases) for the bloblist.
946
947config TPL_BLOBLIST_FIXED
948 bool "Place bloblist at a fixed address in memory"
949 help
950 Select this to used a fixed memory address for the bloblist. If the
951 bloblist exists at this address from a previous phase, it used as is.
952 If not it is created at this address in TPL.
953
954config TPL_BLOBLIST_ALLOC
955 bool "Allocate bloblist"
956 help
957 Allocate the bloblist using malloc(). This avoids the need to
958 specify a fixed address on systems where this is unknown or can
959 change at runtime.
960
961endchoice
962
963endif # TPL_BLOBLIST
964
Simon Glass712bd2d2018-11-15 18:43:50 -0700965endmenu
966
Simon Glassffe19762016-09-12 23:18:22 -0600967source "common/spl/Kconfig"
AKASHI Takahiro2223c7d2020-02-21 15:12:55 +0900968
969config IMAGE_SIGN_INFO
970 bool
971 select SHA1
972 select SHA256
973 help
974 Enable image_sign_info helper functions.
Heinrich Schuchardte52bd932020-04-15 18:46:21 +0200975
976if IMAGE_SIGN_INFO
977
978config SPL_IMAGE_SIGN_INFO
979 bool
980 select SHA1
981 select SHA256
982 help
983 Enable image_sign_info helper functions in SPL.
984
985endif
Patrick Delaunayec058982021-11-15 16:32:17 +0100986
987config FDT_SIMPLEFB
988 bool "FDT tools for simplefb support"
989 depends on OF_LIBFDT
990 help
991 Enable the fdt tools to manage the simple fb nodes in device tree.
992 These functions can be used by board to indicate to the OS
993 the presence of the simple frame buffer with associated reserved
994 memory