installation notes for dell latitude e6430

Signed-off-by: Leah Rowe <leah@libreboot.org>

site/contrib.md

@@ -291,7 +291,11 @@ Made the libreboot logo.
 Nicholas Chin
 -------------
 
-[Ported Dell Latitude E6400 to Libreboot](news/e6400.md).
+[Ported Dell Latitude E6400 to Libreboot](news/e6400.md)
+and also [Dell Latitude E6430](hardware/e6430.md) - author of
+the `dell-flash-unlock` (formerly `e6400-flash-unlock`) utility, which
+can unlock the flash on these boards, allowing internal flashing of
+Libreboot directly from host OS running under the original Dell firmware.
 
 Patrick "P. J." McDermott
 ---------------------------

site/docs/hardware/e6430.md

@@ -0,0 +1,75 @@
+---
+title: Dell Latitude E6430
+x-toc-enable: true
+...
+
+<div class="specs">
+<center>
+Dell Latitude E6430
+</center>
+
+| ***Specifications***       |                                                |
+|----------------------------|------------------------------------------------|
+| **Manufacturer**           | Dell                                           |
+| **Name**                   | Latitude E6430                                 |
+| **Variants**               | E6430 with Intel GPU supported                 |
+| **Released**               | 2012                                           |
+| **Chipset**                | Intel Ivy Bridge                               |
+| **CPU**                    | Intel Core i3, i5 or i7         .              |
+| **Graphics**               | Intel HD 4000 and unsupported NVidia NVS 5200M | 
+| **Display**                | 1366x768/1600x900 TFT                          |
+| **Memory**                 | 4 or 8GB (Upgradable to 16GB)                   |
+| **Architecture**           | x86_64                                         |
+| **EC**                     | SMSC MEC5055 with proprietary firmware         |
+| **Original boot firmware** | Dell UEFI                                      |
+| **Intel ME/AMD PSP**       | Present. Can be completely disabled.           |
+| **Flash chip**             | 2xSOIC-8, 12MiB (8MiB and 4MiB in combination) |
+
+
+```
+W+: Works without blobs; 
+N: Doesn't work; 
+W*: Works with blobs; 
+U: Untested; 
+P+: Partially works; 
+P*: Partially works with blobs
+```
+
+| ***Features***                                    |    |
+|---------------------------------------------------|----|
+| **Internal flashing with original boot firmware** | W+ |
+| **Display (if Intel GPU)**                        | W+ |
+| **Display (if Nvidia GPU)**                       | U  |
+| **Audio**                                         | W+ |
+| **RAM Init**                                      | W+ |
+| **External output**                               | W+ |
+| **Display brightness**                            | P+ | 
+
+| ***Payloads supported***  |           |
+|---------------------------|-----------|
+| **GRUB**                  | FAIL     |
+| **SeaBIOS**               | Works     |
+| **SeaBIOS with GRUB**     | Works    |
+</div>
+Introduction
+============
+
+ROM images for Dell Latitude E6430 are available for flashing in the Libreboot
+releases *after* 20230625, or you can compile a ROM image for installation via
+lbmk, see: [build instructions](../build/)
+
+Only the Intel GPU variants are supported, currently. All models with Intel GPU
+are assumed to work.
+
+Unlike the E6400, this one does require a neutered Intel ME image to run. This
+means running it through `me_cleaner` before flashing; the Libreboot build
+system does this automatically, during build, or you can insert a neutered
+ROM image using the vendor scripts, see guide:
+
+[Insert vendor files](../install/ivy_has_common.md)
+
+As with the E6400, this one is flashable in software, from Dell UEFI firmware
+to Libreboot. Please refer to the installation instructions.
+
+**To install Libreboot, see: [E6430 installation
+instructions](../install/e6430.md)**

site/docs/hardware/index.md

@@ -50,19 +50,21 @@ libreboot currently supports the following systems in this release:
 -   [Acer G43T-AM3](acer_g43t-am3.md)
 -   [Apple iMac 5,2](imac52.md)
 -   [ASUS KCMA-D8 motherboard](kcma-d8.md)
--   [Dell Precision T1650](t1650.md)
+-   [Dell Precision T1650](t1650.md) (**easy to flash without disassembly**)
 -   [Gigabyte GA-G41M-ES2L motherboard](ga-g41m-es2l.md)
 -   [HP Elite 8200 SFF/MT](hp8200sff.md) (HP 6200 Pro Business probably works too)
--   [HP Elite 8300 USDT](hp8300usdt.md)
+    (**easy to flash without disassembly**)
+-   [HP Elite 8300 USDT](hp8300usdt.md) (**easy to flash without disassembly**)
 -   [Intel D510MO and D410PT motherboards](d510mo.md)
 
 ### Laptops (Intel, x86)
 
