|
@@ -1,16 +1,16 @@
|
|
|
# 杀虫灯http协议
|
|
# 杀虫灯http协议
|
|
|
|
|
|
|
|
-## 1. 简要描述
|
|
|
|
|
|
|
+## 简要描述
|
|
|
|
|
|
|
|
本文档主要用于阐述杀虫灯与服务器端进行交互的通讯细节。
|
|
本文档主要用于阐述杀虫灯与服务器端进行交互的通讯细节。
|
|
|
|
|
|
|
|
-## 2. 通信描述
|
|
|
|
|
|
|
+## 通信描述
|
|
|
|
|
|
|
|
需要接收方编写接口以接收数据,使用 POST 请求。数据分为 `status`、`data` 和 `offline` 类型,可以共用一个接口,并根据 `cmd` 字段进行解析。
|
|
需要接收方编写接口以接收数据,使用 POST 请求。数据分为 `status`、`data` 和 `offline` 类型,可以共用一个接口,并根据 `cmd` 字段进行解析。
|
|
|
|
|
|
|
|
-## 3. 状态报告
|
|
|
|
|
|
|
+## 状态报告
|
|
|
|
|
|
|
|
-### 报文结构
|
|
|
|
|
|
|
+报文结构
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -79,7 +79,7 @@
|
|
|
| stamp | 时间戳:20180301211805 |
|
|
| stamp | 时间戳:20180301211805 |
|
|
|
| info | 用于内部调试 |
|
|
| info | 用于内部调试 |
|
|
|
|
|
|
|
|
-4. 数据报告
|
|
|
|
|
|
|
+## 数据报告
|
|
|
报文结构
|
|
报文结构
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -180,13 +180,13 @@
|
|
|
|
|
|
|
|
# 杀虫灯mqtt协议
|
|
# 杀虫灯mqtt协议
|
|
|
|
|
|
|
|
-## 1. 物联网杀虫灯通讯约定
|
|
|
|
|
|
|
+## 物联网杀虫灯通讯约定
|
|
|
|
|
|
|
|
-### 1.1. 简要描述
|
|
|
|
|
|
|
+### 简要描述
|
|
|
|
|
|
|
|
本文档主要用于阐述物联网杀虫灯与服务器端进行交互的通讯细节,其中包括物联网杀虫灯与服务器之间使用的通信协议和交互通讯协议两部分。
|
|
本文档主要用于阐述物联网杀虫灯与服务器端进行交互的通讯细节,其中包括物联网杀虫灯与服务器之间使用的通信协议和交互通讯协议两部分。
|
|
|
|
|
|
|
|
-### 1.2. 设备主题
|
|
|
|
|
|
|
+### 设备主题
|
|
|
|
|
|
|
|
关于主题 `sub` 和 `pub` 的说明,注意不要混淆:
|
|
关于主题 `sub` 和 `pub` 的说明,注意不要混淆:
|
|
|
|
|
|
|
@@ -197,7 +197,7 @@
|
|
|
|
|
|
|
|
其中 `<imei>` 指设备唯一标识。
|
|
其中 `<imei>` 指设备唯一标识。
|
|
|
|
|
|
|
|
-### 1.3. 术语和缩略语
|
|
|
|
|
|
|
+### 术语和缩略语
|
|
|
|
|
|
|
|
| 缩写 | 描述 |
|
|
| 缩写 | 描述 |
|
|
|
|-----------|-------------------------------|
|
|
|-----------|-------------------------------|
|
|
@@ -213,15 +213,15 @@
|
|
|
| power | 服务器下发开关协议命令字,报文中使用 |
|
|
| power | 服务器下发开关协议命令字,报文中使用 |
|
|
|
| timer | 服务器下发定时协议命令字,报文中使用 |
|
|
| timer | 服务器下发定时协议命令字,报文中使用 |
|
|
|
|
|
|
|
|
-## 2. 通信协议
|
|
|
|
|
|
|
+## 通信协议
|
|
|
|
|
|
|
|
-### 2.1. MQTT协议版本
|
|
|
|
|
|
|
+### MQTT协议版本
|
|
|
|
|
|
|
|
物联网杀虫灯使用主流公开的 MQTT 协议 V3.1.1 版本作为通讯协议,默认 QOS 质量等级为 0。服务器端需要实现 MQTT 协议的转发和解析,数据的上报为 JSON 格式。
|
|
物联网杀虫灯使用主流公开的 MQTT 协议 V3.1.1 版本作为通讯协议,默认 QOS 质量等级为 0。服务器端需要实现 MQTT 协议的转发和解析,数据的上报为 JSON 格式。
|
|
|
|
|
|
|
|
MQTT V3.1.1 协议详见附件。
|
|
MQTT V3.1.1 协议详见附件。
|
|
|
|
|
|
|
|
-### 2.2. 报文分类
|
|
|
|
|
|
|
+### 报文分类
|
|
|
|
|
|
|
|
- **状态**
|
|
- **状态**
|
|
|
- `status`:状态报告
|
|
- `status`:状态报告
|
|
@@ -246,7 +246,7 @@ MQTT V3.1.1 协议详见附件。
|
|
|
|
|
|
|
|
根据 MQTT 的特性,下发服务不必回复,可以通过设置下位机的 QOS 为 2 或 1 来保证命令必达,也可以通过服务器主动下发查询状态和下发查询配置指令,来判断是否执行成功。
|
|
根据 MQTT 的特性,下发服务不必回复,可以通过设置下位机的 QOS 为 2 或 1 来保证命令必达,也可以通过服务器主动下发查询状态和下发查询配置指令,来判断是否执行成功。
|
|
|
|
|
|
|
|
-### 2.3. 报文结构
|
|
|
|
|
|
|
+### 报文结构
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -261,7 +261,7 @@ ext:为各个命令字对应的信息内容。
|
|
|
|
|
|
|
|
|
|
|
|
|
### 上行通信
|
|
### 上行通信
|
|
|
-2.4.1. 状态报告
|
|
|
|
|
|
|
+ 状态报告
|
|
|
报文结构
|
|
报文结构
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -324,7 +324,7 @@ ext:为各个命令字对应的信息内容。
|
|
|
| lat | 纬度 |
|
|
| lat | 纬度 |
|
|
|
| stamp | 时间戳:20180301211805 |
|
|
| stamp | 时间戳:20180301211805 |
|
|
|
|
|
|
|
|
-2.4.2. 数据报告
|
|
|
|
|
|
|
+### 数据报告
|
|
|
报文结构:
|
|
报文结构:
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -386,8 +386,8 @@ ext:为各个命令字对应的信息内容。
|
|
|
| stamp | 时间戳:20180301211805 |
|
|
| stamp | 时间戳:20180301211805 |
|
|
|
|
|
|
|
|
### 交互协议
|
|
### 交互协议
|
|
|
-3.1.下行通信
|
|
|
|
|
-3.1.1. 下发查询请求:
|
|
|
|
|
|
|
+下行通信
|
|
|
|
|
+下发查询请求:
|
|
|
查询状态报文结构:
|
|
查询状态报文结构:
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -403,7 +403,7 @@ ext:为各个命令字对应的信息内容。
|
|
|
| data | 请求读取数据信息 |
|
|
| data | 请求读取数据信息 |
|
|
|
| paramconf | 请求读取参数配置信息 |
|
|
| paramconf | 请求读取参数配置信息 |
|
|
|
|
|
|
|
|
-3.1.2. 参数配置
|
|
|
|
|
|
|
+### 参数配置
|
|
|
报文结构:
|
|
报文结构:
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|