文档目录
文档目录 x
1. Intel® HLS Compiler Pro版参考手册 2. 编译器 3. C语言和库支持 4. 组件接口 5. 组件存储器（存储器属性） 6. 组件中的循环 7. 组件并发 8. 任意精度数学支持 9. 组件目标频率(Target Frequency) 10. 任务系统 11. 库 12. 高级硬件综合控制 13. Intel® High Level Synthesis Compiler Pro版参考总结 A. 高级数学源代码库 B. 支持的数学函数 C. Cyclone® V限制 D. Intel® HLS Compiler Pro版参考手册存档 E. Intel® HLS Compiler Pro版参考手册修订历史
1. Intel® HLS Compiler Pro版参考手册 x
1.1. Intel® HLS Compiler待弃用
2. 编译器 x
2.1. Intel® HLS Compiler Pro版命令选项 2.2. 在您的组件中使用库 2.3. 编译器互操作性（Interoperability） 2.4. Intel® HLS Compiler硬件模式
2.3. 编译器互操作性（Interoperability） x
2.3.1. 单独编译您的测试台和组件
3. C语言和库支持 x
3.1. 支持用于组件综合的C和C++子集 3.2. C和C++库 3.3. 模板和重载函数 3.4. Intel® HLS Compiler Pro版编译器定义的预处理器宏
3.3. 模板和重载函数 x
3.3.1. 模板函数 3.3.2. 重载函数 3.3.3. 函数名称映射
4. 组件接口 x
4.1. 组件调用接口 4.2. Avalon® 流（Streaming）接口 4.3. 管道 4.4. Avalon® 存储器映射Host接口 4.5. Agent（代理）接口 4.6. 稳定的组件参数 4.7. 全局变量 4.8. 组件接口中的结构体 4.9. 复位行为
4.1. 组件调用接口 x
4.1.1. 标量参数 4.1.2. 指针和引用参数 4.1.3. 接口定义实例：组件调用接口控制属性 4.1.4. 接口定义实例：具有标量和指针自变量的组件
4.3. 管道 x
4.3.1. pipe类别及其用途
4.4. Avalon® 存储器映射Host接口 x
4.4.1. 存储器映射Host测试台构造函数（Constructor） 4.4.2. 描述存储器接口的隐式和显式实例 4.4.3. Avalon® Memory-Mapped Host接口和加载-存储-单元（Load-Store Units）
4.4.3. Avalon® Memory-Mapped Host接口和加载-存储-单元（Load-Store Units） x
4.4.3.1. Load-Store Unit类型 4.4.3.2. 存储器访问合并和加载-存储单元
4.5. Agent（代理）接口 x
4.5.1. 控制和状态寄存器（CSR）Agent 4.5.2. Agent存储器
5. 组件存储器（存储器属性） x
5.1. 静态变量
6. 组件中的循环 x
6.1. 循环启动间隔（ii预处理指令） 6.2. 循环依赖项（ivdep预处理指令） 6.3. 循环合并（loop_coalesce预处理指令) 6.4. 循环展开（unroll预处理指令） 6.5. 循环并发(max_concurrency预处理指令) 6.6. 循环迭代推测（speculated_iterations预处理指令 6.7. 循环流水线控制（disable_loop_pipelining预处理指令） 6.8. 循环交叉存取控制（max_interleaving预处理指令） 6.9. 循环融合（Loop Fusion）
6.9. 循环融合（Loop Fusion） x
6.9.1. 循环融合控制（loop_fuse预处理指令） 6.9.2. 循环融合豁免（loop_fuse预处理指令）
7. 组件并发 x
7.1. 存储器空间或I/O内的串行等效性 7.2. 并发控制（hls_max_concurrency属性） 7.3. 组件流水线控制（hls_disable_component_pipelining属性）
8. 任意精度数学支持 x
8.1. 声明ac_int数据类型 8.2. 声明ac_fixed数据类型 8.3. 声明ac_complex数据类型 8.4. AC数据类型和本地编译器 8.5. 声明hls_float数据类型
8.1. 声明ac_int数据类型 x
8.1.1. 关于ac_int数据类型的重要使用信息 8.1.2. 整数提升（Integer Promotion）和ac_int数据类型整 8.1.3. 调试您使用的ac_int数据类型
8.2. 声明ac_fixed数据类型 x
8.2.1. 运算中的任意精度定点Literal（字面常量）
8.5. 声明hls_float数据类型 x
8.5.1. hls_float数据类型支持的操作符和返回类型 8.5.2. hls_float.h提供的其他数据类型
9. 组件目标频率(Target Frequency) x
9.1. 指定目标II和目标fMAX的效果
10. 任务系统 x
10.1. 任务函数 10.2. 内部流 10.3. 任务系统模拟
11. 库 x
11.1. 静态对象库 11.2. 创建静态对象库 11.3. 从HLS代码创建对象 11.4. 从RTL代码创建对象 11.5. 将对象文件打包到库中
11.3. 从HLS代码创建对象 x
11.3.1. 从HLS代码创建对象 11.3.2. 支持的 OpenCL* 语言结构体
11.4. 从RTL代码创建对象 x
11.4.1. RTL模块和HLS流水线（Pipeline） 11.4.2. 从RTL模块创建静态对象文件
11.4.1. RTL模块和HLS流水线（Pipeline） x
11.4.1.1. RTL模块到HLS流水线（Pipeline）的集成 11.4.1.2. RTL模块接口 11.4.1.3. RTL复位和时钟信号 11.4.1.4. 对象清单文件句法 11.4.1.5. 将HLS数据类型映射到RTL信号 11.4.1.6. 基于RTL的函数的HLS仿真模型 11.4.1.7. RTL模块与部分重配置之间的潜在不兼容性 11.4.1.8. 无停顿（Stall-Free）RTL 11.4.1.9. HLS库的RTL模块限制和局限性
11.4.1.2. RTL模块接口 x
11.4.1.2.1. RTL模块接口信号
11.4.1.3. RTL复位和时钟信号 x
11.4.1.3.1. Intel Agilex® 7和 Intel® Stratix® 10无停顿（Stall-Free）和可停顿（Stallable）RTL模块的特定设计复位要求
11.4.1.4. 对象清单文件句法 x
11.4.1.4.1. ATTRIBUTES的XML元素 11.4.1.4.2. INTERFACE的XML元素 11.4.1.4.3. RESOURCES的XML元素
11.4.1.4.1. ATTRIBUTES的XML元素 x
11.4.1.4.1.1. ALLOW_MERGING和HAS_SIDE_EFFECTS元素之间的交互。
12. 高级硬件综合控制 x
12.1. 数学函数的硬件实现控制 12.2. hls_fpga_reg()函数
12.1. 数学函数的硬件实现控制 x
12.1.1. 数学函数硬件实现总结 12.1.2. --dsp-mode命令选项 12.1.3. ihc::math_dsp_control函数
13. Intel® High Level Synthesis Compiler Pro版参考总结 x
13.1. Intel® HLS Compiler Pro版i++命令行参数 13.2. Intel® HLS Compiler Pro版头文件 13.3. Intel® HLS Compiler Pro版编译器定义的预处理器宏 13.4. Intel® HLS Compiler Pro版关键字 13.5. Intel® HLS Compiler Pro版模拟API（仅测试台） 13.6. Intel® HLS Compiler Pro版组件存储器属性 13.7. Intel® HLS Compiler Pro版循环预处理指令 13.8. Intel® HLS Compiler Pro版范围预处理指令 13.9. Intel® HLS Compiler Pro版组件属性 13.10. Intel® HLS Compiler Pro版组件默认值接口 13.11. Intel® HLS Compiler Pro版组件调用接口控制属性 13.12. Intel® HLS Compiler Pro版组件宏 13.13. Intel® HLS Compiler Pro版技术性任务系统API 13.14. Intel® HLS Compiler Pro版管道API 13.15. Intel® HLS Compiler Pro版流输入接口 13.16. Intel® HLS Compiler Pro版流输出接口 13.17. Intel® HLS Compiler Pro版存储器映射接口 13.18. Intel® HLS Compiler Pro版加载-存储单元控制 13.19. Intel® HLS Compiler Pro版任意精度数据类型
13.13. Intel® HLS Compiler Pro版技术性任务系统API x
13.13.1. ihc::stream分类
A. 高级数学源代码库 x
A.1. 随机数生成程序库 A.2. 矩阵乘法库 A.3. 乔莱斯基分解（Cholesky Decomposition）库
B. 支持的数学函数 x
B.1. math.h头文件提供的数学函数 B.2. extendedmath.h头文件提供的数学函数 B.3. ac_fixed_math.h头文件提供的数学函数 B.4. hls_float.h头文件提供的数学函数 B.5. hls_float_math.h头文件提供的数学函数 B.6. 默认舍入方案和非规格数（Subnormal Number）支持
1. Intel® HLS Compiler Pro版参考手册
2. 编译器
3. C语言和库支持
4. 组件接口
5. 组件存储器（存储器属性）
6. 组件中的循环
7. 组件并发
8. 任意精度数学支持
9. 组件目标频率(Target Frequency)
10. 任务系统
11. 库
12. 高级硬件综合控制
13. Intel® High Level Synthesis Compiler Pro版参考总结
A. 高级数学源代码库
B. 支持的数学函数
C. Cyclone® V限制
D. Intel® HLS Compiler Pro版参考手册存档
E. Intel® HLS Compiler Pro版参考手册修订历史

