Flashing the Firmware - UG1739

AMD Solarflare X4 Series Ethernet Adapter User Guide (UG1739)

Document ID
UG1739
Release Date
2025-10-24
Revision
1.0 English

To flash the firmware update files, use the standard Linux devlink command:

  • The sfc net driver must be loaded.
  • You must be logged in as root.
  • Pathnames you give are relative to the /usr/lib/firmware directory.

To flash the firmware update files with devlink:

  1. List the AMD Solarflare PCIe devices:
    # lspci -D -d 1924:
    0000:01:00.0 Ethernet controller: AMD Solarflare Device 0c03
    0000:01:00.1 Ethernet controller: AMD Solarflare Device 0c03
  2. Note the PCIe address of the first interface on the X4 series adapter that you want to update.

    In the above example, the address of the first interface is 0000:01:00.0.

    Note: The PCIe address includes the domain (0000) before the bus, device, and function (01:00.0).
  3. Flash the update file for the firmware bundle to the PCIe address that you noted in step 2. Ensure you are using the correct file for your adapter:
    • For an X4522:
      # devlink dev flash pci/0000:01:00.0 file amdsolarflare/x4522_bundle_<version>.bin
    • For an X4542:
      # devlink dev flash pci/0000:01:00.0 file amdsolarflare/x4542_bundle_<version>.bin

    The devlink command hands the filename to the driver, and the driver then calls the current firmware to perform the update.

  4. Wait for the current firmware to finish the update, viewing the progress report from devlink:
    # devlink dev flash pci/0000:01:00.0 file amdsolarflare/x4542_bundle_<version>.bin
    Checking update
    Starting update
    Erasing 100%
    Writing 100%
    Finishing update
    Update complete
    Note: Older versions of devlink might not output a progress report.
    Note: If you press Ctrl-C it halts devlink and its progress reports, but the current firmware continues to apply the update.
    Note: If the update fails, refer to the kernel message log for details. The error messages from devlink dev flash are generic and can be misleading.
  5. Flash the update file for the filesystem bootloader to the PCIe address that you noted in step 2:
    # devlink dev flash pci/0000:01:00.0 file amdsolarflare/x4_fsbl_<version>.bin
  6. Wait for the current firmware to finish the update, viewing the progress report from devlink:
    # devlink dev flash pci/0000:01:00.0 file amdsolarflare/x4_fsbl_<version>.bin
    Checking update
    Starting update
    Erasing 100%
    Writing 100%
    Finishing update
    Update complete
  7. Do a cold reboot of the server using one of the following methods:
    • Use a tool such as iDRAC/BMC to issue a cold reboot or power cycle command.
    • Physically disconnect the server from all power sources for at least 10 seconds.

Now confirm that the update succeeded by checking that the firmware versions of the X4 series Ethernet adapter are as expected.