已弃用功能特性和不受支持的功能特性

已弃用功能特性和不受支持的功能特性 - 2023.2 简体中文

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

Document ID

UG1399

Release Date

2023-12-18

Version

2023.2 简体中文

AMD Vitis™ HLS 已弃用多条 AMD Vivado™ HLS 命令。下表列出了这些已弃用的命令，这些命令在未来版本中将停用，不建议使用。

表 1. Vitis HLS 中弃用的 Vivado HLS 命令
类型	命令	选项	Vitis HLS	详细信息
config	`config_interface`	`-m_axi_max_data_size`	已弃用
config	`config_interface`	`-m_axi_min_data_size`	已弃用
config	`config_interface`	`-m_axi_alignment_byte_size`	已弃用
config	`config_interface`	`-m_axi_offset=slave`	不支持	现在通过 `-m_axi_offset=direct` 与 `-default_slave_interface=s_axilite` 组合来处理此操作
config	`config_interface`	`-expose_global`	不支持	在 Vitis HLS 中不支持将全局变量作为 IP 或内核中的顶层端口予以公开。
config	`config_interface`	`-trim_dangling_port`	不支持
config	`config_array_partition`	`-auto_promotion_threshold`	已弃用
config	`config_array_partition`	`-auto_partition_threshold`	已弃用	已重命名为 `-complete_threshold`
config	`config_array_partition`	`-scalarize_all`	不支持
config	`config_array_partition`	`-throughput_driven`	不支持
config	`config_array_partition`	`-maximum_size`	不支持
config	`config_array_partition`	`-include_extern_globals`	不支持
config	`config_array_partition`	`-include_ports`	不支持
config	`config_schedule`	除 `-enable_dsp_fill_reg` 外的所有选项	已弃用
config	`config_bind`	*（所有选项）	已弃用
config	`config_rtl`	`-encoding`	已弃用	FSM 编码为独热码。
config	`config_sdx`	*（所有选项）	已弃用
config	`config_flow`	*（所有选项）	已弃用
config	`config_dataflow`	`-disable_start_propagation`	已弃用
config	`config_rtl`	`-auto_prefix`	已弃用	已替换为 `config_rtl -module_prefix`。
config	`config_rtl`	`-prefix`	已弃用	已替换为 `config_rtl -module_prefix`。
config	`config_rtl`	`-m_axi_conservative_mode`	已弃用	使用 `config_interface -m_axi_conservative_mode`
指令/编译指示	`set_directive_pipeline`	`-enable_flush`	已弃用
指令/编译指示	`CLOCK`	*	不支持
指令/编译指示	`DATA_PACK`	*	不支持	如果需要，请使用 AGGREGATE 编译指示或指令和 `__attribute__(packed(X))`。
指令/编译指示	`INLINE`	-region	已弃用
指令/编译指示	`INTERFACE`	`-mode ap_bus`	不支持	使用 `m_axi` 代替。
指令/编译指示	`INTERFACE`	`-mode ap_stable`	已弃用	改用 STABLE 编译指示或指令。
指令/编译指示	`ARRAY_MAP`	*	不支持
指令/编译指示	`RESOURCE`	*	已弃用	已替换为 BIND_OP 和 BIND_STORAGE 编译指示和指令。对于顶层函数实参，请将 INTERFACE 编译指示或指令与 `storage_type` 选项搭配使用。
指令/编译指示	`SHARED`	*	已弃用	`SHARED` 编译指示或指令已移至 `STREAM` 编译指示或指令的 `type=shared` 选项。
指令/编译指示	`STREAM`	`-dim`	不支持
指令/编译指示	`STREAM`	`-off`	已弃用	`STREAM off` 已改为 `STREAM type=pipo`
工程	`csim_design`	`-clang_sanitizer`	添加/重命名
工程	`export_design`	`-use_netlist`	已弃用	已替换为：`export_design -format ip_catalog`
工程	`export_design`	`-xo`	已弃用	已替换为：`export_design -format xo`
工程	`add_files`		不支持	System-C 文件不受 Vitis HLS 支持。
config	`config_export`	`-disable_deadlock_detection`	已弃用	已替换为：`config_export -deadlock_detection_sim`
已弃用：在未来版本中将发出终止使用相关编译指示的警告消息。不支持：Vitis HLS 将报错，并输出有效消息。 *：命令中的所有选项。

下列库均已弃用。

表 2. 已弃用的库
库	API	已弃用	建议的替代/操作
线性代数库 `hls_linear_algebra.h` `hls/hls_axi_io.h` `hls/hls_linear_algebra_io.h` `hls/linear_algebra` `\|-- deprecated` `\| \|-- x_complex_back_substitute.h` `\| \|-- x_complex_cholesky.h` `\| \|-- x_complex_cholesky_inverse.h` `\| \|-- x_complex_matrix_multiply.h` `\| \|-- x_complex_matrix_tb_utils.h` `\| \|-- x_complex_matrix_utils.h` `\| \|-- x_complex_qr_inverse.h` `\| \|-- x_complex_qrf.h` \| `-- x_complex_svd.h `\|-- hls_back_substitute.h` `\|-- hls_cholesky.h` `\|-- hls_cholesky_inverse.h` `\|-- hls_matrix_multiply.h` `\|-- hls_qr_inverse.h` `\|-- hls_qrf.h` `\|-- hls_svd.h` `-- utils `\|-- std_complex_utils.h` `\|-- x_hls_complex.h` `\|-- x_hls_matrix_tb_utils.h` `-- x_hls_matrix_utils.h	cholesky float、ap_fixed、x_complex<float> 或 x_complex<ap_fixed>	已弃用	Vitis 解算器 potrf float 或 double
	cholesky_inverse float、ap_fixed、x_complex<float> 或 x_complex<ap_fixed>		Vitis 解算器 pomatrixinverse float 或 double
	matrix_multiply float、ap_fixed、x_complex<float> 或 x_complex<ap_fixed>
	qrf float 或 x_complex<float>		Vitis 解算器 geqrf float 或 double
	qr_inverse float 或 x_complex<float>
	svd float 或 x_complex<float>		Vitis 解算器 gesvdj float 或 double
DSP 库 `hls_dsp.h` `hls/dsp` `\|-- hls_atan2_cordic.h` `\|-- hls_awgn.h` `\|-- hls_cmpy.h` `\|-- hls_convolution_encoder.h` `\|-- hls_nco.h` `\|-- hls_qam_demod.h` `\|-- hls_qam_mod.h` `\|-- hls_sqrt_cordic.h` `\|-- hls_viterbi_decoder.h` `-- utils `\|-- hls_cordic.h` `\|-- hls_cordic_functions.h` `-- hls_dsp_common_utils.h	atan2 输入：std::complex<ap_fixed> 输出：ap_ufixed	已弃用	HLS 数学库 atan2 ap_fixed/ap_ufixed/float/double
	sqrt 含 1 位整数的无符号二进制小数，无符号整数	已弃用	HLS 数学库 sqrt ap_fixed/ap_ufixed/float/double
	awgn（加性高斯白噪声）输入：ap_ufixed 输出：ap_int
	cmpy（复数乘法）输入：std::complex< ap_fixed > 输出：std::complex< ap_fixed >
	convolution_encoder（用于在含纠错的通道内进行数据传输，搭配 Viterbi Decoder 一起使用）输入：ap_uint 输出：ap_uint
	viterbi_decoder（用于在含纠错的通道内进行数据传输，搭配 Convolutional Encoder 一起使用）输入：ap_uint 输出：ap_uint
	nco（数控振荡器）输入：ap_uint 输出：std::complex< ap_int >