Xilinx Alveo X3 Series Firmware Configuration Package

Version: 1.16.1.8-15

Overview

This is the v1.16.1.8 firmware configuration package for Xilinx Alveo X3
series adapters. It contains a set of configurations that can be applied
to an adapter to modify the persistent PCI configuration of the device.

Supported hardware platforms

This release of the firmware configuration package supports the
following Xilinx Alveo X3 series adapters:

-   Xilinx Alveo X3522 NIC

Contents

X3522 configurations

-   x3522-enable_uefi.update
-   x3522-disable_uefi.update

These configurations support the following use cases:

-   UEFI Expansion ROM enabled (default)
-   UEFI Expansion ROM disabled

Installation

This package installs the firmware non-volatile configuration files onto
the target system, where they can be applied to its installed X3 series
adapters using a firmware update tool. First install the binary package
using your preferred package manager, for example using rpm:

    rpm --install ./firmware-x3-config-1.16.1.8-15.noarch.rpm

devlink is the preferred firmware update tool, to apply a configuration
using devlink:

1.  List the Xilinx PCIe devices for the X3 adapter:

        lspci -D -d 10ee:

2.  Ensure the net driver is loaded:

        modprobe xlnx_efct

3.  Note the PCIe address of the first X3 LLNIC interface, which can be
    identified as an Ethernet controller of type 5084. Apply the .update
    file to the device:

        devlink dev flash pci/<domain>:<bus>:<device>.<function> file xilinx/x3/<configuration>

    Note: The configuration filename is a path relative to the
    /lib/firmware/ directory.

4.  Wait for the update to complete.

5.  Perform a cold reboot of the machine after updating the adapter's
    non-volatile configuration.

On OS distributions which do not include devlink or support flash update
via devlink, ethtool can be used to apply the configuration:

1.  Ensure the net driver is loaded:

        modprobe xlnx_efct

2.  Apply the .update file to the device:

        ethtool --flash <interface> xilinx/x3/<configuration>

    Note: The configuration filename is a path relative to the
    /lib/firmware/ directory.

3.  Wait for the update to complete; ethtool blocks and does not report
    progress.

4.  Perform a cold reboot of the machine after updating the adapter's
    non-volatile configuration.

Additional information

For addition information, please refer to the "Deployment
Configurations" chapter in the "Alveo X3522 User Guide (UG1523)"
(XN-201015-CD).

Support

Please contact your local Xilinx support representative or email
support-nic@xilinx.com.

Change logs

Alveo X3 series firmware configurations

v1.16.1.8 --- Feature Release

-   Initial release to support Alveo X3522 NIC card.

Copyright

Copyright 2022 Xilinx, Inc. All rights reserved.
Use is subject to license terms.