Kria SOMs & Starter Kits

The purpose of this page is to provide developers with information and links to collateral available for the Kria Production SOMs and Starter Kits, including documentation, pre-built images, firmware updates, and GitHub repositories. It is meant to augment other official documentation found at the Kria SOM product page at amd.com.

Table of Contents

Kria Platforms Overview

Xilinx Kria is a portfolio of System-On-Modules (SOMs) designed for edge applications in a variety of use cases and production settings. The K26 and K24 SOMs are meant to be integrated directly into a customers production design and the SOM Starter Kit (e.g. KV260, KR260, KD240) are an evaluation and early development platform. The Kria lineup simplifies and accelerates the system development, helping you get your product to market faster.

Production SOMs

K26

The K26 system-on-module (SOM) is a production ready hardware platform. The K26 SOM is shipped without any preloaded FW or SW configurations in the non-volatile memory devices (QSPI and eMMC). The K26 SOMs do not include ECC support.

K24

The K24 system-on-module (SOM) is a production ready hardware platform. The K24 SOM is shipped without any preloaded FW or SW configurations in the non-volatile memory devices (QSPI and eMMC). The I-grade K24 SOM includes ECC support while the C-grade K24 SOM does not.

 

Starter Kits

Kria Starter Kits are intended to be used for initial evaluation and early development platform for the K26 and K24 SOM. They consist of either a K26 or K24 SOM coupled with an application focused carrier card. The Kria Starter Kits are shipped with a pre-loaded boot FW stored in the QSPI non-volatile memory device and a preset boot mode configuration of QSPI32. Details on QSPI memory configuration and content are outlined below. A pre-built Kria Starter Kit Linux image is provided for each SOM variant set of Starter Kits. Pre-built applications are then made available over-the-air (OTA) via Linux package feeds. Details on the Kria Starter Kit Linux images and example applications are outlined below.

KV260 Starter Kit

The KV260 is an evaluation kit based on the K26 SOM focused on vision applications.

KR260 Starter Kit

The KR260 is an evaluation kit based on the K26 SOM focused on robotics and machine vision applications.

KD240 Starter Kit

The KD240 is an evaluation kit based on the K24 SOM focused on electric drives and motor applications.

Kria Product Summary

As outlined on this page there are variants of production and corresponding starter kit SOMs. The starter kits are built with SOMs that are component/part population only variants of the production SOM. The following table summarizes the key functional difference in the Kria product variants.

Module

eMMC Populated

Thermal Solution

Temperate Range

K26 Production SOM - C Grade

Yes

Heat spreader plate

0C to 85C

K26 Production SOM - I Grade

Yes

Heat spreader plate

-40C to 100C

K24 Production SOM - C Grade

Yes

Heat spreader clam shell

0C to 85C

KV260 Starter Kit SOM

No

Fansink

0C to 35C

KR260 Starter Kit SOM

No

Fansink

0C to 35C

KD240 Starter Kit SOM

No

Passive heat sink

0C to 35C

Getting Started

First time Kria Starter Kit users should refer to the on-line “Getting Started” guide for their kit:

Developer Resources

The following section provides links to the product documentation, pre-built firmware and software binaries, and application examples.

The Kria adventure map is a map of links to help users discover useful documentation according to their evaluation stages.

Additional technical assets and resources such as 3D CAD model, bill of materials, carrier schematic, carrier PCB layout and schematic source files can be accessed in the Carrier Card Design Resources section of the following Kria Starter Kit product pages:

K26 Documentation

K24 Documentation

Kria Shared Documentation

Starter Kit Pre-Built Software

The Kria Starter Kits use a two stage boot process. The primary boot firmware is pre-installed at the factory on the QSPI device. The secondary boot device is an SD card containing the Linux kernel and Linux root filesystem (rootfs). The Starter Kit pre-built FW and SW are aligned with their specific Starter Kits. The K26 and K24 Starter Kit SD card images are available in the tables below. When using pre-built applications from the Xilinx App Store you need to ensure to align your Starter Kit Linux version with the target application assumed Linux version.

The K26 based Starter Kits are supported with Ubuntu Desktop 22.04 and the K24 Starter Kits are supported with Ubuntu Server 22.04. The configurations between the two Ubuntu OS are primarily the same with the primary functional difference being the inclusion of the desktop GUI.

K26 Starter Kit Linux

