"Release" means that a new coreboot git revision with substantially different code has been adapted for libreboot.
"Revision" means a modification to an existing release, where the result is insubstantially different from what preceded it.
The 1st, 2nd, 3rd and 4th releases were really just older revisions of the 5th release.
For historical reasons (and to avoid confusion), these are still called 'releases' instead of correcting the mistake.
If flashing on an X60 then note that you might want to enable wifi and trackpoint after booting libreboot the first time (meaning, **after** you powered off and subsequently booted again).
See docs/index.html#x60_wifi and docs/index.html#x60_trackpoint for how to do that.
Lenovo ThinkPad T60/T60p 14.1"/15.1"/15.4" with ATI GPU (all models)
Reasons are given in the documentation. If you have one of these machines,
then you can look at the documentation for how to remedy the situation (hardware modifications).
T60 15.1" QXGA (2048x1536) with Intel GPU currently does not show GRUB visually (the serial output works), although everything after GRUB is working.
A proposed (untested) workaround for GRUB is to lower the screen resolution for that machine (only in GRUB), or try to fix it (the current theory is that not enough memory is
allocated for the framebuffer; this is an issue to be dealt with in coreboot (the upstream provider) and not libreboot (the downstream provider)).
* T60 15.4" (1280x800 and 1680x1050) with Intel GPU is UNTESTED
T60 15.4" (1280x800 and 1680x1050) with Intel GPU is untested in this pre-release. Not much yet is known about panel names.
They will be tested at a later date.
* T60 (microcode): some CPU's might not work (can be replaced)
A user with 2 T60's, each with a Core 2 Duo T7200 processor tried libreboot on each machine.
One worked, one did not. It should be explained that in addition to the microcode (on the CPU),
updates are usually supplied in coreboot (from Intel) which patch the onboard microcode to fix bugs.
Errata's can be found at http://download.intel.com/design/mobile/SPECUPDT/30922214.pdf
and http://download.intel.com/design/mobile/SPECUPDT/31407918.pdf.
These microcode updates are not included in libreboot because they are proprietary (blobs). Most CPU's work fine without them: hundreds
of Core Duo T2300/T2400/T2500/L2300/L2400/L2500 processors have been tested on the X60, and a few T5600 CPU's have been tested on the T60 (and X60 and all work).
In the case of the T7200, it was found that one of the two tested had instability issues (kernel panics) without the updates: work is being done to find out
exactly what version of the microcode that particular CPU had in this case.
If you find that your CPU gives you similar issues (after trying libreboot), the current workaround is to simply try another CPU
(fortunately, the CPU's in the T60 are installed in a socket so replacing them is easy).
There might be a patched kernel that can be used, or a kernel parameter that can be used in GRUB to work around these (rare) buggy CPU's
(it is unknown at the moment whether this is possible).
The Core 2 Duo T7600 is untested, but will be tested soon (the lead developer of libreboot project has 3 of them to try out).
If reading this for 2nd beta, note that any debugging obtained so far will be included in the 3rd beta.
** Warning: MacBook2,1 UNTESTED!
At the time of this pre-release, MacBook2,1 support is present but untested. I have ordered a MacBook2,1
but it has not yet arrived at the time of writing.
I take it merely on faith that these images even work at all. Use at your own risk!
Machines no longer supported (compared to previous release):
All previous machines still supported!
Development notes
Initial release (new coreboot base, dated June 1st 2014. See 'getcb' script for reference)
DEBLOBBED coreboot
Removed the part from memtest86+ 'make' where it tried to connect to some scp server while compiling. (commented out line 24 in the Makefile)
X60 now uses a single .config (for coreboot)
X60 now uses a single grub.cfg (for grub memdisk)
X60 now uses a single grub.elf (payload)
Added new native graphics code for X60 (replaces the old 'replay' code) from Vladimir Serbinenko: 5320/9 from review.coreboot.org
T60 is now supported, with native graphics. (5345/4 from review.coreboot.org, cherry-picked on top of 5320/9 checkout)
Added macbook2,1 support (from Mono Moosbart and Vladimir Serbinenko) from review.coreboot.org (see 'getcb' script to know how that was done)
Documentation: added information linking to correct page and talking about which models are supported.
Added resources/libreboot/config/macbook21config
macbook21: Added 'build-macbook21' script and linked to it in 'build' (ROM's included under bin/macbook21/)
macbook21: Removed dd instructions from build-macbook21 script (macbook21 does not need bucts when flashing libreboot while Apple EFI firmware is running)
Documentation: Added macbook21 ROM's to the list of ROM's in docs/index.html#rom
Documentation: Write documentation linking to Mono Moosbart's macbook21 and parabola page (and include a copy)
Documentation: added a copy of Mono's Parabola install guide (for macbook21 with Apple EFI firmware) and linked in in main index.
Documentation: added a copy of Mono's Coreboot page (for macbook21) and linked it in main index.
T60: Copy CD option from the grub.cfg's for T60 *serial*.rom images into the grub configs for non-serial images. (T60's have CD/DVD drive on main laptop)
macbook21: remove options in build-macbook21 for *serial*.rom (there is no dock or serial port available for macbook21)
Added patches for backlight controls on X60 and T60 with help from Denis Carikli (see ./resources/libreboot/patch/gitdiff and ./getcb and docs/i945_backlight.html)
Documentation: added docs/i945_backlight.html showing how backlight controls were made to work on X60/T60
Documentation: Added info about getting LCD panel name based on EDID data.
Documentation: Added a link to this from the list of supported T60's and LCD panels for T60 (so that the user can check what LCD panel they have).
X60/T60: Merged patches for 3D fix (from Paul Menzel) when using kernel 3.12 or higher (see ./resources/libreboot/patch/gitdiff and ./getcb)
based on 5927/11 and 5932/5 from review.coreboot.org
Improved thinkpad_acpi support (from coreboot ): xsensors shows more information.
From 4650/29 in review.coreboot.org (merged in coreboot 'master' on June 1st 2014)
Merged changes for digitizer (X60 Tablet) and IR (X60 and T60) based on 5243/17, 5242/17 and 5239/19 from review.coreboot.org
(see ./resources/libreboot/patch/gitdiff and ./getcb)
Documentation: added information about building flashrom using 'builddeps-flashrom' script.
Re-created resources/libreboot/config/x60config
Re-created resources/libreboot/config/t60config
Added 'x60tconfig' in resources/libreboot/config (because X60 Tablet has different information about serial/model/version in 'dmidecode')
Added 'build-x60t' script
Updated 'build' script to use 'build-x60t'
Documentation: added to #config section the section #config_x60t (libreboot configuration and dmidecode info)
Documentation: added x60t ROM's to the list of ROM's
Tidied up the 'builddeps' script (easier to read)
Tidied up the 'cleandeps' script (easier to read)
Annotated the 'buildall' script
Added 'getcb' script for getting coreboot revision used from git, and patching it.
Added 'getgrub' script for getting the GRUB revision used from git, and patching it.
Added 'getmt86' script for getting the memtest86+ version used, and patching it.
Added 'getbucts' script for getting the bucts version used.
Added 'getflashrom' script for getting the flashrom version used, and patching it
Added 'getall' script which runs all of the other 'get' scripts.
Add instructions to the 'build' script to prepare libreboot_meta.tar.gz
New archive: libreboot_meta.tar.gz - minimal archive, using the 'get' scripts to download all the dependencies (coreboot, memtest, grub and so on).
Documentation: added information about where 'build' script prepares the libreboot_meta.tar.gz archive.
Documentation: added information about how to use the 'get' scripts in libreboot_meta.tar.gz (to generate libreboot_src.tar.gz)
Documentation: mention that meta doesn't create libreboot_src/ directory, but that libreboot_meta itself becomes the same.
Documentation: advise to rename libreboot_meta to libreboot_src after running 'getall'.
Annotated the 'builddeb' script, to say what each set of dependencies are for.
Separated bucts/flashrom builddeb sections into separate scripts: builddeb-flashrom, builddeb-bucts.
Documentation: Updated relevant parts based on the above.
Added instructions to 'build' script for including builddeb-bucts and builddeb-flashrom in libreboot_bin
Updated flashrom checkout (r1822 2014-06-16) from SVN (http://flashrom.org/Downloads).
Updated flashing instructions in docs/index.html for new commands needed (Macronix chip on X60/T60)
For X60/T60 (flashrom): Patched flashchips.c_lenovobios_macronix and flashchips.c_lenovobios_sst executables for SST/macronix (included in resources/flashrom/patch)
Updated builddeps to build flashrom_lenovobios_sst and flashrom_lenovobios_macronix, for X60/T60 users with Lenovo BIOS
moved the flashrom build instructions from 'builddeps' and put them in 'builddeps-flashrom', excecuting that from 'builddeps'.
Added builddeps-flashrom to libreboot_bin.tar.gz
flashrom: added patched flashchips.c to resources/flashrom/patch (automatically use correct macronix chip on libreboot, without using '-c' switch)
removed 'MX25L1605' and 'MX25L1605A/MX25L1606E' entries in flashchips.c for the patched version of flashchips.c
added instructions to 'builddeps-flashrom' to automatically use this modified flashchips.c in the default build
Added builddeb to libreboot_bin.tar.gz
Moved 'bucts' build instructions from builddeps to builddeps-bucts
builddeps now runs 'builddeps-bucts' instead
Added 'builddeps-bucts' to libreboot_bin.tar.gz
Documentation: Added information about using 'builddep-bucts' to build the BUC.TS utility.
Added 'lenovobios_firstflash' and 'lenovobios_secondflash' scripts
Added instructions to 'build' script for including those files in libreboot_bin
Documentation: Add tutorial for flashing while Lenovo BIOS is running (on X60/T60)
Added 'flash' script (make sure to run builddeps-flashrom first) which (while libreboot is already running) can use flashrom to flash a ROM
updated 'build' script to include the 'flash' script in libreboot_bin.tar.gz
Documentation: replaced default flashrom tutorial to recommend the 'flash' script instead.
Re-add cbfstool source code back into libreboot_bin.tar.gz, as cbfstool_standalone
Patched that version to work (able to be built and used) without requiring the entire coreboot source code.
Created patched version of the relevant source files and added it into resources/cbfstool/patch
see coreboot/util/cbfstool/rmodule.c and then the patched version in resources/cbfstool/patch/rmodule.c
see coreboot/src/include/rmodule-defs.h and the rule in 'build' for including this in ../libreboot_bin/cbfstool_standalone
Added instructions to 'build' script for applying this patch to the cbfstool_standalone source in libreboot_bin
Added instructions to 'build' script for then re-compiling cbfstool_standalone in libreboot_bin after applying the patch
Added a 'builddeps-cbfstool' script (in src, but only used in bin and put in bin by 'build') that compiles cbfstool_standalone in libreboot_bin (make), moves the cbfstool and rmodtool binaries into libreboot_bin/ and then does 'make clean' in libreboot_bin/cbfstool_standalone
Updated the 'build' script to put 'builddeps-cbfstool' in libreboot_bin
Updated the 'build' script in the cbfstool (standalone) part to accomodate the above.
Documentation: added notes about cbfstool (standalone) in libreboot_bin
Documentation: made docs/howtos/grub_cbfs.html slightly easier to follow.
Annotate the 'build*' scripts with 'echo' commands, to help the user understand what it actually happening during the build process.
Documentation: added information about how 'dmidecode' data was put in the coreboot configs
Documentation: In fact, document how the 'config' files in resources/libreboot/config/ were created
Documentation: Added information about which ThinkPad T60's are supported, and which are not.
Documentation: added information about LCD inverters (for upgrading the LCD panel on a T60 14.1' XGA or 15.1' XGA)
it's FRU P/N 41W1478 (on T60 14.1") so this was added to the docs.
it's P/N 42T0078 FRU 42T0079 or P/N 41W1338 (on T60 15.1") so this was added to the docs.
Documentation: added information about names of LCD panels for T60 to the relevant parts of the documentation.
Documentation: added information (with pictures) about the differences between T60 with Intel GPU and T60 with ATI GPU.
Documentation: added pictures of keyboard layouts (US/UK Qwerty/Dvorak) to the ROM list, to let the user compare with their own keyboard.
Move the coreboot build instructions in 'builddeps' into 'builddeps-coreboot' and link it in 'builddeps'
Link to 'builddeps-coreboot' in final stage of 'getcb'
Move GRUB build instructions from 'builddeps' into 'builddeps-grub', link from 'builddeps'
Link to 'builddeps-grub' in final stage of 'getgrub'
Move MemTest86+ build instructions from 'builddeps' into 'builddeps-memtest86', link from 'builddeps'
Link to 'builddeps-memtest86' in final stage of 'getmt86'
made 'build' script put resources/ directory in libreboot_bin, to make builddeps-flashrom work in libreboot_bin
Removed instructions for building source code in the 'get' script (they don't really belong there)
Added libfuse-dev and liblzma-dev to the list of GRUB dependencies in 'builddeb' script.
Converted the 'RELEASE' file to 'docs/RELEASE.html'
Added those dependencies to builddeb script (for GRUB part): gawk libdevmapper-dev libtool libfreetype6-dev
Added to build script the instruction at the end to create a sha512sum.txt with a file manifest plus checksums.
Deleted the RELEASE and BACKPORT files (no longer needed)
Documentation: added information about X60/T60 dock (ultrabase x6 and advanced mini dock) to relevant sections.
Added to docs/index.html#serial
Revisions for 2nd beta (2014 July 16th)
Deleted all git-related files from the coreboot directory. This was necessary because
with those it is possible to run 'git diff' which shows the changes made in the form
of a patch (diff format); this includes the blobs that were deleted during deblobbing.
Revisions for 3rd beta (2014 July 20th)
Fixed typo that existed in 2nd beta where the release date of the 2nd beta was listed as being in year 2016, when in actual fact it was 2014.
Documentation: added (preliminary) details about (rare) buggy CPU's on the ThinkPad T60 that were found to fail (instability, kernel panics, etc)
without the microcode updates.
Documentation: added docs/howtos/x60_heatsink.html for showing how to change the heatsink on the Thinkpad X60
Added ROM images for Azerty (French) keyboard layout in GRUB (courtesy of Olivier Mondoloni)
Tidied up some scripts:
Re-factored those scripts (made easier to read/maintain): build-x60, build-x60t, build-t60, build-macbook21
Reduced the number of grub configs to 2 (or 1, for macbook21), the build scripts now generate the other configs at build time.
Deleted build-x60, build-x60t, build-t60, build-macbook21 and replaced with intelligent (generic) buildrom-withgrub script
Updated build to use buildrom-withgrub script for building the ROM images.
coreboot.rom and coreboot_serial.rom renamed to coreboot_usqwerty.rom and coreboot_serial_usqwerty.rom
coreboot_dvorak and coreboot_serial_dvorak.rom renamed to coreboot_usdvorak.rom and coreboot_serial_usdvorak.rom
Renamed coreboot*rom to libreboot*rom
Made flash, lenovobios_firstflash and lenovobios_secondflash scripts fail if the specified file does not exist.
Updated all relevant parts of the documentation to reflect the above.
Replaced background.png with background.jpg. added gnulove.jpg. (resources/grub/background/)
Updated buildrom-withgrub to use background.jpg instead of background.png
Updated buildrom-withgrub to use gnulove.jpg aswell
Updated resources/grub/macbook21/grub*cfg to use gnulove.jpg background.
Updated resources/grub/{x60,t60,x60t}/grub*cfg to use background.jpg background.
Documentation: updated docs/index.html#grub_custom_keyboard to be more generally useful.
nvramtool:
Updated builddeps-coreboot script to build it
Updated build script to include it in libreboot_bin
Documentation: added docs/howtos/x60_security.html (security hardening for X60)
Other tasks (to be completed before declaring the initial stable release)
TODO: Re-tooled linux-libre deblob scripts for use with coreboot. Deblobbing is already complete; completion of this additional task will simply make future deblobbing work easier.
TODO: Modified coreboot to make wifi and trackpoint be enabled by default on the ThinkPad X60 (so no need for nvramtool)
TODO: added this to gitdiff file.
(Remove from or add comment in the documentation the notes about disabling wifi/trackpoint)
TODO: T60: find (for rare buggy CPU's that are unstable without microcode updates) if there is a workaround (patched kernel, special parameter, etc)
TODO: Modify coreboot so that tft_brightness is 0xff by default (for fixing the looping issue automatically)
TODO: Modify the Kconfig options in coreboot so that the (non-existent, deleted) microcode is never loaded when building.
TODO: Ask Mono what license he wants to use for his pages (see notes in docs/index.html#macbook21) and then include a copy in the relevant part of the documentation. (note: the backups are not included for now, for this exact reason)
TODO: Retroactively GPG-sign the final revisions of each previous release. (SHA512 sums aswell).
TODO: For the gitdiff in resources/libreboot/patch, re-implement those changes as actual commits in git, using separate patch files for each change.
TODO: Made the lenovobios_firstflash and lenovobios_secondflash scripts safer to use (checking for unintended errors, bad checksums and so on)
TODO: Tested all of the remaining untested LCD panels under docs/index.html#supported_t60_list
TODO: macbook21: from what I can tell, macbook21 has no dock or serial. investigate usbdebug and spkmodem option.
TODO: Documentation: macbook2,1: Show how to physically remove the built-in webcam (which doesn't work unless you install a non-free driver)
TODO: Documentation: macbook2,1: Check if there is another webcam to replace it that can work without requiring any non-free drivers.
TODO: T60 15" QXGA (2048x1536): fixed issue where GRUB wouldn't show any graphics.
It might be the same issue I ran into with Paul on the X60 (not enough memory being allocated) since the same code works on T60 SXGA+ and UXGA, where GRUB actually display graphics.
This should be done in coreboot and backported into libreboot. See 5320 and 5345 on review.coreboot.org
For now, see if lowering GRUB's resolution works (as a workaround) since everything (GNU/Linux) works after that.
TODO: Documentation: added as many links as I could find, to datasheets and schematics for macbook21/x60/t60 (i945 chipset, EC info for x60/t60/macbook21)
TODO: Go over the documentation, and find the parts that are not accessible: eg, improve the docs to be friendly for colour-blind people.
TODO: the X60 unbricking tutorial could use some work. It currently has lots of red and green, for instance. Consider highlighting specific parts of pictures in bold zig-zagged white lines instead of straight red lines.
TODO: Documentation: Added (replicated) the same level of logs (from default firmware) that Mono did for macbook21, for t60/x60/x60t
TODO: Documentation: Write documentation showing how to install a GNU/Linux distribution on a macbook2,1 while stock (non-free) firmware is running.
TODO: macbook21: Added script 'macbook21_firstflash' for flashing libreboot while Apple EFI firmware is running.
TODO: Documentation: macbook21: added software-based flashing instructions for flashing libreboot while Apple EFI firmware is running.
TODO: Documentation: updated the X60 unbrick tutorial to use the 5-pin method instead (safer / less dangerous).
TODO: Documentation: added unbricking tutorial for T60
TODO: Documentation: Advise what parts of the unbricking tutorial to follow (or skip) for replacing motherboard
TODO: Documentation: X60/T60: added information about checking custom ROM's using dd to see whether or not the top 64K region is duplicated below top or not. Advise caution about this in the tutorial that deals with flashing on top of Lenovo BIOS, citing the correct dd commands necessary if it is confirmed that the ROM has not been applied with dd yet. (in the case that the user compiled their own ROM's from libreboot, without using the build scripts, or if they forgot to use dd, etc).
TODO: Documentation: Add a "development guide" for how to maintain libreboot ('get' scripts, deblob scripts, associated files under ./resources and so on)
TODO: Investigate high boot speeds on X60/T60/macbook21
"set pager=1" is set in grub.cfg, for less-like functionality
The "Parse" options read ./isolinux/isolinux.cfg on a CD or USB,
and automatically converts it to a grub config and switches to the boot menu of that distro.
This makes booting ISO's *much* easier than before.