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.