Confirm Firmware Installation for DFX-2RP Platforms - 2.3 English

Getting Started with Alveo Data Center Accelerator Cards User Guide (UG1301)
Document ID
UG1301
Release Date
2022-12-23
Version
2.3 English

When a card has successfully been installed and the firmware has been updated, both entries for Platform and SC version installed on the card and the system must match. If they do not match, the system will be unable to correctly run applications on your card.

To confirm your card is setup correctly to run applications, run the following command and visually compare the 'Platform' and 'SC Version' entries under Flashable partitions running on FPGA and Flashable partitions installed in system confirm they match. See Displaying Card BDF Values to obtain the device management BDF.
$ sudo /opt/xilinx/xrt/bin/xbmgmt examine --report platform --device <management BDF>
In the following example output, the platform (xilinx_u250_gen3x16_base_3, xilinx_u250_gen3x16_xdma_shell_3_1) and SC Version (4.6.11) displayed under Flashable partitions running on FPGA and Flashable partitions installed in system both match.
Flashable partitions running on FPGA
  Platform             : xilinx_u250_gen3x16_base_3
  SC Version           : 4.6.11
  Platform UUID        : 48810C9D-1786-0EF5-3E9E-529E8B14CE39
  Interface UUID       : 695718EC-21A2-32E4-5E1A-FCB4E558E11F

  Platform             : xilinx_u250_gen3x16_xdma_shell_3_1
  Logic UUID           : BD5FB8AB-AB26-6C32-6591-8257B5048E88
  Interface UUID       : F2F6C5E1-273E-7894-8F2C-4806221462F2

Flashable partitions installed in system
  Platform             : xilinx_u250_gen3x16_base_3
  SC Version           : 4.6.11
  Platform UUID        : 48810C9D-1786-0EF5-3E9E-529E8B14CE39

  Platform             : xilinx_u250_gen3x16_xdma_shell_3_1
  Logic UUID           : BD5FB8AB-AB26-6C32-6591-8257B5048E88
  Interface UUID       : 695718EC-21A2-32E4-5E1A-FCB4E558E11F

Under Flashable partitions installed in system it displays available shell partition(s) available to program on the FPGA. In this example, only one shell partition is available xilinx_u250_gen3x16_xdma_shell_3_1.

The logic-uuid and interface-uuid are used by the system to ensure compatible base and shell partitions are used for a given application.

If no shell partitions are displayed under Flashable partitions installed in system (as shown in the following output), it implies no shell partitions compatible with the base partition have been installed. Download and install a compatible shell partition from the Getting Started tab on the respective Alveo card product page: 
Flashable partitions running on FPGA
  Platform             : xilinx_u250_gen3x16_base_3
  SC Version           : 4.6.11
  Platform UUID        : 48810C9D-1786-0EF5-3E9E-529E8B14CE39
  Interface UUID       : 695718EC-21A2-32E4-5E1A-FCB4E558E11F

Flashable partitions installed in system
  Platform             : xilinx_u250_gen3x16_base_3
  SC Version           : 4.6.11
  Platform UUID        : 48810C9D-1786-0EF5-3E9E-529E8B14CE39

If the SC version does not match under Flashable partitions running on FPGA and Flashable partitions installed in system, the SC will need to be flashed. See SC versions do not match to update the SC version on the card.