作者：Chen Yang，AMD开发工程师，来源：AMD Xilinx开发者社区
承接上一篇blog介绍xbmgmt，这次来介绍xbutil的使用方法。在使用之前，请先安装好XRT，然后source /opt/xilinx/xrt/setup.sh(bash shell)或者source /opt/xilinx/xrt/setup.csh(csh shell)。
xbutil的全称是Xilinx Board Utility，主要用于检验和识别加速卡，并且可以得到一些板卡的具体信息，比如板卡内存，主机接口，板卡名称等。不同于xbmgmt用于管理空间的配置，xbutil主要侧重于用户空间。
xbutil也有全局5个通用选项：
--verbose：启用更详细的信息打印，帮助用户从log中得到更多的信息。
--batch：使能batch模式
--force：强制进行操作，例如生成已存在文件，可以强制覆盖
--help：显示help信息
--version: xrt及其驱动版本信息
截止到2023.1版本，xubtil还有5个功能选项：
xbutil program
xbutil validate
xbutil examine
xbutil configure
xbutil reset
xbutil program
xbutil program的用途是直接下载xclbin文件到板卡上，等效于host中device.load_xclbin（binaryFile），当然这里注意的是xclbin要对应相应的platform，不能把u50的xclbin下载到u200板卡上。xbutil program 有以下功能选项：a) --device：指定目标板卡，输入对应的BDF（BDF的查看请参考介绍xbmgmt文章）；b) --user：要求指定需要下载的xclbin文件
示例：xbutil program --device 0000:00:00.1 --user ./vadd.xclbin
xbutil validate
xbutil validate用途是通过运行一些预编译的基本测试来验证安装的板卡。xbutil validate有如下功能选项：
a) –device（略）
b) –run：指定运行测试的内容：
all 运行所有的测试（默认）
aux-connection 检查辅助电源是否连接
pcie-link 检查PCIE是否link
sc-version SC固件是否过期
verify 运行vadd kernel测试
dma dma测试
iops 测试调度程序性能
mem-bw 运行bandwidth kernel并检查吞吐量
p2p peer-to-peer测试
m2m memory-to-memory测试
hostmem-bw 使能host memory运行bandwidth kernel
bist bist测试
vcu 解码测试
quick 快速测试Aux connection，PCIE link，SC version and Verify kernel
aie-pl AIE-PL测试
c) –format：指定报告格式，format需要和ouput选项共同使用，如果确实output选项，结果会直接打印在终端。有两中参数可选JSON和JSON-2020.2；
d) –output：指定输出文件；
e) –param：指定可拓展的参数来测试，test（dma）， key（block-size）， value（数值，单位为bytes）
示例： xbutil validate --device 0000:00:00.1
xbutil validate --device 0000:00:00.1 --run DMA pcie-link --format JSON --output test.json
xbutil validate --device 0000:00:00.1 --run DMA --param dma:block-size:1024
xbutil examine
xbutil examine 用于报告板卡的具体信息，xbutil examine有如下选项：
a) –device（略）；
b) –report：报告以下对应的板卡信息：
aie 报告xclbin文件中AIE kernel信息
aieshim 报告AIE shim的状态
all 报告所有已知信息
debug-ip-status 报告在kernel编译中插入的debug ip
dynamic-regions xclbin和计算单元的信息
electrical 报告器件上的电子电源传感器
error 器件上的异步错误
firewall 报告防火墙状态
host 报告主机配置及驱动信息
mailbox Mailbox信息
mechanical 器件周围机械传感器
memory 报告xclbin中内存拓扑
pcie-info PCIE信息
platform 平台信息
qspi-status QSPI写保护状态
thermal 报告期间上的热传感器
c) –format（略）
d) –output（略）
示例： xbutil examine
xbutil examine --device 0000:00:00.1 --report electrical firewall --format JSON --output test.json
xbutil configure
xbutil configure根据用户应用需要配置相关的设置（需要sudo）。
具体可以配置如下：
a) –device（略）
b) –host-mem/--p2p：开启（enable）或者关闭（disable）host-mem和p2p；
c) –size：与—host-mem enable配合，指定memory的大小。
示例： sudo xbutil configure --device 0000:00:00.1 --host-mem enable --size 1G
sudo xbutil configure --device 0000:00:00.1 --p2p disable
xbutil reset
xbutil reset用途是重置器件，目前功能如下：a) –device（略）；b) –type：选择重置类型，目前仅支持hot重置(默认)。
示例：xbutil reset --device 0000:65:00.1 –type hot
