蓝牙配网消息格式说明

本文档供自行开发小程序或APP，进行蓝牙配网对接时消息格式参考。
适用以下芯片模组：SU-63T、JX-12F、JX-A7T、JL-17T。

1.蓝牙服务和特征值

连接主服务ID：AE30
开启订阅：选择支持indicate的特征值
写入数据：选择支持write的特征值

2.蓝牙分包规则

消息分包发送，每次不超过20字节，每包第一字节为校验位。

前2位:

  • 10 表示 首包
  • 01 表示 中间包
  • 00 表示 结束包

后6位代表包数量
比如000001表示总共1个包，000100表示总共有4个包。

示例：

  • 首包：10000004
  • 中间包：01000001
  • 中间包：01000002
  • 结束包：00000003

3.消息结构

3.1 共用消息头header

字段 类型 含义
traceId String 消息id，ack要与原消息的traceId一致
payloadVersion Int 版本
udid String 任意字符串
timestamp Int 当前时间戳
method String 操作方法，用于指定操作： 1、device-cfg-wifi：设置WiFi； 2、device-properties-report：设备属性上报； 3、device-discovery：设备发现，获取设备基本信息。设备收到消息后，用相同的方法应答
auth_code String 设备密码，默认为空。如果需要设备生成密码，需要在小程序设备页选择设备密码为“设备本地密码”。如果密码校验不通过，返回retcode：4

3.2 各消息体字段说明

3.2.1 设置WiFi

字段 类型 含义
ssid String SSID
passwd String 密码
token String 默认填空

发送示例：

{
    "header": {
        "traceId": "xsd123456",
        "payloadVersion": 1,
        "udid": "abcdef",
        "timestamp": 0,
        "method": "device-cfg-wifi",
        "auth_code": ""
    },
    "body": {
        "ssid": "xxxx",
        "passwd": "123456",
        "token": ""
    }
}

3.2.2 属性上报（由设备主动上报）

字段 类型 含义
properties Array 属性列表
properties/id String 属性标识
properties/value Int或String 属性取值，当id=WifiConnect且value=1时，设备配网成功

返回示例：

{
    "header": {
        "traceId": "xsd123456",
        "payloadVersion": 1,
        "udid": "abcdef",
        "timestamp": 0,
        "method": "device-properties-report"
    },
    "body": {
        "properties": [
            {
                "id": "WifiConnect",
                "value": 1
            }
        ]
    }
}

3.2.3 设备发现

字段 类型 含义
deviceType String 设备类型
deviceIdentification String 设备标识
productKey String 产品标识
version String 产品版本

发送示例：

{
    "header": {
        "traceId": "xsd123456",
        "payloadVersion": 1,
        "udid": "abcdef",
        "timestamp": 0,
        "method": "device-discovery",
        "auth_code": ""
    },
    "body": {}
}

返回示例：

{
    "header": {
        "traceId": "xsd123456",
        "payloadVersion": 1,
        "udid": "abcdef",
        "timestamp": 0,
        "method": "device-discovery"
    },
    "body": {
        "deviceType": "VoiceLamp",
        "deviceIdentification": "ahg13aGFa3",
        "productKey": "skg352ZDg",
        "version": "1.0"
    }
}
作者：admin  创建时间：2026-09-20 16:50
最后编辑：admin  更新时间：2026-09-20 18:09