改訂履歴 - 2023.2 日本語

AI エンジン ツールおよびフロー ユーザー ガイド (UG1076)

Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 日本語

次の表に、この文書の改訂履歴を示します。

セクション 改訂内容
2023 年 12 月 4 日、バージョン 2023.2
全般 新しい AMD Vitis™ 統合 IDE の使用に合わせて引き続きアップデート。
シミュレータのオプション --dump-size=SIZE オプションを追加。
AI エンジン コンパイラのオプション pl-register-threshold の詳細を追加。
インライン キーワード inline キーワードの詳細を追加。
FIFO の深さの評価 FIFO の深さの評価に関する情報を追加。
ADF API を含むホスト コードのコンパイルおよびリンク 新しいセクションを追加。
AI エンジンのシミュレーションに基づくプロファイリング プロファイル レポートの [Function Reports] で生成された情報の定義を追加。
2023 年 10 月 18 日、バージョン 2023.2
資料全体 新しい AMD Vitis™ 統合 IDE の使用に合わせてアップデート。
AI エンジン ML サポートに合わせてアップデート。
Vitis Unified IDE への移行 2023.1 コマンドライン プロジェクトの Vitis 統合 IDE への移行、および 2023.1 の従来 Vitis IDE プロジェクトの Vitis 統合 IDE への移行に関する情報を追加。
Vitis Unified IDE の使用 Vitis 統合 IDE での AI エンジン コンポーネントの作成、およびそれらのシミュレーションとデバッグ方法に関する情報を追加。
AI エンジン コンパイラのオプション --part-runtime-opt--float-accuracy arg--lock-fence-mode、および --evaluate-fifo-depth オプションを追加。
マップおよび配線オプション disableMultiDMAFifo および skipUnroutableTraceNets オプションを追加。
デバイス アーキテクチャのマクロ __AIE_ARCH__ マクロの詳細。
v++ (統合コンパイラ) を使用するコンパイル 新しい Vitis 統合コマンド ライン AI エンジン コンパイラの使用に合わせてアップデート。
シミュレーションの入力および出力データ ストリームおよびCSV ファイル形式 PLIO 入力と出力の CSV ファイル形式のサポートを追加。
デッドロックの解消を目的とした FIFO 深さの評価 デッドロックを回避するために aiesimulator で FIFO の深さのレポートを使用する方法を追加。
AI エンジン シミュレータ オプションの再利用 AIE_Profile オプションはサードパーティー シミュレータでサポートされないことを明確に説明。
入力 main 関数には、return 文が必要であることを説明する注記を追加。return 文がなければ、aiecompiler でエラーが発生することがあります。
シミュレータのオプション --dump_size x86simulator オプションを追加。
AI エンジン ML ベース デバイスのメモリ タイル イベント トレース AI エンジン ML ベース アプリケーションのメモリ タイルのイベント トレースの詳細を追加。
メモリ タイルのプロファイリング AI エンジン ML ベース アプリケーションのメモリ タイルのプロファイリングの詳細を追加。
VCD を使用した AI エンジンのトレース 生成されたイベント トレース データのディレクトリ パスをアップデート。
セレクト信号を含む VCD の生成 options.txt ファイルに、VCD の生成に使用される行、列、タイム ウィンドウのオプションを追加。
IDE でセレクト信号を含む VCD を生成する Vitis 統合 IDE を使用して、VCD の生成に使用される行、列、およびタイム ウィンドウのオプションを指定する方法を追加。
NoC のプロファイリング NoC のネットワーク パフォーマンスをモニターする方法を追加。
XSDB フロー メモリ タイルのプロファイリング オプションに合わせてアップデート。インターフェイス タイルのメトリクス用にマルチレベル階層のグラフのサポートを追加。
XRT フロー メモリ タイルのプロファイリング オプションに合わせてアップデート。インターフェイス タイルのメトリクス用にマルチレベル階層グラフのサポートを追加。
XSDB フロー マルチレベル階層グラフのサポート例をアップデート。
XRT フロー offload_interval_us および file_dump_interval_s オプションを削除。

マルチレベル階層グラフのサポート例を追加。

