Important: This
option cannot be used with embedded processor platforms.
The top command outputs card statistics
including memory topology, DMA transfer metrics, and Compute Unit usage data. This
command is similar to the Linux top command. When
running, it continues to operate until q is
entered in the terminal window to quit.
It has the following command line format:
xbutil top [-d card] [-i seconds]The following table lists the available options.
| Option | Description | Required |
|---|---|---|
-d
<card>
|
Specifies the target card. <card> can be specified as either
the card_id or Bus:Device:Function (BDF). Defaults to card_id = 0 if
not specified. Note: Use the
xbutil
scan command to display both the card_id and BDF
for installed cards. |
N |
-i
<seconds>
|
Refresh rate (in seconds). Default is 1 second. | N |
For example, the following command will perform top
with a two second refresh rate.
xbutil top -i 2| Field | Description |
|---|---|
| Device Memory Usage | Percentage of memory used per memory bank. Graphical usage bar will be displayed proportion to the amount of memory used. Bar will be similar to the following: |||||||||| |
| Power | Total card power |
| Mem Topology | Assigned tag to the memory bank |
| Memory type (that is, DDR or HBM) | |
| Temperature of the memory bank | |
| Total available memory per memory bank | |
| Current memory usage | |
| Number of buffers allocated | |
| Total DMA Transfer Metrics | Accumulated bytes transferred because of reboot |
| CU Usage | Number of commands executed by this CU. Numbers
are accumulated until the xclbin
is changed where they are reset to zero. |
The following example is an output after running this command:
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
############################################################################If no xclbin is loaded, the following will be
displayed:
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:
############################################################################