Releases

Releases are tested, stable Kuiper images that we recommend for most users. Every release is a Kuiper 2 image. If you have an existing SD card and are unsure which generation it holds, see Checking Your Kuiper Version.

Download: ADI Kuiper Releases

Note

Kuiper 1 is the previous generation. It is deprecated and no longer maintained. New releases are Kuiper 2 only.

Release Variants

Each release is published in four variants, one for every combination of architecture (32-bit or 64-bit) and edition (Basic or Full):

Variant

Architecture

Edition

ARM 32-bit Basic

armhf (32-bit)

Basic

ARM 32-bit Full

armhf (32-bit)

Full

ARM 64-bit Basic

arm64 (64-bit)

Basic

ARM 64-bit Full

arm64 (64-bit)

Full

Choose the architecture that matches your hardware, then choose the edition that matches how you intend to use the system.

Choosing an Architecture

The architecture must match your target device. Boot files differ between the two, so a 32-bit image will not boot a 64-bit-only target and vice versa.

  • ARM 32-bit (armhf) — the default. Includes boot files for the Zynq, Arria10, and Cyclone5 platforms (ZedBoard, ZC706, DE10-Nano, etc.) as well as Raspberry Pi.

  • ARM 64-bit (arm64) — includes boot files for the ZynqMP and Versal platforms (ZCU102, ADRV9009-ZU11EG, Jupiter SDR, VCK190, etc.) as well as Raspberry Pi.

For the full architecture-to-hardware mapping, see the boot files configuration in the Configuration section.

Choosing an Edition

Basic Edition

The Basic edition is the minimal, default Kuiper image. It contains only the essential packages and configuration needed for a functional system, plus the boot files for its architecture. It has no desktop environment and no ADI libraries or tools.

It is built from the default config file, with the architecture and boot-file options set to match the variant:

  • ARM 32-bit Basic — TARGET_ARCHITECTURE=armhf with the armhf boot files (Zynq, Arria10, Cyclone5, Raspberry Pi).

  • ARM 64-bit Basic — TARGET_ARCHITECTURE=arm64 with the arm64 boot files (ZynqMP, Versal, Raspberry Pi).

Perfect for: headless applications, a foundation for custom development, and resource-constrained environments.

Full Edition

The Full edition includes everything in the Basic edition plus the complete ADI software stack and a graphical environment:

  • XFCE desktop environment with VNC server (CONFIG_DESKTOP=y)

  • The full ADI library suite (libiio, pyadi-iio, libm2k, libad9361, libad9166)

  • ADI applications (IIO Oscilloscope, Scopy) and GNU Radio

  • Additional development tools and utilities

This corresponds to the config file with all optional components enabled, built for the variant’s architecture.

Perfect for: complete development workstations, evaluation and testing, and learning the ADI ecosystem.

Tip

Need a different combination of components — say Basic plus one or two specific libraries? Build a custom image instead of using a release. See the Configuration section.

Included Components

The tables below list the main components that make up a release: the version shipped, the config option that controls it, and the Debian package it is installed from. Use the config option name to enable or disable the component in a custom build.

Note

Versions reflect the components at the time of writing and may differ between releases. The exact versions built into your image are recorded in /config and in the ADI_repos_git_info.txt build log that ships with the image.

System and Boot Components

Present in every edition. The boot files installed depend on the architecture and on the boot options selected (see Configuration).

Component

Architecture

Config option

Debian package

ADI Linux kernel

armhf, arm64

(always included)

built from the ADI Linux tree

ADI Raspberry Pi kernel (6.12)

armhf, arm64

CONFIG_RPI_BOOT_FILES

adi-rpi-boot

ADI system utilities and scripts

all

(always included)

adi-scripts

Zynq boot files

armhf

CONFIG_ARCH_ZYNQ

adi-zynq-boot

Arria10 boot files

armhf

CONFIG_ARCH_ARRIA10

adi-arria10-boot

Cyclone5 boot files

armhf

CONFIG_ARCH_CYCLONE5

adi-cyclone5-boot

ZynqMP boot files

arm64

CONFIG_ARCH_ZYNQMP

adi-zynqmp-boot

Versal boot files

arm64

CONFIG_ARCH_VERSAL

adi-versal-boot

Note

The Intel/Xilinx boot file packages bundle the U-Boot and ARM Trusted Firmware binaries required to boot those platforms.

ADI Libraries (Full Edition)

Component

Version

Config option

Debian package

libiio

v0.26

CONFIG_LIBIIO

libiio (from the Debian/Ubuntu upstream)

pyadi-iio

v0.0.20

CONFIG_PYADI

pyadi-iio (pip package)

libm2k

v0.9.0

CONFIG_LIBM2K

libm2k

libad9166-iio

v0.3.0

CONFIG_LIBAD9166_IIO

libad9166

libad9361-iio

v0.4.0

CONFIG_LIBAD9361_IIO

libad9361

ADI Applications (Full Edition)

Component

Version

Config option

Debian package

IIO Oscilloscope

v0.18.1

CONFIG_IIO_OSCILLOSCOPE

iio-oscilloscope

IIO FM Radio

v0.3.0

CONFIG_IIO_FM_RADIO

iio-fm-radio

FRU Tools

v0.8.1.7

CONFIG_FRU_TOOLS

fru-tools

JESD Eye Scan GTK

v0.2

CONFIG_JESD_EYE_SCAN_GTK

jesd-eye-scan-gtk

Colorimeter

v0.3.0

CONFIG_COLORIMETER

colorimeter

Scopy

v2.2.0

CONFIG_SCOPY

scopy

gr-m2k

v1.0.0

CONFIG_GRM2K

gr-m2k

GNU Radio

Debian repository version

CONFIG_GNURADIO

gnuradio (from the Debian repository)

Desktop Environment (Full Edition)

The Full edition also installs the XFCE desktop environment and an X11VNC server for remote graphical access, controlled by CONFIG_DESKTOP. See VNC Access for how to connect.

Building Beyond the Releases

The releases cover the two most common setups, Basic and Full. To pick an arbitrary subset of the components above, or to add options not included in any release, build a custom image. Some options only available when building your own image include:

  • Source code export (EXPORT_SOURCES) — collect the source of every package in the image.

  • Custom scripts (EXTRA_SCRIPT) — run your own script during the build. See Custom Script Integration.

  • Raspberry Pi packages (INSTALL_RPI_PACKAGES) — add raspi-config, GPIO tooling, and other Raspberry Pi specific packages.

See the Configuration section for the full list of options.