在 Digital Design Studio 中首次运行 RTL 仿真

Windows 版 Digital Design Studio 中的首次 RTL 仿真。打开计数器示例,在你的电脑上运行其测试平台并读取波形。

Windows 版 Digital Design Studio:本教程使用 OSS CAD Suite 仿真器在你的电脑上运行测试平台;只有在你要求时,应用才会下载并安装这些仿真器。已发布的软件包请参阅下载。

概述

Digital Design Studio 自带一个小型示例项目:4 位计数器(rtl/counter.sv)及其测试平台(tb/counter_tb.sv)。在本教程中,你将打开示例、安装一次仿真器、按下运行并查看波形。仿真在你的电脑上运行,不会启动 Cloud 作业。

你需要:

  • 在 Windows x64 上运行的 Digital Design Studio Windows 应用。

  • Altifigence 账户是可选的:不登录也可以运行仿真器,Windows 应用也不需要设备许可证。

  • 用于从 GitHub 一次性下载约 574 MiB 的互联网连接。安装后,电脑上保留约 226 MiB。

安装并登录

  1. 从下载获取 Windows 应用,并按照Windows 安装指南中的说明进行安装。

  2. 启动 Digital Design Studio。在 Sign in to Digital Design Studio 界面中选择 Continue with Altifigence,然后在浏览器中完成登录。

  3. 如果改为选择 Continue without login,你仍然可以打开、编辑和运行示例;以后需要 Cloud 或 AI 等账户服务时再登录即可。

打开计数器示例

新用户首次在电脑上启动应用时,在登录或不登录继续之后,计数器示例会自动打开。应用会打开测试平台 tb/counter_tb.sv 和 RTL simulation 标签页。

如果这台电脑以前使用过 Digital Design Studio(例如已保存的登录、最近的项目或 Academy 项目,或已保存的窗口)、应用是为了打开特定项目而启动的,或者你登录的组织已经有 Cloud 项目,示例就不会自动打开。要自行打开:

  1. 在导航面板顶部打开环境菜单,然后选择本地。

  2. 在此电脑上的项目中选择打开示例。如果已经打开了这台电脑上的项目,请选择项目列表下方的本地返回此页面。

请先保存编辑内容,并等待正在运行的任务完成:存在未保存的工作或正在运行的任务时,应用不会切换项目。

示例是你自己的副本,只会在应用的数据文件夹中创建一次。再次打开时会保留你的更改。

文件

内容

rtl/counter.sv

带异步低电平有效复位(rst_n)的 4 位计数器。enable 为高电平时计数。

tb/counter_tb.sv

测试平台。它复位计数器,使能计数器 20 个时钟周期,检查计数是否回绕到 4,并写出 counter_tb.vcd。

README.md

示例的简短说明。

.gitignore

使存放运行结果的 .alti/ 文件夹不纳入 Git。

安装 OSS 仿真器(仅需一次)

Digital Design Studio 不捆绑仿真器。在你要求时,它会下载官方 YosysHQ OSS CAD Suite 2026-10-09 构建,用固定的 SHA-256 校验下载内容,并只安装 Icarus Verilog、Verilator 和 GTKWave 所需的文件。

  1. 在 RTL simulation 标签页中,保持选中测试平台。在安装仿真器之前,面板会显示“尚未安装 OSS CAD Suite 仿真器扩展。运行时会先安装。”

  2. 按下运行。在要安装 OSS CAD Suite 仿真器吗?中选择下载并安装。选择稍后会关闭对话框,不安装任何内容。

  3. 对话框会显示下载、SHA-256 校验和安装过程。选择取消即可停止;已下载的部分会保留,下次从中断处继续。

  4. 安装完成后,运行就会开始。

你也可以提前安装仿真器:打开插件,选择OSS CAD Suite 仿真器,然后选择安装。之后在这台电脑上的运行都使用同一份安装。

运行测试平台

  1. 检查面板:测试平台为 counter_tb · tb/counter_tb.sv,仿真器为 Icarus Verilog,波形格式为 VCD。面板会在其下方显示“2 个源文件 · top counter_tb”。

  2. 按下运行。运行时会先保存已更改的 .v、.sv、.svh 和 .vh 文件,然后以所选测试平台作为顶层模块,编译项目中所有的 .v 和 .sv 文件,但 .alti/、.altifigence/、.git/ 和 node_modules/ 下的文件除外。

  3. 运行通过时,面板会显示通过以及仿真器版本和运行时间,并在下方打开波形。

  4. 展开仿真器日志即可查看编译器和仿真器的输出。测试平台会打印 counter_tb: PASS count=4 at 260 ns。

查看结果

时钟周期为 10 ns。测试平台在时钟下降沿改变输入,计数器在上升沿计数。波形显示:

时间

信号

0–20 ns

rst_n 为低电平。使用 Icarus Verilog 时,在 5 ns 的上升沿将其复位为 0 之前,count 是未知值(x)。

20 ns

rst_n 变为高电平。

30 ns

enable 变为高电平。

35–225 ns

count 在 clk 的每个上升沿加 1,在 185 ns 从 15 回绕到 0,并在 225 ns 达到 4。

