Qualcomm CAMSS架构下的摄像头适配实践：V4L2驱动封装与Media Controller pipeline构建详解
在基于Qualcomm CAMSS（Camera Subsystem）的系统中，实现摄像头功能的关键在于V4L2驱动的封装以及Media Controller pipeline的构建。这一流程涵盖了硬件抽象、设备管理与数据流调度等多个方面，是打造高效、可靠摄像头系统的重要基础。
V4L2驱动封装：连接硬件与用户空间的桥梁
V4L2（Video for Linux 2）作为Linux内核中的标准视频驱动接口，为摄像头适配提供了统一的开发接口。在Qualcomm平台中，V4L2驱动的封装主要包括以下几个核心步骤：
设备注册与初始化
通过调用v4l2_device_register()函数，可以注册一个V4L2设备实例，该实例作为系统层级的管理器，负责维护所有子设备的列表。在MSM（Qualcomm Mobile SoC）平台中，msm_probe()函数通常用于创建并注册v4l2_device实例，并生成对应的video_device节点，如/dev/video0，供用户空间调用。
子设备管理
每个摄像头子设备（如图像传感器、ISP等）通常通过v4l2_subdev结构体进行描述，并被嵌入到video_device中。子设备通过I2C或SPI等接口与底层硬件通信，完成如初始化、图像流控制等功能。例如，图像传感器的驱动代码中，msm_sensor_probe()函数通常负责上电、ID校验等初始化操作。
文件操作接口
V4L2驱动通过v4l2_file_operations与v4l2_ioctl_ops接口为用户提供标准的文件操作和控制机制，包括open、read、ioctl等。用户空间应用可以借助这些接口与内核层交互，实现摄像头的控制与图像数据采集。
Media Controller pipeline构建：实现高效数据流转
Media Controller是V4L2驱动体系中的核心组成部分，负责管理设备之间的拓扑关系与数据流路径。在Qualcomm CAMSS体系中，Media Controller通过如下步骤构建pipeline：
设备枚举与拓扑建立
系统通过media_device_register()函数注册媒体设备，并生成对应的/dev/media0节点。用户空间可使用MEDIA_IOC_ENUM_ENTITIES等IOCTL命令来遍历所有子设备，并根据设备名称（如msm-config）找到其对应的video_device节点。
pipeline构建
根据具体的使用场景（如实时预览、拍照、录像等），Media Controller会构建对应的pipeline。一个pipeline通常由多个节点（Node）组成，节点之间通过Link连接，构成完整的图像数据传输路径。例如，预览pipeline可能包含图像传感器、ISP与显示输出节点。
数据流控制
用户空间应用通过VIDIOC_STREAMON和VIDIOC_STREAMOFF等IOCTL命令控制图像流的开启与关闭。Media Controller依据当前的pipeline拓扑，将这些控制指令转发至各个节点，从而启动数据采集和图像处理流程，并将图像数据填充到V4L2的缓冲队列中。
实战案例：添加自定义pipeline的实现过程
在高通平台中，若需添加一条自定义的图像处理pipeline（如SWMFMergeRawTwo2One，用于将两路Raw数据合并为一路输出），通常可按如下步骤进行：
- 创建pipeline的XML文件：在路径vendor/qcom/proprietary/chi-cdk/oem/qcom/topology/usecase/components/usecases/下创建camxSWMFMergeRawTwo2One.xml文件，用于定义pipeline的名称、节点列表及端口连接。
- 配置NodesList与PortLinkages：在XML文件中列出所有相关节点，并定义其输入输出端口的连接关系。例如，可使用NodeId 255标识自定义节点，并通过NodePropertyId和NodePropertyValue字段设置节点参数。
- 更新引用与target定义：在Usecase的XML文件中，通过CamxInclude指令引入自定义pipeline，并为其添加新的目标定义（如TARGET_BUFFER_RAW_OUT2）。
- HAL层适配：在HAL层中添加对新pipeline的支持，确保用户空间应用能够正确调用并控制该pipeline。