蓝牙配网

添加设备-蓝牙配网 | TUTK P2P SDK 开发指南

一、配网流程图

图1：蓝牙配网完整流程图

（一）设备端进入蓝牙配网模式

设备通过硬件触发（如按键长按）进入蓝牙配网模式，启动蓝牙广播，对外发送设备标识信息。

（二）客户端解析蓝牙广播包

客户端通过蓝牙扫描指定名称的BLE设备，呈现到搜索到的设备列表。

（三）用户选择待配网的设备

APP展示扫描到的可配网设备列表，用户选择目标设备后，进入WiFi信息配置页面。

（四）客户端发送WiFi配置给设备

客户端从DeviceProfile（每一个设备图标都有对应的profile）获取蓝牙设备的服务uuid和特征值uuid。

客户端通过蓝牙设备ID和uuid的write、read服务，与设备交互数据。

1. APP发送WiFi配置信息结构

{ "m": "", "i": , "p":{ "s": "", "p": "", "r": "" } }

2. WiFi配置信息参数说明

3. WiFi配置信息 - params 参数定义说明

参数	类型	是否必须	说明
`s`	string	是	ssid，表示目标WiFi的SSID（网络名称）
`p`	string	是	password，表示目标WiFi的连接密码
`r`	string	是	region，根据Kalay App当前所在环境，将区域信息同步给设备

4. 区域定义说明

（五）设备端回复设备信息

设备接收并验证WiFi配置信息后，返回设备P2P连接所需的核心信息。

1. 设备连线信息结构

{ "i": , "r":{ "s": , "d": "", "p": "", "a": "" } }

2. 设备回复连线信息参数说明

参数	类型	是否必须	说明
`i`	int	是	请求ID，与APP发送的i值保持一致
`r`	object	是	结果参数对象，包含连接状态和设备信息

3. result参数说明

备注：

4. state参数值说明

（六）客户端获取设备配网状态

APP通过蓝牙发送状态查询请求，获取设备配网进度和结果。

1. 获取设备配网状态信息结构

{ "m": "", "i": }

2. 客户端获取设备状态信息参数说明

参数	类型	是否必须	说明
`m`	string	是	status，固定值。表示请求查询配网状态
`i`	int	是	请求ID（指令标识），需与设备回复保持一致

（七）设备端回复配网状态

设备根据当前配网进度，返回详细状态信息和错误提示（如有）。

1. 设备回复配网状态信息结构

{ "i": , "s": , "e":{ "c": , "m": "" } }

2. 设备回复配网状态信息参数说明

3. error参数说明

参数	类型	是否必须	说明
`c`	int	是	错误码：0表示无错误，其他值表示具体错误类型
`m`	string	是	错误描述信息，用于APP展示给用户