2. Linux V4L2 框架：V4L2 架构、设备节点、ioctl 接口、缓冲区管理机制

V4L2（Video for Linux 2）是 Linux 内核中为视频设备提供的标准驱动框架。对于 CSI 接口摄像头驱动而言，V4L2 是连接硬件中断与用户态应用程序的核心桥梁。本章将深入剖析 V4L2 的层次架构、设备节点模型、ioctl 控制接口以及关键的缓冲区管理机制，为后续实现中断响应与数据流协同设计奠定基础。

2.1 V4L2 架构层次

V4L2 采用分层架构设计，从上到下依次为：用户态应用层、V4L2 核心层、V4L2 设备驱动层以及硬件层。每一层都有明确的职责划分，通过标准接口进行交互。

各层之间的交互遵循以下原则：

• 用户态应用通过 open()、close()、ioctl()、mmap()、poll() 等标准系统调用与 V4L2 设备节点通信。
• V4L2 核心层负责解析 ioctl 命令，调用驱动注册的回调函数，管理视频流状态机。
• 设备驱动层实现具体的硬件操作，包括寄存器读写、中断处理、DMA 传输等。
• 硬件层完成图像数据的采集与传输。

2.2 设备节点与文件操作

V4L2 设备在 Linux 文件系统中以字符设备节点的形式呈现，通常位于 /dev/videoX（X 为 0、1、2...）。设备节点的创建由内核的 videodev 模块自动完成，驱动只需注册 video_device 结构体。

驱动中注册设备节点的核心代码片段如下：

static struct video_device csi_vdev = {
    .name           = "CSI Camera",
    .fops           = &csi_fops,       // 文件操作函数集
    .ioctl_ops      = &csi_ioctl_ops,  // ioctl 操作函数集
    .release        = video_device_release,
    .vfl_dir        = VFL_DIR_RX,      // 接收方向
};

// 在 probe 函数中注册
video_register_device(&csi_vdev, VFL_TYPE_VIDEO, -1);

2.3 ioctl 接口详解

ioctl 是 V4L2 框架中用户态与内核态交互的主要通道。V4L2 定义了丰富的 ioctl 命令，涵盖查询能力、设置格式、控制参数、管理缓冲区、启动/停止流等操作。

以下是 CSI 摄像头驱动中常用的 ioctl 命令分类：

典型的用户态 ioctl 调用流程：

int fd = open("/dev/video0", O_RDWR);

// 1. 查询设备能力
struct v4l2_capability cap;
ioctl(fd, VIDIOC_QUERYCAP, &cap);

// 2. 设置格式
struct v4l2_format fmt;
fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
fmt.fmt.pix.width = 1920;
fmt.fmt.pix.height = 1080;
fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;
ioctl(fd, VIDIOC_S_FMT, &fmt);

// 3. 请求缓冲区
struct v4l2_requestbuffers req;
req.count = 4;
req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
req.memory = V4L2_MEMORY_MMAP;
ioctl(fd, VIDIOC_REQBUFS, &req);

// 4. 启动流
int type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
ioctl(fd, VIDIOC_STREAMON, &type);

2.4 缓冲区管理机制

缓冲区管理是 V4L2 框架中最核心、最复杂的部分，直接决定了视频采集的性能。V4L2 支持三种缓冲区管理方式：MMAP（内存映射）、USERPTR（用户指针）和 DMABUF（DMA 缓冲区共享）。

2.4.1 三种缓冲区模式对比

2.4.2 缓冲区队列状态机

V4L2 缓冲区管理采用生产者-消费者模型，每个缓冲区在生命周期中经历以下状态转换：

2.4.3 中断与缓冲区的协同

在 CSI 摄像头驱动中，中断响应与缓冲区管理紧密耦合。典型的数据流协同流程如下：

1. 初始化阶段：驱动在 VIDIOC_REQBUFS 中分配 DMA 缓冲区，并将所有缓冲区通过 VIDIOC_QBUF 放入驱动队列。
2. 启动流：用户态调用 VIDIOC_STREAMON，驱动使能 CSI 控制器和 DMA 引擎，开始接收图像数据。
3. 中断触发：每帧数据采集完成后，CSI 控制器产生中断。中断服务程序（ISR）中，驱动执行以下操作：
   • 从驱动队列中取出当前使用的缓冲区。
   • 更新缓冲区的时间戳、帧序号、数据长度等元数据。
   • 将缓冲区移至已完成队列。
   • 唤醒等待在 VIDIOC_DQBUF 上的用户态进程。
   • 从空闲队列取出下一个缓冲区，配置 DMA 地址，继续采集。
4. 用户态处理：用户态通过 VIDIOC_DQBUF 获取已完成缓冲区，处理图像数据（显示、编码、存储）。
5. 缓冲区回收：用户态处理完毕后，再次调用 VIDIOC_QBUF 将缓冲区放回空闲队列，形成循环。

2.4.4 vb2 框架简化开发

现代 V4L2 驱动推荐使用 videobuf2 (vb2) 框架，它封装了缓冲区管理的复杂性，提供了统一的接口：

static const struct vb2_ops csi_vb2_ops = {
    .queue_setup    = csi_queue_setup,     // 设置缓冲区数量和大小
    .buf_prepare    = csi_buf_prepare,     // 准备缓冲区（DMA 映射）
    .buf_queue      = csi_buf_queue,       // 缓冲区入队（启动 DMA）
    .start_streaming = csi_start_streaming,// 启动视频流
    .stop_streaming  = csi_stop_streaming, // 停止视频流
};

static struct vb2_queue csi_vq = {
    .type           = V4L2_BUF_TYPE_VIDEO_CAPTURE,
    .io_modes       = VB2_MMAP | VB2_USERPTR | VB2_DMABUF,
    .ops            = &csi_vb2_ops,
    .mem_ops        = &vb2_dma_contig_memops, // 连续 DMA 内存
    .buf_struct_size = sizeof(struct csi_buffer),
};

使用 vb2 框架后，驱动开发者只需实现 buf_queue 回调（将缓冲区地址配置给 DMA 引擎）和中断处理函数（调用 vb2_buffer_done），无需手动管理队列状态机。