Xilinx Alveo U200 Getting Started

Xilinx Alveo U200 Getting Started

Data center accelerator cards
Hide thumbs Also See for Alveo U200:

Advertisement

Quick Links

Getting Started with Alveo
Data Center Accelerator
Cards
UG1301 (v1.8) February 5, 2021

Advertisement

Table of Contents
loading

Summary of Contents for Xilinx Alveo U200

  • Page 1 Getting Started with Alveo Data Center Accelerator Cards UG1301 (v1.8) February 5, 2021...
  • Page 2: Revision History

    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...
  • Page 5: Table Of Contents

    Chapter 6: Next Steps ....................36 Chapter 7: Troubleshooting ..................37 Known Issues..........................38 Appendix A: Changing XRT and Target Platform Versions ....40 RedHat and CentOS........................40 UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 6 ......49 CE Directives..........................49 CE Standards..........................49 Compliance Markings....................... 50 Appendix F: Additional Resources and Legal Notices ......51 Xilinx Resources.........................51 Documentation Navigator and Design Hubs.................51 References..........................52 Please Read: Important Legal Notices................... 52 UG1301 (v1.8) February 5, 2021 www.xilinx.com Send Feedback...
  • Page 7: Chapter 1: Introduction

    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 ®...
  • Page 8: Card Features

    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)
  • Page 9: Qualified Servers

    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...
  • Page 10: Chapter 2: Accelerator Card Overview

    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...
  • Page 11: Passive And Active Cooling 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...
  • Page 13: Chapter 3: Card Installation Procedures

    • 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...
  • Page 15: Before You Begin

    • 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...
  • Page 21: Chapter 4: Installing The Deployment Software

    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.
  • Page 25: Xrt And Deployment Package Installation Procedures On Ubuntu

    $ 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...
  • Page 29: Chapter 5: Card Bring-Up And Validation

    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.
  • Page 30: Running Xbmgmt Flash --Scan

    See https:/ /xilinx.github.io/XRT/master/html/ platforms.html for additional details. 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]...
  • Page 31: Running Xbmgmt Partition

    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>.
  • Page 33: Xbutil Validate

    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...
  • Page 36: Chapter 6: Next Steps

    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.
  • Page 37: Chapter 7: Troubleshooting

    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.
  • Page 38: Known Issues

    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...
  • Page 40: Appendix A: Changing Xrt And Target Platform Versions

    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.
  • Page 41: Ubuntu

    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 43: Appendix B: Creating A Vault Repository For Centos

    [C7.4.1708-extras] name=CentOS-7.4.1708 - Extras baseurl=http://vault.centos.org/7.4.1708/extras/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-centosplus] name=CentOS-7.4.1708 - CentOSPlus baseurl=http://vault.centos.org/7.4.1708/centosplus/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-fasttrack] name=CentOS-7.4.1708 - CentOSPlus baseurl=http://vault.centos.org/7.4.1708/fasttrack/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 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...
  • Page 45: Appendix C: Reverting The Card To Factory Image

    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...
  • Page 47: Appendix D: Obtaining Xbmgmt Command Options

    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...
  • Page 49: Appendix E: Regulatory And Compliance Information

    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...
  • Page 50: Compliance Markings

    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.
  • Page 51: Appendix F: Additional Resources And Legal Notices

    • 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: •...
  • Page 52: References

    (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...

This manual is also suitable for:

Alveo u250Alveo u280

Table of Contents