Xilinx Varium C1100 User manual

Varium C1100 Compute
Adaptor
Installaon Guide
UG1525 (v1.1) March 8, 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.............................................................................................. 3
Adaptor Features.........................................................................................................................3
Minimum System Requirements...............................................................................................4
Chapter 2: Adaptor Interfaces and Details...................................................... 5
Chapter 3: Adaptor Installation Procedures................................................... 6
Safety Instructions...................................................................................................................... 6
Before You Begin.........................................................................................................................8
Installing the Adaptor.................................................................................................................8
Chapter 4: Installing the Deployment Software......................................... 11
XRT and Deployment Platform Installation Procedures on RedHat and CentOS............. 11
XRT and Deployment Package Installation Procedures on Ubuntu................................... 14
Chapter 5: Card Bring-Up and Validation........................................................17
Environment Setup................................................................................................................... 17
Running lspci............................................................................................................................. 17
Confirm Firmware Installation ................................................................................................18
Card Validation.......................................................................................................................... 19
Chapter 6: Troubleshooting.................................................................................... 22
Known Issues.............................................................................................................................22
Appendix A: Reverting the Card to Factory Image....................................23
Appendix B: Additional Resources and Legal Notices............................. 24
Xilinx Resources.........................................................................................................................24
Documentation Navigator and Design Hubs.........................................................................24
References..................................................................................................................................24
Revision History.........................................................................................................................25
Please Read: Important Legal Notices................................................................................... 25
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 2
Send Feedback

Chapter 1
Introduction
Note: Parts of this document contain informaon in languages other than English. This is required for
regulatory compliance.
This document provides hardware and soware installaon procedures for the Varium™ C1100
compute adaptor using XRT 2021.1 and later. For installaon procedures using previous XRT
versions, see v1.0 of the Varium C1100 Compute Adaptor Installaon Guide (UG1525).
Dierent system conguraons are available for running, developing, and debugging applicaons
on your Varium C1100 compute adaptor:
•Running Applicaons: To congure a system to run accelerated applicaons, install a Varium
C1100 compute adaptor into a system as described in Chapter 3: Adaptor Installaon
Procedures along with the required deployment soware to support running applicaons.
•Running, Developing, and Debugging Applicaons: By installing the Varium C1100 compute
adaptor with both the deployment and development soware on a single machine, you can
congure a system for developing and running compute applicaons. With the adaptor
installed, developers can debug applicaons in both emulaon modes and on the hardware.
Adaptor Features
The full-height, half-length Varium C1100 compute adaptor is Gen3 x16 PCI Express® (PCIe)
compliant. It features the Xilinx® UltraScale+™ architecture and targets compute applicaons.
The Varium C1100 compute adaptor features are as follows.
Table 1: Varium C1100 Compute Adaptor Features
Adaptor Component Varium C1100
FPGA UltraScale+ XCU55N FPGA
HBM 8 GB - two 4 gigabyte (GB) HBM memory stacks
Network Interface 2 x QSFP28 supporting 100 GbE, 40 GbE, or 4 x 10/25 GbE
Status LEDs
PCIe 16-lane PCI Express
PCIe integrated endpoint block connectivity
Gen1, 2, or 3 up to x16, Gen4 x8
Dual Gen4 x8
I2C Bus ✓
Chapter 1: Introduction
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 3
Send Feedback

