XILINX ALVEO U30 (01) PDF MANUAL


Post questions, comments, reviews or errors in the comment box below.

Your File is Ready … Download PDF

CLICK HERE TO DOWNLOAD XILINX ALVEO U30 (01) PDF MANUAL


PDF Content Summary: Alveo U30 Data Center Accelerator Card Installation and User Guide UG1425 (v1.0) June 16, 2020 Revision History Revision History The following table shows the revision history for this document. Section Revision Summary 06/16/2020 Version 1.0 Initial release. N/A

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 2

Table of Contents Revision History...............................................................................................................2 Chapter 1: Introduction.............................................................................................. 5 Minimum System Requirements...............................................................................................5 Chapter 2: Card Interfaces and Details..............................................................6 Chapter 3: Card Installation Procedures...........................................................7 Safety Instructions...................................................................................................................... 7 Before You Begin.........................................................................................................................9 Installing the Card.....................................................................................................................10 Chapter 4: Installing the Deployment Software.........................................13 FFmpeg Command Usage........................................................................................................15 Chapter 5: Multiple Devices and YAML Configuration.............................17 Chapter 6: Troubleshooting....................................................................................18 Known Issues.............................................................................................................................18 Appendix A: Changing XRT and Target Platform Versions....................20 Ubuntu........................................................................................................................................20 Appendix B: Regulatory and Compliance Information...........................22 Safety Compliance.....................................................................................................................22 EMC Compliance........................................................................................................................22 CE Directives.............................................................................................................................. 23 CE Standards..............................................................................................................................23 Compliance Markings...............................................................................................................24 Other Compliance Statements................................................................................................ 24 Appendix C: Additional Resources and Legal Notices............................. 28 Xilinx Resources.........................................................................................................................28 Documentation Navigator and Design Hubs.........................................................................28 UG1425 (v1.0) June 16, 2020 xilinx.com U30 Installation and User Guide 3 Send Feedback References..................................................................................................................................28 Please Read: Important Legal Notices................................................................................... 29 UG1425 (v1.0) June 16, 2020 xilinx.com U30 Installation and User Guide 4 Send Feedback Chapter 1: Introduction UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 5 Chapter 1 Introduction This document provides hardware and software installation procedures for the AlveoTM U30 Data Center accelerator card. The half-height, half-length U30 Alveo data center accelerator card has a bifurcated Gen3 x8 to form two independent Gen3 x4 PCI Express® (PCIe) compliant interfaces. It features two Zynq® UltraScale+TM MPSoCs to accelerate HD video transcoding and analytics. It targets high density video transcoding application, capable of decoding, scaling, and encoding up to eight 1080p60 streams. The U30 card provides superb power and cost performance for such video applications. Minimum System Requirements The minimum system requirements for running the AlveoTM U30 Data Center accelerator cards are listed below: Table 1: Minimum System Requirements Component Requirement Motherboard Can be used with either PCI Express®-compliant Gen3x16 or Gen3x8 with x4x4 bifurcation enabled in the BIOS. System Power Supply 75W Operating System Linux, 64-bit: • Ubuntu 16.04 System Memory For deployment installations, a minimum of 16 GB is required. Internet Connection Required for downloading drivers and utilities. Hard disk space Satisfy the minimum system requirements for your operating system. Licensing None required for application deployment. For details on the acceptable environmental conditions, see Alveo U30 Data Center Accelerator Cards Data Sheet (DS970). Chapter 2: Card Interfaces and Details Chapter 2 Card Interfaces and Details The Xilinx® AlveoTM U30 data center accelerator card, shown in the following figure, is a single slot, half-height, half-length, low profile form factor passively-cooled card operating up to a 75W maximum power limit.Figure 1: Alveo U30 Card with Full-Height Bracket For card specifications, dimensions, list of card features, and block diagram, see Alveo U30 Data Center Accelerator Cards Data Sheet (DS970).

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 6

Chapter 3: Card Installation Procedures UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 7 Chapter 3 Card Installation Procedures To reduce the risk of fire, electric shock, or injury, always follow basic safety precautions. CAUTION! You must always use an ESD strap or other antistatic device when handling hardware. ATTENTION! Il est fortement recommandé d'utiliser un bracelet ESD ou autres dispositifs antistatiques. VORSICHT! Beim Umgang mit Hardware müssen sie immer ein Erdungs Armband oder ein anderes antistatisches Gerät verwenden. Safety Instructions Safety Information To ensure your personal safety and the safety of your equipment: • Keep your work area and the computer/server clean and clear of debris. • Before opening the computer/system cover, unplug the power cord. Dispositif de Sécurité Pour assurer votre sécurité personnelle et la sécurité de votre équipement: • Maintenez votre zone de travail et l'ordinateur/serveur propre et dégagé de débris. • Avant d'ouvrir le capot de l'ordinateur/système, débranchez le cordon d'alimentation. Sicherheitsinformation Um ihre persönliche Sicherheit und die Sicherheit ihrer Ausrüstung zu gewährleisten: • Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen. • Ziehen sie vor dem Öeffnen der Computer / Systemabdeckung das Netzkabel ab.

