グラフの入力および出力用のイベント プロファイル API - 2023.2 日本語

AI エンジンにはパフォーマンス カウンターが含まれ、パフォーマンス メトリクスを計測するためにハードウェア イベントをカウントするよう設定できます。イベント API をグラフ制御 API と共に使用して、グラフの指定の期間実行して、特定のパフォーマンス メトリクスをプロファイリングできます。イベント API では、プラットフォーム I/O ポートの帯域幅、グラフのスループット、グラフのレイテンシなどのパフォーマンス メトリクスを計測するのにプラットフォーム I/O ポート (PLIO および GMIO) のみがサポートされます。

イベント API は、AI エンジン/PL インターフェイスを通過するネットのストリーム スイッチで発生したイベントを監視します。ネット上のストリーム スイッチのイベントには、次の図に示すように、idle、running、および stall があります。

図 1. ネット上のイベント

• ストリーム スイッチを通過するデータがない場合、ストリーム スイッチは idle ステートになります。
• ストリーム スイッチを通過するデータがある場合、ストリーム スイッチは running ステートになります。
• ネット上のすべての FIFO がフルになると、ストリーム スイッチは stall ステートになります。
• データ転送が再開すると、ストリーム スイッチは running ステートになります。

次に、データが mm2s PL カーネルから AI エンジンに転送されるグラフの例を示します。グラフがデータを AI エンジンから s2mm PL カーネルに送信することも示します。

図 2. グラフの例

異なるポートが同じ AI エンジン/PL インターフェイス列を通過できます。この列は、インターフェイスのパフォーマンス カウンターを共有します。Vitis IDE の array ビューで、これらのポートの配線がどの列を通過しているかを確認できます。次の図に、上記の例の array を示します。赤い丸で囲まれた部分はストリーム スイッチであり、ここでイベント API が監視します。

図 3. [Array] ビューの例

#include "adf/adf_api/XRTConfig.h"
......
auto device = xrt::device(0); //device index=0
auto uuid = device.load_xclbin(xclbinFilename);
auto dhdl = xrtDeviceOpenFromXcl(device);
adf::registerXRT(dhdl, uuid.get());
event::handle handle = event::start_profiling(......);