Xilinx Alveo U200 User manual

Geng Started with Alveo
Data Center Accelerator
Cards
User Guide
UG1301 (v2.2) August 19, 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
Chapter 2: Accelerator Card Overview............................................................... 5
Card Features...............................................................................................................................5
Minimum System Requirements...............................................................................................6
Qualified Servers......................................................................................................................... 6
Card Interfaces and Details........................................................................................................6
Passive and Active Cooling Cards..............................................................................................8
Chapter 3: Card Installation Procedures......................................................... 10
Safety Instructions.................................................................................................................... 10
Before You Begin.......................................................................................................................12
Installing the Card.....................................................................................................................12
Chapter 4: Installing the Deployment Software......................................... 18
XRT and Deployment Platform Installation Procedures on RedHat and CentOS............. 19
XRT and Deployment Package Installation Procedures on Ubuntu................................... 23
Chapter 5: Card Bring-Up and Validation........................................................27
Environment Setup................................................................................................................... 27
Running lspci............................................................................................................................. 27
Confirm Firmware Installation for DFX-1RP Platforms.........................................................28
Confirm Firmware Installation for DFX-2RP Platforms.........................................................29
Card Validation.......................................................................................................................... 31
Chapter 6: Next Steps.................................................................................................35
Chapter 7: Troubleshooting.................................................................................... 36
Appendix A: Programming the Shell Partition for DFX-2RP
Platforms...................................................................................................................... 37
Appendix B: Regulatory and Compliance Information........................... 39
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 2
Send Feedback

CE Directives.............................................................................................................................. 39
CE Standards..............................................................................................................................39
Compliance Markings............................................................................................................... 40
Appendix C: Additional Resources and Legal Notices............................. 41
Xilinx Resources.........................................................................................................................41
Documentation Navigator and Design Hubs.........................................................................41
References..................................................................................................................................42
Revision History.........................................................................................................................42
Please Read: Important Legal Notices................................................................................... 46
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 3
Send Feedback

Chapter 1
Introduction
This document provides hardware and soware installaon procedures for Xilinx® Alveo™ data
center accelerator cards U200/U250/U280 and applies to DFX-1RP and DFX-2RP plaorms and
XRT 2021.1 and greater. For DFX-1RP and DFX-2RP plaorm features and types for your Alveo
card, see Alveo Data Center Accelerator Card Plaorms User Guide (UG1120). For installaon
procedures using previous XRT versions, see v1.9 of Geng Started with Alveo Data Center
Accelerator Cards (UG1301).
The Alveo U200/U250/U280 data center accelerator cards are PCIe® Gen3 x16 compliant
featuring the Xilinx Virtex® UltraScale+™ technology. These cards accelerate compute-intensive
applicaons such as machine learning, data analycs, video processing, and more and are
available in passive and acve cooling conguraons.
Dierent system conguraons are available for running, developing, and debugging applicaons
on your Alveo accelerator cards:
•Running Applicaons: To congure a system to run accelerated applicaons, install an Alveo
card into a system as described in Chapter 3: Card Installaon Procedures along with the
required deployment soware to support running applicaons as described in Chapter 4:
Installing the Deployment Soware.
•Developing Applicaons: To develop FPGA accelerated applicaons, it is necessary to install
both the deployment soware and the development soware. Development soware
installaon, described in Chapter 6: Next Steps, consists of installing both a development
target plaorm and the Vis™ environment. This conguraon does not have an Alveo card
installed and is used for development along with debugging in emulaon modes.
•Running, Developing, and Debugging Applicaons: By installing the Alveo card along with
both the deployment and development soware on a single machine, you can congure a
system for developing and running accelerated applicaons. With the card installed,
developers can debug applicaons in both emulaon modes and on the hardware.
Chapter 1: Introduction
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 4
Send Feedback

