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

自动比较实际值与期望值

自动比较实际值与期望值

自检仿真的关键不是“看波形再判断”,而是让 testbench 在每组激励后自动得到期望值、采样 DUT 实际值并累计错误。这样一次仿真就能直接给出 PASS 或 FAIL,既减少人工判断,也便于回归测试和批量验证。

学习目标

  • 使用 expected 与 actual 自动判断测试向量是否通过
  • 用错误计数器汇总多个用例的失败数量
  • 正确处理 X、Z 等未知态,输出明确的 PASS/FAIL 结果

建立可复用的自检判断

下面用一个 4 位加法器演示完整流程。DUT 输出 5 位结果,testbench 通过 check_vector 任务统一施加输入、等待组合逻辑稳定、保存期望值和实际值,再完成比较。这样可以避免为每组向量重复编写相同的判断代码。

!== 是 case inequality(四态不等)运算符。与 != 不同,只要普通相等比较中存在无法确定的 X 或 Z,!= 的结果就可能是 X;而 !== 会把 0、1、X、Z 都作为可区分的四态符号比较,并始终返回确定的 0 或 1。因此在自检 testbench 中,!== 更适合把未知态明确判为失败。

verilog
`timescale 1ns/1ps

module adder4 (
    input  wire [3:0] a,
    input  wire [3:0] b,
    output wire [4:0] sum
);
    assign sum = a + b;
endmodule

module tb_adder4;
    reg  [3:0] a;
    reg  [3:0] b;
    wire [4:0] sum;

    reg  [4:0] expected;
    reg  [4:0] actual;
    integer errors;

    adder4 dut (
        .a(a),
        .b(b),
        .sum(sum)
    );

    task automatic check_vector;
        input [3:0] ta;
        input [3:0] tb;
        input [4:0] exp;
        begin
            a = ta;
            b = tb;
            #1;  // 仅用于把组合逻辑激励与检查时刻明确分开
            expected = exp;
            actual = sum;

            if (actual !== expected) begin
                errors = errors + 1;
                $display("ERROR: a=%0d b=%0d expected=%0d actual=%0d",
                         a, b, expected, actual);
            end
        end
    endtask

    initial begin
        errors = 0;

        check_vector(4'd3,  4'd5, 5'd8);
        check_vector(4'd15, 4'd1, 5'd16);

        if (errors == 0)
            $display("PASS: all tests passed");
        else
            $display("FAIL: %0d test(s) failed", errors);

        $finish;
    end
endmodule

预期输出

text
PASS: all tests passed

在当前 timescale 1ns/1ps 下,#1 会把仿真时间推进 1 ns。这里它只是让组合逻辑的激励与检查时刻清晰分开,并不表示真实硬件具有 1 ns 延迟。若 DUT 是时序逻辑,应等待有效时钟边沿、握手完成或其他协议条件后再检查,而不是随意加入固定延迟。

让失败信息可以定位

自检不能只输出“失败”。失败日志至少应包含输入、期望值和实际值,这样无需重新打开波形,也能先定位是哪组向量出现偏差。错误计数器则负责把所有失败累计起来,使一次仿真可以继续执行后续向量,而不是在第一个错误出现时立即结束。

对于总线或状态字段,可以按需要使用 %h 等格式显示。若检查有符号数据,还要保证 testbench 与 DUT 的位宽和 signed 声明一致,否则符号扩展规则不同也可能造成比较结果与预期不一致。

判定整组测试是否通过

稳定的自检通常分成两层:每个测试向量完成一次比较并累计 errors,全部向量结束后再根据 errors 做总判定。只有 errors == 0 才输出 PASS,否则输出 FAIL 和失败数量。

在自动化回归中,还可以让外部脚本解析 PASS/FAIL 日志,或使用仿真器支持的退出状态进行进一步处理。无论采用哪种方式,期望值都应来自规格、测试向量或独立参考模型,而不能直接复制 DUT 的实现逻辑,否则 DUT 与 testbench 可能犯同一个错误并被误判为通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

自动比较实际值与期望值

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

登录哪都通