Vitis IDE でのプロファイル結果の表示 新しいセクション「[Graph] ビューのパフォーマンス アノテーション」を追加。
高速デバッグ ポートを使用するイベント トレース オフロード トレース データをオフロードするための高速デバッグ ポートの使用に関する情報を追加。
イベント トレースの配線 イベント トレース配線エラーに対処する方法を追加。
章: Vitis ツール フローを使用したアプリケーションの統合」 『Vitis 統合ソフトウェア プラットフォーム資料: アプリケーション アクセラレーション開発』 (UG1393) に内容の一部を移動。
章: AI エンジン アプリケーションのデバッグ」 『Vitis 統合ソフトウェア プラットフォーム資料: アプリケーション アクセラレーション開発』 (UG1393) に内容の一部を移動。
2023 年 6 月 23 日、バージョン 2023.1
AI エンジン グラフ アプリケーションのシミュレーションおよびハードウェアでの AI エンジン グラフ アプリケーションのパフォーマンス解析 コンパイル済みの AI エンジン テスト ハーネスに関するヒントを追加。
x86 プロセッサ用のエンベデッド アプリケーションのコンパイル AMD Vitis™ インストールでの GCC パスの設定に関する注記を追加。
2023 年 5 月 16 日、バージョン 2023.1
全般 コンパイルとシミュレーションのレポート、サマリ ファイルを表示する新しい Vitis IDE 用にスクリーンショットをアップデート。
資料全体で、vitis_analyzer -a のように、サマリ ファイルで Vitis アナライザーを起動するためのオプション -a を追加。
付録「AI エンジン カーネルでの restrict キーワードの使用」と「テンプレートなしのウィンドウおよびストリーム データ型と API」を 『AI エンジン カーネルおよびグラフ プログラミング ガイド』 (UG1079) に移動。
input_window から input_buffer および output_window から output_buffer など、ウィンドウをバッファーに変更。
ツール コンパイルとシミュレーションのレポートの表示、AI エンジン コンパイラで生成された出力ファイルの解析を実行する新しい Vitis IDE を追加。Vitis の統合コマンド ライン インターフェイスを追加。
AI エンジン コンパイラのオプション --graph-iterator-event イベント トレース コンパイラ オプションを追加。

FIFO の深さを追加するための反復的な手動プロセスを回避するのに役立つ、--evaluate-fifo-depth オプションを追加。このオプションを使用してデザインをコンパイルし、aiesimulator を使用してシミュレーションすると、シミュレータによって FIFO の深さの推奨値が生成される。

Vitis 統合 IDE の [Analysis] ビューでのコンパイル結果の表示 新しい Vitis IDE に対応するため、このセクションの例、および画面キャプチャを更新しました。
AI エンジン グラフ アプリケーションのシミュレーション シミュレーションフロー、シミュレーションモデル、シミュレーション機能のテーブルを更新しました。
シミュレータのオプション --display-run-interval=<time in ns>--dump-vcd=<file>--enable-handshake-ext-tb--enable-memory-check--hang-detect-time=<time in ns>、および --online の説明をアップデート。
シミュレータのオプション

選択した VCD のテキスト ファイルを指定する --options-file を追加。

セレクト信号を含む VCD の生成 AI エンジンの VCD モジュールの選択および生成に関する新しいセクション。
外部トラフィック ジェネレーター 新しいセクションを追加。
AI エンジン シミュレータ オプションの再利用 実行サマリの表示に関する情報を追加。
トレース比較 トレース比較機能で vitis_analyzer --classic を使用することを推奨に追加。
ストリーム スイッチ FIFO の可視化 ストリーム スイッチ FIFO のデータ可視化に関する新しいセクションを追加。
AI エンジン、メモリ モジュール、およびインターフェイス タイルのプロファイリング および プロファイリング フロー 帯域幅をスループットでアップデート。
XSDB フロー -start-type-start-time、および -start-iteration オプションおよび例を追加。

-tile_based_aie_tile_metrics -tile-based-aie-tile-metrics -graph_based_aie_tile_metrics -graph-based-aie-tile-metrics 、および -tile_based_interface_tile_metrics-tile-based-interface-tile-metrics に名前を変更。

