feat: added qrtr_lookup test

Signed-off-by: Jeevanandan Sandan <sandanka@qti.qualcomm.com>

Author: Jeevanandan Sandan

Runner/suites/Kernel/Baseport/IPC/qrtr_lookup_validation/README.md

@@ -0,0 +1,83 @@
+# qrtr-lookup Validation Test
+
+## Overview
+This script verifies the existence of Qualcomm IPC Router (QRTR) services on a Linux target. It utilizes the `qrtr-lookup` command to scan for active nodes and validates that specific subsystems (ADSP, CDSP, Modem, etc.) are up and registered with the correct Instance IDs.
+
+## Prerequisites
+*   **Target Device:** Qualcomm Linux Device (e.g., QCS6490, QCS9100, etc.)
+*   **Software:** `qrtr-lookup` binary must be installed and in the system `$PATH`.
+*   **Shell:** Standard `/bin/sh` or `/bin/bash`.
+
+## Usage
+
+### 1. Default Mode (ADSP Root)
+### 1. Default Mode (Any Service Scan)
+Running the script without arguments will scan for **any** active service labeled "Test service" in the `qrtr-lookup` output. The test passes if **at least one** service is found.
+```bash
+./run.sh
+
+### 2. Targeted Mode (Recommended)
+Use the `-t` flag to check a specific subsystem by name. This handles ID mapping automatically.
+```bash
+./run.sh -t <target_name>
+```
+**Examples:**
+```bash
+./run.sh -t audio      # Checks ADSP Audio PD (ID 33)
+./run.sh -t adsp root      # Checks ADSP Root PD (ID 32)
+./run.sh -t cdsp       # Checks CDSP Root (ID 64)
+./run.sh -t wpss       # Checks WPSS (ID 128)
+./run.sh -t gpdsp0       # Checks GPDSP0 (ID 112)
+```
+
+### 3. Manual Override
+Use the `-i` flag if you need to check a specific Instance ID that is not yet mapped in the script.
+```bash
+./run.sh -i 99
+```
+
+## Supported Targets
+The following aliases are supported via the `-t` flag:
+
+| Subsystem | Target Names (Case Insensitive) | Instance ID |
+| :--- | :--- | :--- |
+| **ADSP** | `adsp`, `adsp-root` | **32** (Default) |
+| **ADSP Audio** | `audio`, `adsp-audiopd` | **33** |
+| **ADSP Sensor** | `sensor`, `adsp-sensorpd` | **34** |
+| **ADSP Charger** | `charger`, `adsp-chargerpd` | **35** |
+| **CDSP** | `cdsp` | **64** |
+| **CDSP 1** | `cdsp1` | **72** |
+| **GPDSP 0** | `gpdsp0`, `gpdsp0-root` | **112** |
+| **GPDSP 0 User**| `gpdsp0-user` | **113** |
+| **GPDSP 1** | `gpdsp1`, `gpdsp1-root` | **120** |
+| **GPDSP 1 User**| `gpdsp1-user` | **121** |
+| **WPSS** | `wpss` | **128** |
+| **SOC CP** | `soccp` | **141** |
+| **DCP** | `dcp` | **142** |
+| **MODEM** | `mpss`, `modem` | **5** |
+| **MODEM OEM** | `mpss-oempd`, `modem-oempd` | **6** |
+
+## Outputs
+*   **Console:** Prints `PASS` or `FAIL` with details about the found ID.
+*   **Result File:** Generates `qrtr-lookup_validation.res` in the current directory containing:
+    *   `qrtr-lookup_validation PASS`
+    *   `qrtr-lookup_validation FAIL`
+
+## LAVA Integration
+To include this in a LAVA test definition (`.yaml`), simply call the script multiple times for the subsystems you wish to validate:
+
+\`\`\`yaml
+run:
+  steps:
+    - chmod +x run.sh
+    - ./run.sh            # Validates ADSP Root (Default)
+    - ./run.sh -t audio   # Validates Audio
+    - ./run.sh -t cdsp    # Validates CDSP
+    - ./run.sh -t cdsp1    # Validates CDSP1
+    - ./run.sh -t gpdsp0    # Validates GPDSP0
+    - ./run.sh -t gpdsp1    # Validates GPDSP1
+    - ./run.sh -t gpdsp0-user    # Validates GPDSP0 User PD
+    - ./run.sh -t gpdsp1-user    # Validates GPDSP1 User PD
+    - ./run.sh -t mpss    # Validates Modem Root
+    - ./run.sh -t mpss-oempd    # Validates Modem OEM PD
+\`\`\`

Runner/suites/Kernel/Baseport/IPC/qrtr_lookup_validation/qrtr_lookup_validation.yaml

@@ -0,0 +1,16 @@
+metadata:
+  name: qrtr_lookup_validation
+  format: "Lava-Test Test Definition 1.0"
+  description: "Validates existence of QRTR services for various subsystems"
+  os:
+    - linux
+  scope:
+    - functional
+params:
+  REMOTE_PROC: "adsp"
+run:
+  steps:
+    - REPO_PATH=$PWD
+    - cd Runner/suites/Kernel/Baseport/IPC/qrtr_lookup_validation
+    - ./run.sh -t "$REMOTE_PROC"
+    - $REPO_PATH/Runner/utils/send-to-lava.sh qrtr_lookup_validation.res

Runner/suites/Kernel/Baseport/IPC/qrtr_lookup_validation/run.sh

@@ -0,0 +1,114 @@
+#!/bin/sh
+# run.sh - Verification for qrtr-lookup service
+
+# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+# SPDX-License-Identifier: BSD-3-Clause
+
+# 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
+if [ -z "$__INIT_ENV_LOADED" ]; then
+    # shellcheck disable=SC1090
+    . "$INIT_ENV"
+    export __INIT_ENV_LOADED=1
+fi
+
+# Always source functestlib.sh
+# shellcheck disable=SC1090,SC1091
+. "$TOOLS/functestlib.sh"
+
+TESTNAME="qrtr_lookup_validation"
+test_path=$(find_test_case_by_name "$TESTNAME")
+cd "$test_path" || exit 1
+res_file="./$TESTNAME.res"
+
+log_info "--------------------------------------------------"
+log_info "------------- Starting $TESTNAME Test ------------"
+
+check_dependencies qrtr-lookup
+
+# --- Argument Parsing ---
+TARGET_NAME=""
+INSTANCE_ID=""
+
+while getopts "t:i:" opt; do
+  case ${opt} in
+    t) TARGET_NAME=$OPTARG ;;
+    i) INSTANCE_ID=$OPTARG ;;
+    \?) 
+        log_fail "Invalid option: -$OPTARG"
+        echo "$TESTNAME FAIL" > "$res_file"
+        exit 0 
+        ;;
+  esac
+done
+
+# Resolve Target Name to ID if provided
+if [ -n "$TARGET_NAME" ]; then
+    MAPPED_ID=$(get_qrtr_id_from_name "$TARGET_NAME")
+    if [ -n "$MAPPED_ID" ]; then
+        INSTANCE_ID=$MAPPED_ID
+        log_info "Mapped target '$TARGET_NAME' to Instance ID $INSTANCE_ID"
+    else
+        log_fail "Unknown target name '$TARGET_NAME'"
+        echo "$TESTNAME FAIL" > "$res_file"
+        exit 0
+    fi
+fi
+
+# --- Main Logic ---
+
+if [ -n "$INSTANCE_ID" ]; then
+    # --- MODE 1: Specific Verification ---
+    log_info "Verifying specific Instance ID: $INSTANCE_ID"
+    
+    if qrtr_id_exists "$INSTANCE_ID"; then
+        scan_dmesg_errors "qrtr" "$PWD"
+        log_pass "Found service for ID $INSTANCE_ID"
+        echo "$TESTNAME PASS" > "$res_file"
+    else
+        log_fail "Instance ID $INSTANCE_ID not found in qrtr-lookup output."
+        echo "$TESTNAME FAIL" > "$res_file"
+    fi
+
+else
+    # --- MODE 2: Default (Auto-Detect Any) ---
+    log_info "No specific target provided. Scanning for ANY Test services..."
+    
+    # Get all lines containing "Test service", extract ID (Col 3)
+    FOUND_IDS=$(qrtr-lookup | grep "Test service" | awk '{print $3}')
+    
+    if [ -n "$FOUND_IDS" ]; then
+        log_info "Found the following active Test Services:"
+        
+        for id in $FOUND_IDS; do
+            name=$(get_qrtr_name_from_id "$id")
+            log_info "  - ID $id : $name"
+        done
+        
+        # Pass if at least one is found
+        scan_dmesg_errors "qrtr" "$PWD"
+        log_pass "Found active qrtr-lookup test services"
+        echo "$TESTNAME PASS" > "$res_file"
+    else
+        log_fail "No 'Test service' lines found in qrtr-lookup output."
+        echo "$TESTNAME FAIL" > "$res_file"
+    fi
+fi
+
+exit 0

Runner/utils/functestlib.sh

@@ -4558,3 +4558,58 @@ get_pid() {
     log_info "Process '$process_name' not found."
     return 1
 }
+
+# Check if a specific Node ID (column 3) exists
+qrtr_id_exists() {
+    target=$1
+    qrtr-lookup 2>/dev/null | awk -v target="$target" '
+        NR > 1 && $3 ~ /^[0-9]+$/ && $3 == target { found = 1; exit }
+        END { exit(found ? 0 : 1) }
+    '
+}
+
+# Map human-readable names to IDs
+get_qrtr_id_from_name() {
+    key=$(printf '%s' "$1" | tr '[:upper:]' '[:lower:]')
+    case "$key" in
+        "adsp" | "adsp-root")         echo "32" ;;
+        "adsp-audiopd" | "audio")     echo "33" ;;
+        "adsp-sensorpd" | "sensor")   echo "34" ;;
+        "adsp-chargerpd" | "charger") echo "35" ;;
+        "mpss" | "modem")             echo "5" ;;
+        "mpss-oempd" | "modem-oempd") echo "6" ;;
+        "cdsp")                       echo "64" ;;
+        "cdsp1")                      echo "72" ;;
+        "gpdsp0" | "gpdsp0-root")     echo "112" ;;
+        "gpdsp0-user")                echo "113" ;;
+        "gpdsp1" | "gpdsp1-root")     echo "120" ;;
+        "gpdsp1-user")                echo "121" ;;
+        "soccp")                      echo "141" ;;
+        "dcp")                        echo "142" ;;
+        "wpss")                       echo "128" ;;
+        *)                            echo "" ;;
+    esac
+}
+
+# Reverse mapping for display
+get_qrtr_name_from_id() {
+    id="$1"
+    case "$id" in
+        "32")  echo "ADSP Root" ;;
+        "33")  echo "ADSP AudioPD" ;;
+        "34")  echo "ADSP SensorPD" ;;
+        "35")  echo "ADSP ChargerPD" ;;
+        "5")   echo "MPSS Modem" ;;
+        "6")   echo "MPSS OEMPD" ;;
+        "64")  echo "CDSP Root" ;;
+        "72")  echo "CDSP1" ;;
+        "112") echo "GPDSP0 Root" ;;
+        "113") echo "GPDSP0 User" ;;
+        "120") echo "GPDSP1 Root" ;;
+        "121") echo "GPDSP1 User" ;;
+        "141") echo "SOCCP" ;;
+        "142") echo "DCP" ;;
+        "128") echo "WPSS" ;;
+        *)     echo "Unknown Subsystem" ;;
+    esac
+}

Runner/utils/lib_gstreamer.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 # Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
-# SPDX-License-Identifier: BSD-3-Clause#
+# SPDX-License-Identifier: BSD-3-Clause
 # Runner/utils/lib_gstreamer.sh
 #
 # GStreamer helpers.