镜像安装

Kickpi K7 / K7C 默认板载 eMMC 闪存，且直接从 eMMC 启动系统。若需更换 eMMC 中已安装的系统，或通过其他存储设备（如 TF 卡）旁加载其他操作系统，请参阅本章内容并按步骤操作。

Tip

本章节中，采用K7作为镜像安装操作示例。

镜像获取

从百度网盘获取Kickpi K7 / K7C镜像文件。

├── Android14       // Android 14 Tablet 桌面镜像
├── Armbian         // Armbian Ubuntu2404 镜像
├── Debian12        // Debian12 xfce 桌面镜像
└── Ubuntu2404      // Ubuntu2404 xfce 桌面镜像

Android, Ubuntu, Debian镜像安装

Warning

Android，Ubuntu，Debian系统均支持此章节中镜像安装的操作方法，Armbian 镜像与Rockchip 官方镜像存在差异，无法使用本安装章节中的操作方法，安装Armbian镜像请阅读下文独立章节。

USB 安装

通过 USB TYPE-C 将镜像烧录至主板 EMMC 中（使用SD卡安装或从SD卡中启动系统请阅读SD安装）。

硬件安装

硬件：Windows 系统电脑 / 笔记本、电源适配器、HDMI 显示器（可选配）、USB Type-C 数据线（部分廉价 Type-C 数据线仅支持供电，需确保使用支持数据传输的数据线）。有用户反馈，使用 Type-C to C数据线时，偶发安装失败的情况；更换为 USB-A to C 数据线后，即可正常使用。

Warning

FPC 天线表面为裸露金属层，应避免与电路板直接接触。此外，该天线工作时可能产生电磁干扰，干扰 DDR 信号传输，请将天线远离 DDR、SoC 。

安装步骤

下载 USB 驱动 DriverAssiant ，打开解压文件夹中的 DriverInstall.exe。

下载 RKDevTool ，打开解压文件夹中的 RKDevTool.exe。

6f52ad7c-b238-450a-8412-7c3dc8bc244b

USB TYPE-C 线连接主板和电脑，主板进入 MASKROM 安装模式，RKDevTool 工具上能够识别到 MASKROM 设备。

Note

MASKROM强制安装模式：
主板断电状态下，长按 MASKROM 按钮（不要松开），接通电源，此时绿色LED常亮，松开 MASKROM 按钮，连接USB烧录线，烧录工具识别到 MASKROM 设备。
主板通电状态下，长按 MASKROM 按钮（不要松开），再短按一下 RESET 按钮，烧录工具识别到 MASKROM 设备，松开 MASKROM 按钮。

选择镜像文件并烧录

1. 点击 Upgrade Firmware，跳转到升级固件界面；点击 Firmware，选择要烧录的镜像 update-*.img。

2. 点击 Upgrade，等待烧录完成。

Success

主板连接显示屏状态下，烧录完成请勿立即断电，系统会自行开机，等待系统正常进入桌面！
主板未连接显示屏状态下，烧录完成请勿立即断电，系统会自行开机，LED状态发生变化，绿色LED常亮，蓝色LED持续闪烁！

SD 安装

K7 / K7C 配备 1 个 SD 卡槽（兼容微型 SD 卡，又称 TransFlash 或 TF 卡），该卡槽亦可作为可引导启动设备。在 K7 / K7C 的启动顺序中，SD 卡拥有更高的优先级，因此设备会优先尝试从 SD 卡启动；当未检测到可挂载的 SD 卡时，再从板载 eMMC 启动。因芯片原厂官方工具统一使用术语 SD（微型 SD 卡）而非 TF 卡，故本文档中均采用 SD 卡表述，TF 卡与 SD 卡在本文中含义一致。

通过芯片原厂工具可制作两种类型的启动卡：SD 启动卡的工作模式类似便携版操作系统（如 Windows PE），主要用于设备的各类维护与故障修复操作，也可用于验证用户的自定义系统配置；第二种为SD 安装卡，当需要通过 SD 卡向板载 eMMC 烧录新系统镜像时，需制作该类型启动卡。此卡内置专用脚本，可完成 eMMC 的分区创建、文件系统格式化及镜像文件拷贝等操作。请务必确认自身使用需求，制作对应的 SD 卡。

Note