E. Intel® HLS Compiler Pro版参考手册修订历史

文档版本 Intel® HLS Compiler Pro Edition版本 修订内容
2023.12.04 23.4
  • 维护版本。

    更新了版本23.4的<quartus_installdir>路径信息。

2023.10.02 23.3
  • 维护版本。

    更新了版本23.3的<quartus_installdir>路径信息。

2023.06.26 23.2
  • 维护版本。

    更新了版本23.2的<quartus_installdir>路径信息。

2023.06.02 23.1
2023.05.26 23.1
2023.05.05 23.1
  • 在任意精度数学支持的“Limitations of the Intel® HLS Compiler Arbitrary Precision Floating Point Data Type”中添加了局限性。
2023.04.03 23.1

  • 更新了版本23.1的<quartus_installdir>路径信息。

  • 将产品系列名称更新为“Intel Agilex 7”。
2022.12.19 22.4
  • 添加了待弃用通知。
  • 更新了版本22.4的<quartus_installdir>路径信息。
2022.09.23 22.3
  • 维护版本。

    更新了版本22.3的<quartus_installdir>路径信息。

2022.06.20 22.2
2022.03.28 22.1
2021.12.13 21.4
2021.10.04 21.3
  • 更新了--simulator 命令选项的描述，以包含Siemens* EDA Questa*支持。