XRT フロー start_typestart_time、および start_iteration オプションおよび例を追加。
遅延イベント トレースの使用 新規セクション。
Vitis IDE での FIFO 深さの表示 ストリーム スイッチ FIFO のデータ可視化に関するセクションを追加。
AI エンジン ステータスの解析 新しい Vitis IDE の [Analysis] パースペクティブではなく、クラシック Vitis アナライザーで vitis_analyzer --classic を使用して、エラー イベントにアクセスできることに言及する注記を追加。
ハードウェアでのイベント トレースのトラブルシューティング -config-level がサポートされなくなったため、例で -config-level ではなく -graph-based-aie-tile-metrics を使用してアップデート。
PS ホスト アプリケーションのプログラミング ADF API に関する説明を削除、XRT API のみの使用にアップデート。
XRT C ++API を使用したアプリケーションの制御 PL カーネルを制御する XRT API の実行モデルと AI エンジン グラフをアップデートし、サンプル コードをアップデート。
AI エンジンの GMIO 転送の制御 AI エンジンの GMIO バッファーは、キャッシュ不可能なバッファーのみサポートされることを追記。
Linux 用のホスト コードのコンパイルおよびリンク 新規セクション。
ベアメタル用のホスト コードのコンパイルおよびリンク 新規セクション。
AI エンジン アレイのリセットおよび再読み込みフロー 新規セクション。
プラットフォーム プラットフォームのタイプをアップデート。
Cortex-A72 プロセッサ用のエンベデッド アプリケーションのコンパイル XRT のみのコンパイルに関するアップデート。
AI エンジン アレイのリセットおよび再読み込みフロー 新しいセクションを追加。
新しい Vitis 統合 IDE の紹介 プレビュー モード ツールに関する説明を付録として新たに追加。
2022 年 10 月 5 日、バージョン 2022.2
資料のタイトル 『AI エンジン ツールおよびフロー ユーザー ガイド』に変更。
資料全体 グラフ プログラミングの説明を 『AI エンジン カーネルおよびグラフ プログラミング ガイド』 (UG1079) に移動。
AI エンジン コンパイラのオプション DRC オプションを追加。イベント トレースのオプションを追加。
シミュレーションの入力および出力データ ストリーム シミュレーション オプション ファイルの詳細を追加。
コンフィギュレーション ファイルでサードパーティ シミュレータをイネーブルにする 汎用の <SIMULATOR DIRECTORY> 変数を使用するために v++ --link コンフィギュレーションを更新。
スカラー RTP データ解析 新規トピック。
グラフのレイテンシのプロファイリング ハードウェアとハードウェアのエミュレーションのコード例を追加。
AI エンジンのプロファイリング stream_put_get メトリックを削除。
XSDB フロー XSDB トレース オプションを追加。
制限 新規トピック。
メモリ モデル グローバル読み出し/書き込みをスレッド セーフにするためのマクロ X86SIM_THREAD_LOCAL の説明を追加。
インターフェイス タイルのプロファイリング input_bandwidths メトリクスと output_bandwidths メトリクスを更新。新しい packets メトリクス。
XSDB フロー aieprofile のオプションを更新し、新しいオプションも追加。
XRT フロー、およびXRT フロー 全体で xrt.ini オプションおよび例を更新。
ハードウェアでのイベント トレースのトラブルシューティング 特定のストリームでトレース パケットが欠落する場合のトラブルシューティング オプションを更新。
AI エンジンの GMIO 転送の制御 新規トピック。
AI エンジンのアプリケーション コンパイルの繰り返し 新規トピック。
バッファー ポート インターフェイスからのデータの表示 新規トピック。
システムのリンク [connectivity] セクションのオプション: sp の追加。
ハードウェア エミュレーションでの AI エンジン ステータスの解析 ハードウェア エミュレーションにおける AI エンジンのプロファイルとステータスに対する Vitis アナライザーのサポートについて説明する新しいトピックを追加。
x86 プロセッサ用のエンベデッド アプリケーションのコンパイル ソフトウェア エミュレーションにおける ps_on_x86 フローのサポートについて説明する新しいトピックを追加。
SystemVerilog/Verilog を用いたトラフィック ジェネレーターの作成 Verilog または SystemVerilog モジュール/テストベンチを使用して、AI エンジン シミュレータで動作する ADF グラフとの間でトラフィックを送受信する方法について説明する新しいトピック。
AI エンジン カーネルの暗号化 暗号化の詳細を示すウェブ ラウンジの説明とリンクを示す新しい付録。
2022 年 5 月 25 日、バージョン 2022.1
AI エンジン コンパイラのオプション 2 つの予約語 aie および adf がグラフ プログラミングで有効な名前空間識別子ではないことを説明する注記を追加。
Vitis 統合 IDE の [Analysis] ビューでのコンパイル結果の表示 2022.1 リリースに併せてグラフをアップデート。
I/Oネット、および タイル 2022.1 リリースに併せて例の詳細および Vitis アナライザーの GUI のスクリーンショットをアップデート。
インターフェイス チャネル 新しいグラフ インターフェイス チャネルの詳細を追加。
グラフの入力および出力用のイベント プロファイル API ネット上のイベントの詳細を追加。
Vitis IDE でのガイダンスの表示 ガイダンスを追加。
AI エンジン システム プロジェクトでのトラフィック ジェネレーターの使用 C++ と Python に加え、HDL で外部トラフィック ジェネレーターを書き込むことができることを明確に記述。
2022 年 4 月 26 日、バージョン 2022.1
概要 Vitis コア開発キットの詳細を 2022.1 リリースに併せてアップデート。
カーネルを含むデータフロー グラフの作成 2022.1 プログラミング モデルにアップデート。
同期ウィンドウ アクセス ウィンドウ間ブロードキャストおよびマルチレート デザインのサポートを説明するセクションを追加。
ストリーム ベース アクセス カスケード ストリームを使用したストリーム ベースのアクセスを説明するセクションを追加。
ストリームの並列使用 32 ビットおよび 64 ビットのリストをアップデート。
ランタイム パラメーターのサポート サマリ サポートされなくなった AI エンジン間のランタイム パラメーター コンストラクトを削除。
マルチキャスト サポート 「マルチキャスト サポート」の表をアップデート。
RTL プログラマブル ロジックを使用したデザイン フロー 2022.1 プログラミング モデルの変更を反映して例をアップデート。
第 12 章: グラフのプログラミング モデル プログラミング モデルの詳細を章全体でアップデート。
AI エンジン コンパイラのオプション 新しいマルチレート オプションを追加。

