Libreboot release information

Documentation for this release can be found at index.html. Updated versions of libreboot can be found at libreboot.org.

Old Releases

See archive_old.html for information about older libreboot releases.

See tasks for the current TODO list.

Release YYYYMMDD

Release date: Month Day(st,rd,th), Year.

Installation instructions can be found at install/index.html. Building instructions (for source code) can be found at git/index.html#build.

Machines supported in this release:

ThinkPad X60/X60s
- You can also remove the motherboard from an X61/X61s and replace it with an X60/X60s motherboard. An X60 Tablet motherboard will also fit inside an X60/X60s.
ThinkPad X60 Tablet (1024x768 and 1400x1050) with digitizer support
- See hcl/index.html#supported_x60t_list for list of supported LCD panels
- It is unknown whether an X61 Tablet can have it's mainboard replaced with an X60 Tablet motherboard.
ThinkPad T60 (Intel GPU) (there are issues; see below):
- See notes below for exceptions, and hcl/index.html#supported_t60_list for known working LCD panels.
- It is unknown whether a T61 can have it's mainboard replaced with a T60 motherboard.
- See future/index.html#t60_cpu_microcode.
- T60P (and T60 laptops with ATI GPU) will likely never be supported: hcl/index.html#t60_ati_intel
ThinkPad X200
- X200S and X200 Tablet are also supported, conditionally; see hcl/x200.html#x200s
- ME/AMT: libreboot removes this, permanently. hcl/gm45_remove_me.html
ThinkPad R400
- See hcl/r400.html
- ME/AMT: libreboot removes this, permanently. hcl/gm45_remove_me.html
ThinkPad T400
- See hcl/t400.html
- ME/AMT: libreboot removes this, permanently. hcl/gm45_remove_me.html
ThinkPad T500
- See hcl/t500.html
- ME/AMT: libreboot removes this, permanently. hcl/gm45_remove_me.html
Apple MacBook1,1 (MA255LL/A, MA254LL/A, MA472LL/A)
- See hcl/index.html#macbook11.
Apple MacBook2,1 (MA699LL/A, MA701LL/A, MB061LL/A, MA700LL/A, MB063LL/A, MB062LL/A)
- See hcl/index.html#macbook21.

Git. No changelog!

This version of libreboot is from git. It is not a stable release! If you are using a snapshot (tarball), you can find a file included called commitid which tells you what git revision it is from the libreboot git repository. If this is not a snapshot, then you have cloned libreboot, so you can simply run git log.

Did we forget to mention that this is from git?
This is from the libreboot git repository.

Tasks for future release

Board ports

Port to as many GM45 laptops as possible
- add roda rk9 support (contact nico to ask for more details about hw). This is GM45 but these machines do not have a descriptor (no ME), should be easy
  - This board lacks native graphics initialization (it should be easy to add in Kconfig files, but it has to be tested beforehand)
- ThinkPad R500: http://projects.mtjm.eu/work_packages/43
- port acer aspire 5738 to coreboot (gm45)? (and then libreboot). EC is the main blocker (no support in coreboot yet). ME isn't an issue, because its GM45 so it could be removed (it looks like this machine might also be shipped in non-descriptor mode by default, like the roda rk9). Search jv50 block diagram filetype:pdf for schematics. (jv50 is written on the board); noone seems to have found any documentation for the EC chip, but maybe it could be sufficiently reverse engineered via serialice and ectool.
- T400S and X301. These both seem to be GS45. X301 uses only the low-performance mode CPUs, so raminit is the main blocker there. They both probably use WSON-8 flash chips.
- Add proper GS45 raminit for enabling all X200S and X200 Tablets to work properly. (maybe other machines) See hcl/x200.html#x200s_raminit
Look into those machines:
- ThinkPad X201 - ME ignition is an issue. Watchdog for ME is an issue. Might be possible to disable watchdog in the flash descriptor (soft straps).
- T410S is supported but not yet merged. This uses the same chipset as the X201. http://review.coreboot.org/#/c/7975/ has the patch. This should be tested by someone and should ideally be merged in coreboot. pecg has one. help him.
- This page contains a list of basically every thinkpad that would ever be a candidate for libreboot: http://psref.lenovo.com/WithdrawnBook - take a look at this PDF.
- Lenovo G505S (works without microcode updates). Video BIOS is an issue (unfinished replacement: openatom), as is the SMU firmware (ruik will know more). Other non-essential blobs may also still be present (but possible to remove)
- HP Pavillion 1035DX (same chipset as G505S. See notes above)
- F2A85-M and E350M1 (libreboot_*_headless.rom). Test openatom (video BIOS replacement). SMU firmware is a problem. XHCI firmware is a problem.

