Radxa CM3I 刷机教程：CM3I IO 底板 SD 卡、eMMC、NVMe 安装 Radxa OS

先确认是 CM3I + CM3I IO 底板

本页只适用于瑞莎 Radxa CM3I 工业级核心板（Rockchip RK3568J）插在 Radxa CM3I IO 底板上的组合，对应 Radxa CM3I + CM3I IO 系统镜像页。

三种核心板的镜像、Loader 和进入刷机模式的方法都不同，不能混用。

准备

• 电源：CM3I IO 底板用 12V/3A 直流电源，也支持 PoE。Radxa 推荐官方 DC12 36W 电源。
• 存储：microSD 卡、核心板自带的 eMMC 或 M.2 NVMe 固态硬盘任选一种。Radxa 推荐把系统装在 NVMe 上。
• 一台电脑和读卡器；线刷 eMMC 时还要一根 USB-A 转 USB-A 数据线。
• 装核心板时先对齐四个固定孔，一边压一半再压另一边，最后逐边压到底；不要按压中间悬空的位置。

下载哪个文件

打开 Radxa CM3I + CM3I IO 系统镜像页：

以后 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 电源。

应看到：电源指示灯亮起，大约 40 秒后显示器出现桌面。

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

方法二：用 USB 线刷进核心板 eMMC（MaskROM 模式）

RKDevTool 界面有中文和英文两种，下面按钮名两种都写上。需要 Windows 电脑、本站的 RKDevTool 和驱动助手，以及 Radxa CM3I 下载页上的 Loader 文件（本站暂未收录，从文末“官方资料”进入 Radxa 页面获取）。Radxa 页面上这个链接显示为 RK356x_SPL_Loader_v1.15.113.bin，下载下来的实际文件名是 rk356x_spl_loader_ddr1056_v1.10.111.bin，以你下载到的文件为准。

1. 运行驱动助手里的 DriverInstall.exe，点“驱动安装（Install Driver）”。装过旧版就先点“驱动卸载（Uninstall Driver）”。
2. 断电，拔掉底板上的 microSD 卡。
3. 同时按住核心板上的 Maskrom Button（SPI Flash）和 Maskrom Button（eMMC）两个小按键，保持按住。按 Radxa 的标注图，SPI Flash 键在核心板上边缘 SPI Flash 芯片下方，eMMC 键在无线模块下方（以 Radxa 标注图为准）。
4. 用 USB-A 转 USB-A 线，把电脑接到底板的 OTG 口。按 Radxa 的接线图，它是底板下边缘、两个网口右边紧挨着的那个 USB-A 口（以 Radxa 接线图为准）。
5. 接上电源，进入 MaskROM 模式后松开按键。

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

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

Linux 和 macOS 可以用 rkdeveloptool 完成同样的写入（Loader 换成你下载到的文件名）：

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

方法三：装到 NVMe 固态硬盘

NVMe 启动要先往 SPI Flash 写入引导程序。Radxa 的做法是先用 SD 卡开机：

1. 按方法一做好 SD 卡并开机，连上网络。
2. 打开终端，更新系统：

sudo apt-get update && sudo apt-get full-upgrade

1. 运行 rsetup，进入 System Maintenance → Update SPI Bootloader，选中候选项后等待写入成功。
2. 装好 M.2 NVMe 固态硬盘，运行 lsblk，确认能看到 nvme0n1。
3. 把镜像文件拷到板子上，写入 NVMe：

sudo xzcat radxa-cm3i-io_bookworm_kde_r2.output_512.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress

1. 关机，拔掉 SD 卡，再上电。

应看到：大约 53 秒后出现桌面，系统已从 NVMe 启动。

警告dd 会覆盖目标盘的全部数据。执行前用 lsblk 再确认一次设备名是 nvme0n1。

第一次开机

• 默认账号：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密码。
• 更多说明见 开发板第一次开机与登录。

刷坏了怎么救

• 清空 eMMC 或 SPI Flash：按方法二进 MaskROM（同时按住两个按键），在 RKDevTool 里选 Loader 后点“下载（Download）”，点“读取 Capability（ReadCapability）”，存储切到 eMMC（或 SPINOR）后点“切换存储（Switch Storage）”，再点“擦除所有（Erase ALL）”，最后点“重启设备（Reset Device）”。Linux 下清空 SPI 用 sudo rkdeveloptool ef。
• 系统还能进、想取消 NVMe 引导：运行 rsetup，选 System Maintenance → Erase SPI Bootloader，选 OK 后按空格选中 radxa-cm3i-io。擦除后依赖 SPI 引导的 NVMe 将无法启动。
• 装了 NVMe 不启动：用 SD 卡开机，在 rsetup 里重新执行 Update SPI Bootloader。
• RKDevTool 显示没有发现设备：重装驱动助手里的驱动，重新同时按住两个按键再上电。
• 想看启动日志：用 USB 转 TTL 串口，见 用 USB 转 TTL 串口调试开发板。通用救砖思路见 开发板救砖与恢复。

资料来源

按 Radxa 官方文档（CM3I 资源下载汇总、快速上手、电源选择、安装系统到 microSD 卡与 NVMe、通过 USB 刷机、清除 eMMC 或 SPI Flash、手动清空 SPI Flash，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 radxa-cm3i-io rsdk-r2 版本信息整理。

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