Chapter 3: Card Installation Procedures Electrostatic Discharge Caution Electrostatic discharge (ESD) can damage electronic components when they are improperly handled, and can result in total or intermittent failures. Always follow ESD-prevention procedures when removing and replacing components. To prevent ESD damage: • Use an ESD wrist or ankle strap and ensure that it makes skin contact. Connect the equipment end of the strap to an unpainted metal surface on the chassis. • Avoid touching the card against your clothing. The wrist strap protects components from ESD on the body only. • Handle the card by its bracket or edges only. Avoid touching the printed circuit board or the connectors. • 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 entraîner des défaillances totales ou intermittentes. Suivez toujours les procédures de prévention contre les ESD lors du retrait et remplacement des composants. Pour prévenir les dommages dus aux ESD: • Utilisez une sangle de poignet ou de cheville anti-ESD et assurez-vous qu'elle est en contact avec la peau. Branchez l'extrémité du cable de la sangle à une surface métallique non peinte du châssis et a la masse. • Évitez de mettre en contact la carte de circuit imprimé ou les connecteurs avec vos vêtements. La sangle de poignet protège la carte ou connecteurs contre les ESD du corps seulement. • Manipulez la carte uniquement par son support ou par ses bords. Évitez de toucher la carte de circuit imprimé ou les connecteurs. • Ne posez la carte de circuit imprimé ou les connecteurs que sur une surface antistatique telle que le sac anti-statique fourni avec la carte. • Si vous retournez la carte a Xilinx, remettez-la dans son sac antistatique immédiatement. Vorsicht Elektrostatische Entladung Elektrostatische Entladung (ESD) kann elektronische Bauteile beschädigen, wenn sie unsachgemäß behandelt werden, und es kann zu totalen oder zeitweiligen Ausfällen kommen. Befolgen sie beim Entfernen und Austauschen von Komponenten stets die ESD- Schutzmaßnahmen.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 8

Chapter 3: Card Installation Procedures So verhindern sie ESD-Schäden: • Verwenden sie einen ESD-Handgelenk-oder Knöchelriemen und stellen sie sicher, dass er Hautkontakt hat. Verbinden sie das Ende des Riemens mit einer unlackierten Metalloberfläche am Gehäuse. • Berühren sie die Karte nicht mit ihrer Kleidung. Der Riemen schützt Komponenten nur vor ESD am Körper. • Fassen sie die Karte nur an der Halterung oder an den Kanten an. Berühren sie nicht die Leiterplatte oder die Anschlüsse. • 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. Before You Begin IMPORTANT! AlveoTM cards are delicate and sensitive electronic devices; equipment is to be installed by a qualified technician only. This equipment is intended for installation in a Restricted Access Location. IMPORTANT! Les cartes AlveoTM sont des appareils électronique sensibles et fragiles; l'équipement doit être installé par un technicien certifié seulement. Cet équipement est destiné à être installé dans un lieu d'accès restreint. WICHTIG! Die Karten AlveoTM sind sensible und empfindliche elektronische Geräte. Das Gerät darf nur von einem qualifizierten Techniker installiert werden. Dieses Gerät ist für die Installation an einem Ort mit begrenztem Zugang vorgesehen. • Verify that the minimum card space is available to install your card. Card specifications and dimensions can be found in Alveo U30 Data Center Accelerator Cards Data Sheet (DS970). • Check for card compatibility with the system. Also check for proper system requirements such as power, bus type, and physical dimensions to support the card. Replacing the Bracket The Alveo U30 card can be used with either a full-height or half-height bracket. Depending on your system, it may be necessary to switch between the full and half-height bracket on the card. The bracket is secured to the card with four screws, as shown in the figure below. To replace the bracket, follow the instructions below. 1. Remove screws 1 and 2 from the card. 2. Remove screws 3 and 4 from the card.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 9

