仿真器选项 - 2023.2 简体中文

AI 引擎工具和流程用户指南 (UG1076)

Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 简体中文

本节中描述了完整的 AI 引擎仿真器 (aiesimulator) 选项集合。在大部分情况下,只需指向 pkg-dir 即足矣。

表 1. AI 引擎仿真器选项
选项 描述
-h--help 显示如下帮助消息并退出。
--display-run-interval=<time in ns> 在每个时间(以 ns 为单位)节拍后定期显示时间戳。例如,aiesimulator --display-run-interval=10 --pkg-dir=./Work --i=.. 将每隔 10ns 显示一次时间戳,如 图 1 所示。
--dump-vcd=<file> 将 VCD 波形信息转储到 <file> 中。由于该工具会将 .vcd 追加到指定文件名后,因此无需包含文件后缀。
注释: 该选项允许您访问一部分信号。如果要访问所有信号或者另一部分信号,应使用 --options-file 选项指定要在 VCD 文件内生成的信号的类别。
注释: 要从 aiesimulator 生成的 .vcd 文件生成 XPE 文件,请使用 vcdanalyze 工具,如下所示:
vcdanalyze --vcd <vcdfile> --xpe [OPTIONS]
可用选项包括:
  • -s=<STARTTIME>:指定开始时间(可选)。
  • -e=<ENDTIME>:指定结束时间(可选)。
  • --out=<RPT>:以“.rpt”格式生成工作负载估算报告。
  • -v:生成详细输出(可选)。
  • --xpe:生成功耗估算报告。
  • --xpe-dir=<XPEOutputDir>:指定用于生成 XPE 报告的目录。默认值为 ./aiesim_xpe
如需了解有关使用 XPE 文件的信息,请参阅 电源设计管理器用户指南(UG1556)
注释: --online 选项与 --dump-vcd 选项不得搭配一起使用。如果同时指定这两个选项,只有 --online 选项会生效。
--options-file=<file> 用于选择并生成指定 VCD 数据的文本文件。例如,aiesimulator --options-file=<options>.txt --dump-vcd<options.txt> 文件将指定模块,此模块中的数据需作为 VCD 数据来生成。

此开关应搭配 --dump-vcd 开关一起用于生成 VCD。

--enable-memory-check 启用运行时程序和数据存储器边界访问检查。任何违例访问都将以 [ERROR] 消息方式来报告。默认禁用该选项。如果您在启用该选项的情况下运行仿真,并在 Vitis IDE 中打开运行汇总,那么计算图视图会显示Memory Violations(存储器违例)选项卡。该选项卡会报告仿真运行期间检测到的所有存储器违例。您可单击特定违例,并导航到源代码中导致此违例的行。如需了解更多信息,请参阅 存储器违例
--hang-detect-time=<time in ns> 如果在该选项所指定的时间段(以 ns 为单位)过后,所有活动的核都处于停滞状态,则 aiesimulator 将退出。例如,如果向 aiesimulator 提供 --hang-detect-time=10 选项,且经过 10 ns 后所有活动的核都处于停滞状态,那么 aiesimulator 将退出。
注释:AI 引擎机器学习器件中不支持此选项。
-i --input-dir=<dir> 选项的别名。
-o --output-dir=<dir> 选项的别名。
--pkg-dir=<dir> 指定封装目录,例如,./Work
--profile 为所有已用的核生成剖析数据。允许在 stdout 上生成 printf 追踪消息,并在仿真期间收集剖析统计数据。这可能稍许减缓仿真器速度。
(可选)可使用 --profile=(col,row)(col,row)... 指定对特定核进行剖析
注释: 该选项在 AI 引擎 ML 的 hw_emu 中尚不可用
--simulation-cycle-timeout=<cycles> 应用完成加载后,运行指定的周期数。
提示: 指定 --simulation-cycle-timeout 选项即可在指定周期数后终止仿真会话。但在调试进程期间指定仿真超时时,请务必指定更大的周期数,因为达到超时周期后,调试将终止。
--online -text -wdb

将该选项与 -text-wdb 搭配使用,以即时解析 VCD 数据,这样即可生成 event.txt 文件和波形数据库 (WDB) 输出文件。

例如,aiesimulator --pkg-dir=./Work --i=.. --online -text -wdb 将生成 WDB 文件和事件文本文件,这些文件可在 Vitis IDE 中打开。

提示: --online 选项与 --dump-vcd 选项不得搭配一起使用。如果同时指定这两个选项,AI 引擎仿真器将发出错误。
--output-time-stamp 使用 --output-time-stamp=no 可获取无时间值的输出文件,使用 --output-time-stamp 可获取输出文件中的统一时间值(以 ns 为单位)。
图 1. AI 引擎仿真器显示运行示例