Query Mode

Description

Inquiring the system for information about NT SmartNICs is a passive probing of FPGA and firmware version as well as flash bank information. It does not alter the state of any SmartNICs.

The output from a --query -vv command (see Syntax for the imgctrl Tool) is useful information for Napatech support personnel in assisting with any troubles you may encounter. -vv displays an output containing more detailed information.

The --query command can also be executed with a --brief argument which condenses the SmartNIC information to a one-line version.

Command example 1

This is an example of a --query command.

$ imgctrl --query

Output example 1

This is an example of an output from the --query command in Command example 1.

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 0:
     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

This information provides the version of the currently running FPGA on each SmartNIC. SmartNIC 0, for example, is a PCI Express Gen3 2 × 100 Gbit/s SmartNIC running FPGA 9516 version 9.08. The primary bank for SmartNIC 0 is bank 0, and no switch event is currently pending, since the SmartNIC is in the NEUTRAL state (see NEUTRAL state). This means that on the next reboot or power cycle, bank 0 continues to be the primary bank.

Note: This SmartNIC supports PCIe bifurcation with 2 × 8-lanes PCIe device endpoints. Furthermore, the SmartNIC supports two different FPGA images, the capture/replay image 9516 in FPGA bank 0 and the capture image 9515 in FPGA bank 1.

Command example 2

This is an example of a --query command.

$ imgctrl --query --brief

Output example 2

This is an example of an output from the --query command in Command example 2.

imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
ADAPTER 0: PCI:0000:84:00.0 DEVICE:NT200A01-SCC       RUNNING FPGA:200-9516-09-08-0000

Command example 3

This is an example of a --query command.

$ imgctrl --query --log

Output example 3

This is an example of an output from the --query command in Command example 3.

imgctrl v3.4.7.29602 (Nov 25 2016 16:00:19) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 0:
     PCI SLOT        : 0000:05:00.0
     PCI DEVICE ID   : 01A5
     PCI LANES       : x8x8
     ADAPTER TYPE    : NT200A01-01-SCC-2x100-E3-FF-ANL QSFP28 platform
SUPPORTCHIP LOG:

     ---------------------------------------------------------------------------
     sn                       :   0000227943
     vpd psu_hw_version       :   15
     vpd pn                   :   81100060104
     vpd pba                  :   0730132010401
     vpd productFamily        :   03
     vpd featureMask          :   0x00000A0B
     vpd invfeatureMask       :   0xFFFFF5F4
     vpd noOfMacs             :   03
     vpd macAddress           :   00.0D.E9.05.4E.5B
     vpd customId             :   0x0000
     platform                 :   NT200E3_2_PTP
     version                  :   v3.5c
     log version              :   10
     psu version              :   00 na
     pci bifurcation support  :   yes
     pci bridge count         :   0
     pci device count         :   2
     pci ep2 gpio disable     :   0
     pci ep2 nvm  disable     :   0
     uptime          [seconds]:   684
     total runtime     [hours]:   18
     warm reset count         :   1
     cold reset count         :   3
     write index              :   8
     read  index              :   0

     entry  event       unit  data  description
     ---------------------------------------------------------------------------
         0    128  [125MSEC]   456  EVENT_POWER_ON_RECORD_LAST_TOTAL_RUNTIME
         1    129  [    1MS]     0  EVENT_LOG_FORCED_ERASED
         2    128  [    1MS]     0  EVENT_POWER_ON_RECORD_LAST_TOTAL_RUNTIME
         3    138  [125MSEC]    15  EVENT_FPGA_LOAD_DONE
         4    128  [    1MS]     0  EVENT_POWER_ON_RECORD_LAST_TOTAL_RUNTIME
         5    138  [125MSEC]    15  EVENT_FPGA_LOAD_DONE
         6    128  [    1MS]     0  EVENT_POWER_ON_RECORD_LAST_TOTAL_RUNTIME
         7    138  [125MSEC]    15  EVENT_FPGA_LOAD_DONE