Xilinx Board Utility (xbutil)

TheXilinx®Board Utility (xbutil) is a standalone command line utility that is included with theXilinxRun Time (XRT) installation package. It includes multiple commands to validate and identify the installed card(s) along with additional card details including DDR,PCIe®, shell name (DSA), and system information. This information can be used for both card administration and application debugging. Some of these include:

• Card administration tasks:
  • Flash card configuration memory of the card.
  • Reset hung cards.
  • Query card status, sensors, andPCI ExpressAER registers.
• Debug operations:
  • Download theSDAccel™binary (.xclbin) to FPGA.
  • Test DMA forPCIebandwidth.
  • Show status of compute units.

Thexbutilcommand line format is:

xbutil  [options]

where the available commands are given below. Specific command options are detailed in the respective command topics:

• clock
• dmatest
• dump
• flash
• flash scan
• help
• list
• mem read
• mem write
• program
• query
• reset
• scan
• status
• top
• validate
• m2mtest
• p2p

To run thexbutilcommand without prepending the path/opt/xilinx/xrt/bin/, run the following command.

Use the following command in csh shell:

$ source /opt/xilinx/xrt/setup.csh

Use the following command in bash shell:

$ source /opt/xilinx/xrt/setup.sh