blob: f68553c2a0bbf5209ffa8032ee16c038f29597e0 [file] [log] [blame]
Patrick Georgic49d7a32020-05-08 22:50:46 +02001## SPDX-License-Identifier: GPL-2.0-only
Patrick Georgi0588d192009-08-12 15:00:51 +00002
Uwe Hermannad8c95f2012-04-12 22:00:03 +02003mainmenu "coreboot configuration"
Patrick Georgi0588d192009-08-12 15:00:51 +00004
Uwe Hermannc04be932009-10-05 13:55:28 +00005menu "General setup"
6
Lee Leahybb70c402017-04-03 07:38:20 -07007config COREBOOT_BUILD
8 bool
9 default y
10
Uwe Hermannc04be932009-10-05 13:55:28 +000011config LOCALVERSION
Uwe Hermann168b11b2009-10-07 16:15:40 +000012 string "Local version string"
Uwe Hermannc04be932009-10-05 13:55:28 +000013 help
14 Append an extra string to the end of the coreboot version.
15
Uwe Hermann168b11b2009-10-07 16:15:40 +000016 This can be useful if, for instance, you want to append the
17 respective board's hostname or some other identifying string to
18 the coreboot version number, so that you can easily distinguish
19 boot logs of different boards from each other.
20
Arthur Heymans6f751542019-06-08 11:28:52 +020021config CONFIGURABLE_CBFS_PREFIX
22 bool
23 help
24 Select this to prompt to use to configure the prefix for cbfs files.
25
Arthur Heymans6010eb22019-10-06 13:34:20 +020026choice
27 prompt "CBFS prefix to use"
28 depends on CONFIGURABLE_CBFS_PREFIX
29 default CBFS_PREFIX_FALLBACK
30
31config CBFS_PREFIX_FALLBACK
32 bool "fallback"
33
34config CBFS_PREFIX_NORMAL
35 bool "normal"
36
37config CBFS_PREFIX_DIY
38 bool "Define your own cbfs prefix"
39
40endchoice
41
Patrick Georgi4b8a2412010-02-09 19:35:16 +000042config CBFS_PREFIX
Arthur Heymans6010eb22019-10-06 13:34:20 +020043 string "CBFS prefix to use" if CBFS_PREFIX_DIY
44 default "fallback" if !CONFIGURABLE_CBFS_PREFIX || CBFS_PREFIX_FALLBACK
45 default "normal" if CBFS_PREFIX_NORMAL
Patrick Georgi4b8a2412010-02-09 19:35:16 +000046 help
47 Select the prefix to all files put into the image. It's "fallback"
48 by default, "normal" is a common alternative.
49
Patrick Georgi23d89cc2010-03-16 01:17:19 +000050choice
Uwe Hermannad8c95f2012-04-12 22:00:03 +020051 prompt "Compiler to use"
Patrick Georgi23d89cc2010-03-16 01:17:19 +000052 default COMPILER_GCC
53 help
54 This option allows you to select the compiler used for building
55 coreboot.
Martin Rotha5a628e82016-01-19 12:01:09 -070056 You must build the coreboot crosscompiler for the board that you
57 have selected.
58
59 To build all the GCC crosscompilers (takes a LONG time), run:
60 make crossgcc
61
62 For help on individual architectures, run the command:
63 make help_toolchain
Patrick Georgi23d89cc2010-03-16 01:17:19 +000064
65config COMPILER_GCC
66 bool "GCC"
Uwe Hermannad8c95f2012-04-12 22:00:03 +020067 help
68 Use the GNU Compiler Collection (GCC) to build coreboot.
69
70 For details see http://gcc.gnu.org.
71
Patrick Georgi23d89cc2010-03-16 01:17:19 +000072config COMPILER_LLVM_CLANG
Arthur Heymans5b528bc2022-03-24 10:38:54 +010073 bool "LLVM/clang"
74 depends on ALLOW_EXPERIMENTAL_CLANG || ARCH_SUPPORTS_CLANG
Uwe Hermannad8c95f2012-04-12 22:00:03 +020075 help
Martin Rotha5a628e82016-01-19 12:01:09 -070076 Use LLVM/clang to build coreboot. To use this, you must build the
77 coreboot version of the clang compiler. Run the command
78 make clang
Arthur Heymans5b528bc2022-03-24 10:38:54 +010079 Note that Clang is not currently working on all architectures.
Uwe Hermannad8c95f2012-04-12 22:00:03 +020080
81 For details see http://clang.llvm.org.
82
Patrick Georgi23d89cc2010-03-16 01:17:19 +000083endchoice
84
Arthur Heymans5b528bc2022-03-24 10:38:54 +010085config ARCH_SUPPORTS_CLANG
86 bool
87 help
88 Opt-in flag for architectures that generally work well with CLANG.
89 By default the option would be hidden.
90
91config ALLOW_EXPERIMENTAL_CLANG
92 bool "Allow experimental LLVM/Clang"
93 depends on !ARCH_SUPPORTS_CLANG
94 help
95 On some architectures CLANG does not work that well.
96 Use this only to try to get CLANG working.
97
Patrick Georgi9b0de712013-12-29 18:45:23 +010098config ANY_TOOLCHAIN
99 bool "Allow building with any toolchain"
100 default n
Patrick Georgi9b0de712013-12-29 18:45:23 +0100101 help
102 Many toolchains break when building coreboot since it uses quite
Martin Roth4ef61b12022-05-28 12:34:44 -0600103 unusual linker features. Unless developers explicitly request it,
Patrick Georgi9b0de712013-12-29 18:45:23 +0100104 we'll have to assume that they use their distro compiler by mistake.
105 Make sure that using patched compilers is a conscious decision.
106
Patrick Georgi516a2a72010-03-25 21:45:25 +0000107config CCACHE
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200108 bool "Use ccache to speed up (re)compilation"
Patrick Georgi516a2a72010-03-25 21:45:25 +0000109 default n
110 help
111 Enables the use of ccache for faster builds.
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200112
113 Requires the ccache utility in your system $PATH.
114
115 For details see https://ccache.samba.org.
Patrick Georgi516a2a72010-03-25 21:45:25 +0000116
Martin Roth461c33b2022-09-27 18:13:48 -0600117config IWYU
118 bool "Test platform with include-what-you-use"
119 help
120 This runs each source file through the include-what-you-use tool
121 to check the header includes.
122
Sol Boucher69b88bf2015-02-26 11:47:19 -0800123config FMD_GENPARSER
124 bool "Generate flashmap descriptor parser using flex and bison"
125 default n
Sol Boucher69b88bf2015-02-26 11:47:19 -0800126 help
127 Enable this option if you are working on the flashmap descriptor
128 parser and made changes to fmd_scanner.l or fmd_parser.y.
129
130 Otherwise, say N to use the provided pregenerated scanner/parser.
131
Martin Rothf411b702017-04-09 19:12:42 -0600132config UTIL_GENPARSER
Patrick Georgi615cdfc2021-09-06 16:59:56 +0200133 bool "Generate parsers for bincfg, sconfig and kconfig locally"
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000134 default n
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000135 help
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200136 Enable this option if you are working on the sconfig device tree
Denis 'GNUtoo' Carikli780e9312018-01-10 14:35:55 +0100137 parser or bincfg and made changes to the .l or .y files.
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200138
Sol Boucher69b88bf2015-02-26 11:47:19 -0800139 Otherwise, say N to use the provided pregenerated scanner/parser.
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000140
Angel Pons17852e62021-05-20 15:30:59 +0200141choice
142 prompt "Option backend to use"
Angel Pons9bc780f2021-05-20 16:43:08 +0200143 default USE_MAINBOARD_SPECIFIC_OPTION_BACKEND if HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
Angel Pons17852e62021-05-20 15:30:59 +0200144 default USE_OPTION_TABLE if NVRAMCUI_SECONDARY_PAYLOAD
145
146config OPTION_BACKEND_NONE
147 bool "None"
148
Joe Korty6d772522010-05-19 18:41:15 +0000149config USE_OPTION_TABLE
150 bool "Use CMOS for configuration values"
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000151 depends on HAVE_OPTION_TABLE
Joe Korty6d772522010-05-19 18:41:15 +0000152 help
153 Enable this option if coreboot shall read options from the "CMOS"
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200154 NVRAM instead of using hard-coded values.
Joe Korty6d772522010-05-19 18:41:15 +0000155
Angel Pons9bc780f2021-05-20 16:43:08 +0200156config USE_MAINBOARD_SPECIFIC_OPTION_BACKEND
157 bool "Use mainboard-specific option backend"
158 depends on HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
159 help
160 Use a mainboard-specific mechanism to access runtime-configurable
161 options.
162
Angel Pons17852e62021-05-20 15:30:59 +0200163endchoice
164
Timothy Pearsonf20c6e82015-02-14 16:15:31 -0600165config STATIC_OPTION_TABLE
166 bool "Load default configuration values into CMOS on each boot"
Timothy Pearsonf20c6e82015-02-14 16:15:31 -0600167 depends on USE_OPTION_TABLE
168 help
169 Enable this option to reset "CMOS" NVRAM values to default on
170 every boot. Use this if you want the NVRAM configuration to
171 never be modified from its default values.
172
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000173config COMPRESS_RAMSTAGE
174 bool "Compress ramstage with LZMA"
Subrata Banikb5962a92019-06-08 12:29:02 +0530175 depends on HAVE_RAMSTAGE
Martin Roth75e5cb72016-12-15 15:05:37 -0700176 # Default value set at the end of the file
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000177 help
Arthur Heymans7f229332019-11-08 11:59:25 +0100178 Compress ramstage to save memory in the flash image.
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000179
Julius Werner09f29212015-09-29 13:51:35 -0700180config COMPRESS_PRERAM_STAGES
181 bool "Compress romstage and verstage with LZ4"
Arthur Heymanse146fbd2019-11-04 18:57:06 +0100182 depends on (HAVE_ROMSTAGE || HAVE_VERSTAGE) && NO_XIP_EARLY_STAGES
Martin Roth75e5cb72016-12-15 15:05:37 -0700183 # Default value set at the end of the file
Julius Werner09f29212015-09-29 13:51:35 -0700184 help
185 Compress romstage and (if it exists) verstage with LZ4 to save flash
186 space and speed up boot, since the time for reading the image from SPI
187 (and in the vboot case verifying it) is usually much greater than the
Arthur Heymanse146fbd2019-11-04 18:57:06 +0100188 time spent decompressing. Doesn't work for XIP stages for obvious
189 reasons.
Julius Werner09f29212015-09-29 13:51:35 -0700190
Julius Werner99f46832018-05-16 14:14:04 -0700191config COMPRESS_BOOTBLOCK
192 bool
Subrata Banikb5962a92019-06-08 12:29:02 +0530193 depends on HAVE_BOOTBLOCK
Julius Werner99f46832018-05-16 14:14:04 -0700194 help
195 This option can be used to compress the bootblock with LZ4 and attach
196 a small self-decompression stub to its front. This can drastically
197 reduce boot time on platforms where the bootblock is loaded over a
198 very slow connection and bootblock size trumps all other factors for
Jonathan Neuschäfer2930a722018-09-29 17:42:52 +0200199 speed. Since using this option usually requires changes to the
Julius Werner99f46832018-05-16 14:14:04 -0700200 SoC memlayout and possibly extra support code, it should not be
201 user-selectable. (There's no real point in offering this to the user
202 anyway... if it works and saves boot time, you would always want it.)
203
Cristian Măgherușan-Stanciud367b002011-06-19 03:03:28 +0200204config INCLUDE_CONFIG_FILE
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200205 bool "Include the coreboot .config file into the ROM image"
Martin Roth75e5cb72016-12-15 15:05:37 -0700206 # Default value set at the end of the file
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200207 help
208 Include the .config file that was used to compile coreboot
209 in the (CBFS) ROM image. This is useful if you want to know which
210 options were used to build a specific coreboot.rom image.
211
Daniele Forsi53847a22014-07-22 18:00:56 +0200212 Saying Y here will increase the image size by 2-3KB.
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200213
Julius Werner4924cdb2022-11-16 17:48:46 -0800214 You can then use cbfstool to extract the config from a final image:
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200215
Julius Werner4924cdb2022-11-16 17:48:46 -0800216 cbfstool coreboot.rom extract -n config -f <output file path>
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200217
218 Alternatively, you can also use cbfstool to print the image
219 contents (including the raw 'config' item we're looking for).
220
221 Example:
222
223 $ cbfstool coreboot.rom print
224 coreboot.rom: 4096 kB, bootblocksize 1008, romsize 4194304,
225 offset 0x0
226 Alignment: 64 bytes
Steve Goodrichf0269122012-05-18 11:18:47 -0600227
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200228 Name Offset Type Size
Elyes HAOUAS2119d0b2020-02-16 10:01:33 +0100229 cmos_layout.bin 0x0 CMOS layout 1159
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200230 fallback/romstage 0x4c0 stage 339756
Daniele Forsi53847a22014-07-22 18:00:56 +0200231 fallback/ramstage 0x53440 stage 186664
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200232 fallback/payload 0x80dc0 payload 51526
233 config 0x8d740 raw 3324
234 (empty) 0x8e480 null 3610440
Cristian Măgherușan-Stanciud367b002011-06-19 03:03:28 +0200235
Vadim Bendebury9202473d2011-09-21 14:46:43 -0700236config COLLECT_TIMESTAMPS
237 bool "Create a table of timestamps collected during boot"
Paul Menzel4e4a7632015-10-11 11:57:44 +0200238 default y if ARCH_X86
Vadim Bendebury9202473d2011-09-21 14:46:43 -0700239 help
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200240 Make coreboot create a table of timer-ID/timer-value pairs to
241 allow measuring time spent at different phases of the boot process.
242
Martin Rothb22bbe22018-03-07 15:32:16 -0700243config TIMESTAMPS_ON_CONSOLE
244 bool "Print the timestamp values on the console"
245 default n
246 depends on COLLECT_TIMESTAMPS
247 help
Kyösti Mälkki8b93cb72020-01-09 08:41:46 +0200248 Print the timestamps to the debug console if enabled at level info.
Martin Rothb22bbe22018-03-07 15:32:16 -0700249
Patrick Georgi7e9b9d82012-04-30 21:06:10 +0200250config USE_BLOBS
251 bool "Allow use of binary-only repository"
Felix Helda6b887e2019-12-28 19:10:12 +0100252 default y
Patrick Georgi7e9b9d82012-04-30 21:06:10 +0200253 help
254 This draws in the blobs repository, which contains binary files that
255 might be required for some chipsets or boards.
256 This flag ensures that a "Free" option remains available for users.
257
Marshall Dawson20ce4002019-10-28 15:55:03 -0600258config USE_AMD_BLOBS
259 bool "Allow AMD blobs repository (with license agreement)"
260 depends on USE_BLOBS
261 help
262 This draws in the amd_blobs repository, which contains binary files
263 distributed by AMD, including VBIOS, PSP bootloaders, SMU firmwares,
264 etc. Selecting this item to download or clone the repo implies your
265 agreement to the AMD license agreement. A copy of the license text
266 may be reviewed by reading Documentation/soc/amd/amdblobs_license.md,
267 and your copy of the license is present in the repo once downloaded.
268
269 Note that for some products, omitting PSP, SMU images, or other items
270 may result in a nonbooting coreboot.rom.
271
Julius Wernerbc1cb382020-06-18 15:03:22 -0700272config USE_QC_BLOBS
Benjamin Doron999d29e2020-07-01 01:47:22 +0000273 bool "Allow QC blobs repository (selecting this agrees to the license!)"
Julius Wernerbc1cb382020-06-18 15:03:22 -0700274 depends on USE_BLOBS
275 help
276 This draws in the qc_blobs repository, which contains binary files
277 distributed by Qualcomm that are required to build firmware for
278 certain Qualcomm SoCs (including QcLib, QC-SEC, qtiseclib and QUP
279 firmware). If you say Y here you are implicitly agreeing to the
280 Qualcomm license agreement which can be found at:
281 https://review.coreboot.org/cgit/qc_blobs.git/tree/LICENSE
282
283 *****************************************************
284 PLEASE MAKE SURE YOU READ AND AGREE TO ALL TERMS IN
285 ABOVE LICENSE AGREEMENT BEFORE SELECTING THIS OPTION!
286 *****************************************************
287
288 Not selecting this option means certain Qualcomm SoCs and related
289 mainboards cannot be built and will be hidden from the "Mainboards"
290 section.
291
Stefan Reinauerd37ab452012-12-18 16:23:28 -0800292config COVERAGE
293 bool "Code coverage support"
294 depends on COMPILER_GCC
Stefan Reinauerd37ab452012-12-18 16:23:28 -0800295 help
296 Add code coverage support for coreboot. This will store code
297 coverage information in CBMEM for extraction from user space.
298 If unsure, say N.
299
Ryan Salsamendiab37e9a2017-06-11 21:07:31 -0700300config UBSAN
301 bool "Undefined behavior sanitizer support"
302 default n
303 help
304 Instrument the code with checks for undefined behavior. If unsure,
305 say N because it adds a small performance penalty and may abort
306 on code that happens to work in spite of the UB.
307
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700308config HAVE_ASAN_IN_ROMSTAGE
309 bool
Harshit Sharma2bcaba02020-06-09 20:25:16 -0700310 default n
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700311
312config ASAN_IN_ROMSTAGE
313 bool
314 default n
315 help
316 Enable address sanitizer in romstage for platform.
317
318config HAVE_ASAN_IN_RAMSTAGE
319 bool
320 default n
321
322config ASAN_IN_RAMSTAGE
323 bool
324 default n
325 help
326 Enable address sanitizer in ramstage for platform.
327
328config ASAN
329 bool "Address sanitizer support"
330 default n
331 select ASAN_IN_ROMSTAGE if HAVE_ASAN_IN_ROMSTAGE
332 select ASAN_IN_RAMSTAGE if HAVE_ASAN_IN_RAMSTAGE
Arthur Heymans25a0c672022-03-24 00:15:46 +0100333 depends on COMPILER_GCC
Harshit Sharma2bcaba02020-06-09 20:25:16 -0700334 help
335 Enable address sanitizer - runtime memory debugger,
336 designed to find out-of-bounds accesses and use-after-scope bugs.
337
338 This feature consumes up to 1/8 of available memory and brings about
339 ~1.5x performance slowdown.
340
341 If unsure, say N.
342
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700343if ASAN
Harshit Sharma3b9cc852020-07-06 23:38:31 -0700344 comment "Before using this feature, make sure that "
345 comment "asan_shadow_offset_callback patch is applied to GCC."
346endif
347
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200348choice
349 prompt "Stage Cache for ACPI S3 resume"
Reka Norman166c3032022-12-19 11:11:48 +1100350 default NO_STAGE_CACHE if !HAVE_ACPI_RESUME || MAINBOARD_DISABLE_STAGE_CACHE
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200351 default TSEG_STAGE_CACHE if SMM_TSEG
352
353config NO_STAGE_CACHE
354 bool "Disabled"
355 help
356 Do not save any component in stage cache for resume path. On resume,
357 all components would be read back from CBFS again.
358
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300359config TSEG_STAGE_CACHE
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200360 bool "TSEG"
361 depends on SMM_TSEG
Stefan Reinauer58470e32014-10-17 13:08:36 +0200362 help
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300363 The option enables stage cache support for platform. Platform
364 can stash copies of postcar, ramstage and raw runtime data
365 inside SMM TSEG, to be restored on S3 resume path.
366
367config CBMEM_STAGE_CACHE
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200368 bool "CBMEM"
369 depends on !SMM_TSEG
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300370 help
371 The option enables stage cache support for platform. Platform
372 can stash copies of postcar, ramstage and raw runtime data
373 inside CBMEM.
374
375 While the approach is faster than reloading stages from boot media
376 it is also a possible attack scenario via which OS can possibly
377 circumvent SMM locks and SPI write protections.
378
379 If unsure, select 'N'
Stefan Reinauer58470e32014-10-17 13:08:36 +0200380
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200381endchoice
382
Reka Norman166c3032022-12-19 11:11:48 +1100383config MAINBOARD_DISABLE_STAGE_CACHE
384 bool
385 help
386 Selected by mainboards which wish to disable the stage cache.
387 E.g. mainboards which don't use S3 resume in the field may wish to
388 disable it to save boot time at the cost of increasing S3 resume time.
389
Stefan Reinauer58470e32014-10-17 13:08:36 +0200390config UPDATE_IMAGE
391 bool "Update existing coreboot.rom image"
Stefan Reinauer58470e32014-10-17 13:08:36 +0200392 help
393 If this option is enabled, no new coreboot.rom file
394 is created. Instead it is expected that there already
395 is a suitable file for further processing.
396 The bootblock will not be modified.
397
Martin Roth5942e062016-01-20 14:59:21 -0700398 If unsure, select 'N'
399
Konstantin Aladyshev6544cb32015-01-24 18:52:10 +0400400config BOOTSPLASH_IMAGE
401 bool "Add a bootsplash image"
402 help
403 Select this option if you have a bootsplash image that you would
404 like to add to your ROM.
405
406 This will only add the image to the ROM. To actually run it check
407 options under 'Display' section.
408
409config BOOTSPLASH_FILE
410 string "Bootsplash path and filename"
411 depends on BOOTSPLASH_IMAGE
Martin Roth75e5cb72016-12-15 15:05:37 -0700412 # Default value set at the end of the file
Konstantin Aladyshev6544cb32015-01-24 18:52:10 +0400413 help
414 The path and filename of the file to use as graphical bootsplash
415 screen. The file format has to be jpg.
416
Duncan Laurie36e6c6f2020-05-09 19:20:10 -0700417config FW_CONFIG
418 bool "Firmware Configuration Probing"
419 default n
420 help
421 Enable support for probing devices with fw_config. This is a simple
422 bitmask broken into fields and options for probing.
423
Duncan Laurie36e6c6f2020-05-09 19:20:10 -0700424config FW_CONFIG_SOURCE_CHROMEEC_CBI
425 bool "Obtain Firmware Configuration value from Google Chrome EC CBI"
426 depends on FW_CONFIG && EC_GOOGLE_CHROMEEC
427 default n
428 help
429 This option tells coreboot to read the firmware configuration value
430 from the Google Chrome Embedded Controller CBI interface. This source
431 is not tried if FW_CONFIG_SOURCE_CBFS is enabled and the value was
432 found in CBFS.
433
Wonkyu Kim38649732021-11-01 20:15:30 -0700434config FW_CONFIG_SOURCE_CBFS
435 bool "Obtain Firmware Configuration value from CBFS"
436 depends on FW_CONFIG
437 default n
438 help
439 With this option enabled coreboot will look for the 32bit firmware
440 configuration value in CBFS at the selected prefix with the file name
441 "fw_config". This option will override other sources and allow the
442 local image to preempt the mainboard selected source and can be used as
443 FW_CONFIG_SOURCE_CHROMEEC_CBI fallback option.
444
Wonkyu Kim43e26922021-11-01 20:55:25 -0700445config FW_CONFIG_SOURCE_VPD
446 bool "Obtain Firmware Configuration value from VPD"
447 depends on FW_CONFIG && VPD
448 default n
449 help
450 With this option enabled coreboot will look for the 32bit firmware
451 configuration value in VPD key name "fw_config". This option will
452 override other sources and allow the local image to preempt the mainboard
453 selected source and can be used for other FW_CONFIG_SOURCEs fallback option.
454
Nico Huber94cdec62019-06-06 19:36:02 +0200455config HAVE_RAMPAYLOAD
456 bool
457
Subrata Banik7e893a02019-05-06 14:17:41 +0530458config RAMPAYLOAD
459 bool "Enable coreboot flow without executing ramstage"
Subrata Banik86dbe0f2019-06-28 18:18:37 +0530460 default y if ARCH_X86
Nico Huber94cdec62019-06-06 19:36:02 +0200461 depends on HAVE_RAMPAYLOAD
Subrata Banik7e893a02019-05-06 14:17:41 +0530462 help
463 If this option is enabled, coreboot flow will skip ramstage
464 loading and execution of ramstage to load payload.
465
466 Instead it is expected to load payload from postcar stage itself.
467
468 In this flow coreboot will perform basic x86 initialization
469 (DRAM resource allocation), MTRR programming,
470 Skip PCI enumeration logic and only allocate BAR for fixed devices
471 (bootable devices, TPM over GSPI).
472
Subrata Banik37bead62020-02-09 19:13:52 +0530473config HAVE_CONFIGURABLE_RAMSTAGE
474 bool
475
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000476config CONFIGURABLE_RAMSTAGE
477 bool "Enable a configurable ramstage."
478 default y if ARCH_X86
Subrata Banik37bead62020-02-09 19:13:52 +0530479 depends on HAVE_CONFIGURABLE_RAMSTAGE
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000480 help
481 A configurable ramstage allows you to select which parts of the ramstage
482 to run. Currently, we can only select a minimal PCI scanning step.
483 The minimal PCI scanning will only check those parts that are enabled
484 in the devicetree.cb. By convention none of those devices should be bridges.
485
486config MINIMAL_PCI_SCANNING
487 bool "Enable minimal PCI scanning"
Subrata Banik1cb26a62020-02-09 19:35:16 +0530488 depends on CONFIGURABLE_RAMSTAGE && PCI
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000489 help
Subrata Banik1cb26a62020-02-09 19:35:16 +0530490 If this option is enabled, coreboot will scan only PCI devices
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000491 marked as mandatory in devicetree.cb
Maximilian Brune1d7a9de2022-04-14 14:54:16 +0200492
493menu "Software Bill Of Materials (SBOM)"
494
495source "src/sbom/Kconfig"
496
497endmenu
Uwe Hermannc04be932009-10-05 13:55:28 +0000498endmenu
499
Martin Roth026e4dc2015-06-19 23:17:15 -0600500menu "Mainboard"
501
Stefan Reinauera48ca842015-04-04 01:58:28 +0200502source "src/mainboard/Kconfig"
Stefan Reinauer8aedcbc2010-12-16 23:37:17 +0000503
Marshall Dawsone9375132016-09-04 08:38:33 -0600504config DEVICETREE
505 string
506 default "devicetree.cb"
507 help
508 This symbol allows mainboards to select a different file under their
509 mainboard directory for the devicetree.cb file. This allows the board
510 variants that need different devicetrees to be in the same directory.
511
512 Examples: "devicetree.variant.cb"
513 "variant/devicetree.cb"
514
Furquan Shaikhf2419982018-06-21 18:50:48 -0700515config OVERRIDE_DEVICETREE
516 string
517 default ""
518 help
519 This symbol allows variants to provide an override devicetree file to
520 override the registers and/or add new devices on top of the ones
521 provided by baseboard devicetree using CONFIG_DEVICETREE.
522
523 Examples: "devicetree.variant-override.cb"
524 "variant/devicetree-override.cb"
525
Patrick Georgi8a3592e2015-09-16 18:10:52 +0200526config FMDFILE
527 string "fmap description file in fmd format"
Patrick Georgib8fba862020-06-17 21:06:53 +0200528 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/chromeos.fmd" if CHROMEOS
Patrick Georgi8a3592e2015-09-16 18:10:52 +0200529 default ""
530 help
531 The build system creates a default FMAP from ROM_SIZE and CBFS_SIZE,
532 but in some cases more complex setups are required.
533 When an fmd is specified, it overrides the default format.
534
Arthur Heymans965881b2019-09-25 13:18:52 +0200535config CBFS_SIZE
536 hex "Size of CBFS filesystem in ROM"
537 depends on FMDFILE = ""
538 # Default value set at the end of the file
539 help
540 This is the part of the ROM actually managed by CBFS, located at the
541 end of the ROM (passed through cbfstool -o) on x86 and at at the start
542 of the ROM (passed through cbfstool -s) everywhere else. It defaults
543 to span the whole ROM on all but Intel systems that use an Intel Firmware
544 Descriptor. It can be overridden to make coreboot live alongside other
545 components like ChromeOS's vboot/FMAP or Intel's IFD / ME / TXE
546 binaries. This symbol should only be used to generate a default FMAP and
547 is unused when a non-default fmd file is provided via CONFIG_FMDFILE.
548
Martin Rothda1ca202015-12-26 16:51:16 -0700549endmenu
550
Martin Rothb09a5692016-01-24 19:38:33 -0700551# load site-local kconfig to allow user specific defaults and overrides
552source "site-local/Kconfig"
553
Vladimir Serbinenkoa9db82f2014-10-16 13:21:47 +0200554config SYSTEM_TYPE_LAPTOP
Martin Roth595e7772015-04-26 18:53:26 -0600555 default n
556 bool
Vladimir Serbinenkoa9db82f2014-10-16 13:21:47 +0200557
Duncan Laurie8312df42019-02-01 11:33:57 -0800558config SYSTEM_TYPE_TABLET
559 default n
560 bool
561
562config SYSTEM_TYPE_DETACHABLE
563 default n
564 bool
565
566config SYSTEM_TYPE_CONVERTIBLE
567 default n
568 bool
569
Werner Zehc0fb3612016-01-14 15:08:36 +0100570config CBFS_AUTOGEN_ATTRIBUTES
571 default n
572 bool
573 help
574 If this option is selected, every file in cbfs which has a constraint
575 regarding position or alignment will get an additional file attribute
576 which describes this constraint.
577
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000578menu "Chipset"
579
Duncan Lauried2119762015-06-08 18:11:56 -0700580comment "SoC"
Martin Roth7e486862022-06-22 20:58:06 -0600581source "src/soc/*/*/Kconfig"
582source "src/soc/*/*/Kconfig.common"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000583comment "CPU"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200584source "src/cpu/Kconfig"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000585comment "Northbridge"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200586source "src/northbridge/*/*/Kconfig"
Angel Ponsf462b3d2021-01-20 00:36:31 +0100587source "src/northbridge/*/*/Kconfig.common"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000588comment "Southbridge"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200589source "src/southbridge/*/*/Kconfig"
Angel Ponsc027ece2021-02-16 16:13:35 +0100590source "src/southbridge/*/*/Kconfig.common"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000591comment "Super I/O"
Omar Pakker57603e22016-07-29 23:31:45 +0200592source "src/superio/*/*/Kconfig"
Sven Schnelle7592e8b2011-01-27 11:43:03 +0000593comment "Embedded Controllers"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200594source "src/ec/acpi/Kconfig"
595source "src/ec/*/*/Kconfig"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000596
Martin Roth59aa2b12015-06-20 16:17:12 -0600597source "src/southbridge/intel/common/firmware/Kconfig"
Martin Rothe1523ec2015-06-19 22:30:43 -0600598source "src/vendorcode/*/Kconfig"
Martin Roth59aa2b12015-06-20 16:17:12 -0600599
Martin Rothe1523ec2015-06-19 22:30:43 -0600600source "src/arch/*/Kconfig"
601
Duncan Lauriee335c2e2020-07-29 16:28:43 -0700602config CHIPSET_DEVICETREE
603 string
604 default ""
605 help
606 This symbol allows a chipset to provide a set of default settings in
607 a devicetree which are common to all mainboards. This may include
608 devices (including alias names), chip drivers, register settings,
609 and others. This path is relative to the src/ directory.
610
611 Example: "chipset.cb"
612
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000613endmenu
Patrick Georgi0588d192009-08-12 15:00:51 +0000614
Stefan Reinauera48ca842015-04-04 01:58:28 +0200615source "src/device/Kconfig"
Stefan Reinauer95a63962012-11-13 17:00:01 -0800616
Rudolf Marekd9c25492010-05-16 15:31:53 +0000617menu "Generic Drivers"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200618source "src/drivers/*/Kconfig"
Stefan Reinauer86ddd732016-03-11 20:22:28 -0800619source "src/drivers/*/*/Kconfig"
Duncan Laurie2cc126b2020-08-28 19:46:35 +0000620source "src/drivers/*/*/*/Kconfig"
Lee Leahy48dbc662017-05-08 16:56:03 -0700621source "src/commonlib/storage/Kconfig"
Rudolf Marekd9c25492010-05-16 15:31:53 +0000622endmenu
623
Philipp Deppenwiese1899fbe2017-10-16 17:09:33 +0200624menu "Security"
625
626source "src/security/Kconfig"
Wim Vervoorne32d16f2019-11-14 14:10:28 +0100627source "src/vendorcode/eltan/security/Kconfig"
Philipp Deppenwiese1899fbe2017-10-16 17:09:33 +0200628
629endmenu
630
Martin Roth09210a12016-05-17 11:28:23 -0600631source "src/acpi/Kconfig"
632
Aaron Durbin4a36c4e2016-08-11 11:02:26 -0500633# This option is for the current boards/chipsets where SPI flash
634# is not the boot device. Currently nearly all boards/chipsets assume
635# SPI flash is the boot device.
636config BOOT_DEVICE_NOT_SPI_FLASH
637 bool
638 default n
639
640config BOOT_DEVICE_SPI_FLASH
641 bool
642 default y if !BOOT_DEVICE_NOT_SPI_FLASH
643 default n
644
Aaron Durbin16c173f2016-08-11 14:04:10 -0500645config BOOT_DEVICE_MEMORY_MAPPED
646 bool
647 default y if ARCH_X86 && BOOT_DEVICE_SPI_FLASH
648 default n
649 help
650 Inform system if SPI is memory-mapped or not.
651
Aaron Durbine8e118d2016-08-12 15:00:10 -0500652config BOOT_DEVICE_SUPPORTS_WRITES
653 bool
654 default n
655 help
656 Indicate that the platform has writable boot device
657 support.
658
Patrick Georgi0770f252015-04-22 13:28:21 +0200659config RTC
660 bool
661 default n
662
Patrick Georgi0588d192009-08-12 15:00:51 +0000663config HEAP_SIZE
664 hex
Marty E. Plummer0987e432019-04-22 20:46:27 -0500665 default 0x100000 if FLATTENED_DEVICE_TREE
Myles Watson04000f42009-10-16 19:12:49 +0000666 default 0x4000
Patrick Georgi0588d192009-08-12 15:00:51 +0000667
Julius Wernerc3e7c4e2014-09-19 13:18:16 -0700668config STACK_SIZE
669 hex
Arthur Heymans3951bc72022-05-23 23:28:44 +0200670 default 0x2000 if ARCH_X86
Julius Werner66a476a2015-10-12 16:45:21 -0700671 default 0x0
Julius Wernerc3e7c4e2014-09-19 13:18:16 -0700672
Patrick Georgi0588d192009-08-12 15:00:51 +0000673config MAX_CPUS
674 int
675 default 1
676
Stefan Reinauera48ca842015-04-04 01:58:28 +0200677source "src/console/Kconfig"
Patrick Georgi0588d192009-08-12 15:00:51 +0000678
679config HAVE_ACPI_RESUME
680 bool
681 default n
682
Wim Vervoornbccc7e72020-01-15 11:31:25 +0100683config DISABLE_ACPI_HIBERNATE
684 bool
685 default n
686 help
687 Removes S4 from the available sleepstates
688
Aaron Durbin87c9fae2016-01-22 15:26:04 -0600689config RESUME_PATH_SAME_AS_BOOT
690 bool
691 default y if ARCH_X86
692 depends on HAVE_ACPI_RESUME
693 help
694 This option indicates that when a system resumes it takes the
695 same path as a regular boot. e.g. an x86 system runs from the
696 reset vector at 0xfffffff0 on both resume and warm/cold boot.
697
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300698config NO_MONOTONIC_TIMER
Aaron Durbina4217912013-04-29 22:31:51 -0500699 def_bool n
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300700
701config HAVE_MONOTONIC_TIMER
702 bool
703 depends on !NO_MONOTONIC_TIMER
Kyösti Mälkkib28b6b52019-07-01 15:38:25 +0300704 default y
Aaron Durbina4217912013-04-29 22:31:51 -0500705 help
706 The board/chipset provides a monotonic timer.
707
Aaron Durbine5e36302014-09-25 10:05:15 -0500708config GENERIC_UDELAY
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300709 bool
Aaron Durbine5e36302014-09-25 10:05:15 -0500710 depends on HAVE_MONOTONIC_TIMER
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300711 default y if !ARCH_X86
Aaron Durbine5e36302014-09-25 10:05:15 -0500712 help
713 The board/chipset uses a generic udelay function utilizing the
714 monotonic timer.
715
Aaron Durbin340ca912013-04-30 09:58:12 -0500716config TIMER_QUEUE
717 def_bool n
718 depends on HAVE_MONOTONIC_TIMER
719 help
Kyösti Mälkkiecd84242013-09-13 07:57:49 +0300720 Provide a timer queue for performing time-based callbacks.
Aaron Durbin340ca912013-04-30 09:58:12 -0500721
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500722config COOP_MULTITASKING
723 def_bool n
Raul E Rangel199c45c2021-11-02 11:29:33 -0600724 select TIMER_QUEUE
Arthur Heymansf4c11dc2022-11-01 23:48:32 +0100725 depends on ARCH_X86
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500726 help
727 Cooperative multitasking allows callbacks to be multiplexed on the
Raul E Rangel199c45c2021-11-02 11:29:33 -0600728 main thread. With this enabled it allows for multiple execution paths
729 to take place when they have udelay() calls within their code.
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500730
731config NUM_THREADS
732 int
733 default 4
734 depends on COOP_MULTITASKING
735 help
736 How many execution threads to cooperatively multitask with.
737
Angel Pons9bc780f2021-05-20 16:43:08 +0200738config HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
739 bool
740 help
741 Selected by mainboards which implement a mainboard-specific mechanism
742 to access the values for runtime-configurable options. For example, a
743 custom BMC interface or an EEPROM with an externally-imposed layout.
744
Patrick Georgi0588d192009-08-12 15:00:51 +0000745config HAVE_OPTION_TABLE
746 bool
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000747 default n
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000748 help
749 This variable specifies whether a given board has a cmos.layout
750 file containing NVRAM/CMOS bit definitions.
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000751 It defaults to 'n' but can be selected in mainboard/*/Kconfig.
Patrick Georgi0588d192009-08-12 15:00:51 +0000752
Angel Ponsf206cda2021-05-17 12:12:39 +0200753config CMOS_LAYOUT_FILE
754 string
755 default "src/mainboard/\$(MAINBOARDDIR)/cmos.layout"
756 depends on HAVE_OPTION_TABLE
757
Patrick Georgi0588d192009-08-12 15:00:51 +0000758config PCI_IO_CFG_EXT
759 bool
760 default n
761
762config IOAPIC
763 bool
Kyösti Mälkkic25ecb52021-06-06 08:28:16 +0300764 default y if SMP
Patrick Georgi0588d192009-08-12 15:00:51 +0000765 default n
766
Myles Watson45bb25f2009-09-22 18:49:08 +0000767config USE_WATCHDOG_ON_BOOT
768 bool
769 default n
770
Myles Watson45bb25f2009-09-22 18:49:08 +0000771config GFXUMA
772 bool
Myles Watsond73c1b52009-10-26 15:14:07 +0000773 default n
Myles Watson45bb25f2009-09-22 18:49:08 +0000774 help
775 Enable Unified Memory Architecture for graphics.
776
Myles Watsonb8e20272009-10-15 13:35:47 +0000777config HAVE_MP_TABLE
778 bool
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000779 help
780 This variable specifies whether a given board has MP table support.
781 It is usually set in mainboard/*/Kconfig.
782 Whether or not the MP table is actually generated by coreboot
783 is configurable by the user via GENERATE_MP_TABLE.
Myles Watsonb8e20272009-10-15 13:35:47 +0000784
785config HAVE_PIRQ_TABLE
786 bool
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000787 help
788 This variable specifies whether a given board has PIRQ table support.
789 It is usually set in mainboard/*/Kconfig.
790 Whether or not the PIRQ table is actually generated by coreboot
791 is configurable by the user via GENERATE_PIRQ_TABLE.
Myles Watsonb8e20272009-10-15 13:35:47 +0000792
Aaron Durbin9420a522015-11-17 16:31:00 -0600793config ACPI_NHLT
794 bool
795 default n
796 help
797 Build support for NHLT (non HD Audio) ACPI table generation.
798
Myles Watsond73c1b52009-10-26 15:14:07 +0000799#These Options are here to avoid "undefined" warnings.
800#The actual selection and help texts are in the following menu.
801
Uwe Hermann168b11b2009-10-07 16:15:40 +0000802menu "System tables"
Myles Watson45bb25f2009-09-22 18:49:08 +0000803
Myles Watsonb8e20272009-10-15 13:35:47 +0000804config GENERATE_MP_TABLE
Kyösti Mälkkica5a7932021-06-08 08:06:06 +0300805 prompt "Generate an MP table" if HAVE_MP_TABLE
Stefan Reinauer56cd70b2012-11-13 17:33:08 -0800806 bool
Kyösti Mälkkica5a7932021-06-08 08:06:06 +0300807 default HAVE_MP_TABLE
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000808 help
809 Generate an MP table (conforming to the Intel MultiProcessor
810 specification 1.4) for this board.
811
812 If unsure, say Y.
Myles Watson45bb25f2009-09-22 18:49:08 +0000813
Myles Watsonb8e20272009-10-15 13:35:47 +0000814config GENERATE_PIRQ_TABLE
Stefan Reinauer56cd70b2012-11-13 17:33:08 -0800815 prompt "Generate a PIRQ table" if HAVE_PIRQ_TABLE
816 bool
817 default HAVE_PIRQ_TABLE
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000818 help
819 Generate a PIRQ table for this board.
820
821 If unsure, say Y.
Myles Watson45bb25f2009-09-22 18:49:08 +0000822
Sven Schnelle164bcfd2011-08-14 20:56:34 +0200823config GENERATE_SMBIOS_TABLES
824 depends on ARCH_X86
825 bool "Generate SMBIOS tables"
826 default y
827 help
828 Generate SMBIOS tables for this board.
829
830 If unsure, say Y.
831
Angel Pons437da712021-09-03 16:51:40 +0200832config SMBIOS_TYPE41_PROVIDED_BY_DEVTREE
833 bool
834 depends on ARCH_X86
835 help
836 If enabled, only generate SMBIOS Type 41 entries for PCI devices in
837 the devicetree for which Type 41 information is provided, e.g. with
838 the `smbios_dev_info` devicetree syntax. This is useful to manually
839 assign specific instance IDs to onboard devices irrespective of the
840 device traversal order. It is assumed that instance IDs for devices
841 of the same class are unique.
842 When disabled, coreboot autogenerates SMBIOS Type 41 entries for all
843 appropriate PCI devices in the devicetree. Instance IDs are assigned
844 successive numbers from a monotonically increasing counter, with one
845 counter for each device class.
846
Vladimir Serbinenko0afdec42015-05-30 23:08:26 +0200847config SMBIOS_PROVIDED_BY_MOBO
848 bool
849 default n
850
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200851config MAINBOARD_SERIAL_NUMBER
Nico Huberebd8a4f2017-11-01 09:49:16 +0100852 prompt "SMBIOS Serial Number" if !SMBIOS_PROVIDED_BY_MOBO
853 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200854 depends on GENERATE_SMBIOS_TABLES
855 default "123456789"
Martin Roth595e7772015-04-26 18:53:26 -0600856 help
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200857 The Serial Number to store in SMBIOS structures.
858
859config MAINBOARD_VERSION
Nico Huberebd8a4f2017-11-01 09:49:16 +0100860 prompt "SMBIOS Version Number" if !SMBIOS_PROVIDED_BY_MOBO
861 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200862 depends on GENERATE_SMBIOS_TABLES
863 default "1.0"
864 help
865 The Version Number to store in SMBIOS structures.
866
867config MAINBOARD_SMBIOS_MANUFACTURER
Nico Huberebd8a4f2017-11-01 09:49:16 +0100868 prompt "SMBIOS Manufacturer" if !SMBIOS_PROVIDED_BY_MOBO
869 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200870 depends on GENERATE_SMBIOS_TABLES
871 default MAINBOARD_VENDOR
872 help
873 Override the default Manufacturer stored in SMBIOS structures.
874
875config MAINBOARD_SMBIOS_PRODUCT_NAME
Nico Huberebd8a4f2017-11-01 09:49:16 +0100876 prompt "SMBIOS Product name" if !SMBIOS_PROVIDED_BY_MOBO
877 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200878 depends on GENERATE_SMBIOS_TABLES
879 default MAINBOARD_PART_NUMBER
880 help
881 Override the default Product name stored in SMBIOS structures.
882
Johnny Linc746a742020-06-03 11:44:22 +0800883config VPD_SMBIOS_VERSION
884 bool "Populates SMBIOS type 0 version from the VPD_RO variable 'firmware_version'"
885 default n
886 depends on VPD && GENERATE_SMBIOS_TABLES
887 help
888 Selecting this option will read firmware_version from
889 VPD_RO and override SMBIOS type 0 version. One special
890 scenario of using this feature is to assign a BIOS version
891 to a coreboot image without the need to rebuild from source.
892
Myles Watson45bb25f2009-09-22 18:49:08 +0000893endmenu
894
Martin Roth21c06502016-02-04 19:52:27 -0700895source "payloads/Kconfig"
Peter Stugea758ca22009-09-17 16:21:31 +0000896
Uwe Hermann168b11b2009-10-07 16:15:40 +0000897menu "Debugging"
898
Nico Huberd67edca2018-11-13 19:28:07 +0100899comment "CPU Debug Settings"
Arthur Heymansaae81902019-11-04 21:50:21 +0100900source "src/cpu/*/Kconfig.debug_cpu"
Nico Huberd67edca2018-11-13 19:28:07 +0100901
Arthur Heymans71bd7e42019-10-20 14:20:53 +0200902comment "BLOB Debug Settings"
903source "src/drivers/intel/fsp*/Kconfig.debug_blob"
904
Nico Huberd67edca2018-11-13 19:28:07 +0100905comment "General Debug Settings"
906
Uwe Hermann168b11b2009-10-07 16:15:40 +0000907# TODO: Better help text and detailed instructions.
Patrick Georgi0588d192009-08-12 15:00:51 +0000908config GDB_STUB
Uwe Hermann5ec2c2b2009-08-25 00:53:22 +0000909 bool "GDB debugging support"
Rudolf Marek65888022012-03-25 20:51:16 +0200910 default n
Arthur Heymans8e980132019-11-04 09:33:04 +0100911 depends on DRIVERS_UART
Patrick Georgi0588d192009-08-12 15:00:51 +0000912 help
Uwe Hermann5ec2c2b2009-08-25 00:53:22 +0000913 If enabled, you will be able to set breakpoints for gdb debugging.
Elyes Haouas95231b22022-02-16 22:37:44 +0100914 See src/arch/x86/c_start.S for details.
Patrick Georgi0588d192009-08-12 15:00:51 +0000915
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200916config GDB_WAIT
Denis 'GNUtoo' Carikli7d234f22015-12-10 21:58:52 +0100917 bool "Wait for a GDB connection in the ramstage"
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200918 default n
919 depends on GDB_STUB
920 help
Denis 'GNUtoo' Carikli7d234f22015-12-10 21:58:52 +0100921 If enabled, coreboot will wait for a GDB connection in the ramstage.
922
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200923
Julius Wernerd82e0cf2015-02-17 17:27:23 -0800924config FATAL_ASSERTS
925 bool "Halt when hitting a BUG() or assertion error"
926 default n
927 help
928 If enabled, coreboot will call hlt() on a BUG() or failed ASSERT().
929
Nico Huber371a6672018-11-13 22:06:40 +0100930config HAVE_DEBUG_GPIO
931 bool
932
933config DEBUG_GPIO
934 bool "Output verbose GPIO debug messages"
935 depends on HAVE_DEBUG_GPIO
936
Stefan Reinauerfe422182012-05-02 16:33:18 -0700937config DEBUG_CBFS
938 bool "Output verbose CBFS debug messages"
939 default n
Stefan Reinauerfe422182012-05-02 16:33:18 -0700940 help
941 This option enables additional CBFS related debug messages.
942
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000943config HAVE_DEBUG_RAM_SETUP
944 def_bool n
945
Uwe Hermann01ce6012010-03-05 10:03:50 +0000946config DEBUG_RAM_SETUP
947 bool "Output verbose RAM init debug messages"
948 default n
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000949 depends on HAVE_DEBUG_RAM_SETUP
Uwe Hermann01ce6012010-03-05 10:03:50 +0000950 help
951 This option enables additional RAM init related debug messages.
952 It is recommended to enable this when debugging issues on your
953 board which might be RAM init related.
954
955 Note: This option will increase the size of the coreboot image.
956
957 If unsure, say N.
958
Myles Watson80e914ff2010-06-01 19:25:31 +0000959config DEBUG_PIRQ
960 bool "Check PIRQ table consistency"
961 default n
962 depends on GENERATE_PIRQ_TABLE
963 help
964 If unsure, say N.
965
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000966config HAVE_DEBUG_SMBUS
967 def_bool n
968
Uwe Hermann01ce6012010-03-05 10:03:50 +0000969config DEBUG_SMBUS
970 bool "Output verbose SMBus debug messages"
971 default n
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000972 depends on HAVE_DEBUG_SMBUS
Uwe Hermann01ce6012010-03-05 10:03:50 +0000973 help
974 This option enables additional SMBus (and SPD) debug messages.
975
976 Note: This option will increase the size of the coreboot image.
977
978 If unsure, say N.
979
980config DEBUG_SMI
981 bool "Output verbose SMI debug messages"
982 default n
983 depends on HAVE_SMI_HANDLER
Angel Pons12d48cd2020-10-03 12:22:04 +0200984 select SPI_FLASH_SMM if EM100PRO_SPI_CONSOLE || CONSOLE_SPI_FLASH
Uwe Hermann01ce6012010-03-05 10:03:50 +0000985 help
986 This option enables additional SMI related debug messages.
987
988 Note: This option will increase the size of the coreboot image.
989
990 If unsure, say N.
991
Kyösti Mälkki94464472020-06-13 13:45:42 +0300992config DEBUG_PERIODIC_SMI
993 bool "Trigger SMI periodically"
994 depends on DEBUG_SMI
995
Uwe Hermanna953f372010-11-10 00:14:32 +0000996# Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
997# printk(BIOS_DEBUG, ...) calls.
998config DEBUG_MALLOC
Marc Jonescf3dcd62020-12-02 11:34:17 -0700999 prompt "Output verbose malloc debug messages" if DEFAULT_CONSOLE_LOGLEVEL_7 || DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
Stefan Reinauer95a63962012-11-13 17:00:01 -08001000 bool
Uwe Hermanna953f372010-11-10 00:14:32 +00001001 default n
Uwe Hermanna953f372010-11-10 00:14:32 +00001002 help
1003 This option enables additional malloc related debug messages.
1004
1005 Note: This option will increase the size of the coreboot image.
1006
1007 If unsure, say N.
Cristian Măgherușan-Stanciu9f52ea42011-07-02 00:44:39 +03001008
Marc Jones5b5c52e2020-10-12 11:44:46 -06001009# Only visible if DEBUG_SPEW (8) is set.
1010config DEBUG_RESOURCES
Marc Jonescf3dcd62020-12-02 11:34:17 -07001011 bool "Output verbose PCI MEM and IO resource debug messages" if DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
Marc Jones5b5c52e2020-10-12 11:44:46 -06001012 default n
1013 help
1014 This option enables additional PCI memory and IO debug messages.
1015 Note: This option will increase the size of the coreboot image.
1016 If unsure, say N.
1017
Kyösti Mälkki66277952018-12-31 15:22:34 +02001018config DEBUG_CONSOLE_INIT
1019 bool "Debug console initialisation code"
1020 default n
1021 help
1022 With this option printk()'s are attempted before console hardware
1023 initialisation has been completed. Your mileage may vary.
1024
1025 Typically you will need to modify source in console_hw_init() such
1026 that a working console appears before the one you want to debug.
1027
1028 If unsure, say N.
1029
Uwe Hermanna953f372010-11-10 00:14:32 +00001030# Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
1031# printk(BIOS_DEBUG, ...) calls.
Myles Watson6c9bc012010-09-07 22:30:15 +00001032config REALMODE_DEBUG
Marc Jonescf3dcd62020-12-02 11:34:17 -07001033 prompt "Enable debug messages for option ROM execution" if DEFAULT_CONSOLE_LOGLEVEL_7 || DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
Stefan Reinauer95a63962012-11-13 17:00:01 -08001034 bool
Myles Watson6c9bc012010-09-07 22:30:15 +00001035 default n
Peter Stuge5015f792010-11-10 02:00:32 +00001036 depends on PCI_OPTION_ROM_RUN_REALMODE
Myles Watson6c9bc012010-09-07 22:30:15 +00001037 help
1038 This option enables additional x86emu related debug messages.
1039
1040 Note: This option will increase the time to emulate a ROM.
1041
1042 If unsure, say N.
1043
Uwe Hermann01ce6012010-03-05 10:03:50 +00001044config X86EMU_DEBUG
1045 bool "Output verbose x86emu debug messages"
1046 default n
1047 depends on PCI_OPTION_ROM_RUN_YABEL
1048 help
1049 This option enables additional x86emu related debug messages.
1050
1051 Note: This option will increase the size of the coreboot image.
1052
1053 If unsure, say N.
1054
1055config X86EMU_DEBUG_JMP
1056 bool "Trace JMP/RETF"
1057 default n
1058 depends on X86EMU_DEBUG
1059 help
1060 Print information about JMP and RETF opcodes from x86emu.
1061
1062 Note: This option will increase the size of the coreboot image.
1063
1064 If unsure, say N.
1065
1066config X86EMU_DEBUG_TRACE
1067 bool "Trace all opcodes"
1068 default n
1069 depends on X86EMU_DEBUG
1070 help
1071 Print _all_ opcodes that are executed by x86emu.
Stefan Reinauer14e22772010-04-27 06:56:47 +00001072
Uwe Hermann01ce6012010-03-05 10:03:50 +00001073 WARNING: This will produce a LOT of output and take a long time.
1074
1075 Note: This option will increase the size of the coreboot image.
1076
1077 If unsure, say N.
1078
1079config X86EMU_DEBUG_PNP
1080 bool "Log Plug&Play accesses"
1081 default n
1082 depends on X86EMU_DEBUG
1083 help
1084 Print Plug And Play accesses made by option ROMs.
1085
1086 Note: This option will increase the size of the coreboot image.
1087
1088 If unsure, say N.
1089
1090config X86EMU_DEBUG_DISK
1091 bool "Log Disk I/O"
1092 default n
1093 depends on X86EMU_DEBUG
1094 help
1095 Print Disk I/O related messages.
1096
1097 Note: This option will increase the size of the coreboot image.
1098
1099 If unsure, say N.
1100
1101config X86EMU_DEBUG_PMM
1102 bool "Log PMM"
1103 default n
1104 depends on X86EMU_DEBUG
1105 help
1106 Print messages related to POST Memory Manager (PMM).
1107
1108 Note: This option will increase the size of the coreboot image.
1109
1110 If unsure, say N.
1111
1112
1113config X86EMU_DEBUG_VBE
1114 bool "Debug VESA BIOS Extensions"
1115 default n
1116 depends on X86EMU_DEBUG
1117 help
1118 Print messages related to VESA BIOS Extension (VBE) functions.
1119
1120 Note: This option will increase the size of the coreboot image.
1121
1122 If unsure, say N.
1123
1124config X86EMU_DEBUG_INT10
1125 bool "Redirect INT10 output to console"
1126 default n
1127 depends on X86EMU_DEBUG
1128 help
1129 Let INT10 (i.e. character output) calls print messages to debug output.
1130
1131 Note: This option will increase the size of the coreboot image.
1132
1133 If unsure, say N.
1134
1135config X86EMU_DEBUG_INTERRUPTS
1136 bool "Log intXX calls"
1137 default n
1138 depends on X86EMU_DEBUG
1139 help
1140 Print messages related to interrupt handling.
1141
1142 Note: This option will increase the size of the coreboot image.
1143
1144 If unsure, say N.
1145
1146config X86EMU_DEBUG_CHECK_VMEM_ACCESS
1147 bool "Log special memory accesses"
1148 default n
1149 depends on X86EMU_DEBUG
1150 help
1151 Print messages related to accesses to certain areas of the virtual
1152 memory (e.g. BDA (BIOS Data Area) or interrupt vectors)
1153
1154 Note: This option will increase the size of the coreboot image.
1155
1156 If unsure, say N.
1157
1158config X86EMU_DEBUG_MEM
1159 bool "Log all memory accesses"
1160 default n
1161 depends on X86EMU_DEBUG
1162 help
1163 Print memory accesses made by option ROM.
1164 Note: This also includes accesses to fetch instructions.
1165
1166 Note: This option will increase the size of the coreboot image.
1167
1168 If unsure, say N.
1169
1170config X86EMU_DEBUG_IO
1171 bool "Log IO accesses"
1172 default n
1173 depends on X86EMU_DEBUG
1174 help
1175 Print I/O accesses made by option ROM.
1176
1177 Note: This option will increase the size of the coreboot image.
1178
1179 If unsure, say N.
1180
Denis 'GNUtoo' Carikli4cdc5d62013-05-15 00:19:49 +02001181config X86EMU_DEBUG_TIMINGS
1182 bool "Output timing information"
1183 default n
Kyösti Mälkki91945fb2019-07-10 15:10:22 +03001184 depends on X86EMU_DEBUG && HAVE_MONOTONIC_TIMER
Denis 'GNUtoo' Carikli4cdc5d62013-05-15 00:19:49 +02001185 help
1186 Print timing information needed by i915tool.
1187
1188 If unsure, say N.
1189
Stefan Reinauer1c56d9b2012-05-10 11:27:32 -07001190config DEBUG_SPI_FLASH
1191 bool "Output verbose SPI flash debug messages"
1192 default n
1193 depends on SPI_FLASH
1194 help
1195 This option enables additional SPI flash related debug messages.
1196
Marc Jonesdc12daf2021-04-16 14:26:08 -06001197config DEBUG_IPMI
1198 bool "Output verbose IPMI debug messages"
1199 default n
1200 depends on IPMI_KCS
1201 help
1202 This option enables additional IPMI related debug messages.
1203
Stefan Reinauer8e073822012-04-04 00:07:22 +02001204if SOUTHBRIDGE_INTEL_BD82X6X && DEFAULT_CONSOLE_LOGLEVEL_8
1205# Only visible with the right southbridge and loglevel.
1206config DEBUG_INTEL_ME
1207 bool "Verbose logging for Intel Management Engine"
1208 default n
1209 help
1210 Enable verbose logging for Intel Management Engine driver that
1211 is present on Intel 6-series chipsets.
1212endif
1213
Marc Jones8b522db2020-10-12 11:58:46 -06001214config DEBUG_FUNC
Marc Jonesc6076ef2021-11-11 12:07:46 -07001215 bool "Enable function entry and exit reporting macros" if DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
Marc Jones8b522db2020-10-12 11:58:46 -06001216 default n
1217 help
1218 This option enables additional function entry and exit debug messages
Kyösti Mälkki8c99c272020-07-24 15:54:31 +03001219 for select functions.
Marc Jones8b522db2020-10-12 11:58:46 -06001220 Note: This option will increase the size of the coreboot image.
1221 If unsure, say N.
1222
Stefan Reinauerd37ab452012-12-18 16:23:28 -08001223config DEBUG_COVERAGE
1224 bool "Debug code coverage"
1225 default n
1226 depends on COVERAGE
1227 help
1228 If enabled, the code coverage hooks in coreboot will output some
1229 information about the coverage data that is dumped.
1230
Jonathan Neuschäferfc04f9b2016-06-29 21:59:32 +02001231config DEBUG_BOOT_STATE
1232 bool "Debug boot state machine"
1233 default n
1234 help
1235 Control debugging of the boot state machine. When selected displays
1236 the state boundaries in ramstage.
1237
Nico Hubere84e6252016-10-05 17:43:56 +02001238config DEBUG_ADA_CODE
1239 bool "Compile debug code in Ada sources"
1240 default n
1241 help
1242 Add the compiler switch `-gnata` to compile code guarded by
1243 `pragma Debug`.
1244
Simon Glass46255f72018-07-12 15:26:07 -06001245config HAVE_EM100_SUPPORT
Arthur Heymans1842aa22022-04-17 20:10:41 +02001246 bool
Simon Glass46255f72018-07-12 15:26:07 -06001247 help
1248 This is enabled by platforms which can support using the EM100.
1249
1250config EM100
1251 bool "Configure image for EM100 usage"
1252 depends on HAVE_EM100_SUPPORT
1253 help
1254 The Dediprog EM100 SPI emulator allows fast loading of new SPI images
1255 over USB. However it only supports a maximum SPI clock of 20MHz and
1256 single data output. Enable this option to use a 20MHz SPI clock and
1257 disable "Dual Output Fast Read" Support.
1258
1259 On AMD platforms this changes the SPI speed at run-time if the
1260 mainboard code supports this. On supported Intel platforms this works
1261 by changing the settings in the descriptor.bin file.
1262
Uwe Hermann168b11b2009-10-07 16:15:40 +00001263endmenu
1264
Martin Roth8e4aafb2016-12-15 15:25:15 -07001265###############################################################################
1266# Set variables with no prompt - these can be set anywhere, and putting at
1267# the end of this file gives the most flexibility.
Nico Huber3db76532017-05-18 18:07:34 +02001268
1269source "src/lib/Kconfig"
1270
Myles Watson2e672732009-11-12 16:38:03 +00001271config WARNINGS_ARE_ERRORS
1272 bool
Edward O'Callaghan63f6dc72014-11-18 03:17:54 +11001273 default y
Patrick Georgi436f99b2009-11-27 16:55:13 +00001274
Peter Stuge51eafde2010-10-13 06:23:02 +00001275# The four POWER_BUTTON_DEFAULT_ENABLE, POWER_BUTTON_DEFAULT_DISABLE,
1276# POWER_BUTTON_FORCE_ENABLE and POWER_BUTTON_FORCE_DISABLE options are
1277# mutually exclusive. One of these options must be selected in the
1278# mainboard Kconfig if the chipset supports enabling and disabling of
1279# the power button. Chipset code uses the ENABLE_POWER_BUTTON option set
1280# in mainboard/Kconfig to know if the button should be enabled or not.
1281
1282config POWER_BUTTON_DEFAULT_ENABLE
1283 def_bool n
1284 help
1285 Select when the board has a power button which can optionally be
1286 disabled by the user.
1287
1288config POWER_BUTTON_DEFAULT_DISABLE
1289 def_bool n
1290 help
1291 Select when the board has a power button which can optionally be
1292 enabled by the user, e.g. when the board ships with a jumper over
1293 the power switch contacts.
1294
1295config POWER_BUTTON_FORCE_ENABLE
1296 def_bool n
1297 help
1298 Select when the board requires that the power button is always
1299 enabled.
1300
1301config POWER_BUTTON_FORCE_DISABLE
1302 def_bool n
1303 help
1304 Select when the board requires that the power button is always
1305 disabled, e.g. when it has been hardwired to ground.
1306
1307config POWER_BUTTON_IS_OPTIONAL
1308 bool
1309 default y if POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE
1310 default n if !(POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE)
1311 help
1312 Internal option that controls ENABLE_POWER_BUTTON visibility.
Duncan Laurie72748002013-10-31 08:26:23 -07001313
1314config REG_SCRIPT
1315 bool
Duncan Laurie72748002013-10-31 08:26:23 -07001316 default n
1317 help
1318 Internal option that controls whether we compile in register scripts.
Furquan Shaikh99ac98f2014-04-23 10:18:48 -07001319
Furquan Shaikh99ac98f2014-04-23 10:18:48 -07001320config MAX_REBOOT_CNT
1321 int
1322 default 3
Timothy Pearson17ada2e2015-03-18 01:31:34 -05001323 help
1324 Internal option that sets the maximum number of bootblock executions allowed
1325 with the normal image enabled before assuming the normal image is defective
Vadim Bendebury9c9c3362014-07-23 09:40:02 -07001326 and switching to the fallback image.
Martin Roth59ff3402016-02-09 09:06:46 -07001327
Martin Roth8e4aafb2016-12-15 15:25:15 -07001328config UNCOMPRESSED_RAMSTAGE
1329 bool
1330
1331config NO_XIP_EARLY_STAGES
1332 bool
1333 default n if ARCH_X86
1334 default y
1335 help
1336 Identify if early stages are eXecute-In-Place(XIP).
1337
Martin Roth8e4aafb2016-12-15 15:25:15 -07001338config EARLY_CBMEM_LIST
1339 bool
1340 default n
1341 help
1342 Enable display of CBMEM during romstage and postcar.
1343
1344config RELOCATABLE_MODULES
1345 bool
1346 help
1347 If RELOCATABLE_MODULES is selected then support is enabled for
1348 building relocatable modules in the RAM stage. Those modules can be
1349 loaded anywhere and all the relocations are handled automatically.
1350
Martin Roth8e4aafb2016-12-15 15:25:15 -07001351config GENERIC_GPIO_LIB
1352 bool
1353 help
1354 If enabled, compile the generic GPIO library. A "generic" GPIO
1355 implies configurability usually found on SoCs, particularly the
1356 ability to control internal pull resistors.
1357
Martin Roth8e4aafb2016-12-15 15:25:15 -07001358config BOOTBLOCK_CUSTOM
1359 # To be selected by arch, SoC or mainboard if it does not want use the normal
1360 # src/lib/bootblock.c#main() C entry point.
1361 bool
1362
Arthur Heymanse8217b12022-04-05 20:42:07 +02001363config BOOTBLOCK_IN_CBFS
1364 bool
1365 default y if ARCH_X86
1366 help
1367 Select this on platforms that have a top aligned bootblock inside cbfs.
1368
Furquan Shaikh46514c22020-06-11 11:59:07 -07001369config MEMLAYOUT_LD_FILE
1370 string
Patrick Georgib8fba862020-06-17 21:06:53 +02001371 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/memlayout.ld"
Furquan Shaikh46514c22020-06-11 11:59:07 -07001372 help
1373 This variable allows SoC/mainboard to supply in a custom linker file
1374 if required. This determines the linker file used for all the stages
1375 (bootblock, romstage, verstage, ramstage, postcar) in
1376 src/arch/${ARCH}/Makefile.inc.
1377
Martin Roth75e5cb72016-12-15 15:05:37 -07001378###############################################################################
1379# Set default values for symbols created before mainboards. This allows the
1380# option to be displayed in the general menu, but the default to be loaded in
1381# the mainboard if desired.
1382config COMPRESS_RAMSTAGE
1383 default y if !UNCOMPRESSED_RAMSTAGE
1384
1385config COMPRESS_PRERAM_STAGES
Arthur Heymanse146fbd2019-11-04 18:57:06 +01001386 depends on (HAVE_ROMSTAGE || HAVE_VERSTAGE) && NO_XIP_EARLY_STAGES
Martin Roth75e5cb72016-12-15 15:05:37 -07001387 default y
1388
1389config INCLUDE_CONFIG_FILE
1390 default y
1391
Martin Roth75e5cb72016-12-15 15:05:37 -07001392config BOOTSPLASH_FILE
1393 depends on BOOTSPLASH_IMAGE
1394 default "bootsplash.jpg"
1395
1396config CBFS_SIZE
1397 default ROM_SIZE
Subrata Banikb5962a92019-06-08 12:29:02 +05301398
1399config HAVE_BOOTBLOCK
1400 bool
1401 default y
1402
1403config HAVE_VERSTAGE
1404 bool
1405 depends on VBOOT_SEPARATE_VERSTAGE
1406 default y
1407
1408config HAVE_ROMSTAGE
1409 bool
1410 default y
1411
Subrata Banikb5962a92019-06-08 12:29:02 +05301412config HAVE_RAMSTAGE
1413 bool
1414 default n if RAMPAYLOAD
1415 default y