Commit 92de8c2b6d2ecab302d2437327c3e684e0935c12

Authored by 孙向锦
1 parent 73fb9953

海亮定制

Showing 1 changed file with 128 additions and 118 deletions
海亮定制.md
... ... @@ -146,7 +146,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
146 146 | qs | number | 该题型数量(question sum),单题为1,多题则为实际数量。 |
147 147 | qn | number | 题目序号(question No),题目顺序号 |
148 148 | dn | string | display no 显示编号,键盘上显示的题目编号|
149   -| a | string | 答案(answer)示例:字母单选:A字母多选:A|B文本题:hex: 标记是gbk编码的hex内容 |
  149 +| a | string | 答案(answer)<br> 示例:字母单选:A <br> 字母多选:A&#124;B&#124;C |
150 150 | en | string | 练习(考试)编号(exercise No)每次考试或者练习的唯一编号,用于确定提交的答案属于那次练习。 |
151 151 | on | number | 单选和多选题的选项数量(option no) |
152 152 | cid | string | 客户端ID(client Id) |
... ... @@ -167,7 +167,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
167 167  
168 168 对客户端授时,发送指令即可,基站会完成校时。
169 169  
170   -主题 : /client/${client}/operate
  170 +<br>主题 : /client/${client}/operate
171 171  
172 172 ```
173 173 {
... ... @@ -176,7 +176,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
176 176 }
177 177 ```
178 178  
179   -| 名 | 备注 |
  179 +| 名 | 备注 |
180 180 | --- | --- |
181 181 | i = 19 | 授时 |
182 182 | t | 当前时间轴秒 |
... ... @@ -190,35 +190,41 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
190 190  
191 191 由基站发给应用程序,应用需要订阅主题
192 192  
193   -主题 : /client/${clientId}/online
  193 +<br>主题 : /client/${clientId}/online
194 194  
195   -指令内容:
  195 +<br>指令内容:
196 196 ```
197 197 {
198 198 "i": 40
199 199 }
200 200 ```
201 201  
  202 +| 名称 | 备注 |
  203 +| --- | --- |
  204 +| i = 40 | 基站上线 |
  205 +
202 206  
203 207 #### 基站下线(待完成-可能修改)
204 208  
205 209 由服务器发给应用程序,应用需要订阅主题
206 210  
207   -主题:/client/${clientId}/offline
208   -指令内容:
  211 +<br>主题:/client/${clientId}/offline
  212 +<br>指令内容:
209 213 ```json
210 214 {
211 215 "i": 41
212 216 }
213 217 ```
214   -
  218 +| 名称 | 备注 |
  219 +| --- | --- |
  220 +| i = 41 | 基站下线 |
215 221  
216 222 #### 基站信息设置与读取
217 223  
218 224 应用程序发送给基站
219 225  
220   -主题: /client/${client}/operate
221   -指令内容:
  226 +<br>主题: /client/${client}/operate
  227 +<br>指令内容:
222 228 ```json
223 229 {
224 230 "i": 20,
... ... @@ -232,13 +238,14 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
232 238 }
233 239 ```
234 240  
235   -| 主题 | 备注 |
  241 +| 名称 | 备注 |
236 242 | --- | --- |
  243 +| i= 20 |基站信息设置与读取 |
237 244 | f |基站频点 频点范围1-80|
238   -| mqtt\_ip | 连接服务器的IP|
239   -| mqtt\_port | 连接mqtt服务器的端口 |
240   -| mqtt\_username | 连接mqtt服务器的用户名 |
241   -| mqtt\_password | 连接mqtt服务器的密码 |
  245 +| mqtt_ip | 连接服务器的IP|
  246 +| mqtt_port | 连接mqtt服务器的端口 |
  247 +| mqtt_username | 连接mqtt服务器的用户名 |
  248 +| mqtt_password | 连接mqtt服务器的密码 |
