Overview

The NVM Update Reference Application (NVM URA) is a reference application to help you create a customized NVM update tool.

• When you run the NVM URA tool, it generates the nvm_​ura.log log file. This file is overwritten each time you run the tool.

• You can only update one adapter at the time.

• If you run NVM URA without specifying any options, it will display the tool version and the list of supported adapters.

System Requirements

• Your system must be running 64-bit Linux* or 64-bit FreeBSD*.

• The base networking driver must be installed on the system.

• You must run NVM URA with root privileges.

Building and Installation

cd <location-of-nvm-ura>
make

cd <location-of-nvm-ura>
gmake

Options

-h

Displays command line help.

-a

Display the adapter PHY version.

-b

Saves a backup copy of the NVM memory content of the selected network adapter to a file.

-c <file>

Programs the NVM from the file.

-d

Saves a backup copy of the ID EEPROM content of the selected network adapter to the file <mac_​address>_​eeid.bin.

-e

Programs the PHY NVM. If this option is used along with the -c option, PHY NVM will be programmed after the NVM update procedure.

-f

Triggers a firmware reset after the NVM update procedure. Must be used with the -c option.

Important:

This will cause the device to stop responding until the firmware reset completes.

-g

Program the ID EEPROM of the selected network adapter from a file.

-i

Displays adapter identification and versioning information.

-m

Forces the use of the devlink interface.

-p <preserve>

Selects the preservation mode. Must be used with the -c option. Valid values for <preserve> are: full, selective, factory, none. If this option is not used, -c programs the NVM with full preservation.

-r <file>

Verifies the NVM against a file.

-s <location>

Selects the adapter by PCI location in the format, [bb:dd], where:

b:

bus

d:

device

Both numbers must be in hexadecimal.