3. 测试环境搭建：内核配置选项、udev 规则与虚拟驱动加载

V4L2-compliance 测试工具的运行依赖于完整且正确的内核 V4L2 子系统支持。本章将详细讲解如何从零搭建一个标准的 V4L2 测试环境，包括内核编译选项的配置、设备节点权限管理（udev 规则）以及虚拟驱动 vivid 的加载与参数配置。一个稳定的测试环境是后续全量检测的基础，也是定位驱动缺陷的前提。

3.1 内核配置选项：V4L2 核心与依赖

V4L2 子系统的功能通过内核 Kconfig 选项控制。在编译内核或加载模块前，必须确保以下关键选项已启用。下表列出了 V4L2-compliance 测试所必需的配置项及其说明。

以下是一个典型的 .config 片段，展示了 V4L2 测试环境的最小配置集合：

CONFIG_MEDIA_SUPPORT=m
CONFIG_MEDIA_CAMERA_SUPPORT=y
CONFIG_VIDEO_DEV=m
CONFIG_VIDEO_V4L2=m
CONFIG_VIDEO_V4L2_I2C=m
CONFIG_VIDEO_VIVID=m

3.2 udev 规则：设备节点权限与符号链接

V4L2 设备节点（如 /dev/video0）默认属于 root 用户，普通用户无法直接访问。V4L2-compliance 测试通常以非 root 用户运行，因此需要配置 udev 规则，为视频设备赋予可读可写权限。此外，通过 udev 创建稳定的符号链接，可以避免设备编号漂移带来的测试脚本适配问题。

在 /etc/udev/rules.d/ 目录下创建规则文件，例如 99-v4l2.rules：

# 为所有 V4L2 视频设备赋予 0666 权限（所有用户可读写）
SUBSYSTEM=="video4linux", KERNEL=="video[0-9]*", MODE="0666"

# 为 vivid 虚拟驱动创建固定符号链接
SUBSYSTEM=="video4linux", KERNEL=="video[0-9]*", ATTR{name}=="vivid*", SYMLINK+="v4l2-vivid-%n"

规则生效后，重新加载 udev 规则并触发：

sudo udevadm control --reload-rules
sudo udevadm trigger

验证设备节点权限与符号链接：

ls -l /dev/video0
# 预期输出：crw-rw-rw- 1 root video 81, 0 ... /dev/video0

ls -l /dev/v4l2-vivid-0
# 预期输出：lrwxrwxrwx 1 root root 7 ... /dev/v4l2-vivid-0 -> video0

3.3 虚拟驱动 vivid：加载与配置

vivid（Virtual Video Test Driver）是内核自带的虚拟 V4L2 驱动，能够模拟多种视频设备类型：视频捕获、视频输出、VBI 捕获/输出、视频覆盖、视频输出覆盖等。它不依赖任何物理硬件，是 V4L2-compliance 全量测试的理想目标。

3.3.1 加载 vivid 模块

使用 modprobe 加载 vivid 模块，并指定模拟的设备数量：

sudo modprobe vivid n_devs=2

参数 n_devs 控制创建的虚拟设备实例数。每个实例包含一组完整的视频、VBI、输出设备节点。加载后，通过 ls /dev/video* 可看到新增的设备节点。

3.3.2 模块参数详解

vivid 支持丰富的模块参数，用于定制测试场景。下表列出了常用参数及其作用：

3.3.3 验证驱动加载状态

加载 vivid 后，通过以下命令确认驱动和设备状态：

# 查看内核模块是否加载
lsmod | grep vivid

# 查看 V4L2 设备节点列表
v4l2-ctl --list-devices

# 查看单个设备的详细能力
v4l2-ctl -d /dev/video0 --all

典型的 v4l2-ctl --list-devices 输出示例：

Vivid (platform:vivid-000):
    /dev/video0
    /dev/video1
    /dev/video2
    /dev/video3
    /dev/vbi0
    /dev/vbi1
    /dev/vout0
    /dev/vout1

3.4 测试环境架构总览

下图展示了 V4L2-compliance 测试环境的整体架构，从内核配置到用户空间测试工具的完整链路：

3.5 常见问题与排查

• vivid 模块加载失败： 检查内核是否启用了 CONFIG_VIDEO_VIVID。使用 modinfo vivid 查看模块信息，确认模块文件存在。
• 设备节点权限不足： 执行 v4l2-compliance -d /dev/video0 时提示 Permission denied。检查 udev 规则是否生效，或使用 sudo 临时测试。
• 设备节点未创建： 使用 dmesg | tail -20 查看内核日志，确认 vivid 驱动是否成功注册平台设备。若日志无输出，检查模块参数 n_devs 是否大于 0。
• 符号链接未生成： 确认 udev 规则文件名以 .rules 结尾，且位于 /etc/udev/rules.d/ 目录。运行 udevadm test /sys/class/video4linux/video0 模拟规则匹配。