set_directive_latency - 2023.2 简体中文

描述

在函数、循环或区域上指定最大和/或最小时延值。

Vitis HLS 始终以最小时延为目标。指定最小和最大时延值时，该工具的行为如下所示：

• 当时延小于最小值时：如果 Vitis HLS 可以实现小于最小指定值的时延，那么它可将时延扩展至指定值，这样可能增加共享。
• 当时延大于最小值时：满足约束。不再执行进一步最优化。
• 当时延小于最大值时：满足约束。不再执行进一步最优化。
• 当时延大于最大值时：如果 Vitis HLS 无法调度到最大限值范围内，那么它会尽力实现指定约束。如果仍无法满足最大时延，则会发出警告。随后，Vitis HLS 会以可实现的最小时延来生成设计。

如果要限制所有循环迭代的总时延，应将时延指令应用于包含整个循环的区域，如以下示例所示：set_directive Region_All_Loop_A

Region_All_Loop_A: {
Loop_A: for (i=0; i<N; i++) 
  { 
  ..Loop Body... 
  }
}

在此情况下，即使展开循环，时延指令仍会对所有循环操作设置最大限制。

如果 Vitis HLS 无法满足最大时延约束，它会放宽时延约束，并尝试尽可能实现最佳结果。

如果设置最小时延约束，并且 Vitis HLS 生成的设计时延低于所需的最小值，它会插入虚拟时钟周期以满足最小时延。

语法

set_directive_latency [OPTIONS] <location>

• <location> 是要约束的函数、循环或区域的位置（格式为 function[/label]）。

选项

-max <integer>

指定最大时延。

-min <integer>

指定最小时延。

示例

指定 foo 函数采用最小时延值 4 和最大时延值 8。

set_directive_latency -min=4 -max=8 foo

在 foo 函数中，指定 loop_row 循环采用最大时延 12。将编译指示置于循环主体内。

set_directive_latency -max=12 foo/loop_row

另请参阅

• pragma HLS latency