设备配网 UI 业务包

更新时间:2024-06-24 06:39:57下载pdf

业务功能涵盖了目前涂鸦智能所有的 Wi-Fi 设备、Zigbee 设备、蓝牙设备以及支持二维码扫码的设备(例如 GPRS & NB-IoT 设备)等不同类型设备配网前置操作引导和具体入网激活实现。

设备类型

Wi-Fi 设备配网

支持 Wi-Fi 智能设备入网连接云服务,Wi-Fi 设备配网主要有 EZ 模式和 AP 模式两种,其中 IPC 设备支持扫二维码方式配网。

名词 解释
EZ 模式 又称 Wi-Fi 快连模式,App 把配网数据包打包到 802.11 数据包的指定区域中,发送到周围环境。智能设备的 Wi-Fi 模组处于混杂模式下,监听捕获网络中的所有报文,按照约定的协议数据格式解析出 App 发出配网信息包。
AP 模式 又称热点模式,手机作为 STA 连接智能设备的热点,双方建立一个 Socket 连接通过约定端口交互数据。

Zigbee 设备配网

支持 Zigbee 网关和子设备配网。

名词 解释
Zigbee 网关 融合 Zigbee 网络中协调器和 Wi-Fi 功能的设备,负责 Zigbee 网络的组建及数据信息存储。
子设备 Zigbee 网络中的路由或者终端设备,负责数据转发或者终端控制响应。

蓝牙设备配网

涂鸦蓝牙有三条技术线路,主要包括蓝牙、蓝牙 Mesh、涂鸦 Mesh 以及双模设备。

名词 解释
蓝牙 通过蓝牙与手机一对一相连的蓝牙单点设备
蓝牙 Mesh 采用蓝牙技术联盟发布的蓝牙拓扑通信
双模设备 支持多协议的设备,即同时具备 Wi-Fi 能力和蓝牙能力的设备

扫码配网设备

该类设备上电后即连接了涂鸦 IoT 云,App 通过扫描设备上的二维码(必须是涂鸦支持的二维码规则,支持固件具体接入方式可咨询涂鸦科技相关商务及项目经理)使能设备去涂鸦云激活绑定。

名词 解释
GPRS 设备 采用 GPRS 通信技术接入网络连接云服务的智能设备
NB-IoT 设备 采用窄带物联网 (Narrowband-IoT) 技术的智能设备

自动发现配网

融合涂鸦智能通用配网技术实现,为用户提供一套快捷配网的功能。

业务包集成

业务集成

  1. 创建工程。

    在 Android Studio 中建立您的工程,接入涂鸦商用照明 SDK 并完成 业务包框架接入

  2. 配置业务的 build.gradle

    dependencies {
    	api enforcedPlatform("com.thingclips.smart:thingsmart-BizBundlesBom:2.8.0-bizbundle-lamp-2.8.0.27")
            api ("com.thingclips.smart:thingsmart-bizbundle-lamp_device_activator")
    }
    
  3. 混淆配置。

    #fastJson
    -keep class com.alibaba.fastjson.**{*;}
    -dontwarn com.alibaba.fastjson.**
    
    #rx
    -dontwarn rx.**
    -keep class rx.** {*;}
    -keep class io.reactivex.**{*;}
    -dontwarn io.reactivex.**
    -keep class rx.**{ *; }
    -keep class rx.android.**{*;}
    
    #fresco
    -keep class com.facebook.drawee.backends.pipeline.Fresco
    -keep @com.facebook.common.internal.DoNotStrip class *
    -keepclassmembers class * {
    @com.facebook.common.internal.DoNotStrip *;
    }
    
    #tuya
    -keep class com.thingclips.**{*;}
    -dontwarn com.thingclips.**
    

功能调用

功能配置

配置项 字段名 描述
AP 热点名称配置 <string name="ap_mode_ssid">SmartLife</string> AP 配网支持的热点前缀列表,默认配置:SmartLife
是否支持蓝牙 <bool name="is_need_ble_support">true</bool> 是否支持蓝牙设备配网功能,默认配置:true
是否支持 Mesh <bool name="is_need_blemesh_support">true</bool> 是否支持 Mesh 设备配网功能,默认配置:true
是否支持扫一扫 <bool name="is_scan_support">true</bool> 是否支持列表页面右上角扫描配网功能,默认配置:true
自发现是否支持 EZ 配网 <bool name="is_config_activator_ez">false</bool> 是否支持自发现页面配网 EZ 类型设备,默认配置:false

方法调用

ThingDeviceActivatorManager.INSTANCE.startDeviceActiveAction(this);

ThingDeviceActivatorManager.INSTANCE.addListener(new IThingDeviceActiveListener() {

            @Override
            public void onDevicesAdd(List<String> list) {

            }

            @Override
            public void onRoomDataUpdate() {

            }

            @Override
            public void onOpenDevicePanel(String s) {

            }

            @Override
            public void onExitConfigBiz() {

            }
        });

入参说明

参数 说明
activity activity
homeId 当前配网所在区域对应的关系 ID,获取方式参考 获取区域对应的关系 ID

出参说明

参数 说明
devIds 配网成功的设备 ID 列表
updateRoomData 房间设备信息是否有变更
onOpenDevicePanel 可以打开某个面板,根据实际业务需要选择实现
onExitConfigBiz 未执行配网,主动退出配网业务,根据实际业务需要选择实现