使用 XRT 执行定期 AI 引擎状态输出
您可使用
xrt.ini
文件启用运行时死锁检测和状态输出。这是一次性设置,它将导致定期输出状态数据,包括死锁检测。要开启此功能特性,请在 xrt.ini
文件中添加:[Debug]
aie_status=true
要指定 AI 引擎状态探测和分析时间间隔,请执行以下操作:
[Debug]
aie_status=true
aie_status_interval_us=1000
运行主机程序时,将把 AI 引擎状态复制到下列文件:
- xrt.run_summary:运行汇总,包含可供 Vitis 分析器使用的文件列表信息。
- aie_status_edge.json:AI 引擎状态和 AI 引擎存储器。
- aieshim_status_edge.json:AI 引擎接口 tile (拼块)状态。
- summary.csv:始终创建此文件。适用于其它剖析功能,例如,提供指导信息。
如果检测到死锁,则会报告如下警告信息:
[XRT] WARNING: Potential deadlock/hang found in AI Engines. Graph : gr
[XRT] WARNING: Potential stuck cores found in AI Engines. Graph : gr Tile : (25,1) Status 0x81 : Enable,Lock_Stall_W
除 AI 引擎状态外,如果发生任何错误事件,则会将其记录在 JSON 文件中。
您负责判定错误严重性以及是否可恢复。使用汇总文件和 JSON 文件在 Vitis 分析器中进行分析。
手动 AI 引擎状态输出
您可以在器件完成加载后,随时将 AI 引擎状态的单一快照输出到 JSON 文件。这是 AI 引擎运行状态的静态快照,并包含在此之前发生的事件。
使用
xbutil
命令搭配 -f json
选项即可将状态输出至 JSON 文件。例如:xbutil examine -r aie -d 0 -f json -o aie_status_xbutil.json
稍后,可遵循特定步骤将此 JSON 文件导入 Vitis 分析器。