Chapter 2
Accelerator Card Overview
Card Features
Features of the producon Alveo™ U200/U250/U280 data center accelerator cards are listed in
the following table.
Table 1: Alveo U200/U250/U280 Features
Card Component U200 U250 U280
FPGA UltraScale+™
XCU200-2FSGD2104E
UltraScale+
XCU250-2LFIGD2104E
UltraScale+
XCU280-L2FSVH2892E
DDR4 64 gigabyte (GB)
4x DDR4 16 GB
32 gigabyte (GB)
2x DDR4 16 GB
2400 mega-transfers per second (MT/s), on 64-bit ECC DIMM
HBM – – 8 GB, 32-pseudo channels
PCIe 16-lane PCI™ Express
PCIe Integrated Endpoint block connectivity
Gen1, 2, or 3 up to x16 Gen1, 2, or 3 up to x16
Gen4 x8
Network Interface 2x QSFP28 2x QSFP28 2x QSFP28
I2C Bus ✓✓✓
Status LEDs ✓✓✓
Power Management Power management with system management bus (SMBus) voltage, current, and
temperature monitoring
Electrical Design Power 65W with PCIe slot power only
140W with 110A max VCCINT current PCIe slot power and 6-pin PCIe AUX power cable
connected
215W with 160A max VCCINT current PCIe slot power and 8-pin PCIe AUX power cable
connected1
Configuration Options 1 gigabit (Gb) Quad Serial Peripheral Interface (SPI) flash memory
Micro-USB JTAG configuration port
UART UART access through the USB port
Notes:
1. Vitis™ unified software platform based applications are only designed to run with electrical design power at 215W.
Chapter 2: Accelerator Card Overview
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 5
Send Feedback

Minimum System Requirements
The minimum system requirements for running the Alveo™ U200/U250/U280 Data Center
accelerator cards are listed in the following table.
Table 2: Minimum System Requirements
Component Requirement
Motherboard PCI Express® 3.0-compatible with one dual-width x16 slot.
System Power Supply 225W via PCI Express Slot connection and 8-pin PCI Express Auxiliary Power
cable.
Operating System For the latest OS support, see Xilinx Runtime for Alveo Data Center Accelerator
Cards - Master Release Notes and Known Issues.
System Memory For deployment installations, a minimum of 16 GB plus application memory
requirements is required.
For development installations, a minimum of 64 GB of system memory is
required, but 80 GB is recommended.
Internet Connection Required for downloading drivers and utilities.
Hard disk space Satisfy the minimum system requirements for your operating system.
Licensing None required for application deployment.
For the application development environment, see Vitis Unified Software
Platform Documentation: Application Acceleration Development (UG1393).
For addional specicaons and details on the acceptable environmental condions, see Alveo
U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center
Accelerator Cards Data Sheet (DS963).
Qualified Servers
The Xilinx Qualied Servers Catalog provides a list of servers that Alveo cards are fully qualied.
Card Interfaces and Details
Alveo™ U200/U250/U280 cards are available in both passive and acve cooling conguraons;
see Passive and Acve Cooling Cards. The interfaces of each are idencal, except the fan
included on acve cooled cards. The card includes the following interfaces.
• A PCI Express® x16 card connector.
• A PCI Express auxiliary power connector. This 8-pin connector is shown in Figure 5 and is not
compable with an ATX12V/EPS12V power cable source.
Chapter 2: Accelerator Card Overview
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 6
Send Feedback

• Two QSFP28 interfaces. Currently these interfaces are not supported by the deployment
plaorm.
• A micro-USB connector for maintenance purposes.
• A fan for the acve cooled card conguraon.
WARNING! Hazardous moving parts. Keep away from fan blades.
ATTENTION! Pièces mobiles peuvent etre dangereuses. Éloignez-vous des lames du venlateur.
WARNUNG! Gefährliche bewegliche Teile. Halten sie sich von Lüerügeln fern.
Figure 1: Alveo Card Features
Fan
(for Active configuration only)
PCIe
Connector
Micro-USB
Interface
Network
Interface
Note: On the Alveo U280 card, the micro-USB is located on the opposite end of the card between the PCB
board and the enclosure.
Chapter 2: Accelerator Card Overview
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 7
Send Feedback