SD卡支持格式：exfat、NTFS
SD 启动卡（SD Boot）：含引导程序与完整系统镜像，支持设备从 TF 卡直接启动，适用于内置存储故障、开发调试等场景。
SD 安装卡（Upgrade Firmware）：存储固件镜像和安装脚本，用于向设备内置存储（例如 eMMC）写入或升级固件。

下载 SDDiskTool ，打开解压文件夹中的 SD_Firmware_Tool.exe，将 SD 卡插入电脑。

Note

SDDiskTool默认显示语言为中文，如需改为英文，找到下方示意图中config.ini文件，将[Language]下方Selected=1修改为Selected=2，保存后重新启动SDDiskTool。

SD 启动卡

Note

主板 eMMc 和 SD 启动卡同时存在镜像系统时，系统优先从SD卡启动。

eMMC 擦除

Note

当板载 eMMC 中预装Android操作系统时，而 SD 卡中已写入其他Linux系统并尝试从 SD 卡启动时，启动会失败。其原因在于：设备的启动流程会优先进入板载 eMMC 中的 U-boot 引导程序 —— 当未检测到可挂载的 SD 卡时，设备直接加载板载 eMMC 中的内核与根文件系统；当检测到外置 SD 卡时，板载 eMMC 中的 U-boot 会尝试将控制权移交给 SD 卡中的 U-boot。但 Linux系统搭载了其他版本的引导程序（U-boot），该版本与板载 eMMC 中的版本 U-boot 不兼容，无法加载 Linux 的 U-boot。针对这种情况，我们需要擦除板载 eMMC 中的现有系统。

操作步骤

1. 下载 USB 驱动 DriverAssiant ，打开解压文件夹中的 DriverInstall.exe。

2. 运行RKDevTool，先关闭设备电源，长按RECOVER按键并保持按压状态，随后给设备上电；当 RKDevTool 的状态栏显示Found One LOADER Device（发现 LOADER 设备）时，再松开RECOVER按键。

3.选择Advanced Function标签页，点击EraseAll按钮，该操作将擦除板载 eMMC 中的所有数据。

4. 文本框显示擦除成功。

Step1. 制作 SD 启动卡

1. 选择 SD 卡。

2. 选择 SD 启动卡（SD Boot）。

3. 下载镜像，点击 Firmware 选择安装镜像 update-*.img 文件。

├── Android14       // Android 14 Tablet Desktop Image
├── Armbian         // Armbian Ubuntu2404 Image
├── Debian12        // Debian12 xfce Desktop Image
└── Ubuntu2404      // Ubuntu2404 xfce Desktop Image

4. 点击创建 SD 启动卡（SD Boot），请耐心等待 SD 启动卡创建完成。

Note

创建 SD 启动卡过程中，SDDiskTool 会确认是否格式化SD卡，SD格式化成功时会提示安装失败，重新创建即可。
SDDiskTool出现格式化失败时，请阅读下文常见问题章节。

5. SD 启动卡创建完成。

6. 将主板断电，接入显示屏并插入SD 启动卡，重新上电启动，观察是否正常进入桌面。

Note

首次启动过程中显示屏长时间停留在ROCKCHIP KERNEL的LOGO界面（大约5~10分钟左右），等待期间显示屏可能会出现连续息屏，为正常现象。请耐心等待系统进入桌面。

SD 安装卡

SD 安装卡中镜像会强制覆盖 eMMC 中镜像。

1. 如果您的SD卡大于16GB，会出现安装失败问题，请修改SDDiskTool_v1.74/config.ini，指定格式化格式为NTFS，保存后重新启动SDDiskTool。

USER_DISK_FS=NTFS

2. 按照操作示意图中步骤进行操作。

3. SD 安装卡创建完成。

4. 将主板断电，接入显示屏并插入SD 安装卡，重新上电启动，显示器中显示安装进度条和 “check userdata/oem partition success”等字样。

Success

安装完成时，显示器中显示“Please remove SD CARD!!!,wait for reboot”. 此时拔出SD卡，等待系统重启（系统首次开机，请勿立即断电，等待系统正常进入桌面）。
未接入显示器时，在蓝色LED和绿色LED同时常亮状态下拔出SD卡，等待系统重启，蓝色LED持续闪烁。

Armbian 镜像安装

镜像获取

从百度网盘中获取 Kickpi K7 / K7C 镜像。

