复用 AI 引擎仿真器选项 - 2022.1 简体中文

Versal ACAP AI 引擎编程环境 用户指南 (UG1076)

Document ID
UG1076
Release Date
2022-05-25
Version
2022.1 简体中文

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} 必须是指向此文件或目录的完整路径。

表 1. 适用于硬件仿真的 AI 引擎选项
命令 实参 描述
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)