Firefly ITX-3588J 刷机教程:RKDevTool 线刷统一固件到 eMMC
Firefly ITX-3588J 装 Ubuntu、Debian 或 Buildroot:解压统一固件,按 RECOVERY 键进 Loader 模式,用 RKDevTool 或 upgrade_tool 刷进 eMMC,附默认账号、BOOT 键进 MaskRom 救砖。约 20 分钟。
适用于Firefly ITX-3588J 官方系统镜像
先确认型号
Firefly ITX-3588J 是 RK3588 的 ITX 标准主板,由核心板 Core-3588J 和底板 MB-JM3-RK3588ITX 组成,标准套装带 12V/7A 电源适配器和一根 Type-C 数据线。本页的文件只适用于 ITX-3588J,不能刷到 ROC-RK3588S-PC、Station M3 等其他 Firefly 板子上。
ITX-3588J 有不同硬件版本(V1.1 及以下、V1.2 及以上),RECOVERY 键的位置不同,操作时以板上丝印为准;系统文件不区分硬件版本。
准备
- 一台 Windows 电脑(Linux 也可以,见方法一后面的说明)。
- 质量好的 Type-C 数据线(套装里自带一根)。
- 本站的 RKDevTool 和驱动助手,以及 7-Zip。
- 板子自带的 12V 电源适配器。
下载哪个文件
打开 Firefly ITX-3588J 系统镜像页,每个系统一个 .7z 压缩包,文件名格式是 ITX-3588J_系统名_版本_日期.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) |
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 秒后松开。
应看到: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 ITX-3588J_Ubuntu22.04-Xfce-r31173_v1.3.0g_260901.img失败时先擦除再写:
sudo upgrade_tool ef ITX-3588J_Ubuntu22.04-Xfce-r31173_v1.3.0g_260901.img
sudo upgrade_tool uf ITX-3588J_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 下),没有单独写明用户名和密码,以首次开机实际情况为准 |
登录后请先修改密码。
刷坏了怎么救
Firefly 说明,一般情况下除非硬件损坏,ITX-3588J 不会变砖:
- 进不了 Loader 模式:改用 MaskRom 模式。断开电源,按住 ITX-3588J 底板上的 BOOT 键(也可以用镊子短接 Core-3588J 核心板上的两个测试点,位置见 Firefly 文档图片),再接上电源,板子会进入 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(Core-3588J / ITX-3588J 手册的介绍、升级固件介绍、使用 USB 线缆升级固件、MaskRom 模式、使用 SD 卡升级固件)和 Firefly Linux 开发指南(用户和密码、Debian 手册)整理(2026-10-22 查阅)。本站镜像为 Firefly 官方发布的统一固件,厂商未公布校验值。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置以你的板子丝印和 Firefly 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证