海亮定制

孙向锦
1 parent 60a60b35
Showing 1 changed file with 57 additions and 48 deletions
海亮定制.md
@@ -88,7 +88,6 @@ MQTT服务器配置结果检查
 | 授时 | 给基站校时 |
 | 基站上下线 | 基站上下线信息 |
 | 键盘上下线 | 键盘上下线信息 |
-| 签到 | 答题器按键签到 |
 | 单题 | 下发一题测验 |
 | 多级编号题 | 下发多题测验 |
 | 基站升级 | 基站固件升级 |
@@ -123,7 +122,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | /client/${clientId}/card/online | 答题器上线通知。 |
 | /client/${clientId}/card/offline | 答题器离线通知。 |
 | /client/${clientId}/report | 基站主动上报状态，或者对设置指令的回应。 |
-| /lesson/class/${clinetId}/send | 基站对答题/签到数据的反馈 |
+| /lesson/class/${clinetId}/send | 基站对答题的反馈 |
 | /client/${clientId}/error | 基站错误信息上报 |
@@ -142,17 +141,18 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | m | object | 答题消息的内容(message) 对象或数组 |
 | c | string | 答题器的序号(card) |
 | t | number | 时间戳(10位timestamp) |
-| qm | number | 模式(question model)取值范围：<br> 0：停止 <br> 1：单题 <br> 7：签到 <br> 14：多级编号答题 |
+| qm | number | 模式(question model)取值范围：<br> 0：停止 <br> 1：单题  <br> 14：多级编号答题 |
 | qt | number | 题型（question type），取值范围： 0：字母单选 1：字母多选 2：数字题 3：判断题 4: 填空题 5：抢答 7:自判题判断题 |
 | qs | number | 该题型数量（question sum），单题为1，多题则为实际数量。 |
-| qn | number | 题型序号(question No) |
+| qn | number | 题目序号(question No)，题目顺序号 |
+| dn | string | display no 显示编号，键盘上显示的题目编号|
 | a | string | 答案（answer）示例：字母单选：A字母多选：A|B文本题：hex: 标记是gbk编码的hex内容 |
 | en | string | 练习（考试）编号(exercise No)每次考试或者练习的唯一编号，用于确定提交的答案属于那次练习。 |
 | on | number | 单选和多选题的选项数量(option no) |
 | cid | string | 客户端ID(client Id) |
 | cm | string | 客户端型号(client Model) |
 | cv | string | 客户端版本(client Version)基站软件版本号 |
-| f | number | 信道频点(frequency)基站频点取值：1-80 |
+| f | number | 信道频点(frequency) 基站频点取值：1-80 |
 | ap | number | 考勤功率(attend Power)取值：0-31，值约小，基站的接收能力约强。 |
 | rssi | number | 答题器考勤的RSSI阈值，软件实现的过滤。RSSI高于该值的答题器的该次考勤会丢弃。默认0，不过滤。 |
 | khs | string | 键盘心跳开关(keyboard Heartbeat Switch)，on开启，off关闭 |
@@ -165,7 +165,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | pm | number | power mode 关机模式 pm = 0 在线不关机Pm = 1 在线超时关机 |
 | et | number | 错误类型et =1 基站频点冲突 |
 | em | string | 错误消息em = "3" 配合et使用，如et=1 em=3 表示3号频点冲突 |
-| success | number | 0 成功 非0：错误码 |
+| success | number | 0 成功  -1 错误/失败 |
 ## 3.3 功能说明
@@ -242,7 +242,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | 主题 | 备注 |
 | --- | --- |
-| f |基站频点 |
+| f |基站频点 频点范围1-80|
 | mqtt\_ip | 连接服务器的IP| 
 | mqtt\_port | 连接mqtt服务器的端口 |
 | mqtt\_username | 连接mqtt服务器的用户名 |
@@ -346,21 +346,6 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | c |键盘sn号 |
 | t |答题器编号和下线时间 |
-
-      
-#### 键盘在线检测
-主题: /lesson/class/${clinetId}/receive
-指令内容：
-```json
-{
-	"i": 16
-}
-```
-| 名词 | 备注 |
-| --- | --- |
-| i = 16 |应用主动通知键盘发送在线键盘信息 |
-
-
 #### 读取白名单
@@ -394,7 +379,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | i = 31 |白名单上传 |
 | total |一共上传的数据包数 |
 | current |当前第几包 |
-| m |键盘列表 |
+| m |键盘序列号列表 |
@@ -407,13 +392,13 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 ```json
 {
 	"i": 3,
-	"m": ["12345", "56789"]
+	"m": ["2126833703", "2126833671"]
 }
 ```
 | 名词 | 备注 |
 | --- | --- |
 | i = 3 |添加白名单m内包含白名单键盘按编号 |
-| m |键盘列表 |
+| m |键盘序列号列表 |
@@ -426,14 +411,14 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 ```json
 {
 	"i": 4,
-	"m": ["12345", "56789"]
+	"m": ["2126833703", "2126833671"]
 }
 ```
 | 名词 | 备注 |
 | --- | --- |
 | i = 4 |删除白名单m内包含白名单键盘按编号 |
