From 8b2219bfa2da36e7809588ef723a10483a6e137f Mon Sep 17 00:00:00 2001 From: Francis Rowe Date: Wed, 05 Nov 2014 20:52:36 -0500 Subject: Documentation: *major* cleanup. Cleanup was long overdue. Old structure was messy and inefficient. --- (limited to 'docs/install') diff --git a/docs/install/index.html b/docs/install/index.html new file mode 100644 index 0000000..571e115 --- /dev/null +++ b/docs/install/index.html @@ -0,0 +1,405 @@ + + + + + + + + + Installing libreboot + + + + +

Installing libreboot

+

+ This section relates to installing libreboot on supported targets. +

+

+ Or Back to main index. +

+

Installing libreboot (software)

+ + +

Installing libreboot (hardware)

+ + +
+ +

Recommended ROM's to flash

+ +

+ List of directories corresponding to each board: +

+ + +

These images use coreboot text-mode graphics:

+ +

These images use coreboot framebuffer graphics:

+ + +

+ _txtmode images come with a working MemTest86+ and GRUB Invaders, both of which require text-mode. + _vesafb images are recommended in most cases. +

+ +

+ 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/index.html#grub_keyboard shows you how this was done. If your native keyboard layout + differs, you can adapt those notes and hack the 'build' script for your needs. +

+ +

Back to top of page.

+ +
+ +

X60/X60S/X60T/T60: How to flash the ROM's onto your machine (if running Lenovo BIOS firmware).

+ +
+ +

+ Hover over the next paragraph to make it black. +

+

+ Following this guide means simply flashing a libreboot ROM. This guide will not (directly) teach you how to make a backup (dump) of the original Lenovo BIOS + because to do so would be to explicitly endorse proprietary software. However, for the purposes of reverse engineering it can be useful + to have a backup. Each copy of the original Lenovo BIOS is tied to the specific machine that it came from; it will not run + on any other machine, even if it's the same type of machine as yours. What this means is that, effectively, you can back it up now (so that you can + re-flash it later if you want to run the original Lenovo BIOS again) or lose it forever. The X60/T60 installation + guide on the coreboot wiki will show you how to do this: + http://www.coreboot.org/Board:lenovo/x60/Installation.
+ Do not make this decision lightly! This is your last and only chance. +

+ +

+ The following is for the libreboot image and *not* the factory bios dump: +

+

+ Check the last two 64K regions in your ROM file (libreboot.rom in this example):
+ $ dd if=libreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s libreboot.rom) - 0x10000] count=64k
+ $ dd if=libreboot.rom of=lower64k.bin bs=1 skip=$[$(stat -c %s libreboot.rom) - 0x20000] count=64k
+ $ sha512sum lower64k.bin top64k.bin
+ Make *sure* that they match before you continue. The ROM's included pre-compiled in libreboot should already match. + If they don't match, then do this (based on those instructions from coreboot wiki):
+ $ dd if=top64k.bin of=libreboot.rom bs=1 seek=$[$(stat -c %s libreboot.rom) - 0x20000] count=64k conv=notrunc
+ After this, the ROM will be safe to flash. Explanation is provided in ../git/index.html#build_bucts. +

+ +
+ +

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!

+ +

If you are flashing a Lenovo ThinkPad T60, be sure to read ../hcl/index.html#supported_t60_list

+ +

+ First, install the build dependencies. +

+ +
+ +

+ + Before you proceed, make *sure* to build flashrom and bucts from source. Both are provided. This is very important! + +

+ + +
+ +

"YOURBOARD/YOURROM" should be replaced with what is correct as per #rom. Alternatively + you may be using your own custom ROM. Adapt.

+ +

+ Run the script:
+ $ sudo ./lenovobios_firstflash bin/YOURBOARD/YOURROM. +

+ +
+ +

+ You should see within the output the following:
+ "Updated BUC.TS=1 - 64kb address ranges at 0xFFFE0000 and 0xFFFF0000 are swapped". +

+ +

+ You should also see within the output the following:
+ "Flash chip is in an unknown state", "FAILED" and "DO NOT SHUTDOWN OR REBOOT"
+ Seeing this means that the operation was a resounding success! DON'T PANIC. +

+ +

