top - 2020.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 English
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.

Table 1. xbutil top Command 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
Table 2. Top Field Definition
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:

############################################################################