From 5a806015cfe89f50e8e37d3da209a8ca645597f1 Mon Sep 17 00:00:00 2001
From: Leah Rowe <info@minifree.org>
Date: Fri, 1 Mar 2024 13:42:59 +0000
Subject: [PATCH] w541 guide

Signed-off-by: Leah Rowe <info@minifree.org>
---
 site/docs/install/index.md         |  4 ++-
 site/docs/install/w541_external.md | 56 ++++++++++++++++++++++++++++++
 2 files changed, 59 insertions(+), 1 deletion(-)
 create mode 100644 site/docs/install/w541_external.md

diff --git a/site/docs/install/index.md b/site/docs/install/index.md
index 1a98f70..5641f8e 100644
--- a/site/docs/install/index.md
+++ b/site/docs/install/index.md
@@ -912,7 +912,9 @@ LIBREBOOT](../../news/safety.md).**
 Refer to the [ivybridge/haswell common guide.](ivy_has_common.md) for how to
 make the rom image usable for external flashing.
 
-Read [board documentation](/docs/install/t440p_external.html) for disassembly.
+Read [board documentation](/docs/install/t440p_external.md) for disassembly.
+
+and for W541: [W541 guide](/docs/install/w541_external.md)
 
 **If using release ROMs, neutered ME must be inserted. Refer to the above
 guide.**
diff --git a/site/docs/install/w541_external.md b/site/docs/install/w541_external.md
new file mode 100644
index 0000000..fb3e965
--- /dev/null
+++ b/site/docs/install/w541_external.md
@@ -0,0 +1,56 @@
+---
+title: ThinkPad T440p external flashing
+x-toc-enable: true
+...
+
+Buy Libreboot preinstalled
+==========================
+
+This laptop is available to buy with Libreboot pre-installed:
+<https://minifree.org/product/libreboot-w541/>
+
+Introduction
+============
+
+NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
+now, as of 27 January 2024, which is a fork of flashrom.
+
+**[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
+OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
+
+Read the [Ivybridge/Haswell common guide](/docs/install/ivy_has_common.html) if you want more information.
+All of the following instructions assume that you've cloned lbmk and are operating from the
+root of that project. To do so, run
+
+	git clone https://codeberg.org/libreboot/lbmk
+	cd lbmk
+
+You can now follow the rest of the instructions.
+
+Warning: external flashing notes
+================================
+
+This machine cannot be easily flashed externally. It is recommended
+to set a higher drive strength on your programmer; anything 12mA to
+16mA should be fine.
+
+When flashing one of the two chips, you must tie the chip select high
+on the other one. More testing is needed.
+
+The only currently known-reliable way of flashing it is to de-solder both
+ICs, flash them in a socket and solder them back. You could alternatively
+use WSON8 sockets, and install WSON8 ICs in them.
+
+Here are some photos of the flashes being soldered and re-soldered:
+
+<img tabindex=1 class="l" src="https://av.libreboot.org/w541/flash_removed.jpg" /><span class="f"><img src="https://av.libreboot.org/w541/flash_removed.jpg" /></span>
+<img tabindex=1 class="l" src="https://av.libreboot.org/w541/flash_soldered.jpg" /><span class="f"><img src="https://av.libreboot.org/w541/flash_soldered.jpg" /></span>
+
+Flash the chip in a socket:
+
+<img tabindex=1 class="l" src="https://av.libreboot.org/hp2170p/ch341a_socket_soic8.jpg" /><span class="f"><img src="https://av.libreboot.org/hp2170p/ch341a_socket_soic8.jpg" /></span>
+
+NOTE: The pictured flasher is a CH341A, but it's modified to have 3.3v logic levels
+and pull-up resistors on WP/HOLD - the unmodified one is unsafe to sue on this machine, unless
+you use a model with 3.3v flash (e.g. some of the green models). More info available
+in the [SPI flashing guide](spi.md).