From c664b90f056a145fd26a7fe76a9da971b4b6fcba Mon Sep 17 00:00:00 2001 From: Jonathan Zhang Date: Thu, 30 Apr 2020 15:40:04 -0700 Subject: Doc/mb/ocp: Add documentation for Tioga Pass Add OCP platform Tioga Pass documentation. Signed-off-by: Jonathan Zhang Signed-off-by: Reddy Chagam Change-Id: If4c2832d5bd006c572dab035040b4242f8a3d53b Reviewed-on: https://review.coreboot.org/c/coreboot/+/40925 Tested-by: build bot (Jenkins) Reviewed-by: Paul Menzel Reviewed-by: Angel Pons --- Documentation/mainboard/ocp/tiogapass.md | 100 +++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 Documentation/mainboard/ocp/tiogapass.md (limited to 'Documentation/mainboard/ocp') diff --git a/Documentation/mainboard/ocp/tiogapass.md b/Documentation/mainboard/ocp/tiogapass.md new file mode 100644 index 0000000000..6d6afb1920 --- /dev/null +++ b/Documentation/mainboard/ocp/tiogapass.md @@ -0,0 +1,100 @@ +# OCP Tioga Pass + +This page describes coreboot support status for the [OCP] (Open Compute Project) +Tioga Pass server platform. + +## Introduction + +OCP Tioga Pass server platform was contributed by Facebook, and was accepted +in 2019. The design collateral including datasheet can be found at [OCP Tioga Pass]. + +Since complete EE design collateral is open sourced, anyone can build server +as-is or a variant based on the original design. It can also be purchased from [OCP Market Place]. +An off-the-shelf version is available, as well as rack ready version. With the +off-the-shelf version, the server can be plugged into wall power outlet. + +With the off-the-shelf version of Tioga Pass, a complete software solution is +available. [Off-the-shelf Host Firmware] takes the approach of UEFI/Linuxboot. + +coreboot as of release 4.13 is a proof-of-concept project between Facebook, +Intel, Wiwynn and Quanta. The context is described at [OCP Tioga Pass POC Blog]. + +## Required blobs + +This board currently requires: +- FSP blob: The blob (Intel Skylake Scalable Processor Firmware Support Package) + is not yet available to the public. The binary is at POC status, hopefully + someday an IBV is able to obtain the privilege to maintain it. +- Microcode: `3rdparty/intel-microcode/intel-ucode/06-55-04` +- ME binary: The binary can be extracted from [Off-the-shelf Host Firmware]. + +## Payload +- Linuxboot: This is necessary only if you use Linuxboot as coreboot payload. + U-root as initramfs, is used in the POC activity. It can be extracted from + [Off-the-shelf Host Firmware], or it can be built following [All about u-root]. + +## Flashing coreboot + +To do in-band FW image update, use [flashrom]: + flashrom -p internal:ich_spi_mode=hwseq -c "Opaque flash chip" --ifd \ + -i bios --noverify-all -w + +From OpenBMC, to update FW image: + fw-util mb --force --update + +To power off/on the host: + power-util mb off + power-util mb on + +To connect to console through SOL (Serial Over Lan): + sol-util mb + +## Known issues / feature gaps +- C6 state is not supported. Workaround is to disable C6 support through + target OS and Linuxboot kernel paramter, such as "cpuidle.off=1". +- SMI handlers are not implemented. +- xSDT tables are not fully populated, such as processor/socket devices, + PCIe bridge devices. +- There is boot stability issue. Occasionally the boot hangs at ramstage + with following message "BIOS PCU Misc Config Read timed out." +- If [CB 40500 patchset] is not merged, when PCIe riser card is used, + boot fails. +- PCIe devices connected to socket 1 may not work, because FSP + does not support PCIe topology input for socket 1.k +- SMBIOS type 7 and type 17 are not populated. + +## Working +The solution was developed using Linuxboot payload. The Linuxboot +kernel versions tried are 4.16.18 and 5.2.9. The initramfs image is +u-root. +- Most SMBIOS types +- BMC integration: + - BMC readiness check + - IPMI commands + - watchdog timer + - POST complete pin acknowledgement +- SEL record generation +- Early serial output +- port 80h direct to GPIO +- ACPI tables: APIC/DMAR/DSDT/FACP/FACS/HPET/MCFG/SPMI/SRAT/SLIT/SSDT + +## Technology + +```eval_rst ++------------------------+---------------------------------------------+ +| Processor (2 sockets) | Intel Skylake Scalable Processor LGA3647 | ++------------------------+---------------------------------------------+ +| BMC | Aspeed AST 2500 | ++------------------------+---------------------------------------------+ +| PCH | Intel Lewisburg C621 | ++------------------------+---------------------------------------------+ +``` + +[flashrom]: https://flashrom.org/Flashrom +[OCP]: https://www.opencompute.org/ +[OCP Tioga Pass]: https://www.opencompute.org/contributions?query=Tioga%20Pass%20v1.0 +[OCP Market Place]: https://www.opencompute.org/products/109/wiwynn-tioga-pass-advanced-2u-ocp-server-up-to-768gb-12-dimm-slots-4-ssds-for-io-performance +[Off-the-shelf Host Firmware]: https://github.com/linuxboot/book/blob/master/case_studies/TiogaPass/README.md +[OCP Tioga Pass POC Blog]: https://www.opencompute.org/blog/linux-firmware-boots-up-server-powered-by-intelr-xeonr-scalable-processor +[All about u-root]: https://github.com/linuxboot/book/tree/master/u-root +[CB 40500 patchset]: https://review.coreboot.org/c/coreboot/+/40500 -- cgit v1.2.3