The K26 Kria Starter Kits supported with Ubuntu Desktop 22.04 for the initial out-of-box support and example applications. An embedded Linux built within Yocto is also provided as a reference implementation for customers intending to target a custom embedded Linux during evaluation and production. Each Starter Kit also has a corresponding PetaLinux BSP. The Ubuntu Desktop 22.04 is the primary OS targeted by the KV260 and KR260 pre-built applications and out of box workflows.

Ubuntu Desktop LTS

The following table outlines the Ubuntu images available for the Kria Starter Kit. For additional details on the Ubuntu support for Kria see the Xilinx Ubuntu Wiki. Kria Ubuntu default login:

  • Username: ubuntu

  • Password: ubuntu (Will be prompted to change on first login)

Kira Starter Kit users of Ubuntu 22.04 LTS should update their boot FW to the recommended version in the table below to ensure full platform functionality.

Legacy KV260 kits REQUIRE the 2022.1 boot FW update prior to booting Ubuntu 22.04. Update should be completed with your current Linux image or via the Boot Image Recovery tool.

Starter Kit Ubuntu Image

Description

Kits Supported

Recommended FW

Download Link

Starter Kit Ubuntu Image

Description

Kits Supported

Recommended FW

Download Link

Ubuntu Desktop 22.04 LTS

Kria K26 Starter Kit Ubuntu Desktop 22.04 image

KV260, KR260

2022.1 K26 Boot FW Update or later

Install Ubuntu on AMD | Ubuntu

Ubuntu Desktop 20.04 LTS

Kria Starter Kit Ubuntu Desktop 20.04 image

KV260

2021.1 K26 Boot FW Update 2 or later

Install Ubuntu on AMD | Ubuntu

Kria Ubuntu 22.04 LTS has the following known limitations:

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

  • 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 USB2.0 devices not functional on U46 interfaces. Upgrade to 2022.1 Boot FW.

K26 Embedded Linux (Yocto)

Starting with 2023.1 the Kria Starter Kits embedded Linux reference image has been built natively in Yocto to support users not using the Xilinx specific PetaLinux tool. The Kria Yocto reference image is built to support multiple platforms while the PetaLinux BSPs only support a single static HW configuration. Thus you will find a Yocto reference image that supports both K26 Starter Kits (KV260, KR260), while PetaLinux has a 1-to-1 mapping of BSPs to individual platforms. For additional details on Kria platform Yocto support see the Kria App Dev Guide. For details on Yocto vs PetaLinux support for KRia, refer to Kria SOMs & Starter Kits | Yocto Vs PetaLinux Support and Released Artifacts. Yocto image default login:

  • Username: petalinux

  • Password: Will be prompted to change on first login

K26 Starter Kit Yocto Image

Description

Kits Supported

Recommended FW

Download Link

K26 Starter Kit Yocto Image

Description

Kits Supported

Recommended FW

Download Link

Kria K26 Starter Kit embedded Linux 2023.2

Kria K26 Starter Kit embedded Linux

KV260, KR260

01.02 K26 Boot FW Update or later

Xilinx Download

Kria K26 Starter Kit embedded Linux 2023.1

Kria K26 Starter Kit embedded Linux

KV260, KR260

2023.1 K26 Boot FW Update or later

Xilinx Download

K26 PetaLinux

The following table outlines the PetaLinux based pre-built Linux images. Default login:

  • Username: petalinux

  • Password: Will be prompted to change on first login

K26 Starter Kit PetaLinux Image

Description

Kits Supported

Recommended FW

Download Link

K26 Starter Kit PetaLinux Image

Description

Kits Supported

Recommended FW

Download Link

Kria K26 Starter Kit 2022.1

2022.1 PetaLinux Starter Kit Linux pre-built SD card image

KV260, KR260

2022.1 K26 Boot FW Update

Xilinx download

Kria K26 Starter Kit 2021.1

2021.1 PetaLinux Starter Kit Linux pre-built SD card image

KV260

2021.1 K26 Boot FW Update 2 or later

Xilinx download

Kria K26 Starter Kit 2020.2.2

2020.2.2 PetaLinux Starter Kit Linux pre-built SD card image

KV260

2020.2.2 K26 Boot FW Update or later

Xilinx download

PetaLinux Images SD Card Boot “Update”

After initial boot of a new SD card image it is best practice to execute sudo dnf update (PetaLinux) or sudo apt update (Ubuntu) in order to update core utilities that may have been released following the SD card image release.

