廃止予定およびサポートされない機能 - 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_schedule -enable_dsp_fill_reg 以外のすべてのオプション 廃止予定  
コンフィギュレーション config_bind * (すべてのオプション) 廃止予定  
config config_rtl -encoding 廃止予定 FSM エンコードは、ワンホット エンコードです。
コンフィギュレーション config_sdx * (すべてのオプション) 廃止予定  
コンフィギュレーション 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 プラグマおよび指示子に置き換え。top 関数引数には 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 に置き換え。
  1. 廃止予定: プラグマが今後のリリースでサポートされなくなることを示す警告メッセージが表示されます。
  2. サポートなし: Vitis HLS でエラー メッセージが表示されます。
  3. *: コマンドのすべてのオプション。

次のライブラリは廃止予定です。

表 2. 廃止予定のライブラリ
[Library] 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 Solver

potrf

float、double

cholesky_inverse

float、ap_fixed、x_complex<float>、x_complex<ap_fixed>

Vitis Solver

pomatrixinverse

float、double

matrix_multiply

float、ap_fixed、x_complex<float>、x_complex<ap_fixed>

  

qrf

float、x_complex<float>

Vitis Solver

geqrf

float、double

qr_inverse

float、x_complex<float>

  

svd

float、x_complex<float>

Vitis Solver

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

input: 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 (エラー訂正を含むチャネルでのデータ転送用、convolution_encoder とペアで使用)

入力: ap_uint

出力: ap_uint

    

nco (数値制御型オシレーター)

入力: ap_uint

出力: std::complex< ap_int >