4. ToF模组通信协议解析

ToF（Time-of-Flight）模组在嵌入式系统中的集成，本质上是完成三类信号链路的正确对接：控制平面（寄存器配置）、数据平面（深度/红外图像传输）以及事件平面（中断与状态指示）。本章将深入解析I2C/SPI寄存器读写时序的差异与适用场景，MIPI CSI-2接口在ToF应用中的数据传输机制（包括虚拟通道、数据类型与帧格式），以及中断与GPIO控制信号在系统同步与电源管理中的关键作用。理解这三类协议的正确交互，是驱动移植成功的基础，也是排查图像异常、帧率不稳、功耗异常等问题的关键入口。

上图展示了ToF模组与主控SoC之间的完整接口关系。控制平面通过I2C或SPI实现寄存器级配置，数据平面通过MIPI CSI-2接口传输深度与红外图像，事件平面通过中断与GPIO信号实现异步通知与电源管理。三个平面在时序上必须严格协同，任何一环的时序异常都可能导致图像撕裂、帧率下降或模组无法唤醒。

4.1 I2C/SPI寄存器读写时序：控制平面的核心机制

4.1.1 核心原理：两种总线的本质差异

ToF模组的寄存器空间通常包含数百个控制寄存器（如积分时间、调制频率、激光功率、ROI窗口、去噪参数等）以及只读的状态寄存器（如温度、错误码、版本号）。I2C和SPI是两种最常用的控制总线，它们在时序特性上存在显著差异：

在ToF模组驱动中，I2C通常用于运行时的寄存器配置（如每次改变积分时间），而SPI则用于出厂校准数据烧录或固件升级。部分高端ToF模组（如TI的OPT9221配合CCD传感器）甚至将SPI作为主控制通道，因为其高吞吐量可以支持更复杂的算法参数实时更新。

4.1.2 判断方法：如何选择I2C还是SPI

选择控制总线时，需要评估以下三个维度：

• 带宽需求：如果每次配置需要写入超过64字节的寄存器块（如多区域ROI配置），且帧率要求高于30fps，则SPI是更优选择；若仅需修改少量参数（如曝光时间、增益），I2C足够。
• 引脚资源：I2C仅占用2个GPIO，而SPI需要4个。在引脚紧张的嵌入式系统中，I2C往往成为默认选择。
• 时序确定性：SPI的时钟由主机完全控制，无仲裁机制，时序确定性更强；I2C在总线拥塞时可能产生等待状态，不适合对时间敏感的操作。

4.1.3 案例拆解：I2C读写时序异常导致图像噪声

背景与约束：某机器人项目使用ToF模组进行避障，主控为i.MX8M Mini，I2C总线频率设置为400kHz。模组初始化后，深度图像出现周期性水平条纹噪声，且模组温度读数异常偏高（从35°C跳变至80°C）。

分析过程：通过逻辑分析仪抓取I2C波形，发现SDA线上存在毛刺信号，且SCL高电平时间不足（仅1.1μs，而400kHz要求高电平最小0.6μs，但实际模组要求1.3μs）。进一步检查发现，I2C上拉电阻为2.2kΩ，但总线电容因PCB走线过长（超过15cm）而偏大，导致上升沿过缓。

操作步骤：

1. 将I2C上拉电阻从2.2kΩ更换为1.0kΩ，提升上升沿速率。
2. 在驱动代码中将I2C时钟频率从400kHz降低至300kHz，留出时序裕量。
3. 在模组初始化序列中增加20ms延时，确保电源稳定后再进行寄存器写入。

结果对比：修复后，温度读数稳定在38°C±1°C，水平条纹完全消失。代价是初始化时间增加了约15ms，但帧率不受影响。

4.2 MIPI CSI-2数据传输：深度图像的高速通道

4.2.1 核心原理：CSI-2协议在ToF中的特殊应用

MIPI CSI-2是摄像头模组与SoC之间最主流的数据传输接口。ToF模组虽然输出的是深度数据而非传统RGB图像，但其数据格式仍然遵循CSI-2协议规范。关键差异在于：

• 数据类型（Data Type）：ToF模组通常使用RAW10或RAW12格式传输原始相位数据，或使用用户自定义数据类型（0x30~0x37）传输深度图（Depth Map）和置信度图（Confidence Map）。
• 虚拟通道（Virtual Channel）：多路数据流（如深度+IR+置信度）可通过不同虚拟通道在同一物理链路上传输，减少引脚占用。
• 帧结构：ToF数据帧通常包含帧起始码（SoF）、行起始码（SoL）、图像数据、行结束码（EoL）、帧结束码（EoF）。驱动需要正确解析这些同步码以恢复图像帧。

// CSI-2 数据类型示例（ToF模组典型配置）
#define MIPI_DT_RAW10       0x2B  // 原始10位数据
#define MIPI_DT_USER_DEF_1  0x30  // 深度图（16位）
#define MIPI_DT_USER_DEF_2  0x31  // 置信度图（8位）
#define MIPI_DT_USER_DEF_3  0x32  // IR灰度图（8位）

4.2.2 判断方法：CSI-2链路调试的关键指标

在驱动移植过程中，CSI-2链路调试通常遵循以下流程：

1. 物理层检查：使用示波器测量差分信号眼图，确保数据速率下的眼高>200mV、眼宽>0.6UI。
2. 协议层检查：使用协议分析仪（如Keysight的U4421A）捕获CSI-2包，检查包头CRC和包尾CRC是否正确。
3. 应用层检查：在SoC的ISP或视频接收端（如i.MX8的ISI模块）配置正确的数据类型和虚拟通道映射。

4.2.3 实战场景：多虚拟通道数据同步

