coreboot-kgpe-d16/Documentation/mainboard/51nb/x210.md
Matthew Garrett 2f62a352ea mb/51nb: Add support for the 51nb X210
The 51nb X210 is a replacement motherboard for Thinkpad X200/X201 systems,
based on a modern Kabylake CPU. It also ships with no firmware protection,
(IFD is fully unlocked, no protected regions are set, no Bootguard),
making it an ideal coreboot target. This port is based on the support for
the Skylake-based Purism Librem 13v3, with the following significant
changes:

* EC firmware is contained within the system SPI flash, and so a blob of
  EC firmware must be injected to a defined location during image build.
* GPIO layout is different - this is currently just a raw import of the
  GPIO configuration from the vendor firmware
* The system has two DIMMs, so an additional SPD address has been added
* The USB port layout is different
* The EC must be enabled at boot time through SuperIO-style logical device
  configuration
* EC register layout is different, necessitating changes in the ACPI tables
* The HDA pins are different
* The genx_dec config is different

All hardware appears to work as expected, although the SD reader is
untested.

Signed-off-by: Matthew Garrett <mjg59@google.com>
Signed-off-by: Matt DeVillier <matt.devillier@gmail.com>
Change-Id: If74621e76d703f629b54f1feb1acfc95cc72d183
Reviewed-on: https://review.coreboot.org/c/coreboot/+/32531
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Reviewed-by: Felix Held <felix-coreboot@felixheld.de>
2020-03-16 14:42:04 +00:00

1.4 KiB

51NB X210

Extracting vendor EC firmware

EC firmware is included in the SPI image. To extract it, run:

dd bs=64K skip=32 count=1 if=bios.rom of=ec.bin

and ensure that you have a file that includes the string "Insyde Software Corp"

Flashing instructions

This can be performed using the internal SPI controller, even when flashing from stock firmware. Use flashrom -p internal and follow the appropriate flashrom instructions to force it. Alternatively, external flashing has been tested with Dediprog SF100 and SF600 and using a Beaglebone Black. The flash is located on the upper side of the motherboard, below the keyboard connector. It is circled in red here:

Flashing a subset of the ROM

If you want to flash coreboot without extracting firmware blobs, you can flash coreboot without overwriting those blobs. After building coreboot, create a layout file with the following content:

00000000:001fffff me
00200000:0020ffff ec
00210000:007fffff main

and run flashrom with the "--layout rom.layout --image main" arguments. This will flash the main firmware without overwriting the existing EC or ME firmware.

Working

All hardware features are believed to be working, although the SD reader is untested. Note that certain hotkeys don't work (including the Thinkvantage button) - this is a limitation of the EC firmware, and these keys also generate no events under the stock vendor firmware.