GStreamer imsdk camera test suite

Runner/suites/Multimedia/GSTreamer/Camera/Camera_Tests/Camera_Tests.yaml

@@ -0,0 +1,32 @@
+metadata:
+  name: gstreamer-camera-tests
+  format: "Lava-Test Test Definition 1.0"
+  description: >
+    Comprehensive camera validation using GStreamer with qtiqmmfsrc or libcamerasrc.
+    Auto-detects available plugin (qtiqmmfsrc: 10 tests, libcamerasrc: 7 tests).
+    Tests run in sequence: Fakesink -> Preview -> Encode.
+    qtiqmmfsrc supports NV12 (linear) and UBWC (Qualcomm compressed) formats.
+    libcamerasrc supports NV12 only.
+  os:
+    - linux
+  scope:
+    - functional
+
+params:
+  CAMERA_ID: "0"
+  CAMERA_PLUGIN: "auto"
+  CAMERA_TEST_MODES: "fakesink,preview,encode"
+  CAMERA_FORMATS: "nv12,ubwc"
+  CAMERA_RESOLUTIONS: "720p,1080p,4k"
+  CAMERA_FRAMERATE: "30"
+  CAMERA_DURATION: "10"
+  CAMERA_GST_DEBUG: "2"
+  LAVA_TESTCASE_ID: "Camera_Tests"
+
+run:
+  steps:
+    - REPO_PATH="$PWD"
+    - cd "$REPO_PATH/Runner/suites/Multimedia/GSTreamer/Camera/Camera_Tests"
+    - export CAMERA_ID CAMERA_PLUGIN CAMERA_TEST_MODES CAMERA_FORMATS CAMERA_RESOLUTIONS CAMERA_FRAMERATE CAMERA_DURATION CAMERA_GST_DEBUG
+    - ./run.sh --camera-id "${CAMERA_ID}" --plugin "${CAMERA_PLUGIN}" --test-modes "${CAMERA_TEST_MODES}" --formats "${CAMERA_FORMATS}" --resolutions "${CAMERA_RESOLUTIONS}" --framerate "${CAMERA_FRAMERATE}" --duration "${CAMERA_DURATION}" --gst-debug "${CAMERA_GST_DEBUG}" --lava-testcase-id "${LAVA_TESTCASE_ID}" || true
+    - "$REPO_PATH/Runner/utils/send-to-lava.sh" Camera_Tests.res

Runner/suites/Multimedia/GSTreamer/Camera/Camera_Tests/README.md

