Versions Compared

Old Version 41

changes.mady.by.user Hatch, Christopher

Saved on

compared with

New Version Current

changes.mady.by.user Hatch, Christopher

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Hardware and Software Requirements

SD Card

Networking

USB Peripherals

Miscellaneous

ZCU102 (Rev 1.0+)

16GB+ 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+)

16GB+ Micro SD Card

(Optional) USB hub for peripherals (ex: keyboard, mouse)

ZCU106 (Rev 1.0+)

16GB+ SD Card

Kria KR260 Starter Kit

16GB+ Micro SD Card

Kria KV260 Starter Kit

16GB+ Micro SD Card

The KV260 desktop is mirrored on both the DisplayPort and HDMI interfaces.

Installing the Image

Once you have downloaded the Certified Ubuntu for Xilinx Devices image fromhttps://ubuntu.com/download/amd-xilinx , you can write it to your SD card using any disk writing tool such as Balena Etcher, Win32 Disk Imager, or dd.

...

To install the xlnx-config snap, execute the following command from a terminal: 

Code Block
languagebash
$ sudo snap install xlnx-config --classic --channel=2.x
Info

For Kria users who are familiar with the xmutil command, there is now a xmutil debian package pre-installed in the images. It is no longer a requirement to use xlnx-config for xmutil functionality.

...

The default platforms for the three boards are: 

Evaluation Board

Reference Hardware Platform

ZCU102

2022.1 Petalinux BSP

ZCU104

2022.1 Petalinux BSP

ZCU106

2022.1 Petalinux BSP

VCK190

VCK190: Versal Base TRD 2022.1 ( Platform 1 VCK190 Single Sensor design vck190_mipiRxSingle_hdmiTx version v1.4)

Kria KV260 Starter Kit

2022.1 Vitis Platforms

Kria KR260 Starter Kit

2022.1 Vitis Platforms

Running the ZCU10x DPU Demos

...

  • Suspend/resume functionality is not supported including Ethernet wake-on-LAN (WOL)

  • via-lab chipset based USB hubs will cause boot failure. Recommendation to use USB devices without a hub.

  • Install of Xilinx application packages causes dfx-mgr to crash. Recommendation to reboot platform or restart dfx-mgr service.

  • xmutil pwrctrl utility functional but does not print status to console

  • Audio playback on DisplayPort occasionally produces a “clicking” noise in concert with actual audio playback

  • KV260: Legacy boot FW (2021.1) will not boot the Ubuntu 22.04 image. Upgrade to 2022.1 Boot FW prior to loading Ubuntu 22.04 image.

  • KR260: KR260 USB2.0 devices not functional on U46 interfaces. Upgrade to 2022.1 Boot FW.

  • Portrait mode is unsupported

  • Wake on USB (eg, pressing a key on a keyboard or clicking a button on a mouse) is not supported

  • KR260: KR260 only supports a single lane of DisplayPort with a maximum resolution of 1080p. Some monitors are not able to negotiate the maximum link speed to support 1080p, so a lower maximum resolution may be reported.

  • KD240: A longer boot time may be seen on KD240. This is under investigation for resolution in a future release. Ref#2034604

  • KD240: KASLR is currently disabled on Kria images. This is under investigation for resolution in a future release.  Ref#2030907

  • KD240: On revB boards the Machine Name may be incorrectly printed as ZynqMP KD240 revA.  This is being investigated for resolution in the next release.  Ref#2033477

  • KD240: The RS485 component on KD240 boards may fail to send and receive messages.   This is being investigated for resolution in the next release.  Ref#2021573

  • KD240: On KD240 boards the CAN0 interface may fail to come online when enabled with "ip link set can0 up2" with either  "Invalid argument" returned or "kria kernel: xilinx_can ff060000.can can0: bit-timing not yet defined" printed to the Journal log.    To resolve this issue ensure the bitrate is set before enabling the CAN device:    "ip link set can0 type can bitrate 100000 loopback on // CAN node configure with 100Kbps speed."  This is being investigated for resolution in the next release.  Ref #2025450

  • KD240: On KD240 boards errors relating to sdhci0 (sdhci-arasan)  may be seen during boot and in dmsg logs.    This is being investigated for resolution in the next release.  Internal reference #2034924

ZCU10x Boards

TBD

Versal Boards

...

After updating the Linux kernel boot arguments, run the flash-kernel utility to update the bootargs passed the Linux kernel on the next reboot.

Code Block
ubuntu@kria:~$ sudo flash-kernel

Verifying the bootargs

To verify that the bootargs are set they way you want them, you can use the following command after the reboot:

...

Info

Unless otherwise noted, the Xilinx version for any Xilinx-specific packages is 2022.1

This table is currently being updated ahead of the Certified Ubuntu releases for Ubuntu 22.04.

Package Name

Description & Notes

KR/V260

ZCU10x

dfx-mgr

Y

Y

libdfx-mgr1

Y

Y

xilinx-bootgen

Xilinx BootGen tool used for creating bootable images

N

Y

fpga-manager-xlnx

fpgautil

Y

Y

libegl-mali-xlnx

libEGL libraries for the Mali GPU

Y

Y

u-boot-zynqmp

Xilinx U-Boot bootloader - u-boot-zynqmp

N

Y

vitis-ai

Vitis AI libraries & Vitis AI DNNDK legacy libraries

N

TBD

xserver-xorg-video-armsoc-endlessm

Open source driver for Arm GPU from the Endless OS Foundation xf86-video-armsoc repository.

Y

Y

xilinx-vcu-ctrl

Applications for encoding & decoding video streams (ctrlsw_decoder and ctrlsw_encoder)

Y

Y

xilinx-vcu-omx

OMX decoder and encoder tools (omx_decoder and omx_encoder)

Y

Y

xlnx-firmware

Boot assets (bitstream, firmware, bootloaders, dtb, etc.)
HDMI Rx firmware

N

Y

xrt

Libraries required to support XRT on Arm platforms

Y

Y

oem-limerick-kria-meta

Ubuntu meta-package for support of the Certified Ubuntu on Xilinx Devices image on Kria platforms

Y

N

xmutil

Y

Y

fru-print

Y

Y

libxilinx-vcu-dev

Y

Y

libxilinx-vcu0

Y

Y

libxilinx-vcu-omx-dev

Y

Y

libxilinx-vcu-omx1

Y

Y

xilinx-vcu-omx-utils

Y

Y

linux-firmware-xilinx-vcu

Firmware required for the VCU operation

Y

Y

xlnx-default-bitstreams

Y

N

linux-firmware-xilinx-ap1302

Y

Y

Checking the Xilinx Kernel Configuration

...

Historically, DisplayPort to HDMI adapters have been problematic when used with the ZCU10x boards. However, there are some that work consistently. The table below lists ones that are known to work as well as some that did not work. 

Adapter Model

Status

Where to Purchase

JSAUX JSESNZ4KDP2HDF

(tick) Compatible

Amazon.ca

J5create JDA158

(tick) Compatible

J5Create Direct , Amazon.com , Staples , Best Buy , NewEgg.com

IVANKY-DP11

(error) Incompatible

ICZI IZEC-A10-IT

(error) Incompatible

Snowkids DP to HDMI Cable

(error) Incompatible

Related Links

...