242 249 | 注意 | 如果没有该字段则不设置该值,保持原值下发对有需要修改的值设置完成后,基站信息会自动上报一次 |
243 250  
244 251  
... ... @@ -246,8 +253,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
246 253  
247 254 基站发送给应用程序
248 255  
249   -主题: /client/${client}/report
250   -指令内容:
  256 +<br>主题: /client/${client}/report
  257 +<br>指令内容:
251 258 ```json
252 259 {
253 260 "i": 21,
... ... @@ -255,14 +262,16 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
255 262 "m": {
256 263 "f": 1,
257 264 "mqtt_ip": "edunew.sunvotecloud.cn",
258   - "mqtt_port": 8443,
  265 + "mqtt_port": 1883,
259 266 "mqtt_username": "admin",
260 267 "mqtt_password": "1223456789"
261 268 }
262 269 }
263 270 ```
264   -| 名 | 备注 |
  271 +| 名 | 备注 |
265 272 | --- | --- |
  273 +| i= 21 |基站信息上报 |
  274 +| cId |客户端ID |
266 275 | f |基站频点 |
267 276 | mqtt_ip | 连接服务器的IP |
268 277 | mqtt_port | 连接mqtt服务器的端口 |
... ... @@ -272,9 +281,9 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
272 281  
273 282 #### 基站错误信息上报(待完成-可能修改)
274 283  
275   -基站发送给应用程序
276   -主题:/client/${client}/error
277   -指令内容:
  284 +基站发送给应用程序主题
  285 +<br>主题:/client/${client}/error
  286 +<br>指令内容:
278 287 ```json
279 288 {
280 289 "i": 22,
... ... @@ -284,7 +293,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
284 293 }
285 294 }
286 295 ```
287   -| 名 | 备注 |
  296 +| 名 | 备注 |
288 297 | --- | --- |
289 298 | i = 22 | 基站错误信息上报 |
290 299 | et |错误类型 et = 1 :基站频点冲突 |
... ... @@ -298,8 +307,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
298 307 #### 键盘上线
299 308  
300 309 由基站发给应用程序,应用需要订阅主题
301   -主题: /client/${clientId}/card/online
302   -指令内容:
  310 +<br>主题: /client/${clientId}/card/online
  311 +<br>指令内容:
303 312 ```json
304 313 {
305 314 "i": 14,
... ... @@ -310,7 +319,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
310 319 }]
311 320 }
312 321 ```
313   -| 名 | 备注 |
  322 +| 名 | 备注 |
314 323 | --- | --- |
315 324 | i = 14 |键盘上线 |
316 325 | c |键盘sn号 |
... ... @@ -321,8 +330,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
321 330 #### 键盘下线
322 331  
323 332 由基站发给应用程序,应用需要订阅主题
324   -主题: /client/${clientId}/card/offline
325   -指令内容:
  333 +<br>主题: /client/${clientId}/card/offline
  334 +<br>指令内容:
326 335 ```json
327 336 {
328 337 "i": 15,
... ... @@ -332,7 +341,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
332 341 }]
333 342 }
334 343 ```
335   -| 名 | 备注 |
  344 +| 名 | 备注 |
336 345 | --- | --- |
337 346 | i = 15 |键盘下线 |
338 347 | c |键盘sn号 |
... ... @@ -342,22 +351,22 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
342 351 #### 读取白名单
343 352  
344 353 应用程序发送给基站
345   -主题: /lesson/class/${clinetId}/receive
346   -指令内容:
  354 +<br>主题: /lesson/class/${clinetId}/receive
  355 +<br>指令内容:
347 356 ```json
348 357 {
349 358 "i": 30
350 359 }
351 360 ```
352   -| 名 | 备注 |
  361 +| 名 | 备注 |
353 362 | --- | --- |
354 363 | i = 30 |读取白名单 |
355 364  
356 365  
357 366  
358   -基站发给应用程序
359   -主题: /lesson/class/${clinetId}/receive
360   -指令内容:
  367 +基站发给应用程序主题
  368 +<br>主题: /lesson/class/${clinetId}/receive
  369 +<br>指令内容:
361 370 ```json
362 371 {
363 372 "i": 31,
... ... @@ -366,7 +375,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
366 375 "m": ["2126932551"]
367 376 }
368 377 ```
369   -| 名 | 备注 |
  378 +| 名 | 备注 |
