Milk-V Meles 刷机教程：写 microSD 卡安装 RevyOS

先确认是 Milk-V Meles，以及内存版本

Milk-V Meles 是平头哥（T-Head）TH1520 芯片的 RISC-V 单板电脑。Milk-V 硬件说明列出 4 GB、8 GB、16 GB 三种内存配置，但引导程序文件只按 4 GB 版和 8 GB 版给了两种：

16 GB 版该用哪个引导程序，Milk-V 文档没有写明，需要重写 SPI 前请先向 Milk-V 确认。不确定自己的内存大小时，可以开机后在终端运行 free -h 看总内存。Meles 的 SPI 闪存出厂已经写好引导程序，平时装系统只需要写 microSD 卡，用不到引导程序文件。

准备

• microSD 卡，16 GB 以上、Class 10 或更快，加读卡器。
• 5V 的 USB Type-C 电源。
• HDMI 显示器和线，USB 键盘鼠标。
• 可选：网线（也可以用 Wi-Fi）、USB 转 TTL 串口线。

下载哪个文件

打开 Milk-V Meles 系统镜像页，下载 sdcard-meles-<日期>_<时间>.img.xz。本站收录的是 Milk-V 发布页 v2024-0417 里的 RevyOS 镜像 sdcard-meles-20240417_155900.img.xz。

注意Milk-V 说明从 20251226 版起镜像改用 Linux 6.6 内核，必须先升级 SPI 闪存里的固件再写系统。本站这一版早于 20251226。

下载后可以按 如何核对下载文件的 SHA-256 核对。

写入 microSD 卡

1. 用 7-Zip 把 .img.xz 解压成 .img。
2. 打开 balenaEtcher，点“从文件烧录”选 .img，点“选择目标”选 microSD 卡，点“现在烧录”。

应看到：balenaEtcher 显示“烧录完成！”（Flash Complete!）。

1. 把卡插进 Meles 的 microSD 卡槽。先接 HDMI 线，再接 Type-C 电源，反过来可能没有画面。

应看到：显示器上出现 Debian 桌面。

警告写入会清空整张卡。选目标时看清容量。

第一次登录

• 用户名 debian，密码 debian。
• 在终端运行 sudo su 获取 root 权限，密码同样是 debian。
• 联网：插网线，或点桌面右上角的网络图标选择 Wi-Fi 输入密码。

装到 eMMC（本站暂未收录所需文件）

Milk-V 的做法是在 Ubuntu 电脑上用 fastboot 写入三个文件：对应内存版本的 u-boot-with-spl-meles(-4g).bin、boot-meles-<日期>.ext4、root-meles-<日期>.ext4（v2024-0417 发布页里是 .ext4.tar.gz 压缩包）。本站暂未收录 boot 和 root 文件，从文末“官方资料”进入 Milk-V 页面获取。进入下载模式的方法：按住 Meles 的 download 键，把 Type-C 线拔下再插上一次，然后松开；电脑上运行 lsusb | grep T-HEAD 应看到 T-HEAD USB download gadget。

刷坏了怎么救

• 系统卡坏了：重新写一次 microSD 卡即可。
• SPI 闪存里的引导程序损坏，或换了新的 SPI 闪存：Milk-V 的方法是在 Ubuntu 电脑上通过串口用 cct 工具重写：

1. 安装工具：sudo pip install yoctools -U，再准备 Milk-V 的 iw-single-line.bin 和对应内存版本的引导程序（本站暂未收录，从文末“官方资料”进入 Milk-V 页面获取）。
2. 接好 USB 转 TTL 串口线，在电脑上运行 sudo cct list -u /dev/ttyUSB0，看到它在等待（Wait ......）时不要关窗口。
3. Meles 断电，按住 download 键，接上 Type-C 电源，然后松开。

应看到：第 2 步的窗口列出 ram0 和 qspi0。

1. 先把写入程序下载到内存，再把引导程序写进 SPI（8 GB 版示例，4 GB 版换成 -4g 文件）：

sudo cct download -u /dev/ttyUSB0 -d ram0 -f ./iw-single-line.bin -v checksum -r
sudo cct download -u /dev/ttyUSB0 -d qspi0 -f ./u-boot-with-spl-meles.bin -v checksum -r -t 1200

应看到：每条命令都显示 download success 和“读出并校验成功!”。

1. Meles 断电再上电。

应看到：蓝色 LED 常亮。

• 接了显示器没画面：断电，先插 HDMI 再插电源。
• 想看启动日志：串口参数 115200、8N1、无流控，红线不要接，见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Milk-V 官方文档（Meles Boot the Meles、Meles Main Board、Install an image to MicroSD Card / eMMC / SPI Nor Flash、Official Image、RevyOS）和 Milk-V 在 GitHub 发布的 meles-images v2024-0417 文件列表整理，2026-10-22 查阅。

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