In some scenarios it may be required to clean the local dnf cache first. To do so execute sudo dnf clean all

With 2021.1 package feeds when doing dnf update you will see a number packages that are flagged for update but are only revision metadata updates. You do not need to install these dnf tracked changes, but if you do it will only update/align the associated revision information.

K26 Boot Firmware Updates

K24 Starter Kit Linux

The K24 Kria Starter Kits supported with Ubuntu Server 22.04 for the initial out-of-box support and example applications. An embedded Linux built within Yocto is also provided as a reference implementation for customers intending to target a custom embedded Linux during evaluation and production. Each Starter Kit also has a corresponding PetaLinux BSP. The Ubuntu Server 22.04 is the primary OS targeted by the KD240 pre-built applications and out of box workflows.

Ubuntu Server LTS

The following table outlines the Ubuntu images available for the K24 Kria Starter Kit. For additional details on the Ubuntu support for Kria see the Xilinx Ubuntu Wiki. Kria Ubuntu default login:

  • Username: ubuntu

  • Password: ubuntu (Will be prompted to change on first login)

Starter Kit Ubuntu Image

Description

Kits Supported

Recommended FW

Download Link

Starter Kit Ubuntu Image

Description

Kits Supported

Recommended FW

Download Link

Ubuntu Server 22.04 LTS

Kria K24 Starter Kit Ubuntu Server 22.04 image

KD240

2023.1 K24 Boot FW Update or later

https://ubuntu.com/download/amd

Known issue:

  • on certified Ubuntu 22.04 kd05, RS485 driver is not present as it is in the process of being upstreamed. It is still available on Ubuntu 22.04 kd03 version

K24 Embedded Linux (Yocto)

The K24 Kria Starter Kits embedded Linux reference image has been built natively in Yocto to support users not using the Xilinx specific PetaLinux tool. The Kria Yocto reference image is built to support multiple platforms while the PetaLinux BSPs only support a single static HW configuration. Thus you will find a Yocto reference image that supports both K24 Starter Kits (KD240), while PetaLinux has a 1-to-1 mapping of BSPs to individual platforms. For additional details on Kria platform Yocto support see the Kria App Dev Guide. For additional details on Kria platform Yocto support see the Kria App Dev Guide. For details on Yocto vs PetaLinux support for KRia, refer to Kria SOMs & Starter Kits | Yocto Vs PetaLinux Support and Released Artifacts. Yocto image default login:

  • Username: petalinux

  • Password: Will be prompted to change on first login

K24 Starter Kit Yocto Image

Description

Kits Supported

Recommended FW

Download Link

K24 Starter Kit Yocto Image

Description

Kits Supported

Recommended FW

Download Link

Kria K24 Starter Kit embedded Linux 2023.2

Kria K24 Starter Kit embedded Linux

KD240

01.02 K24 Boot FW Update or later

AMD Download - K24 Embedded Linux image

Kria K24 Starter Kit embedded Linux 2023.1

Kria K24 Starter Kit embedded Linux

KD240

2023.1 K24 Boot FW Update or later

AMD Download - K24 Embedded Linux image

Known issue:

  • RS485 Driver is not integrated in PetaLinux 2023.2, refer to AR000035701 for more information.

K24 Boot Firmware Updates (Yocto)

On-Target Utilities

The Kria runtime software provides a number of platform management helper utilities available under a common wrapper called “xmutil”. The following table summarizes these utilities which can be called using “xmutil <utility name>” in both Starter Kit Linux OS variants available. Use the -h or help functions with each utility to get detailed use instructions. Using sudo is required with many of the xmutil functions. The utilities and procedures are the same for all Kria Starter Kits.

Utility Name

Description

Utility Name

Description

xmutil boardid

Reads all board EEPROM contents. Prints information summary to command line interface.

xmutil bootfw_status

Reads primary boot device information. Prints A/B status information, image IDs, and checksums to command line interface.

xmutil bootfw_update

Tool for updating the primary boot device with a new boot image in the inactive partition.

xmutil getpkgs

Queries Xilinx package feeds and provides a summary to the debug interface of relevant packages for the active platform based on board ID information.

NOTE: This functionality is not supported in Kria Ubuntu.

xmutil listapps

Queries on the target hardware resource manager daemon of pre-built applications that are available on the platform and provides a summary to the debug interface.