Chapter 3: Card Installation Procedures 3. Remove the bracket from the card. 4. Place the new bracket on the card and align it with the card's connectors and screw locations. 5. Replace screws 1 and 2 on the new bracket. 6. Replace screws 3 and 4 on the new bracket. Figure 2: Screw Locations on Bracket Installing the Card The following procedure is a guide for the Xilinx® AlveoTM U30 Data Center accelerator card installation. Consult your computer documentation for additional information. Note: For use with UL Listed Servers or ITE. If you encounter any issues during installation, see Chapter 6: Troubleshooting.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 10

1. Shut down the host computer and unplug the power cord. 2. Open your computer by removing the casing. 3. If necessary, remove the adjacent PCIe® slot cover corresponding to the PCIe slot in which you are installing the Alveo card. 4. Plug the Alveo card into the PCIe x8 or x16 slot on the motherboard. 5. Re-install the computer casing. 6. Connect the power cord and turn on the computer. WARNING! Do not power-on a passively cooled card without adequate forced airflow across the card with proper air flow direction, otherwise the card can be damaged. This card can heat up after use in the server. Use caution when handling. For more information, see Alveo U30 Data Center Accelerator Cards Data Sheet (DS970). 7. To verify that the device has been installed correctly, enter the following Linux command in the terminal: $ sudo lspci -vd 10ee: If the card is successfully installed and found by the operating system, a message similar to the one below will be displayed. There will be two management and two user functions displayed because the U30 card has two Zynq® UltraScale+TM MPSoCs. See xilinx.github.io/XRT/master/html/ platforms.html for additional details. d9:00.0 Processing accelerators: Xilinx Corporation Device 503d (rev 02) Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, IRQ 298, NUMA node 1 Memory at f8000000 (32-bit, non-prefetchable) [size=32M] Memory at fa020000 (32-bit, non-prefetchable) [size=64K] Capabilities: [40] Power Management version 3 Capabilities: [60] MSI-X: Enable+ Count=32 Masked- Capabilities: [70] Express Endpoint, MSI 00 Capabilities: [100] Advanced Error Reporting Capabilities: [1c0] #19 Kernel driver in use: xocl Kernel modules: xocl d9:00.1 Processing accelerators: Xilinx Corporation Device 503c (rev 02) Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, NUMA node 1 Memory at f6000000 (32-bit, non-prefetchable) [size=32M] Memory at fa000000 (32-bit, non-prefetchable) [size=128K] Capabilities: [40] Power Management version 3 Capabilities: [60] MSI-X: Enable+ Count=32 Masked- Capabilities: [70]t Express Endpoint, MSI 00 Capabilities: [100] Advanced Error Reporting Kernel driver in use: xclmgmt Kernel modules: xclmgmt da:00.0 Processing accelerators: Xilinx Corporation Device 503d (rev 02) Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, IRQ 250, NUMA node 1 Memory at f2000000 (32-bit, non-prefetchable) [size=32M] Memory at f4020000 (32-bit, non-prefetchable) [size=64K] Capabilities: [40] Power Management version 3Chapter 3: Card Installation Procedures UG1425 (v1.0) June 16, 2020 xilinx.com U30 Installation and User Guide 11 Send Feedback

Chapter 3: Card Installation Procedures Capabilities: [60] MSI-X: Enable+ Count=32 Masked- Capabilities: [70] Express Endpoint, MSI 00 Capabilities: Capabilities: [100] [1c0] Advanced #19 Error Reporting Kernel driver in use: xocl da:00.1 Kernel modules: Processing xocl accelerators: Xilinx Corporation Device 503c (rev 02) Subsystem: Xilinx Corporation Device 000e Flags: Memory bus at f0000000 master, fast (32-bit, devsel, non-prefetchable) latency 0, NUMA [size=32M] node 1 Memory at f4000000 (32-bit, non-prefetchable) [size=128K] Capabilities: Capabilities: [40] [60] Power MSI-X: Management Enable+ Count=32 version Masked- 3 Capabilities: [70] Express Endpoint, MSI 00 Capabilities: Kernel driver [100] in use: Advanced xclmgmt Error Reporting Kernel modules: xclmgmt If you do not see a similar message, see Chapter 6: Troubleshooting.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 12

