mirror of
https://github.com/linuxboot/heads.git
synced 2024-12-25 15:41:07 +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
|
|||
|
|
```
|