AudioPlayback.yaml

metadata:
  name: audio-playback
  format: "Lava-Test Test Definition 1.0"
  description: "Audio playback validation for various audio formats and configurations"
  os:
    - linux
  scope:
    - functional

params:
  AUDIO_BACKEND: ""  # Selects backend: pipewire or pulseaudio, default: auto-detect
  SINK_CHOICE: "speakers"  # Playback sink: speakers or null, default: speakers
  CLIP_NAMES: "playback_config1"  # Test specific clips (e.g., "playback_config1 playback_config2" or "play_48KHz_8b_2ch"), default: playback_config1
  CLIP_FILTER: ""  # Filter clips by pattern (e.g., "48KHz" or "16b" or "2ch"), default: unset
  FORMATS: "wav"  # Audio formats: e.g. wav, default: wav
  DURATIONS: ""  # Playback durations: short, medium, long (legacy mode only, not used in config discovery mode), default: unset
  LOOPS: 1  # Number of playback loops, default: 1
  TIMEOUT: "10s"  # Playback timeout per loop (e.g., 15s, 0=none), default: 10s
  STRICT: 0  # Enable strict mode (fail on any error), default: 0
  DMESG_SCAN: 1  # Scan dmesg for errors after playback, default: 1
  VERBOSE: 0  # Enable verbose logging, default: 0
  EXTRACT_AUDIO_ASSETS: true  # Download/extract audio assets if missing, default: true
  ENABLE_NETWORK_DOWNLOAD: false  # Enable network download of missing audio files, default: false
  AUDIO_CLIPS_BASE_DIR: "/home/AudioClips"  # Custom path to pre-staged audio clips (for CI), default: /home/AudioClips
  SSID: ""  # Wi-Fi SSID for network connection, default: unset
  PASSWORD: ""  # Wi-Fi password for network connection, default: unset
  NET_PROBE_ROUTE_IP: "1.1.1.1"  # IP used for route probing, default: 1.1.1.1
  NET_PING_HOST: "8.8.8.8"  # Host used for ping reachability check, default: 8.8.8.8
  RES_SUFFIX: ""  # Suffix for unique result file and log directory (e.g., "Config1" generates AudioPlayback_Config1.res and results/AudioPlayback_Config1/), default: unset
  LAVA_TESTCASE_ID: "AudioPlayback"  # Unique testcase ID written into the .res file for LAVA, default: AudioPlayback

run:
  steps:
    - REPO_PATH=$PWD
    - cd Runner/suites/Multimedia/Audio/AudioPlayback/
    - ./run.sh --backend "${AUDIO_BACKEND}" --sink "${SINK_CHOICE}" --clip-name "${CLIP_NAMES}" --clip-filter "${CLIP_FILTER}" --loops "${LOOPS}" --timeout "${TIMEOUT}" --strict "${STRICT}" --audio-clips-path "${AUDIO_CLIPS_BASE_DIR}" --res-suffix "${RES_SUFFIX}" --lava-testcase-id "${LAVA_TESTCASE_ID}" --ssid "${SSID}" --password "${PASSWORD}" || true
    - $REPO_PATH/Runner/utils/send-to-lava.sh AudioPlayback${RES_SUFFIX:+_${RES_SUFFIX}}.res