瑞莎 Radxa ROCK 5B+ 刷机教程:SD 卡、板载 eMMC、NVMe 安装 Radxa OS
ROCK 5B+ 装系统:区分 5B 与 5B+,写 microSD 卡,Maskrom 键加 RKDevTool 线刷板载 eMMC,rsetup 写 SPI 引导后装 NVMe,附默认账号和救砖方法。约 20 分钟。
适用于Radxa ROCK 5B+ 官方系统镜像
先确认是 ROCK 5B+,不是 ROCK 5B
两块板子长得很像,但系统镜像不能混用。
| 看哪里 | ROCK 5B+ | ROCK 5B |
|---|---|---|
| USB-C 口 | 2 个:左下角标 POWER 的是供电口,上边缘的是数据(OTG)口 | 只有 1 个(供电兼数据) |
| eMMC | 焊在板上 | 底面有 eMMC 模块插座,模块可拔插 |
| 无线 | 板载 Wi-Fi 6 / 蓝牙模块,带 M.2 B-Key 和 SIM 卡槽 | 没有板载 Wi-Fi |
| 丝印 | ROCK 5B+ V1.2 | ROCK 5B V1.45 等 |
是 ROCK 5B 的话,请看 ROCK 5B 刷机教程。
准备
- 电源:USB-C PD 电源(9V、12V、15V 或 20V,2A),或 40W 以上的 USB-C 固定电压电源。Radxa 推荐官方 PD 65W 电源,并说明 ROCK 5B+ 需要 40W。
- 存储:microSD 卡、板载 eMMC,或 M.2 NVMe 固态硬盘(板子底面有两个 M.2 M-Key 2280 插槽)。
- 一台电脑和读卡器;刷板载 eMMC 时还要一根 USB-A 转 USB-C 数据线。
下载哪个文件
| 文件 | 说明 |
|---|---|
rock-5b-plus_bookworm_kde_r7.output_512.img.xz | Debian 12 KDE 桌面版,rsdk-r7,Radxa 在 GitHub 上标为正式版(不是预发布),Radxa 下载页列出的也是它 |
output_512 表示 512 字节扇区的整盘镜像,可以写入 SD 卡、eMMC 或 NVMe。以后出新版本时,文件名里的 r7 会变,选页面上没有标“预发布”的最新版本即可。下载后核对 SHA-256,方法见 如何核对下载文件的 SHA-256。
方法一:装到 microSD 卡(最简单)
- 用 7-Zip 把
.img.xz解压成.img(Radxa 要求用 balenaEtcher 前先解压);用 Raspberry Pi Imager 可以直接选.img.xz。 - 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选你的 microSD 卡,再点“现在烧录”,等到显示完成。
- 把卡插进板子的卡槽,电源接到标 POWER 的 USB-C 口。
应看到:电源指示灯亮绿色,系统正常启动后开始闪烁;接了显示器的话,大约 40 秒后出现桌面。
警告写入会清空整张卡。选目标时看清容量,别选成电脑上的硬盘。
方法二:用 USB 线刷到板载 eMMC(MaskROM 模式)
ROCK 5B+ 的 eMMC 焊在板上,不能用读卡器,要用 USB 线刷。需要 Windows 电脑、本站的 RKDevTool 和驱动助手,以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin(本站暂未收录,从文末“官方资料”进入 Radxa 页面获取)。
- 运行驱动助手里的
DriverInstall.exe(右键以管理员身份运行),点“驱动安装(Install Driver)”。装过旧版就先点“驱动卸载(Uninstall Driver)”。 - 拔掉 microSD 卡和电源线。
- 按住板子左侧边缘、风扇接口旁边的 Maskrom 小按键。
- 按住不放,把电源接到左下角标 POWER 的 USB-C 口,然后松开按键。
- 用 USB-A 转 USB-C 线,把电脑接到板子上边缘的那个 USB-C 口(数据口)。
应看到:RKDevTool 窗口底部显示“发现一个 MASKROM 设备”(英文界面为 Found One MASKROM Device)。
- 在“下载镜像(Download Image)”页:Loader 一栏选
rk3588_spl_loader_v1.15.113.bin,镜像一栏选解压后的.img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”,等进度完成。 - 拔掉数据线,重新插拔电源,板子从 eMMC 启动。
Linux 和 macOS 可以用 rkdeveloptool 完成同样的写入:
sudo rkdeveloptool db rk3588_spl_loader_v1.15.113.bin
sudo rkdeveloptool wl 0 rock-5b-plus_bookworm_kde_r7.output_512.img
sudo rkdeveloptool rd注意Loader 用的是 Radxa 在 ROCK 5B/5B+ 共用下载页上列出的那一个文件。如果下载页以后为 5B+ 单独列出 Loader,以下载页为准。
方法三:装到 NVMe 固态硬盘
从 NVMe 启动要先往 SPI 闪存里写入引导程序。Radxa 的做法是先用 SD 卡开机:
- 按方法一做好 SD 卡并开机,连上网络。
- 打开终端,更新系统:
sudo apt-get update && sudo apt-get full-upgrade- 运行
rsetup,进入 System Maintenance → Update SPI Bootloader,选与板子对应的那一项,等待写入成功。 - 把 NVMe 装进板子底面的 M.2 M-Key 插槽,运行
lsblk,确认能看到nvme0n1。 - 把镜像文件拷到板子上(U 盘、浏览器下载或 scp 都可以),写入 NVMe:
sudo xzcat rock-5b-plus_bookworm_kde_r7.output_512.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress- 关机,拔掉 SD 卡,再上电。
警告dd 会覆盖目标盘的全部数据。执行前用 lsblk 再确认一次设备名。
提示同时插着 SD 卡、eMMC 和 NVMe 时,从哪个启动取决于 SPI 里的引导程序,Radxa 没有公布固定顺序。装好后只保留一个系统盘最省事。
第一次开机
- 默认账号:
radxa,密码radxa。登录后请先改密码。 - SSH:第一次开机时没有接显示器,系统会自动开启 SSH;接了显示器的话,在终端运行
sudo systemctl enable --now ssh手动开启。 - 找 IP:登录路由器后台看新出现的设备,然后运行
ssh radxa@板子的IP。 - 板载 Wi-Fi 要接上包装里的天线再用。更多见 开发板第一次开机与登录。
刷坏了怎么救
- 上电后反复重启:多半是电源功率不够或 PD 协商失败。换 Radxa PD 65W,或 40W 以上的 12V 固定电压 USB-C 电源。
- 刷完 eMMC 后灯不闪、没画面:可能是线刷时没有进 MaskROM,镜像写进了 SPI。重新进 MaskROM,在 RKDevTool 里载入 Loader 后点“下载(Download)”,存储选 SPINOR,点“切换存储(Switch Storage)”,再点“擦除所有(Erase ALL)”,然后重新刷 eMMC。
- 装了 NVMe 不启动:用 SD 卡开机,在
rsetup里重新执行 Update SPI Bootloader。 - 想取消 NVMe 引导:在
rsetup里选 System Maintenance → Erase SPI Bootloader,型号选rock-5b-plus。 - 判断板子能否进刷机模式:拔掉 SD 卡和 NVMe,按方法二第 3~5 步操作,电脑能识别到 MASKROM 设备,说明板子能刷机。
- 其他排查思路见 开发板刷坏了怎么救。
资料来源
按 Radxa 官方文档(ROCK 5B/5B+ 快速上手、电源、系统安装、USB 刷机进入 Maskrom 模式、资源下载汇总,2026-10-22 查阅)和 Radxa 在 GitHub 发布的 rsdk-r7 版本信息整理。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Radxa 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证