Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Libreboot

General steps to download and prepare Libreboot. See sections for specific hardware hints.

first steps

Supposing to start with a fresh debian based os, git is the first software required to checkout the repo. Then the ./mk utility has an option to install all the build dependencies.

sudo apt install git
git config --global user.name my-name
git config --global user.email my-email
git clone https://codeberg.org/libreboot/lbmk.git
cd lbmk
sudo ./mk dependencies debian

speed up the build time

export XBMK_THREADS=4 or the number of cores of the system in use.

flashprog

./mk -b flashprog this will install flashprog, used to read and write from the bios chip.

build phase

./mk -b coreboot my-chip where my-chip is the name of the system, as listed with ./mk -b coreboot list

INTERNAL flash

read and backup the vendor bios

From the directory containing ./lbmk:

./lbmk/elf/flashprog -p internal -r bios-1.rom
./lbmk/elf/flashprog -p internal -r bios-2.rom
diff bios-*
write the libreboot firmware

no output means the 2 readings are equal, so likely it’s a good backup. Delete one of them.

./lbmk/elf/flashprog -p internal -w lbmk/bin/the-system-built-dir/choose-one.rom

where of course it has to be the right system and the right name.

EXTERNAL flash