2. MIPI CSI-2协议基础

MIPI CSI-2（Camera Serial Interface 2）是移动与嵌入式领域应用最广泛的摄像头串行接口标准。对于Linux内核驱动开发者而言，理解CSI-2协议不仅是解析设备树中端点属性（endpoint properties）的前提，更是调试图像采集异常（如花屏、丢帧、通道错位）的必备技能。本章将从物理传输机制出发，逐层拆解协议栈，重点剖析长/短包结构、虚拟通道与数据类型映射，并结合多通道（Multi-Lane）映射的工程实践，帮助读者建立从“传感器输出”到“控制器接收”的完整数据通路认知。

上图展示了CSI-2链路的核心分层与数据流。物理层负责差分信号传输，协议层负责数据封装与校验，应用层则面向具体的像素格式。驱动开发者的主要战场在协议层与物理层的交互边界——即如何正确配置控制器以匹配传感器的输出格式与通道映射。

2.1 物理层：D-PHY的电气特性与通道结构

CSI-2的物理层基于MIPI D-PHY规范，采用源同步差分信号。每个通道（Lane）由一对差分线（P/N）组成，包含一个时钟通道（Clock Lane）和1-4个数据通道（Data Lane）。时钟通道传输DDR（双沿）时钟，数据通道在时钟的上下沿均采样数据，因此每个数据通道的理论带宽为时钟频率的2倍。

核心原理：D-PHY定义了三种工作模式——高速（HS）模式用于突发传输像素数据，低功耗（LP）模式用于传输控制信号（如帧同步、进入/退出高速模式）。HS模式下差分摆幅约200mV，LP模式下单端摆幅约1.2V。驱动开发中，需要关注控制器对HS/LP切换时序的要求，尤其是LP→HS的建立时间（T_HS_SETTLE），该参数通常需要在设备树中根据传感器手册调整。

多通道映射的物理约束：数据通道的数量决定了峰值带宽。例如，一个1080P60 RAW10传感器，像素时钟约148.5MHz，RAW10每像素10bit，总数据率约1.485Gbps。若使用2-Lane配置，每条Lane需承载约742.5Mbps，对应时钟频率约371.25MHz（DDR）。若使用4-Lane，则每条Lane仅需371.25Mbps，时钟频率降至185.6MHz，对PCB布线更友好。

通道数	典型带宽	适用场景	驱动配置要点
1-Lane	≤1Gbps	低分辨率（VGA/720P）	设备树中data-lanes = <1>
2-Lane	≤2Gbps	1080P30 RAW10	需指定lane映射顺序
4-Lane	≤4Gbps	4K RAW12/多摄像头复用	注意时钟通道位置固定

2.2 协议层：长包与短包的结构解析

CSI-2协议层定义了两种包格式：短包（Short Packet）和长包（Long Packet）。短包固定为4字节，用于传输帧同步、行同步等控制信息；长包则包含包头、像素数据、包尾三部分，用于传输实际的图像数据。

短包结构：由数据标识符（DI）、16位字计数（WC，固定为0）、ECC校验码组成。其中DI字段的高2位为虚拟通道（VC），低6位为数据类型（DT）。常见的短包DT值包括：0x00（帧同步代码FS）、0x01（帧结束FE）、0x02（行同步LS）、0x03（行结束LE）。

长包结构：包头包含DI、16位字计数（WC，表示像素数据的总字节数）、ECC；包尾为16位CRC校验。WC的计算需注意：对于RAW10格式，每4个像素打包为5字节，因此WC = 像素数 × 10 / 8。驱动开发中，若WC计算错误，会导致接收端数据错位或DMA溢出。

// 长包解析示例（内核drivers/media/platform/mediatek/mdp3/）
static int mdp3_csi2_parse_long_packet(struct mdp3_csi2_dev *dev, u32 *buf)
{
    u32 di = (buf[0] & 0xFF000000) >> 24;
    u32 wc = (buf[0] & 0x00FFFF00) >> 8;
    u32 ecc = buf[0] & 0x000000FF;
    u32 vc = (di >> 6) & 0x03;
    u32 dt = di & 0x3F;
    // 校验ECC，若失败则丢弃该包
    if (ecc != calc_ecc(buf[0])) {
        dev_err(dev->dev, "ECC error, VC=%d DT=0x%02X\n", vc, dt);
        return -EIO;
    }
    // 根据DT分发到对应缓冲区
    return mdp3_csi2_route_payload(dev, vc, dt, &buf[1], wc);
}

