Card Validation - 1.1 English

Card installation can be validated using the xbutil validate command. This command performs various tests and checks on the card including PCIe link status, SC version status, memory, and bandwidth tests and auxiliary power connection where applicable. Full command details can be found in xbutil documentation. Depending on the card tested, not all tests are valid or might require the function to be enabled (for example, Peer-2-Peer).

Use the following command to run the card validation test:

/opt/xilinx/xrt/bin/xbutil validate --device <user BDF> --verbose

Where <user BDF> is the card to be programmed. To obtain the device management BDF, see Displaying Card BDF Values.

If the card was installed and validated successfully, a message similar to the following will be displayed. Review the Validation Summary section at the end of the output and confirm the device validated successfully. Additional validation details are displayed by appending the --verbose option to the command. See Card Validation within the Alveo Card Debug Guide for support.

Verbose: Enabling Verbosity
Starting validation for 1 devices

Validate Device     : [0000:af:00.1]
  Platform       : xilinx_u55n_gen3x4_xdma_base_1
  SC Version      : 7.1.12
  Platform ID     : 9964C19C-DB53-EB6C-69B6-FD2072401583
-------------------------------------------------------------------------------
Test 1 [0000:af:00.1]  : Aux connection

  Description     : Check if auxiliary power is connected
  Details       : Aux power connector is not available on this board
  Test Status     : [SKIPPED]
-------------------------------------------------------------------------------
Test 2 [0000:af:00.1]  : PCIE link
  Description     : Check if PCIE link is active
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 3 [0000:af:00.1]  : SC version
  Description     : Check if SC firmware is up-to-date
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 4 [0000:af:00.1]  : Verify kernel
  Description     : Run 'Hello World' kernel test
  Xclbin        : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/verify.xclbin
  Testcase       : /opt/xilinx/xrt/test/validate.exe
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 5 [0000:af:00.1]  : DMA
  Description     : Run dma test
  Details       : Host -> PCIe -> FPGA write bandwidth = 3323.8 MB/s
              Host <- PCIe <- FPGA read bandwidth = 3252.4 MB/s
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 6 [0000:af:00.1]  : iops
  Description     : Run scheduler performance measure test
  Xclbin        : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/verify.xclbin
  Testcase       : /opt/xilinx/xrt/test/xcl_iops_test.exe
  Details       : IOPS: 443001 (verify)
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 7 [0000:af:00.1]  : Bandwidth kernel
  Description     : Run 'bandwidth kernel' and check the throughput
  Xclbin        : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/bandwidth.xclbin
  Testcase       : /opt/xilinx/xrt/test/kernel_bw.exe
  Details       : Throughput (Type: HBM) (Bank count: 1) : 12378.9MB/s
  Test Status     : [PASSED]
-------------------------------------------------------------------------------
Test 8 [0000:af:00.1]  : Peer to peer bar

  Description     : Run P2P test
  Details       : P2P bar is not enabled
  Test Status     : [SKIPPED]
-------------------------------------------------------------------------------
Test 9 [0000:af:00.1]  : Memory to memory DMA

  Description     : Run M2M test
  Details       : M2M is not available
  Test Status     : [SKIPPED]
-------------------------------------------------------------------------------
Test 10 [0000:af:00.1]  : Host memory bandwidth test

  Description     : Run 'bandwidth kernel' when host memory is enabled
  Details       : Host memory is not enabled
  Test Status     : [SKIPPED]
-------------------------------------------------------------------------------
Test 11 [0000:af:00.1]  : vcu
  Description     : Run decoder test
  Details       : Verify xclbin not available or shell partition is not
              programmed. Skipping validation.
  Test Status     : [SKIPPED]
-------------------------------------------------------------------------------
Validation completed