FPGA 与数字 IC 设计 / 系统课时
安装并验证仿真工具链
安装并验证仿真工具链
本课完成一套最小可用的 Verilog 仿真环境:安装 Icarus Verilog 与 GTKWave,确认版本可调用,再编译并运行一个会生成 VCD 波形的最小设计。完成后,你应能同时证明“仿真器可执行”和“波形查看器可打开”。
学习目标
- 安装并检查 Icarus Verilog 12 系列与 GTKWave 3.x。
- 用
iverilog和vvp完成一次最小编译与仿真。 - 生成 VCD 文件,并确认 GTKWave 能加载该波形。
安装并检查版本
下面以 Ubuntu/Debian 环境为例。系统仓库中的具体小版本取决于发行版;如果课程环境要求固定在 Icarus Verilog 12.x 与 GTKWave 3.x,应先检查实际版本,再决定是否需要改用对应软件源或官方发布包。
sudo apt update
sudo apt install -y iverilog gtkwave
iverilog -V 2>&1 | head -n 1
gtkwave --version 2>&1 | head -n 1预期输出
Icarus Verilog version 12.<VALUE>
GTKWave Analyzer v3.<VALUE><VALUE> 代表实际小版本、构建信息或补丁号,机器之间可能不同。若主版本不是课程要求的 12 与 3,应先统一工具版本,再继续后续实验,避免语法支持或界面行为差异干扰结果。
运行最小仿真
建立一个临时目录,并写入能产生时钟信号和 VCD 文件的最小模块。这里使用 -g2012 明确启用 IEEE 1800-2012 语言模式,后续即使使用部分 SystemVerilog 语法,也不会因默认语言版本不同而产生意外解析差异。
mkdir -p logic-sim-check
cd logic-sim-check
cat > smoke_test.v <<'EOF'
`timescale 1ns/1ps
module smoke_test;
reg clk = 1'b0;
always #5 clk = ~clk;
initial begin
// 记录本模块中的信号,供 GTKWave 读取。
$dumpfile("smoke_test.vcd");
$dumpvars(0, smoke_test);
#20;
$display("simulation-ok");
$finish;
end
endmodule
EOF
iverilog -g2012 -o smoke_test.out smoke_test.v
vvp smoke_test.out预期输出
VCD info: dumpfile smoke_test.vcd opened for output.
simulation-ok第一行由 Icarus Verilog 的 VCD 输出机制产生,第二行来自测试代码中的 $display。如果编译阶段没有生成 smoke_test.out,应先处理语法、文件路径或命令错误,不要直接跳到 GTKWave。
验证波形文件
仿真结束后,先用命令确认 VCD 文件确实存在且非空,再启动 GTKWave。这样可以把“仿真没有生成波形”和“GTKWave 无法打开图形界面”分成两个独立问题排查。
test -s smoke_test.vcd && echo "vcd-ok"
gtkwave smoke_test.vcd预期结果
vcd-ok随后应打开 GTKWave 图形窗口,并能在层级中找到 smoke_test 与信号 clk。将 clk 加入波形区后,可以看到它每 5 ns 翻转一次。GTKWave 启动时可能额外打印与平台或构建版本有关的信息,不影响上述验收。若服务器没有桌面环境或 X/Wayland 转发,vcd-ok 仍能证明仿真与 VCD 生成链路正常,但图形界面需要在具备桌面环境的机器上验证。
处理最常见的失败
出现 iverilog: command not found 或 gtkwave: command not found,通常是安装未成功或可执行文件不在 PATH;可先运行 command -v iverilog 与 command -v gtkwave 确认路径。出现编译错误时,应优先检查源文件名、工作目录和语言模式,而不是重装 GTKWave。
如果 vvp 能输出 simulation-ok,但没有生成 VCD,重点检查 $dumpfile、$dumpvars 是否位于会执行的 initial 块中。工具链的验收标准很明确:版本可查询、仿真可运行、VCD 文件非空,并且 GTKWave 能加载该波形。