# SPDX-License-Identifier: GPL-2.0-only config PLATFORM_USES_FSP2_0 bool default n help Include FSP 2.0 wrappers and functionality config PLATFORM_USES_FSP2_1 bool default n select PLATFORM_USES_FSP2_0 select FSP_USES_CB_STACK help Include FSP 2.1 wrappers and functionality. Feature added into FSP 2.1 specification that impacts coreboot is: 1. Remove FSP stack switch and use the same stack with boot firmware config PLATFORM_USES_FSP2_2 bool default n select PLATFORM_USES_FSP2_1 help Include FSP 2.2 wrappers and functionality. Features added into FSP 2.2 specification that impact coreboot are: 1. Added multi-phase silicon initialization to increase the modularity of the FspSiliconInit() API 2. FSP_INFO_HEADER changes to add FspMultiPhaseSiInitEntryOffset 3. Added EnableMultiPhaseSiliconInit, bootloaders designed for FSP2.0/2.1 can disable the FspMultiPhaseSiInit() API and continue to use FspSiliconInit() without change. config PLATFORM_USES_FSP2_3 bool default n select PLATFORM_USES_FSP2_2 help Include FSP 2.3 wrappers and functionality. Features added into FSP 2.3 specification that impact coreboot are: 1. Added ExtendedImageRevision field in FSP_INFO_HEADER 2. Added FSP_NON_VOLATILE_STORAGE_HOB2 if PLATFORM_USES_FSP2_0 config PLATFORM_USES_FSP2_X86_32 bool default y help The FSP 2.0 runs in x86_32 protected mode. Once there's a x86_64 FSP this needs to default to n. config HAVE_INTEL_FSP_REPO bool help Select this, if the FSP binaries for the platform are public and available in 3rdparty/fsp/. When selecting this option, the platform must also set FSP_HEADER_PATH and FSP_FD_PATH correctly. config FSP_USE_REPO bool "Use binaries of the Intel FSP repository on GitHub" depends on HAVE_INTEL_FSP_REPO select FSP_FULL_FD default y help Select this option to use the default FSP headers and binaries found in the IntelFsp GitHub repository at https://github.com/IntelFsp/FSP/ If unsure, say Y. config FSP_HEADER_PATH string "Location of FSP headers" if !FSP_USE_REPO help Include directory with the FSP ABI header files. config ADD_FSP_BINARIES bool "Add Intel FSP 2.0 binaries to CBFS" if !FSP_USE_REPO default y if FSP_USE_REPO help Add the FSP-M and FSP-S binaries to CBFS. config FSP_T_CBFS string "Name of FSP-T in CBFS" depends on FSP_CAR default "fspt.bin" config FSP_T_LOCATION hex default 0xfffe0000 help The location for FSP-T. config FSP_S_CBFS string "Name of FSP-S in CBFS" default "fsps.bin" config FSP_M_CBFS string "Name of FSP-M in CBFS" default "fspm.bin" config FSP_FULL_FD bool "Use a combined FSP FD file" if !FSP_USE_REPO depends on ADD_FSP_BINARIES help Use a combined FSP FD file instead of specifying individual, already split binaries and split the file at build-time. config FSP_FD_PATH string "Location of FSP FD file" if FSP_FULL_FD && !FSP_USE_REPO help Path to the FSP FD file that contains the individual FSP-T, FSP-M and FSP-S binaries. The file gets split at build-time. config FSP_T_FILE string "Intel FSP-T (temp RAM init) binary path and filename" if !FSP_FULL_FD depends on ADD_FSP_BINARIES depends on FSP_CAR default "\$(obj)/Fsp_T.fd" if FSP_FULL_FD help The path and filename of the Intel FSP-T binary for this platform. config FSP_M_FILE string "Intel FSP-M (memory init) binary path and filename" if !FSP_FULL_FD depends on ADD_FSP_BINARIES default "\$(obj)/Fsp_M.fd" if FSP_FULL_FD help The path and filename of the Intel FSP-M binary for this platform. config FSP_S_FILE string "Intel FSP-S (silicon init) binary path and filename" if !FSP_FULL_FD depends on ADD_FSP_BINARIES default "\$(obj)/Fsp_S.fd" if FSP_FULL_FD help The path and filename of the Intel FSP-S binary for this platform. config FSP_CAR bool default n select NO_CBFS_MCACHE if !NO_FSP_TEMP_RAM_EXIT help Use FSP APIs to initialize & Tear Down the Cache-As-Ram config FSP_T_RESERVED_SIZE hex default 0x100 if FSP_CAR default 0x0 help This is the size of the area reserved by FSP-T. This is not defined in the FSP specification but in the SOC integration guides. config NO_FSP_TEMP_RAM_EXIT bool depends on FSP_CAR help Select this on a platform where you want to use FSP-T but use coreboot code to tear down CAR. config FSP_M_XIP bool default n help Select this value when FSP-M is execute-in-place. config FSP_T_XIP bool default n help Select this value when FSP-T is execute-in-place. config FSP_USES_CB_STACK bool default n help Enable support for fsp to use same stack as coreboot. This option allows fsp to continue using coreboot stack without reinitializing stack pointer. This feature is supported Icelake onwards. config FSP_TEMP_RAM_SIZE hex help The amount of memory coreboot reserves for the FSP to use. In the case of FSP 2.1 and newer that share the stack with coreboot instead of having its own stack, this is the amount of anticipated heap usage in CAR by FSP to setup HOB and needs to be the recommended value from the Platform FSP integration guide. In the case of the FSP having its own stack that will be placed in DRAM and not in CAR, this is the amount of memory the FSP needs for its stack and heap. config FSP_PLATFORM_MEMORY_SETTINGS_VERSIONS bool help This is selected by SoC or mainboard to supply their own concept of a version for the memory settings respectively. This allows deployed systems to bump their version number with the same FSP which will trigger a retrain of the memory. config HAVE_FSP_LOGO_SUPPORT bool default n config BMP_LOGO bool "Enable logo" default n depends on HAVE_FSP_LOGO_SUPPORT help Uses the FSP to display the boot logo. This method supports a BMP file only. The uncompressed size can be up to 1 MB. The logo can be compressed using LZMA. config FSP2_0_LOGO_FILE_NAME string "Logo file" depends on BMP_LOGO default "3rdparty/blobs/mainboard/\$(MAINBOARDDIR)/logo.bmp" config FSP_COMPRESS_FSP_S_LZMA bool config FSP_COMPRESS_FSP_S_LZ4 bool config FSP_COMPRESS_FSP_M_LZMA bool depends on !FSP_M_XIP config FSP_COMPRESS_FSP_M_LZ4 bool depends on !FSP_M_XIP config FSP_ALIGNMENT_FSP_S int help Sets the CBFS alignment for FSP-S config FSP_ALIGNMENT_FSP_M int help Sets the CBFS alignment for FSP-M config FSP_M_ADDR hex help The address FSP-M will be relocated to during build time config FSP_STATUS_GLOBAL_RESET_REQUIRED_3 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET_REQUIRED_4 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET_REQUIRED_5 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET_REQUIRED_6 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET_REQUIRED_7 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET_REQUIRED_8 bool help FSP Reset Status code used for global reset as per FSP EAS v2.0 section 11.2.2 config FSP_STATUS_GLOBAL_RESET hex depends on SOC_INTEL_COMMON_FSP_RESET default 0x40000003 if FSP_STATUS_GLOBAL_RESET_REQUIRED_3 default 0x40000004 if FSP_STATUS_GLOBAL_RESET_REQUIRED_4 default 0x40000005 if FSP_STATUS_GLOBAL_RESET_REQUIRED_5 default 0x40000006 if FSP_STATUS_GLOBAL_RESET_REQUIRED_6 default 0x40000007 if FSP_STATUS_GLOBAL_RESET_REQUIRED_7 default 0x40000008 if FSP_STATUS_GLOBAL_RESET_REQUIRED_8 default 0xffffffff help If global reset is supported by SoC then select the correct status value for global reset type from SoC Kconfig based on available Kconfig options FSP_STATUS_GLOBAL_RESET_REQUIRED_X. Default is unsupported. config SOC_INTEL_COMMON_FSP_RESET bool help Common code block to handle platform reset request raised by FSP. The FSP will use the FSP EAS v2.0 section 12.2.2 (OEM Status Code) to indicate that a reset is required. config FSPS_HAS_ARCH_UPD bool help SoC users must select this Kconfig if the `FSPS_UPD` header has architecture UPD structure as `FSPS_ARCH_UPD`. Typically, platform with FSP 2.2 specification onwards has support for `FSPS_ARCH_UPD` section as part of `FSPS_UPD` structure. But there are some exceptions as in TGL, JSL, XEON_SP FSP header doesn't have support for FSPS_ARCH_UPD. config FSPS_USE_MULTI_PHASE_INIT bool help SoC users to select this Kconfig to set EnableMultiPhaseSiliconInit to enable and execute FspMultiPhaseSiInit() API. config USE_FSP_NOTIFY_PHASE_POST_PCI_ENUM bool help The FSP API is used to notify the FSP about different phases in the boot process. The current FSP specification supports three notify phases: - Post PCI enumeration - Ready to Boot - End of Firmware This option allows FSP to execute Notify Phase API (Post PCI enumeration). SoC users can override this config to use coreboot native implementations to perform the required lock down and chipset register configuration prior to executing any 3rd-party code during PCI enumeration (i.e. Option ROM). coreboot native implementation to skip FSP Notify Phase (Post PCI enumeration) is still WIP. config USE_FSP_NOTIFY_PHASE_READY_TO_BOOT bool help The FSP API is used to notify the FSP about different phases in the boot process. The current FSP specification supports three notify phases: - Post PCI enumeration - Ready to Boot - End of Firmware This option allows FSP to execute Notify Phase API (Ready to Boot). SoC users can override this config to use coreboot native implementations to perform the required lock down and chipset register configuration prior boot to payload. config USE_FSP_NOTIFY_PHASE_END_OF_FIRMWARE bool help The FSP API is used to notify the FSP about different phases in the boot process. The current FSP specification supports three notify phases: - Post PCI enumeration - Ready to Boot - End of Firmware This option allows FSP to execute Notify Phase API (End of Firmware). SoC users can override this config to use coreboot native implementations to perform the required lock down and chipset register configuration prior boot to payload. config FSP_USES_CB_DEBUG_EVENT_HANDLER bool default n help This option allows to create `Debug Event Handler` to print FSP debug messages to output device using coreboot native implementation. config DISPLAY_FSP_TIMESTAMPS bool "Display FSP Timestamps" default n help Select this config to retrieve FSP timestamps from Firmware Performance Data Table (FPDT) and display from ramstage after FSP-S is executed. To be able to use this, FSP has to be compiled with `PcdFspPerformanceEnable` set to `TRUE`. config FSP_ENABLE_SERIAL_DEBUG bool "Output FSP debug messages on serial console" default y depends on FSP_USES_CB_DEBUG_EVENT_HANDLER help Output FSP debug messages on serial console. The config option is selected based on your FSP configuration i.e., debug or release. Enable this option from site-local to print FSP serial messages using coreboot native debug driver when coreboot has integrated the debug FSP binaries. coreboot disables serial messages when this config is not enabled. config SAVE_MRC_AFTER_FSPS bool default n depends on XEON_SP_COMMON_BASE help Save MRC training data after FSP-S. Select this on platforms that generate MRC cache HOB data as part of FSP-S rather than FSP-M. config FSP_MULTIPHASE_SI_INIT_RETURN_BROKEN bool default n depends on PLATFORM_USES_FSP2_2 help Select this config for Intel SoC platform where FSP MultiPhaseSiInit API is unable to return ERROR status properly. The config option will be selected based on the target SoC platform and if the problem existed inside the FSP MultiPhaseSiInit. At present the problem has only reported with Alder Lake and Raptor Lake FSP where MultiPhaseSiInit API is unable to return any ERROR status. endif