tidy up the vendor inject guide

some of the wording was a bit long, and there was slight
repetition in cases. streamline it a bit more, so that it
reads more fluidly

Signed-off-by: Leah Rowe <leah@libreboot.org>
master
Leah Rowe 2025-01-04 15:42:38 +00:00
parent c587cee2ac
commit 08f35ff1b6
1 changed files with 20 additions and 17 deletions

View File

@ -39,24 +39,21 @@ if your board requires it, otherwise your board simply will not boot.**
Introduction Introduction
============ ============
Coreboot is nominally free software, but requires certain vendor code on some On *some* boards, but certainly not all of them, certain files are required from
boards, for certain functionalities; we cover this more thoroughly in the hardware vendor. Libreboot has strict [rules](../../news/policy.md)
the [Freedom Status](../../freedom-status.md) page and in the [Binary Blob governing this, and you can find more information on
Reduction Policy](../../news/policy.md). the [Freedom Status](../../freedom-status.md) page.
Libreboot can't directly distribute *all* of these files, so some of them are Libreboot can't directly distribute *all* of these files, so some of them are
downloaded at build-time, and processed for insertion into the firmware images. downloaded at build-time, and processed for insertion into the firmware images.
**On pre-compiled ROM images in releases, these files are removed, and can be **On pre-compiled ROM images in releases, these files are removed, and can be
re-added using the same automation that was applied during the build process.** re-added using the same automation that was applied during the build process.**
Examples of vendor files can include, for example: Intel ME (disabled after Examples of these files can be found on
boot with me\_cleaner), Embedded Controller firmware (e.g. KBC1126 EC firmware the [Freedom Status](../../freedom-status.md) page.
on HP EliteBooks), VGA ROMs (e.g. Nvidia GPU ROM for Dell Latitude E6400),
and so on. Without these, your machine may not boot correctly, or not boot at
all!
If in doubt, you should simply follow these instructions. If your board **If in doubt, you should simply follow these instructions. If your board
doesn't need vendor files, the tar archive won't be modified. doesn't need vendor files, the tar archive won't be modified.**
MAC address MAC address
----------- -----------
@ -246,9 +243,14 @@ by processing the MEv11 image with Mate Kukri's [deguard](deguard.md) utility.
Errata Errata
====== ======
This section should not concern you, if you're using newer Libreboot releases.
This section largely concerns *bugs* which existed in older releases, pertaining
to this documentation, and design changes made accordingly.
NOTE: As of Libreboot releases from May 2024 onward, the Intel MRC is no longer NOTE: As of Libreboot releases from May 2024 onward, the Intel MRC is no longer
included for Haswell; MRC is a blob for raminit, but we now provide libre included for Haswell; MRC is a firmware for raminit, but we now provide native
raminit. The following targets no longer exist in the build system: raminit written by Angel Pons, for the coreboot project. The following targets
no longer exist in the build system:
* `t440pmrc_12mb` (use `t440plibremrc_12mb` instead) * `t440pmrc_12mb` (use `t440plibremrc_12mb` instead)
* `t440pbmrc_12mb` (use `t440plibremrc_12mb` instead) * `t440pbmrc_12mb` (use `t440plibremrc_12mb` instead)
@ -276,9 +278,10 @@ images but on the newer build system from May 2024 onward; you must use the
Libreboot 20240225 release if you want to inject MRC and so on, for these older Libreboot 20240225 release if you want to inject MRC and so on, for these older
targets. targets.
Libreboot's [binary blob reduction policy](../../news/policy.md) is very strict, Libreboot's [Binary Blob Reduction Policy](../../news/policy.md) is very strict,
and states: if a blob can be avoided, it must be avoided. Therefore, the MRC and states: if it can be done with free software exclusively, then it should be
is removed on Haswell and Libreboot will only use the libre raminit (called done with free software exclusively. Therefore, the MRC is removed on Haswell
NRI, short for Native Ram Initialisation). and Libreboot will only use the libre raminit (called NRI, short for Native Ram
Initialisation).
The four freedoms are absolute. The four freedoms are absolute.