AI エンジン ML ベース デバイスのメモリ タイル イベント トレース - 2023.2 日本語

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

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

ザイリンクス ランタイム (XRT) およびザイリンクス ソフトウェア デバッガー (XSDB) を使用して、AI エンジン タイル、AI エンジン メモリ、および AI エンジン インターフェイスの場合と同様に、メモリ タイルからトレース データをキャプチャできます。これらのオプションは、AI エンジン ML 固有のものです。

チャネル メトリクス セットはバッファー ディスクリプターの開始と終了を焦点を当て、その他のメトリクス セットはトレースにストールを追加します。

表 1. メモリ タイル イベント トレース
イベント タイプ/メトリクス セット input_channels input_channels_stalls output_channels output_channels_stalls
S2MM チャネルバッファー ディスクリプター転送 Yes 2x Yes - -
S2MM チャネル ロック ストール - Yes - -
S2MM チャネル ストリーム不足 - Yes - -
S2MM チャネル メモリ バック プレッシャー - Yes - -
MM2S チャネルバッファー ディスクリプターの転送 - - Yes 2x Yes
MM2S チャネル ロック ストール - - - Yes
MM2S チャネル ストリーム バック プレッシャー - - - Yes
MM2S チャネル メモリ不足 - - - Yes
表 2. XSDB トレースのオプション
オプション 説明
-tile-based-memory-tile-metrics 指定されたタイルについて、どの AI エンジン ML メモリ タイル イベントを保存するかを設定します。
-graph-based-memory-tile-metrics 指定されたバッファー/グラフについて、どの AI エンジン ML メモリ タイル イベントを保存するかを設定します。

次に、XSDB フローを使用してメモリ タイル イベントをトレースする例を示します。

# Sets event trace to "input_channels" for the buffer named buffer2 of graph1 (channels 1 and 2) and "input_channels_stalls" for buffer4 in graph3 for channles 3 and 4.
-graph-based-memory-tile-metrics "graph1:buffer2:input_channels:1:2; graph3:buffer4:input_channels_stalls:3:4" 

# Sets event trace to "output_channels" for columns 1 to 4 only for channel 1 and 2, and "output_channels_stalls" for column 5 and channels 3 and 4.
-tile-based-memory-tile-metrics "1:4:output_channels:1:2; 5:output_channels_stalls:3:4"
表 3. メモリ タイルの XRT フロー トレース オプション
オプション 説明
tile_based_memory_tile_metrics = <column|all>:<off|channels|input_channels_stalls|output_channels_stalls>[:<channel 1>][:<channel 2>] 1 つ/すべての列に適用する AI エンジン メモリ タイル イベント トレース メトリクスを設定します。
tile_based_memory_tile_metrics =<mincolumn> <maxcolumn>:<off|input_channels|input_channels_stalls|output_channels|output_channels_stalls>[:<channel 1>][:<channel 2>] 範囲内のすべての列に適用する AI エンジン イベント トレース メトリクスを設定します。
graph_based_memory_tile_metrics = <graph name|all>:<buffer name|all>:<off|input_channels|input_channels_stalls|output_channels|output_channels_stalls>[:<channel 1>][:<channel 2>] 特定/すべてのグラフの 1 つ/すべてのバッファーに適用する AI エンジン イベント トレース メトリクスを設定します。

次に、xrt.ini ファイルの一部の例を示します。

# Sets event trace to "input_channels" for the buffer named buffer2 of graph1 (channels 1 and 2) and "input_channels_stalls" for buffer4 in graph3 for channles 3 and 4.
graph-based-memory-tile-metrics=graph1:buffer2:input_channels:1:2; graph3:buffer4:input_channels_stalls:3:4 

# Sets event trace to "output_channels" for columns 1 to 4 only for channel 1 and 2, and "output_channels_stalls" for column 5 and channels 3 and 4.
tile-based-memory-tile-metrics=1:4:output_channels:1:2; 5:output_channels_stalls:3:4