本节中描述了完整的 AI 引擎仿真器 (aiesimulator) 选项集合。在大部分情况下，只需指向 pkg-dir 即足矣。
| 选项 | 描述 |
|---|---|
-h 和 --help
|
显示如下帮助消息并退出。 |
--display-run-interval=<time in
ns>
|
每次该选项所指定的时间耗尽（以 ns 为单位）后，定期显示时间戳。例如，--display-run-interval=10。 |
--dump-vcd=<file>
|
将 VCD 波形信息转储到 <file> 中。由于该工具会将 .vcd 追加到指定文件名后，因此无需包含文件后缀。注释： 要从 aiesimulator 生成的 .vcd 文件生成 XPE 文件，请使用
vcdanalyze 工具，如下所示： |
--enable-handshake-ext-tb
|
在 aiesimulator 与外部测试激励文件之间启用逐个样本传输事务。 |
--enable-memory-check
|
启用运行时程序和数据存储器边界访问检查。任何违例访问都将以 [WARNING] 消息方式来报告。默认禁用该选项。 |
--hang-detect-time=<time in
ns>
|
如果在该选项所指定的时间段（以 ns 为单位）过后，所有活动的核都处于停滞状态，则仿真退出。例如，--hang-detect-time=10。 |
-i
|
--input-dir=<dir> 选项的别名。 |
-o
|
--output-dir=<dir> 选项的别名。 |
--pkg-dir=<dir>
|
指定封装目录，例如，./Work。 |
--profile
|
为所有已用的核生成剖析数据。允许在 stdout 上生成 printf 追踪消息，并在仿真期间收集剖析统计数据。这可能稍许减缓仿真器速度。（可选）可使用 |
--simulation-cycle-timeout=<cycles>
|
应用完成加载后，运行指定的周期数。 提示： 指定
--simulation-cycle-timeout 选项即可在指定次数的超时后终止仿真会话。但在调试进程期间指定仿真超时时，请务必指定较大数值的周期数，因为达到超时周期后，调试将终止。 |
--online
|
调用 提示：
--online 选项与 --dump-vcd 选项不得搭配一起使用。如果同时指定这两个选项，只有 --online 选项会生效。 |
--output-time-stamp
|
使用 --output-time-stamp=no 可获取无时间值的输出文件，使用 --output-time-stamp 可获取输出文件中的统一时间值（以 ns 为单位）。 |
挂起检测
AI 引擎用户可能会遇到仿真器挂起。常见原因是对于所请求的 graph 迭代次数，输入数据不足；串流数据的生成和耗用之间存在不匹配；与串流、级联串流或异步窗口之间存在周期依赖性，或者阻塞协议调用（获取异步窗口、读/写串流）顺序错误。
aiesimulator 的 --hang-detect-time=<time_in_ns> 选项将允许该工具检查内核上发生的挂起状况，并在指定延迟后触发仿真退出。它可以检测电路切换或包切换通信的锁定停滞和串流停滞。以下提供了挂起检测输出的部分示例：图 1. 串流停滞检测
图 2. 锁定停滞检测
