AppGoBox

教程

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

下载哪个文件

打开 Radxa ROCK 5B+ 系统镜像页:

文件说明
rock-5b-plus_bookworm_kde_r7.output_512.img.xzDebian 12 KDE 桌面版,rsdk-r7,Radxa 在 GitHub 上标为正式版(不是预发布),Radxa 下载页列出的也是它

output_512 表示 512 字节扇区的整盘镜像,可以写入 SD 卡、eMMC 或 NVMe。以后出新版本时,文件名里的 r7 会变,选页面上没有标“预发布”的最新版本即可。下载后核对 SHA-256,方法见 如何核对下载文件的 SHA-256。

方法一:装到 microSD 卡(最简单)

  1. 用 7-Zip 把 .img.xz 解压成 .img(Radxa 要求用 balenaEtcher 前先解压);用 Raspberry Pi Imager 可以直接选 .img.xz。
  2. 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选你的 microSD 卡,再点“现在烧录”,等到显示完成。
  3. 把卡插进板子的卡槽,电源接到标 POWER 的 USB-C 口。

应看到:电源指示灯亮绿色,系统正常启动后开始闪烁;接了显示器的话,大约 40 秒后出现桌面。

方法二:用 USB 线刷到板载 eMMC(MaskROM 模式)

ROCK 5B+ 的 eMMC 焊在板上,不能用读卡器,要用 USB 线刷。需要 Windows 电脑、本站的 RKDevTool 和驱动助手,以及 Radxa 下载页上的 Loader 文件 rk3588_spl_loader_v1.15.113.bin(本站暂未收录,从文末“官方资料”进入 Radxa 页面获取)。

  1. 运行驱动助手里的 DriverInstall.exe(右键以管理员身份运行),点“驱动安装(Install Driver)”。装过旧版就先点“驱动卸载(Uninstall Driver)”。
  2. 拔掉 microSD 卡和电源线。
  3. 按住板子左侧边缘、风扇接口旁边的 Maskrom 小按键。
  4. 按住不放,把电源接到左下角标 POWER 的 USB-C 口,然后松开按键。
  5. 用 USB-A 转 USB-C 线,把电脑接到板子上边缘的那个 USB-C 口(数据口)。

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

  1. 在“下载镜像(Download Image)”页:Loader 一栏选 rk3588_spl_loader_v1.15.113.bin,镜像一栏选解压后的 .img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”,等进度完成。
  2. 拔掉数据线,重新插拔电源,板子从 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 卡开机:

  1. 按方法一做好 SD 卡并开机,连上网络。
  2. 打开终端,更新系统:
sudo apt-get update && sudo apt-get full-upgrade
  1. 运行 rsetup,进入 System Maintenance → Update SPI Bootloader,选与板子对应的那一项,等待写入成功。
  2. 把 NVMe 装进板子底面的 M.2 M-Key 插槽,运行 lsblk,确认能看到 nvme0n1。
  3. 把镜像文件拷到板子上(U 盘、浏览器下载或 scp 都可以),写入 NVMe:
sudo xzcat rock-5b-plus_bookworm_kde_r7.output_512.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress
  1. 关机,拔掉 SD 卡,再上电。

提示同时插着 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 官方说明为准。

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

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

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