NVIDIA DRIVE NvSIPL 实践：多款模组与 GMSL SerDes(MAX96712/MAX96792/MAX96724/MAX9295/MAX96717)

本文结合 NVIDIA DRIVE 平台上的 NvSIPL 摄像头驱动适配实践，从 Sensor、Serializer、Deserializer 到 CSI 接收端，系统梳理车载摄像头的数据传输、控制与诊断链路。通过对基线代码与项目代码的分析，介绍驱动适配涉及的配置文件、核心接口、初始化流程和 SerDes 拓扑，重点解析 MFP 引脚分配、FSYNC 帧同步、RESET 复位，以及 Embedded Data 的产生、传输与解析机制。

文章汇总项目中各摄像头模组的能力地图，横向比较分辨率、帧率、RAW/YUV 输出、HDR、曝光与增益控制等常用功能，并梳理内外触发、多摄像头帧同步、片上 ISP、LOFIC/SPD、补光同步、温度读取及 OTP/EEPROM 等特色能力。结合测试图生成、内外回环、链路裕量测试和 IMX728S 诊断实例，分析故障检测、错误上报、自检与链路恢复的实现方式。

在采集链路之外，文章进一步介绍多画面合成显示，以及双 Thor 平台通过 PCIe C2C 跨芯片传输摄像头图像的方案，说明摄像头驱动、NvSIPL、NvSciStream/NvSciC2C 与接收端图像处理、编码之间的协作关系。通过区分硬件支持、驱动实现、配置启用与应用层能力，为模组选型、Camera Bring-up、跨芯片图像传输和故障排查提供实践参考。

加载 CameraModule 驱动库 │ ├─ CNvMCameraModule_GetNames()│ └─ CNvMCameraModule_Create()↓ CNvMMAX96712_96717_AR0341 对象 ↓ DoSetConfig()├─ 创建/配置 MAX96717 对象 ├─ 创建/配置 AR0341 Sensor 对象 ├─ GetAR0341Driver()├─ GetCDIDeviceContext()└─ SetupConnectionProperty()└─ SetSensorConnectionProperty()↓ DoCreateCDIDevice()├─ 创建 MAX96717 CDI Device ├─ 创建 AR0341 CDI Device │ └─ DriverCreate()│ └─ DevBlkCDII2CPgmrCreate()└─ 创建 TransportLink ↓ 给 CameraModule 上电并等待 200ms ↓ EnableModuleLink()└─ InitTransportLinks()└─ CNvMTransportLink_Max96712_96717F::Init()├─ 配置 MAX96717 ├─ 配置 GMSL GPIO ├─ 配置 MIPI PHY ├─ 配置 RAW12 Video Pipe └─ 释放 AR0341 Reset ↓ DetectModuleLink()└─ DetectModule()└─ AR0341CheckPresence()↓ CNvMMAX96712CameraModule::Init()├─ AR0341::InitModule()│ ├─ AR0341SetDefaults()│ │ ├─ Sensor Software Reset │ │ └─ 写1920×1536 RAW12 60fps 寄存器表 │ └─ AR0341Trigger()[外同步模式]│ └─ TransportLink::PostSensorInit()└─ MAX96712 配置 FSYNC[外同步模式]↓ CNvMMAX96712CameraModule::PostInit()├─ MiscInitModule()├─ TransportLink::MiscInit()│ ├─ ERRB 配置 │ └─ Register CRC/诊断配置 └─ AR0341::PostInitModule()↓ Deserializer Start ├─ 检查 CSI PLL ├─ 检查 GMSL Link Lock └─ Enable CSI Output ↓ CNvMMAX96712CameraModule::Start()├─ TransportLink::Start()└─ AR0341::StartModule()└─ AR0341StreamOn()└─ 写 AR0341 0x0100=0x0100 ↓ 开始输出图像

所有模组能力地图

按当前 JSON 中 inputFormat: “422” 判断，共有 9 类 YUV422 摄像头，对应 19 个解串器驱动目录

新模组开发真正要做的内容

1. 平台和模组 JSON
通常需要定义：

• Platform 名称。
• DeviceBlock 和 Deserializer。
• CSI Port、PHY mode、lane/trio 数。
• Link index。
• CameraModule 名称。
• Sensor、Serializer、EEPROM 名称和 I²C 地址。
• VCID、DataType、宽高、Embedded Top/Bottom 行。
• Frame rate。
• Trigger mode。
• Reset GPIO、FSYNC GPIO。
• Sensor reference clock。

最容易出错的是“JSON 名字”和 C++ 注册字符串不完全一致。必须逐字符一致。

2. CameraModule 包装层
新模组至少需要关注：

