Xilinx Alveo X3522 User manual

Alveo X3522
Installaon Guide
UG1522 (v1.0) October 18, 2022
Xilinx is creating an environment where employees, customers, and
partners feel welcome and included. To that end, we’re removing non-
inclusive language from our products and related collateral. We’ve
launched an internal initiative to remove language that could exclude
people or reinforce historical biases, including terms embedded in our
software and IPs. You may still find examples of non-inclusive
language in our older products as we work to make these changes and
align with evolving industry standards. Follow this link for more
information.

Table of Contents
Chapter 1: Introduction.............................................................................................. 4
Intended Audience......................................................................................................................4
Features........................................................................................................................................4
Block Diagram..............................................................................................................................5
Server Requirements.................................................................................................................. 6
Chapter 2: Card Installation..................................................................................... 7
Safety Instructions...................................................................................................................... 7
Before You Begin.........................................................................................................................9
Install the Card.......................................................................................................................... 10
Connect the Card to the Network........................................................................................... 14
Status LEDs.................................................................................................................................16
Chapter 3: Software Installation..........................................................................18
Login........................................................................................................................................... 18
Installing the Network Software............................................................................................. 18
Chapter 4: Card Bring-Up and Validation........................................................28
Running lspci............................................................................................................................. 28
Running ethtool.........................................................................................................................28
Running ip.................................................................................................................................. 29
Running ping............................................................................................................................. 30
Chapter 5: Next Steps.................................................................................................32
Chapter 6: Troubleshooting.................................................................................... 33
Troubleshooting the Network Driver Load............................................................................ 33
Known Issues.............................................................................................................................34
Appendix A: Additional Resources and Legal Notices............................. 35
Xilinx Resources.........................................................................................................................35
Documentation Navigator and Design Hubs.........................................................................35
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 2
Send Feedback

References..................................................................................................................................35
Revision History.........................................................................................................................36
Please Read: Important Legal Notices................................................................................... 37
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 3
Send Feedback

Chapter 1
Introduction
This is the Installaon Guide for all Xilinx® Alveo™ X3522 card variants, including the following:
• X3522 low latency network adapter.
• X3522PV adaptable accelerator card.
It gives detailed procedures for engineers to setup the X3522, and to provide an environment for
tesng it.
Product Website
The most up-to-date informaon related to Alveo™ X3522 card variants, downloads and
documentaon are available on the following website:
hps://www.xilinx.com/x3
Intended Audience
The intended audience for this Installaon Guide are soware installaon, conguraon and test
engineers responsible for tesng and evaluang the X3522.
Features
The Xilinx® Alveo™ X3522 is a single slot, half length, half height form factor passively cooled
card that brings low latency networking and compute acceleraon to a single plaorm.
It uses an XCUX35 FPGA (XCUX35-3VSVA1365E). It has two DSFP28 network connecons and
a PCI Express® Gen4 ×8 / Gen3 ×8 interface connected to the XCUX35. Each DSFP28 cage
supports two ports via a shared PF, currently at 10 GbE, with 25 GbE support to follow. See
Figure 1: X3522 Block Diagram.
The shell provides the user with the PCIe link and management funcons necessary to operate
and program the card.
Chapter 1: Introduction
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 4
Send Feedback

X3522 Low Latency Network Adapter
In this variant, low-latency network interface card funconality is enabled by a soware-dened
network interface controller (SoNIC) in the shell. The SoNIC provides network acceleraon
capabilies.
You can upgrade this variant to hybrid mode so that it is programmable. The upgrade provides an
addional dynamic region. This is a recongurable paron that the user can dynamically
program at runme when running an applicaon.
X3522PV Adaptable Accelerator Card
This variant is suitable for customers using the card purely as a vehicle to have a PCIe-aached
FPGA for a Vivado-based workow. For example, it can be used for trading acceleraon or
compute ooad applicaons.
Block Diagram
A block diagram of the X3522 is shown in the following gure.
Figure 1: X3522 Block Diagram
QSPI Secondary
Flash
XCUX35-3VSVA1365E
Satellite
Controller
LPC5500
Series
EP GTY x8
QSPI
DSFP28
DSFP28
QSPI Primary
Flash
GTY x4
DDR C1
DDR4 5x16
4/8 GB
x72
Port 1
Port 2
SMBus
PCIe
Gen4 x8
UART
Sensors
Alveo Configuration Port
2xJTAG, 3xUART
PMBus, SMBus, SWDIO
X25588-052622
Chapter 1: Introduction
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 5
Send Feedback

