蓝牙穿戴设备数据接口指引

 

 

 

 

 

 

 

 

 

 

目录

蓝牙穿戴设备数据接口指引

1 需求说明

2 MQTT接口说明

2.1 作用

2.2 传输方式

2.3 网络访问地址、端口

2.4 数据格式

3 网页管理端:

3.1 作用

3.2 网络访问地址、端口

3.3 设备状态查询功能:

3.4 缓存管理功能:

3.5 服务状态:

 

 


 

1 需求说明

提供穿戴设备数据给数据使用者。

2 MQTT接口说明

2.1 作用 

通过接口,使用者可以实时获取穿戴设备数据

2.2 传输方式 

使用 MQTT 协议传输,系统开发商系统作为 MQTT service,数据使用者使用 MQTT 订阅 调用

2.3 网络访问地址、端口 

访问IP,视实际情况而定

访问端口,视实际情况而定,一般常用端口为1883

2.4 数据格式 

使用标准 json 格式,数据格式采用如下格式:

[

  {

    gatewaymac: 'DF76BEF61873',

    wearablemac: 'EBFD22580F2A',

    rssi: -83,

    stepCount: 99,

    calories: 3,

    temperature: 0,

    heartRate: 0,

    battery: 63,

    bpSystolic: null,

    bpDiastolic: null,

    bloodOxygen: null,

    sleep: null,

    sos: null,

    longitude: null,

    latitude: null,

    positionMode: null,

    positionAddress: null,

    isWearing: false

  }

]

 

 

 

其中:

1、gatewaymac:网关的mac地址共6个字节

2、wearablemac:穿戴设备的mac地址共6个字节

3、rssi:代表信号值(负数表示)

4、其它数据每款型号穿戴设备各不相同,具体上报数据请按照具体穿戴设备数据格式解析。

说明:

1、 传输间隔(触发机制):若穿戴设备被周围网关扫描到,最快每秒会发布数据;

2、 身份验证:MQTT的订阅host、portclientIdusernamepassword

 

3 网页管理端:

3.1 作用 

管理用,非代码层面

3.2 网络访问地址、端口 

访问IP,视实际情况而定

访问端口,视实际情况而定,一般常用端口为3000

 

3.3 设备状态查询功能: 

l 查看网关列表

显示服务启动后,所有网关的类型、最后上报数据时间

l 查看穿戴设备及类型列表

显示服务启动后,所有穿戴设备MAC+的类型,用于检验导入的穿戴设备数据是否正确

 

3.4 缓存管理功能: 

l 作用

需要重启服务器时,重启之前备份缓存文件,启动后回复,确保缓存数据不丢失

l 操作图示

 

3.5 服务状态: 

显示服务启动时间