Chapter 4: Installing the Deployment Software UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 13 Chapter 4 Installing the Deployment Software This chapter details the procedures for installing deployment software and running the FFmpeg application on the Ubuntu operating system. All software installations use standard Linux DEB packages and require root access. The deployment software consists of the following software packages: Note: <version> will be different for different packages. For example the XRT version string could be different from xcdr. • XRT - Host based Runtime Software Stack: xrt_<version>.deb • XSA File: xsa/<version>.xsabin • MPSoC based Encoder and Decoder XMA Plugins: xmpsoccodecs-<version>.deb • Xilinx Multi-Scaler XMA Plugin: xmultiscaler-<version>.deb • Xilinx Modified FFmpeg 4.1: xffmpeg-<version>.deb • Xilinx MPSoC Transcoding Application (XCDR): xcdr-<version>.deb • Installation Script: install.sh To view more information about a package, enter the following command: $ new dpkg-deb debian --info package, ./xmpsoccodecs-<version_string>.deb version 2.0. ... <snip> Depends: xrt (>= <xrt_version>) Installed-Size: 255 Description: Description: Xilinx MPSoC H264/HEVC Encoder and Decoder Plugins The installation package can be downloaded from the Alveo U30 Product Page. If you encounter any issues during installation, see Chapter 6: Troubleshooting. 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.

Chapter 4: Installing the Deployment Software WICHTIG! Root-Zugriff ist für alle Software- und Firmware-Installationen erforderlich. To install the packages, run the following bash script with sudo rights. This script needs to be run in the directory containing the packages: $ ./install.sh After successfully installing the deployment software, proceed with sourcing the setup script by running the following command to set the environment to use the Xilinx utilities. Use the following command in csh shell: $ source /opt/xilinx/xdcr/setup.csh Use the following command in bash shell: $ source /opt/xilinx/xdcr/setup.sh Validate Install After successfully running the setup script, use the following steps to validate the installation. 1. Run the following command to validate the Alveo card(s) installed on the system. $ sudo /opt/xilinx/xrt/bin/xbutil scan You will see an output similar to the following. The bottom of the log will display the installed cards. In this example, four cards are displayed. Confirm that the number of cards displayed from the xbutil scan command match the number installed in your system. $ INFO: xbutil Found scan total 4 card(s), 4 are usable ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~ System Configuration OS name: Linux Release: Version: 4.15.0-66-generic #75~16.04.1-Ubuntu SMP Tue Oct 1 14:01:08 UTC 2019 Machine: x86_64 Model: CPU cores: X11DPi-N(T) 16 Memory: 31824 MB Glibc: Distribution: 2.23 Ubuntu 16.04.6 LTS Now: Fri Apr 3 15:37:53 2020 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~ XRT Information Version: Git Hash: 2.5.2 59ba825ea6a39358ab1f0d86666e9afd79e6fafd Git Branch: master-merge Build XOCL: Date: 2.5.2,59ba825ea6a39358ab1f0d86666e9afd79e6fafd 2020-03-17 17:12:22 XCLMGMT: 2.5.2,59ba825ea6a39358ab1f0d86666e9afd79e6fafd ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 14

Chapter 4: Installing the Deployment Software ~~~~~~~ [0] 0000:18:00.0 xilinx_U30_xdma_1_1(ID=0x5e7a31f8) user(inst=128) [1] [2] 0000:19:00.0 0000:b0:00.0 xilinx_U30_xdma_1_1(ID=0x5e7a31f8) xilinx_U30_xdma_1_1(ID=0x5e7a31f8) user(inst=129) user(inst=131) [3] 0000:af:00.0 xilinx_U30_xdma_1_1(ID=0x5e7a31f8) user(inst=130) 2. Use the following command to confirm that the xFFmpeg package is located under the directory, /opt/xilinx/ffmpeg/bin/ffmpeg. $ which ffmpeg The deployment software installation is complete. FFmpeg Command Usage This section describes how to run the FFmpeg command using the Alveo U30 card to accelerate the application. The following example scripts run ffmpeg as an application that uses the VCU encoder, decoder, and multi-scaler IPs from the Zynq UltraScale+ MPSoC. For background information, refer to the ffmpeg documentation for the Alveo U200 card at: github.com/ Xilinx/ABR-video-transcode/blob/2018.2_XDF/ffmpeg-integration.md. Although this document is specific to the Alveo U200 card, most of the details apply to the U30 as well. ABR Transcoding Ladder The xcdr package installs an example script that performs decoding, scaling, and encoding. The following script performs the decode, scale, and encode operation as shown in the ABR transcoding ladder figure below. One input is decoded and scaled with five encoded outputs at different resolutions. $ /opt/xilinx/xcdr/scripts/ffmpeg_scale_transcode_x1.sh user_clip.h264

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 15

Chapter 4: Installing the Deployment Software Figure 3: ABR Transcoding Ladder Encoder H.264 720p60 1080p60 720p60H.264 ABR DecoderScaler Split Frame H.264 Rate Drop Encoder Frame H.264 480p60 Rate Drop Encoder Frame H.264 360p60 Rate Drop Encoder 160p60 720p30 480p30 360p30 Frame Rate Drop Encoder H.264 160p30 X23796-032720 Decode and Encode The following example performs decoding and encoding only (no scaling). $ /opt/xilinx/xcdr/scripts/ffmpeg_transcode_only_x1.sh user_clip.h264 Encode Only The following example encodes a raw 1080p YUV file (encoder only). $/opt/xilinx/xcdr/scripts/ffmpeg_encode_raw_1080p_yuv_x1.sh <1080p YUV file> UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 16