• SetConfigModule
• SetSensorConnectionProperty
• DetectModule
• InitModule
• PostInitModule
• StartModule
• StopModule
• DeinitModule
• GetPowerOnDelayMs
• GetPowerOffDelayMs
• GetErrorSize
• GetErrorInfo
• GetSensorRegisterValue
• SetSensorRegisterValue
• GetSensorPCLK
• GetLinkMode

不是每个模组都要重新实现全部函数；能由基类完成的应尽量复用。

3. Sensor CDI 层
典型功能包括：

• Driver create/destroy。
• 默认状态初始化。
• Chip ID / Revision 检测。
• Sensor 初始化寄存器表。
• Stream On/Off。
• Exposure 时间到寄存器的换算。
• Analog/Digital Gain 换算。
• White Balance Gain。
• Group Hold。
• Embedded Data 解析。
• 温度、帧计数器和错误状态读取。
• 任意寄存器读写。
• Register Dump。
• PCLK/VTS/HTS 计算。
• Sensor Error Data。

4. Serializer/Deserializer 链路
公共 TransportLink 负责的内容很多，新手很容易误认为都在 Sensor 驱动里：

• GMSL Link lock。
• Serializer 地址重映射。
• Sensor/EEPROM broadcast 地址映射。
• Serializer reference clock。
• Sensor Reset GPIO。
• FSYNC GPIO。
• MIPI lane mapping、polarity、2-lane/4-lane。
• RAW 数据类型和 Embedded Data。
• Deserializer pipeline、VC 和输出端口。
• Link Error、CRC、ERRB 和 FUSA 检查。

推荐的 Bring-up 调试顺序

必须逐层推进，不要上来就调 ISP 或图像质量。

阶段 1：供电
确认：

• Deserializer 本身供电。
• PoC/负载开关输出。
• 模组 PMIC。
• Serializer 电源。
• Sensor 各路电源。
• Reset 电平和时序。

这里至少有四层：板级电源、PoC、模组 PMIC、Sensor reset。找不到模组自己的 Power 函数，不代表没有执行供电。

阶段 2：Serializer 链路
目标：

• Deserializer 能锁住 GMSL link。
• 能读 Serializer Chip ID。
• Serializer alias 地址正确。
• 没有同地址冲突。
• Link rate、GMSL1/GMSL2 模式正确。

如果这一步不通，不要继续查 Sensor 初始化表。

阶段 3：Sensor I²C
目标：

• 地址翻译配置成功。
• 读出正确 Chip ID 和 Revision。
• Reset 已释放。
• Sensor reference clock 存在。
• I²C 波形和地址正确。
  常见现象：
• Serializer 可读、Sensor 不可读：优先查 reset、MCLK、地址翻译和电源。
• 单路正常、多路失败：优先查 broadcast/alias 地址冲突。

阶段 4：初始化表
先只做：

• Software reset。
• PLL/MCLK。
• RAW 格式。
• 分辨率。
• HTS/VTS。
• MIPI lane。
• VC/DataType。
• Embedded Data。
• Stream On。

不要一开始混入 AE、AWB、复杂 FUSA 检查。

阶段 5：确认视频链路
依次确认：

1. Sensor frame counter 在增加。
2. Serializer video lock。
3. Deserializer link/pipe lock。
4. Deserializer CSI 输出。
5. SoC CSI/VI 没有 CRC、ECC、short frame。
6. SIPL 收到 frame completion。
7. ISP/Consumer 才开始工作。

“无图”不是一个问题，它至少可能落在七个不同层级。

阶段 6：曝光和增益
重点检查：

• Exposure 单位是秒、微秒还是行数。
• PCLK、HTS、VTS 换算。
• 曝光上限是否预留 margin。
• HDR 各曝光通道顺序。
• HCG/LCG/SPD/VS 映射。
• Analog/Digital Gain 范围。
• Group Hold 是否正确释放。
• 写入值和 Embedded Data 回读值是否一致。

阶段 7：触发同步
必须区分：

• Sensor 自由运行。
• Deserializer 内部产生 FSYNC。
• SoC/外部输入 FSYNC。
  bEnableTriggerModeSync、bEnableInternalSync、Sensor JSON 的 isTriggerModeEnabled 是不同概念，而且公共配置流程可能覆盖模组层设置。

阶段 8：错误与恢复
最终验证：

• 拔插同轴。
• 短时断链。
• Sensor I²C NACK。
• CRC/ECC 错误。
• Frame timeout。
• DisableLink/EnableLink。
• 带 power cycle 的恢复。
• 多路相机中单路恢复是否影响其他路。

最常见问题和优先排查点