Page 1
Kit Hardware Installation Guide UG1531 (v1.0) March 4, 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.
Introduction This document provides hardware and software installation procedures for the full-height full- length Xilinx ® VCK5000 Versal ® development card and applies to XRT 2021.2 and later. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Chapter 2: Accelerator Card Overview Chapter 2 Accelerator Card Overview Card Features The following table lists the features of the VCK5000 evaluation card. Table 1: Summary of Card Features Feature Summary ACAP Device XCVC1902-2MSEVSVD1760 Configuration Options 2 Gb OSPI memory MT35XU01GBBA2G12-0SIT Configurable over OSPI, OSPI + PCIe ®...
None required for application deployment. Active and Passive Card Configurations The Xilinx VCK5000 Versal development card can be configured as an actively or passively cooled card depending on the addition of the fan assembly. A Xilinx VCK5000 Versal development card configured with a fan assembly attached is referred to as the active configuration.
Page 7
Operation of a passively configured card without external cooling will cause damage to the card. Figure 2: Passive Configuration UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
• A maintenance connector Used to program the card in RTL flow through the programming cable. For more information see the Alveo Programming Cable User Guide (UG1377). Figure 3: VCK5000 Card with Half-Height Bracket Maintenance Port Micro-USB Connector PCIe Connector...
Page 9
Chapter 2: Accelerator Card Overview For card specifications, dimensions, and block diagram see the VCK5000 Data Center Acceleration Development Kit User Guide (UG1428). Contact your FAE for more information. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
• 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. UG1531 (v1.0) March 4, 2022 www.xilinx.com...
• Verify that the minimum card space is available to install your card. Card specifications and dimensions can be found in the VCK5000 Data Center Acceleration Development Kit User Guide (UG1428). In the active configuration, the AUX power cables are exiting from the back side of the card and requires additional spacing, exceeding the form factor.
Page 12
WARNING! VCK5000 cards are not compatible with an ATX12V/EPS12V power source. Do not force connection to a CPU (ATX12V/EPS12V) power source. Do not insert or use a 4-pin ATX cable on a 6-pin/8-pin PCIe connector on the VCK5000 card. This will damage the VCK5000 card and void the warranty.
Page 13
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 VCK5000 card: 01:00.0 Memory controller: Xilinx Corporation Device 5048 Subsystem: Xilinx Corporation Device 000e...
Page 14
Kernel driver in use: xocl Kernel modules: xocl Note: If this card has previously been installed, the lspci output will be similar to the one shown in Running lspci. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
All installation packages can be downloaded from either the VCK5000 lounge or VCK5000-AIE lounge. Contact your FAE for more information.
Page 16
Ensure that uname is surrounded by backticks ( `) and not single quotes ('). $ sudo yum install kernel-headers-`uname -r` $ sudo yum install kernel-devel-`uname -r` 3. After the previous command completes, reboot your machine. 4. From the lounge, download the Xilinx ® runtime (XRT) and deployment target platform installation packages.
Page 17
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> --image xilinx_vck5000_gen3x16_xdma_base_1 Where management BDF is the card requiring SC firmware update. See...
For details on installing a newer or older version of XRT and deployment platform, see Appendix B: Changing XRT and Target Platform Versions. 1. From the lounge, download the Xilinx ® runtime (XRT) and deployment target platform installation packages. Download the packages by clicking on the displayed package names.
Page 19
7. 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> --image xilinx_vck5000_gen3x16_xdma_base_1 Where management BDF is the card requiring SC firmware update.
Page 20
Chapter 4: Installing the Deployment Software The installation for deployment is now complete. Chapter 5: Card Bring-Up and Validation provides steps to validate the card has been installed successfully. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Use the following command in csh shell: $ source /opt/xilinx/xrt/setup.csh Use the following command in bash shell: $ source /opt/xilinx/xrt/setup.sh Running lspci 1. Enter the following command: $ sudo lspci -vd 10ee: UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
(i.e., Peer-2-Peer). Use the following command to run the card validation test: $ /opt/xilinx/xrt/bin/xbutil validate -d <user BDF> where user BDF is the card to be validated. See Appendix C: Obtaining Card BDF Values obtain the user BDF value.
Validation completed. Please run the command '--verbose' option for more details Temperature and Electrical Status To monitor the current electrical and temperature status, use the following commands: xbutil examine --device <user BDF> --report thermal electrical UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 25
Mgt Vtt 1.197 V 3.3 Volts Vcc 3.270 V Vcc 1.2 Volts i 2.200 A Vcc Auxillary 1.508 V Vcc Auxillary Pmc 1.512 V Vcc Ram 0.800 V UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
For complete details on the development flow and getting started in Vitis, see Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400). For an introduction to Vitis methodology, see Vitis Unified Software Platform Documentation (UG1416). UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Deployment Software in the VCK5000 Hardware Installation Guide (UG1531) for steps to update the SC. 2. VCK5000 faceplate makes it difficult to connect standard micro-USB cable to the card during debugging. Recommend to use an elongated USB cable which can be found in the...
1. Remove mounting bracket screws. Turn over the card and remove the six screws (highlighted in the following image) to connect the fan assembly to the fan assembly mounting bracket. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 29
Metal Fan Assembly Mounting Bracket X25818-030322 3. Disconnect the fan power connector. Gently unplug the fan power connector from the card and remove the fan assembly. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 30
4. Remove the metal fan assembly mounting bracket. Unscrew and remove the three screws highlighted and separate the bracket from the card. X25822-030322 5. Disconnect PCIe power cables. Gently disconnect and remove both the 6-pin and 8-pin PCIe AUX power cables. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
1. Connect the 6-pin and 8-pin PCIe AUX power cables to the card. Gently connect the 6-pin and 8-pin PCIe AUX power cables to the AUX connectors on the card (shown in the following figure) and ensure they are mechanically fixed (with a click). UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 32
Do not over bend. X25841-030322 3. Attach the metal fan mounting bracket. Align the metal fan mounting bracket and attach it with the three screws as highlighted. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 33
While holding onto the edge of the metal fan mounting bracket, push the fan assembly down until it is firmly attached. When attached, it is held in place by the metal fan assembly bracket. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Page 34
6. Secure the fan assembly to the mounting bracket with the six screws (highlighted in the following image). Metal Fan Assembly Mounting Bracket X25816-030322 Fan assembly is successfully attached. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
To ensure a successful migration to a newer or older version of the VCK5000 card XRT and platform, carefully follow the instructions for your specific release pairing. Failure to adhere to these procedures can result in an unstable installation or other issues.
$ apt list --installed | grep xrt Installing Newer Packages Install the newest XRT and deployment platform on your VCK5000 card by following these steps. Currently, both packages must be upgraded concurrently. 1. Download the desired XRT and deployment platform packages. Follow installation in...
Page 37
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. UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
Appendix C Obtaining Card BDF Values Each VCK5000 card is assigned both a management and an user BDF (Bus:Device:Function). For a given card, the management and user BDF values differ only by the function digit. To obtain the management and user BDF values for installed cards, use the following commands.
CE Safety IEC 60950-1:2005, Information technology equipment – Safety, Part 1: General requirements EN 60950-1:2006, Information technology equipment – Safety, Part 1: General requirements UG1531 (v1.0) March 4, 2022 www.xilinx.com Send Feedback VCK5000 Hardware Install Guide...
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: •...
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 43
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...
Need help?
Do you have a question about the VCK5000 and is the answer not in the manual?
Questions and answers