ArkOS4Clone 刷机全流程指南:DD 烧录、设备选择与黑屏自救方法
ArkOS4Clone 刷机全流程指南:DD 烧录、设备选择与黑屏自救方法
如果你手中有 R36S、K36S、RG351V/P/MP、RG36 等 RK3326 掌机,ArkOS4Clone 就是为这类"官方不直接支持"的设备移植 (d)ArkOS 4.4 系统的开源项目——它提供改好的 U-Boot、按机型区分的 DTB 设备树、一键构建与挂载脚本,让你用一条 DD 命令完成整机刷机,并在开机时自动识别机型、自动配置按键映射与屏幕参数。本文覆盖刷机前的准备、Linux 下 DD 烧录步骤、设备(DTB)正确选法,以及刷完黑屏时最常见的 5 种自救方案。
一、刷机前准备:一张卡 + 一个镜像
📌 刷机原理很简单:把完整的系统镜像"整卡写入" TF 卡(SD 卡),插卡开机即可,掌机本身不需要任何额外操作。
需要准备:
- TF 卡:建议 32GB 以上,U1/A1 以上等级(镜像解压后约 13GB 左右,空间要留足)
- 读卡器 + 电脑(Linux / macOS / Windows 均可,Windows 可用第三方刷卡工具写入 .img)
- 系统镜像:
ArkOS4Clone-YYYYMMDD.img.xz(压缩格式)与同名.md5校验文件
镜像有两种获取方式:
- 直接使用官方发布的现成镜像(最省事,推荐新手)
- 自己构建:拉取源码后运行一键构建脚本 build_image.sh:
git clone https://gitcode.com/gh_mirrors/ar/arkos4clone
cd arkos4clone
sudo ./build_image.sh /path/to/ArkOS-原始镜像.img
构建脚本会依次完成:复制镜像 → 分区扩容(boot 扩到 256MB、root 扩到 11GB)→ 写入定制 U-Boot → 挂载注入 boot/、rootfs/、roms/ 三棵树 → 卸载 → 文件系统校验 → xz 压缩,最终输出 ArkOS4Clone-日期.img.xz。构建逻辑详见 scripts/clone_support.sh 与 scripts/repart_image.sh。
下载完成后务必校验:md5sum -c ArkOS4Clone-XXXX.img.md5,校验失败请重新下载。
二、DD 烧录:一条命令刷入 TF 卡
🐧 Linux / macOS 下推荐用管道直写,无需先解压(以 /dev/sdX 为目标,注意是整块卡设备,绝不能写成 /dev/sdX1 之类的分区):
xzcat ArkOS4Clone-20260927.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
- 先用
lsblk或dmesg确认 TF 卡设备名,写错设备会清空磁盘 - 写入完成后执行
sudo sync,再安全弹出 TF 卡 - Windows 用户:先用 7-Zip 把
.img.xz解压出.img,再用 Win32DiskImager 类工具"整卡写入"
📌 写入成功后无需任何格式化、分区操作——镜像自带完整的 boot / root / roms 三个分区。
三、设备选择:DTB 才是"选对机型"的关键
ArkOS4Clone 支持 90 多个 RK3326 机型(R36S、R36Max 各 type、RG351V 各 panel、RG36、Miyoo Mini、Powkiddy 等),配置位于 boot/dArkOS/consoles/,每个机型一个文件夹,内含对应的 rk3326-xxx-linux.dtb 与 boot.ini(load mmc 1:1 ... rk3326-k36s-linux.dtb 指定开机加载哪颗设备树)。
怎么选到属于自己的配置? 项目提供了图形化的 DTB 选择工具(即 dtbTools 编译出的 dtb_selector,源码见 dtbTools/main.go),镜像里同时携带 Linux、macOS、Windows 三个版本(dtb_selector_linux32 / dtb_selector_macos / dtb_selector_win32.exe):
- 把 TF 卡插到电脑上,运行对应的 dtb_selector 可执行文件
- 按提示选择你的机型(注意同一机型的 panel1 / panel2 / type1 / type2 / origin / clone / sauce 等后缀代表不同屏幕面板与接线,选错会黑屏或画面错位,可参考 Changelog 中的命名调整记录,如 Changelog.md 中 "Type 3 Panel 1 -> Type 1 Panel 2" 的说明)
- 工具会清理 boot 分区内旧的
*.dtb / *.ini,再把你选中机型的配置复制进去
⚠️ 拿不准自己是哪块面板时,优先选择与你机器外观、屏幕方向最接近的常见面板(例如 R36S 常见的
origin panel1系列),再依据开机表现微调。
四、首次开机:系统会自动做完这些事
插上刷好的卡开机,首次启动会自动运行 boot/dArkOS/clone.sh 与 expandtoexfat.sh,完成:
- 分区扩容:把 roms 分区(p3)扩展到卡尾并转换为 exFAT,完成后写入
/boot/doneit标记,日志在/boot/boot.log - 机型检测:
console_detect探测设备名、屏幕分辨率、摇杆数量、热键类型,并写入/boot/.console - 自动配置:按机型应用 RetroArch/ES 按键映射、音量映射、SDL 屏幕旋转、音频输出通道等,日志在
/boot/clone_log.txt - OTA 升级:若
/roms/下放了update-arkos.tar(dArkOS 为update-darkos.tar),开机即自动执行 OTA 更新,注意包名必须与当前系统匹配,不匹配会直接跳过
📌 ArkOS4Clone 功能更全(含 PortMaster 移植、双 SD 卡等),dArkOS4Clone 走精简路线且暂不支持 OTA,两者按 Changelog.md 说明选择即可。
五、黑屏自救:5 种常见症状与对策
| 症状 | 最可能原因 | 自救方法 |
|---|---|---|
| 开机无显示、完全黑屏 | DTB 选错,屏幕时序不对 | 取出 TF 卡插电脑,重跑 dtb_selector 换一块 panel 配置;或直接在 PC 上编辑 boot 分区的 boot.ini,把 load mmc 1:1 ... rk3326-xxx-linux.dtb 一行改成其他机型(boot/ 分区内所有机型 DTB 都带全) |
| 连 U-Boot 启动画面都没有 | U-Boot 未写入 / SD 卡不兼容 / 卡槽问题 | 换一张 TF 卡重试;重刷整卡;或单独重烧引导区:cd uboot && ./flash_uboot.sh -i /path/to/image.img(参见 uboot/flash_uboot.sh,idbloader@32KiB、uboot@8MiB、trust@12MiB 三处偏移) |
| 停在 Logo 不动 / 偶尔花屏死机 | 镜像或下载损坏、卡速不足 | md5sum -c 重新校验并下载;换成 U3/A2 卡;避免用带集成的 USB Hub 读卡 |
| 开机反复重启或提示 OTA 错误 | 升级包与系统不匹配(ArkOS 与 dArkOS 混用) | 按 clone.sh 中 Mismatch 提示,放入正确命名的 update-arkos.tar 或 update-darkos.tar;查看 /boot/clone_log.txt 定位 |
| 以上都无效 | 卡或机器硬件问题 | 用同一张卡刷其他镜像(如原生 ArkOS)交叉验证,确认是镜像问题还是卡/机器问题 |
💡 排查黄金法则:先看日志——
/boot/clone_log.txt(机型配置日志)与/boot/boot.log(首启扩容日志)能覆盖 90% 的问题;黑屏时优先怀疑 DTB 而不是系统本身,换一块 panel 配置的成本最低。
六、常用文件路径速查
- 一键构建脚本:build_image.sh
- U-Boot 引导镜像与烧写脚本:uboot/
- 分区挂载/卸载工具:scripts/mount_arkos.sh
- 分区扩容逻辑:scripts/repart_image.sh
- 开机机型检测与配置:boot/dArkOS/clone.sh
- 首启分区转换 exFAT:boot/ArkOS/expandtoexfat.sh
- DTB 选择工具源码:dtbTools/
- ES 主题资源:roms/themes/es-theme-nes-box/
- 版本更新记录:Changelog.md
总结
ArkOS4Clone 刷机三步走:校验下载 → 整卡 DD → 选对 DTB。记住"黑屏先怀疑 DTB、排查先看 /boot 下两个日志文件",绝大多数刷坏的设备都能通过重选设备配置或重刷整卡救回来。祝你顺利点亮掌机 🎮