From 7c04acff8a58b7350fc669e2a0a71f3a308f8c09 Mon Sep 17 00:00:00 2001 From: Wim Vervoorn Date: Thu, 5 Dec 2019 13:45:41 +0100 Subject: mb/facebook/monolith: Add Facebook Monolith The board is booting Linux and has been briefly tested. SeaBIOS, TianoCore payload and Linux as payload all seem to work fine. BUG=N/A TEST=tested on Facebook Monolith Change-Id: I65a2e03334af65cfb3f825d43fa0daa6e6c75913 Signed-off-by: Wim Vervoorn Reviewed-on: https://review.coreboot.org/c/coreboot/+/37516 Tested-by: build bot (Jenkins) Reviewed-by: Frans Hendriks --- Documentation/mainboard/facebook/monolith.md | 78 ++++++++++++++++++++++++++++ Documentation/mainboard/index.md | 1 + 2 files changed, 79 insertions(+) create mode 100644 Documentation/mainboard/facebook/monolith.md (limited to 'Documentation') diff --git a/Documentation/mainboard/facebook/monolith.md b/Documentation/mainboard/facebook/monolith.md new file mode 100644 index 0000000000..9b9f33b29f --- /dev/null +++ b/Documentation/mainboard/facebook/monolith.md @@ -0,0 +1,78 @@ +# Facebook Monolith + +This page describes how to run coreboot on the Facebook Monolith. + +Please note: the coreboot implementation for this boards is in it's Alpha state and isn't fully +tested yet. + +## Required blobs + +This board currently requires: +fsp blobs 3rdparty/fsp/KabylakeFspBinPkg/Fsp_M.fd + 3rdparty/fsp/KabylakeFspBinPkg/Fsp_S.fd + +Microcode 3rdparty/intel-microcode/intel-ucode + +## Flashing coreboot + +### Internal programming + +The SPI flash can be accessed using [flashrom]. + +### External programming + +The system has an internal flash chip which is a 16 MiB soldered SOIC-8 chip. +Specifically, it's a Winbond W25Q128JVSIQ (3.3V). + +The system has an external flash chip which is a 16 MiB soldered SOIC-8 chip. +Specifically, it's a Winbond W25Q128JVSIM (3.3V). + +Flashing of these devices is very difficult, disassembling the system destroys the cooling +solution. Wires need to be connected to be able to flash using an external programmer. + +## Known issues + +- None + +## Untested + +- Hardware monitor +- SDIO +- Full Embedded Controller support +- eMMC +- SATA + +## Working + +- USB +- Gigabit Ethernet +- Graphics (Using FSP GOP) +- flashrom +- PCIe +- EC serial port +- SMBus +- Initialization with FSP +- SeaBIOS payload (commit a5cab58e9a3fb6e168aba919c5669bea406573b4) +- TianoCore payload (commit a5cab58e9a3fb6e168aba919c5669bea406573b4) + +All of the above has been briefly tested by booting Linux from the TianoCore payload. +SeaBios has been checked to the extend that it runs to the boot selection and provides display +output. + +## Technology + +```eval_rst ++------------------+--------------------------------------------------+ +| SoC | Intel Kaby Lake U | ++------------------+--------------------------------------------------+ +| CPU | Intel i3-7100U | ++------------------+--------------------------------------------------+ +| Super I/O, EC | ITE8256 | ++------------------+--------------------------------------------------+ +| Coprocessor | Intel Management Engine | ++------------------+--------------------------------------------------+ +``` + +[W25Q128JVSIQ]: https://www.winbond.com/resource-files/w25q128jv%20revf%2003272018%20plus.pdf +[W25Q128JVSIM]: https://www.winbond.com/resource-files/w25q128jv%20dtr%20revb%2011042016.pdf +[flashrom]: https://flashrom.org/Flashrom diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md index 60302cbe0f..038689d192 100644 --- a/Documentation/mainboard/index.md +++ b/Documentation/mainboard/index.md @@ -32,6 +32,7 @@ The boards in this section are not real mainboards, but emulators. ## Facebook - [FBG-1701](facebook/fbg1701.md) +- [Monolith](facebook/monolith.md) ## Foxconn -- cgit v1.2.3