Firefly ROC-RK3588S-PC / Station M3 刷机教程:RKDevTool 线刷到 eMMC
Firefly ROC-RK3588S-PC 和 Station M3 装 Ubuntu、Debian 或 Buildroot:解压统一固件,按 RECOVERY 键进 Loader 模式,用 RKDevTool 或 upgrade_tool 刷进 eMMC,附默认账号和 MaskRom 救砖。约 20 分钟。
适用于Firefly ROC-RK3588S-PC / Firefly Station M3 官方系统镜像
先确认型号:ROC-RK3588S-PC 还是 Station M3
两者是同一块主板,用同一套系统文件:
| 型号 | 是什么 |
|---|---|
| Firefly ROC-RK3588S-PC | RK3588S 开源主板(裸板) |
| Firefly Station M3 | 装在 Firefly 外壳里的迷你主机,Firefly 的 Station M3 刷机说明里用的就是 ROC-RK3588S-PC 开发板 |
本页的文件不能刷到 ITX-3588J、Station P2 等其他 Firefly 板子上。RK3588 的 ITX-3588J 请看 Firefly ITX-3588J 刷机教程。
准备
- 一台 Windows 电脑(Linux 也可以,见方法一后面的说明)。
- 质量好的 Type-C 数据线。
- 本站的 RKDevTool 和驱动助手,以及 7-Zip。
- 板子的电源适配器。
下载哪个文件
打开 Firefly ROC-RK3588S-PC / Station M3 系统镜像页,每个系统一个 .7z 压缩包,文件名格式是 ROC-RK3588S-PC_系统名_版本_日期.7z:
| 文件名包含 | 系统 | 说明 |
|---|---|---|
Ubuntu22.04-Xfce | Ubuntu 22.04 桌面(6.1 内核) | 最新正式版(v1.3.0g,2026-09-01),大多数人选这个 |
Debian12-Xfce | Debian 12 桌面 | 最新正式版(v1.3.0g,2026-09-01) |
Ubuntu24-Gnome_alpha | Ubuntu 24.04 GNOME 桌面 | Firefly 标为 alpha 测试版(预发布),想要稳定请选上面两个 |
Buildroot | Buildroot 精简系统 | 2023 年的旧版本,适合嵌入式开发 |
用 7-Zip 解压后得到一个 .img 文件,这是 Firefly 的“统一固件”(update.img),不是直接写进 SD 卡的镜像,不能用 balenaEtcher 写卡启动。厂商没有公布校验值,页面上的 SHA-256 是本站从官方渠道获取时计算的,下载后照样核对,方法见 如何核对下载文件的 SHA-256。
警告刷统一固件会重写主板上所有分区和分区表,清空 eMMC 里的全部数据。有要保留的数据,先备份。
方法一:用 USB 线刷进 eMMC(推荐)
RKDevTool 界面有中文和英文两种,Firefly 文档里的按钮名是英文,下面两种都写上。
- 解压驱动助手,运行
DriverInstall.exe,先点“驱动卸载”,再点“驱动安装”(Firefly 建议这样做,让所有设备都用新驱动)。 - 打开 RKDevTool(Windows 7/8 要右键“以管理员身份运行”)。如果解压后的固件包里自带
windows文件夹和工具,Firefly 建议优先用包里自带的版本。 - 进入升级模式(Loader 模式):先断开电源 → 用 Type-C 数据线连接电脑和板子 → 按住设备上的 RECOVERY(恢复)键不放 → 接上电源 → 大约 2 秒后松开。Station M3 上 RECOVERY 键的位置见 Firefly Station M3 说明里的图片。
应看到:RKDevTool 底部显示“发现一个 LOADER 设备”(英文界面为 Found One LOADER Device);Windows 设备管理器里出现 Rockusb Device。
- 切到“升级固件(Upgrade Firmware)”页,点“固件(Firmware)”,选解压出来的
.img。工具会显示固件信息。 - 点“升级(Upgrade)”,等进度完成,板子会自动重启进入新系统。
- 升级失败的话,先点“擦除 Flash(EraseFlash)”,再重新点“升级(Upgrade)”。
Linux 电脑不用装驱动,用本站的 upgrade_tool,板子进入 Loader 模式后运行:
sudo upgrade_tool uf ROC-RK3588S-PC_Ubuntu22.04-Xfce-r31173_v1.3.0g_260901.img失败时先擦除再写:
sudo upgrade_tool ef ROC-RK3588S-PC_Ubuntu22.04-Xfce-r31173_v1.3.0g_260901.img
sudo upgrade_tool uf ROC-RK3588S-PC_Ubuntu22.04-Xfce-r31173_v1.3.0g_260901.img命令里的文件名换成你实际解压出来的 .img 名称。
提示系统已经能开机时,也可以不按键:连好 Type-C 线,在串口终端或 adb 里运行 reboot loader,板子会直接进入 Loader 模式。
方法二:用 SD 卡升级
Firefly 也提供“升级卡”方式:在 Windows 上用 Firefly 的 SD_Firmware_Tool 做卡工具,勾选 Upgrade Firmware,点 Firmware 选解压出的统一固件,选中 TF 卡后点 Create;把卡插进主板上电,主板会自动把固件写进 eMMC,完成后取出卡、主板自动重启。Firefly 建议用 32 GB 及以下的卡。
本站收录的是瑞芯微 SD 卡工具 SDDiskTool,Firefly 文档没有说明它和 SD_Firmware_Tool 的版本对应关系;想完全按 Firefly 文档操作,请从文末“官方资料”进入 Firefly 下载页获取 SD_Firmware_Tool。
第一次开机:怎么登录
Firefly Linux 指南写明的默认账号:
| 系统 | 账号 |
|---|---|
| Ubuntu 桌面版 | 开机自动登录 firefly 用户,密码 firefly;root 默认没有密码,用 sudo passwd root 自行设置。接了调试串口时,串口终端自动登录 root |
| Buildroot | 用户 root,密码 firefly |
| Debian | Firefly 的 Debian 手册只说用法和 Ubuntu 基本一致(文中配置路径在 /home/firefly 下),没有单独写明用户名和密码,以首次开机实际情况为准 |
登录后请先修改密码。
刷坏了怎么救
- 进不了 Loader 模式:改用 MaskRom 模式。断开电源,按住板上的 MASKROM 键,再接上电源,板子会进入 MaskRom 模式;RKDevTool 底部显示“发现一个 MASKROM 设备”后,按方法一第 4 步刷统一固件。
- Firefly 提醒:MaskRom 是变砖后的最后手段,涉及硬件操作,有一定风险,只在进不了 Loader 模式时使用。进入 MaskRom 的原理是让系统认为 eMMC 数据出错,eMMC 里的数据会被清除。
- 刷写时提示 Download Boot Fail 或中途出错:多半是 USB 线接触不良、线材质量差,或电脑 USB 口供电不足,换线、换电脑 USB 口再试。
- 想看启动日志:用 USB 转 TTL 串口,Firefly 的 RK3588 板子波特率是 1500000,见 用 USB 转 TTL 串口调试开发板。更多瑞芯微线刷背景见 瑞芯微开发板 USB 线刷教程。
资料来源
按 Firefly 官方 Wiki(ROC-RK3588S-PC 手册与 Station M3 手册的使用 USB 线缆升级固件、MaskRom 模式、使用 SD 卡升级固件)和 Firefly Linux 开发指南(用户和密码、Debian 手册)整理(2026-10-22 查阅)。本站镜像为 Firefly 官方发布的统一固件,厂商未公布校验值。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置以你的板子丝印和 Firefly 官方说明为准。
适用的固件与系统镜像(1)
按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证