Chapter 5: Multiple Devices and YAML Configuration UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 17 Chapter 5 Multiple Devices and YAML Configuration The ffmpeg application uses a YAML configuration file to define several fields used by the application. The file is located at: /opt/xilinx/xcdr/yaml/xmacfg.yaml and can be edited, however, sudo permission is required. Currently only the device_id_map field can be modified. The device_id_map field needs to match the number of devices installed in the system. Each Alveo U30 card can accommodate two devices. For instance, if you have a system with eight cards, you will need to set device_id_map to 16. Below is an example of setting the device_id_map for a system with one Alveo U30 card. device_id_map: [0,1] Similarly, the following is an example of setting the device_id_map for a system with three Alveo U30 cards. device_id_map: [0,1,2,3,4,5]

Chapter 6: Troubleshooting UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 18 Chapter 6 Troubleshooting The following table lists potential issues, causes, and fixes related to card installation. Table 2: Card Troubleshooting Issue Potential Cause Fix Card not found. Card not correctly installed. Reinstall the card following the installation instructions. Check if the card shows up by typing the following Linux command: lspci -vd 10ee: Card not compatible with server. Use qualified server. For system capabilities, see Alveo U30 Data Center Accelerator Card Data Sheet (DS970). Kernel version is incompatible. Run uname -r to check the kernel version. Ensure that the kernel version matches the version listed for your OS in Chapter 4: Installing the Deployment Software. lspci no longer recognizes the card. Card is overheating. Ensure that operating ambient conditions do not exceed specifications and passive cards are in a system that provides adequate airflow. Known Issues The following table lists known issues.

Chapter 6: Troubleshooting Table 3: Known Issues Area Description Comments/Recommendations XRT Installation Warning When trying to install the XRT debian package, there is an error seen during the installation of a python Open CL package. The error may look like this: DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. ... WARNING: The directory ‘/home/ rathaval/.cache/pip/http’ or its parent directory ... WARNING: The directory ‘/home/ rathaval/.cache/pip’ or its parent directory ... ERROR: Could not install packages due to an EnvironmentError: [Errno 13] ... UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 19 Consider using the –user option or check permissions. ffprobe for xFFmpeg does not work Trying to use /opt/xilinx/ ffmpeg/bin/ffprobe leads to an error or crash because it does not use xma_initialize(). xbutil validate is not supported Unlike other Alveo cards, the xbutil validate command is currently not supported on the U30. Use lspci --vd 10ee to confirm the card is seen by the OS. Also validate installation by following the steps in Validate Install. xbutil reset is not supported Resetting the Alveo U30 from the host using xbutil reset is not supported. Two different resets are available via the xbmgmt tool which requires sudo access. These include: • xbmgmt reset --softkernel: Performs a reset to the relaunch daemon SKD and ZOCL drivers that are embedded on the PS side. If you are seeing incorrect output data, try using this reset. • xbmgmt reset –ert: This reset will relaunch the embedded PS operating system (inside the Zynq UltraScale+ MPSoC). Perform this reset after stopping an application via CRTL-C. If the recommendations explained above do not work, a cold reboot of the host machine may be necessary to reset the Alveo U30 card. In case the board PCIe does not link up on the host (lscpi does not show Xilinx devices) If the red LED on the card is illuminated, it indicates that the golden flash image is corrupt. It is necessary to manually re-flash the golden image and cold-reboot. Contact Xilinx customer support for assistance.

Appendix A: Changing XRT and Target Platform Versions UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 20 Appendix A Changing XRT and Target Platform Versions The AlveoTM Data Center Accelerator card target platform revisions can change significantly between releases. XRT upgrade procedure is described below. Ubuntu During upgrading, downgrading, or uninstalling, it can be useful to list the currently installed Alveo packages. To list the currently installed XRT package, run the following command: $ apt list -–installed | grep xrt Upgrading XRT You can upgrade the XRT and deployment platform on your Alveo card by following these steps. Currently, both packages must be upgraded concurrently. You can upgrade the XRT on your Alveo card by following these steps. 1. Download the desired XRT packages. 2. Install the XRT installation package by running the following command from within the directory where the installation packages reside. <version> is the latter part of the installation package file name. $ sudo apt install ./xrt_<version>.deb This will install the XRT along with any necessary dependencies. Follow the instructions when prompted throughout the installation.

