Card Validation

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 may require the function to be enabled (i.e., Peer-2-Peer).

Use the following command to run the card validation test:

$ /opt/xilinx/xrt/bin/xbutil validate -d <user BDF>

where user BDF is the card to be validated. See Obtaining Card BDF Values to obtain the user BDF value.

If the card was installed and validated successfully, a message similar to the following will be displayed. Review the output and confirm the device validated successfully. Additional validation details are displayed by appending the --verbose option to the command.

Starting validation for 1 devices
Platform              : xilinx_vck5000_gen3x16_xdma_base_1
    SC Version            : 4.4.12
    Platform ID           : 1E56042E-C345-CF41-5D66-4E9EE73451FC
-------------------------------------------------------------------------------
Test 1 [0000:01:00.1]     : PCIE link 
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 2 [0000:01:00.1]     : SC version 
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 3 [0000:01:00.1]     : Verify kernel 
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 4 [0000:01:00.1]     : DMA 
    Details               : Host -> PCIe -> FPGA write bandwidth = 10820.6 MB/s
                            Host <- PCIe <- FPGA read bandwidth = 10513.8 MB/s
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 5 [0000:01:00.1]     : iops 
    Details               : IOPS: 132544 (hello)
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 6 [0000:01:00.1]     : Bandwidth kernel 
    Details               : Maximum throughput: 50540 MB/s
    Test Status           : [PASSED]
-------------------------------------------------------------------------------
Test 7 [0000:01:00.1]     : vcu 
Validation completed. Please run the command '--verbose' option for more details