Appendix D: Obtaining Xbmgmt Command Options - Xilinx Alveo U200 Getting Started

Obtaining xbmgmt Command
Options
®
Xilinx Board Management (xbmgmt) utility is a standalone command line tool that is included
with the XRT installation package. This utility is used for card installation and administration, and
requires sudo privileges when running it and supports tasks include flashing the card firmware,
and scanning the current device and system configuration. Complete command documentation
can be found under
Unified Software Platform Documentation (UG1416).
This section describes how to obtain the xbmgmt command options necessary for flashing the
base partition and programming the shell partition.
The following command is used to flash the base partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --card
<card_bdf>
The following command is used to program the shell partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> --
card <card_bdf>
Command options, descriptions, and commands to display the options are provided in the
following table.
Table 5: Command Options and Descriptions
Option
card_bdf
base_name
shell_name
Use the following command to list the available base partition.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan
UG1301 (v1.8) February 5, 2021
Getting Started with Alveo Accelerator Cards
xbmgmt Utility in the Application Acceleration Development flow of the Vitis
Description
Card Bus Device Function (BDF) for the
card in the following format:
[Bus : Device : Function]
Base partition firmware name
Shell partition firmware name

Appendix D: Obtaining xbmgmt Command Options

xbmgmt flash --scan
or
xbmgmt partition --scan
xbmgmt flash --scan
xbmgmt partition --scan
Send Feedback
Appendix D
Command
www.xilinx.com
47