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。

先更新软件包索引并安装工具:

bash
sudo apt update
sudo apt install -y verilator gtkwave build-essential

预期结果:安装命令以退出码 0 正常结束。使用下面的命令检查安装状态:

bash
verilator --version
make --version | head -n 1
g++ --version | head -n 1
command -v gtkwave

预期输出示例:

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

先创建独立工作目录:

bash
mkdir -p ~/rtl-lab
cd ~/rtl-lab

预期结果:当前工作目录为 ~/rtl-lab,后续源文件、波形和编译结果都放在这里。

创建 tb.sv,包含设计模块 xor_gate 和测试顶层 tb。测试平台负责改变输入、打印结果并产生波形。

systemverilog
`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 错误带入编译阶段:

bash
verilator --lint-only --timing --top-module tb tb.sv

预期结果:命令退出码为 0,且没有错误信息。--lint-only 只检查,不生成可执行仿真程序;--timing 启用测试平台中的延迟等时序控制。

接下来生成仿真可执行文件:

bash
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++ 测试平台,不能不加区别地照搬到这个示例。

执行刚才生成的程序:

bash
./obj_dir/Vtb

预期输出中的关键三行是:

text
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 波形

完成仿真后,在工作目录检查文件:

bash
ls -lh wave.vcd

预期结果:显示一个非空的 wave.vcd 文件。文件大小和修改时间取决于实际运行环境。

打开波形查看器:

bash
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。重新执行编译命令,再运行程序,才能验证修改后的行为。

最后可以执行一次完整回归:

bash
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 模块时,可以沿用同一套工具链。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 Verilator 仿真环境

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

登录哪都通