+ See this link for more details: + http://thread.gmane.org/gmane.linux.bios.flashrom/575. +

+ +

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

+ +

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

+ +
+ +

+ You should see within the output the following:
+ "Updated BUC.TS=0 - 128kb address range 0xFFFE0000-0xFFFFFFFF is untranslated" +

+ +

+ You should also see within the output the following:
+ "Verifying flash... VERIFIED." +

+ +

Shut down again, wait a few seconds, and then boot.

+ +
+ +

+ Some thinkpads come with WWAN cards installed, along with sim cards. These use non-free firmware and should be removed. + You might also want to remove bluetooth. See ../security/x60_security.html and + ../security/t60_security.html. +

+ +

Back to top of page.

+ +
+ +

macbook21: How to flash your ROM (if running Apple EFI firmware)

+ +
+ +

+ Hover over the next paragraph to make it black. +

+

+ Following this guide means simply flashing a libreboot ROM. This guide will not (directly) teach you how to make a backup (dump) of the original Apple EFI firmware + because to do so would be to explicitly endorse proprietary software. However, for the purposes of reverse engineering it can be useful + to have a backup. Each copy of the original Apple EFI is (believed, but unproven to be) tied to the specific machine that it came from; it will not (as is believed) run + on any other machine, even if it's the same type of machine as yours. What this means is that, effectively, you can back it up now (so that you can + re-flash it later if you want to run the original Apple EFI firmware again) or lose it forever. The macbook21 installation + guide on the coreboot wiki will show you how to do this: + http://www.coreboot.org/Board:apple/macbook21.
+ Do not make this decision lightly! This is (very likely) your last and only chance. +

+ +

+ (this theory is untested at the time of writing) +

+ +

+ Note: If you have a MacBook1,1 then these instructions will not work. See ../hcl/index.html#macbook11 for MacBook1,1 flashing instructions. +

+ +
+ +

+ + This is for the MacBook2,1 while running Apple EFI firmware. If you already have + coreboot or libreboot running, then go to #flashrom instead! + +

+ +

+ Be sure to read the information in ../hcl/index.html#macbook21. +

+ +

+ First, install the build dependencies. +

+ +
+ +

+ + Before you proceed, make *sure* to build flashrom from source. This is very important! + +

+ + +
+ +

+ Look at #rom to see which ROM is suitable for your machine. Alternatively you may be using your own + custom ROM. Adapt. +

+ +

+ Flashing is actually easy (compared to X60/T60).
+ $ sudo flashrom -p internal:laptop=force_I_want_a_brick -w bin/YOURBOARD/YOURROM +

+ +

+ Alternatively, a script is provided which does the same thing:
+ $ sudo ./macbook21_firstflash bin/YOURBOARD/YOURROM +

+ +
+ +

+ You should also see within the output the following:
+ "Verifying flash... VERIFIED." +

+ +

+ If you see that, great! Shut down now (power off). Wait a few seconds and then boot! +

+ +

+ + If you boot and you see nothing, try turning up the backlight (F2 for macbook21). + +

+ + +
+ +

Back to top of page.

+ +
+ +

X60/X60S/X60T/T60/macbook21: How to flash the ROM's onto your machine (if running libreboot or coreboot already)

+ +

+ + These instructions work for the Lenovo ThinkPad X60/X60S/X60T/T60 and Apple MacBook2,1. + +

+

+ + This assumes that you already have coreboot or libreboot running. + +

+

+ + If you have Lenovo BIOS running (X60/X60S/X60T/T60), go to #flashrom_lenovobios instead. + +

+

+ + If you have Apple EFI firmware running (macbook21), go to #flashrom_macbook21 instead. + +

+

+ + If you are flashing a Lenovo ThinkPad T60, be sure to read ../hcl/index.html#supported_t60_list. + +

+

+ + If you are flashing an Apple MacBook2,1, be sure to read the information in ../hcl/index.html#macbook21. + +

+

+ First, install the build dependencies. +

+
+ +

+ + Before you proceed, make *sure* to build flashrom from source. This is very important! + +

+ + +
+

+ Look at #rom to see which ROM is suitable for your machine. Alternative you may be using your own + custom ROM. Adapt. +

+

