diff options
author | Jonathan Zhang <jonzhang@fb.com> | 2021-09-15 16:55:49 -0700 |
---|---|---|
committer | Patrick Georgi <pgeorgi@google.com> | 2021-09-23 06:28:39 +0000 |
commit | 7f1e6f2727bdccc3d6f4f06b1ea0995b331a0daa (patch) | |
tree | 33c1362b653a36b1909fff90d8ea60dec7799142 | |
parent | 911f3273987b5407a87681429720b840bb7c336e (diff) |
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 <jonzhang@fb.com>
Change-Id: I315db879b75f0df2fbca2fa8bb6d00987a69efba
Reviewed-on: https://review.coreboot.org/c/coreboot/+/57688
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Christian Walter <christian.walter@9elements.com>
-rw-r--r-- | Documentation/mainboard/ocp/deltalake.md | 37 |
1 files 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 |