瑞莎 Radxa CM5 刷机教程:CM5 载板 SD 卡与板载 eMMC 安装 Radxa OS
瑞莎 CM5 核心板配 Radxa CM5 载板装系统:选桌面版或命令行版镜像,写 microSD 卡,按核心板 Maskrom 键用 RKDevTool 线刷板载 eMMC,附默认账号。约 20 分钟。
适用于Radxa CM5 + Radxa CM5 IO 官方系统镜像
先确认组合:CM5 核心板 + Radxa CM5 载板
瑞莎 CM5 是一块 RK3588S2 核心板(带板载 eMMC),要插在载板上用。Radxa 为不同载板发布不同镜像,本页只写 CM5 + Radxa CM5 载板(CM5 IO):
| 组合 | 镜像文件名开头 | 本页是否适用 |
|---|---|---|
| CM5 + Radxa CM5 载板 | radxa-cm5-io_ | 适用 |
| CM5 + 树莓派 CM4 IO 底板 | radxa-cm5-rpi-cm4-io_ | 不适用,见文末说明 |
认 CM5 载板:板上丝印 CM5 IO;DC 圆口供电;一个全功能 USB-C 口在耳机插孔旁边;有 microSD 卡槽和 M.2 E-Key 插槽。
准备
- 电源:DC 电源适配器,支持 5V 或 12V,Radxa 推荐 12V。
- 存储:microSD 卡(8 GB 以上),或 CM5 自带的板载 eMMC。
- 一台电脑和读卡器;刷 eMMC 时还要一根 USB-A 转 USB-C 数据线。
下载哪个文件
| 版本 | 文件 | 说明 |
|---|---|---|
| rsdk-b3 | radxa-cm5-io_bookworm_kde_b3.output.img.xz | Debian 12 KDE 桌面,Radxa 标为正式版,下载页写明用于“CM5 搭载 CM5 载板”,建议选这个 |
| rsdk-b3 | radxa-cm5-io_bookworm_cli_b3.output.img.xz | 同版本命令行版,Radxa 下载页写明用于“CM5 Lite 搭载 CM5 载板” |
| rsdk-r5 | radxa-cm5-io_bookworm_kde_r5.output_512.img.xz / …_cli_r5.output_512.img.xz | 更新的版本,但 Radxa 在 GitHub 上标为预发布,Radxa 说明不对预发布版提供支持 |
下载后核对 SHA-256,方法见 如何核对下载文件的 SHA-256。Radxa 下载页上的 CM5 Android 镜像本站暂未收录。
方法一:装到 microSD 卡
- 用 7-Zip 把
.img.xz解压成.img(Radxa 要求用 balenaEtcher 前先解压)。 - 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 microSD 卡,再点“现在烧录”,等到显示完成。
- 把卡插进载板的 microSD 卡槽,接上 DC 12V 电源。
应看到:载板上的绿色电源灯亮起,进入系统后 CM5 核心板上的蓝色灯开始闪烁。
警告写入会清空整张卡。选目标时看清容量,别选成电脑上的硬盘。
方法二:装到 CM5 板载 eMMC(MaskROM 模式)
需要 Windows 电脑、本站的 RKDevTool 和驱动助手,以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin(本站暂未收录,从文末“官方资料”进入 Radxa 页面获取)。
- 运行驱动助手里的
DriverInstall.exe,点“驱动安装(Install Driver)”。 - 断开电源,拔掉 microSD 卡。
- 用 USB-A 转 USB-C 线,把电脑接到载板耳机插孔旁边的 USB-C 口(OTG 口)。
- 长按 CM5 核心板上标着 Maskrom 的小按键(不在载板上),按住的同时接上 DC 12V 电源。
应看到:RKDevTool 窗口底部显示“发现一个 MASKROM 设备”(英文界面为 Found One MASKROM Device)。Linux 上 sudo rkdeveloptool ld 显示末尾为 Maskrom 的设备。
- 在“下载镜像(Download Image)”页:Loader 一栏选
rk3588_spl_loader_v1.15.113.bin,镜像一栏选解压后的.img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”,等进度完成。 - 拔掉 USB 线,重新插拔电源,CM5 从 eMMC 启动。
Linux 和 macOS 可以用 rkdeveloptool:
sudo rkdeveloptool db rk3588_spl_loader_v1.15.113.bin
sudo rkdeveloptool wl 0 radxa-cm5-io_bookworm_kde_b3.output.img
sudo rkdeveloptool rd提示Radxa 说明 RKDevTool 同时刷多台设备会失败,批量刷机要改用 upgrade_tool(Linux / macOS 命令行工具,Radxa 说明它可以同时烧录多台设备)。
第一次开机
- 默认账号有两个:
radxa/radxa,以及rock/rock。登录后请先改密码。 - SSH:第一次开机时没有接显示器,系统会自动开启 SSH;接了显示器的话,运行
sudo systemctl enable --now ssh手动开启。 - 找 IP:载板接网线,到路由器后台看新出现的设备,然后运行
ssh radxa@板子的IP。 - 更多见 开发板第一次开机与登录。
刷坏了怎么救
- eMMC 系统起不来:插上做好的 microSD 卡开机确认核心板正常,再按方法二重新线刷 eMMC。
- 电脑识别不到 MASKROM 设备:确认数据线接的是耳机插孔旁的 USB-C 口、按的是核心板上的 Maskrom 键,并且先按住键再接电源。
- 上电不亮:确认 DC 适配器是 5V 或 12V,推荐 12V。
- 其他排查思路见 开发板刷坏了怎么救。
用树莓派 CM4 IO 底板的情况
本站另有 CM5 + 树莓派 CM4 IO 底板镜像页,但 Radxa 只发布了这个组合的镜像,没有给出它的刷机步骤(用哪个 USB 口、按哪个键、SD 卡能否直接启动)。本页不覆盖这个组合,请以 Radxa 官方说明为准。
资料来源
按 Radxa 官方文档(瑞莎 CM5 产品介绍、准备工作、系统安装、Maskrom 模式、RKDevTool、常见问题、资源下载汇总,2026-10-22 查阅)和 Radxa 在 GitHub 发布的 rsdk-b3、rsdk-r5 版本信息整理。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证