Server Requirements
The server hosng the X3522 must meet the following requirements:
• The server must have a 64-bit x86 processor.
• The server must be able to accept a half height half length 8-lane PCIe board.
• The server must meet the Thermal Specicaons given in the Alveo X3522 Data Sheet
(DS1002).
Note: A desktop machine is unlikely to meet these specicaons.
If the server does not meet these specicaons the X3522 can overheat, causing prevenve
measures such as reducing throughput or shung down the card. See Chapter 6:
Troubleshoong.
• The server should have an operang system installed that is supported by the X3522
soware.
Refer to the Release Notes for the X3522 drivers and other soware that you are using.
• The following oponal packages are required:
○kernel-headers
○kernel-devel, or kernel-smp-devel (for Symmetric Mul-Processing systems).
Chapter 1: Introduction
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 6
Send Feedback

Chapter 2
Card Installation
This chapter tells you how to install an X3522 in its host machine.
To reduce the risk of re, electric shock, or injury, always follow basic safety precauons.
CAUTION! The X3522 can become hot under power. Before handling it you must remove power and wait
for it to cool.
ATTENTION! La carte X3522 peut devenir chaude sous tension. Vous devez couper l’alimentaon et
aendre que la carte refroidisse avant de la toucher.
VORSICHT! X3522 kann im Betrieb heiß werden. Vor allen Arbeiten am X3522 müssen Sie die
Stromversorgung trennen und warten, bis es abgekühlt ist.
CAUTION! You must always use an ESD strap or other anstac device when handling hardware.
ATTENTION! Il est fortement recommandé d'uliser un bracelet ESD ou autres disposifs anstaques.
VORSICHT! Beim Umgang mit Hardware müssen sie immer ein Erdungs Armband oder ein anderes
anstasches Gerät verwenden.
Safety Instructions
Safety Information
To ensure your personal safety and the safety of your equipment:
• Keep your work area and the computer/server clean and clear of debris.
• Before opening the computer/system cover, unplug the power cord.
Dispositif de Sécurité
Pour assurer votre sécurité personnelle et la sécurité de votre équipement:
• Maintenez votre zone de travail et l'ordinateur/serveur propre et dégagé de débris.
• Avant d'ouvrir le capot de l'ordinateur/système, débranchez le cordon d'alimentaon.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 7
Send Feedback

