|
|
@@ -1 +1,116 @@
|
|
|
-# 杀虫灯
|
|
|
+# 物联网杀虫灯与服务器端交互通讯细节
|
|
|
+
|
|
|
+## 简述
|
|
|
+
|
|
|
+本文档主要用于阐述物联网杀虫灯与服务器端进行交互的通讯细节。
|
|
|
+
|
|
|
+## 通信描述
|
|
|
+
|
|
|
+对接采用 HTTP 协议，由接收方写接口来接收 http post 数据（需从 request 的 body （字节流类型）中取数据，取到之后进行 json 解析）。
|
|
|
+
|
|
|
+## 对接说明
|
|
|
+
|
|
|
+### 设备数据说明
|
|
|
+
|
|
|
+1. **数据上传时间默认为 30 分钟一次**。
|
|
|
+2. **电击次数就是杀虫数**，上传一次 data 数据后重置为 0。
|
|
|
+
|
|
|
+### 设备对接说明
|
|
|
+
|
|
|
+1. **设备数据包含**：设备号、SIM 卡号、境温湿度、工作状态、经纬度、电压等。
|
|
|
+2. **由接收方提供接口接收数据**，设备方推送数据，需要提供一个可以外网访问的接口接收数据（与接收数据(离线数据与 data 数据区分，根据数据中的 cmd 字段进行区分)）。
|
|
|
+3. **先进行接口测试**，没问题后才能发正式数据。
|
|
|
+4. **如果对接完成后设备未收到数据**，请先检查所提供的接口是否有问题，然后再联系对接人员。
|
|
|
+5. **设备上线后会自动发送 data 数据**。
|
|
|
+6. **关于接口安全问题**，可以针对传输方 IP 做限制,不是传输方的 IP 不让其调用接口，（传输方 IP 可以联系对接人员提供）。
|
|
|
+7. **设备数据格式不可变**，不能按接收方增加或者减少字段，如有需求请联系销售经理。
|
|
|
+8. **接口设置是我们这边进行配置**，您只需要把接口发给对接人员就可以了。
|
|
|
+
|
|
|
+## 设备数据报文结构
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "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"
|
|
|
+}
|
|
|
+```
|
林轩