2022-11-13 21:12:15 +00:00
|
|
|
---
|
|
|
|
title: ThinkPad X230/X230T external flashing
|
|
|
|
x-toc-enable: true
|
|
|
|
...
|
|
|
|
|
2024-04-15 20:19:02 +00:00
|
|
|
This machine is available to purchase with Libreboot pre-installed:
|
|
|
|
<https://minifree.org/product/libreboot-x230/>
|
|
|
|
|
2024-01-27 22:35:38 +00:00
|
|
|
NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
|
|
|
|
now, as of 27 January 2024, which is a fork of flashrom.
|
|
|
|
|
2023-07-07 22:04:10 +00:00
|
|
|
**[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
|
|
|
|
OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
|
|
|
|
|
2022-11-25 23:02:20 +00:00
|
|
|
NOTE: Internal flashing (from vendor firmware) to Libreboot is possible, on
|
|
|
|
this board, but the steps are a bit more complex than using an external flasher.
|
|
|
|
See: [internal ivybridge flashing](ivy_internal.md)
|
|
|
|
|
|
|
|
Read the [Ivybridge/Haswell common guide](ivy_has_common.md) if you want more information.
|
2022-11-14 02:31:12 +00:00
|
|
|
All of the following instructions assume that you've cloned lbmk and are operating from the
|
2022-11-13 21:12:15 +00:00
|
|
|
root of that project. To do so, run
|
|
|
|
|
2023-04-08 18:45:15 +00:00
|
|
|
git clone https://codeberg.org/libreboot/lbmk
|
2022-11-14 02:31:12 +00:00
|
|
|
cd lbmk
|
2022-11-13 21:12:15 +00:00
|
|
|
|
|
|
|
You can now follow the rest of the instructions.
|
|
|
|
|
|
|
|
Preparing a release Rom
|
|
|
|
-----------------------
|
|
|
|
|
2023-10-10 20:37:16 +00:00
|
|
|
You must patch the release rom with the necessary vendor files *and then* flash it to your board.
|
2022-11-13 21:12:15 +00:00
|
|
|
|
2023-10-10 20:37:16 +00:00
|
|
|
Lbmk includes a script that will automatically inject the necessary files into a rom image.
|
2022-11-13 21:12:15 +00:00
|
|
|
The script can determine the board automatically if you have not changed the name, but you can also manually set the board name with the `-b` flag.
|
|
|
|
|
2023-10-10 20:37:16 +00:00
|
|
|
In order to inject the necessary files into a rom image, run the script from the root of lbmk and point to the rom image.
|
2023-04-03 02:30:13 +00:00
|
|
|
Run the injection script pointing to the release archive you downloaded:
|
|
|
|
|
2023-10-20 05:07:57 +00:00
|
|
|
./vendor inject /path/to/libreboot-20230319-18-g9f76c92_t440_12mb.tar.xz
|
2023-04-03 02:30:13 +00:00
|
|
|
|
|
|
|
The script can automatically detect the board as long as you do not change the file name.
|
|
|
|
You can then find flash-ready ROMs in `/bin/release/`
|
|
|
|
|
|
|
|
Alternatively, you may patch only a single rom file.
|
2022-11-13 21:12:15 +00:00
|
|
|
For example:
|
|
|
|
|
2023-10-20 05:07:57 +00:00
|
|
|
./vendor inject -r x230_libreboot.rom -b x230_12mb
|
2022-11-13 21:12:15 +00:00
|
|
|
|
|
|
|
Optionally, you can use this script to modify the mac address of the rom with the `-m` flag.
|
|
|
|
For example:
|
|
|
|
|
2023-10-20 05:07:57 +00:00
|
|
|
./vendor inject -r x230_libreboot.rom -b x230_12mb -m 00:f6:f0:40:71:fd
|
2022-11-13 21:12:15 +00:00
|
|
|
|
2022-11-17 11:51:52 +00:00
|
|
|
NOTE: this makes use of `nvmutil`, which you can read more about in
|
|
|
|
the [nvmutil documentation](nvmutil.md).
|
|
|
|
|
2022-11-13 21:12:15 +00:00
|
|
|
Splitting The Rom
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
You can use `dd` to easily split your rom into the two separate portions for
|
|
|
|
external flashing.
|
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
dd if=libreboot.rom of=top.rom bs=1M skip=8
|
|
|
|
dd if=libreboot.rom of=bottom.rom bs=1M count=8
|
2022-11-13 21:12:15 +00:00
|
|
|
|
|
|
|
Flash the top chip with top.rom, and tho bottom chip with bottom.rom.
|
2024-01-27 22:35:38 +00:00
|
|
|
Don't worry about knowing which chip is which on a standard setup; flashprog will let you know if the
|
2022-11-13 21:12:15 +00:00
|
|
|
image size is incorrect for the chip you're flashing.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Disassembly
|
|
|
|
-----------
|
|
|
|
|
|
|
|
Start by removing the battery.
|
|
|
|
Remove every screw from the bottom of the machine marked with a keyboard/touchpad indicator.
|
|
|
|
|
|
|
|
Pry up the keyboard and separate it from the palmrest.
|
2022-11-14 02:31:12 +00:00
|
|
|
![](https://av.libreboot.org/board/x230/palmrest.jpg)
|
2022-11-13 21:12:15 +00:00
|
|
|
|
|
|
|
Unplug the ribbon cable from the palmrest and pry it off as well.
|
2022-11-14 02:31:12 +00:00
|
|
|
![](https://av.libreboot.org/board/x230/palmrest_cable.jpg)
|
2022-11-13 21:12:15 +00:00
|
|
|
|
|
|
|
Pull up the protective cover to reveal the two soic chips for flashing.
|
2022-11-14 02:31:12 +00:00
|
|
|
![](https://av.libreboot.org/board/x230/chipLocation.jpg)
|