Hello Anjaneya "Reddy" Chagam,
I'd like you to do a code review. Please visit
https://review.coreboot.org/c/coreboot/+/40925
to review the following change.
Change subject: Documentation/mb/ocp/tiogapass: Add documentation ......................................................................
Documentation/mb/ocp/tiogapass: Add documentation
Add OCP platform TiogaPass documentation.
Signed-off-by: Jonathan Zhang jonzhang@fb.com Signed-off-by: Reddy Chagam anjaneya.chagam@intel.com Change-Id: If4c2832d5bd006c572dab035040b4242f8a3d53b --- A Documentation/mainboard/ocp/tiogapass.md M MAINTAINERS 2 files changed, 105 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/25/40925/1
diff --git a/Documentation/mainboard/ocp/tiogapass.md b/Documentation/mainboard/ocp/tiogapass.md new file mode 100644 index 0000000..33c5e10 --- /dev/null +++ b/Documentation/mainboard/ocp/tiogapass.md @@ -0,0 +1,95 @@ +# OCP TiogaPass + +This page describes coreboot support status for the OCP (Open Compute Project) +TiogaPass server platform. + +## Introduction + +OCP TiogaPass server platform was contributed by Facebook, and was accepted +in 2019. The design collatoral including datasheet can be found at [OCP TiogaPass]. + +Since complete EE design collaboral is open sourced, anyone can build 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 TiogaPass, 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. More context can be referenced at [OCP TiogaPass POC Blog]. +## Required blobs + +This board currently requires: +fsp blob - The blob is not available to the public. The binary is at POC +status, hopefully there is a IBV stepping up to maintain the binary. +Microcode - 3rdparty/intel-microcode/intel-ucode/06-55-04 +ME binary - The binary can be extracted from [Off-the-shelf Host Firmware]. +Linuxboot binary - This is optional. 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 according to [All about u-root]. + +## Flashing coreboot + +### Internal programming + +Using [flashrom] is not verified. + +### External programming + +From OpenBMC, to update FW image: +fw-util mb --force --update <path to coreboot image> + +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. +- SMI handlers are not implemented. +- xSDT tables are not fully populated, such as processor/socket devices, +PCIe bridge devices. +- There is boot stability issue. +- If [CB 40500 patchset] is not merged, when PCIe riser card is used, +boot fails. +- PCIe devices connected to socket 1 may not work, due to FSP issue. +- Some TiogaPass SKUs do not have all PCIe devices working. +- SMBIOS type 7 and type 17 are not populated. + +- None + +## Working +- 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 ++------------------+--------------------------------------------------+ +| SoC (2 sockets) | Intel SkyLake Scalable Processor LGA3647 | ++------------------+--------------------------------------------------+ +| BMC | Aspeed 2500 | ++------------------+--------------------------------------------------+ +| PCH | Intel Lewisburg C620 | ++------------------+--------------------------------------------------+ +``` + +[flashrom]: https://flashrom.org/Flashrom +[OCP TiogaPass]: 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-s... +[Off-the-shelf Host Firmware]: https://github.com/linuxboot/book/blob/master/case_studies/TiogaPass/README.... +[OCP TiogaPass POC Blog]: https://www.opencompute.org/blog/linux-firmware-boots-up-server-powered-by-i... +[All about u-root]: https://github.com/linuxboot/book/tree/master/u-root +[CB 40500 patchset]: https://review.coreboot.org/c/coreboot/+/40500 diff --git a/MAINTAINERS b/MAINTAINERS index bc1e1fc..3531292 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -362,6 +362,16 @@ S: Maintained F: src/mainboard/facebook/monolith/
+OCP TIOGAPASS MAINBOARD +M: Jonathan Zhang jonzhang@fb.com +M: Reddy Chagam anjaneya.chagam@intel.com +M: Johnny Lin Johnny_Lin@wiwynn.com +M: Morgan Jang Morgan_Jang@wiwynn.com +M: Ryback Hung <Ryback.Hung@quantatw.com +M: Bryant Ou Bryant.Ou@quantatw.com +S: Maintained +F: src/mainboard/ocp/tiogapass + PORTWELL PQ-M107 MAINBOARD M: Frans Hendriks fhendriks@eltan.com M: Wim Vervoorn wvervoorn@eltan.com