heads/blobs/w541
Manuel Mendez 87ec2ca043
blobs: Ignore build generated binaries
These are generated during the build process so should be ignored.

Signed-off-by: Manuel Mendez <github@i.m.mmlb.dev>
Signed-off-by: Thierry Laurion <insurgo@riseup.net>
2024-05-02 13:00:51 -04:00
..
.gitignore blobs: Ignore build generated binaries 2024-05-02 13:00:51 -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