FPGA 与数字 IC 设计 / 系统课时
组织波形记录与重复回归
组织波形记录与重复回归
一次能跑通的 Testbench 还不等于可回归的验证环境。本节把 VCD 范围、仿真超时、明确结束条件和批量运行入口固定下来,让同一组小测试可以重复执行、自动判定并保留可定位问题的波形与日志。
学习目标
- 限制 VCD 记录范围,避免无关层级让波形文件快速膨胀。
- 为每次仿真设置成功、失败和超时三个明确出口。
- 用统一脚本连续运行多个测试用例并归档日志与波形。
回归需要固定的四个边界
小型回归最容易失控的地方不是断言本身,而是运行边界不一致。应固定四件事:每次从同一个编译产物启动、只记录需要排查的层级、无论成功失败都能结束、每个用例都留下独立日志和波形文件。
波形不是“越多越好”。$dumpvars(0, dut) 会记录 dut 实例及其下层级,而不会把整个 Testbench 的辅助对象全部纳入;大型设计还可以继续缩小到具体子模块。回归判定也不应依赖人工打开波形,而应由 PASS、FAIL 和超时条件直接给出机器可读结果。

主示例:为每次运行建立明确出口
下面的 tb_regression.v 同时包含一个 4 位计数器和完整 Testbench。用 +CASE=<ID> 选择需要运行的周期数;$dumpvars(0, dut) 只记录 DUT 层级;独立 watchdog 在 200 ns 时强制结束没有正常收敛的仿真。
`timescale 1ns/1ps
module counter (
input wire clk,
input wire rst_n,
output reg [3:0] count
);
always @(posedge clk or negedge rst_n) begin
if (!rst_n)
count <= 4'd0;
else
count <= count + 1'b1;
end
endmodule
module tb_regression;
reg clk;
reg rst_n;
wire [3:0] count;
integer case_id;
integer cycles;
reg [3:0] expected;
counter dut (.clk(clk), .rst_n(rst_n), .count(count));
initial begin
clk = 1'b0;
forever #5 clk = ~clk;
end
initial begin : watchdog
#200;
$display("FAIL case=%0d reason=simulation-timeout", case_id);
$finish;
end
initial begin
rst_n = 1'b1;
if (!$value$plusargs("CASE=%d", case_id))
case_id = 0;
case (case_id)
0: begin cycles = 3; expected = 4'd3; end
1: begin cycles = 5; expected = 4'd5; end
2: begin cycles = 7; expected = 4'd7; end
default: begin
$display("FAIL case=%0d reason=unknown-case", case_id);
$finish;
end
endcase
$dumpfile("wave.vcd");
$dumpvars(0, dut); // 只记录 DUT 层级,避免无关 Testbench 信号膨胀文件
#1 rst_n = 1'b0;
#2 rst_n = 1'b1;
repeat (cycles) @(posedge clk);
#1; // 等待最后一次 NBA 更新完成
if (count !== expected)
$display("FAIL case=%0d cycles=%0d count=%0d", case_id, cycles, count);
else
$display("PASS case=%0d cycles=%0d count=%0d", case_id, cycles, count);
$finish;
end
endmodule真正的可执行入口使用一个脚本统一编译并连续运行三个 case。脚本会为每次运行保存独立日志,并把固定名称的 wave.vcd 重命名后归档。
#!/usr/bin/env bash
set -euo pipefail
rm -rf build
mkdir -p build/waves
iverilog -g2012 -o build/simv tb_regression.v
for case_id in 0 1 2; do
log="build/case-${case_id}.log"
vvp build/simv +CASE=${case_id} | tee "${log}"
mv wave.vcd "build/waves/case-${case_id}.vcd"
if grep -q '^FAIL' "${log}"; then
echo "REGRESSION FAIL case=${case_id}"
exit 1
fi
done
echo "REGRESSION PASS"预期输出:
PASS case=0 cycles=3 count=3
PASS case=1 cycles=5 count=5
PASS case=2 cycles=7 count=7
REGRESSION PASS不同模拟器可能额外打印 VCD 文件已打开之类的提示,但关键判定行应与上面一致。运行后还应得到 build/case-0.log 到 build/case-2.log,以及 build/waves/case-0.vcd 到 build/waves/case-2.vcd。
让失败具有可机器判断的形态
回归环境不应依赖 $stop 等等待人工交互的动作。正常路径和失败路径都应最终 $finish,并在退出前输出稳定的 PASS 或 FAIL 前缀;外层脚本再根据日志决定是否继续。这样即使模拟器本身没有按测试失败返回非零退出码,回归脚本仍能可靠中止。
Testbench 内的 200 ns watchdog 解决“测试忘记结束”或等待条件永远不满足的问题。若工程还可能出现零延迟死循环,仿真时间不会继续前进,内部 watchdog 也无法触发,此时应在 CI 外层再加进程级墙钟超时,作为第二道保护。
控制波形成本而不是依赖波形判定
VCD 应服务于失败定位,而不是承担通过与否的判断。优先缩小 $dumpvars 的实例范围;只在确有必要时记录大层级。对于很长的仿真,还可以在怀疑的时间窗口使用 $dumpon 和 $dumpoff 控制记录区间,避免把稳定阶段全部写入文件。
重复回归时,真正需要稳定的是测试输入、结束条件、日志格式和归档路径,而不是 VCD 文件字节级完全相同。只要每个 case 都能从干净目录启动、自动结束并留下对应证据,这套流程就可以继续扩展到更多用例或 CI 环境。