出力 - 2023.2 日本語

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

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

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

ヒント: 異なる出力ディレクトリを指定するには、--workdir オプションを使用します。

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

表 1. 作業ディレクトリの構造
ディレクトリ/ファイル 説明
./Work/  
  <name>.aiecompile_summary コンパイル サマリを含むファイルで、Vitis 統合 IDE で開くことができます。
  config/scsim_config.json AI エンジン シミュレータのオプションを指定する JSON スクリプト。AI エンジン アレイ タイルの配置、入力/出力ファイル仕様、およびストリーム スイッチへの接続を含みます。
  arch/  
  logical_arch_aie.larch AI エンジン アプリケーションのハードウェア要件を記述する JSON ファイル。
  aieshim_constraints.json この JSON ファイルが存在する場合、AI エンジン アプリケーションで指定される AI エンジン アレイとプログラマブル ロジック間のユーザー定義物理インターフェイス制約を表します。
  aieshim_solution.aiesol AI エンジン アレイとプログラマブル ロジック間のインターフェイスをまたぐ論理チャネルから物理チャネルへのマップを記述する JSON ファイル。
  cfgraph.xml AI エンジン アプリケーションのハードウェア要件を記述する XML ファイル。このファイルは、Vitis ツール フローで使用されます。
  aie/  
  Makefile すべての AI エンジンのコードをコンパイルするための makefile。
  <n>_<m>/ 個々の AI エンジン コンパイル ディレクトリ。
  Release/ ELF ファイルを含む AI エンジン用の Synopsys リリース ディレクトリ。
  <n>_<m>.lst <n>_<m> にあるカーネルのマイクロコード。
  <n>_<m>.map <n>_<m> にあるカーネルのメモリ マップを示します。メモリのサイズ、幅、およびオフセットも含まれます。
  scripts/ Synopsys コンパイラ プロジェクトおよびリンカー スクリプト。
  src/ カーネルおよび main を含むプロセッサのソース ファイル。
  ps/c_rts/ PS との通信をモデル化するための C ベース ランタイム制御を含むディレクトリ。
  aie_control.cpp プログラムに存在する特定のグラフ オブジェクト用の initrunend グラフ API をインプリメントして生成された AI エンジン制御コード。このファイルをアプリケーション main とリンクして、シミュレータおよびベアメタル用の PS スレッドを作成します。
  aie_control_xrt.cpp プログラムに存在する特定のグラフ オブジェクト用の initrunend グラフ API をインプリメントして生成された AI エンジン制御コード。このファイルをアプリケーション main とリンクして、Linux アプリケーション用の PS スレッドを作成します。
  systemC/ PS main の SystemC モデルを含むディレクトリ。
  Makefile すべての PS SystemC モデルをコンパイルする makefile。
  generated-source/ PS main の SystemC ラッパー。
  generated-objects/ PS main 用のコンパイル済みの共有ライブラリ。
  ps/cdo/ グラフ コンフィギュレーションおよび初期化用のコンフィギュレーション データ オブジェクト (CDO) フォーマットの生成コード。このファイルは、SystemC-RTL シミュレーションおよび実際のハードウェア実行で使用されます。
  Makefile グラフ CDO をコンパイルする Makefile
  generateAIEConfig グラフ CDO をビルドする bash スクリプト
  generated-sources/ CDO を生成する C++ プログラム。
  generated-objects/ CDO を生成するコンパイル済みプログラム。
  pthread/  
  PthreadSim.c pthreads を使用して入力フロー グラフから C プログラムに変換されたソース。
  sim.out PthreadSim.c の GCC コンパイルされたバイナリ。
  reports/  
  <graph>_mapping_analysis_report.txt カーネルから AI エンジン、ウィンドウ バッファーから AI エンジン メモリ グループへの割り当てを示すマップ レポート。
  <graph>.png カーネル グラフの接続と AI エンジンへの分割を示すビットマップ ファイル。
  <graph>.xpe 使用されたハードウェア リソースに基づくグラフの見積もり消費電力プロファイルを記述する XML ファイル。このファイルは、Power Design Manager (PDM) ツールで使用されます。
  sync_buffer_address.json ローカルおよびグローバル アドレスを含むカーネルの同期バッファー アドレスを示します。
  lock_allocation_report.json ポートとカーネルに関連付けられているロックおよびバッファーを示します。
  dma_lock_report.json AI エンジンへの入力/出力の DMA ロックと、それらが接続されているカーネルとバッファーの情報を示します。
  temp/ AI エンジン コンパイラで生成される一時ファイルが含まれます。これらの一時ファイルは、デバッグに便利です。CF グラフ .o ファイルもデフォルトでここに作成されます。