创建存档文件 - 2022.1 简体中文

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

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

执行工程开发时,您对主机或内核代码所执行的某些更改可能完全改变该工具所生成的各种构建和运行汇总信息的内容或质量。除非您手动保存相关文件,否则现有报告和分析数据将被覆盖。Archive Summary(存档汇总)允许您保存与打开的Link Summary(链接汇总)或Run Summary(运行汇总)相关的所有文件。

提示: 该功能允许您通过共享存档汇总信息来与其它团队成员共享设计报告。

选择File > Archive Summary(文件 > 存档汇总)菜单命令或者右键单击Report Navigator(报告导航器)中的汇总信息,然后选择Archive Summary(存档汇总)。这样即可打开Archive Summary对话框,如下所示。

图 1. “存档汇总”对话框

存档文件名必须包含扩展名 link_summary.archiverun_summary.archive 才可供 Vitis 分析器识别。存档的内容取决于要存档的汇总报告。

Link Summary的内容包含以下文件扩展名:

二进制容器
.xclbin
内核
.xo
系统/平台框图
.json
系统估算
.xtxt
指南
.html 或 .pb
时序汇总
.rpt 或 .rpv
利用率
.xutil

Run Summary的内容包含以下文件扩展名:

系统框图
.run_summary
平台框图
.run_summary
指南
非必需,通过使用 vp_analyze 和 opencl_summary.csv 来生成
剖析汇总
opencl_summary.csv
时间线轨迹
opencl_trace.csv 和 native_trace.csv
波形报告
.wdb
重要: 对于 AI 引擎设计,当 run_summary 包含追踪报告,但不包含对应 AI 引擎工作目录的条目时,Vitis 分析器无法运行 hwanalyze 来显示此追踪报告。在此情况下,该工具会提示您提供 AI 引擎 compile_summary 的位置,并更新磁盘上的 run_summary 文件。如果您在提供此位置前对 run_summary 进行存档,则无法查看来自已存档的 run_summary 的追踪报告。

您也可以选择保存 .xclbin 文件扩展名、任何已编译的内核对象文件扩展名(.o.xo)以及原始源文件扩展名(.cpp.c.cl),用于生成汇总报告。

提示: 指南信息不予保存,因为它是由 Vitis™ 分析器从 opencl_summary.csv 以及(可选)profile_kernels.csv 动态生成的。
要打开现有存档文件,请使用File > Open Summary(文件 > 打开汇总)命令,并浏览所需归档文件。您也可以在启动 Vitis 分析器时使用以下命令打开存档文件:
vitis_analyzer design.archive
“Archive Summary”(存档汇总)还支持命令行格式,欲知详情,请使用以下命令:
archive_summary -help
注释: Vitis 分析器存档是压缩存档,可通过解压来访问其中个别存档文件,包括存档中包含的 xclbinxo 文件。