3. 编译与安装：从源码编译 v4l2-compliance、依赖库安装、交叉编译注意事项、安装验证

v4l2-compliance 是 V4L2 驱动开发与测试的核心工具，通常需要从源码编译以获取最新特性或适配特定内核版本。本章详细讲解从源码获取、依赖安装、编译配置到安装验证的完整流程，并重点分析交叉编译场景下的关键注意事项。

3.1 源码获取与目录结构

v4l2-compliance 源码托管于 Linux 媒体子系统仓库，推荐使用 git 克隆最新稳定分支：

git clone https://git.linuxtv.org/v4l-utils.git
cd v4l-utils
git checkout stable/v4l-utils-1.26  # 切换到最新稳定标签

源码目录核心结构如下：

3.2 依赖库安装

编译 v4l2-compliance 需要以下系统依赖库：

3.3 编译流程（原生环境）

v4l-utils 支持 autotools 和 meson 两种构建方式。推荐使用 meson 以获得更快的增量编译和更清晰的依赖管理：

# 方式一：meson 构建（推荐）
meson setup builddir
ninja -C builddir
sudo ninja -C builddir install

# 方式二：autotools 构建（传统）
./autogen.sh
./configure --prefix=/usr
make -j$(nproc)
sudo make install

编译完成后，验证二进制文件是否正确生成：

which v4l2-compliance
v4l2-compliance --version

预期输出应显示版本号及编译时间戳。

3.4 交叉编译注意事项

嵌入式平台（如 ARM64、RISC-V）需要交叉编译。以下是关键配置步骤与常见陷阱：

3.4.1 工具链与 sysroot 准备

# 假设使用 aarch64-linux-gnu 工具链
export CROSS_COMPILE=aarch64-linux-gnu-
export CC=${CROSS_COMPILE}gcc
export CXX=${CROSS_COMPILE}g++
export AR=${CROSS_COMPILE}ar
export SYSROOT=/path/to/aarch64-sysroot

# meson 交叉编译文件 cross-file.conf
[binaries]
c = 'aarch64-linux-gnu-gcc'
cpp = 'aarch64-linux-gnu-g++'
ar = 'aarch64-linux-gnu-ar'
strip = 'aarch64-linux-gnu-strip'
pkgconfig = 'aarch64-linux-gnu-pkg-config'

[host_machine]
system = 'linux'
cpu_family = 'aarch64'
cpu = 'aarch64'
endian = 'little'

[properties]
sys_root = '/path/to/aarch64-sysroot'

3.4.2 依赖库交叉编译

libudev 和 libjpeg 必须在 sysroot 中预先安装交叉编译版本：

# 交叉编译 libudev（示例）
cd libudev-252
./configure --host=aarch64-linux-gnu --prefix=${SYSROOT}/usr
make -j$(nproc)
make install

# 或使用 crosstool-NG / buildroot 生成的完整 sysroot

3.4.3 常见交叉编译错误与解决

3.5 安装验证

安装完成后，执行以下验证步骤确保工具可用：

1. 版本检查： v4l2-compliance --version 输出版本号与编译时间。
2. 帮助信息： v4l2-compliance --help 显示所有命令行选项。
3. 设备枚举： v4l2-compliance -l 列出系统中所有 V4L2 设备节点。
4. 快速测试： v4l2-compliance -d /dev/video0 -s 对首个视频设备执行标准测试。

3.6 编译与安装流程总览

3.7 常见问题与排查