7.2 板级调试与诊断
7.2 板级调试与诊断
本节摘要：仿真全绿但上板出问题，物理世界开始介入。本节教你板级调试的基础设施与方法：片上逻辑分析仪（ILA）怎么配触发、怎么设深度，如何用"先埋探针"的思维设计可观测性，以及信号丢失、噪声、毛刺、接口时序这些"仿真看不见"的问题怎么定位。
当仿真无法回答的问题出现
仿真再完备，上板后仍有一类问题它永远答不了：物理问题。信号在真实走线上有噪声、有反射；外部器件有自己的时序脾气；温度和电压会漂移。这些在理想化的仿真模型里都不存在。所以板级调试是每个 FPGA 工程师的必修课——而且它有个独特的节奏：仿真 bug 能在桌面上慢慢研究，板级 bug 往往要"在灯坏了的实验室里抓一个只在特定温度出现的闪断"。
板级调试的第一原则是先埋探针：在设计阶段就规划好调试基础设施——留出调试信号、预置观测点、设计可旁路路径。等到出了故障才想"我怎么看内部信号"，一切已经晚了，因为 ILA 需要在综合前就实例化进设计。
ILA：插进芯片里的逻辑分析仪
FPGA 调试的头号工具是片上逻辑分析仪（ILA，Integrated Logic Analyzer）：它是一段被综合进设计的调试逻辑，按你的设置抓取内部信号，通过 JTAG 把波形传回电脑。用它的套路很固定：
- 例化 ILA 核，把要观测的信号接进去（数量、位宽按需选）。
- 配置采样深度：触发前存多少拍、触发后存多少拍。深度越深，看到的上下文越长，但 BRAM 占用越多。
- 配置触发条件：比如"当 counter 等于某个值时触发""当 error 信号拉高时触发"。触发条件是调试的灵魂——抓得准，一次定位；抓不准，反复折腾。
- 综合、下载、运行，在波形里分析。
触发-采样-分析循环
ILA 的采样深度是最常纠结的参数：深度深能看到触发前的长上下文（找"为什么会到这里"），但每个采样点占一块 BRAM。工程经验：先浅后深——先用浅深度确认触发条件对不对，再加深深度抓长上下文，别一上来就满配。
可观测性设计：让调试不抓瞎
ILA 不是万能的：它只能抓你预先接进去的信号。所以 RTL 设计阶段就要做可观测性设计：
- 关键状态机的当前状态、计数器的值、错误标志，提前留出来供观测。
- 用"状态寄存器的编码"辅助判断：调试时直接把状态值读出来，一眼看出模块卡在哪个阶段。
- 预留调试旁路：比如某条路径可以切换成测试模式，隔离嫌疑模块。
- 合理复用调试引脚：调试信号多的系统，用 JTAG 通道传回电脑，别把所有调试线都引到外部引脚。
物理问题的典型症状
上板遇到的物理问题，各有各的"长相"，认识长相能省一半排查时间：
| 现象 | 常见根因 | 初查方向 |
|---|---|---|
| 偶发错误、与温度相关 | 时序余量不足 / 信号完整性 | 看时序报告余量、检查走线长度 |
| 特定数据模式才出错 | 串扰 / 电源噪声 | 换数据模式对比、测电源纹波 |
| 一接外设就复位 | 复位域冲突 / 上电时序 | 检查复位路径与电源时序 |
| 高速接口时通时断 | 参考时钟不稳 / 均衡不足 | 测参考时钟、调均衡档位 |
| 波形整体滞后 | 引脚约束错误 | 核对管脚约束与原理图 |
分层定位法是处理这些问题的通用章法：先确认"问题在哪一层"——软件层（逻辑行为）、接口层（协议时序）、物理层（信号质量）。每层都有专属工具（仿真、协议分析仪、示波器），先锁定层次，再用对应工具深挖，比逐层瞎试高效得多。
一次完整的调试实战
把整套方法走一遍，看一个"偶发数据错误"的排查过程。
背景：一个 SPI 从设备与 FPGA 通信，从设备每帧回传 32 字节，FPGA 侧偶发读到错字节，大约几万帧错一次。仿真全绿，上板复现率低。
操作：先用 ILA 把 SPI 接收逻辑的关键信号抓上——片选、时钟、移位寄存器的输出。触发条件设为"校验错误的字节"，但错误出现频率太低，抓了三次都没触发成功。于是缩小思路：改抓"帧结束"事件，先看最近几十帧的正常数据里有没有规律性异常。结果发现：错误帧里第一个字节和第二个字节被交换了。
结果：这个规律性给了方向——不是信号噪声，而是逻辑时序问题。查 SPI 主设备的时序规范，发现该从设备的片选释放前，时钟需要多保持一拍；FPGA 的接收逻辑提前一拍采样了数据，把第二字节的尾部当成了第一字节。
解读：这次调试的三个关键动作——先抓大现象（帧结束）再逼近细节（字节错位）、把偶发问题先变成规律问题、对照外部器件的时序规范找根因——是板级调试的通用套路。如果一开始就怀疑信号完整性去调走线，方向就错了。
变式：同样的套路可以搬到更多场景：UART 偶发乱码查波特率偏差与采样点、DDR 偶发错误查训练参数与温度、以太网丢包查 CRC 校验错误计数。原则不变：先量化现象（多抓几次）、再锁定层次、最后对规范。
⚠️ 常见坑：把 ILA 当示波器用。ILA 只能看数字信号、采样率受限于你的时钟，抓不到亚稳态和毛刺的真实模拟波形——那些要上示波器。工具选错，调试必然绕远。
问题：调试信号太多，ILA 放不下怎么办
问：一个模块的可观测信号动辄几十上百个，ILA 采样深度和位宽都有限，怎么取舍？答：三个办法配合用。一是分层观测：先只抓"状态机状态 + 关键计数器"这类高层信号（几十位就够），定位到嫌疑模块后再针对性加深度信号；二是复用触发器：把暂时不用的调试信号通过多路选择器复用同一批 ILA 位，切换观测目标不用重新综合；三是用断言替代抓取：很多"该不该发生"的判断用仿真断言（7.1 的方法）就能兜住，上板只抓"断言兜不住"的物理层信号。记住原则：ILA 是最后手段，能用仿真和断言解决的，别占片上资源。
本节要点回顾
- 先埋探针：调试信号在 RTL 阶段就设计好，ILA 必须在综合前实例化。
- 触发是灵魂：触发条件准，一次定位；不准，反复折腾。先浅深度确认，再加深。
- 可观测性设计：状态编码、错误标志、调试旁路，都是让调试不抓瞎的投资。
- 认识物理症状：温度相关、模式相关、时通时断各有根因方向，别乱查。
- 分层定位：先锁层（软件/接口/物理）再选工具，别用 ILA 干示波器的活。
下一步进入 7.3：功能对、能调试，还差最后一层——可靠性设计，让系统在恶劣环境里依然正确。