第1章：Camera驱动开发全景：RK平台Camera子系统架构、V4L2框架、ISP Pipeline、MIPI CSI/DSI协议基础
大家好，我是老周。做RK平台Camera驱动这行，一晃十多年了。从RK3288一路干到RK3588，踩过的坑比走过的路还多。
这一章，咱们先把全景图铺开。说白了，就是让你脑子里先有个完整的Camera子系统地图。后面每一章，都是这张地图上的一个具体坐标。
1.1 RK平台Camera子系统整体架构
先看一张我手绘的架构图。这张图我每次带新人，都会先让他们盯着看五分钟。
核心观点：RK平台的Camera子系统，本质上是「Sensor + ISP + 内存」这三者之间的数据搬运与处理链路。谁控制这条链路，谁就掌握了图像质量。
这张图你得记住三个层次：用户空间、内核空间、硬件层。我当年刚接触RK平台时，就是靠这张图把整个驱动脉络理清的。
1.2 V4L2框架——Camera驱动的灵魂
V4L2，全称Video for Linux 2。说白了，它就是Linux内核给视频设备定的一套标准接口。你写Sensor驱动，本质上就是在实现V4L2规定的那些回调函数。
个人经验：我习惯把V4L2框架理解成一个「设备管理器」。它帮你管好了打开设备、配置格式、申请缓冲区、启动流、处理数据这一整套流程。你只需要关心你的Sensor怎么初始化、怎么输出数据就行。
V4L2框架的核心数据结构，我列个表给你看：
| 数据结构 | 作用 | 我在项目中踩过的坑 |
|---|---|---|
struct video_device |
代表一个V4L2视频设备节点（/dev/videoX） | 注册顺序搞错，导致设备节点号乱跳 |
struct v4l2_device |
V4L2顶层设备实例，管理所有子设备 | 忘记调用v4l2_device_register()，内核直接Oops |
struct v4l2_subdev |
子设备抽象，Sensor、ISP、CSI都是子设备 | 子设备初始化顺序不对，导致MIPI时钟锁不住 |
struct vb2_queue |
视频缓冲区队列管理 | buffer类型配错，应用层拿不到数据 |
struct media_entity |
Media Controller实体，用于pipeline拓扑管理 | link配置漏了，ISP不干活 |
嗯，这里要注意：V4L2框架本身不处理图像数据。它只负责把数据从Sensor搬到内存，再从内存搬到应用层。真正的图像处理，是ISP干的活。
1.3 ISP Pipeline——图像质量的命脉
ISP，Image Signal Processor。你想想看，Sensor输出的原始RAW数据，那叫一个惨不忍睹。偏色、噪点、暗角、坏点，啥毛病都有。ISP就是干这个的——把RAW数据变成人眼看着舒服的图像。
RK3588的ISP Pipeline，我画了个简化流程：
避坑指南：我曾经在RK3568上调一个IMX415的Sensor，ISP Pipeline里的AWB参数没配好，出来的图像偏蓝得离谱。后来发现是AWB的增益矩阵配置反了。记住：ISP调参，一定要从RAW开始一级一级验证，别跳步。
1.4 MIPI CSI/DSI协议基础
MIPI，Mobile Industry Processor Interface。CSI是Camera Serial Interface，DSI是Display Serial Interface。咱们做Camera的，主要跟CSI打交道。
MIPI CSI-2的物理层，说白了就是差分信号传输。一对差分线叫一个Lane，数据在Lane上串行传输。RK3588支持4 Lane CSI，最高速率能到2.5Gbps per Lane。
我整理了一个MIPI CSI-2的关键参数表：
| 参数 | 说明 | RK3588典型值 |
|---|---|---|
| Lane数量 | 数据通道数，1/2/4 Lane | 4 Lane |
| 每Lane速率 | 数据时钟频率 | 1.5Gbps（常用） |
| 数据类型 | RAW8/10/12, YUV422, JPEG等 | RAW10（Sensor常用） |
| 虚拟通道 | VC，最多4个虚拟通道 | VC0（单Sensor场景） |
| LP/HS模式 | 低功耗/高速模式切换 | HS模式传输数据 |
你想想看，MIPI CSI的调试，最头疼的是什么？时钟锁定。我遇到过好几次，Sensor输出的时钟频率跟CSI Host期望的不匹配，导致D-PHY锁不住PLL，画面全黑。
调试技巧：我习惯在调试MIPI时，先用示波器量一下Sensor输出的时钟和数据信号。看看眼图是否清晰，电压摆幅是否达标。很多时候，问题出在PCB走线太长或者阻抗不匹配上，跟驱动代码没关系。
1.5 本章小结
这一章，咱们把RK平台Camera驱动的全景图铺开了。你脑子里应该有三个核心概念：
- V4L2框架——驱动开发的骨架，所有设备都挂在这个框架上
- ISP Pipeline——图像质量的灵魂，从RAW到YUV的每一级处理都不能马虎
- MIPI CSI——数据传输的血管，物理层调不好，上层再牛也白搭