链路全绿却黑屏：视频通路的“状态向量“调试法

系列第三篇。场景FPGA DisplayPort 视频透传输入端收 GPU输出端接显示器 中间过 DDR 帧缓冲。链路层一切正常屏幕就是不亮——这类问题怎么系统性地查。## 全绿骗了我们几次视频链路调试最折磨人的阶段不是链路训练失败——那至少有明确的错误码——而是**一切指标正常但屏幕不亮**两侧链路训练成功、时序参数正确、主流使能已置位显示器背光亮着画面漆黑或者一屏雪花。这个阶段我们被全绿骗了不止一次后来沉淀出一个原则**链路状态只证明管子通了不证明水在流。** 要判断水流必须给整条数据路径的每一段都找到一个可观测量拼成一个状态向量一次采集、整体判读。## 我们的状态向量长什么样以GPU→接收核→DMA 写→DDR→DMA 读→图样发生器→发送核→显示器这样一条典型透传链为例状态向量至少包含1. **两侧链路状态**训练完成位、每 lane 的 CR/EQ/符号锁定这只是管子2. **接收侧视频状态**时序参数寄存器分辨率/总行场/像素时钟比值、视频有效标志——证明协议核确实在解出视频3. **DMA 写通道状态寄存器**特别是错误锁存位行/帧几何不匹配类错误——这是我们抓到最多次凶手的地方4. **帧缓冲内容取证**直接从 DDR 采样几个字调试口读内存间隔几秒采两次—— 内容在变真有像素在写内容凝固写路径断了全零只有初始化数据5. **DMA 读通道 视频时钟锁定 图样发生器配置**证明显示那半边在正确消费一次黑屏把向量全采出来凶手几乎立刻现形。举三个真实案例细节脱敏**案例 A显示器显示内存里的陈года数据。** 向量显示读通道健康、写通道零活动、DDR 内容凝固。追到接收协议核里有一个视频输出使能门——bring-up 阶段为了安静把它关了忘了打开。视频根本没流出协议核。教训**协议核内部的enable 树要画全**一个被遗忘的门就能吃掉整条流。**案例 B换一次显示模式就永久黑屏。** 向量显示DMA 写通道错误位锁存行几何错误全家桶且**停机后错误位不自动清除**——后续所有重启写通道的自愈尝试都对着陈旧错误空转。两个教训几何参数每行字节数必须和流的实际打包格式逐模式核对**错误锁存位的清除条件要读手册**停止再启动往往不够需要复位。**案例 C一切正常画面每隔几像素错位。** 向量全绿唯独 DDR 取证的内容模式不对——同一行内数据周期与预期打包宽度不符。追到每拍像素数这个参数在链路上五个地方出现接收管线、时序结构、DMA 几何、内存布局、发送核其中一处被驱动内部逻辑按像素时钟自动改写与其余四处失配。教训**跨模块共享的格式参数要么单点定义处处引用要么在切换点全链同步**——我这里设过了不算数。## 关于读寄存器的时机状态向量方法有个隐蔽的坑**采样时机**。视频协议核的时序寄存器在管线复位、模式切换的瞬间会读出垃圾我们抓到过色深字段读出不存在的值这种鬼数据差点顺着它修出第二个 bug。三条守则- 采样前先确认链路处于已训练稳定态- 一次把整组寄存器读完存下来再去做任何会扰动管线的操作- 关键值做隔 N 毫秒复读一致的防抖确认## 小结链路通与画面对之间隔着一整条数据路径。与其黑屏时凭直觉猜不如提前给路径的每一段布好观测点黑屏时一次采全、整体判读。我们把这套向量做成了固件里的一个调试命令一个 JTAG 脚本后来每次黑屏的平均定位时间从天缩到了十分钟。本系列下一篇嵌入式调试的四个反直觉时刻