set_directive_pipeline - 2024.1 简体中文

描述

通过允许并发执行操作来缩短函数或循环的启动时间间隔 (II)，如 循环流水打拍 中所述。流水线函数或循环每隔 N 个时钟周期即可处理新输入，其中 N 为启动时间间隔 (II)。如果 II 为 1，则表示每个时钟周期都处理新输入。

Vitis HLS 使用 PIPELINE 编译指示或指令时的默认行为是根据指定的时钟周期约束，为设计生成最小 II。除非指定 -II 选项，否则重点强调满足时序，而不是实现 II。

流水线的默认样式是由 config_compile -pipeline_style 命令定义的，但可在 PIPELINE 编译指示或指令内进行覆盖。

如果 Vitis HLS 无法按指定的 II 创建设计，它将：

• 发出警告。
• 以可能的最低 II 创建设计。

随后，您可利用警告消息来分析此设计，以判定必须采取哪些步骤才能创建满足所需启动时间间隔的设计。

语法

set_directive_pipeline [OPTIONS] <location>

其中：

• <location> 是要流水打拍的位置（格式为 function[/label]）。

选项

-II <integer>

指定期望的流水线启动时间间隔。Vitis HLS 会尝试满足此请求。根据数据依赖关系，实际结果的 II 可能更大。

-off

关闭特定循环或函数的流水线。当使用 config_compile -pipeline_loops 对循环进行全局流水打拍时，可使用该选项。

-rewind

注释： 仅适用于循环。

可选关键字。支持回绕，如 回绕已流水打拍的循环以保障性能 中所述。这样即可支持持续性循环流水打拍，但在循环执行结束与下一次执行开始之间没有暂停。仅当顶层函数内只有一个循环（或完美循环嵌套）时，回绕才有效。循环前的代码段：

• 被视为初始化。
• 在流水线中仅执行一次。
• 不能包含任何条件运算 (if-else)。

-style <stp | frp | flp>

指定要用于指定的函数或循环的流水线类型。如需了解有关流水线样式的更多信息，请参阅 刷新流水线和流水线类型。流水线类型包括：

stp

停止流水线。仅当输入数据可用时才运行，否则停滞。这是默认设置，也是 Vitis HLS 用于循环和函数流水打拍的流水线类型。无需可刷新流水线时，请使用此类型。例如，没有导致停滞的性能或死锁问题时即可用。

flp

该选项用于将流水线定义为可刷新流水线。此类型的流水线通常耗用更多资源和/或可能 II 较大，因为无法在流水线迭代间共享资源。

frp

自由运行的可刷新流水线。即使输入数据不可用也可运行。如果由于流水线控制信号扇出减少而导致需要更好的时序，或者如果需要提升性能以免死锁，则可使用此类型。但此流水线样式可能功耗更大，因为即使没有数据也会对流水线寄存器进行计时。

重要： 这是提示，而非硬性约束。工具会检查设计启用流水打拍的条件。部分循环可能不遵循特定样式，如果需要，工具会还原为默认样式 (stp)。

示例

函数 func 按指定启动时间间隔进行流水打拍。

set_directive_pipeline func II=1

另请参阅

• pragma HLS pipeline
• set_directive_dependence
• config_compile