heads/blobs/w541
Manuel Mendez d396236a83
Remove hard coded paths in shebang lines
Remove hard coded paths from shebangs and other references because they
do not play well in nix-land. Either use /usr/bin/env to do runtime PATH
based lookup or avoid absolute paths so PATH look up happens instead.

Signed-off-by: Thierry Laurion <insurgo@riseup.net>
Signed-off-by: Manuel Mendez <github@i.m.mmlb.dev>
Signed-off-by: Thierry Laurion <insurgo@riseup.net>
2024-05-02 13:00:22 -04:00
..
download-clean-me Remove hard coded paths in shebang lines 2024-05-02 13:00:22 -04:00
extract Remove hard coded paths in shebang lines 2024-05-02 13:00:22 -04:00
gbe.bin add configuration for w541 2023-10-23 21:52:09 +02:00
ifd.bin add configuration for w541 2023-10-23 21:52:09 +02:00
README.md add configuration for w541 2023-10-23 21:52:09 +02:00

W541 Blobs

Overview

Coreboot on the W541 requires the following binary blobs:

  • mrc.bin - Consists of Intels Memory Reference Code (MRC) and is used to initialize the DRAM.
  • me.bin - Consists of Intels Management Engine (ME), which we modify using me_cleaner to remove all but the modules which are necessary for the CPU to function.
  • gbe.bin - Consists of hardware/software configuration data for the Gigabit Ethernet (GbE) controller. Intel publishes the data structure here, and an ImHex hex editor pattern is available here.
  • ifd.bin - Consists of the Intel Flash Descriptor (IFD). Intel publishes the data structure here, and an ImHex hex editor pattern is available here.

Heads supplies an IFD and GbE blob, which we extracted from a donor board. We changed the MAC address of the GbE blob to 00:de:ad:c0:ff:ee using nvmutil, to support anonymity and build reproducibility.

When building any W541 board variant with make, the build system will download a copy of the MRC and Intel ME. We extract mrc.bin from a Chromebook firmware image and me.bin from a Lenovo firmware update.

Using Your Own Blobs

You can compile Heads using the Intel ME, GbE, and and IFD blobs from your original ROM.

First, make sure you've built Heads at least once in order to download the Coreboot sources:

$ make BOARD=w541-hotp-maximized

Then, supply the path to the Coreboot sources via the COREBOOT_DIR environment variable, and run the blob-extraction script:

$ export COREBOOT_DIR="./build/x86/coreboot-4.17/"
$ ./blobs/w541/extract /path/to/original_rom.bin ./blobs/w541

Now, you can rebuild Heads:

$ make BOARD=w541-hotp-maximized