从 Vitis IDE 进行软件仿真调试 - 2022.1 简体中文

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

Document ID
UG1076
Release Date
2022-05-25
Version
2022.1 简体中文
在软件仿真中运行应用之前,您需要使用“Emulation-SW”(软件仿真)构建目标来构建系统工程。要在Emulation-SW构建目标中运行和调试应用,必须使用以下步骤。
  1. 选择Xilinx > Start/Stop Emulator(赛灵思 > 启动/停止仿真器)启动 QEMU 仿真环境。

    这样即可启动仿真器,然后等待至 QEMU 内 Linux 完成启动为止。Emulation(仿真)控制台会显示 QEMU 启动和 Linux 启动进程的转录文本。当进度对话框关闭并且Emulation Console(仿真控制台)窗口显示空白 qemu% 时,即表示此进程已完成。您可以检查转录文本以获取该进程的详细信息。

    启动软件仿真时,您可以为运行 graph 应用的 AI 引擎仿真器指定选项。如 复用 x86 仿真器选项 中所述,在前图中所示的Emulator Arguments(仿真器实参)字段中可以使用以下命令指定这些选项。
    -x86-sim-options ${FULL_PATH}/x86sim.options
    注释: ${FULL_PATH} 是指向 x86sim.options 文件位置的完整路径。
    重要: 打开主机应用源文件。右键单击 int main() 一侧以设置断点,因为 IDE 不会在 main() 处自动设置断点。
  2. 右键单击顶层系统工程,然后选择Debug As > Launch SW Emulator(调试方式 > 启动软件仿真器)命令。这样会打开Debug Configurations(调试配置)对话框。
  3. 单击Debug(调试)以继续。
    这样即可在 Vitis IDE 中打开Debug透视图,并连接至 QEMU 中其各自的线程上运行的 PS 应用和 AI 引擎 graph。
    注释: 如需了解调试期间使用的视图的更多详细信息,请参阅 用于软件仿真调试的 Vitis IDE 布局
  4. 单击Resume(恢复)按钮 转至下一个断点。观察Debug视图可以看到各种派生的线程。

    注释: Debug视图还会显示已命中断点的线程,并带有信息(暂挂:断点)。
  5. 请复查Variables(变量)视图。此视图显示所有变量和对象以及 AI 引擎内核(如下图所示)。例如,下图显示了展开的sbuff,其中显示v32cint16数据类型已格式化。

  6. 单击Registers(寄存器)视图。在 AI 引擎内核中触发断点后,此视图会显示所有相关触发器。

    注释: 如果在主机应用源中触发断点,那么它会显示 PS 寄存器。