Documentation: Add OCP Mono Lake mainboard
Add information about the OCP Mono Lake mainboard. Change-Id: I2109cca0e4037a2945bcb7e4d80897b48ada54af Signed-off-by: Marc Jones <marcjones@sysproconsutling.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/57561 Reviewed-by: Stefan Reinauer <stefan.reinauer@coreboot.org> Reviewed-by: Jay Talbott <JayTalbott@sysproconsulting.com> Tested-by: Stefan Reinauer <stefan.reinauer@coreboot.org> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
This commit is contained in:
Marc Jones
Felix Held
parent
40dccd9f36
commit
4401498041
|
|
@ -99,6 +99,10 @@ The boards in this section are not real mainboards, but emulators.
|
|||
|
||||
- [MS-7707](msi/ms7707/ms7707.md)
|
||||
|
||||
## OCP
|
||||
|
||||
- [Mono Lake](ocp/monolake.md)
|
||||
|
||||
## Open Cellular
|
||||
|
||||
- [Elgon](opencellular/elgon.md)
|
||||
|
|
|
|||
|
|
@ -0,0 +1,146 @@
|
|||
# OCP Mono Lake
|
||||
|
||||
This page describes coreboot support status for the [OCP] (Open Compute Project)
|
||||
Mono Lake server platform.
|
||||
|
||||
## Introduction
|
||||
|
||||
OCP Mono Lake server platform is a component of multi-host server Yosemite-V1.
|
||||
Facebook [introduced Yosemite] in 2015 and the [Mono Lake was accepted] to OCP in 2019.
|
||||
|
||||
Mono Lake server is a single socket BroadwellDE server.
|
||||
|
||||
Yosemite-V1 may host up to 4 Mono Lake servers (blades) in one sled.
|
||||
|
||||
The Yosemite-V1 system is in mass production. Facebook, Intel, ITRenew and partners
|
||||
jointly develop Open System Firmware (OSF) solution on Mono Lake as an alternative
|
||||
solution. The OSF solution is based on coreboot/FSP/LinuxBoot stack. A firmware binary
|
||||
is available from ITRenew.
|
||||
|
||||
coreboot Mono Lake is supported on the coreboot version 4.11 branch.
|
||||
The Broadwell-DE FSP v1.0 support was dropped after 4.11.
|
||||
|
||||
|
||||
## Required blobs
|
||||
|
||||
Mono Lake server OSF solution requires:
|
||||
- [FSP] blob: SysPro custom FSP is required to support the 16-core Broadwell-DE on Mono Lake
|
||||
- Microcode: Available through github.com:otcshare/Intel-Generic-Microcode.git
|
||||
- ME binary: Available under NDA with Intel
|
||||
|
||||
## Payload
|
||||
- LinuxBoot: Linuxboot is the prefered coreboot payload for Mono Lake.
|
||||
It can be built following [All about u-root].
|
||||
|
||||
Tested configuration:
|
||||
Linux Kernel v5.10.44
|
||||
[u-root Mono Lake pull request]
|
||||
u-root build command:
|
||||
GO111MODULE=off u-root -build=bb -uinitcmd=systemboot \
|
||||
-files="${FLASHROMDIR}/flashrom:bin/flashrom" \
|
||||
-files="${VPDDIR}/vpd:bin/vpd" \
|
||||
core github.com/u-root/u-root/cmds/boot/{systemboot,pxeboot,boot} \
|
||||
github.com/u-root/u-root/cmds/exp/{cbmem,dmidecode,modprobe,ipmidump,netbootxyz} \
|
||||
|
||||
note: flashrom and vpd binaries must be precompiled
|
||||
|
||||
## Flashing coreboot
|
||||
|
||||
Mono Lake in-band BIOS firmware image update uses [flashrom]:
|
||||
flashrom -p internal:ich_spi_mode=hwseq -c "Opaque flash chip" --ifd \
|
||||
-i bios --noverify-all -w <path to coreboot image>
|
||||
|
||||
Yosemite-V1 OpenBMC BIOS firmware image update uses fw-util:
|
||||
fw-util slotx --update bios <path to coreboot image>
|
||||
|
||||
## Yosimite-V1 server controls
|
||||
|
||||
To power off/on a Mono Lake host:
|
||||
power-util slotx off
|
||||
power-util slotx on
|
||||
|
||||
To connect to coreboot and Linux console through SOL (Serial Over Lan):
|
||||
sol-util slotx
|
||||
|
||||
## Firmware configurations
|
||||
[ChromeOS VPD] is used to store most of the firmware configurations.
|
||||
RO_VPD region holds default values, while RW_VPD region holds customized
|
||||
values.
|
||||
|
||||
VPD variables supported are:
|
||||
- firmware_version: This variable holds overall firmware version. coreboot
|
||||
uses that value to populate smbios type 1 version field.
|
||||
- bmc_bootorder_override: When it's set to 1 IPMI OEM command can override boot
|
||||
order. The boot order override is done in the u-root LinuxBoot payload.
|
||||
- systemboot_log_level: u-root package systemboot log levels, would be mapped to
|
||||
quiet/verbose in systemboot as that is all we have for now. 5 to 8 would be
|
||||
mapped to verbose, 0 to 4 and 9 would be mapped to quiet.
|
||||
- VPDs affecting coreboot are in src/mainboard/ocp/monolake/mainboard.c.
|
||||
No coreboot VPD are required, uses safe defaults.
|
||||
|
||||
## Working features
|
||||
The solution is developed using LinuxBoot payload with Linux kernel 5.2.9,
|
||||
and [u-root] as initramfs.
|
||||
- BMC integration:
|
||||
- BMC readiness check
|
||||
- IPMI commands
|
||||
- watchdog timer
|
||||
- POST complete pin acknowledgement
|
||||
- Check BMC version: ipmidump -device
|
||||
- Early serial output
|
||||
- ACPI tables: DMAR/DSDT/FACP/FACS/HPET/MCFG/SPMI/SRAT/SLIT/SSDT/XSDT
|
||||
- FSP MRC cache support (Skipping memory training upon subsequent reboots)
|
||||
- Versions
|
||||
- Check FSP version: cbmem | grep LB_TAG_PLATFORM_BLOB_VERSION
|
||||
- Check Microcode version: cat /proc/cpuinfo | grep microcode
|
||||
- Devices:
|
||||
- Boot drive
|
||||
- All 5 data drives
|
||||
- NIC card
|
||||
- SMBIOS:
|
||||
- Type 0 – BIOS Information
|
||||
- Type 1 – System Information
|
||||
- Type 2 – Baseboard Information
|
||||
- Type 3 – System Enclosure or Chassis
|
||||
- Type 4 – Processor Information
|
||||
- Type 7 – Cache Information
|
||||
- Type 16 – Physical Memory Array
|
||||
- Type 17 – Memory Device
|
||||
- Type 32 – System Boot Information
|
||||
- Type 38 – IPMI Device Information
|
||||
- Type 41 – Onboard Devices Extended Information
|
||||
- Type 127 – End-of-Table
|
||||
- Power button
|
||||
- u-root boot
|
||||
- u-root pxeboot
|
||||
|
||||
## Stress and Performance tests passed
|
||||
|
||||
## Known issues
|
||||
|
||||
### Feature gaps
|
||||
- flashrom command not able to update ME region
|
||||
- ACPI BERT table
|
||||
- PCIe hotplug through VPP (Virtual Pin Ports)
|
||||
- RO_VPD region as well as other RO regions are not write protected
|
||||
- Not able to selectively enable/disable core
|
||||
|
||||
## Technology
|
||||
|
||||
```eval_rst
|
||||
+------------------------+---------------------------------------------+
|
||||
| Processor (1 socket) | Broadwell-DE |
|
||||
+------------------------+---------------------------------------------+
|
||||
| BMC | Aspeed AST 1250 |
|
||||
+------------------------+---------------------------------------------+
|
||||
```
|
||||
|
||||
[OCP]: https://www.opencompute.org
|
||||
[introduced Yosemite]: https://engineering.fb.com/2015/03/10/core-data/introducing-yosemite-the-first-open-source-modular-chassis-for-high-powered-microservers/
|
||||
[Mono Lake was accepted]: https://www.opencompute.org/contributions?query=Tioga%20Pass%20v1.0
|
||||
[FSP]: https://doc.coreboot.org/soc/intel/fsp/index.html
|
||||
[u-root Mono Lake pull request]: https://github.com/u-root/u-root/pull/2045
|
||||
[flashrom]: https://flashrom.org/Flashrom
|
||||
[All about u-root]: https://github.com/linuxboot/book/tree/master/u-root
|
||||
[u-root]: https://u-root.org/
|
||||
[ChromeOS VPD]: https://chromium.googlesource.com/chromiumos/platform/vpd/+/master/README.md
|
||||
Loading…
Reference in New Issue