Xilinx Varium C1100 User manual

Varium C1100 Compute
Adaptor
Installaon Guide
UG1525 (v1.0) September 17, 2021

Revision History
The following table shows the revision history for this document.
Section Revision Summary
09/17/2021 Version 1.0
Initial release. N/A
Revision History
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 2
Send Feedback

Table of Contents
Revision History...............................................................................................................2
Chapter 1: Introduction.............................................................................................. 5
Adaptor Features.........................................................................................................................5
Minimum System Requirements...............................................................................................6
Chapter 2: Adaptor Interfaces and Details...................................................... 7
Chapter 3: Adaptor Installation Procedures................................................... 8
Safety Instructions...................................................................................................................... 8
Before You Begin.......................................................................................................................10
Installing the Adaptor...............................................................................................................10
Chapter 4: Installing the Deployment Software......................................... 13
XRT and Deployment Platform Installation Procedures on RedHat and CentOS............. 13
XRT and Deployment Package Installation Procedures on Ubuntu................................... 16
Chapter 5: Card Bring-Up and Validation........................................................20
Running lspci............................................................................................................................. 20
Running xbmgmt flash --scan................................................................................................. 21
xbutil validate............................................................................................................................ 22
Chapter 6: Troubleshooting.................................................................................... 24
Known Issues.............................................................................................................................24
Appendix A: Changing XRT and Target Platform Versions....................25
RedHat and CentOS.................................................................................................................. 25
Ubuntu........................................................................................................................................26
Appendix B: Creating a Vault Repository for CentOS...............................28
Appendix C: Reverting the Card to Factory Image.................................... 30
Appendix D: Obtaining xbmgmt Command Options............................... 31
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 3
Send Feedback

