Switch Image on an NT SmartNIC

Procedure

To check the state of SmartNIC 1, write: $ imgctrl --adapter 1 --query

An example of an output is:

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 1:
     PCI SLOT        : 0000:84:00.0
     PCI DEVICE ID   : 01A5
     PCI LANES       : x8x8
     ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
RUNNING FPGA:
     FPGA IDENT      : 200-9516-09-08-0000
FPGA BANK0:
     PRODUCT CODE    : 9516
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
FPGA BANK1:
     PRODUCT CODE    : 9515
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
SUPPORTCHIP INFO:
     NT200E3_2_PTP   : v3.5f
FPGA IMAGE STATE:
     IMAGE STATE     : NEUTRAL (code 0)
     PRIMARY BANK    : 0
     RUNNING BANK    : 0

The SmartNIC state must be NEUTRAL.

To perform a quick switch operation, write: $ imgctrl --adapter 1 --switch

An example of an output is:

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Switching image on adapter 1:
  OK. Image switched. Remember to issue --confirm or --discard to accept/discard the change. Inquire the adapter via --query

To verify that the state is now IMAGE SWITCH EVENT IN PROGRESS, write: $ imgctrl --adapter 1 --query

An example of an output is:

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 1:
     PCI SLOT        : 0000:84:00.0
     PCI DEVICE ID   : 01A5
     PCI LANES       : x8x8
     ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
RUNNING FPGA:
     FPGA IDENT      : 200-9515-09-08-0000
FPGA BANK0:
     PRODUCT CODE    : 9516
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
FPGA BANK1:
     PRODUCT CODE    : 9515
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
SUPPORTCHIP INFO:
     NT200E3_2_PTP   : v3.5f
FPGA IMAGE STATE:
     IMAGE STATE     : IMAGE SWITCH EVENT IN PROGRESS (code 2)
     PRIMARY BANK    : 0
     CHANGED TO BANK : 1

To acknowledge the switch and cause the primary image setting to be updated, write: $ imgctrl --adapter 1 --switch --confirm

An example of an output is:

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Applying current running image as safeboot image..
  OK. Adapter PrimaryImage has been updated to reflect current running image.

To check that the state is back to NEUTRAL, and that the primary image bank has changed, write: $ imgctrl --adapter 1 --query

An example of an output is:

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 1:
     PCI SLOT        : 0000:84:00.0
     PCI DEVICE ID   : 01A5
     PCI LANES       : x8x8
     ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
RUNNING FPGA:
     FPGA IDENT      : 200-9515-09-08-0000
FPGA BANK0:
     PRODUCT CODE    : 9516
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
FPGA BANK1:
     PRODUCT CODE    : 9515
     VERSION         : 9.08
     DOWNLOADED BY   : ntope
SUPPORTCHIP INFO:
     NT200E3_2_PTP   : v3.5f
FPGA IMAGE STATE:
     IMAGE STATE     : NEUTRAL (code 0)
     PRIMARY BANK    : 1
     RUNNING BANK    : 1