370 379 | --- | --- |
371 380 | i = 31 |白名单上传 |
372 381 | total |一共上传的数据包数 |
... ... @@ -379,15 +388,15 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
379 388 #### 添加白名单
380 389  
381 390 应用程序发送给基站
382   -主题: /lesson/class/${clinetId}/receive
383   -指令内容:
  391 +<br>主题: /lesson/class/${clinetId}/receive
  392 +<br>指令内容:
384 393 ```json
385 394 {
386 395 "i": 3,
387 396 "m": ["2126833703", "2126833671"]
388 397 }
389 398 ```
390   -| 名 | 备注 |
  399 +| 名 | 备注 |
391 400 | --- | --- |
392 401 | i = 3 |添加白名单m内包含白名单键盘按编号 |
393 402 | m |键盘序列号列表 |
... ... @@ -398,8 +407,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
398 407 #### 删除白名单
399 408  
400 409 应用程序发送给基站
401   -主题: /lesson/class/${clinetId}/receive
402   -指令内容:
  410 +<br>主题: /lesson/class/${clinetId}/receive
  411 +<br>指令内容:
403 412 ```json
404 413 {
405 414 "i": 4,
... ... @@ -407,7 +416,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
407 416 }
408 417 ```
409 418  
410   -| 名 | 备注 |
  419 +| 名 | 备注 |
411 420 | --- | --- |
412 421 | i = 4 |删除白名单m内包含白名单键盘按编号 |
413 422 | m |键盘序列号列表 |
... ... @@ -417,14 +426,14 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
417 426 #### 清空白名单
418 427  
419 428 应用程序发送给基站
420   -主题: /lesson/class/${clinetId}/receive
421   -指令内容:
  429 +<br>主题: /lesson/class/${clinetId}/receive
  430 +<br>指令内容:
422 431 ```json
423 432 {
424 433 "i": 5
425 434 }
426 435 ```
427   -| 名 | 备注 |
  436 +| 名 | 备注 |
428 437 | --- | --- |
429 438 | i = 5 |清空白名单 |
430 439  
... ... @@ -439,8 +448,8 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
439 448 #### 开启答题
440 449  
441 450 由应用程序发给基站,应用按照主题发送
442   -主题: /lesson/class/${clinetId}/receive
443   -指令内容:
  451 +<br>主题: /lesson/class/${clinetId}/receive
  452 +<br>指令内容:
444 453 ```json
445 454 {
446 455 "i": 12,
... ... @@ -453,7 +462,7 @@ ${clinetId} clinetId 是基站编号,为替换字符串。
453 462 }
454 463 }
455 464 ```
456   -| 名 | 备注 |
  465 +| 名 | 备注 |
