Xilinx ZYNQ UltraScale+ MPSoC - Getting Started - Xilinx Kria

From RidgeRun Developer Wiki







Previous: Getting_Started Index Next: Getting_Started/ZCU_102-106





Using prebuilt Ubuntu image

Out of the box, the board can boot Ubuntu 22.04. Newer versions require updating the boot firmware.

Installing the proper firmware

Please, consider the following table to find the proper version of the firmware.

Ubuntu Image Firmware Version
20.04 2021.1 Boot FW Update 2 or later
22.04 2022.1 Boot FW Update

You can install the firmware in two possible ways:

1. Using the xmutil

The xmutil provides a utility to help in the update of the on-target boot firmware with the following steps:

  • Download the boot firmware update from the table above. It should be a Xilinx BOOT.BIN file.
  • Move the BOOT.BIN file to the Xilinx Kria target using FTP
  • Execute sudo xmutil bootfw_update -i $PATH_TO_BOOT_BIN
  • After the image writing is completed, issue a power-on reset (press the RESET push button)
  • After restart, verify functionality executing sudo xmutil bootfw_update -v to validate successful boot against the new firmware.

On Ubuntu 20.04, the xmutil command must be replaced by xlnx-config --xmutil

2. Using the Ethernet Rescue Tool

The Ethernet Rescue Tool can recover the board in case of bootloader or rootfs corruption. To put the board into rescue mode:

  • Connect the board to a wired network using Ethernet
  • Press the FLASH button and hold it
  • Power cycle the board (turn it on or press the RESET button)
  • Wait for 3 seconds
  • Release the FLASH button

After putting the board into rescue mode, open http://192.168.0.111 in a browser. It will open the Rescue Tool:

From https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/1641152513/Kria+K26+SOM#Boot-FW-Update-Process
From https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/1641152513/Kria+K26+SOM#Boot-FW-Update-Process

Make sure of configuring your IP Address and Subnet Mask accordingly. For instance, set your IP to 192.168.0.5 and subnet mask to 255.255.255.0

You can find the image presented above and more information in the Xilinx Wiki.

Download Ubuntu and Flash the MicroSD Card

You can download the prebuilt images from the following link: Install Ubuntu on Xilinx. With these images, you should be able to get a graphical interface automatically working using a display, keyboard, and mouse.

After downloading the image, you need to write it to your microSD card. You can flash it with a tool like Balena Etcher (https://www.balena.io/etcher/).

Alternatively, please, use the following:

1. Insert the microSD card into your computer and identify the corresponding device:

dmesg | grep sd | tail

2. Flash the downloaded image, change /dev/sdX to your corresponding device:

xzcat ~/Downloads/<image-file.xz> | sudo dd of=/dev/sdX bs=32M

3. Eject the microSD card:

sudo eject /dev/sdx

Setup the Board

1. Insert the prepared microSD card into the board.

2. Connect an HDMI or DisplayPort display.

3. Connect the USB keyboard and mouse.

4. Connect your power supply. The KV260 Starter kit will power on and boot automatically.

First Boot

Many green LEDs close to the Micro-USB connector will light as soon as the board gets power. Wait for the kernel to finish loading, and you will see the login screen with a single user named "ubuntu":

  • Log in to ubuntu with the password: ubuntu
  • It will immediately ask you to change the password. Go ahead and choose another one.

After these steps, you should see the Ubuntu 20.04 GUI Desktop.

Before proceeding with the installation check that the correct date is configured in the system with:

date

if not, set the correct date with:

TZ='America/Los_Angeles' sudo date -s '2022-08-26 16:00:00'



Previous: Getting_Started Index Next: Getting_Started/ZCU_102-106