docs: address validation documentation clarity issues

- Fix directory specification: clarify tests/validation/ must be current dir for pip install
- Add gen_frames.sh usage details: specify directory and supported formats
- Add interactive paths for test_config.yaml and topology_config.yaml
- Add device specification options including system name method
- Add comprehensive pytest parameter execution examples
- Emphasize root user requirement more clearly throughout
- Clean up duplicated device specification sections
- Add clearer file location information for both config files

Author: KarolinaPomian

doc/validation_framework.md

@@ -41,11 +41,13 @@ A shell script for generating test frames for video testing:
 - Creates test patterns in various formats
 - Supports different resolutions and frame rates  
 - Configurable color patterns and test signals
+- Generates files like `ParkJoy_1080p.yuv`, test patterns, and various resolution formats
 
 **Usage**:
 ```bash
-cd tests/validation/common
-./gen_frames.sh
+cd tests/validation/common  # Must be in this directory
+./gen_frames.sh  # Generates test media files for validation
+# Generated files will be available for test configuration
 ```
 
 **Supported Formats**:
@@ -61,10 +63,27 @@ The `configs/` directory contains YAML files that specify:
 - **Test Environment Settings**: Hardware specifications, media paths, and test parameters
 - **Network Topology**: Interface configuration, IP addressing, and routing information
 
-#### [test_config.yaml](../tests/validation/configs/test_config.yaml)
+#### [`test_config.yaml`](../tests/validation/configs/test_config.yaml)
+
+Location: `tests/validation/configs/test_config.yaml`
 
 Defines the test execution environment:
 
+**Key Parameters**:
+  - **build**: Path to MTL build directory 
+  - **mtl_path**: Path to MTL installation directory
+  - **media_path**: Path to test media files directory
+  - **ramdisk.media.mountpoint**: Mount point for media RAM disk
+  - **ramdisk.media.size_gib**: Size of media RAM disk in GiB
+  - **ramdisk.pcap.mountpoint**: Mount point for packet capture RAM disk
+  - **ramdisk.pcap.size_gib**: Size of packet capture RAM disk in GiB
+
+#### [`topology_config.yaml`](../tests/validation/configs/topology_config.yaml)
+
+Location: `tests/validation/configs/topology_config.yaml`
+
+Defines the network topology and host configuration.
+
 ### MTL Engine
 
 The `mtl_engine/` directory contains the core components of the framework:
@@ -187,10 +206,13 @@ hosts:
 ```
 
 **Device Specification Options**:
-- **PCI device ID** (recommended): Find with `lspci | grep Ethernet` → use format like "0000:18:00.0"
-- **System interface name**: Find with `ip link show` → use format like "enp24s0f0"
+You can specify network devices in multiple ways:
+- **PCI device ID** (recommended): `"0000:18:00.0"` (find with `lspci | grep Ethernet`)
+- **Interface name**: `"enp175s0f0np0"` (find with `ip link show`)
+- **System name**: Use your actual system hostname in the `name` field for the host
+- **Environment variables**: `"${TEST_PF_PORT_P}"` (if you set them)
 
-**To find your options**:
+**To find your device options**:
 ```bash
 # Find PCI device IDs
 lspci | grep Ethernet
@@ -249,6 +271,25 @@ sudo ./script/nicctl.sh create_vf "0000:18:00.1"  # Replace with your secondary
 
 ### Basic Test Execution
 
+**⚠️ CRITICAL**: All tests must be run as **root user**. Regular users will fail.
+
+#### Run specific test with parameters:
+
+**Examples of running tests with specific parameters**:
+```bash
+# Run fps test with specific parameters
+pytest --topology_config=configs/topology_config.yaml --test_config=configs/test_config.yaml "tests/single/st20p/fps/test_fps.py::test_fps[|fps = p60|-ParkJoy_1080p]"
+
+# Run specific integrity test with resolution parameters
+pytest --topology_config=configs/topology_config.yaml --test_config=configs/test_config.yaml "tests/dual/st20p/integrity/test_integrity.py::test_integrity[yuv422p10le-1920x1080]"
+
+# Run specific packing test
+pytest --topology_config=configs/topology_config.yaml --test_config=configs/test_config.yaml "tests/dual/st20p/packing/test_packing.py::test_packing[bpm-10]"
+
+# Run audio format test with specific format
+pytest --topology_config=configs/topology_config.yaml --test_config=configs/test_config.yaml "tests/dual/st30p/st30p_format/test_st30p_format.py::test_st30p_format[pcm24]"
+```
+
 Run all tests:
 
 ```bash

doc/validation_quickstart.md

@@ -80,17 +80,18 @@ sudo ./script/nicctl.sh create_vf ${TEST_PF_PORT_R}
 
 ## Generate Test Media (Optional)
 
-For video testing, generate test frames:
+For video testing, generate test frames (must run from specific directory):
 ```bash
-cd tests/validation/common
-./gen_frames.sh
+cd tests/validation/common  # Must be in this directory
+./gen_frames.sh             # Generates test media files
 ```
 
 The script supports:
 - Multiple resolutions (3840x2160, 1920x1080, 1280x720, 640x360)
 - Different pixel formats (yuv422p, yuv422p10le)
-- Configurable color patterns and test signals
-- Various frame rates
+- Configurable color patterns and test signals with timestamps
+- Various frame rates and durations
+- Generates files like `ParkJoy_1080p.yuv` used in test examples
 
 ---