1. V4L2框架概述

1.1 V4L2在Linux多媒体子系统中的位置

Video for Linux Two（V4L2）是Linux内核中负责视频设备驱动的标准框架，位于多媒体子系统的核心层。它为应用程序提供统一的设备节点接口（/dev/videoX、/dev/v4l-subdevX等），屏蔽底层硬件差异。

1.2 V4L2核心数据结构

V4L2框架围绕几个核心数据结构构建，理解这些结构是掌握驱动开发的基础。下表列出了最重要的数据结构及其职责：

1.3 V4L2核心API分类

V4L2 API分为用户空间API和内核空间API两大部分。用户空间通过ioctl系统调用与驱动交互，内核空间则通过回调函数实现具体硬件操作。

1.3.1 用户空间API（关键IOCTL）

• 查询与枚举：
  • VIDIOC_QUERYCAP — 查询设备能力
  • VIDIOC_ENUM_FMT — 枚举支持的格式
  • VIDIOC_ENUM_FRAMESIZES — 枚举支持的帧尺寸
  • VIDIOC_ENUM_FRAMEINTERVALS — 枚举支持的帧间隔
• 格式与参数设置：
  • VIDIOC_S_FMT / VIDIOC_G_FMT — 设置/获取数据格式
  • VIDIOC_S_PARM / VIDIOC_G_PARM — 设置/获取流参数（帧率等）
  • VIDIOC_S_INPUT / VIDIOC_G_INPUT — 选择/查询输入源
• 缓冲区管理：
  • VIDIOC_REQBUFS — 请求分配缓冲区
  • VIDIOC_QUERYBUF — 查询缓冲区状态
  • VIDIOC_QBUF / VIDIOC_DQBUF — 缓冲区入队/出队
  • VIDIOC_STREAMON / VIDIOC_STREAMOFF — 启动/停止流
• 控制与事件：
  • VIDIOC_S_CTRL / VIDIOC_G_CTRL — 设置/获取控制参数
  • VIDIOC_SUBSCRIBE_EVENT / VIDIOC_DQEVENT — 事件订阅与读取

1.3.2 内核空间API（驱动回调）

驱动开发者需要实现的核心回调函数集：

/* v4l2_subdev_video_ops 中的关键回调 */
struct v4l2_subdev_video_ops {
    int (*s_stream)(struct v4l2_subdev *sd, int enable);
    int (*s_parm)(struct v4l2_subdev *sd, struct v4l2_streamparm *param);
    int (*g_parm)(struct v4l2_subdev *sd, struct v4l2_streamparm *param);
    int (*enum_frame_interval)(struct v4l2_subdev *sd,
                               struct v4l2_subdev_frame_interval_enum *fie);
    int (*enum_frame_size)(struct v4l2_subdev *sd,
                           struct v4l2_subdev_frame_size_enum *fse);
    int (*enum_mbus_code)(struct v4l2_subdev *sd,
                          struct v4l2_subdev_mbus_code_enum *code);
};

/* vb2_ops 中的关键回调 */
struct vb2_ops {
    int (*queue_setup)(struct vb2_queue *q,
                       unsigned int *nbuffers, unsigned int *nplanes,
                       unsigned int sizes[], struct device *alloc_devs[]);
    int (*buf_prepare)(struct vb2_buffer *buf);
    void (*buf_queue)(struct vb2_buffer *buf);
    int (*start_streaming)(struct vb2_queue *q, unsigned int count);
    void (*stop_streaming)(struct vb2_queue *q);
};

1.4 V4L2设备注册流程与设备树的关系

V4L2驱动的初始化流程与设备树解析紧密耦合。以下是一个典型的V4L2摄像头驱动初始化步骤：

1. 平台驱动探测： 内核匹配设备树节点，调用驱动的probe函数
2. 获取资源： 通过of_property_read_*解析设备树属性（reg、interrupts、clocks、pinctrl等）
3. pinctrl设置： 调用devm_pinctrl_get_select_default应用默认引脚复用
4. 时钟使能： 通过clk_get获取时钟句柄，clk_prepare_enable使能时钟
5. V4L2子设备注册： v4l2_subdev_init + v4l2_async_register_subdev
6. video_device注册： video_register_device创建/dev/videoX
7. vb2队列初始化： vb2_queue_init设置DMA缓冲区管理

1.5 V4L2与设备树pinctrl/时钟的耦合点

从上述流程可以看出，V4L2驱动与设备树的pinctrl和时钟配置在以下关键点耦合：