Article published by: Leah Rowe
Date of publication: 19 March 2023
UPDATE: Bugs in this were fixed, and a bugfix release is now available. See: Libreboot 20230413 release announcement of 13 April 2023 - the
w541mrc_12mb images have been re-added, in the new release.
PLEASE READ THIS BEFORE INSTALLING: Safety issues updating Libreboot on Sandybridge/Ivybridge/Haswell
Libreboot provides boot firmware for supported x86/ARM machines, starting a bootloader that then loads your operating system. It replaces proprietary BIOS/UEFI firmware on x86 machines, and provides an improved configuration on ARM-based chromebooks supported (U-Boot bootloader, instead of Google’s depthcharge bootloader). On x86 machines, the GRUB and SeaBIOS coreboot payloads are officially supported, provided in varying configurations per machine. It provides an automated build system for the configuration and installation of coreboot ROM images, making coreboot easier to use for non-technical people. You can find the list of supported hardware in the Libreboot documentation.
The last Libreboot release, version 20221214, was released on 14 December in 2022. This new release, Libreboot 20230319, is released today on March 19th, 2023.
This is marked as a testing release. Not all ROM image configurations have been provided pre-compiled; specifically,
veyron chromebook boards are not available pre-compiled, but the other boards are. A few new boards have been added, in addition to several fixes and feature additions.
On newer Intel platforms that require Intel ME and/or MRC firmware, such as ThinkPad X230 or T440p, and/or HP laptops that require KBC1126 EC firmware, the release ROMs of Libreboot are MISSING certain files, that you must insert yourself. FAILURE to adhere to this warning may result in you bricking your machine (rendering it unbootable), if you were to flash the release ROMs without modifying them in any way. For more information, please read:
This isn’t required on all Libreboot-supported boards, but if in doubt, follow these instructions anyway. If you run
blobutil on a board that doesn’t need blobs, nothing will happen.
This release was build-tested on Debian Sid, as of 18 March 2023. Your mileage may vary, with other distros. Refer to Libreboot documentation.
For more detailed change logs, look at the Git repository. This is a summary of changes.
I’ve been very busy these last couple months, so there have been less changes in Libreboot lately. I’m expecting to have a lot more time throughout the coming summer, which I plan to make full use of for the next Libreboot release.
The changes can be summarised, thus:
mrc.binfor raminit are still available aswell, so this release contains ROMs with libre raminit and ROMs with blob raminit. The reasons are explained below.
mrc.bin. The images with libre MRC still have broken S3. S3 suspend/resume is what people refer to as sleep mode and wake from sleep.
GRUB_TERMINAL=consolethat you might find in
/etc/default/grubon a Linux machine. In Libreboot, switching VGA/text modes is unsupported, it’s stuck in one mode until Linux/BSD Kernel Mode Setting takes over. With this change to GRUB, GRUB’s VGA mode switching is disabled. This might make a few Linux distro installer menus work a bit nicer.
mrc.binis in use; Haswell (T440p/W541) setups that don’t use
mrc.bin(and instead use Angel`s libre replacement code), it’s currently based on coreboot from mid-2022 because that’s what Angel’s as yet unmerged patches are based on (relative to coreboot’s master branch)
grub.cfg: 5 seconds boot delay, instead of 10 seconds.
NOTE: T440p/W541 images with
mrc.bin must be compiled from source. They were removed from the release, due to a bug reported in scripts used for preparing them post-build, when users install them. The bug was fixed in a revision after the release. If you still have those ROM images from prior to deletion, and want to use them, you should apply the following patch to your archive of the release, or just use latest
lbmk from the Git repository; see:
Pre-compiled ROM images will for the
w541mrc_12mb targets will be available in the next release; the
w541_12mb images are still available in this release, pre-compiled.
Upon testing, I’ve discovered that the libre code has the following problems:
Therefore, the libre MRC setup in this release, for T440p and W541 thinkpads, only provides SeaBIOS payload (booting in text mode, implying use of a bootloader that supports this, and if wanting xorg/wayland, a kernel that does kernel mode setting, which is most BSD/Linux setups these days).
In this release, and in the build system, the following targets are defined:
t440p_12mb: libre raminit code used (reverse engineered replacement of
w541_12mb: ditto (libre raminit code)
mrc.binused for raminit. GRUB and SeaBIOS payloads both supported.
mrc.binused for raminit. GRUB and SeaBIOS payloads both supported.
The libre raminit comes from this patchset:
The MRC blob (and Angel’s replacement code) don’t just do raminit, they handle a few other init tasks aswell, including USB host controller.
I bought these machines, which I’ve not added to the release but plan to add for the next release:
^ I would have put these in today’s release, but didn’t have time, and wanted to get this release done today.
The precise list of commits in
lbmk.git since the last release, is as follows:
* 07b6bb3d - build/release: handle nvmutil (12 hours ago) <Leah Rowe> * 653810b8 - fix bug: me not being downloaded on some boards (12 hours ago) <Leah Rowe> * 2bb63d85 - new board: lenovo/w530 (12 hours ago) <Leah Rowe> * 896e9065 - new board: lenovo/t530 (13 hours ago) <Leah Rowe> * cffa5679 - haswell (lenovo t440p/w541): fix S3 suspend/resume (14 hours ago) <Leah Rowe> * be3d7b7e - haswell: re-add mrc.bin in separate board configs (22 hours ago) <Leah Rowe> * bdc39ffc - haswell: only use txtmod seabios configuration (25 hours ago) <Leah Rowe> * df6b9e28 - remove t440p_12mb_cbfs4mb (retain t440_12mb) (25 hours ago) <Leah Rowe> * 04f1fe17 - remove x220_16mb (x220 with 16MB flash) (29 hours ago) <Leah Rowe> * 548872ce - haswell boards: use libre mrc.bin replacement (2 days ago) <Leah Rowe> * a942bd65 - move download/gitmodule script to root directory (2 days ago) <Leah Rowe> * 59540530 - nuke p2b_ls/p3b_f boards (2 days ago) <Leah Rowe> * ebd9ec96 - debian/ubuntu dependencies scripts: add gettext (3 days ago) <Leah Rowe> * f9e20b8a - util/nvmutil: optimise rhex() further (13 days ago) <Leah Rowe> * f04855c2 - fix flashrom download error (13 days ago) <Leah Rowe> * e2945f02 - payload/grub: force terminal_output to console (2 weeks ago) <Leah Rowe> * 909d3b31 - grub.cfg: set default timeout to 5 seconds (2 weeks ago) <Leah Rowe> * 544737c8 - scripts: build cbutils, not specific utils (2 weeks ago) <Leah Rowe> * 9398ad08 - also fix data.vbt path for lenovo/w541 (2 weeks ago) <Leah Rowe> * d2465e82 - Fix CONFIG_INTEL_GMA_VBT_FILE for the t440p_12mb config (2 weeks ago) <Konstantinos Koukopoulos> * 0e34d199 - update debian dependencies (for sid) (2 weeks ago) <Leah Rowe> * a5aa5bca - ICH9M: default to 256MB VRAM, not 352MB (2 weeks ago) <Leah Rowe> * 6421af5d - bump seabios revision (4 weeks ago) <Leah Rowe> * aba6307d - bump grub revision (4 weeks ago) <Leah Rowe> * 36982ab5 - fix bad ifdtool patch from earlier commit (4 weeks ago) <Leah Rowe> * 3857b4b6 - build/dependencies/debian: add python3 dependency (4 weeks ago) <Leah Rowe> * dac9ea86 - build/boot/roms: fail when build cbutils fails (4 weeks ago) <Leah Rowe> * 0d0f6cf3 - coreboot: update revision of cbtree "default" (4 weeks ago) <Leah Rowe> * dc1fedf9 - Merge branch 'uboot-v2023.01' of alpernebbi/lbmk into master (4 weeks ago) <Leah Rowe> |\ | * 7932d5fa - u-boot: Disable environment storage (5 weeks ago) <Alper Nebi Yasak> | * 8d57468e - u-boot: Update to v2023.01 (5 weeks ago) <Alper Nebi Yasak> |/ * 6b4a14ce - util/nvmutil: tidy up variable declarations (7 weeks ago) <Leah Rowe> * 031a0b55 - util/nvmutil: setWord(): declare variables first (7 weeks ago) <Leah Rowe> * 257eedca - util/nvmutil: reset errno if any write attempted (7 weeks ago) <Leah Rowe> * adc76e38 - util/nvmutil: do not write non-changes to disk (7 weeks ago) <Leah Rowe> * 3e150bf3 - util/nvmutil: cmd_swap(): write sequentually (7 weeks ago) <Leah Rowe> * 7e3a7355 - util/nvmutil: don't use malloc() (7 weeks ago) <Leah Rowe> * a924d43b - util/nvmutil: fix clang build errors (7 weeks ago) <Leah Rowe> * c822033b - util/nvmutil: simplify rhex() (7 weeks ago) <Leah Rowe> * 0f485245 - util/nvmutil: use gbe in word() and setword() (7 weeks ago) <Leah Rowe> * b1186968 - util/nvmutil: code cleanup (7 weeks ago) <Leah Rowe> * 7a986497 - util/nvmutil: call pledge() earlier, in main() (7 weeks ago) <Leah Rowe> * bb6fe263 - util/nvmutil: remove unused #define (7 weeks ago) <Leah Rowe> * 5a5a8662 - util/nvmutil: optimised disk reads (7 weeks ago) <Leah Rowe> * 24d56456 - util/nvmutil: optimise cmd_swap() (7 weeks ago) <Leah Rowe> * ef84329a - util/nvmutil: optimise rhex() for speed (7 weeks ago) <Leah Rowe> * 88a51531 - util/nvmutil: code cleanup in rhex() (7 weeks ago) <Leah Rowe> * ac1cab28 - x230edp_12mb: Correct the path to data.vbt (7 weeks ago) <Alexei Sorokin> * afc80b89 - util/nvmutil: update copyright years (9 weeks ago) <Leah Rowe> * 8242dca5 - util/nvmutil: limit bytes written per command (9 weeks ago) <Leah Rowe> * e398331b - util/nvmutil: make writeGbeFile more readable (9 weeks ago) <Leah Rowe> * 8dea350a - util/nvmutil: only write parts that are modified (9 weeks ago) <Leah Rowe> * d0fa08d5 - blobs/inject: fix wrong nvmutil path for make (10 weeks ago) <Leah Rowe> * e8072934 - Merge branch 'veyron-uboot-dmreset' of alpernebbi/lbmk into master (10 weeks ago) <Leah Rowe> |\ | * e11650c3 - u-boot: Enable DM_RESET for veyron boards (3 months ago) <Alper Nebi Yasak> * | 6b104542 - Merge branch 'peach-uboot-usbehci' of alpernebbi/lbmk into master (10 weeks ago) <Leah Rowe> |\ \ | |/ |/| | * 80bf54b2 - u-boot: Enable USB_EHCI_EXYNOS on peach boards (3 months ago) <Alper Nebi Yasak> |/ * 7f5dfebf - Do not rely on bashisms and behaviour undefined by the POSIX specification. Part 2 (3 months ago) <Ferass 'Vitali64' EL HAFIDI> * f7870446 - Do not rely on bashisms and behaviour undefined by the POSIX specification. (3 months ago) <Ferass 'Vitali64' EL HAFIDI> * d45b2e70 - util/nvmutil: use err() more consistently (3 months ago) <Leah Rowe> * d726b16f - util/nvmutil: more robust pointer handling (3 months ago) <Leah Rowe> * 448ee510 - util/nvmutil: optimise cmd_swap() further (3 months ago) <Leah Rowe> * effcb942 - util/nvmutil: greatly optimise cmd_copy() (3 months ago) <Leah Rowe> * 6e5828e4 - util/nvmutil: greatly optimise cmd_swap() (3 months ago) <Leah Rowe> * 7aafc62b - scripts/blobs/inject: fix bad cbfstool build check (3 months ago) <Leah Rowe> * 6ebd178f - util/nvmutil: simplified error handling in rhex() (3 months ago) <Leah Rowe> * 04da953c - util/nvmutil: return errno when calling err() (3 months ago) <Leah Rowe> * 00187811 - util/nvmutil: exit non-zero if close() fails (3 months ago) <Leah Rowe>
In general, you should also check the issue tracker to find other notes. There is always more work to do, to improve Libreboot.
STILL ON TODO SINCE LAST RELEASE.
This is another project that has been on hold for a while. The issue has been that I need a decent userland project. I’ve looked at many different userlands and since late June in 2022, decided to make my own. I want a BusyBox-like solution, but based on code from OpenBSD, ported to run under Linux with musl libc.
I want this distro to provide a kexec bootloader in flash, similar to Heads, and I also want it to use apk-tools, pointing at Alpine Linux repositories so as to allow any number of packages to be downloaded. It could also provide lots of utils in general, to be a live rescue system of sorts. Linux system in flash, that can bootstrap other systems.
About a week before this release, I actually started on the project for real, after having many false starts. I’ve forked a project called
lobase which already ports OpenBSD’s userland utilities to glibc under Linux, and it’s as of today about 5 years outdated based on OpenBSD 6.3.
I’ve ported these utilities directly from OpenBSD 7.2, in my local fork of lobase, superimposing the new code on top of the old and adapting according to musl libc (lobase is full of hacks for glibc that I don’t need):
I’ve been working on this in a dedicated Alpine Linux virtual machine, currently on release 3.17 of Alpine Linux. Alpine is an ideal test distro for such development, because it already uses musl libc and has libressl available in aports.
I don’t have enough to release yet, but when I have a release ready, I will upload it to a Git repository. When the userland port is fully complete, I shall then base off of Alpine Linux abuild+aports build system infrastructure to provide small base images. It will be similar to the Heads project, but built separately and not specifically targeted at Libreboot, but in general to any coreboot setup, on supported hardware. It won’t be a general purpose distro, but I would at that point submit my userland port to Alpine, proposing it as a replacement of their busybox package in base.
Unlike Heads, I don’t plan yet to make this a direct coreboot payload. Instead, it’ll be a standalone image loaded into CBFS, and chainloaded via the GRUB or SeaBIOS payloads, which are both capable of executing ELF binaries from the flash.
Lobase, which my development is forked from, can be found here (archived): https://github.com/Duncaen/lobase
I’ve been re-using lobase’s build system, adapting newer code from OpenBSD. It’s a lot of work, but I’m hopeful I can have this ready before the next Libreboot release.
STILL ON TODO SINCE LAST RELEASE.
GRUB is full of unused bloat that almost nobody uses, yet is in the current Libreboot builds. It’s been on TODO for some time, but work has not yet begun on this project. My efforts are currently focused on the Linux distro.
What I want is a fork of GRUB, optimized to run on bare metal as a coreboot payload, on x86 and ARM platforms.
I have an update since the last release. Paul Menzel of coreboot has made GRUB modules more configurable, making it possible to reduce the size of the payload. His patch is not yet used in Libreboot (not in this release, anyway), but the patch in GRUB is:
commit 6c5ee45548fcb65d7921c9fca5867b256f9a48ad Author: Paul Menzel <firstname.lastname@example.org> Date: Thu Mar 7 12:16:06 2019 +0100 Makefile: Allow to set file systems modules for default_payload.elf
I’m going to play around with this when I get the time. Even with this modification, GRUB is still full of code that Libreboot will never use. A GRUB Valhalla Rampage is still in order!
Markdown file for this page: https://libreboot.org/news/libreboot20230319.md
This HTML page was generated by the untitled static site generator.