Milk-V Mars CM 刷机教程:Lite 版写卡与 eMMC 版 UsbFlashTool 刷机
Milk-V Mars CM 装 Debian:区分 Lite 版和 eMMC 版,Lite 版在树莓派 CM4 IO 底板上用 microSD 卡启动,eMMC 版用 UsbFlashTool 刷入,附引导程序救砖。约 20 分钟。
适用于Milk-V Mars CM (on RPi CM4 IO) 官方系统镜像
先确认是哪种 Mars CM
Milk-V Mars CM 是赛昉(StarFive)JH7110 计算模块,引脚兼容树莓派 CM4。Milk-V 目前发布的固件适配树莓派 CM4 IO 底板(Raspberry Pi CM4 IO Board),本页也按这块底板写。Mars CM 按存储分两种,装法不同:
| 看哪里 | Mars CM Lite | Mars CM(eMMC 版) |
|---|---|---|
| 板载 eMMC | 没有 | 有 |
| 系统装在哪 | 底板 SD 卡槽里的 microSD 卡 | 模块上的 eMMC |
| 能否用底板 SD 卡槽 | 必须用 | 不能用(eMMC 和 SD 卡共用接口,用 eMMC 版时不要往卡槽插卡) |
| 对应镜像 | mars-cm_…_cm4-io-board_sdcard_…(本站已收录) | mars-cm_…_cm4-io-board_emmc_…(本站暂未收录) |
单板的 Milk-V Mars 请看 Milk-V Mars 刷机教程。
注意本站收录的 sdcard 镜像在 Milk-V 的发布说明里写的是 “Mars CM Lite (SDCard) version”,只给 Lite 版用。
准备
- 树莓派 CM4 IO 底板(或其他兼容 CM4 的底板,Lite 版必须带 SD 卡槽)和 12V DC 电源。
- Lite 版:8 GB 以上的 microSD 卡和读卡器。
- eMMC 版:一台 Windows 电脑、USB 转 TTL 串口线、Micro USB 数据线和一个跳线帽。
- HDMI 显示器(可选)。
下载哪个文件
打开 Milk-V Mars CM 系统镜像页,下载 mars-cm_debian-desktop_sdk-v<SDK 版本>_cm4-io-board_sdcard_v<版本>.img.zip(目前是 v1.0.6),这是 Mars CM Lite 的 Debian 桌面版 microSD 卡镜像。下载后可以按 如何核对下载文件的 SHA-256 核对。
方法一:Mars CM Lite 写 microSD 卡
- 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 microSD 卡,再点“现在烧录”。也可以用 Rufus。
- 把 Mars CM 装到 CM4 IO 底板上,把卡插进底板的卡槽。
- 用 HDMI 线接底板的 HDMI0 口(Mars CM 只有一路 HDMI 输出),再给底板的 12V DC 口通电。
应看到:Mars CM 上的绿色 LED 开始闪烁,显示器上出现 Debian 登录界面。
警告写入会清空整张卡。选目标时看清容量。
方法二:Mars CM(eMMC 版)刷 eMMC
需要 Milk-V 的 eMMC 镜像和 Windows 工具 UsbFlashTool,两者本站暂未收录,从文末“官方资料”进入 Milk-V 页面获取。
- USB 转 TTL 串口线接底板的 40 针排针,记下电脑上的串口号,关掉其他占用串口的程序。
- 用跳线帽短接 CM4 IO 底板 J12 排针的第 1、2 脚(USB 刷机模式)。
- 用 Micro USB 线连接电脑和底板的 J11(USB Slave)口。
- 运行
UsbFlashTool-*-Windows.exe,在右侧 Serial Setting 里选第 1 步的串口号。 - 给底板的 12V DC 口通电。
- File Type 选
Firmware,点 File Select 选工具update目录里的usbprog-mars-230510.out,点 Load。第一次使用时这里会出现Loaded,Windows 设备管理器里多出StarFive JH7110 Device:运行工具目录里的zadig-2.5,在 Options 菜单选 List All Devices,下拉框选StarFive JH7110 Device,点 Install Driver;装好后关掉工具、断电,从第 1 步重来。驱动装好后这一步会显示Complete。 - 再点 File Select 选 eMMC 镜像,File Type 选
Allinone,Memory Type 选EMMC,点 Load 开始刷写。
应看到:进度条分段前进,不会实时滚动;约 10 分钟后提示 100% 且没有错误信息,表示完成。
- 关掉工具,断电,取下 J12 的跳线帽,再接 HDMI0 和 12V 电源开机。
应看到:绿色 LED 开始闪烁,显示器上出现 Debian 登录界面。
第一次登录
- 默认用户
user,密码milkv,登录后请先改密码。 - 没有显示器时,可以接串口登录(接法见下文)。
刷坏了怎么救
- Lite 版系统卡坏了:重新写一次 microSD 卡即可。
- eMMC 版:按方法二重新刷一次 eMMC。
- 镜像和引导程序不配套、起不来:Milk-V 说明 Mars CM 的引导程序存在 SPI 闪存里,升级官方系统镜像时要配套更新,否则可能起不来。v1.0.6 的配套引导程序在串口日志里显示的时间是:Lite 版
Oct 08 2023 - 18:04:24,eMMC 版Oct 08 2023 - 17:13:43。 - 重写 SPI 引导程序:按方法二的第 1~5 步连好串口、跳线和 USB 线,打开 UsbFlashTool 并通电,然后 File Select 选 SPL 文件、File Type 选
SPL、Memory Type 选FLASH,点 Load 等出现SUCCEED和Complete;再选 U-Boot 文件、File Type 选U-Boot、Memory Type 选FLASH,点 Load。完成后断电并取下 J12 跳线帽。引导程序文件在 Milk-V 的 mars-buildroot-sdk 发布页,Lite 版是mars-cm_sdcard_u-boot-spl.bin.normal.out和mars-cm_sdcard_visionfive2_fw_payload.img,eMMC 版是mars-cm_emmc_…开头的同名文件,本站暂未收录。 - 串口接法(以 CM4 IO 底板为例):GND(6 脚)接 USB 转 TTL 的黑线,TX(8 脚)接白线,RX(10 脚)接绿线,红线不要接;参数 115200、8N1、无流控。见 用 USB 转 TTL 串口调试开发板。
资料来源
按 Milk-V 官方文档(Mars CM Boot the Mars CM、Setting Up、Images Download、Bootloader Update Guide)和 Milk-V 在 GitHub 发布的 mars-buildroot-sdk V1.0.6 版本说明整理,2026-10-22 查阅。
提示本页按厂商官方文档整理,本站没有在实机上测试。跳线、接口位置和文件名以你的底板和 Milk-V 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证