Sicherheitsinformation
Um ihre persönliche Sicherheit und die Sicherheit ihrer Ausrüstung zu gewährleisten:
• Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen.
• Ziehen sie vor dem Öenen der Computer / Systemabdeckung das Netzkabel ab.
Electrostatic Discharge Caution
Electrostac discharge (ESD) can damage electronic components when they are improperly
handled, and can result in total or intermient failures. Always follow ESD-prevenon procedures
when removing and replacing components.
To prevent ESD damage:
• Use an ESD wrist or ankle strap and ensure that it makes skin contact. Connect the equipment
end of the strap to an unpainted metal surface on the chassis.
• Avoid touching the card against your clothing. The wrist strap protects components from ESD
on the body only.
• Handle the card by its bracket or edges only. Avoid touching the printed circuit board or the
connectors.
• Put the card down only on an anstac surface such as the bag supplied in your kit.
• If you are returning the card to Xilinx Product Support, place it back in its anstac bag
immediately.
Attention aux Décharge Électrostatique (ESD)
L'ESD peut endommager les composants électroniques lorsqu'ils sont mal manipulés, et peut
entraîner des défaillances totales ou intermientes. Suivez toujours les procédures de prévenon
contre les ESD lors du retrait et remplacement des composants.
Pour prévenir les dommages dus aux ESD:
•Ulisez une sangle de poignet ou de cheville an-ESD et assurez-vous qu'elle est en contact
avec la peau. Branchez l'extrémité du cable de la sangle à une surface métallique non peinte
du châssis et a la masse.
• Évitez de mere en contact la carte de circuit imprimé ou les connecteurs avec vos vêtements.
La sangle de poignet protège la carte ou connecteurs contre les ESD du corps seulement.
• Manipulez la carte uniquement par son support ou par ses bords. Évitez de toucher la carte de
circuit imprimé ou les connecteurs.
• Ne posez la carte de circuit imprimé ou les connecteurs que sur une surface anstaque telle
que le sac an-staque fourni avec la carte.
• Si vous retournez la carte a Xilinx, remeez-la dans son sac anstaque immédiatement.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 8
Send Feedback

Vorsicht Elektrostatische Entladung
Elektrostasche Entladung (ESD) kann elektronische Bauteile beschädigen, wenn sie
unsachgemäß behandelt werden, und es kann zu totalen oder zeitweiligen Ausfällen kommen.
Befolgen sie beim Enernen und Austauschen von Komponenten stets die ESD-
Schutzmaßnahmen.
So verhindern sie ESD-Schäden:
• Verwenden sie einen ESD-Handgelenk-oder Knöchelriemen und stellen sie sicher, dass er
Hautkontakt hat. Verbinden sie das Ende des Riemens mit einer unlackierten Metalloberäche
am Gehäuse.
• Berühren sie die Karte nicht mit ihrer Kleidung. Der Riemen schützt Komponenten nur vor
ESD am Körper.
• Fassen sie die Karte nur an der Halterung oder an den Kanten an. Berühren sie nicht die
Leiterplae oder die Anschlüsse.
• Legen sie die Karte nur auf einer anstaschen Oberäche ab, z.B. dem anstaschen Beutel
der mit dem Kit mitgeliefert wurde.
• Wenn sie die Karte an den Xilinx Product Support zurücksenden, legen Sie sie bie sofort
wieder in den anstaschen Beutel.
Before You Begin
IMPORTANT! Alveo™ cards are delicate and sensive electronic devices; equipment is to be installed by a
qualied technician only. This equipment is intended for installaon in a Restricted Access Locaon.
IMPORTANT! Les cartes Alveo™ sont des appareils électronique sensibles et fragiles; l'équipement doit
être installé par un technicien ceré seulement. Cet équipement est desné à être installé dans un lieu
d'accès restreint.
WICHTIG! Die Karten Alveo™ sind sensible und empndliche elektronische Geräte. Das Gerät darf nur
von einem qualizierten Techniker installiert werden. Dieses Gerät ist für die Installaon an einem Ort mit
begrenztem Zugang vorgesehen.
• Verify that the minimum card space is available to install your card. Card specicaons and
dimensions can be found in Alveo X3522 Data Sheet (DS1002).
• Check for card compability with the system. Also check for proper system requirements such
as power, bus type, and physical dimensions to support the card.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 9
Send Feedback

