FPGA 与数字 IC 设计 / 系统课时
配置 Verilator 仿真环境
配置 Verilator 仿真环境
本篇在 Ubuntu 环境中安装 Verilator 和 GTKWave,并用一个异或门测试平台跑通 RTL 编译、仿真执行与波形查看。完成后,你将得到可重复使用的命令组合,并能通过控制台结果和 VCD 波形确认仿真环境正常工作。
学习目标
- 安装 Verilator、C++ 编译工具链和 GTKWave,验证工具可用。
- 编写最小 SystemVerilog 测试平台,完成编译和仿真。
- 生成并查看 VCD 波形,定位常见环境问题。
安装编译与波形工具
以下操作以 Ubuntu 24.04 LTS 为例,适用于具有 sudo 权限的本地系统或 WSL2 Ubuntu。Verilator 使用 C++ 编译生成仿真程序,因此除了 Verilator,还需要 C++ 编译器和 GNU Make。
先更新软件包索引并安装工具:
sudo apt update
sudo apt install -y verilator gtkwave build-essential预期结果:安装命令以退出码 0 正常结束。使用下面的命令检查安装状态:
verilator --version
make --version | head -n 1
g++ --version | head -n 1
command -v gtkwave预期输出示例:
Verilator 5.006 2023-01-22 rev (Debian 5.006-3)
GNU Make 4.3
g++ (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
/usr/bin/gtkwave以上版本号仅为示例,不要求逐字相同。具体版本由 Ubuntu 软件仓库决定;关键是 Verilator 为支持 --binary 的 5.x 版本,并且编译器、Make 和 GTKWave 都能找到。
如果需要更新的 Verilator 版本,可参考官方安装文档从源码编译,不建议直接把不同发行版的软件包混装。
创建最小 RTL 仿真项目
使用一个两输入异或门验证环境。异或运算的规则是:两个输入不同,输出为 1;两个输入相同,输出为 0。
先创建独立工作目录:
mkdir -p ~/rtl-lab
cd ~/rtl-lab预期结果:当前工作目录为 ~/rtl-lab,后续源文件、波形和编译结果都放在这里。
创建 tb.sv,包含设计模块 xor_gate 和测试顶层 tb。测试平台负责改变输入、打印结果并产生波形。
`timescale 1ns/1ps
module xor_gate (
input logic a,
input logic b,
output logic y
);
assign y = a ^ b;
endmodule
module tb;
logic a, b, y;
xor_gate dut (.a(a), .b(b), .y(y));
initial begin
// 从仿真开始记录测试顶层及其子模块信号
$dumpfile("wave.vcd");
$dumpvars(0, tb);
a = 0; b = 0;
#5;
$display("t=%0t a=%0b b=%0b y=%0b", $time, a, b, y);
a = 1;
#5;
$display("t=%0t a=%0b b=%0b y=%0b", $time, a, b, y);
b = 1;
#5;
$display("t=%0t a=%0b b=%0b y=%0b", $time, a, b, y);
$finish;
end
endmodule其中 #5 表示延迟 5 ns,$display 将输入输出打印到控制台,$dumpfile 指定波形文件名称,$dumpvars(0, tb) 请求记录测试顶层及其下级模块信号。
xor_gate 是待验证设计,tb 是仿真测试平台。两者放在同一文件只是为了减少初次配置成本,正式项目可以分别放入 rtl/ 和 tb/ 目录。
编译并执行 Verilator 仿真
先进行语法与静态检查,避免将明显的 RTL 错误带入编译阶段:
verilator --lint-only --timing --top-module tb tb.sv预期结果:命令退出码为 0,且没有错误信息。--lint-only 只检查,不生成可执行仿真程序;--timing 启用测试平台中的延迟等时序控制。
接下来生成仿真可执行文件:
verilator --binary --trace-vcd --top-module tb tb.sv预期结果:Verilator 调用 C++ 工具链完成编译,在 obj_dir 中生成可执行文件 Vtb,并以退出码 0 结束。构建日志的编译器路径、命令和耗时会随系统不同而变化。
关键参数含义如下:
| 参数 | 作用 |
|---|---|
--binary |
生成、编译独立仿真程序,并启用 timing 支持 |
--trace-vcd |
编译 VCD 波形追踪功能 |
--top-module tb |
明确选择测试顶层,避免误选设计模块 |
这里采用 Verilator 5.x 的直接仿真方式,不必额外编写 C++ 仿真入口。旧教程中的 --cc --exe 常用于自定义 C++ 测试平台,不能不加区别地照搬到这个示例。
执行刚才生成的程序:
./obj_dir/Vtb预期输出中的关键三行是:
t=5 a=0 b=0 y=0
t=10 a=1 b=0 y=1
t=15 a=1 b=1 y=0除此之外,还可能出现 $finish 对应的源文件位置和 Verilator 运行统计信息。只要三组结果依次为 0、1、0,并且程序正常退出,就说明组合逻辑与测试激励按预期执行。
如果命令提示找不到 Vtb,先确认编译命令成功执行,再检查 obj_dir 中是否存在可执行文件。不要把 xor_gate 误写为 --top-module 的值,否则测试平台不会作为入口运行。
用 GTKWave 检查 VCD 波形
完成仿真后,在工作目录检查文件:
ls -lh wave.vcd预期结果:显示一个非空的 wave.vcd 文件。文件大小和修改时间取决于实际运行环境。
打开波形查看器:
gtkwave wave.vcd预期结果:GTKWave 打开波形窗口,能够加载 wave.vcd。在信号层级中选择 tb,将 a、b 和 y 添加到波形显示区域。
可以直接在时间轴上检查三个区间:
| 仿真时间 | a | b | y |
|---|---|---|---|
| 0~5 ns | 0 | 0 | 0 |
| 5~10 ns | 1 | 0 | 1 |
| 10~15 ns | 1 | 1 | 0 |
时间轴上的输入变化应当位于 5 ns 和 10 ns 附近,y 随输入改变,在组合逻辑稳定后等于 a ^ b。点击信号并放大时间范围,可以核对每次变化的位置。
如果只看到空白窗口,先确认已经将信号添加到波形区域,并使用缩放到完整时间范围的功能。若 VCD 中没有有效信号,则检查测试平台的 $dumpfile、$dumpvars 以及编译时是否启用了 --trace-vcd。
处理安装和执行中的典型问题
遇到失败时按安装、编译、执行、波形四个阶段定位,不必反复重装全部软件。
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
verilator: command not found |
未安装或 PATH 不正确 | 重新检查 apt 安装结果及 command -v verilator |
g++: command not found |
缺少 C++ 编译器 | 安装 build-essential |
Unknown option: --binary |
Verilator 版本过旧 | 检查版本并升级到支持该参数的 5.x 版本 |
NEEDTIMINGOPT |
使用了延迟但未选择时序模式 | 使用 --timing 或 --binary |
找不到 wave.vcd |
没有实际运行仿真或未启用波形记录 | 检查编译参数、dump 语句和当前目录 |
| GTKWave 无法打开显示窗口 | 无可用图形显示服务 | 配置 WSLg、桌面环境或在本机查看 VCD |
修改 tb.sv 后需要重新编译,旧的 obj_dir/Vtb 不会自动使用更新的 RTL。重新执行编译命令,再运行程序,才能验证修改后的行为。
最后可以执行一次完整回归:
cd ~/rtl-lab
verilator --lint-only --timing --top-module tb tb.sv
verilator --binary --trace-vcd --top-module tb tb.sv
./obj_dir/Vtb
ls -lh wave.vcd预期结果:静态检查和编译正常结束,仿真输出依次为 0、1、0,并生成非空的 wave.vcd。至此,RTL 源码检查、编译执行和波形验证三条路径均已打通,后续替换为寄存器、计数器或 CPU 模块时,可以沿用同一套工具链。