Procedure
-
Enter the following command to list the available FPGA images.
# ls -R /opt/napatech3/images/
This is an example of an output from this command.
/opt/napatech3/images/: NT200A02 NT50B01 /opt/napatech3/images/NT200A02: 200-9530-42-05-00-210601-2117.ntimg /opt/napatech3/images/NT50B01: 200-9542-42-05-00-210602-2336.ntimg
-
Flash the FPGA with the appropriate image using the imgctrl command
(/opt/napatech3/bin/imgctrl).
imgctrl -a 0 -p --ntimg <path_to_image_file> \ --ini <id_string>
where:- path_to_image_file specifies the path to the .ntimg FPGA image file to be uploaded to the flash
- id_string specifies a user-chosen identifier
This is an example of the command to flash the FPGA.
/opt/napatech3/bin/imgctrl -a 0 -p \ --ntimg 200-9530-42-05-00-210601-2117.ntimg \ --ini LinkVirt-4.2
An output example:... Scanning for Napatech adapters.. Adapter upgrade commencing.. Writing FPGA bank 1 Erasing................... 100% done Writing................... 100% done Verifying................. 100% done Done writing FPGA bank 1 Note: You can inspect the upload result through the Bank1 Contents section using the --query mode. To try the new image, remember to switch bank using the --switch mode. See --help for more information. Upgrade process complete
Note: Refer to Handling FPGA Images on the Napatech Documentation Portal for complete documentation on the Napatech image control tool imgctrl. -
Switch to the new FPGA image using the imgctrl command.
/opt/napatech3/bin/imgctrl -s -a 0 /opt/napatech3/bin/imgctrl -s -a 0 --confirm
Note:Switching to the new FPGA image may fail with an error as follows.Use the --pcirst option to perform a PCI Reset switch method which will execute on next system reboot. Remember to --confirm the switch after rebooting. This is an example command sequence with a PCI Reset.... Error: You cannot quick switch image. New image requires different set of PCI resources, which must be assigned during the PCI resource enumeration at server reboot. Please use --pcirst command and reboot the entire host to switch image. FAIL. Switching failed. Use --query to examine adapter
The server must be rebooted as reloading the FPGA is not sufficient./opt/napatech3/bin/imgctrl -s -a 0 --pcirst reboot /opt/napatech3/bin/imgctrl -s -a 0 --confirm
Note: 33.00 or newer version FPGA images support SR-IOV capabilities. If the FPGA image of the SmartNIC has been switched from an older version to 33.00 or newer version, you must reboot the server to enumerate SR-IOV capabilities. -
Confirm the FPGA image state running the following command.
/opt/napatech3/bin/imgctrl -q
An output example:imgctrl v3.13.0.4-ccbef (Jan 4 2021 19:15:51) (Logfile: /tmp/imgctrl.log) Scanning for Napatech adapters.. Adapter 0: PCI SLOT : 0000:03:00.0 PCI DEVICE ID : 01C5 PCI LANES : x16 ADAPTER TYPE : NT200A02-01-SCC-2x100/40-E3-FF-ANL 2x100Gb QSFP28 / 2x40Gb QSFP+ platform RUNNING FPGA: FPGA IDENT : 200-9530-42-05-0000 DESCRIPTION : 2x25Gb, virtualization FPGA BANK0: PRODUCT CODE : 9521 VERSION : 28.07 DOWNLOADED BY : ntope FPGA BANK1: PRODUCT CODE : 9530 VERSION : 42.05 DOWNLOADED BY : LinkVirt-4.2 SUPPORTCHIP INFO: NT200A02 : v3.5r FPGA IMAGE STATE: IMAGE STATE : NEUTRAL (code 0) PRIMARY BANK : 1 RUNNING BANK : 1