海亮定制

孙向锦
1 parent 73fb9953
Showing 1 changed file with 128 additions and 118 deletions
海亮定制.md
@@ -146,7 +146,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 | qs | number | 该题型数量（question sum），单题为1，多题则为实际数量。 |
 | qn | number | 题目序号(question No)，题目顺序号 |
 | dn | string | display no 显示编号，键盘上显示的题目编号|
-| a | string | 答案（answer）示例：字母单选：A字母多选：A|B文本题：hex: 标记是gbk编码的hex内容 |
+| a | string | 答案（answer）<br> 示例：字母单选：A  <br> 字母多选：A&#124;B&#124;C |
 | en | string | 练习（考试）编号(exercise No)每次考试或者练习的唯一编号，用于确定提交的答案属于那次练习。 |
 | on | number | 单选和多选题的选项数量(option no) |
 | cid | string | 客户端ID(client Id) |
@@ -167,7 +167,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 对客户端授时，发送指令即可，基站会完成校时。
-主题 : /client/${client}/operate 
+<br>主题 : /client/${client}/operate 
 ```
 {
@@ -176,7 +176,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- | 
 | i = 19 | 授时 |
 | t | 当前时间轴秒 |
@@ -190,35 +190,41 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 由基站发给应用程序，应用需要订阅主题
-主题 ： /client/${clientId}/online 
+<br>主题 ： /client/${clientId}/online 
-指令内容：
+<br>指令内容：
 ``` 
 {
 	"i": 40
 } 
 ``` 
+| 名称 | 备注 |
+| --- | --- |
+| i = 40 | 基站上线 |
+
 #### 基站下线(待完成-可能修改)
 由服务器发给应用程序，应用需要订阅主题
-主题：/client/${clientId}/offline 
-指令内容：
+<br>主题：/client/${clientId}/offline 
+<br>指令内容：
 ```json 
 { 
 	"i": 41
 } 
 ``` 
-
+| 名称 | 备注 |
+| --- | --- |
+| i = 41 | 基站下线 |
 #### 基站信息设置与读取
 应用程序发送给基站
-主题： /client/${client}/operate 
-指令内容：
+<br>主题： /client/${client}/operate 
+<br>指令内容：
 ```json 
 {
 	"i": 20,
@@ -232,13 +238,14 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 }
 ```
-| 主题 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
+| i= 20 |基站信息设置与读取 |
 | f |基站频点 频点范围1-80|
-| mqtt\_ip | 连接服务器的IP| 
-| mqtt\_port | 连接mqtt服务器的端口 |
-| mqtt\_username | 连接mqtt服务器的用户名 |
-| mqtt\_password | 连接mqtt服务器的密码 | 
+| mqtt_ip | 连接服务器的IP| 
+| mqtt_port | 连接mqtt服务器的端口 |
+| mqtt_username | 连接mqtt服务器的用户名 |
+| mqtt_password | 连接mqtt服务器的密码 | 
 | 注意 | 如果没有该字段则不设置该值，保持原值下发对有需要修改的值设置完成后，基站信息会自动上报一次 |
@@ -246,8 +253,8 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 基站发送给应用程序
-主题: /client/${client}/report
-指令内容：
+<br>主题: /client/${client}/report
+<br>指令内容：
 ```json
 {
 	"i": 21,
@@ -255,14 +262,16 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	"m": {
 		"f": 1,
 		"mqtt_ip": "edunew.sunvotecloud.cn",
-		"mqtt_port": 8443,
+		"mqtt_port": 1883,
 		"mqtt_username": "admin",
 		"mqtt_password": "1223456789"
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
+| i= 21 |基站信息上报 |
+| cId |客户端ID |
 | f |基站频点 |
 | mqtt_ip | 连接服务器的IP | 
 | mqtt_port | 连接mqtt服务器的端口 |
@@ -272,9 +281,9 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 基站错误信息上报(待完成-可能修改)
-基站发送给应用程序
-主题：/client/${client}/error
-指令内容：
+基站发送给应用程序主题
+<br>主题：/client/${client}/error
+<br>指令内容：
 ```json
 {
 	"i": 22,
@@ -284,7 +293,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 22 | 基站错误信息上报 |
 | et |错误类型 et = 1 ：基站频点冲突 |
@@ -298,8 +307,8 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 键盘上线
 由基站发给应用程序，应用需要订阅主题
-主题: /client/${clientId}/card/online
-指令内容：
+<br>主题: /client/${clientId}/card/online
+<br>指令内容：
 ```json
 {
 	"i": 14,
@@ -310,7 +319,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 14 |键盘上线 |
 | c |键盘sn号 |
@@ -321,8 +330,8 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 键盘下线
 由基站发给应用程序，应用需要订阅主题
-主题: /client/${clientId}/card/offline
-指令内容：
+<br>主题: /client/${clientId}/card/offline
+<br>指令内容：
 ```json
 {
 	"i": 15,
@@ -332,7 +341,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 15 |键盘下线 |
 | c |键盘sn号 |
@@ -342,22 +351,22 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 读取白名单
 应用程序发送给基站
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 30
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 30 |读取白名单 |
-基站发给应用程序
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+基站发给应用程序主题
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 31,
@@ -366,7 +375,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	"m": ["2126932551"]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 31 |白名单上传 |
 | total |一共上传的数据包数 |
@@ -379,15 +388,15 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 添加白名单
 应用程序发送给基站
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 3,
 	"m": ["2126833703", "2126833671"]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 3 |添加白名单m内包含白名单键盘按编号 |
 | m |键盘序列号列表 |
@@ -398,8 +407,8 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 删除白名单
 应用程序发送给基站
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 4,
@@ -407,7 +416,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 4 |删除白名单m内包含白名单键盘按编号 |
 | m |键盘序列号列表 |
@@ -417,14 +426,14 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 清空白名单
 应用程序发送给基站
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 5
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 5 |清空白名单 |
@@ -439,8 +448,8 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 #### 开启答题
 由应用程序发给基站，应用按照主题发送
-主题: /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题: /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 12,
@@ -453,7 +462,7 @@ ${clinetId} clinetId 是基站编号，为替换字符串。
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 12 |下发答题  |
 | en |序号  |
@@ -486,8 +495,8 @@ public static String bytesToHexString(byte[] src) {
 #### 接收答题数据
 由基站发给应用程序，应用订阅主题
-主题: /lesson/class/${clinetId}/send
-指令内容：
+<br>主题: /lesson/class/${clinetId}/send
+<br><br>指令内容：
 ```json
 {
 	"i": 13,
@@ -501,37 +510,37 @@ public static String bytesToHexString(byte[] src) {
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 13 | 答题数据 |
-| qn = 1 |上报答题数据，单题题号固定为1 |
+| qn |上报答题数据，单题题号固定为1 |
 | t  |提交答案时间 |
 | a  | 答题数据 |
 #### 停止答题
-由应用程序发给基站，应用按照主题发送
-主题：/lesson/class/${clinetId}/receive 
-指令内容：
+由应用程序发给基站，应用按照发送
+<br>主题：/lesson/class/${clinetId}/receive 
+<br>指令内容：
 ```json
 {
 	"i": 11,
 	"en": "1"
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 11 | 停止答题 |
 | en |停止对序号1的练习 |
-### 抢答(待完成-可能修改)
+### 抢答
-#### 开启答题(待完成-可能修改)
+#### 开启答题
-由应用程序发给基站，应用按照主题发送
-主题:  /lesson/class/${clinetId}/receive
-指令内容：
+由应用程序发给基站，应用按照发送
+<br>主题:  /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 12,
@@ -539,7 +548,7 @@ public static String bytesToHexString(byte[] src) {
 	"qm": 4
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 12 | 开启答题 |
 | en |序号2的练习 |
@@ -547,26 +556,24 @@ public static String bytesToHexString(byte[] src) {
-#### 接收答题数据(待完成-可能修改)
+#### 接收答题数据
-由基站发给应用程序，应用订阅主题
-主题： /lesson/class/${clinetId}/send
-指令内容：
+由基站发给应用程序，应用订阅
+<br>主题： /lesson/class/${clinetId}/send
+<br>指令内容：
 ```json
 {
 	"i": 13,
 	"en": "2",
 	"qm": 4,
-	"c": "2126833671",
 	"m": [{
-		"qn": 1,
-		"a": "A",
+	    "c": "2126833671",
 		"t": 1626016299
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 12 | 开启答题 |
 | en |序号2的练习 |
@@ -580,15 +587,15 @@ public static String bytesToHexString(byte[] src) {
 #### 停止答题(待完成-可能修改)
 由应用程序发给基站，应用按照主题发送
-主题：/lesson/class/${clinetId}/receive 
-指令内容：
+<br>主题：/lesson/class/${clinetId}/receive 
+<br>指令内容：
 ```json
 {
 	"i": 11,
 	"en": "2"
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 11 | 停止答题 |
 | en |停止对序号2的练习 |
@@ -600,8 +607,8 @@ public static String bytesToHexString(byte[] src) {
 #### 开启答题
 由应用程序发给基站，应用按照主题发送
-主题： /lesson/class/${clinetId}/receive
-指令内容：
+<br>主题： /lesson/class/${clinetId}/receive
+<br>指令内容：
 ```json
 {
 	"i": 12,
@@ -626,7 +633,7 @@ public static String bytesToHexString(byte[] src) {
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 12 | 开启答题 |
 | en |12341练习 |
@@ -642,8 +649,8 @@ public static String bytesToHexString(byte[] src) {
 #### 接收答题数据
 由基站发给应用程序，应用订阅主题
-主题: /lesson/class/${clinetId}/send
-指令内容：
+<br>主题: /lesson/class/${clinetId}/send
+<br>指令内容：
 ```json
 {
 	"i": 13,
@@ -651,14 +658,14 @@ public static String bytesToHexString(byte[] src) {
 	"qm": 14,
 	"c": "2126833671",
 	"m": [{
-		"qn": "1",
+		"qn": 1,
 		"a": "A",
 		"t": 1626016299
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 13 | 接收答题数据 |
 | en |12341练习 |
@@ -672,15 +679,15 @@ public static String bytesToHexString(byte[] src) {
 #### 停止答题
 由应用程序发给基站，应用按照主题发送
-主题：/lesson/class/${clinetId}/receive 
-指令内容：
+<br>主题：/lesson/class/${clinetId}/receive 
+<br>指令内容：
 ```json
 {
 	"i": 11,
 	"en": "3"
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 11 | 停止答题 |
 | en |停止对序号12341的练习 |
@@ -689,8 +696,8 @@ public static String bytesToHexString(byte[] src) {
 ### 基站升级
 #### 开始升级
-主题: /client/${client}/operate
-指令内容：
+<br>主题: /client/${client}/operate
+<br>指令内容：
 ```json
 {
 	"i": 17,
@@ -702,7 +709,7 @@ public static String bytesToHexString(byte[] src) {
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 17 | 基站升级 |
 | en |序号5 |
@@ -713,8 +720,8 @@ public static String bytesToHexString(byte[] src) {
 #### 升级进度报告
-主题： /client/${client}/report
-指令内容：
+<br>主题： /client/${client}/report
+<br>指令内容：
 ```json
 {
 	"i": 18,
@@ -725,7 +732,7 @@ public static String bytesToHexString(byte[] src) {
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 18 | 升级进度报告 |
 | cId |基站编号 |
@@ -736,19 +743,19 @@ public static String bytesToHexString(byte[] src) {
 ### 键盘升级
 #### 开始升级
-主题: /client/${client}/operate
-指令内容：
+<br>主题: /client/${client}/operate
+<br>指令内容：
 ```json
 {
 	"i": 28,
 	"m": {
-		"url": "",
-		"version": "",
-		"CRC": ""
+		"url": "http://120.78.57.84:8888/file/S6_2.4G_2.1.2.50_GB2312_CGC_add_head.bin",
+		"version": "2.1.2.50",
+		"CRC": "10605263"
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 28 | 键盘升级 |
 | url |固件包地址，基站能访问到的路径 |
@@ -757,8 +764,8 @@ public static String bytesToHexString(byte[] src) {
 #### 升级进度报告
-主题： /client/${client}/report
-指令内容：
+<br>主题： /client/${client}/report
+<br>指令内容：
 ```json
 {
 	"i": 29,
@@ -769,19 +776,19 @@ public static String bytesToHexString(byte[] src) {
 	}
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
-| i = 18 | 升级进度报告 |
+| i = 29 | 升级进度报告 |
 | cId |基站编号 |
 | percent |升级百分比 |
 | status |升级状态信息。 <br> 0：未开始<br> 1：升级中<br> 2：升级成功<br> 4：固件版本号错误<br> 5：不在升级名单内<br> 6：升级指令错误<br> \>127：升级中的错误码。 |
-### 文本预设
+### 文本下发
-#### 文本设置
-主题： /client/${client}/operate
-指令内容：
+#### 文本下发
+<br>主题： /client/${client}/operate
+<br>指令内容：
 ```json
 {
 	"i": 60,
@@ -796,9 +803,9 @@ public static String bytesToHexString(byte[] src) {
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
-| i = 60 | 文本设置 |
+| i = 60 | 文本下发 |
 | sn |键盘列表 |
 | cmd |下发的命令 <br> 1： 姓名下发 <br> 4： 第二行文本 <br> 85： 自判题判断  <br> 87： 清除 |
 | text |标题信息，以hex:开头添加的内容 内容为GBK的hex编码 |
@@ -825,31 +832,34 @@ public static String bytesToHexString(byte[] src) {
-#### 设置返回(待完成-可能修改)
-主题: /client/${client}/report
-指令内容：
+#### 文本下发返回
+<br>主题: /client/${client}/report
+<br>指令内容：
 ```json
 {
 	"i": 61,
 	"en": "6",
-	"sn": ["2126956007", "2126956008"],
+	"cmd": 1,
 	"m": [{
-		"cmd": 81,
-		"success": 0
+        "sn": "2126833671",
+        "success": 0
+	},{
+        "sn": "2126833672",
+        "success": 0
 	}]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
-| i = 61 | 设置返回 |
-| sn |键盘列表 |
-| cmd |下发的命令 <br> 1： 姓名下发 <br> 4： 第二行文本 <br> 85：自判题判断  <br> 87 清除 |
+| i = 61 | 文本下发返回 |
+| sn |键盘号 |
+| cmd |下发的命令 <br> 1： 姓名下发 <br> 4： 第二行文本 <br> 85：自判题判断  <br> 87：清除 |
 | success | 是否成功。<br> 0 表示成功 <br> -1 失败 |
 ### 学生卡信息上报
 卡初始化组网的时候会上报一次
-主题：/client/${client}/report
-指令内容：
+<br>主题：/client/${client}/report
+<br>指令内容：
 ```json
 {
     "i":32,
@@ -863,7 +873,7 @@ public static String bytesToHexString(byte[] src) {
     ]
 }
 ```
-| 名词 | 备注 |
+| 名称 | 备注 |
 | --- | --- |
 | i = 32 | 学生卡信息上报 |
 | c |键盘编号 |