Added CoreSight TPDM automated Scripts

This patch adds/updates a suite of automated scripts to validate the functionality
and stability of CoreSight TPDM (Trace, Profiling, and Diagnostics Monitor) hardware:

* TPDM-Interface-Access: Validates sysfs read/write accessibility for various TPDM
  dataset modes (DSB, CMB, TC, BC, GPR) to ensure the driver exposes and handles
  attributes correctly.
* TPDM-Enable-Disable: Stress-tests the hardware and driver state machine by
  repeatedly toggling the TPDM source nodes on and off.
* TPDM-Integration-Test: Verifies that TPDM nodes can be successfully linked to
  CoreSight sinks and that the overarching trace path is correctly established.
* TPDM-Trace-Sink: Validates end-to-end data generation and routing by enabling
  TPDMs, generating trace data, and verifying that the data can be successfully
  extracted from the /dev/ node of the targeted sink.

Signed-off-by: Rohan Dutta <rohadutt@qti.qualcomm.com>

Author: Rohan-in-Qualcomm

Runner/suites/Kernel/DEBUG/TPDM-Enable-Disable/README.md

@@ -0,0 +1,88 @@
+# TPDM-Enable-Disable Test
+
+## Overview
+
+This test acts as a stress test for the Coresight Trace Port Debug Module (TPDM) drivers. It repeatedly enables and disables all available TPDM sources to verify the stability and correctness of the toggling mechanism under repeated stress.
+
+## Test Goals
+
+- Validate the stability of the TPDM drivers under repeated enable/disable cycles.
+- Ensure all TPDM sources can be successfully toggled without causing system hangs or crashes.
+- Verify that sysfs states correctly reflect the enabled/disabled status across multiple rapid transitions.
+- Ensure 100% success rate across 50 iterations for pass criteria.
+
+## Prerequisites
+
+- Kernel must be built with Coresight TPDM support.
+- `sysfs` access to `/sys/bus/coresight/devices/`.
+- Root privileges (to configure source enables).
+
+## Script Location
+
+Runner/suites/Kernel/DEBUG/TPDM-Enable-Disable/run.sh
+
+
+## Files
+
+- `run.sh` - Main test script
+- `TPDM-Enable-Disable.res` - Summary result file with PASS/FAIL
+- `TPDM-Enable-Disable.log` - Full execution log (generated if logging is enabled)
+
+## How It Works
+
+1. **Discovery**: Scans `/sys/bus/coresight/devices/` for all available TPDM devices (e.g., `tpdm*`).
+2. **Setup**: Resets all Coresight devices to ensure a clean state.
+3. **Loop (50 Iterations)**:
+   - **Enable**: Attempts to enable each discovered TPDM device.
+   - **Verify**: Confirms the device successfully transitioned to the enabled state.
+   - **Disable**: Attempts to disable each TPDM device.
+   - **Verify**: Confirms the device successfully transitioned to the disabled state.
+4. **Teardown**: Ensures all devices are left in a disabled, clean state.
+
+## Usage
+
+Run the script directly via the framework:
+
+```bash
+./run.sh
+```
+
+## Example Output
+
+```
+[INFO] 2026-03-23 05:42:18 - -----------------------------------------------------------------------------------------
+[INFO] 2026-03-23 05:42:18 - -------------------Starting TPDM-Enable-Disable Testcase----------------------------
+[INFO] 2026-03-23 05:42:18 - Iteration: 0 - PASS
+[INFO] 2026-03-23 05:42:19 - Iteration: 1 - PASS
+[INFO] 2026-03-23 05:42:19 - Iteration: 2 - PASS
+[INFO] 2026-03-23 05:42:20 - Iteration: 3 - PASS
+[INFO] 2026-03-23 05:42:20 - Iteration: 4 - PASS
+.....
+[INFO] 2026-03-23 05:42:38 - Iteration: 49 - PASS
+[INFO] 2026-03-23 05:42:39 - Iteration: 50 - PASS
+[PASS] 2026-03-23 05:42:39 - -------------enable/disable TPDMs Test PASS-------------
+[INFO] 2026-03-23 05:42:39 - -------------------TPDM-Enable-Disable Testcase Finished----------------------------
+```
+
+## Return Code
+
+- `0` — All 50 iterations successfully enabled and disabled the TPDM sources
+- `1` — One or more iterations failed to toggle a source or verify its state
+
+## Integration in CI
+
+- Can be run standalone or via LAVA
+
+- Result file TPDM-Enable-Disable.res will be parsed by result_parse.sh
+
+## Notes
+
+- The test performs exactly 50 iterations specifically to catch intermittent concurrency bugs or resource leaks in the driver's enable/disable path.
+
+- A failure in any single iteration immediately flags the overall test run as a failure.
+
+## License
+
+SPDX-License-Identifier: BSD-3-Clause-Clear
+
+(c) Qualcomm Technologies, Inc. and/or its subsidiaries.

Runner/suites/Kernel/DEBUG/TPDM-Enable-Disable/TPDM-Enable-Disable.yaml