USB 安装

通过 USB TYPE-C 将镜像安装至主板 EMMC 中（从SD卡中启动Armbian系统请阅读SD启动卡）。

硬件安装

硬件：独立电源适配器，HDMI 显示屏（非必选），USB TYPE-C

Tip

连接显示器可更直观地观察镜像烧录是否成功。K7 / K7C 支持多种显示连接方式，本文中仅演示K7 HDMI 连接的操作方法。

安装步骤

下载 USB 驱动 DriverAssiant ，打开解压文件夹中的 DriverInstall.exe。

下载 RKDevTool，打开解压文件夹中的 RKDevTool.exe。

6f52ad7c-b238-450a-8412-7c3dc8bc244b

USB TYPE-C 线连接主板和电脑，主板进入 MASKROM 安装模式，RKDevTool 工具上能够识别到 MASKROM 设备。

Note

MASKROM强制安装模式：
主板断电状态下，长按 MASKROM 按钮（不要松开），接通电源，此时绿色LED常亮，松开 MASKROM 按钮，连接USB烧录线，烧录工具识别到 MASKROM 设备。
主板通电状态下，长按 MASKROM 按钮（不要松开），再短按一下 RESET 按钮，烧录工具识别到 MASKROM 设备，松开 MASKROM 按钮。

与 Android 及其他 Linux 发行版不同，Armbian 无法以完整镜像的形式直接进行简单安装，详情请参阅下文内容。

1. 点击 Download Image标签页，在分区表区域可查看多个分区，例如 Loader、Parameter 分区等。

2. 鼠标右键点击分区框内任意位置，打开配置选项，点击 Load Config，选择 armbian_*.cfg 文件。

3. 点击Load Config导入armbian.cfg文件后，分区表区域会同步更新，以匹配armbian.cfg中的配置内容，最终仅保留两个分区（Loader 分区与 Image 分区）。我们需要为每个分区指定对应的镜像 / 二进制文件（img/bin）。首先为 Loader 分区指定文件：点击标注为 (1) 的区域，选择MiniLoaderAll_rk3576.bin文件即可。

4. 选择 Image 分区配置，点击标注为 (2) 的区域，选择Armbian-*.img格式的镜像文件即可。

5. 勾选分区安装配置以及 Write by Address 配置（必须勾选！）。

6. 点击 Run，等待安装完成，观察显示器是否正常显示Armbian桌面。

Success

若设备已连接显示器，镜像烧录完成后设备将自动重启，等待显示器显示系统桌面即可。若未连接显示器，无法观察重启过程，可通过指示灯状态判断烧录结果：正常状态为绿色指示灯常亮、蓝色指示灯持续闪烁；烧录过程中蓝色指示灯始终熄灭，因此当蓝色指示灯开始闪烁时，即表示设备已重启完成。

SD 启动卡

eMMC 擦除

Note

当板载 eMMC 中已预装其他操作系统（如 Ubuntu、Debian、Android），而 SD 卡中已写入Armbian系统并尝试从 SD 卡启动时，启动将会失败。其原因在于：设备的启动流程会优先进入板载 eMMC 中的 U-boot 引导程序 —— 当未检测到可挂载的 SD 卡时，设备直接加载板载 eMMC 中的内核与根文件系统；当检测到外置 SD 卡时，板载 eMMC 中的 U-boot 会尝试将控制权移交给 SD 卡中的 U-boot。但 Armbian 搭载了最新版本的引导程序（U-boot），该版本与板载 eMMC 中的旧版本 U-boot 不兼容，旧版本 U-boot 无法加载 Armbian 的 U-boot。针对这种情况，我们需要擦除板载 eMMC 中的现有系统。

1. 下载 USB 驱动 DriverAssiant ，打开解压文件夹中的 DriverInstall.exe。

2. 运行RKDevTool，先关闭设备电源，长按RECOVERY按键并保持按压状态，随后给设备上电；当 RKDevTool 的状态栏显示Found One LOADER Device（发现 LOADER 设备）时，再松开RECOVERY按键。

3. 选择Advanced Function标签页，点击EraseAll按钮，该操作将擦除板载 eMMC 中的所有数据。

4. 文本框显示擦除成功。

Step1. 制作 SD 启动卡

准备工作

