基于蓝牙近距离连接产品的接口文档 - Blufi连接
概述
本接口文档旨在介绍TS-PSMB-4088 基于蓝牙通道传输,采用 BluFi 协议格式实现近距离信息交互,支持传输包括 Wi-Fi SSID、密码及其他功能参数在内的配置信息。简而言之,通过该通信机制,TS-PSMB-4088 可实现网络和参数配置功能。
流程简述
- 蓝牙连接建立:移动设备搜索并连接到TS-PSMB-4088
- GATT服务发现:连接后,移动设备发现设备提供的GATT服务和特征
- Blufi协议通信:通过特定的GATT特征,设备与移动应用进行数据通信,按照Blufi协议的格式传输数据
- 命令操作:基于Blufi协议自定义数据帧传输,设备支持特定的命令操作,实现重启/更换服务器/设置报警值等功能
更详细的参考文档
GATT说明
在GATT协议中,使用以下服务和特征UUID实现Blufi通信:
服务UUID
0xFFFF(16 bit)
写特征UUID
0xFF01
- 主要权限:可写
- 用于接收移动设备发送的数据
通知特征UUID
0xFF02
- 主要权限:可读可通知
- 用于向移动设备发送数据
通过以上特征,设备与移动应用之间可以进行双向的数据通信,按照Blufi协议的格式传输数据。
功能说明
配网
功能描述:通过蓝牙,将Wi-Fi的SSID和密码等配置信息从移动设备传输到TS-PSMB-4088,实现设备的联网。
实现步骤:
- 移动设备通过写特征发送Wi-Fi配置信息
- 设备接收到信息后,尝试连接指定的Wi-Fi网络
- 连接成功后,设备通过通知特征反馈连接结果
传输自定义数据
功能描述:在蓝牙连接的基础上,传输特定格式的自定义数据,实现设备的特定功能。
实现步骤:
- 移动设备通过写特征发送自定义数据命令
- 设备解析命令,执行相应的操作
- 设备通过通知特征反馈执行结果或返回数据
命令操作扩展
基于自定义数据传输,我们的产品TS-PSMB-4088扩展出特定的命令操作,例如:
- rconfig:读取设备当前配置信息
- wconfig:写入新的配置参数到设备
- reboot:重启设备
- ota:通过传输固件数据进行OTA升级
- resetr0:重置设备的R0基准值
- 详细接口