From 6ec47261310b0921741c6e8fff0dc6b8122800d3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CAanchal?= Date: Fri, 23 Jan 2026 04:02:59 +0530 Subject: [PATCH 1/4] Add test script to validate USB HID MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The shell script verifies the enumeration of USB Human Interface Devices. Signed-off-by: “Aanchal --- Runner/suites/Kernel/Baseport/usb_hid/run.sh | 70 ++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100755 Runner/suites/Kernel/Baseport/usb_hid/run.sh diff --git a/Runner/suites/Kernel/Baseport/usb_hid/run.sh b/Runner/suites/Kernel/Baseport/usb_hid/run.sh new file mode 100755 index 00000000..ce8c435a --- /dev/null +++ b/Runner/suites/Kernel/Baseport/usb_hid/run.sh @@ -0,0 +1,70 @@ +#!/bin/sh + +# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries. +# SPDX-License-Identifier: BSD-3-Clause-Clear + +# Validate USB HID device detection +# Requires at least one USB HID peripheral (keyboard/mouse, etc.) connected to a USB Host port. + +# Robustly find and source init_env +SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" +INIT_ENV="" +SEARCH="$SCRIPT_DIR" +while [ "$SEARCH" != "/" ]; do + if [ -f "$SEARCH/init_env" ]; then + INIT_ENV="$SEARCH/init_env" + break + fi + SEARCH=$(dirname "$SEARCH") +done + +if [ -z "$INIT_ENV" ]; then + echo "[ERROR] Could not find init_env (starting at $SCRIPT_DIR)" >&2 + exit 1 +fi + +# Only source if not already loaded (idempotent) +if [ -z "$__INIT_ENV_LOADED" ]; then + # shellcheck disable=SC1090 + . "$INIT_ENV" +fi +# Always source functestlib.sh, using $TOOLS exported by init_env +# shellcheck disable=SC1090,SC1091 +. "$TOOLS/functestlib.sh" + +TESTNAME="usb_hid" +test_path=$(find_test_case_by_name "$TESTNAME") +cd "$test_path" || exit 1 +# shellcheck disable=SC2034 +res_file="./$TESTNAME.res" + +log_info "-----------------------------------------------------------------------------------------" +log_info "-------------------Starting $TESTNAME Testcase----------------------------" +log_info "=== Test Initialization ===" + +# Check if lsusb is installed, else skip test +check_dependencies lsusb grep || { + log_skip "$TESTNAME SKIP - lsusb is missing" + echo "$TESTNAME SKIP" >"$RES_FILE" + exit 0 +} + +log_info "=== USB HID device Detection ===" +hid_iface_count="$(lsusb -v 2>/dev/null | grep -i 'Human Interface Device' | wc -l)" + +echo "lsusb -v HID descriptors:" +lsusb -v 2>/dev/null | grep -i 'Human Interface Device' || true + +echo "Number of HID interfaces found: $hid_iface_count" + +if [ "$hid_iface_count" -gt 0 ]; then + log_pass "$TESTNAME : Test Passed - USB HID interface(s) detected" + echo "$TESTNAME PASS" > "$res_file" + exit 0 +else + log_fail "$TESTNAME : Test Failed - No 'Human Interface Device' interface found" + echo "$TESTNAME FAIL" > "$res_file" + exit 1 +fi + +log_info "-------------------Completed $TESTNAME Testcase----------------------------" \ No newline at end of file From 4330599f097f57ff6d5a13320e866536061a18b2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CAanchal?= Date: Fri, 23 Jan 2026 04:06:53 +0530 Subject: [PATCH 2/4] Add documentation for Runner/../usb_hid/run.sh MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Added setup information and basic requirements. This informs the tester of the hardware setup requirement before starting test. Signed-off-by: “Aanchal --- .../suites/Kernel/Baseport/usb_hid/README.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 Runner/suites/Kernel/Baseport/usb_hid/README.md diff --git a/Runner/suites/Kernel/Baseport/usb_hid/README.md b/Runner/suites/Kernel/Baseport/usb_hid/README.md new file mode 100644 index 00000000..30614367 --- /dev/null +++ b/Runner/suites/Kernel/Baseport/usb_hid/README.md @@ -0,0 +1,37 @@ +``` +Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries. +SPDX-License-Identifier: BSD-3-Clause-Clear +``` + +# USB HID Validation + +## Overview + +This shell script executes on the DUT (Device-Under-Test) and verifies enumeration of connected USB Human Interface Devices (HID). + +--- + +## Setup + +- Connect USB HID peripheral(s) to USB port(s) on DUT. +- Only applicable for USB ports that support Host Mode functionality. +- USB HID peripherals examples: Mouse, Keyboard, USB headset, etc. + +--- + +## Usage +### Instructions: +1. **Copy the test suite to the target device** using `scp` or any preferred method. +2. **Navigate to the test directory** on the target device. +3. **Run the test script** using the test runner or directly. + +--- + +### Quick Example +```bash +git clone +cd +scp -r common Runner user@target_device_ip: +ssh user@target_device_ip +cd /Runner && ./run-test.sh usb_hid +``` \ No newline at end of file From b48d6369f8a8ec64b1cda765e3e9795c020e9993 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CAanchal?= Date: Fri, 23 Jan 2026 04:11:07 +0530 Subject: [PATCH 3/4] Add test definition for usb_hid MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Individual test definition is meant to be used for debugging the test script running in LAVA. Signed-off-by: “Aanchal --- .../suites/Kernel/Baseport/usb_hid/usb_hid.yaml | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 Runner/suites/Kernel/Baseport/usb_hid/usb_hid.yaml diff --git a/Runner/suites/Kernel/Baseport/usb_hid/usb_hid.yaml b/Runner/suites/Kernel/Baseport/usb_hid/usb_hid.yaml new file mode 100644 index 00000000..7521de49 --- /dev/null +++ b/Runner/suites/Kernel/Baseport/usb_hid/usb_hid.yaml @@ -0,0 +1,16 @@ +metadata: + name: usb-hid + format: "Lava-Test Test Definition 1.0" + description: "This shell script executes on the DUT (Device-Under-Test) and verifies enumeration of connected USB Human Interface Devices (HID)." + os: + - linux + scope: + - functional + +run: + steps: + - REPO_PATH=$PWD + - cd Runner/suites/Kernel/Baseport/usb_hid + - ./run.sh || true + - $REPO_PATH/Runner/utils/send-to-lava.sh usb_hid.res || true + From 9ae698ce4d4c20407937c03570503ee54b4fb464 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CAanchal?= Date: Fri, 23 Jan 2026 04:02:59 +0530 Subject: [PATCH 4/4] Add test script to validate USB HID The shell script verifies the enumeration of USB Human Interface Devices. Signed-off-by: Aanchal Chaurasia --- Runner/suites/Kernel/Baseport/usb_hid/run.sh | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/Runner/suites/Kernel/Baseport/usb_hid/run.sh b/Runner/suites/Kernel/Baseport/usb_hid/run.sh index ce8c435a..1dbd41e6 100755 --- a/Runner/suites/Kernel/Baseport/usb_hid/run.sh +++ b/Runner/suites/Kernel/Baseport/usb_hid/run.sh @@ -27,6 +27,7 @@ fi if [ -z "$__INIT_ENV_LOADED" ]; then # shellcheck disable=SC1090 . "$INIT_ENV" + __INIT_ENV_LOADED=1 fi # Always source functestlib.sh, using $TOOLS exported by init_env # shellcheck disable=SC1090,SC1091 @@ -42,20 +43,16 @@ log_info "---------------------------------------------------------------------- log_info "-------------------Starting $TESTNAME Testcase----------------------------" log_info "=== Test Initialization ===" -# Check if lsusb is installed, else skip test -check_dependencies lsusb grep || { - log_skip "$TESTNAME SKIP - lsusb is missing" - echo "$TESTNAME SKIP" >"$RES_FILE" - exit 0 -} +# Check if grep is installed, else skip test +deps_list="grep" +check_dependencies "$deps_list" +# Count interfaces with bInterfaceClass = 03 (HID) under /sys/bus/usb/devices +hid_iface_count=0 log_info "=== USB HID device Detection ===" -hid_iface_count="$(lsusb -v 2>/dev/null | grep -i 'Human Interface Device' | wc -l)" +hid_iface_count="$(cat /sys/bus/usb/devices/*/bInterfaceClass 2>/dev/null | grep -i '03' | wc -l)" -echo "lsusb -v HID descriptors:" -lsusb -v 2>/dev/null | grep -i 'Human Interface Device' || true - -echo "Number of HID interfaces found: $hid_iface_count" +printf "Number of HID interfaces found: $hid_iface_count" if [ "$hid_iface_count" -gt 0 ]; then log_pass "$TESTNAME : Test Passed - USB HID interface(s) detected"