xbmgmtcommand-line tool is in preview mode for the 2020.2 release of XRT. This version will replace the current
xbmgmtin a future release of XRT. Refer to https://xilinx.github.io/XRT/2020.2/html/xbmgmt2.html for information about the new utility.
Board Management (
xbmgmt) utility is a standalone command line tool that is
included with the Xilinx Runtime (XRT) installation
xbmgmt command supports both Alveo Data Center accelerator cards, and embedded
Accelerator cards are partitioned into a user function and a management
function to provide different levels of card access. The user function allows end users
to load and run their applications, while the management function is for system
administrators to manage the card. The
interacts with the user function. The
which requires root privilege, is for interacting with the management function. The
reason for splitting the function access between the two utilities is to provide some
security for the management features of the tool.
xbmgmtutility only works with Alveo cards that have Xilinx provided shells/platforms. XRT does not work on custom Vivado® designs.
This utility is used for card installation and administration, and
sudo privileges when running it. The
xbmgmt supported tasks include flashing the card firmware,
and scanning the current device configuration.
xbmgmt command line format is:
xbmgmt <command> [options]
The supported sub-commands are given below.
- Parse or update daemon/device configuration
- Update SC firmware or shell on the device
- Print out help message for a sub-command
- Show and download partition onto the device
- List all detected
- Print out XRT build version
helpcommand to list the available
xbmgmtcommands and options, and access help for individual commands by using the following:
xbmgmt help <command>
xbmgmt help <subcommand>
Set up the
xbmgmt command using the
- For csh
$ source /opt/xilinx/xrt/setup.csh
- For bash
$ source /opt/xilinx/xrt/setup.sh