Install the Card
You must t the X3522 to a 64-bit x86 server in an 8‑lane PCIe slot.
CAUTION! Servers contain high voltage electrical components. Before removing the server cover,
disconnect the mains power supply to avoid the risk of electrocuon. Before handling computer
components, discharge stac electricity from yourself by touching a metal surface, or wear a correctly
ed an-stac wrist band.
ATTENTION! Les serveurs conennent des composants électriques a haute tension. Avant de rerer le
capot du serveur, débranchez l'alimentaon secteur pour éviter tout risque d'électrocuon. Veuillez vous
déchargez de l'électricité staque en touchant une surface métallique ou portez un bracelet anstaque
correctement ajusté avant de manipuler les composants de l'ordinateur.
VORSICHT! Server enthalten elektrische Hochspannungskomponenten. Um die Gefahr eines
Stromschlages zu vermeiden, trennen Sie die Stromversorgung bevor sie das Gehäuse önen. Vor allen
Arbeiten an dem Server sollten sie sich zuerst elektrostasch entladen indem Sie eine geerdete
Metalloberäche kurz berühren oder ein passendes Anstak-Armband tragen.
Get Details of the Card
1. If necessary, note the serial number of the X3522 (located on the card) for your own records.
For example:
5056B1085011
2. Read the MAC address QR code using a smartphone, and note it down to help idenfy the
card later in this install. For example:
00:0a:35:0d:91:70
Note: This is a base address. There are 16 addresses available from this base.
Locate an 8‑lane PCI Express Slot
The X3522 is a half height, half length, 8‑lane PCIe form factor card.
IMPORTANT! The X3522 requires an 8
‑ lane PCI Express slot. The card should be installed in a PCIe Gen4
or PCIe Gen3 slot.
IMPORTANT! La carte X3522 nécessite un emplacement PCI Express pour 8 lignes. La carte doit être
installé dans un slot PCIe Gen4 ou PCIe Gen3.
WICHTIG! Der X3522 Karte benoegt einen PCI Express x16 Steckplatz. Die Karte sollte in einem PCIe
Gen4 oder PCIe Gen3 Steckplatz installiert sein.
1. Shut down the server.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 10
Send Feedback

2. Unplug it from its power source.
3. Remove the server cover to access the PCI Express slots in the server.
4. Locate an 8‑lane PCI Express slot (refer to the server manual if necessary).
Fit the Correct Bracket
Xilinx adapters are supplied with a full height bracket ed to the adapter. A low-prole bracket
has also been supplied for PCIe slots that require this type of bracket.
To change the bracket that is ed to the adapter:
1. From the back of the adapter, remove the screws securing the ed bracket.
2. Slide the bracket away from the adapter.
3. Taking care not the over-ghten the screws, aach the replacement bracket to the adapter.
Figure 2: Replacing the Bracket
X25603-072821
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 11
Send Feedback

Insert the Card in the PCI Express Slot
1. Insert the X3522 into the 8‑lane PCI Express slot that you idened earlier (see Locate an
8‑lane PCI Express Slot).
2. Secure the card bracket in the slot.
CAUTION! The X3522 must have sucient air ow cooling – during normal operaon the minimum
air ow required is 300 LFM (X3522) or 500 LFM (X3522PV). Server cooling fans must be fully
operave to prevent damage to the card.
ATTENTION! La carte X3522 doit avoir un ux d'air refroidissement adéquat – pour fonconner
normalement le débit d'air minimum requis est de 300 LFM (X3522) ou 500 LFM (X3522PV). Les
venlateurs de refroidissement du serveur doivent être enèrement opéraonnels pour éviter
d'endommager la carte.
VORSICHT! Der X3522 muss über eine ausreichende Lustromkühlung verfügen. Während des
normalen Betriebs ist ein Lustrom von mindestens 300 lfm (X3522) oder 500 lfm (X3522PV)
erforderlich. Alle Lüer müssen voll funkonsfähig sein um Schäden an der Karte zu verhindern.
3. Re-install the computer casing.
4. Connect the power cord and restart the computer.
Confirm the Card is Seen by the OS
Now conrm the card is seen by the OS:
1. Login as root.
2. Conrm that you can see the PCIe devices for the X3522, by entering the following Linux
command in the terminal:
# lspci -v -d 10ee:
If the card is successfully installed and found by the operang system, a message will be
displayed. The output depends on the X3 series card that you have installed, and might also
vary depending on the current state of the card:
• This is sample output for an X3522 low latency network adapter that is in its supplied
conguraon:
01:00.0 Ethernet controller: Xilinx Corporation Device 5084
Subsystem: Xilinx Corporation Device 000b
Flags: bus master, fast devsel, latency 0
Memory at 92b00000 (64-bit, prefetchable) [size=1M]
Memory at 92c01000 (64-bit, prefetchable) [size=4K]
Expansion ROM at 90100000 [disabled] [size=1M]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable+ Count=64 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Capabilities: [b0] Vital Product Data
Capabilities: [100] Advanced Error Reporting
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 12
Send Feedback