457 466 | --- | --- |
458 467 | i = 12 |下发答题 |
459 468 | en |序号 |
... ... @@ -486,8 +495,8 @@ public static String bytesToHexString(byte[] src) {
486 495 #### 接收答题数据
487 496  
488 497 由基站发给应用程序,应用订阅主题
489   -主题: /lesson/class/${clinetId}/send
490   -指令内容:
  498 +<br>主题: /lesson/class/${clinetId}/send
  499 +<br><br>指令内容:
491 500 ```json
492 501 {
493 502 "i": 13,
... ... @@ -501,37 +510,37 @@ public static String bytesToHexString(byte[] src) {
501 510 }]
502 511 }
503 512 ```
504   -| 名 | 备注 |
  513 +| 名 | 备注 |
505 514 | --- | --- |
506 515 | i = 13 | 答题数据 |
507   -| qn = 1 |上报答题数据,单题题号固定为1 |
  516 +| qn |上报答题数据,单题题号固定为1 |
508 517 | t |提交答案时间 |
509 518 | a | 答题数据 |
510 519  
511 520  
512 521 #### 停止答题
513   -由应用程序发给基站,应用按照主题发送
514   -主题:/lesson/class/${clinetId}/receive
515   -指令内容:
  522 +由应用程序发给基站,应用按照发送
  523 +<br>主题:/lesson/class/${clinetId}/receive
  524 +<br>指令内容:
516 525 ```json
517 526 {
518 527 "i": 11,
519 528 "en": "1"
520 529 }
521 530 ```
522   -| 名 | 备注 |
  531 +| 名 | 备注 |
523 532 | --- | --- |
524 533 | i = 11 | 停止答题 |
525 534 | en |停止对序号1的练习 |
526 535  
527 536  
528   -### 抢答(待完成-可能修改)
  537 +### 抢答
529 538  
530   -#### 开启答题(待完成-可能修改)
  539 +#### 开启答题
531 540  
532   -由应用程序发给基站,应用按照主题发送
533   -主题: /lesson/class/${clinetId}/receive
534   -指令内容:
  541 +由应用程序发给基站,应用按照发送
  542 +<br>主题: /lesson/class/${clinetId}/receive
  543 +<br>指令内容:
535 544 ```json
536 545 {
537 546 "i": 12,
... ... @@ -539,7 +548,7 @@ public static String bytesToHexString(byte[] src) {
539 548 "qm": 4
540 549 }
541 550 ```
542   -| 名 | 备注 |
  551 +| 名 | 备注 |
543 552 | --- | --- |
544 553 | i = 12 | 开启答题 |
545 554 | en |序号2的练习 |
... ... @@ -547,26 +556,24 @@ public static String bytesToHexString(byte[] src) {
547 556  
548 557  
549 558  
550   -#### 接收答题数据(待完成-可能修改)
  559 +#### 接收答题数据
551 560  
552   -由基站发给应用程序,应用订阅主题
553   -主题: /lesson/class/${clinetId}/send
554   -指令内容:
  561 +由基站发给应用程序,应用订阅
  562 +<br>主题: /lesson/class/${clinetId}/send
  563 +<br>指令内容:
555 564 ```json
556 565 {
557 566 "i": 13,
558 567 "en": "2",
559 568 "qm": 4,
560   - "c": "2126833671",
561 569 "m": [{
562   - "qn": 1,
563   - "a": "A",
  570 + "c": "2126833671",
564 571 "t": 1626016299
565 572 }]
566 573 }
567 574 ```
568 575  
569   -| 名 | 备注 |
  576 +| 名 | 备注 |
570 577 | --- | --- |
571 578 | i = 12 | 开启答题 |
572 579 | en |序号2的练习 |
... ... @@ -580,15 +587,15 @@ public static String bytesToHexString(byte[] src) {
580 587  
581 588 #### 停止答题(待完成-可能修改)
582 589 由应用程序发给基站,应用按照主题发送
583   -主题:/lesson/class/${clinetId}/receive
584   -指令内容:
  590 +<br>主题:/lesson/class/${clinetId}/receive
  591 +<br>指令内容:
585 592 ```json
586 593 {
587 594 "i": 11,
588 595 "en": "2"
589 596 }
590 597 ```
591   -| 名 | 备注 |
  598 +| 名 | 备注 |
592 599 | --- | --- |
593 600 | i = 11 | 停止答题 |
594 601 | en |停止对序号2的练习 |
... ... @@ -600,8 +607,8 @@ public static String bytesToHexString(byte[] src) {
600 607 #### 开启答题
601 608  
602 609 由应用程序发给基站,应用按照主题发送
603   -主题: /lesson/class/${clinetId}/receive
604   -指令内容:
  610 +<br>主题: /lesson/class/${clinetId}/receive
  611 +<br>指令内容:
605 612 ```json
606 613 {
607 614 "i": 12,
... ... @@ -626,7 +633,7 @@ public static String bytesToHexString(byte[] src) {
626 633 }
627 634 ```
628 635  
629   -| 名 | 备注 |
  636 +| 名 | 备注 |
630 637 | --- | --- |
631 638 | i = 12 | 开启答题 |
632 639 | en |12341练习 |
... ... @@ -642,8 +649,8 @@ public static String bytesToHexString(byte[] src) {
642 649 #### 接收答题数据
643 650  
644 651 由基站发给应用程序,应用订阅主题
645   -主题: /lesson/class/${clinetId}/send
646   -指令内容:
  652 +<br>主题: /lesson/class/${clinetId}/send
  653 +<br>指令内容:
647 654 ```json
648 655 {
649 656 "i": 13,
... ... @@ -651,14 +658,14 @@ public static String bytesToHexString(byte[] src) {
651 658 "qm": 14,
652 659 "c": "2126833671",
653 660 "m": [{
654   - "qn": "1",
  661 + "qn": 1,
655 662 "a": "A",
656 663 "t": 1626016299
657 664 }]
658 665 }
659 666 ```
660 667  
661   -| 名 | 备注 |
  668 +| 名 | 备注 |
662 669 | --- | --- |
663 670 | i = 13 | 接收答题数据 |
664 671 | en |12341练习 |
... ... @@ -672,15 +679,15 @@ public static String bytesToHexString(byte[] src) {
672 679  
673 680 #### 停止答题
674 681 由应用程序发给基站,应用按照主题发送
675   -主题:/lesson/class/${clinetId}/receive
676   -指令内容:
  682 +<br>主题:/lesson/class/${clinetId}/receive
  683 +<br>指令内容:
677 684 ```json
678 685 {
679 686 "i": 11,
680 687 "en": "3"
681 688 }
682 689 ```
683   -| 名 | 备注 |
  690 +| 名 | 备注 |
684 691 | --- | --- |
685 692 | i = 11 | 停止答题 |
686 693 | en |停止对序号12341的练习 |
... ... @@ -689,8 +696,8 @@ public static String bytesToHexString(byte[] src) {
689 696 ### 基站升级
690 697  
691 698 #### 开始升级
692   -主题: /client/${client}/operate
693   -指令内容:
  699 +<br>主题: /client/${client}/operate
  700 +<br>指令内容:
694 701 ```json
695 702 {
696 703 "i": 17,
... ... @@ -702,7 +709,7 @@ public static String bytesToHexString(byte[] src) {
702 709 }
703 710 }
704 711 ```
705   -| 名 | 备注 |
  712 +| 名 | 备注 |
706 713 | --- | --- |
707 714 | i = 17 | 基站升级 |
708 715 | en |序号5 |
... ... @@ -713,8 +720,8 @@ public static String bytesToHexString(byte[] src) {
713 720  
714 721  
715 722 #### 升级进度报告
716   -主题: /client/${client}/report
717   -指令内容:
  723 +<br>主题: /client/${client}/report
  724 +<br>指令内容:
718 725 ```json
719 726 {
720 727 "i": 18,
... ... @@ -725,7 +732,7 @@ public static String bytesToHexString(byte[] src) {
725 732 }
726 733 }
727 734 ```
728   -| 名 | 备注 |
  735 +| 名 | 备注 |
729 736 | --- | --- |
730 737 | i = 18 | 升级进度报告 |
731 738 | cId |基站编号 |
... ... @@ -736,19 +743,19 @@ public static String bytesToHexString(byte[] src) {
736 743 ### 键盘升级
737 744  
738 745 #### 开始升级
739   -主题: /client/${client}/operate
740   -指令内容:
  746 +<br>主题: /client/${client}/operate
  747 +<br>指令内容:
741 748 ```json
742 749 {
743 750 "i": 28,
744 751 "m": {
745   - "url": "",
746   - "version": "",
747   - "CRC": ""
  752 + "url": "http://120.78.57.84:8888/file/S6_2.4G_2.1.2.50_GB2312_CGC_add_head.bin",
  753 + "version": "2.1.2.50",
  754 + "CRC": "10605263"
748 755 }
749 756 }
750 757 ```
751   -| 名 | 备注 |
  758 +| 名 | 备注 |
752 759 | --- | --- |
753 760 | i = 28 | 键盘升级 |
754 761 | url |固件包地址,基站能访问到的路径 |
... ... @@ -757,8 +764,8 @@ public static String bytesToHexString(byte[] src) {
757 764  
758 765  
759 766 #### 升级进度报告
760   -主题: /client/${client}/report
761   -指令内容:
  767 +<br>主题: /client/${client}/report
  768 +<br>指令内容:
762 769 ```json
763 770 {
764 771 "i": 29,
... ... @@ -769,19 +776,19 @@ public static String bytesToHexString(byte[] src) {
769 776 }
770 777 }
771 778 ```
772   -| 名 | 备注 |
  779 +| 名 | 备注 |
773 780 | --- | --- |
774   -| i = 18 | 升级进度报告 |
  781 +| i = 29 | 升级进度报告 |
775 782 | cId |基站编号 |
776 783 | percent |升级百分比 |
777 784 | status |升级状态信息。 <br> 0:未开始<br> 1:升级中<br> 2:升级成功<br> 4:固件版本号错误<br> 5:不在升级名单内<br> 6:升级指令错误<br> \>127:升级中的错误码。 |
778 785  
779 786  
780   -### 文本预设
  787 +### 文本下发
781 788  
782   -#### 文本设置
783   -主题: /client/${client}/operate
784   -指令内容:
  789 +#### 文本下发
  790 +<br>主题: /client/${client}/operate
  791 +<br>指令内容:
785 792 ```json
786 793 {
787 794 "i": 60,
... ... @@ -796,9 +803,9 @@ public static String bytesToHexString(byte[] src) {
796 803 }]
797 804 }
798 805 ```
799   -| 名 | 备注 |
  806 +| 名 | 备注 |
800 807 | --- | --- |
801   -| i = 60 | 文本设置 |
  808 +| i = 60 | 文本下发 |
802 809 | sn |键盘列表 |
803 810 | cmd |下发的命令 <br> 1: 姓名下发 <br> 4: 第二行文本 <br> 85: 自判题判断 <br> 87: 清除 |
804 811 | text |标题信息,以hex:开头添加的内容 内容为GBK的hex编码 |
... ... @@ -825,31 +832,34 @@ public static String bytesToHexString(byte[] src) {
825 832  
826 833  
827 834  
828   -#### 设置返回(待完成-可能修改)
829   -主题: /client/${client}/report
830   -指令内容:
  835 +#### 文本下发返回
  836 +<br>主题: /client/${client}/report
  837 +<br>指令内容:
831 838 ```json
832 839 {
833 840 "i": 61,
834 841 "en": "6",
835   - "sn": ["2126956007", "2126956008"],
  842 + "cmd": 1,
836 843 "m": [{
837   - "cmd": 81,
838   - "success": 0
  844 + "sn": "2126833671",
  845 + "success": 0
  846 + },{
  847 + "sn": "2126833672",
  848 + "success": 0
839 849 }]
840 850 }
841 851 ```
842   -| 名 | 备注 |
  852 +| 名 | 备注 |
843 853 | --- | --- |
844   -| i = 61 | 设置返回 |
845   -| sn |键盘列表 |
846   -| cmd |下发的命令 <br> 1: 姓名下发 <br> 4: 第二行文本 <br> 85:自判题判断 <br> 87 清除 |
  854 +| i = 61 | 文本下发返回 |
  855 +| sn |键盘号 |
  856 +| cmd |下发的命令 <br> 1: 姓名下发 <br> 4: 第二行文本 <br> 85:自判题判断 <br> 87:清除 |
847 857 | success | 是否成功。<br> 0 表示成功 <br> -1 失败 |
848 858  
849 859 ### 学生卡信息上报
850 860 卡初始化组网的时候会上报一次
851   -主题:/client/${client}/report
852   -指令内容:
  861 +<br>主题:/client/${client}/report
  862 +<br>指令内容:
853 863 ```json
854 864 {
855 865 "i":32,
... ... @@ -863,7 +873,7 @@ public static String bytesToHexString(byte[] src) {
863 873 ]
864 874 }
865 875 ```
866   -| 名 | 备注 |
  876 +| 名 | 备注 |
867 877 | --- | --- |
868 878 | i = 32 | 学生卡信息上报 |
869 879 | c |键盘编号 |
... ...