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 时强制结束没有正常收敛的仿真。

verilog
`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 重命名后归档。

bash
#!/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"

预期输出:

text
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 环境。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织波形记录与重复回归

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

登录哪都通