Merge pull request #744 from Dasharo/dts_test

326-dasharo-tools-suite.md: add DTS release candidate test

docs/unified-test-documentation/dasharo-compatibility/315-network-boot.md

@@ -110,7 +110,7 @@ and return to the `Setup Menu`.
 **Test description**
 
 This test aims to verify that the `Dasharo Tools Suite` option in
-`Dasharo Network Boot Menu` allows booting into DTS.
+`Dasharo Network Boot Menu` allows booting into DTS over HTTPS.
 
 **Test configuration data**
 
@@ -131,11 +131,14 @@ This test aims to verify that the `Dasharo Tools Suite` option in
    ++enter++.
 1. Select the `Dasharo Tools Suite` option using the arrow keys, then press
     ++enter++.
+1. Take note of the output from iPXE while DTS is loading.
 
 **Expected result**
 
-After configuring the network interfaces, connecting to the server and booting,
-`Dasharo Tools Suite` menu should appear.
+1. After configuring the network interfaces, connecting to the server and
+   booting, `Dasharo Tools Suite` menu should appear.
+1. While downloading DTS, the URL pointing to `dts.ipxe` printed to the console
+   should begin with HTTPS.
 
 ## PXE005.001 OS installation option is available and works correctly
 
@@ -240,3 +243,38 @@ server.
 1. The iPXE application boots successfully.
 1. iPXE obtains an IP address.
 1. iPXE boots an `Debian 11` from netboot.xyz.
+
+## PXE008.001 Firmware Update Mode
+
+**Test description**
+
+This test aims to verify that the DUT is capable of network booting Dasharo
+Tools Suite over the network using Firmware Update Mode.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+
+**Test setup**
+
+1. Proceed with the
+    [Generic test setup: firmware](../generic-test-setup.md#firmware).
+
+**Test steps**
+
+1. Power on the DUT.
+1. Ensure network cable is connected to the DUT.
+1. Hold the `SETUP_MENU_KEY` to enter the UEFI Boot Menu.
+1. Select the `Dasharo System Features` option using the arrow keys and press
+   ++enter++.
+1. Select the `Dasharo Security Options` option using the arrow keys and press
+   ++enter++.
+1. Select the `Firmware Update Mode` option using the arrow keys and press
+   ++enter++.
+1. Press ++enter++ when prompted. The DUT will reboot at this point.
+1. Press the requested number on the keyboard when prompted.
+
+**Expected result**
+
+1. DTS is booted automatically when Firmware Update Mode is entered.
+1. DTS automatically begins to check for a firmware update.

docs/unified-test-documentation/dasharo-compatibility/326-dasharo-tools-suite.md

@@ -367,3 +367,70 @@ firmware by using system76_ectool in DTS.
 1. The EC firmware version, after checking the method described in the
     above-mentioned [documentation](https://docs.dasharo.com/dasharo-tools-suite/documentation#ec-update),
     should correspond to the binary version used.
+
+## DTS010.001 Test firmware update in pre-release DTS over iPXE
+
+**Test description**
+
+This test verifies that DTS is able to correctly update device firmware from
+the previous to the currently tested version.
+
+1. `FIRMWARE` = Dasharo
+
+**Test setup**
+
+1. Proceed with the
+    [Test cases common documentation](#test-cases-common-documentation) section.
+1. Ensure that the **previous** firmware version (the one before the one you're
+   currently testing) is flashed to the DUT.
+1. If custom boot logo functionality is supported, ensure that a custom logo
+   is installed. Follow the steps outlined
+   [here](https://docs.dasharo.com/guides/logo-customization/).
+1. Ensure that the DUT is connected to a wired network.
+
+    > Use an Ethernet cable plugged into the DUT's onboard NIC. USB networking
+    > adapters may not work correctly, and wireless (Wi-Fi) connection is not
+    > supported.
+
+**Test steps**
+
+1. Power on the DUT.
+1. Hold the `SETUP_MENU_KEY` to enter the Dasharo setup menu.
+1. In the setup menu, navigate to `Dasharo System Features` -> `Networking
+   Options` and ensure that the option `Enable Network Boot` is enabled.
+    1. If you changed the setting, press `F10` to save changes.
+1. Exit to the setup menu front page by pressing the `Esc` key.
+1. Select `Reset` to reboot the DUT.
+1. Hold the `BOOT_MENU_KEY` to enter the boot device selection menu.
+1. Select `iPXE Network Boot` to enter the iPXE menu.
+
+    > The option may have a different name on some platforms.
+
+1. Select `iPXE Shell` to drop to shell.
+1. Type in the following commands:
+
+    ```ipxe
+    dhcp
+    chain https://boot.dasharo.com/dts/dts-rc.ipxe
+    ```
+
+1. Press the `Enter` key to begin downloading DTS.
+1. If required, enter the appropriate credentials in the DTS menu.
+
+> Credential for DES releases are not publicly available. If you need DES
+> credentials for testing DTS, consult your TL.
+
+1. Select the `Update Dasharo Firmware` option to check for update.
+1. When asked for confirmation, confirm to allow the update process to continue.
+1. When the update is completed, reboot the DUT.
+1. Hold down the `SETUP_MENU_KEY` to enter the setup menu again.
+
+**Expected result**
+
+1. A DTS release candidate is correctly booted over the network.
+1. A firmware update is available and installed to the DUT without errors.
+1. The device is able to boot after the update is applied.
+1. If custom boot logo functionality is supported, the logo is displayed after
+   the update.
+1. After the update, in the setup menu, the expected firmware version is
+   displayed.