AI エンジン コンパイラのオプション - 2023.2 日本語

スタック、ヒープ、および同期バッファー (32 バイト、グラフ実行回数の情報を含む) には、32768 バイトまでのデータ メモリが割り当てられます。デフォルトのヒープ サイズは 1024 バイトです。ヒープ サイズを異なる値に変更する前に、スタック、ヒープ、および同期バッファー サイズの合計が 32768 バイトを超えていないことを確認してください。

ユーザー グラフに明示的に接続されていない残りのファイル スコープのデータを割り当てるのに使用されます。

スタック、ヒープ、および同期バッファー (32 バイト) には、32768 バイトまでのデータ メモリが割り当てられます。デフォルトのスタック サイズは 1024 バイトです。スタック サイズを異なる値に変更する前に、スタック、ヒープ、および同期バッファー サイズの合計が 32768 バイトを超えていないことを確認してください。

スタック割り当て済みのローカル変数およびレジスタあふれを含む標準コンパイラ呼び出し規則として使用されます。

しきい値のデフォルト周波数は、AI エンジンの周波数 (デバイスのスピード グレードによる) の 1/8 です。

• 0: エラー
• 1: レベル 0 + 警告
• 2: レベル 1 + 情報メッセージ
• 3: レベル 2 + デバッグ メッセージ

デフォルトは 2 です。

• hw: ターゲット プラットフォームおよびハードウェア エミュレーションのハードウェア デバイスで使用する libadf.a を生成します。
• x86sim: x86 simulator で使用するコードをコンパイルします (x86 論理シミュレータ を参照)。

1 つまたは複数のインクルード ディレクトリを指定します。

Vitis プラットフォーム ファイルへのパスを指定します。このファイルが、Vitis アプリケーション開発の開始点となります。これらのアプリケーションは、プラットフォームで提供されるリソースや機能を利用できます。プラットフォームによって、アプリケーションで利用できるハードウェアとソフトウェアのコンポーネントが定義されます。プラットフォームは、ザイリンクス プラットフォーム ファイル (XPFM) またはザイリンクス シェル アーカイブ (XSA) として指定できます。

例: aiecompiler --include ./aie --part xcvc1902-vsvd1760-2MP-e-S graph.cpp

AI エンジン コンパイルを実行するために、aiecompiler では --platform オプションまたは --part オプションを指定する必要があります。--platform および --part オプションを同時に指定することはできません。

デフォルトでは、コンパイラですべての出力が現在のディレクトリの Work サブディレクトリに生成されます。異なる出力ディレクトリを指定する場合に、このオプションを使用します。

データパスの再変換の結果生じるデッドロックを評価し、解決する手順は、次のとおりです。

1. このオプションを使用してデザインをコンパイルします。
2. デザインで aiesimulator を実行します。
3. Vitis 統合 IDE でシミュレーションの run_summary を開きます。[Estimated FIFO] の列を参照し、fifo_depth 制約を使用して推奨される数の FIFO を特定のネットに適用します。

詳細は、デッドロックの解消を目的とした FIFO 深さの評価を参照してください。

• 0: I/O バッファーの取得と解放に関して、控えめなスケジューリングを使用します。
• 1 (デフォルト): I/O バッファーの取得と解放に関して、積極的なスケジューリングを使用します。これにより、サイクル数が削減されることがあります。

オプション文字列は <kernel-function>:<optionid>=<value> のように指定します。このオプション文字列は、指定したカーネル関数がマップされている AI エンジンに生成されたソース ファイルのコンパイル中に含められます。

並列コンパイルの数を 4 に制限するには、-Xelfgen="-j4" と指定します。

--Xmapper=DisableFloorplanning

これらのオプションは、マップまたは配線段階でデザインが収束しない場合、またはメモリ バンクの競合を削減してパフォーマンスを改善する場合に、指定してみることができます。

オプションのリストと説明は、マップおよび配線オプション を参照してください。

--Xpreproc=-D<var>=<value>

--Xpslinker=-L<libpath> -l<libname>

-Xrouter=dmaFIFOsInFreeBankOnly

-Xx86sim=clangStaticAnalyzer

カーネル ソース コードの clang スタティック アナライザーをイネーブルにします。

• safe: 精度は FP32 より若干高い。
• fast: FP32 と同等の精度でパフォーマンスは向上。
• low: FP16 および bfloat16 よりも精度が高く、最高のパフォーマンス。

<value> には、次のいずれかを指定します。

• functions
• functions_partial_stalls
• functions_all_stalls
• runtime

• ストールなしの関数遷移ビュー。
• ストリーム、ロック、カスケード ストールを含む関数遷移ビュー。
• すべてのストール (ストリーム、ロック、カスケード、メモリ) を含む関数遷移ビュー。
• AI エンジン メモリとインターフェイス タイルのランタイム イベント トレースの設定。

• plio
• gmio

• AI エンジン イベント トレース ポートを plio に設定します。
• AI エンジン イベント トレース ポートを gmio に設定します。

• xlopt=1
  • ヒープ サイズの自動計算: カーネル解析を使用して各 AI エンジン のヒープ要件を自動的に計算します。ヒープ サイズを指定する必要はありません。
  • ガイダンス: アライメントされていない変数、マップで割り当てられる可能性のあるグローバル配列、制限の不適切な使用、書き込み前に読み出し競合の可能性に対して、ガイダンスが表示されます。
  • プラグマの挿入: カーネル コードに自動的にプラグマを推論し、挿入します。
• xlopt=2
  • 関数の自動インライン展開: 関数が __inline または inline として宣言されていなくても、有益で可能な場合に関数を自動的にインライン展開します。
  • 展開されたループのループ ピーリング: ピーリングによりループ反復回数を展開係数の倍数にします。反復回数と収益性の経験則に基づいてループを複数のループに分割し、分割ループにフラット化プラグマを追加します。

• -annotate-pragma=false: ループ プラグマを自動的に挿入しないようにします。
• -xlinline-threshold=T: 関数の自動インライン展開のしきい値を T に設定します。T のデフォルト値は 5000 です。
• -annotate-pragma: ループ展開、パイプライン処理、フラット化プラグマを自動的に挿入します。デフォルトは true です。

I/O バッファーの取得と解放について、積極的なスケジューリングをイネーブルにします (デフォルト: 0)。

• --lock-fence-mode=0: 積極的なスケジューリングをディスエーブルにします。
• --lock-fence-mode=1: マルチレイヤー デザイン以外に積極的なスケジューリングを使用します。

• --runtime-opt=false: 最適化は実行されません。これがデフォルトです。
• --runtime-opt=true: 最適化をイネーブルにします。