diff --git a/c200k基站mqtt协议文档对内版.md b/c200k基站mqtt协议文档对内版.md index 37dc760..650efa8 100644 --- a/c200k基站mqtt协议文档对内版.md +++ b/c200k基站mqtt协议文档对内版.md @@ -84,28 +84,28 @@ [3.3.17. 考勤 34](#_Toc5523) -1. -## 前言 - 1. -## 背景 +## 1. 前言 + + +## 1.背景 方便客户基于C200K基站设备使用 通信基站数据接收及解析。 - 1. -## 编写目的 + +## 1.编写目的 此说明书是为了说明协议内容,开发流程,方便基于此进行二次开发。 - 1. -## 读者对象 + +## 1.读者对象 1. 相关研发人员 2. 方案制定人员 3. 决策人员 -1. -## 开发流程 + +## 1. 开发流程 C200K基站,采用MQTT协议进行开发,基站接入MQTT服务器,应用从MQTT服务器下发指令和接收数据 @@ -113,8 +113,8 @@ C200K基站,采用MQTT协议进行开发,基站接入MQTT服务器,应用 ![](RackMultipart20240201-1-g1fo09_html_f478434017db65da.png) - 1. -## MQTT服务器准备 + +## 1. MQTT服务器准备 MQTT服务器要求: @@ -132,8 +132,8 @@ MQTT服务器配置结果检查 ![](RackMultipart20240201-1-g1fo09_html_fee7c61a6124a949.png) - 1. -## 基站配置 + +## 1. 基站配置 通过USB连接基站,打开基站服务器配置软件。 @@ -153,18 +153,18 @@ MQTT服务器配置结果检查 ![](RackMultipart20240201-1-g1fo09_html_39a2e5f2d9f1e7b5.png) - 1. -## 应用开发 + +## 1. 应用开发 整体开发流程图如下: ![](RackMultipart20240201-1-g1fo09_html_5eea82088a9bba36.png) -1. -## 功能清单 - 1. -## 支持的功能清单 +## 1. 功能清单 + + +## 1. 支持的功能清单 | **功能** | **说明** | | --- | --- | @@ -181,26 +181,26 @@ MQTT服务器配置结果检查 | 键盘升级 | 键盘固件升级 | | 基站错误信息上报 | 基站错误信息上报 | - 1. -## 协议简介 + +## 1. 协议简介 - 1. -### MQTT + +### 1. MQTT 关于MQTT说明,请参考 https://mqtt.org/ ${clinetId} clinetId 是基站编号,为替换字符串。 - 1. -#### 应用程序发布的主题 + +#### 1. 应用程序发布的主题 | 主题 | 功能 | | --- | --- | | /client/${clientId}/operate | 基站的设置,查询等指令 | | /lesson/class/${clinetId}/receive | 接收答题的指令 | - 1. -#### 应用程序订阅的主题 + +#### 1. 应用程序订阅的主题 | 主题 | 功能 | | --- | --- | @@ -214,15 +214,15 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | /client/${clientId}/card/fingerprint | 指纹事件 | | /client/${clientId}/error | 基站错误信息上报 | - 1. -### 协议格式 + +### 1. 协议格式 ![](RackMultipart20240201-1-g1fo09_html_d43b4a7f2872481.png) 协议采用json格式,数据中字段见属性介绍。 - 1. -### 指令属性介绍 + +### 1. 指令属性介绍 | 名称 | 类型 | 说明 | | --- | --- | --- | @@ -258,11 +258,11 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | em | String | 错误消息em = "3" 配合et使用,如et=1 em=3 表示3号频点冲突 | | success | number | 0 成功 非0:错误码 | - 1. -## 功能说明 + +## 1. 功能说明 - 1. -### 授时 + +### 1. 授时 对客户端授时,发送指令即可,基站会完成校时。 @@ -270,11 +270,11 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 19, "t": 1634802943} | t 当前时间轴 秒 | - 1. -### 基站管理 + +### 1.基站管理 - 1. -#### 基站上线 + +#### 1. 基站上线 由基站发给应用程序,应用需要订阅主题 @@ -282,8 +282,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 40} | 基站上线 | - 1. -#### 基站下线 + +#### 2. 基站下线 由服务器发给应用程序,应用需要订阅主题 @@ -291,8 +291,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 41} | 基站下线 | - 1. -#### 基站信息设置与读取 + +#### 1. 基站信息设置与读取 应用程序发送给基站 @@ -301,8 +301,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i": 20, "m": { "f": 0, "ap": 0, "rssi": 0, "khs": "on", "mm": 1, "pm": 0, "arti": 30, "mqtt\_ip": "edunew.sunvotecloud.cn", "mqtt\_port": 8443, "mqtt\_username": "admin", "mqtt\_password": "1223456789", "heartbeat":0, "keypad\_af":0, "keypad\_ap":0 }} | f 基站频点ap 考勤功率 rssi 答题器考勤的RSSI阈值 khs 键盘心跳开关 mm 基站配对模式arti 考勤上报时间间隔 pm 键盘关机模式 mqtt\_ip:连接服务器的IP(只能是IP,不能是域名) mqtt\_port:连接mqtt服务器的端口 mqtt\_username: 连接mqtt服务器的用户名 Mqtt\_password:连接mqtt服务器的密码 heartbeat: 心跳 0 关闭 1 开启 Keypad\_af:考勤频率(0-3) keypad\_ap:考勤功率(0-5)注意:如果没有该字段则不设置该值,保持原值下发对有需要修改的值设置完成后,基站信息会自动上报一次 | - 1. -#### 基站信息上报 + +#### 1. 基站信息上报 基站发送给应用程序 @@ -313,8 +313,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 }} | f 基站频点ap 考勤功率 rssi 答题器考勤的RSSI阈值 khs 键盘心跳开关 mc 基站配对码 mm 基站配对模式arti 考勤上报时间间隔 sn 基站sn号 cm 客户端设备型号 cv 客户端设备版本 pm 键盘关机模式读取时,会全部返回值 mqtt\_ip:连接服务器的IP mqtt\_port:连接mqtt服务器的端口 mqtt\_username: 连接mqtt服务器的用户名 Mqtt\_password:连接mqtt服务器的密码 heartbeat: 心跳 0 关闭 1 开启 Keypad\_af:考勤频率(0-3 0关闭) keypad\_ap:考勤功率(0-5) cId 基站编号 | - 1. -#### 基站错误信息上报 + +#### 1. 基站错误信息上报 基站发送给应用程序 @@ -322,10 +322,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 22, "m": { "et": 1, "em": "3" }} | et 错误类型 et = 1 :基站频点冲突 em 错误消息 em=3 :3号频点示例 基站频点3冲突 | - 1. -### 键盘管理 + +### 1. 键盘管理 - 1. + #### 键盘上线 由基站发给应用程序,应用需要订阅主题 @@ -334,7 +334,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":14, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 14 键盘上线 el 电量信息答题器编号和上线时间及电量信息 | - 1. + #### 键盘下线 由基站发给应用程序,应用需要订阅主题 @@ -344,14 +344,14 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":15, "m":[{ "c":"12345", "t":1626016299 }]} | i = 15 键盘下线 答题器编号和下线时间 | - 1. + #### 键盘在线检测 | 主题 | /lesson/class/${clinetId}/receive | 备注 | | --- | --- | --- | | { "i":16} | i = 16应用主动通知键盘发送在线键盘信息。键盘上线参考"键盘上线3.3.3.1" | - 1. + #### 键盘遥控指令 应用程序发送给基站 @@ -360,7 +360,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":52, "m"{ "cmd":"shutdown" }} | i = 52通知遥控指令 Cmd 不超过16个字符 Cmd = "shutdown"遥控关机Cmd="reset" 遥控重启 | - 1. + #### 开启白名单 应用程序发送给基站 @@ -369,7 +369,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":1} | i = 1 开启白名单 | - 1. + #### 关闭白名单 应用程序发送给基站 @@ -378,7 +378,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":2} | i = 2 关闭白名单 | - 1. + #### 读取白名单 应用程序发送给基站 @@ -393,7 +393,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 31, "total": 1, "current": 1, "m": ["2126932551"]} | i = 31 白名单上传 | - 1. + #### 添加白名单 应用程序发送给基站 @@ -403,7 +403,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":3, "m":["12345","56789"] } | i = 3 添加白名单m内包含白名单键盘按编号 | - 1. + #### 删除白名单 应用程序发送给基站 @@ -413,7 +413,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":4, "m":["12345","56789"] } | i = 4 删除白名单m内包含白名单键盘按编号 | - 1. + #### 清空白名单 应用程序发送给基站 @@ -422,10 +422,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":5} | i = 5 清空白名单 | - 1. + ### 签到 - 1. + #### 开启签到 由应用程序发给基站,应用按照主题发送 @@ -436,7 +436,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | - 1. + #### 接收签到信息 由基站发给应用程序,应用订阅主题 @@ -445,7 +445,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12340", "qm":7, "m":[{ "c":"12345", "a":"6542", "t":1626016299 }] } | qm = 7 签到 en 发起的序号ID c 键盘sn号 t 表示时间A 签到附带信息 | - 1. + #### 停止签到 由应用程序发给基站,应用按照主题发送 @@ -454,7 +454,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12340"} | 停止对序号12340的签到 | - 1. + #### 签到结果下发 由应用程序发给基站,应用按照主题发送 @@ -463,10 +463,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 62, "en": "12340" "sn":["1","2"], "m":{ "success":0 "text":"hex:shjdfhkjhkjfd" }} | Pin 签到的签到结果下发 Success 签到状态结果Text 签到信息(例如签到失败) | - 1. + ### 单题 - 1. + #### 开启答题 由应用程序发给基站,应用按照主题发送 @@ -476,7 +476,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i": 12, "en": "12340", "qm": 1, "m": { "qt": 0, "on": 4, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 示例为单题模式的字母单选。题目内容必须要转成GBK 16进制hex进行传输,并且在内容前面标记为hex: qm =1 单题模式 i=12 下发答题/签到指令 qt 字母单选on 选项数content 题目主干内容 | | { "i": 12, "en": "12340", "qm": 1, "at": 1, "m": { "qt": 0, "on": 4, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 添加 at = 1 自动测试,键盘固定答案上传 | - 1. + #### 接收答题数据 由基站发给应用程序,应用订阅主题 @@ -485,7 +485,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12340", "qm":1, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间文本题:hex: 标记是gbk编码的hex内容 I = 13 上报信息 qm 字母单选题 c 键盘编号 qn 第几题 单选固定是1t 答题时间 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -494,10 +494,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12340"} | 停止对序号12340的测验 | - 1. + ### 多题 - 1. + #### 开启答题 由应用程序发给基站,应用按照主题发送 @@ -507,7 +507,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | "i":12, "en":"12341", "qm":2, "m":{ "qt":0, "on": 4, "qs":20, "content":"hex: c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }} | 示例为多题模式不带内容的快速20道字母单选。 qm =2 多题模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | - 1. + #### 接收答题数据 由基站发给应用程序,应用订阅主题 @@ -516,7 +516,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -525,10 +525,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12341"} | 停止对序号12341的测验 | - 1. + ### 套卷 - 1. + #### 开启答题 由应用程序发给基站,应用按照主题发送 @@ -540,7 +540,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 },{ "qt":0, "qs":1, "on":6 }]} | 示例为多题模式不带内容的快速20道字母单选。 qm =3 套卷模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | - 1. + #### 接收答题数据 由基站发给应用程序,应用订阅主题 @@ -549,7 +549,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -558,10 +558,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12341"} | 停止对序号12341的测验 | - 1. + ### 抢答 - 1. + #### 开启答题 由应用程序发给基站,应用按照主题发送 @@ -571,7 +571,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":12, "en":"12341", "qm":4} | 示例为多题模式不带内容的快速20道字母单选。 qm =3 套卷模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qs 题目数量 | - 1. + #### 接收答题数据 由基站发给应用程序,应用订阅主题 @@ -580,7 +580,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12341", "qm":2, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -589,10 +589,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12341"} | 停止对序号12341的测验 | - 1. + ### 套卷带题干 - 1. + #### 开启答题(套卷带题干) 由应用程序发给基站,应用按照主题发送 @@ -602,7 +602,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":12, "en":"12342", "qm":8, "qs":4, "total":1, "current":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 示例: 1道字母单选, 1道字母多选, 1道判断题, 1道字母单选。 I = 12 指令 en = 12342该答题序号为12342,应用程序自定义 qm 题型 total 这次数据一共多少包 current 当前第几包。如果套卷内容过大,需要分包传输,一个包的数据量是整个 json数据不能超过4k(4096个字节)。 m 题目详情 qt 题型 qs 题数 on 选项数 content 题目内容 | | { "i":12, "en":"12342", "qm":8, "qs":4, "total":1, "current":1, "at":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 比上一个用例多一个 at= 1表示自动测试键盘固定答案上传 | - 1. + #### 接收答题信息 由基站发给应用程序,应用需要订阅主题 @@ -612,7 +612,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":13, "en":"12342", "qm":8, "c":"12345", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -621,10 +621,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12342"} | 停止对序号12342的测验 | - 1. + ### 离线套卷带题干下载 - 1. + #### 下载套题(套卷带题干) 键盘只能保存一套套卷试题 由应用程序发给基站,应用按照主题发送 @@ -634,7 +634,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":12, "en":"12342", "qm":9, "qs":4, "total":1, "current":1, "m":[{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":1, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":3, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on":6, "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }] } | 示例: 1道字母单选, 1道字母多选, 1道判断题, 1道字母单选。 I = 12 指令 en = 12342该答题序号为12342,应用程序自定义 qm 题型 total 这次数据一共多少包 current 当前第几包。如果套卷内容过大,需要分包传输,一个包的数据量是整个json数据不能超过4k(4096个字节)。 m 题目详情 qt 题型 qs 题数 on 选项数 content 题目内容 套题最多20题,每题不超过50个汉字 | - 1. + #### 停止下载 由应用程序发给基站,应用按照主题发送 @@ -643,7 +643,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12342"} | 停止对序号12342的下载 | - 1. + #### 收取离线答案(键盘在线) 由应用程序发给基站,应用按照主题发送 @@ -655,7 +655,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | | - 1. + #### 接收答题信息 由基站发给应用程序,应用需要订阅主题 @@ -665,7 +665,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":13, "en":"12342", "c":"12345", "qm":"10", "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止收取离线答案 由应用程序发给基站,应用按照主题发送 @@ -674,10 +674,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12342"} | 停止对序号12342的下载 | - 1. + ### 离线下载多题不带题干 - 1. + #### 下载套题 由应用程序发给基站,应用按照主题发送 @@ -688,7 +688,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i": 12, "en": "12341", "qm": 11, "at": 1, "m": [{ "qn": 1, "qt": 0, "qs": 20, "on": 4 }, { "qn": 21, "qt": 1, "qs": 20, "on": 4 }]} | "at":1 表示自动测试模式。基站根据各题型自动填充答案。 | - 1. + #### 停止下载套题 由应用程序发给基站,应用按照主题发送 @@ -697,7 +697,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12341"} | 停止对序号12341的测验 | - 1. + #### 开启收取离线多题答案 由应用程序发给基站,应用按照主题发送 @@ -706,7 +706,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 12, "en": "12342", "qm": 12} | 开始对序号12342的离线答案收取 | - 1. + #### 离线多题答案收取 基站发给应用程序 @@ -715,7 +715,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12342", "c":"12345", "qm": 12, "m":[{ "qn":1, "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,单题题号固定为1, t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为A "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止收取离线多题答案 由应用程序发给基站,应用按照主题发送 @@ -724,10 +724,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12342"} | 停止对序号12342的离线答案收取 | - 1. + ### 收取离线文本 - 1. + #### 开始收取离线文本 由应用程序发给基站,应用按照主题发送 @@ -738,7 +738,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i": 12, "qm": 13, "at": 1} | 自动测试收取离线文本 at = 0 或缺省是正常模式 at = 1 表示自动测试测试 | - 1. + #### 离线文本收取 基站发给应用程序 @@ -747,7 +747,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12342", "c":"12345", "qm": 13, "m":{ "a":"hex:", "t":1626016299 } } | t为提交答案时间示例说明:键盘号为12345的键盘在时间轴1626016299 答的套卷第一题的答案为 "a":"hex:",文本题:hex: 标记是gbk编码的hex内容 | - 1. + #### 停止收取离线文本 由应用程序发给基站,应用按照主题发送 @@ -756,10 +756,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11} | 停止收取离线文本 | - 1. + ### 多题题号多题 - 1. + #### 开启答题 由应用程序发给基站,应用按照主题发送 @@ -769,7 +769,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | {"i":12, "en":"12341", "qm":14, "qs":3, "m":[{ "qt":0, "on": 4, "qn":"1-1-1", "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on": 4, "qn":"2-1" "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" },{ "qt":0, "on": 4, "qn":"3" "content":"hex:c7ebbbd8b4f0cfc2c3e633b5c0cad4cce2" }]} | 示例为多题模式 qm =14 多题多级编号模式 Qt 题目模式 qt = 0 字母单选 On 选项数量 Qn 题目多级编号 多级编号必须用"-"隔开。其他必须是数字 content 题目内容 | - 1. + #### 接收答题数据 由基站发给应用程序,应用订阅主题 @@ -778,7 +778,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":13, "en":"12341", "qm":14, "c":"12345", "m":[{ "qn":"1-1-1", "a":"A", "t":1626016299 }] } | 按照题号(qn)来上报答题数据,t为提交答案时间 | - 1. + #### 停止答题 由应用程序发给基站,应用按照主题发送 @@ -787,17 +787,17 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i": 11, "en": "12341"} | 停止对序号12341的测验 | - 1. + ### 下发姓名 - 1. + #### 姓名下发 | 主题 | /lesson/class/${clinetId}/receive | 备注 | | --- | --- | --- | | { "i":60, "total":1, "current":1, "en":"12342", "qs":2, "m":[{ "sn":"202308093214", "name":"张三", },{ "sn":"202308093215", "name":"李四",}]} | Qs 总下发姓名数量 I=60 姓名下发指令 total 这次数据一共多少包 current 当前第几包。 Sn 键盘编号name 姓名 | - 1. + #### 成功失败返回 | 主题 | /lesson/class/${clinetId}/send | 备注 | @@ -806,41 +806,41 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 Sn 姓名写成功键盘编号 | - 1. + ### 基站升级 - 1. + #### 开始升级 | 主题 | /client/${client}/operate | 备注 | | --- | --- | --- | | { "i":17, "m":{ "url":"", "version":"", "CRC":"" }} | url:升级包地址 version:版本号CRC:CRC-32校验码 | - 1. + #### 升级进度报告 | 主题 | /client/${client}/report | 备注 | | --- | --- | --- | | { "i":18, "m":{ "cId":"123456", "percent":0, "status":0 }} | cId:客户端设备ID percent:升级进度,0-100status:升级状态信息,0:未开始;1:升级中;2:升级成功;4固件版本号错误;5:不在升级名单内;6:升级指令错误;\>127:升级中的错误码。 | - 1. + ### 键盘升级 - 1. + #### 开始升级 | 主题 | /client/${client}/operate | 备注 | | --- | --- | --- | | { "i":28, "m":{ "url":"", "version":"", "CRC":"" }} | url:升级包地址 version:版本号CRC:CRC-32校验码 | - 1. + #### 升级进度报告 | 主题 | /client/${client}/report | 备注 | | --- | --- | --- | | { "i":29, "m":{ "cId":"123456", "percent":0, "status":0 }} | cId:客户端设备ID percent:升级进度,0-100 status:升级状态信息, 0:未开始; 1:升级中; 2:升级成功; 4固件版本号错误; 5:不在升级名单内;6:升级指令错误;\>127:升级中的错误码。 | - 1. + ### 刷卡事件 由基站发给应用程序,应用需要订阅主题 @@ -849,7 +849,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":50, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 50 刷卡事件答题器编号和刷卡时间 | - 1. + ### 指纹事件 由基站发给应用程序,应用需要订阅主题 @@ -858,10 +858,10 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":51, "m":[{ "c":"12345", "el":0.75, "t":1626016299 }]} | i = 51指纹事件答题器编号和刷卡时间 | - 1. + ### 考勤 - 1. + #### 打开考勤功能 应用程序发送给基站 @@ -870,7 +870,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":6} | i = 6 开启考勤功能 | - 1. + #### 关闭考勤功能 应用程序发送给基站 @@ -879,7 +879,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":7} | i = 7 关闭考勤功能 | - 1. + #### 设置考勤上传频率 应用程序发送给基站 @@ -888,17 +888,17 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | --- | --- | --- | | { "i":8, "m":30} | i = 8 设置考勤频率m = 30 表示频率率为30秒采集一次 | - 1. + #### 上报考勤数据 | 主题 | /lesson/class/${clientId}/attend | 备注 | | --- | --- | --- | | { "i":9, "m":[{ "c":"12345", "t":1626016299 }], "total":4, "current":1} | 内容为答题器序号和时间戳, total为本次上报的总的传输包数,current为当前传输包序号。 | - 1. + ### 文本预设 - 1. + #### 文本设置 | 主题 | /client/${client}/operate | 备注 | @@ -906,14 +906,14 @@ ${clinetId} clinetId 是基站编号,为替换字符串。 | { "i":61, "en":"123552", "sn":["12345","56789"], "m":[{ "cmd":81, "text":"",}]} | Cmd:对应测验题显示 1 姓名 2 积分 3 81 单选 82 多选 83 数字 84 判断 85 自判题判断 86 自判题数字 87 清除 Text:文本预设内容,最长不超过8个汉字。 sn 键盘列表 | - 1. + #### 设置返回 | 主题 | /client/${client}/report | 备注 | | --- | --- | --- | | { "i":61, "en":"123552", "m":[{ "cmd":81, "success":0, "sn":["12345","56789"]}]} | Cmd:对应测验题显示 81单选 82 多选 83 数字 84 判断 85 自判题判断 86 自判题数字 87 清除Text:文本预设内容,最长不超过8个汉字。 | - 1. + ### 学生卡信息上报 主题:/client/${client}/report