硬件：SD 卡（建议容量≥16GB）、SD 读卡器
软件：安装工具 balenaEtcher，Armbian镜像

操作步骤

1. 连接存储卡：将 SD 卡通过读卡器插入电脑。

2. 启动软件：使用管理员模式打开安装好的 balenaEtcher 程序。

3. 选择镜像：点击「从文件烧录」，选择您下载好的 Armbian-*.img 系统镜像文件。

4. 选择目标：点击「选择目标磁盘」，在列表中选择您刚插入的 SD 卡设备。

5. 开始烧录：确认信息无误后，点击「现在烧录」。

6. 安装完成：等待程序自动完成验证并提示成功，关闭此窗口。

在镜像无损坏的情况下，出现图示情况，可能是USB接口接触不良，请更换USB接口再次进行尝试。

17859058bae58c8ee8daf31212804ee2

Step2. 使用 SD 卡启动设备

Note

首次启动指引
1. 耐心等待：首次开机后，系统将自动进行初始化配置，请勿在此过程中断电或重启。
2. 完成标志：当屏幕显示图形化桌面或命令行登录提示符时，即表示启动完成，可正常使用。

1. 设备断电：确保您的目标主板或设备处于完全断电状态。

2. 插入启动卡：将制作好的 SD 启动卡，插入设备主板的对应卡槽中。

3. 上电启动：为设备接通电源，系统将开始从 SD 卡启动。

4. 等待启动完成：系统将正常启动，首次启动时系统可能需要数分钟进行初始化，请耐心等待系统进入桌面。

Warning

镜像烧录成功，连接MIPI显示屏，出现黑屏现象，请参考下文。

MIPI 配置

主板中已存在dtbo文件

/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-AT101DS40I.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-MX101BA1340.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-MX080B2140.dtbo
/boot/dtb-6.1.115-vendor-rk35xx/rockchip/overlay/rk3576-kickpi-lcd-mipi-F050008M01.dtbo

操作示例：连接型号为 MX080B2140 的 8寸屏，添加对应的 overlays（overlays=rk3576-kickpi-lcd-mipi-MX080B2140 添加对应的 dtbo 名称）。

$ vim /boot/armbianEnv.txt 
verbosity=1
bootlogo=true
console=both
overlay_prefix=rk35xx
fdtfile=rockchip/rk3576-kickpi-K7.dtb
rootdev=UUID=389fa6c5-33a8-4653-99ec-f532b9d5a742
rootfstype=ext4
overlays=rk3576-kickpi-lcd-mipi-MX080B2140
usbstoragequirks=0x2537:0x1066:u,0x2537:0x1068:u

工厂烧录

工厂烧录用于批量烧录（不支持 Armbian 系统批量烧录）。

下载 FactoryTool ，打开解压文件夹中的 FactoryTool.exe。

烧录镜像

1. 点击 Firmware，选择需要烧录的镜像；点击 Run，启动工厂烧录模式。

2. FactoryTool绿灯状态下，使用TYPE-C连接主板。

3. 主板进入 MASKROM 烧录模式。

Note

MASKROM强制烧录模式：
主板断电状态下，长按 MASKROM 按钮（不要松开），接通电源，此时绿色LED常亮，松开 MASKROM 按钮，连接USB烧录线，烧录工具识别到 MASKROM 设备。
主板通电状态下，长按 MASKROM 按钮（不要松开），再短按一下 RESET 按钮，烧录工具识别到 MASKROM 设备，松开 MASKROM 按钮。

4. 观察灯，当FactoryTool识别到设备会切换成红灯，此时不要拔出或接入设备。

5. 等待绿灯，重复步骤2、步骤3、步骤4，可同时烧录新的设备。

6. 烧录所有设备完成，点击 Stop。

常见问题

SDDiskTool 格式化用户盘失败问题？

出现原因：大于32G的SD卡需要使用NTFS格式的文件系统

解决方法：修改SDDiskTool_v1.74/config.ini，指定格式化格式为NTFS，保存后重新启动SDDiskTool。

USER_DISK_FS=NTFS

Armbian 镜像烧录失败问题？

如果遇到如下启动失败信息时，说明 Armbian 镜像烧录导致，无法继续烧录。

解决办法：

第一步，烧录 android / linux 的整包镜像，恢复系统。

第二步，重新进行 armbian 镜像烧录即可。