Upgrade the FPGA Image on an NT SmartNIC

Handling FPGA Images

product_line_custom
Napatech SmartNIC
category
User Guide

Procedure

  1. To check the state of SmartNIC 0, write: $ imgctrl --adapter 0 --query --verbose
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Press CTRL-Z (Win:CTRL-BREAK) to increase verbosity level at runtime.
    Scanning for Napatech adapters..
    Adapter 0:
         PCI SLOT        : 0000:06:00.0
         PCI DEVICE ID   : 0155
         PCI LANES       : x16
         ADAPTER TYPE    : NT100E3_1_PTP PCI Express Gen3 1x100Gb CFP4 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9505-08-06-0000
         64BIT CODE      : 0x000000C825210806
         ITEM CODE       : 200
         PRODUCT CODE    : 9505
         VERSION CODE    : 8
         REVISION CODE   : 6
         BUILD CODE      : 0
         BUILD TIME      : 0x592297AB
         BUILD DATE      : Mon May 22 07:47:55 2017 (UTC/GMT)
    FPGA BANK0:
         PRODUCT CODE    : 9505
         VERSION         : 8.06
         DOWNLOADED BY   : ntope
         DOWNLOAD DATE   : Tue Sep 26 09:33:32 2017
         SOURCE FILENAME : 200-9505-08-06-00-170522-0947.ntimg
         SOURCE DATE     : Mon May 22 13:43:41 2017
    FPGA BANK1:
         PRODUCT CODE    : 9505
         VERSION         : 8.06
         DOWNLOADED BY   : ntope
         DOWNLOAD DATE   : Tue Sep 26 09:33:34 2017
         SOURCE FILENAME : 200-9505-08-06-00-170522-0947.ntimg
         SOURCE DATE     : Mon May 22 13:43:41 2017
    SUPPORTCHIP INFO:
         IDENT           : AVR NT100E3_1_PTP
         VERSION         : 3.5f
         VERSION NAME    : Sep 19 2017 - 15:15:04
         RUNNING BANK    : 0
         SOURCE FILENAME : atxmega128a1u.NT100E3_1_PTP.bank0.hex
         DOWNLOADED BY   : kje
         DOWNLOAD DATE   : Wed Sep 20 16:01:16 2017
    FPGA IMAGE STATE:
         IMAGE STATE     : NEUTRAL (code 0)
         PRIMARY BANK    : 1
         RUNNING BANK    : 1

    The SmartNIC state must be NEUTRAL.

  2. To upgrade the image, write (for instance): $ imgctrl --adapter 0 --program --ini kje --ntimg 200-9508-06-06-00-161201-2014.ntimg
    Note: Interrupting the programming process, for instance using Ctrl+c, will invalidate the bank. In such a case, simply restart the programming process.
    An example of an output is:
    imgctrl -a0 -p --ini kje --ntimg 200-9505-09-08-00-170921-1453.ntimg
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Adapter upgrade commencing..
    Writing FPGA bank 0
      Erasing................... 100% done
      Writing................... 100% done
      Verifying................. 100% done
    Done writing FPGA bank 0
    Note: You can inspect the upload result through the Bank0 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

Results

Note: Upgrading an FPGA image does not automatically switch to the new image. Use the --switch command to try the new image (see Switch Image on an NT SmartNIC).