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') diff --git a/docs/RELEASE.html b/docs/RELEASE.html index 7d41aeb..6e12ca7 100644 --- a/docs/RELEASE.html +++ b/docs/RELEASE.html @@ -32,7 +32,7 @@

Releases

  • TODO: Documentation: Added (replicated) the same level of logs (from default firmware) that Mono did for macbook21, for t60/x60/x60t
    • -
  • TODO: macbook21: make it's grub.cfg's use a background1280x800.png instead, because macbook21 uses this 16:10 resolution instead of 4:3
  • 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: X60/X60s: create new x60sconfig in resources/libreboot/config
    • -
  • TODO: Added script build-x60s which puts it's ROM's in bin/x60s and uses resources/libreboot/config/x60sconfig (still uses resources/grub/config/*)
    • -
  • TODO: Added ./build-x60s instruction to build script
  • 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: Updated 'build' script to include coreboot/util/nvramtool source directory as 'nvramtool_standalone' directory in libreboot_bin
    • -
  • TODO: Added 'builddeps-nvramtool' for building nvramtool (for libreboot_bin, not src) standalone, which does 'make' in libreboot_bin/nvramtool_standalone then puts the nvramtool executable in libreboot_bin/ and then does 'make clean' in libreboot_bin/nvramtool_standalone/.
    • -
  • TODO: Updated 'build' script to include 'builddeps-nvramtool' in libreboot_bin
    • -
  • TODO: Updated 'build' script to include X60/T60/macbook21 cmos.layout files (from libreboot_src/coreboot/src/mainboard/oem/board/) in libreboot_bin, for use with nvramtool
    • -
  • TODO: Documentation: updated the relevant parts that use nvramtool to mention the new 'builddeps-nvramtool' and the cmos.layout files in libreboot_bin. Emphasize that this is for libreboot_bin and not libreboot_src
  • 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 diff --git a/docs/howtos/grub_cbfs.html b/docs/howtos/grub_cbfs.html index 8446686..d95904d 100644 --- a/docs/howtos/grub_cbfs.html +++ b/docs/howtos/grub_cbfs.html @@ -29,7 +29,7 @@

    - A coreboot or libreboot ROM is not simply "flat"; there is an actual filesystem inside called CBFS (coreboot filesystem). A utility called 'cbfstool' + A libreboot (or coreboot) ROM is not simply "flat"; there is an actual filesystem inside called CBFS (coreboot filesystem). A utility called 'cbfstool' allows you to change the contents of the ROM. In this case, libreboot is configured such that the grub.cfg exists directly inside CBFS instead of inside the grub.elf payload's 'memdisk' (which is itself stored in CBFS).

    @@ -61,30 +61,30 @@

    You can work directly with one of the ROM's already included in libreboot_bin.tar.gz. For the purpose of this tutorial it is assumed - that your ROM is named 'coreboot.rom' so please make sure to adapt. + that your ROM is named 'libreboot_usqwerty.rom' so please make sure to adapt.

    If you want to re-use the ROM that you currently have flashed (and running) then see ../index.html#build_flashrom and then run:
    - $ sudo ./flashrom -p internal -r coreboot.rom
    - Notice that this is using "-r" (read) instead of "-w" (write). This will create a dump (copy) of your current firmware and name it coreboot.rom. You need to take ownership of the file. For example:
    - $ sudo chown yourusername:yourusername coreboot.rom
    - # chown yourusername:yourusername coreboot.rom + $ sudo ./flashrom -p internal -r libreboot_usqwerty.rom
    + Notice that this is using "-r" (read) instead of "-w" (write). This will create a dump (copy) of your current firmware and name it libreboot_usqwerty.rom. You need to take ownership of the file. For example:
    + $ sudo chown yourusername:yourusername libreboot_usqwerty.rom
    + # chown yourusername:yourusername libreboot_usqwerty.rom

    Display contents of ROM:
    - $ ./cbfstool coreboot.rom print + $ ./cbfstool libreboot_usqwerty.rom print

    - The coreboot.rom file contains your grub.cfg. + The libreboot_usqwerty.rom file contains your grub.cfg.

    Extract grub.cfg from the ROM:
    - $ ./cbfstool coreboot.rom extract -n grub.cfg -f grub.cfg + $ ./cbfstool libreboot_usqwerty.rom extract -n grub.cfg -f grub.cfg

    @@ -93,22 +93,22 @@

    Delete the grub.cfg that remained inside the ROM:
    - $ ./cbfstool coreboot.rom remove -n grub.cfg + $ ./cbfstool libreboot_usqwerty.rom remove -n grub.cfg

    Display ROM contents and now you see grub.cfg no longer exists there:
    - $ ./cbfstool coreboot.rom print + $ ./cbfstool libreboot_usqwerty.rom print

    Add the modified version that you just made:
    - $ ./cbfstool coreboot.rom add -n grub.cfg -f grub.cfg -t raw + $ ./cbfstool libreboot_usqwerty.rom add -n grub.cfg -f grub.cfg -t raw

    Now display ROM contents again and see that it exists again:
    - $ ./cbfstool coreboot.rom print + $ ./cbfstool libreboot_usqwerty.rom print

    diff --git a/docs/howtos/x60_heatsink.html b/docs/howtos/x60_heatsink.html new file mode 100644 index 0000000..0feee77 --- /dev/null +++ b/docs/howtos/x60_heatsink.html @@ -0,0 +1,142 @@ + + + + + + + + + Libreboot documentation: Switch heatsink on ThinkPad X60 + + + + +

    +

    Changing the fan/heatsink on the ThinkPad X60

    + +
    + +

    Or go back to main index

    + +

    Table of Contents

    + + +

    Hardware requirements

    + + +

    Software requirements (for CPU stress testing)

    + + +

    Disassembly

    +

    + Remove those screws:
    + +

    +

    + Push the keyboard forward (carefully):
    + +

    +

    + Lift the keyboard up and disconnect it from the board:
    + +

    +

    + Grab the right-hand side of the chassis and force it off (gently) and pry up the rest of the chassis:
    + +

    +

    + You should now have this:
    + +

    +

    + Disconnect the wifi antenna cables, the modem cable and the speaker:
    + +

    +

    + Unroute the cables along their path, carefully lifting the tape that holds them in place. Then, disconnect the modem + cable (other end) and power connection and unroute all the cables so that they dangle by the monitor hinge on the right-hand + side:
    + +

    +

    + Disconnect the monitor from the motherboard, and unroute the grey antenna cable, carefully lifting the tape + that holds it into place:
    + +

    +

    + Carefully lift the remaining tape and unroute the left antenna cable so that it is loose:
    + +

    +

    + Remove those screws:
    + +

    +

    + Remove those screws:
    + +

    +

    + Carefully remove the plate, like so:
    + +

    +

    + Remove the SATA connector:
    + +

    +

    + Now remove the motherboard (gently) and cast the lcd/chassis aside:
    + +

    +

    + Look at that black tape above the heatsink, remove it:
    + +

    +

    + Now you have removed it:
    + +

    + +

    + Disconnect the fan and remove all the screws, heatsink will easily come off:
    + +

    + +

    + Remove the old paste with a cloth (from the CPU and heatsink) and then clean both of them with the alcholeel (to remove remaining residue. typo is intentional). + Apply a pea-sized amount of paste to the both chipsets that the heatsink covered and spread it evenly (uniformally). + Finally reinstall the heatsink, reversing previous steps. +

    + +

    + stress -c 2 command can be used to push the CPU to 100%, and xsensors (or watch sensors command) can be used to monitor heat. + Below 90C is ok. +

    + +
    + +

    + Copyright © 2014 Francis Rowe, All Rights Reserved.
    + See ../license.html for license conditions. +

    + + + diff --git a/docs/howtos/x60_heatsink/0000.jpg b/docs/howtos/x60_heatsink/0000.jpg new file mode 100644 index 0000000..ce0ec3b --- /dev/null +++ b/docs/howtos/x60_heatsink/0000.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0001.jpg b/docs/howtos/x60_heatsink/0001.jpg new file mode 100644 index 0000000..2bbc0ca --- /dev/null +++ b/docs/howtos/x60_heatsink/0001.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0002.jpg b/docs/howtos/x60_heatsink/0002.jpg new file mode 100644 index 0000000..b55db3b --- /dev/null +++ b/docs/howtos/x60_heatsink/0002.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0003.jpg b/docs/howtos/x60_heatsink/0003.jpg new file mode 100644 index 0000000..c5799ae --- /dev/null +++ b/docs/howtos/x60_heatsink/0003.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0004.jpg b/docs/howtos/x60_heatsink/0004.jpg new file mode 100644 index 0000000..cd47840 --- /dev/null +++ b/docs/howtos/x60_heatsink/0004.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0005.jpg b/docs/howtos/x60_heatsink/0005.jpg new file mode 100644 index 0000000..418c9d2 --- /dev/null +++ b/docs/howtos/x60_heatsink/0005.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0006.jpg b/docs/howtos/x60_heatsink/0006.jpg new file mode 100644 index 0000000..6d36d93 --- /dev/null +++ b/docs/howtos/x60_heatsink/0006.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0007.jpg b/docs/howtos/x60_heatsink/0007.jpg new file mode 100644 index 0000000..971ccdf --- /dev/null +++ b/docs/howtos/x60_heatsink/0007.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0008.jpg b/docs/howtos/x60_heatsink/0008.jpg new file mode 100644 index 0000000..24e6526 --- /dev/null +++ b/docs/howtos/x60_heatsink/0008.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0009.jpg b/docs/howtos/x60_heatsink/0009.jpg new file mode 100644 index 0000000..d318395 --- /dev/null +++ b/docs/howtos/x60_heatsink/0009.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0010.jpg b/docs/howtos/x60_heatsink/0010.jpg new file mode 100644 index 0000000..5e6fdc7 --- /dev/null +++ b/docs/howtos/x60_heatsink/0010.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0011.jpg b/docs/howtos/x60_heatsink/0011.jpg new file mode 100644 index 0000000..101cf6a --- /dev/null +++ b/docs/howtos/x60_heatsink/0011.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0012.jpg b/docs/howtos/x60_heatsink/0012.jpg new file mode 100644 index 0000000..dbb6669 --- /dev/null +++ b/docs/howtos/x60_heatsink/0012.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0013.jpg b/docs/howtos/x60_heatsink/0013.jpg new file mode 100644 index 0000000..2d2b9dd --- /dev/null +++ b/docs/howtos/x60_heatsink/0013.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0014.jpg b/docs/howtos/x60_heatsink/0014.jpg new file mode 100644 index 0000000..733f997 --- /dev/null +++ b/docs/howtos/x60_heatsink/0014.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0015.jpg b/docs/howtos/x60_heatsink/0015.jpg new file mode 100644 index 0000000..1e81166 --- /dev/null +++ b/docs/howtos/x60_heatsink/0015.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0016.jpg b/docs/howtos/x60_heatsink/0016.jpg new file mode 100644 index 0000000..ea418a5 --- /dev/null +++ b/docs/howtos/x60_heatsink/0016.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0017.jpg b/docs/howtos/x60_heatsink/0017.jpg new file mode 100644 index 0000000..8a67482 --- /dev/null +++ b/docs/howtos/x60_heatsink/0017.jpg Binary files differ diff --git a/docs/howtos/x60_heatsink/0018.jpg b/docs/howtos/x60_heatsink/0018.jpg new file mode 100644 index 0000000..98c43ac --- /dev/null +++ b/docs/howtos/x60_heatsink/0018.jpg Binary files differ diff --git a/docs/howtos/x60_security.html b/docs/howtos/x60_security.html new file mode 100644 index 0000000..fc9cb0b --- /dev/null +++ b/docs/howtos/x60_security.html @@ -0,0 +1,171 @@ + + + + + + + + + Libreboot documentation: Security on the ThinkPad X60 + + + + +
    +

    Security on the ThinkPad X60

    + +
    + +

    Or go back to main index

    + +

    Table of Contents

    + + +

    Hardware requirements

    + + +

    Software requirements

    + + +

    Disassembly

    + +

    + Firstly remove the bluetooth (if your X60 has this):
    + The marked screws are underneath those stickers (marked in those 3 locations at the bottom of the LCD assembly):
    +
    + Now gently pry off the bottom part of the front bezel, and the bluetooth module is on the left (easily removable):
    +
    +

    + +

    + If your model was WWAN, remove the simcard (check anyway):
    + Uncover those 2 screws at the bottom:
    +
    + SIM card is in the marked location:
    +
    + Replacement: USB dongle. +

    + +

    + Now get into the motherboard. +

    + +

    + Remove those screws:
    + +

    +

    + Push the keyboard forward (carefully):
    + +

    +

    + Lift the keyboard up and disconnect it from the board:
    + +

    +

    + Grab the right-hand side of the chassis and force it off (gently) and pry up the rest of the chassis:
    + +

    +

    + You should now have this:
    + +

    + +

    + The following is a summary of what you will remove (already done to this machine):
    +
    + Note: the blue lines represent antenna cables and modem cables. You don't need to remove these, but you can if you want + (to make it tidier after removing other parts). I removed the antenna wires, the modem jack, the modem cable and + also (on another model) a device inside the part where the wwan antenna goes (wasn't sure what it was, but I knew it wasn't needed). This is optional +

    + +

    + Remove the microphone (can desolder it, but you can also easily pull it off with you hands). Already removed here:
    +
    + We do not know what the built-in microcode (on the CPU) is doing. The theory is that it could be programmed to take commands that do something + and then the CPU returns results. (meaning, remote security hole). So we remove it, just in case.
    + Replacement: external microphone on USB or line-in jack. +

    + +

    + Remove the modem:
    +
    + (useless, obsolete device) +

    + +

    + Remove the speaker:
    +
    + Reason: combined with the microphone issue, this could be used to leak data.
    + Replacement: headphones/speakers (line-out) or external DAC (USB). +

    + +

    + Remove the wlan (also remove wwan if you have it):
    +
    + Reason: has direct (and very fast) memory access, and could (theoretically) leak data over a side-channel. +

    + +

    + Not covered yet: +

    + +

    + Go to http://media.ccc.de/browse/congress/2013/30C3_-_5529_-_en_-_saal_2_-_201312271830_-_hardening_hardware_and_choosing_a_goodbios_-_peter_stuge.html + or directly to the video: http://mirror.netcologne.de/CCC/congress/2013/webm/30c3-5529-en-Hardening_hardware_and_choosing_a_goodBIOS_webm.webm. +

    +

    + A lot of this tutorial is based on that video. Look towards the second half of the video to see how to do the abev. +

    + +

    + Also not covered yet: +

    + + +
    + +

    + Copyright © 2014 Francis Rowe, All Rights Reserved.
    + See ../license.html for license conditions. +

    + + + diff --git a/docs/howtos/x60_security/0000.jpg b/docs/howtos/x60_security/0000.jpg new file mode 100644 index 0000000..ce0ec3b --- /dev/null +++ b/docs/howtos/x60_security/0000.jpg Binary files differ diff --git a/docs/howtos/x60_security/0000_bluetooth.jpg b/docs/howtos/x60_security/0000_bluetooth.jpg new file mode 100644 index 0000000..94a255f --- /dev/null +++ b/docs/howtos/x60_security/0000_bluetooth.jpg Binary files differ diff --git a/docs/howtos/x60_security/0000_bluetooth0.jpg b/docs/howtos/x60_security/0000_bluetooth0.jpg new file mode 100644 index 0000000..a750b0c --- /dev/null +++ b/docs/howtos/x60_security/0000_bluetooth0.jpg Binary files differ diff --git a/docs/howtos/x60_security/0000_simcard0.jpg b/docs/howtos/x60_security/0000_simcard0.jpg new file mode 100644 index 0000000..40837ea --- /dev/null +++ b/docs/howtos/x60_security/0000_simcard0.jpg Binary files differ diff --git a/docs/howtos/x60_security/0000_simcard1.jpg b/docs/howtos/x60_security/0000_simcard1.jpg new file mode 100644 index 0000000..c0a5b35 --- /dev/null +++ b/docs/howtos/x60_security/0000_simcard1.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001.jpg b/docs/howtos/x60_security/0001.jpg new file mode 100644 index 0000000..2bbc0ca --- /dev/null +++ b/docs/howtos/x60_security/0001.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001_microphone.jpg b/docs/howtos/x60_security/0001_microphone.jpg new file mode 100644 index 0000000..c419060 --- /dev/null +++ b/docs/howtos/x60_security/0001_microphone.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001_modem.jpg b/docs/howtos/x60_security/0001_modem.jpg new file mode 100644 index 0000000..6a7a6a0 --- /dev/null +++ b/docs/howtos/x60_security/0001_modem.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001_overview.jpg b/docs/howtos/x60_security/0001_overview.jpg new file mode 100644 index 0000000..7268e49 --- /dev/null +++ b/docs/howtos/x60_security/0001_overview.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001_speaker.jpg b/docs/howtos/x60_security/0001_speaker.jpg new file mode 100644 index 0000000..28d3ed6 --- /dev/null +++ b/docs/howtos/x60_security/0001_speaker.jpg Binary files differ diff --git a/docs/howtos/x60_security/0001_wlan_wwan.jpg b/docs/howtos/x60_security/0001_wlan_wwan.jpg new file mode 100644 index 0000000..0db858d --- /dev/null +++ b/docs/howtos/x60_security/0001_wlan_wwan.jpg Binary files differ diff --git a/docs/howtos/x60_security/0002.jpg b/docs/howtos/x60_security/0002.jpg new file mode 100644 index 0000000..b55db3b --- /dev/null +++ b/docs/howtos/x60_security/0002.jpg Binary files differ diff --git a/docs/howtos/x60_security/0003.jpg b/docs/howtos/x60_security/0003.jpg new file mode 100644 index 0000000..c5799ae --- /dev/null +++ b/docs/howtos/x60_security/0003.jpg Binary files differ diff --git a/docs/howtos/x60_security/0004.jpg b/docs/howtos/x60_security/0004.jpg new file mode 100644 index 0000000..cd47840 --- /dev/null +++ b/docs/howtos/x60_security/0004.jpg Binary files differ diff --git a/docs/howtos/x60_unbrick.html b/docs/howtos/x60_unbrick.html index 10f66b4..8427c5a 100644 --- a/docs/howtos/x60_unbrick.html +++ b/docs/howtos/x60_unbrick.html @@ -172,7 +172,8 @@ Programmer is now active:

    Now I install flashrom on the T60 (running Trisquel GNU/Linux) and do this:
    - flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w coreboot.rom
    + flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/x60/libreboot_usqwerty.rom
    + Note: there are also other ROM images for X60
    Note: this is using buspirate as the programmer, so it is flashing the X60, not the T60!
    Here's my terminal window on the T60:

    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