Khadas VIM3L 刷机教程:TF 卡、USB Burning Tool 线刷与 OOWOW
Khadas VIM3L 装 Ubuntu:区分 VIM3L 与 VIM3,写通用镜像到 TF 卡,用 USB Burning Tool 线刷 -emmc 镜像,或从 TF 卡启动 OOWOW 安装,附 v14 版启动问题处理。约 20 分钟。
适用于Khadas VIM3L 官方系统镜像
先确认是 VIM3L,不是 VIM3
VIM3 和 VIM3L 外形和接口几乎一样,Khadas 也把两者写在同一套文档里,但镜像不能混用:
| 看哪里 | VIM3 | VIM3L |
|---|---|---|
| 芯片(SoC) | 晶晨 Amlogic A311D | 晶晨 Amlogic S905D3 |
| CPU | 4 核 A73 + 2 核 A53 | 4 核 A55 |
| 镜像文件名开头 | vim3- | vim3l- |
是 VIM3 的话,请看 Khadas VIM3 刷机教程。
Khadas 说明 VIM3 和 VIM3L 从 v14 版起换了内存配置,一些还用旧引导程序的镜像在 v14 板上启动不了。建议用本站列出的最新版镜像。
准备
- 电源:12V/2A 的 USB-C 电源(Khadas 配的是 24W USB-C 适配器)和一根 USB-C 数据线。
- 显示器(HDMI)和 USB 键盘。
- 装到 TF 卡或 U 盘:一张 TF 卡或一个 U 盘,加读卡器。
- 用 USB 线刷 eMMC:一台 Windows 电脑,或 Ubuntu 电脑。
VIM3L 出厂时 eMMC 里装的是安卓,接上电源默认进入安卓。
下载哪个文件
打开 Khadas VIM3L 官方系统镜像页,按文件名选:
| 文件名 | 用途 | 对应方法 |
|---|---|---|
vim3l-ubuntu-24.04-gnome-linux-5.15-fenix-<版本>-<日期>.img.xz(或 server) | 通用镜像,写进 TF 卡或 U 盘直接启动 | 方法一 |
同上但以 -emmc.img.xz 结尾 | 晶晨 USB 线刷包,刷进板载 eMMC | 方法二 |
vim3l-oowow-<版本>-sd.img.gz | 从 TF 卡启动 OOWOW 安装器 | 方法三 |
vim3l-yocto-<日期>-test.img.xz | Khadas 标为 test 的 Yocto 线刷包 | 一般不用 |
系统选择:要桌面选带 gnome 的,只要命令行选带 server 的,目前都是 Fenix 1.7.5(日期 250925)。下载后可以按 如何核对下载文件的 SHA-256 核对。
注意带 -emmc 的文件只能用 USB 线刷工具刷进 eMMC,写进 TF 卡不能正常启动;Khadas 说明只有通用镜像能装到外部存储。
方法一:写进 TF 卡或 U 盘启动
- 打开 balenaEtcher,点“从文件烧录”,选不带
-emmc的vim3l-ubuntu-….img.xz,点“选择目标”选 TF 卡或 U 盘,点“现在烧录”。Linux 也可以用 Khadas 给的dd命令,但dd不会自动解压,要先把.img.xz解压成.img(例如运行unxz 文件名.img.xz),再把/path/to/image换成解压后的.img、/dev/sdX换成你的卡:
sudo dd if=/path/to/image of=/dev/sdX bs=1M && sync- 把卡插进板子背面的 Micro-SD 卡槽(或插上 U 盘),接通电源。
应看到:显示器上出现 Khadas 标志,随后进入 Ubuntu。
如果插卡后仍然进入 eMMC 里的安卓,改用方法二或方法三把 Ubuntu 装进 eMMC。
警告写入会清空整张卡或整个 U 盘,选目标时看清容量。
方法二:USB 线刷到 eMMC
Windows:USB Burning Tool
需要本站的 USB Burning Tool(2.2.0)。本站的镜像是 .img.xz 压缩包,先用 7-Zip 解压出 -emmc.img。
- 解压工具包,运行
setup_v2.x.x.exe安装。 - 打开
USB_Burning_tool_v2.x.x.exe,点 File → Import Image,选解压后的-emmc.img。 - 用 USB-C 线把板子接到电脑(板子会自动上电),再让板子进入升级模式:2 秒内连按 3 次 Function 键后松开。
应看到:电源灯闪约 3 秒后熄灭,表示进入升级模式(Maskrom 模式);电脑识别到一个新的 USB 设备。
- 点 Start,等进度走完。完成后断开 USB 线,重新上电(Khadas 页面没有写这一步的细节,以工具提示为准)。
注意进度超过 15% 后中途点 Stop,eMMC 可能已被完全擦除,需要重新刷一次。电脑 USB 口供电不够时,给板子另接电源。
Function 键不好按时,也可以:按住 POWER 键不放,短按一下 RESET,数 2~3 秒后松开 POWER,Sys 灯亮起即进入升级模式。
Ubuntu 电脑:burn-tool
Khadas 说明这套工具只在 Ubuntu 上验证过。
sudo apt-get install libusb-dev git parted再用 git 克隆 Khadas 在 GitHub 上的 utils 仓库(本站暂未收录,地址见文末“官方资料”进入的 Khadas 页面),进入仓库目录安装:
sudo ./INSTALL让板子进入升级模式后检查:
lsusb | grep Amlogic应看到:ID 1b8e:c004 Amlogic, Inc. DNL。然后刷写(VIM3 和 VIM3L 都用 -b VIM3,路径换成你的镜像):
burn-tool -v aml -b VIM3 -i /path/to/vim3l-ubuntu-….-emmc.img应看到:最后输出 burn successful^_^。
更多界面说明见 Khadas VIM 刷 eMMC。
方法三:从 TF 卡启动 OOWOW 安装
VIM3L 的 SPI 闪存里没有 OOWOW,但可以从 TF 卡运行它(Khadas 标为部分支持,Wi-Fi 只有基础功能,建议接网线)。
- 用 balenaEtcher 把
vim3l-oowow-<版本>-sd.img.gz写进 TF 卡。 - 插卡,接上网线、HDMI 显示器和 USB 键盘,接通电源,进入 OOWOW。
- eMMC 为空时会自动出现安装向导:连接网络 → 选择系统 → 下载并安装。eMMC 里已有安卓时,在 OOWOW 主菜单选 Write image to eMMC,可以从 Khadas 下载服务器或 U 盘选择镜像(U 盘里支持
.img、.img.xz、.img.gz、.img.zst)。 - 装完后关机,拔掉 TF 卡再开机。
注意Khadas 提醒,有时 eMMC 里的系统会挡住从外部存储启动。插着 OOWOW 卡仍进安卓时,先用方法二刷一次 eMMC。
更多 OOWOW 用法见 Khadas OOWOW 安装器。
第一次开机和登录
- 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 启动不了、卡在启动循环:Khadas 说明 v14 板写入旧版 U-Boot 后会这样,用晶晨刷机工具重新刷写 eMMC 即可恢复。Khadas 为此提供单独的 U-Boot 刷机镜像(本站暂未收录,从文末“官方资料”进入 Khadas 页面获取);也可以按方法二重新刷一次完整的
-emmc系统镜像(Khadas 给的 burn-tool 刷写日志里可以看到引导程序 bootloader 也会一并写入)。 - Function 键进不了升级模式:也可以在串口终端开机时按空格进入 U-Boot,输入
run update;或者用镊子短接板子背面 M 寄存器(M-Register)的两个焊盘,同时短按 Reset。 - 想回到 Khadas 的 OOWOW 环境:用方法三的 OOWOW 卡开机即可,OOWOW 菜单里的 Dump image from eMMC 还能先把 eMMC 备份下来。
- 想看启动日志:USB 转 TTL 串口接 GPIO 排针:GND→17 脚,TXD→18 脚(Linux_Rx),RXD→19 脚(Linux_Tx),Khadas 的表里还列了 VCC 3.3V→20 脚。VIM3L 波特率 115200。见 用 USB 转 TTL 串口调试开发板。
资料来源
按 Khadas 官方文档(VIM3/3L Getting Started、Install OS、Boot into Upgrade Mode、Interfaces、VIM3 and VIM3L v14,OOWOW User Manual、How-To、Devices,Install OS into External Storage、Install OS into eMMC on Ubuntu、Remote access、Upgrade System、Setup Serial Tool)整理,2026-10-22 查阅。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Khadas 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证