@@ -0,0 +1,205 @@
+# Camera Tests - GStreamer Camera Validation
+
+## Overview
+
+Validates camera functionality using GStreamer with two camera source plugins:
+- **qtiqmmfsrc** (Qualcomm CAMX downstream) - 10 tests
+- **libcamerasrc** (upstream) - 7 tests
+
+Auto-detects available plugin (prioritizes qtiqmmfsrc). Use `--plugin` to explicitly select.
+
+## Prerequisites
+
+### Required Tools
+- `gst-launch-1.0` - GStreamer command-line tool
+- `gst-inspect-1.0` - GStreamer plugin inspector
+
+### Required Plugins
+
+**qtiqmmfsrc:**
+- `qtiqmmfsrc` - Qualcomm camera source
+- `v4l2h264enc` - H.264 encoder (for encode tests)
+- `waylandsink` - Display sink (for preview tests)
+
+**libcamerasrc:**
+- `libcamerasrc` - Upstream camera source
+- `videoconvert` - Format converter (required)
+- `v4l2h264enc` - H.264 encoder (for encode tests)
+- `waylandsink` - Display sink (for preview tests)
+
+### Hardware
+- Camera hardware
+- Weston display server (for preview tests)
+- Write permissions to output directories
+
+## Test Matrix
+
+### qtiqmmfsrc Tests (10 Total)
+
+| Category | Tests | Formats | Resolutions | Description |
+|----------|-------|---------|-------------|-------------|
+| Fakesink | 2 | NV12, UBWC | 720p | Basic capture validation |
+| Preview | 2 | NV12, UBWC | 4K | Display on Weston |
+| Encode | 6 | NV12, UBWC | 720p, 1080p, 4K | H.264 encoding to MP4 |
+
+**Format Notes:**
+- **NV12**: Standard linear format (universal support)
+- **UBWC**: Qualcomm compressed format (Qualcomm optimized)
+
+### libcamerasrc Tests (7 Total)
+
+| Category | Tests | Resolutions | Description |
+|----------|-------|-------------|-------------|
+| Fakesink | 2 | 720p, 1080p | Basic capture validation |
+| Preview | 2 | 720p, 1080p | Display on Weston |
+| Encode | 3 | 720p, 1080p, 4K | H.264 encoding to MP4 |
+
+**Format Notes:**
+- Only supports NV12 format
+- Requires `videoconvert` element
+
+## Parameters
+
+### Command Line Options
+
+```bash
+./run.sh [OPTIONS]
+
+--camera-id <id>        Camera device ID (qtiqmmfsrc only, default: 0)
+--plugin <name>         Plugin: qtiqmmfsrc, libcamerasrc, auto (default: auto)
+--test-modes <list>     Modes: fakesink,preview,encode (default: all)
+--formats <list>        Formats: nv12,ubwc (qtiqmmfsrc only, default: both)
+--resolutions <list>    Resolutions: 720p,1080p,4k (default: all)
+--framerate <fps>       Framerate (default: 30)
+--duration <seconds>    Test duration (default: 10)
+--gst-debug <level>     Debug level 1-9 (default: 2)
+-h, --help              Display help
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `CAMERA_ID` | Camera device ID (qtiqmmfsrc only) | 0 |
+| `CAMERA_PLUGIN` | Plugin: qtiqmmfsrc, libcamerasrc, auto | auto |
+| `CAMERA_TEST_MODES` | Test modes (comma-separated) | fakesink,preview,encode |
+| `CAMERA_FORMATS` | Formats (qtiqmmfsrc only) | nv12,ubwc |
+| `CAMERA_RESOLUTIONS` | Resolutions | 720p,1080p,4k |
+| `CAMERA_FRAMERATE` | Framerate (fps) | 30 |
+| `CAMERA_DURATION` | Duration (seconds) | 10 |
+| `CAMERA_GST_DEBUG` | Debug level (1-9) | 2 |
+
+### Usage Examples
+
+```bash
+# Run all tests (auto-detect)
+./run.sh
+
+# Test specific plugin
+./run.sh --plugin qtiqmmfsrc
+./run.sh --plugin libcamerasrc
+
+# Run specific test modes
+./run.sh --plugin qtiqmmfsrc --test-modes fakesink
+./run.sh --plugin libcamerasrc --test-modes preview,encode
+
+# Test specific formats/resolutions
+./run.sh --plugin qtiqmmfsrc --formats nv12 --resolutions 720p,1080p
+./run.sh --plugin libcamerasrc --resolutions 4k --duration 20
+
+# Using environment variables
+export CAMERA_PLUGIN="qtiqmmfsrc"
+export CAMERA_FORMATS="ubwc"
+./run.sh
+```
+
+## Output
+
+### Result Files
+- `Camera_Tests.res` - Overall result (PASS/FAIL/SKIP)
+
+### Logs
+```
+logs/Camera_Tests/
+├── <testname>.log       # Individual test logs
+├── gst.log              # GStreamer debug output
+├── dmesg/               # Kernel logs
+└── encoded/             # Encoded MP4 files
+    └── *.mp4
+```
+
+## Troubleshooting
+
+### Test Skipped
+
+**Plugin not available:**
+```bash
+gst-inspect-1.0 qtiqmmfsrc
+gst-inspect-1.0 libcamerasrc
+gst-inspect-1.0 v4l2h264enc
+gst-inspect-1.0 waylandsink
+gst-inspect-1.0 videoconvert  # libcamerasrc only
+```
+
+**Camera not detected:**
+```bash
+ls -l /dev/video*
+dmesg | grep camera
+```
+
+**Weston not running:**
+```bash
+echo $WAYLAND_DISPLAY
+# Start Weston if needed
+```
+
+### Test Failed
+
+**Permission denied:**
+```bash
+# Add user to video group
+sudo usermod -a -G video $USER
+# Logout and login required
+```
+
+**No output file / File too small:**
+- Check camera connection and power
+- Verify camera permissions: `ls -l /dev/video*`
+- Check output directory write permissions
+- Review logs in `logs/Camera_Tests/`
+
+**Format not supported:**
+- qtiqmmfsrc: Check capabilities with `v4l2-ctl --list-formats-ext`
+- libcamerasrc: Only supports NV12
+- UBWC is qtiqmmfsrc-specific (Qualcomm compressed format)
+
+**Preview not displaying:**
+- Verify Weston is running: `echo $WAYLAND_DISPLAY`
+- Check XDG_RUNTIME_DIR is set
+- Ensure display permissions are correct
+
+### Common Issues
+
+1. **Camera not detected**
+   - Verify hardware connection
+   - Check kernel logs: `dmesg | grep camera`
+   - List devices: `ls -l /dev/video*`
+
+2. **GStreamer errors**
+   - Check `logs/Camera_Tests/gst.log`
+   - Check `logs/Camera_Tests/<testname>.log`
+   - Check `logs/Camera_Tests/dmesg/`
+
+3. **Weston required for preview**
+   - Preview tests require Weston compositor
+   - Tests will be skipped if Weston not available
+
+## Notes
+
+- Auto-detection prioritizes qtiqmmfsrc when both available
+- qtiqmmfsrc supports NV12 and UBWC formats
+- libcamerasrc supports NV12 only
+- UBWC is Qualcomm's compressed format (qtiqmmfsrc-specific)
+- libcamerasrc requires `videoconvert` element
+- All tests clean up GStreamer processes on exit
+- LAVA-compatible (always exits 0)