LicheePi4A镜像刷写教程(Windows)
此页面是 LicheePi 4A 镜像刷写教程，适用于 Windows
如想查看镜像刷写教程请从下面的表格中点击链接进行查看。
| 其他刷写教程 | 链接 |
|---|---|
| LicheePi4A镜像刷写教程(Linux) | Linux 刷写教程 |
| Milk-V pioneer | 刷写教程 |
| Milk-V Meles | 刷写教程 |
在查看此教程前，请对照下面的图片确认手中板卡是否和图片一致，请在确认一致后再继续按照教程操作。
演示环境介绍
此教程中所有镜像刷写的相关操作都使用以下环境：
- 操作系统：Windows 11 24H2 OS 内部版本26100.3194
- 架构：x86_64
- LiCheePi4A 板卡规格：16G RAM + 128G eMMC
在此环境中，本教程中的所有操作都是可复现的。在刷写过程中遇到任何问题，请参考此页提交issue。
启动方式介绍
LicheePi 4A 目前支持两种启动方式，分别是从SD card 启动和从 eMMC 启动。对于两种不同的启动方式，此教程中都有说明，请根据所需方式点击跳转查看。
无论使用哪种刷写方式，原有用户数据都会丢失，刷写前请务必备份数据！
从 SD card 启动
有关开发板拨码开关设置的提示
从sd卡启动不需要改变拨码开关，请按照eMMC拨码开关进行设置。
拨码开关存在于板卡下方，需要取出板卡后才能看到，正确设置应为两个按钮全部对准下方。
注意： 部分早期版本的 LicheePi4A 板卡没有拨码开关。
有关SD卡兼容性的提示
部分 SD 卡在开发板上可能存在兼容性问题，请在 LicheePi 4A SD卡兼容清单 查找您的 SD 卡是否有已知问题。
准备工作
如果从镜像版本20240720及以前的版本升级，需要重置U-Boot环境变量
重置方法： 连接开发板串口，插入电源，在进入U-Boot后按下回车中断启动，进入U-Boot命令行界面，输入以下命令：
env default -a -f; env save; reset
将重置所有U-Boot环境变量并重启。如此即完成重置操作。
获取 SD card 镜像
从以下链接下载 LicheePi4A 以 sdcard- 为前缀的 SD card 启动系统镜像：
-
最新版本（6.6内核）：20250729
有关RevyOS镜像内核版本的说明
20240720镜像使用的是5.10内核，目前5.10内核处于较为成熟的状态，在视频的编解码以及各种应用上表现都更加稳定。
最新版本镜像使用的是6.6内核，6.6内核可能会出现一些未知的问题，已知的有视频方面卡顿以及usb失去供电等问题，目前正在修复当中。
以 20250123 镜像为例进行演示：
有两种镜像下载方式可供选择：
- 通过网页浏览。直接点击链接下载即可。
- 通过命令行下载。打开PowerShell，运行以下命令：
curl.exe -OL https://mirror.iscas.ac.cn/revyos/extra/images/lpi4a/20250123/sdcard-lpi4a-20250123_195216.img.zst
curl.exe从Windows 10起作为一个默认组件存在于Windows系统中。如果找不到 curl.exe，可以使用浏览器下载的方法作为替代。
即可下载。等待进度到达100%即表示下载完成。
通过上面两种方式进行下载，完成后都会得到名为 sdcard-lpi4a-20250123_195216.img.zst 的镜像压缩包。由于在下载过程中有概率出现传输错误，推荐进行哈希校验步骤来校验镜像的准确性。
校验镜像（可选，推荐）
打开资源管理器，导航到镜像文件所在的文件夹，右键选择 在终端中打开
点击打开 Powershell 终端。输入下面的命令获取镜像站中的 md5sum.txt 校验和：
curl.exe -L https://mirror.iscas.ac.cn/revyos/extra/images/lpi4a/20250123/md5sum.txt
应该能够展示出各个镜像文件的理论校验和。运行下面的命令计算本地镜像校验和：
Get-FileHash -Algorithm MD5 .\sdcard-lpi4a-20250123_195216.img.zst
对照两个校验和，应当观察到校验和一致。否则需要重新下载镜像。
解压镜像
镜像带有 zstd 压缩，可使用一些压缩工具进行解压，例如PeaZip或7-zip Zstd版
关于解压后的文件大小提示
解压后的文件大小约为10.2GB，请确保本地存储空间充足！
硬件准备
准备MicroSD 读卡器和一张MicroSD 卡,目前 MicroSD 卡存在兼容性问题，RevyOS 提供了目前已测试过的 MicroSD 卡列表。
使用BalenaEtcher写入镜像到 MicroSD 卡
从官网获取烧录工具 BalenaEtcher https://etcher.balena.io/，下载时请根据本机情况选择文件进行下载。选择Etcher for Windows进行下载并解压安装。
- 把 SD 卡插入读卡器，并将其插入电脑。
- 运行 BalenaEtcher用于写入镜像到SD 卡。
- 在 BalenaEtcher 窗口中, 首先点击 "从文件烧录" 来选择镜像文件。
- 选择完镜像文件后在第二栏选择需要写入的设备。
- 两项都选择完以后点击"Flash"写入镜像。
- 在等待一段时间后会显示烧录已完成。
关于SD卡写入的提示
拔出 SD 卡前，请确保 BalenaEtcher 烧录过程已完成，SD 卡指示灯不再闪烁，并在系统托盘中弹出 SD 卡，否则可能导致 SD 卡损坏或数据丢失。
通过SD卡启动系统
在写入镜像完成后将SD 卡插入如图所示卡槽中。
需要先将HDMI线（如果有外接显示器需求）进行连接，然后将随箱附赠的USB-A接口到USB-C接口的数据线中的C口一端接入到开发板上，另一端接入至少5V2A 输出的 USB 电源上，即可启动。
从 eMMC 启动
从eMMC启动镜像时，刷写镜像的途径分为连接串口进行刷写与不连接串口进行刷写两种情况。考虑到接入串口进行刷写不是必须行为，所以默认是使用不连接串口的刷写方式，如果手上有串口线的情况下也可以选择查看连接串口刷写的部分。其中进行的操作有些许区别，如您想连接串口线刷机，请参考Linux刷写教程中的相关章节。
从 eMMC 启动前应当先取出 SD Card！
准备工作
如果从镜像版本 20240720 及以前的版本升级，需要重置 U-Boot 环境变量
重置方法： 连接开发板串口，插入电源，在进入 U-Boot 后按下回车中断启动，进入 U-Boot 命令行界面，输入以下命令：
env default -a -f; env save; reset
将重置所有U-Boot环境变量并重启。如此即完成重置操作。
安装镜像刷写工具
从 eMMC 启动需要将 u-boot 文件、boot 文件以及 root 文件通过 fastboot 工具刷入eMMC中，所以需要先确认是否已安装 fastboot。
您可以使用类似Everything的索引工具查找您的电脑上是否已安装了fastboot.exe，如果没有或者版本低于 34，可使用 winget install google.platformtools 安装最新版本的 fastboot。（过低版本的 fastboot 刷写最新镜像会出现异常）
在包含fastboot.exe的文件夹中打开Powershell，运行.\fastboot.exe --version，判断fastboot.exe是否能够正常运行。
如果如上图所示能够正常回显版本号则证明安装成功。
获取镜像
从以下链接下载 LicheePi4A 的系统镜像。
-
最新版本（6.6内核）：20250729
有关 RevyOS 镜像内核版本的说明
20240720镜像使用的是5.10内核，目前5.10内核处于较为成熟的状态，在视频的编解码以及各种应用上表现都更加稳定。
最新版本镜像使用的是6.6内核，6.6内核可能会出现一些未知的问题，已知的有视频方面卡顿以及 USB 失去供电等问题，目前正在修复当中。
有关u-boot固件文件的提示
LicheePi4A 不同的内存版本的 uboot 文件不通用，可参照下表根据您的核心板的板卡版本选择对应镜像。
| 内存存储组合 | 对应的uboot镜像 |
|---|---|
| 8G RAM + 8G eMMC | u-boot-with-spl-lpi4a-main_8gemmc.bin |
| 8G RAM + 32G eMMC | u-boot-with-spl-lpi4a-main.bin |
| 16G RAM | u-boot-with-spl-lpi4a-16g-main.bin |
如果无法确认核心板的规格，可以扫描核心板上的二维码进行查看。LicheePi4A板卡发售时，在核心板与底板上都会有一张二维码贴纸，在扫描核心板的二维码贴纸后会显示核心板的内存+存储配置。
例如在 16G RAM + 128G 板卡上，贴纸在如图所示的部分
通过扫描二维码后显示如下
扫描后的结果中，第二部分的数字便是核心板的内存+存储配置。
确认好板卡规格后，下载、校验并解压对应的 uboot、boot 以及 root 文件（uboot 文件不需要解压）。这部分可参考上面的 从SD卡启动章节。
连接板卡并打入驱动
按住板卡上的 BOOT 键后，将靠近 BOOT 键的 Type-C 接口接入电脑，板卡会进入刷写模式。
在Windows徽标右键，打开设备管理器，如果在 其他设备 处看到 USB download gadget，即表明设备已被正确识别。但是未安装驱动程序。
为了打入 fastboot 驱动，需要下载 Google USB驱动（需要代理），下载并解压到某一位置。
- 右键设备管理器中的
USB download gadget，点击更新驱动程序 - 选择
浏览我的电脑以查找驱动程序
- 选择
让我从计算机上的可用驱动程序列表中选取 - 选中
显示所有设备，并点击下一步
- 点击
从磁盘安装 - 点击
浏览，选中Google USB驱动下的inf文件，点击确定
- 选中
Android Bootloader Interface，点击下一步，在弹出对话框中点击是，在弹出的Windows安全中心对话框中点击安装
- 成功安装fastboot驱动
若上述步骤出现问题，请回到设备管理器找到该设备，点击 卸载驱动程序，然后重新插拔开发板并重试。
刷写镜像
回到包含 fastboot.exe 的 Powershell 终端，输入下面的命令，程序应当输出一行信息代表有一个设备已经连接。
.\fastboot.exe devices
输入下面的命令以刷写并重启到临时uboot：
.\fastboot.exe flash ram .\u-boot-with-spl-lpi4a-16g.bin # 替换为您的板卡规格对应的 uboot 文件的路径，可在资源管理器中将文件拖放到终端以快捷输入文件的路径
.\fastboot reboot
开发板重启后，计算机可能再次检测到一个名为USB download gadget的未知设备。请按照上面的驱动安装教程重新为该设备安装驱动后继续下面的步骤。
# 以下三行替换为您的板卡规格对应的 uboot boot root 文件的路径，可在资源管理器中将文件拖放到终端以快捷输入文件的路径
.\fastboot.exe flash uboot u-boot-with-spl-lpi4a-16g.bin
.\fastboot.exe flash boot boot-lpi4a-20240720_171951.ext4
.\fastboot.exe flash root root-lpi4a-20240720_171951.ext4
关于刷写进度和耗时的提示
uboot 和 boot 文件刷写较快，root 文件大约需 5 分钟。如果刷写 root 文件时数据块数量异常（如下图所示，2000+ 或 3000+），说明前面操作有误，请重新刷写。
至此镜像刷写完成，可以通过重新拔插电源线的方式启动系统。
用户登录
下面是默认的系统账户以及密码
- 登录账户：debian
- 账户密码：debian
在初次启动镜像时可使用以上的用户密码进行登录。
出于安全性考虑，请在初次登录后一定修改密码，避免出现问题。