--Xrouter=<string> の例をアップデート。

マップおよび配線オプション enableSplitAsBroadcast オプション (常にオン) を削除。

disablePathBalancing オプションを追加。

x86 論理シミュレータ Vitis アナライザーに x86 シミュレーション出力を表示する機能を追加。
デザインのコンパイル x86 シミュレータ オプションを追加。
データ スナップショット Vitis アナライザーにスナップショットを表示する機能を追加。
制限 「シミュレーション出力ファイルの処理に関する考慮事項」および「adf::headers 制約および aie_api インクルードファイル」セクションを削除 (これらの x86 シミュレーションの制限は解消)。
シミュレータのオプション 新しいオプションおよびハング検出の詳細を追加。
コンフィギュレーション ファイルでサードパーティ シミュレータをイネーブルにする VCS の詳細をアップデート。

Riviera シミュレータの情報を追加。

ハードウェアでの AI エンジンのプロファイリング

インターフェイス タイルのプロファイリング

AI エンジン、メモリ モジュール、およびインターフェイス タイルのプロファイリング

DMA write_bandwidths/read_bandwidths に使用されるイベントを追加。

インターフェイス イベントのプロファイル機能を追加。

Vitis IDE での FIFO 深さの表示 Vitis アナライザーにシミュレーション VCD データからの DMA FIFO の深さを表示する機能を追加。
XSDB フロー

XRT フロー

イベント トレース開始時間を表示する機能を追加。

トレース データを一定の間隔で周期的にオフロードする機能を追加。

Vitis IDE でのプロファイル結果の表示 インターフェイス メトリクスの例を追加。

Vitis アナライザーに複数のプロファイルを統合する機能を追加。

ハードウェアでの AI エンジン ステータスの解析

AI エンジン ステータスの生成

AI エンジン ステータスの解析

