指南 - 2022.1 简体中文

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

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

Vitis 核开发套件具有全面的设计指南工具,可即时提供切实可行的指导信息,以帮助软件开发者解决设计中检测到的问题。这些问题可能与源代码相关,或者也可能是由于未进行工具最优化而导致的。此外,其中所含规则均为基于广泛的参考设计制定的通用规则。因此,这些规则可能不适用于您的特定设计。您应自行理解特定指南规则,并根据您自己的具体算法和要求来采取相应的行动。

这些指南是从 v++ 编译器调用的 Vitis HLS、Vitis Profiler 和 Vivado Design Suite 生成的。生成的设计指南可能包含多个严重性级别,警告消息、参考消息和设计规则检查是在软件仿真、硬件仿真和系统构建期间提供的。剖析设计指南可帮助您解读剖析结果,从而使您能够专注于提高性能。

指南包含有关已报告的违例的消息文本、简要的建议解决方案以及以 Web 链接形式提供的详细解决方案。您可以根据建议的解决方案来确定自己接下来的行动方针。它会快速高亮问题并指引您获取有关使用 Vitis 技术的更多信息,从而帮助您提升工作效率。

设计指南是在通过命令行或 Vitis IDE 来构建或运行应用之后自动生成的。

您可按 使用 Vitis 分析器 中所述方式打开“Guidance”(指南)报告。要访问“Guidance”报告,请打开“Compile Summary”(编译汇总)、“Link Summary”(链接汇总)或“Run Summary”(运行汇总),然后打开“Guidance”报告。

  • “Kernel Guidance”(内核指南)是在使用 v++ 编译命令构建内核之后,由 Vitis HLS 工具生成的。可在 Vitis 分析器中通过打开“Compile Summary”报告来查看此报告。针对编译的每个内核,都会生成内核指南和编译汇总文件。内核指南包含有关使用数据流的建议以及无法实现期望的吞吐量的可能原因。
  • “System Guidance”(系统指南)是在使用 v++ 链接命令构建内核之后生成的。可在 Vitis 分析器中通过打开“Link Summary”报告来查看此报告。系统指南包含所有内核指南检查,并提供了应用运行前的全方位审查结果。
  • “Run Guidance”(运行指南)是在运行所生成的 .xclbin 时生成的,它属于 XRT 的一项功能特性。可在 Vitis 分析器中通过打开“Run Summary”来查看此报告。运行指南包含“Kernel Stall”(内核停滞)是否超过 50% 之类的检查以及是否可以使用 PLRAM 代替 DDR 等建议。

打开“Guidance”报告后,“Guidance”视图会显示消息列和解决方案列。解决方案还可包含展开的 Web 链接帮助。

下图显示了 Vitis 分析器中显示的“Guidance”报告示例。例如,单击“Name”(名称)列中的链接即可打开规则检查描述。“Details”(详情)列中的链接可打开源代码、选择设计对象(例如,内核)或者浏览其它报告。

图 1. 设计指南示例
提示:设置指南阈值 中所述,您可以手动编辑Run Guidance报告的Threshold列中的值以自定义此报告。

针对运行的每条 v++ 命令(包括编译和链接),都会生成一份 HTML 指南报告。报告文件位于 --report_dir 中的特定输出名称下。例如:

  • v++_compile_<output>_guidance.html 对应 v++ 编译
  • v++_link_<output>_guidance.html 对应 v++ 链接

您可单击“Resolution”(解决方案)列中的 Web 链接以获取有关解决方案的更多详细信息。Guidance Messaging 网页列出了所有当前消息以供您复查。

图 2. “Guidance Messaging”网页

内核和计算单元对象以及剖析报告的数据值还可以与其它视图进行交叉探测,例如,“System Diagram”(系统框图)或“Profile Report”(剖析报告)。如需了解更多信息,请参阅 处理汇总报告