小机云

第三方设备接入流程 ​

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

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

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

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

名词解释 ​

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

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

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

接入步骤 ​

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

  1. 登陆小机云，找到或创建您的蓝牙项目，拿到ProjectId，ProjectSecret，校验内容格式（keyContent）
  2. 蓝牙按要求配置广播服务UUID
  3. 蓝牙按要求配置自定义广播
  4. 蓝牙按要求配置读写服务
  5. 使用您的蓝牙MAC地址在小机云控制台创建设备
  6. 完成上面步骤后，小机云蓝牙应用即可搜索到您的蓝牙硬件。下面需要完成蓝牙向小机云发送密钥进行校验。校验完后即可进行数据通讯

蓝牙要求 ​

蓝牙名：无要求。

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发送校验内容。校验通过后才可以使用数据传输

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

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

小机云蓝牙微信小程序 ​

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

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