From 7f1e6f2727bdccc3d6f4f06b1ea0995b331a0daa Mon Sep 17 00:00:00 2001 From: Jonathan Zhang Date: Wed, 15 Sep 2021 16:55:49 -0700 Subject: [PATCH] doc/mainboard/ocp: update Delta Lake documentation Update Delta Lake documentation upon: * Delta Lake and Yosemite-V3 design specs acceptance by OCP. * Delta Lake OSF acceptance by OCP. Signed-off-by: Jonathan Zhang Change-Id: I315db879b75f0df2fbca2fa8bb6d00987a69efba Reviewed-on: https://review.coreboot.org/c/coreboot/+/57688 Tested-by: build bot (Jenkins) Reviewed-by: Christian Walter --- Documentation/mainboard/ocp/deltalake.md | 37 ++++++++++++++++-------- 1 file changed, 25 insertions(+), 12 deletions(-) diff --git a/Documentation/mainboard/ocp/deltalake.md b/Documentation/mainboard/ocp/deltalake.md index a2b61b4596..8906ad89b0 100644 --- a/Documentation/mainboard/ocp/deltalake.md +++ b/Documentation/mainboard/ocp/deltalake.md @@ -6,9 +6,11 @@ Delta Lake server platform. ## Introduction OCP Delta Lake server platform is a component of multi-host server system -Yosemite-V3. Both were announced by Facebook and Intel in [OCP virtual summit 2020]. +Yosemite-V3. Both [Delta Lake server design spec] and [Yosemite-V3 design +spec] were contributed to [OCP]. Delta Lake server is a single socket Cooper Lake Scalable Processor (CPX-SP) server. +Intel Cooper Lake Scalable Processor was launched in Q2 2020. Yosemite-V3 has multiple configurations. Depending on configurations, it may host up to 4 Delta Lake servers (blades) in one sled. @@ -16,22 +18,30 @@ host up to 4 Delta Lake servers (blades) in one sled. The Yosemite-V3 system is in mass production. Facebook, Intel and partners jointly develop Open System Firmware (OSF) solution on Delta Lake as an alternative solution. The OSF solution is based on FSP/coreboot/LinuxBoot stack. The -OSF solution reached DVT exit equivalent status. +OSF solution reached production quality for some use cases in July, 2021. -## Required blobs +## How to build -Delta Lake server OSF solution requires: +OSF code base is public at +https://github.com/opencomputeproject/OpenSystemFirmware + +Run following commands to build Delta Lake OSF image from scratch: + git clone https://github.com/opencomputeproject/OpenSystemFirmware.git + cd OpenSystemFirmware/Wiwynn/deltalake && ./download_and_build.sh + +The Delta Lake OSF code base leverages [osf-builder] to sync down coreboot, +Linux kernel and u-root code from their upstream repo, and sync down needed +binary blobs. [osf-builder] also provides the top level build system. + +Delta Lake server OSF solution requires following binary blobs: - FSP blob: The blob (Intel Cooper Lake Scalable Processor Firmware Support Package) - is not yet available to the public. It will be made public soon by Intel - with redistributable license. + can be downloaded from https://github.com/intel/FSP/tree/master/CedarIslandFspBinPkg. - Microcode: Available through github.com/intel/Intel-Linux-Processor-Microcode-Data-Files. coreboot.org mirrors this repo and by default the correct binary is included. -- ME binary: Ignition binary will be made public soon by Intel with - redistributable license. +- ME binary: Ignition binary can be downloaded from + https://github.com/tianocore/edk2-non-osi/tree/master/Silicon/Intel/PurleySiliconBinPkg/MeFirmware - ACM binaries: only required for CBnT enablement. Available under NDA with Intel. - -## Payload -- LinuxBoot: This is necessary only if you use LinuxBoot as coreboot payload. +- Payload: LinuxBoot is necessary when LinuxBoot is used as the coreboot payload. U-root as initramfs, is used in the joint development. It can be built following [All about u-root]. @@ -66,7 +76,7 @@ VPD variables supported are: mapped to verbose, 0 to 4 and 9 would be mapped to quiet. - VPDs affecting coreboot are listed/documented in [src/mainboard/ocp/deltalake/vpd.h]. -## Working features +## Features The solution is developed using LinuxBoot payload with Linux kernel 5.2.9, and [u-root] as initramfs. - SMBIOS: @@ -175,6 +185,9 @@ and [u-root] as initramfs. ``` [OCP]: https://www.opencompute.org +[Delta Lake server design spec]: https://www.opencompute.org/documents/delta-lake-1s-server-design-specification-1v05-pdf +[Yosemite-V3 design spec]: https://www.opencompute.org/documents/ocp-yosemite-v3-platform-design-specification-1v16-pdf +[osf-builder]: https://github.com/facebookincubator/osf-builder [OCP virtual summit 2020]: https://www.opencompute.org/summit/virtual-summit/schedule [flashrom]: https://flashrom.org/Flashrom [All about u-root]: https://github.com/linuxboot/book/tree/master/u-root