LiberLiveapp 中文文档 下载 App

固件更新失败:下载完固件但推送时中断或 App 报错

固件更新的三个阶段

一次完整的固件更新通常是:

  1. 下载阶段:App 从云端服务器下载固件文件到手机本地 → 需要稳定 Wi-Fi
  2. 推送阶段:App 通过 BLE 把固件分片推送到 C1 / C2 / U1 → 需要稳定蓝牙
  3. 升级阶段:硬件 MCU 校验固件完整性 → 写入 Flash → 重启 → App 自动重连

每个阶段都可能失败,原因不同。

阶段一:下载失败

原因一:Wi-Fi 不稳定

固件文件通常比较大(几十到几百 MB),下载过程中 Wi-Fi 抖动会导致:

官方 FAQ 明确说:用稳定 Wi-Fi,不要用手机热点。手机热点的网络不稳定可能导致下载反复失败。

原因二:Wi-Fi 名称有特殊字符

官方 FAQ 还提到一个容易被忽略的坑:Wi-Fi 名称里有 emoji 或非 ASCII 字符可能导致 C1 / C2 / U1 连不上 Wi-Fi——虽然固件下载是 App 从云端拉走、不需要硬件连 Wi-Fi,但某些版本的固件推送链路需要硬件连 Wi-Fi 辅助,所以 Wi-Fi 名字尽量只用英文 + 数字。

解决方法

阶段二:推送失败

推送阶段是 App 通过 BLE 把固件分片传给硬件——这是整个更新里最脆弱的阶段:

常见原因

解决方法

阶段三:升级失败

推送完成后硬件 MCU 开始写入 Flash——这个阶段如果失败,硬件可能变成半砖(无法启动):

解决方法

一次完整的固件更新有多快

理想情况:

总共约 5~10 分钟。升级期间绝对不要断电、不要断开蓝牙、不要把 App 切后台。