AI エンジン シミュレータ オプションの再利用 - 2023.2 日本語

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

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

AI エンジン シミュレータは、AI エンジン グラフ アプリケーションのシミュレーションに使用されるオプションをリストするオプションファイルを生成します。このオプション ファイルは、AI エンジン シミュレータを実行すると自動的に生成されます。初期のグラフ レベルのシミュレーションで使用した AI エンジン シミュレータ オプションは、システム レベルのハードウェア エミュレーションで再利用できます。必要に応じてオプション ファイルを手動で編集し、ほかのオプションを指定することもできます。次の表に、aiesim_options.txt ファイルで指定可能なオプションをリストします。このファイルは、aiesimulator コマンドに --dump-vcd オプション (XSIM シミュレータでのみ有効) または --profile オプションのいずれかを使用した場合に、aiesimulator_output ディレクトリに作成されます。このファイルは、ハードウェアでの AI エンジン グラフ アプリケーションのパフォーマンス解析 に説明されているように、launch_hw_emu.sh スクリプトを使用してハードウェア エミュレーターを起動するときにコマンド ライン オプションの一部として指定できます。次にコマンド例を示します。

./launch_hw_emu.sh \
-aie-sim-options ${FULL_PATH}/aiesimulator_output/aiesim_options.txt

${FULL_PATH}: ファイルまたはディレクトリへの絶対パスを指定します。

表 1. ハードウェア エミュレーションの AI エンジン オプション
コマンド 引数 説明
AIE_DUMP_VCD <filename> AIE_DUMP_VCD を指定すると、シミュレーションで VCD データが生成され、指定した <filename>.vcd に保存されます。
AIE_DEBUG_AXIMM True | False AIE_DEBUG_AXIMM がイネーブル (True) の場合、シミュレーションでメモリ マップド AXI4 トランザクション データが生成され、aiesim_debug_axi_mm_dump.txt ファイルに保存されます。
AIE_PROFILE All | (1,2)(3,4)... 使用されるすべての AI エンジンまたは選択した AI エンジンをプロファイリングします。ハードウェア エミュレーションによってプロファイル データ ファイルが生成されます。プロファイリングは、サードパーティ シミュレータではサポートされません。
重要: AI エンジン コンパイラの workdir 環境変数を、AI エンジン コンパイラで生成される Work ディレクトリに設定する必要があります。このためには、AMD シミュレータを起動する前に、シェル ウィンドウに「setenv AIE_COMPILER_WORKDIR /yourdesigndirectory/Work」と入力します。
注記: ファイルへのパスを含むコマンドでは、絶対パスを使用する必要があります。

シミュレーション オプション ファイルを手動で作成する場合は、COMMAND=ARGUMENT の形式を使用し、各コマンドを個別の行に記述する必要があります。次の例に、ベスト プラクティスを示します。

AIE_PROFILE=All
AIE_VCD=foo

AMD Vivado™ シミュレータ波形 GUI を表示するには、v++ リンクおよび launch_hw_emu スクリプトで -g オプションを使用する必要があります。

./launch_hw_emu.sh -g

Vivado ロジック シミュレータ GUI を使用してエミュレーションを起動せずに波形データをログに記録するためのアドバンス オプションも追加できます。次にコマンド例を示します。

./launch_hw_emu.sh \
-user-pre-sim-script pre-sim.tcl

pre-sim.tcl には、波形を追加したり、デザイン波形をログに記録する Tcl コマンドが含まれます。例は 『Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発』 (UG1393)、Tcl コマンドは 『Vivado Design Suite ユーザー ガイド: ロジック シミュレーション』 (UG900) を参照してください。

ヒント: ハードウェア エミュレーションでのアプリケーションのデバッグに関する詳細は、 『Vitis 統合ソフトウェア プラットフォーム資料: アプリケーション アクセラレーション開発』 (UG1393)アプリケーションおよびカーネルのデバッグを参照してください。

実行サマリの表示

上述のシミュレーション オプションを使用してハードウェア エミュレーションを実行すると、次の実行サマリを確認できます。

<package_dir>/sim/behav_waveform/xsim/default.aierun_summary 内に生成された AI エンジン実行サマリの場合

  • <package_dir>/sim/behav_waveform/xsim/<vcd filename> などの同じロケーションに生成された VCD ファイルを確認できます。
  • オプション ファイルで AIE_PROFILE を、ADF カーネルで printf を使用してプロファイルをイネーブルにした場合、<package_dir>/sim/behav_waveform/xsim/simulate.log 内で printf ログ データを確認できます。