pragma HLS interface 端口综合

最新推荐文章于 2025-03-28 14:22:03 发布
原创 最新推荐文章于 2025-03-28 14:22:03 发布 · 1.1w 阅读 · 73 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#hls

本文深入解析pragmaHLS接口语法，涵盖多种接口模式如ap_vld、ap_ack及AXI系列，详解如何在VivadoHLS中指定端口协议、寄存选项与深度配置，帮助读者掌握高效RTL设计技巧。

这是针对pragma HLS interface 语法的翻译笔记，可以作为原英文文档的辅助文档，原文地址是SDSoc Development Help

正文

在vivado HLS基于C的设计中，函数形式参数代表了输入和输出操作。但是在RTL设计中，必须设计接口来执行这些输入和输出操作，并且通常使用特定的I / O（输入-输出）协议进行操作。有关更多信息，请参考《Vivado Design Suite用户指南：高级综合（UG902）》中的“Ch.1 Manage Interface” 。（推荐参考：对ug902中manage interface部分的优质翻译）

INTERFACEpragma指定如何在接口合成期间依据函数定义创建RTL端口。
RTL实现中的端口派生自:

  • 指定的任何函数级协议
  • 函数参数
  • 由顶级函数访问的，并且是在其作用域之外定义的全局变量

Function-level protocols（函数层级的协议）也称为block-level I/O protocols（块级I/O协议），用于提供信号来控制函数何时开始操作，并指示函数操作何时结束、空闲和准备好接受新的输入。函数级协议的实现:

  • 由值指定为三种模式ap_ctrl_none， ap_ctrl_hs或ap_ctrl_chain。其中的 ap_ctrl_hs是默认的块级I / O协议。
  • 与函数名相关联。

port-level (I/O) interface protocol（端口级I / O接口协议）:可以为每个函数参数指定port-level (I/O) interface protocol（端口级I / O接口协议），如有效握手（ap_vld）或确认握手（ap_ack）。如果函数会返回一个值，则为顶层函数和函数返回中的每个参数创建端口级I/O接口协议。创建的默认I/O协议取决于C参数的类型。在使用块级IO协议启动块的操作后，使用端口级IO协议对数据进行序列输入和输出。

如果访问了全局变量，但所有读和写操作都是design的本地操作，即是在design中创建资源，那么在RTL中不需要I/O端口。如果全局变量是外部源或地址，则以类似的方式将其接口指定为标准函数参数。参见下面的示例。
当INTERFACEpragma用于子函数时，只能使用register选项。子函数不支持< mode>选项。

提示:Vivado HLS自动确定任何子函数使用的I/O协议。除了指定端口是否寄存外，您无法控制这些端口。

语法

将pragma放在函数内。

