NVIDIA Firmware Tools (MFT) Documentation v4.25.1
NVIDIA ConnectX-5 Adapter Cards Firmware Release Notes v16.35.3502 LTS

Spectrum or Switch-IB 2 Switch Systems

Upon first time flash burning, the GUIDs and VPD of the device are required to be set on the flash. The sections below demonstrate two methods of burning a new device in order to set these initial settings. Subsequent firmware updates will not change these settings.

Warning

flint for OEM is required for burning Spectrum/Switch-IB 2 for the first time.

For information regarding GUIDs, MACs and VPD, please refer to Accessing Remote InfiniBand Device by Direct Route MADs.

Method 1: Generating Firmware with Specific GUIDs and MACs and Burning it on Device

In order to burn a new Spectrum/Switch-IB 2 device, follow the steps below:

  1. Generate the initial image with the correct GUIDs and VPD for the specific device using the mlxburn tool. The generated image occupies full flash size.

    Copy
    Copied!
                

    # mlxburn -fw FW/fw-Spectrum.mlx -c FW/MCB194A-FCA_A1.ini -wrimage fw-Spectrum-MCB194A- FCA_A1.bin -base_guid 0x0002c903002ef500 -base_mac 0x02c90ef500 -vpd_r_file ./vpd_r_data.bin

  2. Disable Write protection.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -override_cache_replacement hw set Flash0.WritePro- tected=Disabled

  3. Burn the entire flash.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -i ./fw-Spectrum-MCB194A-FCA_A1.bin -override_cache_re- placement -ignore_dev_data -nofs -allow_psid_change -y b

  4. Set Write protection.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -override_cache_replacement hw set Flash0.WriteProtected=Top,8-SubSectors

  5. Enable flash quad SPI IO operations.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -override_cache_replacement hw set QuadEn=1

Method 2: Generating a Firmware Image with Blank GUIDs, Burning and Setting GUIDs on the Device

In order to burn a new Spectrum/Switch-IB 2 device, follow the steps below:

  1. Generate the initial image VPD for the specific device using the mlxburn tool. The generated image occupies full flash size.

    Copy
    Copied!
                

    # mlxburn -fw FW/fw-Spectrum.mlx -c FW/MCB194A-FCA_A1.ini -wrimage fw-Spectrum-MCB194A- FCA_A1.bin -vpd_r_file ./vpd_r_data.bin

  2. Disable Write protection.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -override_cache_replacement hw set Flash0.WritePro- tected=Disabled

  3. Burn the entire flash using the flint tool.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -i ./fw-Spectrum-MCB194A-FCA_A1.bin -ocr -ignore_dev_data -nofs -allow_psid_change -y b

  4. Set device manufacture GUIDs and MACs.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -ocr -guid 0xe41d2d0300570fc0 -mac 0x0000e41d2d570fc0 smg

  5. Set device GUIDs and MACs.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -ocr -guid 0xe41d2d0300570fc0 -mac 0x0000e41d2d570fc0 sg

  6. Set Write protection on the last sector.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -ocr hw set Flash0.WriteProtected=Top,8-SubSectors

  7. Enable flash quad SPI IO operations.

    Copy
    Copied!
                

    # flint -d /dev/mst/mt585_pciconf0 -ocr hw set QuadEn=1

    1. To view flash settings:

      Copy
      Copied!
                  

      # flint -d /dev/mst/mt53000_pciconf0 -ocr hw query

    2. To view assigned GUIDs:

      Copy
      Copied!
                  

      # flint -d /dev/mst/mt53000_pciconf0 -ocr q

    3. To change a GUID after the initial burn:

      Copy
      Copied!
                  

      # flint -d /dev/mst/mt53000_pciconf0 -ocr -guid 0xe41d2d0300570fc0 sg

    4. To change a MAC after the initial burn:

      Copy
      Copied!
                  

      # flint -d /dev/mst/mt53000_pciconf0 -ocr -mac 0x0000e41d2d570fc0 sg

    5. To change a GUID and derive MAC from it after the initial burn, run:

      Copy
      Copied!
                  

      # flint -d /dev/mst/mt53000_pciconf0 -ocr -uid 0xe41d2d0300570fc0 sg

© Copyright 2023, NVIDIA. Last updated on Oct 23, 2023.