Xilinx Alveo U200 Getting Started

Xilinx Alveo U200 Getting Started

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

Advertisement

Getting Started with Alveo
Data Center Accelerator
Cards
UG1301 (v1.5) June 3, 2020

Advertisement

Table of Contents
loading

Summary of Contents for Xilinx Alveo U200

  • Page 1 Getting Started with Alveo Data Center Accelerator Cards UG1301 (v1.5) June 3, 2020...
  • Page 2: Revision History

    Upgrade from 2018.x to 2019.1 in Ubuntu Downgrade from 2018.3 to 2018.2 in RedHat and CentOS Chapter 1: Introduction 06/27/2019 Version 2019.1 Qualified Servers Updated server requirements. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 3 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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 4: Table Of Contents

    Known Issues..........................33 Appendix A: Changing XRT and Target Platform Versions ....35 RedHat and CentOS........................35 Ubuntu............................41 Appendix B: Creating a Vault Repository for CentOS .......48 UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 5 ........50 Appendix D: Generating the xbmgmt flash --update Command ..51 Appendix E: Additional Resources and Legal Notices ......53 Xilinx Resources.........................53 Documentation Navigator and Design Hubs.................53 References..........................54 Please Read: Important Legal Notices................... 54 UG1301 (v1.5) June 3, 2020 www.xilinx.com...
  • Page 6: Chapter 1: Introduction

    With the card installed, developers can debug applications in both emulation modes and on the hardware. Card Features Features of the Alveo U200/U250/U280 data center accelerator cards are listed in the following table. UG1301 (v1.5) June 3, 2020 www.xilinx.com...
  • Page 7: Minimum System Requirements

    Chapter 1: Introduction 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) 32 gigabyte (GB) 4x DDR4 16 GB 2x DDR4 16 GB 2400 mega-transfers per second (MT/s), 64-bit with error correcting code (ECC) DIMM x4/x8 unregistered dual inline memory module (UDIMM) support ✓...
  • Page 8: 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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 9: Chapter 2: Unpacking

    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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 10 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 11 Chapter 2: Unpacking Figure 2: Active Cooled Card Configuration Figure 3: Passive Cooled Card Configuration UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 12: Chapter 3: Card Installation Procedures

    • Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen. • Ziehen sie vor dem Öeffnen der Computer / Systemabdeckung das Netzkabel ab. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 13 • 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 14: 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 15: Installing The Card

    (“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 16 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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 17 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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 18 WARNING! Do not power-on a passively cooled card without adequate forced airflow across the card with proper airflow direction, otherwise the card can be damaged. 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).
  • Page 19 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 U200 card: 65:00.0 Processing accelerators: Xilinx Corporation Device d000...
  • Page 20: 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 21 4. Download both the XRT and deployment platform installation packages associated with your card from the Getting Started tab in one of the following locations: • Alveo U200 Product Page • Alveo U250 Product Page UG1301 (v1.5) June 3, 2020 www.xilinx.com...
  • Page 22 $ sudo yum install ./xilinx-<card>-<version>.rpm The deployment software sources are now installed on the system. The installation of the drivers, runtime software, and utilities are in the /opt/xilinx/ directory and contains the xrt and dsa sub-directories. The dsa folder contains the deployment platform installation.
  • Page 23 The installation for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up and Validation to validate the installation. Related Information Creating a Vault Repository for CentOS Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 24: Xrt And Deployment Package Installation Procedures On Ubuntu

    Befehlen entsprechend den heruntergeladenen Paketen aktualisieren. 1. Download both the XRT and deployment installation packages associated with your card from the Getting Started tab in one of the following locations: • Alveo U200 Product Page • Alveo U250 Product Page •...
  • Page 25 The deployment software sources are now installed and deployed on the system. The installation of the drivers, runtime software, and utilities are in the /opt/xilinx/ directory and contains the xrt and dsa sub-directories. Note that the dsa folder contains the deployment platform installation.
  • Page 26 The installation for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up and Validation to validate the installation. Related Information Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 27: Chapter 5: Card Bring-Up And Validation

    • xbutil validate The lspci Linux command is used to validate the card as seen by the OS, as was done when installing the card. The second and third commands use the Xilinx ® xbmgmt and xbutil utilities, that are included during the XRT package installation.
  • Page 28: Running Xbmgmt Flash --Scan

    See https:/ /xilinx.github.io/XRT/master/html/ platforms.html for additional details. 03:00.0 Processing accelerators: Xilinx Corporation Device 5020 Subsystem: Xilinx Corporation Device 000e Physical Slot: 4 Flags: bus master, fast devsel, latency 0, NUMA node 0 Memory at d2000000 (64-bit, prefetchable) [size=32M]...
  • Page 29: Xbutil Validate

    DMA test - Data transfer between host and card memory through PCIe. b. Memory test - Data transfer between kernels and card memory. The validate command has the format: xbutil validate -d <card_bdf> UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 30 Run the validate command shown below: $ /opt/xilinx/xrt/bin/xbutil validate If the card was installed correctly, you will see a high-level summary of the tests performed similar to the following output. If the output is not similar to the one shown below, see Chapter Troubleshooting.
  • Page 31: 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 32: 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 33: 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 34 It is necessary to upgrade pip and python using the following commands encountered during XRT installation. prior to installing XRT. sudo pip install --upgrade sudo python -m pip install numpy UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 35: 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 UG1301 (v1.5) June 3, 2020...
  • Page 36 If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
  • Page 37 If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
  • Page 38 $ sudo /opt/xilinx/xrt/bin/xbutil flash scan If the package does not match, try to install the deployment shell package again. If the SC field for Shell running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
  • Page 39 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 at Xilinx Answer Record AR-71915. Complete the repair instructions associated with the Xilinx Answer prior to proceeding.
  • Page 40 If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
  • 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 Upgrade from 2018.2 to 2018.3 in Ubuntu...
  • Page 42 If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
  • Page 43 If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash -a all 6.
  • Page 44 $ sudo /opt/xilinx/xrt/bin/xbutil flash scan If the package does not match, try to install the deployment shell package again. If the SC field for Shell running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
  • Page 45 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 at Xilinx Answer Record AR-71915. Complete the repair instructions associated with the Xilinx Answer prior to proceeding.
  • Page 46 Appendix A: Changing XRT and Target Platform Versions 8. Flash the firmware to the Alveo card. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update 9. To load the new firmware image on the FPGA, cold boot the machine. 10. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match.
  • Page 47 If not, manually list the packages using the list command at the beginning of this section, then delete the remaining packages using the remove command. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 48: 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.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 49 Note: For CentOS 7.5, create the repo file /etc/yum.repos.d/centos75.repo and add the above content, replacing "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 above content, replacing "7.4.1708" with "7.6.1810". UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 50: Appendix C: Reverting The Card To Factory Image

    1. Open a terminal window. 2. Run the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 3. Enter y to continue. The following message is displayed on completion. Shell is reset succesfully Cold reboot machine to load new shell on card 4.
  • Page 51: Appendix D: Generating The Xbmgmt Flash --Update Command

    To flash the firmware installed in the system to the Alveo™ card, use the xbmgmt flash -- update command. The format of the xbmgmt flash --update command is: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <shell_name> --card <card_bdf> To obtain the necessary card_bdf and shell_name options, run the following xbmgmt flash --scan command.
  • Page 52 IMPORTANT! Utilisez une commande xbmgmt flash distincte pour faire flasher chaque carte du système. WICHTIG! Verwenden Sie einen separaten xbmgmt flash-Befehl, um jede Karte im System zu flashen. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 53: Appendix E: 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 54: References

    The information disclosed to you hereunder (the "Materials") is provided solely for the selection and use of Xilinx products. To the maximum extent permitted by applicable law: (1) Materials are made available "AS IS" and with all faults, Xilinx hereby DISCLAIMS ALL WARRANTIES AND...
  • Page 55 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