Xeon Scalable processor coreboot Community Preview Guide¶

Background¶

Sapphire Rapids coreboot was already merged into coreboot mainline. Granite Rapids coreboot upstreaming is coming.

For Granite Rapids coreboot, we are going to perform a phased upstreaming strategy according to the maturity of the code. A community preview branch is opensource at: https://review.coreboot.org/plugins/gitiles/intel-dev-pub/.

The community preview branch initially contains codes on legacy feature enabling and matured patch set for platform support. More platform support code will come with the platform development. The subsequent upstreaming work will be based on this branch. It provides 2 board targets,

Avenue City CRB (Granite Rapids-AP)
Beechnut City CRB (Granite Rapids-SP)

The above targets can pass build with Granite Rapids n-1 FSP headers, which is a set of stub FSP headers used for compilation sanity check.

Build steps¶

Prepare workspace¶

# Create workspace

mkdir workspace && cd workspace

# Prepare coreboot codebase

git clone https://review.coreboot.org/intel-dev-pub ln -s intel-dev-pub/
coreboot

# Prepare stub binaries and update their path in
# configs/builder/config.intel.crb.avc.n-1

# Granite Rapids coreboot uses FSP 2.4, where FSP-I is newly introduced
# as an optional module to provide FSP based SMM capability. For FSP 2.4
# and FSP-I, please further refer to:
# https://cdrdv2-public.intel.com/736809/736809_FSP_EAS_v2.4_Errata_A.pdf

CONFIG_IFD_BIN_PATH=<path of intel flash descriptor blob>
CONFIG_CPU_UCODE_BINARIES=<path of ucode>
CONFIG_FSP_T_FILE=<path of FSP-T binary>
CONFIG_FSP_M_FILE=<path of FSP-M binary>
CONFIG_FSP_S_FILE=<path of FSP-S binary>
CONFIG_FSP_I_FILE=<path of FSP-I binary>
CONFIG_PAYLOAD_FILE=<path of payload binary>

Download necessary submodules¶

git submodule update --init --checkout 3rdparty/vboot

Or take below alternative if the network connection is not good¶

git clone https://github.com/coreboot/vboot.git 3rdparty/vboot/

Build toolchain¶

make crossgcc-i386 CPUS=$(nproc)

Build BIOS (Avenue City CRB)¶

make distclean

make defconfig KBUILD_DEFCONFIG=configs/builder/config.intel.crb.avc.n-1

make olddefconfig

make clean

make UPDATED_SUBMODULES=1 -j`nproc`

Build BIOS (Beechnut City CRB)¶

make distclean

make defconfig KBUILD_DEFCONFIG=configs/builder/config.intel.crb.bnc.n-1

make olddefconfig

make clean

make UPDATED_SUBMODULES=1 -j`nproc`

Obtain the preview patch list¶

# The tag ‘upstream’ points to the upstream commit that the preview
# branch is based on.

git format-patch upstream..HEAD

About Granite Rapids n-1 FSP Headers¶

This is a set of stub FSP headers for Granite Rapids server, which will be forward compatible with the formal Granite Rapids FSP headers which will be opensource at a later stage. For the n-1 FSP headers, there are no corresponding n-1 FSP binaries. To pass build, users need to use stub binaries which could be generated in arbitrary ways. Granite Rapids n-1 FSP headers are at: src/vendorcode/intel/fsp/fsp2_0/graniterapids_n-1.

For the formal Granite Rapids FSP headers and binaries, they will be published at in https://github.com/coreboot/coreboot/tree/main/src/vendorcode/intel/fsp/fsp2_0 (headers only) and https://github.com/intel/FSP (headers and binaries) at a later stage.