某ToF模组通过CSI-2的4个虚拟通道同时输出深度图（VC0）、IR图（VC1）、置信度图（VC2）和RGB图（VC3，来自辅助摄像头）。在驱动中需要为每个虚拟通道配置独立的DMA通道，并确保四路数据在时间上对齐。

关键操作：在SoC的CSI-2接收控制器中，使能所有4个虚拟通道，并为每个通道分配独立的缓冲区。同时，在帧同步信号（FSYNC）触发时，启动所有DMA传输。若发现深度图与IR图错位一帧，需要检查模组是否在帧起始时同时输出所有虚拟通道的数据，必要时在驱动中增加帧ID校验。

4.3 中断与GPIO控制信号：事件驱动的基石

4.3.1 核心原理：中断与GPIO的分工

ToF模组的中断（INT）和GPIO控制信号（如XSHUT、PWDN、RST）在系统运行中承担不同职责：

• INT（中断请求）：模组主动向SoC发送事件通知，包括帧同步就绪、测量完成、错误报警（如激光过温、电源欠压）、FIFO溢出等。SoC通过中断服务程序（ISR）响应这些事件。
• XSHUT/PWDN（关断控制）：低电平有效。拉低后模组进入硬件关断状态，功耗降至μA级。用于系统休眠或模组异常复位。
• RST（复位）：低电平有效。复位模组内部所有寄存器至默认值，需重新初始化。
• GPIO（通用控制）：可用于激光使能（LASER_EN）、外部触发输入（TRIGGER）等自定义功能。

4.3.2 判断方法：中断信号的有效性与去抖

在驱动中配置中断时，需要明确以下参数：

1. 触发方式：上升沿、下降沿、高电平、低电平。ToF模组通常支持可编程中断极性，需根据模组手册配置。
2. 去抖时间：部分模组的中断信号在内部已经去抖，但外部干扰仍可能导致误触发。建议在SoC侧配置GPIO去抖（如i.MX8的GPIO输入滤波器）或软件去抖（延时重读）。
3. 中断清除机制：多数ToF模组的中断状态寄存器需要主机读取后写1清除（W1C）。若未正确清除，中断会持续触发，导致CPU占用率飙升。

// 中断处理伪代码（Linux内核驱动）
static irqreturn_t tof_irq_handler(int irq, void *dev_id) {
    struct tof_dev *tof = dev_id;
    uint32_t status;
    // 读取中断状态寄存器
    tof_read_reg(tof, REG_INT_STATUS, &status);
    if (status & INT_FRAME_SYNC) {
        // 帧同步就绪，启动DMA传输
        tof_start_dma(tof);
    }
    if (status & INT_ERROR) {
        // 错误处理：读取错误码，记录日志
        tof_read_reg(tof, REG_ERROR_CODE, &tof->last_error);
    }
    // 写1清除所有中断
    tof_write_reg(tof, REG_INT_CLEAR, status);
    return IRQ_HANDLED;
}

4.3.3 案例拆解：GPIO控制时序导致模组无法唤醒

背景与约束：某智能门锁产品使用ToF模组做人脸识别，系统待机时拉低XSHUT进入低功耗模式。唤醒时，SoC拉高XSHUT并重新初始化模组。但现场反馈，约5%的设备在唤醒后无法输出图像，必须断电重启。

分析过程：通过示波器测量XSHUT引脚波形，发现SoC拉高XSHUT后，模组的电源电压（AVDD）在2ms后才稳定到2.8V。而模组数据手册要求XSHUT拉高前，AVDD必须已稳定至少10ms。由于SoC的GPIO和电源管理由不同子系统控制，存在时序竞争。

操作步骤：

1. 在驱动中增加电源稳定等待函数，在拉高XSHUT前轮询电源监控ADC，确认AVDD>2.7V。
2. 增加固定延时：拉高XSHUT后，延时20ms再开始I2C初始化。
3. 在设备树中配置XSHUT GPIO为开漏输出，并外接10kΩ上拉电阻，确保默认状态为高电平（模组正常工作）。

结果对比：修复后，唤醒失败率从5%降至0.01%以下。代价是唤醒时间增加了约20ms，但人脸识别场景可接受。

4.4 常见误区与总结复盘

4.4.1 误区一：I2C速率越高越好

虽然I2C标准支持1MHz，但ToF模组的寄存器写入需要满足特定的建立时间和保持时间。部分模组在400kHz以上时，内部逻辑无法正确采样，导致寄存器写入错误。建议严格按照模组数据手册的时序要求配置I2C速率，而非盲目追求高速。

4.4.2 误区二：忽略CSI-2的帧同步信号

ToF模组的深度图与IR图必须在同一时刻采集，否则运动物体会产生伪影。CSI-2协议本身不提供全局时间戳，需要依赖模组的帧同步信号（FSYNC）或SoC的硬件时间戳。在驱动中，务必确保所有虚拟通道的数据帧使用相同的帧起始时间。

4.4.3 误区三：中断处理函数中执行耗时操作

中断服务程序应保持极短，仅做标志位设置和必要的数据读取。若在ISR中执行I2C读写（可能阻塞），会严重影响系统实时性。正确做法是：在ISR中仅唤醒工作队列或tasklet，将实际的数据处理放到进程上下文。

4.4.4 总结复盘：协议协同的工程要点

在ToF模组驱动移植中，建议遵循“先控制、后数据、再事件”的调试顺序：首先确保I2C/SPI能正确读写寄存器（通过读取模组ID验证），然后配置CSI-2链路并抓取一帧图像，最后接入中断与GPIO控制。每一步都需要使用逻辑分析仪或示波器验证时序，避免“盲调”。