HLS 常规选项 - 2023.2 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 简体中文
重要: 在 HLS 配置文件中的 [hls] 头文件下必须出现下列选项。
clock

指定时钟周期,以 ns 或 MHz 为单位,默认单位为 ns。如果不指定周期,将使用默认周期 10 ns。

clock=8ns
重要: 如果 HLS 配置文件使用 platform= 代替 part=,那么您还必须指定 freqhz= 代替 clock=(如此处所示)以更改平台的默认时钟频率。
clock_uncertainty
指定供 HLS 用作为裕度的时钟周期长短。将从时钟周期中扣除不确定性的裕度,以创建有效的时钟周期。时钟不确定性是以 ns 或者时钟周期的百分比来定义的。时钟不确定性默认设为时钟周期的 27%。指定该值时,默认单位为 ns,但也可以使用 % 或 MHz 作为单位。
clock_uncertainty=15%
flow_target

将流程目标设为综合 Vitis 内核 (.xo) 或 Vivado IP (.xci)。Vitis 内核用于应用加速流程,Vivado IP 可用于嵌入式软件设计流程。

重要: Vivado IP 与 Vitis 内核所支持的接口定义存在差异。

C 语言综合源文件

syn.cflags
定义要应用于所有 syn.file 定义的源文件的编译标志,以供在综合期间使用。
syn.cflags=-I../../src/
syn.csimflags

定义要应用于所有 syn.file 源文件的编译标志,以供在 C 语言仿真或 RTL/协同仿真期间使用。

syn.file

指定要在 HLS 组件综合期间使用的源文件的文件路径和名称。要指定多个文件,需添加多条 syn.file 语句。

文件路径可指定为绝对路径或相对路径,其中相对路径相对于配置文件的位置,无论是在 HLS 组件内部还是外部都是如此。
syn.file=../../src/dct.cpp
syn.file_cflags
将综合的编译标志应用于指定源文件。首先指定文件路径和名称,后接逗号,然后接 cflags:
syn.file_cflags=../../src/dct.cpp,-I../../src/
syn.file_csimflags
将仿真的编译标志应用于指定源文件。首先指定文件路径和名称,后接逗号,然后接 csimflags。
syn.file_csimflags=../../src/dct.cpp,-Wno-unknown-pragmas
syn.blackbox.file
指定用于 RTL 黑盒的 JSON 文件。此文件中的信息供 HLS 编译器在综合期间以及运行 RTL/协同仿真时使用。
syn.blackbox.file=../../RTL/fft.json
syn.top
指定函数名称,该函数将作为 HLS 组件的顶层函数来进行综合。在包含多个已定义的函数的源代码中,这可用于识别其中的顶层函数。
syn.top=dct
重要: 顶层函数调用的任意函数都将成为 HLS 组件的一部分。

测试激励文件源文件

tb.cflags arg
定义要应用于所有 tb.file 已定义的源文件的编译标志,以供在仿真或协同仿真期间使用。
tb.cflags=-Wno-unknown-pragmas
tb.file arg

指定要在 HLS 组件仿真或者协同仿真期间使用的测试激励源文件的文件路径和名称。要指定多个文件,需添加多条 tb.file 语句。

文件路径可指定为绝对路径或相对路径,其中相对路径相对于配置文件的位置,无论是在 HLS 组件内部还是外部都是如此。
tb.file=../../src/dct_test.cpp
tb.file_cflags arg
将用于仿真或协同仿真的编译标志应用于指定的测试激励源文件。首先指定文件路径和名称,后接逗号,然后接 cflags:
syn.file_cflags=../../src/dct.cpp,-Wno-unknown-pragmas