AppGoBox

教程

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-XfceUbuntu 22.04 桌面(6.1 内核)最新版(v1.3.0g,2026-09-01),大多数人选这个
Debian12-XfceDebian 12 桌面最新版(v1.3.0g,2026-09-01)
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 秒后松开。

应看到: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 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
DebianFirefly 的 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 官方说明为准。

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

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

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