蓝牙协议 V2

星云智能门锁蓝牙通信协议第二版，代号 StarLock Protocol V2，目标是提供一个简洁、统一、可扩展的通信协议框架。

协议亮点

传输层无关

协议设计与传输层解耦，同一套指令可运行在不同通信介质上：

通过蓝牙 WiFi 网关时，只需在外层增加路由信息，协议主体完全复用，无需为不同传输层维护多套协议。

离线优先

设备端与服务器采用非实时同步架构，核心数据存储在设备本地：

设计要点	说明
本地决策	开锁鉴权在设备端完成，无需等待服务器响应
离线密码	算法生成的密码无需联网即可验证，联网后补全用户关联
增量同步	设备记录操作日志，联网时批量上报，支持断点续传
冲突解决	基于时间戳和版本号的冲突检测与合并策略

这种设计确保了：

断网时设备仍可正常使用
网络恢复后数据自动同步
服务器故障不影响本地功能

安全机制

层级	机制	说明
传输层	对称加密	数据加密，防窃听
会话层	Token 鉴权	单一密钥，权限隔离
应用层	授权指令包	JWT 签名的操作授权，防越权
业务层	胁迫凭证	静默报警机制

使用场景

蓝牙门锁

最典型的应用场景，APP 通过蓝牙直连门锁：

近场通信，响应快速
无需网络基础设施
设备端完整存储用户和凭证数据

分布式可用架构

设备端存储完整数据，意味着断网断云时设备仍可正常使用，APP 与设备直连即可操作，数据以设备为准，联网后自动同步。端对端鉴权确保指令只有目标设备能验证执行，云端和网关仅做透传，无法伪造或篡改。

WiFi 门锁

门锁通过 WiFi 直连云端，支持远程控制：

实时在线，支持远程开锁和通知推送
同一套指令集，蓝牙能做的 WiFi 都能做
Protobuf 序列化，数据包体积小，省流量省电

深度休眠支持

利用 MQTT 会话保留机制，设备可完全断开 TCP 连接进入深度休眠，唤醒后自动接收暂存消息，适合电池供电场景。

蓝牙 WiFi 网关

通过网关扩展蓝牙设备的通信范围：

网关仅在外层增加路由信息，协议主体完全复用，透明转发不解析内容。

类型	应用
锁具	柜锁、保险箱、车位锁、抽屉锁
门禁	门禁系统、智能猫眼
共享设备	共享充电宝柜、共享水杯柜
工业设备	操作权限管理、维护记录

快速开始

文档	说明
协议设计	了解协议的分类设计和约束规范
数据结构	掌握用户、凭证、事件等核心实体
指令表	查阅完整的指令编号和功能列表
升级说明	V1 用户了解 V2 的改进点

蓝牙协议 V2 ​

协议亮点 ​

传输层无关 ​

离线优先 ​

安全机制 ​

使用场景 ​

蓝牙门锁 ​

WiFi 门锁 ​

蓝牙 WiFi 网关 ​

更多应用场景 ​

快速开始 ​