mainboard: Add Supermicro X10SLM+-F
This board runs well with coreboot. The documentation part of this commit lists what works and what doesn't. Tested with GRUB 2.02 as a payload, loading SeaBIOS 1.12.0 which then boots FreeBSD 11.2. It has also been tested with GRUB directly booting Debian GNU/Linux 9.6 (kernel 4.9). Change-Id: I291573d4651bdffe24eb841033ea6189fcbf8502 Signed-off-by: Tristan Corrick <tristan@corrick.kiwi> Reviewed-on: https://review.coreboot.org/c/30357 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Arthur Heymans <arthur@aheymans.xyz> Reviewed-by: Angel Pons <th3fanbus@gmail.com>
This commit is contained in:
committed by
Philipp Deppenwiese
parent
8e9921178d
commit
44095c1edc
@@ -66,3 +66,7 @@ The boards in this section are not real mainboards, but emulators.
|
||||
## SiFive
|
||||
|
||||
- [SiFive HiFive Unleashed](sifive/hifive-unleashed.md)
|
||||
|
||||
## Supermicro
|
||||
|
||||
- [X10SLM+-F](supermicro/x10slm-f.md)
|
||||
|
203
Documentation/mainboard/supermicro/x10slm-f.md
Normal file
203
Documentation/mainboard/supermicro/x10slm-f.md
Normal file
@@ -0,0 +1,203 @@
|
||||
# Supermicro X10SLM+-F
|
||||
|
||||
This section details how to run coreboot on the [Supermicro X10SLM+-F].
|
||||
|
||||
## Required proprietary blobs
|
||||
|
||||
```eval_rst
|
||||
Please see :doc:`../../northbridge/intel/haswell/mrc.bin`.
|
||||
```
|
||||
|
||||
## Building coreboot
|
||||
|
||||
```eval_rst
|
||||
If you haven't already, build the coreboot toolchain as described in
|
||||
:doc:`../../lessons/lesson1`.
|
||||
```
|
||||
|
||||
A fully working image should be possible so long as you have the
|
||||
Haswell `mrc.bin` file. You can set the basic config with the following
|
||||
commands. However, it is strongly advised to use `make menuconfig`
|
||||
afterwards (or instead), so that you can see all of the settings.
|
||||
|
||||
```bash
|
||||
make distclean # Note: this will remove your current config, if it exists.
|
||||
touch .config
|
||||
./util/scripts/config --enable VENDOR_SUPERMICRO
|
||||
./util/scripts/config --enable BOARD_SUPERMICRO_X10SLM_PLUS_F
|
||||
./util/scripts/config --enable HAVE_MRC
|
||||
make olddefconfig
|
||||
```
|
||||
|
||||
If you don't plan on using coreboot's serial console to collect logs,
|
||||
you might want to disable it at this point (`./util/scripts/config
|
||||
--disable CONSOLE_SERIAL`). It should reduce the boot time by several
|
||||
seconds. However, a more flexible method is to change the console log
|
||||
level from within an OS using `util/nvramtool`, or with the `nvramcui`
|
||||
payload.
|
||||
|
||||
Now, run `make` to build the coreboot image.
|
||||
|
||||
## Flashing coreboot
|
||||
|
||||
```eval_rst
|
||||
In addition to the information here, please see the
|
||||
:doc:`../../flash_tutorial/index`.
|
||||
```
|
||||
|
||||
### Internal programming
|
||||
|
||||
Under the vendor firmware, the BIOS region of the flash chip is
|
||||
write-protected. Additionally, the vendor flashing tool does not work
|
||||
with a coreboot image. So, [external programming](#external-programming)
|
||||
needs to be used when first installing coreboot. By default, coreboot is
|
||||
not configured to write-protect the BIOS region, so internal programming
|
||||
can be used thereafter.
|
||||
|
||||
[flashrom] may be used to flash coreboot internally:
|
||||
|
||||
```bash
|
||||
sudo flashrom -p internal --ifd -i bios --noverify-all -w coreboot.rom
|
||||
```
|
||||
|
||||
The use of `--noverify-all` is required since the Management Engine
|
||||
region is not readable even by the host.
|
||||
|
||||
### External programming
|
||||
|
||||
The main firmware flash chip is an SOIC-8 package located near the CMOS
|
||||
battery and SATA ports. It should come with a sticker attached that
|
||||
states the firmware revision (e.g. "X10SLH 4.424"). The chip model is
|
||||
an N25Q128A, and the datasheet can be found [here][N25Q128A].
|
||||
|
||||
As with [internal programming](#internal-programming), [flashrom] works
|
||||
reliably:
|
||||
|
||||
```bash
|
||||
flashrom -p <your-programmer> --ifd -i bios -w coreboot.rom
|
||||
```
|
||||
|
||||
For flashing to work, power to the board should be disconnected (ACPI
|
||||
G3), and power should be supplied from the external programmer. There is
|
||||
a diode attached to Vcc, so such flashing should not damage the board.
|
||||
During testing, a single X10SLM+-F has been flashed dozens of times this
|
||||
way without issue.
|
||||
|
||||
## BMC (IPMI)
|
||||
|
||||
This board has an ASPEED [AST2400], which has BMC functionality. The
|
||||
BMC firmware resides in a 32 MiB SOIC-16 chip just above the [AST2400].
|
||||
This chip is an MX25L25635F, whose datasheet can be found
|
||||
[here][MX25L25635F].
|
||||
|
||||
### Removing the BMC functionality
|
||||
|
||||
The BMC functionality on this board can be removed. If you do not need
|
||||
its features, removing the BMC functionality might increase security.
|
||||
This topic has not been widely explored, and you should only **undertake
|
||||
this process at your own risk.**
|
||||
|
||||
There is a jumper labelled `JPB1` on the board that states the ability
|
||||
to disable the BMC. Though, pins 1 and 2 are fixed together, keeping
|
||||
the BMC enabled. It might be possible to disable the BMC by cutting the
|
||||
connection between pins 1 and 2 (and then connecting pins 2 and 3). This
|
||||
has not been tested so far.
|
||||
|
||||
Another approach is to erase the entire BMC firmware chip. However, if
|
||||
this is done, and the board's power cycled, the voltage changes on some
|
||||
pins of the flash chip, **so it will be harder to flash it again!**
|
||||
|
||||
To remove the firmware, connect an external programmer to the BMC
|
||||
firmware chip. Vcc should **not** be connected via the external
|
||||
programmer. The system should be turned off, but the power still
|
||||
connected (ACPI S5). Then, erase the chip with [flashrom]. Power cycle
|
||||
the board, and the BMC should no longer be active.
|
||||
|
||||
If you erase the BMC firmware while using the **vendor BIOS**, you
|
||||
will need to cut the connection between pins 1 and 2 of `JPB1`. The
|
||||
system will stall for two minutes each time when booting, but it will
|
||||
eventually start. There is no such delay when running coreboot.
|
||||
|
||||
## ECC DRAM
|
||||
|
||||
```eval_rst
|
||||
ECC DRAM seems to work, but please see
|
||||
:doc:`../../northbridge/intel/haswell/mrc.bin`
|
||||
for caveats.
|
||||
```
|
||||
|
||||
## Known issues
|
||||
|
||||
- The x8 PCIe slots do not work, as the Haswell code is missing support.
|
||||
The code to support it has been written, but it still needs to be
|
||||
reviewed and merged.
|
||||
|
||||
- Broadwell CPUs are not supported. They might work with minimal changes
|
||||
to the code, but this has not been tested.
|
||||
|
||||
- The PCH thermal sensor doesn't yet have a driver in coreboot, so it
|
||||
can't be used for temperature readings.
|
||||
|
||||
- There is no automatic, OS-independent fan control. This is because
|
||||
the super I/O hardware monitor can only obtain valid CPU temperature
|
||||
readings from the PECI agent, but the required driver doesn't exist
|
||||
in coreboot. The `coretemp` driver can still be used for accurate CPU
|
||||
temperature readings from an OS, and hence the OS can do fan control.
|
||||
|
||||
## Untested
|
||||
|
||||
- TPM
|
||||
- PCIe x4 slot (it will almost certainly work)
|
||||
- BMC (IPMI) functionality
|
||||
- internal serial port
|
||||
- chassis intrusion header
|
||||
- SATA DOM header
|
||||
- standby power header
|
||||
- serial GPIO headers
|
||||
- power supply SMBus header
|
||||
- jumpers not otherwise mentioned
|
||||
- LEDs
|
||||
|
||||
## Working
|
||||
|
||||
- USB
|
||||
- S3 suspend/resume
|
||||
- Gigabit Ethernet
|
||||
- SATA
|
||||
- external serial port
|
||||
- VGA graphics
|
||||
- disabling VGA graphics using the jumper
|
||||
- hiding the AST2400 using the CMOS setting
|
||||
- super I/O hardware monitor (see [Known issues](#known-issues))
|
||||
- initialisation with Haswell MRC version 1.6.1 build 2
|
||||
- flashrom under coreboot
|
||||
- Wake-on-LAN
|
||||
- front panel header
|
||||
- internal buzzer
|
||||
|
||||
## Technology
|
||||
|
||||
```eval_rst
|
||||
+------------------+--------------------------------------------------+
|
||||
| CPU | :doc:`../../northbridge/intel/haswell/index` |
|
||||
+------------------+--------------------------------------------------+
|
||||
| PCH | Intel Lynx Point (C224) |
|
||||
+------------------+--------------------------------------------------+
|
||||
| Super I/O | Nuvoton NCT6776 |
|
||||
+------------------+--------------------------------------------------+
|
||||
| Coprocessor | Intel SPS (server version of the ME) |
|
||||
+------------------+--------------------------------------------------+
|
||||
| Coprocessor | ASPEED AST2400 |
|
||||
+------------------+--------------------------------------------------+
|
||||
```
|
||||
|
||||
## Extra links
|
||||
|
||||
- [Board manual]
|
||||
|
||||
[AST2400]: https://www.aspeedtech.com/products.php?fPath=20&rId=376
|
||||
[Board manual]: https://www.supermicro.com/manuals/motherboard/C224/MNL-1500.pdf
|
||||
[flashrom]: https://flashrom.org/Flashrom
|
||||
[MX25L25635F]: https://media.digikey.com/pdf/Data%20Sheets/Macronix/MX25L25635F.pdf
|
||||
[N25Q128A]: https://www.micron.com/~/media/Documents/Products/Data%20Sheet/NOR%20Flash/Serial%20NOR/N25Q/n25q_128mb_3v_65nm.pdf
|
||||
[Supermicro X10SLM+-F]: https://www.supermicro.com/products/motherboard/xeon/c220/x10slm_-f.cfm
|
Reference in New Issue
Block a user