From 3c83170db90a09c3d2283167c8fedfe68aabacae Mon Sep 17 00:00:00 2001 From: sunmin Date: Mon, 20 Apr 2026 11:55:20 +0800 Subject: [PATCH 1/3] licheepi4a: update flash doc --- docs/Installation/licheepi4a-windows.mdx | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/Installation/licheepi4a-windows.mdx b/docs/Installation/licheepi4a-windows.mdx index 5062482..6b65d9c 100644 --- a/docs/Installation/licheepi4a-windows.mdx +++ b/docs/Installation/licheepi4a-windows.mdx @@ -187,7 +187,13 @@ Get-FileHash -Algorithm MD5 .\sdcard-lpi4a-20250123_195216.img.zst 在写入镜像完成后将SD 卡插入如图所示卡槽中。 ![](/img/image-for-flash/lpi4a5.png) -需要先将HDMI线（如果有外接显示器需求）进行连接，然后将随箱附赠的USB-A接口到USB-C接口的数据线中的C口一端接入到开发板上，另一端接入至少5V2A 输出的 USB 电源上，即可启动。 +建议启动流程：先连接好 HDMI 外接显示器（如需），再使用**随箱附赠**的 USB-A 转 USB Type-C 数据线，将开发板连接至一个至少 5V/2A 的 USB 电源适配器 (开发板通电后将自动开机)。 + +:::warning +**关于 USB-A 转 USB Type-C 数据线的选用** + +写入镜像时一定要选用支持充电和 5Gbps-10Gbps 数据传输功能的优质数据线；不能用只能充电或者数据传输速度极慢的廉价数据线。 +::: ## 从 eMMC 启动 @@ -315,6 +321,8 @@ LicheePi4A 不同的内存版本的 uboot 文件不通用，可参照下表根 开发板重启后，计算机可能再次检测到一个名为`USB download gadget`的未知设备。请按照上面的驱动安装教程重新为该设备安装驱动后继续下面的步骤。 ```powershell +#确保驱动工作正常，而且设备没有掉线（应当输出一行信息代表有一个设备已经连接） +.\fastboot.exe devices # 以下三行替换为您的板卡规格对应的 uboot boot root 文件的路径，可在资源管理器中将文件拖放到终端以快捷输入文件的路径 .\fastboot.exe flash uboot u-boot-with-spl-lpi4a-16g.bin .\fastboot.exe flash boot boot-lpi4a-20240720_171951.ext4 @@ -326,7 +334,7 @@ LicheePi4A 不同的内存版本的 uboot 文件不通用，可参照下表根 :::warning **关于刷写进度和耗时的提示** -uboot 和 boot 文件刷写较快，root 文件大约需 5 分钟。如果刷写 root 文件时数据块数量异常（如下图所示，2000+ 或 3000+），说明前面操作有误，请重新刷写。 +uboot 和 boot 文件刷写较快，root 文件大约需 5 分钟。如果刷写 root 文件时数据块数量异常（如下图所示，2000+ 或 3000+），说明前面操作有误，请重新刷写（也可以尝试更换更高传输速率的数据线）。 ![错误的fastboot刷写](/img/image-for-flash/bad-fastboot-flash.png) ::: From ea5928f8247d801e7cc0bd3f1d48f92ea7523404 Mon Sep 17 00:00:00 2001 From: sunmin Date: Mon, 20 Apr 2026 12:54:55 +0800 Subject: [PATCH 2/3] licheepi4a: update flash doc --- docs/Installation/licheepi4a-windows.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/Installation/licheepi4a-windows.mdx b/docs/Installation/licheepi4a-windows.mdx index 6b65d9c..2fddc72 100644 --- a/docs/Installation/licheepi4a-windows.mdx +++ b/docs/Installation/licheepi4a-windows.mdx @@ -192,7 +192,7 @@ Get-FileHash -Algorithm MD5 .\sdcard-lpi4a-20250123_195216.img.zst :::warning **关于 USB-A 转 USB Type-C 数据线的选用** -写入镜像时一定要选用支持充电和 5Gbps-10Gbps 数据传输功能的优质数据线；不能用只能充电或者数据传输速度极慢的廉价数据线。 +写入镜像时一定要选用支持充电和 USB 3.0/3.1 Gen1 5Gbps 或以上数据传输的优质数据线；不能用只能充电或者数据传输速度极慢的廉价数据线。 ::: ## 从 eMMC 启动 @@ -321,8 +321,8 @@ LicheePi4A 不同的内存版本的 uboot 文件不通用，可参照下表根 开发板重启后，计算机可能再次检测到一个名为`USB download gadget`的未知设备。请按照上面的驱动安装教程重新为该设备安装驱动后继续下面的步骤。 ```powershell -#确保驱动工作正常，而且设备没有掉线（应当输出一行信息代表有一个设备已经连接） -.\fastboot.exe devices +# 确保驱动工作正常，而且设备没有掉线 +.\fastboot.exe devices # 预期输出: <序列号> fastboot # 以下三行替换为您的板卡规格对应的 uboot boot root 文件的路径，可在资源管理器中将文件拖放到终端以快捷输入文件的路径 .\fastboot.exe flash uboot u-boot-with-spl-lpi4a-16g.bin .\fastboot.exe flash boot boot-lpi4a-20240720_171951.ext4 From d7cae5f8d53664429363c8e8521c89e7365fbac5 Mon Sep 17 00:00:00 2001 From: sunmin Date: Mon, 20 Apr 2026 14:36:33 +0800 Subject: [PATCH 3/3] licheepi4a: update flash doc --- docs/Installation/licheepi4a-windows.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Installation/licheepi4a-windows.mdx b/docs/Installation/licheepi4a-windows.mdx index 2fddc72..b2db9ac 100644 --- a/docs/Installation/licheepi4a-windows.mdx +++ b/docs/Installation/licheepi4a-windows.mdx @@ -192,7 +192,7 @@ Get-FileHash -Algorithm MD5 .\sdcard-lpi4a-20250123_195216.img.zst :::warning **关于 USB-A 转 USB Type-C 数据线的选用** -写入镜像时一定要选用支持充电和 USB 3.0/3.1 Gen1 5Gbps 或以上数据传输的优质数据线；不能用只能充电或者数据传输速度极慢的廉价数据线。 +写入镜像时一定要选用支持充电和高速数据传输的优质数据线；不能用只能充电或者数据传输速度极慢的廉价数据线。 ::: ## 从 eMMC 启动