📚 课程目录第3章 Linux V4L2 框架入门

Linux V4L2 框架入门：V4L2 是什么、设备节点与核心数据结构

好，我们正式开始啃 V4L2。很多刚接触 Camera 驱动的同学，一看到 V4L2 就头大——代码量不小，概念又多。其实说白了，V4L2 就是 Linux 内核为视频设备准备的一套标准接口。你想想看，如果没有它，每个摄像头芯片都得自己搞一套 ioctl，那驱动工程师不得疯掉？

V4L2 到底是什么？

V4L2，全称 Video for Linux 2，是 Linux 内核中视频设备的统一框架。它定义了用户空间和内核空间之间交换视频数据的标准方式。

我个人的理解是：V4L2 就是一座桥。桥的一头是硬件——Camera Sensor、ISP、MIPI 接口；桥的另一头是应用程序——GStreamer、FFmpeg、OpenCV。V4L2 负责把硬件的原始数据流，包装成应用层能理解的格式。

核心要点：V4L2 不是某个具体的驱动，而是一套规范。你的 Camera 驱动只要遵循这个规范，就能被所有支持 V4L2 的应用直接使用。

我在项目中遇到过一件事：有个同事自己写了一套 Camera 驱动，功能都正常，但上层应用就是调不通。折腾了两天，最后发现——他没有注册 V4L2 设备节点。应用层根本找不到这个设备。从那以后，我每次写驱动第一件事就是确认 V4L2 框架有没有挂好。

V4L2 的设备节点与架构

V4L2 设备在用户空间表现为 /dev/videoX 这样的设备节点。X 从 0 开始，比如 /dev/video0、/dev/video1。你可以在板子上跑一下 ls /dev/video*，看看有几个节点。

但要注意，不是所有 /dev/videoX 都是 Camera。V4L2 支持的设备类型包括：

设备类型	设备节点	典型用途
视频采集	/dev/videoX	Camera 传感器数据采集
视频输出	/dev/videoX	显示输出、视频叠加
视频中继	/dev/videoX	视频数据转发、M2M 设备
VBI	/dev/vbiX	垂直消隐期数据
Radio	/dev/radioX	收音机设备

V4L2 的架构分三层，我画了一张图帮你理解：

从上图可以看到，应用层通过 /dev/videoX 节点发起系统调用，V4L2 核心框架负责路由到具体的设备驱动，最终操作硬件。每一层各司其职，耦合度很低。

V4L2 的核心数据结构

写 V4L2 驱动，有两个结构体你必须吃透：struct video_device 和 struct v4l2_device。我刚开始学的时候，这两个东西老是搞混，后来在项目里踩了几次坑才彻底明白。

struct video_device

这个结构体代表一个 V4L2 设备节点。说白了，你在用户空间看到的 /dev/video0，背后就是一个 struct video_device 实例。

它的核心成员包括：

成员	类型	作用
fops	const struct v4l2_file_operations *	文件操作函数集（open/release/ioctl 等）
v4l2_dev	struct v4l2_device *	指向所属的 v4l2_device
ctrl_handler	struct v4l2_ctrl_handler *	控制句柄（亮度、对比度等）
queue	struct vb2_queue *	视频缓冲队列
minor	int	次设备号
device_caps	u32	设备能力标志

注册一个 video_device 的典型流程：

// 1. 分配 video_device 结构体
struct video_device *vdev = video_device_alloc();

// 2. 设置文件操作函数
vdev->fops = &my_camera_fops;
vdev->v4l2_dev = &my_v4l2_dev;
vdev->queue = &my_queue;
vdev->device_caps = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;

// 3. 设置设备名称
strscpy(vdev->name, "My Camera Sensor", sizeof(vdev->name));

// 4. 注册到 V4L2 框架
video_register_device(vdev, VFL_TYPE_VIDEO, -1);

个人经验：注册 video_device 时，最后一个参数传 -1 表示让内核自动分配节点号。我建议你这么做，省得跟其他设备冲突。有一次我手动指定了节点号，结果跟板子上的 HDMI 采集设备撞了，排查了半天。

struct v4l2_device

这个结构体是 V4L2 驱动的顶层容器。一个 v4l2_device 可以包含多个 video_device、多个 subdev（子设备）。

它的核心成员：

成员	类型	作用
dev	struct device *	指向 Linux 设备模型中的 device
name	char[32]	设备名称
subdevs	struct list_head	子设备链表头
ctrl_handler	struct v4l2_ctrl_handler *	全局控制句柄

初始化 v4l2_device 的代码：

struct v4l2_device my_v4l2_dev;

// 初始化 v4l2_device
v4l2_device_register(&platform_dev->dev, &my_v4l2_dev);

// 注册子设备（比如 Sensor 和 ISP）
v4l2_device_register_subdev(&my_v4l2_dev, &sensor_sd);
v4l2_device_register_subdev(&my_v4l2_dev, &isp_sd);

曾经踩过的坑：v4l2_device 必须在 video_device 之前注册。我刚开始写驱动时顺序搞反了，结果 video_device 注册时找不到父设备，内核直接 panic。记住：先有家（v4l2_device），再有孩子（video_device）。

两个结构体的关系

用一个简单的比喻来理解：

v4l2_device 就像一栋楼，代表整个 Camera 硬件模块
video_device 就像楼里的一个房间，代表一个具体的视频数据通道
一栋楼可以有多个房间（比如主摄和副摄各占一个 video_device）
每个房间都通过 /dev/videoX 这个门进出

在实际的 Camera 驱动中，一个典型的拓扑结构是这样的：

小结一下

这一章我们讲了三个核心概念：

V4L2 是什么——Linux 视频设备的标准框架，统一了用户空间和内核空间的接口
设备节点与架构——/dev/videoX 是用户空间的入口，V4L2 框架分三层：应用层、核心层、驱动层
核心数据结构——struct v4l2_device 是顶层容器，struct video_device 是设备节点，两者是父子关系