首页

当蓝牙锁无法通过常规手段（刷卡开锁、远程开锁）开锁的时候，可以通过蓝牙电子钥匙进行授权开锁。

蓝牙电子钥匙使用蓝牙连接，通过蓝牙协议写入授权信息，用户可使用蓝牙电子钥匙插入蓝牙锁TYPE-C接口进行开锁。

详细步骤

• 短按蓝牙电子钥匙的按钮开机
• 蓝牙连接钥匙
• 校准蓝牙钥匙的时间
• 管理员写入授权信息（包括授权开始、结束时间，总开锁次数，蓝牙锁编号），交给用户使用
• 用户把蓝牙钥匙数据线插入蓝牙锁的TYPE-C口，并按下蓝牙钥匙的按钮，蓝牙锁即可开锁。
• 用户关锁后，拔出蓝牙钥匙数据线，交还管理员
• 蓝牙连接钥匙，读取开锁日志，并保存
• 删除授权信息

如何使用

使用 Docker

• 创建容器

  docker run --name blekeyapi -d -e DefaultPassword=12345678 -e TenantPassword=87654321 -p 8080:80 --restart=always registry.cn-hangzhou.aliyuncs.com/an1-public/blekeyapi:1.0.0

• 可选环境变量：租户原密钥DefaultPassword，租户新密钥TenantPassword。更新设备密钥的时候，会验证设备现密钥是否与原密钥相同，验证通过则会更新为新密钥。镜像内置密钥为设备出厂时的默认密钥。
• 访问 http://127.0.0.1:8080

如何开发应用

• 在有蓝牙设备的电脑上，使用浏览器打开演示网站
• 在安卓Android手机上，使用 chrome 浏览器打开演示网站
• 在苹果iOS手机上，使用 safari 浏览器打开演示网站
  演示网站地址

操作逻辑
可查看演示网站源码了解操作逻辑，了解后可使用微信小程序等进行开发：

1. 搜索可用的蓝牙设备。Service uuid : 0000FFF0-0000-1000-8000-00805F9B34FB
2. 连接蓝牙设备后，监听读取特征：0000FFF6-0000-1000-8000-00805F9B34FB ，获取写入特征：0000FFF7-0000-1000-8000-00805F9B34FB
3. 通过API接口获取不同指令的数据，通过写入特征发送到蓝牙设备
4. 通过监听读取特征获取蓝牙设备返回的数据，并通过API解码接口对数据进行解码

举例：发送开锁指令

1. 打开演示网站后，输入蓝牙锁的编号，如49000303，搜索设备并配对，
2. 配对并连接成功后，点击【锁-开锁】按钮，网站会获取开锁指令，并将数据填入到“发送数据”输入框。
3. 点击【发送】按钮，数据将发送到蓝牙锁。
4. 蓝牙锁接收到数据后，会开锁并返回操作结果，网站将自动调用API接口对数据进行解码，并将结果显示在“蓝牙数据解析结果”区域。