添加编译指示和指令 - 2023.2 简体中文

Vitis 高层次综合用户指南 (UG1399)

Document ID
UG1399
Release Date
2023-12-18
Version
2023.2 简体中文

HLS 编译指示和指令允许您配置代码的综合结果。

  • 在源代码中添加了 HLS 编译指示 以启用在原始源代码内执行最优化或更改。每次综合代码时,都会根据指定编译指示来实现代码。
  • HLS 最优化指令 可指定为与 HLS 组件关联的 HLS 配置文件命令。这些配置文件可跨多个 HLS 组件复用,以便您跨不同组件自定义同一代码库的综合结果。
重要: 在某些情况下,如果编译指示或指令与其他编译指示或指令存在冲突,那么综合进程会返回错误,直至冲突得以解决为止。但在某些情况下,遇到的第一条编译指示或指令优先于第二条编译指示或指令,并忽略第二条编译指示或指令。此信息应在 log 日志文件或控制台窗口内予以报告。

要将编译指示或指令添加到工程中,请执行以下操作:

  1. Vitis Component Explorer(Vitis 组件资源管理器)中的Sources(源文件)文件夹下选中 HLS 组件的源文件以将其打开。
  2. 打开源文件后,从 Vitis Unified IDE 靠右侧工具栏菜单中选中“HLS Directive”(HLS 指令)命令 (),以打开HLS Directive编辑器,如下图所示。
    图 1. “HLS Directive”编辑器
  3. HLS Directive编辑器会显示当前源代码的层级,以便您将指令或编译指示添加到设计中,指令会进入配置文件,编译指示则进入源文件。在上图中,添加到配置文件中的条目是:
    syn.directive.array_partition=dct_2d in_block factor=8 type=cyclic
    单击OK后,您即可看到它被添加到“Config File”(配置文件)编辑器中。
  4. HLS Directive编辑器中选择Add Directive(添加指令)命令,方法是选中要将指令添加到其中的函数、循环或变量,然后单击右侧“+”,如下图所示。

    选中指令旁的Edit Directive(编辑指令)命令即可修改现有指令。