From 488242eb941305ef61319b8499d4a1e8ccf218a1 Mon Sep 17 00:00:00 2001 From: Francis Rowe Date: Sun, 20 Jul 2014 03:37:00 -0400 Subject: Libreboot release 6 beta 3. - 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/config/macbook21/grub*cfg to use gnulove.jpg background. - Updated resources/grub/config/{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) --- (limited to 'docs/index.html') diff --git a/docs/index.html b/docs/index.html index 8e8f2de..37fdd38 100644 --- a/docs/index.html +++ b/docs/index.html @@ -61,6 +61,8 @@
  • List of supported ThinkPad T60's
  • Inverter boards for ThinkPad T60 when upgrading the LCD panel.
  • ThinkPad T60 (ATI GPU) and ThinkPad T60 (Intel GPU) differences.
    • +
  • ThinkPad X60: change the fan/heatsink
    • +
  • ThinkPad X60: security

    • Macbook2,1

    @@ -92,13 +94,15 @@
  • QWERTY (United States)
  • Dvorak (United Kingdom)
  • Dvorak (United States)
    • +
  • AZERTY (French)
  • Custom keyboard layout in GRUB
  • US Qwerty keyboard layout in GRUB
  • UK Qwerty keyboard layout in GRUB
  • US Dvorak keyboard layout in GRUB
    • -
  • UK Dvorak layout in GRUB
    • +
  • UK Dvorak keyboard layout in GRUB
    • +
  • FR AZERTY keyboard layout in GRUB
    • @@ -301,7 +305,7 @@

    - ThinkPad X60 configuration (file: resources/libreboot/config/x60config) + ThinkPad X60 configuration (file: resources/libreboot/config/x60/config)

    - The resulting .config file was saved as resources/libreboot/config/x60config and is used by the build + The resulting .config file was saved as resources/libreboot/config/x60/config and is used by the build scripts for this machine.

    @@ -340,7 +344,7 @@

    - ThinkPad X60 Tablet configuration (file: resources/libreboot/config/x60tconfig) + ThinkPad X60 Tablet configuration (file: resources/libreboot/config/x60t/config)

    - The resulting .config file was saved as resources/libreboot/config/x60config and is used by the build + The resulting .config file was saved as resources/libreboot/config/x60t/config and is used by the build scripts for this machine.

    @@ -375,7 +379,7 @@

    - ThinkPad T60 configuration (file: resources/libreboot/config/t60config) + ThinkPad T60 configuration (file: resources/libreboot/config/t60/config)

    - The resulting .config file was saved as resources/libreboot/config/t60config and is used by the build + The resulting .config file was saved as resources/libreboot/config/t60/config and is used by the build scripts for this machine.

    @@ -409,7 +413,7 @@

    - MacBook2,1 configuration (file: resources/libreboot/config/macbook21config) + MacBook2,1 configuration (file: resources/libreboot/config/macbook21/config)

    - The resulting .config file was saved as resources/libreboot/config/macbook21config and is used by the build + The resulting .config file was saved as resources/libreboot/config/macbook21/config and is used by the build scripts for this machine.

    @@ -531,6 +535,30 @@ +
    +

    + 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. +

    +
    +

    To find what LCD panel you have, see: #get_edid_panelname.

    @@ -785,6 +813,10 @@

    + There is a 15.4" T60 with Intel graphics, which might work. (untested at the time of writing). Note to self: REMOVE THIS WHEN TESTED. +

    + +

    The following T60 motherboard shows an ATI GPU (do not buy this) (highlighted in red, or on the right next to the white CPU socket), which is unsupported by libreboot:

    @@ -900,55 +932,62 @@
  • ThinkPad X60, X60s (bin/x60/)
  • ThinkPad X60 Tablet (bin/x60t/)
  • ThinkPad T60 (bin/t60/) (note, see #supported_t60_list)
  • MacBook2,1 (bin/macbook21/)

    • - This will give you your native keyboard layout in GRUB. The preferences in your OS are not affected, it just makes using + This will give you your native keyboard layout inside GRUB. The preferences in your OS are not affected, it just makes using the GRUB command line easier (if you ever need to do that). #grub_keyboardshows you how this was done. If your native keyboard layout differs, you can adapt those notes and hack the 'build' script for your needs. @@ -981,8 +1020,6 @@ -

    (the above message is a lot more benign and a lot less scary than it looks)

    -

    This is for the ThinkPad X60 and T60 while running Lenovo BIOS. If you already have coreboot or libreboot running, then go to #flashrom instead!

    @@ -1025,12 +1062,27 @@

    - If the above is what you see, then SHUT DOWN. Wait a few seconds, and then boot; libreboot is running, but there is a 2nd procedure needed (see below). + If the above is what you see, then SHUT DOWN. Wait a few seconds, and then boot; libreboot is running, but there is a 2nd procedure *needed* (see below).

    + + If you boot and you see nothing, try turning up the backlight (Fn+Home). + If this is a ThinkPad X60 and backlight resets to zero when turning it up while at max, look at #tft_brightness. + +

    + +

    + + After the 2nd flash, if this is a ThinkPad X60 then you can look at #x60_wifi for how to enable/disable wifi. + You can also look at #x60_trackpoint for how to enable/disable the trackpoint (red mouse on keyboard). + You might want to do the 2nd flash first (see below) before doing that. + +

    + +

    When you have booted up again:
    $ sudo ./lenovobios_secondflash bin/YOURBOARD/YOURROM

    @@ -1051,10 +1103,6 @@ -

    - !!!! -

    -

    Back to top of page.

    @@ -1094,6 +1142,20 @@ after you see this, and then boot up again after a few seconds.

    +

    + + If you boot and you see nothing, try turning up the backlight (Fn+Home). + If this is a ThinkPad X60 and backlight resets to zero when turning it up while at max, look at #tft_brightness. + +

    + +

    + + If this is a ThinkPad X60 then you can look at #x60_wifi for how to enable/disable wifi. + You can also look at #x60_trackpoint for how to enable/disable the trackpoint (red mouse on keyboard). + +

    +

    Back to top of page

    @@ -1135,35 +1197,64 @@

    Taken from WikiPedia. - See https://en.wikipedia.org/wiki/Dvorak_Simplified_Keyboard - and https://en.wikipedia.org/wiki/QWERTY. + See https://en.wikipedia.org/wiki/Dvorak_Simplified_Keyboard, + https://en.wikipedia.org/wiki/QWERTY + and https://en.wikipedia.org/wiki/AZERTY.

    QWERTY (United Kingdom)

    -

    - https://upload.wikimedia.org/wikipedia/commons/thumb/d/da/KB_United_Kingdom.svg/900px-KB_United_Kingdom.svg.png -

    +

    + https://upload.wikimedia.org/wikipedia/commons/thumb/d/da/KB_United_Kingdom.svg/900px-KB_United_Kingdom.svg.png +

    QWERTY (United States)

    -

    - https://upload.wikimedia.org/wikipedia/commons/thumb/5/51/KB_United_States-NoAltGr.svg/900px-KB_United_States-NoAltGr.svg.png -

    +

    + https://upload.wikimedia.org/wikipedia/commons/thumb/5/51/KB_United_States-NoAltGr.svg/900px-KB_United_States-NoAltGr.svg.png +

    Dvorak (United Kingdom)

    +

    + https://upload.wikimedia.org/wikipedia/commons/thumb/c/cc/KB_United_Kingdom_Dvorak.svg/900px-KB_United_Kingdom_Dvorak.svg.png +

    + +

    Dvorak (United States)

    +

    + https://upload.wikimedia.org/wikipedia/commons/thumb/2/25/KB_United_States_Dvorak.svg/800px-KB_United_States_Dvorak.svg.png +

    + +

    AZERTY (French)

    +

    + https://upload.wikimedia.org/wikipedia/commons/thumb/b/b9/KB_France.svg/800px-KB_France.svg.png +

    + +

    Back to top of page

    + +

    Custom keyboard layout in GRUB (for reference)

    +

    - https://upload.wikimedia.org/wikipedia/commons/thumb/c/cc/KB_United_Kingdom_Dvorak.svg/900px-KB_United_Kingdom_Dvorak.svg.png + Keymaps are stored in resources/grub/keymap/original (original files) and resources/grub/keymap (.gkb files).

    -

    Dvorak (United States)

    - https://upload.wikimedia.org/wikipedia/commons/thumb/2/25/KB_United_States_Dvorak.svg/800px-KB_United_States_Dvorak.svg.png + Example (French Azerty):
    + $ ckbcomp fr > frazerty

    + Go in grub directory:
    + cat frazerty | ./grub/grub-mklayout -o frazerty.gkb

    -

    Back to top of page

    +

    + You must make sure that the files are named keymap and keymap.gkb (where 'keymap' can be whatever you want). +

    -

    Custom keyboard layout in GRUB (for reference)

    +

    + Then from the above example, you would put frazerty in resources/grub/keymap/original/ and + the frazerty.gkb file goes under resources/grub/keymap/ +

    -

    You can adapt the notes below and update the 'build' script to make it build a ROM with your custom/other keyboard layout in GRUB.

    +

    + The scripts build and buildrom-withgrub will automatically see this, and automatically build + ROM's with your custom layout (given the name) and include them under bin. Example: libreboot_frazerty.rom. +

    Back to top of page

    @@ -1210,7 +1301,7 @@

    UK Dvorak keyboard layout in GRUB (for reference)

    -

    There isn't much difference.
    +

    There isn't much difference to US Dvorak.
    $ cp usdvorak ukdvorak

    Patch ukdvorak like so (diff usdvorak ukdvorak):
    @@ -1221,6 +1312,21 @@

    Note: these files are already included ('build' script makes use of them). You don't need to do any of this.

    +

    FR AZERTY keyboard layout in GRUB (for reference)

    + +

    How the frazerty.gkb was made (for FR AZERTY layout in GRUB).

    + +

    $ cd libreboot_src/grub
    + compile grub ('build' script has the info on how to do this)
    + come back out into libreboot_src:
    + $ cd ../

    + +

    Generate the layout file:
    + $ ckbcomp fr > frazerty
    + $ cat frazerty | ./grub/grub-mklayout -o frazerty.gkb

    + +

    Note: these files are already included ('build' script makes use of them). You don't need to do it.

    +

    Back to top of page

    @@ -1235,7 +1341,7 @@ $ sudo apt-get install build-essential

    - Go into the libreboot_src directory. Under coreboot/util/nvramtool/ do that to compile it: + Go into the libreboot_src directory. Under coreboot/util/nvramtool/ do that to compile it:
    $ make

    @@ -1416,6 +1522,10 @@ WantedBy=multi-user.target 

     	Unlisted note: http://inertiawar.com/microcode/
 	(link published to coreboot mailing list on July 8, 2014)
+
+	This page talks about 'calibration' in powertop:
+	https://docs.fedoraproject.org/en-US/Fedora/15/html/Power_Management_Guide/PowerTOP.html
+	I should think about adapting information here based on that page.
    -- cgit v0.9.1