Getting Started - 2023.2 English

Versal Adaptive SoC Embedded Design Tutorial (UG1305)

Document ID
Release Date
2023.2 English

Hardware Requirements

This tutorial targets the AMD Versal™ VCK190, VMK180, and VPK180 evaluation boards. To use this guide, you need the following hardware items. These are included with the evaluation board. Ensure that the required tools are installed properly and your environments match the requirements.

The evaluation board kit includes:

  • VCK190/VMK180/VPK180 Production 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


QSPI/SD were tested on VCK190/VMK180/VPK180 Production boards.

Installation Requirements

Vitis Integrated Design Environment (IDE) and Vivado Design Suite

Ensure that you have the AMD Vitis™ 2023.2 software development platform installed. The Vitis IDE is a unified tool which 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 development tools. You do not have to make any extra selections in the installer.


Visit to confirm that you have the latest tools version.

For more information on installing the Vivado Design Suite, refer to the Vitis Unified Software Platform Documentation: Embedded Software Development (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, 7.9, 8.1, 8.2 (64-bit)

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

  • Ubuntu Linux Workstation/Server 16.04.5, 16.04.6, 18.04.1, 18.04.2, 18.04.3, 18.04.4, 18.04.5, 20.04, 20.04.1 (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:


  • 8 GB RAM (recommended minimum for AMD tools)

  • 2 GHz CPU clock or equivalent (minimum of eight cores)

  • 100 GB free HDD space

Extracting the PetaLinux Package

By default, the PetaLinux tools are installed into the current working directory. Alternatively, you can specify an installation path.

For example, to install PetaLinux tools under /opt/pkg/petalinux/<petalinux-version>:

$ mkdir -p /opt/pkg/petalinux/<petalinux-version>
$ ./petalinux-v<petalinux-version> --dir /opt/pkg/petalinux/<petalinux-version>

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

Software Licensing

AMD 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 Production Silicon are provided in the ref_files directory.