ハードウェアの AI エンジンのステータスをレポートする機能を追加、Vitis アナライザーでレポートを開いて解析する機能を追加。
DFX プラットフォームのパッケージ ベース プラットフォームに加えて DFX プラットフォームを使用する機能を追加、ハードウェアでこのプラットフォームを使用するための情報を追加。
AI エンジン グラフの制御におけるマルチプロセスおよびマルチスレッド サポート xrtGraphClose および xrtDeviceClose の動作に関する説明を明確化。
プラットフォーム プラットフォームのタイプに DFX プラットフォームを追加。
パフォーマンス メトリクス [Show Percentage] ボタンの説明を追加。
ロック ストールの解析

ストリーム ストールの解析

カスケード ストールの解析

メモリ ストールの解析

プログラム カウンター (PC) オプションを追加 (これにより Vitis アナライザーの [Trace] ビューからソース コードにクロスプローブ可能)。
AI エンジン システムでのトラフィック ジェネレーターの使用

AI エンジン グラフでのトラフィック ジェネレーターの使用

x86 論理シミュレータ、AI エンジン シミュレータ、ソフトウェア エミュレーション、およびハードウェア エミュレーションにおけるトラフィック ジェネレーターの使用のサポートを追加。これらのトラフィック ジェネレーターは Python、C++、または HDL で記述可能。
ベアメタル用のホスト プログラミング

ベアメタル システムのビルド

Linux およびベアメタルのホスト プログラミングの比較

ベアメタル ソフトウェア スタックに関する詳細を追加。

ベアメタル OS と Linux オペレーティング システムでホスト アプリケーションを実行する機能を比較。

Vitis ツール フローを使用したアプリケーションの統合

システムのリンク

ハードウェア用のシステムのパッケージ

v++ リンクで XSA ファイルが生成されるようになったことを反映してアップデート。
AI エンジン ハードウェアのプロファイルおよびデバッグ手法 AI エンジンのハードウェア プロファイルとデバッグ手法に関する新しい章。
input_gmio/output_gmio

input_plio/output_plio

input_gmio/output_gmioinput_plio/output_plio を含むプログラミング モデルの変更を反映してアップデート。
その他の制約 マルチレート デザインの repetition_count オプションを追加。
2021 年 12 月 17 日、バージョン 2021.2
第 8 章: ウィンドウおよびストリーミング データ API サポートされる符号なしの整数データ型をさらに追加。
ランタイム データ パラメーターの指定 説明を明確化。
プログラミング モデルの機能 セクション見出しを変更。
AI エンジン コンパイラのオプション 表 11 を追加
AI エンジンのプロファイリング 新規セクション。
グラフのスループットのプロファイリング 情報を追加。
ハードウェアでの AI エンジンのプロファイリング 新規セクション。
ハードウェアでのイベント トレース 新規セクション。
ハードウェア イベント トレース 新規セクション。
ハードウェアでのイベント トレースのトラブルシューティング 新規セクション。
2021 年 10 月 22 日、バージョン 2021.2
AI エンジンのコンポーネント アップデート。
カーネルの準備 AI エンジン API 用にアップデート。
カーネルを含むデータフロー グラフの作成 グラフ接続を示す図を追加。
第 8 章: ウィンドウおよびストリーミング データ API AI エンジン API およびテンプレート サポートのデータ型をアップデート。
パケット スイッチング グラフ構文 浮動小数点データの例を追加。
エリア ロケーション制約 新規セクション。
階層制約 情報を追加。
プログラミング モデルの機能 新規セクション。
AI エンジン コンパイラのオプション 新規オプションを追加。
AI エンジン グラフ アプリケーションのシミュレーション シミュレーション フロー関連の情報を追加。
データ スナップショット 新規セクション。
デッドロックの検出 新規セクション。
トレース レポート 新規セクション。
メモリ アクセス違反および Valgrind 新規セクション。
メモリ モデル 情報をアップデート。
シミュレーション出力ファイルの処理に関する考慮事項 新規セクション。
adf::headers 制約および aie_api インクルードファイル 新規セクション。
ソフトウェア エミュレーション 新規セクション。
シミュレータのオプション 新規オプションを追加。
ハードウェア エミュレーション 新規セクション。
AI エンジン シミュレータ オプションの再利用 AI エンジン コンパイラの workdir 環境変数の設定およびシミュレーション オプション ファイルの手動作成に関する情報を追加。
AI エンジンのシミュレーションに基づくプロファイリング 新規セクション。
サポートされるウィンドウのデータ型 データ型をアップデート。
サポートされるストリームのデータ型
Vitis IDE での AI エンジンのストール解析 新規セクション。
AI エンジン グラフの制御におけるマルチプロセスおよびマルチスレッド サポート 新規セクション。
AI エンジンのエラー イベント エラーおよびデバッグ ヒントをアップデート。
ソフトウェア エミュレーションの実行 新規セクション。
エリア グループ制約 プロパティをアップデート。
AI エンジン グラフ プロジェクトおよび最上位システムプロジェクトの作成 スクリーンショットをアップデート。
システムのビルドと実行 ソフトウェア エミュレーションを追加。
AI エンジン アプリケーションのデバッグ デバッグ情報を追加。
Vitis IDE からのソフトウェア エミュレーション デバッグ 新規セクション。
コマンド ラインからのソフトウェア エミュレーションの実行 新規セクション。
デバッグ環境の使用 スクリーンショットをアップデート。
ウォッチポイント 新規セクション。
ソフトウェア エミュレーション デバッグ用の Vitis IDE レイアウト 新規セクション。
テンプレートなしのウィンドウおよびストリーム API テンプレートなしのウィンドウおよびストリーム データ型と API を説明する付録。
2021 年 7 月 19 日、バージョン 2021.1
FIFO のロケーション制約 FIFO の制約例をアップデート。
サポートされるウィンドウのデータ型 新規トピック。
サポートされるストリームのデータ型 新規トピック。
Vitis IDE でのベアメタル AI エンジンのビルド 手順 4 をアップデート。
2021 年 6 月 16 日、バージョン 2021.1
ランタイム比 新規トピック。
ストリームのデータ型

