Merge pull request #968 from nedpfeiffer/nedpfeiffer-optiplex-docs

Update Optiplex documentation
Dasharo · Jan 3, 2025 · 6015533 · 6015533
2 parents 1167809 + 0e39f13
commit 6015533
Show file tree

Hide file tree

Showing 2 changed files with 26 additions and 10 deletions.
diff --git a/docs/variants/dell_optiplex/building-manual.md b/docs/variants/dell_optiplex/building-manual.md
@@ -34,9 +34,10 @@ the result binary using `cbfstool`. The methods are covered later on in the
     cd coreboot
     ```
 
-    Replace `vX.Y.Z` with a valid version, eg. `v0.1.0`:
+    Replace `vX.Y.Z` with a valid version, eg. `v0.1.1`:
 
     ```bash
+    git fetch --tags
     git checkout optiplex_7010_9010_vX.Y.Z
     ```
 

diff --git a/docs/variants/dell_optiplex/initial-deployment.md b/docs/variants/dell_optiplex/initial-deployment.md
@@ -120,7 +120,17 @@ binwalk -e O7010A29.exe -C .
 Assuming the extraction process was successful, you should now have an
 extracted UEFI image file, hidden under an unassuming name such as
 `65C10`. Deeper down the rabbit hole, you will now have to extract the
-blobs from this image using `uefi-firmware-parser`:
+blobs from this image using the `uefi-firmware` Python package, a set of scripts
+for parsing, extracting, and recreating UEFI firmware volumes. To install:
+
+```bash
+apt install python3-venv python3-pip
+python3 -m venv venv
+source venv/bin/activate
+pip install uefi-firmware==1.9
+```
+
+To extract the blobs (you may have to run the command twice):
 
 ```bash
  uefi-firmware-parser -e "_O7010A29.exe.extracted/65C10" -O
@@ -131,18 +141,23 @@ files. Now, let's copy them with more readable names for future reference:
 
 * EC firmware -
 
-`cp _O7010A29.exe.extracted/65C10_output/pfsobject/section-7ec6c2b0-3fe3-
-42a0-a316-22dd0517c1e8/volume-0x50000/file-d386beb8-4b54-4e69-94f5-
-06091f67e0d3/section0.raw sch5545_ecfw.bin`
+```bash
+cp _O7010A29.exe.extracted/65C10_output/pfsobject/\
+    section-7ec6c2b0-3fe3-42a0-a316-22dd0517c1e8/volume-0x50000/\
+    file-d386beb8-4b54-4e69-94f5-06091f67e0d3/section0.raw sch5545_ecfw.bin
+```
 
-* BIOS ACM file -
+* BIOS ACM file (only necessary for TXT support) -
 
-`cp _O7010A29.exe.extracted/65C10_output/pfsobject/section-7ec6c2b0-3fe3-
-42a0-a316-22dd0517c1e8/volume-0x500000/file-2d27c618-7dcd-41f5-bb10-
-21166be7e143/object-0.raw IVB_BIOSAC_PRODUCTION.bin`
+```bash
+cp _O7010A29.exe.extracted/65C10_output/pfsobject/\
+    section-7ec6c2b0-3fe3-42a0-a316-22dd0517c1e8/volume-0x500000/\
+    file-2d27c618-7dcd-41f5-bb10-21166be7e143/object-0.raw IVB_BIOSAC_PRODUCTION.bin
+```
 
 The SINIT file is fortunately available for download directly from Intel at
-[this url](https://cdrdv2.intel.com/v1/dl/getContent/630744).
+[this url](https://cdrdv2.intel.com/v1/dl/getContent/630744)
+(again, only necessary for TXT support).
 
 ### Patching the binary