案例拆解：某项目使用IMX219传感器（RAW10，1920×1080），配置为2-Lane模式。调试时发现图像下半部分出现绿色条纹。通过读取控制器寄存器，发现MIPI_CSIS_ERR1的CRC错误计数持续增长。进一步分析发现，传感器输出的行长为1920×10/8=2400字节，但驱动中配置的wc为2400，而实际DMA读取时按4字节对齐，导致每行末尾多读2字节，引发CRC错位。解决方案是将DMA突发长度调整为与WC对齐，并在设备树中设置lane-polarities确保差分极性正确。

2.3 虚拟通道（VC）与数据类型（DT）的映射策略

虚拟通道允许在同一个物理链路上复用多路数据流。VC字段为2位，因此最多支持4个虚拟通道。每个VC可以承载不同的数据类型，例如VC0传输RAW10主图像，VC1传输YUV422副图像（如景深数据）。

核心原理：接收端控制器根据DI字段中的VC和DT值，将数据路由到不同的DMA通道或内存缓冲区。在Linux V4L2框架中，每个VC对应一个独立的/dev/videoX节点，通过media-controller拓扑进行管理。

数据类型（DT）详解：DT字段为6位，定义了像素格式。常见值包括：

• RAW8 (0x2A)：每像素8bit，常用于黑白或低端传感器。
• RAW10 (0x2B)：每像素10bit，4像素打包为5字节，需注意位序（高位在前）。
• RAW12 (0x2C)：每像素12bit，2像素打包为3字节。
• YUV422-8bit (0x1E)：每像素16bit，Y/U/V交错排列。
• RGB888 (0x24)：每像素24bit，常用于测试模式。

判断方法：在驱动中，通过v4l2_fill_mbus_format设置mbus_code，该值需与传感器的DT值严格对应。例如，IMX219输出RAW10时，mbus_code应为MEDIA_BUS_FMT_SRGGB10_1X10。若配置错误，图像会出现颜色错乱或无法采集。

DT值	格式	每像素位数	V4L2 MBUS代码	典型传感器
0x2A	RAW8	8	MEDIA_BUS_FMT_SRGGB8_1X8	OV5640 (RAW8模式)
0x2B	RAW10	10	MEDIA_BUS_FMT_SRGGB10_1X10	IMX219, OV5647
0x2C	RAW12	12	MEDIA_BUS_FMT_SRGGB12_1X12	IMX477
0x1E	YUV422	16	MEDIA_BUS_FMT_UYVY8_1X16	OV5640 (YUV模式)

2.4 多通道映射的工程实践与排障

多通道映射涉及两个层面：物理层的Lane分配和协议层的VC复用。在设备树中，通过data-lanes属性指定传感器输出到控制器输入的Lane映射关系。例如，一个4-Lane传感器可以配置为data-lanes = <1 2 3 4>，表示D0→Lane0，D1→Lane1，以此类推。若映射错误，接收端将无法同步数据。

操作流程：调试多通道映射时，建议按以下步骤进行：

1. 确认传感器手册中的Lane分配表，记录每个物理通道对应的VC和DT。
2. 在设备树中设置data-lanes和lane-polarities（差分极性，通常为<0 1>表示正负不反转）。
3. 使用media-ctl -p查看当前拓扑，确认V4L2子设备之间的链接关系。
4. 采集一帧图像，检查是否有行错位或颜色异常。若异常，使用示波器测量各Lane的HS-TX时序。

案例拆解：某方案使用4-Lane连接OV5640（RAW10，2592×1944）。调试时发现图像上半部分正常，下半部分出现随机噪点。通过分析，发现传感器在输出高分辨率时，4条Lane的负载不均——D0和D1承载了大部分数据，而D2和D3空闲。原因是设备树中data-lanes配置为<1 2 3 4>，但传感器固件默认将数据分配到前两条Lane。解决方案是更新传感器固件，或修改设备树为<1 2 1 2>（即D0和D1各复用两次），但后者会降低带宽。最终通过升级固件解决。

常见误区：初学者容易混淆“通道数”与“虚拟通道数”。物理通道（Lane）是硬件差分线，虚拟通道（VC）是协议层的逻辑标识。一个物理通道可以承载多个VC的数据（通过时分复用），但一个VC的数据不能跨物理通道传输（除非使用协议层的多通道合并功能，但该功能在CSI-2 v1.3中才引入，且需要控制器支持）。