+ Flash the ROM:
+ $ sudo ./flash bin/YOURBOARD/YOURROM +

+ +
+ +

+ You should see "Verifying flash... VERIFIED." written at the end of the flashrom output. SHUT DOWN + 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 for X60/X60S/X60T/T60, F2 for macbook21). + +

+ +
+ +

+ Some thinkpads come with WWAN cards installed, along with sim cards. These use non-free firmware and should be removed. + You might also want to remove bluetooth. See ../security/x60_security.html and + ../security/t60_security.html. +

+ +

Back to top of page

+ +
+ +

+ Copyright © 2014 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. +

+ + + diff --git a/docs/install/t60_unbrick.html b/docs/install/t60_unbrick.html new file mode 100644 index 0000000..b79f3de --- /dev/null +++ b/docs/install/t60_unbrick.html @@ -0,0 +1,316 @@ + + + + + + + + + Libreboot documentation: Unbricking the ThinkPad T60 + + + + +
+

Unbricking the ThinkPad T60

+ +
+ +

Or go back to main index

+ +

Table of Contents

+ + +

Hardware requirements

+ + +

Software requirements

+ + +

Brick type 1: bucts not reset.

+

+ You still have Lenovo BIOS, or you had libreboot running and you flashed another ROM; and you had bucts 1 set and + the ROM wasn't dd'd.* or if Lenovo BIOS was present and libreboot wasn't flashed.