2021.05.21 21.2
  • 在任意精度数学支持添加了关于将hls_float数据类型转换为无符号整数数据类型的限制 。
  • 修改了Avalon接口的参考，以与新的Avalon Interconnect术语保持一致。Avalon master接口改为Avalon host接口，Avalon从接口改为Avalon agent接口。
  • 重命名接口以与新的Avalon Interconnect术语保持一致。使用旧术语的接口已被弃用。使用新术语的接口替换如下所示：
    表 82.   Intel® HLS Compiler接口变更
    弃用的接口 替换接口
    hls_avalon_slave_component hls_avalon_agent_component
    hls_avalon_slave_register_argument hls_avalon_agent_register_argument
    hls_avalon_slave_memory_argument hls_avalon_agent_memory_argument
    mm_master mm_host

    如果您使用已弃用的接口，则在编译组件时可能会收到警告消息。
2021.03.29 21.1
2020.12.14 20.4
2020.09.28 20.3
2020.06.22 20.2
2020.05.13 20.1
2020.04.13 20.1
2020.02.10 19.4
2020.01.27 19.4
2019.12.16 19.4

Intel® HLS Compiler参考手册的文档修订历史

先前版本的 Intel® HLS Compiler参考手册包含 Intel® HLS Compiler Standard Edition和 Intel® HLS Compiler Pro Edition的信息。

