AI 引擎仿真器会生成一个选项文件,其中列出了用于对 AI 引擎 graph 应用进行仿真的选项。运行 AI 引擎仿真器时,会自动生成该选项文件。后续在系统级别硬件仿真中,您可以复用在初始 graph 级别仿真运行期间所使用的 AI 引擎仿真器选项。您也可以手动编辑选项文件以按需指定其它选项。下表列出了可在 aiesim_options.txt 文件内指定的选项。此文件位于 aiesimulator_output 目录中,只要将 --dump-vcd
选项或 --profile
选项与 aiesimulator
命令搭配使用,就会创建此文件。在命令行选项中可指定此文件,以使用 launch_hw_emu.sh 脚本启动硬件仿真器,如 在硬件中运行系统 中所述。命令行示例如下所示。
./launch_hw_emu.sh \
-add-env VITIS_LAUNCH_WAVEFORM_BATCH=1 \
-aie-sim-options ${FULL_PATH}/aiesimulator_output/aiesim_options.txt
其中 ${FULL_PATH}
必须是指向此文件或目录的完整路径。
命令 | 实参 | 描述 |
---|---|---|
AIE_DUMP_VCD
|
<filename> | 指定 AIE_DUMP_VCD 时,仿真会生成 VCD 数据,并将其写入指定的 <filename>.vcd。 |
AIE_PROFILE
|
All | (1,2)(3,4)... | 该选项会剖析所有已使用的 AI 引擎或列出的选定 AI 引擎。硬件仿真会在 sim/behav_waveform/xsim 目录中生成剖析数据文件,在 Vitis 分析器中打开 default.aierun_summary 文件即可查看这些文件。该选项还会将 ADF 内核 printf 数据记录到 sim/behav_waveform/xsim/simulate.log 文件中。 |
重要: 您必须使用下列任一方法将 AI 引擎编译器
workdir
环境变量设置为由 AI 引擎编译器生成的 Work
目录:- 在
launch_hw_emu.sh
的命令行中使用-add-env
。例如,在 Makefile 中,./launch_hw_emu.sh -aie-sim-options ./sim_options.txt -add-env AIE_COMPILER_WORKDIR=/yourdesigndirectory/Work
。 - 启动赛灵思仿真器之前,请在 shell 窗口中输入
setenv AIE_COMPILER_WORKDIR /yourdesigndirectory/Work
。
注释: 包含文件路径的任何命令都必须采用绝对路径。
手动创建仿真选项文件时,需遵循 COMMAND=ARGUMENT
格式,每条命令单独一行。最佳实践如以下示例所示。
AIE_PROFILE=All
AIE_VCD=foo
以下命令用于在硬件仿真期间启动赛灵思仿真器波形 GUI。
./launch_hw_emu.sh -g
此外,您可以添加更多高级选项来记录波形数据,而无需随 Vivado 逻辑仿真器 GUI 启动仿真。命令行示例如下所示。
./launch_hw_emu.sh \
-user-pre-sim-script pre-sim.tcl
pre-sim.tcl 包含用于添加波形或记录设计波形的 Tcl 命令。如需获取示例,请参阅 Vitis 统一软件平台文档:应用加速开发(UG1393),如需查看 Tcl 命令,请参阅 Vivado Design Suite 用户指南:逻辑仿真(UG900)。