mirror of
https://github.com/linuxboot/heads.git
synced 2024-12-29 17:28:54 +00:00
41 lines
2.4 KiB
Markdown
41 lines
2.4 KiB
Markdown
# W541 Blobs
|
||
|
||
- [Overview](#overview)
|
||
- [Using Your Own Blobs](#using-your-own-blobs)
|
||
|
||
## Overview
|
||
|
||
Coreboot on the W541 requires the following binary blobs:
|
||
|
||
- `mrc.bin` - Consists of Intel’s Memory Reference Code (MRC) and [is used to initialize the DRAM](https://doc.coreboot.org/northbridge/intel/haswell/mrc.bin.html).
|
||
- `me.bin` - Consists of Intel’s Management Engine (ME), which we modify using [me_cleaner](https://github.com/corna/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](https://web.archive.org/web/20230122164346/https://www.intel.com/content/dam/www/public/us/en/documents/design-guides/i-o-controller-hub-8-9-nvm-map-guide.pdf), and an [ImHex](https://github.com/WerWolv/ImHex) hex editor pattern is available [here](https://github.com/rbreslow/ImHex-Patterns/blob/rb/intel-ich8/patterns/intel/ich8_lan_nvm.hexpat).
|
||
- `ifd.bin` - Consists of the Intel Flash Descriptor (IFD). Intel publishes the data structure [here](https://web.archive.org/web/20221208011432/https://www.intel.com/content/dam/www/public/us/en/documents/datasheets/io-controller-hub-8-datasheet.pdf), and an ImHex hex editor pattern is available [here](https://github.com/rbreslow/ImHex-Patterns/blob/rb/intel-ich8/patterns/intel/ich8_flash_descriptor.hexpat).
|
||
|
||
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](https://libreboot.org/docs/install/nvmutil.html), 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:
|
||
|
||
```console
|
||
$ 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:
|
||
|
||
```console
|
||
$ export COREBOOT_DIR="./build/x86/coreboot-4.17/"
|
||
$ ./blobs/w541/extract /path/to/original_rom.bin ./blobs/w541
|
||
```
|
||
|
||
Now, you can rebuild Heads:
|
||
|
||
```console
|
||
$ make BOARD=w541-hotp-maximized
|
||
```
|