文档版本 Intel Quartus Prime版本 修订内容
2019.09.30 19.3
2019.09.10 19.2
  • 修正了Intel HLS Compiler Pro版命令选项中关于-c选择描述中的笔误。以"When you later compile the.o file..."开头的句子以更正为，"When you later link the .o file"。
2019.07.01 19.2
2019.06.04 19.1
  • 在Slave Memories中，明确了从存储器存储器属性的用途。
  • 在组件存储器（存储器属性）中，阐明了 Intel® HLS Compiler Pro Edition和 Intel® HLS Compiler Standard Edition存储器属性支持。
2019.05.03 19.1
2019.04.01 19.1
2019.01.03 18.1..1
2018.12.24 18.1.1
  • 删除了有关“HLS/iostream”头文件的信息。此头文件提供的函数由标准 C++ iostream头和HLS_SYNTHESIS宏替换。
  • 对C和C++库添加了HLS_SYNTHESIS宏的描述 。
2018.12.24 18.1
2018.09.24 18.1
  • Intel® HLS Compiler有一个新的前端。有关该新前端引入的更改内容的摘要，请参阅 Intel® HLS Compiler版18.1发布笔记中的Improved Intel HLS Compiler Front End。
  • Pro版本中不再支持-promote-integers标志和best_practices/integer_promotion教程，因为现在默认进行整型提升（integer promotion）。标准版中仍然支持该标志和教程。
  • 通过hls_avalon_slave_component参数调用的组件必须采用从属或稳定参数。如果组件参数不是从属或稳定参数，则编译组件来生成错误消息。 对Component Invocation Interface Control Attributes和Quick Reference中hls_avalon_slave_component参数的描述现在反映这一要求。
  • 在组件中的循环中，阐明了适用于循环的指令声明必须优先处理适用于该指令的循环。
  • 在声明ac_int数据类型中，添加了将ac_int变量初始化为大于64位要求。您必须使用ac::init_array构造函数将ac_int变量初始化到大于64位。
  • 在静态变量中，删除了对文件范围的静态变量应用存储器属性的限制。可以对文件范围和函数范围的静态变量应用存储器属性。
2018.07.08 18.0
  • 在静态变量中，突出显示只有在组件函数内声明静态变量时，将存储器属性应用于静态变量才会有效。
  • 在控制和状态寄存器（CSR）Agent中更正了笔误。将句子” You do not need to use the hls_avalon_slave_component attribute to use the hls_avalon_slave_component attribute”更改为You do not need to use the hls_avalon_slave_component attribute to use the hls_avalon_slave_register_argument attribute".
2018.05.07 18.0
  • 从Intel Quartus Prime 18.0开始， Intel® HLS Compiler支持的功能和器件取决于您的Intel Quartus Prime版本。现在 Intel® HLS Compiler发布版本使用图标表示适用于特定版本的功能或内容：
    表示功能或内容仅适用于Intel Quartus Prime Pro Edition提供的 Intel® HLS Compiler。
    表示功能或内容仅适用于 Intel® Quartus® Prime Standard Edition提供的 Intel® HLS Compiler。
  • 更正了 Intel® HLS Compiler Streaming Input Interfaces Code Example中的代码实例。更正后的行是int x = a.tryRead(success); (was int x = a.tryRead(&success);).
  • 对Command Options中的[Fb519042-march MAX10[FB519042] 选项添加了脚注]，该脚注是关于在您综合 Intel® MAX® 10器件的组件IP之前所需要的先决条件。
