summaryrefslogtreecommitdiffstats
path: root/docs/install/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/install/index.html')
-rw-r--r--docs/install/index.html328
1 files changed, 116 insertions, 212 deletions
diff --git a/docs/install/index.html b/docs/install/index.html
index 4ec7bdb..6f95068 100644
--- a/docs/install/index.html
+++ b/docs/install/index.html
@@ -26,27 +26,27 @@
</div>
<div class="section">
-
- <h2>Setting up external programmers</h2>
+
<ul>
- <li><a href="bbb_setup.html">Setup the BeagleBone Black as an SPI flashrom programmer</a></li>
+
</ul>
- <h2>Installing libreboot (software)</h2>
+ <h2>Software methods</h2>
<ul>
<li><a href="#rom">List of ROM images in libreboot</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/X200/R400/macbook21: How to flash your ROM (if running libreboot or coreboot already)</a></li>
+ <li><a href="#flashrom">How to install or update libreboot (if running libreboot or coreboot)</a></li>
+ <li><a href="#flashrom_lenovobios">ThinkPad X60/T60: Initial installation guide (if running Lenovo BIOS firmware)</a></li>
+ <li><a href="#flashrom_macbook21">MacBook2,1: Initial installation guide (if running Apple EFI firmware)</a></li>
</ul>
- <h2>Installing libreboot (hardware)</h2>
+ <h2>Hardware methods</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>
- <li><a href="x200_external.html">ThinkPad X200: How to unbrick</a> (also the initial installation guide for this machine)</li>
- <li><a href="r400_external.html">ThinkPad R400: How to unbrick</a> (also the initial installation guide for this machine)</li>
+ <li><a href="bbb_setup.html">How to programme an SPI flash chip with the BeagleBone Black</a></li>
+ <li><a href="x60_unbrick.html">ThinkPad X60: Recovery guide</a></li>
+ <li><a href="x60tablet_unbrick.html">ThinkPad X60 Tablet: Recovery guide</a></li>
+ <li><a href="t60_unbrick.html">ThinkPad T60: Recovery guide</a></li>
+ <li><a href="x200_external.html">ThinkPad X200: Initial installation guide</a> (also the recovery guide)</li>
+ <li><a href="r400_external.html">ThinkPad R400: Initial installation guide</a> (also the recovery guide)</li>
</ul>
</div>
@@ -56,15 +56,14 @@
<h1 id="rom">List of ROM images in libreboot</h1>
<p>
- Use the list of archives below to know which archive is correct
- for your device:
+ Libreboot supports the following (refer to the <a href="../release.html">release</a> page):
</p>
<ul>
- <li>ThinkPad X60, X60s and X60 Tablet: <b>libreboot_x60.tar.xz</b></li>
- <li>ThinkPad T60: <b>libreboot_t60.tar.xz</b> (note, see <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>)</li>
- <li>ThinkPad X200: <b>libreboot_x200_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_x200_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/x200.html">../hcl/x200.html</a>)</li>
- <li>ThinkPad R400: <b>libreboot_r400_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_r400_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/r400.html">../hcl/r400.html</a>)</li>
- <li>Apple MacBook1,1 and MacBook2,1: <b>libreboot_macbook21.tar.xz</b></li>
+ <li>Apple MacBook1,1 and MacBook2,1: download <b>libreboot_macbook21.tar.xz</b></li>
+ <li>ThinkPad X60, X60s and X60 Tablet: download <b>libreboot_x60.tar.xz</b></li>
+ <li>ThinkPad T60: download <b>libreboot_t60.tar.xz</b> (see <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>)</li>
+ <li>ThinkPad X200: download <b>libreboot_x200_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_x200_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/x200.html">../hcl/x200.html</a>)</li>
+ <li>ThinkPad R400: download <b>libreboot_r400_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_r400_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/r400.html">../hcl/r400.html</a>)</li>
</ul>
<p>
@@ -84,15 +83,11 @@
<h2 id="qemu">QEMU</h2>
<p>
- Coreboot supports <a href="http://www.coreboot.org/QEMU">QEMU</a>. QEMU is useful for testing purposes. Libreboot
- comes with ROM images built for QEMU, by default.
- </p>
- <p>
- The following ROM image archives are available in libreboot:
+ Libreboot comes with ROM images built for QEMU, by default:
</p>
<ul>
- <li>libreboot_qemu_q35_ich9.tar.xz</li>
- <li>libreboot_qemu_i440fx_piix4.tar.xz</li>
+ <li><b>libreboot_qemu_q35_ich9.tar.xz</b></li>
+ <li><b>libreboot_qemu_i440fx_piix4.tar.xz</b></li>
</ul>
<p>
Examples of how to use libreboot in QEMU:
@@ -114,43 +109,77 @@
</p>
</div>
-
+
<div class="section">
- <h1 id="flashrom_lenovobios">X60/X60S/X60T/T60: How to flash the ROMs onto your machine (if running Lenovo BIOS firmware).</h1>
+ <h1 id="flashrom">How to install or update libreboot (if running libreboot or coreboot)</h1>
<div class="important">
-
<p>
- Hover over the next paragraph to make it black.
+ <b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</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.
+ </div>
+
+ <p>
+ These instructions work for most targets, provided that they are already running libreboot or coreboot.
+ </p>
+ <p>
+ Look at the <a href="#rom">list of ROM images</a> to see which image is compatible with your device.
+ </p>
+ <p>
+ X60/T60 users with Lenovo BIOS should refer to <a href="#flashrom_lenovobios">#flashrom_lenovobios</a> instead.
+ Similary, MacBook2,1 users running Apple EFI should refer to <a href="#flashrom_macbook21">#flashrom_macbook21</a>.
+ </p>
+ <p>
+ <b>
+ ThinkPad T60 and X60 Tablet users: be sure to read <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>
+ or <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>.
+ </b>
+ </p>
+ <p>
+ X200/R400 users running Lenovo BIOS should refer to <a href="x200_external.html">x200_external.html</a>
+ or <a href="r400_external.html">r400_external.html</a>. <b>These machines contain the hard coded
+ MAC address for the onboard ethernet chipset, directly inside the SPI flash;
+ <a href="../hcl/gm45_remove_me.html#ich9gen">ich9gen</a> shows how to change it (the default
+ libreboot ROM images for these machines contain a generic MAC address).</b>
+ </p>
+ <p>
+ X200/R400 users should also note, that it is possible for the user to write-protect whole regions
+ of the SPI flash by using a modified descriptor. Locked regions must be flashed externally;
+ see <a href="x200_external.html">x200_external.html</a> or <a href="r400_external.html">r400_external.html</a>.
+ <b>Libreboot unlocks all regions, by default.</b>
+ </p>
+ <div class="important">
+ <p>
+ How to update the flash chip contents:<br/>
+ $ <b>sudo ./flash update <a href="#rom">yourrom.rom</a></b>
</p>
-
+ </div>
+ <div class="important">
<p>
- The following is for the libreboot image and *not* the factory bios dump:
+ 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:<br/>
+ $ <b>sudo ./flash forceupdate <a href="#rom">yourrom.rom</a></b>
</p>
+ </div>
+
+ <div class="important">
+
<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 ROMs 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>.
+ 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>
</div>
+ <p><a href="#pagetop">Back to top of page</a></p>
+
+ </div>
+
+ <div class="section">
+
+ <h1 id="flashrom_lenovobios">ThinkPad X60/T60: Initial installation guide (if running Lenovo BIOS firmware)</h1>
+
<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>
@@ -161,16 +190,25 @@
<b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</p>
</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 ./flash i945lenovo_firstflash bin/<a href="#rom">YOURBOARD/YOURROM</a>.</b>
+ <b>
+ Warning: this guide will not instruct the user how to backup the original Lenovo BIOS firmware. These backups
+ are tied to each machine, and will not work on any other.
+ For that, please refer to <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.
+ </b>
</p>
<div class="important">
+
+ <p>
+ The first half of the procedure is as follows:<br/>
+ $ <b>sudo ./flash i945lenovo_firstflash <a href="#rom">yourrom.rom</a>.</b>
+ </p>
+
+ </div>
+
+ <div class="important">
<p>
You should see within the output the following:<br/>
@@ -194,16 +232,12 @@
</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 ./flash i945lenovo_secondflash bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
- </p>
+ <div class="important">
+ <p>
+ When you have booted up again, you must also do this:<br/>
+ $ <b>sudo ./flash i945lenovo_secondflash <a href="#rom">yourrom.rom</a></b>
+ </p>
+ </div>
<div class="important">
@@ -217,46 +251,20 @@
<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>
</div>
<div class="section">
- <h1 id="flashrom_macbook21">macbook21: How to flash your ROM (if running Apple EFI firmware)</h1>
+ <h1 id="flashrom_macbook21">MacBook2,1: Initial installation guide (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>
+ <b>If you have a MacBook1,1, refer to <a href="../hcl/index.html#macbook11">../hcl/index.html#macbook11</a> for flashing instructions.</b>
</p>
</div>
@@ -271,149 +279,45 @@
<p>
Be sure to read the information in <a href="../hcl/index.html#macbook21">../hcl/index.html#macbook21</a>.
</p>
-
- <div class="important">
- <p>
- <b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
- </p>
- </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>
- Use this flashing script, to install libreboot:<br/>
- <b>$ sudo ./flash i945apple_firstflash bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
+ <b>
+ Warning: this guide will not instruct the user how to backup the original Apple EFI firmware.
+ For that, please refer to <a href="http://www.coreboot.org/Board:apple/macbook21">http://www.coreboot.org/Board:apple/macbook21</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>
+ <b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</p>
-
-
</div>
- <p><a href="#pagetop">Back to top of page.</a></p>
-
- </div>
-
- <div class="section">
-
- <h1 id="flashrom">X60/X60S/X60T/T60/X200/R400/macbook21: How to flash the ROMs 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 Lenovo BIOS running (X200), go to <a href="x200_external.html">x200_external.html</a> instead.
- </b>
- </p>
- <p>
- <b>
- If you have Lenovo BIOS running (R400), go to <a href="r400_external.html">r400_external.html</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 have an X200 or R400 with libreboot or coreboot already running, note that
- the Gbe in the boot flash contains your MAC address. You will need to change the default
- MAC address inside the ROM images before flashing a new libreboot image. See
- <a href="../hcl/gm45_remove_me.html#ich9gen">ich9gen</a> for details.
-
- Another important note about the X200/R400: even if you do already have libreboot or coreboot,
- it is possible for the user to write-protect regions in the flash chip, by modifying
- the flash descriptor. If you have locked regions, you will need an external flasher
- (see <a href="x200_external.html">x200_external.html</a> or <a href="x200_external.html">x200_external.html</a>)
- to re-flash those regions. By default,
- the X200 and R400 ROM images in libreboot contain a descriptor+gbe with all regions unlocked.
- </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>
+ Look at the <a href="#rom">list of ROM images</a> to see which image is compatible with your device.
</p>
+
<div class="important">
<p>
- <b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
+ Use this flashing script, to install libreboot:<br/>
+ $ <b>sudo ./flash i945apple_firstflash <a href="#rom">yourrom.rom</a></b>
</p>
</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 update bin/<a href="#rom">YOURBOARD/YOURROM</a></b>
- </p>
- <p>
- If you are sure that you are flashing the correct image but you get the error
- <b>This coreboot image (LENOVO:ThinkPad X60) does not appear to be correct for the detected mainboard (Lenovo:ThinkPad X60 / X60s / X60t) or
- similar (if it's a different board), then do</b>:
- <br/>
- <b>$ sudo ./flash forceupdate 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.
+ You should also see within the output the following:<br/>
+ <b>&quot;Verifying flash... VERIFIED.&quot;</b>
</p>
<p>
- <b>
- If you boot and you see nothing, try turning up the backlight (Fn+Home for X60/X60S/X60T/T60/X200, F2 for macbook21).
- </b>
+ Shut down.
</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>
+ <p><a href="#pagetop">Back to top of page.</a></p>
</div>