タイムライン トレースの生成と表示 - 2023.2 日本語

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

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 日本語

Timeline Trace レポートを生成するには、次の手順に従って、コマンド ライン フローでタイムラインとデバイス トレース データ収集イネーブルにします。

  1. --profile オプション に示すように、リンク時に v++ --profile オプションを使用して、カーネルにアクセラレーション モニターおよび AXI パフォーマンス モニターを追加することにより FPGA バイナリをインストルメント化します。次に、v++ リンク コマンドに --profile.data を追加する例を示します。
    v++ -g -l --profile.data all:all:all ...
  2. ビルド プロセスでカーネルをインストルメント化したら、xrt.ini ファイルを編集してアプリケーションのランタイム実行時にデータ収集をイネーブルにする必要があります。詳細は、xrt.ini ファイル を参照してください。

    次の xrt.ini ファイルでは、アプリケーションの実行時に最大限の情報が収集されます。

    [Debug]
    opencl_trace=true
    device_trace=fine
    stall_trace=all
    
    ヒント: 大量のトレース データを収集する場合、v++ コマンドで --profile.trace_memory を指定し、xrt.initrace_buffer_size キーワードを含める必要がある場合があります。

    アプリケーションの実行後、タイムライン トレース データが opencl_trace.csv および device_trace_0.csv という CSV ファイルに保存されます。

  3. CSV レポートを表示するには、Vitis アナライザー ツールでアプリケーション実行中に生成された Run Summary を開きます。Vitis アナライザーを起動して Run Summary を開くには、次のコマンドを使用します。
    vitis_analyzer xrt.run_summary
    ヒント: デフォルトでは、Timeline Trace は階層ビューで表示されます。階層ビューでは、デザイン階層に従って情報が表示されますが、表示にかなりのスペースが使用されます。別の方法として、タイムライン表示をフラットにして、ライン間の不要なスペースをなくすこともできます。これには、ツールバーの Flatten Signal をクリックします。この機能は、作業する表示領域が少ない場合や、複数のトレース ファイルを比較する場合に便利です。