+ + In this case, unbricking is easy: reset BUC.TS to 0 by removing that yellow cmos coin (it's a battery) and putting it back after a minute or two:
+

+ + *Those dd commands should be applied to all newly compiled T60 ROM's (the ROM's in libreboot binary archives already have this applied!):
+ dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k
+ dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump
+ dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc
+ (doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running, + using those instructions: http://www.coreboot.org/Board:lenovo/x60/Installation. + (it says x60, but instructions for t60 are identical) +

+ +

bad rom (or user error), machine won't boot

+ +

+ In this scenario, you compiled a ROM that had an incorrect configuration, or there is an actual bug preventing your machine from + booting. Or, maybe, you set BUC.TS to 0 and shut down after first flash while Lenovo BIOS was running. In any case, your machine is bricked and will not boot at all. +

+

+ "Unbricking" means flashing a known-good (working) ROM. The problem: you can't boot the machine, making this difficult. In this situation, external hardware (see hardware requirements above) is needed which can flash the SPI chip (where libreboot resides). +

+ +

+ Remove those screws and remove the HDD:
+ +

+ +

+ Lift off the palm rest:
+ +

+ +

+ Lift up the keyboard, pull it back a bit, flip it over like that and then disconnect it from the board:
+ +

+ +

+ Gently wedge both sides loose:
+ +

+ +

+ Remove that cable from the position:
+ +

+ +

+ Now remove that bezel. Remove wifi, nvram battery and speaker connector (also remove 56k modem, on the left of wifi):
+ +

+ +

+ Remove those screws:
+ +

+ +

+ Disconnect the power jack:
+ +

+ +

+ Remove nvram battery:
+ +

+ +

+ Disconnect cable (for 56k modem) and disconnect the other cable:
+ +

+ +

+ Disconnect speaker cable:
+ +

+ +

+ Disconnect the other end of the 56k modem cable:
+ +

+ +

+ Make sure you removed it:
+ +

+ +

+ Unscrew those:
+ +

+ +

+ Make sure you removed those:
+ +

+ +

+ Disconnect LCD cable from board:
+ +

+ +

+ Remove those screws then remove the LCD assembly:
+ +

+ +

+ Once again, make sure you removed those:
+ +

+ +

+ Remove the shielding containing the motherboard, then flip it over. Remove these screws, placing them on a steady + surface in the same layout as they were in before you removed them. Also, you should mark each screw hole after removing the + screw (a permanent marker pen will do), this is so that you have a point of reference when re-assembling the machine:
+ + +

+ +

+ At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):
+ http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts.
+ Correlating with the following information, I was able to wire up my pirate correctly:
+ http://flashrom.org/Bus_Pirate#Connections
+ And by following that advice:
+ http://www.coreboot.org/Board:lenovo/x60/Installation#Howto.
+ (it says X60 but instructions are virtually the same for the T60, with except to physical differences in how to disassemble the machine)
+ Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.
+ Note: and then, for power it says (on that coreboot.org page) to connect the power jack to the board and connect the + AC adapter (without powering on the board).
+ Note: I ignored that advice, and wired up all 8 pins. And it worked.
+ + Here is the pinout (correlate it with your programmer's documentation):
+ +

+ +

+ Connecting the pomona:
+ +

+ +

+ Connect programmer to 2nd computer:
+ +

+ +

+ Programmer has power:
+ +

+ +

+ Now flash the bricked machine using the 2nd computer. in my case I did:
+ flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/t60/libreboot_usqwerty.rom
+ Note: there are also other ROM images for T60
+ Note: this is using buspirate as the programmer, so it is flashing the T60, not the 2nd computer!
+ Here's my terminal window on the 2nd computer (also the programmer is active):
+
+ So, you should see the following:
+ -- +

+ 
+flashrom v0.9.5.2-r1517 on Linux 3.2.0-61-generic (i686), built with libpci 3.1.8, GCC 4.6.3, little endian
+flashrom is free software, get the source code at http://www.flashrom.org
+
+Calibrating delay loop... delay loop is unreliable, trying to continue OK.
+Found Macronix flash chip "MX25L1605" (2048 kB, SPI) on buspirate_spi.
+Reading old flash chip contents... done.
+Erasing and writing flash chip... Erase/write done.
+Verifying flash... VERIFIED. 
+
+

+ --
+ At the end it says "VERIFIED", which means that the procedure worked. If you see this, it means + that you can put your T60 back together. So let's do that now. +

+ +

+ Put those screws back:
+ +

+ +

+ Put it back into lower chassis:
+ +

+ +

+ Attach LCD and insert screws (also, attach the lcd cable to the board):
+ +

+ +

+ Insert those screws:
+ +

+ +

+ On the CPU (and there is another chip south-east to it, sorry forgot to take pic) + clean off the old thermal paste (rubbing a1ocheal (misspelling intentional. halal internet)) and apply new (Artic Silver 5 is good, others are good too) + you should also clean the heatsink the same way
+ +

+ +

+ Attach the heatsink and install the screws (also, make sure to install the AC jack as highlighted):
+ +

+ +

+ Reinstall that upper bezel:
+ +

+ +

+ Do that:
+ +

+ +

+ Re-attach modem, wifi, (wwan?), and all necessary cables. Sorry, forgot to take pics. Look at previous removal steps to see where they go back to. +

+ +

+ Attach keyboard and install nvram battery:
+ +

+ +

+ Place keyboard and (sorry, forgot to take pics) reinstall the palmrest and insert screws on the underside:
+ +

+ +

+ It lives!
+ +

+ +

+ Always stress test ('stress -c 2' and xsensors. below 90C is ok) when replacing cpu paste/heatsink:
+ +

+ +
+ +

+ Copyright © 2014 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. +

+ + + diff --git a/docs/install/x60_unbrick.html b/docs/install/x60_unbrick.html new file mode 100644 index 0000000..751c4a8 --- /dev/null +++ b/docs/install/x60_unbrick.html @@ -0,0 +1,301 @@ + + + + + + + + + Libreboot documentation: Unbricking the ThinkPad X60 + + + + +
+

Unbricking the ThinkPad X60

+ +
+ +

Or go back to main index

+ +

Table of Contents

+ + +

Hardware requirements

+ + +

Software requirements

+ + +

Brick type 1: bucts not reset.

+

+ You still have Lenovo BIOS, or you had libreboot running and you flashed another ROM; and you had bucts 1 set and + the ROM wasn't dd'd.* or if Lenovo BIOS was present and libreboot wasn't flashed.

+ + In this case, unbricking is easy: reset BUC.TS to 0 by removing that yellow cmos coin (it's a battery) and putting it back after a minute or two:
+

+ + *Those dd commands should be applied to all newly compiled X60 ROM's (the ROM's in libreboot binary archives already have this applied!):
+ dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k
+ dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump
+ dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc
+ (doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running, + using those instructions: http://www.coreboot.org/Board:lenovo/x60/Installation. +

+ +

bad rom (or user error), machine won't boot

+

+ In this scenario, you compiled a ROM that had an incorrect configuration, or there is an actual bug preventing your machine from + booting. Or, maybe, you set BUC.TS to 0 and shut down after first flash while Lenovo BIOS was running. In any case, your machine is bricked and will not boot at all. +

+

+ "Unbricking" means flashing a known-good (working) ROM. The problem: you can't boot the machine, making this difficult. In this situation, external hardware (see hardware requirements above) is needed which can flash the SPI chip (where libreboot resides). +

+

+ 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 the screw that is highlighted (do NOT remove the other one; it holds part of the heatsink (other side) into place):
+ +

+

+ Remove those screws:
+ +

+

+ Carefully remove the plate, like so:
+ +

+

+ Remove the SATA connector:
+ +

+

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

+

+ Lift back that tape and hold it with something. Highlighted is the SPI flash chip:
+ +

+

+ At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):
+ http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts.
+ Correlating with the following information, I was able to wire up my pirate correctly:
+ http://flashrom.org/Bus_Pirate#Connections
+ And by following that advice:
+ http://www.coreboot.org/Board:lenovo/x60/Installation#Howto.
+ Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.
+ Note: and then, for power it says (on that coreboot.org page) to connect the power jack to the board and connect the + AC adapter (without powering on the board).
+ Note: I ignored that advice, and wired up all 8 pins. And it worked.
+ + Here is the pinout (correlate it with your programmer's documentation):
+ +

+ +

+ My programmer (bus pirate):
+
+ My clip (pomona 5250):
+
+ Connecting the pomona:
+
+ Connecting the USB cable from programmer to 2nd(working/non-bricked) computer, my T60:
+
+ Now I install flashrom on the T60 (running Trisquel GNU/Linux) and do this:
+ 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:
+
+ So, you should see the following:
+ -- +

+
+flashrom v0.9.5.2-r1517 on Linux 3.2.0-61-generic (i686), built with libpci 3.1.8, GCC 4.6.3, little endian
+flashrom is free software, get the source code at http://www.flashrom.org
+
+Calibrating delay loop... delay loop is unreliable, trying to continue OK.
+Found Macronix flash chip "MX25L1605" (2048 kB, SPI) on buspirate_spi.
+Reading old flash chip contents... done.
+Erasing and writing flash chip... Erase/write done.
+Verifying flash... VERIFIED. 
+
+

+ --
+ At the end it says "VERIFIED", which means that the procedure worked. If you see this, it means + that you can put your X60 back together. So let's do that now. +

+

+ Remove the programmer and put it away somewhere. Put back the tape and press firmly over it:
+ +

+

+ Your empty chassis:
+ +

+

+ Put the motherboard back in:
+ +

+

+ Reconnect SATA:
+ +

+

+ Put the plate back and re-insert those screws:
+ +

+

+ Re-route that antenna cable around the fan and apply the tape:
+ +

+

+ Route the cable here and then (not shown, due to error on my part) reconnect the monitor cable to the motherboard + and re-insert the screws:
+ +

+

+ Re-insert that screw:
+ +

+

+ Route the black antenna cable like so:
+ +

+

+ Tuck it in neatly like so:
+ +

+

+ Route the modem cable like so:
+ +

+

+ Connect modem cable to board and tuck it in neatly like so:
+ +

+

+ Route the power connection and connect it to the board like so:
+ +

+

+ Route the antenna and modem cables neatly like so:
+ +

+

+ Connect the wifi antenna cables. At the start of the tutorial, this machine had an Intel wifi chip. Here you see I've replaced it with an + Atheros AR5B95 (supports 802.11n and can be used without blobs):
+ +

+

+ Connect the modem cable:
+ +

+

+ Connect the speaker:
+ +

+

+ You should now have this:
+ +

+

+ Re-connect the upper chassis:
+ +

+

+ Re-connect the keyboard:
+ +

+

+ Re-insert the screws that you removed earlier:
+ +

+

+ Power on!
+ +

+

+ Trisquel live USB menu (using GRUB's ISOLINUX parser):
+ +

+

+ Trisquel live desktop:
+ +

+ +
+ +

+ Copyright © 2014 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. +

+ + + diff --git a/docs/install/x60tablet_unbrick.html b/docs/install/x60tablet_unbrick.html new file mode 100644 index 0000000..b5aad3c --- /dev/null +++ b/docs/install/x60tablet_unbrick.html @@ -0,0 +1,209 @@ + + + + + + + + + Libreboot documentation: Unbricking the ThinkPad X60 Tablet + + + + +
+

Unbricking the ThinkPad X60

+ +
+ +

Or go back to main index

+ +

Table of Contents

+ + +

Hardware requirements

+ + +

Software requirements

+ + +

Brick type 1: bucts not reset.

+

+ You still have Lenovo BIOS, or you had libreboot running and you flashed another ROM; and you had bucts 1 set and + the ROM wasn't dd'd.* or if Lenovo BIOS was present and libreboot wasn't flashed.

+ + In this case, unbricking is easy: reset BUC.TS to 0 by removing that yellow cmos coin (it's a battery) and putting it back after a minute or two:
+

+ + *Those dd commands should be applied to all newly compiled X60 ROM's (the ROM's in libreboot binary archives already have this applied!):
+ dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k
+ dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump
+ dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc
+ (doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running, + using those instructions: http://www.coreboot.org/Board:lenovo/x60/Installation. +

+ +

bad rom (or user error), machine won't boot

+

+ In this scenario, you compiled a ROM that had an incorrect configuration, or there is an actual bug preventing your machine from + booting. Or, maybe, you set BUC.TS to 0 and shut down after first flash while Lenovo BIOS was running. In any case, your machine is bricked and will not boot at all. +

+

+ "Unbricking" means flashing a known-good (working) ROM. The problem: you can't boot the machine, making this difficult. In this situation, external hardware (see hardware requirements above) is needed which can flash the SPI chip (where libreboot resides). +

+ +

+ +

+ +

+ Remove those screws:
+ +

+ +

+ Remove the HDD:
+ +

+ +

+ Push keyboard forward to loosen it:
+ +

+ +

+ Lift:
+ +

+ +

+ Remove those:
+ +

+ +

+ + +

+ +

+ Also remove that (marked) and unroute the antenna cables:
+ +

+ +

+ Some X60T's you have to unroute those too:
+ +

+ +

+ Remove the LCD extend board screws. Also remove those screws (see blue marks) and remove/unroute the cables and remove the metal plate:
+ +

+ +

+ Remove that screw and then remove the board:
+ +

+ +

+ At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):
+ http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts.
+ Correlating with the following information, I was able to wire up my pirate correctly:
+ http://flashrom.org/Bus_Pirate#Connections
+ And by following that advice:
+ http://www.coreboot.org/Board:lenovo/x60/Installation#Howto.
+ Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.
+ Note: and then, for power it says (on that coreboot.org page) to connect the power jack to the board and connect the + AC adapter (without powering on the board).
+ Note: I ignored that advice, and wired up all 8 pins. And it worked.
+ + Here is the pinout (correlate it with your programmer's documentation):
+
+ (SPI chip here is on the bottom of the board) +

+ +

+ Bus pirate:
+ +

+ +

+ Pomona 5250:
+ +

+ +

+ Connect pomona:
+ +

+ +

+ Connect pirate to USB on 2nd computer:
+ +

+ +

+ +

+ +

+ On the 2nd machine, I did: flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/x60t/libreboot_ukqwerty.rom +

+ + 
+			flashrom v0.9.5.2-r1517 on Linux 3.2.0-61-generic (i686), built with libpci 3.1.8, GCC 4.6.3, little endian
+			flashrom is free software, get the source code at http://www.flashrom.org
+
+			Calibrating delay loop... delay loop is unreliable, trying to continue OK.
+			Found Macronix flash chip "MX25L1605" (2048 kB, SPI) on buspirate_spi.
+			Reading old flash chip contents... done.
+			Erasing and writing flash chip... Erase/write done.
+			Verifying flash... VERIFIED. 
+
+ +

+ At the end it says "VERIFIED", which means that the procedure worked. If you see this, it means that you can put your X60T back together. So let's do that now. +

+ +

+ Reverse the steps to re-assemble your machine. +

+ +
+ +

+ Copyright © 2014 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. +

+ + + -- cgit v0.9.1