AppGoBox

教程

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-PCRK3588S 开源主板(裸板)
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-XfceUbuntu 22.04 桌面(6.1 内核)最新正式版(v1.3.0g,2026-09-01),大多数人选这个
Debian12-XfceDebian 12 桌面最新正式版(v1.3.0g,2026-09-01)
Ubuntu24-Gnome_alphaUbuntu 24.04 GNOME 桌面Firefly 标为 alpha 测试版(预发布),想要稳定请选上面两个
BuildrootBuildroot 精简系统2023 年的旧版本,适合嵌入式开发

用 7-Zip 解压后得到一个 .img 文件,这是 Firefly 的“统一固件”(update.img),不是直接写进 SD 卡的镜像,不能用 balenaEtcher 写卡启动。厂商没有公布校验值,页面上的 SHA-256 是本站从官方渠道获取时计算的,下载后照样核对,方法见 如何核对下载文件的 SHA-256。

方法一:用 USB 线刷进 eMMC(推荐)

RKDevTool 界面有中文和英文两种,Firefly 文档里的按钮名是英文,下面两种都写上。

  1. 解压驱动助手,运行 DriverInstall.exe,先点“驱动卸载”,再点“驱动安装”(Firefly 建议这样做,让所有设备都用新驱动)。
  2. 打开 RKDevTool(Windows 7/8 要右键“以管理员身份运行”)。如果解压后的固件包里自带 windows 文件夹和工具,Firefly 建议优先用包里自带的版本。
  3. 进入升级模式(Loader 模式):先断开电源 → 用 Type-C 数据线连接电脑和板子 → 按住设备上的 RECOVERY(恢复)键不放 → 接上电源 → 大约 2 秒后松开。Station M3 上 RECOVERY 键的位置见 Firefly Station M3 说明里的图片。

应看到:RKDevTool 底部显示“发现一个 LOADER 设备”(英文界面为 Found One LOADER Device);Windows 设备管理器里出现 Rockusb Device。

  1. 切到“升级固件(Upgrade Firmware)”页,点“固件(Firmware)”,选解压出来的 .img。工具会显示固件信息。
  2. 点“升级(Upgrade)”,等进度完成,板子会自动重启进入新系统。
  3. 升级失败的话,先点“擦除 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
DebianFirefly 的 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 · 依据 · 本站未在实机上逐一验证