方案概述

版本记录

版本 编写/修订说明 修订日期 备注
1.0.0 创建文档 20200601
1.1.0 新增方案概述和接入方案说明 20200803

概述

蓝牙门锁指通过蓝牙模组或者蓝牙芯片实现联网控制的智能门锁。涂鸦的蓝牙门锁方案支持单点蓝牙和蓝牙网关两种连接方式,单点蓝牙通过手机蓝牙与门锁近距离通讯进行数据交互,而蓝牙网关连接方式,门锁既可以近距离通过手机连接,也可以通过网关与涂鸦云连接。这两种连接方式都需要对接涂鸦的蓝牙门锁协议。涂鸦蓝牙门锁推出MCU对接SDK对接两种方式。

蓝牙门锁对接方案

方案框图

图1 蓝牙门锁MCU对接框图
蓝牙门锁mcu对接框图.jpg

图2 蓝牙门锁SDK对接框图
涂鸦门锁SDK对接协议框图.jpg

方案说明

涂鸦蓝牙门锁方案支持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注册-产品定义-面板选择-模组选择-硬件配置-拓展配置。

创建家用门锁
安防传感 ——> 家用门锁 ——> 家用门锁
Snipaste_20200717_105343.png

创建保险箱
安防传感 ——> 保险箱 ——> 保险箱
Snipaste_20200717_105410.png

DP点规范

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对接指南

MCU对接协议(产品数据通讯协议)

产品开发的公版通信协议,数据协议。开发者创建产品 ——> 选择模组 时可下载最新的通讯协议。

BLE门锁DP协议参考:Tuya_ble_锁类_dp点规范

BLE门锁MCU通讯协议参考:BLE门锁MCU对接协议

三方语音能力

BLE门锁已经支持第三方语音开门,需要下载app3.17.7以上版本。

支持的BLE门锁品类:选择 安防传感——> 家庭门锁,联网方式选择蓝牙BLE。

三方语音能力 支持情况
Alexa语音开门 支持语音开门语音关门语音开关门状态查询,且支持开关门Alexa语音反馈
BLE公寓门锁 支持语音开门语音关门语音开关门状态查询,不支持语音反馈