AppGoBox

教程

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 也把两者写在同一套文档里,但镜像不能混用:

看哪里VIM3VIM3L
芯片(SoC)晶晨 Amlogic A311D晶晨 Amlogic S905D3
CPU4 核 A73 + 2 核 A534 核 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.xzKhadas 标为 test 的 Yocto 线刷包一般不用

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

注意带 -emmc 的文件只能用 USB 线刷工具刷进 eMMC,写进 TF 卡不能正常启动;Khadas 说明只有通用镜像能装到外部存储。

方法一:写进 TF 卡或 U 盘启动

  1. 打开 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
  1. 把卡插进板子背面的 Micro-SD 卡槽(或插上 U 盘),接通电源。

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

如果插卡后仍然进入 eMMC 里的安卓,改用方法二或方法三把 Ubuntu 装进 eMMC。

方法二:USB 线刷到 eMMC

Windows:USB Burning Tool

需要本站的 USB Burning Tool(2.2.0)。本站的镜像是 .img.xz 压缩包,先用 7-Zip 解压出 -emmc.img。

  1. 解压工具包,运行 setup_v2.x.x.exe 安装。
  2. 打开 USB_Burning_tool_v2.x.x.exe,点 File → Import Image,选解压后的 -emmc.img。
  3. 用 USB-C 线把板子接到电脑(板子会自动上电),再让板子进入升级模式:2 秒内连按 3 次 Function 键后松开。

应看到:电源灯闪约 3 秒后熄灭,表示进入升级模式(Maskrom 模式);电脑识别到一个新的 USB 设备。

  1. 点 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 只有基础功能,建议接网线)。

  1. 用 balenaEtcher 把 vim3l-oowow-<版本>-sd.img.gz 写进 TF 卡。
  2. 插卡,接上网线、HDMI 显示器和 USB 键盘,接通电源,进入 OOWOW。
  3. eMMC 为空时会自动出现安装向导:连接网络 → 选择系统 → 下载并安装。eMMC 里已有安卓时,在 OOWOW 主菜单选 Write image to eMMC,可以从 Khadas 下载服务器或 U 盘选择镜像(U 盘里支持 .img、.img.xz、.img.gz、.img.zst)。
  4. 装完后关机,拔掉 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 官方说明为准。

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

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

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