The Xilinx Certified Ubuntu 20.04 LTS for Xilinx Devices image is an official Ubuntu image with certified hardware support for select Xilinx evaluation boards. This page details how to boot and use the official desktop environment image released by Canonical for Xilinx ZCU102, ZCU104, and ZCU106 evaluation boards as well as the Kria KV260 Starter Kit. You can read more and download the certified Ubuntu hardware here.

For the 22.04 Jammy Jellyfish release, please refer to the 22.04 getting started page: https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/2363129857

1 Hardware and Software Requirements
2 Installing the Image
3 First Boot and Getting Started
- 3.1 Logging in via the Terminal
- 3.2 Logging in via the Graphical Desktop
- 3.3 Network Setup
4 Set up the Xilinx Development & Demonstration Environment for Ubuntu 20.04 LTS
- 4.1 Install the Custom Xilinx gstreamer
- 4.2 Download a Vitis AI Model (ZCU104 and ZCU106 Only)
5 Overview of the Out-of-the-Box Demos
6 Creating a Custom Hardware Platform
7 Getting Help
8 Resources & References
9 Related Links

Hardware and Software Requirements

	SD Card	Networking	USB Peripherals	Miscellaneous

	SD Card	Networking	USB Peripherals	Miscellaneous
ZCU102 (Rev 1.0+)	8GB+ SD Card	Wired Ethernet cable (100Mbps+) required to download updates and additional reference designs	Micro USB-A to USB-A Adapter, (Optional) USB hub for peripherals (ex: keyboard, mouse)	A DisplayPort cable and monitor may be used for a graphical desktop experience. Else, connect via USB UART terminal or SSH. If DisplayPort Monitor is not available, please see the DisplayPort to HDMI Adapters section below for compatible adapters.
ZCU104 (Rev 1.0+)	8GB+ Micro SD Card		(Optional) USB hub for peripherals (ex: keyboard, mouse)
ZCU106 (Rev 1.0+)	8GB+ SD Card
Kria KV260 Starter Kit	8GB+ Micro SD Card

Note: The ZCU104 & ZCU106 VCU ROI TRD demonstrations additionally require the following accessories: HDMI monitor, HDMI source device (ex: DVD player), and HDMI cables. HDMI is not used on the ZCU102 design.

Installing the Image

Once you have downloaded the Certified Ubuntu for Xilinx Devices image fromInstall Ubuntu on AMD | Ubuntu , you can write it to your SD card using any disk writing tool such as Balena Etcher, Win32 Disk Imager, or dd.

The screenshots below show how to write the disk image with Win32 Disk Imager.

For Linux & Mac Users, you can follow the instructions here: https://ubuntu.com/download/iot/installation-media

After opening Win32 Disk Imager, ensure the correct SD card drive is selected in (1) and then used the folder button (2) to locate the disk image.

The final disk image name may be different for you. Make sure that you are using the disk image that you downloaded.

After selecting the disk image, click the Write button to write the disk image to the SD card. The process will take approximately 10 minutes depending on the speed of your SD card and card reader.

First Boot and Getting Started

Before powering on the board, make sure all of the cables and peripherals are attached. At a minimum, attach the following:

Power Adapter
USB UART cable
(Micro) SD Card

For the best experience, additionally connect the following:

DisplayPort or HDMI Monitor
USB Keyboard & Mouse (may be attached via USB hub)
Ethernet networking (with Internet access)

For detailed information about preparing each of three evaluation boards for booting from the SD card, please refer to the following links:

For general information about how the boot process works for the ZCU10x image, please refer to https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/2036826124. For information on how the boot process works for the Kria KV260 Starter Kit, please refer to the Kria K26 SOM wiki page.

NOTE: There are important differences for using the Certified Ubuntu on Xilinx Devices release on the ZCU104 board. Please see the Special Considerations for the ZCU104 Evaluation Board section.

Logging in via the Terminal

If you choose to boot without the optional accessories, you can monitor the boot process via the USB UART terminal output. Once you see the zynqmp login: prompt you can log into the system.

The default Ubuntu 20.04 LTS terminal login prompt

The default login credentials are:

username: ubuntu

password: ubuntu

The standard system policy requires you to change the password after the first time you log in with the default credentials.

If you login very quickly the first boot, you may find that the password does not have to be changed. In this case, you will be required to update it the next time you login or use sudo.

The default Ubuntu 20.04 LTS terminal

Logging in via the Graphical Desktop

If you are using the graphical interface via a monitor, the login process is similar:

the default Ubuntu 20.04 LTS login greeter screen

the default Ubuntu 20.04 LTS GNOME 3 desktop

Note: All systems using the Certified Ubuntu for Xilinx Devices image will initially boot with the graphical resolution of 1920x1080. 4K (3840x2160 or higher) resolutions are possible but Xilinx recommends using the 1920x1080 resolution for the most robust desktop experience.

The Ubuntu Desktop configuration used for this image is ubuntu-desktop-minimal. This configuration does not include Ubuntu Software by default. While you can always install Debian packages and snaps from the command line, if you would like to install the Ubuntu Software application, you can run the following command in a terminal:

sudo snap install snap-store

Network Setup

The instructions below assume the system is connected to the Internet. If your system is not connected to the Internet please connect the Ethernet cable and configure the system for Internet access before continuing.

If your network is configured with a DHCP server, the Certified Ubuntu for Xilinx Devices system will automatically obtain an IP address. If a static address is required, you can use the ip command from the command line to configure the network interface. For more information, please see Configuring networks

For those users that prefer to use the ifconfig tools to configure your network interface, you can install the net-tools package. These tools are no longer included as part of the standard Ubuntu 20.04 root filesystem. To install them, you can use the following command:
$sudo apt install net-tools

If you are using the Gnome 3 graphical interface, you can configure networking via the Network Settings options in the GUI.

The GNOME 3 Network Settings GUI

Set up the Xilinx Development & Demonstration Environment for Ubuntu 20.04 LTS

Getting Started with Certified Ubuntu 20.04 LTS for Xilinx Devices

Table of Contents