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,应先检查实际版本,再决定是否需要改用对应软件源或官方发布包。

bash
sudo apt update
sudo apt install -y iverilog gtkwave
iverilog -V 2>&1 | head -n 1
gtkwave --version 2>&1 | head -n 1

预期输出

text
Icarus Verilog version 12.<VALUE>
GTKWave Analyzer v3.<VALUE>

<VALUE> 代表实际小版本、构建信息或补丁号,机器之间可能不同。若主版本不是课程要求的 12 与 3,应先统一工具版本,再继续后续实验,避免语法支持或界面行为差异干扰结果。

运行最小仿真

建立一个临时目录,并写入能产生时钟信号和 VCD 文件的最小模块。这里使用 -g2012 明确启用 IEEE 1800-2012 语言模式,后续即使使用部分 SystemVerilog 语法,也不会因默认语言版本不同而产生意外解析差异。

bash
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

预期输出

text
VCD info: dumpfile smoke_test.vcd opened for output.
simulation-ok

第一行由 Icarus Verilog 的 VCD 输出机制产生,第二行来自测试代码中的 $display。如果编译阶段没有生成 smoke_test.out,应先处理语法、文件路径或命令错误,不要直接跳到 GTKWave。

验证波形文件

仿真结束后,先用命令确认 VCD 文件确实存在且非空,再启动 GTKWave。这样可以把“仿真没有生成波形”和“GTKWave 无法打开图形界面”分成两个独立问题排查。

bash
test -s smoke_test.vcd && echo "vcd-ok"
gtkwave smoke_test.vcd

预期结果

text
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 能加载该波形。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装并验证仿真工具链

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

登录哪都通