Table 1: Varium C1100 Compute Adaptor Features (cont'd)
Adaptor Component Varium C1100
Power Management Power management with system management bus (SMBus)
voltage, current, and temperature monitoring
External Power Sources 75W PCIe slot functional with PCIe slot power only.
Provisioned with auxiliary power connector. However, the
adaptor is thermally designed to support 150W.
Configuration Options 1 Gb Quad-SPI flash memory:
UltraScale+ device configurable over USB/JTAG and Quad-
SPI configuration flash memory
UART UART access through the micro-USB connector
Minimum System Requirements
The minimum system requirements for running the Varium C1100 compute adaptor are listed in
the following table.
Table 2: Minimum System Requirements
Component Requirement
Motherboard PCI Express® 3.0-compliant with one full-height x16 slot.
System power supply 150W via PCI Express slot connection and 8-pin PCI Express auxiliary power.
Operating system For the latest OS support, see XRT Release Notes (UG1451).
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 details on the acceptable environmental condions, see the Varium C1100 Compute Adaptor
Data Sheet (DS1003).
Chapter 1: Introduction
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 4
Send Feedback

Chapter 2
Adaptor Interfaces and Details
The Varium™ C1100 compute adaptor is available in a passive cooling conguraon and is
designed for installaon into a data center server where controlled air ow provides direct
cooling to the adaptor. The adaptor includes the following interfaces.
• A PCI Express® card connector
• A PCI Express auxiliary power connector
• The producon qualied (PQ) adaptor and engineering sample (ES) adaptor both have two
QSFP28 interfaces
• A micro-USB connector for JTAG programming
Figure 1: Varium C1100 Compute Adaptor with Full-Height Bracket
QSFP28 Inerfaces
Micro-USB Connector
PCIe Connector
AUX Power
Connector
Note: Varium C1100 compute adaptor is designed to be installed into a data center server, where
controlled air ow provides direct cooling. If the cooling enclosure is removed from the adaptor and the
adaptor is powered-up, external fan cooling airow MUST be applied to prevent over-temperature shut-
down and possible damage to the adaptor electronics. Removing the cooling enclosure voids the board
warranty.
For adaptor specicaons, dimensions, list of adaptor features, and block diagram, see the Varium
C1100 Compute Adaptor Data Sheet (DS1003).
Chapter 2: Adaptor Interfaces and Details
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 5
Send Feedback

Chapter 3
Adaptor 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: Adaptor Installation Procedures
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 6
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 adaptor against your clothing. The wrist strap protects components from
ESD on the body only.
• Handle the adaptor by its bracket or edges only. Avoid touching the printed circuit board or
the connectors.
• Put the adaptor down only on an anstac surface such as the bag supplied in your kit.
• If you are returning the adaptor 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 le adapateurs 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 le adapateurs uniquement par son support ou par ses bords. Évitez de toucher la
carte de circuit imprimé ou les connecteurs.
• Ne posez le adapateurs 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 le adapateurs 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: Adaptor Installation Procedures
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 7
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 der adapter nicht mit ihrer Kleidung. Der Riemen schützt Komponenten nur vor
ESD am Körper.
• Fassen sie der adapter nur an der Halterung oder an den Kanten an. Berühren sie nicht die
Leiterplae oder die Anschlüsse.
• Legen sie der adapter nur auf einer anstaschen Oberäche ab, z.B. dem anstaschen
Beutel der mit dem Kit mitgeliefert wurde.
• Wenn sie der adapter an den Xilinx Product Support zurücksenden, legen Sie sie bie sofort
wieder in den anstaschen Beutel.
Before You Begin
IMPORTANT! Varium C1100 adaptors 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 adaptateurs Varium 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 adaptern Varium 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 space is available to install your adaptor. Adaptor specicaons and
dimensions are listed in the Varium C1100 Compute Adaptor Data Sheet (DS1003).
• Check for adaptor compability with the system. Also check for proper system requirements
such as power, bus type, and physical dimensions to support the adaptor.
Installing the Adaptor
The following procedure is a guide for the Varium™ C1100 compute adaptor installaon. Consult
your computer documentaon for addional informaon.
Note: For use with UL listed servers or ITE.
If you encounter any issues during installaon, see Chapter 6: Troubleshoong.
Chapter 3: Adaptor Installation Procedures
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 8
Send Feedback

1. Shut down the host computer and unplug the power cord.
2. Open your computer by removing the casing.
3. If necessary, remove the adjacent PCIe® slot cover corresponding to the PCIe slot in which
you are installing the Varium C1100 compute adaptor.
4. Plug the Varium C1100 compute adaptor into the PCIe x16 slot on the motherboard.
5. Connect the AUX power connector to the Varium C1100 compute adaptor, ensure the plug is
mechanically xed (with the click).
IMPORTANT! Operaon of the Varium C1100 compute adaptor only with AUX power connector is
not allowed.
IMPORTANT! Le fonconnement des adaptateurs Varium uniquement avec le connecteur auxiliaire
n'est pas autorisé.
WICHTIG! Der Betrieb von Varium-Adaptern mit dem Hilfsstecker ist nicht zulässig.
To provide addional power, the Varium C1100 compute adaptor has an 8-pin female PCIe
AUX power connector which can accept an 8-pin or 6-pin AUX power cable. For applicaons
requiring opmum performance, the PCIe AUX power needs to be connected to increase the
power supplied to the adaptor from 75W from the PCIe to 150W. Consult your computer
documentaon for addional informaon.
6. Re-install the computer casing.
7. Connect the power cord and turn on the computer.
WARNING! 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. This card can heat up aer use in
the server. Use cauon when handling. For more informaon, see Varium C1100 Compute Adaptor
Data Sheet (DS1003).
8. To verify that the device has been installed correctly, enter the following command in the
terminal:
$ sudo lspci -vd 10ee:
If the adaptor 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 Varium C1100 compute adaptor:
af:00.0 Processing accelerators: Xilinx Corporation Device 5058
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, NUMA node 1
Memory at 39bffc000000 (64-bit, prefetchable) [size=32M]
Memory at 39bffe000000 (64-bit, prefetchable) [size=128K]
Capabilities: <access denied>
Kernel driver in use: xclmgmt
Kernel modules: xclmgmt
Chapter 3: Adaptor Installation Procedures
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 9
Send Feedback

If you do not see a message similar to the previous one, see Chapter 6: Troubleshoong.
Chapter 3: Adaptor Installation Procedures
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 10
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
Varium™ C1100 compute adaptor.
•Deployment plaorm: The deployment plaorm provides the base rmware needed to run
pre-compiled applicaons. It cannot be used to compile or create new applicaons.
All installaon packages can be downloaded from the Geng Started tab of the respecve Alveo
card landing page: Varium C1100 Product Page
If you encounter any issues during installaon, see Chapter 6: Troubleshoong.
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.
XRT and Deployment Platform Installation
Procedures on RedHat and CentOS
Use the following steps to download and install the XRT and deployment plaorms using .rpm
installaon package.
For details on upgrading or downgrading the XRT and deployment plaorm, see Modifying XRT
or Plaorm.
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 11
Send Feedback

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 on the
XRT Installaon page.
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. From the Geng Started tab of the Varium C1100 compute adaptor product page, download
the Xilinx Runme (XRT) and deployment target plaorm installaon packages associated
with your OS and version. To download the packages, click on the displayed package names.
5. Install the XRT installaon package by running the following command from within the
directory where the XRT installaon packages reside. <version> is the laer part of the
installaon package le name.
$ sudo yum install ./xrt_<version>.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
Aer you install the deployment packages, 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 <shell_name>
8. Flash the plaorm rmware on the card.
With XRT 2021.1 or greater, you must use the following new command to ash the card,
rather than the command displayed in the previous system message. This assumes only one
deployment playform is installed on the card.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where <management BDF> is the card to be programmed. To obtain the device
management BDF, see Displaying Card BDF Values.
This can take several minutes.
IMPORTANT! If you have mulple cards installed in the system, you must run the above
xbmgmt
program command separately for each card.
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 12
Send Feedback

Note: If more than one plaorm is installed, then the --image opon needs to be added. For details,
see xbmgmt documentaon.
IMPORTANT! Do not enter Ctrl + c in the terminal while the rmware is ashing as this can cause the
card to become inoperable.
IMPORTANT! N'entrez pas Ctrl + c dans le terminal lorsque le micrologiciel clignote, car cela pourrait
rendre la carte inulisable.
WICHTIG! Geben Sie im Terminal nicht Strg + c ein, während die Firmware blinkt, da dies dazu führen
kann, dass die Karte nicht mehr funkoniert.
Aer successfully ashing the card, a message similar to the following is displayed:
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
If the card has been ashed with the current plaorm rmware, a message similar to the
following is displayed:
Device(s) up-to-date and do not need to be flashed.
9. Cold boot the machine to load the new rmware image on the FPGA.
IMPORTANT! Be sure to fully power o the machine and then power it on again. The image will not
boot from ash if the machine is only rebooted.
IMPORTANT! Assurez-vous d'éteindre complètement la machine, puis de la rallumer. L'image ash ne
démarrera pas si la machine n'est pas redémarrée.
WICHTIG! Schalten Sie das Gerät vollständig aus und wieder ein. Das Image startet nicht von Flash,
wenn der Computer nur neu gestartet wird.
10. Update the SC rmware on the card. Run the following command to update the SC rmware
on the card. It is the idencal command used to ash the plaorm rmware on the card. This
can take several minutes to complete.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where <management BDF> is the card to be programmed. To obtain the device
management BDF, see Displaying Card BDF Values.
IMPORTANT! If you have mulple cards installed in the system, you must run the above
xbmgmt
program command separately for each card.
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 13
Send Feedback

A message similar to the following will be displayed aer a successful SC rmware update,
where the device management BDF is given in square brackets.
Report
[0000:af:00.0] : Successfully flashed
1 device(s) flashed successfully.
******************************************************************
Warm reboot is required to recognize new SC image on the device.
******************************************************************
If the card already has the current rmware, a message similar to the following is displayed
and no addional installaon steps are necessary.
Device(s) up-to-date and do not need to be flashed.
11. Warm boot the system for XRT to recognize the new SC image.
The installaon for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up
and Validaon.
XRT and Deployment Package Installation
Procedures on Ubuntu
Use the following steps to download and install the XRT and deployment plaorm using a .deb
installaon package.
For details on upgrading or downgrading the XRT and deployment plaorm, see Modifying XRT
or Plaorm.
1. From the Geng Started tab of the Varium C1100 compute adaptor product page, download
the XRT and deployment target plaorm installaon packages associated with your OS and
version. To download the packages, click on the displayed package names.
2. Install the XRT installaon package by running the following command from within the
directory where the XRT installaon packages reside. <version> is the laer part of the
installaon package le name.
$ sudo apt install ./xrt_<version>.deb
This will install the XRT and its necessary dependencies. Follow the instrucons when
prompted throughout the installaon.
3. 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.
4. 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 apt install ./*.deb
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 14
Send Feedback

Aer you install the deployment packages, 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 <shell_name>
5. Flash the plaorm rmware on the card.
With XRT 2021.1 or greater, you must use the following new command to ash the card,
rather than the command displayed in the previous system message. This assumes only one
deployment playform is installed on the card.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where <management BDF> is the card to be programmed. To obtain the device
management BDF, see Displaying Card BDF Values.
This can take several minutes.
IMPORTANT! If you have mulple cards installed in the system, you must run the above
xbmgmt
program command separately for each card.
Note: If more than one plaorm is installed, then the --image opon needs to be added. For details,
see xbmgmt documentaon.
IMPORTANT! Do not enter Ctrl + c in the terminal while the rmware is ashing as this can cause the
card to become inoperable.
IMPORTANT! N'entrez pas Ctrl + c dans le terminal lorsque le micrologiciel clignote, car cela pourrait
rendre la carte inulisable.
WICHTIG! Geben Sie im Terminal nicht Strg + c ein, während die Firmware blinkt, da dies dazu führen
kann, dass die Karte nicht mehr funkoniert.
Aer successfully ashing the card, a message similar to the following is displayed:
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
If the card has been ashed with the current plaorm rmware, a message similar to the
following is displayed:
Device(s) up-to-date and do not need to be flashed.
6. Cold boot the machine to load the new rmware image on the FPGA.
IMPORTANT! Be sure to fully power o the machine and then power it on again. The image will not
boot from ash if the machine is only rebooted.
IMPORTANT! Assurez-vous d'éteindre complètement la machine, puis de la rallumer. L'image ash ne
démarrera pas si la machine n'est pas redémarrée.
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 15
Send Feedback

WICHTIG! Schalten Sie das Gerät vollständig aus und wieder ein. Das Image startet nicht von Flash,
wenn der Computer nur neu gestartet wird.
7. Update the SC rmware on the card. Run the following command to update the SC rmware
on the card. It is the idencal command used to ash the plaorm rmware on the card. This
can take several minutes to complete.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where <management BDF> is the card to be programmed. To obtain the device
management BDF, see Displaying Card BDF Values.
IMPORTANT! If you have mulple cards installed in the system, you must run the above
xbmgmt
program command separately for each card.
A message similar to the following will be displayed aer a successful SC rmware update,
where the device management BDF is given in square brackets.
Report
[0000:af:00.0] : Successfully flashed
1 device(s) flashed successfully.
******************************************************************
Warm reboot is required to recognize new SC image on the device.
******************************************************************
If the card already has the current rmware, a message similar to the following is displayed
and no addional installaon steps are necessary.
Device(s) up-to-date and do not need to be flashed.
8. Warm boot the system for XRT to recognize the new SC image.
The installaon for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up
and Validaon.
Chapter 4: Installing the Deployment Software
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 16
Send Feedback

Chapter 5
Card Bring-Up and Validation
Aer installing the XRT and deployment plaorm, the card installaon can be veried using the
following commands which are described in subsequent secons.
•lspci
•xbmgmt examine
•xbutil validate
The lspci Linux command is used to conrm the card, is seen by the OS, as was done when
installing the card.
The addional commands are used to validate and idenfy the installed card(s) and report
addional card details including memory, PCIe®, plaorm name, and system informaon. See
xbul and xbmgmt
Note: Ulity command line help can always be obtained using the --help opon.
Environment Setup
Set the environment to use the ulies by running the following command. Note that the
command is dependent on the command shell you are using.
Use the following command in csh shell:
$ source /opt/xilinx/xrt/setup.csh
Use the following command in bash shell:
$ source /opt/xilinx/xrt/setup.sh
Running lspci
Conrm the card is detected by the OS:
Chapter 5: Card Bring-Up and Validation
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 17
Send Feedback

1. Enter the following command.
$ sudo lspci -vd 10ee:
2. If the card is successfully installed and found by the operang system, you will see a message
similar to the following.
af:00.0 Processing accelerators: Xilinx Corporation Device 5058
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, NUMA node 1
Memory at 39bff2000000 (64-bit, prefetchable) [size=32M]
Memory at 39bff4040000 (64-bit, prefetchable) [size=256K]
Capabilities: <access denied>
Kernel driver in use: xclmgmt
Kernel modules: xclmgmt
af:00.1 Processing accelerators: Xilinx Corporation Device 5059
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, IRQ 188, NUMA node 1
Memory at 39bff0000000 (64-bit, prefetchable) [size=32M]
Memory at 39bff4000000 (64-bit, prefetchable) [size=256K]
Memory at 39bfe0000000 (64-bit, prefetchable) [size=256M]
Capabilities: <access denied>
Kernel driver in use: xocl
Kernel modules: xocl
Note: For each card, there will be two physical funcons found: management and user. For addional
details, see XRT and Vis Plaorm Overview.
Confirm Firmware Installation
When a card has successfully been installed and the rmware has been updated, both entries for
Platform and SC version installed on the card and the system must match. If they do not
match, the system will be unable to correctly run applicaons on your card.
To conrm they match, run the following command and visually compare the 'Plaorm' and 'SC
Version' entries under Flashable partitions running on FPGA and Flashable
partitions installed in system match.
$ sudo /opt/xilinx/xrt/bin/xbmgmt examine --device <management BDF>
To obtain the device management BDF, see Displaying Card BDF Values.
In the following example output, Platform (xilinx_u55n_gen3x4_xdma_base_1) and SC
version (7.1.12) are displayed under Flashable partitions running on FPGA and
Flashable partitions installed in system both match.
----------------------------------------------------
1/1 [0000:af:00.0] : xilinx_u55n_gen3x4_xdma_base_1
----------------------------------------------------
Flash properties
Type : spi
Chapter 5: Card Bring-Up and Validation
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 18
Send Feedback

Serial Number : XFL1OZFU4IRX
Device properties
Type : u55n
Name : ALVEO U55N PQ
Config Mode : 7
Max Power : 75W
Flashable partitions running on FPGA
Platform : xilinx_u55n_gen3x4_xdma_base_1
SC Version : 7.1.12
Platform UUID : 9964C19C-DB53-EB6C-69B6-FD2072401583
Interface UUID : FCBF14C6-8850-4574-FD28-1F538E4582A3
Flashable partitions installed in system
Platform : xilinx_u55n_gen3x4_xdma_base_1
SC Version : 7.1.12
Platform UUID : 9964C19C-DB53-EB6C-69B6-FD2072401583
Mac Address : 00:0A:35:0B:0C:E0
: 00:0A:35:0B:0C:E1
: 00:0A:35:0B:0C:E2
: 00:0A:35:0B:0C:E3
: 00:0A:35:0B:0C:E4
: 00:0A:35:0B:0C:E5
: 00:0A:35:0B:0C:E6
: 00:0A:35:0B:0C:E7
Card Validation
Card installaon can be validated using the xbutil validate command. This command
performs various tests and checks on the card including PCIe link status, SC version status,
memory, and bandwidth tests and auxiliary power connecon where applicable. Full command
details can be found in xbul documentaon. Depending on the card tested, not all tests are valid
or might require the funcon to be enabled (for example, Peer-2-Peer).
Use the following command to run the card validaon test:
/opt/xilinx/xrt/bin/xbutil validate --device <user BDF> --verbose
Where <user BDF> is the card to be programmed. To obtain the device management BDF, see
Displaying Card BDF Values.
Chapter 5: Card Bring-Up and Validation
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 19
Send Feedback

If the card was installed and validated successfully, a message similar to the following will be
displayed. Review the Validation Summary secon at the end of the output and conrm the
device validated successfully. Addional validaon details are displayed by appending the --
verbose opon to the command. See Card Validaon within the Alveo Card Debug Guide for
support.
Verbose: Enabling Verbosity
Starting validation for 1 devices
Validate Device : [0000:af:00.1]
Platform : xilinx_u55n_gen3x4_xdma_base_1
SC Version : 7.1.12
Platform ID : 9964C19C-DB53-EB6C-69B6-FD2072401583
----------------------------------------------------------------------------
---
Test 1 [0000:af:00.1] : Aux connection
Description : Check if auxiliary power is connected
Details : Aux power connector is not available on this board
Test Status : [SKIPPED]
----------------------------------------------------------------------------
---
Test 2 [0000:af:00.1] : PCIE link
Description : Check if PCIE link is active
Test Status : [PASSED]
----------------------------------------------------------------------------
---
Test 3 [0000:af:00.1] : SC version
Description : Check if SC firmware is up-to-date
Test Status : [PASSED]
----------------------------------------------------------------------------
---
Test 4 [0000:af:00.1] : Verify kernel
Description : Run 'Hello World' kernel test
Xclbin : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/
verify.xclbin
Testcase : /opt/xilinx/xrt/test/validate.exe
Test Status : [PASSED]
----------------------------------------------------------------------------
---
Test 5 [0000:af:00.1] : DMA
Description : Run dma test
Details : Host -> PCIe -> FPGA write bandwidth = 3323.8 MB/s
Host <- PCIe <- FPGA read bandwidth = 3252.4 MB/s
Test Status : [PASSED]
----------------------------------------------------------------------------
---
Test 6 [0000:af:00.1] : iops
Description : Run scheduler performance measure test
Xclbin : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/
verify.xclbin
Testcase : /opt/xilinx/xrt/test/xcl_iops_test.exe
Details : IOPS: 443001 (verify)
Test Status : [PASSED]
----------------------------------------------------------------------------
---
Test 7 [0000:af:00.1] : Bandwidth kernel
Description : Run 'bandwidth kernel' and check the throughput
Xclbin : /opt/xilinx/firmware/u55n/gen3x4-xdma/base/test/
bandwidth.xclbin
Testcase : /opt/xilinx/xrt/test/kernel_bw.exe
Chapter 5: Card Bring-Up and Validation
UG1525 (v1.1) March 8, 2022 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 20
Send Feedback