FPGA 与数字 IC 设计 / 系统课时
生成 VCD 波形文件
生成 VCD 波形文件
终端输出适合核对少量结果,却很难还原信号随时间变化的过程。本课在测试平台中使用 $dumpfile 与 $dumpvars 生成 VCD 波形文件,并通过一次完整的编译、仿真和文件检查确认波形数据可用,同时说明如何限制记录范围以避免文件过度膨胀。
学习目标
- 能在测试平台中正确配置
$dumpfile与$dumpvars。 - 能编译、运行并验证 VCD 文件已经实际生成。
- 能根据层级范围、信号数量和翻转频率控制波形文件规模。
在测试平台启用 VCD
VCD 由仿真运行时写出,因此转储系统任务通常放在测试平台中。下面的主示例同时包含待测与门和测试平台,可以直接使用 Icarus Verilog 编译运行。本例只验证波形转储链路,#10 的作用是制造可观察的信号翻转间隔,不依赖特定的绝对时间单位。
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 显式指定测试平台为顶层模块。
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"预期输出
VCD info: dumpfile wave.vcd opened for output.
wave.vcd generated不同 Icarus Verilog 版本的 VCD 提示文字可能略有差异,因此更可靠的验收条件是最后的非空检查成功。生成的 wave.vcd 会包含变量定义、仿真时间戳和信号值变化,可以交给支持 VCD 的波形查看器继续分析。
控制记录范围
$dumpvars 的第一个参数控制从指定作用域向下记录的层级深度。0 是特殊值,表示递归进入所有后代作用域;1 只记录指定作用域这一层,不继续进入其子实例。大型设计若始终从测试平台顶层全量转储,文件会迅速增大,因此应优先把作用域缩小到当前正在调试的实例。

如果只关心少数信号,也可以把具体信号直接作为 $dumpvars 的参数,而不是记录整个设计层级。调试较深的某个模块时,选择该实例或关键端口通常比从顶层递归转储更有效,也能明显降低后续加载和浏览波形的成本。
控制文件规模
VCD 是文本格式,文件大小主要取决于被记录的信号数量、位宽、翻转频率和仿真持续时间。仿真时间很长但信号几乎不变化时,文件增长可能有限;大量宽总线持续高频翻转时,即使仿真时间不长,也会产生大量值变化记录。
控制 VCD 规模时,应先缩小 $dumpvars 的层级和信号集合,再减少不需要观察的仿真时间窗口。生成后至少确认文件存在且非空,并在波形查看器中检查目标信号确实被记录;否则功能仿真即使已经通过,后续波形分析仍可能因为缺少目标数据而无法继续。