1 ## SPDX-License-Identifier: GPL-2.0-only
3 mainmenu "coreboot configuration"
8 string "Local version string"
10 Append an extra string to the end of the coreboot version.
12 This can be useful if, for instance, you want to append the
13 respective board's hostname or some other identifying string to
14 the coreboot version number, so that you can easily distinguish
15 boot logs of different boards from each other.
17 config CONFIGURABLE_CBFS_PREFIX
20 Select this to prompt to use to configure the prefix for cbfs files.
23 prompt "CBFS prefix to use"
24 depends on CONFIGURABLE_CBFS_PREFIX
25 default CBFS_PREFIX_FALLBACK
27 config CBFS_PREFIX_FALLBACK
30 config CBFS_PREFIX_NORMAL
33 config CBFS_PREFIX_DIY
34 bool "Define your own cbfs prefix"
39 string "CBFS prefix to use" if CBFS_PREFIX_DIY
40 default "fallback" if !CONFIGURABLE_CBFS_PREFIX || CBFS_PREFIX_FALLBACK
41 default "normal" if CBFS_PREFIX_NORMAL
43 Select the prefix to all files put into the image. It's "fallback"
44 by default, "normal" is a common alternative.
46 config DEFAULT_COMPILER_LLVM_CLANG
49 Allows to override the default compiler. This can for instance be
50 set in site-local/Kconfig.
53 prompt "Compiler to use"
54 default COMPILER_LLVM_CLANG if DEFAULT_COMPILER_LLVM_CLANG
57 This option allows you to select the compiler used for building
59 You must build the coreboot crosscompiler for the board that you
62 To build all the GCC crosscompilers (takes a LONG time), run:
65 For help on individual architectures, run the command:
71 Use the GNU Compiler Collection (GCC) to build coreboot.
73 For details see http://gcc.gnu.org.
75 config COMPILER_LLVM_CLANG
77 depends on ALLOW_EXPERIMENTAL_CLANG || ARCH_SUPPORTS_CLANG
79 Use LLVM/clang to build coreboot. To use this, you must build the
80 coreboot version of the clang compiler. Run the command
82 Note that Clang is not currently working on all architectures.
84 For details see http://clang.llvm.org.
88 config ARCH_SUPPORTS_CLANG
91 Opt-in flag for architectures that generally work well with CLANG.
92 By default the option would be hidden.
94 config ALLOW_EXPERIMENTAL_CLANG
95 bool "Allow experimental LLVM/Clang"
96 depends on !ARCH_SUPPORTS_CLANG
98 On some architectures CLANG does not work that well.
99 Use this only to try to get CLANG working.
102 bool "Allow building with any toolchain"
105 Many toolchains break when building coreboot since it uses quite
106 unusual linker features. Unless developers explicitly request it,
107 we'll have to assume that they use their distro compiler by mistake.
108 Make sure that using patched compilers is a conscious decision.
111 bool "Use ccache to speed up (re)compilation"
113 Enables the use of ccache for faster builds.
115 Requires the ccache utility in your system $PATH.
117 For details see https://ccache.samba.org.
120 bool "Test platform with include-what-you-use"
122 This runs each source file through the include-what-you-use tool
123 to check the header includes.
126 bool "Generate flashmap descriptor parser using flex and bison"
129 Enable this option if you are working on the flashmap descriptor
130 parser and made changes to fmd_scanner.l or fmd_parser.y.
132 Otherwise, say N to use the provided pregenerated scanner/parser.
134 config UTIL_GENPARSER
135 bool "Generate parsers for bincfg, sconfig and kconfig locally"
138 Enable this option if you are working on the sconfig device tree
139 parser or bincfg and made changes to the .l or .y files.
141 Otherwise, say N to use the provided pregenerated scanner/parser.
144 prompt "Option backend to use"
145 default USE_MAINBOARD_SPECIFIC_OPTION_BACKEND if HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
146 default USE_OPTION_TABLE if NVRAMCUI_SECONDARY_PAYLOAD
147 default USE_UEFI_VARIABLE_STORE if DRIVERS_EFI_VARIABLE_STORE && \
148 PAYLOAD_EDK2 && SMMSTORE_V2
150 config OPTION_BACKEND_NONE
153 config USE_OPTION_TABLE
154 bool "Use CMOS for configuration values"
155 depends on HAVE_OPTION_TABLE
157 Enable this option if coreboot shall read options from the "CMOS"
158 NVRAM instead of using hard-coded values.
160 config USE_UEFI_VARIABLE_STORE
161 bool "Use UEFI variable-store in SPI flash as option backend"
162 depends on DRIVERS_EFI_VARIABLE_STORE
163 depends on SMMSTORE_V2
165 Enable this option if coreboot shall read/write options from the
166 SMMSTORE region within the SPI flash. The region must be formatted
167 by the payload first before it can be used.
169 config USE_MAINBOARD_SPECIFIC_OPTION_BACKEND
170 bool "Use mainboard-specific option backend"
171 depends on HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
173 Use a mainboard-specific mechanism to access runtime-configurable
178 config STATIC_OPTION_TABLE
179 bool "Load default configuration values into CMOS on each boot"
180 depends on USE_OPTION_TABLE
182 Enable this option to reset "CMOS" NVRAM values to default on
183 every boot. Use this if you want the NVRAM configuration to
184 never be modified from its default values.
186 config MB_COMPRESS_RAMSTAGE_LZ4
189 Select this in a mainboard to use LZ4 compression by default
192 prompt "Ramstage compression"
193 depends on HAVE_RAMSTAGE && !UNCOMPRESSED_RAMSTAGE
194 default COMPRESS_RAMSTAGE_LZ4 if MB_COMPRESS_RAMSTAGE_LZ4
195 default COMPRESS_RAMSTAGE_LZMA
197 config COMPRESS_RAMSTAGE_LZMA
198 bool "Compress ramstage with LZMA"
200 Compress ramstage with LZMA to save memory in the flash image.
202 config COMPRESS_RAMSTAGE_LZ4
203 bool "Compress ramstage with LZ4"
205 LZ4 doesn't give as good compression as LZMA, but decompresses much
206 faster. For large binaries such as ramstage, it's typically best to
207 use LZMA, but there can be cases where the faster decompression of
208 LZ4 can lead to a faster boot time. Testing on each individual board
209 is typically going to be needed due to the large number of factors
210 that can influence the decision. Binary size, CPU speed, ROM read
211 speed, cache, and other factors all play a part.
213 If you're not sure, stick with LZMA.
217 config COMPRESS_PRERAM_STAGES
218 bool "Compress romstage and verstage with LZ4"
219 depends on (HAVE_ROMSTAGE || HAVE_VERSTAGE) && NO_XIP_EARLY_STAGES
220 # Default value set at the end of the file
222 Compress romstage and (if it exists) verstage with LZ4 to save flash
223 space and speed up boot, since the time for reading the image from SPI
224 (and in the vboot case verifying it) is usually much greater than the
225 time spent decompressing. Doesn't work for XIP stages for obvious
228 config COMPRESS_BOOTBLOCK
230 depends on HAVE_BOOTBLOCK
232 This option can be used to compress the bootblock with LZ4 and attach
233 a small self-decompression stub to its front. This can drastically
234 reduce boot time on platforms where the bootblock is loaded over a
235 very slow connection and bootblock size trumps all other factors for
236 speed. Since using this option usually requires changes to the
237 SoC memlayout and possibly extra support code, it should not be
238 user-selectable. (There's no real point in offering this to the user
239 anyway... if it works and saves boot time, you would always want it.)
241 config SEPARATE_ROMSTAGE
242 bool "Build a separate romstage"
244 Build a separate romstage that is loaded by bootblock. With this
245 option disabled the romstage sources are linked inside the bootblock
248 config INCLUDE_CONFIG_FILE
249 bool "Include the coreboot .config file into the ROM image"
250 # Default value set at the end of the file
252 Include the .config file that was used to compile coreboot
253 in the (CBFS) ROM image. This is useful if you want to know which
254 options were used to build a specific coreboot.rom image.
256 Saying Y here will increase the image size by 2-3KB.
258 You can then use cbfstool to extract the config from a final image:
260 cbfstool coreboot.rom extract -n config -f <output file path>
262 Alternatively, you can also use cbfstool to print the image
263 contents (including the raw 'config' item we're looking for).
267 $ cbfstool coreboot.rom print
268 coreboot.rom: 4096 kB, bootblocksize 1008, romsize 4194304,
272 Name Offset Type Size
273 cmos_layout.bin 0x0 CMOS layout 1159
274 fallback/romstage 0x4c0 stage 339756
275 fallback/ramstage 0x53440 stage 186664
276 fallback/payload 0x80dc0 payload 51526
277 config 0x8d740 raw 3324
278 (empty) 0x8e480 null 3610440
280 config COLLECT_TIMESTAMPS
281 bool "Create a table of timestamps collected during boot"
282 default y if ARCH_X86
284 Make coreboot create a table of timer-ID/timer-value pairs to
285 allow measuring time spent at different phases of the boot process.
287 config TIMESTAMPS_ON_CONSOLE
288 bool "Print the timestamp values on the console"
290 depends on COLLECT_TIMESTAMPS
292 Print the timestamps to the debug console if enabled at level info.
295 bool "Allow use of binary-only repository"
298 This draws in the blobs repository, which contains binary files that
299 might be required for some chipsets or boards.
300 This flag ensures that a "Free" option remains available for users.
303 bool "Allow AMD blobs repository (with license agreement)"
306 This draws in the amd_blobs repository, which contains binary files
307 distributed by AMD, including VBIOS, PSP bootloaders, SMU firmwares,
308 etc. Selecting this item to download or clone the repo implies your
309 agreement to the AMD license agreement. A copy of the license text
310 may be reviewed by reading Documentation/soc/amd/amdblobs_license.md,
311 and your copy of the license is present in the repo once downloaded.
313 Note that for some products, omitting PSP, SMU images, or other items
314 may result in a nonbooting coreboot.rom.
317 bool "Allow QC blobs repository (selecting this agrees to the license!)"
320 This draws in the qc_blobs repository, which contains binary files
321 distributed by Qualcomm that are required to build firmware for
322 certain Qualcomm SoCs (including QcLib, QC-SEC, qtiseclib and QUP
323 firmware). If you say Y here you are implicitly agreeing to the
324 Qualcomm license agreement which can be found at:
325 https://review.coreboot.org/cgit/qc_blobs.git/tree/LICENSE
327 *****************************************************
328 PLEASE MAKE SURE YOU READ AND AGREE TO ALL TERMS IN
329 ABOVE LICENSE AGREEMENT BEFORE SELECTING THIS OPTION!
330 *****************************************************
332 Not selecting this option means certain Qualcomm SoCs and related
333 mainboards cannot be built and will be hidden from the "Mainboards"
337 bool "Code coverage support"
338 depends on COMPILER_GCC
340 Add code coverage support for coreboot. This will store code
341 coverage information in CBMEM for extraction from user space.
345 bool "Undefined behavior sanitizer support"
348 Instrument the code with checks for undefined behavior. If unsure,
349 say N because it adds a small performance penalty and may abort
350 on code that happens to work in spite of the UB.
352 config HAVE_ASAN_IN_ROMSTAGE
356 config ASAN_IN_ROMSTAGE
360 Enable address sanitizer in romstage for platform.
362 config HAVE_ASAN_IN_RAMSTAGE
366 config ASAN_IN_RAMSTAGE
370 Enable address sanitizer in ramstage for platform.
373 bool "Address sanitizer support"
375 select ASAN_IN_ROMSTAGE if HAVE_ASAN_IN_ROMSTAGE
376 select ASAN_IN_RAMSTAGE if HAVE_ASAN_IN_RAMSTAGE
377 depends on COMPILER_GCC
379 Enable address sanitizer - runtime memory debugger,
380 designed to find out-of-bounds accesses and use-after-scope bugs.
382 This feature consumes up to 1/8 of available memory and brings about
383 ~1.5x performance slowdown.
388 comment "Before using this feature, make sure that "
389 comment "asan_shadow_offset_callback patch is applied to GCC."
393 prompt "Stage Cache for ACPI S3 resume"
394 default NO_STAGE_CACHE if !HAVE_ACPI_RESUME || MAINBOARD_DISABLE_STAGE_CACHE
395 default TSEG_STAGE_CACHE if SMM_TSEG
397 config NO_STAGE_CACHE
400 Do not save any component in stage cache for resume path. On resume,
401 all components would be read back from CBFS again.
403 config TSEG_STAGE_CACHE
407 The option enables stage cache support for platform. Platform
408 can stash copies of postcar, ramstage and raw runtime data
409 inside SMM TSEG, to be restored on S3 resume path.
411 config CBMEM_STAGE_CACHE
415 The option enables stage cache support for platform. Platform
416 can stash copies of postcar, ramstage and raw runtime data
419 While the approach is faster than reloading stages from boot media
420 it is also a possible attack scenario via which OS can possibly
421 circumvent SMM locks and SPI write protections.
423 If unsure, select 'N'
427 config MAINBOARD_DISABLE_STAGE_CACHE
430 Selected by mainboards which wish to disable the stage cache.
431 E.g. mainboards which don't use S3 resume in the field may wish to
432 disable it to save boot time at the cost of increasing S3 resume time.
435 bool "Update existing coreboot.rom image"
437 If this option is enabled, no new coreboot.rom file
438 is created. Instead it is expected that there already
439 is a suitable file for further processing.
440 The bootblock will not be modified.
442 If unsure, select 'N'
444 config BOOTSPLASH_IMAGE
445 bool "Add a bootsplash image"
447 Select this option if you have a bootsplash image that you would
448 like to add to your ROM.
450 This will only add the image to the ROM. To actually run it check
451 options under 'Display' section.
453 config BOOTSPLASH_FILE
454 string "Bootsplash path and filename"
455 depends on BOOTSPLASH_IMAGE
456 # Default value set at the end of the file
458 The path and filename of the file to use as graphical bootsplash
459 screen. The file format has to be JPEG with YCC 4:2:0 color sampling
460 unless converted with "Pre-process bootsplash file with ImageMagick".
462 The image can only be displayed by coreboot if it's smaller or has
463 the same size as the framebuffer resolution. Width and height have
464 to be a multiple of 16 pixels.
466 Setting these constraints allows a leaner implementation in coreboot.
467 The minimum necessary ImageMagick command line seems to be:
468 $ convert input.img -colorspace YCC -sampling-factor 4:2:0 bootsplash.jpg
470 config BOOTSPLASH_CONVERT
471 bool "Pre-process bootsplash file with ImageMagick"
472 depends on BOOTSPLASH_IMAGE
474 Use ImageMagick (`convert` program) to convert a bootsplash image
475 to the supported JPEG format.
477 config BOOTSPLASH_CONVERT_QUALITY
478 int "Bootsplash JPEG target quality (%)"
479 depends on BOOTSPLASH_CONVERT
481 # Default value set at the end of the file
483 config BOOTSPLASH_CONVERT_RESIZE
484 bool "Resize bootsplash image"
485 depends on BOOTSPLASH_CONVERT
487 Resize the image to the given resolution. Aspect ratio will be kept,
488 adding black bars as necessary.
490 config BOOTSPLASH_CONVERT_RESOLUTION
491 string "Bootsplash image target size"
492 depends on BOOTSPLASH_CONVERT_RESIZE
493 # Default value set at the end of the file
495 Target image resolution given as <width>x<height>, e.g. 1024x768.
496 Values not divisible by 16 will be rounded down.
498 When using coreboot to display the bootsplash image (CONFIG_BOOTSPLASH),
499 set this lower or equal to the minimum resolution you expect.
501 config BOOTSPLASH_CONVERT_COLORSWAP
502 bool "Swap red and blue color channels"
503 depends on BOOTSPLASH_CONVERT
505 The JPEG decoder currently ignores the framebuffer color order.
506 If your colors seem all wrong, try this option.
511 Enable support for probing devices with fw_config. This is a simple
512 bitmask broken into fields and options for probing.
513 Select this option in the Mainboard Kconfig.
515 config FW_CONFIG_SOURCE_CHROMEEC_CBI
517 depends on FW_CONFIG && EC_GOOGLE_CHROMEEC
519 This option tells coreboot to read the firmware configuration value
520 from the Google Chrome Embedded Controller CBI interface. This source
521 is not tried if FW_CONFIG_SOURCE_CBFS is enabled and the value was
523 Select this option in the Mainboard Kconfig.
525 config FW_CONFIG_SOURCE_CBFS
526 bool "Obtain Firmware Configuration value from CBFS"
529 With this option enabled coreboot will look for the 32bit firmware
530 configuration value in CBFS at the selected prefix with the file name
531 "fw_config". This option gets run if no value is found with CBI, so acts
532 as a FW_CONFIG_SOURCE_CHROMEEC_CBI fallback option.
534 config FW_CONFIG_SOURCE_VPD
535 bool "Obtain Firmware Configuration value from VPD"
536 depends on FW_CONFIG && VPD
538 With this option enabled coreboot will look for the 32bit firmware
539 configuration value in VPD key name "fw_config". This option runs if no
540 FW_CONFIG value is set by either CBI or CBFS.
542 config HAVE_RAMPAYLOAD
546 bool "Enable coreboot flow without executing ramstage"
547 default y if ARCH_X86
548 depends on HAVE_RAMPAYLOAD
550 If this option is enabled, coreboot flow will skip ramstage
551 loading and execution of ramstage to load payload.
553 Instead it is expected to load payload from postcar stage itself.
555 In this flow coreboot will perform basic x86 initialization
556 (DRAM resource allocation), MTRR programming,
557 Skip PCI enumeration logic and only allocate BAR for fixed devices
558 (bootable devices, TPM over GSPI).
560 config HAVE_CONFIGURABLE_RAMSTAGE
563 config CONFIGURABLE_RAMSTAGE
564 bool "Enable a configurable ramstage."
565 default y if ARCH_X86
566 depends on HAVE_CONFIGURABLE_RAMSTAGE
568 A configurable ramstage allows you to select which parts of the ramstage
569 to run. Currently, we can only select a minimal PCI scanning step.
570 The minimal PCI scanning will only check those parts that are enabled
571 in the devicetree.cb. By convention none of those devices should be bridges.
573 config MINIMAL_PCI_SCANNING
574 bool "Enable minimal PCI scanning"
575 depends on CONFIGURABLE_RAMSTAGE && PCI
577 If this option is enabled, coreboot will scan only PCI devices
578 marked as mandatory in devicetree.cb
580 menu "Software Bill Of Materials (SBOM)"
582 source "src/sbom/Kconfig"
589 source "src/mainboard/Kconfig"
593 default "devicetree.cb"
595 This symbol allows mainboards to select a different file under their
596 mainboard directory for the devicetree.cb file. This allows the board
597 variants that need different devicetrees to be in the same directory.
599 Examples: "devicetree.variant.cb"
600 "variant/devicetree.cb"
602 config OVERRIDE_DEVICETREE
606 This symbol allows variants to provide an override devicetree file to
607 override the registers and/or add new devices on top of the ones
608 provided by baseboard devicetree using CONFIG_DEVICETREE.
610 Examples: "devicetree.variant-override.cb"
611 "variant/devicetree-override.cb"
614 string "fmap description file in fmd format"
615 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/chromeos.fmd" if CHROMEOS
618 The build system creates a default FMAP from ROM_SIZE and CBFS_SIZE,
619 but in some cases more complex setups are required.
620 When an fmd is specified, it overrides the default format.
623 hex "Size of CBFS filesystem in ROM"
624 depends on FMDFILE = ""
625 # Default value set at the end of the file
627 This is the part of the ROM actually managed by CBFS, located at the
628 end of the ROM (passed through cbfstool -o) on x86 and at the start
629 of the ROM (passed through cbfstool -s) everywhere else. It defaults
630 to span the whole ROM on all but Intel systems that use an Intel Firmware
631 Descriptor. It can be overridden to make coreboot live alongside other
632 components like ChromeOS's vboot/FMAP or Intel's IFD / ME / TXE
633 binaries. This symbol should only be used to generate a default FMAP and
634 is unused when a non-default fmd file is provided via CONFIG_FMDFILE.
638 # load site-local kconfig to allow user specific defaults and overrides
639 source "site-local/Kconfig"
641 config SYSTEM_TYPE_LAPTOP
645 config SYSTEM_TYPE_TABLET
649 config SYSTEM_TYPE_DETACHABLE
653 config SYSTEM_TYPE_CONVERTIBLE
657 config CBFS_AUTOGEN_ATTRIBUTES
661 If this option is selected, every file in cbfs which has a constraint
662 regarding position or alignment will get an additional file attribute
663 which describes this constraint.
668 source "src/soc/*/*/Kconfig"
669 source "src/soc/*/*/Kconfig.common"
671 source "src/cpu/Kconfig"
672 comment "Northbridge"
673 source "src/northbridge/*/*/Kconfig"
674 source "src/northbridge/*/*/Kconfig.common"
675 comment "Southbridge"
676 source "src/southbridge/*/*/Kconfig"
677 source "src/southbridge/*/*/Kconfig.common"
679 source "src/superio/*/*/Kconfig"
680 comment "Embedded Controllers"
681 source "src/ec/acpi/Kconfig"
682 source "src/ec/*/*/Kconfig"
684 source "src/southbridge/intel/common/firmware/Kconfig"
685 source "src/vendorcode/*/Kconfig"
687 source "src/arch/*/Kconfig"
689 config CHIPSET_DEVICETREE
693 This symbol allows a chipset to provide a set of default settings in
694 a devicetree which are common to all mainboards. This may include
695 devices (including alias names), chip drivers, register settings,
696 and others. This path is relative to the src/ directory.
698 Example: "chipset.cb"
702 source "src/device/Kconfig"
704 menu "Generic Drivers"
705 source "src/drivers/*/Kconfig"
706 source "src/drivers/*/*/Kconfig"
707 source "src/drivers/*/*/*/Kconfig"
708 source "src/commonlib/storage/Kconfig"
713 source "src/security/Kconfig"
714 source "src/vendorcode/eltan/security/Kconfig"
718 source "src/acpi/Kconfig"
720 # This option is for the current boards/chipsets where SPI flash
721 # is not the boot device. Currently nearly all boards/chipsets assume
722 # SPI flash is the boot device.
723 config BOOT_DEVICE_NOT_SPI_FLASH
727 config BOOT_DEVICE_SPI_FLASH
729 default y if !BOOT_DEVICE_NOT_SPI_FLASH
732 config BOOT_DEVICE_MEMORY_MAPPED
734 default y if ARCH_X86 && BOOT_DEVICE_SPI_FLASH
737 Inform system if SPI is memory-mapped or not.
739 config BOOT_DEVICE_SUPPORTS_WRITES
743 Indicate that the platform has writable boot device
756 default 0x2000 if ARCH_X86
763 source "src/console/Kconfig"
765 config ACPI_S1_NOT_SUPPORTED
769 Set this to 'y' on platforms that do not support ACPI S1 state.
771 config HAVE_ACPI_RESUME
775 config DISABLE_ACPI_HIBERNATE
779 Removes S4 from the available sleepstates
781 config RESUME_PATH_SAME_AS_BOOT
783 default y if ARCH_X86
784 depends on HAVE_ACPI_RESUME
786 This option indicates that when a system resumes it takes the
787 same path as a regular boot. e.g. an x86 system runs from the
788 reset vector at 0xfffffff0 on both resume and warm/cold boot.
790 config NO_MONOTONIC_TIMER
793 config HAVE_MONOTONIC_TIMER
795 depends on !NO_MONOTONIC_TIMER
798 The board/chipset provides a monotonic timer.
800 config GENERIC_UDELAY
802 depends on HAVE_MONOTONIC_TIMER
803 default y if !ARCH_X86
805 The board/chipset uses a generic udelay function utilizing the
810 depends on HAVE_MONOTONIC_TIMER
812 Provide a timer queue for performing time-based callbacks.
814 config COOP_MULTITASKING
819 Cooperative multitasking allows callbacks to be multiplexed on the
820 main thread. With this enabled it allows for multiple execution paths
821 to take place when they have udelay() calls within their code.
826 depends on COOP_MULTITASKING
828 How many execution threads to cooperatively multitask with.
830 config HAVE_MAINBOARD_SPECIFIC_OPTION_BACKEND
833 Selected by mainboards which implement a mainboard-specific mechanism
834 to access the values for runtime-configurable options. For example, a
835 custom BMC interface or an EEPROM with an externally-imposed layout.
837 config HAVE_OPTION_TABLE
841 This variable specifies whether a given board has a cmos.layout
842 file containing NVRAM/CMOS bit definitions.
843 It defaults to 'n' but can be selected in mainboard/*/Kconfig.
845 config CMOS_LAYOUT_FILE
847 default "src/mainboard/\$(MAINBOARDDIR)/cmos.layout"
848 depends on HAVE_OPTION_TABLE
850 config PCI_IO_CFG_EXT
859 config USE_WATCHDOG_ON_BOOT
867 Enable Unified Memory Architecture for graphics.
872 This variable specifies whether a given board has MP table support.
873 It is usually set in mainboard/*/Kconfig.
874 Whether or not the MP table is actually generated by coreboot
875 is configurable by the user via GENERATE_MP_TABLE.
877 config HAVE_PIRQ_TABLE
880 This variable specifies whether a given board has PIRQ table support.
881 It is usually set in mainboard/*/Kconfig.
882 Whether or not the PIRQ table is actually generated by coreboot
883 is configurable by the user via GENERATE_PIRQ_TABLE.
889 Build support for NHLT (non HD Audio) ACPI table generation.
891 #These Options are here to avoid "undefined" warnings.
892 #The actual selection and help texts are in the following menu.
896 config GENERATE_MP_TABLE
897 prompt "Generate an MP table" if HAVE_MP_TABLE
899 depends on !ECAM_MMCONF_SUPPORT || ECAM_MMCONF_BUS_NUMBER <= 256
900 default HAVE_MP_TABLE
902 Generate an MP table (conforming to the Intel MultiProcessor
903 specification 1.4) for this board.
907 config GENERATE_PIRQ_TABLE
908 prompt "Generate a PIRQ table" if HAVE_PIRQ_TABLE
910 default HAVE_PIRQ_TABLE
912 Generate a PIRQ table for this board.
916 config GENERATE_SMBIOS_TABLES
917 depends on ARCH_X86 || ARCH_ARM64
918 bool "Generate SMBIOS tables"
919 default n if ARCH_ARM64
922 Generate SMBIOS tables for this board.
926 config SMBIOS_TYPE41_PROVIDED_BY_DEVTREE
930 If enabled, only generate SMBIOS Type 41 entries for PCI devices in
931 the devicetree for which Type 41 information is provided, e.g. with
932 the `smbios_dev_info` devicetree syntax. This is useful to manually
933 assign specific instance IDs to onboard devices irrespective of the
934 device traversal order. It is assumed that instance IDs for devices
935 of the same class are unique.
936 When disabled, coreboot autogenerates SMBIOS Type 41 entries for all
937 appropriate PCI devices in the devicetree. Instance IDs are assigned
938 successive numbers from a monotonically increasing counter, with one
939 counter for each device class.
941 config SMBIOS_PROVIDED_BY_MOBO
945 if GENERATE_SMBIOS_TABLES
948 prompt "SMBIOS BIOS Vendor name"
952 The BIOS Vendor name to store in the SMBIOS Type0 table.
954 config MAINBOARD_SERIAL_NUMBER
955 prompt "SMBIOS Serial Number" if !SMBIOS_PROVIDED_BY_MOBO
959 The Serial Number to store in SMBIOS structures.
961 config MAINBOARD_VERSION
962 prompt "SMBIOS Version Number" if !SMBIOS_PROVIDED_BY_MOBO
966 The Version Number to store in SMBIOS structures.
968 config MAINBOARD_SMBIOS_MANUFACTURER
969 prompt "SMBIOS Manufacturer" if !SMBIOS_PROVIDED_BY_MOBO
971 default MAINBOARD_VENDOR
973 Override the default Manufacturer stored in SMBIOS structures.
975 config MAINBOARD_SMBIOS_PRODUCT_NAME
976 prompt "SMBIOS Product name" if !SMBIOS_PROVIDED_BY_MOBO
978 default MAINBOARD_PART_NUMBER
980 Override the default Product name stored in SMBIOS structures.
982 config VPD_SMBIOS_VERSION
983 bool "Populates SMBIOS type 0 version from the VPD_RO variable 'firmware_version'"
987 Selecting this option will read firmware_version from
988 VPD_RO and override SMBIOS type 0 version. One special
989 scenario of using this feature is to assign a BIOS version
990 to a coreboot image without the need to rebuild from source.
996 source "payloads/Kconfig"
1000 comment "CPU Debug Settings"
1001 source "src/cpu/*/Kconfig.debug_cpu"
1003 comment "Vendorcode Debug Settings"
1004 source "src/vendorcode/*/*/Kconfig.debug"
1006 comment "BLOB Debug Settings"
1007 source "src/drivers/intel/fsp*/Kconfig.debug_blob"
1009 comment "General Debug Settings"
1011 # TODO: Better help text and detailed instructions.
1013 bool "GDB debugging support"
1015 # FIXME Not implemented in long mode
1016 depends on DRIVERS_UART && !USE_X86_64_SUPPORT
1018 If enabled, you will be able to set breakpoints for gdb debugging.
1019 See src/arch/x86/c_start.S for details.
1022 bool "Wait for a GDB connection in the ramstage"
1026 If enabled, coreboot will wait for a GDB connection in the ramstage.
1029 config FATAL_ASSERTS
1030 bool "Halt when hitting a BUG() or assertion error"
1033 If enabled, coreboot will call hlt() on a BUG() or failed ASSERT().
1035 config HAVE_DEBUG_GPIO
1039 bool "Output verbose GPIO debug messages"
1040 depends on HAVE_DEBUG_GPIO
1043 bool "Output verbose CBFS debug messages"
1046 This option enables additional CBFS related debug messages.
1048 config HAVE_DEBUG_RAM_SETUP
1051 config DEBUG_RAM_SETUP
1052 bool "Output verbose RAM init debug messages"
1054 depends on HAVE_DEBUG_RAM_SETUP
1056 This option enables additional RAM init related debug messages.
1057 It is recommended to enable this when debugging issues on your
1058 board which might be RAM init related.
1060 Note: This option will increase the size of the coreboot image.
1065 bool "Check PIRQ table consistency"
1067 depends on GENERATE_PIRQ_TABLE
1071 config HAVE_DEBUG_SMBUS
1075 bool "Output verbose SMBus debug messages"
1077 depends on HAVE_DEBUG_SMBUS
1079 This option enables additional SMBus (and SPD) debug messages.
1081 Note: This option will increase the size of the coreboot image.
1086 bool "Output verbose SMI debug messages"
1088 depends on HAVE_SMI_HANDLER
1089 select SPI_FLASH_SMM if EM100PRO_SPI_CONSOLE || CONSOLE_SPI_FLASH
1091 This option enables additional SMI related debug messages.
1093 Note: This option will increase the size of the coreboot image.
1097 config DEBUG_PERIODIC_SMI
1098 bool "Trigger SMI periodically"
1099 depends on DEBUG_SMI
1101 # Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
1102 # printk(BIOS_DEBUG, ...) calls.
1104 prompt "Output verbose malloc debug messages" if DEFAULT_CONSOLE_LOGLEVEL_7 || DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
1108 This option enables additional malloc related debug messages.
1110 Note: This option will increase the size of the coreboot image.
1114 # Only visible if DEBUG_SPEW (8) is set.
1115 config DEBUG_RESOURCES
1116 bool "Output verbose PCI MEM and IO resource debug messages" if DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
1119 This option enables additional PCI memory and IO debug messages.
1120 Note: This option will increase the size of the coreboot image.
1123 config DEBUG_CONSOLE_INIT
1124 bool "Debug console initialisation code"
1127 With this option printk()'s are attempted before console hardware
1128 initialisation has been completed. Your mileage may vary.
1130 Typically you will need to modify source in console_hw_init() such
1131 that a working console appears before the one you want to debug.
1135 # Only visible if debug level is DEBUG (7) or SPEW (8) as it does additional
1136 # printk(BIOS_DEBUG, ...) calls.
1137 config REALMODE_DEBUG
1138 prompt "Enable debug messages for option ROM execution" if DEFAULT_CONSOLE_LOGLEVEL_7 || DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
1141 depends on PCI_OPTION_ROM_RUN_REALMODE
1143 This option enables additional x86emu related debug messages.
1145 Note: This option will increase the time to emulate a ROM.
1150 bool "Output verbose x86emu debug messages"
1152 depends on PCI_OPTION_ROM_RUN_YABEL
1154 This option enables additional x86emu related debug messages.
1156 Note: This option will increase the size of the coreboot image.
1162 config X86EMU_DEBUG_JMP
1163 bool "Trace JMP/RETF"
1166 Print information about JMP and RETF opcodes from x86emu.
1168 Note: This option will increase the size of the coreboot image.
1172 config X86EMU_DEBUG_TRACE
1173 bool "Trace all opcodes"
1176 Print _all_ opcodes that are executed by x86emu.
1178 WARNING: This will produce a LOT of output and take a long time.
1180 Note: This option will increase the size of the coreboot image.
1184 config X86EMU_DEBUG_PNP
1185 bool "Log Plug&Play accesses"
1188 Print Plug And Play accesses made by option ROMs.
1190 Note: This option will increase the size of the coreboot image.
1194 config X86EMU_DEBUG_DISK
1198 Print Disk I/O related messages.
1200 Note: This option will increase the size of the coreboot image.
1204 config X86EMU_DEBUG_PMM
1208 Print messages related to POST Memory Manager (PMM).
1210 Note: This option will increase the size of the coreboot image.
1215 config X86EMU_DEBUG_VBE
1216 bool "Debug VESA BIOS Extensions"
1219 Print messages related to VESA BIOS Extension (VBE) functions.
1221 Note: This option will increase the size of the coreboot image.
1225 config X86EMU_DEBUG_INT10
1226 bool "Redirect INT10 output to console"
1229 Let INT10 (i.e. character output) calls print messages to debug output.
1231 Note: This option will increase the size of the coreboot image.
1235 config X86EMU_DEBUG_INTERRUPTS
1236 bool "Log intXX calls"
1239 Print messages related to interrupt handling.
1241 Note: This option will increase the size of the coreboot image.
1245 config X86EMU_DEBUG_CHECK_VMEM_ACCESS
1246 bool "Log special memory accesses"
1249 Print messages related to accesses to certain areas of the virtual
1250 memory (e.g. BDA (BIOS Data Area) or interrupt vectors)
1252 Note: This option will increase the size of the coreboot image.
1256 config X86EMU_DEBUG_MEM
1257 bool "Log all memory accesses"
1260 Print memory accesses made by option ROM.
1261 Note: This also includes accesses to fetch instructions.
1263 Note: This option will increase the size of the coreboot image.
1267 config X86EMU_DEBUG_IO
1268 bool "Log IO accesses"
1271 Print I/O accesses made by option ROM.
1273 Note: This option will increase the size of the coreboot image.
1277 config X86EMU_DEBUG_TIMINGS
1278 bool "Output timing information"
1280 depends on HAVE_MONOTONIC_TIMER
1282 Print timing information needed by i915tool.
1288 config DEBUG_SPI_FLASH
1289 bool "Output verbose SPI flash debug messages"
1291 depends on SPI_FLASH
1293 This option enables additional SPI flash related debug messages.
1296 bool "Output verbose IPMI debug messages"
1300 This option enables additional IPMI related debug messages.
1302 if SOUTHBRIDGE_INTEL_BD82X6X && DEFAULT_CONSOLE_LOGLEVEL_8
1303 # Only visible with the right southbridge and loglevel.
1304 config DEBUG_INTEL_ME
1305 bool "Verbose logging for Intel Management Engine"
1308 Enable verbose logging for Intel Management Engine driver that
1309 is present on Intel 6-series chipsets.
1313 bool "Enable function entry and exit reporting macros" if DEFAULT_CONSOLE_LOGLEVEL_8 || CONSOLE_OVERRIDE_LOGLEVEL
1316 This option enables additional function entry and exit debug messages
1317 for select functions.
1318 Note: This option will increase the size of the coreboot image.
1321 config DEBUG_COVERAGE
1322 bool "Debug code coverage"
1326 If enabled, the code coverage hooks in coreboot will output some
1327 information about the coverage data that is dumped.
1329 config DEBUG_BOOT_STATE
1330 bool "Debug boot state machine"
1333 Control debugging of the boot state machine. When selected displays
1334 the state boundaries in ramstage.
1336 config DEBUG_ADA_CODE
1337 bool "Compile debug code in Ada sources"
1340 Add the compiler switch `-gnata` to compile code guarded by
1343 config HAVE_EM100_SUPPORT
1346 This is enabled by platforms which can support using the EM100.
1349 bool "Configure image for EM100 usage"
1350 depends on HAVE_EM100_SUPPORT
1352 The Dediprog EM100 SPI emulator allows fast loading of new SPI images
1353 over USB. However it only supports a maximum SPI clock of 20MHz and
1354 single data output. Enable this option to use a 20MHz SPI clock and
1355 disable "Dual Output Fast Read" Support.
1357 On AMD platforms this changes the SPI speed at run-time if the
1358 mainboard code supports this. On supported Intel platforms this works
1359 by changing the settings in the descriptor.bin file.
1361 config DEBUG_ACPICA_COMPATIBLE
1362 bool "Print out ACPI tables in ACPICA compatible format"
1363 depends on HAVE_ACPI_TABLES
1365 Select this to print out ACPI tables in an ACPICA compatible
1366 format. Set the console loglevel to verbosity 'SPEW'.
1367 To analyze ACPI tables capture the coreboot log between
1368 "Printing ACPI in ACPICA compatible table" and "Done printing
1369 ACPI in ACPICA compatible table".
1370 Remove the prefix "[SPEW ] " and then issue 'acpixtract -a dump'
1371 to extract all the tables. Then use 'iasl -d' on the .dat files
1372 to decompile the tables.
1376 ###############################################################################
1377 # Set variables with no prompt - these can be set anywhere, and putting at
1378 # the end of this file gives the most flexibility.
1380 source "src/lib/Kconfig"
1382 config WARNINGS_ARE_ERRORS
1386 # The four POWER_BUTTON_DEFAULT_ENABLE, POWER_BUTTON_DEFAULT_DISABLE,
1387 # POWER_BUTTON_FORCE_ENABLE and POWER_BUTTON_FORCE_DISABLE options are
1388 # mutually exclusive. One of these options must be selected in the
1389 # mainboard Kconfig if the chipset supports enabling and disabling of
1390 # the power button. Chipset code uses the ENABLE_POWER_BUTTON option set
1391 # in mainboard/Kconfig to know if the button should be enabled or not.
1393 config POWER_BUTTON_DEFAULT_ENABLE
1396 Select when the board has a power button which can optionally be
1397 disabled by the user.
1399 config POWER_BUTTON_DEFAULT_DISABLE
1402 Select when the board has a power button which can optionally be
1403 enabled by the user, e.g. when the board ships with a jumper over
1404 the power switch contacts.
1406 config POWER_BUTTON_FORCE_ENABLE
1409 Select when the board requires that the power button is always
1412 config POWER_BUTTON_FORCE_DISABLE
1415 Select when the board requires that the power button is always
1416 disabled, e.g. when it has been hardwired to ground.
1418 config POWER_BUTTON_IS_OPTIONAL
1420 default y if POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE
1421 default n if !(POWER_BUTTON_DEFAULT_ENABLE || POWER_BUTTON_DEFAULT_DISABLE)
1423 Internal option that controls ENABLE_POWER_BUTTON visibility.
1429 Internal option that controls whether we compile in register scripts.
1431 config MAX_REBOOT_CNT
1435 Internal option that sets the maximum number of bootblock executions allowed
1436 with the normal image enabled before assuming the normal image is defective
1437 and switching to the fallback image.
1439 config UNCOMPRESSED_RAMSTAGE
1442 config NO_XIP_EARLY_STAGES
1444 default n if ARCH_X86
1447 Identify if early stages are eXecute-In-Place(XIP).
1449 config EARLY_CBMEM_LIST
1453 Enable display of CBMEM during romstage and postcar.
1455 config RELOCATABLE_MODULES
1458 If RELOCATABLE_MODULES is selected then support is enabled for
1459 building relocatable modules in the RAM stage. Those modules can be
1460 loaded anywhere and all the relocations are handled automatically.
1462 config GENERIC_GPIO_LIB
1465 If enabled, compile the generic GPIO library. A "generic" GPIO
1466 implies configurability usually found on SoCs, particularly the
1467 ability to control internal pull resistors.
1469 config BOOTBLOCK_CUSTOM
1470 # To be selected by arch, SoC or mainboard if it does not want use the normal
1471 # src/lib/bootblock.c#main() C entry point.
1474 config BOOTBLOCK_IN_CBFS
1476 default y if ARCH_X86
1478 Select this on platforms that have a top aligned bootblock inside cbfs.
1480 config MEMLAYOUT_LD_FILE
1482 default "src/mainboard/\$(CONFIG_MAINBOARD_DIR)/memlayout.ld"
1484 This variable allows SoC/mainboard to supply in a custom linker file
1485 if required. This determines the linker file used for all the stages
1486 (bootblock, romstage, verstage, ramstage, postcar) in
1487 src/arch/${ARCH}/Makefile.mk.
1489 ###############################################################################
1490 # Set default values for symbols created before mainboards. This allows the
1491 # option to be displayed in the general menu, but the default to be loaded in
1492 # the mainboard if desired.
1493 config COMPRESS_PRERAM_STAGES
1494 depends on (HAVE_ROMSTAGE || HAVE_VERSTAGE) && NO_XIP_EARLY_STAGES
1497 config INCLUDE_CONFIG_FILE
1500 config BOOTSPLASH_FILE
1501 depends on BOOTSPLASH_IMAGE
1502 default "bootsplash.jpg"
1504 config BOOTSPLASH_CONVERT_QUALITY
1505 depends on BOOTSPLASH_CONVERT
1508 config BOOTSPLASH_CONVERT_RESOLUTION
1509 depends on BOOTSPLASH_CONVERT_RESIZE
1515 config HAVE_BOOTBLOCK
1519 config HAVE_VERSTAGE
1521 depends on VBOOT_SEPARATE_VERSTAGE
1524 config HAVE_ROMSTAGE
1526 depends on SEPARATE_ROMSTAGE
1529 config HAVE_RAMSTAGE
1531 default n if RAMPAYLOAD
1534 config SEPARATE_ROMSTAGE