Platform-specific bugs

HIGH PRIORITY! Fix these issues on GM45/GS45 targets:
- X200: text-mode is broken. only framebuffer graphics work. Commit bde6d309dfafe58732ec46314a2d4c08974b62d4 in coreboot is what broke it. Investigate.
- Sound (internal speaker) worked on the T500, but stopped after all subsequent boots. (might just be this machine). investigate. (external speaker works)
Finish all work listed in future/index.html
Fix these issues on i945 targets (X60/T60/macbook21)
- HIGH PRIORITY! i945: Linux 3.19 doesn't boot. UPDATE: Patch to fix it is on linux bug tracker (see below), we are waiting for it to merge in linux upstream/mainline. For now, we are getting this patch into the GNU/Linux distros typically used with libreboot. (also affects T60/macbook21). Preliminary bug report (kernel, linux) pstuge said http://biosbits.org/ patricg says https://wiki.ubuntu.com/HardwareEnablementTeam/Documentation/FirmwareTestSuiteLive
  - It's commit aaecdf61 (drm/i915: Stop gathering error states for CS error interrupts) in linux that introduced the regression
  - This patch linked on the bug report page above: https://bugzilla.kernel.org/attachment.cgi?id=172941 - fixes the problem, and makes the i945 laptops boot up again.
    - Parabola has temporarily merged it in a kernel update - when it's merged upstream, let Emulatorman know (#parabola on IRC freenode)
    - So has Guix - when it's merged upstream, let mark_weaver know (#guix on IRC freenode)
    - Still waiting for jxself to merge it in freesh (as a temporary stop gap, until the patch lands in linux upstream/mainline)
  - Since 3.19, there are still some warning messages now, after applying the patch. See Mono's comments on the bug report page - https://bugzilla.kernel.org/show_bug.cgi?id=93171#c27
  - TODO: this fix in linux is a workaround, the real bug is in coreboot. (without the patch, 3.19/higher doesn't boot on coreboot/libreboot i945 with native graphics, but does boot on lenovobios with 3.19/higher - it probably also boots with coreboot+vgarom, since the bug is in the video init code.
- i945: fix VRAM size (currently 8MB. should be 64MB). See future/index.html#i945_vram_size.
- Fix remaining incompatible LCD panels in native graphics on T60. See future/index.html#lcd_i945_incompatibility.
- i945: the intel video driver used to initialize the display without native graphics initialization and without the extracted video BIOS. It no longer does, so investigate why it does not, and fix the regression (fix has to be done in the kernel, Linux). See http://www.coreboot.org/pipermail/coreboot/2014-June/078104.html and http://www.coreboot.org/pipermail/coreboot/2014-June/078105.html
- Add fake_vbt tables on i945 machines (also GM45).
- Commit 26ca08caf81ad2dcc9c8246a743d82ffb464c767 in coreboot, see the while (1) loop that waits for the panel to power up on i945. This is an infinite loop if the panel doesn't power up. Fix it. Also, are there panels that don't power up? Test this, and fix it.

Payloads

Add ProteanOS payload to machines with big enough flash chips. (eg X200/R400). This page (outdated, but still useful according to the maintainer) has some info: http://www.proteanos.com/doc/plat/porting/. pehjota says that once the port is done, prokit can be modified to generate the entire distribution as a vmlinuz and initrd.img file.
Related to MemTest86+:
- Todo: modify memtest86+ to work with libpayload (coreboot framebuffer) and delete all the text-mode ROM images. See http://projects.mtjm.eu/work_packages/17

Build system

HIGH PRIORITY! Make memtest86+ build using coreboot's own crossgcc toolchain. Currently, memtest86+ doesn't even work at all when cross-compiled using the toolchain in x86-64 trisquel7
Make libreboot (all of it!) build reproducibly. This is very important. See http://projects.mtjm.eu/work_packages/16.
build/release/archives currently fails on Parabola (it only works well in Trisquel). That script is buggy, and full of ugly hacks anyway, so re-write it and make it modular/portable this time.
Reduce the size of libreboot releases. See http://projects.mtjm.eu/work_packages/19
- Proposal: unify ROM images (don't duplicate). See http://projects.mtjm.eu/work_packages/20.
Make GRUB build using coreboot's own crossgcc toolchain
Delete all parts of coreboot that libreboot doesn't use. For instance, delete boards that aren't used in libreboot. This will reduce the size of the source tarballs considerably.

Improvements to the utilities

Make ich9gen/ich9deblob portable. They both rely extensively on bitfields, and they assume little-endian; for instance, mapping a little endian file directly to a struct, instead of serializing/deserializing. Re-factor both utilities and make them fully portable. See http://projects.mtjm.eu/work_packages/18
Adapt linux-libre deblob scripts for use with coreboot. Libreboot is already deblobbed using its own script, but updating it is still a bit too manual. linux-libre's deblob scripts do an excellent job and (adapted) will make it much easier to maintain coreboot-libre.
Add a whitelist entry to board_enable.c in flashrom, for the ThinkPad R400 and T400
Improve the deblobbing scripts (see http://projects.mtjm.eu/work_packages/40)
- .spd.hex files. These aren't blobs? Don't remove them? (in coreboot). See deblob script. Categorize blobs and non-blobs more clearly, explaining what they are for and why they are (or are not) blobs.

Documentation improvements

HIGH PRIORITY! Add information from hw registers on all boards. See http://projects.mtjm.eu/work_packages/15
- We currently have them for X200 (4MiB flash chip), T400 but not complete
- Get them for more boards:
  - X60
  - T60
  - macbook21
  - X200 (make sure to have it for both flash chip sizes)
  - R400 (make sure to have it for both flash chip sizes)
  - T400 (make sure to have it for both flash chip sizes)
  - T500 (make sure to have it for both flash chip sizes)
Add guides for GM45 laptops in docs/security/
Add guides for GM45 laptops in docs/hardware/
Convert documentation to Sphinx/ReST See http://projects.mtjm.eu/work_packages/5 and http://projects.mtjm.eu/work_packages/12
Maintainence manual. How to contribute to libreboot. See http://projects.mtjm.eu/work_packages/11
Add cubieboard SPI flashing instructions to libreboot. mrnuke's github page with patches. mrnuke in IRC knows about the cubieboard
LUKS key in initramfs: Add Trisquel documentation for docs/gnulinux/encrypted_trisquel.html. See http://projects.mtjm.eu/work_packages/39
image, image, image - work with mrnuke on getting info about vultureprog PLCC flashing into libreboot. Libreboot needs server boards. https://github.com/mrnuke/vultureprog, https://github.com/mrnuke/qiprog, https://github.com/mrnuke/vultureprog-hardware. He also uses the sigrok logic analyzer (free/libre): http://www.dx.com/p/logic-analyzer-w-dupont-lines-and-usb-cable-for-scm-black-148945

Project (institutional) improvements

HIGH PRIORITY! Libreboot needs to be factory firmware, not the replacement. It needs to be *the* firmware. Consult with the openlunchbox project (and maybe others) on getting hardware manufactured with libreboot support (out of the box, from the factory).
Look into the possibility of expanding libreboot to support non-coreboot systems. (u-boot, for instance). Currently, libreboot presents itself as a deblobbed coreboot distribution. There are other systems out there that use other firmware, such as u-boot, which libreboot could theoretically support. This would mean that the build scripts know how to build things other than just coreboot/grub.
- Allwinner A10 (ARM) SoCs
- PMON?
- barebox (u-boot derivative)
- etc
- http://zedboard.org/product/zedboard might be a candidate, according to the main developer of openlunchbox.
Set up a routine (project-wise) for testing each machine with the latest kernel version. See http://projects.mtjm.eu/work_packages/22 and http://projects.mtjm.eu/work_packages/21

EC firmware

http://www.coreboot.org/Embedded_controller Replace this on all libreboot targets. Some laptops use an extra SPI flash chip for the EC, some have EC in the main chip, some don't use SPI flash at all but have the firmware inside the EC chip itself. If the EC has integrated flash then you need to be able to get to the pins on the chip or be able to program them over LPC or SPI (if they have that feature). The lenovo laptops currently supported in libreboot all use H8 EC chips (contains flash inside the chip). Read the datasheets on how to externally programme the EC. Chromebooks seem to have free EC (https://chromium.googlesource.com/chromiumos/platform/ec/+/master/chip/).

Back to top of page.

Copyright © 2014, 2015 Francis Rowe <info@gluglug.org.uk>
This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions. A copy of the license can be found at license.txt.

This document is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See license.txt for more information.