Appendix E: Additional Resources and Legal Notices..............................33
Xilinx Resources.........................................................................................................................33
Documentation Navigator and Design Hubs.........................................................................33
References..................................................................................................................................33
Please Read: Important Legal Notices................................................................................... 34
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 4
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 2020.2.1.
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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 5
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 system1Linux, 64-bit:
•Ubuntu: 16.04, 18.04, 20.04
•CentOS: 7.6, 7.7, 7.8, 8.1, 8.2
•RHEL: 7.6, 7.7, 7.8, 8.1, 8.2
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.
Notes:
1. For the latest OS support, see XRT Release Notes (UG1451).
For details on the acceptable environmental condions, see the Varium C1100 Compute Adaptor
Data Sheet (DS1003).
Chapter 1: Introduction
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 6
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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 7
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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 8
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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 9
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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 10
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 card performance, the PCIe AUX power needs to be connected to
increase the power supplied to the card 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.
Note: Do not power-on a passively cooled adaptor without adequate forced airow across the adaptor
with proper air ow direcon, otherwise the adaptor can be damaged. This adaptor can heat up aer
use in the server. Use cauon when handling. For more informaon, see the Varium C1100 Compute
Adaptor Data Sheet (DS1003).
8. To verify that the device has been installed correctly, enter the following Linux 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 386ff2000000 (64-bit, prefetchable) [size=32M]
Memory at 386ff4040000 (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
Chapter 3: Adaptor Installation Procedures
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 11
Send Feedback

Capabilities: [e00] Access Control Services
Capabilities: [e10] #15
Capabilities: [e80] Vendor Specific Information: ID=0020 Rev=0 Len=010
Kernel driver in use: xclmgmt
Kernel modules: xclmgmt
If you do not see a message similar to the previous one, see Chapter 6: Troubleshoong.
Chapter 3: Adaptor Installation Procedures
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 12
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.
Both the Xilinx runme (XRT) and deployment plaorm installaon packages can be downloaded
from the Varium C1100 compute adaptor 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 Appendix A:
Changing XRT and Target Plaorm Versions.
Chapter 4: Installing the Deployment Software
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 13
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`
Note: If these yum commands fail because they cannot nd packages matching your kernel version, set
up a Vault repository. For more informaon, see Appendix B: Creang a Vault Repository for CentOS.
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 XRT installaon package le by selecng your OS and version, then select the displayed
XRT le name.
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. From the Varium C1100 compute adaptor product page, download and unpack the
deployment installaon tar.gz le. Download the tar.gz le by rst selecng your OS
and version, then clicking on the displayed le name. Unpack the 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 ./xilinx*.rpm
The installaon of the deployment paron and rmware are located in the /opt/xilinx/
firmware directory and contains the named paron and rmware sub-directories. Aer
installing the deployment packages you will see the following message.
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>
8. Flash the base rmware to the Varium C1100 compute adaptor using the command displayed
in the output of the previous step. It has the following format.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --
card <card_bdf>
Chapter 4: Installing the Deployment Software
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 14
Send Feedback

If the card has been upgraded, you will see a message similar to the following and no
addional installaon steps are necessary.
Status: shell is up-to-date Card(s) up-to-date and do not need to be
flashed.
9. You will be asked to conrm the update, as follows. Type y and press the Enter key.
Status: shell needs updating
Current shell: <current_base_partition_name>
Shell to be flashed: <base_partition_to_be_flashed>
Are you sure you wish to proceed? [y/n]:
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.
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.
Successfully ashing a new card results in a message similar to the following. If the command
returns Card Not Found, perform a cold reboot, and retry. Otherwise, see Chapter 6:
Troubleshoong.
Updating shell on card[0000:d8:00.0]
Bitstream guard installed on flash @0x1002000
Persisted 545084 bytes of meta data to flash 0 @0x7f7ae98
Extracting bitstream from MCS data:
...............................
Extracted 32306392 bytes from bitstream @0x1002000
Writing bitstream to flash 0:
...............................
Bitstream guard removed from flash
Successfully flashed Card[0000:d8:00.0]
1 Card(s) flashed successfully.
Cold reboot machine to load the new image on card(s).
10. Cold boot your machine to load the new base rmware image on the FPGA.
Note: Be sure to fully power OFF the machine and then power it ON again. The image will not boot
from ash if the machine is only rebooted.
11. Update the SC rmware by re-running the update command in the previous step.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --
card <card_bdf>
Chapter 4: Installing the Deployment Software
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 15
Send Feedback

If the SC is up to date, you will see the following message and no addional upgrade steps
are necessary.
Status: shell is up-to-date
Card(s) up-to-date and do not need to be flashed
If you have mulple cards installed or need to regenerate the command, follow the steps
given in Appendix D: Obtaining xbmgmt Command Opons.
If the SC needs updang it will report the following message.
Status: SC needs updating
Current SC: <current_sc_version>
SC to be flashed: <sc_version_to_be_flashed>
Are you sure you wish to proceed? [y/n]: y
Updang the SC rmware can take several minutes. Successfully ashing the SC results in a
message similar to the following. No reboot is necessary.
Updating SC firmware on card[0000:d8:00.0]
Stopping user function...
......................................
Successfully flashed Card[0000:d8:00.0]
1 Card(s) flashed successfully.
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 Appendix A:
Changing XRT and Target Plaorm Versions.
Note: The installaon packages referenced here are updated regularly and the le names frequently
change. If you copy and paste any commands from this user guide, be sure to update the placeholders in
those commands to match the downloaded packages.
1. From the Varium C1100 compute adaptor product page, download the XRT installaon
package by rst selecng your OS and version, then select the displayed XRT le name
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*.deb
Chapter 4: Installing the Deployment Software
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 16
Send Feedback

This will install the XRT along with any necessary dependencies. Follow the instrucons
when prompted throughout the installaon.
3. From the Varium C1100 compute adaptor product page, download and extract the
deployment installaon tar.gz le by rst selecng your OS and version, then clicking on
the displayed le name. Extract the 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 ./xilinx*.deb
The installaon of the deployment paron and rmware are located in the /opt/xilinx/
rmware directory and contain the named paron and rmware sub-directories. Aer
installing the deployment packages you will see the following message.
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>
5. Flash the base rmware to the Varium C1100 compute adaptor using the command displayed
in the output of the previous step. It has the following format.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --
card <card_bdf>
If the card has been upgraded, you will see a message similar to the following and no
addional installaon steps are necessary.
Status: shell is up-to-date Card(s) up-to-date and do not need to be
flashed.
The following command can be used for obtaining the base_name and card_bdf command
opons.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan
If you have mulple cards installed or need to regenerate the command, follow the steps
given in Appendix D: Obtaining xbmgmt Command Opons.
6. You will be asked to conrm the update, as follows. Type y and press the Enter key.
Status: shell needs updating
Current shell: <current_base_partition_name>
Shell to be flashed: <base_partition_to_be_flashed>
Are you sure you wish to proceed? [y/n]:
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
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 17
Send Feedback

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.
Successfully ashing a new card results in a message similar to the one shown below. If the
command returns Card Not Found, perform a cold reboot, and retry. Otherwise, see
Chapter 6: Troubleshoong.
Updating shell on card[0000:86:00.0]
Bitstream guard installed on flash @0x1002000
Persisted 547368 bytes of meta data to flash 0 @0x7f7a5ac
Extracting bitstream from MCS data:
...........................................
Extracted 44476060 bytes from bitstream @0x1002000
Writing bitstream to flash 0:
...........................................
Bitstream guard removed from flash
Successfully flashed Card[0000:86:00.0]
1 Card(s) flashed successfully.
Cold reboot machine to load the new image on card(s)
7. Cold boot your machine to load the new base rmware image on the FPGA.
Note: Be sure to perform a cold boot to fully power OFF the machine and then power it ON again. The
image will not boot from ash if the machine is only rebooted.
8. Update the SC rmware by re-running the update command in the previous update step.
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --
card <card_bdf>
If the SC is up to date, you will see the following message and no addional upgrade steps
are necessary.
Status: shell is up-to-date
Card(s) up-to-date and do not need to be flashed.
9. If the SC needs updang it will report the following message.
Status: SC needs updating
Current SC: <current_sc_version>
SC to be flashed: <sc_version_to_be_flashed>
Are you sure you wish to proceed? [y/n]: y
Updang the SC rmware can take several minutes. A successful SC rmware update will
result in a message similar to the following. The SC rmware will be updated and no cold
boot is required.
Updating SC firmware on card[0000:d8:00.0]
Stopping user function...
........................................
Successfully flashed Card[0000:d8:00.0]
1 Card(s) flashed successfully.
Chapter 4: Installing the Deployment Software
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 18
Send Feedback

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.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 19
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 flash --scan
•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 use the xbmgmt and xbutil ulies included during the XRT package
installaon. These ulies include mulple commands 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 Vis Unied Soware Plaorm Documentaon: Applicaon Acceleraon
Development (UG1393) for a detailed list of commands.
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
Perform the following to run lspci:
1. Enter the following command.
$ sudo lspci -vd 10ee:
Chapter 5: Card Bring-Up and Validation
UG1525 (v1.0) September 17, 2021 www.xilinx.com
Varium C1100 Compute Adaptor Installation Guide 20
Send Feedback