跳到主要内容

LicheePi4A镜像刷写教程(Windows)

此页面是 LicheePi4A 镜像刷写教程，适用于 Windows

如想查看镜像刷写教程请从下面的表格中点击链接进行查看。

其他刷写教程链接
LicheePi4A镜像刷写教程(Linux)Linux 刷写教程
Milk-V pioneer刷写教程
Milk-V Meles刷写教程
注意

在查看此教程前，请对照下面的图片确认手中板卡是否和图片一致，请在确认一致后再继续按照教程操作。

LicheePi4A 示例图

演示环境介绍​

此教程中所有镜像刷写的相关操作都使用以下环境：

  • 操作系统：Windows 11 24H2 OS内部版本26100.3194
  • 架构：x86_64
  • LiCheePi4A 板卡规格：16G RAM + 128G eMMC
备注

在此环境中，本教程中的所有操作都是可复现的。在刷写过程中遇到任何问题，请参考此页提交issue。

启动方式介绍​

LicheePi4A 目前支持两种启动方式，分别是从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 启动系统镜像：

备注

有关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版

使用Peazip解压镜像

注意

关于解压后的文件大小提示

解压后的文件大小约为10.2GB，请确保本地存储空间充足！

硬件准备​

准备MicroSD 读卡器和一张MicroSD 卡,目前 MicroSD 卡存在兼容性问题，RevyOS 提供了目前已测试过的 MicroSD 卡列表。

备注

如果您使用的 MicroSD 卡不在已知可用的列表上，出现无法正确刷写镜像和刷写后无法启动镜像的问题，请参考此页提交issue，并尝试参考从 eMMC 启动镜像的刷写教程进行镜像刷写。

使用BalenaEtcher写入镜像到 MicroSD 卡​

从官网获取烧录工具 BalenaEtcher https://etcher.balena.io/，下载时请根据本机情况选择文件进行下载。选择Etcher for Windows进行下载并解压安装。

BalenaEtcher版本选择

  1. 把 SD 卡插入读卡器，并将其插入电脑。
  2. 运行 BalenaEtcher用于写入镜像到SD 卡。
  3. 在 BalenaEtcher 窗口中, 首先点击 "从文件烧录" 来选择镜像文件。
  4. 选择完镜像文件后在第二栏选择需要写入的设备。
  5. 两项都选择完以后点击"Flash"写入镜像。
  6. 在等待一段时间后会显示烧录已完成。

BalenaEtcher烧录流程

注意

关于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是否能够正常运行。

fastboot工具检测

如果如上图所示能够正常回显版本号则证明安装成功。

获取镜像​

从以下链接下载 LicheePi4A 的系统镜像。

备注

有关RevyOS镜像内核版本的说明

20240720镜像使用的是5.10内核，目前5.10内核处于较为成熟的状态，在视频的编解码以及各种应用上表现都更加稳定。

最新版本镜像使用的是6.6内核，6.6内核可能会出现一些未知的问题，已知的有视频方面卡顿以及usb失去供电等问题，目前正在修复当中。

注意

有关u-boot固件文件的提示

LicheePi4A 不同的内存版本的 uboot 文件不通用，可参照下表根据您的核心板的板卡版本选择对应镜像。

内存存储组合对应的uboot镜像
8G RAM + 8G eMMCu-boot-with-spl-lpi4a-main_8gemmc.bin
8G RAM + 32G eMMCu-boot-with-spl-lpi4a-main.bin
16G RAMu-boot-with-spl-lpi4a-16g-main.bin

如果无法确认核心板的规格，可以扫描核心板上的二维码进行查看。LicheePi4A板卡发售时，在核心板与底板上都会有一张二维码贴纸，在扫描核心板的二维码贴纸后会显示核心板的内存+存储配置。

例如在 16G RAM + 128G 板卡上，贴纸在如图所示的部分

core-card

通过扫描二维码后显示如下

Core board-info

扫描后的结果中，第二部分的数字便是核心板的内存+存储配置。

确认好板卡规格后，下载、校验并解压对应的 uboot、boot以及root文件（uboot文件不需要解压）。这部分可参考上面的“从SD卡启动”章节。

下载得到的镜像文件

连接板卡并打入驱动​

按住板卡上的BOOT键后，将靠近BOOT键的Type-C口接入电脑，板卡会进入刷写模式。

在Windows徽标右键，打开设备管理器，如果在“其他设备”处看到“USB download gadget”，即表明设备已被正确识别。但是未安装驱动程序。

为了打入fastboot驱动，需要下载Google USB驱动（需要代理），下载并解压到某一位置。

  1. 右键设备管理器中的“USB download gadget”，点击“更新驱动程序”
  2. 选择“浏览我的电脑以查找驱动程序” 更新驱动程序步骤2
  3. 选择“让我从计算机上的可用驱动程序列表中选取”
  4. 选中“显示所有设备”，并点击“下一步” 更新驱动程序步骤4
  5. 点击“从磁盘安装”
  6. 点击“浏览”，选中Google USB驱动下的inf文件，点击确定 更新驱动程序步骤6
  7. 选中“Android Bootloader Interface”，点击“下一步”，在弹出对话框中点击“是”，在弹出的Windows安全中心对话框中点击“安装” 更新驱动程序步骤7
  8. 成功安装fastboot驱动 更新驱动程序步骤8

若上述步骤出现问题，请回到设备管理器找到该设备，点击“卸载驱动程序”，然后重新插拔开发板并重试。

刷写镜像​

回到包含fastboot.exe的Powershell终端，输入下面的命令，程序应当输出一行信息代表有一个设备已经连接。

.\fastboot.exe devices

fastboot设备检测

输入下面的命令以刷写并重启到临时uboot：

.\fastboot.exe flash ram .\u-boot-with-spl-lpi4a-16g.bin # 替换为您的板卡规格对应的 uboot 文件的路径，可在资源管理器中将文件拖放到终端以快捷输入文件的路径
.\fastboot reboot

刷写uboot进内存

开发板重启后，计算机可能再次检测到一个名为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

fastboot刷入系统

注意

关于刷写进度和耗时的提示

uboot 和 boot 文件刷写较快，root 文件大约需 5 分钟。如果刷写 root 文件时数据块数量异常（如下图所示，2000+ 或 3000+），说明前面操作有误，请重新刷写。

错误的fastboot刷写

至此镜像刷写完成，可以通过重新拔插电源线的方式启动系统。

用户登录​

下面是默认的系统账户以及密码

  • 登录账户：debian
  • 账户密码：debian

在初次启动镜像时可使用以上的用户密码进行登录。

出于安全性考虑，请在初次登录后一定修改密码，避免出现问题。