Drivers - Xilinx Alveo X3522 User Manual

• If the adapter is using SFP cables then each port is presented to the host as a separate PF and
the operating system treats the ports independently.
• If the adapter is using DSFP cables then there are still two PFs but each PF presents a pair of
ports. The X3 drivers still treat each port independently – that is, there is no difference to the
user between ports that share a PF and ports that do not.
Note: The rest of this document ignores the fact that some network ports share a PF (this should be
invisible to applications), and only shows what is needed to use a single port on the NIC. For applications
that need to interface to multiple ports, all the structures are duplicated as each port uses separate
resources and interfaces.

Drivers

The X3522 uses a new net driver named xilinx_efct. It also requires the auxiliary bus driver
which is used for connectivity between the net driver and application libraries, such as Onload
and TCPDirect.
The xilinx_efct and auxiliary bus drivers can both be downloaded from the product website
(see Product Website). The auxiliary bus driver is also provided by some recent Linux
distributions.
Onload continues to supply the sfc driver used by predecessors of the X3522, but it does not
supply the xilinx_efct and auxiliary bus drivers . Likewise, Onload scripts and tools continue
to interact with the sfc driver, but do not interact with the xilinx_efct and auxiliary bus
drivers.
Drivers must be built and loaded in the following order:
1. Auxiliary bus driver.
2. xilinx_efct net driver.
3. Onload and sfc driver.
and must be unloaded in the reverse order.
So, to reload the auxiliary bus, xilinx_efct and Onload drivers:
# onload_tool unload --onload-only
# modprobe -r xilinx_efct
# modprobe -r auxiliary
# modprobe auxiliary
# modprobe xilinx_efct
# onload_tool reload --onload-only
Note: If you are also using the sfc driver, omit the --onload-only flag.
UG1523 (v1.0) October 18, 2022
Alveo X3522 User Guide
Chapter 3: What's New
www.xilinx.com
Send Feedback
18