Vitis コンパイラのコンフィギュレーション ファイル - 2020.2 Japanese

Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発 (UG1393)

Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 Japanese

コンパイル コンフィギュレーション ファイルは、Vitis コンパイラ オプションを指定するのにも使用できます。コンフィギュレーション ファイルを使用すると、同様のオプションをグループ化でき、v++ コマンド ラインを短くできます。コンフィギュレーション ファイルで制御できる機能には、次のものがあります。

  • カーネルのコンパイルを設定する HLS オプション
  • インスタンシエートするカーネルの数、カーネル ポートのグローバル メモリへの割り当てなど、システムのリンクに使用する接続指示子
  • Vivado Design Suite でハードウェア合成およびインプリメンテーションを制御する指示子。

一般的に、どの v++ コマンド オプションでもコンフィギュレーション ファイルに指定できます。コンフィギュレーション ファイルでは、関連のコマンドのグループを含むセクションを定義でき、ビルド オプションおよびストラテジを管理しやすくなっています。次の表に、定義済みのセクションを示します。

表 1. コンフィギュレーション ファイルのセクション タグ
セクション名 コンパイラ/リンカー 説明
[hls] コンパイラ HLS 指示子 --hls オプション:
  • clock
  • export_project
  • export_mode
  • max_memory_ports
  • memory_port_data_width
[clock] コンパイラ clock コマンド --clock オプション:
  • defaultFreqHz
  • defaultID
  • freqHz
  • id
[connectivity] リンカー --connectivity オプション:
  • nk
  • sp
  • stream_connect
  • slr
  • connect
[vivado] リンカー --vivado オプション:
  • param
  • prop
[advanced] 両方 --advanced オプション:
  • param
  • prop
  • misc
ヒント: コンフィギュレーション ファイルにコマンドを追加するには、行を # で開始します。セクションの終わりは空行で示します。

v++ コマンドでは、1 つの v++ コマンド ラインで複数のコンフィギュレーション ファイルがサポートされるので、コンパイル ストラテジ、リンク ストラテジ、または Vivado インプリメンテーション ストラテジを定義する関連のオプションにコンフィギュレーション ファイルを分割し、ビルド プロセスで複数のコンフィギュレーション ファイルを指定できます。

コンフィギュレーション ファイルの指定はオプションです。ファイルの命名規則は特になく、指定できるコンフィギュレーション ファイルの数は 0 以上です。すべての v++ オプションを 1 つのコンフィギュレーション ファイルに含めることができますが、関連のオプションごとにコンフィギュレーション ファイルを作成すると、ビルド ストラテジを管理しやすくなります。たとえば、[connectivity] 関連のオプションを 1 つのファイルに、[Vivado] オプションを別のファイルにグループ化するなどです。

Vitis コンパイラの一般オプション で説明するように、コンフィギュレーション ファイルは v++ --config オプションで指定します。次に --config オプションの例を示します。

v++ --config ../src/connectivity.cfg

オプションは、記述された順に読み出されます。同じオプションが別の設定で指定されていた場合、最初に読み出されたオプションの設定が使用されます。オプションの優先順位は次のとおりです。

  1. コマンド ライン オプション。
  2. コマンド ラインのコンフィギュレーション ファイルは左から右。
  3. コンフィギュレーション ファイル内では上から下。