1. Interface Synthesis

这一部分首先区分了两部分端口，他们二者是独立的。一个是 Block-level interface，是 HLS 综合后默认生成的，与函数的参数列表无关，用来管理和查看 module 的状态如 start，done 或 idle 等；另一个是 Port-level interface，包括了函数形参以及返回值所生成的 signal，这部分是代码中能看到的。以上两种对应的 Protocol 在下面会一一介绍。

为什么 clock port 没有什么生成呢？我猜测可能是其实际运行时背后已经包含了 ap_clk 和 ap_rsn ，后面图中的波形图里也可以看到。

a. Block-level Interface Protocol

这类 Protocol 只会作用于函数和函数的返回值。在 mode 设置上，常用 ap_ctrl_hs (handshake) ，其包含了一组控制和状态信号。但有时候没有必要查看其状态，此时便可设置为 ap_ctrl_none。

显而易见，不再赘述

从下图可以很直观地看到几个信号之间的变化关系。

b. Port-level Interface

对于函数形参，pass-by-value 类型只会有一个方向，对应生成的也只有一个 Port，默认为 ap_none 类型。而 pass-by-pointer 则既是 input 也是 output，默认会生成三个 port（包含一个 valid 信号），默认是 ap_ovld 类型。

ap_none 只针对于输入是 scalar ,ap_stable 只作用于 configuration inputs，只有当设备处在 reset mode 时才会发生改变。

只有 argument 为指针或者引用时（ in-out 模式）才会使用 ap_ovld mode，当 in-out 被拆分为 input 和 output 时 input port 会被设置为 ap_none mode，而 output 会被设置为 ap_vld mode。

Directive 修改有三种选择，从下图可以看到 ap_hs 其实是最复杂的，包含了 ap_vld 和 ap_ack 两种，后者是一个应答信号，并且分为了 in 和 out。

以上所有总结如下图

2. Summary

简单总结下，Block Level Protocol 包括三类。而 Port Level Protocol 主要分为 Scalar 和 Pointer & Reference 以及 Return 三种，其中 Scalar 和 Return 都只有一类，而 Pointer & Reference 可以分成 In，out 以及 In/Out 三种，这三种分别对应不同的 Protocol。从下图中可以看到，对于 Input 而言默认均为 ap_none 类型，而对于 Output 而言默认则都是 ap_vld 类型，只有 In/Out 默认才是 ap_ovld 类型(额外记住这个"o"即可，代表 output)。