构建和运行系统 - 2022.1 简体中文

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

Document ID
UG1076
Release Date
2022-05-25
Version
2022.1 简体中文
定义完顶层系统工程后,就表示 AI 引擎 graph 应用已添加、PL 内核已添加、PS 应用已添加、HW-Link(硬件链接)工程已配置,这样一切准备就绪,可以开始构建和运行系统了。

系统工程支持三种不同构建目标:Emulation-SW(软件仿真)、Emulation-HW(硬件仿真)和Hardware(硬件)。您可使用下列步骤来构建顶层系统工程。

  1. 双击Explorer(资源管理器)视图中的 <project>.sprj 文件,在编辑器区域内打开系统工程。
  2. Project Editor(工程编辑器)窗口中的Active build configuration(活动的构建配置)设置为Emulation-SWEmulation-HWHardware,以选择特定构建目标。
  3. Assistant(助手)视图中,选中顶层工程,然后单击Settings(设置)命令 () 以显示System Project Settings(系统工程设置)对话框,并执行任何必要的更改,然后执行构建。
  4. 单击工具栏菜单中的Build(构建)命令 (),以启动当前处于活动状态的构建配置。Vitis IDE 中的构建进程是递增进程,仅构建已更新的工程元素,上一次构建完成后需重新构建。您可以构建系统工程的单个元素,例如,AI 引擎 graph 或 PL 内核,该工具会识别是否需要重新构建这些元素。
    注释: 硬件的构建进程运行时间远超仿真构建的时间。因此在仿真构建中重要的是,先完成设计调试,而后再转至硬件构建。
  5. 当构建完成后,请检验Explorer视图中的Emulation-SWEmulation-HWHardware构建文件夹的内容。您可选中并展开构建目录的各文件夹。在输出层级中会显示 Vitis 编译器封装进程 (v++ --package) 的输出文件。构建进程会生成系统所需的仿真数据和启动文件,并将其写入 sd_card 文件夹。
    注释: 在 Hardware 文件夹下会创建两个文件夹:packagepackage_no_aie_debugpackage 文件夹内的 sd_card.img 文件用于硬件调试目的,而 package_no_aie_debug 文件夹内的 sd_card.img 文件则用于常规应用执行。
    重要:AI 引擎系统工程中,您可以调试和运行系统级工程,或者也可以调试并运行 AI 引擎工程。除部分顶层系统工程外,您无法调试和运行 PS 或 PL 工程。
  6. 对于软件仿真构建,请选择Xilinx > Start/Stop Emulator(赛灵思 > 启动/停止仿真器)命令以启动 QEMU 仿真环境。

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

    启动软件仿真时,您可以为运行 graph 应用的 AI 引擎仿真器指定选项,如 复用 x86 仿真器选项 中所述。在前图中所示的Emulator Arguments(仿真器实参)字段中可以使用以下命令指定这些选项。

    -x86-sim-options ${FULL_PATH}/x86sim.options
  7. 对于硬件仿真构建,请选择Xilinx > Start/Stop Emulator(赛灵思 > 启动/停止仿真器)命令以启动 QEMU 仿真环境。

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

    启动硬件仿真时,您可以为运行 graph 应用的 AI 引擎仿真器指定选项,如 复用 AI 引擎仿真器选项 中所述。在前图中所示的Emulator Arguments(仿真器实参)字段中可以使用以下命令指定这些选项。

    -aie-sim-options ${FULL_PATH}/aiesim_options.txt
  8. Run Configurations(运行配置)对话框中,选中Run(运行)以继续。