瑞莎 Radxa ROCK 5T 刷机教程：SD 卡、板载 eMMC、NVMe 安装 Radxa OS

先确认型号

ROCK 5T 是 RK3588 板子，和 ROCK 5B 很像，但供电方式不同，镜像也不能混用：

如果你的板子靠 USB-C 供电，那不是 ROCK 5T，请换看对应型号的教程。

准备

• 电源：DC 12V/2A 以上适配器（DC5525 接口；支持 9～20V）。Radxa 推荐官方 DC12 36W 电源。
• 存储：microSD 卡、板载 eMMC 或 M.2 NVMe 固态硬盘。
• 一台电脑和读卡器；USB 线刷时还要一根 USB-A 转 USB-C 数据线。

下载哪个文件

打开 Radxa ROCK 5T 系统镜像页：

output_512 是 512 字节扇区的整盘镜像，可以写入 SD 卡、eMMC 或 NVMe。以后出新版本时 r7 会变，选页面上没有标“预发布”的最新版本。Radxa 下载页上的 ROCK 5T Android 镜像本站暂未收录。下载后核对 SHA-256，方法见 如何核对下载文件的 SHA-256。

方法一：装到 microSD 卡

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

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

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

方法二：装到板载 eMMC

从 SD 卡开机后用 dd 写入（不用另装 Windows 工具）

1. 按方法一用 SD 卡开机，把镜像下载或拷到板子上。
2. 解压，再写入 eMMC（eMMC 一般是 /dev/mmcblk0，先用 lsblk 确认）：

sudo apt install xz-utils
unxz rock-5t_bookworm_kde_r7.output_512.img.xz
sudo dd if=rock-5t_bookworm_kde_r7.output_512.img of=/dev/mmcblk0 bs=4M status=progress
sudo fdisk -l /dev/mmcblk0

应看到：fdisk 列出新写入的分区。

1. 关机断电，拔掉 SD 卡，再接电源，板子从 eMMC 启动。

警告dd 会覆盖目标盘。看清楚 of= 后面的设备名，别写到正在运行的 SD 卡上。

用 USB 线刷（MaskROM 模式）

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

1. 运行驱动助手里的 DriverInstall.exe，点“驱动安装（Install Driver）”。
2. 拔掉 microSD 卡和电源。
3. 按住板子左侧边缘、风扇接口下方的 Maskrom 按键不放。
4. 用 USB-A 转 USB-C 线，把电脑接到板子上边缘的 USB-C 口，再接上 DC 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 启动。

注意第 3 步如果没按住 Maskrom 键，镜像可能被写进 SPI 闪存，之后板子灯不闪、没画面。处理方法见下面“刷坏了怎么救”。

方法三：装到 NVMe 固态硬盘

ROCK 5T 有 16 MB SPI 闪存存放引导程序，NVMe 存放系统。先用 SD 卡开机：

1. 运行 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-5t_bookworm_kde_r7.output_512.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：两个 2.5G 网口任接一个，到路由器后台看新出现的设备，然后运行 ssh radxa@板子的IP。
• 更多见 开发板第一次开机与登录。

刷坏了怎么救

• 刷完 eMMC 后灯不闪、没画面：Radxa 说明这种情况大概率是线刷时没有按住 Maskrom 键，镜像被写进了 SPI 闪存，开机时先读 SPI 就会出错。解决方法：按方法二正常进入 MaskROM，在 RKDevTool 里载入 Loader 后点“下载（Download）”，存储选 SPINOR，点“切换存储（Switch Storage）”，再点“擦除所有（Erase ALL）”；清空 SPI 后按方法二重新刷 eMMC。
• 判断板子是否正常：断电，拔掉 SD 卡和 NVMe，按住 Maskrom 键，接 USB 线到电脑再接 DC 电源，绿灯亮、电脑出现新的 USB 设备，说明板子能进刷机模式。没反应先换电脑背面的 USB 口。
• 装了 NVMe 不启动：用 SD 卡开机，在 rsetup 里重新执行 Update SPI Bootloader。
• 接显示器没画面：在 /boot/extlinux/extlinux.conf 的 append 行末尾加上 video=1920x1080@60（按显示器调整）。
• 其他排查思路见 开发板刷坏了怎么救。

资料来源

按 Radxa 官方文档（ROCK 5T 产品介绍、电源选择、安装系统到 microSD 卡/eMMC/NVMe、通过 USB 刷机、常见问题、资源下载汇总，2026-10-22 查阅）和 Radxa 在 GitHub 发布的 rsdk-r7 版本信息整理。

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