アプリケーション ハードウェア ビルドの実行 - 2022.1 日本語

Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発 (UG1393)

Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 日本語

アプリケーション ハードウェア ビルドを実行すると、 Alveo™ データセンター アクセラレータ カードなどのアクセラレータ カード、または Versal® ACAP または Zynq® デバイスをターゲットにしたエンベデッド プロセッサ プラットフォームで実行されるアプリケーションを確認できます。示されるパフォーマンス データおよび結果は、アクセラレーション アプリケーションの実際のパフォーマンスです。この実行からのプロファイリング データでも、デザインを最適化できる可能性が示される場合があります。

ヒント: アクセラレータ カードを使用するには、 『Alveo データセンター アクセラレータ カード入門』 (UG1301) に説明されている手順に従って、カードを設置する必要があります。
  1. xrt.ini ファイル の説明に従って xrt.ini ファイルを編集します。

    これはオプションですが、評価目的にハードウェアで実行する場合に推奨されます。xrt.ini ファイルを使用すると、アプリケーション実行中にデバッグとプロファイル データを取り込むように XRT ファイルを設定できます。ハードウェアの実行時にイベント トレース データを取り込む方法は、アプリケーションでのプロファイリングのイネーブル を参照してください。実行中のハードウェアをデバッグする方法は、ハードウェア実行中のデバッグ を参照してください。

    ヒント: カーネル コードをデバッグ用にコンパイルするには、v++ -g オプションを使用してください。
  2. XCL_EMULATION_MODE 環境変数の設定を解除します。
    重要: XCL_EMULATION_MODE 環境変数がエミュレーション ターゲットに設定されていると、ハードウェア ビルドが実行されません。
  3. エンベデッド プラットフォームの場合は、SD カードを起動します。
    ヒント: この手順は、Versal ACAP や Zynq UltraScale+ MPSoC などのザイリンクス エンベデッド デバイスを使用するプラットフォームでのみ必要です。

    エンベデッド プロセッサ プラットフォームの場合、v++ --package コマンドで生成された ./sd_card フォルダーの内容を、システムのブート デバイスとして SD カードにコピーします。SD カードからシステムを起動します。

  4. アプリケーションを実行します。

    アプリケーションを実行するための具体的なコマンドラインは、ホスト コードによって異なります。ザイリンクス チュートリアルおよびサンプルで使用される一般的なインプリメンテーションは次のとおりです。

    ./host.exe kernel.xclbin
ヒント: このコマンド ラインでは、多くの Vitis サンプルおよびチュートリアルと同様に、ホスト プログラムが xclbin ファイルの名前を引数として使用することを想定していますが、アプリケーションによっては xclbin ファイルの名前がホスト プログラムにコード記述されていたり、実行に別の方法が必要であったりすることがあります。

アプリケーションでのプロファイリングのイネーブル で説明するように、デザインを実行中、実行時にデザイン データをキャプチャする多数のトレース オプションを指定できます。実行中に生成されたすべてのレポートが xrt.run_summary ファイルに収集されます。このレポートのコレクションは、Vitis アナライザーで run_summary を開くと表示でき、ハードウェア デザインを描くサマリ レポート、システムおよびプラットフォーム図、システム パフォーマンスを改善する推奨事項を示す Run Guidance レポート、実行時に xrt.ini ファイルで有効になっている場合は、プロファイル サマリおよびタイムライン トレースも含みます。詳細は、Vitis アナライザーの使用を参照してください。