Merge pull request #595 from Dasharo/dasharo_stability_nvme

Dasharo stability NVMe detection
Dasharo · Jun 28, 2023 · c4867b1 · c4867b1
2 parents 06b481b + 53c606f
commit c4867b1
Show file tree

Hide file tree

Showing 6 changed files with 223 additions and 4 deletions.
diff --git a/docs/unified-test-documentation/dasharo-stability/C03-nvme-detection.md b/docs/unified-test-documentation/dasharo-stability/C03-nvme-detection.md
@@ -0,0 +1,209 @@
+# Dasharo Stability: NVMe detection
+
+## Test cases common documentation
+
+**Test setup**
+
+1. Proceed with the
+   [Generic test setup: firmware](../../generic-test-setup/#firmware).
+1. Proceed with the
+   [Generic test setup: OS installer](../../generic-test-setup/#os-installer).
+1. Proceed with the
+   [Generic test setup: OS installation](../../generic-test-setup/#os-installation).
+1. Proceed with the
+   [Generic test setup: OS boot from disk](../../generic-test-setup/#os-boot-from-disk).
+
+## SNV0001.001 NVMe detection after cold boot (Ubuntu 22.04)
+
+**Test description**
+
+This test aims to verify that the NVMe disk is correctly detected after
+performing a cold boot. The test should be performed in multiple iterations.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+1. `OPERATING_SYSTEM` = Ubuntu 22.04
+
+**Test setup**
+
+1. Proceed with the
+   [Test cases common documentation](#test-cases-common-documentation) section.
+
+**Test steps**
+
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+1. Disconnect the power source, and remove the battery if present.
+1. Connect power and battery again.
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+**Expected result**
+
+The output of each `lspci` command should contain information about the mounted
+on the DUT NVMe disk. Example output:
+
+```bash
+01:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller 980
+```
+
+## SNV0001.001 NVMe detection after warm boot (Ubuntu 22.04)
+
+**Test description**
+
+This test aims to verify that the NVMe disk is correctly detected after
+performing a warm boot. The test should be performed in multiple iterations.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+1. `OPERATING_SYSTEM` = Ubuntu 22.04
+
+**Test setup**
+
+1. Proceed with the
+   [Test cases common documentation](#test-cases-common-documentation) section.
+
+**Test steps**
+
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+1. Power off the DUT using the power button.
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+**Expected result**
+
+The output of each `lspci` command should contain information about the mounted
+on the DUT NVMe disk. Example output:
+
+```bash
+01:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller 980
+```
+
+## SNV0003.001 NVMe detection after reboot (Ubuntu 22.04)
+
+**Test description**
+
+This test aims to verify that the NVMe disk is correctly detected after
+performing a reboot. The test should be performed in multiple iterations.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+1. `OPERATING_SYSTEM` = Ubuntu 22.04
+
+**Test setup**
+
+1. Proceed with the
+   [Generic test setup: firmware](../../generic-test-setup#firmware)
+
+**Test steps**
+
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+1. Disconnect the power source, and remove the battery if present.
+1. Connect power and battery again.
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+**Expected result**
+
+The output of each `lspci` command should contain information about the mounted
+on the DUT NVMe disk. Example output:
+
+```bash
+01:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller 980
+```
+
+## SNV0004.001 NVMe detection after suspension (Ubuntu 22.04)
+
+**Test description**
+
+This test aims to verify that the NVMe disk is correctly detected after
+performing suspension. The test should be performed in multiple iterations.
+
+**Test configuration data**
+
+1. `FIRMWARE` = Dasharo
+1. `OPERATING_SYSTEM` = Ubuntu 22.04
+
+**Test setup**
+
+1. Proceed with the
+   [Test cases common documentation](#test-cases-common-documentation) section.
+1. Install the [Firmware test suite](https://wiki.ubuntu.com/FirmwareTestSuite)
+   package.
+
+**Test steps**
+
+1. Power on the DUT.
+1. Boot into the system.
+1. Log into the system by using the proper login and password.
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+1. Execute the following command to suspend the system and automatically wake it
+   up after 10 seconds:
+
+    ```bash
+    sudo fwts s3 --s3-sleep-delay=10
+    ```
+
+1. Open a terminal window and run the following command:
+
+    ```bash
+    lspci | grep -i nvme
+    ```
+
+**Expected result**
+
+The output of each `lspci` command should contain information about the mounted
+on the DUT NVMe disk. Example output:
+
+```bash
+01:00.0 Non-Volatile memory controller: Samsung Electronics Co Ltd NVMe SSD Controller 980
+```
diff --git a/docs/variants/novacustom_ns5x_adl/test-matrix.md b/docs/variants/novacustom_ns5x_adl/test-matrix.md
@@ -136,6 +136,8 @@ subjected before the release of the new binary.
 |:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
 | 1.   | [USB Type-A devices detection][SUD]               | SUD           | All                                  |
 | 2.   | [M.2 Wi-fi][SMW]                                  | SMW           | All                                  |
+| 3.   | [NVMe detection][SNV]                             | SNV           | All                                  |
 
-[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
 [SUD]: ../../unified-test-documentation/dasharo-stability/C01-usb-type-a-devices-detection.md
+[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
+[SNV]: ../../unified-test-documentation/dasharo-stability/C03-nvme-detection.md
diff --git a/docs/variants/novacustom_ns5x_tgl/test-matrix.md b/docs/variants/novacustom_ns5x_tgl/test-matrix.md
@@ -139,6 +139,8 @@ subjected before the release of the new binary.
 |:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
 | 1.   | [USB Type-A devices detection][SUD]               | SUD           | All                                  |
 | 2.   | [M.2 Wi-fi][SMW]                                  | SMW           | All                                  |
+| 3.   | [NVMe detection][SNV]                             | SNV           | All                                  |
 
-[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
 [SUD]: ../../unified-test-documentation/dasharo-stability/C01-usb-type-a-devices-detection.md
+[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
+[SNV]: ../../unified-test-documentation/dasharo-stability/C03-nvme-detection.md
diff --git a/docs/variants/novacustom_nv4x_adl/test-matrix.md b/docs/variants/novacustom_nv4x_adl/test-matrix.md
@@ -136,6 +136,8 @@ subjected from before the release of the new binary.
 |:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
 | 1.   | [USB Type-A devices detection][SUD]               | SUD           | All                                  |
 | 2.   | [M.2 Wi-fi][SMW]                                  | SMW           | All                                  |
+| 3.   | [NVMe detection][SNV]                             | SNV           | All                                  |
 
-[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
 [SUD]: ../../unified-test-documentation/dasharo-stability/C01-usb-type-a-devices-detection.md
+[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
+[SNV]: ../../unified-test-documentation/dasharo-stability/C03-nvme-detection.md
diff --git a/docs/variants/novacustom_nv4x_tgl/test-matrix.md b/docs/variants/novacustom_nv4x_tgl/test-matrix.md
@@ -143,9 +143,11 @@ subjected from before the release of the new binary.
 |:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
 | 1.   | [USB Type-A devices detection][SUD]               | SUD           | All                                  |
 | 2.   | [M.2 Wi-fi][SMW]                                  | SMW           | All                                  |
+| 3.   | [NVMe detection][SNV]                             | SNV           | All                                  |
 
-[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
 [SUD]: ../../unified-test-documentation/dasharo-stability/C01-usb-type-a-devices-detection.md
+[SMW]: ../../unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
+[SNV]: ../../unified-test-documentation/dasharo-stability/C03-nvme-detection.md
 
 ## NV41MZ test matrix
 
@@ -223,3 +225,4 @@ subjected from before the release of the new binary.
 |:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
 | 1.   | [USB Type-A devices detection][SUD]               | SUD           | All                                  |
 | 2.   | [M.2 Wi-fi][SMW]                                  | SMW           | All                                  |
+| 3.   | [NVMe detection][SNV]                             | SNV           | All                                  |
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -389,6 +389,7 @@ nav:
           - 'Dasharo stability':
               - 'USB Type-A devices detection': unified-test-documentation/dasharo-stability/C01-usb-type-a-devices-detection.md
               - 'M.2 Wi-fi': unified-test-documentation/dasharo-stability/C02-m2-wi-fi.md
+              - 'NVMe detection': unified-test-documentation/dasharo-stability/C03-nvme-detection.md
       - 'Roadmap': ecosystem/roadmap.md
       - 'Quality Principles': quality-principles/introduction.md
         # - 'Introduction':