Switch Image on an NT SmartNIC

Handling FPGA Images

Platform
Napatech SmartNIC
Content Type
User Guide
Capture Software Version
Link™ Capture Software 12.11

Procedure

  1. To check the state of SmartNIC 1, write: $ imgctrl --adapter 1 --query
    An example of an output is:
    ...
    Adapter 0:
         PCI SLOT        : 0000:42:00.0
         PCI DEVICE ID   : 01D5
         PCI LANES       : x16
         ADAPTER TYPE    : NT50B01-01-NEBS-2x25-E3-FF-ANL 2x25Gb SFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9541-35-20-0000
         DESCRIPTION     : 2x25/10Gb, capture
    FPGA BANK0:
         PRODUCT CODE    : 9541
         VERSION         : 35.20
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9541
         VERSION         : 47.07
         DOWNLOADED BY   : jmh
    SUPPORTCHIP INFO:
         NT50B01         : v3.5s
    FPGA IMAGE STATE:
         IMAGE STATE     : NEUTRAL (code 0)
         PRIMARY BANK    : 0
         RUNNING BANK    : 0
    
    The SmartNIC state must be NEUTRAL.
  2. To perform a quick switch operation, run:
    /opt/napatech3/bin/imgctrl --adapter 0 --switch
    An example of an output is:
    Switching image on adapter 0:
      OK. Image switched. Remember to issue --confirm or --discard to accept/discard the change. Inquire the adapter via --query
  3. To verify that the state is now IMAGE SWITCH EVENT IN PROGRESS, run:
    /opt/napatech3/bin/imgctrl --adapter 0 --query
    An example of an output is:
    ...
    Adapter 0:
         PCI SLOT        : 0000:42:00.0
         PCI DEVICE ID   : 01D5
         PCI LANES       : x16
         ADAPTER TYPE    : NT50B01-01-NEBS-2x25-E3-FF-ANL 2x25Gb SFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9541-47-07-0000
         DESCRIPTION     : 2x25/10Gb, capture
    FPGA BANK0:
         PRODUCT CODE    : 9541
         VERSION         : 35.20
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9541
         VERSION         : 47.07
         DOWNLOADED BY   : jmh
    SUPPORTCHIP INFO:
         NT50B01         : v3.5s
    FPGA IMAGE STATE:
         IMAGE STATE     : IMAGE SWITCH EVENT IN PROGRESS (code 2)
         PRIMARY BANK    : 0
         CHANGED TO BANK : 1
    
  4. To acknowledge the switch and cause the primary image setting to be updated, run:
    /opt/napatech3/bin/imgctrl --adapter 0 --switch --confirm
    An example of an output is:
    Scanning for Napatech adapters..
    Applying current running image as safeboot image..
      OK. Adapter PrimaryImage has been updated to reflect current running image.
  5. To check that the state is back to NEUTRAL, and that the primary image bank has changed, run:
    /opt/napatech3/bin/imgctrl --adapter 0 --query
    An example of an output is:
    ...
    Adapter 0:
         PCI SLOT        : 0000:42:00.0
         PCI DEVICE ID   : 01D5
         PCI LANES       : x16
         ADAPTER TYPE    : NT50B01-01-NEBS-2x25-E3-FF-ANL 2x25Gb SFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9541-47-07-0000
         DESCRIPTION     : 2x25/10Gb, capture
    FPGA BANK0:
         PRODUCT CODE    : 9541
         VERSION         : 35.20
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9541
         VERSION         : 47.07
         DOWNLOADED BY   : jmh
    SUPPORTCHIP INFO:
         NT50B01         : v3.5s
    FPGA IMAGE STATE:
         IMAGE STATE     : NEUTRAL (code 0)
         PRIMARY BANK    : 1
         RUNNING BANK    : 1