Appendix A: Changing XRT and Target Platform Versions Uninstalling Packages To completely uninstall the Alveo XRT and deployment platform packages, run the following command in a Linux terminal. Uninstalling XRT also uninstalls the deployment platform. $ sudo apt remove ./<xrt_package_name> Note: Make sure that all of the target platform packages are displayed in the output terminal after running the command. 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.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 21

Appendix B: Regulatory and Compliance Information Appendix B Regulatory and Compliance Information This product is designed and tested to conform to the European Union directives and standards described in this section. Safety Compliance The following table shows the safety standards that apply to the Alveo U30 cards. Table 4: Safety Standards Safety Standard Alveo U30 IEC 62368-1:2014 (Second Edition) ✓ CSA C22.2 No. 60950-1-07, 2nd Edition, 2014-10-14 (Information Technology Equipment - Safety - Part 1: General Requirements) UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 22 ✓ EN 60950-1:2006+A11:2009+A1:2012+A12:2011+A2:2013 (European Union) ✓ IEC 60950-1:2005 (2nd Edition); Am 1:2009 (International) ✓ EU LVD Directive 2014/35/EC ✓ EMC Compliance The following tables show the EMC standards that apply to the Alveo U30 cards. Class A Products Table 5: EMC Standards Standard Alveo U30 FCC Part 15 – Radiated & Conducted Emissions (USA) ✓ CAN ICES-3(A)/NMB-3(A) – Radiated & Conducted Emissions (Canada) ✓ CISPR 32 – Radiated & Conducted Emissions (International) ✓

