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

生成 VCD 波形文件

生成 VCD 波形文件

终端输出适合核对少量结果,却很难还原信号随时间变化的过程。本课在测试平台中使用 $dumpfile 与 $dumpvars 生成 VCD 波形文件,并通过一次完整的编译、仿真和文件检查确认波形数据可用,同时说明如何限制记录范围以避免文件过度膨胀。

学习目标

  • 能在测试平台中正确配置 $dumpfile 与 $dumpvars。
  • 能编译、运行并验证 VCD 文件已经实际生成。
  • 能根据层级范围、信号数量和翻转频率控制波形文件规模。

在测试平台启用 VCD

VCD 由仿真运行时写出,因此转储系统任务通常放在测试平台中。下面的主示例同时包含待测与门和测试平台,可以直接使用 Icarus Verilog 编译运行。本例只验证波形转储链路,#10 的作用是制造可观察的信号翻转间隔,不依赖特定的绝对时间单位。

verilog
module and_gate (
    input  wire a,
    input  wire b,
    output wire y
);
    assign y = a & b;
endmodule

module tb_vcd;
    reg a;
    reg b;
    wire y;

    and_gate dut (
        .a(a),
        .b(b),
        .y(y)
    );

    initial begin
        // 先指定输出文件,再声明需要转储的作用域。
        $dumpfile("wave.vcd");
        $dumpvars(0, tb_vcd);

        a = 0; b = 0;
        #10 a = 0; b = 1;
        #10 a = 1; b = 0;
        #10 a = 1; b = 1;

        // 保留最后一个状态一段时间后结束仿真。
        #10 $finish;
    end
endmodule

$dumpfile("wave.vcd") 指定输出文件名;$dumpvars(0, tb_vcd) 从 tb_vcd 作用域开始递归记录其下可转储的信号。这里只声明转储范围还不够,必须真正运行仿真,VCD 文件才会被创建并写入时间戳和值变化。

编译运行并验证文件

将上面的源码保存为 vcd_demo.v。下面把清理旧文件、编译、仿真和非空检查合并为一次验证,避免旧的 wave.vcd 让检查产生误判;-s tb_vcd 显式指定测试平台为顶层模块。

bash
rm -f wave.vcd vcd_sim
iverilog -g2012 -s tb_vcd -o vcd_sim vcd_demo.v
vvp vcd_sim
test -s wave.vcd && echo "wave.vcd generated"

预期输出

text
VCD info: dumpfile wave.vcd opened for output.
wave.vcd generated

不同 Icarus Verilog 版本的 VCD 提示文字可能略有差异,因此更可靠的验收条件是最后的非空检查成功。生成的 wave.vcd 会包含变量定义、仿真时间戳和信号值变化,可以交给支持 VCD 的波形查看器继续分析。

控制记录范围

$dumpvars 的第一个参数控制从指定作用域向下记录的层级深度。0 是特殊值,表示递归进入所有后代作用域;1 只记录指定作用域这一层,不继续进入其子实例。大型设计若始终从测试平台顶层全量转储,文件会迅速增大,因此应优先把作用域缩小到当前正在调试的实例。

VCD 记录范围与层级关系

如果只关心少数信号,也可以把具体信号直接作为 $dumpvars 的参数,而不是记录整个设计层级。调试较深的某个模块时,选择该实例或关键端口通常比从顶层递归转储更有效,也能明显降低后续加载和浏览波形的成本。

控制文件规模

VCD 是文本格式,文件大小主要取决于被记录的信号数量、位宽、翻转频率和仿真持续时间。仿真时间很长但信号几乎不变化时,文件增长可能有限;大量宽总线持续高频翻转时,即使仿真时间不长,也会产生大量值变化记录。

控制 VCD 规模时,应先缩小 $dumpvars 的层级和信号集合,再减少不需要观察的仿真时间窗口。生成后至少确认文件存在且非空,并在波形查看器中检查目标信号确实被记录;否则功能仿真即使已经通过,后续波形分析仍可能因为缺少目标数据而无法继续。

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

目录与阅读设置

阅读设置

17

记录一个想法

生成 VCD 波形文件

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

登录哪都通