diff --git a/海亮定制.md b/海亮定制.md index 5e02dd9..db5bdf4 100644 --- a/海亮定制.md +++ b/海亮定制.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)取值范围:
0:停止
1:单题
7:签到
14:多级编号答题 | +| qm | number | 模式(question model)取值范围:
0:停止
1:单题
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 |下发的命令
4 第二行文本
81 单选
82 多选
83 数字
84 判断
85 自判题判断
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 |下发的命令
4 第二行文本
81 单选
82 多选
83 数字
84 判断
85 自判题判断
87 清除 | -| success | 是否成功。
0 表示成功
非0 表示失败 -1失败 | +| success | 是否成功。
0 表示成功
-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