启动系统工程的运行或调试 - 2023.2 简体中文

系统工程构建完成后，您即可通过以下步骤启动运行或调试。

1. 为系统工程打开Launch Configuration（启动配置）编辑器 (launch.json)，具体方法是从Component Explorer（组件资源管理器）内工程的Settings（设置）文件夹中选中该工程，或者在 Flow Navigator 中，选中Run（运行）或Debug（调试）旁的Open Settings（打开设置）。
   提示： Open Settings命令是隐藏图标，仅当您将光标置于Flow Navigator中的Run或Debug旁时才会显示。

   

2. 编辑现有启动配置，或者创建新配置以进行修改，从而明确您即将开始的运行或调试会话的具体要求。您可为系统工程所支持的 3 种类型的目标分别定义独立的启动配置。构建目标包括 Software Emulation (sw_emu)、Hardware Emulation (hw_emu) 和 Hardware (hw)，如 Vitis 统一软件平台文档：应用加速开发(UG1393) 的“构建目标”中所述。

   图 1. 启动配置
   
   

   前图显示了系统工程的Launch Configuration编辑器，其中包含可用于配置系统工程以便执行Run或Debug的选项。

   前图显示了系统工程的硬件仿真启动配置，其中包含以下设置：

   • Name（名称）：启动配置的名称。
   • Host Executable（主机可执行文件）：应用组件中包含的主机应用的名称。
   • Cmd Line Args（命令行实参）：要传递到主机应用的实参，如果代码需要二进制容器 (.xclbin)，那么也会一并包含。
   • Target（目标）：应搭配启动配置一起使用的构建目标。
   • Working Directory（工作目录）：这是从中运行主机应用的工作目录。
   • XRT Config File（XRT 配置文件）：这是运行应用时要使用的 xrt.ini 文件的位置。如需了解有关这些可用选项的详细信息，请参阅 xrt.ini 文件。
   • Stop at main（在 main 处停止）：启用该复选框即可在 main 应用的入口点处添加一个断点用于调试。
   • Stop at program entry（在程序入口处停止）：启用该复选框即可在 AI 引擎程序的入口点处添加一个断点。

配置完启动配置后，您可选中Launch Configuration编辑器中的Run或Debug命令，或者从Flow Navigator中选中Run或Debug。如有多个启动配置可用于您正在运行的构建目标，Vitis IDE 将提示您选择要使用的启动配置。

对于嵌入式器件或嵌入式平台的硬件仿真，您必须先从Flow Navigator选中Emulator命令以启动 QEMU 环境，然后才能选择Run或Debug。QEMU 环境启动需要数分钟时间。您应等待至 QEMU 启动并正常运行后再启动Run或Debug。如需了解更多信息，请参阅 在嵌入式处理器平台上运行仿真。

启动硬件仿真时，您可以为运行计算图应用的 AI 引擎仿真器指定选项，如 AI 引擎工具和流程用户指南(UG1076) 的复用 AI 引擎仿真器选项中所述。在Emulator Arguments（仿真器实参）字段中可以通过指定以下命令来指定这些选项。

-aie-sim-options ${FULL_PATH}/aiesim_options.txt