"数据转发服务"功能是温湿度监控平台为了满足客户平台不同协议而推出的一项服务。 支持HTTP、TCP、MQTT主流协议。

一、HTTP

参数

名称 类型 描述
Method String 请求方式,如POST、GET。
Timestamp Long 发送数据时间
Version Int 协议版本
PID Int 产品编号
Temperature Double 温度(-1000代表为空)
Humidity Double 湿度(-1000代表为空)
Voltage Double 电压(-1000代表为空)
L_wgs84 String 经纬度(WGS-84 坐标)
Datas > Timestamp Long 设备时间
  1. JOSN

    示例

    {"Method":"POST","Timestamp":1501224426512,"Version":1,"Datas":[{"PID":7,"Temperature":29.50,"Humidity":-1000.0,"Voltage":3.58,"L_wgs84":"","Timestamp":1501195550000},{"PID":5,"Temperature":29.90,"Humidity":0.65,"Voltage":3.64,"L_wgs84":"","Timestamp":1501195229000},{"PID":3,"Temperature":25.80,"Humidity":-1000.0,"Voltage":3.63,"L_wgs84":"","Timestamp":1501195508000},{"PID":2,"Temperature":26.50,"Humidity":0.59,"Voltage":3.61,"L_wgs84":"","Timestamp":1501195378000},{"PID":4,"Temperature":29.70,"Humidity":0.66,"Voltage":3.61,"L_wgs84":"","Timestamp":1501195436000}]}
  2. XML

    示例

    <?xml version="1.0"?><Command xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Timestamp>1501225406521</Timestamp><Version>1</Version><Datas><CommandBody><PID>7</PID><Temperature>29.50</Temperature><Humidity>-1000</Humidity><Voltage>3.58</Voltage><L_wgs84 /><Timestamp>1501196493000</Timestamp></CommandBody></Datas><Method>POST</Method></Command>

二、TCP

  1. Command Line 命令行协议

    说明:命令行协议,编码为 Ascii。命令行协议定义了每个请求以回车换行结尾 "\r\n"。

    格式说明:每项参数中间以“空格”隔开

    类型 协议版本 时间 内容(N) CRC 结束\r\n
    AA : 1 1501225869421 …… 254F

    内容部分说明:每项参数中以“|”隔开

    时间 产品编号 温度 湿度 电压 经纬度
    1501197059000 | 7 | 1501225869421 | 29.60 | -1000 | 3.58 |

    示例

    AA:1 1501225869421 1501197059000|7|29.60|-1000|3.58|| 254F

    注:-1000代表为空

  2. FixedHeader 头部格式固定并且包含内容长度的协议

    说明:头部格式固定并且包含内容长度的协议,编码为 Hex。 这种协议将一个请求定义为两大部分, 第一部分定义了包含第二部分长度等等基础信息. 我们通常称第一部分为头部 "request header(request name + len) + request body"。

    格式说明

    类型 长度 版本 时间 内容(N) CRC
    位数 1 bytes 2 bytes 1 bytes 6 bytes N bytes 2 bytes
    原始数据 AA 0035 01 11071C100515 …… 28CF
    AA 53 1 17-7-28 16:05:21

    内容部分说明

    时间 产品编号 温度 湿度 电压 经纬度
    位数 6 bytes 2 bytes 3 bytes 2 bytes 2 bytes 6 bytes
    原始数据 11071C08042E 0008 000A7A 0030 0EE2 0000000000000000
    17-07-28 16:04:46 8 26.82 0.48 3.81

    示例

    AA00350111071C10051511071C08042E0008000A7A00300EE2000000000000000011071C0802100007000B9000000DFC000000000000000028CF

    注:

      1、温度3byte,第一个字节,0为正,1代表为负。第2、3字节转为10进制,然后除以100.
      2、湿度2byte, 转为10进制,然后除以100.
      3、电压2byte, 转为10进制,然后除以1000.
      4、为0xffff 代表为空.

二、MQTT

参数

名称 类型 描述
Timestamp Long 发送数据时间
Version Int 协议版本
PID Int 产品编号
Temperature Double 温度(-1000代表为空)
Humidity Double 湿度(-1000代表为空)
Voltage Double 电压(-1000代表为空)
L_wgs84 String 经纬度(WGS-84 坐标)
Datas > Timestamp Long 设备时间
  1. JOSN

    示例

    {"Timestamp":1501224426512,"Version":1,"Datas":[{"PID":7,"Temperature":29.50,"Humidity":-1000.0,"Voltage":3.58,"L_wgs84":"","Timestamp":1501195550000},{"PID":5,"Temperature":29.90,"Humidity":0.65,"Voltage":3.64,"L_wgs84":"","Timestamp":1501195229000},{"PID":3,"Temperature":25.80,"Humidity":-1000.0,"Voltage":3.63,"L_wgs84":"","Timestamp":1501195508000},{"PID":2,"Temperature":26.50,"Humidity":0.59,"Voltage":3.61,"L_wgs84":"","Timestamp":1501195378000},{"PID":4,"Temperature":29.70,"Humidity":0.66,"Voltage":3.61,"L_wgs84":"","Timestamp":1501195436000}]}