Updated operating system. Card Interfaces and Details Clarified description. XRT and Deployment Platform Installation Procedures on RedHat and CentOS Updated installation steps for the Alveo U200 and U250 cards. XRT and Deployment Package Installation Procedures on Ubuntu Running lspci Updated output log.
Page 3
Added appendix. 08/18/2020 Version 1.6 Card Features Updated information. XRT and Deployment Package Installation Procedures on Added a link to Xilinx Answer Record 75294. Ubuntu xbutil validate Added a note about installing XRT on Ubuntu. Appendix E: Regulatory and Compliance Information Added appendix.
Page 4
Added new information on upgrading and downgrading deployment software. Known Issues Updated known issues. Appendix B: Creating a Vault Repository for CentOS Added new appendix. 10/02/2018 Version 1.0 Initial Xilinx release. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Installation procedures for the U200 and U280, as well as all other platforms on the U250 Alveo data center accelerator cards, must follow the instructions in v1.5 of Getting 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 ®...
Chapter 1: Introduction Card Features Features of the production 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+ UltraScale+ UltraScale+ XCU200-2FSGD2104E XCU250-2LFIGD2104E XCU280-L2FSVH2892E DDR4 64 gigabyte (GB)
U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963). Qualified Servers A list of servers on which Alveo cards are fully qualified on can be found here: https:/ /www.xilinx.com/products/boards-and-kits/alveo/qualified-servers.html. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
WARNING! Hazardous moving parts. Keep away from fan blades. ATTENTION! Pièces mobiles peuvent etre dangereuses. Éloignez-vous des lames du ventilateur. WARNUNG! Gefährliche bewegliche Teile. Halten sie sich von Lüfterflügeln fern. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
For card specifications, 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).
Page 12
Chapter 2: Accelerator Card Overview Figure 2: Active Cooled Card Configuration Figure 3: Passive Cooled Card Configuration UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
• Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen. • Ziehen sie vor dem Öffnen der Computer / Systemabdeckung das Netzkabel ab. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 14
• Put the card down only on an antistatic surface such as the bag supplied in your kit. • If you are returning the card to Xilinx Product Support, place it back in its antistatic bag immediately. Attention aux Décharge Électrostatique (ESD) L'ESD peut endommager les composants électroniques lorsqu'ils sont mal manipulés, et peut...
• Legen sie die Karte nur auf einer antistatischen Oberfläche ab, z.B. dem antistatischen Beutel der mit dem Kit mitgeliefert wurde. • Wenn sie die Karte an den Xilinx Product Support zurücksenden, legen Sie sie bitte sofort wieder in den antistatischen Beutel.
Page 16
(“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 installation. Consult your computer documentation for additional information.
Page 17
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 figure. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 18
12V source, and 75 Watts from the 6-pin AUX connector). 215W is available with the 8-pin connector (65 Watts from PCIe connector 12V source, and 150 Watts from the 8-pin AUX connector). UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 19
For more information, see Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963). UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 20
If the card is successfully installed and found by the operating 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...
If you encounter any issues during installation, see Chapter 7: Troubleshooting Known Issues. See Xilinx Answer Record 71752 for additional known issues. IMPORTANT! Root access is required for all software and firmware installations. IMPORTANT! L'accès Root est requis pour toutes les installations logicielles et firmware.
Page 22
After installing the deployment platform 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> Alternatively, you can install the five deployment platform installation packages individually.
Page 23
7. Flash the base firmware to the Alveo card 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> The following command, described in Appendix D: Obtaining xbmgmt Command Options, can be used for obtaining the base_name and card_bdf command options.
Page 24
Status: shell is up-to-date Card(s) up-to-date and do not need to be flashed. 11. Program the shell partition using the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> --card <card_bdf> Use the following command, described in Appendix D: Obtaining xbmgmt Command Options, for obtaining the card_bdf and shell_name options.
$ sudo apt install ./xilinx*.deb After installing the deployment platform 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> UG1301 (v1.8) February 5, 2021 www.xilinx.com...
Page 26
4. Flash the base firmware to the Alveo card 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> The following command, described in Appendix D: Obtaining xbmgmt Command Options, can be used for obtaining the base_name and card_bdf command options.
Page 27
7. Flash the Satellite Controller (SC) firmware to the Alveo card using the same command to flash the base firmware. It has the following format: $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --card <card_bdf> Appendix D: Obtaining xbmgmt Command Options for obtaining the command options.
Page 28
Appendix D: Obtaining xbmgmt Command Options, for obtaining the card_bdf and shell_name options. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --scan After programming the shell, an output similar to the following example will be displayed. Programming PLP on Card [0000:65:00.0]... Partition file: /opt/xilinx/firmware/u250/gen3x16/xdma-shell/ partition.xsabin...
Set the environment to use the utilities 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 1.
1. Display the base firmware running on the card by entering the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --scan For each card in the server, you will see an output similar to the following example.
Page 32
2. Enter the following command to program the shell partition on the FPGA. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> --card <card_bdf> where <shell_name> is the name of the shell partition to be programmed to the card identified with BDF <card_bdf>.
After the shell partition is programmed, it is not necessary to reprogram it unless the system is warm or cold rebooted. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name <shell_name> -- card <card_bdf>...
Page 34
INFO: == Starting AUX power connector check: INFO: == AUX power connector check PASSED INFO: == Starting Power warning check: INFO: == Power warning check PASSED INFO: == Starting PCIE link check: UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 35
INFO: == Starting verify kernel test: Verify xclbin not available. Skipping validation. INFO: == verify kernel test SKIPPED INFO: Card[0] validated successfully. INFO: All cards validated successfully. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
What you have done so far allows you to deploy and run accelerated applications on your system. Alveo™ Accelerated Solutions page provides information and links to available Xilinx and third-party accelerated applications. These include video processing, financial computing, machine learning, and data analytics.
Check if the card shows up by typing the following Linux command: lspci -vd 10ee: Card not compatible with server. Use qualified server. See Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) for system compatibilities. Maintenance USB cable attached.
Run time fails with following message: Failed to source the setup.sh script. Source /opt/xilinx/xrt/setup.sh Error: Failed to find Xilinx platform When installing the XRT, you see the This is caused by running sudo apt The XRT will install correctly, despite following message: the error.
Page 39
If the red LED is still illuminated, disconnect the power to the sever for 5 minutes and repeat the step above. UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Alveo packages. To list all currently installed platform packages, run the following command in a Linux terminal: $ yum list installed | grep xilinx To list the currently installed XRT package, run the following command: $ yum list installed | grep xrt Upgrade The following steps require XRT 2019.2 or later to be installed.
Alveo packages. To list all currently platform packages, run the following command in a Linux terminal: $ apt list --installed | grep xilinx To list the currently installed XRT package, run the following command: $ apt list --installed | grep xrt UG1301 (v1.8) February 5, 2021...
Page 42
To completely uninstall the Alveo XRT and installed deployment platform packages, run the following command in a Linux terminal. Uninstalling XRT also uninstalls the deployment platform. $ sudo apt remove xrt UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 44
"7.4.1708" with "7.5.1804". Similarly, for CentOS 7.6, create the repo file /etc/ yum.repos.d/centos76.repo and add the previously listed content, replacing "7.4.1708" with "7.6.1810". UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
IMPORTANT! If the GOLDEN_2 image is running on the FPGA, carefully review the design advisory for Alveo data center accelerator card golden corruption, found in the Xilinx Answer Record AR-71915. Complete the repair instructions associated with the Xilinx Answer prior to proceeding.
Page 46
WICHTIG! Wenn das GOLDEN_2-Image auf dem FPGA ausgeführt wird, lesen Sie die Designempfehlung zur Goldenen Beschädigung der Alveo Data Center-Beschleunigerkarte unter Xilinx Answer Record AR-71915. Führen Sie die mit der Xilinx Answer verbundenen Reparaturanweisungen aus, bevor Sie fortfahren. UG1301 (v1.8) February 5, 2021 www.xilinx.com...
This section describes how to obtain the xbmgmt command options necessary for flashing the base partition and programming the shell partition. The following command is used to flash the base partition. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <base_name> --card <card_bdf> The following command is used to program the shell partition.
Page 48
0000:65:00.0. Using the command options from the previous example, the command for flashing the base is as follows, $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell xilinx_u250_gen3x16_base_3 --card 0000:65:00.0 and the command for programming the shell is as follows. $ sudo /opt/xilinx/xrt/bin/xbmgmt partition --program --name xilinx_u250_gen3x16_xdma_shell_3_1 --card 0000:65:00.0...
Safety IEC 60950-1, 2nd Edition, 2014, Information technology equipment – Safety, Part 1: General requirements UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Xilinx has met its national obligations to the EU WEEE Directive by registering in those countries to which Xilinx is an importer. Xilinx has also elected to join WEEE Compliance Schemes in some countries to help manage customer returns at end-of-life.
• On Windows, select Start → All Programs → Xilinx Design Tools → DocNav. • At the Linux command prompt, enter docnav. Xilinx Design Hubs provide links to documentation organized by design tasks and other topics, which you can use to learn key concepts and address frequently asked questions. To access the Design Hubs: •...
(including loss of data, profits, goodwill, or any type of loss or damage suffered as a result of any action brought by a third party) even if such damage or loss was reasonably foreseeable or Xilinx UG1301 (v1.8) February 5, 2021 www.xilinx.com...
Page 53
IP cores may be subject to warranty and support terms contained in a license issued to you by Xilinx. Xilinx products are not designed or intended to be fail-safe or for use in any application requiring fail-safe performance; you assume sole risk and liability for...
Need help?
Do you have a question about the Alveo U200 and is the answer not in the manual?
Questions and answers