--   [Apple MacBook1,1 and MacBook2,1](macbook21.md)
+-   [Apple MacBook1,1 and MacBook2,1](macbook21.md) (2,1 flashable without disassembly)
 -   [Dell Latitude E6400, E6400 XFR and E6400 ATG, all with Nvidia or Intel
     GPU](e6400.md) **(easy to flash, no disassembly, similar
     hardware to X200/T400)**
--   [HP EliteBook 2170p](hp2170p.md)
+-   [Dell Latitude E6430 (Intel GPU](e6430.md) **(easy to flash, no disassembly)**
+-   [HP EliteBook 2170p](hp2170p.md) (**socketed flash IC**)
 -   [HP EliteBook 2560p](hp2560p.md)
 -   [HP EliteBook 2570p](hp2570p.md)
 -   [HP EliteBook 8470p](hp8470p.md)
@@ -76,7 +78,7 @@ libreboot currently supports the following systems in this release:
 -   [Lenovo ThinkPad T440p](../install/t440p_external.md)
 -   [Lenovo ThinkPad T500](t500.md)
 -   [Lenovo ThinkPad T530 / W530](../install/ivy_has_common.md) (no install
--   Lenovo ThinkPad T60 (with Intel GPU)
+-   Lenovo ThinkPad T60 (with Intel GPU) (**easy to flash without disassembly**)
 -   [Lenovo ThinkPad W500](t500.md)
 -   [Lenovo ThinkPad W541](../install/ivy_has_common.md) (no install docs yet)
 -   [Lenovo ThinkPad X200 / X200S / X200 Tablet](x200.md)
@@ -86,7 +88,7 @@ libreboot currently supports the following systems in this release:
 -   [Lenovo Thinkpad X230](../install/x230_external.md)
 -   [Lenovo Thinkpad X230t](../install/x230_external.md)
 -   Lenovo ThinkPad X301
--   Lenovo ThinkPad X60 / X60S / X60 Tablet
+-   Lenovo ThinkPad X60 / X60S / X60 Tablet (**easy to flash without disassembly**)
 
 ### Laptops (ARM, with U-Boot payload)
 

site/docs/hardware/index.zh-cn.md

@@ -47,6 +47,7 @@ x-toc-enable: true
 
 -   [Apple MacBook1,1 及 MacBook2,1](macbook21.md)
 -   [Dell Latitude E6400, E6400 XFR 及 E6400 ATG，皆支持 Nvidia 或 Intel GPU](e6400.md) **（刷入简单，无需拆解，硬件类似 X200/T400）**
+-   [Dell Latitude E6430, Intel GPU](e6430.md) **（刷入简单，无需拆解）**
 -   [HP EliteBook 2170p](hp2170p.md)
 -   [HP EliteBook 2560p](hp2560p.md)
 -   [HP EliteBook 2570p](hp2570p.md)

site/docs/install/e6400.md

@@ -167,13 +167,10 @@ was previously called `e6400-flash-unlock`. Links have been updated.**
 BSD *boots* and works properly on these machines, but take note:
 
 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
+utility has been ported to OpenBSD, but *other* BSDs are assumed unsupported for
-available on BSD systems. Libreboot's build system has not yet been ported to
+now. The `flashrom` software is available on BSD systems. Libreboot's build
-the BSDs.
+system has *itself* not yet been ported to the BSDs, but you can use the
-
+flash unlock utility.
-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.

site/docs/install/e6430.md

@@ -0,0 +1,174 @@
+---
+title: Flashing the Dell Latitude E6430
+x-toc-enable: true
+...
+
+Introduction
+============
+
+This guide is for those who want libreboot on their Latitude E6430 while
+they still have the original Dell firmware present. This guide can also be
+followed (adapted) if you brick your E6430, and you want to recover it.
+
+**The Intel video initialisation is libre, implemented with publicly available
+source code via libgfxinit, from the coreboot project.**
+
+Only the intel GPU variants are supported. The Nvidia GPU variants are untested
+and should be assumed *broken* by default.
+
+Flash chip size {#flashchips}
+===============
+
+Use this to find out:
+
+	flashrom -p internal
+
+The internal flash size is 12MiB on this board; physically, an 8MiB and 4MiB
+chip (two chips) but this distinction only matters for external flashing.
+
+MAC address {#macaddress}
+===========
+
+The MAC address is part of the ROM image that you're flashing. You can change
+it at any time, before or after you've flashed Libreboot; you can also change
+it in the *Dell* BIOS, if you really want to. This is for the onboard gigabit
+ethernet device.
+
+Refer to [mac\_address.md](../hardware/mac_address.md).
+
+It is recommended that you run *nvmutil*. See:
+
+[nvmutil usage manual](nvmutil.md)
+
+The `nvmutil` software is specifically designed for changing MAC addresses,
+and it implements a few more safeguards (e.g. prevents multicast/all-zero
+MAC addresses) and features (MAC address randomisation, ability to correct or
+intententionally corrupt(disable) GbE sections if you wish, swap GbE parts,
+etc). - **it is also the only software available for this. Please do not
+use ich9gen on this board. This is an ivybridge board, not ICH9M.**
+
+Intel GPU: libre video initialisation available
+===============================================
+
+Libreboot uses coreboot's native `libgfxinit` on this platform, for
+variants with Intel graphics.
+
+Libreboot releases after 20230625 will support this board, otherwise you can
+refer to the [build instructions](../build/)
+
+Nvidia GPU: Video BIOS Option ROM required
+==========================================
+
+UNSUPPORTED. DO NOT BUY THE NVIDIA VARIANT.
+
+Only the Intel GPU variants are supported. It is believed that the Nvidia
+variants still have Intel GPUs in them, configured via hardware mux, but this
+has not yet been configured or tested in the coreboot code; you should assume
+that the Nvidia models do not work.
+
+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 [dell-flash-unlock](https://browse.libreboot.org/lbmk.git/plain/util/dell-flash-unlock/dell_flash_unlock.c)
+utility has been ported to OpenBSD, but *other* BSDs are assumed unsupported for
+now. The `flashrom` software is available on BSD systems. Libreboot's build
+system has *itself* not yet been ported to the BSDs, but you can use the
+flash unlock utility.
+
+NOTE: BSD is mentioned above, but the only BSD tested for `dell-flash-unlock`
+is OpenBSD, as of 15 October 2023.
+
+Flashing from Linux
+-------------------
+
+MAKE SURE you boot with this Linux kernel parameter: `iomem=relaxed` - this
+disables memory protections, permitting `/dev/mem` access needed by flashrom.
+The flash is memory mapped and flashrom accesses it via `/dev/mem`.
+
+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.
+
+**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/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/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
+you run it and flash it unlocked. Then you run it again. The source code is
+intuitive enough that you can easily get the gist of it; it's writing some EC
+commands and changing some chipset config bits. The EC on this machine is
+hooked up to the `GPIO33` signal, sometimes called `HDA_DOCK_EN`, which sets
+the flash descriptor override thus disabling any flash protection by the IFD.
+It also bypasses the SMM BIOS lock protection by disabling SMIs, and Dell's
+BIOS doesn't set any other type of protection either such as writing to
+Protected Range registers.
+
+When you flash it, you can use this command:
+
+	flashrom -p internal -w libreboot.rom
+
+Where `libreboot.rom` is your E6430 ROM. *Make sure* it's the right one.
+If flashrom complains about multiple flash chips detected, just pick one of
+them (doesn't matter which one), with the `-C` flag as directed; just pick one,
+and if it doesn't work, try the next.
+
+When you see flashrom say `VERIFIED` at the end, that means the flash was
+successful. If you don't see that, or you're unsure, please [contact the
+Libreboot project via IRC](../../contact.md).
+
+BACK UP THE FACTORY BIOS
+========================
+
+The `-w` option flashes `libreboot.rom`. You may consider *backing up* the
+original Dell BIOS first, using the -r option:
+
+	flashrom -p internal -r backup.rom
+
+AGAIN: make sure to use `-C` accordingly, if you need to pick a chip (where
+flashrom has detected multiple chip definitions). Just pick one, any of them
+will probably work, if not try the next.
+
+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 E6430 itself.
+
+With this method, you can probably flash it within 5 minutes. Again, zero
+disassembly required!
+
+How to flash externally
+=========================
+
+Refer to [spi.md](spi.md) as a guide for external re-flashing.
+
+The SPI flash chip shares a voltage rail with the ICH9 southbridge, which is
+not isolated using a diode. As a result, powering the flash chip externally
+causes the ICH9 to partially power up and attempt to drive the SPI clock pin
+low, which can interfere with programmers such as the Raspberry Pi. See
+[RPi Drive Strength](spi.md#rpi-drive-strength) for a workaround.
+
+Have a look online for videos showing how to disassemble, if you wish to
+externally re-flash.
+

site/docs/install/index.md

@@ -310,6 +310,10 @@ the sections below:
 
 See: [Dell Latitude E6400 Libreboot Installation Guide](e6400.md)
 
+#### DELL Latitude E6430 laptop (easy to flash, no disassembly)
+
+See: [Dell Latitude E6430 Libreboot Installation Guide](e6430.md)
+
 #### ThinkPad X200/T400/T500/W500/R400/R500 vendor BIOS
 
 If you're running one of these, it cannot be flashed internally if you're still
@@ -554,6 +558,11 @@ DELL Latitude E6400 laptop (easy to flash, similar to X200/T400)
 
 See: [Dell Latitude E6400 Libreboot Installation Instructions](e6400.md)
 
+DELL Latitude E6430 laptop (easy to flash, no disassembly)
+-------------------------
+
+See: [Dell Latitude E6430 Libreboot Installation Instructions](e6430.md)
+
 ASUS KFSN4-DRE
 --------------