蓝牙无网络激活

更新时间:2023-12-19 08:36:57下载pdf

涂鸦 蓝牙无网络激活 是指蓝牙和 Wi-Fi 双模设备在无法直连广域网的情况下,可以通过蓝牙连接 App,让 App 代理设备去云端激活的方案。该功能也称为 PlugPlay 配网能力

功能描述

您如果想要启用这个功能,请前往 涂鸦 IoT 开发平台,在 功能定义 > 高级功能 处为产品开启 PlugPlay 配网能力

蓝牙无网络激活

大概分为以下步骤:

  1. 设备可通过蓝牙通道将设备数据传送给 App。
  2. App 拿到设备信息后发送给云端,帮助设备在云端进行激活并拿到激活后的信息回传给设备,让设备处于被激活绑定的状态。
  3. 之后 App 可通过蓝牙通道来控制设备,同步设备状态等。

蓝牙无网激活流程

App设备云端用户进入蓝牙配网界面发送蓝牙广播包扫描蓝牙广播包,发现设备通过蓝牙连接设备连接成功用户主动选择蓝牙无网络激活或者配网时设备连路由或者连云失败之后会进入蓝牙无网络激活流程查询设备信息返回设备信息发送设备信息,代理激活返回设备 DP 描述等信息发送设备 DP 描述等信息接收成功设备进入被激活绑定的状态用户通过 App 控制设备发送控制命令设备执行指令返回设备当前状态App设备云端

开发指导

运行环境

由于每个双模模组上的资源不一样,并不会打开所有配网方式,您需要检查 tuya_iot_config.h 确认如下宏定义是否定义:

/* 蓝牙服务开关 */
#define ENABLE_BT_SERVICE 1

/* 蓝牙激活开关 */
#define ENABLE_BT_ACTIVE 1

限制条件

  • App 只有对支持 PlugPlay 配网能力 的设备,才支持蓝牙无网络激活功能。
  • 蓝牙无网络激活功能不需要您开发,也不需要您另外调接口触发。

使用方法

以下几种情况 App 会触发蓝牙无网络配网功能

  • 情况一:当蓝牙配网出现如下配网错误时。

    /* 设备连路由器、连云失败错误码 */
    typedef int AP_CFG_ERR_CODE;
    #define AP_CFG_SUCC 0
    #define AP_CFG_ERR_PCK 1
    #define AP_CFG_AP_NOT_FOUND 2
    #define AP_CFG_ERR_PASSWD 3
    #define AP_CFG_CANT_CONN_AP 4
    #define AP_CFG_DHCP_FAILED 5
    #define AP_CFG_CONN_CLOUD_FAILED 6
    #define AP_CFG_GET_URL_FAILED 7
    #define AP_CFG_GW_ACTIVE_FAILED 8
    #define AP_CFG_GW_ACTIVE_SUCCESS 9
    
  • 情况二:当用户在 App 上主动选择启用蓝牙无网络激活。

常见问题

配网失败后,App 会自动触发蓝牙无网络功能吗?

只有蓝牙配网失败才会触发该功能。

热点配网,闪电配网等 Wi-Fi 配网方式失败后,是不会触发蓝牙无网络激活的。并且,App 只有对支持 PlugPlay 配网能力 的设备,才支持蓝牙无网络激活功能。