Documentation: *major* cleanup.

Cleanup was long overdue. Old structure was messy and inefficient.
author: Francis Rowe <info@gluglug.org.uk> 2014-11-05 20:52:36 (EST)
committer: Francis Rowe <info@gluglug.org.uk> 2014-11-05 20:52:36 (EST)
commit: 8b2219bfa2da36e7809588ef723a10483a6e137f (patch)
tree: 8c4d74b9efbdabc1a2604b8cbd508c006c225241 /docs/install
parent: 7429bdcdbb4fc51c61897115112468642afeecfc (diff)
download: libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.zip
libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.tar.gz
libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.tar.bz2
4 files changed, 1231 insertions, 0 deletions
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 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1">
+
+	<style type="text/css">
+		@import url('../css/main.css');
+	</style>
+
+	<title>Installing libreboot</title>
+</head>
+
+<body>
+
+	<h1 id="pagetop">Installing libreboot</h1>
+		<p>
+			This section relates to installing libreboot on supported targets.
+		</p>
+		<p>
+			Or <a href="../index.html">Back to main index</a>.
+		</p>
+		<h2>Installing libreboot (software)</h2>
+			<ul>
+				<li><a href="#rom">Recommended ROM's to flash</a></li>
+				<li><a href="#flashrom_lenovobios">X60/X60S/X60T/T60: How to flash your ROM (if running Lenovo BIOS firmware)</a></li>
+				<li><a href="#flashrom_macbook21">macbook21: How to flash your ROM (if running Apple EFI firmware)</a></li>
+				<li><a href="#flashrom">X60/X60S/X60T/T60/macbook21: How to flash your ROM (if running libreboot or coreboot already)</a></li>
+			</ul>
+
+		<h2>Installing libreboot (hardware)</h2>
+			<ul>
+				<li><a href="x60_unbrick.html">ThinkPad X60/X60S: How to unbrick</a></li>
+				<li><a href="x60tablet_unbrick.html">ThinkPad X60 Tablet: How to unbrick</a></li>
+				<li><a href="t60_unbrick.html">ThinkPad T60: How to unbrick</a></li>
+			</ul>
+
+<hr/>
+
+	<h1 id="rom">Recommended ROM's to flash</h1>
+
+		<p>
+			List of directories corresponding to each board:
+		</p>
+			<ul>
+				<li>ThinkPad X60, X60s: <b>bin/x60/</b></li>
+				<li>ThinkPad X60 Tablet: <b>bin/x60t/</b></li>
+				<li>ThinkPad T60: <b>bin/t60/</b> (note, see <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>)</li>
+				<li>Apple MacBook2,1: <b>bin/macbook21/</b></li>
+				<li>Apple MacBook1,1: <b>bin/macbook21/</b> (it's not a typo; the same ROM's work)</li>
+			</ul>
+
+		<p>These images use coreboot text-mode graphics:</p>
+			<ul>
+				<li>US Qwerty keyboard: <b>libreboot_usqwerty_txtmode.rom</b></li>
+				<li>UK Qwerty keyboard: <b>libreboot_ukqwerty_txtmode.rom</b></li>
+				<li>US Dvorak keyboard: <b>libreboot_usdvorak_txtmode.rom</b></li>
+				<li>UK Dvorak keyboard: <b>libreboot_ukdvorak_txtmode.rom</b></li>
+				<li>French Azerty keyboard: <b>libreboot_frazerty_txtmode.rom</b></li>
+				<li>Italian Qwerty keyboard: <b>libreboot_itqwerty_txtmode.rom</b></li>
+				<li>Swedish Qwerty keyboard: <b>libreboot_svenska_txtmode.rom</b></li>
+			</ul>
+		<p>These images use coreboot framebuffer graphics:</p>
+			<ul>
+				<li>US Qwerty keyboard: <b>libreboot_usqwerty_vesafb.rom</b></li>
+				<li>UK Qwerty keyboard: <b>libreboot_ukqwerty_vesafb.rom</b></li>
+				<li>US Dvorak keyboard: <b>libreboot_usdvorak_vesafb.rom</b></li>
+				<li>UK Dvorak keyboard: <b>libreboot_ukdvorak_vesafb.rom</b></li>
+				<li>French Azerty keyboard: <b>libreboot_frazerty_vesafb.rom</b></li>
+				<li>Italian Qwerty keyboard: <b>libreboot_itqwerty_vesafb.rom</b></li>
+				<li>Swedish Qwerty keyboard: <b>libreboot_svenska_vesafb.rom</b></li>
+			</ul>
+
+		<p>
+			_txtmode images come with a working MemTest86+ and GRUB Invaders, both of which require text-mode.
+			_vesafb images are recommended in most cases.
+		</p>
+
+		<p>
+			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).
+			<a href="../grub/index.html#grub_keyboard">../grub/index.html#grub_keyboard</a> 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.
+		</p>
+
+		<p><a href="#pagetop">Back to top of page.</a></p>
+
+<hr/>
+
+	<h1 id="flashrom_lenovobios">X60/X60S/X60T/T60: How to flash the ROM's onto your machine (if running Lenovo BIOS firmware).</h1>
+
+		<div class="important">
+
+			<p>
+				Hover over the next paragraph to make it black.
+			</p>
+			<p class="lenovobios">
+				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: 
+				<a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.<br/>
+				Do not make this decision lightly! This is your last and only chance.
+			</p>
+
+			<p>
+				The following is for the libreboot image and *not* the factory bios dump:
+			</p>
+			<p>
+				Check the last two 64K regions in your ROM file (libreboot.rom in this example):<br/>
+				<b>$ dd if=libreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s libreboot.rom) - 0x10000] count=64k</b><br/>
+				<b>$ dd if=libreboot.rom of=lower64k.bin bs=1 skip=$[$(stat -c %s libreboot.rom) - 0x20000] count=64k</b><br/>
+				<b>$ sha512sum lower64k.bin top64k.bin</b><br/>
+				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 <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">coreboot wiki</a>):<br/>
+				<b>$ dd if=top64k.bin of=libreboot.rom bs=1 seek=$[$(stat -c %s libreboot.rom) - 0x20000] count=64k conv=notrunc</b><br/>
+				After this, the ROM will be safe to flash. Explanation is provided in <a href="../git/index.html#build_bucts">../git/index.html#build_bucts</a>.
+			</p>
+
+		</div>
+
+		<p><b>This is for the ThinkPad X60 and T60 while running Lenovo BIOS. If you already have coreboot or libreboot running,
+		then go to <a href="#flashrom">#flashrom</a> instead!</b></p>
+
+		<p><b>If you are flashing a Lenovo ThinkPad T60, be sure to read <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a></b></p>
+
+		<p>
+			First, <a href="../git/index.html#build_dependencies">install the build dependencies</a>.
+		</p>
+
+		<div class="important">
+
+			<p>
+				<b>
+					Before you proceed, make *sure* to build flashrom and bucts from source. Both are provided. This is very important!
+				</b>
+			</p>
+				<ul>
+					<li><a href="../git/index.html#build_flashrom">How to build flashrom from source</a></li>
+					<li><a href="../git/index.html#build_bucts">How to build bucts from source</a></li>
+				</ul>
+
+		</div>
+
+		<p>&quot;YOURBOARD/YOURROM&quot; should be replaced with what is correct as per <a href="#rom">#rom</a>. Alternatively
+		you may be using your own custom ROM. Adapt.</p>
+
+		<p>
+			Run the script:<br/>
+			<b>$ sudo ./lenovobios_firstflash bin/<a href="#rom">YOURBOARD/YOURROM</a>.</b>
+		</p>
+
+		<div class="important">
+
+			<p>
+				You should see within the output the following:<br/>
+				<b>&quot;Updated BUC.TS=1 - 64kb address ranges at 0xFFFE0000 and 0xFFFF0000 are swapped&quot;</b>.
+			</p>
+
+			<p>
+				You should also see within the output the following:<br/>
+				<b>&quot;Flash chip is in an unknown state&quot;</b>, <b>&quot;FAILED&quot;</b> and <b>&quot;DO NOT SHUTDOWN OR REBOOT&quot;</b><br/>
+				Seeing this means that the operation was a <b>resounding</b> success! <b>DON'T PANIC</b>.
+			</p>
+
+			<p>
+				See this link for more details: 
+				<a href="http://thread.gmane.org/gmane.linux.bios.flashrom/575">http://thread.gmane.org/gmane.linux.bios.flashrom/575</a>.
+			</p>
+
+			<p>
+				If the above is what you see, then <b>SHUT DOWN</b>. Wait a few seconds, and then boot; libreboot is running, but there is a 2nd procedure <b>*needed*</b> (see below).
+			</p>
+
+		</div>
+
+		<p>
+			<b>
+				If you boot and you see nothing, try turning up the backlight (Fn+Home).
+			</b>
+		</p>
+
+		<p>
+			When you have booted up again:<br/>
+			<b>$ sudo ./lenovobios_secondflash bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
+		</p>
+
+		<div class="important">
+
+			<p>
+				You should see within the output the following:<br/>
+				<b>&quot;Updated BUC.TS=0 - 128kb address range 0xFFFE0000-0xFFFFFFFF is untranslated&quot;</b>
+			</p>
+
+			<p>
+				You should also see within the output the following:<br/>
+				<b>&quot;Verifying flash... VERIFIED.&quot;</b>
+			</p>
+
+			<p>Shut down again, wait a few seconds, and then boot.</p>
+
+		</div>
+
+		<p>
+			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 <a href="../security/x60_security.html">../security/x60_security.html</a> and
+			<a href="../security/t60_security.html">../security/t60_security.html</a>.
+		</p>
+
+		<p><a href="#pagetop">Back to top of page.</a></p>
+
+<hr/>
+
+	<h1 id="flashrom_macbook21">macbook21: How to flash your ROM (if running Apple EFI firmware)</h1>
+
+		<div class="important">
+
+			<p>
+				Hover over the next paragraph to make it black.
+			</p>
+			<p class="lenovobios">
+				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: 
+				<a href="http://www.coreboot.org/Board:apple/macbook21">http://www.coreboot.org/Board:apple/macbook21</a>.<br/>
+				Do not make this decision lightly! This is (very likely) your last and only chance.
+			</p>
+
+			<p>
+				(this theory is untested at the time of writing)
+			</p>
+
+			<p>
+				Note: <b>If you have a MacBook1,1 then these instructions will not work. See <a href="../hcl/index.html#macbook11">../hcl/index.html#macbook11</a> for MacBook1,1 flashing instructions.</b>
+			</p>
+
+		</div>
+
+		<p>
+			<b>
+				This is for the MacBook2,1 while running Apple EFI firmware. If you already have 
+				coreboot or libreboot running, then go to <a href="#flashrom">#flashrom</a> instead!
+			</b>
+		</p>
+
+		<p>
+			Be sure to read the information in <a href="../hcl/index.html#macbook21">../hcl/index.html#macbook21</a>.
+		</p>
+
+		<p>
+			First, <a href="../git/index.html#build_dependencies">install the build dependencies</a>.
+		</p>
+
+		<div class="important">
+
+			<p>
+				<b>
+					Before you proceed, make *sure* to build flashrom from source. This is very important!
+				</b>
+			</p>
+				<ul>
+					<li><a href="../git/index.html#build_flashrom">How to build flashrom from source</a></li>
+				</ul>
+
+		</div>
+
+		<p>
+			Look at <a href="#rom">#rom</a> to see which ROM is suitable for your machine. Alternatively you may be using your own
+			custom ROM. Adapt.
+		</p>
+
+		<p>
+			Flashing is actually easy (compared to X60/T60).<br/>
+			<b>$ sudo flashrom -p internal:laptop=force_I_want_a_brick -w bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
+		</p>
+
+		<p>
+			Alternatively, a script is provided which does the same thing:<br/>
+			<b>$ sudo ./macbook21_firstflash bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
+		</p>
+
+		<div class="important">
+
+			<p>
+				You should also see within the output the following:<br/>
+				<b>&quot;Verifying flash... VERIFIED.&quot;</b>
+			</p>
+
+			<p>
+				If you see that, great! Shut down now (power off). Wait a few seconds and then boot!
+			</p>
+
+			<p>
+				<b>
+					If you boot and you see nothing, try turning up the backlight (F2 for macbook21). 
+				</b>
+			</p>
+
+
+		</div>
+
+		<p><a href="#pagetop">Back to top of page.</a></p>
+
+<hr/>
+
+	<h1 id="flashrom">X60/X60S/X60T/T60/macbook21: How to flash the ROM's onto your machine (if running libreboot or coreboot already)</h1>
+
+		<p>
+			<b>
+				These instructions work for the Lenovo ThinkPad X60/X60S/X60T/T60 and Apple MacBook2,1.
+			</b>
+		</p>
+		<p>
+			<b>
+				This assumes that you already have coreboot or libreboot running.
+			</b>
+		</p>
+		<p>
+			<b>
+				If you have Lenovo BIOS running (X60/X60S/X60T/T60), go to <a href="#flashrom_lenovobios">#flashrom_lenovobios</a> instead.
+			</b>
+		</p>
+		<p>
+			<b>
+				If you have Apple EFI firmware running (macbook21), go to <a href="#flashrom_macbook21">#flashrom_macbook21</a> instead.
+			</b>
+		</p>
+		<p>
+			<b>
+				If you are flashing a Lenovo ThinkPad T60, be sure to read <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>.
+			</b>
+		</p>
+		<p>
+			<b>
+				If you are flashing an Apple MacBook2,1, be sure to read the information in <a href="../hcl/index.html#macbook21">../hcl/index.html#macbook21</a>.
+			</b>
+		</p>
+		<p>
+			First, <a href="../git/index.html#build_dependencies">install the build dependencies</a>.
+		</p>
+		<div class="important">
+
+			<p>
+				<b>
+					Before you proceed, make *sure* to build flashrom from source. This is very important!
+				</b>
+			</p>
+				<ul>
+					<li><a href="../git/index.html#build_flashrom">How to build flashrom from source</a></li>
+				</ul>
+
+		</div>
+		<p>
+			Look at <a href="#rom">#rom</a> to see which ROM is suitable for your machine. Alternative you may be using your own
+			custom ROM. Adapt.
+		</p>
+		<p>
+			Flash the ROM:<br/>
+			<b>$ sudo ./flash bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
+		</p>
+
+		<div class="important">
+
+			<p>
+				You should see <b>&quot;Verifying flash... VERIFIED.&quot;</b> written at the end of the flashrom output. <b>SHUT DOWN</b>
+				after you see this, and then boot up again after a few seconds.
+			</p>
+
+			<p>
+				<b>
+					If you boot and you see nothing, try turning up the backlight (Fn+Home for X60/X60S/X60T/T60, F2 for macbook21). 
+				</b>
+			</p>
+
+		</div>
+
+		<p>
+			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 <a href="../security/x60_security.html">../security/x60_security.html</a> and
+			<a href="../security/t60_security.html">../security/t60_security.html</a>.
+		</p>
+
+		<p><a href="#pagetop">Back to top of page</a></p>
+
+<hr/>
+
+	<p>
+		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
+		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 <a href="../license.txt">../license.txt</a>.
+	</p>
+
+	<p>
+		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 <a href="../license.txt">../license.txt</a> for more information.
+	</p>
+
+</body>
+</html>
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 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1">
+
+	<style type="text/css">
+		@import url('../css/main.css');
+	</style>
+
+	<title>Libreboot documentation: Unbricking the ThinkPad T60</title>
+</head>
+
+<body>
+
+	<header>
+		<h1>Unbricking the ThinkPad T60</h1>
+		<aside>This guide will show you how to recover from a bad flash that prevents your ThinkPad T60 from booting.</aside>
+	</header>
+
+	<p>Or go <a href="index.html">back to main index</a></p>
+
+	<h2>Table of Contents</h2>
+		<ul>
+			<li><a href="#hardware_requirements">Hardware Requirements</a></li>
+			<li><a href="#software_requirements">Software Requirements</a></li>
+			<li>
+				Types of brick:
+				<ul>
+					<li><a href="#bucts_brick">Brick type 1: bucts not reset</a></li>
+					<li><a href="#recovery">Brick type 2: bad rom (or user error), machine won't boot</a></li>
+				</ul>
+			</li>
+		</ul>
+
+	<h1 id="hardware_requirements">Hardware requirements</h1>
+		<ul>
+			<li>a 2nd computer (maybe another T60. any computer will do)</li>
+			<li>external flashrom-compatible programmer (I'm using the "bus pirate")
+			<li>SOIC-8 IC clip (I'm using the Pomona 5250)</li>
+			<li>Cable (programmer&lt;&gt;clip) - mine came with the bus pirate.</li>
+			<li>USB mini a to b cable (for buspirate&lt;&gt;computer connection).</li>
+			<li>rubbing a***hol (misspelling intentional. halal internet) and thermal compound for changing CPU heatsink (procedure involves removing heatsink)</li>
+		</ul>
+
+	<h1 id="software_requirements">Software requirements</h1>
+		<ul>
+			<li>GNU/Linux (on the 2nd computer)</li>
+			<li>flashrom software (on the 2nd computer): <a href="http://flashrom.org/">http://flashrom.org/</a>
+		</ul>
+
+	<h1 id="bucts_brick">Brick type 1: bucts not reset.</h1>
+		<p>
+			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.<br/><br/>
+
+			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:<br/>
+			<img src="../images/t60_dev/0006.JPG" alt="" /><br/><br/>
+
+			*Those dd commands should be applied to all newly compiled T60 ROM's (the ROM's in libreboot binary archives already have this applied!):<br/>
+			dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k<br/>
+			dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump<br/>
+			dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc<br/>
+			(doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running,
+			using those instructions: <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.
+			(it says x60, but instructions for t60 are identical)
+		</p>
+
+	<h1 id="recovery">bad rom (or user error), machine won't boot</h1>
+
+		<p>
+			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.
+		</p>
+		<p>
+			&quot;Unbricking&quot; 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).
+		</p>
+
+		<p>
+			Remove those screws and remove the HDD:<br/>
+			<img src="../images/t60_dev/0001.JPG" alt="" /> <img src="../images/t60_dev/0002.JPG" alt="" />
+		</p>
+
+		<p>
+			Lift off the palm rest:<br/>
+			<img src="../images/t60_dev/0003.JPG" alt="" />
+		</p>
+
+		<p>
+			Lift up the keyboard, pull it back a bit, flip it over like that and then disconnect it from the board:<br/>
+			<img src="../images/t60_dev/0004.JPG" alt="" /> <img src="../images/t60_dev/0005.JPG" alt="" /> <img src="../images/t60_dev/0006.JPG" alt="" />
+		</p>
+
+		<p>
+			Gently wedge both sides loose:<br/>
+			<img src="../images/t60_dev/0007.JPG" alt="" /> <img src="../images/t60_dev/0008.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove that cable from the position:<br/>
+			<img src="../images/t60_dev/0009.JPG" alt="" /> <img src="../images/t60_dev/0010.JPG" alt="" />
+		</p>
+
+		<p>
+			Now remove that bezel. Remove wifi, nvram battery and speaker connector (also remove 56k modem, on the left of wifi):<br/>
+			<img src="../images/t60_dev/0011.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove those screws:<br/>
+			<img src="../images/t60_dev/0012.JPG" alt="" />
+		</p>
+
+		<p>
+			Disconnect the power jack:<br/>
+			<img src="../images/t60_dev/0013.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove nvram battery:<br/>
+			<img src="../images/t60_dev/0014.JPG" alt="" />
+		</p>
+
+		<p>
+			Disconnect cable (for 56k modem) and disconnect the other cable:<br/>
+			<img src="../images/t60_dev/0015.JPG" alt="" /> <img src="../images/t60_dev/0016.JPG" alt="" />
+		</p>
+
+		<p>
+			Disconnect speaker cable:<br/>
+			<img src="../images/t60_dev/0017.JPG" alt="" />
+		</p>
+
+		<p>
+			Disconnect the other end of the 56k modem cable:<br/>
+			<img src="../images/t60_dev/0018.JPG" alt="" />
+		</p>
+
+		<p>
+			Make sure you removed it:<br/>
+			<img src="../images/t60_dev/0019.JPG" alt="" />
+		</p>
+
+		<p>
+			Unscrew those:<br/>
+			<img src="../images/t60_dev/0020.JPG" alt="" />
+		</p>
+
+		<p>
+			Make sure you removed those:<br/>
+			<img src="../images/t60_dev/0021.JPG" alt="" />
+		</p>
+
+		<p>
+			Disconnect LCD cable from board:<br/>
+			<img src="../images/t60_dev/0022.JPG" alt="" />
+		</p>
+
+		<p> 
+			Remove those screws then remove the LCD assembly:<br/>
+			<img src="../images/t60_dev/0023.JPG" alt="" /> <img src="../images/t60_dev/0024.JPG" alt="" /> <img src="../images/t60_dev/0025.JPG" alt="" />
+		</p>
+
+		<p>
+			Once again, make sure you removed those:<br/>
+			<img src="../images/t60_dev/0026.JPG" alt="" />
+		</p>
+
+		<p>
+			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:<br/>
+			<img src="../images/t60_dev/0027.JPG" alt="" /> <img src="../images/t60_dev/0028.JPG" alt="" /> <img src="../images/t60_dev/0029.JPG" alt="" />
+			<img src="../images/t60_dev/0031.JPG" alt="" /> <img src="../images/t60_dev/0032.JPG" alt="" /> <img src="../images/t60_dev/0033.JPG" alt="" />
+		</p>
+
+		<p>
+			At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):<br/>
+			<a href="http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts">http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts</a>.<br/>
+			Correlating with the following information, I was able to wire up my pirate correctly:<br/>
+			<a href="http://flashrom.org/Bus_Pirate#Connections">http://flashrom.org/Bus_Pirate#Connections</a><br/>
+			And by following that advice:<br/>
+			<a href="http://www.coreboot.org/Board:lenovo/x60/Installation#Howto">http://www.coreboot.org/Board:lenovo/x60/Installation#Howto</a>.<br/>
+			(it says X60 but instructions are virtually the same for the T60, with except to physical differences in how to disassemble the machine)<br/>
+			Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.<br/>
+			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).<br/>
+			Note: I ignored that advice, and wired up all 8 pins. And it worked.<br/>
+
+			Here is the pinout (correlate it with your programmer's documentation):<br/>
+			<img src="../images/t60_dev/0030.JPG" alt="" />
+		</p>
+
+		<p>
+			Connecting the pomona:<br/>
+			<img src="../images/t60_dev/0034.JPG" alt="" />
+		</p>
+
+		<p>
+			Connect programmer to 2nd computer:<br/>
+			<img src="../images/t60_dev/0035.JPG" alt="" />
+		</p>
+
+		<p>
+			Programmer has power:<br/>
+			<img src="../images/t60_dev/0036.JPG" alt="" />
+		</p>
+
+		<p>
+			Now flash the bricked machine using the 2nd computer. in my case I did:<br/>
+			<b>flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/t60/libreboot_usqwerty.rom</b><br/>
+			Note: there are also other ROM images for T60<br/>
+			Note: this is using buspirate as the programmer, so it is flashing the T60, not the 2nd computer!<br/>
+			Here's my terminal window on the 2nd computer (also the programmer is active):<br/>
+			<img src="../images/t60_dev/0037.JPG" alt="" /> <img src="../images/t60_dev/0038.JPG" alt="" /><br/>
+			So, you should see the following:<br/>
+			--
+		</p>
+			<pre>
+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. 
+</pre>
+		<p>
+			--<br/>
+			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.
+		</p>
+
+		<p>
+			Put those screws back:<br/>
+			<img src="../images/t60_dev/0047.JPG" alt="" />
+		</p>
+
+		<p>
+			Put it back into lower chassis:<br/>
+			<img src="../images/t60_dev/0048.JPG" alt="" />
+		</p>
+
+		<p>
+			Attach LCD and insert screws (also, attach the lcd cable to the board):<br/>
+			<img src="../images/t60_dev/0049.JPG" alt="" />
+		</p>
+
+		<p>
+			Insert those screws:<br/>
+			<img src="../images/t60_dev/0050.JPG" alt="" />
+		</p>
+
+		<p>
+			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<br/>
+			<img src="../images/t60_dev/0051.JPG" alt="" />
+		</p>
+
+		<p>
+			Attach the heatsink and install the screws (also, make sure to install the AC jack as highlighted):<br/>
+			<img src="../images/t60_dev/0052.JPG" alt="" />
+		</p>
+
+		<p>
+			Reinstall that upper bezel:<br/>
+			<img src="../images/t60_dev/0053.JPG" alt="" />
+		</p>
+
+		<p>
+			Do that:<br/>
+			<img src="../images/t60_dev/0054.JPG" alt="" /> <img src="../images/t60_dev/0055.JPG" alt="" />
+		</p>
+
+		<p>
+			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.
+		</p>
+
+		<p>
+			Attach keyboard and install nvram battery:<br/>
+			<img src="../images/t60_dev/0056.JPG" alt="" /> <img src="../images/t60_dev/0057.JPG" alt="" />
+		</p>
+
+		<p>
+			Place keyboard and (sorry, forgot to take pics) reinstall the palmrest and insert screws on the underside:<br/>
+			<img src="../images/t60_dev/0058.JPG" alt="" />
+		</p>
+
+		<p>
+			It lives!<br/>
+			<img src="../images/t60_dev/0071.JPG" alt="" /> <img src="../images/t60_dev/0072.JPG" alt="" /> <img src="../images/t60_dev/0073.JPG" alt="" />
+		</p>
+
+		<p>
+			Always stress test ('stress -c 2' and xsensors. below 90C is ok) when replacing cpu paste/heatsink:<br/>
+			<img src="../images/t60_dev/0074.JPG" alt="" />
+		</p>
+
+<hr/>
+
+	<p>
+		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
+		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 <a href="../license.txt">../license.txt</a>.
+	</p>
+
+	<p>
+		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 <a href="../license.txt">../license.txt</a> for more information.
+	</p>
+
+</body>
+</html>
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 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1">
+
+	<style type="text/css">
+		@import url('../css/main.css');
+	</style>
+
+	<title>Libreboot documentation: Unbricking the ThinkPad X60</title>
+</head>
+
+<body>
+
+	<header>
+		<h1>Unbricking the ThinkPad X60</h1>
+		<aside>This guide will show you how to recover from a bad flash that prevents your ThinkPad X60 from booting.</aside>
+	</header>
+
+	<p>Or go <a href="index.html">back to main index</a></p>
+
+	<h2>Table of Contents</h2>
+		<ul>
+			<li><a href="#hardware_requirements">Hardware Requirements</a></li>
+			<li><a href="#software_requirements">Software Requirements</a></li>
+			<li>
+				Types of brick:
+				<ul>
+					<li><a href="#bucts_brick">Brick type 1: bucts not reset</a></li>
+					<li><a href="#recovery">Brick type 2: bad rom (or user error), machine won't boot</a></li>
+				</ul>
+			</li>
+		</ul>
+
+	<h1 id="hardware_requirements">Hardware requirements</h1>
+		<ul>
+			<li>a 2nd computer (maybe another X60. any computer will do)</li>
+			<li>external flashrom-compatible programmer (I'm using the "bus pirate")
+			<li>SOIC-8 IC clip (I'm using the Pomona 5250)</li>
+			<li>Cable (programmer&lt;&gt;clip) - mine came with the bus pirate.</li>
+			<li>USB mini a to b cable (for buspirate&lt;&gt;computer connection).</li>
+		</ul>
+
+	<h1 id="software_requirements">Software requirements</h1>
+		<ul>
+			<li>GNU/Linux (on the 2nd computer)</li>
+			<li>flashrom software (on the 2nd computer): <a href="http://flashrom.org/">http://flashrom.org/</a>
+		</ul>
+
+	<h1 id="bucts_brick">Brick type 1: bucts not reset.</h1>
+		<p>
+			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.<br/><br/>
+
+			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:<br/>
+			<img src="../images/x60_unbrick/0004.jpg" alt="" /><br/><br/>
+
+			*Those dd commands should be applied to all newly compiled X60 ROM's (the ROM's in libreboot binary archives already have this applied!):<br/>
+			dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k<br/>
+			dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump<br/>
+			dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc<br/>
+			(doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running,
+			using those instructions: <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.
+		</p>
+
+	<h1 id="recovery">bad rom (or user error), machine won't boot</h1>
+		<p>
+			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.
+		</p>
+		<p>
+			&quot;Unbricking&quot; 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).
+		</p>
+		<p>
+			Remove those screws:<br/>
+			<img src="../images/x60_unbrick/0000.jpg" alt="" />
+		</p>
+		<p>
+			Push the keyboard forward (carefully):<br/>
+			<img src="../images/x60_unbrick/0001.jpg" alt="" />
+		</p>
+		<p>
+			Lift the keyboard up and disconnect it from the board:<br/>
+			<img src="../images/x60_unbrick/0002.jpg" alt="" />
+		</p>
+		<p>
+			Grab the right-hand side of the chassis and force it off (gently) and pry up the rest of the chassis:<br/>
+			<img src="../images/x60_unbrick/0003.jpg" alt="" />
+		</p>
+		<p>
+			You should now have this:<br/>
+			<img src="../images/x60_unbrick/0004.jpg" alt="" />
+		</p>
+		<p>
+			Disconnect the wifi antenna cables, the modem cable and the speaker:<br/>
+			<img src="../images/x60_unbrick/0005.jpg" alt="" />
+		</p>
+		<p>
+			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:<br/>
+			<img src="../images/x60_unbrick/0006.jpg" alt="" />
+		</p>
+		<p>
+			Disconnect the monitor from the motherboard, and unroute the grey antenna cable, carefully lifting the tape
+			that holds it into place:<br/>
+			<img src="../images/x60_unbrick/0008.jpg" alt="" />
+		</p>
+		<p>
+			Carefully lift the remaining tape and unroute the left antenna cable so that it is loose:<br/>
+			<img src="../images/x60_unbrick/0009.jpg" alt="" />
+		</p>
+		<p>
+			Remove the screw that is highlighted (do NOT remove the other one; it holds part of the heatsink (other side) into place):<br/>
+			<img src="../images/x60_unbrick/0011.jpg" alt="" />
+		</p>
+		<p>
+			Remove those screws:<br/>
+			<img src="../images/x60_unbrick/0012.jpg" alt="" />
+		</p>
+		<p>
+			Carefully remove the plate, like so:<br/>
+			<img src="../images/x60_unbrick/0013.jpg" alt="" />
+		</p>
+		<p>
+			Remove the SATA connector:<br/>
+			<img src="../images/x60_unbrick/0014.jpg" alt="" />
+		</p>
+		<p>
+			Now remove the motherboard (gently) and cast the lcd/chassis aside:<br/>
+			<img src="../images/x60_unbrick/0015.jpg" alt="" />
+		</p>
+		<p>
+			Lift back that tape and hold it with something. Highlighted is the SPI flash chip:<br/>
+			<img src="../images/x60_unbrick/0016.jpg" alt="" />
+		</p>
+		<p>
+			At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):<br/>
+			<a href="http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts">http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts</a>.<br/>
+			Correlating with the following information, I was able to wire up my pirate correctly:<br/>
+			<a href="http://flashrom.org/Bus_Pirate#Connections">http://flashrom.org/Bus_Pirate#Connections</a><br/>
+			And by following that advice:<br/>
+			<a href="http://www.coreboot.org/Board:lenovo/x60/Installation#Howto">http://www.coreboot.org/Board:lenovo/x60/Installation#Howto</a>.<br/>
+			Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.<br/>
+			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).<br/>
+			Note: I ignored that advice, and wired up all 8 pins. And it worked.<br/>
+
+			Here is the pinout (correlate it with your programmer's documentation):<br/>
+			<img src="../images/x60_unbrick/0017.jpg" alt="" />
+		</p>
+
+		<p>
+			My programmer (bus pirate):<br/>
+			<img src="../images/x60_unbrick/0019.jpg" alt="" /><br/>
+			My clip (pomona 5250):<br/>
+			<img src="../images/x60_unbrick/0020.jpg" alt="" /><br/>
+			Connecting the pomona:<br/>
+			<img src="../images/x60_unbrick/0022.jpg" alt="" /><br/>
+			Connecting the USB cable from programmer to 2nd(working/non-bricked) computer, my T60:<br/>
+			<img src="../images/x60_unbrick/0024.jpg" alt="" /><br/>
+			Now I install flashrom on the T60 (running Trisquel GNU/Linux) and do this:<br/>
+			<b>flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/x60/libreboot_usqwerty.rom</b><br/>
+			Note: there are also other ROM images for X60<br/>
+			Note: this is using buspirate as the programmer, so it is flashing the X60, not the T60!<br/>
+			Here's my terminal window on the T60:<br/>
+			<img src="../images/x60_unbrick/0025.jpg" alt="" /><br/>
+			So, you should see the following:<br/>
+			--
+		</p>
+<pre>
+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. 
+</pre>
+		<p>
+			--<br/>
+			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.
+		</p>
+		<p>
+			Remove the programmer and put it away somewhere. Put back the tape and press firmly over it:<br/>
+			<img src="../images/x60_unbrick/0026.jpg" alt="" />
+		</p>
+		<p>
+			Your empty chassis:<br/>
+			<img src="../images/x60_unbrick/0027.jpg" alt="" />
+		</p>
+		<p>
+			Put the motherboard back in:<br/>
+			<img src="../images/x60_unbrick/0028.jpg" alt="" />
+		</p>
+		<p>
+			Reconnect SATA:<br/>
+			<img src="../images/x60_unbrick/0029.jpg" alt="" />
+		</p>
+		<p>
+			Put the plate back and re-insert those screws:<br/>
+			<img src="../images/x60_unbrick/0030.jpg" alt="" />
+		</p>
+		<p>
+			Re-route that antenna cable around the fan and apply the tape:<br/>
+			<img src="../images/x60_unbrick/0031.jpg" alt="" />
+		</p>
+		<p>
+			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:<br/>
+			<img src="../images/x60_unbrick/0032.jpg" alt="" />
+		</p>
+		<p>
+			Re-insert that screw:<br/>
+			<img src="../images/x60_unbrick/0033.jpg" alt="" />
+		</p>
+		<p>
+			Route the black antenna cable like so:<br/>
+			<img src="../images/x60_unbrick/0034.jpg" alt="" />
+		</p>
+		<p>
+			Tuck it in neatly like so:<br/>
+			<img src="../images/x60_unbrick/0035.jpg" alt="" />
+		</p>
+		<p>
+			Route the modem cable like so:<br/>
+			<img src="../images/x60_unbrick/0036.jpg" alt="" />
+		</p>
+		<p>
+			Connect modem cable to board and tuck it in neatly like so:<br/>
+			<img src="../images/x60_unbrick/0037.jpg" alt="" />
+		</p>
+		<p>
+			Route the power connection and connect it to the board like so:<br/>
+			<img src="../images/x60_unbrick/0038.jpg" alt="" />
+		</p>
+		<p>
+			Route the antenna and modem cables neatly like so:<br/>
+			<img src="../images/x60_unbrick/0039.jpg" alt="" />
+		</p>
+		<p>
+			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):<br/>
+			<img src="../images/x60_unbrick/0040.jpg" alt="" />
+		</p>
+		<p>
+			Connect the modem cable:<br/>
+			<img src="../images/x60_unbrick/0041.jpg" alt="" />
+		</p>
+		<p>
+			Connect the speaker:<br/>
+			<img src="../images/x60_unbrick/0042.jpg" alt="" />
+		</p>
+		<p>
+			You should now have this:<br/>
+			<img src="../images/x60_unbrick/0043.jpg" alt="" />
+		</p>
+		<p>
+			Re-connect the upper chassis:<br/>
+			<img src="../images/x60_unbrick/0044.jpg" alt="" />
+		</p>
+		<p>
+			Re-connect the keyboard:<br/>
+			<img src="../images/x60_unbrick/0045.jpg" alt="" />
+		</p>
+		<p>
+			Re-insert the screws that you removed earlier:<br/>
+			<img src="../images/x60_unbrick/0046.jpg" alt="" />
+		</p>
+		<p>
+			Power on!<br/>
+			<img src="../images/x60_unbrick/0047.jpg" alt="" />
+		</p>
+		<p>
+			Trisquel live USB menu (using GRUB's ISOLINUX parser):<br/>
+			<img src="../images/x60_unbrick/0048.jpg" alt="" />
+		</p>
+		<p>
+			Trisquel live desktop:<br/>
+			<img src="../images/x60_unbrick/0049.jpg" alt="" />
+		</p>
+
+<hr/>
+
+	<p>
+		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
+		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 <a href="../license.txt">../license.txt</a>.
+	</p>
+
+	<p>
+		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 <a href="../license.txt">../license.txt</a> for more information.
+	</p>
+
+</body>
+</html>
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 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="utf-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1">
+
+	<style type="text/css">
+		@import url('../css/main.css');
+	</style>
+
+	<title>Libreboot documentation: Unbricking the ThinkPad X60 Tablet</title>
+</head>
+
+<body>
+
+	<header>
+		<h1>Unbricking the ThinkPad X60</h1>
+		<aside>This guide will show you how to recover from a bad flash that prevents your ThinkPad X60 Tablet from booting.</aside>
+	</header>
+
+	<p>Or go <a href="index.html">back to main index</a></p>
+
+	<h2>Table of Contents</h2>
+		<ul>
+			<li><a href="#hardware_requirements">Hardware Requirements</a></li>
+			<li><a href="#software_requirements">Software Requirements</a></li>
+			<li>
+				Types of brick:
+				<ul>
+					<li><a href="#bucts_brick">Brick type 1: bucts not reset</a></li>
+					<li><a href="#recovery">Brick type 2: bad rom (or user error), machine won't boot</a></li>
+				</ul>
+			</li>
+		</ul>
+
+	<h1 id="hardware_requirements">Hardware requirements</h1>
+		<ul>
+			<li>a 2nd computer (maybe another X60 Tablet. any computer will do)</li>
+			<li>external flashrom-compatible programmer (I'm using the "bus pirate")
+			<li>SOIC-8 IC clip (I'm using the Pomona 5250)</li>
+			<li>Cable (programmer&lt;&gt;clip) - mine came with the bus pirate.</li>
+			<li>USB mini a to b cable (for buspirate&lt;&gt;computer connection).</li>
+		</ul>
+
+	<h1 id="software_requirements">Software requirements</h1>
+		<ul>
+			<li>GNU/Linux (on the 2nd computer)</li>
+			<li>flashrom software (on the 2nd computer): <a href="http://flashrom.org/">http://flashrom.org/</a>
+		</ul>
+
+	<h1 id="bucts_brick">Brick type 1: bucts not reset.</h1>
+		<p>
+			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.<br/><br/>
+
+			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:<br/>
+			<img src="../images/x60t_unbrick/0008.JPG" alt="" /><br/><br/>
+
+			*Those dd commands should be applied to all newly compiled X60 ROM's (the ROM's in libreboot binary archives already have this applied!):<br/>
+			dd if=coreboot.rom of=top64k.bin bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x10000] count=64k<br/>
+			dd if=coreboot.rom bs=1 skip=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k | hexdump<br/>
+			dd if=top64k.bin of=coreboot.rom bs=1 seek=$[$(stat -c %s coreboot.rom) - 0x20000] count=64k conv=notrunc<br/>
+			(doing this makes the ROM suitable for use when flashing a machine that still has Lenovo BIOS running,
+			using those instructions: <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.
+		</p>
+
+	<h1 id="recovery">bad rom (or user error), machine won't boot</h1>
+		<p>
+			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.
+		</p>
+		<p>
+			&quot;Unbricking&quot; 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).
+		</p>
+
+		<p>
+			<img src="../images/x60t_unbrick/0000.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove those screws:<br/>
+			<img src="../images/x60t_unbrick/0001.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove the HDD:<br/>
+			<img src="../images/x60t_unbrick/0002.JPG" alt="" />
+		</p>
+
+		<p>
+			Push keyboard forward to loosen it:<br/>
+			<img src="../images/x60t_unbrick/0003.JPG" alt="" />
+		</p>
+
+		<p>
+			Lift:<br/>
+			<img src="../images/x60t_unbrick/0004.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove those:<br/>
+			<img src="../images/x60t_unbrick/0005.JPG" alt="" />
+		</p>
+
+		<p>
+			
+			<img src="../images/x60t_unbrick/0006.JPG" alt="" />
+		</p>
+
+		<p>
+			Also remove that (marked) and unroute the antenna cables:<br/>
+			<img src="../images/x60t_unbrick/0007.JPG" alt="" />
+		</p>
+
+		<p>
+			Some X60T's you have to unroute those too:<br/>
+			<img src="../images/x60t_unbrick/0010.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove the LCD extend board screws. Also remove those screws (see blue marks) and remove/unroute the cables and remove the metal plate:<br/>
+			<img src="../images/x60t_unbrick/0008.JPG" alt="" />
+		</p>
+
+		<p>
+			Remove that screw and then remove the board:<br/>
+			<img src="../images/x60t_unbrick/0009.JPG" alt="" />
+		</p>
+
+		<p>
+			At this point, you should wire up your programmer according to it's documentation. For me, this was (see: "SparkFun cable pin reference"):<br/>
+			<a href="http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts">http://dangerousprototypes.com/docs/Common_Bus_Pirate_cable_pinouts</a>.<br/>
+			Correlating with the following information, I was able to wire up my pirate correctly:<br/>
+			<a href="http://flashrom.org/Bus_Pirate#Connections">http://flashrom.org/Bus_Pirate#Connections</a><br/>
+			And by following that advice:<br/>
+			<a href="http://www.coreboot.org/Board:lenovo/x60/Installation#Howto">http://www.coreboot.org/Board:lenovo/x60/Installation#Howto</a>.<br/>
+			Note: that last page says to wire up only those 5 pins (see below) like that: 1, 2, 4, 5, 6.<br/>
+			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).<br/>
+			Note: I ignored that advice, and wired up all 8 pins. And it worked.<br/>
+
+			Here is the pinout (correlate it with your programmer's documentation):<br/>
+			<img src="../images/x60t_unbrick/0011.JPG" alt="" /><br/>
+			(SPI chip here is on the bottom of the board)
+		</p>
+
+		<p>
+			Bus pirate:<br/>
+			<img src="../images/x60_unbrick/0019.jpg" alt="" /> 
+		</p>
+
+		<p>
+			Pomona 5250:<br/>
+			<img src="../images/x60_unbrick/0020.jpg" alt="" /> 
+		</p>
+
+		<p>
+			Connect pomona:<br/>
+			<img src="../images/x60_unbrick/0022.jpg" alt="" /> 
+		</p>
+
+		<p>
+			Connect pirate to USB on 2nd computer:<br/>
+			<img src="../images/x60_unbrick/0024.jpg" alt="" /> 
+		</p>
+
+		<p>
+			<img src="../images/x60_unbrick/0025.jpg" alt="" /> 
+		</p>
+
+		<p>
+			On the 2nd machine, I did: <b>flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w bin/x60t/libreboot_ukqwerty.rom</b>
+		</p>
+
+		<pre>
+			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. 
+		</pre>
+
+		<p>
+			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. 
+		</p>
+
+		<p>
+			Reverse the steps to re-assemble your machine.
+		</p>
+
+<hr/>
+
+	<p>
+		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
+		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 <a href="../license.txt">../license.txt</a>.
+	</p>
+
+	<p>
+		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 <a href="../license.txt">../license.txt</a> for more information.
+	</p>
+
+</body>
+</html>
author	Francis Rowe <info@gluglug.org.uk>	2014-11-05 20:52:36 (EST)
committer	Francis Rowe <info@gluglug.org.uk>	2014-11-05 20:52:36 (EST)
commit	8b2219bfa2da36e7809588ef723a10483a6e137f (patch)
tree	8c4d74b9efbdabc1a2604b8cbd508c006c225241 /docs/install
parent	7429bdcdbb4fc51c61897115112468642afeecfc (diff)
download	libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.zip libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.tar.gz libreboot-8b2219bfa2da36e7809588ef723a10483a6e137f.tar.bz2