/acceleration_firmware_kv260

KV260 firmware. Package for enabling hardware acceleration capabilities in ROS 2 with KV260.

Primary LanguageCMakeApache License 2.0Apache-2.0

acceleration_firmware_kv260

Board Picture Description
Kria KV260 Vision AI Starter Kit The Kria™ KV260 starter kit is a development platform for the K26, the first adaptive Single Board Computer. KV260 offers a compact production-grade board for edge vision and robotics applications.

This repository provides AMD/Xilinx's firmware artifacts for the KV260 board using Ubuntu 22.04 meant to accelerate ROS 2 robotic applications.

NOTE on Ubuntu 22.04 integration: Ubuntu 22.04 sysroot is provided by Canonical and AMD at their own terms as available at https://ubuntu.com/download/amd-xilinx. Refer to this resource for more information. This repository leverages the resulting artifacts "as they are" and enables ROS 2 build flows while integrating hardware acceleration through Vitis and Vivado tools..

Use this ROS 2 package

Fetch from sources

To fetch it from sources, proceed as follows to include the Ubuntu 22.04 resources:

git clone https://github.com/ros-acceleration/acceleration_firmware_kv260
wget https://people.canonical.com/~platform/images/xilinx/kria-ubuntu-22.04/iot-limerick-kria-classic-desktop-2204-x06-20220614-78-sysroot.tar.xz -P acceleration_firmware_kv260/firmware/  # will take a few seconds

Fetch using VCS

When leveraging vcs, just use one of the official release links, which should include the Ubuntu 22.04 resources. E.g. include the following in your .repos file:

repositories:
  firmware/acceleration_firmware_kv260:
    type: zip
    url: https://github.com/ros-acceleration/acceleration_firmware_kv260/releases/download/v1.1.0/acceleration_firmware_kv260.zip

Hardware Acceleration capabilities

According to REP-2008's proposal.

Capability KRS alpha1 KRS beta2 KRS 1.03 (Ubuntu 22.04) KRS 1.13 (Ubuntu 22.04)
1. Kernel Levels
1.i level I kernels ✓ ✓ ✓ ✓
1.ii level II kernels ⚠️ (see this) ✓ (acceleration_examples (graph acceleration), ReconROS) ✓ (acceleration_examples (graph acceleration), ReconROS) ✓ (acceleration_examples (graph acceleration), ReconROS)
1.iii level III kernels
2. Build System
2.i ament extensions ✓ ✓ ✓ ✓
2.ii ament_acceleration support ✓ ✓ ✓
3. Build Tools
3.i hardware emulation (hw_emu)
3.ii hardware emulation (sw_emu) ⚠️
3.iii image tooling ✓ ✓
3.iv Linux kernel ✓ ✓ ✓ ✓
3.iv.a modern Linux kernel ✓ ✓ ✓ ✓
3.iv.b LTS Linux kernel ✓ ✓ ✓
3.v hypervisor ✓
3.v.a no control domain VMs ✓
3.v.b guest VMs in disk ✓
3.v.c control domain in disk ✓
3.v.d no control domain VMs in disk
3.vi network booting
3.vi.a boot artifacts
3.vi.b rootfs
3.vi.c multi-network boot
3.vi.d secure network booting
3.vi.e save in disk network boot
4. Benchmarking
4.i kernel benchmarking ✓ ✓ ✓ ✓
4.ii ROS 2 acceleration benchmarking ✓ ✓ ✓
5. Documentation
5.i in-code documentation ✓ ✓ ✓ ✓
6. Testing and CI
6.i acceleration_examples ✓ ✓ ✓ ✓

Quality Declaration

No quality is claimed according to REP-2004. This package should only be used in workstations to produced valid firmware for the targeted hardware.

Footnotes

  1. Aligns with Vitis 2020.2 release. ↩

  2. Aligns with Vitis 2021.2 release. ↩

  3. Aligns with Vitis 2022.1 release. ↩ ↩2