Page 1
Cards User Guide UG1301 (v2.2) August 19, 2022 Xilinx is creating an environment where employees, customers, and partners feel welcome and included. To that end, we’re removing non- inclusive language from our products and related collateral. We’ve launched an internal initiative to remove language that could exclude people or reinforce historical biases, including terms embedded in our software and IPs.
Chapter 6: Next Steps ....................35 Chapter 7: Troubleshooting ..................36 Appendix A: Programming the Shell Partition for DFX-2RP Platforms ........................37 Appendix B: Regulatory and Compliance Information ......39 UG1301 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 3
CE Directives..........................39 CE Standards..........................39 Compliance Markings....................... 40 Appendix C: Additional Resources and Legal Notices ......41 Xilinx Resources.........................41 Documentation Navigator and Design Hubs.................41 References..........................42 Revision History......................... 42 Please Read: Important Legal Notices................... 46 UG1301 (v2.2) August 19, 2022 www.xilinx.com...
Chapter 1: Introduction Chapter 1 Introduction This document provides hardware and software installation procedures for Xilinx ® Alveo™ data center accelerator cards U200/U250/U280 and applies to DFX-1RP and DFX-2RP platforms and XRT 2021.1 and greater. For DFX-1RP and DFX-2RP platform features and types for your Alveo card, see Alveo Data Center Accelerator Card Platforms User Guide (UG1120).
Chapter 2: Accelerator Card Overview Chapter 2 Accelerator Card Overview 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+™...
225W via PCI Express Slot connection and 8-pin PCI Express Auxiliary Power cable. Operating System For the latest OS support, see Xilinx Runtime for Alveo Data Center Accelerator Cards - Master Release Notes and Known Issues. System Memory For deployment installations, a minimum of 16 GB plus application memory requirements is required.
Page 7
Micro-USB Interface Note: On the Alveo U280 card, the micro-USB is located on the opposite end of the card between the PCB board and the enclosure. UG1301 (v2.2) August 19, 2022 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 9
Chapter 2: Accelerator Card Overview Figure 3: Passive Cooled Card Configuration UG1301 (v2.2) August 19, 2022 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 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 11
• 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 13
(“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 14
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 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 15
PCIe Auxiliary Power or VGA. These connector configurations are not pin compatible with other power source types. Do not force a connection to any power source other than PCIe Auxiliary Power. See Xilinx Answer Record 72298 for more information.
Page 16
Note: 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 17
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...
All installation packages can be downloaded from the Getting Started tab of the respective Alveo card landing page: • Alveo U200 Product Page • Alveo U250 Product Page • Alveo U280 Product Page Note: Select the Vitis Design Flow tool version 2021.1 or greater.
3. After the previous command completes, reboot your machine. 4. Download both the XRT and deployment platform installation packages associated with your card from the Getting Started tab on the respective Alveo card product page: • Alveo U200 Product Page • Alveo U250 Product Page •...
Page 20
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> With XRT 2021.1 or greater, it is necessary to use the following new command to flash the card rather than the one displayed in the above message.
Page 21
11. Update the SC firmware on the card. Run the following command to update the SC firmware on the card. It is the identical command used to flash the platform firmware on the card. $ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF>...
Page 22
12. For DFX-1RP platforms the installation for deployment is complete. For DFX-2RP platforms, it is necessary to program the shell partition file with path. Use the following command to program the shell partition: $ sudo /opt/xilinx/xrt/bin/xbmgmt program --device <management BDF> --shell <partition file with path> Refer to...
2. After the previous command completes, reboot your machine. 3. Download both the XRT and deployment platform installation packages associated with your card from the Getting Started tab on the respective Alveo card product page: • Alveo U200 Product Page • Alveo U250 Product Page •...
Page 24
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> With XRT 2021.1 or greater, it is necessary to use the following new command to flash the card rather than the one displayed in the above message.
Page 25
10. Update the SC firmware on the card. Run the following command to update the SC firmware on the card. It is the identical command used to flash the platform firmware on the card. $ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF>...
Page 26
11. For DFX-1RP platforms the installation for deployment is complete. For DFX-2RP platforms, it is necessary to program the shell partition. Use the following command to program the shell partition: $ sudo /opt/xilinx/xrt/bin/xbmgmt program --device <management BDF> -- shell <partition file with path>...
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 UG1301 (v2.2) August 19, 2022...
See Displaying Card BDF Values to obtain the device management BDF. $ sudo /opt/xilinx/xrt/bin/xbmgmt examine --device <management BDF> In the following example output, the platform (xilinx_u200_gen3x16_xdma_base_1) and SC Version (4.6.18) displayed under Flashable partitions running on FPGA and Flashable partitions installed in system both match.
Page 30
FPGA and Flashable partitions installed in system confirm they match. See Displaying Card BDF Values to obtain the device management BDF. $ sudo /opt/xilinx/xrt/bin/xbmgmt examine --report platform --device <management BDF> In the following example output, the platform (xilinx_u250_gen3x16_base_3, xilinx_u250_gen3x16_xdma_shell_3_1) and SC Version (4.6.11) displayed under Flashable partitions running on FPGA and Flashable partitions installed in system both match.
(i.e., Peer-2-Peer). Use the following command to run the card validation test: $ /opt/xilinx/xrt/bin/xbutil validate --device <user BDF> --verbose where user BDF is the card to be validated. See Displaying Card BDF Values to obtain the user BDF value.
Page 32
: Check if SC firmware is up-to-date Test Status : [PASSED] ---------------------------------------------------------------------------- Test 4 [0000:02:00.1] : Verify kernel Description : Run 'Hello World' kernel test Xclbin : /opt/xilinx/firmware/u200/gen3x16-xdma/base/ test/verify.xclbin Testcase : /opt/xilinx/xrt/test/validate.exe Test Status : [PASSED] ---------------------------------------------------------------------------- Test 5 [0000:02:00.1] : DMA...
Page 33
Unsupported tests [1 device(s)] - [0000:02:00.1] : xilinx_u200_gen3x16_xdma_base_1 : Test(s): 'Peer to peer bar', 'Host memory bandwidth test', vcu Note: The DMA bandwidth can vary depending upon NUMA/CPU affinity. UG1301 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 34
: Verify kernel Description : Run 'Hello World' kernel test Details : Verify xclbin not available or shell partition is not programmed. Skipping validation. Test Status : [SKIPPED] UG1301 (v2.2) August 19, 2022 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.
For card installation support, debugging information, and known issues, see the Alveo Card Debug Guide. For known issues and general information, see Xilinx Answer Record 71752. UG1301 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Dynamic Function Exchange in XRT Documentation. Use the following command to program the shell partition: $ sudo /opt/xilinx/xrt/bin/xbmgmt program --device <management BDF> --shell <partition file with path> Displaying Card BDF Values to obtain the management BDF. Use the following command to get the partition file with path.
Page 38
Appendix A: Programming the Shell Partition for DFX-2RP Platforms The following is an example of the command for programing the shell partition and the output: $ sudo /opt/xilinx/xrt/bin/xbmgmt program --device 03:00.0 --shell /lib/ firmware/xilinx/bd5fb8abab266c3265918257b5048e88/partition.xsabin Programming shell on device [0000:03:00.0]... Partition file: /lib/firmware/xilinx/bd5fb8abab266c3265918257b5048e88/ partition.xsabin...
Safety IEC 60950-1, 2nd Edition, 2014, Information technology equipment – Safety, Part 1: General requirements UG1301 (v2.2) August 19, 2022 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: •...
3. Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400) 4. Vitis Application Acceleration Development Flow Tutorials (GitHub) Alveo Documents 1. Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) 2. Alveo Card Debug Guide (XD027) 3. Alveo Data Center Accelerator Card Platforms User Guide (UG1120) 4.
Page 43
Minimum System Requirements Updated to reflect the latest OS support. Before You Begin Added a link to Xilinx Answer Record 72298. Installing the Card Added a link to Xilinx Answer Record 72298. Chapter 4: Installing the Deployment Software Updated to include references to xbutil and xbmgmt utilities.
Page 44
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 45
Qualified Servers Updated table of validated servers. Card Interfaces and Details Added information on status LEDs. Installing the Card Added image of an installed Alveo card. UG1301 (v2.2) August 19, 2022 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
(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 UG1301 (v2.2) August 19, 2022...
Page 47
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...