Merge pull request #675 from Dasharo/dmi-editing

dasharo-compatibility/362-coreboot-customizer.md: added

docs/unified-test-documentation/dasharo-compatibility/362-coreboot-customizer.md

@@ -0,0 +1,90 @@
+# Dasharo Compatibility: DMI editing tool
+
+## DMI001.001 Change the UUID
+
+**Test description**
+
+The coreboot_customizer tool is a part of the Dasharo Tools Suite.
+This test case verifies that the UUID encoded in the DMI table of an
+image can be changed using our coreboot_customizer utility.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+
+**Test setup**
+
+1. Proceed with the
+    [Generic test setup: firmware](../generic-test-setup.md#firmware).
+1. Download [coreboot_customizer](https://github.com/Dasharo/meta-dts/blob/main/meta-dts-distro/recipes-dts/dts/dts/coreboot_customizer)
+
+**Test steps**
+
+1. Run `./coreboot_customizer -u 96bcfa1a-42b4-6717-a44c-d8bbc18cbea4
+coreboot.rom`
+1. Flash the `coreboot.rom` file onto the platform.
+1. Power on the DUT.
+1. Examine the DMI tables with `dmidecode`.
+1. Note the results.
+
+**Expected result**
+
+The UUID of the platform should be `96bcfa1a-42b4-6717-a44c-d8bbc18cbea4`, just
+as we had set it.
+
+## DMI002.001 Change the serial number
+
+**Test description**
+
+This test case verifies that the serial number encoded in the DMI table of an
+image can be changed using our coreboot_customizer utility.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+
+**Test setup**
+
+1. Proceed with the
+    [Generic test setup: firmware](../generic-test-setup.md#firmware).
+1. Download [coreboot_customizer](https://github.com/Dasharo/meta-dts/blob/main/meta-dts-distro/recipes-dts/dts/dts/coreboot_customizer)
+
+**Test steps**
+
+1. Run `./coreboot_customizer -s D01234567 coreboot.rom`
+1. Flash the `coreboot.rom` file onto the platform.
+1. Power on the DUT.
+1. Examine the DMI tables with `dmidecode`.
+1. Note the results.
+
+**Expected result**
+
+The serial number of the platform should be `D01234567`, just as we had set it.
+
+## DMI003.001 Change the bootsplash logo
+
+**Test description**
+
+This test case verifies that the bootsplash logo of an image can be changed
+using our coreboot_customizer utility.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+
+**Test setup**
+
+1. Proceed with the
+    [Generic test setup: firmware](../generic-test-setup.md#firmware).
+1. Download [coreboot_customizer](https://github.com/Dasharo/meta-dts/blob/main/meta-dts-distro/recipes-dts/dts/dts/coreboot_customizer)
+
+**Test steps**
+
+1. Run `./coreboot_customizer -l ./logo.svg`
+1. Flash the `coreboot.rom` file onto the platform.
+1. Power on the DUT.
+1. Verify the bootsplash logo.
+
+**Expected result**
+
+The bootsplash logo should now be your image of choice placed under ./logo.svg.

mkdocs.yml

@@ -425,6 +425,7 @@ nav:
               - 'Block boot when battery is low': unified-test-documentation/dasharo-compatibility/359-boot-blocking.md
               - 'Power State after Power Fail': unified-test-documentation/dasharo-compatibility/360-power-after-fail.md
               - 'ESP scanning': unified-test-documentation/dasharo-compatibility/361-esp-scanning.md
+              - 'DMI editing tool': unified-test-documentation/dasharo-compatibility/362-coreboot-customizer.md
           - 'Dasharo security':
               - 'TPM support': unified-test-documentation/dasharo-security/200-tpm-support.md
               - 'Verified Boot': unified-test-documentation/dasharo-security/201-verified-boot.md