Capabilities: [1c0] #19
Capabilities: [220] Transaction Processing Hints
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
01:00.1 Ethernet controller: Xilinx Corporation Device 5084
Subsystem: Xilinx Corporation Device 000b
Flags: bus master, fast devsel, latency 0
Memory at 92a00000 (64-bit, prefetchable) [size=1M]
Memory at 92c00000 (64-bit, prefetchable) [size=4K]
Expansion ROM at 90200000 [disabled] [size=1M]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable+ Count=64 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Capabilities: [b0] Vital Product Data
Capabilities: [100] Advanced Error Reporting
Capabilities: [220] Transaction Processing Hints
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
• This is sample output for an X3522 low latency network adapter that has been upgraded
to hybrid mode so that it is programmable:
01:00.0 Ethernet controller: Xilinx Corporation Device 5084
Subsystem: Xilinx Corporation Device 000b
Flags: bus master, fast devsel, latency 0
Memory at 92d00000 (64-bit, prefetchable) [size=1M]
Memory at 92f00000 (64-bit, prefetchable) [size=4K]
Expansion ROM at <ignored> [disabled]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable- Count=64 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Capabilities: [b0] Vital Product Data
Capabilities: [100] Advanced Error Reporting
Capabilities: [1c0] #19
Capabilities: [220] Transaction Processing Hints
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
01:00.1 Ethernet controller: Xilinx Corporation Device 5084
Subsystem: Xilinx Corporation Device 000b
Flags: fast devsel
Memory at 92e00000 (64-bit, prefetchable) [size=1M]
Memory at 92f01000 (64-bit, prefetchable) [size=4K]
Expansion ROM at <ignored> [disabled]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable- Count=64 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Capabilities: [b0] Vital Product Data
Capabilities: [100] Advanced Error Reporting
Capabilities: [220] Transaction Processing Hints
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
01:00.2 Processing accelerators: Xilinx Corporation Device 5086
Subsystem: Xilinx Corporation Device 000b
Flags: bus master, fast devsel, latency 0
Memory at 2ffc000000 (64-bit, prefetchable) [size=32M]
Memory at 2ffe000000 (64-bit, prefetchable) [size=4K]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable- Count=32 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 13
Send Feedback

Capabilities: [b0] Vital Product Data
Capabilities: [100] Advanced Error Reporting
Capabilities: [220] Transaction Processing Hints
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
• This is sample output for an X3522PV adaptable accelerator card:
01:00.0 Processing accelerators: Xilinx Corporation Device 5074
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, NUMA node 0
Memory at 2bf82000000 (64-bit, prefetchable) [size=32M]
Memory at 2bf84040000 (64-bit, prefetchable) [size=256K]
Capabilities: [40] Power Management version 3
Capabilities: [60] MSI-X: Enable+ Count=32 Masked-
Capabilities: [70] Express Endpoint, MSI 00
Capabilities: [100] Advanced Error Reporting
Capabilities: [1c0] #19
Capabilities: [e00] Access Control Services
Capabilities: [e10] #15
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?>
Connect the Card to the Network
If you are installing an X3522 low latency network adapter, you can now connect it to the
network.
The X3522 has two DSFP28 cages, each of which supports two ports:
• Cage 1 supports ports 0 and 2.
• Cage 2 supports ports 1 and 3.
• If you connect a DSFP28 cable, or a DSFP28 to SFP splier, both ports for the cage are
exposed.
• If you connect an SFP+ or SFP28 cable, only the rst port for the cage is exposed.
• Ports are currently 10 GbE only, with 25 GbE support to follow.
Attaching a Direct Attach Copper (DAC) Cable
To aach a DAC cable:
1. Turn the cable so that the connector retenon tab and gold ngers are on the same side as
the network adapter retenon clip.
2. Push the cable connector straight in to the adapter cage unl it clicks into place.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 14
Send Feedback

