diff options
Diffstat (limited to 'docs/install/index.html')
| -rw-r--r-- | docs/install/index.html | 328 |
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>"Verifying flash... VERIFIED."</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>"YOURBOARD/YOURROM" 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>"Verifying flash... VERIFIED."</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>"Verifying flash... VERIFIED."</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>"Verifying flash... VERIFIED."</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>"Verifying flash... VERIFIED."</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> |