MIPI摄像头无图花屏掉帧排查 | FPGA图像采集诊断
MIPI摄像头无图、花屏和掉帧的分层排查方法，覆盖传感器启动、D-PHY、CSI-2、图像格式、缓存及输出链路。
MIPI 摄像头接入 FPGA 后出现无图、花屏或掉帧，不一定是同一个原因。无图常与供电、复位、传感器配置和物理链路有关；花屏更多与图像格式、行长度或缓存有关；掉帧则需要同时检查输入速率、后端带宽和软件处理能力。
本文重点说明：
- 怎样根据现象缩小 MIPI 摄像头故障范围；
- FPGA 图像采集链路应该按什么顺序检查；
- 哪些结果可以证明问题已经真正解决。
*图：先确认摄像头启动，再检查D-PHY和CSI-2，最后核对图像格式、缓存与输出。*
先看结论：不要一开始就改整套FPGA工程
一条完整的 MIPI 图像采集链路通常包括摄像头供电与配置、D-PHY 接收、CSI-2 解包、像素格式转换、帧缓存和后端输出。任何一层不匹配，都可能在画面上表现为“没有正常图像”。
更稳妥的做法是给每一层设置可观察结果，例如传感器 ID 是否可读、接收时钟是否稳定、是否收到帧开始和帧结束、每行像素数是否正确、帧率是否连续。这样可以把问题定位到具体环节。
一、完全无图：先确认摄像头是否真正启动
首先检查电源轨、上电顺序、复位和待机引脚，再通过 I²C 或其他控制接口读取传感器 ID 和关键寄存器。能够写寄存器不代表配置一定生效，最好再读回工作模式、分辨率和输出格式。
如果传感器没有输出时钟或高速数据活动，应优先处理摄像头启动问题，而不是继续修改 CSI-2 解包逻辑。
二、有数据但无法成帧：检查D-PHY与CSI-2配置
确认接收端的 Lane 数、Lane 顺序、极性、连续或非连续时钟模式与摄像头一致。随后观察 CSI-2 是否出现帧开始、帧结束、行数据和错误包。
如果只能偶尔收到完整帧，应记录错误计数是否随时间增长，并检查参考时钟、走线、排线长度和连接器接触。链路裕量不足时，问题可能随温度、线缆或启动次数变化。
三、画面花屏或错位：核对位深、行长度与像素顺序
RAW10、RAW12 等格式通常需要重新打包成便于 FPGA 内部处理的像素数据。若位宽拆分、字节顺序或每行有效字节数错误，画面容易出现斜纹、错位或周期性重复。
建议先使用固定色块、灰阶或已知测试图，核对单行长度、帧尺寸和 Bayer 顺序。测试图比复杂实景更容易判断是链路问题还是颜色处理问题。
四、偶发掉帧：检查缓存和后端输出带宽
摄像头输入连续，而 PCIe、网口、USB 或主机软件可能出现短时等待，因此 FPGA 图像采集卡通常需要缓存和流量控制。平均带宽够用，并不代表峰值时不会溢出。
排查时应同时记录输入帧计数、缓存占用、输出帧计数和丢帧位置。如果 FPGA 内部帧数连续而主机端缺帧，问题更可能在输出链路或上位机处理；如果 FPGA 接收端已经缺帧，则应回到输入链路继续检查。
五、颜色异常：区分采集问题与图像处理问题
画面偏色不一定说明 MIPI 链路错误。Bayer 排列、黑电平、白平衡、颜色矩阵和显示格式都会影响最终颜色。
可以先保存未经复杂处理的原始帧，确认像素排列和位深，再逐步加入去马赛克、颜色校正和显示转换。这样可以避免把算法配置问题误判为采集卡问题。
验证问题是否解决，至少看四项结果
在固定分辨率、帧率和线缆条件下，连续运行一段可复现的测试时间，并记录：接收帧数与输出帧数是否一致、CSI-2 错误计数是否增长、缓存是否溢出、保存图像是否存在错行和偏色。项目需要更高可靠性时，还应增加重复上电、不同温度和不同线缆条件的测试。
总结
MIPI 摄像头无图、花屏和掉帧，应按照“摄像头启动—D-PHY—CSI-2—图像格式—缓存—输出”的顺序排查。把每一层都变成可观察、可记录的结果，才能真正缩短 FPGA 图像采集调试时间。