完善设备端体验与微信校验支持

2026-07-07 16:58:05 +08:00
parent b4fef6d2e0
commit 937e3023fc
38 changed files with 3377 additions and 51 deletions
--- a/talkingq-url/docs/HXNd3XMbPq.txt
+++ b/talkingq-url/docs/HXNd3XMbPq.txt
@@ -0,0 +1 @@
+60756bcfc3d838155f64397bec395a44
--- a/talkingq-url/docs/mqtt协议_V1.9.txt
+++ b/talkingq-url/docs/mqtt协议_V1.9.txt
@@ -0,0 +1,320 @@
+device/imei/command    # 服务器下发命令（下行）
+device/imei/response   # 设备响应（上行）
+device/imei/event      # 设备主动事件
+device/imei/event_resp # 事件返回
+
+消息格式（JSON）
+device/imei/event 
+0.设备定时10分钟上报信息
+{
+  "msg_id": "000",
+   "data": {
+    "id":"TalkingQ_xxx",
+    "power": 20,              剩余电量每个间隔20，从0-100   
+	"signal": 3,              信号强度1是最弱的 5是最强
+	"voice":60,               每个间隔20，从40-100
+	"imei":"861921071409242",
+	"version":"v1.0",   
+	"latitude":23.1173393,
+	"longitude":113.2855975
+	"device_type":0,           0 no NFC+no GPS  1 NFC  2、NFC+GPS
+  }
+}
+服务器返回
+device/imei/event_resp
+{
+	"msg_id": "000",
+	"status": "success"
+}
+
+1. GPS位置查询
+device/imei/command 
+服务器下发：
+{
+  "msg_id": "001"
+}
+
+
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "001",
+  "status": "success",
+  "data": {
+    "latitude": 39.9042,
+    "longitude": 116.4074
+  }
+}
+
+
+2. 音量调节
+device/imei/command 
+ 每个间隔20，从40-100
+服务器下发：
+{
+  "msg_id": "002",
+  "params": {
+    "level": 100                
+  }
+  "time":utc 16位时间戳
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "002",
+  "status": "success",
+  "data": {
+    "current_level": 60
+  }
+  "time":utc 16位时间戳
+}
+
+3. OTA升级
+device/imei/command 
+服务器下发：
+{
+  "msg_id": "003",
+  "params": {
+    "url": "http://101.35.224.118:8080/assets/firmware/3.0.7.bin",
+    "version": "3.0.5"
+  }
+}
+
+device/imei/response
+4G模块响应（立即确认）：
+{
+  "msg_id": "003",
+  "status": "accepted",
+  "data": {
+    "current_version": "2.0.5",
+    "target_version": "2.1.0"
+  }
+}
+
+升级完成
+{
+	"msg_id": "003",
+    "status": "success",
+     "data": {
+    "new_version": "2.1.0"
+   }
+}
+
+4、NFC留言下发提示
+device/imei/command 
+如果设备在线，且有未读留言服务器定时10分钟下发一次：
+{
+  "msg_id": "004",
+  "params": {
+    "url": "http://xxx.mp3" //您有新的留言请注意查收
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "004",
+  "status": "success",
+}
+
+5、发送或收听留言
+device/imei/event
+NFC触发，设备端上报
+{
+  "msg_id": "005",
+  "params": {
+    "uuid": "53C12B6DA20001"
+  }
+}
+
+
+
+//如果不是本机本地UUID，则下发“你好，你的朋友已在线请留言”
+//如果本机本地UUID但没有留言，"你好，已没可读留言"
+服务器下发
+device/imei/event_resp
+
+{
+  "msg_id": "005",
+  "status": "success",
+  "type": 0,  //0代表收听留言  1 代表需要发送留言
+  "params": {
+    "url_1": "http://xxx.mp3"
+	"url_2": "http://xxx.mp3"
+  }
+}
+
+{
+	"msg_id": "005",
+	"type": 0, 
+	"params": 
+	{
+		"url_1": "http://175.24.73.253:8080/assets/audio/no_message.mp3"
+	}
+ }
+
+6、NFC绑定uuid
+device/imei/command 
+{
+  "msg_id": "006"
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "006",
+  "status": "success",
+   "data": {
+    "uuid": "53D22B6DA20001"
+   }
+}
+
+7、开关状态
+//0查询状态   1 控制打开    2控制关闭
+device/imei/command 
+{
+  "msg_id": "007",
+  "type": 0       
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "007",
+  "status": "success",
+   "data": {
+    "status": "on"   //on或off 返回当前状态
+   }
+}
+
+8、定时休眠
+device/imei/command 
+{
+  "msg_id": "008",
+  "params": {
+    "start": "22:00" ,     //设置时和分
+	"end":   "07:00"      //设置时和分
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "008",
+  "status": "success"
+}
+
+9、远程休眠和唤醒 (用7来替代)
+device/imei/command 
+{
+  "msg_id": "009",
+  "params": {
+    "switch": "on"      // on 唤醒 off 休眠
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "009",
+  "status": "success"
+}
+
+10、额外按键长按发送告警信息
+设备上报
+device/imei/event 
+{
+  "msg_id": "010"     //发送告警
+}
+服务器返回
+device/imei/event_resp
+4G模块响应：
+{
+  "msg_id": "010",
+  "status": "success"
+}
+
+11、额外按键短按发送留言给家长
+设备上报
+device/imei/event 
+{
+  "msg_id": "011",
+  "params": {
+    "uuid": "TalkingQ_xxx"
+  }
+}
+服务器返回
+device/imei/event_resp
+{
+	"msg_id": "011",
+	"type": 0, 
+	"params": 
+	{
+		"url": "http://175.24.73.253:8080/assets/audio/message_ok.mp3"
+	}
+ }
+
+12、增加后台自动下发DeviceID和SN流程
+设备端上报
+device/imei/event 
+{
+  "msg_id": "012"
+}
+服务器下发
+device/imei/event_resp
+{
+	"msg_id": "012",
+	"params": 
+	{
+		"device_id":"TalkingQ_XQSN00001003",
+		"device_sn":"TQ_XQSN000000001003"
+	}
+ }
+
+TalkingQ_XQSN00001003   TQ_XQSN000000001003
+53C12B6DA20001 
+53D92B6DA20001 
+53DA2B6DA20001
+
+set id TalkingQ_XQSN00001003
+set sn TQ_XQSN000000001003
+
+TalkingQ_XQSN00001004   TQ_XQSN000000001004
+53E12B6DA20001  
+53D12B6DA20001  
+53D22B6DA20001
+
+TalkingQ_XQSN00001005   TQ_XQSN000000001005
+53C22B6DA20001
+
+1000000189ABCDEFGHIJKLMNOPQRSTUV
+1000000089ABCDEFGHIJKLMNOPQRSTUV
+
+
+1、额外按钮
+	短按 直接与父母留言     
+	长按 播报紧急报警系统
+	
+2、休眠时间段设置功能
+   在设定时间内，设备不可启动
+   设定时间过后，可以正常使用
+
+
+3、远程一键休眠和一键唤醒
+
+
+mqtt地址
+http://175.24.73.253:18083/#/login?to=/clients
+admin  
+emqx_DPWQyk
+
+
+工作态：定时休眠 + 中途反复触发立即休眠
+1. 开启定时休眠 →规定时间休眠中
+2. 触发立即休眠 → 无反应
+3. 触发立即唤醒 → 恢复工作，休眠时间无效
+
+休眠态：定时休眠 + 中途触发立即唤醒
+1. 开启定时休眠 → 规定时间休眠中
+2. 触发立即唤醒 → 直接工作，休眠时间无效
+
+
+优先级：立即唤醒>定时休眠
+
+定时休眠 → 仅【工作态】有效
+定时唤醒 → 仅【休眠态】有效
--- a/talkingq-url/docs/mqtt协议_V2.0.txt
+++ b/talkingq-url/docs/mqtt协议_V2.0.txt
@@ -0,0 +1,324 @@
+device/imei/command    # 服务器下发命令（下行）
+device/imei/response   # 设备响应（上行）
+device/imei/event      # 设备主动事件
+device/imei/event_resp # 事件返回
+
+消息格式（JSON）
+device/imei/event 
+0.设备定时10分钟上报信息
+{
+  "msg_id": "000",
+   "data": {
+    "id":"TalkingQ_xxx",
+    "power": 20,              剩余电量每个间隔20，从0-100   
+	"signal": 3,              信号强度1是最弱的 5是最强
+	"voice":60,               每个间隔20，从40-100
+	"imei":"861921071409242",
+	"version":"v1.0",   
+	"latitude":23.1173393,
+	"longitude":113.2855975
+	"device_type":0,           0 no NFC+no GPS  1 NFC  2、NFC+GPS
+  }
+}
+服务器返回
+device/imei/event_resp
+{
+	"msg_id": "000",
+	"status": "success"
+}
+
+1. GPS位置查询
+device/imei/command 
+服务器下发：
+{
+  "msg_id": "001"
+}
+
+
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "001",
+  "status": "success",
+  "data": {
+    "latitude": 39.9042,
+    "longitude": 116.4074
+  }
+}
+
+
+2. 音量调节
+device/imei/command 
+ 每个间隔20，从40-100
+服务器下发：
+{
+  "msg_id": "002",
+  "params": {
+    "level": 100                
+  }
+  "time":utc 16位时间戳
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "002",
+  "status": "success",
+  "data": {
+    "current_level": 60
+  }
+  "time":utc 16位时间戳
+}
+
+3. OTA升级
+device/imei/command 
+服务器下发：
+{
+  "msg_id": "003",
+  "params": {
+    "url": "http://101.35.224.118:8080/assets/firmware/3.0.7.bin",
+    "version": "3.0.5"
+  }
+}
+
+device/imei/response
+4G模块响应（立即确认）：
+{
+  "msg_id": "003",
+  "status": "accepted",
+  "data": {
+    "current_version": "2.0.5",
+    "target_version": "2.1.0"
+  }
+}
+
+升级完成
+{
+	"msg_id": "003",
+    "status": "success",
+     "data": {
+    "new_version": "2.1.0"
+   }
+}
+
+4、NFC留言下发提示
+device/imei/command 
+如果设备在线，且有未读留言服务器定时10分钟下发一次：
+{
+  "msg_id": "004",
+  "params": {
+    "url": "http://xxx.mp3" //您有新的留言请注意查收
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "004",
+  "status": "success",
+}
+
+5、发送或收听留言
+device/imei/event
+NFC触发，设备端上报
+{
+  "msg_id": "005",
+  "params": {
+    "uuid": "53C12B6DA20001"
+  }
+}
+
+
+
+//如果不是本机本地UUID，则下发“你好，你的朋友已在线请留言”
+//如果本机本地UUID但没有留言，"你好，已没可读留言"
+服务器下发
+device/imei/event_resp
+
+{
+  "msg_id": "005",
+  "status": "success",
+  "type": 0,  //0代表收听留言  1 代表需要发送留言
+  "params": {
+    "url_1": "http://xxx.mp3"
+	"url_2": "http://xxx.mp3"
+  }
+}
+
+{
+	"msg_id": "005",
+	"type": 0, 
+	"params": 
+	{
+		"url_1": "http://175.24.73.253:8080/assets/audio/no_message.mp3"
+	}
+ }
+
+6、NFC绑定uuid
+device/imei/command 
+{
+  "msg_id": "006"
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "006",
+  "status": "success",
+   "data": {
+    "uuid": "53D22B6DA20001"
+   }
+}
+
+7、开关状态
+//0查询状态   1 控制打开    2控制关闭
+device/imei/command 
+{
+  "msg_id": "007",
+  "type": 0       
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "007",
+  "status": "success",
+   "data": {
+    "status": "on"   //on或off 返回当前状态
+   }
+}
+
+8、定时休眠
+device/imei/command 
+{
+  "msg_id": "008",
+  "params": {
+    "start": "22:00" ,     //设置时和分
+	"end":   "07:00"      //设置时和分
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "008",
+  "status": "success"
+}
+
+9、远程休眠和唤醒 (用7来替代)
+device/imei/command 
+{
+  "msg_id": "009",
+  "params": {
+    "switch": "on"      // on 唤醒 off 休眠
+  }
+}
+device/imei/response
+4G模块响应：
+{
+  "msg_id": "009",
+  "status": "success"
+}
+
+10、额外按键长按发送告警信息
+设备上报
+device/imei/event 
+{
+  "msg_id": "010"     //发送告警
+}
+服务器返回
+device/imei/event_resp
+4G模块响应：
+{
+  "msg_id": "010",
+  "type": 0, 
+  "params": 
+	{
+		"url": "http://175.24.73.253:8080/assets/audio/message_ok.mp3"
+	}
+}
+
+11、额外按键短按发送留言给家长
+设备上报
+device/imei/event 
+{
+  "msg_id": "011",
+  "params": {
+    "uuid": "TalkingQ_xxx"
+  }
+}
+服务器返回
+device/imei/event_resp
+{
+	"msg_id": "011",
+	"type": 0, 
+	"params": 
+	{
+		"url": "http://175.24.73.253:8080/assets/audio/message_ok.mp3"
+	}
+ }
+
+12、增加后台自动下发DeviceID和SN流程
+设备端上报
+device/imei/event 
+{
+  "msg_id": "012"
+}
+服务器下发
+device/imei/event_resp
+{
+	"msg_id": "012",
+	"params": 
+	{
+		"device_id":"TalkingQ_XQSN00001003",
+		"device_sn":"TQ_XQSN000000001003"
+	}
+ }
+
+TalkingQ_XQSN00001003   TQ_XQSN000000001003
+53C12B6DA20001 
+53D92B6DA20001 
+53DA2B6DA20001
+
+set id TalkingQ_XQSN00001003
+set sn TQ_XQSN000000001003
+
+TalkingQ_XQSN00001004   TQ_XQSN000000001004
+53E12B6DA20001  
+53D12B6DA20001  
+53D22B6DA20001
+
+TalkingQ_XQSN00001005   TQ_XQSN000000001005
+53C22B6DA20001
+
+1000000189ABCDEFGHIJKLMNOPQRSTUV
+1000000089ABCDEFGHIJKLMNOPQRSTUV
+
+
+1、额外按钮
+	短按 直接与父母留言     
+	长按 播报紧急报警系统
+	
+2、休眠时间段设置功能
+   在设定时间内，设备不可启动
+   设定时间过后，可以正常使用
+
+
+3、远程一键休眠和一键唤醒
+
+
+mqtt地址
+http://175.24.73.253:18083/#/login?to=/clients
+admin  
+emqx_DPWQyk
+
+
+工作态：定时休眠 + 中途反复触发立即休眠
+1. 开启定时休眠 →规定时间休眠中
+2. 触发立即休眠 → 无反应
+3. 触发立即唤醒 → 恢复工作，休眠时间无效
+
+休眠态：定时休眠 + 中途触发立即唤醒
+1. 开启定时休眠 → 规定时间休眠中
+2. 触发立即唤醒 → 直接工作，休眠时间无效
+
+
+优先级：立即唤醒>定时休眠
+
+定时休眠 → 仅【工作态】有效
+定时唤醒 → 仅【休眠态】有效