使用 XSDB 生成 AI 引擎状态 - 2023.2 简体中文

在 Linux 和裸机操作系统上均可使用 XSDB 检验 AI 引擎的状态。该功能特性允许您在开发板处于死锁或挂起状态时调试应用并检测 AI 引擎的状态。不同于需要 XRT 的 xbutil 命令，XSDB 命令独立于 XRT 来运行。

XSDB 能使用 aiestatus examine 命令以 .json 文件格式报告 AI 引擎状态。您可在运行应用之前、期间和之后使用此命令。

命令

aiestatus examine

支持的选项

aiestatus examine [-graphs] <graph-list> [-work-dir] <dir-path> [-aie-version] <version> [-file] <file-name> [-run-summary] [-target-name] <target-name> [-tiles] <tile-list>

支持的选项定义如下：

命令示例

xsdb% source $XILINX_VITIS/scripts/vitis/util/aie_status.tcl

示例 1

指定计算图和工作目录。

aiestatus examine -work-dir ./Work -graphs dut

此示例会检验并报告名为 dut 的计算图的状态。

示例 2

指定拼块。

aiestatus examine -tiles 10,2;5,*

此示例会检验并报告拼块 (10,2) 的状态以及列 5 中所有拼块的状态。

以上命令可在运行应用之前、期间和之后随时运行，前提是开发板正在运行设计或者处于死锁或挂起状态。此命令会在运行命令的目录内生成 JSON 文件 <aie_status_<date_time>.json>。文件名示例：aie_status_2022_08_11_113542.json。此文件可在 AMD Vitis™ IDE 内打开，可供您查看和分析状态。要在运行应用之前读取 AI 引擎拼块的状态寄存器，请在开发板上运行主机应用之前运行 aiestatus 命令。

运行 aiestatus examine 命令之后的 XSDB 控制台样本如下所示。

图 1. XSDB 控制台

此外还可观察到此命令返回与命令中指定的计算图对应的所有 AI 引擎拼块的状态寄存器。

在 Vitis IDE 内打开 JSON 文件

1. 打开 Vitis IDE，并选中Import Xbutil/Xsdb JSON output（导入 Xbutil/Xsdb JSON 输出）选项。
2. 在对话框中，指定 .json 文件以及要生成的 AI Engine Compile Summary 文件和 Run Summary 文件。
   图 2. 导入 Xbutil/Xsdb JSON 输出
3. 单击“OK”（确定）后，会在当前工作目录内生成新的汇总文件。“Analysis”（分析）视图会打开此汇总文件，如下所示。
   图 3. 汇总视图

您可导航到Graph（计算图）或Array（阵列）视图，并观察 AI 引擎拼块的状态。下图显示了已停滞的 AI 引擎拼块的状态。

图 4. 阵列视图

aie_status.run_summary 文件可用于在 Vitis IDE 内查看和分析状态结果。

或者，您也可以运行 aiestatus 命令搭配 -run-summary 选项，如下所示。

aiestatus examine -work-dir ./Work -graphs dut -run-summary

此命令会生成 aie_status.run_summary 文件和 .json 文件，这些文件均可在 IDE 中打开。