Skip to content

Dasharo Compatibility: Dasharo Tools Suite

Test cases common documentation

Test setup

  1. Proceed with the Generic test setup: firmware.
  2. Wired network connection.
  3. Disable Secure Boot.
  4. Prepare the bootable USB stick
  5. Make yourself familiar with Dasharo Tools Suite.

DTS001.001 Booting DTS from USB works correctly

Test description

This test aims to verify that DTS is properly booting from USB.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.

Expected result

After a while, the DTS menu should appear.

DTS002.001 DTS option Creating Dasharo HCL report works correctly

Test description

This test aims to verify that the option Dasharo HCL report in the DTS menu properly creates the report.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 1 and press Enter.
  7. Wait for the question: Do you want to support Dasharo development by sending us logs with hardware configuration?
  8. Type in y and press Enter.

Expected result

The whole process may take a few minutes.

  1. The report should be generated.
  2. The report should be sent to the cloud.
  3. In the summary should be displayed information that all calls exited without errors.

Example summary output:

SUMMARY
========

 > All Curl calls exited without errors
 > Attempt to send completed > <report_name>.tar.gz
Thanks you for supporting Dasharo!

DTS003.001 DTS option power-off DUT works correctly

Test description

This test aims to verify that the option Power off system in the DTS menu turns off the DUT.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 10 and press Enter.

Expected result

The DUT should be turned off without any complications.

DTS004.001 DTS option reboot DUT works correctly

Test description

This test aims to verify that the option Reboot system in the DTS menu reboots the DUT.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 11 and press Enter.

Expected result

The DUT should be rebooted without any complications.

DTS005.001 DTS drop-to-shell option works correctly

Test description

This test aims to verify that the option Shell in the DTS menu opens Shell.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 9 and press Enter.

Expected result

  1. Information about entering the shell and how to exit should be displayed.
  2. Shell command input should be activated.

Example output:

Entering shell, to leave type exit and press Enter or press LCtrl+D

bash-5.1#

DTS006.001 Flash device from DTS shell by using flashrom works correctly

Test description

This test aims to verify whether is the possibility to flash the DUT firmware by using flashrom in DTS Shell.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.
  2. {PATH} = individual path to a specific binary.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type 9 and click Enter to launch Shell.
  7. Run the following command to obtain coreboot.rom binary:

    wget https://3mdeb.com/open-source-firmware/{PATH} -O /tmp/coreboot.rom
    

    The above-described command is not the only way to obtain binary. For example, scp command might be used, too.

  8. Run the following command to flash the firmware:

    flashrom -p internal -w /tmp/coreboot.rom
    

    Additional parameters may be needed for the flashrom command depending on the DUT. Documentation describing the exact command to flash the specific platform is always available in localization: Supported hardware -> Platform name -> Initial Deployment.

  9. Power off the DUT.

  10. Repeat steps 2-6.
  11. Run the following command to check the firmware version:

    dmidecode -t 0
    
  12. Note the results.

Expected result

The output of dmidecode command should contain information about the current firmware. The current firmware version should be equal to the binary version, which you were flashing.

Example output:

Version: Dasharo (coreboot+UEFI) v1.1.0

DTS007.001 Update device firmware from DTS Shell by using fwupd works correctly

Test description

This test aims to verify whether there is the possibility to update the DUT firmware by using fwupd in DTS.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 9 and press Enter.
  7. Run the following commands to update the firmware to the latest version:

    fwupdmgr refresh
    fwupdmgr update
    
  8. Power off the DUT.

  9. Repeat steps 2-6.
  10. Run the following command to check the firmware version:

    dmidecode -t 0
    
  11. Note the results.

Expected result

The output of dmidecode command should contain information about the current firmware. The current firmware version should be equal to the binary version, which you were flashing.

Example output:

Version: Dasharo (coreboot+UEFI) v1.1.0

DTS008.001 Flash device EC firmware by using DTS built-in script works correctly

Test description

This test aims to verify whether there is the possibility to flash the DUT EC firmware by using the built-in script in DTS.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Proceed with Dasharo EC Transition.

Expected result

  1. After the flashing procedure itself, the DUT should be able to boot.
  2. The EC firmware version, after checking the method described in the above-mentioned documentation, should correspond to the latest version.

DTS009.001 Update device EC firmware by using DTS works correctly

Test description

This test aims to verify whether there is the possibility to update the DUT EC firmware by using system76_ectool in DTS.

Test configuration data

  1. FIRMWARE = Dasharo

Test setup

  1. Proceed with the Test cases common documentation section.

Test steps

  1. Plug the USB stick with DTS into the USB slot on the DUT.
  2. Power on the DUT.
  3. Hold the BOOT_MENU_KEY to enter the UEFI Boot Menu.
  4. Select the USB stick with DTS using the arrow keys and press Enter.
  5. Wait for Enter an option:.
  6. Type in 9 and press Enter.
  7. Proceed with Dasharo EC Update.

Expected result

  1. After the updating firmware procedure itself, the DUT should be able to boot.
  2. The EC firmware version, after checking the method described in the above-mentioned documentation, 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 section.
  2. Ensure that the previous firmware version (the one before the one you're currently testing) is flashed to the DUT.
  3. If custom boot logo functionality is supported, ensure that a custom logo is installed. Follow the steps outlined here.
  4. 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.
  2. Hold the SETUP_MENU_KEY to enter the Dasharo setup menu.
  3. 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.
  4. Exit to the setup menu front page by pressing the Esc key.
  5. Select Reset to reboot the DUT.
  6. Hold the BOOT_MENU_KEY to enter the boot device selection menu.
  7. Select iPXE Network Boot to enter the iPXE menu.

    The option may have a different name on some platforms.

  8. Select iPXE Shell to drop to shell.

  9. Type in the following commands:

    dhcp
    chain https://boot.dasharo.com/dts/dts-rc.ipxe
    
  10. Press the Enter key to begin downloading DTS.

  11. 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.
  2. When asked for confirmation, confirm to allow the update process to continue.
  3. When the update is completed, reboot the DUT.
  4. 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.
  2. A firmware update is available and installed to the DUT without errors.
  3. The device is able to boot after the update is applied.
  4. If custom boot logo functionality is supported, the logo is displayed after the update.
  5. After the update, in the setup menu, the expected firmware version is displayed.