Radxa CM3 刷机教程：CM3 IO 与树莓派 CM4 IO 底板安装 Radxa OS

先确认核心板和底板

本页适用于瑞莎 Radxa CM3 核心板（Rockchip RK3566）。CM3 本身不能单独开机，要插在底板上用。Radxa 按底板分别发布镜像，插在哪块底板上就选哪块底板的镜像：

• 核心板上印着 ROCK3 Compute Module 或 Radxa CM3。CM3I、CM3J 是另外两款 RK3568J 工业级核心板，刷机按键和接线都不一样，请看 Radxa CM3I 刷机教程 和 Radxa CM3J 刷机教程。
• Radxa 的 USB 线刷（MaskROM）步骤只写了 CM3 IO 底板的接法。用树莓派 CM4 IO 底板的话，本页只介绍 microSD 卡方式。

准备

• 电源：CM3 IO 底板用 12V DC 电源（2.1 mm 插头），也支持 PoE 供电；树莓派 CM4 IO 底板同样用 12V DC。
• 存储：microSD 卡。CM3 核心板自带 eMMC，要把系统装进 eMMC 需用 USB 线刷。
• 一台电脑和读卡器；线刷 eMMC 时还要一根 USB-A 转 Micro-USB 数据线。
• 装核心板时先对齐四个固定孔，一边压一半再压另一边，最后逐边压到底；不要按压中间悬空的位置。拆的时候从四个角依次撬，别从中间硬掰。

下载哪个文件

这两个 rsdk-r2 都是 Radxa 的正式版（非预发布），也是 Radxa CM3 下载页列出的版本。以后 Radxa 发布新版本时文件名里的 r2 会变，选不带“预发布”标记的最新版即可。下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡（两种底板通用）

1. 用 7-Zip 把 .img.xz 解压成 .img。Radxa 要求用 balenaEtcher 写入前先解压；用 Raspberry Pi Imager 可以直接选 .img.xz。
2. 打开 balenaEtcher，点“从文件烧录”选镜像，点“选择目标”选你的 microSD 卡，再点“现在烧录”，等到显示完成。写入失败就再试一次。
3. 把卡插进底板的 microSD 卡槽，接 HDMI 显示器、键鼠和网线，再接上 12V 电源。

应看到：CM3 IO 底板上电后电源指示灯亮绿色，系统正常启动后开始闪烁；大约 40 秒后显示器出现桌面。

警告写入会清空整张卡。选目标时看清容量，别选成电脑上的硬盘。

注意树莓派 CM4 IO 底板的卡槽旁印有“只用于不带 eMMC 的 CM4”，这是针对树莓派 CM4 的说明。Radxa 为 CM3 + 树莓派 CM4 IO 发布了镜像，但没有说明核心板 eMMC 里已有系统时 SD 卡和 eMMC 谁优先启动。Radxa 也没有给树莓派 CM4 IO 底板写线刷 eMMC 的步骤；插卡后进的不是新系统，而你手上有 CM3 IO 底板的话，可以把核心板换过去按方法二操作。

方法二：用 USB 线刷进核心板 eMMC（CM3 IO 底板）

RKDevTool 界面有中文和英文两种，下面按钮名两种都写上。需要 Windows 电脑、本站的 RKDevTool 和驱动助手，以及 Radxa CM3 下载页上的 Loader 文件 rk356x_spl_loader_ddr1056_v1.10.111.bin（本站暂未收录，从文末“官方资料”进入 Radxa 页面获取）。

1. 运行驱动助手里的 DriverInstall.exe，点“驱动安装（Install Driver）”。装过旧版就先点“驱动卸载（Uninstall Driver）”。
2. 把 CM3 装到 CM3 IO 底板上，拔掉底板上的 microSD 卡。
3. 上电前按住 CM3 核心板上的 SPI Disable 小按键（核心板一角，靠近板边），保持按住。
4. 用 USB-A 转 Micro-USB 线，把电脑接到 CM3 IO 底板的 OTG 口（底板上唯一的 Micro-USB 口）。
5. 插上 12V DC 电源。电源绿灯常亮就说明已进入 MaskROM 模式，这时可以松开按键。

