Skip to content

第三方设备接入流程 ​

本文介绍第三方非小机云硬件如何接入小机云蓝牙服务

如果您只想先测试小机云蓝牙的效果

可以先使用我们的蓝牙模块,能帮助您快速了解小机云蓝牙。

X-B01蓝牙模块:购买地址

名词解释 ​

蓝牙广播名:蓝牙硬件广播的名字

项目名:指的是在小机云网页上,创建项目时设置的名字

设备名:指的是在小机云网页上,在设备详情设置的名字

接入步骤 ​

如果您用的是别家的蓝牙模块,请确认您的蓝牙模块是否可以做以下1,2,3的配置。因为有些蓝牙模块并没有开放下面参数配置指令

  1. 登陆小机云,找到或创建您的蓝牙项目,拿到 ProjectId 与 ProjectSecret。校验方式默认 HMAC 挑战应答,不需要配置校验内容格式;老项目若仍是 keyContent,按《设备校验 KeyContent》处理
  2. 蓝牙按要求配置广播服务UUID
  3. 蓝牙按要求配置自定义广播
  4. 蓝牙按要求配置读写服务
  5. 使用您的蓝牙MAC地址在小机云控制台创建设备
  6. 完成上面步骤后,小机云蓝牙应用即可搜索到您的蓝牙硬件。下面需要完成蓝牙向小机云发送密钥进行校验,校验完后即可进行数据通讯。校验流程见《设备校验 HMAC》,数据帧格式见《二进制协议》或《文本协议》

蓝牙要求 ​

蓝牙名:无要求。

MAC(必须):已经在小机云控制台中创建设备

广播UUID(必须):0000FFF0-0000-1000-8000-00805F9B34FB

主服务UUID(必须):FFF0

通知Characteristic UUID(必须):FFF1

写Characteristic UUID(必须):FFF2

广播数据(ManufacturerData,必须): 广播数据type:0xFF。广播数据value:MAC$ProjectId的HEX

例子:

MAC:112233445566

ProjectId:1013a1e95e36e921

mac去掉冒号加&和ProjectId组成字hex数组为广播内容,其中&为0x24,结果如下:

0x11 0x22 0x33 0x34 0x45 0x56 0x66 0x24 0x10 0x13 0xa1 0xe9 0x5e 0x36 0xe9 0x21

创建设备 ​

完成上述配置后需要使用您的MAC地址在小机云控制台上创建您的设备(添加流程:小机云控制台-->进入您的蓝牙项目-->设备列表-->创建设备)

完成上述步骤后,您的蓝牙设备已经可以被小机云蓝牙小程序/APP搜索得到

设备校验 ​

设备校验:当蓝牙与小机云蓝牙应用连接后,需要使用项目的密钥向 App 发挑战应答。校验通过后才可以使用数据传输。默认方式为 HMAC(见《设备校验 HMAC》),老项目可能是内容校验(见《设备校验 KeyContent》)

如果您是单片机+蓝牙模块项目,可以参考开源项目中的STM32 ble demo,通过单片机+蓝牙模块向小机云APP发送校验内容

如果您没有单片机,只有蓝牙模块或者ESP32主控,可以在主控上实现校验。可以用参考STM32 ble demo或esp32 demo的校验代码。

小机云蓝牙微信小程序 ​

完成上述步骤后,进入小机云蓝牙微信小程序,登录您的账户,搜索连接蓝牙硬件

可以参考《X-B01入门指引》如果您无法搜索或连接到蓝牙硬件,可以查看文章《常见问题》

数据通讯 ​

校验通过后,设备与 App 之间使用下面两种协议之一(可混用):

  • 文本协议:$X#Cmd#Content&CheckCode\r\n,字段以 key:value 文本传输
  • 二进制协议:[0xAE][CMD][LEN][PAYLOAD],字节布局由控制台「二进制转换表」决定

关于平台与引脚 ​

本文只规定蓝牙广播、服务 UUID、校验与数据帧。MCU 型号、框架、引脚与传感器接线由开发者自行决定,平台不限制,也无法从控制台推断。

相关文档 ​