Dasharo Compatibility: Dasharo Tools Suite
Test cases common documentation
Test setup
- Proceed with the Generic test setup: firmware.
- Wired network connection.
- Disable Secure Boot.
- Prepare the bootable USB stick
- 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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - 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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
1
and pressEnter
. - Wait for the question:
Do you want to support Dasharo development by
sending us logs with hardware configuration
? - Type in
y
and press Enter.
Expected result
The whole process may take a few minutes.
- The report should be generated.
- The report should be sent to the cloud.
- 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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
10
and pressEnter
.
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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
11
and pressEnter
.
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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
9
and pressEnter
.
Expected result
- Information about entering the shell and how to exit should be displayed.
- 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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
{PATH}
= individual path to a specific binary.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type 9 and click
Enter
to launch Shell. -
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. -
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
. -
Power off the DUT.
- Repeat steps 2-6.
-
Run the following command to check the firmware version:
dmidecode -t 0
-
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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
9
and pressEnter
. -
Run the following commands to update the firmware to the latest version:
fwupdmgr refresh fwupdmgr update
-
Power off the DUT.
- Repeat steps 2-6.
-
Run the following command to check the firmware version:
dmidecode -t 0
-
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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Proceed with Dasharo EC Transition.
Expected result
- After the flashing procedure itself, the DUT should be able to boot.
- 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
FIRMWARE
= Dasharo
Test setup
- Proceed with the Test cases common documentation section.
Test steps
- Plug the USB stick with DTS into the USB slot on the DUT.
- Power on the DUT.
- Hold the
BOOT_MENU_KEY
to enter the UEFI Boot Menu. - Select the USB stick with DTS using the arrow keys and press
Enter
. - Wait for
Enter an option:
. - Type in
9
and pressEnter
. - Proceed with Dasharo EC Update.
Expected result
- After the updating firmware procedure itself, the DUT should be able to boot.
- The EC firmware version, after checking the method described in the above-mentioned documentation, should correspond to the binary version used.