Image File Description¶
This document describes how to obtain KICKPI development board image files, the directory structure, naming conventions, and descriptions of each system type.
Obtaining Images¶
Image files can be obtained through the following two methods:
- Cloud storage download (recommended): Download the most recent image file for flashing.
- SDK compilation: Build the image yourself. For detailed steps, refer to the document: SDK Compilation
System Type Descriptions¶
| System Type | Description |
|---|---|
| Android | Customised based on Rockchip official code, providing Android Tablet system images. |
| Armbian | Customised based on Armbian official code, providing Ubuntu 24.04 GNOME desktop and server edition images. |
| Debian | Customised based on Rockchip official code, providing Debian Xfce desktop images. |
| Ubuntu | Customised based on Rockchip official code, providing Ubuntu Xfce desktop images. |
| UPDATE_LOG.txt | Image update log file. |
Image Naming Convention¶
Generic Image Name Breakdown (Applicable to Android / Ubuntu / Debian)¶
Example: update-rk3576-kickpi-k7-android-HDMI-202504171451.img
Field Descriptions:
| Field | Example Value | Description |
|---|---|---|
| A | update |
Indicates a complete firmware image package. |
| B | rk3576-kickpi-k7 |
SoC model (rk3576) and board model (k7). |
| C | android / ubuntu / debian |
System type (see table below). |
| D | HDMI / multi / 5-F050008M01 etc. |
Display interface type or screen model identifier. |
| E | 202504171451 |
Image build timestamp (YYYYMMDDHHMM). |
Field C Values Reference:
| Value | System Type |
|---|---|
android |
Android system image |
ubuntu |
Ubuntu system image |
debian |
Debian system image |
Screen Interface / Model Identifiers¶
| Field D | Interface Type | Supported Screen Model (Size / Resolution) | Touch Support | Notes |
|---|---|---|---|---|
10.1-AT101DS40I |
MIPI DSI | AT101DS40I (10.1", 800×1280) | Supported | |
10.1-MX101BA1340 |
MIPI DSI | MX101BA1340 (10.1", 800×1280) | Supported | |
8-MX080B2140 |
MIPI DSI | MX080B2140 (8.0", 800×1280) | Supported | |
5-F050008M01 |
MIPI DSI | F050008M01 (5.0", 720×1280) | Supported | |
HDMI |
HDMI | — | Not supported | Standard HDMI output. |
multi |
MIPI DSI | Automatically detects the above four MIPI screens; defaults to HDMI if no MIPI screen is connected | Supported | Only supported on board revision V1.3 and above! |
Armbian Image Name Breakdown¶
Armbian image files typically consist of multiple components. Below is a typical example and description.
Related Files¶
armbian.cfg: Armbian partition configuration file used by the Rockchip flashing tool.MiniLoaderAll_rk3576.bin: Loader partition configuration file for RK3576.Armbian-*.img: Main system image file.
Image Filename Breakdown¶
Example:
Armbian-unofficial_25.08.0-trunk_Kickpi-k7_noble_vendor_6.1.115_gnome_desktop.img
Field Descriptions:
| Field | Example Value | Description |
|---|---|---|
Armbian-unofficial |
Fixed prefix | Non‑official Armbian‑based image. |
25.08.0-trunk |
Version number | Image version identifier. |
noble |
Ubuntu 24.04 LTS codename | Corresponds to Ubuntu 24.04 LTS. |
Kickpi-k7 |
Board model | e.g., K7 or K7C. |
vendor |
Vendor optimisation flag | Includes vendor‑provided proprietary drivers or firmware, optimised for specific hardware. |
6.1.115 |
Kernel version | Linux kernel version number. |
gnome_desktop |
Desktop environment (optional) | Indicates the GNOME desktop edition; omitted for server edition. |
minimal |
Minimal system (optional) | Indicates a minimal server edition with no extra desktop components. |
Common Armbian Image Type Reference¶
Other Armbian images (e.g., for K7C, K7S_F) follow the same naming convention; only the board model field differs.
| Image Description | Corresponding Filename |
|---|---|
| K7 Ubuntu 24.04 GNOME Desktop | Armbian-unofficial_25.08.0-trunk_Kickpi-k7_noble_vendor_6.1.115_gnome_desktop.img |
| K7 Ubuntu 24.04 Standard Server | Armbian-unofficial_25.08.0-trunk_Kickpi-k7_noble_vendor_6.1.115.img |
| K7 Ubuntu 24.04 Minimal Server | Armbian-unofficial_25.08.0-trunk_Kickpi-k7_noble_vendor_6.1.115_minimal.img |
Update Logs¶
For update records of all images, please refer to the UPDATE_LOG.txt file located in each directory.