更新与恢复
区分 App 更新、无线固件升级、恢复出厂设置和 USB 完整重装。
更新电脑 App、更新设备固件和清除设备数据是不同操作。操作前先确认目的:
| 操作 | 入口 | 数据影响 |
|---|---|---|
| 更新 App | App“应用设置 → 关于与更新” | 更新电脑软件,不等于更新设备固件 |
| 无线升级固件 | App“设备设置 → 固件升级” | 更新设备应用;通常保留配置,但需查看版本格式变更说明 |
| 恢复出厂设置 | 设备“功能 → 设备设置 → 恢复出厂设置” | 删除设备用户数据,保留当前固件 |
| USB 完整重装 | App“设备设置 → 固件升级 → 通过 USB 首次安装” | 擦除设备程序和数据,写入完整安装包 |
本次准备发布 App 0.1.10 与固件 0.1.8。 从固件 0.1.7 普通 OTA 升级时,保留 Wi-Fi、连接身份、配对、雷达偏好、校准和当前格式历史,无需恢复出厂。App 新增电脑指标也支持固件 0.1.7,无需仅为这些字段升级固件;已有 V4 主题继续使用。从更早的 LD2402 固件首次升级到 0.1.6 或更高版本时,雷达会采用高灵敏度、2.0 米、20 秒默认值,请重新保存偏好。
从固件 0.1.4 首次升级到 0.1.5 或更新版本时,最大温漂采用目标固件默认值,曾手动校准时需重新设置。0.1.5 和 0.1.6 的默认值为 3.4°C,0.1.7 为 4.0°C。Wi-Fi 和配对继续保留。App 0.1.7 起使用 V4 主题工程,旧 V3 工程和旧全局 HTTP 配置需重新创建。
首次从固件 0.1.3 及更早的旧雷达 / 旧历史格式切换到 LD2402 与历史 v5,必须恢复出厂并重新配网、生成设备连接身份和配对;旧历史不迁移。 完整 USB 重装已经包含清除,无需再重复恢复出厂。旧 LD6002 硬件不适用新固件,需先按当前 DIY 指引更换雷达。详见版本更新。
需要留存的历史先导出 CSV,需要保留的主题先导出本地主题包。这些导出不等于完整设备备份。
更新桌面 App
- 打开“应用设置 → 关于与更新”,查看当前 App 版本。
- 点击“检查应用更新”,阅读更新提示。
- 确认更新,等待下载、校验与安装。macOS 更新后会重启 App;Windows 由安装器继续完成。
- 自动更新不可用时,可使用界面的“手动下载安装包”入口,或官网提供的桌面安装包。
App 启动时也会检查更新。USB 检测、烧录或 OTA 会话尚未结束时,先结束设备维护,再更新 App。
无线升级设备固件
适用于设备可以正常运行、已经配对,且电脑与设备处于同一局域网的情况。
- 保持设备供电,在切换器核对目标设备,确认该设备已连接。
- 打开“设备设置 → 固件升级”。
- 选择“最新版本”并“下载并选择”,或从“已下载版本”中“校验并选择”;也可以“选择本地应用 .bin”。
- 查看目标版本、硬件兼容信息和更新说明,点击“检查设备并准备升级”。
- 在确认区域核对当前版本与目标版本,再点击“确认并开始升级”。选择文件本身不会开始刷写。
- 等待上传、校验、重启及重新连接,最后检查设备固件版本和 App 提示。
无线 OTA 使用单个应用 .bin,不能使用完整 USB ZIP 包。过程中不要切断设备电源、关闭 App、切换网络,也不要同时发布主题或执行恢复出厂设置。
设备重启时短暂离线是正常现象;上传进度到 100% 不等于启动验证已经完成。若提示已校验但需手动重启,按提示完成后重新检查版本。若失败,保留原始错误信息再排查,不要跳过兼容性校验。
OTA 只写入应用分区,不更新分区表和启动程序。要求更改分区布局的版本不能靠普通 OTA 完成,应遵循该版本的完整恢复说明。
降级和调试阶段兼容性
降级时 App 会要求额外确认。旧版本可能不认识新版本写入的配置;降级不是恢复旧设置的保证。
目前处于调试阶段,App、协议和存储格式可能断代,不承诺旧格式迁移。根据具体版本变化,可能需要重新配置功能、重新发布主题,或按全新状态重新配网和配对。涉及设备身份重建时,旧配对授权也会失效。
这些影响应以对应版本说明为准,不要把所有 OTA 都理解成“清空数据”,也不要承诺所有升级都能保留旧数据。
恢复出厂设置
- 如需留存,先导出历史和本地主题。
- 在设备主页按“确认”,进入“功能 → 设备设置”,用“下一项”找到“恢复出厂设置”。
- 按“确认”进入确认页。默认选中“取消”,需要切换到“确认恢复”并再次按“确认”才会执行;按“返回”可取消。
- 显示“正在恢复出厂设置,请勿断电”后保持供电,等待设备重启并完成清除。
- 设备恢复后先选择语言并进入主页;手动进入网络设置,重新配网并重新配对。
此操作会删除设备保存的 Wi-Fi、全部配对授权和设备连接身份、历史记录、主题与素材、HTTP 数据源配置、设备名称、闹钟、休息提醒、番茄钟及声音/屏幕等用户设置、天气位置、传感器校准和 Home Assistant 配置。
当前固件版本保留,电脑 App 的本地项目和本地数据不会被此操作删除。旧 App 授权无法直接继续使用,需要重新配对。固件升级尚在上传、等待重启或验证时,设备可能拒绝恢复操作,应先完成升级。
USB 完整重装
用于需要完整恢复的设备,成品首次使用不需要做这一步。完整重装会清除这台设备的全部程序和数据,完成后重新配网、配对并发布主题。
- 使用支持数据传输的线缆连接电脑与设备的原生 USB 接口,关闭可能占用串口的工具。
- 打开 App“设备设置 → 固件升级 → 通过 USB 首次安装”。
- 选择与设备型号匹配的完整 ZIP 固件安装包,无需解压。可使用最新版本、已下载版本或本地包,不能使用单个 OTA BIN。
- 点击“刷新 USB 设备”,选择目标端口,再点击“检测开发板”。检测会复位设备,但不会擦除数据。
- 核对检测到的目标、固件版本和硬件要求。当前安装工具仅支持 ESP32-S3 N16R8;不能核实硬件时不要勾选已确认。
- 明确同意清除数据后点击“擦除并安装”。等待所有镜像写入、核验和重启完成。
- 若出现语言选择页,先选择语言;确认设备能显示主页,再手动进入网络设置重新配网。写入成功不代表所有外设都已通过检查。
检测后的安装确认有效期为五分钟,更换目标或超时后应重新检测。“请求取消”需要等待当前操作结束;收到取消请求不代表可以立即拔线。
如果设备无法被检测,先更换数据线或电脑 USB 接口,再刷新列表。需要 BOOT/RESET 手动下载模式而成品没有可操作入口时,请联系提供设备的渠道处理;不要按开发板接线说明自行拆机改线。