blob: f1b4b846b67808d8f19cae8d24f189a4113f9d01 [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
103 unusual linker features. Unless developers explicitely request it,
104 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
Sol Boucher69b88bf2015-02-26 11:47:19 -0800117config FMD_GENPARSER
118 bool "Generate flashmap descriptor parser using flex and bison"
119 default n
Sol Boucher69b88bf2015-02-26 11:47:19 -0800120 help
121 Enable this option if you are working on the flashmap descriptor
122 parser and made changes to fmd_scanner.l or fmd_parser.y.
123
124 Otherwise, say N to use the provided pregenerated scanner/parser.
125
Martin Rothf411b702017-04-09 19:12:42 -0600126config UTIL_GENPARSER
Patrick Georgi615cdfc2021-09-06 16:59:56 +0200127 bool "Generate parsers for bincfg, sconfig and kconfig locally"
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000128 default n
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000129 help
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200130 Enable this option if you are working on the sconfig device tree
Denis 'GNUtoo' Carikli780e9312018-01-10 14:35:55 +0100131 parser or bincfg and made changes to the .l or .y files.
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200132
Sol Boucher69b88bf2015-02-26 11:47:19 -0800133 Otherwise, say N to use the provided pregenerated scanner/parser.
Stefan Reinauer9bf78102010-08-09 13:28:18 +0000134
Angel Pons17852e62021-05-20 15:30:59 +0200135choice
136 prompt "Option backend to use"
Angel Pons9bc780f2021-05-20 16:43:08 +0200137 default USE_MAINBOARD_SPECIFIC_OPTION_BACKEND if HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
Angel Pons17852e62021-05-20 15:30:59 +0200138 default USE_OPTION_TABLE if NVRAMCUI_SECONDARY_PAYLOAD
139
140config OPTION_BACKEND_NONE
141 bool "None"
142
Joe Korty6d772522010-05-19 18:41:15 +0000143config USE_OPTION_TABLE
144 bool "Use CMOS for configuration values"
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000145 depends on HAVE_OPTION_TABLE
Joe Korty6d772522010-05-19 18:41:15 +0000146 help
147 Enable this option if coreboot shall read options from the "CMOS"
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200148 NVRAM instead of using hard-coded values.
Joe Korty6d772522010-05-19 18:41:15 +0000149
Angel Pons9bc780f2021-05-20 16:43:08 +0200150config USE_MAINBOARD_SPECIFIC_OPTION_BACKEND
151 bool "Use mainboard-specific option backend"
152 depends on HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
153 help
154 Use a mainboard-specific mechanism to access runtime-configurable
155 options.
156
Angel Pons17852e62021-05-20 15:30:59 +0200157endchoice
158
Timothy Pearsonf20c6e82015-02-14 16:15:31 -0600159config STATIC_OPTION_TABLE
160 bool "Load default configuration values into CMOS on each boot"
Timothy Pearsonf20c6e82015-02-14 16:15:31 -0600161 depends on USE_OPTION_TABLE
162 help
163 Enable this option to reset "CMOS" NVRAM values to default on
164 every boot. Use this if you want the NVRAM configuration to
165 never be modified from its default values.
166
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000167config COMPRESS_RAMSTAGE
168 bool "Compress ramstage with LZMA"
Subrata Banikb5962a92019-06-08 12:29:02 +0530169 depends on HAVE_RAMSTAGE
Martin Roth75e5cb72016-12-15 15:05:37 -0700170 # Default value set at the end of the file
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000171 help
Arthur Heymans7f229332019-11-08 11:59:25 +0100172 Compress ramstage to save memory in the flash image.
Sven Schnelle8eee19d2011-05-02 19:53:04 +0000173
Julius Werner09f29212015-09-29 13:51:35 -0700174config COMPRESS_PRERAM_STAGES
175 bool "Compress romstage and verstage with LZ4"
Subrata Banikb5962a92019-06-08 12:29:02 +0530176 depends on !ARCH_X86 && (HAVE_ROMSTAGE || HAVE_VERSTAGE)
Martin Roth75e5cb72016-12-15 15:05:37 -0700177 # Default value set at the end of the file
Julius Werner09f29212015-09-29 13:51:35 -0700178 help
179 Compress romstage and (if it exists) verstage with LZ4 to save flash
180 space and speed up boot, since the time for reading the image from SPI
181 (and in the vboot case verifying it) is usually much greater than the
182 time spent decompressing. Doesn't work for XIP stages (assume all
183 ARCH_X86 for now) for obvious reasons.
184
Julius Werner99f46832018-05-16 14:14:04 -0700185config COMPRESS_BOOTBLOCK
186 bool
Subrata Banikb5962a92019-06-08 12:29:02 +0530187 depends on HAVE_BOOTBLOCK
Julius Werner99f46832018-05-16 14:14:04 -0700188 help
189 This option can be used to compress the bootblock with LZ4 and attach
190 a small self-decompression stub to its front. This can drastically
191 reduce boot time on platforms where the bootblock is loaded over a
192 very slow connection and bootblock size trumps all other factors for
Jonathan Neuschäfer2930a722018-09-29 17:42:52 +0200193 speed. Since using this option usually requires changes to the
Julius Werner99f46832018-05-16 14:14:04 -0700194 SoC memlayout and possibly extra support code, it should not be
195 user-selectable. (There's no real point in offering this to the user
196 anyway... if it works and saves boot time, you would always want it.)
197
Cristian Măgherușan-Stanciud367b002011-06-19 03:03:28 +0200198config INCLUDE_CONFIG_FILE
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200199 bool "Include the coreboot .config file into the ROM image"
Martin Roth75e5cb72016-12-15 15:05:37 -0700200 # Default value set at the end of the file
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200201 help
202 Include the .config file that was used to compile coreboot
203 in the (CBFS) ROM image. This is useful if you want to know which
204 options were used to build a specific coreboot.rom image.
205
Daniele Forsi53847a22014-07-22 18:00:56 +0200206 Saying Y here will increase the image size by 2-3KB.
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200207
208 You can use the following command to easily list the options:
209
210 grep -a CONFIG_ coreboot.rom
211
212 Alternatively, you can also use cbfstool to print the image
213 contents (including the raw 'config' item we're looking for).
214
215 Example:
216
217 $ cbfstool coreboot.rom print
218 coreboot.rom: 4096 kB, bootblocksize 1008, romsize 4194304,
219 offset 0x0
220 Alignment: 64 bytes
Steve Goodrichf0269122012-05-18 11:18:47 -0600221
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200222 Name Offset Type Size
Elyes HAOUAS2119d0b2020-02-16 10:01:33 +0100223 cmos_layout.bin 0x0 CMOS layout 1159
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200224 fallback/romstage 0x4c0 stage 339756
Daniele Forsi53847a22014-07-22 18:00:56 +0200225 fallback/ramstage 0x53440 stage 186664
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200226 fallback/payload 0x80dc0 payload 51526
227 config 0x8d740 raw 3324
228 (empty) 0x8e480 null 3610440
Cristian Măgherușan-Stanciud367b002011-06-19 03:03:28 +0200229
Vadim Bendebury9202473d2011-09-21 14:46:43 -0700230config COLLECT_TIMESTAMPS
231 bool "Create a table of timestamps collected during boot"
Paul Menzel4e4a7632015-10-11 11:57:44 +0200232 default y if ARCH_X86
Vadim Bendebury9202473d2011-09-21 14:46:43 -0700233 help
Uwe Hermannad8c95f2012-04-12 22:00:03 +0200234 Make coreboot create a table of timer-ID/timer-value pairs to
235 allow measuring time spent at different phases of the boot process.
236
Martin Rothb22bbe22018-03-07 15:32:16 -0700237config TIMESTAMPS_ON_CONSOLE
238 bool "Print the timestamp values on the console"
239 default n
240 depends on COLLECT_TIMESTAMPS
241 help
Kyösti Mälkki8b93cb72020-01-09 08:41:46 +0200242 Print the timestamps to the debug console if enabled at level info.
Martin Rothb22bbe22018-03-07 15:32:16 -0700243
Patrick Georgi7e9b9d82012-04-30 21:06:10 +0200244config USE_BLOBS
245 bool "Allow use of binary-only repository"
Felix Helda6b887e2019-12-28 19:10:12 +0100246 default y
Patrick Georgi7e9b9d82012-04-30 21:06:10 +0200247 help
248 This draws in the blobs repository, which contains binary files that
249 might be required for some chipsets or boards.
250 This flag ensures that a "Free" option remains available for users.
251
Marshall Dawson20ce4002019-10-28 15:55:03 -0600252config USE_AMD_BLOBS
253 bool "Allow AMD blobs repository (with license agreement)"
254 depends on USE_BLOBS
255 help
256 This draws in the amd_blobs repository, which contains binary files
257 distributed by AMD, including VBIOS, PSP bootloaders, SMU firmwares,
258 etc. Selecting this item to download or clone the repo implies your
259 agreement to the AMD license agreement. A copy of the license text
260 may be reviewed by reading Documentation/soc/amd/amdblobs_license.md,
261 and your copy of the license is present in the repo once downloaded.
262
263 Note that for some products, omitting PSP, SMU images, or other items
264 may result in a nonbooting coreboot.rom.
265
Julius Wernerbc1cb382020-06-18 15:03:22 -0700266config USE_QC_BLOBS
Benjamin Doron999d29e2020-07-01 01:47:22 +0000267 bool "Allow QC blobs repository (selecting this agrees to the license!)"
Julius Wernerbc1cb382020-06-18 15:03:22 -0700268 depends on USE_BLOBS
269 help
270 This draws in the qc_blobs repository, which contains binary files
271 distributed by Qualcomm that are required to build firmware for
272 certain Qualcomm SoCs (including QcLib, QC-SEC, qtiseclib and QUP
273 firmware). If you say Y here you are implicitly agreeing to the
274 Qualcomm license agreement which can be found at:
275 https://review.coreboot.org/cgit/qc_blobs.git/tree/LICENSE
276
277 *****************************************************
278 PLEASE MAKE SURE YOU READ AND AGREE TO ALL TERMS IN
279 ABOVE LICENSE AGREEMENT BEFORE SELECTING THIS OPTION!
280 *****************************************************
281
282 Not selecting this option means certain Qualcomm SoCs and related
283 mainboards cannot be built and will be hidden from the "Mainboards"
284 section.
285
Stefan Reinauerd37ab452012-12-18 16:23:28 -0800286config COVERAGE
287 bool "Code coverage support"
288 depends on COMPILER_GCC
Stefan Reinauerd37ab452012-12-18 16:23:28 -0800289 help
290 Add code coverage support for coreboot. This will store code
291 coverage information in CBMEM for extraction from user space.
292 If unsure, say N.
293
Ryan Salsamendiab37e9a2017-06-11 21:07:31 -0700294config UBSAN
295 bool "Undefined behavior sanitizer support"
296 default n
297 help
298 Instrument the code with checks for undefined behavior. If unsure,
299 say N because it adds a small performance penalty and may abort
300 on code that happens to work in spite of the UB.
301
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700302config HAVE_ASAN_IN_ROMSTAGE
303 bool
Harshit Sharma2bcaba02020-06-09 20:25:16 -0700304 default n
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700305
306config ASAN_IN_ROMSTAGE
307 bool
308 default n
309 help
310 Enable address sanitizer in romstage for platform.
311
312config HAVE_ASAN_IN_RAMSTAGE
313 bool
314 default n
315
316config ASAN_IN_RAMSTAGE
317 bool
318 default n
319 help
320 Enable address sanitizer in ramstage for platform.
321
322config ASAN
323 bool "Address sanitizer support"
324 default n
325 select ASAN_IN_ROMSTAGE if HAVE_ASAN_IN_ROMSTAGE
326 select ASAN_IN_RAMSTAGE if HAVE_ASAN_IN_RAMSTAGE
Arthur Heymans25a0c672022-03-24 00:15:46 +0100327 depends on COMPILER_GCC
Harshit Sharma2bcaba02020-06-09 20:25:16 -0700328 help
329 Enable address sanitizer - runtime memory debugger,
330 designed to find out-of-bounds accesses and use-after-scope bugs.
331
332 This feature consumes up to 1/8 of available memory and brings about
333 ~1.5x performance slowdown.
334
335 If unsure, say N.
336
Harshit Sharma0b1ec5a2020-08-05 21:16:31 -0700337if ASAN
Harshit Sharma3b9cc852020-07-06 23:38:31 -0700338 comment "Before using this feature, make sure that "
339 comment "asan_shadow_offset_callback patch is applied to GCC."
340endif
341
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200342choice
343 prompt "Stage Cache for ACPI S3 resume"
Kyösti Mälkki18a8ba42020-07-02 21:48:38 +0300344 default NO_STAGE_CACHE if !HAVE_ACPI_RESUME
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200345 default TSEG_STAGE_CACHE if SMM_TSEG
346
347config NO_STAGE_CACHE
348 bool "Disabled"
349 help
350 Do not save any component in stage cache for resume path. On resume,
351 all components would be read back from CBFS again.
352
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300353config TSEG_STAGE_CACHE
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200354 bool "TSEG"
355 depends on SMM_TSEG
Stefan Reinauer58470e32014-10-17 13:08:36 +0200356 help
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300357 The option enables stage cache support for platform. Platform
358 can stash copies of postcar, ramstage and raw runtime data
359 inside SMM TSEG, to be restored on S3 resume path.
360
361config CBMEM_STAGE_CACHE
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200362 bool "CBMEM"
363 depends on !SMM_TSEG
Kyösti Mälkki0a4457f2019-08-01 20:29:14 +0300364 help
365 The option enables stage cache support for platform. Platform
366 can stash copies of postcar, ramstage and raw runtime data
367 inside CBMEM.
368
369 While the approach is faster than reloading stages from boot media
370 it is also a possible attack scenario via which OS can possibly
371 circumvent SMM locks and SPI write protections.
372
373 If unsure, select 'N'
Stefan Reinauer58470e32014-10-17 13:08:36 +0200374
Kyösti Mälkki6766f4f2019-12-18 00:19:06 +0200375endchoice
376
Stefan Reinauer58470e32014-10-17 13:08:36 +0200377config UPDATE_IMAGE
378 bool "Update existing coreboot.rom image"
Stefan Reinauer58470e32014-10-17 13:08:36 +0200379 help
380 If this option is enabled, no new coreboot.rom file
381 is created. Instead it is expected that there already
382 is a suitable file for further processing.
383 The bootblock will not be modified.
384
Martin Roth5942e062016-01-20 14:59:21 -0700385 If unsure, select 'N'
386
Konstantin Aladyshev6544cb32015-01-24 18:52:10 +0400387config BOOTSPLASH_IMAGE
388 bool "Add a bootsplash image"
389 help
390 Select this option if you have a bootsplash image that you would
391 like to add to your ROM.
392
393 This will only add the image to the ROM. To actually run it check
394 options under 'Display' section.
395
396config BOOTSPLASH_FILE
397 string "Bootsplash path and filename"
398 depends on BOOTSPLASH_IMAGE
Martin Roth75e5cb72016-12-15 15:05:37 -0700399 # Default value set at the end of the file
Konstantin Aladyshev6544cb32015-01-24 18:52:10 +0400400 help
401 The path and filename of the file to use as graphical bootsplash
402 screen. The file format has to be jpg.
403
Duncan Laurie36e6c6f2020-05-09 19:20:10 -0700404config FW_CONFIG
405 bool "Firmware Configuration Probing"
406 default n
407 help
408 Enable support for probing devices with fw_config. This is a simple
409 bitmask broken into fields and options for probing.
410
Duncan Laurie36e6c6f2020-05-09 19:20:10 -0700411config FW_CONFIG_SOURCE_CHROMEEC_CBI
412 bool "Obtain Firmware Configuration value from Google Chrome EC CBI"
413 depends on FW_CONFIG && EC_GOOGLE_CHROMEEC
414 default n
415 help
416 This option tells coreboot to read the firmware configuration value
417 from the Google Chrome Embedded Controller CBI interface. This source
418 is not tried if FW_CONFIG_SOURCE_CBFS is enabled and the value was
419 found in CBFS.
420
Wonkyu Kim38649732021-11-01 20:15:30 -0700421config FW_CONFIG_SOURCE_CBFS
422 bool "Obtain Firmware Configuration value from CBFS"
423 depends on FW_CONFIG
424 default n
425 help
426 With this option enabled coreboot will look for the 32bit firmware
427 configuration value in CBFS at the selected prefix with the file name
428 "fw_config". This option will override other sources and allow the
429 local image to preempt the mainboard selected source and can be used as
430 FW_CONFIG_SOURCE_CHROMEEC_CBI fallback option.
431
Wonkyu Kim43e26922021-11-01 20:55:25 -0700432config FW_CONFIG_SOURCE_VPD
433 bool "Obtain Firmware Configuration value from VPD"
434 depends on FW_CONFIG && VPD
435 default n
436 help
437 With this option enabled coreboot will look for the 32bit firmware
438 configuration value in VPD key name "fw_config". This option will
439 override other sources and allow the local image to preempt the mainboard
440 selected source and can be used for other FW_CONFIG_SOURCEs fallback option.
441
Nico Huber94cdec62019-06-06 19:36:02 +0200442config HAVE_RAMPAYLOAD
443 bool
444
Subrata Banik7e893a02019-05-06 14:17:41 +0530445config RAMPAYLOAD
446 bool "Enable coreboot flow without executing ramstage"
Subrata Banik86dbe0f2019-06-28 18:18:37 +0530447 default y if ARCH_X86
Nico Huber94cdec62019-06-06 19:36:02 +0200448 depends on HAVE_RAMPAYLOAD
Subrata Banik7e893a02019-05-06 14:17:41 +0530449 help
450 If this option is enabled, coreboot flow will skip ramstage
451 loading and execution of ramstage to load payload.
452
453 Instead it is expected to load payload from postcar stage itself.
454
455 In this flow coreboot will perform basic x86 initialization
456 (DRAM resource allocation), MTRR programming,
457 Skip PCI enumeration logic and only allocate BAR for fixed devices
458 (bootable devices, TPM over GSPI).
459
Subrata Banik37bead62020-02-09 19:13:52 +0530460config HAVE_CONFIGURABLE_RAMSTAGE
461 bool
462
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000463config CONFIGURABLE_RAMSTAGE
464 bool "Enable a configurable ramstage."
465 default y if ARCH_X86
Subrata Banik37bead62020-02-09 19:13:52 +0530466 depends on HAVE_CONFIGURABLE_RAMSTAGE
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000467 help
468 A configurable ramstage allows you to select which parts of the ramstage
469 to run. Currently, we can only select a minimal PCI scanning step.
470 The minimal PCI scanning will only check those parts that are enabled
471 in the devicetree.cb. By convention none of those devices should be bridges.
472
473config MINIMAL_PCI_SCANNING
474 bool "Enable minimal PCI scanning"
Subrata Banik1cb26a62020-02-09 19:35:16 +0530475 depends on CONFIGURABLE_RAMSTAGE && PCI
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000476 help
Subrata Banik1cb26a62020-02-09 19:35:16 +0530477 If this option is enabled, coreboot will scan only PCI devices
Ronald G. Minnich466ca2c2019-10-22 02:02:24 +0000478 marked as mandatory in devicetree.cb
Uwe Hermannc04be932009-10-05 13:55:28 +0000479endmenu
480
Martin Roth026e4dc2015-06-19 23:17:15 -0600481menu "Mainboard"
482
Stefan Reinauera48ca842015-04-04 01:58:28 +0200483source "src/mainboard/Kconfig"
Stefan Reinauer8aedcbc2010-12-16 23:37:17 +0000484
Marshall Dawsone9375132016-09-04 08:38:33 -0600485config DEVICETREE
486 string
487 default "devicetree.cb"
488 help
489 This symbol allows mainboards to select a different file under their
490 mainboard directory for the devicetree.cb file. This allows the board
491 variants that need different devicetrees to be in the same directory.
492
493 Examples: "devicetree.variant.cb"
494 "variant/devicetree.cb"
495
Furquan Shaikhf2419982018-06-21 18:50:48 -0700496config OVERRIDE_DEVICETREE
497 string
498 default ""
499 help
500 This symbol allows variants to provide an override devicetree file to
501 override the registers and/or add new devices on top of the ones
502 provided by baseboard devicetree using CONFIG_DEVICETREE.
503
504 Examples: "devicetree.variant-override.cb"
505 "variant/devicetree-override.cb"
506
Patrick Georgi8a3592e2015-09-16 18:10:52 +0200507config FMDFILE
508 string "fmap description file in fmd format"
Patrick Georgib8fba862020-06-17 21:06:53 +0200509 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/chromeos.fmd" if CHROMEOS
Patrick Georgi8a3592e2015-09-16 18:10:52 +0200510 default ""
511 help
512 The build system creates a default FMAP from ROM_SIZE and CBFS_SIZE,
513 but in some cases more complex setups are required.
514 When an fmd is specified, it overrides the default format.
515
Arthur Heymans965881b2019-09-25 13:18:52 +0200516config CBFS_SIZE
517 hex "Size of CBFS filesystem in ROM"
518 depends on FMDFILE = ""
519 # Default value set at the end of the file
520 help
521 This is the part of the ROM actually managed by CBFS, located at the
522 end of the ROM (passed through cbfstool -o) on x86 and at at the start
523 of the ROM (passed through cbfstool -s) everywhere else. It defaults
524 to span the whole ROM on all but Intel systems that use an Intel Firmware
525 Descriptor. It can be overridden to make coreboot live alongside other
526 components like ChromeOS's vboot/FMAP or Intel's IFD / ME / TXE
527 binaries. This symbol should only be used to generate a default FMAP and
528 is unused when a non-default fmd file is provided via CONFIG_FMDFILE.
529
Martin Rothda1ca202015-12-26 16:51:16 -0700530endmenu
531
Martin Rothb09a5692016-01-24 19:38:33 -0700532# load site-local kconfig to allow user specific defaults and overrides
533source "site-local/Kconfig"
534
Vladimir Serbinenkoa9db82f2014-10-16 13:21:47 +0200535config SYSTEM_TYPE_LAPTOP
Martin Roth595e7772015-04-26 18:53:26 -0600536 default n
537 bool
Vladimir Serbinenkoa9db82f2014-10-16 13:21:47 +0200538
Duncan Laurie8312df42019-02-01 11:33:57 -0800539config SYSTEM_TYPE_TABLET
540 default n
541 bool
542
543config SYSTEM_TYPE_DETACHABLE
544 default n
545 bool
546
547config SYSTEM_TYPE_CONVERTIBLE
548 default n
549 bool
550
Werner Zehc0fb3612016-01-14 15:08:36 +0100551config CBFS_AUTOGEN_ATTRIBUTES
552 default n
553 bool
554 help
555 If this option is selected, every file in cbfs which has a constraint
556 regarding position or alignment will get an additional file attribute
557 which describes this constraint.
558
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000559menu "Chipset"
560
Duncan Lauried2119762015-06-08 18:11:56 -0700561comment "SoC"
Chris Chingaa8e5d32017-10-20 10:43:39 -0600562source "src/soc/*/Kconfig"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000563comment "CPU"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200564source "src/cpu/Kconfig"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000565comment "Northbridge"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200566source "src/northbridge/*/*/Kconfig"
Angel Ponsf462b3d2021-01-20 00:36:31 +0100567source "src/northbridge/*/*/Kconfig.common"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000568comment "Southbridge"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200569source "src/southbridge/*/*/Kconfig"
Angel Ponsc027ece2021-02-16 16:13:35 +0100570source "src/southbridge/*/*/Kconfig.common"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000571comment "Super I/O"
Omar Pakker57603e22016-07-29 23:31:45 +0200572source "src/superio/*/*/Kconfig"
Sven Schnelle7592e8b2011-01-27 11:43:03 +0000573comment "Embedded Controllers"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200574source "src/ec/acpi/Kconfig"
575source "src/ec/*/*/Kconfig"
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000576
Martin Roth59aa2b12015-06-20 16:17:12 -0600577source "src/southbridge/intel/common/firmware/Kconfig"
Martin Rothe1523ec2015-06-19 22:30:43 -0600578source "src/vendorcode/*/Kconfig"
Martin Roth59aa2b12015-06-20 16:17:12 -0600579
Martin Rothe1523ec2015-06-19 22:30:43 -0600580source "src/arch/*/Kconfig"
581
Duncan Lauriee335c2e2020-07-29 16:28:43 -0700582config CHIPSET_DEVICETREE
583 string
584 default ""
585 help
586 This symbol allows a chipset to provide a set of default settings in
587 a devicetree which are common to all mainboards. This may include
588 devices (including alias names), chip drivers, register settings,
589 and others. This path is relative to the src/ directory.
590
591 Example: "chipset.cb"
592
Uwe Hermann63a8f2a2009-10-26 21:42:13 +0000593endmenu
Patrick Georgi0588d192009-08-12 15:00:51 +0000594
Stefan Reinauera48ca842015-04-04 01:58:28 +0200595source "src/device/Kconfig"
Stefan Reinauer95a63962012-11-13 17:00:01 -0800596
Rudolf Marekd9c25492010-05-16 15:31:53 +0000597menu "Generic Drivers"
Stefan Reinauera48ca842015-04-04 01:58:28 +0200598source "src/drivers/*/Kconfig"
Stefan Reinauer86ddd732016-03-11 20:22:28 -0800599source "src/drivers/*/*/Kconfig"
Duncan Laurie2cc126b2020-08-28 19:46:35 +0000600source "src/drivers/*/*/*/Kconfig"
Lee Leahy48dbc662017-05-08 16:56:03 -0700601source "src/commonlib/storage/Kconfig"
Rudolf Marekd9c25492010-05-16 15:31:53 +0000602endmenu
603
Philipp Deppenwiese1899fbe2017-10-16 17:09:33 +0200604menu "Security"
605
606source "src/security/Kconfig"
Wim Vervoorne32d16f2019-11-14 14:10:28 +0100607source "src/vendorcode/eltan/security/Kconfig"
Philipp Deppenwiese1899fbe2017-10-16 17:09:33 +0200608
609endmenu
610
Martin Roth09210a12016-05-17 11:28:23 -0600611source "src/acpi/Kconfig"
612
Aaron Durbin4a36c4e2016-08-11 11:02:26 -0500613# This option is for the current boards/chipsets where SPI flash
614# is not the boot device. Currently nearly all boards/chipsets assume
615# SPI flash is the boot device.
616config BOOT_DEVICE_NOT_SPI_FLASH
617 bool
618 default n
619
620config BOOT_DEVICE_SPI_FLASH
621 bool
622 default y if !BOOT_DEVICE_NOT_SPI_FLASH
623 default n
624
Aaron Durbin16c173f2016-08-11 14:04:10 -0500625config BOOT_DEVICE_MEMORY_MAPPED
626 bool
627 default y if ARCH_X86 && BOOT_DEVICE_SPI_FLASH
628 default n
629 help
630 Inform system if SPI is memory-mapped or not.
631
Aaron Durbine8e118d2016-08-12 15:00:10 -0500632config BOOT_DEVICE_SUPPORTS_WRITES
633 bool
634 default n
635 help
636 Indicate that the platform has writable boot device
637 support.
638
Patrick Georgi0770f252015-04-22 13:28:21 +0200639config RTC
640 bool
641 default n
642
Patrick Georgi0588d192009-08-12 15:00:51 +0000643config HEAP_SIZE
644 hex
Marty E. Plummer0987e432019-04-22 20:46:27 -0500645 default 0x100000 if FLATTENED_DEVICE_TREE
Myles Watson04000f42009-10-16 19:12:49 +0000646 default 0x4000
Patrick Georgi0588d192009-08-12 15:00:51 +0000647
Julius Wernerc3e7c4e2014-09-19 13:18:16 -0700648config STACK_SIZE
649 hex
Arthur Heymans3951bc72022-05-23 23:28:44 +0200650 default 0x2000 if ARCH_X86
Julius Werner66a476a2015-10-12 16:45:21 -0700651 default 0x0
Julius Wernerc3e7c4e2014-09-19 13:18:16 -0700652
Patrick Georgi0588d192009-08-12 15:00:51 +0000653config MAX_CPUS
654 int
655 default 1
656
Stefan Reinauera48ca842015-04-04 01:58:28 +0200657source "src/console/Kconfig"
Patrick Georgi0588d192009-08-12 15:00:51 +0000658
659config HAVE_ACPI_RESUME
660 bool
661 default n
662
Wim Vervoornbccc7e72020-01-15 11:31:25 +0100663config DISABLE_ACPI_HIBERNATE
664 bool
665 default n
666 help
667 Removes S4 from the available sleepstates
668
Aaron Durbin87c9fae2016-01-22 15:26:04 -0600669config RESUME_PATH_SAME_AS_BOOT
670 bool
671 default y if ARCH_X86
672 depends on HAVE_ACPI_RESUME
673 help
674 This option indicates that when a system resumes it takes the
675 same path as a regular boot. e.g. an x86 system runs from the
676 reset vector at 0xfffffff0 on both resume and warm/cold boot.
677
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300678config NO_MONOTONIC_TIMER
Aaron Durbina4217912013-04-29 22:31:51 -0500679 def_bool n
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300680
681config HAVE_MONOTONIC_TIMER
682 bool
683 depends on !NO_MONOTONIC_TIMER
Kyösti Mälkkib28b6b52019-07-01 15:38:25 +0300684 default y
Aaron Durbina4217912013-04-29 22:31:51 -0500685 help
686 The board/chipset provides a monotonic timer.
687
Aaron Durbine5e36302014-09-25 10:05:15 -0500688config GENERIC_UDELAY
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300689 bool
Aaron Durbine5e36302014-09-25 10:05:15 -0500690 depends on HAVE_MONOTONIC_TIMER
Kyösti Mälkki76c43862019-07-01 17:25:41 +0300691 default y if !ARCH_X86
Aaron Durbine5e36302014-09-25 10:05:15 -0500692 help
693 The board/chipset uses a generic udelay function utilizing the
694 monotonic timer.
695
Aaron Durbin340ca912013-04-30 09:58:12 -0500696config TIMER_QUEUE
697 def_bool n
698 depends on HAVE_MONOTONIC_TIMER
699 help
Kyösti Mälkkiecd84242013-09-13 07:57:49 +0300700 Provide a timer queue for performing time-based callbacks.
Aaron Durbin340ca912013-04-30 09:58:12 -0500701
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500702config COOP_MULTITASKING
703 def_bool n
Raul E Rangel199c45c2021-11-02 11:29:33 -0600704 select TIMER_QUEUE
705 depends on ARCH_X86 && CPU_INFO_V2
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500706 help
707 Cooperative multitasking allows callbacks to be multiplexed on the
Raul E Rangel199c45c2021-11-02 11:29:33 -0600708 main thread. With this enabled it allows for multiple execution paths
709 to take place when they have udelay() calls within their code.
Aaron Durbin4409a5e2013-05-06 12:20:52 -0500710
711config NUM_THREADS
712 int
713 default 4
714 depends on COOP_MULTITASKING
715 help
716 How many execution threads to cooperatively multitask with.
717
Angel Pons9bc780f2021-05-20 16:43:08 +0200718config HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
719 bool
720 help
721 Selected by mainboards which implement a mainboard-specific mechanism
722 to access the values for runtime-configurable options. For example, a
723 custom BMC interface or an EEPROM with an externally-imposed layout.
724
Patrick Georgi0588d192009-08-12 15:00:51 +0000725config HAVE_OPTION_TABLE
726 bool
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000727 default n
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000728 help
729 This variable specifies whether a given board has a cmos.layout
730 file containing NVRAM/CMOS bit definitions.
Edwin Beasanteb50c7d2010-07-06 21:05:04 +0000731 It defaults to 'n' but can be selected in mainboard/*/Kconfig.
Patrick Georgi0588d192009-08-12 15:00:51 +0000732
Angel Ponsf206cda2021-05-17 12:12:39 +0200733config CMOS_LAYOUT_FILE
734 string
735 default "src/mainboard/\$(MAINBOARDDIR)/cmos.layout"
736 depends on HAVE_OPTION_TABLE
737
Patrick Georgi0588d192009-08-12 15:00:51 +0000738config PCI_IO_CFG_EXT
739 bool
740 default n
741
742config IOAPIC
743 bool
Kyösti Mälkkic25ecb52021-06-06 08:28:16 +0300744 default y if SMP
Patrick Georgi0588d192009-08-12 15:00:51 +0000745 default n
746
Myles Watson45bb25f2009-09-22 18:49:08 +0000747config USE_WATCHDOG_ON_BOOT
748 bool
749 default n
750
Myles Watson45bb25f2009-09-22 18:49:08 +0000751config GFXUMA
752 bool
Myles Watsond73c1b52009-10-26 15:14:07 +0000753 default n
Myles Watson45bb25f2009-09-22 18:49:08 +0000754 help
755 Enable Unified Memory Architecture for graphics.
756
Myles Watsonb8e20272009-10-15 13:35:47 +0000757config HAVE_MP_TABLE
758 bool
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000759 help
760 This variable specifies whether a given board has MP table support.
761 It is usually set in mainboard/*/Kconfig.
762 Whether or not the MP table is actually generated by coreboot
763 is configurable by the user via GENERATE_MP_TABLE.
Myles Watsonb8e20272009-10-15 13:35:47 +0000764
765config HAVE_PIRQ_TABLE
766 bool
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000767 help
768 This variable specifies whether a given board has PIRQ table support.
769 It is usually set in mainboard/*/Kconfig.
770 Whether or not the PIRQ table is actually generated by coreboot
771 is configurable by the user via GENERATE_PIRQ_TABLE.
Myles Watsonb8e20272009-10-15 13:35:47 +0000772
Aaron Durbin9420a522015-11-17 16:31:00 -0600773config ACPI_NHLT
774 bool
775 default n
776 help
777 Build support for NHLT (non HD Audio) ACPI table generation.
778
Myles Watsond73c1b52009-10-26 15:14:07 +0000779#These Options are here to avoid "undefined" warnings.
780#The actual selection and help texts are in the following menu.
781
Uwe Hermann168b11b2009-10-07 16:15:40 +0000782menu "System tables"
Myles Watson45bb25f2009-09-22 18:49:08 +0000783
Myles Watsonb8e20272009-10-15 13:35:47 +0000784config GENERATE_MP_TABLE
Stefan Reinauer56cd70b2012-11-13 17:33:08 -0800785 prompt "Generate an MP table" if HAVE_MP_TABLE || DRIVERS_GENERIC_IOAPIC
786 bool
787 default HAVE_MP_TABLE || DRIVERS_GENERIC_IOAPIC
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000788 help
789 Generate an MP table (conforming to the Intel MultiProcessor
790 specification 1.4) for this board.
791
792 If unsure, say Y.
Myles Watson45bb25f2009-09-22 18:49:08 +0000793
Myles Watsonb8e20272009-10-15 13:35:47 +0000794config GENERATE_PIRQ_TABLE
Stefan Reinauer56cd70b2012-11-13 17:33:08 -0800795 prompt "Generate a PIRQ table" if HAVE_PIRQ_TABLE
796 bool
797 default HAVE_PIRQ_TABLE
Uwe Hermann6ba13bb2009-10-15 17:49:07 +0000798 help
799 Generate a PIRQ table for this board.
800
801 If unsure, say Y.
Myles Watson45bb25f2009-09-22 18:49:08 +0000802
Sven Schnelle164bcfd2011-08-14 20:56:34 +0200803config GENERATE_SMBIOS_TABLES
804 depends on ARCH_X86
805 bool "Generate SMBIOS tables"
806 default y
807 help
808 Generate SMBIOS tables for this board.
809
810 If unsure, say Y.
811
Angel Pons437da712021-09-03 16:51:40 +0200812config SMBIOS_TYPE41_PROVIDED_BY_DEVTREE
813 bool
814 depends on ARCH_X86
815 help
816 If enabled, only generate SMBIOS Type 41 entries for PCI devices in
817 the devicetree for which Type 41 information is provided, e.g. with
818 the `smbios_dev_info` devicetree syntax. This is useful to manually
819 assign specific instance IDs to onboard devices irrespective of the
820 device traversal order. It is assumed that instance IDs for devices
821 of the same class are unique.
822 When disabled, coreboot autogenerates SMBIOS Type 41 entries for all
823 appropriate PCI devices in the devicetree. Instance IDs are assigned
824 successive numbers from a monotonically increasing counter, with one
825 counter for each device class.
826
Vladimir Serbinenko0afdec42015-05-30 23:08:26 +0200827config SMBIOS_PROVIDED_BY_MOBO
828 bool
829 default n
830
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200831config MAINBOARD_SERIAL_NUMBER
Nico Huberebd8a4f2017-11-01 09:49:16 +0100832 prompt "SMBIOS Serial Number" if !SMBIOS_PROVIDED_BY_MOBO
833 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200834 depends on GENERATE_SMBIOS_TABLES
835 default "123456789"
Martin Roth595e7772015-04-26 18:53:26 -0600836 help
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200837 The Serial Number to store in SMBIOS structures.
838
839config MAINBOARD_VERSION
Nico Huberebd8a4f2017-11-01 09:49:16 +0100840 prompt "SMBIOS Version Number" if !SMBIOS_PROVIDED_BY_MOBO
841 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200842 depends on GENERATE_SMBIOS_TABLES
843 default "1.0"
844 help
845 The Version Number to store in SMBIOS structures.
846
847config MAINBOARD_SMBIOS_MANUFACTURER
Nico Huberebd8a4f2017-11-01 09:49:16 +0100848 prompt "SMBIOS Manufacturer" if !SMBIOS_PROVIDED_BY_MOBO
849 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200850 depends on GENERATE_SMBIOS_TABLES
851 default MAINBOARD_VENDOR
852 help
853 Override the default Manufacturer stored in SMBIOS structures.
854
855config MAINBOARD_SMBIOS_PRODUCT_NAME
Nico Huberebd8a4f2017-11-01 09:49:16 +0100856 prompt "SMBIOS Product name" if !SMBIOS_PROVIDED_BY_MOBO
857 string
Stefan Reinauer6023ca42014-10-17 13:28:15 +0200858 depends on GENERATE_SMBIOS_TABLES
859 default MAINBOARD_PART_NUMBER
860 help
861 Override the default Product name stored in SMBIOS structures.
862
Johnny Linc746a742020-06-03 11:44:22 +0800863config VPD_SMBIOS_VERSION
864 bool "Populates SMBIOS type 0 version from the VPD_RO variable 'firmware_version'"
865 default n
866 depends on VPD && GENERATE_SMBIOS_TABLES
867 help
868 Selecting this option will read firmware_version from
869 VPD_RO and override SMBIOS type 0 version. One special
870 scenario of using this feature is to assign a BIOS version
871 to a coreboot image without the need to rebuild from source.
872
Myles Watson45bb25f2009-09-22 18:49:08 +0000873endmenu
874
Martin Roth21c06502016-02-04 19:52:27 -0700875source "payloads/Kconfig"
Peter Stugea758ca22009-09-17 16:21:31 +0000876
Uwe Hermann168b11b2009-10-07 16:15:40 +0000877menu "Debugging"
878
Nico Huberd67edca2018-11-13 19:28:07 +0100879comment "CPU Debug Settings"
Arthur Heymansaae81902019-11-04 21:50:21 +0100880source "src/cpu/*/Kconfig.debug_cpu"
Nico Huberd67edca2018-11-13 19:28:07 +0100881
Arthur Heymans71bd7e42019-10-20 14:20:53 +0200882comment "BLOB Debug Settings"
883source "src/drivers/intel/fsp*/Kconfig.debug_blob"
884
Nico Huberd67edca2018-11-13 19:28:07 +0100885comment "General Debug Settings"
886
Uwe Hermann168b11b2009-10-07 16:15:40 +0000887# TODO: Better help text and detailed instructions.
Patrick Georgi0588d192009-08-12 15:00:51 +0000888config GDB_STUB
Uwe Hermann5ec2c2b2009-08-25 00:53:22 +0000889 bool "GDB debugging support"
Rudolf Marek65888022012-03-25 20:51:16 +0200890 default n
Arthur Heymans8e980132019-11-04 09:33:04 +0100891 depends on DRIVERS_UART
Patrick Georgi0588d192009-08-12 15:00:51 +0000892 help
Uwe Hermann5ec2c2b2009-08-25 00:53:22 +0000893 If enabled, you will be able to set breakpoints for gdb debugging.
Elyes Haouas95231b22022-02-16 22:37:44 +0100894 See src/arch/x86/c_start.S for details.
Patrick Georgi0588d192009-08-12 15:00:51 +0000895
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200896config GDB_WAIT
Denis 'GNUtoo' Carikli7d234f22015-12-10 21:58:52 +0100897 bool "Wait for a GDB connection in the ramstage"
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200898 default n
899 depends on GDB_STUB
900 help
Denis 'GNUtoo' Carikli7d234f22015-12-10 21:58:52 +0100901 If enabled, coreboot will wait for a GDB connection in the ramstage.
902
Denis 'GNUtoo' Cariklie4cece02012-06-22 15:56:37 +0200903
Julius Wernerd82e0cf2015-02-17 17:27:23 -0800904config FATAL_ASSERTS
905 bool "Halt when hitting a BUG() or assertion error"
906 default n
907 help
908 If enabled, coreboot will call hlt() on a BUG() or failed ASSERT().
909
Nico Huber371a6672018-11-13 22:06:40 +0100910config HAVE_DEBUG_GPIO
911 bool
912
913config DEBUG_GPIO
914 bool "Output verbose GPIO debug messages"
915 depends on HAVE_DEBUG_GPIO
916
Stefan Reinauerfe422182012-05-02 16:33:18 -0700917config DEBUG_CBFS
918 bool "Output verbose CBFS debug messages"
919 default n
Stefan Reinauerfe422182012-05-02 16:33:18 -0700920 help
921 This option enables additional CBFS related debug messages.
922
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000923config HAVE_DEBUG_RAM_SETUP
924 def_bool n
925
Uwe Hermann01ce6012010-03-05 10:03:50 +0000926config DEBUG_RAM_SETUP
927 bool "Output verbose RAM init debug messages"
928 default n
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000929 depends on HAVE_DEBUG_RAM_SETUP
Uwe Hermann01ce6012010-03-05 10:03:50 +0000930 help
931 This option enables additional RAM init related debug messages.
932 It is recommended to enable this when debugging issues on your
933 board which might be RAM init related.
934
935 Note: This option will increase the size of the coreboot image.
936
937 If unsure, say N.
938
Myles Watson80e914ff2010-06-01 19:25:31 +0000939config DEBUG_PIRQ
940 bool "Check PIRQ table consistency"
941 default n
942 depends on GENERATE_PIRQ_TABLE
943 help
944 If unsure, say N.
945
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000946config HAVE_DEBUG_SMBUS
947 def_bool n
948
Uwe Hermann01ce6012010-03-05 10:03:50 +0000949config DEBUG_SMBUS
950 bool "Output verbose SMBus debug messages"
951 default n
Jens Rottmann0d11f2d2010-08-26 12:46:02 +0000952 depends on HAVE_DEBUG_SMBUS
Uwe Hermann01ce6012010-03-05 10:03:50 +0000953 help
954 This option enables additional SMBus (and SPD) debug messages.
955
956 Note: This option will increase the size of the coreboot image.
957
958 If unsure, say N.
959
960config DEBUG_SMI
961 bool "Output verbose SMI debug messages"
962 default n
963 depends on HAVE_SMI_HANDLER
Angel Pons12d48cd2020-10-03 12:22:04 +0200964 select SPI_FLASH_SMM if EM100PRO_SPI_CONSOLE || CONSOLE_SPI_FLASH
Uwe Hermann01ce6012010-03-05 10:03:50 +0000965 help
966 This option enables additional SMI related debug messages.
967
968 Note: This option will increase the size of the coreboot image.
969
970 If unsure, say N.
971
Kyösti Mälkki94464472020-06-13 13:45:42 +0300972config DEBUG_PERIODIC_SMI
973 bool "Trigger SMI periodically"
974 depends on DEBUG_SMI
975
Uwe Hermanna953f372010-11-10 00:14:32 +0000976# Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
977# printk(BIOS_DEBUG, ...) calls.
978config DEBUG_MALLOC
Marc Jonescf3dcd62020-12-02 11:34:17 -0700979 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 -0800980 bool
Uwe Hermanna953f372010-11-10 00:14:32 +0000981 default n
Uwe Hermanna953f372010-11-10 00:14:32 +0000982 help
983 This option enables additional malloc related debug messages.
984
985 Note: This option will increase the size of the coreboot image.
986
987 If unsure, say N.
Cristian Măgherușan-Stanciu9f52ea42011-07-02 00:44:39 +0300988
Marc Jones5b5c52e2020-10-12 11:44:46 -0600989# Only visible if DEBUG_SPEW (8) is set.
990config DEBUG_RESOURCES
Marc Jonescf3dcd62020-12-02 11:34:17 -0700991 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 -0600992 default n
993 help
994 This option enables additional PCI memory and IO debug messages.
995 Note: This option will increase the size of the coreboot image.
996 If unsure, say N.
997
Kyösti Mälkki66277952018-12-31 15:22:34 +0200998config DEBUG_CONSOLE_INIT
999 bool "Debug console initialisation code"
1000 default n
1001 help
1002 With this option printk()'s are attempted before console hardware
1003 initialisation has been completed. Your mileage may vary.
1004
1005 Typically you will need to modify source in console_hw_init() such
1006 that a working console appears before the one you want to debug.
1007
1008 If unsure, say N.
1009
Uwe Hermanna953f372010-11-10 00:14:32 +00001010# Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
1011# printk(BIOS_DEBUG, ...) calls.
Myles Watson6c9bc012010-09-07 22:30:15 +00001012config REALMODE_DEBUG
Marc Jonescf3dcd62020-12-02 11:34:17 -07001013 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 -08001014 bool
Myles Watson6c9bc012010-09-07 22:30:15 +00001015 default n
Peter Stuge5015f792010-11-10 02:00:32 +00001016 depends on PCI_OPTION_ROM_RUN_REALMODE
Myles Watson6c9bc012010-09-07 22:30:15 +00001017 help
1018 This option enables additional x86emu related debug messages.
1019
1020 Note: This option will increase the time to emulate a ROM.
1021
1022 If unsure, say N.
1023
Uwe Hermann01ce6012010-03-05 10:03:50 +00001024config X86EMU_DEBUG
1025 bool "Output verbose x86emu debug messages"
1026 default n
1027 depends on PCI_OPTION_ROM_RUN_YABEL
1028 help
1029 This option enables additional x86emu related debug messages.
1030
1031 Note: This option will increase the size of the coreboot image.
1032
1033 If unsure, say N.
1034
1035config X86EMU_DEBUG_JMP
1036 bool "Trace JMP/RETF"
1037 default n
1038 depends on X86EMU_DEBUG
1039 help
1040 Print information about JMP and RETF opcodes from x86emu.
1041
1042 Note: This option will increase the size of the coreboot image.
1043
1044 If unsure, say N.
1045
1046config X86EMU_DEBUG_TRACE
1047 bool "Trace all opcodes"
1048 default n
1049 depends on X86EMU_DEBUG
1050 help
1051 Print _all_ opcodes that are executed by x86emu.
Stefan Reinauer14e22772010-04-27 06:56:47 +00001052
Uwe Hermann01ce6012010-03-05 10:03:50 +00001053 WARNING: This will produce a LOT of output and take a long time.
1054
1055 Note: This option will increase the size of the coreboot image.
1056
1057 If unsure, say N.
1058
1059config X86EMU_DEBUG_PNP
1060 bool "Log Plug&Play accesses"
1061 default n
1062 depends on X86EMU_DEBUG
1063 help
1064 Print Plug And Play accesses made by option ROMs.
1065
1066 Note: This option will increase the size of the coreboot image.
1067
1068 If unsure, say N.
1069
1070config X86EMU_DEBUG_DISK
1071 bool "Log Disk I/O"
1072 default n
1073 depends on X86EMU_DEBUG
1074 help
1075 Print Disk I/O related messages.
1076
1077 Note: This option will increase the size of the coreboot image.
1078
1079 If unsure, say N.
1080
1081config X86EMU_DEBUG_PMM
1082 bool "Log PMM"
1083 default n
1084 depends on X86EMU_DEBUG
1085 help
1086 Print messages related to POST Memory Manager (PMM).
1087
1088 Note: This option will increase the size of the coreboot image.
1089
1090 If unsure, say N.
1091
1092
1093config X86EMU_DEBUG_VBE
1094 bool "Debug VESA BIOS Extensions"
1095 default n
1096 depends on X86EMU_DEBUG
1097 help
1098 Print messages related to VESA BIOS Extension (VBE) functions.
1099
1100 Note: This option will increase the size of the coreboot image.
1101
1102 If unsure, say N.
1103
1104config X86EMU_DEBUG_INT10
1105 bool "Redirect INT10 output to console"
1106 default n
1107 depends on X86EMU_DEBUG
1108 help
1109 Let INT10 (i.e. character output) calls print messages to debug output.
1110
1111 Note: This option will increase the size of the coreboot image.
1112
1113 If unsure, say N.
1114
1115config X86EMU_DEBUG_INTERRUPTS
1116 bool "Log intXX calls"
1117 default n
1118 depends on X86EMU_DEBUG
1119 help
1120 Print messages related to interrupt handling.
1121
1122 Note: This option will increase the size of the coreboot image.
1123
1124 If unsure, say N.
1125
1126config X86EMU_DEBUG_CHECK_VMEM_ACCESS
1127 bool "Log special memory accesses"
1128 default n
1129 depends on X86EMU_DEBUG
1130 help
1131 Print messages related to accesses to certain areas of the virtual
1132 memory (e.g. BDA (BIOS Data Area) or interrupt vectors)
1133
1134 Note: This option will increase the size of the coreboot image.
1135
1136 If unsure, say N.
1137
1138config X86EMU_DEBUG_MEM
1139 bool "Log all memory accesses"
1140 default n
1141 depends on X86EMU_DEBUG
1142 help
1143 Print memory accesses made by option ROM.
1144 Note: This also includes accesses to fetch instructions.
1145
1146 Note: This option will increase the size of the coreboot image.
1147
1148 If unsure, say N.
1149
1150config X86EMU_DEBUG_IO
1151 bool "Log IO accesses"
1152 default n
1153 depends on X86EMU_DEBUG
1154 help
1155 Print I/O accesses made by option ROM.
1156
1157 Note: This option will increase the size of the coreboot image.
1158
1159 If unsure, say N.
1160
Denis 'GNUtoo' Carikli4cdc5d62013-05-15 00:19:49 +02001161config X86EMU_DEBUG_TIMINGS
1162 bool "Output timing information"
1163 default n
Kyösti Mälkki91945fb2019-07-10 15:10:22 +03001164 depends on X86EMU_DEBUG && HAVE_MONOTONIC_TIMER
Denis 'GNUtoo' Carikli4cdc5d62013-05-15 00:19:49 +02001165 help
1166 Print timing information needed by i915tool.
1167
1168 If unsure, say N.
1169
Stefan Reinauer1c56d9b2012-05-10 11:27:32 -07001170config DEBUG_SPI_FLASH
1171 bool "Output verbose SPI flash debug messages"
1172 default n
1173 depends on SPI_FLASH
1174 help
1175 This option enables additional SPI flash related debug messages.
1176
Marc Jonesdc12daf2021-04-16 14:26:08 -06001177config DEBUG_IPMI
1178 bool "Output verbose IPMI debug messages"
1179 default n
1180 depends on IPMI_KCS
1181 help
1182 This option enables additional IPMI related debug messages.
1183
Stefan Reinauer8e073822012-04-04 00:07:22 +02001184if SOUTHBRIDGE_INTEL_BD82X6X && DEFAULT_CONSOLE_LOGLEVEL_8
1185# Only visible with the right southbridge and loglevel.
1186config DEBUG_INTEL_ME
1187 bool "Verbose logging for Intel Management Engine"
1188 default n
1189 help
1190 Enable verbose logging for Intel Management Engine driver that
1191 is present on Intel 6-series chipsets.
1192endif
1193
Marc Jones8b522db2020-10-12 11:58:46 -06001194config DEBUG_FUNC
Marc Jonesc6076ef2021-11-11 12:07:46 -07001195 bool "Enable function entry and exit reporting macros" if DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
Marc Jones8b522db2020-10-12 11:58:46 -06001196 default n
1197 help
1198 This option enables additional function entry and exit debug messages
Kyösti Mälkki8c99c272020-07-24 15:54:31 +03001199 for select functions.
Marc Jones8b522db2020-10-12 11:58:46 -06001200 Note: This option will increase the size of the coreboot image.
1201 If unsure, say N.
1202
Stefan Reinauerd37ab452012-12-18 16:23:28 -08001203config DEBUG_COVERAGE
1204 bool "Debug code coverage"
1205 default n
1206 depends on COVERAGE
1207 help
1208 If enabled, the code coverage hooks in coreboot will output some
1209 information about the coverage data that is dumped.
1210
Jonathan Neuschäferfc04f9b2016-06-29 21:59:32 +02001211config DEBUG_BOOT_STATE
1212 bool "Debug boot state machine"
1213 default n
1214 help
1215 Control debugging of the boot state machine. When selected displays
1216 the state boundaries in ramstage.
1217
Nico Hubere84e6252016-10-05 17:43:56 +02001218config DEBUG_ADA_CODE
1219 bool "Compile debug code in Ada sources"
1220 default n
1221 help
1222 Add the compiler switch `-gnata` to compile code guarded by
1223 `pragma Debug`.
1224
Simon Glass46255f72018-07-12 15:26:07 -06001225config HAVE_EM100_SUPPORT
Arthur Heymans1842aa22022-04-17 20:10:41 +02001226 bool
Simon Glass46255f72018-07-12 15:26:07 -06001227 help
1228 This is enabled by platforms which can support using the EM100.
1229
1230config EM100
1231 bool "Configure image for EM100 usage"
1232 depends on HAVE_EM100_SUPPORT
1233 help
1234 The Dediprog EM100 SPI emulator allows fast loading of new SPI images
1235 over USB. However it only supports a maximum SPI clock of 20MHz and
1236 single data output. Enable this option to use a 20MHz SPI clock and
1237 disable "Dual Output Fast Read" Support.
1238
1239 On AMD platforms this changes the SPI speed at run-time if the
1240 mainboard code supports this. On supported Intel platforms this works
1241 by changing the settings in the descriptor.bin file.
1242
Uwe Hermann168b11b2009-10-07 16:15:40 +00001243endmenu
1244
Martin Roth8e4aafb2016-12-15 15:25:15 -07001245###############################################################################
1246# Set variables with no prompt - these can be set anywhere, and putting at
1247# the end of this file gives the most flexibility.
Nico Huber3db76532017-05-18 18:07:34 +02001248
1249source "src/lib/Kconfig"
1250
Myles Watson2e672732009-11-12 16:38:03 +00001251config WARNINGS_ARE_ERRORS
1252 bool
Edward O'Callaghan63f6dc72014-11-18 03:17:54 +11001253 default y
Patrick Georgi436f99b2009-11-27 16:55:13 +00001254
Peter Stuge51eafde2010-10-13 06:23:02 +00001255# The four POWER_BUTTON_DEFAULT_ENABLE, POWER_BUTTON_DEFAULT_DISABLE,
1256# POWER_BUTTON_FORCE_ENABLE and POWER_BUTTON_FORCE_DISABLE options are
1257# mutually exclusive. One of these options must be selected in the
1258# mainboard Kconfig if the chipset supports enabling and disabling of
1259# the power button. Chipset code uses the ENABLE_POWER_BUTTON option set
1260# in mainboard/Kconfig to know if the button should be enabled or not.
1261
1262config POWER_BUTTON_DEFAULT_ENABLE
1263 def_bool n
1264 help
1265 Select when the board has a power button which can optionally be
1266 disabled by the user.
1267
1268config POWER_BUTTON_DEFAULT_DISABLE
1269 def_bool n
1270 help
1271 Select when the board has a power button which can optionally be
1272 enabled by the user, e.g. when the board ships with a jumper over
1273 the power switch contacts.
1274
1275config POWER_BUTTON_FORCE_ENABLE
1276 def_bool n
1277 help
1278 Select when the board requires that the power button is always
1279 enabled.
1280
1281config POWER_BUTTON_FORCE_DISABLE
1282 def_bool n
1283 help
1284 Select when the board requires that the power button is always
1285 disabled, e.g. when it has been hardwired to ground.
1286
1287config POWER_BUTTON_IS_OPTIONAL
1288 bool
1289 default y if POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE
1290 default n if !(POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE)
1291 help
1292 Internal option that controls ENABLE_POWER_BUTTON visibility.
Duncan Laurie72748002013-10-31 08:26:23 -07001293
1294config REG_SCRIPT
1295 bool
Duncan Laurie72748002013-10-31 08:26:23 -07001296 default n
1297 help
1298 Internal option that controls whether we compile in register scripts.
Furquan Shaikh99ac98f2014-04-23 10:18:48 -07001299
Furquan Shaikh99ac98f2014-04-23 10:18:48 -07001300config MAX_REBOOT_CNT
1301 int
1302 default 3
Timothy Pearson17ada2e2015-03-18 01:31:34 -05001303 help
1304 Internal option that sets the maximum number of bootblock executions allowed
1305 with the normal image enabled before assuming the normal image is defective
Vadim Bendebury9c9c3362014-07-23 09:40:02 -07001306 and switching to the fallback image.
Martin Roth59ff3402016-02-09 09:06:46 -07001307
Martin Roth8e4aafb2016-12-15 15:25:15 -07001308config UNCOMPRESSED_RAMSTAGE
1309 bool
1310
1311config NO_XIP_EARLY_STAGES
1312 bool
1313 default n if ARCH_X86
1314 default y
1315 help
1316 Identify if early stages are eXecute-In-Place(XIP).
1317
Martin Roth8e4aafb2016-12-15 15:25:15 -07001318config EARLY_CBMEM_LIST
1319 bool
1320 default n
1321 help
1322 Enable display of CBMEM during romstage and postcar.
1323
1324config RELOCATABLE_MODULES
1325 bool
1326 help
1327 If RELOCATABLE_MODULES is selected then support is enabled for
1328 building relocatable modules in the RAM stage. Those modules can be
1329 loaded anywhere and all the relocations are handled automatically.
1330
Martin Roth8e4aafb2016-12-15 15:25:15 -07001331config GENERIC_GPIO_LIB
1332 bool
1333 help
1334 If enabled, compile the generic GPIO library. A "generic" GPIO
1335 implies configurability usually found on SoCs, particularly the
1336 ability to control internal pull resistors.
1337
Martin Roth8e4aafb2016-12-15 15:25:15 -07001338config BOOTBLOCK_CUSTOM
1339 # To be selected by arch, SoC or mainboard if it does not want use the normal
1340 # src/lib/bootblock.c#main() C entry point.
1341 bool
1342
Arthur Heymanse8217b12022-04-05 20:42:07 +02001343config BOOTBLOCK_IN_CBFS
1344 bool
1345 default y if ARCH_X86
1346 help
1347 Select this on platforms that have a top aligned bootblock inside cbfs.
1348
Furquan Shaikh46514c22020-06-11 11:59:07 -07001349config MEMLAYOUT_LD_FILE
1350 string
Patrick Georgib8fba862020-06-17 21:06:53 +02001351 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/memlayout.ld"
Furquan Shaikh46514c22020-06-11 11:59:07 -07001352 help
1353 This variable allows SoC/mainboard to supply in a custom linker file
1354 if required. This determines the linker file used for all the stages
1355 (bootblock, romstage, verstage, ramstage, postcar) in
1356 src/arch/${ARCH}/Makefile.inc.
1357
Martin Roth75e5cb72016-12-15 15:05:37 -07001358###############################################################################
1359# Set default values for symbols created before mainboards. This allows the
1360# option to be displayed in the general menu, but the default to be loaded in
1361# the mainboard if desired.
1362config COMPRESS_RAMSTAGE
1363 default y if !UNCOMPRESSED_RAMSTAGE
1364
1365config COMPRESS_PRERAM_STAGES
1366 depends on !ARCH_X86
1367 default y
1368
1369config INCLUDE_CONFIG_FILE
1370 default y
1371
Martin Roth75e5cb72016-12-15 15:05:37 -07001372config BOOTSPLASH_FILE
1373 depends on BOOTSPLASH_IMAGE
1374 default "bootsplash.jpg"
1375
1376config CBFS_SIZE
1377 default ROM_SIZE
Subrata Banikb5962a92019-06-08 12:29:02 +05301378
1379config HAVE_BOOTBLOCK
1380 bool
1381 default y
1382
1383config HAVE_VERSTAGE
1384 bool
1385 depends on VBOOT_SEPARATE_VERSTAGE
1386 default y
1387
1388config HAVE_ROMSTAGE
1389 bool
1390 default y
1391
Subrata Banikb5962a92019-06-08 12:29:02 +05301392config HAVE_RAMSTAGE
1393 bool
1394 default n if RAMPAYLOAD
1395 default y