Skip to content

运行仿真

仿真在 Subaya 的后端运行。你从 CLI 提交一个测试平台和一个顶层模块,等待结果,然后阅读报告、 日志和波形。本指南用 suya sim 走完整个循环。

suya sim run 可以用 --tool 面向以下任一仿真器:

工具 备注
ryusim RyuSim,Subaya 的 SystemVerilog 仿真器
verilator Verilator
icarus Icarus Verilog
questa Questa
xsim Vivado xsim
renode Renode(嵌入式)

最低限度地,把 suya sim run 指向你的测试平台并命名顶层模块:

Terminal window
suya sim run --tb <path-to-testbench> --top <top-module>

项目默认取自 .subaya/config.toml;传入 --project <project-id> 即可覆盖。有用的选项:

Terminal window
suya sim run \
--tb tb/top_tb.sv \
--top top_tb \
--source rtl/ \
--tool verilator \
--tier S \
--wait \
--no-cache
  • --source <dir> — 要与测试平台一起包含的源代码目录。
  • --tool <name> — 选择一个仿真器(见上表)。
  • --tier <S> — 为本次运行请求一个计算级别。
  • --wait — 阻塞直到运行结束,而非立即返回。
  • --no-cache — 强制一次全新运行,忽略缓存的结果。
  • --arg <a> — 向工具透传一个额外参数(可重复)。

列出你最近的运行以找到一个运行 id:

Terminal window
suya sim list

获取一次运行的状态和结果摘要:

Terminal window
suya sim report <run-id>

跟踪日志,可选地实时跟随它们:

Terminal window
suya sim logs <run-id>
suya sim logs <run-id> --follow

将相同的源代码和规格作为一次全新运行重新提交:

Terminal window
suya sim rerun <run-id> --wait

定位一次运行产生的波形产物:

Terminal window
suya sim wave <run-id>

这会把你指向波形,你可以用 wf 波形 CLI 来分析它——Subaya 基于 WAL 的波形分析工具。