AppGoBox

教程

瑞莎 Radxa ROCK 5 ITX / ITX+ 刷机教程:SD 卡、eMMC、NVMe 安装 Radxa OS

ROCK 5 ITX 和 ITX+ 装系统:电源怎么接,写 microSD 卡,开启 SDHCI 后把系统写进板载 eMMC,Maskrom 线刷,写 SPI 引导装 NVMe,附救砖方法。约 25 分钟。

适用于Radxa ROCK 5 ITX / ROCK 5 ITX+ 官方系统镜像

先确认型号

ROCK 5 ITX 是 170 × 170 mm 的 Mini-ITX 标准主板,RK3588 芯片,能装进普通电脑机箱。ROCK 5 ITX+ 是它的另一个版本,Radxa 两款共用同一个系统镜像:

看哪里ROCK 5 ITXROCK 5 ITX+
丝印V1.11 / V1.12 等ROCK 5 ITX+ V1.2
系统镜像rock-5-itx_…同一个 rock-5-itx_…

两款板上都有 eMMC、SPI 闪存、microSD 卡槽、两个 2.5G 网口和一个全功能 USB-C 口。

准备

  • 电源(三选一,不能同时接两种):12V DC 适配器(外径 5.5 mm、内径 2.5 mm、中心正极,超过 12V 可能损坏主板)、机箱 ATX 24 针电源,或装 Radxa 25W PoE+ 模组后用交换机供电。接上电源后主板会自动开机。
  • 适配器功率按外设算:主板满载约 25W,再加上由主板供电的硬盘。Radxa 的 NVMe 教程用的是 12V/8A。
  • 存储:microSD 卡、板载 eMMC 或 M.2 NVMe 固态硬盘。
  • USB 线刷时要一根 USB-A 转 USB-C 数据线。

下载哪个文件

打开 ROCK 5 ITX / ITX+ 系统镜像页:

版本文件说明
rsdk-b3rock-5-itx_bookworm_kde_b3.output.img.xzDebian 12 KDE 桌面,Radxa 标为正式版,官方下载页列出的就是它,建议选这个
rsdk-r4rock-5-itx_bookworm_kde_r4.output_512.img.xz更新的版本,但 Radxa 在 GitHub 上标为预发布,Radxa 说明不对预发布版提供支持

两个都是 512 字节扇区的整盘镜像。Radxa 下载页上的 Android 镜像本站暂未收录。下载后核对 SHA-256,方法见 如何核对下载文件的 SHA-256。

方法一:装到 microSD 卡

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

应看到:主板自动开机,接了显示器的话大约 53 秒后出现桌面。

方法二:装到板载 eMMC(从 SD 卡开机后写入)

ROCK 5 ITX 的 eMMC 默认是关闭的,要先在系统里打开:

  1. 按方法一用 SD 卡开机,用 radxa / radxa 登录。
  2. 运行 rsetup,进入 Overlays,选中 [] Enable SDHCI,显示 [*] Enable SDHCI 后退出并重启。
  3. 运行 lsblk,Radxa 说明 eMMC 默认是 mmcblk0。
  4. 把镜像拷到板子上,写入 eMMC:
sudo xzcat rock-5-itx_bookworm_kde_b3.output.img.xz | sudo dd of=/dev/mmcblk0 bs=1M status=progress
  1. 关机断电,拔掉 microSD 卡,再上电,系统从 eMMC 启动。

也可以用 USB 线刷(MaskROM 模式)

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

  1. 运行驱动助手里的 DriverInstall.exe,点“驱动安装(Install Driver)”。
  2. 拔掉 microSD 卡和电源。
  3. 按住 Maskrom 按键不放。按键在主板右侧边缘、microSD 卡槽旁边(Radxa 硬件接口图里的 24 号)。
  4. 按住不放,用 USB-A 转 USB-C 线把电脑接到主板的 USB-C 口(ROCK 5 ITX 的 OTG 口就是这个 USB-C)。
  5. 继续按住,接上 12V DC 电源,然后松开按键。Radxa 规格表写明这个 USB-C 口不能给主板供电,所以必须另接 12V 电源。

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

  1. 在“下载镜像(Download Image)”页:Loader 选 rk3588_spl_loader_v1.15.113.bin,镜像选解压后的 .img;存储选 EMMC;勾选“强制按地址写(Write by Address)”;点“执行(Run)”。
  2. 拔掉 USB 线,重新插拔电源,主板从 eMMC 启动。

注意Radxa 的线刷页只写了“按住 Maskrom 按钮、接 USB 线”。第 5 步先接线、再接 12V 电源的顺序,是本站根据“USB-C 不能供电”这条说明整理的,和 Radxa 给 ROCK 5T 写的顺序一致。

方法三:装到 NVMe 固态硬盘

  1. 用 SD 卡开机,运行 sudo apt-get update && sudo apt-get full-upgrade。
  2. 运行 rsetup,进入 System Maintenance → Update SPI Bootloader,选中对应项,等待写入成功。
  3. 把 NVMe 装进 M.2 M-Key 插槽,lsblk 确认看到 nvme0n1,写入:
sudo xzcat rock-5-itx_bookworm_kde_b3.output.img.xz | sudo dd of=/dev/nvme0n1 bs=1M status=progress
  1. 关机,拔掉 SD 卡,再上电。

提示同时有多个系统盘时,从哪个启动取决于 SPI 里的引导程序,Radxa 没有公布固定顺序。装好后只保留一个系统盘最省事。

第一次开机

  • 默认账号:radxa,密码 radxa。登录后请先改密码。
  • SSH:第一次开机时没有接显示器,系统会自动开启 SSH;接了显示器的话,运行 sudo systemctl enable --now ssh 手动开启。
  • 找 IP:到路由器后台看新出现的设备,然后运行 ssh radxa@板子的IP。
  • 更多见 开发板第一次开机与登录。

刷坏了怎么救

  • eMMC 系统起不来:插 SD 卡开机(必要时拔掉 NVMe),按方法二重新写入 eMMC,或进 MaskROM 线刷。
  • 装了 NVMe 不启动:用 SD 卡开机,在 rsetup 里重新执行 Update SPI Bootloader。
  • 想取消 SPI 引导:能开机就在 rsetup 里选 System Maintenance → Erase SPI Bootloader;开不了机就进 MaskROM,在 RKDevTool 里载入 Loader 后点“下载(Download)”,存储选 SPINOR,点“切换存储(Switch Storage)”,再点“擦除所有(Erase ALL)”。
  • 主板不开机:确认只接了一种电源;DC 适配器必须是 12V。
  • 其他排查思路见 开发板刷坏了怎么救。

资料来源

按 Radxa 官方文档(ROCK 5 ITX 产品介绍、电源选择、制作 microSD 启动盘、通过 microSD 启动盘安装系统到 eMMC、安装系统到 NVMe、通过 USB 刷机、硬件接口、资源下载汇总,2026-10-22 查阅)和 Radxa 在 GitHub 发布的 rsdk-b3、rsdk-r4 版本信息整理。

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

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

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

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