+Introduction
+============
+
+**Unavailable in Libreboot 20231106 or earlier. You must [compile from
+source](../build/), or use a release newer than 20231106.**
+
+This is a beastly 12.5" Broadwell machine from HP, the main benefit of which is
+high power efficiency (compared to Ivybridge and Haswell platforms), while
+offering similar CPU performance but much higher graphics performance.
+
+All variants of this mainboard will come with Intel HD 5500 graphics, which has
+completely free software initialisation in coreboot, provided by *libgfxinit*.
+
+Build ROM image from source
+---------------------------
+
+First, install the build dependencies and initialise git, using the
+instructions in [building from source](../build/). Unless you're using a
+release after Libreboot 20231106, you *must* use the latest `lbmk.git`.
+
+The build target, when building from source, is thus:
+
+ ./build roms hp820g2_12mb
+
+NOTE: The actual flash is 16MB, but you must flash only the first 12MB of it.
+The ROM images provided by Libreboot are 12MB.
+
+There is a separate 2MB *system* flash that you must *erase*, prior to
+installing Libreboot. This, along with Libreboot's modified IFD, bypasses
+the security (HP Sure Start) that the vendor put there, allowing you to
+use coreboot-based firmware such as Libreboot.
+
+Installation
+============
+
+Insert binary files
+-------------------
+
+If you're using a release ROM, please ensure that you've inserted extra firmware
+required refer to the [guide](../install/ivy_has_common.md) for that. (**failure
+to adhere to this advice will result in a bricked machine**)
+
+If you're *building* from source (using lbmk), the steps takes above are done
+for you automatically, inserting all of the required files. The above link is
+only relevant for *release* images, which lack some of these files.
+
+Set MAC address
+---------------
+
+This platform uses an Intel Flash Descriptor, and defines an Intel GbE NVM
+region. As such, release/build ROMs will contain the same MAC address. To
+change the MAC address, please read [nvmutil documentation](../install/nvmutil.md).
+
+Update an existing Libreboot installation
+-----------------
+
+NOTE: This section only applies if you haven't enabled write protection. You
+can otherwise use the external flashing instructions (see below) for both the
+initial installation and updates, but for updates you don't need to re-erase
+the private flash, if it was already erased.
+
+If you're already running Libreboot, and you don't have flash protection
+turned on, [internal flashing](../install/) is possible, but please note:
+
+You must *only* flash the first 12MB, and nothing in the final 4MB of the flash.
+This is because the EC firmware is in flash, and we don't touch that during
+initial installation or during updates.
+
+Update it like so:
+
+Create a dummy 16MB ROM like so:
+
+```
+dd if=/dev/zero of=new.bin bs=16M count=1
+```
+
+Then insert your 16MB ROM image into the dummy file:
+
+```
+dd if=libreboot.rom of=new.bin bs=12M count=1 conv=notrunc
+```
+
+The `libreboot.rom` file is the 12MB image from Libreboot. The `new.bin`
+file is the Libreboot ROM, padded to 16MB. You will not flash the entire 16MB
+file, but flashrom detects a 16MB flash IC. This just makes flashrom not
+complain about mismatching ROM/chip size.
+
+You should flash each region individually:
+
+```
+flashrom -p internal --ifd -i gbe -w new.bin --noverify-all
+flashrom -p internal --ifd -i bios -w new.bin --noverify-all
+flashrom -p internal --ifd -i me -w new.bin --noverify-all
+flashrom -p internal --ifd -i ifd -w new.bin --noverify-all
+```
+
+NOTE: The `--ifd` option uses the regions defined in the *flashed* IFD, so
+they must match the ROM. You can otherwise dump a layout file and use that,
+using the instructions below (using `-l layout.txt` instead of `--ifd`).
+
+NOTE: If you already did an installation before, and you don't want to
+[change the MAC address](../install/nvmutil.html) stored in the gbe region,
+you can skip the gbe/ifd/me regions as above, and flash just the BIOS region.
+
+NOTE: Use of `--ifd` requires flashrom 1.2 or higher. If you have an older
+version, or you don't have `--ifd`, you could instead do:
+
+```
+ifdtool -f layout.txt libreboot.rom
+```
+
+Then, instead of `--ifd` you would use `-l layout.txt`.
+
+ALSO: The `--ifd` option makes flashrom flash regions based on what's in
+the *current* flashed IFD.
+
+Flashing Libreboot first time (hardware)
+========================================
+
+**PLEASE ENSURE that you dump a copy of both flash ICs (system flash and
+private flash). Take two dumps of each, and make sure each has two good hashes.
+This is because there are certain files that, while you may not need for a
+regular Libreboot installation, may be useful for recovery purposes. You have
+been warned!**
+
+This section is relevant to you if you're still running the original HP
+firmware. You must [flash externally](../install/spi.md).
+
+Take stock of these further notes, because there are extra steps that you
+must take.
+
+HP Sure Start
+-------------
+
+There is a 16MB flash and a 2MB flash. Read this page for info:
+
