设置指南阈值 - 2022.1 简体中文

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

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

Run Guidance(运行指南)报告中显示的指南消息是由工具中定义的特定规则以及阈值触发的。用户可在 Vitis™ 分析器中对其中部分规则和阈值进行修改。打开Run Guidance报告时,在报告的Threshold(阈值)列中,可修改的值将显示为链接,如下图所示。

图 1. 运行指南阈值

单击Threshold列中的链接将显示Edit Guidance Threshold(编辑指南阈值)对话框,如下所示。此对话框顶部显示的是选定规则的当前运算符和阈值,下半部分则允许您对值进行编辑。

图 2. 编辑指南阈值

上图显示的是以用户指定的值来重新定义Threshold value的过程。在某些案例中,会显示接受的值的范围,该工具会检查提供的值是否在此范围内。在以上示例中,指定的值必须大于或等于 0。

Edit Guidance Threshold对话框还会提供Reset threshold(复位阈值)命令,以允许您将用户定义的值复位为工具提供的硬编码值。这对应于上图所示的

提示: “Run Guidance”报告的菜单栏还提供了Reset Guidance Thresholds(复位指南阈值)命令,供您用于清除报告中的所有用户修改的阈值。

Update guidance report(更新指南报告)复选框允许您指定值更新后是否重新运行指南报告。如果您不勾选此框,那么阈值将按指定方式更改,且由于用户指定了新的阈值,此报告将被标记为过期 (out-of-date)。您将需要使用Reload(重新加载)来重新加载报告,以查看用户提供的值的影响。

单击OK(确定)以更改该值,或者单击Cancel(取消)以关闭此对话框,不执行更改。

导入/导出规则阈值

有关哪些阈值可修改的规则以及所有规则的默认值都存储在工具安装中。您可使用定制规则文件来改写这些值,在 Vitis 分析器中,您可将此类定制规则文件导出和导入不同工程。

Run Guidance报告中有一条或多条自定义规则时,在报告的工具栏菜单中,Export User Guidance Thresholds(导出用户指南阈值)命令将变为活动状态。您可在上图中看到显示的此命令。此命令允许您导出自定义的阈值,以供在其它设计中复用。

以下显示了一个样本文件:

profile_rules =
(
  {
    id = "HOST_MIGRATE_MEM";
    value = "1";
  },
  {
    id = "DEVICE_UTIL";
    value = "3";
  }
);
version = "1";	

用户阈值文件无需包含所有指南规则,只需包含涉及值更改的规则以及规则 ID 和值字段即可:

  • idRun Guidance报告的Name(名称)列中显示的规则名称。
  • value 是用户指定的值,显示在Threshold列中。

Vitis 分析器 IDE 还允许您通过Import User Guidance Thresholds(导入用户指南阈值),在其它工程内复用定制阈值。您可以根据需要导出 user-thresholds.cfg 文件、编辑值并导入文件。导入用户阈值文件会重新生成Run Guidance报告,以使用导入的值。

重要: 导入用户指南阈值文件则将改写任何现有的用户修改的阈值。