AppGoBox

教程

Khadas Edge-2L 刷机教程:OOWOW、U 盘与 RKDevTool 线刷 eMMC

Khadas Edge-2L 装系统:认清刷机用的 USB-C 口 2,用 OOWOW 联网装进 eMMC、写通用镜像到 U 盘、用 RKDevTool 升级固件页线刷 -emmc 镜像,附 OOWOW 恢复方法。约 20 分钟。

适用于Khadas Edge-2L 官方系统镜像

先确认是 Edge-2L,不是 Edge2

两款都是 Khadas 的超薄 Edge 系列,接口布局很像,但芯片不同,镜像不能混用:

看哪里Edge2Edge-2L
芯片瑞芯微 RK3588S / RK3588S2瑞芯微 RK3576
正面摄像头接口3 个2 个
背面两个屏幕接口(DSI1、DSI2)一个 DSI 屏幕接口 + 一个 E-ink 墨水屏接口
镜像文件名开头edge2-edge-2l-

是 Edge2 的话,请看 Khadas Edge2 刷机教程。

两个 USB-C 口的用法不一样,后面会反复用到:

  • USB-C 口 2(USB 3.1 和 DisplayPort):接电脑刷机、进升级模式都用这个口。
  • USB-C 口 4:只用于供电。

Khadas 列出的 Edge-2L 接口里没有 TF 卡槽,下文的外部存储都按 U 盘写(Khadas 对同系列的 Edge2 说明,TF 卡只能通过扩展板或 USB 读卡器使用)。

准备

  • 电源:12V/2A 的 USB-C 电源(Khadas 配的是 24W USB-C 适配器)。
  • 一根 USB-C 数据线(刷机时接电脑和 USB-C 口 2)。
  • 显示器(HDMI)和 USB 键盘:用 OOWOW 菜单时需要。
  • 一个 U 盘:装到外部存储或恢复 OOWOW 时用。
  • 线刷 eMMC:一台 Windows 电脑,或 Ubuntu 电脑。
  • 联网:Khadas 列出的 Edge-2L 接口里没有网口,OOWOW 联网用板载 Wi-Fi。

下载哪个文件

打开 Khadas Edge-2L 官方系统镜像页,按文件名选:

文件名用途对应方法
edge-2l-ubuntu-24.04-gnome-linux-6.1-fenix-<版本>-<日期>.img.xz(或 server)通用镜像,写进 U 盘直接启动方法二
同上但以 -emmc.img.xz 结尾瑞芯微 USB 线刷固件,刷进板载 eMMC方法三
edge-2l-oowow-<版本>-sd.img.gz从 U 盘启动 OOWOW 安装器刷坏了怎么救
edge-2l-oowow-<版本>-spi-upgrade-sd.img.gz恢复 SPI 闪存里的 OOWOW刷坏了怎么救
edge-2l-oowow-<版本>-spi.img.gzSPI 闪存原始镜像,不能写进 U 盘刷坏了怎么救

系统选择:要桌面选带 gnome 的,只要命令行选带 server 的,目前都是 Fenix 1.7.6(日期 260519)。下载后可以按 如何核对下载文件的 SHA-256 核对。

注意带 -emmc 的文件只能用 USB 线刷工具刷进 eMMC;Khadas 说明只有通用镜像能装到外部存储。

方法一:用 OOWOW 联网安装到 eMMC(最简单)

Edge-2L 出厂就在 SPI 闪存里带了 OOWOW 安装器,eMMC 里没有系统时会自动进入它。这种方法从 Khadas 服务器在线下载系统,不需要本站的文件。

  1. 拔掉 U 盘,接上 HDMI 显示器和 USB 键盘,接通电源。
  2. eMMC 里已经有系统时,按住 FUNCTION 键,短按 RESET 键,再松开 FUNCTION,强制进入 OOWOW。
  3. 跟着向导走:连接 Wi-Fi → 显示可用系统 → 选择系统 → 下载并安装。

应看到:安装过程中红灯和白灯闪烁;装完后白灯常亮、红灯熄灭。

  1. 重启后从 eMMC 进入新系统。

没有显示器时:用 USB-C 线把电脑接到 USB-C 口 2,浏览器打开 外部资料(请使用来源按钮访问) 就是同样的 OOWOW 菜单;同一局域网里也可以访问 外部资料(请使用来源按钮访问) 是序列号后 5 位),但 OOWOW 防火墙默认阻止远程访问,要先在 OOWOW 菜单 Network → Firewall Mode 里改成 allow(允许局域网连接);USB 直连不受限制。

提示Khadas 说明 Edge-2L 装安卓时 KBI 的启动模式(boot mode)要是 emmc,出厂默认就是,一般不用改。

方法二:写进 U 盘启动

  1. 打开 balenaEtcher,点“从文件烧录”,选不带 -emmc 的 edge-2l-ubuntu-….img.xz,点“选择目标”选 U 盘,点“现在烧录”。Linux 也可以用 Khadas 给的 dd 命令,但 dd 不会自动解压,要先把 .img.xz 解压成 .img(例如运行 unxz 文件名.img.xz),再把 /path/to/image 换成解压后的 .img、/dev/sdX 换成你的 U 盘:
sudo dd if=/path/to/image of=/dev/sdX bs=1M && sync
  1. 把 U 盘插到板子的 USB-A 口,接通电源。Khadas 对 Edge2 的说明是 SPI 里的引导程序先找 USB,再找 eMMC。

应看到:显示器上出现 Khadas 标志,随后进入 Ubuntu。