-| m |键盘列表 |
+| m |键盘序列号列表 |
@@ -545,7 +530,7 @@ public static String bytesToHexString(byte[] src) {
 | 名词 | 备注 |
 | --- | --- |
 | i = 11 | 停止答题 |
-| en |停止对序号12340的测验 |
+| en |停止对序号1的测验 |
 ### 抢答(待完成-可能修改)
@@ -565,7 +550,7 @@ public static String bytesToHexString(byte[] src) {
 | 名词 | 备注 |
 | --- | --- |
 | i = 12 | 开启答题 |
-| en |2测验 |
+| en |序号2的测验 |
 | qm | qm =4 抢答题 |
@@ -592,7 +577,7 @@ public static String bytesToHexString(byte[] src) {
 | 名词 | 备注 |
 | --- | --- |
 | i = 12 | 开启答题 |
-| en |12341测验 |
+| en |序号2的测验 |
 | qm | qm =4 抢答题 |
 | c | 键盘编号 |
 | qn |上报答题数据，单题题号固定为1 |
@@ -614,7 +599,7 @@ public static String bytesToHexString(byte[] src) {
 | 名词 | 备注 |
 | --- | --- |
 | i = 11 | 停止答题 |
-| en |停止对序号12341的测验 |
+| en |停止对序号2的测验 |
@@ -636,15 +621,15 @@ public static String bytesToHexString(byte[] src) {
 	"m": [{
 		"qt": 0,
 		"on": 4,
-		"qn": "1-1-1"
+		"dn": "1-1-1"
 	}, {
 		"qt": 0,
 		"on": 4,
-		"qn": "2-1"
+		"dn": "2-1"
 	}, {
 		"qt": 0,
 		"on": 4,
-		"qn": "3"
+		"dn": "3"
 	}]
 }
 ```
@@ -659,7 +644,7 @@ public static String bytesToHexString(byte[] src) {
 | qs | 题目总数 |
 | qt = 0 | 字母单选 |
 | on | 选项数量 |
-| qn | 题目多级数字编号，多级数字编号中间必须以“-”隔开 |
+| dn | 显示编号，题目最多3级数字编号，多级数字编号中间必须以“-”隔开，每级最大数200 |
 #### 接收答题数据
@@ -687,7 +672,7 @@ public static String bytesToHexString(byte[] src) {
 | en |12341测验 |
 | qm = 14 | 多题多级编号模式 |
 | c | 键盘编号 |
-| qn |上报答题数据 |
+| qn |顺序题号，不为显示编号，是上述题目的顺序号 |
 | t  |提交答案时间 |
 | a  | 答题数据 |
@@ -723,11 +708,11 @@ public static String bytesToHexString(byte[] src) {
 	"en": "4",
 	"qs": 2,
 	"m": [{
-		"sn": "202308093214",
-		"name": "张三"
+		"sn": "2126833671",
+		"name": "hex:5f204e09"
 	}, {
-		"sn": "202308093215",
-		"name": "李四"
+		"sn": "2126833703",
+		"name": "hex:674e56db"
 	}]
 }
 ```
@@ -752,17 +737,17 @@ public static String bytesToHexString(byte[] src) {
 	"total": 1,
 	"current": 1,
 	"m": [{
-		"sn": "202308093214",
+		"sn": "2126833703",
 		"success": 0
 	}, {
-		"sn": "202308093215",
+		"sn": "2126833671",
 		"success": 0
 	}]
 }
 ```
 | 名词 | 备注 |
 | --- | --- |
-| i = 60 | 姓名下发 |
+| i = 61 | 姓名下发 |
 | en |序号4 |
 | current |当前第几包数据 |
 | total |一共几包数据 |
@@ -873,7 +858,7 @@ public static String bytesToHexString(byte[] src) {
 {
 	"i": 62,
 	"en": "6",
-	"sn": ["12345", "56789"],
+	"sn": ["2126956007", "2126956008"],
 	"m": [{
 		"cmd": 81,
 		"text": "hex:"
@@ -882,7 +867,7 @@ public static String bytesToHexString(byte[] src) {
 ```
 | 名词 | 备注 |
 | --- | --- |
-| i = 18 | 升级进度报告 |
+| i = 62 | 文本设置 |
 | sn |键盘列表 |
 | cmd |下发的命令 <br> 4  第二行文本 <br> 81 单选 <br> 82 多选 <br> 83 数字 <br> 84 判断 <br> 85 自判题判断  <br> 87 清除 |
 | text |标题信息，以hex:开头添加的内容 内容为GBK的hex编码 |
@@ -916,7 +901,7 @@ public static String bytesToHexString(byte[] src) {
 {
 	"i": 63,
 	"en": "6",
-	"sn": ["12345", "56789"],
+	"sn": ["2126956007", "2126956008"],
 	"m": [{
 		"cmd": 81,
 		"success": 0
@@ -925,8 +910,32 @@ public static String bytesToHexString(byte[] src) {
 ```
 | 名词 | 备注 |
 | --- | --- |
-| i = 61 | 升级进度报告 |
+| i = 63 | 设置返回 |
 | sn |键盘列表 |
 | cmd |下发的命令 <br> 4  第二行文本 <br> 81 单选 <br> 82 多选 <br> 83 数字 <br> 84 判断 <br> 85 自判题判断  <br> 87 清除 |
-| success | 是否成功。<br> 0 表示成功 <br> 非0 表示失败  -1失败 |
+| success | 是否成功。<br> 0 表示成功 <br> -1 失败 |
+### 学生卡信息上报
+卡初始化组网的时候会上报一次
+主题：/client/${client}/report
+指令内容：
+```json
+{
+    "i":32,
+    "m":[
+        {
+            "c":"1873373905",
+            "cv":"0.2.2",
+            "hw":"67.0",
+            "t":1638865040
+        }
+    ]
+}
+```
+| 名词 | 备注 |
+| --- | --- |
+| i = 32 | 学生卡信息上报 |
+| c |键盘编号 |
+| cv |固件版本号 |
+| hw |硬件版本号 |
+| t | 时间戳 |
 \ No newline at end of file