@@ -0,0 +1,16 @@
+metadata:
+  name: TPDM-Enable-Disable
+  format: "Lava-Test Test Definition 1.0"
+  description: "Script to repeatedly enable and disable all TPDM coresight sources and verify their status."
+  os:
+    - linux
+  scope:
+    - coresight
+    - kernel
+
+run:
+  steps:
+    - REPO_PATH=$PWD || true
+    - cd Runner/suites/Kernel/DEBUG/TPDM-Enable-Disable || true
+    - ./run.sh || true
+    - $REPO_PATH/Runner/utils/send-to-lava.sh TPDM-Enable-Disable.res || true

Runner/suites/Kernel/DEBUG/TPDM-Enable-Disable/run.sh

@@ -0,0 +1,131 @@
+#!/bin/sh
+
+# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+# SPDX-License-Identifier: BSD-3-Clause
+
+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" >&2
+    exit 1
+fi
+
+if [ -z "$__INIT_ENV_LOADED" ]; then
+    # shellcheck disable=SC1090
+    . "$INIT_ENV"
+fi
+
+# shellcheck disable=SC1090,SC1091
+. "$TOOLS/functestlib.sh"
+
+TESTNAME="TPDM-Enable-Disable"
+res_file="./$TESTNAME.res"
+log_info "-----------------------------------------------------------------------------------------"
+log_info "-------------------Starting $TESTNAME Testcase----------------------------"
+CS_BASE="/sys/bus/coresight/devices"
+
+find_path() {
+    for _dir_name in "$@"; do
+        if [ -d "$CS_BASE/$_dir_name" ]; then
+            echo "$CS_BASE/$_dir_name"
+            return 0
+        fi
+    done
+    echo ""
+}
+
+ETF_PATH=$(find_path "tmc_etf0" "tmc_etf" "tmc_etf1" "coresight-tmc_etf" "coresight-tmc_etf0")
+if [ -z "$ETF_PATH" ]; then
+    log_fail "TMC-ETF sink not found. Cannot proceed."
+    echo "$TESTNAME FAIL" > "$res_file"
+    exit 1
+fi
+
+reset_devices() {
+    for node in "$CS_BASE"/*; do
+        [ -d "$node" ] || continue
+        [ -f "$node/enable_source" ] && echo 0 > "$node/enable_source" 2>/dev/null
+        [ -f "$node/enable_sink" ] && echo 0 > "$node/enable_sink" 2>/dev/null
+    done
+}
+
+tpdm_count=0
+for node_path in "$CS_BASE"/tpdm* "$CS_BASE"/coresight-tpdm*; do
+    [ -d "$node_path" ] && tpdm_count=$((tpdm_count + 1))
+done
+
+if [ "$tpdm_count" -eq 0 ]; then
+    log_fail "No TPDM devices found on the system."
+    echo "$TESTNAME FAIL" > "$res_file"
+    exit 1
+fi
+
+fail=0
+i=0
+
+reset_devices
+
+[ -f "$ETF_PATH/enable_sink" ] && echo 1 > "$ETF_PATH/enable_sink" 2>/dev/null
+
+while [ "$i" -le 50 ]; do
+    iter_fail=0
+    
+    for node_path in "$CS_BASE"/tpdm* "$CS_BASE"/coresight-tpdm*; do
+        [ ! -d "$node_path" ] && continue
+        
+        node_name=$(basename "$node_path")
+        
+        if echo "$node_name" | grep -q "tpdm-turing-llm"; then
+            continue
+        fi
+        
+        if [ ! -f "$node_path/enable_source" ]; then
+            continue
+        fi
+        
+        echo 1 > "$node_path/enable_source" 2>/dev/null
+        if [ "$(cat "$node_path/enable_source" 2>/dev/null)" != "1" ]; then
+            iter_fail=1
+            log_fail "Iter $i: Failed to enable $node_name"
+            echo "$TESTNAME FAIL" > "$res_file"
+        fi
+        
+        echo 0 > "$node_path/enable_source" 2>/dev/null
+        if [ "$(cat "$node_path/enable_source" 2>/dev/null)" = "1" ]; then
+            iter_fail=1
+            log_fail "Iter $i: Failed to disable $node_name"
+            echo "$TESTNAME FAIL" > "$res_file"
+        fi
+    done
+    
+    if [ "$iter_fail" -eq 0 ]; then
+        log_info "Iteration: $i - PASS"
+    else
+        log_fail "Iteration: $i - FAIL"
+        fail=1
+    fi
+    
+    i=$((i+1))
+done
+
+[ -f "$ETF_PATH/enable_sink" ] && echo 0 > "$ETF_PATH/enable_sink" 2>/dev/null
+reset_devices
+
+if [ "$fail" -eq 0 ]; then
+    log_pass "-------------enable/disable TPDMs Test PASS-------------"
+    echo "$TESTNAME PASS" > "$res_file"
+else
+    log_fail "-------------enable/disable TPDMs Test FAIL-------------"
+    echo "$TESTNAME FAIL" > "$res_file"
+fi
+
+log_info "-------------------$TESTNAME Testcase Finished----------------------------" 

Runner/suites/Kernel/DEBUG/TPDM-Integration-Test/README.md

@@ -0,0 +1,74 @@
+# TPDM Integration Test
+
+## Overview
+
+This test acts as an integration validation for the Coresight Trace Port Debug Module (TPDM). It verifies actual trace data generation and routing by artificially injecting data into the TPDM's `integration_test` nodes and confirming that the data successfully reaches the trace sink (ETF) by monitoring its internal Read/Write Pointer (`mgmt/rwp`).
+
+## Test Goals
+
+- Verify the end-to-end trace generation and routing capabilities of TPDM devices.
+- Inject artificial trace data using the Coresight `integration_test` sysfs nodes.
+- Validate that the injected trace data successfully reaches the TMC-ETF sink.
+- Confirm success by observing a change in the ETF's `mgmt/rwp` (Read/Write Pointer) register value, which indicates data was written to the FIFO.
+
+## Prerequisites
+
+- Kernel must be built with Coresight TPDM and TMC (ETF) support.
+- `sysfs` access to `/sys/bus/coresight/devices/`.
+- Root privileges (to configure devices and write to `integration_test` nodes).
+
+## Script Location
+
+```
+Runner/suites/Kernel/FunctionalArea/coresight/TPDM-Integration-Test/run.sh
+```
+
+## Files
+
+- `run.sh` - Main test script
+- `TPDM-Integration-Test.res` - Summary result file with PASS/FAIL
+- `TPDM-Integration-Test.log` - Full execution log (generated if logging is enabled)
+
+## How It Works
+
+1. **Setup**: Resets the Coresight topology to a clean state.
+2. **Enable**: Activates the `tmc_etf0` (or available ETF) sink and the target TPDM source.
+3. **Baseline**: Reads and stores the initial value of the ETF's `mgmt/rwp` register.
+4. **Injection**: Writes dummy/test data to the TPDM's `integration_test` sysfs node to force trace generation.
+5. **Verification**: Reads the ETF's `mgmt/rwp` register again. The test passes if the new value is different from the baseline value (proving data flowed into the sink).
+6. **Teardown**: Disables the TPDM and ETF devices.
+
+## Example Output
+
+```
+[INFO] 2026-03-23 05:33:24 - ------------------------------------------------------
+[INFO] 2026-03-23 05:33:24 - -----  Coresight TPDM integration Test Starting  -----
+[INFO] 2026-03-23 05:33:24 - tpdm0 Integration Test Start
+[INFO] 2026-03-23 05:33:24 - tpdm0 Integration Test PASS
+[INFO] 2026-03-23 05:33:24 - tpdm1 Integration Test Start
+[INFO] 2026-03-23 05:33:24 - tpdm1 Integration Test PASS
+....
+[INFO] 2026-03-23 05:33:24 - tpdm9 Integration Test Start
+[INFO] 2026-03-23 05:33:24 - tpdm9 Integration Test PASS
+[PASS] 2026-03-23 05:33:24 - -----PASS: All TPDM devices integration test-----
+[INFO] 2026-03-23 05:33:24 - -------------------TPDM-Integration-Test Testcase Finished----------------------------
+```
+
+## Return Code
+
+- `0` — The `mgmt/rwp` value changed successfully after data injection (PASS)
+- `1` — The `mgmt/rwp` value did not change, indicating trace data was lost or not generated (FAIL)
+
+## Integration in CI
+
+- Can be run standalone or via LAVA
+- Result file `TPDM-Integration-Test.res` will be parsed by `result_parse.sh`
+
+## Notes
+
+- The `mgmt/rwp` (Read/Write Pointer) is a hardware register in the Trace Memory Controller (TMC) that increments as trace data is written into its SRAM/FIFO. Checking this register is a reliable, lightweight way to verify data flow without needing to dump and parse the entire binary trace buffer.
+
+## License
+
+SPDX-License-Identifier: BSD-3-Clause-Clear  
+(c) Qualcomm Technologies, Inc. and/or its subsidiaries.

Runner/suites/Kernel/DEBUG/TPDM-Integration-Test/TPDM-Integration-Test.yaml

@@ -0,0 +1,16 @@
+metadata:
+  name: TPDM-Integration-Test
+  format: "Lava-Test Test Definition 1.0"
+  description: "Coresight TPDM integration test script to verify trace generation by writing to integration_test nodes and verifying the ETF mgmt/rwp changes."
+  os:
+    - linux
+  scope:
+    - coresight
+    - kernel
+
+run:
+  steps:
+    - REPO_PATH=$PWD || true
+    - cd Runner/suites/Kernel/DEBUG/TPDM-Integration-Test || true
+    - ./run.sh || true
+    - $REPO_PATH/Runner/utils/send-to-lava.sh TPDM-Integration-Test.res || true