Skip to content

设备接入

设备搜索规则,设备权限

名词解释

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

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

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

蓝牙要求

蓝牙名:无要求。如果设备在网页上没有设备名字,则设备显示的名字会被会替换成项目名。如果项目名带有$mac,则被APP替换成MAC后6位(无冒号)

蓝牙名:XSGEE-BLE

MAC:112233445566

项目名:小鸭玩具-$mac

情况一:未设置设备名,则小机云蓝牙APP搜索显示,小鸭玩具-445566

情况二:在网页端设置设备名“鱼缸灯1”,则小机云蓝牙APP搜索显示,鱼缸灯1

MAC:用指令查询出来的MAC和广播的出来的MAC,都需要12位无冒号,如112233445566

主服务UUID:0000FFF0-0000-1000-8000-00805F9B34FB

通知Characteristic UUID:0xFFF1

写Characteristic UUID:0xFFF2

广播数据(ManufacturerData ):MAC&ProjectId字符串的HEX,其中MAC不可以有冒号。如

MAC:11:22:33:44:55:66

ProjectId:1013a1e95e36e921

组成字符串:112233445566&1013a1e95e36e921

把上面的字符串转为二进制字符串:3131323233333434353536362631303133613165393565333665393231

二维码格式

下面链接生成二维码,如果使用小机云蓝牙APP搜索则会执行如下操作。如果在非小机云APP,则会跳转到APP下载页

直接连接设备

https://xsgee.com/open-mp-xsgee-ble/open?action=toDevice&projectId=项目ID&mac=mac地址

参数:

projectId:设备项目ID

mac地址:设备二维码。需要冒号,如:11:22:33:44:55:66

跳转到搜索页

https://m.xsgee.com/appdl/#/appdl-ble?action=toScan&name=设备名&mac=mac地址

https://m.xsgee.com/appdl/#/appdl-ble?action=toScan& 为固定格式

参数:

name:非必选。搜索指定设备名的设备。如果没有设置设备名,则过滤项目名。只要名字中包含关键就会被搜索出来

mac:非必选。搜索指定MAC地址的设备。如:11:22:33:44:55:66