仿真和调试 AI 引擎组件 - 2023.2 简体中文

AI 引擎工具和流程用户指南 (UG1076)

Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 简体中文

Flow Navigator中,成功构建 AI 引擎组件后,您可在X86 simulation(X86 仿真)或“AIE Simulator/Hardware”(AI 引擎仿真器/硬件)构建目标下运行或调试组件,如下所示。

图 1. 调试 AI 引擎
提示: 如果在Flow Navigator下拉列表中列出了多个组件,那么您必须选中 AI 引擎组件,使其成为工具中的活动组件。

在上图中,Open Settings(打开设置)按钮可用于打开启动配置,以便运行或调试 AI 引擎组件。仅当您悬停在Flow Navigator中的Run(运行)或Debug(调试)命令上时,才会显示此按钮。单击Open Settings即可打开包含组件的不同启动配置的 launch.json,如下所述。您还可直接选中RunDebug并使用默认启动配置来运行或调试构建目标,而无需打开 launch.json 文件。

启动配置,如以下 launch.json 图中所示:

  • aie_component_x86:支持运行或调试x86 Simulation构建
  • aie_component_aiesim:支持运行或调试AI Engine Simulator/Hardware构建。这是当前选中并显示的启动配置
提示: 您可选中现有启动配置旁的Duplicate(复制)命令创建新的启动配置,或者选中Delete(删除)命令删除现有配置。
图 2. AI 引擎启动配置

上图显示了当前选中的启动配置的详细信息,其中包含以下选项:

  • Launch config name(启动配置名称):指定名称。选中Edit(编辑)命令即可更改此名称。
  • Target(目标):指定供启动配置使用的构建目标的名称。目标无法更改。
  • Enable Pipeline View(启用流水线视图):在运行或调试期间生成 AI 引擎阵列的“Pipeline”(流水线)视图。
  • Package directory(封装目录):指定封装 AI 引擎组件期间使用的目录。默认目录是 ./Work 目录,如果构建期间指定了其他工作目录 (-workdir),那么可能需要更改此目录。
  • Input directory(输入目录):指定运行或调试期间该组件所使用的任何输入数据的位置。
  • Additional arguments(其他实参):指定运行或调试期间,AI 引擎组件所需的任何其他命令行实参。
  • Trace Options(追踪选项):在运行或调试期间启用追踪捕获,并指定追踪选项。如需了解更多信息,请参阅 启用 AI 引擎追踪
  • Profile Options(剖析选项):在运行或调试期间启用剖析,并指定剖析选项。如需了解有关这些选项的详细信息,请参阅 启用 AI 引擎剖析

设置启动配置之后,您可在 launch.json 中选中Run命令或Debug命令来启动运行或调试,或者如果有多个启动配置可用于构建目标,那么您也可以从Flow Navigator选中RunDebug,并指定某一启动配置。

提示: 如果启动配置包含未保存的更改,那么该工具将提示您先保存,然后再运行。

运行进程中,会向控制台报告 x86simulatoraiesimulator 的输出。您可实时复查转录文本,或者也可在完成运行后参阅生成的 log 日志文件。您可导航到Component Explorer(组件资源管理器)视图中的组件相应的 Output/hw 文件夹或 Output/x86sim 文件夹,打开仿真器的 log 日志文件。

调试进程中,该工具会打开“Debug”视图,如 调试 AI 引擎组件 中所述。

成功运行或调试 AI 引擎组件后,Flow Navigator将显示此进程中生成的一系列报告。可用报告因 x86hw 的构建目标而异。您可选中任意可用报告进行查看,或者也可切换至Analysis(分析)视图以完成报告复审。如需了解有关可用报告的详细信息,请参阅 Vitis 统一软件平台文档:应用加速开发(UG1393) 中的使用“Analysis”视图 (Vitis Analyzer)