AppGoBox

教程

瑞莎 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 数据线。

下载哪个文件

打开 CM5 + CM5 载板系统镜像页:

版本文件说明
rsdk-b3radxa-cm5-io_bookworm_kde_b3.output.img.xzDebian 12 KDE 桌面,Radxa 标为正式版,下载页写明用于“CM5 搭载 CM5 载板”,建议选这个
rsdk-b3radxa-cm5-io_bookworm_cli_b3.output.img.xz同版本命令行版,Radxa 下载页写明用于“CM5 Lite 搭载 CM5 载板”
rsdk-r5radxa-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 卡

  1. 用 7-Zip 把 .img.xz 解压成 .img(Radxa 要求用 balenaEtcher 前先解压)。
  2. 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 microSD 卡,再点“现在烧录”,等到显示完成。
  3. 把卡插进载板的 microSD 卡槽,接上 DC 12V 电源。

应看到:载板上的绿色电源灯亮起,进入系统后 CM5 核心板上的蓝色灯开始闪烁。

方法二:装到 CM5 板载 eMMC(MaskROM 模式)

需要 Windows 电脑、本站的 RKDevTool 和驱动助手,以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin(本站暂未收录,从文末“官方资料”进入 Radxa 页面获取)。

  1. 运行驱动助手里的 DriverInstall.exe,点“驱动安装(Install Driver)”。
  2. 断开电源,拔掉 microSD 卡。
  3. 用 USB-A 转 USB-C 线,把电脑接到载板耳机插孔旁边的 USB-C 口(OTG 口)。
  4. 长按 CM5 核心板上标着 Maskrom 的小按键(不在载板上),按住的同时接上 DC 12V 电源。

应看到:RKDevTool 窗口底部显示“发现一个 MASKROM 设备”(英文界面为 Found One MASKROM Device)。Linux 上 sudo rkdeveloptool ld 显示末尾为 Maskrom 的设备。

  1. 在“下载镜像(Download Image)”页:Loader 一栏选 rk3588_spl_loader_v1.15.113.bin,镜像一栏选解压后的 .img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”,等进度完成。
  2. 拔掉 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 官方说明为准。

适用的固件与系统镜像(1)

按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。

整理:AppGoBox · 依据 · 本站未在实机上逐一验证