aboutsummaryrefslogtreecommitdiff
path: root/docs/install
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-17 23:15:09 -0700
committerAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-17 23:15:09 -0700
commit1eb5130a1c70a7238548d977e9c6f371c007eed7 (patch)
treeee28aa07cbb52f25b5f468f59ec8d9587edff739 /docs/install
parentb62dbec1e23f03ae944b51fc4b510dc56ed9b83e (diff)
downloadlibrebootfr-1eb5130a1c70a7238548d977e9c6f371c007eed7.tar.gz
librebootfr-1eb5130a1c70a7238548d977e9c6f371c007eed7.zip
It wasn't me, I swear!
Diffstat (limited to 'docs/install')
-rw-r--r--docs/install/bbb_setup.md42
-rw-r--r--docs/install/c201.md42
-rw-r--r--docs/install/d510mo.md9
-rw-r--r--docs/install/d945gclf.md6
-rw-r--r--docs/install/ga-g41m-es2l.md15
-rw-r--r--docs/install/index.md39
-rw-r--r--docs/install/kcma-d8.md3
-rw-r--r--docs/install/kgpe-d16.md3
-rw-r--r--docs/install/r400_external.md114
-rw-r--r--docs/install/rpi_setup.md12
-rw-r--r--docs/install/t400_external.md102
-rw-r--r--docs/install/t500_external.md117
-rw-r--r--docs/install/t60_unbrick.md138
-rw-r--r--docs/install/x200_external.md72
-rw-r--r--docs/install/x60_unbrick.md159
-rw-r--r--docs/install/x60tablet_unbrick.md72
16 files changed, 630 insertions, 315 deletions
diff --git a/docs/install/bbb_setup.md b/docs/install/bbb_setup.md
index 4a219c39..e115d8c4 100644
--- a/docs/install/bbb_setup.md
+++ b/docs/install/bbb_setup.md
@@ -137,7 +137,8 @@ to a thicker piece of wire (you could use a paper clip), or wedge the
male end of the jumper cable into the sides of the hole in the
connector, instead of going through the centre.
-Here is an example set up:\
+Here is an example set up:
+
![](images/x200/psu33.jpg "Copyright © 2015 Patrick "P. J." McDermott <pj@pehjota.net> see license notice at the end of this document")
@@ -157,14 +158,18 @@ Alternatives to SSH (in case SSH fails)
---------------------------------------
You can also use a serial FTDI debug board with GNU Screen, to access
-the serial console.\
+the serial console.
+
# screen /dev/ttyUSB0 115200
-Here are some example photos:\
-![](images/x200/ftdi.jpg) ![](images/x200/ftdi_port.jpg)\
+Here are some example photos:
+
+![](images/x200/ftdi.jpg) ![](images/x200/ftdi_port.jpg)
+
You can also connect the USB cable from the BBB to another computer and
a new network interface will appear, with its own IP address. This is
-directly accessible from SSH, or screen:\
+directly accessible from SSH, or screen:
+
# **screen /dev/ttyACM0 115200**
You can also access the uboot console, using the serial method instead
@@ -210,13 +215,15 @@ contents of this file with:
Run **apt-get update** and **apt-get upgrade** then reboot the BBB,
before continuing.
-Check that the firmware exists:\
+Check that the firmware exists:
+
# ls /lib/firmware/BB-SPI0-01-00A0.*
Output:
/lib/firmware/BB-SPI0-01-00A0.dtbo
-Then:\
+Then:
+
# echo BB-SPI0-01 > /sys/devices/bone\_capemgr.*/slots
# cat /sys/devices/bone\_capemgr.*/slots
Output:
@@ -229,14 +236,16 @@ Output:
5: ff:P-O-L Bone-Black-HDMI,00A0,Texas Instrument,BB-BONELT-HDMI
7: ff:P-O-L Override Board Name,00A0,Override Manuf,BB-SPI0-01
-Verify that the spidev device now exists:\
+Verify that the spidev device now exists:
+
# ls -al /dev/spid*
Output:
crw-rw---T 1 root spi 153, 0 Nov 19 21:07 /dev/spidev1.0
Now the BBB is ready to be used for flashing. Make this persist across
-reboots:\
+reboots:
+
In /etc/default/capemgr add **CAPE=BB-SPI0-01** at the end (or change
the existing **CAPE=** entry to say that, if an entry already exists.
@@ -252,7 +261,8 @@ libreboot\_src, and put the ARM binary for it on your BBB.
Finally, get the ROM image that you would like to flash and put that on
your BBB.
-Now test flashrom:\
+Now test flashrom:
+
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
Output:
@@ -333,7 +343,8 @@ should.**
if you need to extend the 3.3v psu leads, just use the same colour M-F
leads, **but** keep all other leads short (10cm or less)
-You should now have something that looks like this:\
+You should now have something that looks like this:
+
![](images/x200/5252_bbb0.jpg) ![](images/x200/5252_bbb1.jpg)
[Back to top of page.](#pagetop)
@@ -360,9 +371,12 @@ following configuration:
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
-Copyright © 2015 Patrick "P. J." McDermott <pj@pehjota.net>\
-Copyright © 2015 Albin Söderqvist\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
+Copyright © 2015 Patrick "P. J." McDermott <pj@pehjota.net>
+
+Copyright © 2015 Albin Söderqvist
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/c201.md b/docs/install/c201.md
index fb4eb2f7..fbd913ea 100644
--- a/docs/install/c201.md
+++ b/docs/install/c201.md
@@ -23,12 +23,14 @@ flashrom version.
**Google's modified version of flashrom** is free software and its
source code is made available by Google:
-[flashrom](https://chromium.googlesource.com/chromiumos/third_party/flashrom/).\
+[flashrom](https://chromium.googlesource.com/chromiumos/third_party/flashrom/).
+
It is not distributed along with Libreboot yet. However, it is
preinstalled on the device, with ChromeOS.
Installing Libreboot internally requires sufficient privileges on the
-system installed on the device.\
+system installed on the device.
+
When the device has ChromeOS installed (as it does initially), it is
necessary to gain root privileges in ChromeOS, to be able to access a
root shell.
@@ -68,7 +70,8 @@ or by pressing **Ctrl + D**
After the system has booted, root access can be enabled by clicking on
the **Enable debugging features** link. A confirmation dialog will ask
-whether to proceed.\
+whether to proceed.
+
After confirming by clicking **Proceed**, the device will reboot and ask
for the root password to set. Finally, the operation has to be confirmed
by clicking **Enable**.
@@ -147,23 +150,28 @@ transferred to the device.
The following operations have to be executed with root privileges on the
device (e.g. using the *root* account). In addition, the
-**cros-flash-replace** script has to be made executable:\
+**cros-flash-replace** script has to be made executable:
+
# chmod a+x cros-flash-replace
-The SPI flash has to be read first:\
+The SPI flash has to be read first:
+
# flashrom -p host -r flash.img
**Note: it might be a good idea to copy the produced flash.img file at
this point and store it outside of the device for backup purposes.**
-Then, the **cros-flash-replace** script has to be executed as such:\
+Then, the **cros-flash-replace** script has to be executed as such:
+
# ./cros-flash-replace flash.img coreboot ro-frid
If any error is shown, it is definitely a bad idea to go further than
this point.
-The resulting flash image can then be flashed back:\
+The resulting flash image can then be flashed back:
+
# flashrom -p host -w flash.img
-You should also see within the output the following:\
+You should also see within the output the following:
+
**"Verifying flash... VERIFIED."**
Shut down. The device will now boot to Libreboot.
@@ -194,24 +202,29 @@ transferred to the host.
The following operations have to be executed with root privileges on the
host (e.g. using the *root* account). In addition, the
-**cros-flash-replace** script has to be made executable:\
+**cros-flash-replace** script has to be made executable:
+
# chmod a+x cros-flash-replace
-The SPI flash has to be read first (using the right spi programmer):\
+The SPI flash has to be read first (using the right spi programmer):
+
# flashrom -p *programmer* -r flash.img
**Note: it might be a good idea to copy the produced flash.img file at
this point and store it outside of the device for backup purposes.**
-Then, the **cros-flash-replace** script has to be executed as such:\
+Then, the **cros-flash-replace** script has to be executed as such:
+
# ./cros-flash-replace flash.img coreboot ro-frid
If any error is shown, it is definitely a bad idea to go further than
this point.
The resulting flash image can then be flashed back (using the right spi
-programmer):\
+programmer):
+
# flashrom -p *programmer* -w flash.img
-You should also see within the output the following:\
+You should also see within the output the following:
+
**"Verifying flash... VERIFIED."**
The device will now boot to Libreboot.
@@ -231,7 +244,8 @@ See <https://wiki.debian.org/InstallingDebianOn/Asus/C201>.
-Copyright © 2015 Paul Kocialkowski <contact@paulk.fr>\
+Copyright © 2015 Paul Kocialkowski <contact@paulk.fr>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/d510mo.md b/docs/install/d510mo.md
index 84ab442e..b5b163b0 100644
--- a/docs/install/d510mo.md
+++ b/docs/install/d510mo.md
@@ -11,7 +11,8 @@ motherboard while they still have the original BIOS present.
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
[Back to top of page.](#pagetop)
@@ -24,12 +25,14 @@ Flashing instructions {#clip}
Refer to [bbb\_setup.html](bbb_setup.html) for how to set up the BBB for
flashing.
-This is an image of the flash chip, for reference:\
+This is an image of the flash chip, for reference:
+
![](../images/d510mo/d510mo.jpg)
-Copyright © 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/d945gclf.md b/docs/install/d945gclf.md
index 95178304..a2f00eff 100644
--- a/docs/install/d945gclf.md
+++ b/docs/install/d945gclf.md
@@ -17,12 +17,14 @@ Flashing instructions {#clip}
Refer to [bbb\_setup.html](bbb_setup.html) for how to set up the BBB for
external flashing.
-Here is an image of the flash chip:\
+Here is an image of the flash chip:
+
![](../images/d945gclf/d945gclf_spi.jpg)
-Copyright © 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/ga-g41m-es2l.md b/docs/install/ga-g41m-es2l.md
index fbd1052d..bbe7ead3 100644
--- a/docs/install/ga-g41m-es2l.md
+++ b/docs/install/ga-g41m-es2l.md
@@ -11,7 +11,8 @@ motherboard while they still have the original BIOS present.
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
[Back to top of page.](#pagetop)
@@ -28,16 +29,19 @@ by connecting 3v3 to /CS of that chip, so you will actually need 2 test
clips (you also need to connect GND on the chip that you're
disabling).**
-Here is an image of the flash chip:\
+Here is an image of the flash chip:
+
![](../images/ga-g41m-es2l/ga-g41m-es2l.jpg)
Internal flashing is possible. Boot with the proprietary BIOS and
GNU+Linux. There are 2 flash chips (one is backup).
-Flash the first chip:\
+Flash the first chip:
+
**./flashrom -p internal:dualbiosindex=0 -w libreboot.rom**
-Flash the second chip:\
+Flash the second chip:
+
**./flashrom -p internal:dualbiosindex=1 -w libreboot.rom**
NOTE: you can still boot the system with just the main flash chip
@@ -53,7 +57,8 @@ operating system.
-Copyright © 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/index.md b/docs/install/index.md
index c11d6ca2..6c622cc6 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -253,7 +253,8 @@ ROM image, and it should work.**
Flash chip size
---------------
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
All good?
@@ -273,14 +274,16 @@ appropriate executable. It is also possible for you to build these
executables from the libreboot source code archives.
-How to update the flash chip contents:\
+How to update the flash chip contents:
+
$ **sudo ./flash update [yourrom.rom](#rom)**
Ocassionally, coreboot changes the name of a given board. If flashrom
complains about a board mismatch, but you are sure that you chose the
-correct ROM image, then run this alternative command:\
+correct ROM image, then run this alternative command:
+
$ **sudo ./flash forceupdate [yourrom.rom](#rom)**
@@ -319,16 +322,19 @@ the flashing script. do this: *rm -f patch && wget -O flash
https://notabug.org/vimuser/libreboot/raw/9d850543ad90b72e0e333c98075530b31e5d23f1/flash
&& chmod +x flash***
-The first half of the procedure is as follows:\
+The first half of the procedure is as follows:
+
$ **sudo ./flash i945lenovo\_firstflash [yourrom.rom](#rom).**
-You should see within the output the following:\
+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:\
+You should also see within the output the following:
+
**"Your flash chip is in an unknown state"**, **"FAILED"** and
"DO NOT REBOOT OR POWEROFF"
Seeing this means that the operation was a **resounding** success!
@@ -343,20 +349,24 @@ and then boot; libreboot is running, but there is a 2nd procedure
-When you have booted up again, you must also do this:\
+When you have booted up again, you must also do this:
+
$ **sudo ./flash i945lenovo\_secondflash [yourrom.rom](#rom)**
-If flashing fails at this stage, try the following:\
+If flashing fails at this stage, try the following:
+
$ **sudo ./flashrom/i686/flashrom -p
internal:laptop=force\_I\_want\_a\_brick -w [yourrom.rom](#rom)**
-You should see within the output the following:\
+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:\
+You should also see within the output the following:
+
**"Verifying flash... VERIFIED."**
@@ -392,12 +402,14 @@ Look at the [list of ROM images](#rom) to see which image is compatible
with your device.
-Use this flashing script, to install libreboot:\
+Use this flashing script, to install libreboot:
+
$ **sudo ./flash i945apple\_firstflash [yourrom.rom](#rom)**
-You should also see within the output the following:\
+You should also see within the output the following:
+
**"Verifying flash... VERIFIED."**
Shut down.
@@ -407,7 +419,8 @@ Shut down.
-Copyright © 2014, 2015, 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015, 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/kcma-d8.md b/docs/install/kcma-d8.md
index 5f5c7f96..37ab8822 100644
--- a/docs/install/kcma-d8.md
+++ b/docs/install/kcma-d8.md
@@ -37,7 +37,8 @@ extractor tool.
-Copyright © 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/kgpe-d16.md b/docs/install/kgpe-d16.md
index 3110c804..727f0044 100644
--- a/docs/install/kgpe-d16.md
+++ b/docs/install/kgpe-d16.md
@@ -48,7 +48,8 @@ extractor tool.
-Copyright © 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/r400_external.md b/docs/install/r400_external.md
index a6edcab2..33e60550 100644
--- a/docs/install/r400_external.md
+++ b/docs/install/r400_external.md
@@ -72,7 +72,8 @@ See [#paste](#paste).
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# flashrom -p internal -V
[Back to top of page.](#pagetop)
@@ -131,73 +132,95 @@ for SOIC-8 (clip: Pomona 5250):
Disassembly
-----------
-Remove all screws:\
-![](images/r400/0000.jpg)\
-Remove the HDD and optical drive:\
-![](images/r400/0001.jpg)\
-Remove the hinge screws:\
+Remove all screws:
+
+![](images/r400/0000.jpg)
+
+Remove the HDD and optical drive:
+
+![](images/r400/0001.jpg)
+
+Remove the hinge screws:
+
![](images/r400/0002.jpg) ![](images/r400/0003.jpg)
-Remove the palm rest and keyboard:\
+Remove the palm rest and keyboard:
+
![](images/r400/0004.jpg) ![](images/r400/0005.jpg)
-Remove these screws, and then remove the bezel:\
+Remove these screws, and then remove the bezel:
+
![](images/r400/0006.jpg) ![](images/r400/0007.jpg)
Remove the speaker screws, but don't remove the speakers yet (just set
-them loose):\
+them loose):
+
![](images/r400/0008.jpg) ![](images/r400/0009.jpg)
![](images/r400/0010.jpg)
-Remove these screws, and then remove the metal plate:\
+Remove these screws, and then remove the metal plate:
+
![](images/r400/0011.jpg) ![](images/r400/0012.jpg)
![](images/r400/0013.jpg)
-Remove the antennas from the wifi card, and then start unrouting them:\
+Remove the antennas from the wifi card, and then start unrouting them:
+
![](images/r400/0014.jpg) ![](images/r400/0015.jpg)
![](images/r400/0016.jpg) ![](images/r400/0017.jpg)
![](images/r400/0018.jpg) ![](images/r400/0019.jpg)
-Disconnect the LCD cable from the motherboard:\
+Disconnect the LCD cable from the motherboard:
+
![](images/r400/0020.jpg) ![](images/r400/0021.jpg)
![](images/r400/0022.jpg) ![](images/r400/0023.jpg)
-Remove the hinge screws, and then remove the LCD panel:\
+Remove the hinge screws, and then remove the LCD panel:
+
![](images/r400/0024.jpg) ![](images/r400/0025.jpg)
![](images/r400/0026.jpg) ![](images/r400/0027.jpg)
-Remove this:\
+Remove this:
+
![](images/r400/0028.jpg) ![](images/r400/0029.jpg)
-Remove this long cable (there are 3 connections):\
+Remove this long cable (there are 3 connections):
+
![](images/r400/0030.jpg) ![](images/r400/0031.jpg)
![](images/r400/0032.jpg) ![](images/r400/0033.jpg)
-Disconnect the speaker cable, and remove the speakers:\
+Disconnect the speaker cable, and remove the speakers:
+
![](images/r400/0034.jpg)
Remove the heatsink screws, remove the fan and then remove the
-heatsink/fan:\
+heatsink/fan:
+
![](images/r400/0035.jpg) ![](images/r400/0036.jpg)
![](images/r400/0037.jpg) ![](images/r400/0038.jpg)
-Remove the NVRAM battery:\
+Remove the NVRAM battery:
+
![](images/r400/0039.jpg) ![](images/r400/0040.jpg)
-Remove this screw:\
+Remove this screw:
+
![](images/r400/0041.jpg) ![](images/r400/0042.jpg)
-Disconnect the AC jack:\
+Disconnect the AC jack:
+
![](images/r400/0043.jpg) ![](images/r400/0044.jpg)
-Remove this screw and then remove what is under it:\
+Remove this screw and then remove what is under it:
+
![](images/r400/0045.jpg)
-Remove this:\
+Remove this:
+
![](images/r400/0046.jpg)
Lift the motherboard (which is still inside the cage) from the side on
-the right, removing it completely:\
+the right, removing it completely:
+
![](images/r400/0047.jpg) ![](images/r400/0048.jpg)
Remove all screws, marking each hole so that you know where to re-insert
@@ -206,19 +229,23 @@ that they were in before removal: ![](images/r400/0049.jpg)
![](images/r400/0050.jpg)
Remove the motherboard from the cage, and the SPI flash chip will be
-next to the memory slots:\
+next to the memory slots:
+
![](images/r400/0051.jpg) ![](images/r400/0052.jpg)
-Connect your programmer, then connect GND and 3.3V\
+Connect your programmer, then connect GND and 3.3V
+
![](images/t400/0065.jpg) ![](images/t400/0066.jpg)
![](images/t400/0067.jpg) ![](images/t400/0069.jpg)
![](images/t400/0070.jpg) ![](images/t400/0071.jpg)
A dedicated 3.3V PSU was used to create this guide, but at ATX PSU is
-also fine:\
+also fine:
+
![](images/t400/0072.jpg)
-Of course, make sure to turn on your PSU:\
+Of course, make sure to turn on your PSU:
+
![](images/x200/disassembly/0013.jpg)
Now, you should be ready to install libreboot.
@@ -230,7 +257,8 @@ source code which can be built.
Log in as root on your BBB, using the instructions in
[bbb\_setup.html#bbb\_access](bbb_setup.html#bbb_access).
-Test that flashrom works:\
+Test that flashrom works:
+
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
In this case, the output was:
@@ -244,17 +272,23 @@ In this case, the output was:
Please specify which chip definition to use with the -c <chipname> option.
How to backup factory.rom (change the -c option as neeed, for your flash
-chip):\
+chip):
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory.rom**\
+factory.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory1.rom**\
+factory1.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory2.rom**\
+factory2.rom**
+
Note: the **-c** option is not required in libreboot's patched
flashrom, because the redundant flash chip definitions in *flashchips.c*
-have been removed.\
-Now compare the 3 images:\
+have been removed.
+
+Now compare the 3 images:
+
# sha512sum factory*.rom
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
@@ -269,7 +303,8 @@ flashing it. Although there is a default MAC address inside the ROM
image, this is not what you want. **Make sure to always change the MAC
address to one that is correct for your system.**
-Now flash it:\
+Now flash it:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
path/to/libreboot/rom/image.rom -V**
@@ -334,7 +369,8 @@ whitelist of approved chips, and it will refuse to boot if you use an
'unauthorized' wifi card.
The following photos show an Atheros AR5B95 being installed, to replace
-the Intel chip that this R400 came with:\
+the Intel chip that this R400 came with:
+
![](images/t400/0012.jpg) ![](images/t400/ar5b95.jpg)
@@ -364,7 +400,8 @@ Make sure that the RAM you buy is the 2Rx8 density.
be useful for RAM compatibility info (note: coreboot raminit is
different, so this page might be BS)
-The following photo shows 8GiB (2x4GiB) of RAM installed:\
+The following photo shows 8GiB (2x4GiB) of RAM installed:
+
![](images/t400/memory.jpg)
@@ -380,7 +417,8 @@ Now [install GNU+Linux](../gnulinux/).
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/rpi_setup.md b/docs/install/rpi_setup.md
index f90819c9..694ec74f 100644
--- a/docs/install/rpi_setup.md
+++ b/docs/install/rpi_setup.md
@@ -427,10 +427,14 @@ box.](http://www.flashrom.org/RaspberryPi)
-Copyright © 2014, 2015 Lawrence Wu <sagnessagiel@gmail.com>\
-Copyright © 2015 snuffeluffegus <>\
-Copyright © 2015 Kevin Keijzer <>\
-Copyright © 2016 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Lawrence Wu <sagnessagiel@gmail.com>
+
+Copyright © 2015 snuffeluffegus <>
+
+Copyright © 2015 Kevin Keijzer <>
+
+Copyright © 2016 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/t400_external.md b/docs/install/t400_external.md
index 347c1932..3ac8d58b 100644
--- a/docs/install/t400_external.md
+++ b/docs/install/t400_external.md
@@ -77,7 +77,8 @@ See [#paste](#paste).
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
[Back to top of page.](#pagetop)
@@ -137,72 +138,90 @@ for SOIC-8 (clip: Pomona 5250):
The procedure
-------------
-Remove *all* screws, placing them in the order that you removed them:\
+Remove *all* screws, placing them in the order that you removed them:
+
![](images/t400/0001.jpg) ![](images/t400/0002.jpg)
-Remove those three screws then remove the rear bezel:\
+Remove those three screws then remove the rear bezel:
+
![](images/t400/0003.jpg) ![](images/t400/0004.jpg)
![](images/t400/0005.jpg) ![](images/t400/0006.jpg)
-Remove the speakers:\
+Remove the speakers:
+
![](images/t400/0007.jpg) ![](images/t400/0008.jpg)
![](images/t400/0009.jpg) ![](images/t400/0010.jpg)
![](images/t400/0011.jpg)
-Remove the wifi:\
+Remove the wifi:
+
![](images/t400/0012.jpg) ![](images/t400/0013.jpg)
-Remove this cable:\
+Remove this cable:
+
![](images/t400/0014.jpg) ![](images/t400/0015.jpg)
![](images/t400/0016.jpg) ![](images/t400/0017.jpg)
![](images/t400/0018.jpg)
-Unroute those antenna wires:\
+Unroute those antenna wires:
+
![](images/t400/0019.jpg) ![](images/t400/0020.jpg)
![](images/t400/0021.jpg) ![](images/t400/0022.jpg)
![](images/t400/0023.jpg)
-Remove the LCD assembly:\
+Remove the LCD assembly:
+
![](images/t400/0024.jpg) ![](images/t400/0025.jpg)
![](images/t400/0026.jpg) ![](images/t400/0027.jpg)
![](images/t400/0028.jpg) ![](images/t400/0029.jpg)
![](images/t400/0030.jpg) ![](images/t400/0031.jpg)
-Disconnect the NVRAM battery:\
+Disconnect the NVRAM battery:
+
![](images/t400/0033.jpg)
-Disconnect the fan:\
+Disconnect the fan:
+
![](images/t400/0034.jpg)
-Unscrew these:\
+Unscrew these:
+
![](images/t400/0035.jpg) ![](images/t400/0036.jpg)
![](images/t400/0037.jpg) ![](images/t400/0038.jpg)
-Unscrew the heatsink, then lift it off:\
+Unscrew the heatsink, then lift it off:
+
![](images/t400/0039.jpg) ![](images/t400/0040.jpg)
-Disconnect the power jack:\
+Disconnect the power jack:
+
![](images/t400/0041.jpg) ![](images/t400/0042.jpg)
-Loosen this:\
+Loosen this:
+
![](images/t400/0043.jpg)
-Remove this:\
+Remove this:
+
![](images/t400/0044.jpg) ![](images/t400/0045.jpg)
![](images/t400/0046.jpg) ![](images/t400/0047.jpg)
![](images/t400/0048.jpg)
-Unscrew these:\
+Unscrew these:
+
![](images/t400/0049.jpg) ![](images/t400/0050.jpg)
-Remove this:\
+Remove this:
+
![](images/t400/0051.jpg) ![](images/t400/0052.jpg)
-Unscrew this:\
+Unscrew this:
+
![](images/t400/0053.jpg)
Remove the motherboard (the cage is still attached) from the right hand
-side, then lift it out:\
+side, then lift it out:
+
![](images/t400/0054.jpg) ![](images/t400/0055.jpg)
![](images/t400/0056.jpg)
@@ -212,19 +231,23 @@ later): ![](images/t400/0057.jpg) ![](images/t400/0058.jpg)
![](images/t400/0059.jpg) ![](images/t400/0060.jpg)
![](images/t400/0061.jpg) ![](images/t400/0062.jpg)
-Separate the motherboard:\
+Separate the motherboard:
+
![](images/t400/0063.jpg) ![](images/t400/0064.jpg)
-Connect your programmer, then connect GND and 3.3V\
+Connect your programmer, then connect GND and 3.3V
+
![](images/t400/0065.jpg) ![](images/t400/0066.jpg)
![](images/t400/0067.jpg) ![](images/t400/0069.jpg)
![](images/t400/0070.jpg) ![](images/t400/0071.jpg)
A dedicated 3.3V PSU was used to create this guide, but at ATX PSU is
-also fine:\
+also fine:
+
![](images/t400/0072.jpg)
-Of course, make sure to turn on your PSU:\
+Of course, make sure to turn on your PSU:
+
![](images/x200/disassembly/0013.jpg)
Now, you should be ready to install libreboot.
@@ -236,7 +259,8 @@ source code which can be built.
Log in as root on your BBB, using the instructions in
[bbb\_setup.html#bbb\_access](bbb_setup.html#bbb_access).
-Test that flashrom works:\
+Test that flashrom works:
+
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
In this case, the output was:
@@ -250,17 +274,23 @@ In this case, the output was:
Please specify which chip definition to use with the -c <chipname> option.
How to backup factory.rom (change the -c option as neeed, for your flash
-chip):\
+chip):
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory.rom**\
+factory.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory1.rom**\
+factory1.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory2.rom**\
+factory2.rom**
+
Note: the **-c** option is not required in libreboot's patched
flashrom, because the redundant flash chip definitions in *flashchips.c*
-have been removed.\
-Now compare the 3 images:\
+have been removed.
+
+Now compare the 3 images:
+
# sha512sum factory*.rom
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
@@ -275,7 +305,8 @@ flashing it. Although there is a default MAC address inside the ROM
image, this is not what you want. **Make sure to always change the MAC
address to one that is correct for your system.**
-Now flash it:\
+Now flash it:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
path/to/libreboot/rom/image.rom -V**
@@ -340,7 +371,8 @@ whitelist of approved chips, and it will refuse to boot if you use an
'unauthorized' wifi card.
The following photos show an Atheros AR5B95 being installed, to replace
-the Intel chip that this T400 came with:\
+the Intel chip that this T400 came with:
+
![](images/t400/0012.jpg) ![](images/t400/ar5b95.jpg)
@@ -370,7 +402,8 @@ Make sure that the RAM you buy is the 2Rx8 density.
be useful for RAM compatibility info (note: coreboot raminit is
different, so this page might be BS)
-The following photo shows 8GiB (2x4GiB) of RAM installed:\
+The following photo shows 8GiB (2x4GiB) of RAM installed:
+
![](images/t400/memory.jpg)
@@ -386,7 +419,8 @@ Now [install GNU+Linux](../gnulinux/).
-Copyright © 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/t500_external.md b/docs/install/t500_external.md
index 239b7d25..3b81c0be 100644
--- a/docs/install/t500_external.md
+++ b/docs/install/t500_external.md
@@ -67,7 +67,8 @@ See [#paste](#paste).
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
[Back to top of page.](#pagetop)
@@ -127,20 +128,26 @@ for SOIC-8 (clip: Pomona 5250):
The procedure
-------------
-Remove all screws:\
-![](images/t500/0000.jpg)\
+Remove all screws:
+
+![](images/t500/0000.jpg)
+
It is also advisable to, throughout the disassembly, place any screws
and/or components that you removed in the same layout or arrangement.
-The follow photos demonstrate this:\
+The follow photos demonstrate this:
+
![](images/t500/0001.jpg) ![](images/t500/0002.jpg)
-Remove the HDD/SSD and optical drive:\
+Remove the HDD/SSD and optical drive:
+
![](images/t500/0003.jpg) ![](images/t500/0004.jpg)
-Remove the palm rest:\
+Remove the palm rest:
+
![](images/t500/0005.jpg) ![](images/t500/0006.jpg)
-Remove the keyboard and rear bezel:\
+Remove the keyboard and rear bezel:
+
![](images/t500/0007.jpg) ![](images/t500/0008.jpg)
![](images/t500/0009.jpg) ![](images/t500/0010.jpg)
![](images/t500/0011.jpg) ![](images/t500/0012.jpg)
@@ -148,88 +155,109 @@ Remove the keyboard and rear bezel:\
If you have a WWAN/3G card and/or sim card reader, remove them
permanently. The WWAN-3G card has proprietary firmware inside; the
technology is identical to what is used in mobile phones, so it can also
-track your movements:\
+track your movements:
+
![](images/t500/0013.jpg) ![](images/t500/0017.jpg)
![](images/t500/0018.jpg)
-Remove this frame, and then remove the wifi chip:\
+Remove this frame, and then remove the wifi chip:
+
![](images/t500/0014.jpg) ![](images/t500/0015.jpg)
![](images/t500/0016.jpg)
-Remove the speakers:\
+Remove the speakers:
+
![](images/t500/0019.jpg) ![](images/t500/0020.jpg)
![](images/t500/0021.jpg) ![](images/t500/0022.jpg)
![](images/t500/0023.jpg) ![](images/t500/0024.jpg)
![](images/t500/0025.jpg)
-Remove the NVRAM battery (already removed in this photo):\
+Remove the NVRAM battery (already removed in this photo):
+
![](images/t500/0026.jpg)
When you re-assemble, you will be replacing the wifi chip with another.
These two screws don't hold anything together, but they are included in
your system because the screw holes for half-height cards are a
different size, so use these if you will be installing a half-height
-card:\
+card:
+
![](images/t500/0027.jpg)
-Unroute the antenna wires:\
+Unroute the antenna wires:
+
![](images/t500/0028.jpg) ![](images/t500/0029.jpg)
![](images/t500/0030.jpg) ![](images/t500/0031.jpg)
-Disconnect the LCD cable from the motherboard:\
+Disconnect the LCD cable from the motherboard:
+
![](images/t500/0032.jpg) ![](images/t500/0033.jpg)
-Remove the LCD assembly hinge screws, and then remove the LCD assembly:\
+Remove the LCD assembly hinge screws, and then remove the LCD assembly:
+
![](images/t500/0034.jpg) ![](images/t500/0035.jpg)
![](images/t500/0036.jpg)
-Remove the fan and heatsink:\
+Remove the fan and heatsink:
+
![](images/t500/0037.jpg) ![](images/t500/0038.jpg)
![](images/t500/0039.jpg)
-Remove this screw:\
+Remove this screw:
+
![](images/t500/0040.jpg)
Remove these cables, keeping note of how and in what arrangement they
-are connected:\
+are connected:
+
![](images/t500/0041.jpg) ![](images/t500/0042.jpg)
![](images/t500/0043.jpg) ![](images/t500/0044.jpg)
![](images/t500/0045.jpg) ![](images/t500/0046.jpg)
![](images/t500/0047.jpg) ![](images/t500/0048.jpg)
![](images/t500/0049.jpg)
-Disconnect the power jack:\
+Disconnect the power jack:
+
![](images/t500/0050.jpg) ![](images/t500/0051.jpg)
Remove the motherboard and cage from the base (the marked hole is where
-those cables were routed through):\
+those cables were routed through):
+
![](images/t500/0052.jpg) ![](images/t500/0053.jpg)
Remove all screws, arranging them in the same layout when placing the
screws on a surface and marking each screw hole (this is to reduce the
-possibility of putting them back in the wrong holes):\
+possibility of putting them back in the wrong holes):
+
![](images/t500/0054.jpg) ![](images/t500/0055.jpg)
-Also remove this:\
+Also remove this:
+
![](images/t500/0056.jpg) ![](images/t500/0057.jpg)
-Separate the motherboard from the cage:\
+Separate the motherboard from the cage:
+
![](images/t500/0058.jpg) ![](images/t500/0059.jpg)
The flash chip is next to the memory slots. On this system, it was a
-SOIC-8 (4MiB or 32Mb) flash chip:\
+SOIC-8 (4MiB or 32Mb) flash chip:
+
![](images/t500/0060.jpg)
-Connect your programmer, then connect GND and 3.3V\
-![](images/t500/0061.jpg)\
+Connect your programmer, then connect GND and 3.3V
+
+![](images/t500/0061.jpg)
+
![](images/t400/0067.jpg) ![](images/t400/0069.jpg)
![](images/t400/0070.jpg) ![](images/t400/0071.jpg)
A dedicated 3.3V PSU was used to create this guide, but at ATX PSU is
-also fine:\
+also fine:
+
![](images/t400/0072.jpg)
-Of course, make sure to turn on your PSU:\
+Of course, make sure to turn on your PSU:
+
![](images/x200/disassembly/0013.jpg)
Now, you should be ready to install libreboot.
@@ -241,7 +269,8 @@ source code which can be built.
Log in as root on your BBB, using the instructions in
[bbb\_setup.html#bbb\_access](bbb_setup.html#bbb_access).
-Test that flashrom works:\
+Test that flashrom works:
+
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
In this case, the output was:
@@ -255,17 +284,23 @@ In this case, the output was:
Please specify which chip definition to use with the -c <chipname> option.
How to backup factory.rom (change the -c option as neeed, for your flash
-chip):\
+chip):
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory.rom**\
+factory.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory1.rom**\
+factory1.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory2.rom**\
+factory2.rom**
+
Note: the **-c** option is not required in libreboot's patched
flashrom, because the redundant flash chip definitions in *flashchips.c*
-have been removed.\
-Now compare the 3 images:\
+have been removed.
+
+Now compare the 3 images:
+
# sha512sum factory*.rom
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
@@ -280,7 +315,8 @@ flashing it. Although there is a default MAC address inside the ROM
image, this is not what you want. **Make sure to always change the MAC
address to one that is correct for your system.**
-Now flash it:\
+Now flash it:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
path/to/libreboot/rom/image.rom -V**
@@ -345,7 +381,8 @@ whitelist of approved chips, and it will refuse to boot if you use an
'unauthorized' wifi card.
The following photos show an Atheros AR5B95 being installed, to replace
-the Intel chip that this T500 came with:\
+the Intel chip that this T500 came with:
+
![](images/t400/0012.jpg) ![](images/t400/ar5b95.jpg)
@@ -375,7 +412,8 @@ Make sure that the RAM you buy is the 2Rx8 density.
be useful for RAM compatibility info (note: coreboot raminit is
different, so this page might be BS)
-The following photo shows 8GiB (2x4GiB) of RAM installed:\
+The following photo shows 8GiB (2x4GiB) of RAM installed:
+
![](images/t400/memory.jpg)
@@ -391,7 +429,8 @@ Now [install GNU+Linux](../gnulinux/).
-Copyright © 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/t60_unbrick.md b/docs/install/t60_unbrick.md
index fa5a77a1..2c857f3f 100644
--- a/docs/install/t60_unbrick.md
+++ b/docs/install/t60_unbrick.md
@@ -24,22 +24,31 @@ Brick type 1: bucts not reset. {#bucts_brick}
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.\
-\
+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:\
-![](../images/t60_dev/0006.JPG)\
-\
+two:
+
+![](../images/t60_dev/0006.JPG)
+
+
+
*Those dd commands should be applied to all newly compiled T60 ROM
images (the ROM images in libreboot binary archives already have this
-applied!):\
+applied!):
+
dd if=coreboot.rom of=top64k.bin bs=1 skip=$\[$(stat -c %s
-coreboot.rom) - 0x10000\] count=64k\
+coreboot.rom) - 0x10000\] count=64k
+
dd if=coreboot.rom bs=1 skip=$\[$(stat -c %s coreboot.rom) - 0x20000\]
-count=64k | hexdump\
+count=64k | hexdump
+
dd if=top64k.bin of=coreboot.rom bs=1 seek=$\[$(stat -c %s
-coreboot.rom) - 0x20000\] count=64k conv=notrunc\
+coreboot.rom) - 0x20000\] count=64k conv=notrunc
+
(doing this makes the ROM suitable for use when flashing a system that
still has Lenovo BIOS running, using those instructions:
<http://www.coreboot.org/Board:lenovo/x60/Installation>. (it says x60,
@@ -61,62 +70,80 @@ you can't boot the system, 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:\
+Remove those screws and remove the HDD:
+
![](../images/t60_dev/0001.JPG) ![](../images/t60_dev/0002.JPG)
-Lift off the palm rest:\
+Lift off the palm rest:
+
![](../images/t60_dev/0003.JPG)
Lift up the keyboard, pull it back a bit, flip it over like that and
-then disconnect it from the board:\
+then disconnect it from the board:
+
![](../images/t60_dev/0004.JPG) ![](../images/t60_dev/0005.JPG)
![](../images/t60_dev/0006.JPG)
-Gently wedge both sides loose:\
+Gently wedge both sides loose:
+
![](../images/t60_dev/0007.JPG) ![](../images/t60_dev/0008.JPG)
-Remove that cable from the position:\
+Remove that cable from the position:
+
![](../images/t60_dev/0009.JPG) ![](../images/t60_dev/0010.JPG)
Now remove that bezel. Remove wifi, nvram battery and speaker connector
-(also remove 56k modem, on the left of wifi):\
+(also remove 56k modem, on the left of wifi):
+
![](../images/t60_dev/0011.JPG)
-Remove those screws:\
+Remove those screws:
+
![](../images/t60_dev/0012.JPG)
-Disconnect the power jack:\
+Disconnect the power jack:
+
![](../images/t60_dev/0013.JPG)
-Remove nvram battery:\
+Remove nvram battery:
+
![](../images/t60_dev/0014.JPG)
-Disconnect cable (for 56k modem) and disconnect the other cable:\
+Disconnect cable (for 56k modem) and disconnect the other cable:
+
![](../images/t60_dev/0015.JPG) ![](../images/t60_dev/0016.JPG)
-Disconnect speaker cable:\
+Disconnect speaker cable:
+
![](../images/t60_dev/0017.JPG)
-Disconnect the other end of the 56k modem cable:\
+Disconnect the other end of the 56k modem cable:
+
![](../images/t60_dev/0018.JPG)
-Make sure you removed it:\
+Make sure you removed it:
+
![](../images/t60_dev/0019.JPG)
-Unscrew those:\
+Unscrew those:
+
![](../images/t60_dev/0020.JPG)
-Make sure you removed those:\
+Make sure you removed those:
+
![](../images/t60_dev/0021.JPG)
-Disconnect LCD cable from board:\
+Disconnect LCD cable from board:
+
![](../images/t60_dev/0022.JPG)
-Remove those screws then remove the LCD assembly:\
+Remove those screws then remove the LCD assembly:
+
![](../images/t60_dev/0023.JPG) ![](../images/t60_dev/0024.JPG)
![](../images/t60_dev/0025.JPG)
-Once again, make sure you removed those:\
+Once again, make sure you removed those:
+
![](../images/t60_dev/0026.JPG)
Remove the shielding containing the motherboard, then flip it over.
@@ -124,20 +151,25 @@ 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
-system:\
+system:
+
![](../images/t60_dev/0027.JPG) ![](../images/t60_dev/0028.JPG)
![](../images/t60_dev/0029.JPG) ![](../images/t60_dev/0031.JPG)
![](../images/t60_dev/0032.JPG) ![](../images/t60_dev/0033.JPG)
-Now wire up the BBB and the Pomona with your PSU.\
+Now wire up the BBB and the Pomona with your PSU.
+
Refer to [bbb\_setup.html](bbb_setup.html) for how to setup the BBB for
-flashing.\
+flashing.
+
**Note, the guide mentions a 3.3v DC PSU but you don't need this on the
T60: if you don't have or don't want to use an external PSU, then make
sure not to connect the 3.3v leads mentioned in the guide; instead,
connect the AC adapter (the one that normally charges your battery) so
-that the board has power (but don't boot it up)**\
-![](../images/t60_dev/0030.JPG)\
+that the board has power (but don't boot it up)**
+
+![](../images/t60_dev/0030.JPG)
+
Correlate the following with the BBB guide linked above:
POMONA 5250:
@@ -156,7 +188,8 @@ Flashrom binaries for ARM (tested on a BBB) are distributed in
libreboot\_util. Alternatively, libreboot also distributes flashrom
source code which can be built.
-SSH'd into the BBB:\
+SSH'd into the BBB:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
yourrom.rom**
@@ -164,56 +197,69 @@ It should be **Verifying flash... VERIFIED** at the end. If flashrom
complains about multiple flash chip definitions detected, then choose
one of them following the instructions in the output.
-Put those screws back:\
+Put those screws back:
+
![](../images/t60_dev/0047.JPG)
-Put it back into lower chassis:\
+Put it back into lower chassis:
+
![](../images/t60_dev/0048.JPG)
-Attach LCD and insert screws (also, attach the lcd cable to the board):\
+Attach LCD and insert screws (also, attach the lcd cable to the board):
+
![](../images/t60_dev/0049.JPG)
-Insert those screws:\
+Insert those screws:
+
![](../images/t60_dev/0050.JPG)
On the CPU (and there is another chip south-east to it, sorry forgot to
take pic) clean off the old thermal paste (with the alcohol) and apply
new (Artic Silver 5 is good, others are good too) you should also clean
-the heatsink the same way\
+the heatsink the same way
+
![](../images/t60_dev/0051.JPG)
Attach the heatsink and install the screws (also, make sure to install
-the AC jack as highlighted):\
+the AC jack as highlighted):
+
![](../images/t60_dev/0052.JPG)
-Reinstall that upper bezel:\
+Reinstall that upper bezel:
+
![](../images/t60_dev/0053.JPG)
-Do that:\
+Do that:
+
![](../images/t60_dev/0054.JPG) ![](../images/t60_dev/0055.JPG)
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:\
+Attach keyboard and install nvram battery:
+
![](../images/t60_dev/0056.JPG) ![](../images/t60_dev/0057.JPG)
Place keyboard and (sorry, forgot to take pics) reinstall the palmrest
-and insert screws on the underside:\
+and insert screws on the underside:
+
![](../images/t60_dev/0058.JPG)
-It lives!\
+It lives!
+
![](../images/t60_dev/0071.JPG) ![](../images/t60_dev/0072.JPG)
![](../images/t60_dev/0073.JPG)
Always stress test ('stress -c 2' and xsensors. below 90C is ok) when
-replacing cpu paste/heatsink:\
+replacing cpu paste/heatsink:
+
![](../images/t60_dev/0074.JPG)
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/x200_external.md b/docs/install/x200_external.md
index fd4af287..fbf190f5 100644
--- a/docs/install/x200_external.md
+++ b/docs/install/x200_external.md
@@ -35,7 +35,8 @@ Check the [suppliers](../../suppliers) page for more information.
Flash chip size {#flashchips}
===============
-Use this to find out:\
+Use this to find out:
+
# **flashrom -p internal -V**
The X200S and X200 Tablet will use a WSON-8 flash chip, on the bottom of
@@ -108,9 +109,12 @@ header), for SOIC-8 (clip: Pomona 5250):
**On the X200S and X200 Tablet the flash chip is underneath the board,
in a WSON package. The pinout is very much the same as a SOIC-8, except
-you need to solder (there are no clips available).\
-The following image shows how this is done:**\
-![](images/x200/wson_soldered.jpg "Copyright 2014 Steve Shenton <sgsit@libreboot.org> see license notice at the end of this document")\
+you need to solder (there are no clips available).
+
+The following image shows how this is done:**
+
+![](images/x200/wson_soldered.jpg "Copyright 2014 Steve Shenton <sgsit@libreboot.org> see license notice at the end of this document")
+
In this image, a pin header was soldered onto the WSON. Another solution
might be to de-solder the WSON-8 chip and put a SOIC-8 there instead.
Check the list of SOIC-8 flash chips at
@@ -126,39 +130,47 @@ This section is for the X200. This does not apply to the X200S or X200
Tablet (for those systems, you have to remove the motherboard
completely, since the flash chip is on the other side of the board).
-Remove these screws:\
+Remove these screws:
+
![](images/x200/disassembly/0003.jpg)
Push the keyboard forward, gently, then lift it off and disconnect it
-from the board:\
+from the board:
+
![](images/x200/disassembly/0004.jpg)
![](images/x200/disassembly/0005.jpg)
Pull the palm rest off, lifting from the left and right side at the back
-of the palm rest:\
+of the palm rest:
+
![](images/x200/disassembly/0006.jpg)
Lift back the tape that covers a part of the flash chip, and then
-connect the clip:\
+connect the clip:
+
![](images/x200/disassembly/0007.jpg)
![](images/x200/disassembly/0008.jpg)
On pin 2 of the BBB, where you have the ground (GND), connect the ground
-to your PSU:\
+to your PSU:
+
![](images/x200/disassembly/0009.jpg)
![](images/x200/disassembly/0010.jpg)
-Connect the 3.3V supply from your PSU to the flash chip (via the clip):\
+Connect the 3.3V supply from your PSU to the flash chip (via the clip):
+
![](images/x200/disassembly/0011.jpg)
![](images/x200/disassembly/0012.jpg)
-Of course, make sure that your PSU is also plugged in and turn on:\
+Of course, make sure that your PSU is also plugged in and turn on:
+
![](images/x200/disassembly/0013.jpg)
This tutorial tells you to use an ATX PSU, for the 3.3V DC supply. The
PSU used when taking these photos is actually not an ATX PSU, but a PSU
that is designed specifically for providing 3.3V DC (an ATX PSU will
-also work):\
+also work):
+
![](images/x200/disassembly/0014.jpg)
Now, you should be ready to install libreboot.
@@ -170,7 +182,8 @@ source code which can be built.
Log in as root on your BBB, using the instructions in
[bbb\_setup.html#bbb\_access](bbb_setup.html#bbb_access).
-Test that flashrom works:\
+Test that flashrom works:
+
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
In this case, the output was:
@@ -184,17 +197,23 @@ In this case, the output was:
Please specify which chip definition to use with the -c <chipname> option.
How to backup factory.rom (change the -c option as neeed, for your flash
-chip):\
+chip):
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory.rom**\
+factory.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory1.rom**\
+factory1.rom**
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
-factory2.rom**\
+factory2.rom**
+
Note: the **-c** option is not required in libreboot's patched
flashrom, because the redundant flash chip definitions in *flashchips.c*
-have been removed.\
-Now compare the 3 images:\
+have been removed.
+
+Now compare the 3 images:
+
# sha512sum factory*.rom
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
@@ -209,7 +228,8 @@ flashing it. Although there is a default MAC address inside the ROM
image, this is not what you want. **Make sure to always change the MAC
address to one that is correct for your system.**
-Now flash it:\
+Now flash it:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
path/to/libreboot/rom/image.rom -V**
@@ -255,7 +275,8 @@ whitelist of approved chips, and it will refuse to boot if you use an
'unauthorized' wifi card.
The following photos show an Atheros AR5B95 being installed, to replace
-the Intel chip that this X200 came with:\
+the Intel chip that this X200 came with:
+
![](images/x200/disassembly/0016.jpg)
![](images/x200/disassembly/0017.jpg)
@@ -285,7 +306,8 @@ work in some cases.
Make sure that the RAM you buy is the 2Rx8 density.
-In this photo, 8GiB of RAM (2x4GiB) is installed:\
+In this photo, 8GiB of RAM (2x4GiB) is installed:
+
![](images/x200/disassembly/0018.jpg)
@@ -309,7 +331,8 @@ disable the flashing protections by the descriptor and stop the ME from
starting (which itself interferes with flashing attempts). The theory
was proven correct; however, it is still useless in practise.
-Look just above the 7 in TP37 (that's GPIO33):\
+Look just above the 7 in TP37 (that's GPIO33):
+
![](../hcl/images/x200/gpio33_location.jpg)
By default we would see this in lenovobios, when trying flashrom -p
@@ -344,7 +367,8 @@ investigating this:
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/x60_unbrick.md b/docs/install/x60_unbrick.md
index c02f3ff9..85b81cf2 100644
--- a/docs/install/x60_unbrick.md
+++ b/docs/install/x60_unbrick.md
@@ -24,22 +24,31 @@ Brick type 1: bucts not reset. {#bucts_brick}
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.\
-\
+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:\
-![](../images/x60_unbrick/0004.jpg)\
-\
+two:
+
+![](../images/x60_unbrick/0004.jpg)
+
+
+
*Those dd commands should be applied to all newly compiled X60 ROM
images (the ROM images in libreboot binary archives already have this
-applied!):\
+applied!):
+
dd if=coreboot.rom of=top64k.bin bs=1 skip=$\[$(stat -c %s
-coreboot.rom) - 0x10000\] count=64k\
+coreboot.rom) - 0x10000\] count=64k
+
dd if=coreboot.rom bs=1 skip=$\[$(stat -c %s coreboot.rom) - 0x20000\]
-count=64k | hexdump\
+count=64k | hexdump
+
dd if=top64k.bin of=coreboot.rom bs=1 seek=$\[$(stat -c %s
-coreboot.rom) - 0x20000\] count=64k conv=notrunc\
+coreboot.rom) - 0x20000\] count=64k conv=notrunc
+
(doing this makes the ROM suitable for use when flashing a system that
still has Lenovo BIOS running, using those instructions:
<http://www.coreboot.org/Board:lenovo/x60/Installation>.
@@ -60,68 +69,86 @@ you can't boot the system, 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 those screws:
+
![](../images/x60_unbrick/0000.jpg)
-Push the keyboard forward (carefully):\
+Push the keyboard forward (carefully):
+
![](../images/x60_unbrick/0001.jpg)
-Lift the keyboard up and disconnect it from the board:\
+Lift the keyboard up and disconnect it from the board:
+
![](../images/x60_unbrick/0002.jpg)
Grab the right-hand side of the chassis and force it off (gently) and
-pry up the rest of the chassis:\
+pry up the rest of the chassis:
+
![](../images/x60_unbrick/0003.jpg)
-You should now have this:\
+You should now have this:
+
![](../images/x60_unbrick/0004.jpg)
-Disconnect the wifi antenna cables, the modem cable and the speaker:\
+Disconnect the wifi antenna cables, the modem cable and the speaker:
+
![](../images/x60_unbrick/0005.jpg)
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:\
+monitor hinge on the right-hand side:
+
![](../images/x60_unbrick/0006.jpg)
Disconnect the monitor from the motherboard, and unroute the grey
-antenna cable, carefully lifting the tape that holds it into place:\
+antenna cable, carefully lifting the tape that holds it into place:
+
![](../images/x60_unbrick/0008.jpg)
Carefully lift the remaining tape and unroute the left antenna cable so
-that it is loose:\
+that it is loose:
+
![](../images/x60_unbrick/0009.jpg)
Remove the screw that is highlighted (do NOT remove the other one; it
-holds part of the heatsink (other side) into place):\
+holds part of the heatsink (other side) into place):
+
![](../images/x60_unbrick/0011.jpg)
-Remove those screws:\
+Remove those screws:
+
![](../images/x60_unbrick/0012.jpg)
-Carefully remove the plate, like so:\
+Carefully remove the plate, like so:
+
![](../images/x60_unbrick/0013.jpg)
-Remove the SATA connector:\
+Remove the SATA connector:
+
![](../images/x60_unbrick/0014.jpg)
-Now remove the motherboard (gently) and cast the lcd/chassis aside:\
+Now remove the motherboard (gently) and cast the lcd/chassis aside:
+
![](../images/x60_unbrick/0015.jpg)
Lift back that tape and hold it with something. Highlighted is the SPI
-flash chip:\
+flash chip:
+
![](../images/x60_unbrick/0016.jpg)
-Now wire up the BBB and the Pomona with your PSU.\
+Now wire up the BBB and the Pomona with your PSU.
+
Refer to [bbb\_setup.html](bbb_setup.html) for how to setup the BBB for
-flashing.\
+flashing.
+
**Note, the guide mentions a 3.3v DC PSU but you don't need this on the
X60: if you don't have or don't want to use an external PSU, then make
sure not to connect the 3.3v leads mentioned in the guide; instead,
connect the AC adapter (the one that normally charges your battery) so
that the board has power (but don't boot it up)**
-![](../images/x60_unbrick/0017.jpg)\
+![](../images/x60_unbrick/0017.jpg)
+
Correlate the following with the BBB guide linked above:
POMONA 5250:
@@ -134,14 +161,16 @@ Correlate the following with the BBB guide linked above:
This is how you will connect. Numbers refer to pin numbers on the BBB, on the plugs near the DC jack.
Connecting the BBB and pomona (in this image, an external 3.3v DC PSU
-was used):\
+was used):
+
![](images/x60/th_bbb_flashing.jpg)
Flashrom binaries for ARM (tested on a BBB) are distributed in
libreboot\_util. Alternatively, libreboot also distributes flashrom
source code which can be built.
-SSH'd into the BBB:\
+SSH'd into the BBB:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
yourrom.rom**
@@ -150,82 +179,106 @@ complains about multiple flash chip definitions detected, then choose
one of them following the instructions in the output.
Remove the programmer and put it away somewhere. Put back the tape and
-press firmly over it:\
+press firmly over it:
+
![](../images/x60_unbrick/0026.jpg)
-Your empty chassis:\
+Your empty chassis:
+
![](../images/x60_unbrick/0027.jpg)
-Put the motherboard back in:\
+Put the motherboard back in:
+
![](../images/x60_unbrick/0028.jpg)
-Reconnect SATA:\
+Reconnect SATA:
+
![](../images/x60_unbrick/0029.jpg)
-Put the plate back and re-insert those screws:\
+Put the plate back and re-insert those screws:
+
![](../images/x60_unbrick/0030.jpg)
-Re-route that antenna cable around the fan and apply the tape:\
+Re-route that antenna cable around the fan and apply the tape:
+
![](../images/x60_unbrick/0031.jpg)
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:\
+screws:
+
![](../images/x60_unbrick/0032.jpg)
-Re-insert that screw:\
+Re-insert that screw:
+
![](../images/x60_unbrick/0033.jpg)
-Route the black antenna cable like so:\
+Route the black antenna cable like so:
+
![](../images/x60_unbrick/0034.jpg)
-Tuck it in neatly like so:\
+Tuck it in neatly like so:
+
![](../images/x60_unbrick/0035.jpg)
-Route the modem cable like so:\
+Route the modem cable like so:
+
![](../images/x60_unbrick/0036.jpg)
-Connect modem cable to board and tuck it in neatly like so:\
+Connect modem cable to board and tuck it in neatly like so:
+
![](../images/x60_unbrick/0037.jpg)
-Route the power connection and connect it to the board like so:\
+Route the power connection and connect it to the board like so:
+
![](../images/x60_unbrick/0038.jpg)
-Route the antenna and modem cables neatly like so:\
+Route the antenna and modem cables neatly like so:
+
![](../images/x60_unbrick/0039.jpg)
Connect the wifi antenna cables. At the start of the tutorial, this
system 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):\
+Atheros AR5B95 (supports 802.11n and can be used without blobs):
+
![](../images/x60_unbrick/0040.jpg)
-Connect the modem cable:\
+Connect the modem cable:
+
![](../images/x60_unbrick/0041.jpg)
-Connect the speaker:\
+Connect the speaker:
+
![](../images/x60_unbrick/0042.jpg)
-You should now have this:\
+You should now have this:
+
![](../images/x60_unbrick/0043.jpg)
-Re-connect the upper chassis:\
+Re-connect the upper chassis:
+
![](../images/x60_unbrick/0044.jpg)
-Re-connect the keyboard:\
+Re-connect the keyboard:
+
![](../images/x60_unbrick/0045.jpg)
-Re-insert the screws that you removed earlier:\
+Re-insert the screws that you removed earlier:
+
![](../images/x60_unbrick/0046.jpg)
-Power on!\
+Power on!
+
![](../images/x60_unbrick/0047.jpg)
-Operating system:\
+Operating system:
+
![](../images/x60_unbrick/0049.jpg)
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative
diff --git a/docs/install/x60tablet_unbrick.md b/docs/install/x60tablet_unbrick.md
index afbfd7ac..79b3fc6e 100644
--- a/docs/install/x60tablet_unbrick.md
+++ b/docs/install/x60tablet_unbrick.md
@@ -24,22 +24,31 @@ Brick type 1: bucts not reset. {#bucts_brick}
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.\
-\
+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:\
-![](../images/x60t_unbrick/0008.JPG)\
-\
+two:
+
+![](../images/x60t_unbrick/0008.JPG)
+
+
+
*Those dd commands should be applied to all newly compiled X60 ROM
images (the ROM images in libreboot binary archives already have this
-applied!):\
+applied!):
+
dd if=coreboot.rom of=top64k.bin bs=1 skip=$\[$(stat -c %s
-coreboot.rom) - 0x10000\] count=64k\
+coreboot.rom) - 0x10000\] count=64k
+
dd if=coreboot.rom bs=1 skip=$\[$(stat -c %s coreboot.rom) - 0x20000\]
-count=64k | hexdump\
+count=64k | hexdump
+
dd if=top64k.bin of=coreboot.rom bs=1 seek=$\[$(stat -c %s
-coreboot.rom) - 0x20000\] count=64k conv=notrunc\
+coreboot.rom) - 0x20000\] count=64k conv=notrunc
+
(doing this makes the ROM suitable for use when flashing a system that
still has Lenovo BIOS running, using those instructions:
<http://www.coreboot.org/Board:lenovo/x60/Installation>.
@@ -62,45 +71,57 @@ flash the SPI chip (where libreboot resides).
![](../images/x60t_unbrick/0000.JPG)
-Remove those screws:\
+Remove those screws:
+
![](../images/x60t_unbrick/0001.JPG)
-Remove the HDD:\
+Remove the HDD:
+
![](../images/x60t_unbrick/0002.JPG)
-Push keyboard forward to loosen it:\
+Push keyboard forward to loosen it:
+
![](../images/x60t_unbrick/0003.JPG)
-Lift:\
+Lift:
+
![](../images/x60t_unbrick/0004.JPG)
-Remove those:\
+Remove those:
+
![](../images/x60t_unbrick/0005.JPG)
![](../images/x60t_unbrick/0006.JPG)
-Also remove that (marked) and unroute the antenna cables:\
+Also remove that (marked) and unroute the antenna cables:
+
![](../images/x60t_unbrick/0007.JPG)
-For some X60T laptops, you have to unroute those too:\
+For some X60T laptops, you have to unroute those too:
+
![](../images/x60t_unbrick/0010.JPG)
Remove the LCD extend board screws. Also remove those screws (see blue
-marks) and remove/unroute the cables and remove the metal plate:\
+marks) and remove/unroute the cables and remove the metal plate:
+
![](../images/x60t_unbrick/0008.JPG)
-Remove that screw and then remove the board:\
+Remove that screw and then remove the board:
+
![](../images/x60t_unbrick/0009.JPG)
-Now wire up the BBB and the Pomona with your PSU.\
+Now wire up the BBB and the Pomona with your PSU.
+
Refer to [bbb\_setup.html](bbb_setup.html) for how to setup the BBB for
-flashing.\
+flashing.
+
**Note, the guide mentions a 3.3v DC PSU but you don't need this on the
X60 Tablet: if you don't have or don't want to use an external PSU,
then make sure not to connect the 3.3v leads mentioned in the guide;
instead, connect the AC adapter (the one that normally charges your
battery) so that the board has power (but don't boot it up)**
-![](../images/x60t_unbrick/0011.JPG)\
+![](../images/x60t_unbrick/0011.JPG)
+
Correlate the following with the BBB guide linked above:
POMONA 5250:
@@ -113,14 +134,16 @@ Correlate the following with the BBB guide linked above:
This is how you will connect. Numbers refer to pin numbers on the BBB, on the plugs near the DC jack.
Connecting the BBB and pomona (in this image, an external 3.3v DC PSU
-was used):\
+was used):
+
![](images/x60/th_bbb_flashing.jpg)
Flashrom binaries for ARM (tested on a BBB) are distributed in
libreboot\_util. Alternatively, libreboot also distributes flashrom
source code which can be built.
-SSH'd into the BBB:\
+SSH'd into the BBB:
+
# **./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
yourrom.rom**
@@ -132,7 +155,8 @@ Reverse the steps to re-assemble your system.
-Copyright © 2014, 2015 Leah Rowe <info@minifree.org>\
+Copyright © 2014, 2015 Leah Rowe <info@minifree.org>
+
Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International license or any later version published by Creative