xref: /aosp_15_r20/external/coreboot/Documentation/mainboard/ocp/tiogapass.md (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1# OCP Tioga Pass
2
3This page describes coreboot support status for the [OCP] (Open Compute Project)
4Tioga Pass server platform.
5
6## Introduction
7
8OCP Tioga Pass server platform was contributed by Facebook, and was accepted
9in 2019. The design collateral including datasheet can be found at [OCP Tioga Pass].
10
11Since complete EE design collateral is open sourced, anyone can build server
12as-is or a variant based on the original design. It can also be purchased from [OCP Market Place].
13An off-the-shelf version is available, as well as rack ready version. With the
14off-the-shelf version, the server can be plugged into wall power outlet.
15
16With the off-the-shelf version of Tioga Pass, a complete software solution is
17available. [Off-the-shelf Host Firmware] takes the approach of UEFI/Linuxboot.
18
19coreboot as of release 4.13 is a proof-of-concept project between Facebook,
20Intel, Wiwynn and Quanta. The context is described at [OCP Tioga Pass POC Blog].
21
22## Required blobs
23
24This board currently requires:
25- FSP blob: The blob (Intel Skylake Scalable Processor Firmware Support Package)
26  is not yet available to the public. The binary is at POC status, hopefully
27  someday an IBV is able to obtain the privilege to maintain it.
28- Microcode: `3rdparty/intel-microcode/intel-ucode/06-55-04`
29- ME binary: The binary can be extracted from [Off-the-shelf Host Firmware].
30
31## Payload
32- Linuxboot: This is necessary only if you use Linuxboot as coreboot payload.
33  U-root as initramfs, is used in the POC activity. It can be extracted from
34  [Off-the-shelf Host Firmware], or it can be built following [All about u-root].
35
36## Flashing coreboot
37
38To do in-band FW image update, use [flashrom]:
39    flashrom -p internal:ich_spi_mode=hwseq -c "Opaque flash chip" --ifd \
40			-i bios --noverify-all -w <path to coreboot image>
41
42From OpenBMC, to update FW image:
43    fw-util mb --force --update <path to coreboot image>
44
45To power off/on the host:
46    power-util mb off
47    power-util mb on
48
49To connect to console through SOL (Serial Over Lan):
50    sol-util mb
51
52## Known issues / feature gaps
53- C6 state is not supported. Workaround is to disable C6 support through
54  target OS and Linuxboot kernel parameter, such as "cpuidle.off=1".
55- SMI handlers are not implemented.
56- xSDT tables are not fully populated, such as processor/socket devices,
57  PCIe bridge devices.
58- There is boot stability issue. Occasionally the boot hangs at ramstage
59  with following message "BIOS PCU Misc Config Read timed out."
60- If [CB 40500 patchset] is not merged, when PCIe riser card is used,
61  boot fails.
62- PCIe devices connected to socket 1 may not work, because FSP
63  does not support PCIe topology input for socket 1.k
64- SMBIOS type 7 and type 17 are not populated.
65
66## Working
67The solution was developed using Linuxboot payload. The Linuxboot
68kernel versions tried are 4.16.18 and 5.2.9. The initramfs image is
69u-root.
70- Most SMBIOS types
71- BMC integration:
72    - BMC readiness check
73    - IPMI commands
74    - watchdog timer
75    - POST complete pin acknowledgement
76- SEL record generation
77- Early serial output
78- port 80h direct to GPIO
79- ACPI tables: APIC/DMAR/DSDT/FACP/FACS/HPET/MCFG/SPMI/SRAT/SLIT/SSDT
80
81## Technology
82
83```{eval-rst}
84+------------------------+---------------------------------------------+
85| Processor (2 sockets)  | Intel Skylake Scalable Processor LGA3647    |
86+------------------------+---------------------------------------------+
87| BMC                    | Aspeed AST 2500                             |
88+------------------------+---------------------------------------------+
89| PCH                    | Intel Lewisburg C621                        |
90+------------------------+---------------------------------------------+
91```
92
93[flashrom]: https://flashrom.org/Flashrom
94[OCP]: https://www.opencompute.org/
95[OCP Tioga Pass]: https://www.opencompute.org/contributions?query=Tioga%20Pass%20v1.0
96[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
97[Off-the-shelf Host Firmware]: https://github.com/linuxboot/book/blob/master/case_studies/TiogaPass/README.md
98[OCP Tioga Pass POC Blog]: https://www.opencompute.org/blog/linux-firmware-boots-up-server-powered-by-intelr-xeonr-scalable-processor
99[All about u-root]: https://github.com/linuxboot/book/tree/master/u-root
100[CB 40500 patchset]: https://review.coreboot.org/c/coreboot/+/40500
101