Getting Started

Hardware Requirements

This tutorial targets the Zynq® UltraScale+™ ZCU102 evaluation board. The examples in this tutorial were tested using the ZCU102 Rev 1 board. To use this guide, you need the following hardware items, which are included with the evaluation board:

  • ZCU102 Rev1 evaluation board

  • AC power adapter (12 VDC)

  • USB Type-A to USB Micro cable (for UART communications)

  • USB micro cable for programming and debugging via USB-Micro JTAG connection

  • SD-MMC flash card for Linux booting

  • Ethernet cable to connect target board with host machine

  • Monitor with DisplayPort (DP) capability and at least 1080P resolution

  • DP cable to connect the display output from the ZCU102 board to a DP monitor

Installation Requirements

Vitis Integrated Design Environment and Vivado Design Suite

Ensure that you have the Vitis™ 2021.2 unified software development platform installed. The Vitis software platform comes with all the hardware and software as a package. If you install the Vitis IDE, you will automatically get both the Vivado Design Suite and the Vitis IDE. You do not have to make any extra selections in the installer.


Visit to confirm that you have the latest tools version.

Vitis embedded software development supports the following operating systems:

  • RHEL/CentOS 7.4, 7.5, 7.6, 7.7, 7.8, 8.1, 8.2

  • RHEL 8.3

  • Ubuntu 16.04.5, 16.04.6, 18.04.1, 18.04.2, 18.04.3, 18.04.4, 20.04, 20.04.1 LTS

  • Amazon Linux 2 AL2 LTS

  • SUSE Enterprise Linux 12.4

  • Windows 10 64-bit Professional and Enterprise versions 1809, 1903, 1909, and 2004

For more information on installing the Vitis Software Development Platform, refer to the Installation section of UG1400.

PetaLinux Tools

Install the PetaLinux tools to run through the Linux portion of this tutorial. PetaLinux tools run under the Linux host system running one of the following:

  • Red Hat Enterprise Workstation/Server 7.4, 7.5, 7.6, 7.7, 7.8 (64-bit)

  • CentOS Workstation/Server 7.4, 7.5, 7.6, 7.7, 7.8 (64-bit)

  • Ubuntu Linux Workstation/Server 16.04.5, 16.04.6, 18.04.1, 18.04.2, 18.04.3, 18.04.4(64-bit)

This can use either a dedicated Linux host system or a virtual machine running one of these Linux operating systems on your Windows development platform.

When you install PetaLinux tools on your system of choice, you must do the following:

  • Download the PetaLinux 2021.2 software from the Xilinx website.

  • Download the ZCU102 PetaLinux BSP (ZCU102 BSP (prod-silicon)) from the downloads page.

  • Add common system packages and libraries to the workstation or virtual machine. For more information, see the Installation Requirements from the PetaLinux Tools Documentation: Reference Guide (UG1144).


  • 16 GB RAM (recommended minimum for Xilinx tools)

  • 100 GB free HDD space

Extracting the PetaLinux Package

PetaLinux tools installation is straight-forward. Without any options, the PetaLinux tools are installed into the current working directory. Alternatively, an installation path may be specified.

For example, to install PetaLinux tools under /opt/pkg/petalinux/2021.2:

For more information, see the PetaLinux Tools Documentation: Reference Guide (UG1144).

Software Licensing

Xilinx software uses FLEXnet licensing. When the software is first run, it performs a license verification process. If the license verification does not find a valid license, the license wizard guides you through the process of obtaining a license and ensuring that the license can be used with the tools installed. If you do not need the full version of the software, you can use an evaluation license. For installation instructions and information, see the Vivado Design Suite User Guide: Release Notes, Installation, and Licensing (UG973).

Tutorial Design Files

The reference design files for this tutorial are provided in the ref_files directory, organized with design number or chapter name. Chapters that need to use reference files will point to the specific ref_files subdirectory.

  • If the examples are GUI based, the ref_files directory provides the source files for the examples.

  • If the examples can be run in script mode, the ref_files directory contains the Makefile to help you run through the flow easily. Run make in this directory to run through the implementation flow.

Next Chapter

The next chapter details the configuration of a Zynq UltraScale+ MPSoC PS with the Vivado IDE.