From 8e76ed523cf4a44e4dd23afc0a91973a9e438e47 Mon Sep 17 00:00:00 2001 From: Leah Rowe <leah@libreboot.org> Date: Sun, 15 Oct 2023 01:34:17 +0100 Subject: [PATCH] re-link dell-flash-unlock in guides (util rename) Signed-off-by: Leah Rowe <leah@libreboot.org> --- site/docs/install/e6400.md | 21 +++++++++++++++------ site/docs/maintain/index.md | 8 +++++++- site/news/e6400.md | 6 +++++- site/news/e6400.uk.md | 5 ++++- 4 files changed, 31 insertions(+), 9 deletions(-) diff --git a/site/docs/install/e6400.md b/site/docs/install/e6400.md index d264f65..2a5fefd 100644 --- a/site/docs/install/e6400.md +++ b/site/docs/install/e6400.md @@ -161,17 +161,23 @@ How to flash internally (no diassembly) Warning for BSD users --------------------- +**NOTE (15 October 2023): The util is now called `dell-flash-unlock`, but it +was previously called `e6400-flash-unlock`. Links have been updated.** + BSD *boots* and works properly on these machines, but take note: -Nicholas's [e6400-flash-unlock](https://browse.libreboot.org/lbmk.git/plain/util/e6400-flash-unlock/e6400_flash_unlock.c) +Nicholas's [dell-flash-unlock](https://browse.libreboot.org/lbmk.git/plain/util/dell-flash-unlock/dell_flash_unlock.c) utility has not yet been ported to BSD systems. The `flashrom` software is available on BSD systems. Libreboot's build system has not yet been ported to the BSDs. -BSD users could run Linux from USB to run `flashrom` and `e6400-flash-unlock`. +BSD users could run Linux from USB to run `flashrom` and `dell-flash-unlock`. Virtualisation is available in BSDs, where it should be feasible to run the Libreboot build system, in Linux, under virtualisation. +NOTE: BSD is mentioned above, but the only BSD tested for `dell-flash-unlock` +is OpenBSD, as of 15 October 2023. + Flashing from Linux ------------------- @@ -183,19 +189,22 @@ You can flash Libreboot directly from the vendor (Dell) BIOS, without taking the machine apart. It can be done entirely from Linux. It will probably also work on BSD systems, but it has only been testing on Linux thus far. -Check `util/e6400-flash-unlock` in the `lbmk.git` repository, or in release +**NOTE (15 October 2023): The util is now called `dell-flash-unlock`, but it +was previously called `e6400-flash-unlock`. Links have been updated.** + +Check `util/dell-flash-unlock` in the `lbmk.git` repository, or in release archives for Libreboot releases from 20230423 onwards. Go in there: - cd util/e6400-flash-unlock + cd util/dell-flash-unlock make With this program, you can unlock the flash in such a way where everything is writeable. Information about how to use it is in the `README.md` file which is included in that program's directory, or you can read it online here: -<https://browse.libreboot.org/lbmk.git/plain/util/e6400-flash-unlock/README.md> +<https://browse.libreboot.org/lbmk.git/plain/util/dell-flash-unlock/README.md> Literally just run that program, and do what it says. You run it once, and shut down, and when you do, the system brings itself back up automatically. Then @@ -233,7 +242,7 @@ original Dell BIOS first, using the -r option: flashrom -p internal -r backup.rom -c MX25L3205D/MX25L3208D -Do this while in a flashable state, after the 2nd run of `e6400-flash-unlock`. +Do this while in a flashable state, after the 2nd run of `dell-flash-unlock`. Make sure the `backup.rom` file gets backed up to an external storage media, not the E6400 itself. diff --git a/site/docs/maintain/index.md b/site/docs/maintain/index.md index c6ef929..7a7624b 100644 --- a/site/docs/maintain/index.md +++ b/site/docs/maintain/index.md @@ -368,13 +368,19 @@ where the intention is that `lbmk.git` itself should be small and efficient. Where appropriate, and where the code is small enough, or it is otherwise deemed desirable, `lbmk.git` provides a few utilities as part of itself, namely: -util/e6400-flash-unlock/ +util/dell-flash-unlock/ --------------- +**NOTE (15 October 2023): The util is now called `dell-flash-unlock`, but it +was previously called `e6400-flash-unlock`. Links have been updated.** + This program, written by Nicholas Chin, unlocks the boot flash on Dell Latitude E6400; it permits internal flashing, from factory firmware to Libreboot, so that the user need not disassemble and flash externally. +It also supports several other Dell laptops, with similar ECs. Check the +README file included in this directory, for more information. + util/me7\_update\_parser/ --------------- diff --git a/site/news/e6400.md b/site/news/e6400.md index 47e2cb7..d8c8dcd 100644 --- a/site/news/e6400.md +++ b/site/news/e6400.md @@ -46,6 +46,10 @@ But wait.... It gets better: Software flashing possible! (no disassembly) --------------------------- +**NOTE (15 October 2023): The util is now called `dell-flash-unlock`, but it +was previously called `e6400-flash-unlock`. Links have been updated. And +Nichelas is still a genius.** + tl;dr Nicholas is a genius, but he spent time studying the board, finding that the EC is hooked up to GPIO33 which allows for flash descriptor override. He successfully reverse engineered a command that can be used to disable IFD @@ -60,7 +64,7 @@ taking it apart, and you can install it easily within 5 minutes.** This is done with the following utility from Nicholas Chin, which I merged into lbmk: -<https://browse.libreboot.org/lbmk.git/tree/util/e6400-flash-unlock> +<https://browse.libreboot.org/lbmk.git/tree/util/dell-flash-unlock> The original util, before Nicholas sent it to lbmk, is here (same util): diff --git a/site/news/e6400.uk.md b/site/news/e6400.uk.md index d0fdc30..7aa9987 100644 --- a/site/news/e6400.uk.md +++ b/site/news/e6400.uk.md @@ -44,6 +44,9 @@ eBay. ДоÑтатньо, щоб тримати людей з Ñимпатією Прошивка програмним забезпеченнÑм можлива! (без розбору) --------------------------- +**NOTE (15 October 2023): The util is now called `dell-flash-unlock`, but it +was previously called `e6400-flash-unlock`. Links have been updated.** + tl;dr ÐÑ–ÐºÐ¾Ð»Ð°Ñ Ð³ÐµÐ½Ñ–Ð¹, але він витратив чаÑ, вивчаючи плату, шукаючи, що EC з'єднана з GPIO33, що дозволÑÑ” пройти через flash descriptor. Він уÑпішно провів зворотню розробку команди, Ñка може бути викориÑтана Ð´Ð»Ñ Ð²Ð¸Ð¼ÐºÐ½ÐµÐ½Ð½Ñ @@ -57,7 +60,7 @@ EC з'єднана з GPIO33, що дозволÑÑ” пройти через flas Це робитьÑÑ Ð· наÑтупною утилітою від ÐіколаÑа Чін, Ñку Ñ Ð·Ð»Ð¸Ð»Ð° в lbmk: -<https://browse.libreboot.org/lbmk.git/tree/util/e6400-flash-unlock> +<https://browse.libreboot.org/lbmk.git/tree/util/dell-flash-unlock> Оригінальна утиліта, перед тим, Ñк ÐÑ–ÐºÐ¾Ð»Ð°Ñ Ð²Ñ–Ð´Ð¿Ñ€Ð°Ð²Ð¸Ð² Ñ—Ñ— в lbmk, тут (та Ñама утиліта): -- GitLab