Milk-V Duo 256M 刷机教程：选对 RISC-V 或 ARM 镜像写 microSD 卡

先确认是 Duo 256M，不是 Duo（64M）

Duo 256M 是 Duo 的内存升级版，两者芯片不同，镜像不能混用：

是 Duo（64M）的话，请看 Milk-V Duo 刷机教程。Milk-V 文档里，Duo 256M 的系统装在 microSD 卡上运行。

准备

• microSD 卡，1 GB 以上，加读卡器。
• 一根 USB Type-C 数据线：既给板子供电（5V 电源适配器或电脑 USB 口都行），也用来连电脑登录。
• 可选：USB 转 TTL 串口线，用来看启动日志。

下载哪个文件

打开 Milk-V Duo 256M 系统镜像页。本站收录的是 Milk-V 推荐给 Duo 256M 的 V2 镜像（v2.0.1），有两个文件，按板子大核当前用的是 RISC-V 还是 ARM 来选：

Duo 256M 的大核可以选 RISC-V 或 ARM，默认是 RISC-V。要用 ARM 核，需要把排针的第 35 脚（Boot-Switch）和 GND 短接。镜像和大核不一致时系统起不来。下载后可以按 如何核对下载文件的 SHA-256 核对。

写入 microSD 卡

1. 打开 balenaEtcher，点“从文件烧录”，选下载的 .img.zip。
2. 点“选择目标”，选你的 microSD 卡。
3. 点“现在烧录”，等到显示完成。也可以用 Rufus 写入。
4. 把卡插进 Duo 256M 的卡槽，用 Type-C 线接上 5V 电源或电脑。

应看到：板子上的蓝色 LED 开始闪烁，说明系统已经正常运行。

警告写入会清空整张卡。选目标时看清容量，别选成电脑上的硬盘。

第一次登录

Duo 256M 的镜像默认开启了 SSH 和 USB 虚拟网卡（CDC-NCM），用 Type-C 线接电脑就能登录：

1. 用 Type-C 线把 Duo 256M 接到电脑，等蓝灯开始闪烁。
2. 在电脑终端运行：

ssh root@192.168.42.1

1. 第一次连接提示时输入 yes，然后输入密码 milkv（输入时不显示）。

• Linux、macOS 和新版 Windows 不用装驱动。较旧的 Windows 在设备管理器里会看到带黄色感叹号的 CDC NCM 设备：右键选“更新驱动程序（Update Driver）” → “浏览我的电脑以查找驱动程序（Browse my computer for drivers）” → “让我从计算机上的可用驱动程序列表中选取（Let me pick from a list…）” → “网络适配器（Network Adapters）” → 厂商选 Microsoft、型号选 UsbNcm Host Device，忽略警告完成安装。
• 同一台电脑接多块板子时，需要改板子上的 USB 网卡地址（/mnt/system/usb-ncm.sh 和 /etc/dnsmasq.conf），方法见 Milk-V 文档。
• 不想让蓝灯一直闪：运行 mv /mnt/system/blink.sh /mnt/system/blink.sh_backup && sync 后重启。

用满整张卡

写入后根分区不会自动占满整张卡（Milk-V 文档的例子里只有 752 MB）。Milk-V 给的扩容方法如下，例子是在 Duo 上做的；先运行 fdisk -l 确认根分区是第 3 个分区 mmcblk0p3，不是的话不要照抄命令：

parted -s -a opt /dev/mmcblk0 "resizepart 3 100%"
resize2fs /dev/mmcblk0p3

运行 df -h 确认 /dev/root 已经变大。

刷坏了怎么救

• 蓝灯不闪：多半是卡没写好。换 balenaEtcher、Rufus 或 Win32DiskImager 重新写一次卡；还不行就接串口看启动日志。
• 写的是 arm64 镜像但起不来（或反过来）：先检查大核设置和镜像是否一致。接上串口时，启动日志第一行以 C 开头表示 RISC-V 核，以 B 开头表示 ARM 核。
• 想恢复出厂状态：系统全部在 microSD 卡里，重新写一次卡就是全新系统。
• 串口接法：Duo 256M 的 TX（16 脚）接 USB 转 TTL 的白线，RX（17 脚）接绿线，GND（18 脚）接黑线，红线不要接；串口电平 3.3V，参数 115200、8N1、无流控。见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Milk-V 官方文档（Duo 256M 介绍、Boot from microSD card、Set up the working environment、Resource Download Summary）和 Milk-V 在 GitHub 发布的 duo-buildroot-sdk-v2 v2.0.1 版本说明整理，2026-10-22 查阅。

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