Vivado HLS中常见的接口类型

Vivado HLS中常见的接口类型有：

1. ap_none

默认类型，该类型不适用任何I/O转换协议，它用于表示只读的输入信号，对应于HDL中的wire类型。

2. ap_stable

只用于输入信号，其具体实现方式仍为ap_none。它用于向Vivado HLS的综合器表明该信号在两次复位之间值是不变的。

3. ap_vld

在数据端口port_name的基础上创建一个额外的数据有效信号指示_vld。

4. ap_ack

在数据端口port_name的基础上创建一个额外的应答信号指示_ack。

5. ap_hs

使用该类型，则会同时创建额外的数据有效信号和应答信号，其效果相当于ap_vld与ap_ack之和。

6. ap_ovld

对于输入信号，其效果与ap_none是一样的。

对于输出信号，其效果与ap_vld是一样的。

对于双向（inout）类型的信号，输入使用ap_none，输出使用ap_vld进行处理。

7. ap_memory

把对数组的读写等效为对外部RAM的引用。

8. ap_fifo

把对数组、指针和参数引用的读写用FIFO的方式来实现。

9. ap_bus

把对指针和参数引用的读写用总线接口的方式来实现。

在TCL脚本中，我们也可以对接口类型进行更改。在图形化的开发界面中，可以直接在directives.tcl中进行规则的编辑，如图1所示。

图1 通过TCL配置改变端口类型

此外，我们还可以通过在Vivado HLS中的Directive视图中选择INTERFACE来进行更改，如图2所示。

图2 接口的类型选择

例如：

void adders_io(intin1,intin2,int*in_out1)

{

*in_out1 = in1 + in2 + *in_out1;

}

这里我们使用了指针。从其本质上来说，指针是一个“双向”的类型，即它即可以做为输入，同时也可以用来输出。在默认的情况下，端口的综合结果如图3所示。

图3 默认情况下的端口综合结果

如果按照图1中的示例对端口类型进行指定，则C综合之后的结果如图4所示。

图4 自定义端口类型之后的端口综合结果

在图1的示例中，我们指定了端口的类型，所以对比图3与图4，可以看出，端口in1和in2的类型从默认的ap_none变为自定义的ap_vld，并且分别具有了对应的数据有效指示位in1_ap_vld和in2ap_vld。

一、Block-level接口协议(块级接口协议,与函数本身相关联，不与任何数据端口相关联)

Block-Level Interface端口：
顾名思义，Block端口的作用就是用来控制Block的操作。它在c参数中没有直接的对应，但是它对应了c函数的调用/返回过程。默认Block端口都会加上，如果不需要，可以对函数顶层设置ap_none。

ap_ctrl_none:没有块级I/O控制协议

ap_ctrl_chain:它同ap_ctrl_hs几乎一样，除了多出一个输入信号ap_continue，它可以使得下游模块控制上游模块的运行/终止。不过这种模式比较不常用，所以有兴趣的读者，可以自己去研究相关的文档。

ap_ctrl_hs:块级I/O控制握手协议，我们已经采用的(ap_start,ap_ready,ap_idle,ap_done)

ap_ctrl_hs是默认的端口类型，它综合出来的端口会有额外的4个系统控制信号，如下所示：
图片居中使用：

其端口行为时序如下：

在ap_rst释放后，ap_start高电平启动模块的运行，然后ap_idle立即拉低表明模块不再空闲。

ap_ready拉高表明本模块已经准备好接收新的输入，不过它的行为会稍微有些复杂，在non-pipelined实现中，ap_ready和ap_done会同时拉高；在pipelined实现中，它可能会随时拉高。

二、Port-level接口协议

Port端口会跟c的参数有直接的对应关系。按照c参数的不同，标量，数组，指针，HLS综合后的rtl端口也有很多中不同的类型可供选

a) ap_ovid ：一般用于in-out指针

b) ap_none

c) ap_hs:包括ap_vld（使能）ap_sck（应答）

其中Port level是我们需要重点关注的，它又可以细分为4中类型：(出处：http://xilinx.eetrend.com/blog/9935 )

A. AXI4-Interface：支持Stream，Lite，Full共3中类型
B. NO I/O协议：无端口协议
C. Wire Handshakes：握手协议
D. Memory Interface：内存访问型的端口协议

各种rtl端口协议和c参数类型的对应关系如下：

三、其他

1.可以IO口添加寄存器，目的是可以控制输入输出波形。（添加寄存器条件是要配置成：ap_hs）

2.可以对设计添加全局使能端口。

编辑：hfy