应看到：RKDevTool 窗口底部显示“发现一个 MASKROM 设备”（英文界面为 Found One MASKROM Device）。

1. 在“下载镜像（Download Image）”页：Loader 一栏选 rk356x_spl_loader_ddr1056_v1.10.111.bin；在列表上点右键“添加项”，存储选 EMMC，镜像一栏选解压后的 .img；勾选“强制按地址写（Write by Address）”，点“执行（Run）”。
2. 提示下载完成后设备会自动重启，从 eMMC 进入系统。

Linux 和 macOS 可以用 rkdeveloptool 完成同样的写入：

sudo rkdeveloptool db rk356x_spl_loader_ddr1056_v1.10.111.bin
sudo rkdeveloptool wl 0 radxa-cm3-io_bookworm_kde_r2.output_512.img
sudo rkdeveloptool rd

更多 Rockchip 线刷细节见 Rockchip 开发板 USB 线刷教程。

第一次开机

• 默认账号：radxa，密码 radxa。登录后请先改密码。
• SSH：第一次开机时没有接显示器，系统会自动开启 SSH。接了显示器的话，先运行 sudo systemctl status ssh 查看；没有这个服务就安装 openssh-server，再运行 sudo systemctl enable --now ssh。
• 找 IP：在板子终端运行 ip a，或登录路由器后台查看，然后在电脑上运行 ssh radxa@板子的IP。
• 没有屏幕时连 Wi-Fi：写好 SD 卡后先别拔，在卡上的配置分区找到 before.txt，加一行 connect_wi-fi 你的WiFi名 你的WiFi密码。CM3 核心板带 Wi-Fi 5。
• 更多说明见 开发板第一次开机与登录。

刷坏了怎么救

• eMMC 里的系统起不来，想清空重刷：按方法二进 MaskROM（按住 SPI Disable 键），在 RKDevTool 里选 Loader 后点“下载（Download）”，点“读取 Capability（ReadCapability）”，存储切到 eMMC 后点“切换存储（Switch Storage）”，再点“擦除所有（Erase ALL）”，最后点“重启设备（Reset Device）”。然后重新刷 eMMC 或改用 SD 卡。
• 想清空 SPI Flash：同样进 MaskROM，但上电时按住的是核心板上的 eMMC Disable 键（靠近无线模块）；载入 Loader 后存储选 SPINOR，点“切换存储（Switch Storage）”再点“擦除所有（Erase ALL）”。Linux 下对应命令是 sudo rkdeveloptool db <Loader文件>、sudo rkdeveloptool ef、sudo rkdeveloptool rd。
• 系统还能进（CM3 IO 底板）：也可以运行 rsetup，选 System Maintenance → Erase SPI Bootloader，选 OK 后按空格选中 radxa-cm3-io。树莓派 CM4 IO 底板镜像对应的选项名 Radxa 没有说明。
• RKDevTool 显示没有发现设备：重装驱动助手里的驱动，重新按住按键再上电。
• 想看启动日志：用 USB 转 TTL 串口，见 用 USB 转 TTL 串口调试开发板。通用救砖思路见 开发板救砖与恢复。

资料来源

按 Radxa 官方文档（CM3 资源下载汇总、快速上手、安装系统到 microSD 卡与板载 eMMC、通过 USB 刷机、清除 eMMC 或 SPI Flash、无屏模式，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 radxa-cm3-io、radxa-cm3-rpi-cm4-io rsdk-r2 版本信息整理。

提示本页按厂商官方文档整理，本站没有在实机上测试。按键位置和文件名以你的核心板、底板和 Radxa 官方说明为准。