作者：Chen Yang，AMD赛灵思开发者
XRT自2021.1更新后，原有的XRT Tool指令发生了一些变化。包括xbmgmt，xclbinutil，xbutil，xbflash2（standalone），xball，xbtop。其中xbmgmt是用于管理板卡，例如刷新shell，检测板卡的信息等，也是初次上手新版卡安装固件的必需工具。此次试验平台为U50，操作系统为Ubuntu 18.04，预先安装XRT。因平台受限，有些功能无法完全展示。
xbmgmt有5个通用选项，分别是：
--verbose：启用更详细的信息打印，帮助用户从log中得到更多的信息。
--batch：使能batch模式
--force：强制进行操作，例如已存在文件，可以强制覆盖
--help：显示help信息
另外xbmgmt还有五个功能选项，可以理解为二级菜单：
xbmgmt configure
xbmgmt dump
xbmgmt examine
xbmgmt program
xbmgmt reset
类似configure前面是不加--”，接下来结合实际的板子来看一下是怎么用的：
在开始使用前需要先查找到板卡的BDF，BDF可以在多个Alveo板卡的时候可以作为识别标志。在终端输入sudo lspci -vd 10ee: (xdmgmt examine也可以输出显示BDF，但是为了先后关系，先使用lspci找到BDF) ，BDF的格式一般是vvvv: xx: yy.0/1，例如0000:01:00.0（可能会省略0000，显示为01:00.0）。
1. xbmgmt configure
xbmgmt configure主要用用于内存的配置，它有3个选项可以使用：--device，--input，--retention。a) 其中device就是 指定BDF；b) input是指定内存配置的INI文件; c) retention是使能或关闭DDR内存保留。（如有相同的选项，后面不再赘述，例如device)
常见的用法是：
xbmgmt configure --device 0000:01:00.0 --input ./memory_config.ini xbmgmt configure --device 0000:01:00.0 --retention ENABLE(DISABLE)
xbmgmt dump 主要用于打印出一些指定选项的内容，它有4个选项：--device，--flash，--config，--output。 a) device（略）；b) falsh是可编程镜像；c) config 是系统配置；d) output是指定输出的文件。
常见的用法是：
xbmgmt dump --device 0000:01:00.0 --flash --output ./flash_dump.txt xbmgmt dump --device 0000:01:00.0 --config --output ./config_dump.ini
3. xbmgmt examine
相比前两个功能，xbmgmt examine用的比较多，所以比较重要。它主要打印出设备和主机状态信息，比如运行的shell版本等，易于调试和配置。
它有四个选项：--device，--report，--format，--output:
a) device（略）
b) 其中report是指定具体内容，可以指定如下选项：
all：所有已知的信息
firewall：防火墙状态
host：主机状态
mailbox：设备的mailbox
mechanical：设备上和周围的传感器
platform：平台信息
c) format 是指定报告的格式，格式为JSON和JSON-2020.2。这个功能需要跟--output配合，如果缺失--output，将直接输出至终端上。
d) output（略）
常见的用法是：
xbmgmt examine --device 0000:01:00.0 --report all
有些信息需要root权限，不然无法显示。
xbmgmt examine --device 0000:01:00.0 --report platform --format JSON --output output.json