Passive and Active Cooling Cards
Alveo™ cards are available in both acve and passive cooling conguraons, as shown in the
following gures. The passive cooling card is designed to be installed into a data center server,
where controlled air ow provides direct cooling. The acve cooling card is designed to be
installed into a PC environment where the air ow is uncontrolled; consequently, this
conguraon includes a heat sink and fan enclosure cover to provide appropriate cooling.
For card specicaons, dimensions, list of card features, and block diagram see Alveo U200 and
U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator
Cards Data Sheet (DS963).
Figure 2: Active Cooled Card Configuration
Chapter 2: Accelerator Card Overview
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 8
Send Feedback

Figure 3: Passive Cooled Card Configuration
Chapter 2: Accelerator Card Overview
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 9
Send Feedback

Chapter 3
Card Installation Procedures
To reduce the risk of re, electric shock, or injury, always follow basic safety precauons.
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.
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 Önen der Computer / Systemabdeckung das Netzkabel ab.
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 10
Send Feedback

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.
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.
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 11
Send Feedback

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 U200 and U250 Data Center Accelerator Cards Data Sheet
(DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963).
• 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.
• Ensure that appropriate PCIe Auxiliary Power source is available, and not an ATX12V/EPS12V
power source. For more details see Xilinx Answer Record 72298.
Installing the Card
IMPORTANT! Do not unplug the Alveo™ AUX power connector while in the power-up state (hot-plug is
not allowed).
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 12
Send Feedback

