AppGoBox

教程

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 LiteMars 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 卡

  1. 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 microSD 卡,再点“现在烧录”。也可以用 Rufus。
  2. 把 Mars CM 装到 CM4 IO 底板上,把卡插进底板的卡槽。
  3. 用 HDMI 线接底板的 HDMI0 口(Mars CM 只有一路 HDMI 输出),再给底板的 12V DC 口通电。

应看到:Mars CM 上的绿色 LED 开始闪烁,显示器上出现 Debian 登录界面。

方法二:Mars CM(eMMC 版)刷 eMMC

需要 Milk-V 的 eMMC 镜像和 Windows 工具 UsbFlashTool,两者本站暂未收录,从文末“官方资料”进入 Milk-V 页面获取。

  1. USB 转 TTL 串口线接底板的 40 针排针,记下电脑上的串口号,关掉其他占用串口的程序。
  2. 用跳线帽短接 CM4 IO 底板 J12 排针的第 1、2 脚(USB 刷机模式)。
  3. 用 Micro USB 线连接电脑和底板的 J11(USB Slave)口。
  4. 运行 UsbFlashTool-*-Windows.exe,在右侧 Serial Setting 里选第 1 步的串口号。
  5. 给底板的 12V DC 口通电。
  6. 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。
  7. 再点 File Select 选 eMMC 镜像,File Type 选 Allinone,Memory Type 选 EMMC,点 Load 开始刷写。

应看到:进度条分段前进,不会实时滚动;约 10 分钟后提示 100% 且没有错误信息,表示完成。

  1. 关掉工具,断电,取下 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 官方说明为准。

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

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

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