Figure 3: Attaching a DAC Cable
X25595-072621
Removing a Direct Attach Copper (DAC) Cable
To remove a DAC cable:
1. Pull straight back on the release ring to release the cable retenon tab. Alternavely, you can
li the retenon clip on the adapter to free the cable if necessary.
2. Slide the cable free from the adapter cage.
Attaching a Fiber Optic Cable
WARNING! Do not look directly into the ber transceiver or cables as the laser beams can damage your
eyesight.
ATTENTION! Ne regardez pas directement dans l'émeeur-récepteur à bre opque ou les câbles car les
faisceaux laser peuvent endommager votre vue.
WARNUNG! Schauen Sie nicht direkt in den Faser-Transceiver oder die Kabel, da die Laserstrahlen Ihr
Sehvermögen schädigen können.
To aach a ber opc cable:
1. Remove and save the ber opc connector cover.
2. Insert a ber opc cable into the ports on the network adapter bracket as shown. Most
connectors and ports are keyed for proper orientaon. If the cable you are using is not keyed,
check to be sure the connector is oriented properly (transmit port connected to receive port
on the link partner, and vice versa).
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 15
Send Feedback

Figure 4: Attaching a Fiber Optic Cable
X25596-072621
Removing a Fiber Optic Cable
WARNING! Do not look directly into the ber transceiver or cables as the laser beams can damage your
eyesight.
ATTENTION! Ne regardez pas directement dans l'émeeur-récepteur à bre opque ou les câbles car les
faisceaux laser peuvent endommager votre vue.
WARNUNG! Schauen Sie nicht direkt in den Faser-Transceiver oder die Kabel, da die Laserstrahlen Ihr
Sehvermögen schädigen können.
To remove a ber opc cable:
1. Remove the cable from the adapter bracket and replace the ber opc connector cover.
2. Pull the plasc or wire tab to release the adapter bracket.
3. Hold the main body of the adapter bracket and remove it from the adapter.
Status LEDs
Each DSFP28 cage has two adjacent LEDs, showing the status of its two supported ports:
• The LEDs for cage 1 show the status of ports 0 and 2.
• The LEDs for cage 2 show the status of ports 1 and 3.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 16
Send Feedback

Figure 5: X3522 LEDs
Link status Activity Link status Activity
Cage 2 (ports 1 and 3)Cage 1 (ports 0 and 2)
X26835-062822
The link status LED for a cage is:
• Green when both ports for the cage have a physical link.
• Amber when only one port for the cage has a physical link.
Note: This includes when an SFP28 or SFP+ cable is connected, and so only a single port is exposed.
•O in the absence of any physical link.
• Blinking red if a command such as ethtool --identify has been issued to idenfy the
network port.
The acvity LED for a cage is:
• Blinking green when there is link acvity on all exposed network ports for the cage.
•O when there is no acvity on any exposed network port for the cage.
Note: Some other LEDs inside the case are visible through the airow holes. These internal LEDs are for
diagnosc use only, and you should ignore them.
Chapter 2: Card Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 17
Send Feedback

Chapter 3
Software Installation
This chapter tells you how to install the soware required by an X3522.
Login
IMPORTANT! Root access is required for all soware and rmware installaons.
IMPORTANT! L'accès Root est requis pour toutes les installaons logicielles et rmware.
WICHTIG! Root-Zugri ist für alle Soware- und Firmware-Installaonen erforderlich.
Ensure you are logged in to the X3522 host as root.
Installing the Network Software
This secon tells you how to install the drivers required by an X3522 low latency network
adapter. Two drivers are required:
• Auxiliary bus driver.
• Network driver.
This secon also tells you how to congure network sengs for the host server and for a link
partner to which it can be connected.
Choose Which Packages To Use
The drivers are provided in two package formats. Choose the appropriate format to use:
Chapter 3: Software Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 18
Send Feedback

