Tip

This is the documentation for the 24.06 version. Looking for the documentation of the latest version? Have a look here.

Mellanox ConnectX-5 Firmware RequirementsΒΆ

Mellanox ConnectX-5 network interface cards (mlx5) in the MT27800 family are currently shipping with firmware revision 16.26.1040 which is not compatible with TNSR.

The incompatible firmware can be identified by errors in the log (e.g. sudo vppctl show errors), such as:

net_mlx5: probe of PCI device [PCI ID] aborted after encountering an error: Operation not supported

Or:

Interface WAN error -12: Unknown error -12
net_mlx5: Failed to query QP using DevX
net_mlx5: Fail to query port 0 Tx queue 0 QP TIS transport domain
net_mlx5: port 0 Tx queue allocation failed: Cannot allocate memory
Device with port_id=0 already stopped

Firmware version 16.24.1000 is compatible with TNSR, and can be manually downgraded using the following procedure.

First, identify the first PCI ID of the card in question. This can be found by looking in the boot logs, the output of a utility such as lspci, or similar methods. The ID will take the form of xx:yy.z, for example 65:00.0. The ID will be used in the following set of commands.

Next, download and decompress the appropriate firmware:

$ curl -LO http://www.mellanox.com/downloads/firmware/fw-ConnectX5-rel-16_24_1000-MCX516A-CCA_Ax-UEFI-14.17.11-FlexBoot-3.5.603.bin.zip
$ unzip fw-ConnectX5-rel-16_24_1000-MCX516A-CCA_Ax-UEFI-14.17.11-FlexBoot-3.5.603.bin.zip

Now install the Mellanox firmware tool and perform the firmware downgrade:

$ sudo apt install mstflint
$ sudo mstconfig q > mst.log
$ sudo mstfwmanager -d <PCI ID> -u -f -i fw-ConnectX5-rel-16_24_1000-MCX516A-CCA_Ax-UEFI-14.17.11-FlexBoot-3.5.603.bin

Replace <PCI ID> in the last command with the first PCI ID of the card.

With the appropriate firmware loaded on the card, it will no longer produce errors and it will be usable by TNSR.

Warning

Reboot after performing the firmware downgrade to ensure the card is fully reinitialized with the appropriate firmware.