入力ストリームの実行および前進

出力ストリームの書き込みおよび前進

新しいストリーム タイプを追加。
ランタイム パラメーターのサポート サマリ AI エンジン RTP サポートの表を追加。
ストリーム スイッチ FIFO

DMA FIFO

AI エンジン タイルの DMA のパフォーマンス

新規 FIFO トピック。
パケット スイッチング グラフ構文 使用可能なパケット ストリームの数をアップデート。
マルチキャスト サポート 新規トピック。
第 11 章: AI エンジン/プログラマブル ロジックの統合 内容をアップデート。
ハードウェア エミュレーションおよびハードウェア フロー ADF_FRONTEND を削除。
AI エンジン/PL と AI エンジン/NoC インターフェイスのパフォーマンス比較 新規トピック。
AI エンジン コンパイラのオプション
  • ヒープおよびスタックのサイズをアップデート。
  • --broadcast-enable-core CDO オプションを追加。
  • トレース オプションをアップデート。
  • xlopt をアップデート。
グラフおよびアレイの詳細 新規セクションを追加。
AI エンジン コンパイラのガイダンス 新規トピック。
AI エンジン シミュレータ オプションの再利用 オプションに --profile/AIE_PROFILE を追加。
コンフィギュレーション ファイルでサードパーティ シミュレータをイネーブルにする シミュレータを追加し、バージョンをアップデート。
x86 論理シミュレータ 内容をアップデートし、新規セクションを追加。
Vitis IDE での実行サマリの表示 内容をアップデート。
[Trace] ビューのデータの可視化 新規セクション。
ランタイム イベント API パフォーマンス カウンターの使用サマリ 新規トピック。
PS ホスト アプリケーションのプログラミング ADF_FRONTEND を削除。
XRT C ++API を使用したアプリケーションの制御 新規トピック。
AI エンジンのエラー レポート xbutil のスコープをアップデート。
ADF API および XRT API を使用するホスト コード printf に関連するアップデート。
AI エンジンでのクロック同期 トピックをアップデート。
Cortex-A72 プロセッサ用のエンベデッド アプリケーションのコンパイル コードをアップデート: aarch64-linux-gnu-g++aarch64-xilinx-linux-g++
ハードウェア エミュレーションの実行 新規セクション。
Vitis 統合 IDE の使用 スクリーンショットをアップデート。
マップ/配線手法 新しい章。
イベント API 「エニュメレーション」セクションを削除。
FIFO 制約 新規トピック。
AI エンジン カーネルで restrict キーワードを使用 C++ にアップデート。