Appendix B: Regulatory and Compliance Information Table 5: EMC Standards (cont'd) Standard Alveo U30 EN55032: 2015 – Radiated & Conducted Emissions (European Union) ✓ EN55024: 2010 +A1:2001+A2:2003 – Immunity (European Union) ✓ EMC Directive 2014/30/EC ✓ VCCI (Class A)– Radiated & Conducted Emissions (Japan) ✓ CNS13438 – Radiated & Conducted Emissions (Taiwan) ✓ CNS 15663 - RoHS (Taiwan) ✓ AS/NZS CISPR 32 – Radiated and Conducted Emissions (Australia/New Zealand) ✓ Article 58-2 of Radio Waves Act, Clause 3 (Korea) ✓ Regulatory Compliance Markings The following table shows the product certification markings that are provided, when required, with the Alveo U30 cards. Table 6: Product Certification Markings Product Certification Markings Alveo U30 UL Listed Accessories Mark for the USA and Canada ✓ CE mark ✓ FCC markings ✓ VCCI marking ✓ Australian C-Tick mark ✓ Korea MSIP mark ✓ Taiwan BSMI mark ✓ German GS mark ✓ CE Directives 2014/35/EC, Low Voltage Directive (LVD) 2014/30/EC, Electromagnetic Compatibility (EMC) Directive CE Standards EN standards are maintained by the European Committee for Electrotechnical Standardization (CENELEC). IEC standards are maintained by the International Electrotechnical Commission (IEC).

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 23

Appendix B: Regulatory and Compliance Information Electromagnetic Compatibility EN:55032:2015, Information Technology Equipment Radio Disturbance Characteristics – Limits and Methods of Measurement EN:55024:2015, Information Technology Equipment Immunity Characteristics – Limits and Methods of Measurement This is a Class A product. In a domestic environment, this product can cause radio interference, in which case the user might be required to take adequate measures. Compliance Markings The information in this section only applies to Alveo U30 cards. This product complies with Directive 2002/95/EC on the restriction of hazardous substances (RoHS) in electrical and electronic equipment. Other Compliance Statements The following sections only apply to Alveo U30 cards.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 24

In August of 2005, the European Union (EU) implemented the EU Waste Electrical and Electronic Equipment (WEEE) Directive 2002/96/EC and later the WEEE Recast Directive 2012/19/EU. These directives require Producers of electronic and electrical equipment (EEE) to manage and finance the collection, reuse, recycling and to appropriately treat WEEE that the Producer places on the EU market after August 13, 2005. The goal of this directive is to minimize the volume of electrical and electronic waste disposal and to encourage re-use and recycling at the end of life. 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. If you have purchased Xilinx-branded electrical or electronic products in the EU and are intending to discard these products at the end of their useful life, please do not dispose of them with your other household or municipal waste. Xilinx has labeled its branded electronic products with the WEEE Symbol to alert our customers that products bearing this label should not be disposed of in a landfill or with municipal or household waste in the EU. Appendix B: Regulatory and Compliance Information FCC Class A User Information The Class A products listed above comply with Part 15 of the FCC Rules. Operation is subject to the following two conditions: 1. This device may not cause harmful interference. 2. This device must accept any interference received, including interference that may cause undesired operation. IMPORTANT! This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case the user will be required to correct the interference at his or her own expense. IMPORTANT! Cet équipement a été testé et jugé conforme à la Class A digital device, conformément à la règle 15 du standard FCC. Ces limites sont conçues pour fournir des protections contre des interférences nuisibles lorsque l'équipement est utilisé dans un environnement commercial. Cet équipement génère, utilise et peut émettre des énergies de radio-fréquence et, s'il n'est pas installé et utilisé conformément aux instructions, peut nuire aux communications radio. L'exploitation de cet équipement dans une zone résidentielle est susceptible de causer des interférences nuisibles, auquel cas auquel cas l'utilisateur peut être tenu de prendre des mesures adéquates à ses propres frais. WICHTIG! Dieses Gerät wurde getestet und entspricht den Grenzwerten für digitale Geräte der Klasse A gemäß Teil 15 der FCC-Bestimmungen. Diese Grenzwerte bieten einen angemessenen Schutz gegen schädliche Interferenzen, wenn das Gerät in einer gewerblichen Umgebung betrieben wird. Dieses Gerät erzeugt und verwendet Hochfrequenzenergie und kann diese abstrahlen. Wenn es nicht gemäß den Anweisungen installiert und verwendet wird, kann dies Funkstörungen verursachen. Der Betrieb dieses Geräts in einem Wohngebiet kann schädliche Interferenzen verursachen. In diesem Fall muss der Benutzer die Interferenz auf eigene Kosten beheben. CAUTION! If the device is changed or modified without permission from Xilinx, the user may void his or her authority to operate the equipment. ATTENTION! Si l'appareil est modifié sans l'autorisation de Xilinx, l'utilisateur peut annuler son abilité à utiliser l'équipement. VORSICHT! Wenn das Gerät ohne Erlaubnis von Xilinx geändert wird, kann der Benutzer seine Berechtigung zum Betrieb des Geräts verlieren. Canadian Compliance (Industry Canada) CAN ICES-3(A)/NMB-3(A)

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 25

Appendix B: Regulatory and Compliance Information VCCI Class A Statement Manufacturer Declaration Xilinx declares that the equipment described in this document is in conformance with the requirements of the European Council Directive listed below: • Low Voltage Directive 2014/35/EU • EMC Directive 2014/30/EU • RoHS 3 Directive 2011/65/EU, 2015/863 These products follow the provisions of the European Directive 2014/53/EU. Dette produkt er i overensstemmelse med det europæiske direktiv 1999/5/EC.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 26 KCC Notice Class A (Republic of Korea Only) BSMI Class A Notice (Taiwan)

Manufacturer Declaration European Community Appendix B: Regulatory and Compliance Information Dit product is in navolging van de bepalingen van Europees Directief 1999/5/EC. Tämä tuote noudattaa EU-direktiivin 1999/5/EC määräyksiä. Ce produit est conforme aux exigences de la Directive Européenne 1999/5/EC. Dieses Produkt entspricht den Bestimmungen der Europäischen Richtlinie 1999/5/EC. Þessi vara stenst reglugerð Evrópska Efnahags Bandalagsins númer 1999/5/EC. Questo prodotto è conforme alla Direttiva Europea 1999/5/EC. Dette produktet er i henhold til bestemmelsene i det europeiske direktivet 1999/5/EC. Este produto cumpre com as normas da Diretiva Européia 1999/5/EC. Este producto cumple con las normas del Directivo Europeo 1999/5/EC. Denna produkt har tillverkats i enlighet med EG-direktiv 1999/5/EC. This declaration is based upon compliance of the Class A products listed above to the following standards: EN 55032 (CISPR 32 Class A) RF Emissions Control. EN 55024:2010 (CISPR 24) Immunity to Electromagnetic Disturbance. EN 60950-1:2006/A11:2009A1:2010/A12:2011 Information Technology Equipment- Safety- Part 1: General Requirements. EN 50581:2012 - Technical documentation for the assessment of electrical and electronic products with respect to the restriction of hazardous substances. CAUTION! In a domestic environment, Class A products may cause radio interference, in which case the user may be required to take adequate measures. ATTENTION! Dans un environnement domestique, les produits de Classe A peuvent causer des interférences radio, auquel cas l'utilisateur peut être tenu de prendre des mesures adéquates. VORSICHT! In einer häuslichen Umgebung können Produkte der Klasse A Funkstörungen verursachen. In diesem Fall muss der Benutzer möglicherweise geeignete Maßnahmen ergreifen. Responsible Party Xilinx, Inc. 2100 Logic Drive, San Jose, CA 95124 United States of America Phone: (408) 559-7778

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 27

Appendix C: Additional Resources and Legal Notices UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 28 Appendix C Additional Resources and Legal Notices Xilinx Resources For support resources such as Answers, Documentation, Downloads, and Forums, see Xilinx Support. Documentation Navigator and Design Hubs Xilinx® Documentation Navigator (DocNav) provides access to Xilinx documents, videos, and support resources, which you can filter and search to find information. To open DocNav: • From the Vivado® IDE, select Help → Documentation and Tutorials. • 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: • In DocNav, click the Design Hubs View tab. • On the Xilinx website, see the Design Hubs page. Note: For more information on DocNav, see the Documentation Navigator page on the Xilinx website. References These documents provide supplemental material useful with this guide:

Appendix C: Additional Resources and Legal Notices 1. Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393) 2. Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400) 3. Vitis 2020.1 Software Platform Release Notes in the Vitis Unified Software Platform Documentation (UG1416) 4. Vitis Application Acceleration Development Flow Tutorials (GitHub) Alveo Documents 1. Alveo U30 Data Center Accelerator Card Data Sheet (DS970) Additional Xilinx Resources 1. Xilinx licensing website: xilinx.com/getproduct 2. Vitis Developer Zone: xilinx.com/products/design-tools/vitis/vitis-platform.html 3. Xilinx Community Forums: forums.xilinx.com 4. Xilinx Third-Party End User License Agreement 5. End-User License Agreement Please Read: Important Legal Notices 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 CONDITIONS, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, OR FITNESS FOR ANY PARTICULAR PURPOSE; and (2) Xilinx shall not be liable (whether in contract or tort, including negligence, or under any other theory of liability) for any loss or damage of any kind or nature related to, arising under, or in connection with, the Materials (including your use of the Materials), including for any direct, indirect, special, incidental, or consequential loss or damage (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. You may not reproduce, modify, distribute, or publicly display the Materials without prior written consent. Certain products are subject to the terms and conditions of Xilinx's limited warranty, please refer to Xilinx's Terms of Sale which can be viewed at

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 29

Appendix C: Additional Resources and Legal Notices xilinx.com/legal.htm#tos; 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 use of Xilinx products in such critical applications, please refer to Xilinx's Terms of Sale which can be viewed at xilinx.com/legal.htm#tos. AUTOMOTIVE APPLICATIONS DISCLAIMER AUTOMOTIVE PRODUCTS (IDENTIFIED AS "XA" IN THE PART NUMBER) ARE NOT WARRANTED FOR USE IN THE DEPLOYMENT OF AIRBAGS OR FOR USE IN APPLICATIONS THAT AFFECT CONTROL OF A VEHICLE ("SAFETY APPLICATION") UNLESS THERE IS A SAFETY CONCEPT OR REDUNDANCY FEATURE CONSISTENT WITH THE ISO 26262 AUTOMOTIVE SAFETY STANDARD ("SAFETY DESIGN"). CUSTOMER SHALL, PRIOR TO USING OR DISTRIBUTING ANY SYSTEMS THAT INCORPORATE PRODUCTS, THOROUGHLY TEST SUCH SYSTEMS FOR SAFETY PURPOSES. USE OF PRODUCTS IN A SAFETY APPLICATION WITHOUT A SAFETY DESIGN IS FULLY AT THE RISK OF CUSTOMER, SUBJECT ONLY TO APPLICABLE LAWS AND REGULATIONS GOVERNING LIMITATIONS ON PRODUCT LIABILITY. Copyright © Copyright 2020 Xilinx, Inc. Xilinx, the Xilinx logo, Alveo, Artix, Kintex, Spartan, Versal, Virtex, Vivado, Zynq, and other designated brands included herein are trademarks of Xilinx in the United States and other countries. PCI, PCIe, and PCI Express are trademarks of PCI-SIG and used under license. All other trademarks are the property of their respective owners.

UG1425 (v1.0) June 16, 2020 U30 Installation and User Guide Send Feedback xilinx.com 30


FREE ENGLISH PDF

OPERATING INSTRUCTIONS

USER GUIDE - USER MANUAL

OWNER GUIDE - OWNER MANUAL

REFERENCE GUIDE - REFERENCE MANUAL

INSTRUCTION GUIDE - INSTRUCTION MANUAL

Leave a Reply