13.13.1. ihc::stream分类

Intel® 高层次综合编译器专业版Pro版: 参考手册

下载 PDF

在收藏夹中：

Cyclone® V FPGAs and SoC FPGAs Support Intel® Cyclone® 10 GX FPGAs Support Intel® HLS Compiler Support for FPGAs Agilex™ 7 I-Series FPGA and SoC FPGA Support Intel® FPGA Development Tools Support Intel® Arria® 10 FPGAs Support Intel® Stratix® 10 FPGAs and SoC FPGAs Support Agilex™ 7 F-Series FPGA and SoC FPGA Support Agilex™ 7 FPGAs and SoC FPGAs Support

ID 683349

日期 12/04/2023

版本 23.4

Public

13.13.1. ihc::stream分类

表 50. Intel® HLS Compiler系统任务流接口模板总结
模板对象或参数	描述
`ihc::stream`	组件或任务功能的流接口。
`ihc::buffer`	指定与流相关的输入数据上FIFO缓冲区的容量（以字为单位）。
`ihc::usesPackets`	公开流接口上的`startofpacket`和`endofpacket`边带信号。

`ihc::stream`模板对象

句法: ihc::stream<datatype, template arguments >
有效值: 任何可轻松复制的C++数据类型。
默认值: N/A
描述: 组件或任务的流接口。
流数据总线的宽度等于sizeof(datatype)的宽度。

`ihc::buffer`模板参数

句法: ihc::buffer<value>
有效值: 非负整数值
默认值: 0
描述: 与流相关的输入数据上FIFO缓冲区的容量（以字为单位）。

`ihc::usesPackets`模板参数

句法: ihc::usesPackets<value>
有效值: true或false
默认值: false
描述: 公开流接口上的startofpacket和endofpacket边带信号，可以通过基于读/写的数据包来访问。

Intel® HLS Compiler任务系统流接口`stream`函数API

表 51. Intel® HLS Compiler流输入接口`stream`功能API
函数API	描述
`T read()`	从组件或任务内部使用的阻塞读调用（Blocking read call）
`T read(bool& sop, bool& eop)`	仅当设置了`usesPackets<true>`时可用。通过带外（out-of-band）`startofpacket`和`endofpacket`信号的阻塞读。
`T tryRead(bool &success)`	从组件或任务内使用的非阻塞读调用（Non-blocking read call）。如果该读取有效，则`success`布尔型被设置为true。
`T tryRead(bool& success, bool& sop, bool& eop)`	仅当设置了`usesPackets<true>`时可用。通过带外（out-of-band）`startofpacket`和`endofpacket`信号的非阻塞读取。
`void write(T data)`	从组件或任务来的阻塞写调用。
`void write(T data, bool sop, bool eop)`	仅当设置了`usesPackets<true>`时可用。通过带外（out-of-band）`startofpacket`和`endofpacket`信号的阻塞写入。
`bool tryWrite(T data)`	从组件或任务来的非阻塞写调用。返回值表示写入是否成功。
`bool tryWrite(T data, bool sop, bool eop)`	仅当设置了`usesPackets<true>`时可用。通过带外`startofpacket`和`endofpacket`信号的非阻塞写入。返回值表示写入是否成功。