• Source RPM packages, recommended for Red Hat.
To install a driver from a source RPM package, the source RPM must be built into a binary
RPM, specic to the OS distribuon and kernel that is in use. The binary RPM must then be
installed and loaded.
To use this format, see Install from RPM Packages.
• DKMS Debian packages, recommended for Ubuntu.
Dynamic Kernel Module Support is a framework where device driver source can reside
outside the kernel source tree. This supports an easy method to rebuild modules when kernels
are upgraded.
To use this format, see Install from DKMS Debian Packages.
IMPORTANT! The X3522 should be physically installed in the host computer before installing the
network driver. The user must have root permissions to install the network drivers.
IMPORTANT! La carte X3522 doit être physiquement installé dans l'ordinateur hôte avant l’installaon
du réseau pilote. L'ulisateur doit disposer des autorisaons root pour installer le reseau pilote.
WICHTIG! Installieren Sie den X3522 Karte im Host-Rechner bevor Sie mit der Installaon des
Netzwerktreibers beginnen. Zur Installaon des Treibers muss der Benutzer über Root-Privilegien verfügen.
Install from RPM Packages
IMPORTANT! If you have chosen to install the drivers from DKMS packages, omit this secon.
IMPORTANT! Si vous avez choisi d'installer les pilotes à parr des packages DKMS, omeez cee secon.
WICHTIG! Wenn Sie die Treiber aus DKMS-Paketen installiert haben, überspringen Sie diesen Abschni.
Requirements
Kernel headers for the running kernel must be installed at /lib/modules/<kernel-
version>/build:
1. List the kernel headers, to conrm they are installed:
# ls /lib/modules/$(uname -r)/build
2. If no les are listed install the kernel-devel or kernel-smp-devel package, as appropriate. For
example:
# yum install kernel-devel-$(uname -r)
Chapter 3: Software Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 19
Send Feedback

Determine if the Auxiliary Bus Driver is Present
X3522 cards use the auxiliary bus driver. This is provided by some recent Linux distribuons. To
determine its presence, type:
# ls -d /sys/bus/auxiliary
• If there is output lisng the directory, the auxiliary bus driver is already present:
/sys/bus/auxiliary
You do not need to install the auxiliary bus driver. Go to Download the Network Driver Source
RPM.
• If there is an error message, the auxiliary bus driver is not present. For example:
ls: cannot access /sys/bus/auxiliary: No such file or directory
You must install the auxiliary bus driver yourself. Read the following secons.
Download the Auxiliary Bus Driver Source RPM
Download the auxiliary bus driver source RPM:
1. Start a web browser.
2. Open the product website (see Product Website).
3. Download the following package:
• XN-201056-LS Auxiliary Bus Driver Source [RPM package].
Build the Auxiliary Bus Driver Binary RPM
To build the auxiliary bus driver binary RPM for the currently running kernel version:
1. Locate the Auxiliary Bus Driver Source [RPM package] that you downloaded. See Download the
Auxiliary Bus Driver Source RPM.
2. Build the binary RPM from the source RPM le:
# rpmbuild --rebuild <source_rpm_path>
where <source_rpm_path> is the full path to the source RPM.
3. The build procedure generates a lot of console output. Towards the end of the build a
"Wrote:" line idenes the locaon of the built binary RPM. For example:
Wrote: <path>/kernel-module-auxiliary-<os_version>-<module_version>.rpm
Chapter 3: Software Installation
UG1522 (v1.0) October 18, 2022 www.xilinx.com
Alveo X3522 Installation Guide 20
Send Feedback