230 ns

enable 变为低电平;count 保持为 4。

260 ns

测试平台检查 count,打印 PASS 行并结束仿真。

状态行会显示运行的结束方式:

状态

含义

通过 · …

仿真器以退出代码 0 结束,且测试平台日志未报告失败。

失败(退出代码 N)· …

仿真器以非零退出代码结束,例如编译时发生错误。请在仿真器日志中阅读编译器或测试平台的消息。如果 Digital Design Studio 在仿真前拒绝了输入,日志会说明被拒绝的路径或设置;没有仿真器退出代码就表示运行并未完成。

测试平台报告失败 · …

仿真器以退出代码 0 结束,但测试平台日志报告失败。请在仿真器日志中查看失败消息。

已达时间限制而停止 · …

运行时间超过 2 分钟,即从此面板运行的上限。

已取消

你在运行期间按下了取消。

每次运行都保存在项目 .alti/sim/ 下各自的文件夹中,包含波形和 receipt.json。receipt 记录仿真器日志和版本、OSS CAD Suite 版本,以及每个源文件和被包含文件的 SHA-256。Digital Design Studio 会保留最新的 20 次运行。如果在运行期间源文件、被包含的文件或 Verilog 设置发生变化,该次运行会被标记为失败;请重新运行。

解决常见错误

现象

处理方法

示例没有自动打开

自动打开仅适用于新用户。请在此电脑上的项目(本地)中选择打开示例。

无法打开示例项目。请在“本地”中选择“打开示例”重试。

在本地中选择打开示例。示例不存在时,之后启动应用也会重试,总共最多 3 次。

没有测试平台按钮

在 Windows 应用中打开此电脑上的项目,并通过测试平台视图运行测试平台。

“未找到测试平台。…”

测试平台是没有端口、也没有被其他模块实例化的模块,例如 module counter_tb;。请保存文件并选择重新查找。

下载失败或停滞

检查连接、代理或防火墙是否允许访问 github.com、release-assets.githubusercontent.com 和 objects.githubusercontent.com,然后再次按下运行。下载会从中断处继续。

杀毒软件拦截了文件,或 Icarus Verilog 无法启动

请保留安全软件的完整消息,并核对官方下载和预期的哈希值。不要仅为了强制运行而关闭防护或添加范围过大的排除项。重试前,请让支持人员或管理员检查这次具体的检测。

可用磁盘空间不足

释放消息中显示的空间后重试。

无法选择 Verilator

Verilator 需要这台电脑上有 C++ 编译器和 make,例如在 MSYS2 UCRT64 中运行 pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make。Icarus Verilog 不需要它们也能工作。

“本次运行没有写出波形。…”

在测试平台中添加 $dumpfile("name.vcd") 和 $dumpvars。文件名不要带文件夹:只会打开写在该次运行自身文件夹中的波形。

波形大于 32 MiB

缩小 $dumpvars 的范围,或缩短运行时间。

包含文件和宏

  • 请将被包含的 .svh 和 .vh 头文件放在项目内。RTL 编译、Icarus Verilog 和 Verilator 会先搜索项目根目录,然后按保存的顺序搜索包含路径,再按名称顺序搜索发现的源文件夹。如果包含它的文件旁边有另一个内容不同的头文件,问题和仿真器日志会指出两个路径以及实际使用的头文件。

  • 如果仿真器日志显示找不到被包含的文件,请将其文件夹以相对于项目根目录的路径添加到项目(Flow Navigator → 项目管理器 → 设置 → 项目 → 包含路径)中的包含路径,然后再次按下运行。宏请在 项目 → 宏定义中输入,每行一个 NAME 或 NAME=VALUE。

  • 包含项目外部的文件会导致运行在仿真开始前失败。此时仿真器日志会显示“… is outside the project: copy it into the project and include it from there”。

  • 如果包含路径中的条目指向项目外部或包含 ..,或者宏定义中有无效的宏名称,运行会停止,并显示指出该条目的消息。请更正或删除它。列表中不存在的文件夹会被跳过,并在仿真器日志中显示警告。

  • 更改后的设置从下一次运行开始生效。编辑器诊断会在重新打开项目后使用它们。

后续步骤

  • 修改测试平台,例如使能的时钟周期数和预期计数,然后再次按下运行。运行时会先保存你的编辑。

  • 安装 C++ 编译器和 make,在仿真器中选择 Verilator,并将结果与 Icarus Verilog 进行比较。

  • 运行你自己的设计:在此电脑上的项目中选择打开项目文件夹或新建项目。添加你的 .v 和 .sv 源文件,以及用 $dumpfile 和 $dumpvars 写出波形的测试平台。然后通过 Flow Navigator → 仿真 → 运行仿真 → 打开仿真设置 打开 RTL simulation 标签页。如果尚未登录,运行仿真会直接打开该标签页。

  • 编辑和保存项目请参阅工作区;Verilog 文件请参阅 Verilog。

与本地仿真分开适用的平台差异,以及公司 AI、存储和账户条件,请参阅支持指南。

环境支持