Commit 3db2eff34c681b2cd8b6b66992b3401159464fd1
Merge branch 'master' of http://120.78.57.84/lee/Protocol
Showing
4 changed files
with
596 additions
and
21 deletions
通讯协议-SDK应用部分.md
... | ... | @@ -8,7 +8,7 @@ WSCmdApp协议接口说明 |
8 | 8 | |
9 | 9 | |
10 | 10 | <div style="text-align: center;font-size: 30px;"> |
11 | -Ver5.1.6 | |
11 | +Ver5.1.7 | |
12 | 12 | </div> |
13 | 13 | <br> |
14 | 14 | <br> |
... | ... | @@ -48,6 +48,7 @@ Ver5.1.6 |
48 | 48 | |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数| |
49 | 49 | |5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式| |
50 | 50 | |5.1.6| 2024年02月19日|陈定敏|1. 增加keypadRemoteControl接口<br>2. 增加举手功能接口| |
51 | +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口<br>2. 增加键盘最终提交状态接口| | |
51 | 52 | |
52 | 53 | <br> |
53 | 54 | |
... | ... | @@ -491,8 +492,8 @@ params:{} //为空 |
491 | 492 | |
492 | 493 | |
493 | 494 | ### 签到设备 |
494 | - | |
495 | -#### 开始签到 | |
495 | +#### 普通签到 | |
496 | +##### 开始签到 | |
496 | 497 | |
497 | 498 | 发送: |
498 | 499 | |
... | ... | @@ -522,7 +523,6 @@ params:{} |
522 | 523 | "bindMode": "1", |
523 | 524 | "lessMode": "0", |
524 | 525 | "modifyMode": "1", |
525 | - "limitNumber": "1", | |
526 | 526 | "options": "10", |
527 | 527 | "optionalN": "10", |
528 | 528 | "keyValue": "0" |
... | ... | @@ -531,7 +531,7 @@ params:{} |
531 | 531 | } |
532 | 532 | ``` |
533 | 533 | |
534 | -#### 接收签到信息 | |
534 | +##### 接收签到信息 | |
535 | 535 | |
536 | 536 | 接收: |
537 | 537 | |
... | ... | @@ -561,7 +561,7 @@ infos:{} |
561 | 561 | } |
562 | 562 | ``` |
563 | 563 | |
564 | -#### 停止签到 | |
564 | +##### 停止签到 | |
565 | 565 | |
566 | 566 | 发送: |
567 | 567 | |
... | ... | @@ -598,13 +598,153 @@ infos:{"state":"OK"}//返回状态,成功为OK |
598 | 598 | } |
599 | 599 | ``` |
600 | 600 | |
601 | -#### 支持设备说明 | |
601 | +##### 支持设备说明 | |
602 | 602 | |
603 | 603 | |**基站+键盘 **|**支持/不支持**|**备注**| |
604 | 604 | | --- | --- | --- | |
605 | 605 | |B100-2.4G+S6|支持|| |
606 | 606 | |B200-2.4G+S6|支持|| |
607 | 607 | |B200-5.8G+T2|支持|| |
608 | +#### 后台签到 | |
609 | +##### 设置后台签到模式 | |
610 | + | |
611 | +注意:此接口只支持广播模式使用。 | |
612 | + | |
613 | +发送: | |
614 | + | |
615 | +fun: "backendBind" // | |
616 | +params:{} | |
617 | + | |
618 | +|**Json字段**| **字段含义** | **赋值及含义**| | |
619 | +| --- | --- | --- | | |
620 | +| mode | 签到模式| 0: 关闭 <br> 1: 开启 | | |
621 | + | |
622 | + | |
623 | +指令样例: | |
624 | + | |
625 | +```json | |
626 | +{ | |
627 | + "fun": "backendBind", | |
628 | + "baseId": 0, | |
629 | + "baseSn":"2023031402", | |
630 | + "params": { | |
631 | + "mode": "1" | |
632 | + }, | |
633 | + "packetTag": "1" | |
634 | +} | |
635 | +``` | |
636 | + | |
637 | +接收: | |
638 | + | |
639 | +fun: "backendBind" // | |
640 | +baseId: "1"//接收到指令的基站ID | |
641 | +infos:{"state":"OK"}//返回状态,成功为OK | |
642 | + | |
643 | +指令样例: | |
644 | + | |
645 | +```json | |
646 | +{ | |
647 | + "fun": "backendBind", | |
648 | + "baseId": 1, | |
649 | + "baseSn":"2023031402", | |
650 | + "infos": { | |
651 | + "mode": "1", | |
652 | + "state": "OK" | |
653 | + }, | |
654 | + "packetTag": "1" | |
655 | +} | |
656 | +``` | |
657 | + | |
658 | +##### 接收签到信息 | |
659 | + | |
660 | +接收: | |
661 | + | |
662 | +fun: "answerBind" //签到返回 | |
663 | +baseId: "1"//接收到指令的基站ID | |
664 | +infos:{} | |
665 | + | |
666 | +| Json字段|字段含义|赋值及含义| | |
667 | +|---|---|---| | |
668 | +|time|答题时间|单位秒| | |
669 | +|keySn|键盘Sn|| | |
670 | +|keyValue|键值|键盘提交的值| | |
671 | + | |
672 | +指令样例: | |
673 | + | |
674 | +```json | |
675 | +{ | |
676 | + "fun": "answerBind", | |
677 | + "baseId": 1, | |
678 | + "baseSn":"2023031402", | |
679 | + "infos": { | |
680 | + "time": "0", | |
681 | + "keySn": "1479824643", | |
682 | + "keyValue": "1234" | |
683 | + }, | |
684 | + "packetTag": "1" | |
685 | +} | |
686 | +``` | |
687 | + | |
688 | + | |
689 | + | |
690 | +##### 键盘授权 | |
691 | + | |
692 | +注意:此接口配合后台签到指令使用,只支持指定键盘操作。 | |
693 | + | |
694 | +发送: | |
695 | + | |
696 | +fun: "keyPadAuthorize" // | |
697 | +baseId: "1"//收到的基站ID | |
698 | +params:{} //默认空 | |
699 | + | |
700 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
701 | +| --- | --- | --- | | |
702 | +| baseId | 基站ID | 1-32 | | |
703 | +| authorize | 状态 | 1:授权成功<br>2:授权失败<br>3:授权解除| | |
704 | + | |
705 | + | |
706 | +指令样例: | |
707 | +```json | |
708 | +{ | |
709 | + "fun": "keyPadAuthorize", | |
710 | + "baseId": 0, | |
711 | + "baseSn": "2023031402", | |
712 | + "keySnList": [{ | |
713 | + "keySn": "0112540402" | |
714 | + }], | |
715 | + "params": { | |
716 | + "authorize": "1" | |
717 | + }, | |
718 | + "packetTag": "20" | |
719 | +} | |
720 | +``` | |
721 | + | |
722 | +接收: | |
723 | + | |
724 | +fun: "keyPadAuthorize" // | |
725 | +baseId: "1"//收到的基站ID | |
726 | +infos:{"authorize":"1"}//返回状态 | |
727 | + | |
728 | +指令样例: | |
729 | +```json | |
730 | +{ | |
731 | + "fun": "keyPadAuthorize", | |
732 | + "baseId": 1, | |
733 | + "baseSn":"2023031402", | |
734 | + "infos": { | |
735 | + "authorize": "1", | |
736 | + "keySn": "0112402128" | |
737 | + }, | |
738 | + "packetTag": "20" | |
739 | +} | |
740 | +``` | |
741 | + | |
742 | +##### 支持设备说明 | |
743 | + | |
744 | +|**基站+键盘 **|**支持/不支持**|**备注**| | |
745 | +| --- | --- | --- | | |
746 | +|B100-2.4G+S6|支持|| | |
747 | +|B200-2.4G+S6|支持|| | |
608 | 748 | |
609 | 749 | ### 选择题 |
610 | 750 | |
... | ... | @@ -2641,6 +2781,54 @@ infos:{"state":"OK"}//返回状态,成功为OK |
2641 | 2781 | } |
2642 | 2782 | ``` |
2643 | 2783 | |
2784 | +#### 键盘最终提交状态 | |
2785 | + | |
2786 | +发送: | |
2787 | + | |
2788 | +fun: "keyPadFinalSubmit" // | |
2789 | +baseId: "1"//收到的基站ID | |
2790 | +params:{} //默认空 | |
2791 | + | |
2792 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
2793 | +| --- | --- | --- | | |
2794 | +| baseId | 基站ID | 1-32 | | |
2795 | +| commitok | 状态 | 0:解锁 | | |
2796 | + | |
2797 | + | |
2798 | +指令样例: | |
2799 | +```json | |
2800 | +{ | |
2801 | + "fun": "keyPadFinalSubmit", | |
2802 | + "baseId": 0, | |
2803 | + "baseSn":"2023031402", | |
2804 | + "params": { | |
2805 | + "commitok": "0" | |
2806 | + }, | |
2807 | + "packetTag": "20" | |
2808 | +} | |
2809 | +``` | |
2810 | + | |
2811 | +接收: | |
2812 | + | |
2813 | +fun: "keyPadFinalSubmit" // | |
2814 | +baseId: "1"//收到的基站ID | |
2815 | +infos:{"commitok":"OK"}//返回状态 | |
2816 | + | |
2817 | +指令样例: | |
2818 | +```json | |
2819 | +{ | |
2820 | + "fun": "keyPadFinalSubmit", | |
2821 | + "baseId": 1, | |
2822 | + "baseSn":"2023031402", | |
2823 | + "infos": { | |
2824 | + "commitok": "0", | |
2825 | + "keySn": "0112402128", | |
2826 | + "time": "84.5" | |
2827 | + }, | |
2828 | + "packetTag": "20" | |
2829 | +} | |
2830 | +``` | |
2831 | + | |
2644 | 2832 | #### 支持设备说明 |
2645 | 2833 | |
2646 | 2834 | | **基站+键盘** | **支持** | **备注** | |
... | ... | @@ -5278,10 +5466,12 @@ params:{}//数组对象,字段不填则保留上次值。 |
5278 | 5466 | | **Json字段** | **字段含义** | **赋值及含义** | |
5279 | 5467 | | --- | --- | --- | |
5280 | 5468 | | keySn| 键盘Sn| 不能为空| |
5281 | -| scoreMode| 分数模式|1:清除<br>2:字符显示(默认值)<br>3:五角星显示<br>4:爱心显示[S6有效]| | |
5282 | -| scoreValue| 分数值|scoreMode == 1,此处无效. <br>scoreMode == 2,8个字符长度. <br>scoreMode == 3,0~6,2个分数表示1个五角星,最多3个. <br> scoreMode == 4,0~6,2个分数表示1个爱心,最多3个 [S6有效]| | |
5469 | +| scoreMode| 分数模式|1:清除<br>2:字符显示(默认值)<br>3:五角星显示| | |
5470 | +| scoreValue| 分数值|scoreMode == 1,此处无效. <br>scoreMode == 2,8个字符长度. <br>scoreMode == 3,0~6,2个分数表示1个五角星,最多3个. | | |
5283 | 5471 | |tipText|提示文本| 最多8个汉字(16个字符),键盘第二行显示| |
5284 | 5472 | |
5473 | +注意:scoreMode和scoreValue字段在 B200+S6和B100+S6设备中无效。 | |
5474 | + | |
5285 | 5475 | |
5286 | 5476 | 指令样例: |
5287 | 5477 | 样例目的:将SN为"1479824643"的键盘积分位置设置成"99",第二行文本位置设置成"已绑定"。 |
... | ... | @@ -5790,3 +5980,6 @@ infos:{ "funId":"F0001","code":"10002"}// |
5790 | 5980 | |F0115|写入键盘姓名| |
5791 | 5981 | |F0116|键盘关机时间等级| |
5792 | 5982 | |F0117|基础配置模式| |
5983 | +|F0118|最终提交状态| | |
5984 | +|F0119|后台签到| | |
5985 | +|F0120|键盘授权| | ... | ... |
通讯协议-SDK应用部分[内部].md
... | ... | @@ -8,7 +8,7 @@ WSCmdApp协议接口说明 |
8 | 8 | |
9 | 9 | |
10 | 10 | <div style="text-align: center;font-size: 30px;"> |
11 | -Ver5.1.6 | |
11 | +Ver5.1.7 | |
12 | 12 | </div> |
13 | 13 | <br> |
14 | 14 | <br> |
... | ... | @@ -48,6 +48,7 @@ Ver5.1.6 |
48 | 48 | |5.1.3| 2023年11月15日|陈定敏|1. 更新语音题接口参数| |
49 | 49 | |5.1.5| 2023年12月28日|陈定敏|1. 增加Json指令支持基站id和基站SN两种模式| |
50 | 50 | |5.1.6| 2024年02月19日|陈定敏|1. 增加keypadRemoteControl接口<br>2. 增加举手功能接口| |
51 | +|5.1.7| 2024年04月22日|陈定敏|1. 增加后台签到接口<br>2. 增加键盘最终提交状态接口| | |
51 | 52 | |
52 | 53 | <br> |
53 | 54 | |
... | ... | @@ -491,8 +492,8 @@ params:{} //为空 |
491 | 492 | |
492 | 493 | |
493 | 494 | ### 签到设备 |
494 | - | |
495 | -#### 开始签到 | |
495 | +#### 普通签到 | |
496 | +##### 开始签到 | |
496 | 497 | |
497 | 498 | 发送: |
498 | 499 | |
... | ... | @@ -522,7 +523,6 @@ params:{} |
522 | 523 | "bindMode": "1", |
523 | 524 | "lessMode": "0", |
524 | 525 | "modifyMode": "1", |
525 | - "limitNumber": "1", | |
526 | 526 | "options": "10", |
527 | 527 | "optionalN": "10", |
528 | 528 | "keyValue": "0" |
... | ... | @@ -531,7 +531,7 @@ params:{} |
531 | 531 | } |
532 | 532 | ``` |
533 | 533 | |
534 | -#### 接收签到信息 | |
534 | +##### 接收签到信息 | |
535 | 535 | |
536 | 536 | 接收: |
537 | 537 | |
... | ... | @@ -561,7 +561,7 @@ infos:{} |
561 | 561 | } |
562 | 562 | ``` |
563 | 563 | |
564 | -#### 停止签到 | |
564 | +##### 停止签到 | |
565 | 565 | |
566 | 566 | 发送: |
567 | 567 | |
... | ... | @@ -598,13 +598,153 @@ infos:{"state":"OK"}//返回状态,成功为OK |
598 | 598 | } |
599 | 599 | ``` |
600 | 600 | |
601 | -#### 支持设备说明 | |
601 | +##### 支持设备说明 | |
602 | 602 | |
603 | 603 | |**基站+键盘 **|**支持/不支持**|**备注**| |
604 | 604 | | --- | --- | --- | |
605 | 605 | |B100-2.4G+S6|支持|| |
606 | 606 | |B200-2.4G+S6|支持|| |
607 | 607 | |B200-5.8G+T2|支持|| |
608 | +#### 后台签到 | |
609 | +##### 设置后台签到模式 | |
610 | + | |
611 | +注意:此接口只支持广播模式使用。 | |
612 | + | |
613 | +发送: | |
614 | + | |
615 | +fun: "backendBind" // | |
616 | +params:{} | |
617 | + | |
618 | +|**Json字段**| **字段含义** | **赋值及含义**| | |
619 | +| --- | --- | --- | | |
620 | +| mode | 签到模式| 0: 关闭 <br> 1: 开启 | | |
621 | + | |
622 | + | |
623 | +指令样例: | |
624 | + | |
625 | +```json | |
626 | +{ | |
627 | + "fun": "backendBind", | |
628 | + "baseId": 0, | |
629 | + "baseSn":"2023031402", | |
630 | + "params": { | |
631 | + "mode": "1" | |
632 | + }, | |
633 | + "packetTag": "1" | |
634 | +} | |
635 | +``` | |
636 | + | |
637 | +接收: | |
638 | + | |
639 | +fun: "backendBind" // | |
640 | +baseId: "1"//接收到指令的基站ID | |
641 | +infos:{"state":"OK"}//返回状态,成功为OK | |
642 | + | |
643 | +指令样例: | |
644 | + | |
645 | +```json | |
646 | +{ | |
647 | + "fun": "backendBind", | |
648 | + "baseId": 1, | |
649 | + "baseSn":"2023031402", | |
650 | + "infos": { | |
651 | + "mode": "1", | |
652 | + "state": "OK" | |
653 | + }, | |
654 | + "packetTag": "1" | |
655 | +} | |
656 | +``` | |
657 | + | |
658 | +##### 接收签到信息 | |
659 | + | |
660 | +接收: | |
661 | + | |
662 | +fun: "answerBind" //签到返回 | |
663 | +baseId: "1"//接收到指令的基站ID | |
664 | +infos:{} | |
665 | + | |
666 | +| Json字段|字段含义|赋值及含义| | |
667 | +|---|---|---| | |
668 | +|time|答题时间|单位秒| | |
669 | +|keySn|键盘Sn|| | |
670 | +|keyValue|键值|键盘提交的值| | |
671 | + | |
672 | +指令样例: | |
673 | + | |
674 | +```json | |
675 | +{ | |
676 | + "fun": "answerBind", | |
677 | + "baseId": 1, | |
678 | + "baseSn":"2023031402", | |
679 | + "infos": { | |
680 | + "time": "0", | |
681 | + "keySn": "1479824643", | |
682 | + "keyValue": "1234" | |
683 | + }, | |
684 | + "packetTag": "1" | |
685 | +} | |
686 | +``` | |
687 | + | |
688 | + | |
689 | + | |
690 | +##### 键盘授权 | |
691 | + | |
692 | +注意:此接口配合后台签到指令使用,只支持指定键盘操作。 | |
693 | + | |
694 | +发送: | |
695 | + | |
696 | +fun: "keyPadAuthorize" // | |
697 | +baseId: "1"//收到的基站ID | |
698 | +params:{} //默认空 | |
699 | + | |
700 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
701 | +| --- | --- | --- | | |
702 | +| baseId | 基站ID | 1-32 | | |
703 | +| authorize | 状态 | 1:授权成功<br>2:授权失败<br>3:授权解除| | |
704 | + | |
705 | + | |
706 | +指令样例: | |
707 | +```json | |
708 | +{ | |
709 | + "fun": "keyPadAuthorize", | |
710 | + "baseId": 0, | |
711 | + "baseSn": "2023031402", | |
712 | + "keySnList": [{ | |
713 | + "keySn": "0112540402" | |
714 | + }], | |
715 | + "params": { | |
716 | + "authorize": "1" | |
717 | + }, | |
718 | + "packetTag": "20" | |
719 | +} | |
720 | +``` | |
721 | + | |
722 | +接收: | |
723 | + | |
724 | +fun: "keyPadAuthorize" // | |
725 | +baseId: "1"//收到的基站ID | |
726 | +infos:{"authorize":"1"}//返回状态 | |
727 | + | |
728 | +指令样例: | |
729 | +```json | |
730 | +{ | |
731 | + "fun": "keyPadAuthorize", | |
732 | + "baseId": 1, | |
733 | + "baseSn":"2023031402", | |
734 | + "infos": { | |
735 | + "authorize": "1", | |
736 | + "keySn": "0112402128" | |
737 | + }, | |
738 | + "packetTag": "20" | |
739 | +} | |
740 | +``` | |
741 | + | |
742 | +##### 支持设备说明 | |
743 | + | |
744 | +|**基站+键盘 **|**支持/不支持**|**备注**| | |
745 | +| --- | --- | --- | | |
746 | +|B100-2.4G+S6|支持|| | |
747 | +|B200-2.4G+S6|支持|| | |
608 | 748 | |
609 | 749 | ### 选择题 |
610 | 750 | |
... | ... | @@ -2788,12 +2928,122 @@ infos:{"state":"OK"}//返回状态,成功为OK |
2788 | 2928 | } |
2789 | 2929 | ``` |
2790 | 2930 | |
2931 | +#### 键盘最终提交状态 | |
2932 | + | |
2933 | +发送: | |
2934 | + | |
2935 | +fun: "keyPadFinalSubmit" // | |
2936 | +baseId: "1"//收到的基站ID | |
2937 | +params:{} //默认空 | |
2938 | + | |
2939 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
2940 | +| --- | --- | --- | | |
2941 | +| baseId | 基站ID | 1-32 | | |
2942 | +| commitok | 状态 | 0:解锁<br>1:锁定| | |
2943 | + | |
2944 | + | |
2945 | +指令样例: | |
2946 | +```json | |
2947 | +{ | |
2948 | + "fun": "keyPadFinalSubmit", | |
2949 | + "baseId": 0, | |
2950 | + "baseSn":"2023031402", | |
2951 | + "params": { | |
2952 | + "commitok": "0" | |
2953 | + }, | |
2954 | + "packetTag": "20" | |
2955 | +} | |
2956 | +``` | |
2957 | + | |
2958 | +接收: | |
2959 | + | |
2960 | +fun: "keyPadFinalSubmit" // | |
2961 | +baseId: "1"//收到的基站ID | |
2962 | +infos:{"commitok":"OK"}//返回状态 | |
2963 | + | |
2964 | +指令样例: | |
2965 | +```json | |
2966 | +{ | |
2967 | + "fun": "keyPadFinalSubmit", | |
2968 | + "baseId": 1, | |
2969 | + "baseSn":"2023031402", | |
2970 | + "infos": { | |
2971 | + "commitok": "0", | |
2972 | + "keySn": "0112402128", | |
2973 | + "time": "84.5" | |
2974 | + }, | |
2975 | + "packetTag": "20" | |
2976 | +} | |
2977 | +``` | |
2978 | + | |
2979 | +#### 科目名称预设[内部使用] | |
2980 | +发送: | |
2981 | + | |
2982 | +fun: "setSubjectName" // | |
2983 | +baseId: "1"//收到的基站ID | |
2984 | +params:{} //默认空 | |
2985 | + | |
2986 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
2987 | +| --- | --- | --- | | |
2988 | +| baseId | 基站ID | 1-32 | | |
2989 | +| id | 科目id | 0:清除所有科目预设<br>1:科目1<br>2:科目2<br>3:科目3<br>4:科目4<br>5:科目5<br>6:科目6<br>7:科目7<br>8:科目8<br>9:科目9| | |
2990 | +| name | 科目名称 | 最长10字节 | | |
2991 | + | |
2992 | +清除所有预设指令样例: | |
2993 | +```json | |
2994 | +{ | |
2995 | + "fun": "setSubjectName", | |
2996 | + "baseId": 0, | |
2997 | + "baseSn":"2023031402", | |
2998 | + "params": { | |
2999 | + "id": "0", | |
3000 | + "name":"" | |
3001 | + }, | |
3002 | + "packetTag": "20" | |
3003 | +} | |
3004 | +``` | |
3005 | + | |
3006 | +预设科目1为“语文”指令样例: | |
3007 | +```json | |
3008 | +{ | |
3009 | + "fun": "setSubjectName", | |
3010 | + "baseId": 0, | |
3011 | + "baseSn":"2023031402", | |
3012 | + "params": { | |
3013 | + "id": "1", | |
3014 | + "name":"语文" | |
3015 | + }, | |
3016 | + "packetTag": "20" | |
3017 | +} | |
3018 | +``` | |
3019 | + | |
3020 | +接收: | |
3021 | + | |
3022 | +fun: "setSubjectName" // | |
3023 | +baseId: "1"//收到的基站ID | |
3024 | +infos:{"keySn": "0112402128"}//返回状态 | |
3025 | + | |
3026 | +指令样例: | |
3027 | +```json | |
3028 | +{ | |
3029 | + "fun": "setSubjectName", | |
3030 | + "baseId": 1, | |
3031 | + "baseSn":"2023031402", | |
3032 | + "infos": { | |
3033 | + "keySn": "0112402128", | |
3034 | + "state": "OK" | |
3035 | + }, | |
3036 | + "packetTag": "20" | |
3037 | +} | |
3038 | +``` | |
3039 | + | |
2791 | 3040 | #### 支持设备说明 |
2792 | 3041 | |
2793 | 3042 | | **基站+键盘** | **支持** | **备注** | |
2794 | 3043 | | --- | --- | --- | |
2795 | 3044 | | B100-2.4G+S6 | 支持 | | |
2796 | 3045 | | B200-2.4G+S6 | 支持 | | |
3046 | +| B100-2.4G+S7 | 支持 | | | |
2797 | 3047 | |
2798 | 3048 | |
2799 | 3049 | ### 填空题 |
... | ... | @@ -5608,6 +5858,70 @@ infos:{"beacon":"0", "listenIn":"0"}// |
5608 | 5858 | } |
5609 | 5859 | ``` |
5610 | 5860 | |
5861 | +#### 基站BIC码和Pid码[内部使用] | |
5862 | + | |
5863 | +读 | |
5864 | +发送: | |
5865 | +fun: "readBasicBicPid" // | |
5866 | +baseId: 1//1~32 (必须指定基站) | |
5867 | +params:{}//可不填 | |
5868 | + | |
5869 | +指令样例: | |
5870 | +```json | |
5871 | +{ | |
5872 | + "fun": "readBasicBicPid", | |
5873 | + "baseId": 1, | |
5874 | + "baseSn": "2023031402", | |
5875 | + "packetTag": "1" | |
5876 | +} | |
5877 | +``` | |
5878 | + | |
5879 | +写 | |
5880 | +发送: | |
5881 | +fun: "writeBasicBicPid" // | |
5882 | +baseId: 1 //1~32 (必须指定基站) | |
5883 | +params:{"bic":"A455", "pid": "EA10"}// | |
5884 | + | |
5885 | +| **Json字段** | **字段含义** | **赋值及含义** | | |
5886 | +| --- | --- | --- | | |
5887 | +| baseId | 基站ID | 1~32 | | |
5888 | +| bic | bic码 | A455:中天电子<br>7955:台湾网奕<br>5A55:印度K12 | | |
5889 | +| pid | pid码 | EA10:中天电子<br>B002:台湾网奕 <br>B004:印度K12 | | |
5890 | + | |
5891 | + | |
5892 | +指令样例: | |
5893 | +```json | |
5894 | +{ | |
5895 | + "fun":"writeBasicBicPid", | |
5896 | + "baseId":1, | |
5897 | + "baseSn":"2023031402", | |
5898 | + "params": { | |
5899 | + "bic": "A455", | |
5900 | + "pid": "EA10" | |
5901 | + }, | |
5902 | + "packetTag":"1" | |
5903 | +} | |
5904 | +``` | |
5905 | + | |
5906 | +返回 | |
5907 | +接收: | |
5908 | +fun: "basicBicPid" | |
5909 | +baseId: 1//基站ID | |
5910 | +infos:{"bic":"A455", "pid": "EA10"}// | |
5911 | + | |
5912 | +指令样例: | |
5913 | +```json | |
5914 | +{ | |
5915 | + "fun": "basicBicPid", | |
5916 | + "baseId": 1, | |
5917 | + "baseSn": "2023031402", | |
5918 | + "infos": { | |
5919 | + "bic": "A455", | |
5920 | + "pid": "EA10" | |
5921 | + }, | |
5922 | + "packetTag": "1" | |
5923 | +} | |
5924 | +``` | |
5611 | 5925 | |
5612 | 5926 | ### 键盘 |
5613 | 5927 | |
... | ... | @@ -6455,10 +6769,12 @@ params:{}//数组对象,字段不填则保留上次值。 |
6455 | 6769 | | **Json字段** | **字段含义** | **赋值及含义** | |
6456 | 6770 | | --- | --- | --- | |
6457 | 6771 | | keySn| 键盘Sn| 不能为空| |
6458 | -| scoreMode| 分数模式|1:清除<br>2:字符显示(默认值)<br>3:五角星显示<br>4:爱心显示[S6有效]| | |
6459 | -| scoreValue| 分数值|scoreMode == 1,此处无效. <br>scoreMode == 2,8个字符长度. <br>scoreMode == 3,0~6,2个分数表示1个五角星,最多3个. <br> scoreMode == 4,0~6,2个分数表示1个爱心,最多3个 [S6有效]| | |
6772 | +| scoreMode| 分数模式|1:清除<br>2:字符显示(默认值)<br>3:五角星显示| | |
6773 | +| scoreValue| 分数值|scoreMode == 1,此处无效. <br>scoreMode == 2,8个字符长度. <br>scoreMode == 3,0~6,2个分数表示1个五角星,最多3个. | | |
6460 | 6774 | |tipText|提示文本| 最多8个汉字(16个字符),键盘第二行显示| |
6461 | 6775 | |
6776 | +注意:scoreMode和scoreValue字段在 B200+S6和B100+S6设备中无效。 | |
6777 | + | |
6462 | 6778 | |
6463 | 6779 | 指令样例: |
6464 | 6780 | 样例目的:将SN为"1479824643"的键盘积分位置设置成"99",第二行文本位置设置成"已绑定"。 |
... | ... | @@ -7032,3 +7348,9 @@ infos:{ "funId":"F0001","code":"10002"}// |
7032 | 7348 | |F0115|写入键盘姓名| |
7033 | 7349 | |F0116|键盘关机时间等级| |
7034 | 7350 | |F0117|基础配置模式| |
7351 | +|F0118|最终提交状态| | |
7352 | +|F0119|后台签到| | |
7353 | +|F0120|键盘授权| | |
7354 | +|F0121|基站BIC码| | |
7355 | +|F0122|科目预设| | |
7356 | + | ... | ... |
通讯协议-教育新版-基站部分.md
... | ... | @@ -1871,7 +1871,33 @@ SDK向基站发送: |
1871 | 1871 | | 3 | AuthorCodeH | 授权码高字节 | |
1872 | 1872 | | 4 | AutchorCodeL | 授权码低字节 | |
1873 | 1873 | |
1874 | +### 5.2.33 读写基站BIC&PIC码 | |
1874 | 1875 | |
1876 | +==基站需保存参数到Eeprom,上电恢复。== | |
1877 | +基站原设置字符串的接口保留 ,单最终与改接口只保存2字节参数。那条指令后发 那条生效。不冲突 | |
1878 | +注意 BIC码二进制不能连续出现3个0或者三个1 。降低RF出错概率,由软件设置具体BIC和品牌码绑定记录。 | |
1879 | + | |
1880 | +电脑向基站发送: | |
1881 | + | |
1882 | +| **字节** | **标识符** | **描述** | | |
1883 | +| --- | --- | --- | | |
1884 | +| 1 | BASECMD | 0x61 基站管理类指令 | | |
1885 | +| 2 | BASEID | 指定的基站编号,为0时候不指定 | | |
1886 | +| 3 | CMDTYPE | 基站管理命令类型<br>11 通用附加配置 | | |
1887 | +| 4 | MODE | 51 读基站BIC<br>52 写基站BIC | | |
1888 | +| 5-6 | DATA | 2字节 BIC码 | | |
1889 | +| 7-10 | DATA | 4字节 PIC码 ASCII 字符串| | |
1890 | + | |
1891 | +基站应答: | |
1892 | + | |
1893 | +| **字节** | **标识符** | **描述** | | |
1894 | +| --- | --- | --- | | |
1895 | +| 1 | BASECMD | 0xE1 基站管理类指令应答 | | |
1896 | +| 2 | BASEID | 应答的基站的编号 | | |
1897 | +| 3 | CMDTYPE | 应答类型 <br>11通用附加配置 | | |
1898 | +| 4 | MODE | 51 读基站BIC<br>52 写基站BIC | | |
1899 | +| 5-6 | DATA | 2字节 BIC码 | | |
1900 | +| 7-10 | DATA | 4字节 PIC码 ASCII 字符串| | |
1875 | 1901 | |
1876 | 1902 | ## 5.3 白名单设置 |
1877 | 1903 | ... | ... |
通讯协议-教育新版-表决器部分.md
... | ... | @@ -68,7 +68,8 @@ |
68 | 68 | | 2-3 | NowT | 时标值,2字节,高位在前<br>从投票启动开始的时间,用于表决器同步计时,20ms为单位,最大约21分钟,最大0xFFFF不自动变为0 | |
69 | 69 | | 4 | DATAPOS | 表决序号(结果记录序号)<br> 1-0xFF,值发生变化的时候,代表是新的一轮表决开始<br>注意:也用作表决、评议、单选多选时候结果保存的位置,可用指令读出保存的结果 | |
70 | 70 | | 5 | MODE | 投票模式<br>低6位是表决模式:<br>1-9是政务应用 10-19商务应用和教育 20-29多项和批次 30-39二维表评测 40-50管理类<br><br>0、空闲,表决停止(含答案提示)<br> 1、签到<br> 2、表决 <br>4、评分 <br>5、判断题<br> 9、模拟测试(通讯效果)<br><br>10、单选多选<br> 11、排序 <br>12、填空 <br>13、抢答 <br>14、测验 <br>15、提交作业<br>16、语音答题<br>17、分组PK<br><br>40 对码模式<br><br> $\color{red} {高2位bit6 和 bit7 } $<br> Bit6=1,白名单基站,0是普通配对基站,由基站程序控制不可设置<br> Bit7=1表示键盘要接收多条的扩展信标(2.2.17节)内容才能启动投票(键盘改无线休眠模式到32.5ms1次以快速接收,并持续到收齐内容后改标准模式减少耗电) | |
71 | -| 6-23 | MODES | 投票参数,具体和MODE有关,不同模式下参数意义不同 | | |
71 | +| 6-22 | MODES | 投票参数,具体和MODE有关,不同模式下参数意义不同 | | |
72 | +| 23 | STATE | 低四位表示后台签到的Count序号(1-15循环),开启一轮新的后台签到则该序号变一次。Bit7 = 1 表示开启后台签到。 | | |
72 | 73 | | 24 | WCT_Pos | 低四位为当前片在WCT中的位置(0-7)以便键盘统一休眠 <br>$\color{red} {最高位 bit7 } $ <br> bit7=1, 表示有基础扩展信标,通常启动后一直在0x17信标前广播发送,直到收到停止指令,才取消发送,如果在投票模式,键盘需先确认收到过基础扩展信标后才能进入投票,避免反复过程| |
73 | 74 | | 25 | ATTRIB1 | BIT0 =0表示基站是配对基站(套装),1是自由基站(名单),这个bit位SDK不能直接修改,只能用设置基站模式修改;键盘在配对或自由选基站时候,根据此位选择基站 <br>BIT1=0 键盘不用定时监听投票信标,1启用定时监听(S61键盘有按键后才监听投票模式,这个用于控制回到标准中天模式)<br> BIT2=1键盘不关机,用于测试和生产<br> BIT4,3 控制4档键盘自动关机时间,不关机是BIT2控制<br> 00 -30秒 01-2分钟 10-10分钟 11-45分钟 <br>BIT5 =1键盘心跳打开 0关闭(要求基站同步自主控制2.3.1节里面的控制位)<br> ==BIT6—登录菜单显示允许位。1允许登录 0不允许登录== <br>BIT7—积分显示 1显示 0不显示 | |
74 | 75 | | 26 | ATTRIB2 | 基站特性2,控制考勤 <br>BIT0,1=键盘每秒发送考勤信号次数,0-3,0相当于关闭 <br>BIT2,3=00---其实还可以当他用<br>高4位是键盘发送考勤信号功率(功率写死可当他用,bit7没用) | |
... | ... | @@ -2515,7 +2516,10 @@ ACK格式: |
2515 | 2516 | |
2516 | 2517 | | **字节** | **标识符** | **描述** | |
2517 | 2518 | | --- | --- | --- | |
2518 | -| 1 | CMD | 类型<br> 1:姓名写 <br>2:姓名清 <br>3:积分字符串<br> 4:积分栏清<br> 5:积分五角星 <br>6:积分爱心显示 <br>7:测验题分数<br><br>10:第二行文本写 <br>11:第二行文本清 <br>12:第三行文本写 <br>13:第三行文本清<br>30:外设控制 LED <br>31:外设控制 BEEP <br>32:外设控制 MOTO<br><br>40:遥控关机 <br>41:遥改配对码 <br>42:键盘参数设置 - CID<br>43:键盘参数设置 - FSN<br>44:键盘授权<br><br>50:指定答题<br> 51:答题标题<br> 52:"发送中"预置 <br>53:"发送中"预置清<br> 54:"已发送"预置 <br>55:"已发送"预置清<br><br>60:订餐短消息 <br>61:恢复出厂设置<br><br>70生僻字12号字体| | |
2519 | +| 1 | CMD | 类型<br> 1:姓名写 <br>2:姓名清 <br>3:积分字符串<br> 4:积分栏清<br> 5:积分五角星 <br>6:积分爱心显示 <br>7:测验题分数<br><br>10:第二行文本写 <br>11:第二行文本清 <br>12:第三行文本写 <br>13:第三行文本清<br>30:外设控制 LED <br>31:外设控制 BEEP <br>32:外设控制 MOTO<br><br>40:遥控关机 <br>41:遥改配对码 <br>42:键盘参数设置 - CID<br>43:键盘参数设置 - FSN<br>44:键盘授权<br>45:键盘授权 登录拒绝<br>46:键盘授权 踢出授权<br>50:指定答题<br> 51:答题标题<br> 52:"发送中"预置 <br>53:"发送中"预置清<br> 54:"已发送"预置 <br>55:"已发送"预置清<br>56:"在线"预置<br>57:"在线"预置清<br>58:"离线"预置<br>59:"离线"预置清<br><br>60:订餐短消息 <br>61:恢复出厂设置<br>62 清除该类所有预置<br><br>70生僻字12号字体<br>71:"语文"预置<br>72:"数学"预置<br>73:"英语"预置<br>74:"政治"预置<br>75:"历史"预置<br>76:"地理"预置<br>77:"生物"预置<br>78:"物理"预置<br>79:"化学"预置<br>80答案补交<br>81-86:对应的文本<br>87为清除81-86预设值<br>90:测验题锁定与解锁<br> | |
2520 | + | |
2521 | + | |
2522 | +| | |
2519 | 2523 | | 1 | LEN | 长度(长度为Data长度,可为0) | |
2520 | 2524 | | N | Data | 数据详细内容 | |
2521 | 2525 | |
... | ... | @@ -2615,10 +2619,24 @@ ACK格式: |
2615 | 2619 | |
2616 | 2620 | | **字节** | **标识符** | **描述** | |
2617 | 2621 | | --- | --- | --- | |
2618 | -| 1 | CMD | 类型<br> 44:键盘授权 | | |
2622 | +| 1 | CMD | 类型<br> 44:键盘授权 登录成功| | |
2619 | 2623 | | 1 | LEN | 长度 1 | |
2620 | 2624 | | 1 | AUTHORIZE | 授权:<br>1,登录成功;<br>2,信息有误,重新登录;<br>3,失败,系统不允许;<br>4,白名单键盘重新登录;| |
2621 | 2625 | |
2626 | +#### 5.5.2.12 键盘授权 | |
2627 | + | |
2628 | +| **字节** | **标识符** | **描述** | | |
2629 | +| --- | --- | --- | | |
2630 | +| 1 | CMD | 类型<br> 45:键盘授权 登录拒绝| | |
2631 | +| 1 | LEN | 长度 1 | | |
2632 | +| 1 | | | |
2633 | +#### 5.5.2.12 键盘授权 | |
2634 | + | |
2635 | +| **字节** | **标识符** | **描述** | | |
2636 | +| --- | --- | --- | | |
2637 | +| 1 | CMD | 类型<br> 46:键盘授权 踢出授权| | |
2638 | +| 1 | LEN | 长度 1 | | |
2639 | +| 1 | | | |
2622 | 2640 | #### 5.5.2.13 指定答题 |
2623 | 2641 | |
2624 | 2642 | 正常单体的指定答题 |
... | ... | @@ -2707,6 +2725,22 @@ ACK格式: |
2707 | 2725 | | 1 | LEN | 文本字符串长度(清LEN=0) | |
2708 | 2726 | | 16 | TEXT | 最大16字节(目前键盘限制到16字节) | |
2709 | 2727 | |
2728 | +#### 5.5.2.21 测验题锁定解锁 | |
2729 | + | |
2730 | +| **字节** | **标识符** | **描述** | | |
2731 | +| --- | --- | --- | | |
2732 | +| 1 | CMD | 类型 90:测验题锁定与解锁| | |
2733 | +| 1 | LEN | 文本字符串长度(清LEN=0) | | |
2734 | +| 1 | data | 1锁定 2解锁 | | |
2735 | + | |
2736 | +#### 5.5.2.22 测验题预置标题更改 | |
2737 | + | |
2738 | +| **字节** | **标识符** | **描述** | | |
2739 | +| --- | --- | --- | | |
2740 | +| 1 | CMD | 类型<br> 62 清除该类所有预置<br>71:"语文"预置 <br>72:"数学"预置<br>73:"英语"预置<br>74:"政治"预置<br>75:"历史"预置<br>76:"地理"预置<br>77:"生物"预置<br>78:"物理"预置<br>79:"化学"预置<br>| | |
2741 | +| 1 | LEN | 文本字符串长度(清LEN=0) | | |
2742 | +| 16 | TEXT | 最大10字节(目前键盘限制到10字节) | | |
2743 | + | |
2710 | 2744 | # 六、下载多包类 |
2711 | 2745 | |
2712 | 2746 | ## 6.1 概述 | ... | ... |