WiFi 固件升级
本文档介绍 WiFi 门锁的 OTA 固件升级协议。与蓝牙门锁不同，WiFi 门锁通过下发固件 URL 由锁端自行下载升级。
升级流程
响应时机
应答消息的返回时机由锁端决定：
- 若锁端在升级后仍能保持状态，可在升级完成后返回结果
- 若锁端升级后会丢失状态，应在收到请求后立即返回
WiFi OTA 升级
指令码: 0x30E8
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令码 |
| LockID | 字符串 | 40 | 锁 ID |
| UserID | 字符串 | 20 | 用户 ID |
| FwVersion | 字符串 | 20 | 目标固件版本，如 1.0.0.240101 |
| FwSize | 整型 | 4 | 固件大小（字节） |
| FwMd5 | 二进制 | 16 | 固件 MD5 校验值 |
| UrlLen | 整型 | 2 | URL 长度 |
| Url | 字符串 | 变长 | 固件下载地址 |
| Token | 整型 | 4 | 动态口令 |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 |
应答消息
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| CmdID | 整型 | 2 | 指令码 |
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 处理状态 |
Status 状态码
| 值 | 说明 |
|---|---|
| 0 | 成功 |
| 120 | 已是最新版本，无需升级 |
| 125 | 升级失败 |
其他错误码参见 错误码定义。