Nvidia MSTFLINT User Manual

60
1.
2.
5th Generation (Group II) Devices
On 5th Generation (Group II) devices, the “sg” command can operate on both the image file andthe
image on the flash. When running the “sg” command on an image on the flash, -uid flag mustbe
specified. For ConnectX-4, -guid/-mac flags can be specified. By default, 8 GUIDs will beassigned for
each port starting from base, base+1 up until base+7 for port 1 and base+8 up untilbase+15 for port 2.
To change the step size and the number of GUIDs per port, specify guids_num=<num>step_size=<size>
to the sg command.
Change GUIDs for device:
# mstflint -d 41:00.0 q
Image type: FS3
FW Version: 10.10.3000
FW Release Date: 29.4.2014
Description: UID GuidsNumber Step
Base GUID1: 0002c903002ef500 8 1
Base GUID2: 0002c903002ef508 8 1
Base MAC1: 0002c92ef500 8 1
Base MAC2: 0002c92ef508 8 1
Image VSD:
Device VSD: VSD
PSID: MT_1240110019
# mstflint -d 41:00.0 -uid 0002c123456abcd -ocr sg
-W- Firmware flash cache access is enabled. Running in this mode may cause the firmware to hang.
Updating GUID section - OK
Updating ITOC section - OK
Restoring signature - OK
# mstflint -d 41:00.0 q
Image type: FS3
FW Version: 10.10.3000
FW Release Date: 29.4.2014
Description: UID GuidsNumber Step
Base GUID1: 00002c123456abcd 8 1
Orig Base GUID1: 0002c903002ef500 8 1
Base GUID2: 00002c123456abd5 8 1
Orig Base GUID2: 0002c903002ef508 8 1
Base MAC1: 00002c56abcd 8 1
Orig Base MAC1: 0002c92ef500 8 1
Base MAC2: 00002c56abd5 8 1
Orig Base MAC2: 0002c92ef508 8 1
Image VSD:
Device VSD: VSD
PSID: MT_1240110019
Change GUIDS for device (specifying guids_num and step_size):
# mstflint -d 41:00.0 q
Image type: FS3
FW Version: 10.10.3000
FW Release Date: 29.4.2014
Description: UID GuidsNumber Step
Base GUID1: 0002c903002ef500 8 1
Base GUID2: 0002c903002ef508 8 1
Base MAC1: 0002c92ef500 8 1
Base MAC2: 0002c92ef508 8 1
Image VSD:
Device VSD: VSD
PSID: MT_1240110019
# mstflint -d 41:00.0 -uid 0000000000000001 -ocr sg guids_num=2 step_size=1
-W- Firmware flash cache access is enabled. Running in this mode may cause the firmware to hang.
Orig Base GUID/MAC refers to the GUIDs/MACs located in the MFG(manufacture guids)
section of the flash/image.


Nvidia MSTFLINT Specifications

General

Brand	Nvidia
Model	MSTFLINT
Category	Tools
Language	English

Summary

Release Notes

Package Tools

Lists available tools in the package with descriptions.

mstflint Supported Operating Systems and Platforms

Details supported operating systems and platforms for mstflint.

Supported Flash Types

Lists supported flash types for mstflint.

Supported Mellanox ICs

Lists supported Mellanox ICs by IC Group and IC Device.

Supported Switch Systems Software

Lists supported Mellanox Switch Systems Software and their versions.

mstflint Bug Fixes in this Version

Lists bugs fixed in the current version of mstflint.

mstflint Known Issues

Lists known issues and limitations for the current mstflint release.

Introduction

Supported Operating Systems

Refers to release notes for supported platforms and kernels.

Access to Hardware Devices

Lists supported Mellanox devices, tools, and access methods.

Compilation and Installation

Provides instructions for compiling and installing mstflint.

Firmware Generation, Configuration, and Update Tools

mstfwmanager – Firmware Update and Query Tool

Utility for updating and querying Mellanox device firmware.

mstarchive – Binary Files Compression Tool

Tool to create MFA2 files containing binary firmware for adapter cards.

mstconfig – Changing Device Configuration Tool

Tool to change device configurations without reburning firmware.

mstflint – Firmware Burning Tool

Utility to burn firmware images to adapter or switch device flash.

mstfwreset – Loading Firmware on 5th Generation Devices Tool

Tool to load updated firmware on NICs without rebooting.

mstcongestion – Tool for Setting Congestion Mode and Action

Tool to configure device behavior for excessive ingress traffic.

mstprivhost - NIC Configuration by the Host Restriction Tool

Restricts hosts from configuring the NIC, granting privilege to the Arm side.

Debug Utilities

mstfwtrace Utility

Extracts and prints trace messages generated by firmware on 5th generation devices.

mstregdump Utility

Dumps device internal configuration registers for troubleshooting.

mstreg Utility

Obtains information about access registers and allows data access.

mstlink Utility

Checks and debugs link status and issues related to links and cables.

mstresourcedump Utility

Extracts and prints data segments generated by firmware for debug.

Troubleshooting

General Related Issues

Covers general issues related to adapter identification and boot problems.

mstconfig Related Issues

Addresses issues with mstconfig, especially concerning SRIOV configuration.

Installation Related Issues

Discusses problems encountered during tool package installation.

Firmware Burning Related Issues

Details issues encountered during firmware update and burning processes.

Secure Firmware Related Issues

Outlines problems and limitations when using secure firmware features.

Appendixes

mstflint - Updating Firmware Using ethtool/devlink and .mfa2 File

Guide to updating firmware using ethtool/devlink with .mfa2 files.

mstflint User Manual Revision History

Provides a history of changes made to the mstflint user manual.

mstflint Release Notes Change Log History

Lists changes and bug fixes across different mstflint versions.