tests: susbsys: Add USB device negotiated speed test

Assess the USB device negotiated speed (nrf54h and nrf54lm20)
Device should attach with High Speed

Signed-off-by: Bartosz Miller <[email protected]>

Author: nordic-bami

CODEOWNERS

@@ -959,6 +959,7 @@
 /tests/zephyr/drivers/uart/               @nrfconnect/ncs-low-level-test
 /tests/zephyr/drivers/watchdog/           @nrfconnect/ncs-low-level-test
 /tests/zephyr/kernel/timer/timer_behavior/ @nrfconnect/ncs-low-level-test
+/tests/subsys/usb/negotiated_speed/       @nrfconnect/ncs-low-level-test
 /tests/zephyr/subsys/settings/performance/ @nrfconnect/ncs-pluto @rghaddab
 
 /tests/benchmarks/multicore/idle/*.rst    @nrfconnect/ncs-si-bluebagel-doc

scripts/ci/tags.yaml

@@ -1505,6 +1505,7 @@ ci_samples_zephyr_subsys_usb:
   files:
     - nrf/samples/zephyr/subsys/usb/
     - zephyr/samples/subsys/usb/
+    - nrf/tests/subsys/usb/
 
 ci_tests_zephyr_drivers_uart:
   files:

tests/subsys/usb/negotiated_speed/CMakeLists.txt

@@ -0,0 +1,15 @@
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(mass)
+
+include(${ZEPHYR_BASE}/samples/subsys/usb/common/common.cmake)
+FILE(GLOB app_sources ${ZEPHYR_BASE}/samples/subsys/usb/mass/src/main.c)
+target_sources(app PRIVATE ${app_sources})
+
+if(CONFIG_BUILD_WITH_TFM)
+  target_include_directories(app PRIVATE
+    $<TARGET_PROPERTY:tfm,TFM_BINARY_DIR>/api_ns/interface/include
+  )
+endif()

tests/subsys/usb/negotiated_speed/Kconfig

@@ -0,0 +1,74 @@
+# Copyright (c) 2025 Nordic Semiconductor ASA
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+menu "MSC sample options"
+
+config APP_WIPE_STORAGE
+	bool "Option to clear the flash area before mounting"
+	help
+	  Use this to force an existing file system to be created.
+
+choice
+	prompt "Storage and file system type used by the application"
+	default APP_MSC_STORAGE_NONE
+	help
+	  Specify the type of storage and file system.
+
+config APP_MSC_STORAGE_NONE
+	bool "Use RAM disk as block device"
+
+config APP_MSC_STORAGE_RAM
+	bool "Use RAM disk and FAT file system"
+	imply FILE_SYSTEM
+	imply FAT_FILESYSTEM_ELM
+
+config APP_MSC_STORAGE_FLASH_FATFS
+	bool "Use FLASH disk and FAT file system"
+	imply DISK_DRIVER_FLASH
+	imply FILE_SYSTEM
+	imply FAT_FILESYSTEM_ELM
+
+config APP_MSC_STORAGE_FLASH_LITTLEFS
+	bool "Use FLASH disk and LittleFS"
+	imply DISK_DRIVER_FLASH
+	imply FILE_SYSTEM
+	imply FILE_SYSTEM_LITTLEFS
+
+config APP_MSC_STORAGE_SDCARD
+	bool "Use SDHC and FAT file system"
+	imply DISK_DRIVER_SDMMC
+	imply FILE_SYSTEM
+	imply FAT_FILESYSTEM_ELM
+
+endchoice
+
+config MASS_STORAGE_DISK_NAME
+	default "NAND" if DISK_DRIVER_FLASH
+	default "RAM" if DISK_DRIVER_RAM
+	default "SD" if DISK_DRIVER_SDMMC
+
+if DISK_DRIVER_FLASH
+
+config FLASH_MAP
+	default y
+
+config FLASH_PAGE_LAYOUT
+	default y
+
+config FLASH_LOG_LEVEL
+	default 3
+
+if NORDIC_QSPI_NOR
+
+config NORDIC_QSPI_NOR_FLASH_LAYOUT_PAGE_SIZE
+	default 4096
+
+endif # NORDIC_QSPI_NOR
+
+endif # DISK_DRIVER_FLASH
+
+endmenu
+
+source "samples/subsys/usb/common/Kconfig.sample_usbd"
+
+source "Kconfig.zephyr"

tests/subsys/usb/negotiated_speed/boards/nrf54h20dk_nrf54h20_cpuapp.overlay

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+/ {
+	ramdisk0 {
+		compatible = "zephyr,ram-disk";
+		disk-name = "RAM";
+		sector-size = <512>;
+		sector-count = <192>;
+	};
+};

tests/subsys/usb/negotiated_speed/prj.conf

@@ -0,0 +1,15 @@
+CONFIG_USB_DEVICE_STACK_NEXT=y
+
+CONFIG_STDOUT_CONSOLE=y
+CONFIG_SERIAL=y
+CONFIG_UART_LINE_CTRL=y
+CONFIG_USBD_MSC_CLASS=y
+CONFIG_USBD_MSC_LUNS_PER_INSTANCE=3
+
+CONFIG_LOG=y
+CONFIG_USBD_LOG_LEVEL_WRN=y
+CONFIG_UDC_DRIVER_LOG_LEVEL_WRN=y
+
+CONFIG_SAMPLE_USBD_PID=0x0008
+CONFIG_SAMPLE_USBD_PRODUCT="USBD MSC sample"
+CONFIG_MAIN_STACK_SIZE=2048

tests/subsys/usb/negotiated_speed/pytest/test_usb_speed.py

@@ -0,0 +1,63 @@
+# Copyright (c) 2025 Nordic Semiconductor ASA
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+import logging
+import os
+import subprocess
+import sys
+from typing import Dict
+
+USB_SAMPLE_ID: str = "NordicSemiconductor USBD MSC sample"
+packet_size_vs_speed: Dict[int, str] = {
+    64: "Full Speed",
+    512: "High Speed",
+    1024: "Super Speed",
+}
+
+logger = logging.getLogger("usb_negotiated_speed")
+logger.setLevel(logging.DEBUG)
+
+
+def excute_command(
+    command: str,
+) -> str:
+    """
+    Execute the command in subprocess.check_output()
+    :return: command standard output
+    """
+    logger.debug(command)
+    return subprocess.check_output(
+        command.split(" "),
+        env=os.environ.copy(),
+    ).decode(sys.getdefaultencoding())
+
+
+def test_usb_negotaited_speed():
+    """
+    Test the USB device negotiated speed
+    The nrf54h20 and nrf54lm20 devices
+    must attach as High Speed USB device
+    """
+    usb_devices: str = excute_command("lsusb")
+    logger.info(usb_devices)
+
+    failure_info: str = f"{USB_SAMPLE_ID} not found in the USB devices"
+
+    assert USB_SAMPLE_ID in usb_devices, failure_info
+
+    vendor_and_dev_id: str = (
+        usb_devices.split(USB_SAMPLE_ID)[0].split("ID ")[-1].strip(" ")
+    )
+    usb_device_info: str = excute_command(f"lsusb -d {vendor_and_dev_id} -v")
+    max_packet_size: int = int(
+        usb_device_info.split("wMaxPacketSize")[-1]
+        .split("bytes")[0]
+        .split("1x ")[-1]
+        .strip(" ")
+    )
+    negotiated_speed: str = packet_size_vs_speed[max_packet_size]
+
+    logger.info(f"Negotiated speed: {negotiated_speed}")
+
+    failure_info = "Negotiated USB device speed is not 'High Speed'"
+    assert negotiated_speed == "High Speed", failure_info

tests/subsys/usb/negotiated_speed/testcase.yaml

@@ -0,0 +1,19 @@
+common:
+  tags:
+    - usb
+    - ci_samples_zephyr_subsys_usb
+  harness: pytest
+
+tests:
+  usb.negotiated_speed:
+    min_ram: 128
+    depends_on: usbd
+    integration_platforms:
+      - nrf54h20dk/nrf54h20/cpuapp
+    platform_allow:
+      - nrf54h20dk/nrf54h20/cpuapp
+      - nrf54lm20apdk/nrf54lm20a/cpuapp
+      - [email protected]/nrf54lm20a/cpuapp
+    extra_configs:
+      - CONFIG_LOG_DEFAULT_LEVEL=3
+      - CONFIG_APP_MSC_STORAGE_RAM=y