Xilinx Alveo U200 Getting Started Manual
  1. Manuals
  2. Brands
  3. Xilinx Manuals
  4. PCI Card
  5. Alveo U200
  6. Getting started manual

Xilinx Alveo U200 Getting Started Manual

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

Advertisement

Quick Links

Download this manual
Getting Started with Alveo
Data Center Accelerator
Cards
UG1301 (v1.3) February 12, 2019

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Alveo U200 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Xilinx Alveo U200

Summary of Contents for Xilinx Alveo U200

  • Page 1 Getting Started with Alveo Data Center Accelerator Cards UG1301 (v1.3) February 12, 2019...

  • Page 2: Revision History

    Deployment Shell on Ubuntu 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 3: Table Of Contents

    Running xbutil flash scan......................36 xbutil validate..........................37 Chapter 6: Installing the Development Software ........39 Chapter 7: Troubleshooting ..................40 Known Issues..........................41 Appendix A: Required Dependencies ..............43 UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 4 Appendix B: Creating a Vault Repository for CentOS .......45 Appendix C: Generating the xbutil flash Command ......... 47 Appendix D: Additional Resources and Legal Notices ......49 Xilinx Resources.........................49 Documentation Navigator and Design Hubs.................49 References..........................50 Please Read: Important Legal Notices................... 50 UG1301 (v1.3) February 12, 2019 www.xilinx.com...

  • Page 5: Chapter 1: Introduction

    Xilinx runtime (XRT) and a deployment shell. The development software allows you to compile and debug acceleration applications, and it consists of the development shell and the SDAccel™...

  • Page 6: Minimum System Requirements

    For the application development environment, see SDAccel Environment Release Notes, Installation, and Licensing Guide (UG1238). For details on the acceptable environmental conditions, see Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963).
  • Page 7 SuperMicro SYS-7049GP-TRT Notes: Servers listed are validated on U200/U250 production and U280 ES1 accelerator cards. Validation with U280 production cards will complete at a future date. UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 8: Chapter 2: Unpacking

    Chapter 2: Unpacking Chapter 2 Unpacking Product Registration IMPORTANT! To receive updates, register your product at https:/ /www.xilinx.com/products/design- tools/software-zone/sdaccel.html#gettingstarted. IMPORTANT! Pour recevoir les mises à jour, enregistrez votre produit sur https:/ /www.xilinx.com/ products/design-tools/software-zone/sdaccel.html#gettingstarted. Wichtig! Um Updates zu erhalten, registrieren Sie ihr Produkt unter https:/ /www.xilinx.com/...
  • Page 9 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 10 Chapter 2: Unpacking Active Cooled Card Configuration Figure 2: Passive Cooled Card Configuration Figure 3: UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 11: 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 12 • 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 13: 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 14 (“hot-plug” n'est pas autorisé). Wichtig! Trennen Sie den Alveo™-Stromanschluss Karten Alveo im eingeschalteten Zustand nicht (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 15 Figure 4: 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 16 Wichtig! Mit dem 6-poligen Stecker stehen nur 150 W zur Verfügung. Die vollen 225W stehen mit dem 8-poligen Stecker zur Verfügung. The following figures show examples of the various connector types: UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 17 8-pin power supply socket, leaving the two leftmost pins unused, as identified by the red box in the following figures. Example of 6-Pin PCIe Aux Power Connector Figure 7: UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 18 Do not power-on a passively cooled card without adequate forced airflow across the card, 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 Chapter 3: Card Installation Procedures For Alveo U200: 03:00.0 Processing accelerators: Xilinx Corporation Device d000 Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, IRQ 11, NUMA node 0 Memory at f6000000 (32-bit, non-prefetchable) [size=32M] Memory at f8000000 (32-bit, non-prefetchable) [size=64K]...

  • Page 20: Chapter 4: Installing The Deployment Software

    Ubuntu operating systems. All software installations use standard Linux RPM and Linux DEB packages. The deployment software installation requires installing the following software packages: • Xilinx ® runtime (XRT) XRT provides the libraries and drivers for an application to run on Alveo™ cards.
  • Page 21 Vault repository. For more information, see Appendix B: Creating a Vault Repository for CentOS 3. After the above command finishes running, reboot your machine. 4. Download both the Xilinx ® runtime (XRT) and deployment shell installation packages associated with your card from the Getting Started tab in one of the following locations: •...
  • Page 22 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. Note that the dsa folder contains the deployment shell installation.

  • Page 23: Xrt And Deployment Shell Installation Procedures On Ubuntu

    Use the following steps to download and install the software using an RPM installation package. For details on upgrading or downgrading the XRT and deployment shell, see Upgrading, Downgrading, and Uninstalling XRT and Deployment Shell on Ubuntu. UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 24 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 shell installation.
  • Page 25 The -a and -t options specify the deployment shell name and timestamp associated with the specific card ID. sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> CAUTION! Not specifying the card ID within the xbutil flash command via the -d option can result in damage to the card.

  • Page 26: Upgrading, Downgrading, And Uninstalling Xrt And Deployment Shell On Redhat And Centos

    To list the currently installed deployment shell package, 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 Upgrading Packages You can upgrade the XRT and deployment shell on your Alveo card by following these steps.
  • Page 27 The -a and -t options specify the deployment shell name and timestamp associated with the specific card ID. sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> To generate the xbutil flash command, follow the instructions in...
  • Page 28 4. Manually generate the xbutil flash command by following the instructions in Appendix C: Generating the xbutil flash Command. sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> Note Not specifying the card ID within the xbutil flash command via the -d option can result in damage to the card.
  • Page 29 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 30: Upgrading, Downgrading, And Uninstalling Xrt And Deployment Shell On Ubuntu

    To list the currently installed deployment shell package, 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 Upgrading Packages You can upgrade the XRT and deployment shell on your Alveo card by following these steps.
  • Page 31 The -a and -t options specify the deployment shell name and timestamp associated with the specific card ID. sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> To generate the xbutil flash command, follow the instructions in...
  • Page 32 4. Manually generate the xbutil flash command by following the instructions in Appendix C: Generating the xbutil flash Command. sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> Note Not specifying the card ID within the xbutil flash command via the -d option can result in damage to the card.
  • Page 33 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 34: Chapter 5: Card Bring-Up And Validation

    Installing the Card when verifying that the ® hardware was installed correctly. In this section, lspci and the Xilinx xbutil utility are used to validate a successful hardware and software setup. The second and third commands use the xbutil utility, which is included during the XRT package installation.
  • Page 35 Note that for each card, there will be two different devices found: one for management and one for user. • For U200: 65:00.0 Processing accelerators: Xilinx Corporation Device 5000 Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, NUMA node 0...

  • Page 36: Running Xbutil Flash Scan

    Capabilities: [410] #15 Kernel driver in use: xocl_xdma Kernel modules: xocl • For U280 ES: 65:00.0 Serial controller: Xilinx Corporation Device 5009 (prog-if 01 [16450]) Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, IRQ 191, NUMA node 0...

  • Page 37: Xbutil Validate

    DDR test - Data transfer between kernels and FPGA DDR. For U280-ES, two channels of FPGA DDR and two channels of FPGA HBM are exercised. UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 38 Chapter 5: Card Bring-Up and Validation To run the validate command, enter the following: $ sudo /opt/xilinx/xrt/bin/xbutil validate If the card was installed correctly, you will see a message similar to the following output. If the output is not similar to the one shown below, review Chapter 7: Troubleshooting.

  • Page 39: Chapter 6: Installing The Development Software

    Development software installation instructions can be found in SDAccel Environments Release Notes, Installation, and Licensing Guide (UG1238). For complete details on the development flow and getting started in SDAccel, see the SDAccel Environment User Guide (UG1023). UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 40: 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 41: 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 XRT, you see the This is caused by running sudo apt The XRT will install correctly, despite following message: the error.
  • Page 42 Or the card is not present when running lspci xbutil xbutil commands do not work. There Reinstall the XRT package. are no errors indicating this in output. UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 43: Appendix A: Required Dependencies

    The following dependencies are required for XRT and shell installation on Ubuntu systems: Table 6: Required Dependencies for Ubuntu Package Minimum Version ocl-icd-opencl-dev 2.2.0 libboost-dev 1.58 libboost-filesystem-dev 1.58 uuid-dev 2.27.1 UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 44 Appendix A: Required Dependencies Table 6: Required Dependencies for Ubuntu (cont'd) Package Minimum Version dkms 2.2.0 libprotoc-dev 2.6.1 protobuf-compiler 2.6.1 libncurses5-dev lsb-release 2.9.1 libxml2-dev 2.9.1 libyaml-dev 0.1.6 UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 45: 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.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
  • Page 46 Appendix B: Creating a Vault Repository for CentOS Note For CentOS 7.5, create the repo file and add the above /etc/yum.repos.d/centos75.repo content, replacing "7.4.1708" with "7.5.1804". UG1301 (v1.3) February 12, 2019 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...

  • Page 47: Appendix C: Generating The Xbutil Flash Command

    Alveo card. The format of the xbutil flash command is: sudo /opt/xilinx/xrt/bin/xbutil flash -a <shell_name> -t <timestamp> -d <card_ID> To obtain the necessary card ID (-d), shell name (-a), and timestamp (-t) command options, run the following xbutil flash scan command.
  • Page 48 The timestamp is 0x000000005bece8e1. For the example output above, the xbutil flash command is: sudo /opt/xilinx/xrt/bin/xbutil flash -a xilinx_u200_xdma_201830_1 -t 0x000000005bece8e1 -d 0 When the Alveo card is successfully flashed, the xbutil flash scan output will show the same package information for both DSA package installed in FPGA: and DSA package installed in system:.

  • Page 49: Appendix D: 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 50: 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 had been advised of the possibility of the same. Xilinx assumes no obligation to correct any errors contained in the Materials or to notify you of updates to the Materials or to product specifications.
  • Page 51 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