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
- 1 Kria Platforms Overview
- 1.1 Production SOMs
- 1.2 Starter Kits
- 1.2.1 KV260 Starter Kit
- 1.2.2 KR260 Starter Kit
- 1.2.3 KD240 Starter Kit
- 1.3 Kria Product Summary
- 2 Getting Started
- 3 Developer Resources
- 3.1 K26 Documentation
- 3.2 K24 Documentation
- 3.3 Kria Shared Documentation
- 3.4 Starter Kit Pre-Built Software
- 3.4.1 K26 Starter Kit Linux
- 3.4.1.1 Ubuntu Desktop LTS
- 3.4.1.2 K26 Embedded Linux (Yocto)
- 3.4.1.3 K26 PetaLinux
- 3.4.2 K26 Boot Firmware Updates
- 3.4.3 K24 Starter Kit Linux
- 3.4.3.1 Ubuntu Server LTS
- 3.4.3.2 K24 Embedded Linux (Yocto)
- 3.4.4 K24 Boot Firmware Updates (Yocto)
- 3.4.1 K26 Starter Kit Linux
- 3.5 On-Target Utilities
- 3.6 Boot FW Update Process
- 3.7 Boot FW QSPI Memory Map
- 3.8 Bitstream Management
- 3.9 Fan Control
- 3.10 PetaLinux & Ubuntu LTS
- 4 AMD-Xilinx Tools Support
- 4.1 Yocto Build instructions
- 4.2 PetaLinux Board Support Packages
- 4.2.1 K26 Platforms
- 4.2.2 K24 Platforms
- 4.2.3 PetaLinux Tools Release Notes
- 4.2.3.1 PetaLinux 2023.1 Release
- 4.2.3.2 PetaLinux 2022.1 Release
- 4.2.4 PetaLinux Build instructions
- 4.2.5 Regenerating boot firmware from BSP
- 4.3 Yocto Vs PetaLinux Support and Released Artifacts
- 4.4 Vivado Board Support Packages
- 4.4.2 SOM XDC Files
- 5 Kria Evaluation & Applications
- 6 Custom & Production SOM Design Guidance
- 6.1 Hardware
- 6.1.1 K26 Devices
- 6.1.2 K24 Devices
- 6.1.3 K26 Qualification Data
- 6.2 Firmware
- 6.2.1 MPSoC PMU FW
- 6.3 Linux
- 6.3.1 Fan Control
- 6.1 Hardware
- 7 Known Issues & Limitations
- 7.1 All Starter Kits
- 7.2 Ubuntu
- 7.3 K24 & KD240 Starter Kit
- 7.4 KR260 Starter Kit
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 |
---|---|---|---|---|
Ubuntu Desktop 22.04 LTS | Kria K26 Starter Kit Ubuntu Desktop 22.04 image | KV260, KR260 | 2022.1 K26 Boot FW Update or later | |
Ubuntu Desktop 20.04 LTS | Kria Starter Kit Ubuntu Desktop 20.04 image | KV260 | 2021.1 K26 Boot FW Update 2 or later |
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 |
---|---|---|---|---|
Kria K26 Starter Kit embedded Linux 2023.2 | Kria K26 Starter Kit embedded Linux | KV260, KR260 | 01.02 K26 Boot FW Update or later | |
Kria K26 Starter Kit embedded Linux 2023.1 | Kria K26 Starter Kit embedded Linux | KV260, KR260 | 2023.1 K26 Boot FW Update or later |
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 |
---|---|---|---|---|
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 | |
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 | |
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 |
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 |
---|---|---|---|---|
Ubuntu Server 22.04 LTS | Kria K24 Starter Kit Ubuntu Server 22.04 image | KD240 | 2023.1 K24 Boot FW Update or later |
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 |
---|---|---|---|---|
Kria K24 Starter Kit embedded Linux 2023.2 | Kria K24 Starter Kit embedded Linux | KD240 | 01.02 K24 Boot FW Update or later | |
Kria K24 Starter Kit embedded Linux 2023.1 | Kria K24 Starter Kit embedded Linux | KD240 | 2023.1 K24 Boot FW Update or later |
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 |
---|---|
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. |