方法三:USB 线刷到 eMMC

Windows:RKDevTool

需要本站的 RKDevTool 和驱动助手(RKDevTool 3.37、DriverAssistant 5.13)。本站的镜像是 .img.xz 压缩包,先用 7-Zip 解压出 -emmc.img。

  1. 进入驱动助手文件夹,运行 DriverInstall.exe,先点“驱动卸载(Uninstall)”,再点“驱动安装(Install)”。
  2. 运行 RKDevTool.exe,切到“升级固件(Upgrade Firmware)”页,点“固件(Firmware)”,选解压后的 -emmc.img。
  3. 用 USB-C 数据线把电脑接到板子的 USB-C 口 2(板子会自动上电)。
  4. 让板子进入升级模式:2 秒内连按 3 次 Function 键后松开。

应看到:红色电源灯闪约 3 秒后熄灭,表示进入 Maskrom 升级模式;电脑识别到新的 USB 设备,RKDevTool 底部显示“发现一个 MASKROM 设备”(英文界面为 Found One MASKROM Device)。

  1. 点“升级(Upgrade)”,等工具提示完成。板子没有自动重启的话,拔掉数据线后重新上电。

已经能进 Linux 时,也可以运行 sudo reboot loader 进入 Loader 升级模式(红灯常亮),再按上面的第 5 步刷写(RKDevTool 里已选好固件,数据线仍接 USB-C 口 2)。

Ubuntu 电脑:burn-tool

Khadas 说明这套工具只在 Ubuntu 上验证过。

sudo apt-get install libusb-dev git parted

再用 git 克隆 Khadas 在 GitHub 上的 utils 仓库(本站暂未收录,地址见文末“官方资料”进入的 Khadas 页面),进入仓库目录安装:

sudo ./INSTALL

让板子进入升级模式后检查:

lsusb | grep Rockchip

应看到:一行 Fuzhou Rockchip Electronics Company 设备(Khadas 页面给的 Edge 系列示例是 ID 2207:350b,没有单独列出 Edge-2L 的编号,以实际显示为准)。然后刷写(路径换成你的镜像):

burn-tool -v rk -i /path/to/edge-2l-ubuntu-….-emmc.img

更多 RKDevTool 的说明见 瑞芯微开发板 USB 线刷。

第一次开机和登录

  • Ubuntu 默认账号 khadas,密码 khadas,登录后请先改密码。
  • SSH:在路由器后台查到板子的 IP 后,在电脑上运行 ssh khadas@板子的IP,第一次连接输入 yes 确认。
  • OOWOW 本身:SSH 或串口登录用 root,没有密码。OOWOW 的防火墙默认阻止远程访问,用 USB 线直连电脑始终允许。

以后升级

Khadas 官方 Ubuntu 镜像可以直接在线升级:

sudo apt update
sudo apt full-upgrade
sudo reboot

刷坏了怎么救

  • eMMC 系统起不来:连按 3 次 Function 键进入 Maskrom 模式,用方法三重新刷一次 -emmc 镜像。
  • FUNCTION + RESET 进不了 OOWOW:用 balenaEtcher 把 edge-2l-oowow-<版本>-spi-upgrade-sd.img.gz 写进 U 盘,插上开机,等它自动把 OOWOW 恢复进 SPI 闪存,然后拔掉 U 盘重启。
  • 只想临时用 OOWOW:把 edge-2l-oowow-<版本>-sd.img.gz 写进 U 盘,插上开机。
  • 插了 U 盘也不从 U 盘启动:Khadas 说明有时 eMMC 里的系统会挡住外部启动,需要先清空 eMMC,再试。
  • 启动 OOWOW 时红灯一直闪或常亮:Khadas 说明启动 OOWOW 时红灯短闪 1~3 秒是正常的;一直闪烁或常亮才表示 OOWOW 启动失败,这时按上面的方法恢复 SPI 里的 OOWOW。
  • 用 Linux 电脑在线恢复 OOWOW:Khadas 还提供一个在线脚本 rockchip-burn,能从 Khadas 服务器下载最新 OOWOW 并通过 USB 写进 SPI。电脑要接板子的 USB-C 口 2(不是供电口),运行脚本后按提示连按 3 次 Function 键。命令和用法见文末“官方资料”进入的 Khadas 页面。
  • 在 OOWOW 里直接写 SPI:edge-2l-oowow-<版本>-spi.img.gz 是给 SPI 闪存的。把它放进 U 盘,在 OOWOW 的终端里运行(路径换成 U 盘的实际挂载位置):
gzip -dc /tmp/mounts/USB-sda1/edge-2l-oowow-<版本>-spi.img.gz | spi_update
  • 想看启动日志:Khadas 的 Edge-2L 串口说明直接沿用 Edge2 的:要接 Edge2 IO 扩展板,USB 转 TTL 串口接法:GND→4 脚,TXD→DRX(3 脚),RXD→DTX(2 脚),波特率 1500000。见 用 USB 转 TTL 串口调试开发板。

更多 OOWOW 用法见 Khadas OOWOW 安装器。

资料来源

按 Khadas 官方文档(Edge-2L Getting Started、Install OS、Boot into Upgrade Mode、Install OS into eMMC via OOWOW / USB Flash Tool、Interfaces、Setup Serial Debug Console,Edge2 Boot sequence,OOWOW User Manual、How-To、Devices,Edge Series Online OS Burn,Install OS into External Storage、Install OS into eMMC on Ubuntu、Remote access、Upgrade System)整理,2026-10-22 查阅。

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

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

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

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