AppGoBox

教程

Khadas VIM4 刷机教程:OOWOW、TF 卡与 USB 线刷 eMMC

Khadas VIM4 装系统:区分 V12 与带 NPU 的新版,用 OOWOW 联网装进 eMMC、写通用镜像到 TF 卡、用 Aml Burn Tool 线刷 -emmc 镜像,附 OOWOW 恢复方法。约 20 分钟。

适用于Khadas VIM4 官方系统镜像

先确认是 VIM4,以及是哪一版

VIM4 用的是晶晨(Amlogic)A311D2 芯片,镜像文件名都以 vim4- 开头,不能和 VIM3、VIM1S 的镜像混用。VIM4 有两个硬件版本:

看哪里VIM4(V12)新版 VIM4(V13A 起,带 NPU)
芯片丝印(可能要先拆散热片)A311D2A311D2-N0D
系统里查到的 CPU 序列号以 360b 开头以 360c 开头

已经能进系统时,运行下面的命令查看 CPU 序列号:

grep -ohm1 360[b\|c].* /proc/cpu*

本站收录的 VIM4 镜像来自 Khadas 的 vim4 下载目录,下载目录里没有按这两个版本分开放文件。

准备

  • 电源:12V/2A 的 USB-C 电源(Khadas 配的是 24W USB-C 适配器)和一根 USB-C 数据线。
  • 显示器(HDMI)和 USB 键盘:用 OOWOW 菜单时需要;没有显示器也可以用网页操作,见方法一。
  • 装到 TF 卡或 U 盘:一张 TF 卡或一个 U 盘,加读卡器。
  • 用 USB 线刷 eMMC:一台 Windows 电脑,或 Ubuntu 电脑。

下载哪个文件

打开 Khadas VIM4 官方系统镜像页,按文件名选:

文件名用途对应方法
vim4-ubuntu-24.04-gnome-linux-5.15-fenix-<版本>-<日期>.img.xz(或 server)通用镜像,写进 TF 卡或 U 盘直接启动方法二
同上但以 -emmc.img.xz 结尾晶晨 USB 线刷包,刷进板载 eMMC方法三
vim4-oowow-<版本>-sd.img.gz从卡启动 OOWOW 安装器刷坏了怎么救
vim4-oowow-<版本>-spi-upgrade-sd.img.gz恢复 SPI 闪存里的 OOWOW刷坏了怎么救
vim4-oowow-<版本>-spi.img.gzSPI 闪存原始镜像,不能写卡刷坏了怎么救
vim4-yocto-<日期>-test.img.xzKhadas 标为 test 的 Yocto 线刷包一般不用

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

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

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

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

  1. 取出 TF 卡(TF 卡的启动优先级最高,插着卡进不了 OOWOW)。接上网线,或准备好 Wi-Fi;接上 HDMI 显示器和 USB 键盘。
  2. 接通电源。eMMC 里已经有系统时,按住 FUNCTION 键,短按 RESET 键,再松开 FUNCTION,强制进入 OOWOW。
  3. 跟着向导走:连接网络 → 显示可用系统 → 选择系统 → 下载并安装。

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

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

没有显示器时:用 USB 线把 VIM4 接到电脑,浏览器打开 外部资料(请使用来源按钮访问) 就是同样的 OOWOW 菜单;同一局域网里也可以访问 外部资料(请使用来源按钮访问) 是序列号后 5 位),但 OOWOW 防火墙默认阻止远程访问,要先在 OOWOW 菜单 Network → Firewall Mode 里改成 allow(允许局域网连接);USB 直连不受限制。也可以用手机开一个名为 oowow、密码 12345678 的热点,在 OOWOW 里短按 POWER 键开启 Easy Wi-Fi,让板子自动连上。

OOWOW 菜单里还有 Write image to eMMC(把 U 盘里的镜像写进 eMMC,支持 .img、.img.xz、.img.gz、.img.zst)和 Dump image from eMMC(把 eMMC 备份成镜像)。

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

  1. 打开 balenaEtcher,点“从文件烧录”,选不带 -emmc 的 vim4-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。

方法三:USB 线刷到 eMMC

Windows:Aml Burn Tool

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

  1. 解压工具包,进入 V3\Driver 目录,双击 dpscat.exe(不会弹出窗口),再双击 dpinst64.exe 安装驱动。32 位 Windows 用 dpinst32.exe。
  2. 进入 V3 目录,双击 Aml_Burn_Tool.exe 打开工具。
  3. 点 Setup → Load Image,选解压后的 -emmc.img。
  4. 用 USB-C 线把板子接到电脑(板子会自动上电),再让板子进入升级模式:2 秒内连按 3 次 Function 键后松开。

应看到:红色电源灯闪约 3 秒后熄灭,表示进入升级模式(Maskrom 模式);电脑会自动识别到这块板子。

  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。然后刷写(换成你的镜像路径):

burn-tool -v aml -b VIM4 -i /path/to/vim4-ubuntu-….-emmc.img

应看到:最后输出 burn successful^_^。

更多按键和界面说明见 Khadas VIM 刷 eMMC。

第一次开机和登录

  • 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 启动不了:按方法三用 Function 键(连按 3 次)进入 Maskrom 升级模式,重新刷一次 -emmc 镜像。
  • FUNCTION + RESET 进不了 OOWOW:用 balenaEtcher 把 vim4-oowow-<版本>-spi-upgrade-sd.img.gz 写进 TF 卡或 U 盘,插上开机,等它自动把 OOWOW 恢复进 SPI 闪存,然后拔掉卡重启。
  • 只想临时用 OOWOW:把 vim4-oowow-<版本>-sd.img.gz 写进 TF 卡,插卡开机就是 OOWOW。
  • 插了卡也不从卡启动:Khadas 说明有时 eMMC 里的系统会挡住外部启动,需要先清空 eMMC(例如在 OOWOW 里操作),再试。
  • 启动 OOWOW 时红灯一直闪或常亮:Khadas 说明启动 OOWOW 时红灯短闪 1~3 秒是正常的;一直闪烁或常亮才表示 OOWOW 启动失败,这时按上面的方法恢复 SPI 里的 OOWOW。
  • 在 OOWOW 里直接写 SPI:vim4-oowow-<版本>-spi.img.gz 是给 SPI 闪存的,不能写卡。把它放进 U 盘,在 OOWOW 的终端里运行下面的命令(路径换成 U 盘的实际挂载位置):
gzip -dc /tmp/mounts/USB-sda1/vim4-oowow-<版本>-spi.img.gz | spi_update
  • 想看启动日志:USB 转 TTL 串口接 GPIO 排针:GND→17 脚,TXD→18 脚(Linux_Rx),RXD→19 脚(Linux_Tx),Khadas 的表里还列了 VCC 3.3V→20 脚。VIM4 波特率 921600。见 用 USB 转 TTL 串口调试开发板。

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

资料来源

按 Khadas 官方文档(VIM4 Getting Started、Install OS、Boot into Upgrade Mode、Interfaces、VIM4 Versions、Boot flow,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 · 依据 · 本站未在实机上逐一验证