对讲 WiFi 配网（已废弃）
本文档介绍早期对讲锁项目使用的蓝牙辅助 WiFi 配网协议。
已废弃
此协议用于早期对讲锁项目 (starchart-talk)，现已完全废弃，所有新老项目均已停止使用。
仅作为历史文档保留，请勿在新项目中使用。
历史项目
原项目仓库：git@code.star-lock.cn:StarlockTeam/starchart-talk.git
功能概述
WiFi 配网模块基于通用扩展指令 0x3030，使用子指令实现以下功能：
| 功能 | 子指令 | 说明 |
|---|---|---|
| WiFi 配网 | 50 | 配置 WiFi 和服务器信息 |
| WiFi 配网结果 | 51 | 返回配网结果 |
| 下发服务器地址 | 52 | 单独配置服务器地址 |
| 搜索 WiFi | 53 | 搜索附近 2.4G WiFi |
| WiFi 搜索结果 | 54 | 返回搜索到的 WiFi 列表 |
WiFi 配网
子指令: 50
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| SSID | 字符串 | 30 | WiFi 名称 |
| Password | 字符串 | 20 | WiFi 密码 |
| PeerId | 字符串 | 44 | 设备 PeerId |
| NumberOfServers | 整型 | 1 | 服务器数量 |
| ListOfServerIPs | 整型 | 4 | 服务器 IP 地址（第一个为主服务器） |
| ServerPort | 整型 | 2 | 服务器端口 |
| ... | 混合 | 6×N | 其他备份服务器信息 |
| NumberOfUid | 整型 | 1 | 手机号数量 |
| Uid | 字符串 | 20 | 手机号 |
| ... | 混合 | 6×N | 其他手机号 |
| ListOfServerDomains | 字符串 | 30×N | 服务器域名地址列表 |
应答消息
无应答。
WiFi 配网结果
子指令: 51
方向: 门锁 → APP
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| Status | 整型 | 1 | 0=成功，0xFF=失败 |
应答消息
无应答。
下发星图服务器地址
子指令: 52
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| NumberOfServers | 整型 | 1 | 服务器数量 |
| ListOfServers | 整型 | 4 | 服务器 IP 地址（第一个为主服务器） |
| ServerPort | 整型 | 2 | 服务器端口 |
| ... | 混合 | 6×N | 其他备份服务器信息 |
| NumberOfPhone | 整型 | 1 | 手机号数量 |
| Phone | 字符串 | 20 | 手机号 |
| ... | 混合 | 6×N | 其他手机号 |
应答消息
无应答。
搜索 2.4G WiFi
子指令: 53
方向: APP → 门锁
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
应答消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| Status | 整型 | 1 | 0=成功，其它=失败 |
说明
收到此命令后，门锁将扫描 4 秒钟后返回结果。
WiFi 搜索结果
子指令: 54
方向: 门锁 → APP
加密: SM4 私钥模式
请求消息
| 字段名称 | 字段类型 | 字段长度 | 字段说明 |
|---|---|---|---|
| Status | 整型 | 1 | 0=成功，0xFF=失败 |
| NumberOfSsid | 整型 | 1 | SSID 数量 |
| SSID | 字符串 | 32 | WiFi 名称 |
| RSSI | 整型 | 1 | 信号强度（如 -40dB） |
| ... | 混合 | (32+1)×N | 多组 SSID 信息 |
应答消息
无应答。
指令汇总
| 子指令 | 名称 | 方向 | 说明 |
|---|---|---|---|
| 50 | WiFi 配网 | APP → 门锁 | 配置 WiFi 和服务器 |
| 51 | WiFi 配网结果 | 门锁 → APP | 返回配网结果 |
| 52 | 下发服务器地址 | APP → 门锁 | 单独配置服务器 |
| 53 | 搜索 WiFi | APP → 门锁 | 搜索附近 WiFi |
| 54 | WiFi 搜索结果 | 门锁 → APP | 返回 WiFi 列表 |