FPGA 与数字 IC 设计 / 系统课时

记录可复用调试证据

记录可复用调试证据

一次调试真正有价值的产物不是“问题解决了”,而是一份别人能够复现、理解并继续验证的证据记录。本课把测点、触发条件、波形、判断依据和修复结果组织成可交接的故障证据链。

学习目标

  • 能记录让他人复现故障所需的最小条件
  • 能把波形观测与具体结论一一对应
  • 能形成包含修复前后验证结果的闭环记录

先记录故障发生时的完整条件

只保存一张异常波形通常不够。至少应同时记录输入条件、时钟频率、复位初态、触发方式、关键测点和故障发生时间。动态值使用实际实验记录中的值,不要用“偶发”“大约”等模糊描述替代。

建议先固定一条最小证据主线:条件 → 测点 → 现象 → 判断 → 修改 → 复测。这样即使交给没有参与现场调试的工程师,也能理解问题是怎样被定位出来的。

数字逻辑故障证据链的完整记录结构

让波形成为可审查的证据

波形记录不能只截最终异常点。应保留足够的前后窗口,让读者看到故障是怎样产生的。例如排查状态机异常时,至少同时保留 clk、输入条件、current_state、关键控制信号和输出状态,并明确触发点。

主证据可以直接写入调试记录,例如:

text
触发条件:复位释放后第 128 个时钟周期出现状态异常
观测点:clk、rst、input_valid、current_state、done
关键现象:input_valid 在采样边沿前已稳定;current_state 未按预期离开 WAIT
候选结论:优先检查 WAIT 状态的转移条件,而非输出接口

预期结果

text
记录能够回答:何时触发、观察了什么、异常从哪里开始、当前结论依据是什么

一条证据最好只支持一个明确判断。不要在同一段波形说明中混入未经验证的推测,否则后续人员很难区分“看到的事实”和“当时的猜想”。

把事实与结论分开写

“done 没有拉高”是事实;“因为状态机没有进入 DONE”是解释;“状态机转移条件判断错误”则是更进一步的根因假设。三者应该分开记录,并标注哪些已经被实验验证。

可以采用这样的最小记录格式:

text
事实:current_state 在异常周期保持 WAIT
假设:WAIT -> DONE 的条件未满足
验证:固定输入后单独修改 valid 条件
结果:valid 满足后状态稳定进入 DONE
结论:原异常与 valid 条件直接相关

预期结果

text
事实、假设、验证、结果、结论之间能够逐项对应,没有把推测伪装成观测事实

记录修复前后差异

“修好了”不是可复用证据。修复后应使用与故障复现阶段尽可能相同的条件重新运行,并记录修改了什么、异常是否消失、原先的触发模式是否还存在。

例如修改状态转移条件后,至少保存修复前后的同一组关键测点,并注明版本或提交标识。这样后续如果问题再次出现,可以判断是回归、条件变化,还是新的故障。

最终形成的证据链应闭合到“为什么这样判断”和“如何证明已经修复”。当条件、测点、波形、实验、结论和复测结果都能相互对应时,调试成果才真正具备交接、复盘和再次定位的价值。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

记录可复用调试证据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通