Просмотр исходного кода

补充交互协议和其它开发资料

niujiuru 6 месяцев назад
Родитель
Сommit
a29f8012d8
2 измененных файлов с 341 добавлено и 0 удалено
  1. 1 0
      docs/android一体机sdk开发在线资料.txt
  2. 340 0
      docs/小虫体协议 - V0.5 260519.md

+ 1 - 0
docs/android一体机sdk开发在线资料.txt

@@ -0,0 +1 @@
+https://alidocs.dingtalk.com/i/p/R2PmKb7Dp3WajXvp/docs/XPwkYGxZV3yAOq0qT76eA3Pb8AgozOKL

+ 340 - 0
docs/小虫体协议 - V0.5 260519.md

@@ -0,0 +1,340 @@
+# 小虫体平台端交互协议
+
+## 1. 数据上传
+
+以设备ID(864865062126413)为示例
+
+topic(设备端 -> 平台端) : /yfkj/XCT/pub/864865062126413    
+topic(平台端 -> 设备端) : /yfkj/XCT/sub/864865062126413
+
+### 1.1 rtu数据上传
+
+数据上报示例(设备端 -> 平台端)无需回复
+
+```c
+{
+    "cmd": "rtu_data",
+    "ext": {
+        "proj": "A7_RTU_V3",
+        "dver": "2.9.sqlite",
+        "cpu_tmp": "47570",
+        "imei": "864865062126413",
+        "iccid": " 50\r\n",
+        "csq": "8",
+        "dat_f": "",
+        "cam_type": "0",
+        "stamp": "20241025155043",
+        "lat": "0",
+        "lng": "0"
+    }
+}
+```
+
+字段解析
+        "proj": "A7_RTU_V3",            // RTU硬件版本号
+        "dver": "2.9.sqlite",           // RTU软件版本号
+        "cpu_tmp": "47570",             // 主控温度(放大1000倍)
+        "imei": "864865062126413",      // 设备ID号
+        "iccid": " 50\r\n",             // 物联网卡号(若有)
+        "csq": "8",                     // 4G信号强度
+        "dat_f": "",                    //数据上报间隔
+        "cam_type": "0",                // 相机类型
+        "stamp": "20241025155043",      // 时间戳
+        "lat": "0",                     // 经度
+        "lng": "0"                      // 纬度
+
+### 1.2 控制板数据上传
+
+ 数据上报示例(设备端 -> 平台端)无需回复
+
+```c
+{
+    "cmd": "data",
+    "ext": {
+        "dver": "2.6.B_18-2.9.sqlite",
+        "proj": "A7_RTU_V3",
+        "dtype": "3",
+        "tt": "2",
+        "collstart": "5",
+        "collend": "10",
+        "ts": "0",
+        "tps": "0",
+        "tph": "50",
+        "tpl": "10",
+        "lps": "0",
+        "rps": "0",
+        "batStatus": "1",
+        "lamp": "0",
+        "lamp_down": "0",
+        "gps": "0",
+        "ds": "1",
+        "ah": "31",
+        "at": "-15",
+        "imei": "864865062126413",
+        "iccid": " 50\r\n",
+        "stamp": "20241025161230",
+        "lng": "0",
+        "lat": "0",
+        "rcnt": 59,
+        "current": "290.95",
+        "vbat": "11.84",
+        "dat_f": "20",
+        "csq": "8"
+    }
+}
+```
+
+字段解析
+        "dver": "2.6.B_18-2.9.sqlite",    // 设备版本号(以"-"为分隔符 -前为控制板版本号 -后为rtu版本号)
+        "proj": "A7_RTU_V3",              // RTU硬件版本号
+        "dtype": "3",                     // 设备类型
+        "tt": "2",                        // 光控定时工作时长
+        "collstart": "5",                 // 时控定时起始时间
+        "collend": "10",                  // 时控定时结束时间
+        "ts": "0",                        // 定时模式(0-时控 1-光控)           
+        "tps": "0",                       // 温控保护使能(0-失能 1-使能)
+        "tph": "50",                      // 温控保护上限(℃)
+        "tpl": "10",                      // 温控保护下限(℃)
+        "rps": "0",                       // 雨控开关(0-失能 1-使能)
+        "lps": "0",                       // 光控状态(0-正常 1-光控)     light protect status
+        "nrps": "0",                      // 降雨(0-否 1-是)    now rain protect status
+        "ntps": "0",                      // 温控状态(0-正常 1-温控上限    2-温控下限)now temp protect status
+        "batStatus": "1",                 // 当前电池状态(0-欠压 1-正常)
+        "lamp": "0",                      // 当前灯管状态(0-待机 1-开启)
+        "gps": "0",                       // gps定位状态(0-未定位 1-已定位)
+        "ds": "1",                        // 设备开关状态(0-已关闭 1-已开启)
+        "ah": "31",                       // 当前环境湿度(%)
+        "at": "-15",                      // 当前环境温度(℃)
+        "imei": "864865062126413",        // 设备ID
+        "iccid": " 50\r\n",               // 物联网卡卡号
+        "stamp": "20241025161230",        // 时间戳
+        "lng": "0",                       // 经度
+        "lat": "0",                       // 纬度
+        "rcnt": 59,                       // 是否为上电开机(保留参数)
+        "current": "290.95",              // 当前工作电流(mA)
+        "vbat": "11.84",                  // 当前电池电压
+        "dat_f": "20",                    // 设备数据上报间隔
+        "csq": "8"                        // 4G信号强度
+
+        "led_sta": "0",             // 当前补光灯状态(0-待机 1-开启)
+
+        "fan_sta": "0",             // 当前采集风机状态(0-待机 1-开启)
+
+        "lamp_down": "0", // 当前下灯管状态(0-待机 1-开启)
+
+
+
+
+
+## 2. 平台控制指令
+
+指令示例
+{
+    "cmd": "paramconf",
+    "ext": {
+        "paraname": "para"
+    }
+}
+
+以下参数可同时下发可单独下发,单独修改某一参数时建议仅对当前修改参数做下发
+
+### 2.1 时控定时区间设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "collstart": 5,
+        "collend": 5
+    }
+}
+```
+
+collstart : 时控工作开始时间(整型 / 时)
+collend : 时控工作结束时间(整型 / 时)
+
+### 2.2 光控定时时长设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "tt": 5
+    }
+}
+```
+
+tt : 光控工作时长(整型 / 时)
+
+### 2.3 工作模式设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "ts": 0
+    }
+}
+```
+
+ts : 工作模式(整型 / 0-时控 1-光控)
+
+### 2.4 温控参数设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "tpl": 9,
+        "tph": 36
+    }
+}
+```
+
+tpl : 温控保护下限位(整型 / ℃)
+tph : 温控保护上限位(整型 / ℃)
+
+### 2.5 间隔设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "inr_data": 9,
+        "inr_photo": 36
+    }
+}
+```
+
+inr_data : 数据上报间隔(整型 / min)
+inr_photo : 工作时拍照间隔(整型 / min)
+
+### 2.6 保护设置
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "limit_temp": 0,
+        "limly_rain": 1
+    }
+}
+```
+
+limit_temp : 设置温控开关(bool / 0-关闭 1-开启)
+limly_rain : 设置雨控开关(bool / 0-关闭 1-开启)
+
+### 2.7 全量下发示例
+
+当需要一次性下发所有参数 参考以下格式
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "tpl": 9,
+        "tph": 36,
+        "inr_data": 9,
+        "inr_photo": 36,
+        "limit_temp": 0,
+        "limly_rain": 1,
+        "tt": 5,
+        "ts": 0,
+        "collstart": 5,
+        "collend": 5
+    }
+}
+```
+
+### 2.8 恢复默认参数
+
+下发指令
+
+```c
+{"cmd": "ctrl", "ext": {"RC": "Force_Reset"}}
+```
+
+设备回复
+
+```c
+{"cmd": "data", "ext": "Force_Reset"}
+```
+
+
+
+# 3. 安卓屏与控制板交互细则
+
+## 3.1 测试相关
+
+安卓屏  > 控制板:
+
+```C
+systest switchled touch
+```
+
+控制板 > 安卓屏 :
+
+```c
+{
+    "cmd":    "test",
+    "ext":    {
+        "type":    "switchled",
+        "status":    "Turn OFF",
+        "info":    "手动测试:补光已关闭"
+    }
+}
+```
+
+## 3.2 事件记录展示
+
+### 3.2.1 获取事件信息
+
+安卓屏 > 控制板:
+
+```c
+{
+    "cmd": "ReadEcodeInfo"
+}
+```
+
+控制板 > 安卓屏 :
+
+```c
+{
+    "cmd":    "ecode",
+    "ext":    {
+        "count":    58,
+        "pages":    10
+    }
+}
+```
+
+### 3.2.2 获取事件内容
+
+安卓屏 > 控制板:
+
+```c
+{
+    "cmd": "paramconf",
+    "ext": {
+        "ecode_pagenum": 5
+    }
+}
+```
+
+控制板 > 安卓屏 :
+
+```c
+{
+    "cmd":    "ecode",
+    "ext":    {
+        "count":    58,
+        "31 - 18/01/01 00:00:18 (19-0)":    "一键测试开始",
+        "32 - 18/01/01 00:00:48 (3-0)":    "风机预警",
+        "33 - 18/01/01 00:00:30 (28-1)":    "30秒种前设备重启",
+        "34 - 18/01/01 00:02:21 (19-0)":    "一键测试开始",
+        "35 - 18/01/01 00:02:24 (19-1)":    "一键测试手动结束",
+        "36 - 18/01/01 00:00:17 (19-0)":    "一键测试开始"
+    }
+}
+```