audio: add overlay build environment setup for audioreach

Overlay builds using audioreach modules need special configuration
before audio tests can run properly. Without this setup, PipeWire
fails to communicate with the audio hardware.

Changes:
- Added setup_overlay_audio_environment() in audio_common.sh
  * Detects overlay builds via lsmod audioreach check
  * Sets /dev/dma_heap/system permissions (chmod 666)
  * Restarts pipewire service via systemctl
  * Waits up to 60s for service to be ready
  * Validates both process and wpctl communication
- Integrated setup call in AudioPlayback and AudioRecord tests
  * Runs early, before backend detection
  * Fails test if setup fails on overlay builds
  * Zero overhead on base builds
- Updated README files with overlay build documentation

Signed-off-by: Teja Swaroop Moida <[email protected]>

Author: tmoida

Runner/suites/Multimedia/Audio/AudioPlayback/Read_me.md

@@ -28,6 +28,16 @@ Ensure the following components are present in the target Yocto build:
 - Common tools: `pgrep`, `timeout`, `grep`, `wget`, `tar`
 - Daemon: `pipewire` or `pulseaudio` must be running
 
+## Overlay Build Support
+
+For overlay builds using audioreach kernel modules, the test automatically:
+- Detects the overlay build configuration
+- Sets required DMA heap permissions
+- Restarts PipeWire service
+- Waits for the service to be ready
+
+This happens transparently before tests run. No manual configuration needed.
+
 ## Directory Structure
 
 ```bash

Runner/suites/Multimedia/Audio/AudioPlayback/run.sh

@@ -41,6 +41,12 @@ fi
 # shellcheck disable=SC1091
 . "$TOOLS/lib_video.sh"
 
+if ! setup_overlay_audio_environment; then
+    log_fail "Overlay audio environment setup failed"
+    echo "$TESTNAME FAIL" > "$RES_FILE"
+    exit 1
+fi
+
 TESTNAME="AudioPlayback"
 RES_FILE="./${TESTNAME}.res"
 LOGDIR="results/${TESTNAME}"

Runner/suites/Multimedia/Audio/AudioRecord/Read_me.md

@@ -27,7 +27,16 @@ Ensure the following components are present in the target Yocto build:
 - PulseAudio: `parecord`, `pactl`
 - Common tools: `pgrep`, `timeout`, `grep`, `sed`
 - Daemon: `pipewire` or `pulseaudio` must be running
-								
+
+## Overlay Build Support
+
+For overlay builds using audioreach kernel modules, the test automatically:
+- Detects the overlay build configuration
+- Sets required DMA heap permissions
+- Restarts PipeWire service
+- Waits for the service to be ready
+
+This happens transparently before tests run. No manual configuration needed.								
 
 ## Directory Structure
 

Runner/suites/Multimedia/Audio/AudioRecord/run.sh

@@ -30,6 +30,12 @@ fi
 # shellcheck disable=SC1091
 . "$TOOLS/audio_common.sh"
 
+if ! setup_overlay_audio_environment; then
+    log_fail "Overlay audio environment setup failed"
+    echo "$TESTNAME FAIL" > "$RES_FILE"
+    exit 1
+fi
+
 TESTNAME="AudioRecord"
 RES_FILE="./${TESTNAME}.res"
 LOGDIR="results/${TESTNAME}"

Runner/utils/audio_common.sh

@@ -155,6 +155,80 @@ audio_timeout_run() {
   done
   wait "$pid"; return $?
 }
+
+# Function: setup_overlay_audio_environment
+# Purpose: Configure audio environment for overlay builds (audioreach-based)
+# Returns: 0 on success, 1 on failure
+# Usage: Call early in audio test initialization, before backend detection
+
+setup_overlay_audio_environment() {
+    # Detect overlay build
+    if ! lsmod 2>/dev/null | awk '$1 ~ /^audioreach/ { found=1; exit } END { exit !found }'; then
+        log_info "Base build detected (no audioreach modules), skipping overlay setup"
+        return 0
+    fi
+    
+    log_info "Overlay build detected (audioreach modules present), configuring environment..."
+    
+    # Check root permissions
+    if [ "$(id -u)" -ne 0 ]; then
+        log_fail "Overlay audio setup requires root permissions"
+        return 1
+    fi
+    
+    # Configure DMA heap permissions
+    if [ -e /dev/dma_heap/system ]; then
+        log_info "Setting permissions on /dev/dma_heap/system"
+        chmod 666 /dev/dma_heap/system || {
+            log_fail "Failed to chmod /dev/dma_heap/system"
+            return 1
+        }
+    else
+        log_warn "/dev/dma_heap/system not found, skipping chmod"
+    fi
+    
+    # Check systemctl availability
+    if ! command -v systemctl >/dev/null 2>&1; then
+        log_fail "systemctl not available, cannot restart pipewire"
+        return 1
+    fi
+    
+    # Restart PipeWire
+    log_info "Restarting pipewire service..."
+    if ! systemctl restart pipewire 2>/dev/null; then
+        log_fail "Failed to restart pipewire service"
+        return 1
+    fi
+    
+    # Wait for PipeWire with polling (max 60s, check every 2s)
+    log_info "Waiting for pipewire to be ready..."
+    max_wait=60
+    elapsed=0
+    poll_interval=2
+    
+    while [ $elapsed -lt $max_wait ]; do
+        # Check if pipewire process is running
+        if pgrep -x pipewire >/dev/null 2>&1; then
+            # Verify wpctl can communicate
+            if command -v wpctl >/dev/null 2>&1 && wpctl status >/dev/null 2>&1; then
+                log_pass "PipeWire is ready (took ${elapsed}s)"
+                return 0
+            fi
+        fi
+        
+        sleep $poll_interval
+        elapsed=$((elapsed + poll_interval))
+        
+        if [ $((elapsed % 10)) -eq 0 ]; then
+            log_info "Still waiting for pipewire... (${elapsed}s/${max_wait}s)"
+        fi
+    done
+    
+    # Timeout reached
+    log_fail "PipeWire failed to become ready within ${max_wait}s"
+    log_fail "Check 'systemctl status pipewire' and 'journalctl -u pipewire' for details"
+    return 1
+}
 
 # ---------- PipeWire: sinks (playback) ----------
 pw_default_speakers() {