本节中描述了完整的 AI 引擎仿真器 (aiesimulator
) 选项集合。在大部分情况下,只需指向 pkg-dir 即足矣。
选项 | 描述 |
---|---|
-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 工具,如下所示: 可用选项包括:
如需了解有关使用 XPE 文件的信息,请参阅
电源设计管理器用户指南(UG1556)。
注释:
--online 选项与 --dump-vcd 选项不得搭配一起使用。如果同时指定这两个选项,只有 --online 选项会生效。 |
--options-file=<file>
|
用于选择并生成指定 VCD 数据的文本文件。例如,aiesimulator
--options-file=<options>.txt --dump-vcd 。<options.txt> 文件将指定模块,此模块中的数据需作为 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
|
将该选项与 例如, 提示:
--online 选项与 --dump-vcd 选项不得搭配一起使用。如果同时指定这两个选项,AI 引擎仿真器将发出错误。 |
--output-time-stamp
|
使用 --output-time-stamp=no 可获取无时间值的输出文件,使用 --output-time-stamp 可获取输出文件中的统一时间值(以 ns 为单位)。 |
图 1. AI 引擎仿真器显示运行示例