Multi-Image SmartNICs

Handling FPGA Images

product_line_custom
Napatech SmartNIC
category
User Guide

Two different images

A large number of Napatech SmartNICs each contains two different images.

Default image

By default the SmartNIC runs on the image in bank 0.

This is an example of an output from a --query command on a SmartNIC in default mode.
imgctrl --adapter 0 --query
imgctrl v3.10.1.3-1cb34 (Nov 27 2019 07:45:22) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 0:
     PCI SLOT        : 0000:84:00.0
     PCI DEVICE ID   : 01C5
     PCI LANES       : x16
     ADAPTER TYPE    : NT200A02-01-SCC-2x40/8×10-E3-FF-ANL 2x40Gb QSFP+ platform
RUNNING FPGA:
     FPGA IDENT      : 200-9535-21-23-0000
     DESCRIPTION     : 2x40Gb, capture
FPGA BANK0:
     PRODUCT CODE    : 9535
     VERSION         : 21.23
     DOWNLOADED BY   : kje
FPGA BANK1:
     PRODUCT CODE    : 9534
     VERSION         : 21.24
     DOWNLOADED BY   : kje
SUPPORTCHIP INFO:
     NT200A02        : v3.5q
FPGA IMAGE STATE:
     IMAGE STATE     : NEUTRAL (code 0)
     PRIMARY BANK    : 0
     RUNNING BANK    : 0

Switching to the image in bank 1

The SmartNIC can be switched from running on the image in bank 0 to running on the image in bank 1 as shown in this example:
$ imgctrl --adapter 0 --switch
$ imgctrl --adapter 0 --switch --confirm

The --switch command forces the SmartNIC to run on the image in bank 1. The --switch --confirm command changes the primary image to the running image, that is the image in bank 1.

This is an example of an output from a --query command after the --switch command above.
imgctrl --adapter 0 --query
imgctrl v3.10.1.3-1cb34 (Nov 27 2019 07:45:22) (Logfile: /tmp/imgctrl.log)
Scanning for Napatech adapters..
Adapter 0:
     PCI SLOT        : 0000:84:00.0
     PCI DEVICE ID   : 01C5
     PCI LANES       : x16
     ADAPTER TYPE    : NT200A02-01-SCC-8×10/2x40-E3-FF-ANL 2x40Gb QSFP+ platform
RUNNING FPGA:
     FPGA IDENT      : 200-9534-21-24-0000
     DESCRIPTION     : 8x10Gb, capture
FPGA BANK0:
     PRODUCT CODE    : 9535
     VERSION         : 21.23
     DOWNLOADED BY   : kje
FPGA BANK1:
     PRODUCT CODE    : 9534
     VERSION         : 21.24
     DOWNLOADED BY   : kje
SUPPORTCHIP INFO:
     NT200A02        : v3.5q
FPGA IMAGE STATE:
     IMAGE STATE     : NEUTRAL (code 0)
     PRIMARY BANK    : 1
     RUNNING BANK    : 1

Style Conventions

Bold typeface is used for names of, for instance, user interface elements and software components.

Italic typeface is used for replaceable text.

Monospaced typeface is used for code, commands and file names.

Abbreviations

a

Adapter

ANL

ANaLysis

b

Brief

BNF

Backus-Naur Form

BSD

Berkeley Software Distribution

CPLD

Complex Programmable Logic Device

Ctrl

ConTRoL

DN

Document Number

FF

Full-Featured

FM

Flow Management

Fpga, FPGA

Field-Programmable Gate Array

func

FUNCtion

ID

IDentifier

imgctrl

IMaGe ConTRoL

nt, NT

NapaTech

p

Program

PCI

Peripheral Component Interconnect

PCIe

Peripheral Component Interconnect Express

PCI-X

Peripheral Component Interconnect eXtended

q

Query

Rev.

REVision

s

Switch

SCC

Self-Contained Cooling

v

Verbose

v, V

Version