IMPORTANT! Ne débranchez pas le connecteur auxiliaire d'alimentaon des cartes Alveo™ pendant
qu’elles sont sous-tension (“hot-plug” n'est pas autorisé).
WICHTIG! Trennen Sie den Alveo™-Stromanschluss-Stecker nicht im eingeschalteten Zustand (Hot-Plug
ist nicht zulässig).
The following procedure is a guide for the Xilinx® Alveo™ data center accelerator card
installaon. Consult your computer documentaon for addional informaon.
If you encounter any issues during installaon, see Chapter 7: Troubleshoong.
1. Host power supply must be disconnected.
2. For enclosed computers, open your computer by removing the casing.
3. If necessary, remove the two adjacent PCIe® slot covers corresponding to the PCIe x16 slot
in which you are installing the Alveo card.
4. Plug the Alveo card in the PCIe x16 slot on the motherboard.
5. Connect the AUX power connector to the Alveo card, ensure the plug is mechanically xed
(with the click).
IMPORTANT! Operaon of the Alveo cards only with AUX power connector is not allowed.
IMPORTANT! Le fonconnement des cartes Alveo uniquement avec le connecteur auxiliaire n'est pas
autorisé.
WICHTIG! Der Betrieb von Alveo-Karten nur mit AUX Connector ist nicht zulässig.
The Alveo card has an 8-pin receptacle PCIe AUX power connector. Depending on your
server or computer, an addional PCI Express auxiliary power cable or adapter may be
needed. Consult your computer documentaon for addional informaon.
For acvely cooled cards, connect the power cable to the AUX power connector at top of the
card as shown in the following gure.
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 13
Send Feedback

Figure 4: Connecting the Power Cable to Actively Cooled Cards
For passively cooled cards, connect the power cable to the AUX power connector at the side
of the card as shown in the following gure.
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 14
Send Feedback

Figure 5: Connecting the Power Cable to Passively Cooled Cards
WARNING! Alveo cards are not compable with an ATX12V/EPS12V power source. Do not force
connecon to a CPU (ATX12V/EPS12V) power source. This will damage the Alveo card and void the
warranty.
ATTENTION! Les cartes Alveo ne sont pas compables avec une source d'alimentaon ATX12V /
EPS12V. Ne forcez pas la connexion à une source d'alimentaon CPU (ATX12V / EPS12V). Cela
endommagerait la carte Alveo et annulerait la garane.
WARNUNG! Alveo-Karten sind nicht mit einer ATX12V / EPS12V-Stromquelle kompabel.
Erzwingen Sie keine Verbindung zu einer CPU-Stromquelle (ATX12V / EPS12V). Dadurch wird die
Alveo-Karte beschädigt und die Garane erlischt.
The power-supply can have an 8-pin or a 6-pin power connector conguraon. Some power
supplies label this cable PCIe Auxiliary Power or VGA. These connector conguraons are not
pin compable with other power source types. Do not force a connecon to any power
source other than PCIe Auxiliary Power. See Xilinx Answer Record 72298 for more
informaon.
IMPORTANT! Only 140W of power is available with the 6-pin connector (65 Was from PCIe
connector with 12V source, and 75 Was from the 6-pin AUX connector). 215W is available with the
8-pin connector (65 Was from PCIe connector 12V source, and 150 Was from the 8-pin AUX
connector).
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 15
Send Feedback

IMPORTANT! La puissance de 140W est uniquement disponibles avec le connecteur 6-broches (65
Was à parr de la source du connecteur PCIe 12V et 75 was à parr du connecteur AUX à 6-
broches). 215W est disponible avec le connecteur à 8-broches (65 was à parr de la source du
connecteur PCIe 12V et 150 Was à parr du connecteur 8-broches).
WICHTIG! Mit dem 6-Pin-Anschluss stehen nur 140W zur Verfügung (65 Wa vom PCIe-Anschluss
mit 12 V-Quelle und 75 Wa vom 6-Pin-Anschluss). 215W ist mit dem 8-Pin-Anschluss erhältlich (65
Wa von 12V-PCIe-Anschluss und 150 Wa vom 8-Pin-Anschluss).
The following example shows a successfully installed passive conguraon Alveo card.
Figure 6: Installed Alveo Card
PCIe Edge
Connector
PCIe AUX
Power Cable
6. If you previously removed the computer casing, re-install the casing.
7. Connect the power cord and turn on the computer.
Note: Do not power-on a passively cooled card without adequate forced airow across the card with
proper airow direcon, otherwise the card can be damaged. For more informaon, see Alveo U200
and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator
Cards Data Sheet (DS963).
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 16
Send Feedback

8. To verify that the device has been installed correctly, enter the following Linux command in
the terminal:
$ sudo lspci -vd 10ee:
If the card is successfully installed and found by the operang system, a message similar to
the one below will be displayed.
This is a sample output for an installed Alveo U250 card:
65:00.0 Processing accelerators: Xilinx Corporation Device 5004
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, NUMA node 0
Memory at 380072000000 (64-bit, prefetchable) [size=32M]
Memory at 380074040000 (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: [400] Access Control Services
Capabilities: [410] #15
Capabilities: [480] Vendor Specific Information: ID=0020 Rev=0
Len=010 <?> Kernel driver in use: xclmgmt
Kernel modules: xclmgmt
Note: If this card has previously been installed, the lspci output will be similar to the one shown in
Running lspci.
If you do not see a message similar to either of these, see Chapter 7: Troubleshoong.
Chapter 3: Card Installation Procedures
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 17
Send Feedback

Chapter 4
Installing the Deployment Software
This chapter details the procedures for installing deployment soware on RedHat/CentOS and
Ubuntu operang systems. All soware installaons use standard Linux RPM and Linux DEB
packages and require root access.
The deployment soware consists of the following soware packages:
•Xilinx® runme (XRT): XRT provides the libraries and drivers for an applicaon to run on
Alveo™ cards and also includes xbul and xbmgmt ulies. Ulity command line help can
always be obtained using the --help opon.
•Deployment plaorm: The deployment plaorm provides the rmware needed to run pre-
compiled applicaons. It cannot be used to compile or create new applicaons. DFX-1RP
plaorms consist of a base, while DFX-2RP plaorms consist of base and shell parons. For
more informaon, see Dynamic Funcon Exchange in XRT Documentaon. To create new
applicaons, install the development soware detailed in Chapter 6: Next Steps. While you
can also install the development soware on a machine with an installed card, doing so is not
necessary to run applicaons.
All installaon packages can be downloaded from the Geng Started tab of the respecve Alveo
card landing page:
•Alveo U200 Product Page
•Alveo U250 Product Page
•Alveo U280 Product Page
Note: Select the Vis Design Flow tool version 2021.1 or greater.
For plaorm features and details, see Alveo Data Center Accelerator Card Plaorms User Guide
(UG1120).
If you encounter any issues during installaon, see Chapter 7: Troubleshoong. See Xilinx
Answer Record 71752 for addional known issues.
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.
Chapter 4: Installing the Deployment Software
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 18
Send Feedback

WICHTIG! Root-Zugri ist für alle Soware- und Firmware-Installaonen erforderlich.
XRT and Deployment Platform Installation
Procedures on RedHat and CentOS
Use the following steps to download and install the XRT deployment plaorms.
For details on upgrading or downgrading the XRT and deployment plaorm, see Changing XRT
and Target Plaorm Versions.
1. XRT installaon requires Extra Packages for Enterprise Linux (EPEL) and a related repository.
If not already installed, install EPEL on your system by following the steps provided here.
2. Run the following two commands to install kernel headers and kernel development packages.
Ensure that uname is surrounded by backcks ( `) and not single quotes ('):
$ sudo yum install kernel-headers-`uname -r`
$ sudo yum install kernel-devel-`uname -r`
3. Aer the previous command completes, reboot your machine.
4. Download both the XRT and deployment plaorm installaon packages associated with your
card from the Geng Started tab on the respecve Alveo card product page:
•Alveo U200 Product Page
•Alveo U250 Product Page
•Alveo U280 Product Page
Note: Select the Vis Design Flow tool version 2021.1 or greater.
5. Install the XRT installaon package by running the following command from within the
directory where the XRT installaon packages reside.
$ sudo yum install ./xrt*.rpm
This will install the XRT and its necessary dependencies. Follow the instrucons when
prompted throughout the installaon.
6. Unpack the deployment target plaorm tar.gz le into a single directory. The locaon of
the directory is not important, however the directory should not contain any other les.
7. Install the deployment packages. From within the directory where the installaon packages
were unpacked, run the following command. This will install all deployment packages.
sudo yum install ./*.rpm
Alternavely, you can install the deployment plaorm installaon packages individually. If this
is the case, install them in the following order.
Chapter 4: Installing the Deployment Software
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 19
Send Feedback

• Satellite controller rmware
• Card management rmware
• Base paron rmware
•Plaorm validaon
• Shell paron rmware (DFX-2RP plaorms only)
The following command is an example of how to install each package individually for a
DFX-2RP plaorm.
$ sudo yum install ./xilinx-sc-fw-<version>.rpm ./xilinx-cmc-
<cmc_version>.rpm ./xilinx-u250-<base_version>.rpm ./xilinx-u250-
<validate_version>.rpm ./xilinx-u250-<shell_version>.rpm
For addional details related to the deployment plaorms for your Alveo card, see the Alveo
Data Center Accelerator Card Plaorms User Guide (UG1120).
8. Flash the base paron to the Alveo card. Aer installing the deployment packages in the
previous step, the following message is displayed:
Partition package installed successfully.
Please flash card manually by running below command:
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --
card <card_bdf>
With XRT 2021.1 or greater, it is necessary to use the following new command to ash the
card rather than the one displayed in the above message. It assumes only one deployment
plaorm is installed on the card. If more than one plaorm is installed the --image opon
needs to be added. See xbmgmt documentaon for details.
IMPORTANT! If you have mulple cards installed in the system, you must run the above xbmgmt
program command separately for each card.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where management BDF is the card to be programmed. See Displaying Card BDF Values to
obtain the device management BDF.
9. You will be asked to conrm the update, as follows. Type y and press the Enter key.
Actions to perform:
[0000:03:00.0] : Program base (FLASH) image
[0000:03:00.0] : Program Satellite Controller (SC) image
----------------------------------------------------
Are you sure you wish to proceed? [Y/n]: y
Flashing can take several minutes.
IMPORTANT! Do not enter Ctrl + c in the terminal while the rmware is ashing as this can cause the
card to become inoperable.
Chapter 4: Installing the Deployment Software
UG1301 (v2.2) August 19, 2022 www.xilinx.com
Getting Started with Alveo Accelerator Cards 20
Send Feedback