Commit d6bb701f3f83d610dd78a43bd0b8b19c0c4dc673
1 parent
4bc2ecc0
修改基站登录密码为0时代表无需密码登录,修改标准测验和多科测试的题号标识设置
Showing
1 changed file
with
35 additions
and
20 deletions
通讯协议-B200W-MQTT协议[内部].md
| ... | ... | @@ -13,6 +13,7 @@ |
| 13 | 13 | background-color: yellow; |
| 14 | 14 | } |
| 15 | 15 | </style> |
| 16 | + | |
| 16 | 17 | [TOC] |
| 17 | 18 | |
| 18 | 19 | # SunVote B200W_MQTT 接口协议 |
| ... | ... | @@ -53,7 +54,7 @@ |
| 53 | 54 | |fEvtXXX|指令事件 |调用对应指令后返回| |
| 54 | 55 | |
| 55 | 56 | ## 数据格式约定 |
| 56 | -- 数据格式统一为**Json**格式,MQTT发送接收消息编码统一为**UTF-8** | |
| 57 | +- 数据格式统一为**Json**格式,发送接收消息编码统一为**UTF-8** | |
| 57 | 58 | - Json通用格式如下: |
| 58 | 59 | |
| 59 | 60 | ```json |
| ... | ... | @@ -1037,7 +1038,7 @@ |
| 1037 | 1038 | |fun|string|-|是|指令名称| |
| 1038 | 1039 | |dataTag|string|-|否|数据包标识,可为空字符串| |
| 1039 | 1040 | |data|object|-|是|传送参数的对象| |
| 1040 | -|+value|string||是|设置的基站登录密码,数字类型,为空代表无需密码登录,最长4位| | |
| 1041 | +|+value|string||是|设置的基站登录密码,数字类型,最长4位,为空或设为0代表无需密码登录| | |
| 1041 | 1042 | |
| 1042 | 1043 | - **示例代码** |
| 1043 | 1044 | ```json |
| ... | ... | @@ -1123,7 +1124,7 @@ |
| 1123 | 1124 | |fun|string|-|是|事件名称| |
| 1124 | 1125 | |dataTag|string|-|否|数据包标识,可传空字符串| |
| 1125 | 1126 | |data|object|-|是|传送参数的对象| |
| 1126 | -|+value|string||是|基站登录密码| | |
| 1127 | +|+value|string||是|基站登录密码,返回值为0代表无需密码登录| | |
| 1127 | 1128 | |
| 1128 | 1129 | - **示例代码** |
| 1129 | 1130 | ```json |
| ... | ... | @@ -1134,6 +1135,15 @@ |
| 1134 | 1135 | "value":"1234" |
| 1135 | 1136 | } |
| 1136 | 1137 | } |
| 1138 | + | |
| 1139 | +//无需密码登录 | |
| 1140 | +{ | |
| 1141 | + "fun":"fEvtBsLoginPwd", | |
| 1142 | + "dataTag":"1", | |
| 1143 | + "data":{ | |
| 1144 | + "value":"0" | |
| 1145 | + } | |
| 1146 | +} | |
| 1137 | 1147 | ``` |
| 1138 | 1148 | ##### fEvtBsLoginState |
| 1139 | 1149 | - **主题**: /basestation/\${baseSN}/receive |
| ... | ... | @@ -3084,7 +3094,7 @@ |
| 3084 | 3094 | "dataTag":"1", |
| 3085 | 3095 | "data": { |
| 3086 | 3096 | "keySn":"1479824643", |
| 3087 | - "state":"1" | |
| 3097 | + "state":"0" | |
| 3088 | 3098 | } |
| 3089 | 3099 | } |
| 3090 | 3100 | ``` |
| ... | ... | @@ -3580,11 +3590,12 @@ |
| 3580 | 3590 | |+examNo|int||是|0-9999<br>=0,新的测验<br>>0时,与上次启动卷号一致继续测验,不一致进入新的测验| |
| 3581 | 3591 | |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头| |
| 3582 | 3592 | |+questions|array||是|题目详情| |
| 3583 | -|++symbol | string||是 | 题号前缀,分级标识为-,可为空,为空表示1级大题<br><font color="red">最多为三级题号,即最多可以设为x-x-</font>| | |
| 3584 | 3593 | |++quesType | int||是| 题目类型<br>1:单选<br>2:多选(排序)<br>3:数字<br>4:判断 | |
| 3585 | 3594 | |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时 默认4;<br>范围:1-10。| |
| 3586 | -|++startNo | int||是| 起始题号 | | |
| 3587 | -|++count | int||是| 题目数量 | | |
| 3595 | +|++firstNo | int||否| 一级题号,mode=0 时有效,范围1-255,可不传字段 | | |
| 3596 | +|++secondNo | int||否| 二级题号,mode=0 时有效,范围1-255,可不传字段 | | |
| 3597 | +|++startNo | int||是| 最后一级题号起始题号<br>mode=0 时有效,范围1-255,mode=1或2时按顺序显示题号<br>说明:<br>1stNo和2stNo都未赋值时,此字段为一级题号<br>1stNo赋值,2stNo未赋值时,此字段为二级题号<br>2stNo赋值时,此字段为三级题号 | | |
| 3598 | +|++count | int||是| 题目数量, >0 | | |
| 3588 | 3599 | |+simParams|object||否|内部模拟测试参数设置对象| |
| 3589 | 3600 | |++answer|array||是|预设提交的按键值<br>格式为"单选题答案,多选题答案;<br>数字题答案;判断题答案(1对2错)"<br>如["A","ABCD","10","1"]| |
| 3590 | 3601 | |
| ... | ... | @@ -3654,23 +3665,23 @@ |
| 3654 | 3665 | "examNo": 1, |
| 3655 | 3666 | //第1-1、1-2题单选题,第2-1、2-2题多选题,第3-1题数字,第4-1题判断,共6题 |
| 3656 | 3667 | "questions": [{ |
| 3657 | - "symbol": "1-", | |
| 3668 | + "firstNo": 1, | |
| 3658 | 3669 | "quesType": 1, //单选题 |
| 3659 | 3670 | "startNo": 1, //题号从1-1开始 |
| 3660 | 3671 | "count":2 //连续2题 |
| 3661 | 3672 | },{ |
| 3662 | - "symbol": "2-", | |
| 3673 | + "firstNo": 2, | |
| 3663 | 3674 | "quesType": 2, //多选题 |
| 3664 | 3675 | "startNo": 1, //题号从2-1开始 |
| 3665 | 3676 | "count":2, //连续2题 |
| 3666 | 3677 | "option":5 |
| 3667 | 3678 | },{ |
| 3668 | - "symbol": "3-", | |
| 3679 | + "firstNo": 3, | |
| 3669 | 3680 | "quesType": 3, //数字题 |
| 3670 | 3681 | "startNo": 1, //题号从3-1开始 |
| 3671 | 3682 | "count":1 //连续1题 |
| 3672 | 3683 | },{ |
| 3673 | - "symbol": "4-", | |
| 3684 | + "firstNo": 4, | |
| 3674 | 3685 | "quesType": 4, //判断题 |
| 3675 | 3686 | "startNo": 1, //题号从4-1开始 |
| 3676 | 3687 | "count":1 //连续1题 |
| ... | ... | @@ -3692,23 +3703,27 @@ |
| 3692 | 3703 | "examNo": 1, |
| 3693 | 3704 | //第1-1-1、1-1-2题单选题,第1-2-1、1-2-2题多选题,第2-1-1题数字,第3-1-1题判断,共6题 |
| 3694 | 3705 | "questions": [{ |
| 3695 | - "symbol": "1-1-", | |
| 3706 | + "firstNo": 1, | |
| 3707 | + "secondNo": 1, | |
| 3696 | 3708 | "quesType": 1, //单选题 |
| 3697 | 3709 | "startNo": 1, //题号从1-1-1开始 |
| 3698 | 3710 | "count":2 //连续2题 |
| 3699 | 3711 | },{ |
| 3700 | - "symbol": "1-2-", | |
| 3712 | + "firstNo": 1, | |
| 3713 | + "secondNo": 2, | |
| 3701 | 3714 | "quesType": 2, //多选题 |
| 3702 | 3715 | "startNo": 1, //题号从1-2-1开始 |
| 3703 | 3716 | "count":2, //连续2题 |
| 3704 | 3717 | "option":5 |
| 3705 | 3718 | },{ |
| 3706 | - "symbol": "2-1-", | |
| 3719 | + "firstNo": 2, | |
| 3720 | + "secondNo": 1, | |
| 3707 | 3721 | "quesType": 3, //数字题 |
| 3708 | 3722 | "startNo": 1, //题号从2-1-1开始 |
| 3709 | 3723 | "count":1 //连续1题 |
| 3710 | 3724 | },{ |
| 3711 | - "symbol": "3-1-", | |
| 3725 | + "firstNo": 3, | |
| 3726 | + "secondNo": 1, | |
| 3712 | 3727 | "quesType": 4, //判断题 |
| 3713 | 3728 | "startNo": 1, //题号从3-1-1开始 |
| 3714 | 3729 | "count":1 //连续1题 |
| ... | ... | @@ -3931,10 +3946,10 @@ |
| 3931 | 3946 | |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头| |
| 3932 | 3947 | |+questions|array||是|题目详情| |
| 3933 | 3948 | |++subject | int||是 | 科目序号,1-9,对应键盘中内置的科目1-9<br>键盘答题时可选择科目切换答题| |
| 3934 | -|++symbol | string||是 | 题号前缀,分级标识为-,可为空,为空表示1级题目<br><font color="red">多科测验题目编号最多只能两级(即symbol可设置为空或x-),超出无效</font>| | |
| 3935 | 3949 | |++quesType | int||是| 题目类型<br>1:单选<br>2:多选(排序)<br>3:数字<br>4:判断 | |
| 3936 | 3950 | |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时 默认4;<br>范围:1-10。| |
| 3937 | -|++startNo | int||是| 起始题号 | | |
| 3951 | +|++firstNo | int||否| 一级题号,mode=0 时有效,范围1-255,可不传字段 | | |
| 3952 | +|++startNo | int||是| 起始题号,mode=0 时有效,范围1-255 <br>firstNo未赋值时,此字段表示一级题号<br>firstNo赋值时,此字段表示二级题号| | |
| 3938 | 3953 | |++count | int||是| 题目数量 | |
| 3939 | 3954 | |+simParams|object||否|内部模拟测试参数设置对象| |
| 3940 | 3955 | |++answer|array||是|预设提交的按键值<br>格式为"单选题答案,多选题答案;<br>数字题答案;判断题答案(1对2错)"<br>如["A","ABCD","10","1"]| |
| ... | ... | @@ -3951,14 +3966,14 @@ |
| 3951 | 3966 | "questions": [{ |
| 3952 | 3967 | "subject":1, //科目1 |
| 3953 | 3968 | //题号1-1 到1-10 共10题单选 |
| 3954 | - "symbol": "1-", | |
| 3969 | + "firstNo": 1, | |
| 3955 | 3970 | "quesType": 1, |
| 3956 | 3971 | "startNo": 1, |
| 3957 | 3972 | "count":10 |
| 3958 | 3973 | }, { |
| 3959 | 3974 | "subject":2, //科目2 |
| 3960 | 3975 | //题号2-2和2-3共两题 多选题,5个选项 |
| 3961 | - "symbol": "2-", | |
| 3976 | + "firstNo": 2, | |
| 3962 | 3977 | "quesType": 2, |
| 3963 | 3978 | "option": 5, |
| 3964 | 3979 | "startNo": 2, |
| ... | ... | @@ -3966,7 +3981,7 @@ |
| 3966 | 3981 | }, { |
| 3967 | 3982 | "subject":3, //科目3 |
| 3968 | 3983 | //题号3-1和3-2共两道数字题 |
| 3969 | - "symbol": "3-", | |
| 3984 | + "firstNo": 3, | |
| 3970 | 3985 | "quesType": 3, |
| 3971 | 3986 | "startNo": 1, |
| 3972 | 3987 | "count":2 | ... | ... |