物联网杀虫灯与服务器端交互通讯细节

简述

本文档主要用于阐述物联网杀虫灯与服务器端进行交互的通讯细节。

通信描述

对接采用 HTTP 协议，由接收方写接口来接收 http post 数据（需从 request 的 body （字节流类型）中取数据，取到之后进行 json 解析）。

对接说明

设备数据说明

数据上传时间默认为 30 分钟一次。
电击次数就是杀虫数，上传一次 data 数据后重置为 0。

设备对接说明

设备数据包含：设备号、SIM 卡号、境温湿度、工作状态、经纬度、电压等。
由接收方提供接口接收数据，设备方推送数据，需要提供一个可以外网访问的接口接收数据（与接收数据(离线数据与 data 数据区分，根据数据中的 cmd 字段进行区分)）。
先进行接口测试，没问题后才能发正式数据。
如果对接完成后设备未收到数据，请先检查所提供的接口是否有问题，然后再联系对接人员。
设备上线后会自动发送 data 数据。
关于接口安全问题，可以针对传输方 IP 做限制,不是传输方的 IP 不让其调用接口，（传输方 IP 可以联系对接人员提供）。
设备数据格式不可变，不能按接收方增加或者减少字段，如有需求请联系销售经理。
接口设置是我们这边进行配置，您只需要把接口发给对接人员就可以了。

设备数据报文结构

{
  "topic": "/yfkj/scd/pub/867435052203452",
  "payload": {
    "cmd": "data",
    "ext": {
      "imei": "867435052203452",
      "iccid": "89680401101700076471",
      "csq": "29",
      "dtype": "1",
      "dver": "1.0.0",
      "stm8vs": "1.0.0",
      "ws": "0",
      "ds": "1",
      "tt": "7",
      "lps": "0",
      "rps": "0",
      "tps": "0",
      "dps": "0",
      "bt": "25",
      "voltval": "60",
      "ts": "0",
      "st": "20",
      "et": "2",
      "cv": "18.000",
      "bv": "12.800",
      "at": "0",
      "ah": "0",
      "ct": "0",
      "clt_t": "30",
      "dat_f": "30",
      "rcnt": "0",
      "info": "2",
      "gps": "1",
      "lng": "113.67336",
      "lat": "34.815187",
      "stamp": "20180301211805"
    }
  }
}

字段说明

字段名	描述
imei	通讯板唯一 ID
iccid	SIM 卡卡号
csq	信号强度
dver	4G 物联网模块代码版本号
ws	工作状态 0: 待机，1: 工作，2: 充电
ds	设备开关 0: 关机，1: 开机
tt	定时时长 (0~7)小时, 0 表示常亮
lps	光控状态 0: 正常 1: 保护 (检测到白天，光控模式下白天不工作，所以保护，2: 充电状态)
rps	雨控状态 0: 正常 1: 保护
tps	温控状态 0: 正常 1: 保护 (设备进入温控状态)
dps	倾倒状态 0: 正常 1: 保护 (设备进入倾倒状态)
bt	主板温度，默认 25 度
ts	时控开关 0: 关闭时控 1: 开启时控（设备工作状态，光控默认工作时间为天黑后 8 小时，时控可以设置工作时间范围）
st	时控开始时间，单位: 小时 0~23
et	时控结束时间，单位: 小时 0~23
cv	充电电压，单位: V 字符串
bv	电池电压，单位: V 字符串
at	环境温度 (字符串)
ah	环境湿度 (字符串)
ct	电击次数，范围 0~255 (每上报一次数据消息（data 消息）后清零)
clt_t	清虫间隔时间，单位：分钟
dat_f	数据上传时间，单位：分钟
rcnt	设备重启次数
gps	定位方式 0: 手动定位 1: GPS 定位 2: 基站定位
lng	经度
lat	纬度
stamp	时间戳，格式：YYYYMMDDHHmmss（例如 20180301211805）

遗愿消息

设备默认设置配置了 MQTT 遗愿消息。当设备异常下线时（客户端断开前未向服务器发送 DISCONNECT 消息），MQTT 消息服务器会发布异常下线设备的遗愿消息。

报文结构

{
  "cmd": "offline",
  "ext": {
    "imei": "867435052203452"
  },
  "topic": "/yfkj/scd/pub/867435052203452"
}

scd.md 5.5 KB История Исходник