4. 命令行参数详解：-d、-s、-n、-r、-v 等参数

v4l2-compliance 提供了丰富的命令行参数，用于控制测试目标、测试范围、交互方式以及输出格式。掌握这些参数是高效进行驱动验证的基础。本章将逐一解析最核心的五个参数：设备节点选择、流测试、非交互模式、报告格式和详细级别。

4.1 核心参数速览表

下表列出了 v4l2-compliance 最常用的命令行参数及其功能描述，方便快速查阅。

参数	长格式	功能描述	典型值示例
-d	--device	指定要测试的 V4L2 设备节点路径	/dev/video0
-s	--streaming	启用流 I/O 测试（capture 或 output）	（无参数）
-n	--no-interactive	非交互模式，跳过需要用户确认的测试项	（无参数）
-r	--report	设置测试报告的输出格式	verbose / json / csv
-v	--verbose	设置日志输出的详细级别	0 / 1 / 2 / 3

4.2 -d 参数：指定设备节点

-d 参数是 v4l2-compliance 最基础的参数，用于指定待测的 V4L2 设备节点。默认情况下，工具会尝试测试 /dev/video0，但在多设备环境中，必须显式指定目标节点。

设备节点类型对照表：

设备节点	设备类型	典型主设备号
/dev/videoX	视频采集/输出设备	81
/dev/vbiX	VBI 数据设备	81
/dev/radioX	收音机设备	81
/dev/swradioX	软件定义无线电设备	81
/dev/mediaX	媒体控制器设备	81

4.3 -s 参数：启用流测试

-s 参数用于启用流 I/O 测试，这是验证驱动数据路径完整性的关键环节。默认情况下，v4l2-compliance 只进行控制查询和格式枚举等静态测试，不会启动数据流。添加 -s 后，工具会执行以下操作：

1. 尝试调用 VIDIOC_REQBUFS 请求缓冲区
2. 调用 VIDIOC_QBUF 和 VIDIOC_DQBUF 进行缓冲区入队/出队循环
3. 验证 VIDIOC_STREAMON 和 VIDIOC_STREAMOFF 的时序行为
4. 检查帧间隔、丢帧率和缓冲区时间戳的合理性

流测试流程 SVG 图：

4.4 -n 参数：非交互模式

-n 参数用于启用非交互模式。在交互模式下，某些测试项（如视频标准切换、输入源选择）会暂停并等待用户确认物理连接是否正确。非交互模式会跳过这些需要人工干预的测试，仅执行自动化可完成的检查。

交互模式 vs 非交互模式对比：

测试项	交互模式行为	非交互模式行为
视频标准检测	等待用户确认当前输入信号标准	跳过，标记为 SKIP
输入源切换	提示用户切换物理输入	仅枚举，不执行切换
音频路由	等待用户确认音频连接	跳过音频路由测试
裁剪/缩放窗口	提示用户确认画面效果	仅检查参数范围

4.5 -r 参数：报告格式

-r 参数控制测试结果的输出格式。v4l2-compliance 支持多种报告格式，以适应不同的使用场景。

支持的报告格式：

格式	命令示例	适用场景
verbose（默认）	-r verbose	终端交互式查看，包含详细测试步骤和失败原因
json	-r json	自动化解析，集成到测试框架或 CI 系统
csv	-r csv	导入电子表格或数据库，进行历史趋势分析

JSON 输出示例：

{
  "test_ioctl": {
    "name": "VIDIOC_QUERYCAP",
    "result": "PASS",
    "duration_ms": 0.12
  },
  "test_format": {
    "name": "VIDIOC_ENUM_FMT",
    "result": "PASS",
    "formats_count": 8
  },
  "test_streaming": {
    "name": "Streaming test",
    "result": "FAIL",
    "reason": "VIDIOC_STREAMON returned -EIO"
  }
}

4.6 -v 参数：详细级别

-v 参数用于控制日志输出的详细程度，从静默模式到最详细的调试信息。合理设置详细级别可以平衡信息量和可读性。

详细级别定义：

级别	参数值	输出内容	典型用途
0	-v 0	仅输出最终测试结果（PASS/FAIL/SKIP）	自动化测试结果汇总
1	-v 1（默认）	每个测试项的名称和结果	日常回归测试
2	-v 2	包含 ioctl 调用参数和返回值	驱动调试，定位失败点
3	-v 3	包含完整的缓冲区数据 dump 和内核日志	深入分析硬件时序问题

4.7 参数组合实战示例

以下是一些常见的参数组合用法，覆盖了从快速验证到深度调试的典型场景。

场景一：快速验证驱动基本功能

v4l2-compliance -d /dev/video0 -n -v 1

非交互模式，默认详细级别，仅测试静态 ioctl 和格式枚举，不启动流。

场景二：全功能流测试（CI 环境）

v4l2-compliance -d /dev/video0 -s -n -r json -v 0

启用流测试，非交互，输出 JSON 格式报告，仅显示最终结果，适合 CI 解析。

场景三：驱动开发调试

v4l2-compliance -d /dev/video0 -s -v 3 2>&1 | tee debug.log

交互模式（不加 -n），最高详细级别，同时将输出保存到文件，便于后续分析。

参数组合决策 SVG 图：

4.8 其他常用参数

除了上述五个核心参数，v4l2-compliance 还提供了以下辅助参数：

参数	功能	示例
--media-device	指定 media controller 设备节点，用于测试拓扑结构	--media-device /dev/media0
--exp-buf-device	指定 export buffer 的辅助设备节点	--exp-buf-device /dev/video1
--list-formats	仅枚举支持的格式，不执行完整测试	--list-formats
--help	显示完整的参数帮助信息	--help