scan (xbutil) - 2021.1 Japanese

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

Document ID
UG1393
Release Date
2022-03-29
Version
2021.1 Japanese

xbutil scan コマンドは、次のような詳細なシステム情報を表示します。

  • システム コンフィギュレーションの詳細
  • XRT 情報
  • GOLDEN ステートのカード以外のシステム上にインストールされたカードすべてがリストされます。

コマンド ライン形式は次のとおりで、オプションはありません。

xbutil scan

次の表には、xbutil scan コマンドのさまざまなセクションから返されるフィールドをリストしています。

表 1. システム コンフィギュレーションのフィールド定義
フィールド 説明
OS Name マシンで実行される OS の名前
Release OS のリリース番号
Version OS バージョン
Machine CPU ベースのアーキテクチャ
Model マシン モデル
CPU Cores マシン上の CPU コアの数
Memory マシンにインストールされたメモリ合計 (MB)
Glibc インストールされた GLIBC バージョン
Distribution 分配
Now 現在の日付と時間
表 2. XRT のフィールド定義
フィールド 説明
Version XRT バージョン
Git Hash 関連する GIT ハッシュ
Git Branch 関連する GIT 分岐
Build Date XRT ビルドの日付
XOCL XOCL バージョン
XCLMGMT XCLMGMT バージョン

システムにインストールされた各カードのリストも表示されます。カードごとに別の行になります。1 つのカード出力例は、次のとおりです。インストールされたカードの詳細を示す複数のフィールドが表示されます。フィールドは、スペースで区切られます。

[0] 0000:65:00.1 xilinx_u50_gen3x16_xdma_201920_3 user(inst=128)

フィールドは、次のように定義されます。

表 3. インストールされたカードのフィールド定義
フィールド 説明
[card_id] ドライバー データ構造のカード エニュメレーションに基づいて割り当てられた card_id が表示されます。一意の card_id が検出されたカードごとに割り当てられます。順番は、ウォーム リブートまたはコールド リブート後に変更できます。
Bus : Device : Function インストールされたカードごとにエニュメレーションされたカードの Bus:Device:Function (BDF) が表示されます。構文は次のとおりです。

[ Bus : Device : Function ]

カードの BDF は、プラグインされた PCIe スロットに基づいて決定されます。

注記: xbutil scan コマンドを使用すると、インストールされたカードに対して card_id と BDF の両方が表示されます。
Platform name プラットフォーム名は、次のフォーマットになります。
<company>_<card>_<customization>_<major_release>_<minor_release>

プラットフォームの命名情報は、 『Alveo データセンター アクセラレータ カード プラットフォーム ユーザー ガイド』 (UG1120) を参照してください。

user (inst = <value>) カードに関連するユーザー関数のインスタンス番号が表示されます。インスタンス番号を使用すると、各関数のデバイス ノードを簡単に見つけることができます。

Linux OS の場合、デバイス ノードは /dev/dri/renderD<inst> に含まれます。

また、インスタンスは dmesg 情報を特定のカードにマップする際に便利です。

次は、xbutil scan 出力の例です。システム コンフィギュレーションおよび XRT 情報セクションがまず表示され、次に検出されたカードが表示されます。次の例では、1 つのカードが検出されて、card_ID に 0 が割り当てられています。BDF は 0000:65:00.1 です。フラッシュ メモリに書き込まれてカードで実行されるプラットフォームは xilinx_u50_gen3x16_xdma_201920_3 で、ユーザー インスタンスは 128 に割り当てられています。

INFO: Found total 1 card(s), 1 are usable
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
System Configuration
OS name:    Linux
Release:    4.15.0-96-generic
Version:    #97~16.04.1-Ubuntu SMP Wed Apr 1 03:03:31 UTC 2020
Machine:    x86_64
Model:      Super Server
CPU cores:  16
Memory:     15703 MB
Glibc:      2.23
Distribution:   Ubuntu 16.04.6 LTS
Now:        Tue Apr 14 21:08:05 2020
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
XRT Information
Version:    2.5.309
Git Hash:   9a03790c11f066a5597b133db737cf4683ad84c8
Git Branch: 2019.2_PU2
Build Date: 2020-02-23 18:51:37
XOCL:       2.5.309,9a03790c11f066a5597b133db737cf4683ad84c8
XCLMGMT:    2.5.309,9a03790c11f066a5597b133db737cf4683ad84c8
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [0] 0000:65:00.1 xilinx_u50_gen3x16_xdma_201920_3 user(inst=128)

複数のカードがインストールされる場合、検出されたカードのリストが展開表示されます。次の例の場合、3 つのカードが検出され、card_ID に 0、1、2 がそれぞれ割り当てられています。

[0] 0000:a6:00.1 xilinx_u280_xdma_201920_2 user(inst=130)
[1] 0000:73:00.1 xilinx_u250_xdma_201830_2 user(inst=129)
[2] 0000:17:00.1 xilinx_u200_xdma_201830_2 user(inst=128)
リストされたカードの前にアスタリスクが付いている場合、そのカードが準備できていないことを示します。次は、使用できないカードのメッセージの例です。
*[0] 0000:a6:00.1 xilinx_u280_xdma_201920_2(ts=0x5e172e16) user(inst=130)
WARNING: card(s) marked by '*' are not ready, run xbmgmt flash --scan --verbose to further check the details.
注記: ゴールデン ステート (フラッシュ メモリに書き込まれたパーティションなし) のカードは、表示されません。