2017.12.22 17.1..1
  • 更新了Slave Memories中hls_avalon_slave_memory_argument(N)的描述，以包含参数值N是以字节为单位描述的存储器的大小。
2017.11.06 17.1
  • 更新了支持的数学函数如下：
    • 注明仅 Intel® HLS Compiler支持HLS/extendedmath.h头文件，而非由GCC或MSVC编译器支持。
    • 将popcount添加到HLS/extendedmath.h头文件支持的函数清单。
    • 扩展了HLS/extendedmath.h提供的函数清单，以明确列出函数的双精度和单精度浮点版本。
    • 添加了不同数据类型的可用popcount函数变量列表。
  • 重新组织了本书的整体结构，将第1章分成若干较小章节并改变了章节顺序。
  • 更新了提及HLS或i++安装目录的内容，以将 Intel® Quartus® Prime Design Suite安装目录作为起点。
  • 将以下内容移至 英特尔®高层次综合编译器最佳实践指南：
2017.06.23 —
  • 更新了静态变量以添加关于静态变量初始化及其控制方法的信息。
  • 少量修改内容和更正。
2017.06.09 —
  • 删除了所有提及--device编译器选项的内容。此选项已被-march编译器选项已更改函数取代。请参阅Intel HLS Compiler Pro版命令选项了解关于-march编译器选项已更改函数的详细信息。
  • 在组件接口中添加了关于组件接口结构的信息。
  • 修改了C和C++库以提供关于对iostream行为更新的内容。
2017.02.03 —
  • 在标量参数和Avalon流接口中，更新了Avalon-ST接口的可用标量参数列表中的信息。
  • 在指针参数、引用参数和Avalon Memory-Mapped Master中，更新了Avalon-MM接口配置的可用模板参数列表中的信息。
  • 在全局变量中添加了关于区域使用以及全局常量、指针和变量优化的新信息。
2016.11..30 —
  • 在 HLS Compiler Command Options中，修改了Command Options that Customize Compilation表格中的内容，具体方式如下：
    • 删除了--rtl-only命令选项及其描述，因为不再使用该命令选项。
    • 添加了--simulator <name>命令选项及其描述。
    • 删除了-g命令选项，因为HLS编译器现在默认以报告形式生成Windows和Linux的调试信息。此外，Linux的最终二进制文件中默认提供调试数据。
  • 在指针参数、引用参数和Avalon Memory-Mapped Master接口中，在表格中添加了关于altera::align<value>模板参数的信息。
  • 添加了主题存储器映射测试台构造器和创建存储器映射主测试台的隐式和显式实例。
  • 在组件调用协议宏的用法实例中，将代码实例中的组件调用协议属性替换为相应的宏。
  • 将行#include "HLS/hls.h”添加到代码片段，如下：
    • 接口综合宏的用法实例
    • 组件调用协议宏的用法实例
  • 添加了任意精度整数支持主题以介绍ac_int数据类型和英特尔提供的ac_int.h头文件。包括以下子主题：
    • 在定义了组件中的ac_int数据类型以支持任意精度整数
    • 关于ac_int数据类型的重要使用方法信息
  • 更新了Area Minimization and Control of On-Chip Memory Architecture中的内容：
    • 使用单个numports_readonly_writeonly(m,n)表值取代Attributes for Controlling On-Chip Memory Architecture表格中的numreadports(n)和numwriteports(n)表值。
    • 添加了关于hls_simple_dual_port_memory宏的信息。
    • 添加了关于hls_merge ("label","direction")和hls_bankbits(b0, b1, ..., bn)属性的信息。
  • 添加了hls_merge("label"、"direction") 和 hls_bankbits(b0、b1, ..., bn)属性的实例用例。
  • 添加了hls_bankbits规范与存储器地址位之间的关系主题以解释存在hls_bankbits和hls_bankwidth属性的情况下存储器地址的推导。
2016.09.12 — 首次发布。
二级标题