#pragma HLS interface <mode> port=<name> bundle=<string> \
register register_mode=<mode> depth=<int> offset=<string> \
clock=<string> name=<string> \
num_read_outstanding=<int> num_write_outstan
最低0.47元/天 解锁文章
【二 HLS】HLS接口的简单介绍
xzs520xzs的博客
09-03 3387
vivado HLS中包含了大量的视频库函数，方便进行视频处理。HLS中的视频库函数代替了处理算法的openCV功能函数，而OpenCv函数用来访问输入输出图像。HLS视频库中许多视频的概念和OpenCV非常的相似，很多图像处理函数和OpenCV库函数一致。这两行代码的参数形式，图像尺寸最大值、语法规则不同，生成的对象是类似的。这位博主关于HLS的解释更为详细，推荐阅读【传送门】
dataflow区域使用ap_ctrl_none协议-vivado hls第四十一章
最新发布
dong6016的博客
10-13 426
也就是说，在此示例中，demux 的执行频率可达 worker1 和 worker2 的 2 倍。1.使用ap_ctrl_none洗液会避免使用ap_Ctrl_hs和ap_Ctrl_chain协议，因为ap_ctrl_hs。b.region区域的父级，包括顶层设计都需要满足也被dataflow指令指定，并且接口也指定为ap_ctrl_none。和ap_ctrl_chain协议暗示hls ip模块需要做同步方案的设计。内所有的proc进程的执行次数完全相同，这个可以理解，数据流的上下游执行的次数是应该完全。
卷积函数的FPGA实现（四）函数接口的HLS
祥瑞的技术博客
12-10 4618
背景：编写好IPcore并且验证通过，但是接口需要进行HLS。 目的：将卷积IPcore接口进行HLS，将权重输入输出同步为DRAM的地址，axi-stream协议进行传输数据。将神经网络参数通过axi-lite协议进行传输。 参考： 用IPcore调用DDR3相关知识 https://blog.csdn.net/weixin_36474809/article/details/810180...
HLS新手入门教程
热门推荐
凳子花❀的博客
02-16 2万+
HLS新手入门笔记
HLS常用语法-AXI4
monkeynight的博客
04-13 1091
其中，directive_name是具体的指令名称，directive_options是指令的参数。
HLS Interface
weixin_30824479的博客
06-05 1710
Managing Interfaces Vivado HLS supports two solutions for specifying the type of I/O protocol used:• Interface Synthesis, where the port interface is created based on efficient industrystandard ...
HLS第十八课（pragma，interface, resource, stream）
Huskar_Liu的博客
10-20 1492
对函数的端口和存储单元的任何编译控制，都体现在pragma中。 下面对一些常用的pragma进行详细说明。 +++++++++++++++++++++++++++++++++++++++
为什么这段代码读写数据不是流水线的void bram_controller( bool read_enable, bool write_enable, addr_t write_address, addr_t read_address, data_t data_in, data_t* data_out ) { #pragma HLS INTERFACE ap_none port=write_enable #pragma HLS INTERFACE ap_none port=write_address #pragma HLS INTERFACE ap_none port=data_in #pragma HLS INTERFACE ap_none port=read_address #pragma HLS INTERFACE ap_none port=data_out #pragma HLS INTERFACE ap_none port=read_enable #pragma HLS INTERFACE ap_ctrl_none port=return // 静态存储区 - 综合为BRAM资源 static data_t bram[MEM_SIZE]; #pragma HLS BIND_STORAGE variable=bram type=ram_2p // 主控制逻辑 if(write_enable) { // 写操作：存储数据并回显 bram[write_address] = data_in; } if(read_enable) { *data_out = bram[read_address]; } }
07-22
#pragma HLS INTERFACE ap_ctrl_none port=return #pragma HLS PIPELINE II=1 while (1) { // 从端口读取输入 // 调用bram_controller bram_controller(...); } } ``` 在top函数中，我们使用一个无限循环...
HLS第二十八课（UG871，接口综合）
Huskar_Liu的博客
10-30 1724
接口的返回值，入口参数，都是需要用pragma约束的。
WARNING: [HLS 207-5553] Unsupported interface port data type in '#pragma HLS interface ap_none' (SRC/Cpp_USA_324.cpp:17:38) WARNING: [HLS 207-5553] Unsupported interface port data type in '#pragma HLS interface ap_none' (SRC/Cpp_USA_324.cpp:18:38)
03-26
因此，在设计函数签名及其对应的 `#pragma HLS interface` 指令时，应确保输入/输出参数采用简单且可综合的数据类型。 对于上述情况，可以尝试以下方法： 1. **调整数据类型** 如果当前使用的数据类型较为复杂，...
分析一下这段代码：#include "SmoothProfileOnXAxisMean.h" void SmoothProfileOnXAxisMean(hls::stream<float>& points_in_z, hls::stream<float>& smoothed_z, ap_uint<6> mean_win_size, float invalid_z) { #pragma HLS INTERFACE axis port=points_in_z #pragma HLS INTERFACE axis port=smoothed_z #pragma HLS INTERFACE ap_none port=mean_win_size #pragma HLS INTERFACE ap_none port=invalid_z #pragma HLS INTERFACE ap_ctrl_none port=return #pragma HLS PIPELINE II=1 // 使用移位寄存器实现窗口存储 static float shift_reg[33]; #pragma HLS ARRAY_PARTITION variable=shift_reg type=complete dim=1 // 窗口状态管理 static ap_uint<6> last_win_size = 0; static ap_uint<1> win_size_changed = 0; static int data_count = 0; // 并行计算单元 float window_sum = 0; int valid_count = 0; float center_value = 0; // 读取新数据（流控制） float new_value = (data_count < 3200) ? points_in_z.read() : invalid_z; // 窗口大小变化检测与处理 if (mean_win_size != last_win_size) { last_win_size = mean_win_size; win_size_changed = 1; } // 窗口大小变化时重置寄存器 if (win_size_changed) { #pragma HLS UNROLL for (int i = 0; i < 33; i++) { shift_reg[i] = invalid_z; } win_size_changed = 0; data_count = 0; } // 计算窗口中心位置 const int half_win = last_win_size >> 1; // 等价于/2 // 并行移位寄存器更新 #pragma HLS UNROLL for (int i = 32; i > 0; i--) { shift_reg[i] = shift_reg[i-1]; } shift_reg[0] = new_value; // 获取中心点值（用于边界判断） center_value = shift_reg[half_win]; // 并行窗口求和与有效计数 #pragma HLS UNROLL for (int i = 0; i < 33; i++) { #pragma HLS EXPRESSION_BALANCE bool in_window = (i < last_win_size); bool is_valid = (shift_reg[i] != invalid_z); if (in_window && is_valid) { window_sum += shift_reg[i]; valid_count++; } } // 边界处理逻辑 bool is_boundary = (data_count < last_win_size) || (data_count >= 3200); bool center_invalid = (center_value == invalid_z); // 输出决策 if (center_invalid || is_boundary) { smoothed_z.write(center_value); } else { float result = (valid_count > 0) ? (window_sum / valid_count) : invalid_z; smoothed_z.write(result); } // 更新数据计数器 if (data_count < 3200 + half_win) { data_count++; } }
07-23
- 求和部分：33个并行浮点加法器，但HLS可能会综合成加法树，但加法树深度为log2(33)≈5级，但每个加法器都是浮点，资源消耗大。 - 注意：在窗口大小变化时，有一个循环33次的复位操作，虽然被展开，但会占用大量...
HLS之接口设计
风间琉璃的博客
11-08 4949
Vitis HLS设计接口介绍。
HLS Pargmas(2) interface
wzx_numberone的博客
08-18 187
Defining Interfaces 接口综合 在Vitis的HLS设计中，顶层函数的参数被合成为接口和端口，这些接口和端口将多个信号分组，以定义HLS设计和外部组件之间的通信协议。Vitis HLS自动定义接口，使用行业标准来指定使用的协议。 AP_Memory in the Vivado IP Flow 在Vivado IP流中，它用于与内存资源(如BRAM和uram)进行通信 Description ...
HLS接口综合-基本介绍
qq_36334929的博客
09-14 2862
目录Interface synthesis OverviewBlock-level Interface protocol三种可用的protocol（协议）ap_ctrl_hs vs. ap_ctrl_noneblock-level接口参数介绍port-level interface protocol对于输入形参对于双向的参数（in-out）（ap_ovld）其他接口信号信号类型以及对应的接口支持 Interface synthesis Overview 如上图所示，对于蓝色区域的C语言代码，在下方viva
HLS 接口综合_增加协议特点
qq_35608277的博客
03-03 1093
接口综合有两种，分别是 block-level interface protocol 和 port-level interface protocol。 接口综合只对顶层函数及其参数有用。 三小类： 控制整个顶层函数的握手信号接口 参数和指针接口 返回值接口 （2）默认情况下，函数的值传递参数和指针参数会用没有 handshaking 信号的简单 wire ports 来实现。如果函数有返...
HLS顶层函数
bufengzj的博客
07-19 1987
顶层函数不一定是主函数，但是顶层函数即就是你要生成的硬件输入输出的形式： 如下面一段C=A*B的乘法加速器代码： 其顶层函数为：void mmult_accel_core，定义了输入，输出两个数据流，即会对应生成硬件的端口 void mmult_accel_core (AXI_VAL in_stream[2*SIZE], AXI_VAL out_stream[SIZE]) {     // ...
Vivado HLS AXI4接口 学习笔记（二）
qq_42376352的博客
01-12 3690
1 端口级接口协议:AXI4接口 Vivado HLS支持的AXI4接口包括AXI4- stream (axis)和AXI4- lite(s_axilite)和AXI4 master (m_axi)接口 AXI4-Stream接口:只指定输入参数或输出参数，而不指定输入/输出参数。 AXI4-Lite接口:指定除数组以外的任何类型的参数。你可以在同一个AXI4-Lite接口中添加多个参数。 AXI4-master接口:仅在数组和指针(以及c++中的引用)上指定。你可以将多个参数分组到同一个AXI4接
HLS学习（二）Using AXI4 Interfaces
crazyeden的博客
01-24 6284
第一部分 AXI4-Stream Interfaces  暂时不细看。 第二部分 AXI4-Lite Interface 作用：use an AXI4-Lite interface to allow the design to be controlled by a CPU or microcontroller。  HLS会自动给各个使用axilite接口的port分配地址，会在驱动文件...
Vivado HLS 优化指令详解
whik1194的博客
03-28 1376
Vivado HLS (High-Level Synthesis) 提供了一系列优化指令(Pragmas)来指导高层次综合过程，帮助开发者优化硬件设计。
评论 3
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值