使用 Vitis 分析器 - 2022.1 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)

Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 简体中文

Vitis™ 分析器实用工具支持您在构建和运行应用的同时查看并分析报告。它旨在允许您查看在构建应用时由 Vitis 编译器生成的报告以及在运行应用时由赛灵思的 Xilinx Runtime (XRT) 库生成的报告。Vitis 分析器可用于查看来自 v++ 命令行的报告和来自 Vitis 集成设计环境 (IDE) 的报告。您将使用 vitis_analyzer 命令启动该工具(请参阅 设置 Vitis 环境)。

首次启动时,Vitis 分析器会打开主页屏幕,您可在其中打开汇总文件、二进制容器或目录。单击其中任一链接即可打开文件浏览器以供您选择所描述的特定类型的文件。

图 1. Vitis 分析器 - 主页屏幕
Open Summary
报告汇总是与 Vitis 工具中特定应用开发阶段相关的报告的集合。其中包含为构建进程的 2 个步骤(编译和链接)创建的报告汇总以及来自执行应用时的运行进程的汇总信息。选择Open Summary(打开汇总)即可打开以下任一汇总报告:
Compile Summary
“Compile Summary”(编译汇总)报告是由 v++ 命令在编译期间生成的,可提供内核编译进程的状态。此报告集合包括汇总报告、时序和资源估算的内核估算、提供编译建议的内核指南以及来自 Vitis HLS 的 HLS 综合 log 日志。
Link Summary
“Link Summary”(链接汇总)报告是由 v++ 命令在链接和创建 .xclbin 文件期间创建的。此报告集合包含汇总报告、用于演示硬件设计的系统和平台框图、提供时序和资源估算的系统估算、提供系统链接和性能改进建议的系统指南以及用于提供设计详细信息(如接口连接、时钟、复位和中断)的 Vivado 自动化汇总。
提示: 仅在构建目标硬件(而不是仿真)时,才会生成“Timing Summary”和“Utilization”。
打开“Link Summary”时,Vitis 分析器将自动打开已链接到 .xclbin 文件中的内核的关联“Compile Summaries”。
Package Summary
“Package Summary”(封装汇总)报告是由 v++ --package 命令生成的,可提供与仿真脚本和 SD 卡输出的生成相关的信息。查看“Package Summary”报告时,该工具还会引用命令行上使用的配置文件和生成的 log 日志文件。
Run Summary
“Run Summary”(运行汇总)报告是由 XRT 库在应用执行期间创建的,可提供运行进程的汇总信息。查看“Run Summary”报告时,该工具还会引用运行应用期间生成的以下报告:“Guidance”(指南)、“Profile Summary”(剖析汇总)、“Timeline Trace”(时间线轨迹)、“Platform and System Diagrams”(平台和系统框图)以及“Simulation Waveforms”(仿真波形)(如果已启用)。
重要: 应用的运行时执行期间生成的报告通常需要提前设置,如 剖析应用 中所述。

v++ 构建进程后运行应用时,来自“Link Summary”的 ID 将分配给“Run Summary”。打开“Run Summary”和“Link Summary”时,Vitis 分析器会基于共享 ID 来链接这些报告。

AI Engine Compile and Run Summaries
Vitis 分析器还支持您查看来自 Versal AI 引擎编译和运行进程的报告。这些报告是由 aiecompileraiesimulator 生成的,如 Versal ACAP AI 引擎编程环境用户指南 (UG1076) 中所述。
提示:Vitis IDE 中,工程层级包含顶层系统工程,其中子工程包含设计元素:处理器应用、硬件内核、硬件链接工程和 AI 引擎工程。上述各种汇总报告均可在相应的子工程中找到:“Compile Summary”位于特定硬件内核工程中、“Link Summary”位于硬件链接工程中、“Package Summary”位于系统工程中、“Run Summary”位于处理器应用中,AI 引擎汇总信息位于 ./Work 文件夹或 ./aiesimulator 输出中。
Open Binary Container
打开所选 .xclbin 文件即可显示构建的平台框图和系统框图。
Open Directory
指定要打开的目录。该工具会以递归方式检验目录内容,并显示对话框以供您选择要打开的文件类型以及要打开的个别文件。
提示: 主页屏幕上的“Open Recent”(打开最近打开的报告)部分提供了最近打开的汇总和报告的列表,以便您快速重新打开。

vitis_analyzer 命令允许您打开工具并显示主页屏幕(如上所述),或者指定打开工具时要加载的文件。您可通过指定要打开的文件的名称来打开此文件。您可通过 Vitis 分析器支持的任意文件来打开此工具,如 处理汇总报告 中所述。例如:

vitis_analyzer xrt.run_summary

您可通过输入以下命令来访问 vitis_analyzer 命令的命令帮助:

vitis_analyzer -help