AI エンジン グラフ アプリケーションのコンパイル

AI エンジン ツールは、Vitis 統合ソフトウェア プラットフォームの一部としてインストールされます。そのため、AI エンジン コンパイラや AI エンジン シミュレータなどの AI エンジン ツールを実行するには、Vitis ツールを設定する必要があります。Vitis 統合ソフトウェア プラットフォームには次の 2 つの構成要素があり、有効な Vitis ツール ライセンスと共に、これらをインストールおよび設定する必要があります。

• Vitis ツールおよび AI エンジン ツール
• ターゲット Vitis プラットフォーム (AI エンジン アプリケーション用の xilinx_vck190_base_202020_1 プラットフォームなど)

詳細は、『Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発』 (UG1393: 英語版、日本語版) を参照してください。

Vitis ソフトウェア プラットフォームのこれらの構成要素をインストールしたら、次のスクリプトを実行して、特定のコマンド シェルで実行できるよう環境設定する必要があります。

#setup XILINX_VITIS and XILINX_HLS variables
 source <Vitis_install_path>/Vitis/<version>/settings64.csh

最後に、次の環境変数を設定して、Vitis IDE および AI エンジン ツールで使用可能なプラットフォームの場所を指定します。

setenv PLATFORM_REPO_PATHS <path to platforms>

ツールのインストールおよび設定を確認するには、次のいずれかのコマンドを使用します。

which vitis
which aiecompiler

プラットフォームのインストールを確認するには、次のコマンドを使用します。

platforminfo --list

AI エンジン コンパイラにいくつかの形式のファイルを入力すると、AI エンジン デバイス上で動作するアプリケーションの実行ファイルが生成されます。AI エンジン コンパイラを実行するためのコマンド ラインは、次のとおりです。

aiecompiler [options] <Input File>

ここで

• <Input File>: AI エンジン グラフの main() アプリケーションを定義したデータフロー グラフのコードを指定します。入力フロー グラフは、データフロー グラフ言語を使用して記述します。データフロー グラフの説明は、データフロー グラフ (カーネルを含む) を作成する を参照してください。

次に、AI エンジン コンパイラのコマンド例を示します。

aiecompiler --verbose --pl-freq=100 --workdir=./myWork --platform=xilinx_vck190_202020_1.xpfm\
--include="./" --include="./src" --include="./src/kernels" --include="./data" --include="${XILINX_HLS}/include"  \
./src/graph.cpp

コマンド ラインには、次の入力オプションを含めることもできます。

• --constraints=<jsonfile>: ロケーションや配置境界ボックスなどの制約を指定します。

デフォルトでは、AI エンジン コンパイラはすべての出力を Work ディレクトリに出力し、それ以外に libadf.a も生成します。Work は、ツールを起動したカレント ディレクトリのサブディレクトリです。libadf.a は Vitis コンパイラの入力ファイルとして使用するファイルで、AI エンジン コンパイラを起動したのと同じディレクトリに作成されます。出力のタイプと出力ディレクトリの内容は、--target (AI エンジン コンパイラのオプション 参照) の指定により異なります。Vitis コンパイラの詳細は、『Vitis 統合ソフトウェア プラットフォームの資料』 (UG1416) のアプリケーション アクセラレーション開発フローの Vitis コンパイラ コマンド を参照してください。

次の表に、./Work ディレクトリの構造と内容を示します。

AI エンジン グラフをコンパイル後、AI エンジン コンパイラはコンパイル結果を <graph-file-name>.aiecompile_summary という名前のサマリとして生成します。これは、Vitis アナライザーで表示できます。このサマリには各種レポート、およびコンパイルしたビルドで実装された AI エンジン アプリケーションのステートを反映した図が含まれます。このサマリは、AI エンジン コンパイラの --workdir オプションで指定する作業ディレクトリ (デフォルトでは ./Work) に出力されます。

AI エンジン コンパイラのサマリを開くには、次のコマンドを実行します。

vitis_analyzer ./Work/graph.aiecompile_summary

Vitis アナライザーが起動し、レポートの Summary ページが表示されます。Report Navigator ビューには、Summary に含まれる各種レポートがリスト形式で表示されます。Vitis アナライザーの詳細は、『Vitis 統合ソフトウェア プラットフォームの資料』 (UG1416) のアプリケーション アクセラレーション開発フローの Vitis アナライザーの使用 を参照してください。

リストには、次のレポートが含まれます。

Summary

最上位のレポートで、ビルドの詳細 (日付、ツール バージョン、グラフへのリンク、ビルドの作成に使用したコマンド ラインなど) が表示されます。

Graph

各種カーネル間のデータフローを示す AI エンジン グラフのフロー図が表示されます。グラフ表示は、必要に応じてズームとパンが可能です。Reports ビューの下部には、カーネル、バッファー、ポート、およびネットなどグラフに関するサマリ情報が表形式で表示されます。グラフ内のオブジェクトをクリックすると、表内でそのオブジェクトがハイライト表示されます。

ヒント: Kernels の表には、グラフに含まれるカーネル、およびカーネル ソース コードへのリンクとグラフ ヘッダー定義がリスト形式で表示されます。リンクのいずれかをクリックすると、Source Code ビューにソース コードが読み出し専用で表示されます。

Array

Versal デバイスの AI エンジン プロセッサ アレイの図が表示されます。グラフ カーネルと接続が、アレイのコンテキスト内に配置されます。アレイ図の一部をズームして、エレメントを選択できます。ここでも、アレイ内のオブジェクトをクリックすると、Reports ビューの下部にある表でそのオブジェクトがハイライト表示されます。

Mapping Analysis

テキスト形式のレポート graph_mapping_analysis_report.txt が表示されます。グラフとデバイス リソース間のブロック マップ、ポート マップ、およびメモリ バンク マップが表示されます。

DMA Analysis

グラフからの DMA アクセスのサマリ情報を記述したテキスト形式のレポート DMA_report.txt が表示されます。

DMA Lock

ポート インスタンス上の DMA ロックをリストにしたテキスト形式のレポート Lock_report.txt が表示されます。

次の図は、Vitis アナライザーで graph.aiecompile_summary レポートを開き、Array の図を表示したところです。図と表で AI エンジン カーネルが 1 つ選択されており、そのカーネルのソース コードが Source Code ビューに表示されています。