版本 | 编写/修订说明 | 修订日期 | 备注 |
---|---|---|---|
1.0.0 | 创建文档 | 20200601 | |
1.1.0 | 新增方案概述和接入方案说明 | 20200803 |
蓝牙门锁指通过蓝牙模组或者蓝牙芯片实现联网控制的智能门锁。涂鸦的蓝牙门锁方案支持单点蓝牙和蓝牙网关两种连接方式,单点蓝牙通过手机蓝牙与门锁近距离通讯进行数据交互,而蓝牙网关连接方式,门锁既可以近距离通过手机连接,也可以通过网关与涂鸦云连接。这两种连接方式都需要对接涂鸦的蓝牙门锁协议。涂鸦蓝牙门锁推出MCU对接和SDK对接两种方式。
图1 蓝牙门锁MCU对接框图
图2 蓝牙门锁SDK对接框图
涂鸦蓝牙门锁方案支持MCU通用串口协议对接和 SDK对接。两种对接方式都是设备维度的对接,采用的协议不一致。
涂鸦蓝牙公版方案,支持门锁以下功能的对接:
功能 | 说明 |
---|---|
全链路通信加密 | 蓝牙模块—App—服务器 通信过程中进行对数据进行全链路加密 |
开门记录 | 解锁方式+解锁id+时间,用户可以通过app查询近6个月的开门记录,不会丢失数据。支持指纹+密码这样的组合开门 |
模块缓存开门记录 | Mcu可将每次开门记录存在蓝牙模块/芯片/sdk上,下次app与门锁就那些蓝牙连接后,数据自动同步到app上 |
告警 | 低电告警、密码错误、指纹错误、房卡错误、防撬、高温等 |
时间同步 | 门锁时间与服务器保持一致,支持全球时区+冬夏令时切换 |
用户管理 | 通过app添加家庭成员、其他成员 |
电量状态显示 | 电量值或电量状态 |
App开门 | 手机与蓝牙门锁建立蓝牙连接后,通过app可以直接进行解锁 |
动态密码 | 涂鸦蓝牙模块集成了动态密码算法,用户可以在app上获取动态密码进行开门,每次获取的动态密码5分钟内有效 |
App添加指纹、卡、密码 | 手机与蓝牙门锁建立蓝牙连接后,通过app可以在门锁上添加/删除指纹、卡、密码等开门方式 |
临时密码 | 若硬件支持本地RTC功能,可为用户(非家庭成员)设置时效性、创建临时密码(家庭成员权限创建后永久有效,无时效性概念,不支持临时密码功能)。 |
特定有效期分享 | 管理员可以通过app,创建一个指定有效期(开始时间—结束时间)的用户 |
OTA | 模块和mcu都可进行OTA |
离线临时密码 | 不依赖网络的离线临时密码,由模块和云端实现算法,mcu调模块接口验证 |
门锁状态显示 | App上可参看门锁的反锁、童锁等状态信息 |
自动落锁开关 | 可以开启自动反锁或关闭自动反锁功能 |
自动落锁等待时长 | 可以设置自动落锁的等待时长 |
开门方式同步 | 通过app直连后,同步硬件与云端的开门方式列表 |
语音下发与删除 | 将app上采集的语音下发到门锁上 |
涂鸦蓝牙门锁接入方案支持创建以下品类:
品类 | 说明 |
---|---|
蓝牙家用门锁 | 即“蓝牙门锁公版”,支持最齐全的蓝牙门锁功能,功能可裁剪,现阶段主推方案 |
蓝牙保险箱 | 目前支持蓝牙保险箱方案 |
蓝牙门锁配件 | 可改装成蓝牙钥匙、密码盘等常用门锁配件(暂未发布) |
蓝牙小型锁 | 目前支持在IoT平台使用家用门锁品类,联网方式选择蓝牙BLE,创建小型锁所需的功能。支持小型锁:柜锁、U型锁、钥匙盒等。 |
创建总体流程
IOT注册-产品定义-面板选择-模组选择-硬件配置-拓展配置。
创建家用门锁
安防传感 ——> 家用门锁 ——> 家用门锁
创建保险箱
安防传感 ——> 保险箱 ——> 保险箱
Tuya_ble_锁类_dp点规范
Tuya_ble_锁配件_dp点规范
目前BLE门锁通用方案,支持选型的模组主要是TYBN1。
模组选型介绍:TYBN1模组规格
软件对接方式 | 硬件对接方式 | 名称 | 固件KEY | 版本 | 状态 | 说明 |
---|---|---|---|---|---|---|
通用对接 | 模块对接 | TYBN1 | keyxwmm8 | 6.1 | 已发布 | 基础版本 |
通用对接 | 芯片对接 | BK3431Q | keyktpaa | 3.3 | 已发布 | 基础版本 |
SDK对接 | 芯片对接 | nRF52832 | \ | 1.4 | 未发布 | 支持Alexa/Google音箱,离线密码 |
SDK对接 | 芯片对接 | BK3431Q | \ | 1.4 | 未发布 | 支持Alexa/Google音箱,离线密码 |
该文档为开发说明,关键步骤,关键DP(DP交互流程、告警/开门记录、恢复出厂设置流程和示例)的文档。开发辅助文档。
SDK开发对接参考:SDK对接指南
通用固件对接参考:MCU对接指南
产品开发的公版通信协议,数据协议。开发者创建产品 ——> 选择模组 时可下载最新的通讯协议。
BLE门锁DP协议参考:Tuya_ble_锁类_dp点规范
BLE门锁MCU通讯协议参考:BLE门锁MCU对接协议
BLE门锁已经支持第三方语音开门,需要下载app3.17.7以上版本。
支持的BLE门锁品类:选择 安防传感——> 家庭门锁,联网方式选择蓝牙BLE。
三方语音能力 | 支持情况 |
---|---|
Alexa语音开门 | 支持语音开门、语音关门、语音开关门状态查询,且支持开关门Alexa语音反馈 |
BLE公寓门锁 | 支持语音开门、语音关门、语音开关门状态查询,不支持语音反馈 |