重要: このオプションはエンベデッド プロセッサ プラットフォームでは使用できません。
top コマンドは、メモリ トポロジ、DMA 転送メトリクス、計算ユニットの使用量データなど、カードの統計を出力します。このコマンドは Linux の top コマンドと似ており、実行すると、ターミナル ウィンドウに q を入力するまで操作が継続実行されます。
コマンド ライン構文は次のとおりです。
xbutil top [-d card] [-i seconds]次の表に、使用可能なオプションを示します。
| オプション | 説明 | 必須 |
|---|---|---|
-d
<card>
|
ターゲット カードを指定します。<card> は、card_id または Bus:Device:Function (BDF) のいずれかに指定できます。指定しない場合は、デフォルトの card_id = 0 になります。 注記:
xbutil
scan コマンドを使用すると、設置されたカードの ID と BDF の両方が表示されます。 |
× |
-i
<seconds>
|
更新レート (秒)。デフォルトは 1 秒です。 | N |
たとえば次のコマンドは、top コマンドを更新レート 2 秒で実行します。
xbutil top -i 2| フィールド | 説明 |
|---|---|
| Device Memory Usage | 使用されているメモリの割合をメモリ バンクごとに示します。 使用されているメモリの量に応じて、次のように縦棒が表示されます。 |||||||||| |
| Power (消費電力) | カードの全消費電力 |
| Mem Topology | メモリ バンクに割り当てられたタグ |
| メモリのタイプ (DDR または HBM) | |
| メモリ バンクの温度 | |
| メモリ バンクごとに使用可能なメモリ | |
| 現在のメモリ使用量 | |
| 割り当てられたバッファー数 | |
| Total DMA Transfer Metrics | リブートにより転送された累積バイト数 |
| CU Usage | この CU で実行されたコマンドの数。この数値は、xclbin is が変更され、0 にリセットされるまで累積されます。 |
次に、このコマンドの出力例を示します。
Device Memory Usage
[0] bank0 [ ||||||||||| 25.0% ]
[1] bank1 [ 0.00% ]
[2] bank2 [ 0.00% ]
[3] bank3 [ 0.00% ]
Power
34.0W
Mem Topology Device Memory Usage
Tag Type Temp Size Mem Usage BO nums
[0] bank0 MEM_DDR4 36 C 16 GB 4 GB 16
[1] bank1 MEM_DDR4 38 C 16 GB 0 Byte 0
[2] bank2 MEM_DDR4 46 C 16 GB 0 Byte 0
[3] bank3 MEM_DDR4 41 C 16 GB 0 Byte 0
Total DMA Transfer Metrics:
Chan[0].h2c: 75 GB
Chan[0].c2h: 78 GB
Chan[1].h2c: 61600 MB
Chan[1].c2h: 61440 MB
############################################################################
Compute Unit Usage:
CU[@0x1800000] : 68
CU[@0x1c00000] : 68
CU[@0x250000] : 6
############################################################################
xclbin が読み込まれていない場合、次のような出力が表示されます。
Device Memory Usage
[1] bank1 [ 0.00% ]
Power
23W
Mem Topology Device Memory Usage
Tag Type Temp Size Mem Usage BO nums
[1] bank1 MEM_DDR4 36 64 GB 0 Byte 0
Total DMA Transfer Metrics:
Chan[0].h2c: 0 Byte
Chan[0].c2h: 0 Byte
Chan[1].h2c: 0 Byte
Chan[1].c2h: 0 Byte
############################################################################
Compute Unit Usage:
############################################################################