Commit 119aeaf3bfb08b4928d32a377bfe4e829238c432

Authored by 李傲寒
1 parent 6d80349f

删除其他文件

通讯协议-教育新版-表决器部分-V0.99_32.md deleted
1   -[TOC]
2   -# 一、概述
3   -  教育新版本协议,可以认为是原有老ARS体系的子集,取消了基础信标,只有1个投票信标,然后数据提交按SN号模式有重新定义,确认包也重新定义。
4   -  基站的通讯时序,变成1个投票信标,然后等待10个周期的键盘提交数据,然后2个SN号格式的确认包,然后重新一轮。
5   -  由于新硬件平台无线最大只能32字节,配对码4字节,实际最大有效数据28字节。
6   -  采用无线射频技术的产品,通讯数据包的结构如下:
7   -| **同步码** | **长度** | **配对码** | **表决数据包** | **校验码** |
8   -| --- | --- | --- | --- | --- |
9   -配对码有4字节,用于在无线射频系统中标识哪个表决器属哪个基站。
10   -
11   -  注意:电脑通过基站向表决器发数据包时候,向基站发送的数据是不包含配对码的,基站向表决器转发时候自动加配对码;同理,基站转发表决器数据包到电脑时候,自动去掉配对码。
12   -  真正有用的数据,是表决数据包部分的数据。以下文档所涉及的数据描述,都是仅针对表决数据包讨论,不包括同步码、长度、校验码等其他字节数据。
13   -
14   -  对于表决数据包的讨论,本文档是按数据包的传输方式分类描述的,分为基站信标、上传单包、上传多包、下传单包、下传多包进行描述,便于统筹设计,另外在第七章中提供了按实现功能划分的索引表。
15   -
16   -  表决数据包,长度目前最大28字节,前面有4字节配对码,最大包长度32。
17   -
18   -  对于不是无线传输的数据,例如USB传输的基站指令,对于少于250字节的数据,打包格式是:(兼容原来老系统协议)
19   -| **引导头-3字节** | **长度-1字节** | **有效数据-N字节** | **CRC-2字节** |
20   -| --- | --- | --- | --- |
21   -|F5 AA AA|后继数据长度=N+2|命令和数据|校验值|
22   -  具体通讯协议里面,描述的是有效数据段(命令和数据)的解析。
23   -  CRC沿用CRC-16算法,不使用效验的话,先0000。
24   -
25   -  凡是超出250字节的,例如WIFI语音数据,用超长包格式打包。区别是引导头不同,和长度字节是2字节。
26   -| **引导头-3字节** | **长度-2字节** | **有效数据-N字节** | **CRC-2字节** |
27   -| --- | --- | --- | --- |
28   -|F5 AA AB|后继数据长度=N+2 高位在前|命令和数据|校验值|
29   -备注:TCP数据包每封包尽量不超过1460字节,UDP不超1472。
30   -# 二、基站信标类
31   -## ==~~2.1 基础信标(取消)~~==
32   -
33   -  ~~基础信标是基站定时发送到一个信标信号。~~
34   -
35   -  ~~基础信标用于实现表决器锁定基站、是否要特殊登录、实现授权后才能表决、投票计时等功能,同时也控制了表决系统的一些特性,例如是否允许自动关机、背光模式等等。~~
36   -
37   -  ~~键盘接收到基础信标后,如果有数据提交,可以按防冲突算法在10个时间片内向基站提交数据,并接收0x15类的应答确认,如果提交不成功,延时在下一个周期再提交。具体参考3.1节和《表决系统通讯协议-应用文档-基础原理》~~
38   -
39   -| **字节** | **标识符** | **描述** |
40   -| --- | --- | --- |
41   -| 1 | CMD | 0x10 标识 |
42   -| 2 | BADDH | 基站编号 |
43   -||||
44   -||||
45   -| 7-8 | AUTHCODE | 授权号,2字节,高位在前,0-0xFFFF =0时候不使用授权模式,表决器可以参与表决>0时候,表决器保存的授权号相同才能参与表决 |
46   -| 9 | LOGIN | 登录申请模式(后台签到模式),是否需要IC卡、登录码(用户编号、登录密码等)、用户姓名信息、学号信息,或直接授权<br>低4位是登录模式:<br>=0 无申请要求,要等待授权指令授权<br> =1 按键签到(应答同后面的签到码,用BCD码1FFFFF提交结果)<br> =2 要输入数字签到码登录(用3.4.3节签到码格式应答)<br> =3 ~~IC卡登录,要插入IC卡~~ V4.5 输入学号登陆<br> =4 输入(英文)姓名登录<br> =5 自动学号登陆(投票器设置好的学号信息)<br> =6 自动姓名登陆(投票器设置好的学号信息)<br><br>第7位=1的时候,表示是动态编号模式,表决器需要先用硬件序列号登陆,重新分配键盘编号(例如教育应用大学模式)|
47   -| 10 | REPORT +LANGUAGE | 表决器报告状态模式<br> Bit0待机中报告 Bit1投票中报告 (Bit2开关机报告暂不实现)时间间隔暂时为10秒间隔<br>但如果是投票中报告,如果开始表决后5秒内没按键,就提前报告状态<br>高4位值,控制键盘使用的语言(V4.75):<br>0是用户自己选择,>1则指定语言,具体什么语言由键盘程序决定,一般1是中文,2是英文 |
48   -| 11 | OFFTIME | 自动关机时间<br>0xFF不关机 0使用硬件缺省其他:按分钟为单位关机 |
49   -| 12 | ATTRIB | 表决器特性:背光模式+蜂鸣器模式<br> Bit0,1是背光模式 0关背光 1按键点亮,延时关 2结果提交成功后延时灭,否则一直保持亮,直到表决停止 3一直亮 <br>Bit2是蜂鸣器模式 1开 0关 <br>Bit3 自动提交模式 1延时自动提交 0要按提交键或OK键提交(对政务版本的表决、评议模式有效,或商务的单选多选有效)<br>Bit4 振动反馈控制 1开0关|
50   -||||
51   -||||
52   -||||
53   -
54   -## 2.2 投票模式信标
55   -
56   -
57   -&emsp;&emsp;投票模式信标主要是作为基站取表决器数据的指令或信标。
58   -
59   -&emsp;&emsp;投票模式信标决定了表决开始、停止,以及投票模式和参数,例如单选多选还是数字题目。
60   -
61   -&emsp;&emsp;新版投票信标在老体系信标上增加了4字节在末尾,来传递原来基础信标里面的一些特性。
62   -
63   -### 2.2.1 取包信标概述
64   -
65   -| **字节** | **标识符** | **描述** |
66   -| --- | --- | --- |
67   -| 1 | GETCMD | 应答模式(组呼、竞争式) <br>0x17 新版本教育协议投票信标,全4字节SN号操作<br>键盘用0x93类或者0x94类指令提交数据,基站0x18、0x19做确认 |
68   -| 2-3 | NowT | 时标值,2字节,高位在前<br>从投票启动开始的时间,用于表决器同步计时,20ms为单位,最大约21分钟,最大0xFFFF不自动变为0 |
69   -| 4 | DATAPOS | 表决序号(结果记录序号)<br> 1-0xFF,值发生变化的时候,代表是新的一轮表决开始<br>注意:也用作表决、评议、单选多选时候结果保存的位置,可用指令读出保存的结果 |
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有关,不同模式下参数意义不同 |
72   -| 24 | WCT_Pos | 低四位为当前片在WCT中的位置(0-7)以便键盘统一休眠 |
73   -| 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   -| 26 | ATTRIB2 | 基站特性2,控制考勤 <br>BIT0,1=键盘每秒发送考勤信号次数,0-3,0相当于关闭 <br>BIT2,3=00---其实还可以当他用<br>高4位是键盘发送考勤信号功率(功率写死可当他用,bit7没用) |
75   -| 27 | ATTRIB3 | 基站特性3—基站主频点,用于键盘不跟踪到副频点 |
76   -| ~~28~~ | ~~ATTRIB4~~ | ~~基站特性~~ 4(被CRC占用) |
77   -| 28 | CRC | 效验值CRC16值的低位字节,注意键盘提交数据是2字节 CRC16从GETCMD到第27字节的ATTRIB3<br>注意:对WIFI体系或者5.8GTDMA体系,这里开始是2.2.18节扩展信标的内容,效验值CRC位置另外确定 |
78   -||||
79   -
80   -注意:
81   -
82   -1. DATAPOS在1-255之间变化,只要是新一轮表决,就由电脑控制变化一次,例如1变为2,2变为3,只要变化,就表示是新的一轮表决开始,例如1直接变为255也是可以的。
83   -2. 但目前DATAPOS也是保存单次表决结果的指定位置,即高可靠系统,会把表决结果按DATAPOS指定的位置保存到FLASH中。
84   -
85   -&emsp;&emsp;不同的表决模式MODE下,后继的表决参数MODES字节含义不同,现在分别讨论不同模式下的参数含义。
86   -
87   -### 2.2.2 空闲模式
88   -
89   -&emsp;&emsp;空闲模式,就表示表决停止了。
90   -
91   -| **字节** | **标识符** | **描述** |
92   -| --- | --- | --- |
93   -| 5 | MODE | =0,表示表决已经停止 |
94   -| 6 | MSGTYPE | 附加信息类型<br>0 无,纯停止指令<br> 1 对错判断 <br>2投票结果显示(政务体系)<br> 3停止答题(高思定制—先停止,然后公布答案,然后才是停止)(有些键盘模式3也是对错判断)<br> ==4 停止带自定义信息,第8字节开始是16字符串信息== <br>9 唤醒键盘(高思,确实是9)<br>6 T2 5.8G是唤醒键盘 |
95   -| 7-9 | HHMMSS | 基站时间 时:分:秒(暂时不改)<br>用于键盘实时时钟更新,000000键盘不处理<br>==备注:在MSGTYPE=3模式下,第7字节是前面投票模式== |
96   -| 10 | REPMODE | 状态报告(键盘状态监控)间隔模式<br>1- 不报告<br>2- 空闲时候报告<br>3- 答题时候报告<br>4- 全时报告|
97   -| 11 | REPTIME | 状态报告间隔,单位0.5s |
98   -| 12 | KEYREP | 低4位,即时反馈模式<br>0- 不启用<br>1- 通用键码,不显示<br>2- 字母模式,带等级名称显示,最大5等级<br>3- 数字模式,带等级名称显示<br>4-菜单模式,按菜单选择反馈内容<br><br>高4位,等级类别,前面模式2、3时候有效<br>0-内部固定等级1<br>1-内部固定等级2<br>2-用户自定义1,最大5等级(需要提前下载到键盘)
99   -| 13 | KEYMAX | 即时反馈最大有效按键<br>例如4,那么ABCD按键可按 |
100   -| 14 | ATTRIB_EX1 | Bit0-1 语言选择 ~~00中文 01英文~~<br> 00 默认,按键盘设置 01中文 02英文 |
101   -| ..24 |||
102   -<br>
103   -
104   -| **字节** | **标识符** | **描述** |
105   -| --- | --- | --- |
106   -| 5 | MODE | =0,表示表决已经停止 |
107   -| 6 | MSGTYPE | 附加信息类型<br>1 对错提示 |
108   -| 7 | TIP | 对错提示模式<br> 0 不显示对错和答案<br> 1 仅显示对错(投票器自己判断)<br>2 显示对错和答案 |
109   -| 8 | ANSTYPE | 正确答案格式,可参考对应模式的应答数据格式<br>由于有对错判断功能的,一般需要显示正确答案,最终都要字符串比较,所以暂仅实现按字符串格式的<br>3 字符串,最多16字节,0提前结束(表决评议等级对应数字字符"1"-"0",单选多选排序都用"A"-"Z",多选要按"A"到"Z"的顺序重新排列,数字题用数字字符) |
110   -| 9-24 | ANSMSG | 正确答案,最多16字节 |
111   -
112   -### 2.2.3 签到模式
113   -
114   -&emsp;&emsp;签到模式用于现场确定到会人数,在使用申请签到的模式下,可用指令控制签到所要输入的信息,例如要使用IC卡签到,输入用户信息等。
115   -
116   -| **字节** | **标识符** | **描述** |
117   -| --- | --- | --- |
118   -| 5 | MODE | =1,签到模式 |
119   -| 6 | MODE1 | 1 按键签到模式,用于清点人数,不能签到到人<br>2 User-ID、签到码签到(输入数字,用户号或密码)<br> ~~3 签到带SN号信息~~ <br>3、UID签到,带 ~~时间~~ 、电压值、序列号<br>(2、3、4统一为UID签到,返回带UID和电压值) |
120   -| 7 | MODE2 | 0 不允许修改,首次按键有效<br>1 允许修改,末次按键有效 |
121   -| 8 | KEYC | >0等于指定按键签到 |
122   -| 9-24 | 。。。 | 参数值没有意义 |
123   -
124   -### 2.2.4 表决模式
125   -
126   -表决模式这里是指单项表决,对一个议题表达观点和态度,选择"赞成、反对、弃权"等。
127   -
128   -| **字节** | **标识符** | **描述** |
129   -| --- | --- | --- |
130   -| 5 | MODE | =2,表决模式 |
131   -| 6 | MODE1 |1&emsp;3键表决模式,中文版本是赞成/反对/弃权,英文版本是Yes/No/Abstain<br>2&emsp;2键表决模式,中文版本是赞成/反对,英文版本是Yes/No
132   -| 7 | MODE2 | 0 不允许修改,首次按键有效<br>1 允许修改,末次按键有效|
133   -| 8 | MODE3 | 保密模式N<br>0 不保密 1显示保密,按键提示后,延时取消按键提示<br>其他具体和产品型号有关 |
134   -||||
135   -
136   -
137   -### 2.2.5 判断题模式
138   -
139   -| **字节** | **标识符** | **描述** |
140   -| --- | --- | --- |
141   -| 5 | MODE | =5,判断题模式 |
142   -| 6 | MODE1 | 1 True/False 对/错<br>2 Yes/No 是/否<br>3 √/×<br>4 错题本,学生输入自己是否答对 |
143   -| 7 | MODE2 | 0 不允许修改,首次按键有效<br>1 允许修改,末次按键有效 |
144   -| 8 | MODE3 | 保密模式,具体和产品型号有关<br>0 不保密 1显示保密,按键提示后,延时取消按键提示 |
145   -| 9-11 || 空,用于大小题号和单选多选对齐 |
146   -| 12 | NO1 | 大题号,0不显示,用于兼容以前键盘 |
147   -| 13 | NO2 | 小题号,0不显示<br>用于键盘显示类似"单选题 1-3" |
148   -| 14-24 | 。。。 | 参数值没有意义 |
149   -
150   -### 2.2.6 数字模式
151   -
152   -| **字节** | **标识符** | **描述** |
153   -| --- | --- | --- |
154   -| 5 | MODE | =4,单项评分 |
155   -| 6 | MODE1 | 评分模式<br>0 自由输入,不限定规则,最多输入14位(7字节BCD码),小数点算1位<br>1-8 原先商务体系保持兼容<br><br>9 极域-分组输入,0-99,参数模式和模式2相同(注意极域S62在ID模式下是用字符串提交的,SN模式下还是BCD)<br>20 带上下限 的数字题|
156   -| 7 | MODE2 | 0 不允许修改,提交后不能修改<br>1 允许修改,提交后可以修改 |
157   -| 8 | MODE3 | 保密模式,具体和产品型号有关<br>0 不保密 1显示保密 |
158   -| 9-11 || 空,用于大小题号和单选多选对齐 |
159   -| 12 | NO1 | 大题号,0不显示,用于兼容以前键盘 |
160   -| 13 | NO2 | 小题号,0不显示<br>用于键盘显示类似"单选题 1-3" |
161   -| 14-15 | 上限 | 0-655.35 精度0.01 |
162   -| 16-17 | 下限 | 0-655.35 精度0.01 |
163   -| 18 | 小数点位数 | 0 没有小数点 1 一位小数点 2 二位小数点 |
164   -| 19-24 | 。。。 | 参数值没有意义 |
165   -<br>
166   -<br>
167   -K1版本,带上下限的时候,不支持大小题号:
168   -
169   -| **字节** | **标识符** | **描述** |
170   -| --- | --- | --- |
171   -| 5 | MODE | =4,单项评分 |
172   -| 6 | MODE1 | 评分模式,K1版本<br>10 带规则,控制上下限,位数,最大16位输入,显示"数字题"<br>11 同上,但显示"请评分" |
173   -| 7 | NUMLIKE | 低4位控制小数位数,F不限定位数,0不能有小数(输入整数)<br>高4位控制整数位数,F不限定,0表示只能输入小数 |
174   -| 8 || 空 |
175   -| 9-16 | MAX | 8字节BCD码格式的上限例如FFFFFFFFFFFF1234表示1234 |
176   -| 17-24 | MIN | 8字节BCD码格式的下限 |
177   -
178   -### 2.2.7 模拟测试
179   -
180   -模拟测试用于测试系统。可了解表决器状态或模拟进行投票测试,而不需要太多人员参与。
181   -
182   -| **字节** | **标识符** | **描述** |
183   -| --- | --- | --- |
184   -| 5 | MODE | =9,模拟测试 |
185   -| 6 | MODE1 | 模拟模式 <br>1 报告状态,用状态报告指令报告相关状态,键盘显示大ID和SN,用于生产排查,使用3.2.5节SN号+ID 号的状态报告提交结果<br>(远距离考勤防冲突测试,MODE2值是1秒发多少次,MODE3是发送多少秒就停止。这样,老批量速度测试软件就可评估)<br> 2 三键表决模拟,1号赞成,2号反对,3号弃权,4号赞成,5号反对。。。依次类推 <br>3报告状态, ~~但带~~~~ SN号信息(同模式1,放这里只是表示也支持模式3)~~,键盘显示姓名和SN号,使用3.2.3节SN+ID+字符串格式提交结果,如果要支持16字符姓名,使用3.2.5状态报告里面的姓名模式 <br>4远距离考勤测试,MODE2值是1秒发多少次,MODE3是射频功率等级,用于研发内部测试批量键盘通过校门的效果<br>5 WIFI数据传输测试(用模拟的语音数据测试,3.2.10节) |
186   -| 7 | MODE2 | 启动后,多少秒内随机模拟按下按键,0=马上<br>Mode1=5时,是WIFI测试方法,暂0,数据传输测试 |
187   -| 8 | MODE3 | 提交成功后,多少秒内再重新提交,模拟修改按键,0=不测试|
188   -| 9-24 | 。。。 | 参数值没有意义 |
189   -
190   -### 2.2.8 单选多选模式
191   -
192   -单选多选主要用于商务应用,对选择题进行选择。
193   -
194   -| **字节** | **标识符** | **描述** |
195   -| --- | --- | --- |
196   -| 5 | MODE | =10,单选多选带计时模式 |
197   -| 6 | MODE1 | 选项编号类型,对带液晶的表决器有用<br>1&emsp;显示字母ABCD。。。<br> 2&emsp;显示数字1234。。。 <br>3&emsp;多选自动测试<br> 4&emsp;简单选举,最多10人,显示按ABCD,结果也用多选格式提交(极域需求) <br>5&emsp;同4,但显示按数字,0代表10(极域需求)<br> 6&emsp;自动10次按键提交 <br>7&emsp;自动10次按键提交,但用字符串格式<br>8&emsp;网龙模式,单选显示投票题(单项),多选显示投票题(不定项)<br>9&emsp;科大讯飞定制,10单选题,Mode5是题目数,Mode6是最大选项,一般是4<br>10&emsp;科大讯飞定制,10个判断题,Mode5是题目数<br>30&emsp;可设置键盘回复的自动测试 |
198   -| 7 | MODE2 | 0 不允许修改,提交后不能修改<br>1 允许修改,提交后可以修改 |
199   -| 8 | MODE3 | 保密模式,具体和产品型号有关<br>0 不保密 1显示保密 |
200   -| 9 | MODE4 | 迫选模式<br>0 不迫选,但限选MODE6个项目数<br>1 迫选,必须选出足够的项目数MODE6 <br>2 允许单个选项选多次,例如"BAAC",但最多也只能MODE6项<br>3 允许单个选项选多次而且迫选,用于多空填空 |
201   -| 10 | MODE5 | 最大可供选择项目数,最大值为10 |
202   -| 11 | MODE6 | 可选出数目,最小值是1,最大值不超出MODE5 |
203   -| 12 | NO1 | 大题号,0不显示,用于兼容以前键盘 |
204   -| 13 | NO2 | 小题号,0不显示用于键盘显示类似"单选题 1-3" |
205   -| 14 | NO_MODE | 题号显示模式 0按1<br>1-XX-YY,XX表示大题,YY表示小题,XX及YY均为自然数字<br>2-为XXXX,X为自然数字<br>3-为X(YY),X表示大题,Y表示小题,X为中文,Y为自然数字 |
206   -| 15 | MODE7 | ==MODE1\==30有效 1按数字解析 2按字母解析 0默认== |
207   -| 16-23 | BCDVALUE | ==MODE1\==30有效 键盘需要发送的结果值 结果值,8字节BCD码表示的值==,高位在前,F表示结束字符,最多16位数,E是小数点,D是空格,C是负号 <br>2、单值结果一般就第一个BCD值有效,例如1FFFFFFF表示1,SDK用"1"表示<br>3、表示数字时候, E表示小数点,例如 1234E5FFFF 表示"1234.5" <br>4、表示单选多选排序的时候,0表示第10个选项,例如 01 32 FF FF 就是"JACB"|
208   -| 24 | 。。。 | 参数值没有意义 |
209   -
210   -### 2.2.9 排序模式
211   -
212   -排序主要用于商务应用和教育应用,结果是按用户选择的顺序输出的。
213   -排序题可以实现连线题类型,因为只要左边选项确定,输入右边连线选项的顺序即可。
214   -
215   -| **字节** | **标识符** | **描述** |
216   -| --- | --- | --- |
217   -| 5 | MODE | =11,排序模式 |
218   -| 6 | MODE1 | 选项编号类型,对带液晶的表决器有用<br>1 显示字母ABCD。。。 2显示数字1234。。。 |
219   -| 7 | MODE2 | 0 不允许修改,提交后不能修改<br>1 允许修改,提交后可以修改 |
220   -| 8 | MODE3 | 保密模式,暂不支持<br>0 不保密 1显示保密 |
221   -| 9 | MODE4 | 迫选模式<br>0 不迫选,但限选MODE6个项目数<br>1 迫选,必须选出足够的项目数MODE6 <br>2 允许单个选项选多次,例如"BAAC",但最多也只能MODE6项<br>3允许单个选项选多次而且迫选,用于多空填空 |
222   -| 10 | MODE5 | 最大可供选择项目数,最大值为10 |
223   -| 11 | MODE6 | 可选出数目,最小值是1,最大值不超出MODE2 |
224   -| 12 | NO1 | 大题号,0不显示,用于兼容以前键盘 |
225   -| 13 | NO2 | 小题号,0不显示<br>用于键盘显示类似"单选题 1-3" |
226   -| 14-24 | 。。。 | 参数值没有意义 |
227   -
228   -### 2.2.10 填空模式
229   -
230   -填空模式用于商务应用,输入一系列的数字或英文字符。
231   -
232   -| **字节** | **标识符** | **描述** |
233   -| --- | --- | --- |
234   -| 5 | MODE | =12,填空模式 |
235   -| 6 | MODE1 | 填空类型<br>1 任意输入<br>2 选项填空,ABCD输入<br>3 数字填空,输入数字<br>4 填空自动测试|
236   -| 7 | MODE2 | 0 不允许修改,提交后不能修改<br>1 允许修改,提交后可以修改 |
237   -| 8 | MODE3 | 保密模式,具体和产品型号有关<br>0 不保密 1显示保密 |
238   -| 9-11 || 空,用于大小题号和单选多选对齐 |
239   -| 12 | NO1 | 大题号,0不显示,用于兼容以前键盘 |
240   -| 13 | NO2 | 小题号,0不显示<br>用于键盘显示类似"单选题 1-3" |
241   -| 10-24 | 。。。 | 参数值没有意义 |
242   -
243   -### 2.2.11 对码模式
244   -
245   -&emsp;&emsp;对码模式表示基站在对码状态,用于表决器快速对码。表决器手动切换进入对码状态后,自动寻找在对码状态的基站,然后自动完成对码。
246   -
247   -| **字节** | **标识符** | **描述** |
248   -| --- | --- | --- |
249   -| 5 | MODE | =40,对码模式 |
250   -| 6 | MODE1 | 0 普通配对模式 <br>1 快速配对模式1(==S60支持快速配对即可==)<br> 2 快速配对模式2(不公开,生产多套同时配对用)参见后面快速配对原理 |
251   -| 7 | CHAN | 配对后基站的真实频点,SDK不能改写,写0<br>但基站会自动取频点值,然后键盘自动锁到真实频点 |
252   -| 8,9 | ID | 0 只配对,不写键盘编号<br>其他值>0:<br> a、对键盘来说,键盘编号自动改写到这个号 <br>b、对SDK而言,是编号开始值,只需要写一次<br>c、对基站而言,编号成功一个键盘,ID自动加1 |
253   -| 10 | PWD_EN | 1 键盘需要核对密码正确后才能配对(由键盘自己判断密码) |
254   -| 11-13 | PWD | 3字节密码,用数字,例如 01 02 03 表示密码123<br>空填0xFF,比如01 02 FF 表示密码12 |
255   -| 14-24 | 。。。 | 参数值没有意义 |
256   -
257   -快速配对原理:
258   -进入快速配对模式的基站,在频点0发送快速配对指令,键盘开机按特殊按键进入快速配对模式,例如M52按.按键开机,就先进入频点0一秒钟,如果这一秒能收到快速配对指令就直接配对和编号了。由于固定频点,省略了扫描时间,也减少了扫描错过的概率,所以能快速配对。基站在原有频点也一样发配对信息,以兼容老配对模式,和配对后键盘能锁频,但2个频点发送间隔根据实际测试效果配置。
259   -
260   -### 2.2.12 抢答和游戏模式
261   -
262   -抢答特指按特定的按键进行抢答,如果是要求直接提交答案的,用单选功能实现。
263   -
264   -用3.2.1节统一BCD码格式提交结果
265   -
266   -| **字节** | **标识符** | **描述** |
267   -| --- | --- | --- |
268   -| 5 | MODE | =13,抢答模式或按键游戏模式 |
269   -| 6 | MODE1 | 0 普通抢答模式 <br>1 按键游戏 <br>2 抢红包 <br>3 带键值抢答(网奕自由按键模式),键值放BCD码第一字节(例如0F到9F代表数字0-9,0x10代表数字10,0x19代表19)<br>4 拔河游戏<br>5 自定义名称游艺<br>6 抢答测试—速度测试,按模式0或2自动模拟按键提交<br>7 按键游戏自动测试模式(KEYS是1秒几个按键,SENDRULE是总共发送多少个按键)|
270   -| 7 | KEYS | 按键模式,<br>低4位有效按键数<br>0- 所有按键有效<br>1- 特定用OK按键抢红包(青果键盘)<br>N- 键码多少内的按键有效,例如4表示1-4按键有效<br>高4位按键显示模式(针对模式2)<br>0- 单选字母<br>1- 单选数字<br>2- 多选字母<br>3- 多选数字<br>4- 判断题|
271   -| 8 | SENDRULE | 低4位是去重规则 <br>0- 常规,提交最后1个按键 <br>1- 去重,提交时间间隔内只提交1次 <br>2- 计数,提交按键次数(数字值格式),例如拔河<br>最高bit是否允许修改<br>1=允许 0 不允许 |
272   -| 9 | SENDTIME | 提交时间间隔,单位0.5秒<br>备注:这个参数可能没有意义,键盘都要做成上次提交成功后到当前时间,未提交的按键次数或者最后按键 |
273   -| 10-24 | GAMENAME | MODE1=5时候是游戏名称,15字符<br>其他模式没有意义<br>MODE1=0时,字节[10]是指定按键抢答:<br>>0指定按键抢答,0等于默认。<br>(1、2、3、4、5、6、7、8、9、0、up、down、ok、esc、voice) |
274   -
275   -青果打怪模式:Mode1取4拔河模式,Keys取1,SENDRULE取2计数模式,键盘按SENDTIME间隔设置ResultState=1提交数据,结果格式按数值格式,而且按按键总次数提交,不清零。
276   -
277   -MODE1=1的按键游戏模式,说明如下:
278   -
279   -键盘用A区和B区的方式,用排序(支持多个连续按键)的格式,例如3.2.11节,但首字母是A区或B区,然后剩余的15个字母是按键序列,当A区满了,用B区传输,B区满了,再用A区传送,不停循环,达到传输连续按键序列的目的。但每次传输的值,并不是新按键,而是包含前面按键的,SDK或应用程序要判断,减去上次收到的按键,才能知道哪些是新按键。
280   -
281   -例如(按3.2.11节结果8BCD可以提交15个按键,如果是3.2.1节是13个)
282   -
283   -第1次返回:AABC 表示现在是A区信息,按键是ABC
284   -
285   -第2次返回:AABCAAA 按键是ABCAAA,但新按键是AAA
286   -
287   -第3次返回:AABCAAABBBCCCDDD 新按键是BBBCCCDDD,这时候已经是15个按键,准备启用B区发送
288   -
289   -第4次返回:BCC 是B区信息,新按键是CC
290   -
291   -第5次返回:BCCAAB 新按键是AAB
292   -
293   -第6次返回:BCCAABCDEFABCDEF 新按键是CDEFABCDEF,这时候B区15按键已满,准备A区发送
294   -
295   -第7次返回:AAC 新按键是AC
296   -
297   -第8次返回:AAC 无新按键,这次数据是键盘通讯重发引起的
298   -
299   -总结:
300   -
301   -对键盘而言,有两个区保存结果,A写满了才用B区,但后台提交,要注意A没送成功,B有还有的情况
302   -
303   -### 2.2.13 测验模式(含多题小测)
304   -
305   -这里的测验特指异步测验模式,每个学生可选择不同的答题进度。
306   -
307   -具体参数是否有用,要根据测验的实现细节,和投票器型号有关。
308   -
309   -| **字节** | **标识符** | **描述** |
310   -| --- | --- | --- |
311   -| 4 | DATAPOS | DATAPOS和以前的不同,都表示进入测验模式,投票器可以自动进入测验 |
312   -| 5 | MODE | =14,异步测验模式 |
313   -| 6 | MODE1 | 测验模式(新版只使用每道题传结果的提交结果模式)<br>0 测验停止,不能再答题<br>1,2 均不指定题型 <br>4 指定题型-30题,单选多选 <br>5 多题(16题,可指定单选多选排序判断数字)<br> 6 多题带题型,32题,不带单选多选固定选项数目 <br>7 多题模式 衡水定制 <br>8多题模式 网奕定制 <br>9 小测,16题,可指定单选多选排序判断数字(K1) <br>10 简单分段模式,8段,每段内题型一样(K1) <br>11 自动提交测试<br>12 小测,64题,单选多选判断数字,不含选项数<br><br>20 带200题型控制的测验进行中(见2.2.13-1说明)<br>21 测验停止,下发200题答案,含得分(见2.2.13-2说明)<br>22 带题干内容的测验进行中 |
314   -| 7 | ~~REPORT~~ | ~~汇报答题进度吗<br>1 汇报,切换题目后,用状态报告指令报告现在的题号<br>0不汇报~~ |
315   -| 8 | TESTNUM | 题目数目,1-100 |
316   -| ~~9-16~~ | ~~TESTNAME~~ | ~~测验名称,8字符~~ |
317   -| 17-24 | 。。。 | 参数值没有意义 |
318   -
319   -特殊地,当使用指定题型模式时候,下列参数解析如下:
320   -
321   -| **字节** | **标识符** | **描述** |
322   -| --- | --- | --- |
323   -| 6 | MODE1 | 测验模式<br>4 指定题型,最多30道题,可指定单选多选,选项数最多8|
324   -| 7 | REPORT | 汇报答题进度吗<br>1 汇报,切换题目后,用状态报告指令报告现在的题号<br>0不汇报 |
325   -| 8 | TESTNUM | 题目数目,1-30 注意,最多30 |
326   -| 9-23 | QTYPES | 15字节的题型数据,每4bit对应一个题目<br>从低4位开始,即第9字节的低4位对应第1题,高4位第2题,第10字节的低4位是第3题。。。<br>每4bit定义如下:<br>bit0是单选多选,=0单选,=1多选<br>Bit1-bit3是选项数目,0=选项数1,1=选项数2,…,7=选项数8 |
327   -| 24 | 。。。 | 参数值没有意义 |
328   -
329   -多题模式5,下列参数解析如下:
330   -
331   -| **字节** | **标识符** | **描述** |
332   -| --- | --- | --- |
333   -| 6 | MODE1 | 测验模式<br>5多题模式,最多16道题,可指定单选多选数字,选项数最多8(每题可指定选项数目) |
334   -| 7 | REPORT | 汇报答题进度吗<br>1 汇报,切换题目后,用状态报告指令报告现在的题号<br>0不汇报 |
335   -| 8 | TESTNUM | 题目数目,1-16 注意,最多16 |
336   -| 9-24 | QTYPES | 16字节的题型数据,每字节对应一个题目<br>低4位是题目类型,0单选,1多选 ~~(排序)~~ ,2数字,3判断,4排序<br>高4位是单选多选排序时候的选项数目,例如4是4选项 |
337   -||||
338   -
339   -多题模式6,下列参数解析如下:
340   -
341   -| **字节** | **标识符** | **描述** |
342   -| --- | --- | --- |
343   -| 6 | MODE1 | 测验模式<br>6多题模式,最多32道题,不指定单选多选选项数(颂大客户)|
344   -| 7 | REPORT | 汇报答题进度吗<br>1 汇报,切换题目后,用状态报告指令报告现在的题号<br>0 不汇报 |
345   -| 8 | TESTNUM | 题目数目,1-32 注意,最多32 |
346   -| 9-24 | QTYPES | 16字节的题型数据,每字节对应一个题目<br>低4位和高4位是题目类型,0单选,1多选 ~~(排序)~~ ,2数字,3判断,4排序,5填空(不能输入),6解答(不能输入) |
347   -
348   -多题模式7 衡水定制 略
349   -
350   -多题模式8 网奕定制 略
351   -
352   -小测模式9,下列参数解析如下:(对应K1小测题)
353   -
354   -| **字节** | **标识符** | **描述** |
355   -| --- | --- | --- |
356   -| 6 | MODE1 | 测验模式<br>9 小测模式,类似模式5,最多16道题,可指定题型,选项数最多8,每题可指定选项数目 |
357   -| 7 | MODE2 | 输入模式<br>0 常规测验题多排输入<br>1 速答模式,可以一行输入,中间逗号分开,例如A,B,<br>2 单字符连续输入,只支持单选,例如AABC |
358   -| 8 | TESTNUM | 题目数目,1-16 注意,最多16<br>高思模式下可以32 |
359   -| 9-24 | QTYPES | 16字节的题型数据,每字节对应一个题目<br>低4位是题目类型,1单选,2多选(排序),3数字,4判断,5语音,(6自由输入),<br>高4位是单选多选排序时候的选项数目,例如4是4选项 |
360   -
361   -分段模式10,下列参数解析如下:(对应K1小测题)
362   -
363   -| **字节** | **标识符** | **描述** |
364   -| --- | --- | --- |
365   -| 6 | MODE1 | 测验模式<br>10 简单分段模式,题号最多8分段,可指定题型,每段题型一样,但每段最多15道题目,也不能指定单选多选选项数目 |
366   -| 7 | MODE2 | 题号显示模式<br>0 数字<br>1 大小题号 |
367   -| 8 | ~~TESTNUM~~ | ~~题目数目~~ (键盘不处理,按9-24的分段数据计算总题目数) |
368   -| 9-24 | QTYPES | 16字节的题型数据,每字节对应一段题目数目和类型,00是空<br>低4位是题目类型,0不显示(主观题),1单选,2多选(排序),3数字,4判断,(5自由输入)<br>高4位是这个分段的题目数量,例如10是10题目,最大15题目,0表示空 |
369   -
370   -备注: 每个分段的开始题号,靠键盘自己计算
371   -
372   -自动提交测试模式11,下列参数解析如下:
373   -
374   -| **字节** | **标识符** | **描述** |
375   -| --- | --- | --- |
376   -| 6 | MODE1 | 测验模式<br>11 自动提交测试模式,自动填答案A-J<br>用于测试测验是否存在少交和错误答案情况 |
377   -| 7 || 空,不处理 |
378   -| 8 | TESTNUM | 题目数目,1-100 |
379   -| 9-24 |||
380   -
381   -小测模式12,类似模式9,下列参数解析如下
382   -
383   -| **字节** | **标识符** | **描述** |
384   -| --- | --- | --- |
385   -| 6 | MODE1 | 测验模式<br>12小测模式,类似模式9,最多64道题,可指定题型,不指定选项数 |
386   -| 7 | MODE2 | 输入模式<br>0 常规测验题多排输入<br>1 速答模式,可以一行输入,中间逗号分开,例如A,B,<br>2 单字符连续输入,只支持单选,例如AABC |
387   -| 8 | TESTNUM | 题目数目,1-64 注意,最多64 |
388   -| 9-24 | QTYPES | 16字节的题型数据,每字节对应4个题目的题型控制,单选多选选项数固定4或者6,不同产品定义可能不同<br>每2个bit位是题目类型,0单选,1多选(排序),2判断,3数字<br>例如0xE4=0b11100100 表示 第1题单选,第2题多选,第3题判断,第4题数字 |
389   -
390   -### 2.2.13-1 带200题型控制
391   -
392   -测验模式20是用于支持200题目的题型控制,键盘收到的指令格式如下:
393   -
394   -| **字节** | **标识符** | **描述** |
395   -| --- | --- | --- |
396   -| 5 | MODE | =14,异步测验模式 |
397   -| 6 | MODE1 | 测验模式<br>=20 带200题型控制的测验进行中 |
398   -| 7-8 | EXAMNO | 测验编号,高字节在前<br>用于键盘取对应EXAMNO的题型数据进行考试<br>(题号显示模式、测验名称等都在数据表中)<br>可以暂为0,或不判断,只支持1个测试题型数据 |
399   -| 9-24 || 空 |
400   -
401   -**SDK 启动带 200 题型控制的流程如下:**
402   -
403   -1. SDK先把题型数据写入到基站,参考基站协议2.3节指令;数据里面关键信息带测验编号EXAMNO和格式,和题型数据;
404   -2. SDK执行写投票信标指令,里面MODE=14,MODE1=20,和EXAMNO值
405   -3. 基站不会马上发投票信标,而是根据14和20知道是带题型控制信息的,开始用2.4节的广播信息信标,而且依次广播不同的题型信息片段,大约5秒钟,理论上所有投票器都能收齐;这时候不发投票信标,广播信息信标发5个时序,留5个时序接收数据,然后发确认信标;
406   -4. 键盘到唤醒周期,监听基站信标,听到是广播信息信标,停止无线休眠,持续接收,接收到哪个数据片段就保存,并判断是否全部收齐(投票器根据DATAPOS和EXAMNO判断)
407   -5. 投票器如果收齐了题型数据,自动按题型数据来启动测验输入,里面含题号格式、考试名称、题型数据;具体怎么显示、怎么控制输入都根据数据表来具体确定,这里是一个总的控制指令,不含过多信息;
408   -6. 基站广播一段时间的题型数据后,例如5秒后,停止发广播信息信标,发投票信标,就是上面表格投票信标,表示测验进行中;这时候已经恢复正常的接收键盘数据的流程;
409   -7. 如果有投票器是迟开机的,收到投票信标,取EXAMNO值和自己的比较,发现没有对应的测验题型数据,按3.2.6节键盘请求进行申请重新播报。
410   -8. 基站收到申请播报,就重新执行步骤3和步骤6一次,保证新键盘可靠收到题型数据
411   -
412   -具体的题型数据格式,见2.4.1节。
413   -
414   -### 2.2.13-2 200题答案含得分下发
415   -
416   -停止测验需要下载得分、键盘对错判断时候,启动这个指令如下:
417   -
418   -| **字节** | **标识符** | **描述** |
419   -| --- | --- | --- |
420   -| 4 | DATAPOS | DATAPOS和以前的不同,进入测验模式 |
421   -| 5 | MODE | =14,异步测验模式 |
422   -| 6 | MODE1 | 测验模式<br>=30带200题型答案和得分下发中 |
423   -| 7-8 | EXAMNO | 测验编号,高字节在前<br>用于键盘取对应EXAMNO的题型数据进行考试<br>(题号显示模式、测验名称等都在数据表中) |
424   -| 9 | MODE2 | 答案和得分的组合模式<br>0 纯答案不包含得分<br>1 纯得分不含答案<br>2 答案+得分<br>基站根据这个模式,来控制广播什么数据,如果是模式2,先广播答案,然后再广播得分,这点基站要特殊处理 |
425   -| 10-24 || 空 |
426   -
427   -SDK停止测验并下发答案流程如下:
428   -
429   -1. SDK先把答案数据写入到基站,参考基站协议2.3节指令;这个步骤,可以写完题型数据之后,就写答案数据,即先把答案下载到基站准备好;也可以收卷的时候执行,但建议提前执行;
430   -2. SDK执行写投票信标指令,里面MODE=14,MODE1=30,和EXAMNO值
431   -3. 基站判断是14、30指令后,启动答案下发和得分下发流程,用用2.4节的广播信息信标,广播对应EXAMNO的答案数据;这个广播周期,不需要再插入读键盘结果的周期,可全部用于广播答案信息;如果需要下载得分,还需要广播得分。发送完毕,停止发广播信息信标,发投票信标内容,就是上面表格投票信标,等软件调用退出这个模式,回到空闲模式,退出考试;
432   -4. 键盘收到答案下发指令,就退出无线休眠状态,持续接收,并保存收到的答案,判断是否收齐所有答案,收齐后自动评改, ~~显示对错、得分~~ ;也就是说,所有评改投票器自己编程完成对错题判断,但得分由电脑软件指定
433   -
434   -具体答案数据包格式,见2.4.2节。
435   -
436   -### 2.2.13-3 带题干内容测验(含离线答题模式)
437   -
438   -测验模式22是用于支持20题目的带题干内容的测验,键盘收到的指令格式如下:
439   -
440   -| **字节** | **标识符** | **描述** |
441   -| --- | --- | --- |
442   -| 4 | DATAPOS | DATAPOS和以前的不同,进入测验模式 |
443   -| 5 | MODE | =14,异步测验模式 |
444   -| 6 | MODE1 | 测验模式<br>=22 带题干内容的的测验进行中<br>=23 带题干内容的离线答题题目下载<br>=24 离线题目答案提交<br>=25 不带题干的离线200题型数据下载 |
445   -| 7-8 | EXAMNO | 测验编号,高字节在前<br>用于键盘取对应EXAMNO的题型数据进行考试<br>(题号显示模式、测验名称等都在数据表中)<br>可以暂为0,或不判断,只支持1个测试题型数据 |
446   -| 9-24 || 空 |
447   -
448   -&emsp;&emsp;Mode=22时候,题干内容的下载方案,见6.6节透传多包。前期也可用原来的200题型方案(2.4节广播信息信标)。
449   -
450   -&emsp;&emsp;Mode=23时候,题干内容下载同Mode22,但加上如果键盘下载成功,用3.2.6节报告,这样sdk能知道键盘下载成功,确保可靠下载。
451   -
452   -&emsp;&emsp;Mode=24时候,用户已经离线完成了Mode23的答案,在这个环节,用单题提交答案的方式,一个一个提交答案,同时可以满足Mode23和Mode25。
453   -
454   -&emsp;&emsp;Mode=25是针对离线200题型的下载。
455   -
456   -### 2.2.14 作业模式
457   -
458   -作业模式,特指收取作业结果。即学生已经完成电子作业,老师在课堂上统一接收。
459   -
460   -也可以用于收取特定的数据结果,例如离线调查结果。
461   -
462   -| **字节** | **标识符** | **描述** |
463   -| --- | --- | --- |
464   -| 5 | MODE | =15,提交作业结果模式 |
465   -| 6 | MODE1 | 提交模式。<br>对于教育应用,是否指定作业名称接收<br>1 不指定,学生随便可选1个作业提交(先实现这种模式)<br>2 ~~指定名称,无对应名称作业时,学生可选择另一个提交~~ <br>3 指定科目编号提交(1-9)<br> 4 自动测试,课后练习单题提交结果<br>5 指定科目、日期,进入后台接收模式,允许键盘提交数据<br>6 指定科目、日期,进入作业接收增量模式<br>7 模式5、6的自动测试|
466   -| 7-14 | HOMEWK | ~~作业名称,8字符,用于确定是收哪个作业~~ <br>如果是指定编号,首字节是科目编号<br>自动测试模式4下,首字节是科目编号 |
467   -| 15-24 | 。。。 | 参数值没有意义 |
468   -
469   -&emsp;&emsp;提交作业流程:基站先用上述指令进入收作业模式,然后键盘使用3.2.7节多包申请提交发包申请,然后SDK再用4.1类开始多包接收进行接收具体作业结果。
470   -
471   -在Mode1=5,6时候,格式细节如下:
472   -
473   -| **字节** | **标识符** | **描述** |
474   -| --- | --- | --- |
475   -| 5 | MODE | =15,提交作业结果模式 |
476   -| 6 | MODE1 | 提交模式。<br>5 指定科目、日期,进入后台接收模式,允许键盘提交数据<br>6 指定科目、日期,进入作业接收增量模式<br>7 模式5、6的自动测试 |
477   -| 7-8 | HWK1 | 第1字节,高4位是科目编号1-9,低4位是月份,第1字节00表示后面空,这里科目月份合一是为了适应以后可能>4科目的需求第2字节,是日期 |
478   -| 9-24 | HWK2-9 | 其他8科,每科2字节,第1字节00表示后面没有了 |
479   -||||
480   -
481   -### 2.2.15 语音答题模式
482   -
483   -语音答题,答题器可以录音上传,可上传多个。
484   -
485   -| **字节** | **标识符** | **描述** |
486   -| --- | --- | --- |
487   -| 5 | MODE | =16,语音答题 |
488   -| 6 | MODE1 |0,正常录音模式<br>1,自动录音测试<br>2,语音红包模式,键盘提示有区别,SDK有连续语音数据流输出<br>3,数据信道传输测试,按语音包格式,数据长度FMODE决定,而且数据有规律,测试软件可以容易判断是否有丢包现象和错误数据<br>4,语音质量测试|
489   -| 7 | TIME | 录音限时,单位秒,0不限时 |
490   -| 8 | NUM | 是否允许多个录音 0,只能1个,>1可以多少个 |
491   -| 9 | ALERT | 剩余多少秒开始提醒,0 不提醒 |
492   -| 10 | FMODE | 录音格式,暂0<br>0 缺省格式,中天内部标准选定以下一种 <br>1 A率压缩,8K采样,8bit数据 <br>2 PCM格式不压缩,8K采样,16bit数据 <br>3 A率压缩,16K采样,8bit数据 <br>4 PCM格式不压缩,16K采样,16bit <br>5 A率压缩,32K采样,8bit数据 <br>6 SPEEX压缩,8K采样率<br>7 SPEEX压缩,16K采样率 |
493   -| 11 | OK_STATUS | 0 正常流程<br>1 强制流程 录音过后按OK键提交录音结束语句,使用心跳提交 |
494   -| 12-13 | VOLUME | 语音质量测试时候有效<br>2字节,录音信号幅度值下限,大于才ok |
495   -| 14-15 | NOISE | 语音质量测试时候有效<br>2字节,录音信号底噪上限,小于才ok |
496   -| 12-24 | 。。。 | 参数值没有意义 |
497   -
498   -### 2.2.16 拍照图片传输
499   -
500   -| **字节** | **标识符** | **描述** |
501   -| --- | --- | --- |
502   -| 5 | MODE | =17,拍照传输 |
503   -| 6 | MODE1 | 0 60路同时传输模式<br>1 先拍先传模式(适合单个传输) |
504   -| 7 | MODE2 | 0是手动。大于0,自动拍照间隔,用于自动测试 |
505   -| 8 | MODE3 | 拍照次数 0xFF一直自动拍照 |
506   -| 9 | MODE4 | 压缩等级,1-100,0表示使用缺省值 |
507   -| -24 | 。。。 | 参数值没有意义 |
508   -
509   -~~2.2.16 分组PK模式(待细化)~~
510   -
511   -~~分组~~ PK开始,每组可以不同题目,每组人员可以答组内不同题目。
512   -
513   -~~暂针对~~ WIFI系统,由于参数比较长,大于RF的24字节,是使用WIFI系统长指令包格式打包。如果是RF系统,使用2.4节发信息信标实现。
514   -
515   -| **字节** | **标识符** | **描述** |
516   -| --- | --- | --- |
517   -| 5 | MODE | =17,分组PK |
518   -| 6 || 允许参加的组别,bit位控制,1=允许参加,0不参加|
519   -| 7-14 |||
520   -| 15-24 | 。。。 | 参数值没有意义 |
521   -
522   -### 2.2.17 扩展信标(高思、新东方)
523   -
524   -&emsp;&emsp;【高思 T1\_WIFI版本】需求上,要求每一个题型都可以自定义6个汉字的题型显示,要求多题控制题型满足到30题目,所以投票信标28字节放不下。考虑到是wifi平台,走的是tcpip或者udp,协议包长度可以加长,所以,可以在2.2.1节的投票信标第28字节后面,附加新的信息。(wifi平台SDK是软基站,所以暂无对应的基站设置指令)
525   -
526   -&emsp;&emsp;也就是具体命令包开头,F5 AA AA LEN中的LEN长度,要根据实际的做调整,加大。
527   -
528   -| **字节** | **标识符** | **描述** |
529   -| --- | --- | --- |
530   -| 1 | GETCMD | ~~0x31 表示附加信标信息~~ <br>注意,高思wifi版本,这个位置其实是第29字节 |
531   -| 2 | ATTRIB3 | 特性控制3。这里,bit=1表示开或者允许,0表示关<br>Bit0 开机震动<br>Bit1 刷卡震动<br>Bit2 答题开始震动<br>Bit3 开机蜂鸣<br>Bit4 刷卡蜂鸣<br>Bit5 答题蜂鸣<br>Bit6 指示灯开关<br>Bit7 心跳信号开关 |
532   -| 3 | ATTRIB4 | 预留,特性4。bit=1表示开或者允许,0表示关<br>Bit0 全程麦克风使能|
533   -| 4-15 | TITLE | 自定义12字节的题型名称,6个汉字,如果不是00开头,键盘就显示这个题型,例如多选时候可以显示"不定项多选"<br>00开头,表示没有用自定义,还是显示标准题型提示,例如"多选" |
534   -| 16-31 | QTYPES | (高思小测使用小测模式9)<br>这里对应17到32题的16字节的题型数据,每字节对应一个题目低4位是题目类型,1单选,2多选(排序),3数字,4判断,5语音,(6自由输入),<br>高4位是单选多选排序时候的选项数目,例如4是4选项 |
535   -
536   -#### 2.2.17-1 自定义题型名称
537   -
538   -【新东方模式】,要求自定义题型名称,8汉字。考虑到通用性,设计如下:
539   -
540   -| **字节** | **标识符** | **描述** |
541   -| --- | --- | --- |
542   -| 1 | GETCMD | 0x33 表示扩展投票信标信息(0x31和0x32做基站广播信息信标了) |
543   -| 2 | INFOTYPE | 信息类型 <br>1= 自定义题型名称 <br>~~2可能是题型控制…~~ |
544   -| 3 | ~~NULL~~ INFOBITS | ~~暂0,备用,\>0可能是组呼用的组号,0表示竞争式~~ <br>8bit,对应INFOTYPE=1-8,bit=1表示键盘这次投票用到这个类型的信息,键盘要收齐才能启动投票界面 |
545   -| 4 | DATAPOS | 用于键盘判断,内部保存的自定义名称是否是这次投票的<br>不是,不用显示。键盘开机先置0。 |
546   -| 5-24 | TITLE | 自定义20字节的题型名称,10个汉字,例如多选时候可以显示"不定项多选" 。具体支持多少汉字显示看键盘类型。 |
547   -| 25-27 || 第27字节写基站主频点(解决自定义题型有些键盘锁频不稳) |
548   -| 28 | CRC ||
549   -
550   -&emsp;&emsp;基站一般情况下,不广播这个信标,如果启用了自定义题型名称(SDK执行了写扩展信标指令《基站2.4节写扩展信标》,而且DATAPOS相同---SDK写DATAPOS的时候是下次投票的DATAPOS),启动投票后, ~~就和~~~~ 0x17信标交替广播,就是1次0x33,1次0x17,都是1问10答,SN模式下各32.5ms,停止投票后又恢复只有0x17信标广播。~~(在增加指定键盘答题后修改成)基站在0x17信标前先发送所有的0x33信标(如果有多条,例如同时启用自定义标题和指定答题器,那就有2条0x33,但INFOTYPE不同),然后发0x17,然后等键盘数据,然后发确认,然后再发0x33,重复,直到停止答题,停止答题后恢复只有0x17的信标。
551   -
552   -&emsp;&emsp;键盘端处理0x33指令,按INFOTYPE位置先保存信息,不休眠继续听无线指令即可。为可靠判断投票是否带0x33扩展信息和收齐,键盘可以加上投票启动时候无线不休眠300ms,300ms后如果有0x33那基本都收齐了,然后启动正式投票输入流程。如果有0x33信息,要判断DATAPOS是否相同,不同,表示不是这次的信息不用处理。
553   -
554   -#### 2.2.17-2 指定键盘答题
555   -
556   -用SN号指定某些答题器参与投票:
557   -
558   -| **字节** | **标识符** | **描述** |
559   -| --- | --- | --- |
560   -| 1 | GETCMD | 0x33 表示扩展投票信标信息 |
561   -| 2 | INFOTYPE | 信息类型2=指定键盘SN答题 |
562   -| 3 | NULL | 暂0 |
563   -| 4 | DATAPOS | 用于键盘判断,内部保存的自定义名称是否是这次投票的&emsp;&emsp;不是,不用显示。键盘开机先置0。 |
564   -| 5-8 | SN1 | 可投票的键盘1的SN,高位在前 |
565   -| 9-12 | SN2 | 第2个SN,全0表示空 |
566   -| 13-16 | SN3 | 第3个SN,全0表示空 |
567   -| 17-20 | SN4 | 第4个SN,全0表示空 |
568   -| 21-24 | SN5 | 第5个SN,全0表示空 |
569   -| 25-27 || 空 |
570   -| 28 | CRC ||
571   -
572   -### 2.2.18 手写单题
573   -
574   -数据的提交格式,参考《语音TDMA协议设计V0.7》,用0x97包提交。
575   -
576   -| **字节** | **标识符** | **描述** |
577   -| --- | --- | --- |
578   -| 5 | MODE | =18,手写答题 |
579   -| 6 | MODE1 | 参数暂无
580   - |
581   -| 7- | 。。。 | 参数值没有意义 |
582   -
583   -### 2.2.19 T2扩展信标
584   -
585   -#### 2.2.19-1 自定义标题和指定SN答题、遥控开机
586   -
587   -T2由于投票信标可以64字节,所以自定义标题和指定SN是直接放后32字节
588   -
589   -同时,0x32遥控开机,和标准版本的0x32指令冲突
590   -
591   -![](RackMultipart20230427-1-mmp6pa_html_955d7a4242d99814.png)
592   -
593   -#### 2.2.19-2提交成功后提示信息
594   -
595   -&emsp;&emsp;科大讯飞定制增加,和自定义标题一起,可修改2个提示。
596   -&emsp;&emsp;SDK通过基站协议-2.4节设置扩展信标进行设置,对应INFOTYPE是3。(实际SDK是按InfoType做的,没考虑GETCM---基站协议笔误)
597   -&emsp;&emsp;如果先设置INFOTYPE=3的内容,然后再设置0x17投票信标启动投票(并且是带0x31自定义标题内容的),就表示这次投票功能要启用0x39信标功能。这时候T2基站,投票信标发送2条各64字节,第1条是0x17(带0x31内容),然后发0x39信标,原先是2条相同的0x17。
598   -&emsp;&emsp;包括录音模式也改成发2条,原先录音只有1条0x17。
599   -
600   -| **字节** | **标识符** | **描述** |
601   -| --- | --- | --- |
602   -| 1 | GETCMD | 0x39 表示T2扩展投票信标信息 |
603   -| 2 | InfoType | 暂3 |
604   -| 3-18 | TitleSendOk | 提交成功后提示语16字符 |
605   -| 。。。 || 后期可加其他信息 |
606   -||||
607   -
608   -## 2.3 确认包信标
609   -
610   -### 2.3.1 标准确认包
611   -
612   -新版确认包,可以一次确认5个SN号键盘数据。
613   -
614   -| **字节** | **标识符** | **描述** |
615   -| --- | --- | --- |
616   -| 1 | CMD | 0x18,新版本SN号确认包的第1包 <br>0x19,新版本SN号确认包的第2包<br>(可判断时序位置,利于时钟同步) |
617   -| 2 | CMD_BITS1 | 用于通知键盘的一些控制位 ==(基站同频,无投票信标模式下才用)== <br> BIT0 =1 考勤打开 0考勤关闭 <br>BIT1=1 心跳打开 0心跳关闭<br> BIT2=1 监听基站信标,用于在线测试 0不监听信标<br>BIT4,3 控制4档键盘自动关机时间,不关机是BIT2控制<br>00 -30秒 01-2分钟 10-10分钟 11-45分钟 |
618   -| 3 | CMD_BITS2 | 备用 |
619   -| 4-7 | SN1 | 第一个SN号,高位在前<br>全00为空 |
620   -| 8 | SN1-CMD | 对第一个SN号键盘的确认状态<br>键盘据此命令做不同的提示或操作 <br>01 数据提交正确(或自由登陆OK) <br>02 数据格式不对,数据提交无效(或自由登陆失败,密码不对) <br>03 不在投票状态,数据提交无效 <br>04 没有投票权限,数据提交无效(包括不在白名单)<br>。。。<br>0xFn 表示有n个未阅读短信? |
621   -| 9-12 | SN2 | 第2个SN号,高位在前 |
622   -| 13 | SN2-CMD | 对第2个SN号键盘的确认状态<br>定义同SN1-CMD |
623   -| 14-17 | SN3 | 第3个SN号,高位在前 |
624   -| 18 | SN3-CMD | 对第3个SN号键盘的确认状态<br>定义同SN1-CMD |
625   -| 19-22 | SN4 | 第4个SN号,高位在前 |
626   -| 23 | SN4-CMD | 对第4个SN号键盘的确认状态<br>定义同SN1-CMD |
627   -| 24-27 | SN5 | 第5个SN号,高位在前 |
628   -| 28 | SN5-CMD | 对第5个SN号键盘的确认状态<br>定义同SN1-CMD |
629   -
630   -特殊地,200题型测试测试中发现,丢题是因为确认包没有CRC的情况,为保持兼容,基站在200题型时候,确认包只发4个SN,第5个SN特殊处理当CRC用:
631   -
632   -| **字节** | **标识符** | **描述** |
633   -| --- | --- | --- |
634   -| 24-26 | CRC_EN | 3字节FF,这样既可以保证没有SN相同(兼容老的协议),新版本键盘也可以知道是带CRC效验的确认包 |
635   -| 27-28 | CRC ||
636   -
637   -### 2.3.2 确认包带基站信息(白名单模式)
638   -
639   -告诉指定SN的键盘,它对应的白名单基站是在什么频点,是对3.2.4节键盘登录请求模式3的应答。一般情况下不发送,只有键盘发请求后才发送,一个时序内(例如30ms)应答。
640   -
641   -考虑到只有几个频点的白名单方案,可能同时很多键盘开机,白名单确认多些能提高速度,对指令优化如下:
642   -
643   -| **字节** | **标识符** | **描述** |
644   -| --- | --- | --- |
645   -| 1 | CMD | 0x1A,确认包带信息<br>用于指挥键盘做一些事情,信息比较多,2.3.1节没法处理了<br>可以当做类似0x30指令的另外一种格式的单包下载 |
646   -| 2 | MSGTYPE | 信息类型,也决定了后面数据的解析格式<br>2 白名单基站信息(多个键盘同时确认) |
647   -| 3 | FREQ | 基站的主频点,键盘跳到基站主频点去听命令<br>(配对码直接从包头取,原始数据包CMD前有4自己配对码) |
648   -| 4-7 | SN1 | 第1个键盘SN |
649   -| 8-11 | SN2 | 第2个键盘SN,全00或FF表示空 |
650   -| 12-15 | SN3 | 第3个键盘SN |
651   -| 16-19 | SN4 | 第4个键盘SN |
652   -| 20-23 | SN5 | 第5个键盘SN |
653   -| 24-28 | SN6 | 第6个键盘SN |
654   -
655   -拓维EA5000T双模块版本:(仅对应一个键盘)
656   -
657   -| **字节** | **标识符** | **描述** |
658   -| --- | --- | --- |
659   -| 1 | CMD | 0x1A,确认包带信息用于指挥键盘做一些事情,信息比较多,2.3.1节没法处理了<br>可以当做类似0x30指令的另外一种格式的单包下载 |
660   -| 2 | MSGTYPE | 信息类型,也决定了后面数据的解析格式<br>1 白名单基站信息 |
661   -| 3-6 | SN | 要接收指令的键盘的SN号,4字节,高位在前 |
662   -| 7 | FREQ | 基站的主频点,键盘跳到基站主频点去听命令<br>(配对码直接从包头取,原始数据包CMD前有4自己配对码) |
663   -| 8-28 || 空 |
664   -
665   -## 2.4 广播信息信标
666   -
667   -用于由基站控制,广播一段数据,这样会比SDK控制发送更快。
668   -
669   -当键盘听到这种命令,就会连续监听数据,直到收到正常的取包信标。键盘一般需要保存数据,并判断是否全部收齐,收齐后一般还根据数据包类型自动执行某些操作。
670   -
671   -| **字节** | **标识符** | **描述** |
672   -| --- | --- | --- |
673   -| 1 | CMD | 0x31 基站连续广播信息,ID模式,所有接收或指定 <br>0x32 基站连续广播信息,指定SN模式<br>0x33 (用作基站扩展信标—参见2.2.17节) |
674   -| 2-3 | KEYID | 键盘编号,高位前<br> 0000表示广播,所有键盘都接收<br>不是0000就指定ID<br>如果指定SN模式,这里可以放6字节SN键盘的高2字节,4字节SN的话填FFFF |
675   -| 4-7 | SN | 4字节SN |
676   -| 8 | DCMD | 低4位,数据包类型—键盘根据类型选择保存位置和处理方式<br> 1 多题题型数据<br> 2多题答案数据<br> 3 得分表数据<br> 4 短信息下发<br> ==高4位作为datapos用,基站自动增加== ,1-15,用于键盘判断是否是新数据还是上次数据重播 |
677   -| 9 | TSLOT | 时序信息,用于键盘判断是否能提交数据,有基站自动控制<br>高4位,代表广播信标占用几个时序,1起,例如5的话,表示广播信息用了5个时序,那么只剩下10-5=5个时序键盘可以提交数据低4位,表示这个数据包是第几个时序,1起,利于键盘跟踪同步 |
678   -| 10 | SLOTMAX | 下发数据包共多少包数据,1起,每包16字节<br>(最大255,255x16= ==4080字节==) |
679   -| 11 | SLOTN | 第多少包数据 |
680   -| 12-27 | DATA | 这个包的16字节数据 |
681   -| 28 | CRC | 校验值CRC16值的低位字节,从第1到第27字节<br>(不能超出28字节,加4字节配对码就到2401最大的32字节) |
682   -
683   -以下描述的是广播的数据包的总的格式,最终是用上述指令,切成每片16字节数据来广播:
684   -
685   -### 2.4.1多题题型格式
686   -
687   -注意,有多种格式,键盘根据格式号具体处理,长度也不一样。
688   -对于题型数据,具体数据格式受FORMAT控制,一般EXAMNO位置不变。
689   -格式2,多个分段,每段里面小题题型可以单独设置,测验名称16中文字符
690   -注意下面字节编号,对应物理地址都要减1!
691   -
692   -| **字节** | **标识符** | **描述** |
693   -| --- | --- | --- |
694   -| 1 | TYPE | 数据包类型<br>1 测验题题型数据 |
695   -| 2 | FORMAT | 数据包格式<br>2 格式2,下面所有数据都是格式2的结构 |
696   -| 3 | PACKLEN | 数据包数据量,以16字节为1单位,(最大255x16=4080字节数据),有些可以固定<br>例如16,表示共256字节 |
697   -| 4-5 | EXAMNO | 测验编号,高位在前 |
698   -| 6 | ITEMNO\_M | 题号显示模式,(大题和后面分段一个概念)<br>1-XX-YY,XX表示大题,YY表示小题,XX及YY均为自然数字<br>2-为XXXX,X为自然数字<br>3-为X(YY),X表示大题,Y表示小题,X为中文,Y为自然数字 |
699   -| 7 | SECTIONS | 分段数目,最多16 |
700   -| 8 | TOTAL | 题目总数,最大200,可以输入的题目<br>不包含有题号但不能输入的题目,例如主观题,SDK要计算 |
701   -| 9 | SELMAX | 单选多选最大选项数目,小于4的默认4,最大10 |
702   -| 。。。 || 空 |
703   -| 17-48 | EXAMNAME | 32字节的测验名称 |
704   -||| **(以下是 2 字节为一段的分段信息,共 32 字节,空填 00 )** |
705   -| 49 | SECTION_NO1 | 第1段显示段号码,也就是支持第一段显示段号二 |
706   -| 50 | NUM1 | 第1段题目数,一定要准确,键盘要根据来取题型和显示小题号 |
707   -| 51-52 || 第2段的段号和题目数 |
708   -| 。。。 |||
709   -| 79-80 | SECTION16 | 第16段的段号和题目数,如果有16段 |
710   -||| **(以下开始是**** 1 ****字节代表的每题的题型)** |
711   -| 81 | TYPE1 | 第一段题目1的题型类型<br>0不能输入(主观题),1单选,2多选(排序),3数字,4判断,(5自由输入)6 语音 7 手写<br>(如果要每题还控制选型数目,高4位做,暂统一SLEMAX控制) |
712   -| 82 | TYPE2 | 第一段题目2的题型类型 |
713   -| 。。。 |||
714   -| 280 || 第200题的题型,如果有200题的话 |
715   -| -288 || 凑满16字节 |
716   -
717   -(下面是K1版本的格式1)
718   -格式1,分段题型,段内题型一致,选择题可设定最大项目数:
719   -
720   -| **字节** | **标识符** | **描述** |
721   -| --- | --- | --- |
722   -| 1 | TYPE | 数据包类型<br>1 测验题题型数据 |
723   -| 2 | FORMAT | 数据包格式<br>1 格式1,下面所有数据都是格式1的结构 |
724   -| 3 | PACKLEN | 数据包数据量,以16字节为1单位,(最大255x16=4080字节数据)<br>例如16,表示共256字节 |
725   -| 4-5 | EXAMNO | 测验编号,高位在前 |
726   -| 6 | ITEMNO\_M | 题号显示模式<br>0 数字<br>1 大小题号 |
727   -| 7-8 || 空 |
728   -| 9-24 | EXAMNAME | 16字节的测验名称 |
729   -||| (以下是4字节为一段的测验题题型) |
730   -| 25 | NUM | 第一段题目数 |
731   -| 26 | TYPE | 第一段题目类型<br>0不显示(主观题),1单选,2多选(排序),3数字,4判断,(5自由输入)6 语音 7 手写 |
732   -| 27 | SELMAX | 题目类型是单选多选时候是选项数,0的时候不限定<br>选择题项目数,一般是4 |
733   -| 28 | STARTNO | 空,0。>0可作为开始题号,但事实上可以不用 |
734   -| 29-32 || 4字节第二段题型数据 |
735   -||| 第3段题型数据… |
736   -|| 。。。 | 一直到PACKLENx16位置,空的填00 |
737   -||||
738   -
739   -### 2.4.2 答案下发格式
740   -
741   -第一个版本,每道题16字节字符串答案。
742   -注意:判断要根据题型,是主观题的不判断不显示
743   -
744   -| **字节** | **标识符** | **描述** |
745   -| --- | --- | --- |
746   -| 1 | TYPE | 数据包类型2 <br>测验题答案 |
747   -| 2 | FORMAT | 数据包格式<br>1 格式1字符串答案,下面所有数据都是格式1的结构 |
748   -| 3 | PACKLEN | 数据包数据量,以16字节为1单位,从第1字节起<br>例如16,表示共256字节 |
749   -| 4-5 | EXAMNO | 测验编号,高位在前<br>对应题型数据的EXAMNO |
750   -| 6 | EXAMNUM | 题目总数 |
751   -| 7-16 || 空 |
752   -||| (以下是16字节一个题目答案数据) |
753   -| 17-32 | ANSOK1 | 第1题题目正确答案,字符串编码 |
754   -| 33-48 | ANSOK2 | 16字节,第2题题目的分数和正确答案 |
755   -| 。。。 | ANSOK3 | 16字节,第3题题目的分数和正确答案 |
756   -| 。。。 || 。。。 |
757   -
758   -### 2.4.3 得分下发格式
759   -
760   -这个模式主要的广播所有键盘的得分,来取代单包下载模式(可能速度慢)
761   -键盘在信标表里面找自己对应的SN的得分,然后显示。
762   -
763   -| **字节** | **标识符** | **描述** |
764   -| --- | --- | --- |
765   -| 1 | TYPE | 数据包类型<br>3 键盘得分表,通过SN或者ID来控制 |
766   -| 2 | FORMAT | 数据包格式<br>1 格式1,下面所有数据都是格式1的结构 |
767   -| 3 | PACKLEN | 数据包数据量,以16字节为1单位,从第1字节起<br>例如16,表示共256字节 |
768   -| 4-5 | EXAMNO | 测验编号,高位在前<br>对应题型数据的EXAMNO |
769   -| 6 | KEYPADNUM | 键盘个数 |
770   -| 7-8 || 空 |
771   -||| (以下是8字节一个键盘得分数据,6字节SN,1字节得分) |
772   -| 9-16 || 8字节,第1个键盘的SN和得分<br>前6字节是SN号,教育体系前2字节FFFF<br>第7字节是得分<br>第8字节是小数得分(暂不用) |
773   -| 17-24 || 8字节,第2个键盘的SN和得分 |
774   -| 25-32 || 8字节,第3个键盘的SN和得分 |
775   -| 。。。 || 。。。 |
776   -||||
777   -
778   -### 2.4.4乐教乐学-多题题型格式
779   -
780   -乐教乐学定制要求3级题号,要求最多999题目,支持填空和自判题
781   -对于题型数据,具体数据格式受FORMAT控制,一般EXAMNO位置不变。
782   -注意下面字节编号,对应物理地址都要减1!
783   -
784   -| **字节** | **标识符** | **描述** |
785   -| --- | --- | --- |
786   -| 1 | TYPE | 数据包类型<br>1 测验题题型数据 |
787   -| 2 | FORMAT | 数据包格式<br>3 格式3,乐教乐学专用 |
788   -| 3 | PACKLEN | 数据包数据量,以16字节为1单位,(最大255x16=4080字节数据),有些可以固定<br>例如16,表示共256字节 |
789   -| 4-5 | EXAMNO | 测验编号,高位在前 |
790   -| 6-7 | TOTAL | 题目总数,高位前,最多999|
791   -| 8 | SELMAX | 单选多选缺省选项数目,一般是4,最大10 |
792   -| 9 | QUES_MODE | 题号显示类型,1-3 4(带上限设置数字题类型) |
793   -| 10-16 || 备用 |
794   -||| **(以下是 4 字节为为 1 题的题型信息, 100 题目就是400 字节)** |
795   -| 17-19 | QUES_NO1 | 3字节的题号,例如题号11-22-33的话,3字节前后就是11、22、33。0表示空,例如1-3就是1、3、0<br>(带上限数字题类型 第一字节表示题号 、第二/三字节表示上限、刻度0.01 最大655.35,下限默认为0) 超限提交 键盘自己提示"输入超限" |
796   -| 20 | TYPE1 | 第一段题目1的题型类型,低4位<br>0不能输入-跳过(主观题),1单选,2多选(排序),3数字,4判断,(5自由输入)6 语音 7 手写 8自判题-对错(乐教乐学)9 自判题-数字(输入评分)<br>高4位控制选型数目,如果是0,单选多选按前面SELMAX值<br>(带上限数字题类型 该位置不表示题型,键盘自己固定全为数字题)<br>该位置含义改为小数点位数(0 无小数点 1/2 位小数点 最多支持2位,只使用低4Bit 高4BIT预留) |
797   -| 21-24 | QUESINFO2 | 4字节,第2个题目的题型数据 |
798   -| 。。。 |||
799   -| 。。。 || 4字节,第TOTAL题的题型数据 |
800   -| 。。。 || 凑满16字节 |
801   -
802   -### 2.4.5带题干内容题型
803   -
804   -带题目文字内容的题型,数据包格式如下:
805   -
806   -| **字节** | **标识符** | **描述** |
807   -| --- | --- | --- |
808   -| 1 | TYPE | 数据包类型<br>2 带题干内容测验题题型数据 |
809   -| 2 | FORMAT | 数据包格式<br>1 格式1,以下字节顺序是对应格式1的 |
810   -| 3-4 | EXAMNO | 测验编号,高位在前 |
811   -| 5-6 | DataLEN | Data段的字节长度,从第9字节开始计算 |
812   -| 7-8 | DataCrc | Data段的CRC值,0000不判断,从第9字节开始计算 |
813   -| 9 | Data | 题型数据 |
814   -
815   -Data 段格式:
816   -
817   -| TitleNum | 题目总数量 | 1 Byte |
818   -| --- | --- | --- |
819   -| Num | 当前题号 TopicNum | 1 Byte |
820   -| NumLEN | 当前题号TitleData长度 | 2 Byte |
821   -| InputType | 答案显示类型(题型,和200题统一)<br>1:单选<br>2:多选<br>3:数值 <br>4:判断√×<br>5:填空-自由输入<br><br>以下暂不做:<br> ~~6:表决-赞成 反对~~~~ <br>7:表决-赞成 反对 弃权 <br>~~~~8:对错~~~~ <br>9:是否~~| 1 Byte |
822   -| MODE1 | 最大可供选择项目数,最大值为10 | 1 Byte |
823   -| MODE2 | 可选出数目,最小值是1,最大值不超出MODE5 | 1 Byte |
824   -| MODE3 | 预留,先0 | 1 Byte |
825   -| TitleData | 题目文本数据 | N data |
826   -
827   -TitleData 格式:纯文本\n换行 (键盘根据\N换行显示与一行显示完全换行。换行时注意英文半子)
828   -
829   -这是一个例题\n
830   -A:选项1\n
831   -B:选项2\n
832   -C:选项3\n
833   -D:选项4\n
834   -E:选项5\n
835   -
836   -TitleData最大200字节95汉字左右,则总缓存大小为:(200+7)*20 +3 = 4143字节
837   -TitleData最大150字节70汉字左右, 则总缓存大小为:(150+7)*20 +3 = 3143字节
838   -
839   -## 2.5投票附加数据 - S6新体系
840   -
841   -新体系下(需具备键盘统一周期休眠) 投票附加数据协议,具体传输方式与协议如下:
842   -
843   -![](RackMultipart20230427-1-mmp6pa_html_3603e47e16cf1fee.png)
844   -
845   -在WCT周期中的第0周期发送17信标之前发送投票附加数据包 ==(周期性广播发送)==,基站根据数据内容的长度,自动切换成相应的发送包数,目前暂定缓存最大5包。并且0X34扩展信息包不需要2.5MS才发送一次,基站到达发送时刻一次性发送出去。
846   -Cmd_Data 不足32一包 后面补0
847   -
848   -==使用方式:暂时只支持一次投票只有一次附加数据。不可以在一次投票过程中有多次不同的附加数据==
849   -
850   -基站:必定MODE的BIT7位= 1,才有0x34包在WCT周期中周期性发送
851   -键盘:当MODE的BIT7位为1时,必须等待收完DATAPOS相同的0X34附加信息才开始答题。
852   -
853   -| **字节** | **标识符** | **描述** |
854   -| --- | --- | --- |
855   -| 1 | GETCMD | 0x34表示扩展投票信标信息 |
856   -| 2 | PACKMAX | 后续传输包数量 暂定此处为最大为5(最大支持五包连续,数据最大为:21+32+32+32+32 =149字节 = 基站每条指令缓存大小)指令按大小基站自动调整是发送一个包还是3个包(基站提供) |
857   -| 3-4 | CRC16 | 本包透传数据的CRC CmdData 的CRC(基站提供) |
858   -| 5 | DATAPOS | 用于键盘判断,是与那次投票绑定的数据。<br>不是,不用显示。键盘开机先置0。 |
859   -| 6-7 | NULL | 预留 |
860   -| 8-28 | Cmd_Data | 第一包21字节(SDK提供) |
861   -| 29-61 | Cmd_Data | 第二包32字节(SDK提供) |
862   -| 62-93 | Cmd_Data | 第三包32字节(SDK提供) |
863   -| 94-125 | Cmd_Data | 第四包32字节(SDK提供) |
864   -| 126-157 | Cmd_Data | 第五包32字节(SDK提供) |
865   -
866   -### 2.5.1 CMD概述
867   -
868   -| **字节** | **标识符** | **描述** |
869   -| --- | --- | --- |
870   -| 1 | CMD | 类型<br> 1:自定义题目标题 |
871   -| 1 | LEN | 长度(长度为Data长度,可为0) |
872   -| N | Data | 数据详细内容 |
873   -
874   -### 2.5.2 自定义题目标题
875   -
876   -| **字节** | **标识符** | **描述** |
877   -| --- | --- | --- |
878   -| 1 | CMD | 类型<br> 1:自定义题目标题 |
879   -| 1 | LEN | 长度: 暂定8个字 < 16字节 |
880   -| N | Data | 字符串标题数据 |
881   -
882   -# 三、上传单包类
883   -
884   -## 3.1概述
885   -
886   -&emsp;&emsp;上传单包类主要是上传简单的投票结果、状态、申请等。一般情况下,表决器如果有数据要上传,在收到基站的投票信标后,根据防冲突算法,在一定的时序里发送数据包。基站接收到完整数据包后,给出数据确认应答,让表决器知道数据已经上传,不再多次发送。
887   -&emsp;&emsp;新体系,键盘仅使用键盘SN模式提交数据,上传单包的数据格式是:
888   -
889   -| **字节** | **标识符** | **描述** |
890   -| --- | --- | --- |
891   -| 1 | ANSCMD | 0x93新体系硬件序列号提交结果0x94硬件序列号带编号提交结果(S6Plus)|
892   -| 2 | ANSTYPE | 数据包类型|
893   -| 3-28 | ANSDATA | 根据结果类型ANSTYPE的不同,有不同的数据长度和含义 |
894   -
895   -对于不同类型的数据格式,后节详细解析。
896   -
897   -基站对上传单包数据的确认应答包结构具体参考2.3节。
898   -
899   -## 3.2新版序列号结果类
900   -
901   -键盘使用硬件序列号而不是键盘编号来上传数据,这时候数据格式是:
902   -
903   -| **字节** | **标识符** | **描述** |
904   -| --- | --- | --- |
905   -| 1 | ANSCMD | 0x93新体系硬件序列号提交结果<br>0x94硬件序列号带编号提交结果(S6Plus)<br>0x94开头时候,第7、8字节是键盘编号 |
906   -| 2 | ANSTYPE | 数据包类型(根据ANSTYPE的不同,第3字节起数据格式有不同定义)<br> 0 状态<br>1 统一BCD码格式<br>2 测验中的单选多选排序类型<br>3 测验中的数字题结果类型(最多12位数)<br>4 填空和测验中的字符串<br>6 键盘主动提交,带类型<br>7 SN+ID,含电量统一BCD格式数据,按字母解码 <br>8 SN+ID,含电量统一BCD格式数据,按数字解码<br> 9 SN+ID的字符串,带电量和效验<br><br>11 登录信息<br>12键盘请求 <br>13 多包申请 <br>14 考勤定位<br>20 语音数据 |
907   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前<br>例如SN号AB120500,那么第1字节值是0xAB,第2字节0x12,依次类推 |
908   -| 7 | DATAPOS/ADDH | 功能等同投票信标中的DATAPOS,正常提交结果必须等同于当前DATAPOS,用于基站判断,是否是当次投票结果。由于新体系键盘出于省电,平常是不监听信标的,就有可能提交结果的时候,投票已经停止或者已经到下一个,这样,基站就能判断结果无效反馈给键盘<br>启动投票的时候,键盘记录DATAPOS值下来,提交结果带上,不要用信标里面的值。<br>为0表示不需要,例如遥控器<br>ANSCMD=0x94时候,本字节是键盘编号高位ADDH字节 |
909   -| 8 | SENDPOS/ ADDL | 键盘提交一次结果就变化一次,用于SDK判断,是否和上次结果一样,这样,对于重复数据,SDK就不弹出消息<br>这对遥控器操作比较有用<br>ANSCMD=0x94时候,本字节是键盘编号低位ADDL字节 |
910   -| 9 | ANSDATA | 根据结果类型ANSTYPE的不同,有不同的数据长度和含义<br>一般只到第17字节,从ANSTYPE起占用16字节 |
911   -| 10-24 |||
912   -| 23-24 | CRC16 | 2字节效验值,值高位在前,效验值计算方法,从ANSCMD开始共22字节,按CRC16算法计算效验值(见参考代码)<br>注意:3.2.3节字符串格式除外,因为占用到24字节了—所以CRC挪到27-28字节 |
913   -
914   -对于不同类型的数据格式,后节详细解析。
915   -基站对上传单包数据的确认应答包结构参见2.3节。
916   -
917   -### 3.2.1统一BCD码格式
918   -
919   -用统一的格式,来传递单值(签到、表决、评议、判断)、单选多选、排序、评分和UID签到结果。
920   -数据格式是:
921   -
922   -| **字节** | **标识符** | **描述** |
923   -| --- | --- | --- |
924   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果0x94硬件序列号带编号提交结果 |
925   -| 2 | ANSTYPE | 数据包类型<br>1 统一BCD码格式,2字节时间和7字节BCD码<br>(UID签到时候是6字节BCD,最后1字节是电压值) |
926   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
927   -| 7 | DATAPOS/ADDH | 结果对应的投票序号或者ADDH |
928   -| 8 | SENDPOS/ADDL | 键盘内部的提交数据序号或者ADDL |
929   -| 9-10 | KEYTIME | 按键时间,离投票开始的时间,2字节,高位在前,单位是20ms,最大约21分钟 |
930   -| 11-17 | BCDVALUE | 7字节BCD码表示的值,高位在前,F表示结束,最多14位数<br> E是小数点,D是空格,C是负号,A是数字0<br>1. 表示数字时候, E表示小数点,例如1234E5FFFFFF表示"1234.5"<br>2. 表示单选多选排序的时候,0表示第10个选项,例如 01 32 FF FF FFFFFF就是"JACB"<br>3. 单值结果一般就第一个BCD值有效,例如1FFFFFFFFFFFFF表示1(判断对=1 错=2 是=1 否=2)<br>4. UID签到时候,前6BCD码是用户UID数字,最多12位数字,第7字节是电压值,单位0.04V<br><br>**注意: SDK 要根据当前的投票模式,来判断数据的真正格式和含义** |
931   -| 18-28 || 无意义 |
932   -
933   -### 3.2.2 测验结果BCD码格式
934   -
935   -课堂测验时候(每道题单独送---不支持字符串),使用SN号传数据,数据格式是:
936   -
937   -| **字节** | **标识符** | **描述** |
938   -| --- | --- | --- |
939   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果<br>0x94硬件序列号带编号提交结果 |
940   -| 2 | ANSTYPE | 数据包类型<br> 2 用序列号的测验中的单选多选排序类型,1次只包含一个项目结果,长度和3.6.1节统一BCD码格式统一 <br>3 用序列号的批次数字题结果类型(最多12位数)|
941   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
942   -| 7 | DATAPOS/ADDH | 结果对应的投票序号或者ADDH |
943   -| 8 | SENDPOS/ADDL | 键盘内部的提交数据序号或者ADDL |
944   -| 9-10 | KEYTIME | 按键时间,离投票开始的时间,2字节,高位在前,单位是100ms,最大约105分钟<br>值为0表示使用电脑时间 |
945   -| 11 | ITEMNO1 | 项目序号,1字节(和老体系不一样) |
946   -| 12-17 | BCDVALUE1 | 项目结果,6字节BCD码表示的值,高位在前,F表示空字符,最多12位数<br> 2、单值结果一般就第一个BCD值有效,例如1FFFFFFF表示1,SDK用"1"表示<br>3、表示数字时候, E表示小数点,例如 1234E5FFFF 表示"1234.5" 4、表示单选多选排序的时候,0表示第10个选项,例如 01 32 FF FF 就是"JACB"<br><br>选举值可以用单值表示,例如1选择或同意,2表示取消选择或反对;评议值也可以用单值表示; |
947   -| ..24 || 空(不能使用,因为SN值结果在基站打包中仅16字节) |
948   -
949   -### 3.2.3填空和测验的字符串格式
950   -
951   -用于传递填空或测验中的字符串格式数据,数据格式是:
952   -
953   -| **字节** | **标识符** | **描述** |
954   -| --- | --- | --- |
955   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
956   -| 2 | ANSTYPE | 数据包类型<br>9字符串(带电量、效验) |
957   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
958   -| 7-8 | ID | 键盘编号,2字节,高位前 |
959   -| 9 | KEYTIME | 如果是填空,单位时间0.5s,如果是测验,单位时间1分钟<br> 注意是单字节,不是平常的双字节,最大值0xFE<br>=FF表示是单题提交课后练习结果,特殊格式 |
960   -| 10 | SLOTN或者ITEMNO | 如果是填空,高4位表示总共有多少片数据(1片16字符),0表示有1片段,低4位表示片段号码(0起),这样填空可以传 ~~256~~ 15x16字符<br>如果是测验,是题号,表示是那个题目的答案 |
961   -| 11 | VOLT | 电池电压,单位20mV |
962   -| 12-26 | STRING | 15字节字符串,ASCII码,0代表字符结束<br>注意:由于产品经理要求还是带完整电量,考虑到CRC比较重要,所以这里的字符串修改成1段只15字符,原先16字符 |
963   -| 27-28 || CRC16效验值 |
964   -
965   -相对于老格式4,把时间做成1字节,SLOT做成1字节,为CRC腾出2字节
966   -
967   -备注:测试扫描模式下,带姓名扫描时,如果用这个格式,由于基站CRC判断位置,老系统在23、24字节,导致实际只能传10字节姓名。解决方案是基站端做兼容判断,如果23、24字节crc不对,加上27、28判断,可以对所有模式,但为了降低crc误通过的风险,甚至可以只针对0x94的9模式。
968   -
969   -特殊地,KRYTIME=0xFF时候,表示是单题课后练习结果:
970   -| **字节** | **标识符** | **描述** |
971   -| --- | --- | --- |
972   -| 9 | KEYTIME | =FF表示是单题提交课后练习结果 |
973   -| 10 | SUBJECT | 科目编号 |
974   -| 11 | ITEMNO | 题号 |
975   -| 12-26 | STRING | 15字节字符串,ASCII码,0代表字符结束 |
976   -| 27-28 || CRC16效验值 |
977   -
978   -老格式如下:(注意:加上配对码后就是无线最大数据32字节了)
979   -
980   -| **字节** | **标识符** | **描述** |
981   -| --- | --- | --- |
982   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果<br>0x94硬件序列号带编号提交结果 |
983   -| 2 | ANSTYPE | 数据包类型<br>4字符串 |
984   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
985   -| 7 | DATAPOS/ADDH | 结果对应的投票序号或者ADDH |
986   -| 8 | SENDPOS/ADDL | 键盘内部的提交数据序号或者ADDL |
987   -| 9-10 | KEYTIME | 按键时间,高位在前<br>如果是填空,单位时间20ms,如果是测验,单位时间100ms |
988   -| 11 | SLOTN | 如果是填空,表示总共有多少片数据(1片16字符),一般是1,如果大于1,键盘就分片提交,1片1片提交,SDK缓存,接收完毕弹出完整信息<br>如果是测验,是题目总数,但SDK也无需判断<br>如果是分组PK,是组号,对应题目组 |
989   -| 12 | SLOT/NO| 如果是填空,表示后面16字节是第几片数据,1起<br>如果是测验,表示是第几题的数据,1起<br>如果是分组PK,这里是题目组里面的题号 |
990   -| 13-28 | STRING | 16字节字符串,ASCII码,0代表字符结束 |
991   -
992   -注意:能龙版本,手动选题型,主动提交的,有一种用16字符输入多题的(测验,但都是单选,一次输入16字符),也用这种格式提交,STRING用字符,SLOTN和SLOT暂都是0以区别正常的填空和测验
993   -
994   -### 3.2.4登录信息
995   -
996   -传递键盘的登录申请信息,包括配对、自由登陆基站。
997   -
998   -数据格式是:
999   -
1000   -| **字节** | **标识符** | **描述** |
1001   -| --- | --- | --- |
1002   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果0x94硬件序列号带编号提交结果 |
1003   -| 2 | ANSTYPE | 数据包类型<br>11 登录信息 |
1004   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1005   -| 7 | DATAPOS/ADDH | 值=0 或者ADDH |
1006   -| 8 | SENDPOS/ADDL | 键盘内部的提交数据序号或者ADDL |
1007   -| 9 | TYPE | 操作类型<br> 1 配对(用于通知基站配对成功)---基站固定系列号模式且快速配对<br> 2 登陆自由基站(用于提交基站密码登陆)---基站自由模式序列号,基站名称是密码---键盘要等待基站确认见2.3节<br>3 登录白名单模式基站(拓维大基站双模块版本,键盘在0频点请求,等待确认告知频点和配对码---基站用2.3.2节确认包应答)<br>4 CH-UID登录模式,需要基站授权 |
1008   -| 10 | HMODEL | 键盘的型号代码 |
1009   -| 11 | HVER | 键盘硬件版本 |
1010   -| 12-14 | SVER | 键盘软件版本,3字节,10进制数字 |
1011   -| 15-16 | PWD | 2字节BCD码格式的登陆密码(登陆自由基站有效)<br>例如123F代表密码123 |
1012   -| 17 || 无意义 |
1013   -
1014   -CH-UID模式下,15字节起是3字节的UID
1015   -
1016   -| **字节** | **标识符** | **描述** |
1017   -| --- | --- | --- |
1018   -| 15-17 | PWD | 3字节BCD码格式的用户UID登录,支持6位数字<br>例如123F代表123 |
1019   -| | | |
1020   -
1021   -### 3.2.5状态信息
1022   -
1023   -用于报告状态(例如正道远心跳信号),或者在线测试的时候,数据格式是:
1024   -
1025   -| **字节** | **标识符** | **描述** |
1026   -| --- | --- | --- |
1027   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果<br>0x94硬件序列号带编号提交结果 |
1028   -| 2 | ANSTYPE | 数据包类型<br>0 状态报告 |
1029   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1030   -| 7 | DATAPOS/ADDH | ADDH |
1031   -| 8 | SENDPOS/ADDL | ~~键盘内部的提交数据序号~~~~ 或者~~ADDL |
1032   -| 9 | HMODEL | 键盘的型号代码<br>特殊地,0xF0起用于报告附加信息 |
1033   -| 10 | HVER | 键盘硬件版本 |
1034   -| 11-13 | SVER | 键盘软件版本,3字节,10进制数字 |
1035   -| 14 | VOLT | 电池电压,Bit7为1表示在充电,低7位x0.04V就是电池当前电压 |
1036   -| 15 | RSSI | 键盘接收到的基站的射频信号强度<br>S61-24R1版本,在线测试时候=1,用于区分心跳和在线测试 |
1037   -| 16 | STATUS | 开关机状态,0用于兼容老系统不弹,1开机,2关机<br>(新东方泡泡要求关机也发心跳,2秒1次) |
1038   -| 17 | SendPos | 该次结果发送次数 键盘自己计数 |
1039   -| 16- | USERID | 学号,16字节,字符串格式<br>(仅用于WIFI答题器体系,包长度有变化) |
1040   -| 18-20 | NULL | 空 |
1041   -
1042   -当HMODEL=0xF0-0xFF时候,用于在线扫描报告键盘对应的其他信息,例如姓名:
1043   -
1044   -| **字节** | **标识符** | **描述** |
1045   -| --- | --- | --- |
1046   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
1047   -| 2 | ANSTYPE | 数据包类型<br>0 状态报告 |
1048   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1049   -| 7-8 | ID | 键盘编号,2字节,高位前 |
1050   -| 9 | HMODEL | 0xF0-报告姓名 |
1051   -| 10 | VOLT | 电池电压,Bit7为1表示在充电,低7位x0.04V就是电池当前电压 |
1052   -| 11-26 | USERID | 学号,16字节,字符串格式 |
1053   -| 27-28 | CRC16 | 效验值 |
1054   -
1055   -备注:基站端老版本CRC位置固定在23、24字节,要兼容,基站端CRC算法可以23、24不对的时候再判断27、28,或只针对0x94、0模式进行特殊crc判断
1056   -
1057   -备注:由于基站如果按状态报告打包处理,传输不了姓名,SDK也不好兼容,所以基站协议新增了类型29,专门打包这个需25字节的格式。
1058   -
1059   -### 3.2.6键盘请求
1060   -
1061   -提交遥控器键码、服务申请。
1062   -
1063   -数据格式是:
1064   -
1065   -| **字节** | **标识符** | **描述** |
1066   -| --- | --- | --- |
1067   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果<br>0x94硬件序列号带编号提交结果 |
1068   -| 2 | ANSTYPE | 数据包类型12键盘申请 |
1069   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1070   -| 7 | DATAPOS/ADDH | 值=0或者ADDH |
1071   -| 8 | SENDPOS/ADDL | 键盘内部的提交数据序号或者ADDL |
1072   -| 9 | REQTYPE | 请求类型<br>1 遥控器<br>2 服务请求(学生举手)<br>3 投票器键码提交<br>4 键盘申请基站重新广播数据REQ1是0或FF表示全部广播,否则用8bit表示要广播那个区,每区512字节(最大限定4080字节了)--如果广播时间短也可以简化为前、后两区?<br>5 透传多包申请重播,REQ1是8bit表示基站要广播哪个数据段,透传数据每段现在1K字节,暂最多8K字节<br>6 题干内容(或离线评测数据表)下载全部ok |
1073   -| 10 | REQ1 | 遥控器键码或服务请求代码 |
1074   -| 11 | REQ2 | 暂0 |
1075   -| 12-17 |||
1076   -
1077   -### 3.2.7多包申请
1078   -
1079   -提交家庭作业等批量数据的上传请求。
1080   -数据格式是:
1081   -
1082   -| **字节** | **标识符** | **描述** |
1083   -| --- | --- | --- |
1084   -| 1 | ANSCMD | 0x92 使用硬件序列号提交单包结果 |
1085   -| 2 | ANSTYPE | 数据包类型<br>13 多包申请 |
1086   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1087   -| 7-8 | ID | 键盘编号 |
1088   -| 9-10 | KEYTIME | 按键时间,离投票开始的时间,2字节,高位在前,单位是20ms,最大约21分钟 |
1089   -| 11 | PACKTYPE | 1 测验结果(或其他批量数据)<br>2作业结果 <br>3 发短信 <br>4 填空信息 |
1090   -| 12 | PACKID | 数据包辨别码,一般是0,不是0表示是第几个,例如第2个作业在PACKTYPE=2的时候,<br>=F0,表示后面数据是多个作业的科目信息<br>=F1,表示多个作业用1个压缩打包传输 |
1091   -| 13-14 | HWKBITS | PACKID=F0时候,这里用bit置1表示对应科目有作业提交<br>高位前,只有bit8-bit0有效,代表9科目<br>例如0001表示科目1有数据,0003表示科目1和2有数据 |
1092   -| 15-17 || 空,不超出17字节,不影响基站数据打包 |
1093   -
1094   -&emsp;&emsp;SDK再用4.1类开始多包接收进行接收具体批量结果。
1095   -
1096   -&emsp;&emsp;如果PACKTYPE=2,PACKID=F0,SDK先把bit位转成科目编号,然后一个一个科目单独对键盘进行提取,好处是可以沿用原来SDK的单独取一门作业功能。
1097   -
1098   -&emsp;&emsp;如果PACKTYPE=2,PACKID=F1,那么4.1节的取作业时候PACKID也保持F1值,表示用1个打包取作业数据,取完后再解压成单科目结果信息。
1099   -
1100   -### 3.2.8考勤定位
1101   -
1102   -&emsp;&emsp;为减少无线发射时间,满足3年使用,数据包缩短,采用新的格式,而且是没有配对码的,这样,基站判断第一个字节是特定的0xFA(0xFB。。。)字节,就知道是没有配对码的格式。新数据格式是:
1103   -
1104   -| **字节** | **标识符** | **描述** |
1105   -| --- | --- | --- |
1106   -| 1 | ANSCMD | 0xFA 考勤定位短包(不包含配对码) |
1107   -| 2-5 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1108   -| 6 | VOLT | 低7位是电池电压,单位0.04VBit7暂保留,例如防拆报警 |
1109   -||||
1110   -
1111   -(老格式,仅供参考:)
1112   -用于报告位置和时间,数据格式是:
1113   -
1114   -| **字节** | **标识符** | **描述** |
1115   -| --- | --- | --- |
1116   -| 1 | ANSCMD | 0x93 使用硬件序列号提交单包结果 |
1117   -| 2 | ANSTYPE | 数据包类型<br>14考勤定位 |
1118   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1119   -| 7 | DATAPOS | 值=0 |
1120   -| 8 | SENDPOS | 键盘内部的提交数据序号 |
1121   -| 9 | MSGTYPE | 数据格式<br>1 无位置信息,键盘数据10-17字节值00,但考勤基站会添加<br>2 带低频唤醒,有位置信息和时间信息 |
1122   -| 10 | GATE | 门号,位置号,1开始 |
1123   -| 11 | RDNO | 阅读头编号,1开始<br>1 内阅读器1号<br>5 内阅读器2号<br>6 外部阅读器1号<br>7 外部阅读器2号|
1124   -| 12 | RSSI | 可能的信号强度值 |
1125   -| 13-16 | TIME | 时、分、秒、0.01秒,10进制|
1126   -| 17 |||
1127   -
1128   -### 3.2.9键盘主动发信模式(带类型)
1129   -
1130   -用于键盘不监听基站信标,其实基站也不控制投票类型,键盘手动选择要提交的数据类型,来传递选择ABCD(单选多选排序)、判断(是否/对错)、数值的单题结果,以及多题结果(测验),仍然保持共16字节的有效数据模式(从SN算起)。
1131   -相对于3.2.1节,去掉了DATAPOS,加了类型,并附加状态报告和题号,时间参数运算方法改变。
1132   -数据格式是:
1133   -
1134   -| **字节** | **标识符** | **描述** |
1135   -| --- | --- | --- |
1136   -| 1 | ANSCMD | 0x93使用硬件序列号提交单包结果 |
1137   -| 2 | ANSTYPE | 数据包类型<br>6键盘主动发信模式 |
1138   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1139   -| 7 | SENDPOS | 键盘内部的提交数据序号,有新值提交键盘+1<br>用于SDK优化不弹出多条相同信息 |
1140   -| 8 | DATATYPE | 数据类型 决定后面的解码格式,特别是BCDVALUE值<br> 1 选择题,SDK按ABCD输出 <br>2 判断,SDK按12输出或TF都可以 <br>3 数字题,SDK按1234输出<br>4 申请 例如举手、错题等(SDK可以迟点做) |
1141   -| 9 | ITEMNO | 题号<br>平常单题是0<br>多题是>1表示题号 |
1142   -| 10-11 | KEYTIME | 按提交键后到现在的时间差,单位20ms,测验模式下100ms<br>SDK可以倒推出实际的按键时间 |
1143   -| 12 | STATUS | 状态<br>Bit 0=1弱电 |
1144   -| 13-17 | BCDVALUE | 5字节BCD码表示的值,高位在前,F表示空字符,最多10位数<br> a、表示数字时候, E表示小数点,A是\*,B是#,C是-,F是空格,例如 1234E5FFFFFF表示"1234.5"<br> b、表示单选多选排序的时候,0表示第10个选项,例如 01 32 FF FF FF就是"JACB" <br>c、单值结果一般就第一个BCD值有效,例如1FFFFFFFFFFFFF表示1(判断对=1 错=2 是=1 否=2)|
1145   -
1146   -### 3.2.10语音录音数据(WIFI版本)
1147   -
1148   -用于提交答题器录音数据。
1149   -带实际录音数据的,按超长数据格式打包,打包格式参考第一节概述,F5 AA AB开头,后面长度数据是2字节的。
1150   -数据格式是:
1151   -
1152   -| **字节** | **标识符** | **描述** |
1153   -| --- | --- | --- |
1154   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
1155   -| 2 | ANSTYPE | 数据包类型<br>20录音数据 |
1156   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1157   -| 7 | ADDH | 投票器编号高位ADDH |
1158   -| 8 | ADDL | 投票器编号低位ADDL |
1159   -| 9 | DATAPOS | 对应启动录音时候投票信标的DATAPOS,用于标识是哪次录音 |
1160   -| 10 | RECNO | 1起,第几个录音,允许多个录音的话<br>0表示录音停止,或者录音没开始,还是用长数据包格式打包-F5 AA AB开头,但长度可以缩小,可以不含语音数据VOICE |
1161   -| 11 | RTYPE | 录音数据格式,1起<br> 1 A率压缩,8K采样,8bit数据<br> 2 PCM格式不压缩,8K采样,16bit数据 <br>3 A率压缩,16K采样,8bit数据 <br>4 PCM格式不压缩,16K采样,16bit <br>5 A率压缩,32K采样,8bit数据<br>6 SPEEX压缩,8K采样率<br>7 SPEEX压缩,16K采样率 |
1162   -| 12-13 | SLOT | 录音数据片号,每片1024字节<br>0起,高位前,65536片,可65536K字节,每秒8KB可8192秒 |
1163   -| 14-15 | LEN | 实际语音数据字节数,高字节前 |
1164   -| 16--+1024 | VOICE | 语音数据,1024字节一个包,也可以缩短 |
1165   -
1166   -### 3.2.11 SN+ID,含电量统一BCD格式数据
1167   -
1168   -由于K1、T1键盘需求要求支持16位数字,要求每次结果带电量,通过基站打包分析,USB一次打包2个键盘数据的话,键盘数据最大可以26字节,原先除了字符串外统一是17字节。考虑到扩展,键盘数据长度还是先按24计算,
1169   -
1170   -| **字节** | **标识符** | **描述** |
1171   -| --- | --- | --- |
1172   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
1173   -| 2 | ANSTYPE | 数据包类型<br>7 SN+ID,含电量统一BCD格式数据,按字母ABCD解码<br>8 SN+ID,含电量统一BCD格式数据,按数字解码<br>这里带了类型,键盘提交要注意,以前是SDK根据现在的投票模式来处理,那么做带题型测验的时候,SDK还需判断题型数据,不方便,这样修改就比较容易解析数据 |
1174   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1175   -| 7-8 | ID | 表决器编号ID,高字节在前 |
1176   -| 9-10 | KEYTIME | 按键时间,离投票开始的时间,2字节,高位在前,平常单位20ms,测验时候单位是100ms,最大约105分钟<br>值为0表示使用电脑时间 |
1177   -| 11 | ITEMNO1 | 测验中的项目序号,1字节,1起<br>如果是单个投票,这里填00,或者SDK不处理<br>项目序号>0时候,SDK时间单位按100ms计算<br>特殊地,题号101表示用户按OK键确认提交(青果),后面的值可以全FF |
1178   -| 12-19 | BCDVALUE1 | 结果值,8字节BCD码表示的值,高位在前,F表示结束字符,最多16位数,E是小数点,D是空格,C是负号<br> 2、单值结果一般就第一个BCD值有效,例如1FFFFFFF表示1,SDK用"1"表示<br>3、表示数字时候, E表示小数点,例如 1234E5FFFF 表示"1234.5" <br>4、表示单选多选排序的时候,0表示第10个选项,例如 01 32 FF FF 就是"JACB"|
1179   -| 20 | VOLT | 电池电压,单位20mV |
1180   -| 21 | SendPos | 该次结果发送次数 键盘自己计数 |
1181   -| 22 || 空,先填00 |
1182   -| 23-24 || CRC,1到第22字节 |
1183   -
1184   -### 3.2.12固件升级结果
1185   -
1186   -键盘固件升级完成或失败后,上报给基站,应用可完成对失败键盘的静默升级。
1187   -
1188   -| **字节** | **标识符** | **描述** |
1189   -| --- | --- | --- |
1190   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
1191   -| 2 | ANSTYPE | 数据包类型 99 固件升级结果 |
1192   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1193   -| 7-8 | ID | 表决器编号ID,高字节在前 |
1194   -| 9 | STATUS | 1 升级成功 \>1是升级失败的原因 |
1195   -| 10 | HW | 键盘硬件代码 |
1196   -| 11-13 | SW1-SW3 | 键盘软件版本,3字节 |
1197   -
1198   -# 四、上传多包类
1199   -
1200   -&emsp;&emsp;上传多包类指令主要用于表决器向基站快速传送一批次的数据,因为不需要竞争通讯的时序,效率较片段提交的方式高效得多。
1201   -
1202   -商务应用:
1203   -&emsp;&emsp;目前仅脱机调研模式使用了上传多包类的指令。表决器如果实现发短信功能也需要主动的多包上传。
1204   -&emsp;&emsp;目前批次和二维评测的结果都是采用片段提交的方式提交的,而没有采用一次性提交方式。
1205   -
1206   -教育应用:
1207   -&emsp;&emsp;上传测验结果、作业、短信、超16字符填空。
1208   -
1209   -## 4.1 开始多包接收
1210   -
1211   -&emsp;&emsp;上传多包一种情况是表决器主动提出要上传,参见多包申请指令,这时候电脑可以知道要求上传的多包数据类型PACKTYPE和数据包辨别码PACKID。
1212   -
1213   -&emsp;&emsp;上传多包另外一种情况是,电脑指定要某种多包数据,这时候需要知道数据包的长度。
1214   -
1215   -&emsp;&emsp;具体原理参见文档《表决系统通讯协议-应用文档-基础原理》。
1216   -
1217   -&emsp;&emsp;以上两种情况,都用进入多包上传模式指令,获取数据包长度:
1218   -
1219   -| **字节** | **标识符** | **描述** |
1220   -| --- | --- | --- |
1221   -| 1 | PACKCMD | 0x20上传多包类指令 |
1222   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FFFF时候,是用序列SN号指定键盘进行上传 V4.74 |
1223   -| 4 | CMD | 1 表示是进入多包上传模式 |
1224   -| 5 | PACKTYPE | 多包数据类型<br>1 测验结果 2作业结果 3发短信4超16字符填空信息 |
1225   -| 6 | PACKID | 数据包辨别码,例如作业编号<br>=F1的时候, 表示取多个作业科目的合起来的一个打包,取出后再展开成单个科目 |
1226   -| 7-9 || 空 |
1227   -| 10-15 | SN | 使用SN号模式时候是键盘SN号,否则空 |
1228   -| 16-24 | 。。。 | 参数值没有意义,或根据需要设定 |
1229   -
1230   -表决器应答:
1231   -
1232   -| **字节** | **标识符** | **描述** |
1233   -| --- | --- | --- |
1234   -| 1 | PACKCMD | 0xA0上传多包类应答 |
1235   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FFFF,用后面SN号指定键盘 |
1236   -| 4 | CMD | 1 进入多包模式应答 |
1237   -| 5 | PACKTYPE | 多包数据类型,例如2是作业 |
1238   -| 6 | PACKID | 数据包辨别码,例如是科目号 |
1239   -| 7 | PACKH | 数据包长度(段总数)高字节 |
1240   -| 8 | PACKL | 数据包长度(段总数)低字节 |
1241   -| 9 || 空 |
1242   -| 10-15 | SN | 键盘SN号 |
1243   -| 16-24 | 。。。 | 参数值没有意义 |
1244   -
1245   -数据包的PACKH和PACKL是这么计算的:
1246   -&emsp;&emsp;数据包以16字节为1片,16片为1段,PACKH相当于段号(从0开始计算),PACKL是最后一段的数据片数目。数据包实际长度=16字节x(16 x PACKH + PACKL)。SDK收到长度后,就可以根据长度,一个一个数据包地询问收取。
1247   -
1248   -注意:当PACKH=0xFF和PACKL=0xFF时候,表示没有这个数据包。
1249   -
1250   -## 4.2 询问多包和应答
1251   -
1252   -询问表决器多包指令是:
1253   -
1254   -| **字节** | **标识符** | **描述** |
1255   -| --- | --- | --- |
1256   -| 1 | PACKCMD | 0x20上传多包类指令 |
1257   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FF01--FFFE,用SN号指定键盘进行多包上传低位字节01-FE,是上传次序UPSN,由SDK管理,只要是针对下一个键盘的上传就变化一次,例如依次加1,实际上可以理解为给于SN号上传多包的键盘的一个临时键盘编号,因为键盘后面传实际数据时候,由于数据包长度限制,不带SN号,就靠这个号码辨别。不单独统一使用FFFF是避免基站数据可能有延迟,回给SDK的是上次键盘数据,注意:键盘要记录UPSN值,因为应答要用到 |
1258   -| 4 | CMD | 2 询问多包数据 |
1259   -| 5 | PACKTYPE | 多包类型 |
1260   -| 6 | PACKID | 数据包标识码 |
1261   -| 7 | PACKH | 需要上传的数据段编号,以16字节为1片,16片为1个数据段<br>PACKH值指定了哪个段的数据要上传 |
1262   -| 8-9 | PACKLS | 2字节,用Bit位表示要上传哪些片,为1要上传,0不需上传<br>共16Bit,对应0-15片数据片<br>注意:低位字节在前,高位字节在后<br>PACKLS值指定了PACKH段中的哪些数据片要上传 |
1263   -| 10-15 | SN | 当KEYID= ~~FFFF~~ 时候是键盘SN号,否则空<br>V4.77前笔误,应该是FF01-FFFE |
1264   -| 10-24 || 参数无意义 |
1265   -
1266   -表决器应答:(依次送回要传输的数据片的内容)
1267   -
1268   -| **字节** | **标识符** | **描述** |
1269   -| --- | --- | --- |
1270   -| 1 | PACKCMD | 0xA0上传多包类指令应答 |
1271   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FF01-FFFE,用SN号提交多包上传数据,高位是FF,低位是UPSN值,这里的UPSN值就是询问包中的UPSN值 |
1272   -| 4 | CMD | 2 回应多包数据 |
1273   -| 5 | PACKTYPE | 多包类型 |
1274   -| 6 | PACKID | 数据包标识码 |
1275   -| 7 | PACKH | 数据段编号 |
1276   -| 8 | PACKL | 0-15,数据片编号 |
1277   -| 9-24 | PACKDATA | 16字节的数据 |
1278   -
1279   -## 4.3 多包接收完毕确认
1280   -
1281   -&emsp;&emsp;多包接收完毕确认指令用于通知表决器多包接收已经完成,如果是主动申请提交的话,不再进行这个多包数据的多包上传申请。
1282   -
1283   -指令结构:
1284   -
1285   -| **字节** | **标识符** | **描述** |
1286   -| --- | --- | --- |
1287   -| 1 | PACKCMD | 0x20上传多包类指令 |
1288   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FFFF,用SN号指定键盘 |
1289   -| 4 | CMD | 3 多包接收完毕确认 |
1290   -| 5 | PACKTYPE | 多包类型 |
1291   -| 6 | PACKID | 数据包标识码 |
1292   -| 7-9 || 空 |
1293   -| 10-15 | SN | 当KEYID=FFFF时候是键盘SN号,否则空 |
1294   -| 16-24 || 参数无意义 |
1295   -
1296   -表决器应答表示收到:
1297   -
1298   -| **字节** | **标识符** | **描述** |
1299   -| --- | --- | --- |
1300   -| 1 | PACKCMD | 0xA0上传多包类指令应答 |
1301   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>FFFF,用SN号指定键盘 |
1302   -| 4 | CMD | 3 多包接收完毕应答 |
1303   -| 5 | PACKTYPE | 多包类型 |
1304   -| 6 | PACKID | 数据包标识码 |
1305   -| 7-9 || 空 |
1306   -| 10-15 | SN | 当KEYID=FFFF时候是键盘SN号,否则空 |
1307   -| 16-24 || 参数无意义 |
1308   -
1309   -## 4.4 具体应用
1310   -
1311   -&emsp;&emsp;多包数据上传的时候,用数据类型PACKTYPE值和数据包标识码PACKID来标识数据的类型,即PACKTYPE值和PACKID值决定了上传的数据包类型、格式。和3.2.7节多包申请里面定义相同。
1312   -
1313   -商务政务涉及到数据表类型有:
1314   -
1315   -| PACKTYPE 值 | PACKID 值 | 数据包类型 |
1316   -| --- | --- | --- |
1317   -| 1 | 0 | 简单类型的脱机调研数据,仅支持单选多选,最多8选8 |
1318   -| 2 | 0 | 待定 |
1319   -| 3 | 0 | 发短信 |
1320   -| 4 | 0 | 超16字符填空信息 |
1321   -
1322   -教育应用涉及到数据表类型有:
1323   -
1324   -| PACKTYPE 值 | PACKID 值 | 数据包类型 |
1325   -| --- | --- | --- |
1326   -| 1 | 0 | 测验结果 |
1327   -| 2 | 0 | 作业结果 |
1328   -| 3 | 0 | 发短信 |
1329   -| 4 | 0 | 超16字符填空信息 |
1330   -
1331   -## 4.5序列号上传多包
1332   -
1333   -&emsp;&emsp;上传多包在使用序列号来标识键盘时候,由于是SDK指定键盘询问的,所以,4.1节到4.3节,都可以修改成兼容按SN号指定和应答,唯键盘上传数据时,为保持和ID方式兼容和数据包长度不修改,应答数据包没包含SN号。
1334   -
1335   -## 4.6 透传多包上传
1336   -
1337   -总体流程:
1338   -
1339   --> 键盘向基站申请需要上传多包数据
1340   -
1341   --> 基站点名获取键盘数据
1342   -
1343   --> 基站释放该SN点名。
1344   -
1345   -### 4.6.1 键盘申请包
1346   -
1347   -键盘向基站发送申请包开始多包传输。
1348   -
1349   -| **字节** | **标识符** | **描述** |
1350   -| --- | --- | --- |
1351   -| 1 | ANSCMD | 0x94硬件序列号带编号提交结果 |
1352   -| 2 | ANSTYPE | 数据包类型32 键盘申请发送透传数据包 |
1353   -| 3-6 | KEYSN | 表决器硬件序列号,4字节,高位在前 |
1354   -| 7 | TR\_POS | 透传轮次号 不能为0 1-255键盘自增 |
1355   -| 8-9 | INTERVAL | 键盘发送一个透传包需要时间,单位us<br> 用于基站确定点名间隔,同时其他键盘可做无线休眠 |
1356   -| 10 | PACKTYPE | 多包类型 |
1357   -| 11 | PACKID | 多包标识码 |
1358   -| 12-15 | PACKLEN | 需要上传的包数据总长度,long值,高位前 |
1359   -| 16-17 | DATALEN | 单位包长度,一次包传输长度封顶1K(32+1包/16+1包) |
1360   -| 18-19 | PACKCRC | 多包上传数据总CRC。00暂时不核对。 |
1361   -
1362   -### 4.6.2 基站点名包
1363   -
1364   -基站点名键盘回复数据
1365   -
1366   -注意:1、键盘没有回复,超时时间为10个SLEEP_INTERVAL时长(发送10次没回复)
1367   -
1368   -2、上个键盘已经收齐,需要切换时,不直接切换到发送信标而是发送SN为0的点名包, ~~再进入超时10个SLEEP_INTERVAL判断。(发送10次空包没人申请则超时)~~
1369   -
1370   -| **字节** | **标识符** | **描述** |
1371   -| --- | --- | --- |
1372   -| 1 | PACKCMD | 0x28上传多包类点名 |
1373   -| 2-3 | SLEEP_INTERVAL | 键盘休眠间隙 单位us 下一信标间隔时间<br>基本等同于键盘申请指令里面的INTERVAL值 |
1374   -| 4-7 | SN | 键盘SN ~~全0为可以继续键盘申请(这里注意下)~~ |
1375   -| 8 | TR_POS | 透传轮次 键盘上传的轮次号 不能为0 1-255键盘自增 |
1376   -| ~~9~~ | ~~REC_OK~~ | ~~上一片区 ACK收齐回复 ,0x55 表示上一周期收全并CRC正确,其他错误~~ |
1377   -| 9-10 | ASK_PACK_NO | 询问键盘包序号,从1开始 基站主动询问包(总包除以单位包得到包总序号),高位前<br>=0表示基站通知收齐了 |
1378   -| ~~11-14~~ | ~~DATALEN~~ | ~~已接收的包数据总长度 (不限制模式下全FF)~~ |
1379   -| 11 | PACKTYPE | 多包类型 |
1380   -| 12 | PACKID | 多包标识码 |
1381   -| 13-14 | DATALEN | 单位包长度 |
1382   -||||
1383   -
1384   -### 4.6.3 键盘透传上传包
1385   -
1386   -&emsp;&emsp;键盘被4.6.2节基站点名后的应答。
1387   -
1388   -&emsp;&emsp;对透传包的接收,基站判断是透传包后,设置继续接收标志并置超时定时器,收到1包就添加到buf尾部,如果超时没到就收到N包,去处理。如果超时没N包,直接丢弃。
1389   -
1390   -&emsp;&emsp;键盘接收可以都丢弃(首包0x8F丢,后继数据包,ATC码判断相同的概率比较低)。
1391   -
1392   -&emsp;&emsp;键盘在上传过程中根据SN被切换(或为0)或者切回发送信标则判断已全部上传完成(省掉最后基站给键盘确认)
1393   -
1394   -| **字节** | **标识符** | **描述** |
1395   -| --- | --- | --- |
1396   -| 0-3 | ATC | 配对码 |
1397   -| 4-7 | MULTI_CODE | 多包透传标志 0x 8f 0x de 0x 48 0xfe(相当于CMD=0x8F) |
1398   -| 8 | MULTI_N | 后续传输包数量 此处为N |
1399   -| 9 | MULTI_TYPE | 透传数据包格式,暂1,后面数据按后面解析 |
1400   -| 10-11 | CRC16 | 全部DownData的 CRC |
1401   -| 12-15 | SN | 4字节SN |
1402   -| 16 | TR_POS | 透传轮次 |
1403   -| 17-18 | ASK_PACK_NO | 当前包序号从1开始 对应基站点名询问包序号 |
1404   -| 19 | PACKTYPE | 多包类型 |
1405   -| 20 | PACKID | 多包标识码 |
1406   -| 21-22 | DATALEN | DownData长度 |
1407   -| 23 | DataPos | 数据题目序号 |
1408   -| --31 || 空。从ATC开始,到这里共32字节<br>下面是数据片段实际数据,32字节1个无线包 |
1409   -| 32*N | DownData | 透传数据 32或者64的倍数 数据不满 补充0到32的倍数 |
1410   -
1411   -# 五、下载单包类
1412   -
1413   -## 5.1概述
1414   -
1415   -&emsp;&emsp;表决器下载单包类指令主要用于控制表决器执行某种操作,例如修改编号、遥控关机等。
1416   -
1417   -发送给表决器的指令结构如下:
1418   -
1419   -| **字节** | **标识符** | **描述** |
1420   -| --- | --- | --- |
1421   -| 1 | KEYCMD | 0x30 表决器管理类指令 |
1422   -| 2-3 | KEYID | 表决器编号,2字节,高位在前 <br>0x0000时候是广播,所有表决器都接收和处理<br>其他值是指定编号执行,编号和KEYID相同的才执行命令 |
1423   -| 4 | KCMD | 执行命令的类型 |
1424   -| 5-24 | KCMDS | 根据KCMD值不同,有不同含义 |
1425   -| 25-26 || 一般是空00 |
1426   -| 27-28 | CRC16 | 这里如果有值不等于0,表示指令带效验,从1计算到26字节<br>这里如果是0,或者数据包只有24字节,表示老体系的不带效验<br>本章节后面,长度24字节的,都可以变成28字节,不修改文档了 |
1427   -
1428   -对于广播式指令(KEYID=0),表决器一般不回应结果状态,对于指定编号的,对应KEYID编号的表决器回应执行的结果:
1429   -
1430   -| **字节** | **标识符** | **描述** |
1431   -| --- | --- | --- |
1432   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1433   -| 2-3 | KEYID | 表决器编号,2字节,高位在前 |
1434   -| 4 | KCMD | 对应指令类型 |
1435   -| 5-24 | CMDMSG | 指令回应状态或其他信息 |
1436   -
1437   -KCMD列表:
1438   -
1439   -| **KCMD 值**|**功能模式** |
1440   -| --- | --- |
1441   -| 1,2 | 读写表决器配置 |
1442   -| 3,4 | 读写表决器硬件信息 |
1443   -| 5 | 遥控关机 |
1444   -| 7 | 信道测试 |
1445   -|||
1446   -| 10 | 显示表决器版本编号等信息 |
1447   -| 11 | 读写学号或姓名 |
1448   -| 12 | 功能检验测试 |
1449   -| 13,14 | 读写OEM硬件信息(极域) |
1450   -| 15 | 分组设置 |
1451   -| 16 | 外设动作控制 |
1452   -| 17 | 回写测验题答案 |
1453   -| 18 | 读取测验题答案 |
1454   -| 19 | 写OEM型号显示名称 |
1455   -| 20 | 授权 |
1456   -| 21-25 | 表决结果显示,政务协议 |
1457   -|||
1458   -| 30 | WIFI服务器信息 |
1459   -| 31 | 遥控绑定和解绑 |
1460   -| -36 | 手机类设置 |
1461   -|||
1462   -
1463   -## 5.2 表决器管理类
1464   -
1465   -### 5.2.1 读写表决器配置
1466   -
1467   -用于读取或修改表决器的基本参数,例如表决器编号。
1468   -
1469   -发送给表决器的指令结构如下:
1470   -
1471   -| **字节** | **标识符** | **描述** |
1472   -| --- | --- | --- |
1473   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1474   -| 2-3 | KEYID | 表决器编号,或0x0000广播(广播模式下不应答) |
1475   -| 4 | KCMD | 1 读表决器配置<br>2 写表决器配置 |
1476   -| 5-6 | NEWID | 写表决器配置操作时候有效<br>新表决器编号,2字节,高位在前,0000不改变 |
1477   -| 7 | ~~OFFTIME~~ | ~~写表决器配置操作时候有效<br> 表决器自动关机时间,以分钟为单位,0xFF不自动关机<br>某些型号不支持修改~~ |
1478   -| 8 | LOCKBASE | 固定配对模式还是自由配对模式<br>目前暂应用在教育系列 <br>1 固定配对 <br>2自由配对(可搜寻基站)<br>3 白名单模式 |
1479   -| ~~9~~ | ~~FIXCHAN~~ | ~~锁频模式<br> 0和 1自动锁频 2固定锁频~~ |
1480   -| 10-24 || 参数无意义 |
1481   -
1482   -表决器回应表决器配置信息:
1483   -
1484   -| **字节** | **标识符** | **描述** |
1485   -| --- | --- | --- |
1486   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1487   -| 2-3 | KEYID | 表决器编号,2字节,高位在前 |
1488   -| 4 | KCMD | 1 表决器配置信息 |
1489   -| 5-6 | KEYID | 表决器编号 |
1490   -| 7 | ~~OFFTIME~~ | ~~表决器自动关机时间~~ |
1491   -| 8 | LOCKBASE | 固定配对模式还是自由配对模式 |
1492   -| 9-24 || 参数无意义 |
1493   -
1494   -### 5.2.2 读写硬件信息
1495   -
1496   -用于读取硬件型号、版本、序列号等信息。
1497   -
1498   -发送给表决器的指令结构如下:
1499   -
1500   -| **字节** | **标识符** | **描述** |
1501   -| --- | --- | --- |
1502   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1503   -| 2-3 | KEYID | 表决器编号,或0x0000广播 |
1504   -| 4 | KCMD | 3 读表决器硬件信息<br>4 写表决器硬件信息(内部使用,不对外公开) |
1505   -| 5 | MODEL | 硬件型号代码,固件程序写死 |
1506   -| 6 | HVER | 硬件版本号,固件程序写死 |
1507   -| 7 | SVER | 软件版本号,固件程序写死 |
1508   -| 8-13 | SERIAL | 硬件序列号,6字节,高位在前,写操作时有效<br> ~~教育体系前4字节有效,后2字节填写FF~~<br> SDK是后4字节有效,前2字节00 |
1509   -| 14 | NEWVER | 0xA0 表示后面3字节是新的版本号 |
1510   -| 15-17 | SW\_3B | 3字节固件版本号,例如1、0、0表示V1.0.0<br>11、12、13表示V11.12.13 |
1511   -| 18-24 || 参数无意义 |
1512   -
1513   -表决器回应表决器硬件信息:(可以一次回SN和ID)
1514   -
1515   -| **字节** | **标识符** | **描述** |
1516   -| --- | --- | --- |
1517   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1518   -| 2-3 | KEYID | 表决器编号,2字节,高位在前 |
1519   -| 4 | KCMD | 3 表决器硬件信息 |
1520   -| 5 | MODEL | 硬件型号代码 |
1521   -| 6 | HVER | 硬件版本号 |
1522   -| 7 | SVER | 软件版本号 |
1523   -| 8-13 | SERIAL | 硬件序列号,6字节,高位在前 |
1524   -| 14 | NEWVER | 0xA0 表示后面3字节是新的版本号 |
1525   -| 15-17 | SW\_3B | 3字节固件版本号 |
1526   -| 18-24 || 参数无意义 |
1527   -
1528   -### 5.2.3 表决器遥控关机
1529   -
1530   -&emsp;&emsp;遥控无线表决器关机,对有线系统无效。表决器不对指令应答,一般要多发送几次确保表决器接收到指令。
1531   -
1532   -| **字节** | **标识符** | **描述** |
1533   -| --- | --- | --- |
1534   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1535   -| 2-3 | KEYID | 表决器编号,一般是0x0000,所有表决器关机,否则是指定某个表决器关机 |
1536   -| 4 | KCMD | 5 遥控关机 |
1537   -| 5 | OFFMODE | 0 正常关机,需要按键才能开机,也即退出遥控开机模式<br> N 进入一键遥控开机模式,键盘定时监听基站是否遥控开机,持续N天后自动退出遥控开机模式,如果N=255表示一直遥控开机<br>(注意:中间键盘手动开机后自动关机的、离线关机的,不要影响这个遥控开机计时,除非重新遥控设置) |
1538   -| 6-8 || 参数无意义 |
1539   -| 9 | ZONEMODE | 0 不使用指定范围,全部修改<br>1 按键盘范围修改 |
1540   -| 10-11 | KEYMIN | 指定键盘编号范围时候的开始值,高位在前 |
1541   -| 12-13 | KEYMAX | 指定键盘编号范围时候的结束值,高位在前 |
1542   -| 14-24 || 参数无意义 |
1543   -
1544   -### 5.2.4 表决器授权
1545   -
1546   -用于控制投票器是否可以登录基站,或者投票权限
1547   -发送给投票器的指令结构如下:
1548   -
1549   -| **字节** | **标识符** | **描述** |
1550   -| --- | --- | --- |
1551   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1552   -| 2-3 | KEYID | 指定表决器编号 可以0000广播<br>0xFFFF,指定SN |
1553   -| 4 | KCMD | 20 表决器授权 |
1554   -| 5 | AUTHOK | 1 登录成功,授权成功 <br>2 签到信息错误,重新输入 <br>3 失败,系统不允许,表决器不要再提交登录请求<br>4 白名单键盘重新登录 |
1555   -| 6-7 | ~~AUTHCODE~~ | ~~授权号,2字节,高位在前<br> 在授权成功下有效~~ |
1556   -| 8-9 || 空 |
1557   -| 10-15 | SN | 投票器硬件序列号,6字节,动态配对编号时候有效<br>对教育新体系,后4字节SN有效 |
1558   -| 16-24 || 参数无意义 |
1559   -
1560   -表决器回应:
1561   -
1562   -| **字节** | **标识符** | **描述** |
1563   -| --- | --- | --- |
1564   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1565   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>SN号模式下是0xFFFF |
1566   -| 4 | KCMD | 20 授权应答 |
1567   -| 5 | AUTHOK | 授权应答类型<br>同AUTHOK接收值,便于判断是哪个指令的应答 |
1568   -| 6-7 | AUTHCODE | 当前的授权号,2字节,高位在前<br>应答类型为1时候有效 |
1569   -| 8-9 || 空 |
1570   -| 10-15 | SERIALID | 投票器硬件序列号,6字节,动态配对编号时候有效 |
1571   -| 16-24 || 参数无意义 |
1572   -
1573   -### 5.2.5 表决器信道测试
1574   -
1575   -表决器信道测试用于测试指定表决器的双向成功率和信号强度,仅用于无线表决器。
1576   -
1577   -发送给表决器的指令结构如下:
1578   -
1579   -| **字节** | **标识符** | **描述** |
1580   -| --- | --- | --- |
1581   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1582   -| 2-3 | KEYID | 指定表决器编号<br>FFFF,用SN号指定键盘 |
1583   -| 4 | KCMD | 7 无线信道测试 |
1584   -| 5 | SENDN | 发送次数 |
1585   -| 6 | OKN | 成功双向通讯次数 |
1586   -| 7 | RSSI1 | 基站接收到的表决器发射的无线信号强度,单位-dbm<br>(由基站自动填写,SDK不需处理) |
1587   -| 8,9 || 空 |
1588   -| 10-15 | SN | 当KEYID=FFFF时候是键盘SN号,否则空<br>对教育新体系,后4字节SN有效 |
1589   -| 16-24 || 参数无意义 |
1590   -
1591   -表决器回应:
1592   -
1593   -| **字节** | **标识符** | **描述** |
1594   -| --- | --- | --- |
1595   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1596   -| 2-3 | KEYID | 指定表决器编号<br>FFFF,用SN号表示键盘 |
1597   -| 4 | KCMD | 7 无线信道测试应答 |
1598   -| 5 | SENDN | 接收到的发送次数数据SENDN |
1599   -| 6 || 空 |
1600   -| 7 | RSSI1 | 基站接收到的表决器发射的无线信号强度 |
1601   -| 8 | RSSI2 | 表决器接收到的基站发射的无线信号强度,单位-dbm |
1602   -| 9 | VOLT | 电池电压,Bit7为1表示在充电,低7位x0.04V就是电池当前电压 |
1603   -| 10-15 | SN | 当KEYID=FFFF时候是键盘SN号,否则空 |
1604   -| 10-24 || 参数无意义 |
1605   -
1606   -电脑接收到回应后,判断SENDN是否等于上次发送的SENDN,是的话表示双向通讯成功一次,OKN加1。
1607   -
1608   -### 5.2.6 读写姓名等个人信息
1609   -
1610   -教育系列键盘可以通过SN号在键盘内写好学号或姓名。
1611   -
1612   -| **字节** | **标识符** | **描述** |
1613   -| --- | --- | --- |
1614   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1615   -| 2-3 | KEYID | 指定表决器编号,0000广播<br>FFFF,用SN号指定键盘 |
1616   -| 4 | KCMD | 11读写学号或姓名 |
1617   -| 5 | MODE | 1读学号 <br>2 写学号 <br>3 读姓名<br> 4 写姓名<br>5 读金币数<br>6 写金币数(见单独说明)<br>7 清空姓名<br>8 写姓名学号金币数(5.8G体系长指令)<br>9 清金币数(得分)--一般用于广播,单独清零可以用写金币<br>10 读8汉字姓名<br>11 写8汉字姓名<br> 12 写单题得分(科大讯飞-键盘自主按UI要求显示),格式同写金币<br>13 清除得分(科大讯飞)|
1618   -| 6-17 | IDSTR | 学号字符串,最多12字符,参数在写学号时候才有用 |
1619   -| 18 || 空 |
1620   -| 19-24 | SN | 表决器SN号,6字节,高位在前对教育新体系,后4字节SN有效 |
1621   -||||
1622   -| 25-36 | Name | 姓名,最多12个字符,5.8G才这么用 |
1623   -| 37 || 空 |
1624   -| 38-41 | MONEY | 金币数,高位在前 |
1625   -
1626   -投票器回应:
1627   -
1628   -| **字节** | **标识符** | **描述** |
1629   -| --- | --- | --- |
1630   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1631   -| 2-3 | KEYID | ~~投票器编号,2字节,高位在前~~<br>=0xffff,使用SN号下载姓名 |
1632   -| 4 | KCMD | 11 读写学号或姓名 |
1633   -| 5 | MODE | 1 读学号 <br>2 写学号 <br>3 读姓名 <br>4 写姓名<br>8 姓名学号金币数, 回复SN |
1634   -| 6-17 | IDSTR | 学号字符串,最多12字符,参数在写学号时候才有用 |
1635   -| 18 || 空 |
1636   -| 19-24 | SN | 表决器SN号,6字节,高位在前<br>对教育新体系,后4字节SN有效,前2字节必须FFFF |
1637   -
1638   -如果要支持8汉字姓名,使用如下指令:
1639   -
1640   -| **字节** | **标识符** | **描述** |
1641   -| --- | --- | --- |
1642   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1643   -| 2-3 | KEYID | 指定表决器编号,0000广播<br>FFFF,用SN号指定键盘 |
1644   -| 4 | KCMD | 11读写学号或姓名 |
1645   -| 5 | MODE | 10读8汉字姓名<br>11写8汉字姓名(键盘判断SN的位置不同) |
1646   -| 6-21 | NAME | 姓名,最多16字符8汉字 |
1647   -| 22 | NULL ||
1648   -| 23-26 | SN | 表决器SN号,4字节,高位在前 |
1649   -| 27-28 | CRC16 ||
1650   -
1651   -对应的键盘应答:
1652   -
1653   -| **字节** | **标识符** | **描述** |
1654   -| --- | --- | --- |
1655   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
1656   -| 2-3 | KEYID | FFFF,用SN号应答 |
1657   -| 4 | KCMD | 11读写学号或姓名 |
1658   -| 5 | MODE | 10读写8汉字姓名应答 |
1659   -| 6-21 | NAME | 姓名,最多16字符8汉字 |
1660   -| 22 | NULL ||
1661   -| 23-26 | SN | 表决器SN号,4字节,高位在前 |
1662   -| 27-28 | CRC16 ||
1663   -
1664   -读写金币数,含本次操作信息:
1665   -
1666   -| **字节** | **标识符** | **描述** |
1667   -| --- | --- | --- |
1668   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1669   -| 2-3 | KEYID | 指定表决器编号<br>FFFF,用SN号指定键盘 |
1670   -| 4 | KCMD | 11读写学号或姓名 |
1671   -| 5 | MODE | 5读金币数6写金币数 |
1672   -| 6-9 | MONEY | 4字节现在金币总数,高位前 |
1673   -| 10 | ADD | 本次增减金币数显示0 不显示 1显示增加金币 2显示减金币 |
1674   -| 11-12 | MONNYADD | 本次增加或减少的金币数,2字节,高位前 |
1675   -| 13-18 || 空 |
1676   -| 19-24 | SN | 表决器SN号,6字节,高位在前<br>对教育新体系,后4字节SN有效 |
1677   -
1678   -投票器回应:
1679   -
1680   -| **字节** | **标识符** | **描述** |
1681   -| --- | --- | --- |
1682   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1683   -| 2-3 | KEYID | ~~投票器编号,2字节,高位在前~~<br>=0xffff,使用SN号下载姓名 |
1684   -| 4 | KCMD | 11 读写学号或姓名 |
1685   -| 5 | MODE | 5读金币数6写金币数 |
1686   -| 6-9 | MONEY | 4字节现在金币总数,高位前 |
1687   -| 。。。 || 空 |
1688   -| 19-24 | SN | 表决器SN号,6字节,高位在前<br>对教育新体系,后4字节SN有效,前2字节必须FFFF |
1689   -
1690   -### 5.2.7 读写OEM预置信息
1691   -
1692   -用于读写OEM预置信息,包括即时反馈的按键等级提示。
1693   -发送给表决器的指令结构如下:
1694   -
1695   -| **字节** | **标识符** | **描述** |
1696   -| --- | --- | --- |
1697   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1698   -| 2-3 | KEYID | 表决器编号,或0x0000广播<br>FFFF,用SN号指定键盘 |
1699   -| 4 | KCMD | 13 读OEM硬件信息<br>14 写OEM硬件信息 |
1700   -| 5 | OEM | OEM信息代码<br> 1 极域10字节SN(只能极域,不对外公开)<br> 2 即时反馈按键提示自定义等级 <br>3 锐捷定制键盘的蓝牙MAC地址(IDSTR是6字节),键盘要串口发给蓝牙芯片,读取时候,读蓝牙芯片MAC返回<br>4 出厂日期(暂字符串格式,放IDSTR) |
1701   -| 6 | IDNO | 具体信息位置编号<br>对于极域SN,填0,原先IDSTR从这里开始<br>对于OEM=2即时等级提示,这里是键码,1起 |
1702   -| 7-18 | IDSTR | 信息字符串 |
1703   -| 19-24 | SN | 表决器SN号,6字节,高位在前<br>对教育新体系,后4字节SN有效,前2字节必须FFFF |
1704   -
1705   -表决器回应表决器硬件信息:
1706   -
1707   -| **字节** | **标识符** | **描述** |
1708   -| --- | --- | --- |
1709   -| 1 | KEYCMD | 0xB0 表决器遥控指令应答 |
1710   -| 2-3 | KEYID | 表决器编号,2字节,高位在前SN模式下FFFF |
1711   -| 4 | KCMD | 13 OEM硬件信息 |
1712   -| 5 | OEM | OEM信息代码 |
1713   -| 6 | IDNO | 具体信息位置编号 |
1714   -| 7-18 | IDSTR | 信息字符串 |
1715   -| 19-24 | SN | 表决器SN号,6字节,高位在前<br>对教育新体系,后4字节SN有效,前2字节必须FFFF |
1716   -
1717   -### 5.2.8 显著显示表决器信息
1718   -
1719   -用于遥控表决器在液晶上显著显示硬件信息,例如用大字体显示编号,利于分发和查看。
1720   -
1721   -| **字节** | **标识符** | **描述** |
1722   -| --- | --- | --- |
1723   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1724   -| 2-3 | KEYID | 表决器编号,一般是0x0000,所有表决器都显示 |
1725   -| 4 | KCMD | 10 显著显示表决器信息 |
1726   -| 5 | MODE | 1 大字体显示表决器编号<br>2 液晶闪烁显示,利于查找 |
1727   -| 6-24 || 参数无意义 |
1728   -
1729   -### 5.2.10 检验模式(硬件自测)
1730   -
1731   -用于控制表决器进入特殊的检验模式,而达到进行某项功能检验的目的。表决器不予应答,一般要多发送几次确保表决器接收到指令。
1732   -
1733   -| **字节** | **标识符** | **描述** |
1734   -| --- | --- | --- |
1735   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1736   -| 2-3 | KEYID | 表决器编号,一般是0x0000,所有表决器都执行 |
1737   -| 4 | KCMD | 12 检验模式(原桌牌协议是11,但和读写学号冲突了) |
1738   -| 5 | MODE | 检验的类型<br>对于带液晶表决器,0是正常待机状态,1是液晶液晶全亮 2交替全亮全灭,时间可控<br>对于电子桌牌,0是缺省模式,1是全亮,2是全灭,3是横扫,4是纵扫<br>对于计分牌,0、1是前后数码管全亮,2是全灭,3是间隔全亮和全灭,间隔1秒 |
1739   -| 6 | T1 | 液晶测试模式2 时候全亮时间,单位秒 |
1740   -| 7 | T2 | 液晶测试模式2 时候全灭时间,单位秒 |
1741   -| 8-24 || 参数无意义 |
1742   -
1743   -### 5.2.11 WIFI服务器模式
1744   -
1745   -&emsp;&emsp;【T1-WIFI体系】这个指令是通过UDP广播给接入网络的语音答题器或其他类似设备,告诉答题器如何连接服务器的。
1746   -
1747   -| **字节** | **标识符** | **描述** |
1748   -| --- | --- | --- |
1749   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1750   -| 2-3 | KEYID | 答题器编号,一般是0x0000,所有答题器都执行<br>或者0xFFFF,用SN号指定答题器 |
1751   -| 4 | KCMD | 30 WIFI服务器信息 |
1752   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1753   -| 11 | MODE | 告诉答题器连接服务器的模式<br>暂时1,用IP地址连接,后面是主控IP地址信息 |
1754   -| 12-15 | IP | 4字节的主控IP地址 |
1755   -| 16-17 | PORT | 暂时00,用户不指定端口值 |
1756   -||||
1757   -
1758   -### 5.2.12 遥控绑定和解绑
1759   -
1760   -用于遥控修改答题器连接服务器方式,和同时修改学生信息。类似NFC修改绑定,但通过遥控指令方式,不是刷卡方式。
1761   -
1762   -| **字节** | **标识符** | **描述** |
1763   -| --- | --- | --- |
1764   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1765   -| 2-3 | KEYID | 答题器编号,一般是0x0000,所有答题器都执行或者0xFFFF,用SN号指定答题器 |
1766   -| 4 | KCMD | 31 绑定和解绑 |
1767   -| 5-10 | SN | 答题器硬件序列号,6字节对教育新体系,后4字节SN有效 |
1768   -| 11 | MODE | 1 绑定<br>2 解绑 |
1769   -||||
1770   -||||
1771   -
1772   -投票器回应:
1773   -
1774   -| **字节** | **标识符** | **描述** |
1775   -| --- | --- | --- |
1776   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1777   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1778   -| 4 | KCMD | 31绑定和解绑的应答 |
1779   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1780   -| 11 | MODE | 1 绑定2 解绑 |
1781   -||||
1782   -||||
1783   -
1784   -### 5.2.13 分组设置(未确定)
1785   -
1786   -用于修改答题器的分组设置。注意本指令超标准长度。
1787   -
1788   -| **字节** | **标识符** | **描述** |
1789   -| --- | --- | --- |
1790   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1791   -| 2-3 | KEYID | 答题器编号,用编号指定答题器<br>或者0xFFFF,用SN号指定答题器 |
1792   -| 4 | KCMD | 15 分组设置 |
1793   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1794   -| 11 | GROUP | 组号,1起 |
1795   -| 12-27 | NAME | 组名,最大16字符,8汉字 |
1796   -||||
1797   -
1798   -投票器回应:(注意本指令超标准长度)
1799   -
1800   -| **字节** | **标识符** | **描述** |
1801   -| --- | --- | --- |
1802   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1803   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1804   -| 4 | KCMD | 15 分组设置应答 |
1805   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1806   -| 11 | GROUP | 组号,1起 |
1807   -| 12-27 | NAME | 组名,最大16字符,8汉字 |
1808   -||||
1809   -
1810   -### 5.2.14 外设动作控制(未确定)
1811   -
1812   -用于控制投票器外设执行动作,震动、指示灯、蜂鸣器等。
1813   -
1814   -| **字节** | **标识符** | **描述** |
1815   -| --- | --- | --- |
1816   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1817   -| 2-3 | KEYID | 答题器编号,用编号指定答题器<br>或者0xFFFF,用SN号指定答题器 |
1818   -| 4 | KCMD | 16 外设动作控制 |
1819   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1820   -| 11 | MODE | 控制外设类型<br> 1 震动 <br>2 指示灯<br> 3 蜂鸣器 <br>4 背光<br>5 麦克风录音打开<br>6 手写笔迹传输打开 |
1821   -| 12- || 控制参数 |
1822   -||||
1823   -
1824   -不同外设类型参数如下:
1825   -
1826   -| **字节** | **标识符** | **描述** |
1827   -| --- | --- | --- |
1828   -| 11 | MODE | 控制外设类型1 震动 |
1829   -| 12 | TIMES | 震动次数 |
1830   -| 13 | POWER | 强度,1=弱 2=中 3=强,其他按2处理 |
1831   -| 14 | TON | 每次开时间,单位0.5s,\>1 |
1832   -| 15 | TOFF | 每次关时间,单位0.5s,为0就是连续震动 |
1833   -||||
1834   -
1835   -| 11 | MODE | 控制外设类型<br>2 指示灯 |
1836   -| --- | --- | --- |
1837   -| 12 | TIMES | 闪烁次数,0是马上灭,255是长亮 |
1838   -| 13 | POWER | 亮度,暂0,但SDK有接口 |
1839   -| 14 | TON | 每次开时间,单位0.5s,\>1 |
1840   -| 15 | TOFF | 每次关时间,单位0.5s,为0就是连续亮 |
1841   -| 16 | R | 灯颜色 红值 |
1842   -| 17 | G | 灯颜色 绿值 |
1843   -| 18 | B | 灯颜色 蓝值 |
1844   -||||
1845   -
1846   -| **字节** | **标识符** | **描述** |
1847   -| --- | --- | --- |
1848   -| 11 | MODE | 控制外设类型<br>3 蜂鸣器 |
1849   -| 12 | TIMES | 响次数 |
1850   -| 13 | POWER | 强度,1=弱 2=中 3=强,其他按2处理 |
1851   -| 14 | TON | 每次开时间,单位0.5s,\>1 |
1852   -| 15 | TOFF | 每次关时间,单位0.5s,为0就是连续震动 |
1853   -||||
1854   -
1855   -| **字节** | **标识符** | **描述** |
1856   -| --- | --- | --- |
1857   -| 11 | MODE | 控制外设类型4 背光 |
1858   -| 12 | TIMES | 闪烁次数 |
1859   -| 13 | POWER | 暂0 |
1860   -| 14 | TON | 每次开时间,单位0.5s,\>1 |
1861   -| 15 | TOFF | 每次关时间,单位0.5s,为0就是连续震动 |
1862   -||||
1863   -
1864   -投票器回应:
1865   -
1866   -| **字节** | **标识符** | **描述** |
1867   -| --- | --- | --- |
1868   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1869   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1870   -| 4 | KCMD | 16 外设控制应答 |
1871   -| 5-10 | SN | 答题器硬件序列号,6字节<br>对教育新体系,后4字节SN有效 |
1872   -| 11 | MODE | 外设类型,对应设置指令 |
1873   -| 12 | OK | 1 OK<br>0 失败,一般是不支持 |
1874   -||||
1875   -
1876   -### 5.2.15 文字自定义显示
1877   -
1878   -用于在指定键盘上指定位置显示字符串。
1879   -
1880   -| **字节** | **标识符** | **描述** |
1881   -| --- | --- | --- |
1882   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1883   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
1884   -| 4 | KCMD | 17 自定义显示(T2代码用于StopByMsg了,先写键盘,停止时候再显示)<br>19 自定义显示 |
1885   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节,以满足高思显示8汉字) |
1886   -| 9 | MODE2 | 显示模式<br> 0 使用后面的字符串内容<br> 1-9 预置显示信息(提前下载好,或写死的方案)<br>高4位可控制字体大小(暂不用) |
1887   -| 10 | XY | 显示位置,以8点为1单位<br>高4位是X,低4位是Y |
1888   -| 11-26 | STR | MODE2=0时候要显示的字符串,最大16字符 |
1889   -| 27-28 | CRC16 | 效验值 |
1890   -
1891   -投票器回应:
1892   -
1893   -| **字节** | **标识符** | **描述** |
1894   -| --- | --- | --- |
1895   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1896   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)=0xFFFF,用SN应答 |
1897   -| 4 | KCMD | 17 自定义显示应答 |
1898   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1899   -| 9 | OK | 1=OK |
1900   -||||
1901   -
1902   -### 5.2.16 回写测验题内容
1903   -
1904   -用于替换键盘的时候,已经答题的题目,内容通过软件写回替换后的键盘。
1905   -
1906   -| **字节** | **标识符** | **描述** |
1907   -| --- | --- | --- |
1908   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1909   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000广播<br>或者0xFFFF,用SN号指定答题器 |
1910   -| 4 | KCMD | 17 回写测验题答题结果 |
1911   -| 5-8 | SN | 答题器硬件序列号,4字节<br>(为了兼容同时写2题目减少时间,是8BCD字节的测验内容) |
1912   -| 9 | NO1 | 题号1 |
1913   -| 10-17 | VAL1 | 8字节BCD码表示的题目输入内容 |
1914   -| 18 | NO2 | 题号2,如果=00表示后面空,即1次回写1题目内容 |
1915   -| 19-26 | VAL1 | 8字节BCD码表示的题目2输入内容 |
1916   -| 27-28 | CRC16 ||
1917   -
1918   -投票器回应:
1919   -
1920   -| **字节** | **标识符** | **描述** |
1921   -| --- | --- | --- |
1922   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1923   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1924   -| 4 | KCMD | 17 回写测验题答题结果应答 |
1925   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1926   -| 9 | OK | 1 OK<br>0 失败,一般是不支持 |
1927   -| 10-17 | VAL1 | 8字节BCD码表示的题目输入内容 |
1928   -||||
1929   -
1930   -### 5.2.17 读取测验题结果
1931   -
1932   -用于指定某个键盘,读取某个题号的结果,用于解决键盘漏交的bug。
1933   -
1934   -| **字节** | **标识符** | **描述** |
1935   -| --- | --- | --- |
1936   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1937   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000广播<br>或者0xFFFF,用SN号指定答题器 |
1938   -| 4 | KCMD | 18 读取测验题答题结果 |
1939   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1940   -| 9 | NO | 题号 |
1941   -||||
1942   -| 27-28 | CRC16 ||
1943   -
1944   -投票器回应:
1945   -
1946   -| **字节** | **标识符** | **描述** |
1947   -| --- | --- | --- |
1948   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1949   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1950   -| 4 | KCMD | 18 返回测验答题结果 |
1951   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1952   -| 9 | NO | 题号 |
1953   -| 10 | TYPE | 7 按ABCD解码 8 按数字解码 |
1954   -| 11-18 | VAL | 8字节BCD码表示的题目输入内容 |
1955   -| 19-20 | TIME | 按键时间 |
1956   -| 21 | VOLT | 电压值 |
1957   -||||
1958   -| 27-28 | CRC16 ||
1959   -
1960   -### 5.2.18获取调试信息(未设计)
1961   -
1962   -### 5.2.19 写OEM型号显示名称
1963   -
1964   -用于更改液晶上的型号显示名称。
1965   -
1966   -一般是广播,键盘不用应答,但键盘显示出来供人工核查。
1967   -
1968   -| **字节** | **标识符** | **描述** |
1969   -| --- | --- | --- |
1970   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
1971   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000广播<br>或者0xFFFF,用SN号指定答题器 |
1972   -| 4 | KCMD | 19 写键盘型号显示名称 |
1973   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1974   -| 9-24 | MODEL_NAME | 型号名称,最多16字符 |
1975   -||||
1976   -| 27-28 | CRC16 ||
1977   -
1978   -投票器回应:(广播时候不用)
1979   -
1980   -| **字节** | **标识符** | **描述** |
1981   -| --- | --- | --- |
1982   -| 1 | KEYCMD | 0xB0 投票器遥控指令应答 |
1983   -| 2-3 | KEYID | 投票器编号,2字节,高位在前(指令是指定编号的)<br>=0xFFFF,用SN应答 |
1984   -| 4 | KCMD | 19 写键盘型号显示名称 |
1985   -| 5-8 | SN | 答题器硬件序列号,4字节 |
1986   -| 9 | OK | 1 OK<br>0 失败,一般是不支持 |
1987   -| 10-25 | MODEL_NAME | 型号名称,最多16字符 |
1988   -||||
1989   -| 27-28 | CRC16 ||
1990   -
1991   -## 5.3 手机类设置
1992   -
1993   -### 5.3.1 服务器地址
1994   -
1995   -用于指定云平台服务器地址和端口。
1996   -
1997   -| **字节** | **标识符** | **描述** |
1998   -| --- | --- | --- |
1999   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2000   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2001   -| 4 | KCMD | 30 设置服务器地址 |
2002   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2003   -| 9 | MODE | 1 设置 2读取 |
2004   -| 10 |||
2005   -| 11-26 | DNS | 不包含HTTP的服务器地址和端口,最大16字符 |
2006   -| 27-28 | CRC16 | 效验值 |
2007   -
2008   -键盘应答:(广播的话不需应答)
2009   -
2010   -| **字节** | **标识符** | **描述** |
2011   -| --- | --- | --- |
2012   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2013   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2014   -| 4 | KCMD | 30 设置服务器地址 |
2015   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2016   -| 9 | MODE | 2读取应答 |
2017   -| 10 |||
2018   -| 11-26 | DNS | 不包含HTTP的服务器地址和端口,最大16字符 |
2019   -| 27-28 | CRC16 | 效验值 |
2020   -
2021   -### 5.3.2 GPS定位设置
2022   -
2023   -用于指定GPS定位参数。
2024   -
2025   -| **字节** | **标识符** | **描述** |
2026   -| --- | --- | --- |
2027   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2028   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2029   -| 4 | KCMD | 31 GPS定位设置 |
2030   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2031   -| 9 | MODE | 1 设置 2读取 |
2032   -| 10 | T1 | 定位间隔,多长时间获取1次定位数据,单位分钟 |
2033   -| 11 | T2 | 上报间隔,多长时间上报1次定位数据,单位分钟 |
2034   -| 12-15 | WORKT1 | 工作时段1,4字节,分别是开始小时、开始分钟、结束小时、结束分钟 |
2035   -| 16-19 | WORKT2 | 工作时段2,结构同上 |
2036   -||| 空 |
2037   -| 27-28 | CRC16 | 效验值 |
2038   -
2039   -键盘应答:(广播的话不需应答)
2040   -
2041   -| **字节** | **标识符** | **描述** |
2042   -| --- | --- | --- |
2043   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2044   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2045   -| 4 | KCMD | 31 GPS定位设置 |
2046   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2047   -| 9 | MODE | 2读取应答 |
2048   -| 10 | T1 | 定位间隔 |
2049   -| 11 | T2 | 上报间隔 |
2050   -| 12-15 | WORKT1 | 工作时段1 |
2051   -| 16-19 | WORKT2 | 工作时段2 |
2052   -||||
2053   -| 27-28 | CRC16 | 效验值 |
2054   -
2055   -### 5.3.3 通话设置
2056   -
2057   -用于设置通话参数。
2058   -
2059   -| **字节** | **标识符** | **描述** |
2060   -| --- | --- | --- |
2061   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2062   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2063   -| 4 | KCMD | 32 通话设置 |
2064   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2065   -| 9 | MODE | 1 设置 2读取 |
2066   -| 10 | T1 | 允许通话时长,单位分钟 |
2067   -| 11 | PH\_NUM | 亲情号码数目 |
2068   -| 12-15 | WORKT1 | 允许通话时段1,4字节,分别是开始小时、开始分钟、结束小时、结束分钟 |
2069   -| 16-19 | WORKT2 | 允许通话时段2,结构同上 |
2070   -||| 空 |
2071   -| 27-28 | CRC16 | 效验值 |
2072   -
2073   -键盘应答:(广播的话不需应答)
2074   -
2075   -| **字节** | **标识符** | **描述** |
2076   -| --- | --- | --- |
2077   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2078   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2079   -| 4 | KCMD | 32 通话设置 |
2080   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2081   -| 9 | MODE | 2读取应答 |
2082   -| 10 | T1 | 通话时长 |
2083   -| 11 | PH\_NUM | 亲情号码数目 |
2084   -| 12-15 | WORKT1 | 工作时段1 |
2085   -| 16-19 | WORKT2 | 工作时段2 |
2086   -||||
2087   -| 27-28 | CRC16 | 效验值 |
2088   -
2089   -### 5.3.4 短信设置
2090   -
2091   -用于设置短信参数。
2092   -
2093   -| **字节** | **标识符** | **描述** |
2094   -| --- | --- | --- |
2095   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2096   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2097   -| 4 | KCMD | 33 短信设置 |
2098   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2099   -| 9 | MODE | 1 设置 2读取 |
2100   -| 10 | MSG\_NUM | 短信保存条数 |
2101   -| 11 |||
2102   -| 12-15 | WORKT1 | 允许短信时段1,4字节,分别是开始小时、开始分钟、结束小时、结束分钟 |
2103   -| 16-19 | WORKT2 | 允许短信时段2,结构同上 |
2104   -||| 空 |
2105   -| 27-28 | CRC16 | 效验值 |
2106   -
2107   -键盘应答:(广播的话不需应答)
2108   -
2109   -| **字节** | **标识符** | **描述** |
2110   -| --- | --- | --- |
2111   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2112   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2113   -| 4 | KCMD | 33 短信设置 |
2114   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2115   -| 9 | MODE | 2读取应答 |
2116   -| 10 | MSG\_NUM | 短信保存条数 |
2117   -| 11 || 空 |
2118   -| 12-15 | WORKT1 | 工作时段1 |
2119   -| 16-19 | WORKT2 | 工作时段2 |
2120   -||||
2121   -| 27-28 | CRC16 | 效验值 |
2122   -
2123   -### 5.3.5 亲情号码设置
2124   -
2125   -用于设置亲情电话本号码参数。(号码数目在通话设置)
2126   -
2127   -| **字节** | **标识符** | **描述** |
2128   -| --- | --- | --- |
2129   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2130   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2131   -| 4 | KCMD | 34 亲情号码设置 |
2132   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2133   -| 9 | MODE | 1 设置号码 2读取号码 3设置姓名 4读取姓名 |
2134   -| 10 | NO | 电话本位置 1-10 |
2135   -| 11-26 | NAME_PHONE | 姓名或者电话,最大16字符,中文按GB2312编码 |
2136   -| 27-28 | CRC16 | 效验值 |
2137   -
2138   -键盘应答:(广播的话不需应答)
2139   -
2140   -| **字节** | **标识符** | **描述** |
2141   -| --- | --- | --- |
2142   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2143   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2144   -| 4 | KCMD | 34 亲情号码设置 |
2145   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2146   -| 9 | MODE | 2号码读取应答 4姓名应答 |
2147   -| 10 | NO | 电话本位置 |
2148   -| 11-26 | NAME_PHONE | 姓名或者电话,最大16字符,中文按GB2312编码 |
2149   -| 27-28 | CRC16 | 效验值 |
2150   -
2151   -### 5.3.6 快捷短信设置
2152   -
2153   -用于设置短信回复快捷短语。
2154   -
2155   -| **字节** | **标识符** | **描述** |
2156   -| --- | --- | --- |
2157   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2158   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2159   -| 4 | KCMD | 35 短信回复设置 |
2160   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2161   -| 9 | MODE | 1 设置2读取 |
2162   -| 10 | NO | 短语编号,一般1-9 |
2163   -| 11-26 | MSG | 回复短语,最大16字符,中文按GB2312编码,最多8汉字<br>例如 "收到"、"我到学校了"、"我放学了" |
2164   -| 27-28 | CRC16 | 效验值 |
2165   -
2166   -键盘应答:(广播的话不需应答)
2167   -
2168   -| **字节** | **标识符** | **描述** |
2169   -| --- | --- | --- |
2170   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2171   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2172   -| 4 | KCMD | 35 短信短语设置 |
2173   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2174   -| 9 | MODE | 2短信短语应答 |
2175   -| 10 | NO | 短语编号 |
2176   -| 11-26 | MSG | 短语内容 |
2177   -| 27-28 | CRC16 | 效验值 |
2178   -
2179   -### 5.3.7 工作日设置
2180   -
2181   -用于设置通话、短信规则起效果的工作日。
2182   -
2183   -| **字节** | **标识符** | **描述** |
2184   -| --- | --- | --- |
2185   -| 1 | KEYCMD | 0x30 表决器下载单包类指令 |
2186   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2187   -| 4 | KCMD | 36 工作日设置 |
2188   -| 5-8 | SN | 答题器硬件序列号,4字节(注意是4字节) |
2189   -| 9 | MODE | 1 设置2读取 |
2190   -| 10 | NO | 工作日规则编号<br> 1 周一到周五 <br>2 周一到周六 <br>3 周一到周日|
2191   -||||
2192   -| 27-28 | CRC16 | 效验值 |
2193   -
2194   -键盘应答:(广播的话不需应答)
2195   -
2196   -| **字节** | **标识符** | **描述** |
2197   -| --- | --- | --- |
2198   -| 1 | KEYCMD | 0xB0 表决器下载单包类指令 |
2199   -| 2-3 | KEYID | 答题器编号,用编号指定答题器,0000表示所有键盘都执行<br>或者0xFFFF,用SN号指定答题器 |
2200   -| 4 | KCMD | 36 工作日设置 |
2201   -| 5-8 | SN | 答题器硬件序列号,4字节 |
2202   -| 9 | MODE | 2读取应答 |
2203   -| 10 | NO | 工作日规则编号 |
2204   -||||
2205   -| 27-28 | CRC16 | 效验值 |
2206   -
2207   -## 5.4 T2Soc快速设置
2208   -
2209   -指令按64字节设计,除去4字节配对码和2字节CRC,指令58字节。
2210   -==第58字节为序号字节 SDK针对每个不同的SN 发送一条就COUNT++。1-255 循环
2211   -传输序号,用于键盘去重,SDK针对每个SN自增(1-255循环)==
2212   -指令码改用0x38。
2213   -
2214   -### 5.4.1 自定义文本显示
2215   -
2216   -用于修改答题器液晶显示。
2217   -
2218   -| **字节** | **标识符** | **描述** |
2219   -| --- | --- | --- |
2220   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2221   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2222   -| 6 | KCMD | 1 自定义三行文本 |
2223   -| 7 | SCMD(6Bit) | 具体下发类型:<br> 1:自定义姓名<br> 2:积分字符串 <br>3:积分五角星(0-7) <br>4:第二行文本(现已处理4=5)<br> 5:第二行文本(原用于提交之后,现已处理4=5)<br>6:第三行文本 |
2224   -| 7 | CONT(2Bit) | 0 :不操作 1:写入 2:清除 |
2225   -| 8-23 | TEXT | 16字节文本 |
2226   -| 24 | SCMD(6Bit)CONT(2Bit) ||
2227   -| 25-40 | TEXT ||
2228   -| 41 | SCMD(6Bit)CONT(2Bit) ||
2229   -| 42-57 | TEXT ||
2230   -
2231   -键盘应答:(广播的话不需应答)
2232   -
2233   -| **字节** | **标识符** | **描述** |
2234   -| --- | --- | --- |
2235   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2236   -| 2-5 | SN | 答题器SN |
2237   -| 6 | KCMD | 1 自定义三行文本应答 |
2238   -| 7-58 || Copy指令回复 |
2239   -
2240   -### 5.4.2 指定答题
2241   -
2242   -指定答题器进入特定答题模式,含自定义标题。
2243   -
2244   -| **字节** | **标识符** | **描述** |
2245   -| --- | --- | --- |
2246   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2247   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2248   -| 6 | KCMD | 2 指定答题 |
2249   -| 7 | DATAPOS | 从本字节开始16字节,等同于2.2节第4字节起的16字节 |
2250   -| 8 | MODE | 投票模式 |
2251   -| 9-26 | MODES | 投票参数 |
2252   -||||
2253   -| 27-42 | TITLE1 | 16字节自定义标题 |
2254   -| 43-58 | TITLE2 | 预留标题2 |
2255   -
2256   -键盘应答:(广播的话不需应答)
2257   -
2258   -| **字节** | **标识符** | **描述** |
2259   -| --- | --- | --- |
2260   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2261   -| 2-5 | SN | 答题器SN |
2262   -| 6 | KCMD | 2 指定答题应答 |
2263   -||||
2264   -| -58 |||
2265   -
2266   -### 5.4.3 外设控制
2267   -
2268   -| **字节** | **标识符** | **描述** |
2269   -| --- | --- | --- |
2270   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2271   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2272   -| 6 | KCMD | 3 外设控制 |
2273   -| 7 | LED_CTRL | LED是否本次指令控制 1是 0否 |
2274   -| 8 | LEDTIMES | LED灯闪烁次数,0是马上灭,255是长亮 |
2275   -| 9 | LED_TON | 每次开时间,单位0.1s,>1 |
2276   -| 10 | LED_TOFF | 每次关时间,单位0.1s,为0就是连续亮 |
2277   -| 11 | R | LED灯颜色 红值 |
2278   -| 12 | G | LED灯颜色 绿值 |
2279   -| 13 | B | LED灯颜色 蓝值 |
2280   -| 14 | BEEP_CTRL | 蜂鸣器是否本次指令控制 1是 0否 |
2281   -| 15 | BEEPTIMES | 蜂鸣器响次数 |
2282   -| 16 | BEEP_TON | 每次开时间,单位0.1s,>1 |
2283   -| 17 | BEEP_TOFF | 每次关时间,单位0.1s,为0就是连续震动 |
2284   -| 18 | MOTO_CTRL | 马达是否本次指令控制 1是 0否 |
2285   -| 19 | MOTO TIMES | 马达响次数 |
2286   -| 20 | MOTO _TON | 每次开时间,单位0.1s,>1 |
2287   -| 21 | MOTO _TOFF | 每次关时间,单位0.1s,为0就是连续震动 |
2288   -||||
2289   -
2290   -键盘应答:(广播的话不需应答)
2291   -
2292   -| **字节** | **标识符** | **描述** |
2293   -| --- | --- | --- |
2294   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2295   -| 2-5 | SN | 答题器SN |
2296   -| 6 | KCMD | 3 外设控制 |
2297   -||||
2298   -| -58 |||
2299   -
2300   -### 5.4.4 遥控关机
2301   -
2302   -| **字节** | **标识符** | **描述** |
2303   -| --- | --- | --- |
2304   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2305   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2306   -| 6 | KCMD | 4 遥控关机 |
2307   -||||
2308   -
2309   -### 5.4.5 遥改配对码(解绑)
2310   -
2311   -| **字节** | **标识符** | **描述** |
2312   -| --- | --- | --- |
2313   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2314   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2315   -| 6 | KCMD | 5 遥改配对码 |
2316   -| 6-9 | MatchCode | 4字节配对码(全0相当于清除配对码) |
2317   -||||
2318   -
2319   -### 5.4.6 通讯测试
2320   -
2321   -| **字节** | **标识符** | **描述** |
2322   -| --- | --- | --- |
2323   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2324   -| 2-5 | SN | 指定答题器的SN |
2325   -| 6 | KCMD | 6 通讯测试 |
2326   -| 7-8 | SendPos | 发送序号(改成整数,1000次) |
2327   -| 9-10 | RcvOk | 成功次数 |
2328   -
2329   -键盘应答:
2330   -
2331   -| **字节** | **标识符** | **描述** |
2332   -| --- | --- | --- |
2333   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2334   -| 2-5 | SN | 答题器SN |
2335   -| 6 | KCMD | 6 通讯测试 |
2336   -| 7-8 | SendPos | 接收到的发送序号,这样发送方好判断成功率 |
2337   -| -58 |||
2338   -
2339   -### 5.4.7 空指令
2340   -
2341   -本指令用于测试指令的传输是否漏,比如SDK向基站发送1000条,T2Soc基站会同时先模块传输,最终模块判断是空指令不会执行,只是返回收到指令的累加数量(通过LOG结果返回显示)
2342   -
2343   -| **字节** | **标识符** | **描述** |
2344   -| --- | --- | --- |
2345   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2346   -| 2-5 | SN | 指定答题器的SN |
2347   -| 6 | KCMD | 0 空指令,用于指令传输测试是否丢包 |
2348   -||||
2349   -||||
2350   -
2351   -### 5.4.8 键盘参数设置
2352   -
2353   -| **字节** | **标识符** | **描述** |
2354   -| --- | --- | --- |
2355   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2356   -| 2-5 | SN | 指定答题器的SN 全0是广播 |
2357   -| 6 | KCMD | 7 参数设置 |
2358   -| 7 | CID_ CTRL | 0 :不操作 1:写入 2:清除 3读取 |
2359   -| 8-9 | CID[2] | CID |
2360   -||||
2361   -
2362   -键盘应答:
2363   -
2364   -| **字节** | **标识符** | **描述** |
2365   -| --- | --- | --- |
2366   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2367   -| 2-5 | SN | 答题器SN |
2368   -| 6 | KCMD | 7参数设置 |
2369   -| 7 | CID_ CTRL | ----- |
2370   -| 8-9 | CID[2] | CID读取值 |
2371   -| -58 |||
2372   -
2373   -### 5.4.9 长姓名
2374   -
2375   -用于修改答题器液晶显示。
2376   -
2377   -| **字节** | **标识符** | **描述** |
2378   -| --- | --- | --- |
2379   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2380   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2381   -| 6 | KCMD | 8 长姓名下发 |
2382   -| 7 | NULL | 预留 |
2383   -| 8-55 | NAME | 长姓名字符串(48字节) |
2384   -| 56-58 | NULL | 预留 |
2385   -
2386   -键盘应答:(广播的话不需应答)
2387   -
2388   -| **字节** | **标识符** | **描述** |
2389   -| --- | --- | --- |
2390   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2391   -| 2-5 | SN | 答题器SN |
2392   -| 6 | KCMD | 8 长姓名下发 |
2393   -| 7-58 || Copy指令回复 |
2394   -
2395   -### 5.4.10 生僻字12号字体
2396   -
2397   -用于修改答题器液晶显示。
2398   -
2399   -| **字节** | **标识符** | **描述** |
2400   -| --- | --- | --- |
2401   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2402   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2403   -| 6 | KCMD | 20 生僻字12号字体 |
2404   -| 7-8 | GB_CODE1 | GB18030_编码 |
2405   -| 9-32 | GB_DATA1 | 点阵库数据(24字节) |
2406   -| 33-34 | GB_CODE2 | GB18030_编码 |
2407   -| 35-58 | GB_DATA2 | 点阵库数据(24字节) |
2408   -
2409   -键盘应答:(广播的话不需应答)
2410   -
2411   -| **字节** | **标识符** | **描述** |
2412   -| --- | --- | --- |
2413   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2414   -| 2-5 | SN | 答题器SN |
2415   -| 6 | KCMD | 20 生僻字12号字体 |
2416   -| 7-58 || Copy指令回复 |
2417   -
2418   -### 5.4.11设置键盘频点
2419   -
2420   -用于修改答题器频点,注意修改完频点之后,如果目标频点短时间内没基站则会离线。
2421   -
2422   -| **字节** | **标识符** | **描述** |
2423   -| --- | --- | --- |
2424   -| 1 | KEYCMD | 0x38 T2Soc下载单包类指令 |
2425   -| 2-5 | SN | 指定答题器的SN,全0是广播 |
2426   -| 6 | KCMD | 10设置键盘频点 |
2427   -| 7 | FREQ | 频点值 不为0 |
2428   -
2429   -键盘应答:(广播的话不需应答)
2430   -
2431   -| **字节** | **标识符** | **描述** |
2432   -| --- | --- | --- |
2433   -| 1 | KEYCMD | 0xB8 表决器下载单包类指令 |
2434   -| 2-5 | SN | 答题器SN |
2435   -| 6 | KCMD | 10设置键盘频点 |
2436   -| 7-58 || Copy指令回复 |
2437   -
2438   -## 5.5 S6体系快速设置
2439   -
2440   -### 5.5.1 信标总体格式
2441   -
2442   -下发信标格式:
2443   -
2444   -| **字节** | **标识符** | **描述** |
2445   -| --- | --- | --- |
2446   -|| **ATC( 4Byte )**|**配对码** |
2447   -| 1 | KEYCMD | 0x37 下载单包类指令(自动拼包版本) |
2448   -| 2-5 | SN | 指定答题器的SN,全0是广播(SDK提供) |
2449   -| 6 | PACKMAX | 后续传输包数量 此处为最大为3(最大支持三包连续,数据最大为:19+32+32 =83字节 = 基站每条指令缓存大小)指令按大小基站自动调整是发送一个包还是3个包(基站提供) |
2450   -| 7-8 | CRC16 | 本包透传数据的CRC CmdData 的CRC(基站提供) |
2451   -| 9 | Tr_Count | 传输序号,用于键盘去重,SDK针对每个SN自增(1-255循环)<br>//SDK断线从1重新开始,键盘重新与基站连接清0(SDK提供) |
2452   -| 10-28 | Cmd_Data | 第一包19字节(SDK提供) |
2453   -| 29-61 | Cmd_Data | 第二包32字节(SDK提供) |
2454   -| 62-93 | Cmd_Data | 第三包32字节(SDK提供) |
2455   -
2456   -备注: CmdData内可支持对同一个SN下发几条设置信息,只需保证字节长度不超过83字节。 数据越短速度越快。
2457   -
2458   -ACK格式:
2459   -
2460   -| **字节** | **标识符** | **描述** |
2461   -| --- | --- | --- |
2462   -|| **ATC ( 4Byte )**|**配对码** |
2463   -| 1 | KEYCMD | 0xB7下载单包类指令ACK(自动拼包版本) |
2464   -| 2-5 | SN | 指定答题器的SN |
2465   -| 6 | NULL | 预留 |
2466   -| 7-8 | NULL | 预留 |
2467   -| 9 | Tr_Count | 传输序号,用于键盘去重,基站针对每个SN自增(1-255循环)<br> ==对应下发信标== |
2468   -| 10-28 | NULL | 预留 |
2469   -
2470   -### 5.5.2 CMD概述
2471   -
2472   -| **字节** | **标识符** | **描述** |
2473   -| --- | --- | --- |
2474   -| 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><br>50:指定答题<br> 51:答题标题<br> 52:"发送中"预置 <br>53:"发送中"预置清<br> 54:"已发送"预置 <br>55:"已发送"预置清<br><br>60:订餐短消息 <br>61:恢复出厂设置<br><br>70生僻字12号字体|
2475   -| 1 | LEN | 长度(长度为Data长度,可为0) |
2476   -| N | Data | 数据详细内容 |
2477   -
2478   -#### 5.5.2.1 姓名写/清
2479   -
2480   -| **字节** | **标识符** | **描述** |
2481   -| --- | --- | --- |
2482   -| 1 | CMD | 类型 1:姓名写 2:姓名清 |
2483   -| 1 | LEN | 长度<br>写姓名长度最大83字节<br>清姓名长度为0 |
2484   -| N | Data | 数据详细内容 (LEN=0时没有Data) |
2485   -
2486   -#### 5.5.2.2 积分写/清
2487   -
2488   -| **字节** | **标识符** | **描述** |
2489   -| --- | --- | --- |
2490   -| 1 | CMD | 类型<br> 3:积分写<br> 4:积分清 |
2491   -| 1 | LEN | 长度<br>写积分长度最大16字节<br>清积分长度为0 |
2492   -| N | Data | 数据详细内容 (LEN=0时没有Data) |
2493   -
2494   -#### 5.5.2.3 积分五角星
2495   -
2496   -| **字节** | **标识符** | **描述** |
2497   -| --- | --- | --- |
2498   -| 1 | CMD | 类型<br> 5:积分五角星 |
2499   -| 1 | LEN | 1(固定长度1) |
2500   -| 1 | Data | 等级(0-6) |
2501   -
2502   -#### 5.5.2.4 积分爱心
2503   -
2504   -| **字节** | **标识符** | **描述** |
2505   -| --- | --- | --- |
2506   -| 1 | CMD | 类型<br> 6:写积分爱心 |
2507   -| 1 | LEN | 1(固定长度1) |
2508   -| 1 | Data | 等级(0-6) |
2509   -
2510   -#### 5.5.2.5 测验题分数
2511   -
2512   -| **字节** | **标识符** | **描述** |
2513   -| --- | --- | --- |
2514   -| 1 | CMD | 类型<br> 7:写测验题分数 |
2515   -| 1 | LEN | 2(固定长度2) |
2516   -| 2 | Data | 测验题分数精度0.1 最大6553.5 |
2517   -
2518   -#### 5.5.2.6 文本写/清
2519   -
2520   -| **字节** | **标识符** | **描述** |
2521   -| --- | --- | --- |
2522   -| 1 | CMD | 类型<br> 10:第二行文本写<br> 11:第二行文本清 <br>12:第三行文本写<br> 13:第三行文本清 |
2523   -| 1 | LEN | 文本字符串长度(清LEN=0) |
2524   -| 16 | TEXT | 最大16字节(目前键盘限制到16字节) |
2525   -
2526   -#### 5.5.2.7 外设控制
2527   -
2528   -| **字节** | **标识符** | **描述** |
2529   -| --- | --- | --- |
2530   -| 1 | CMD | 类型 <br>30:外设控制 LED LEN =6<br> 31:外设控制 BEEP LEN =3 <br>32:外设控制 MOTO LEN =3 |
2531   -| 1 | LEN | 长度 |
2532   -| 1 | LEDTIMES | 开关次数,0是马上关,255是一直开 |
2533   -| 1 | LED_TON | 每次开时间,单位0.1s,\>1 |
2534   -| 1 | LED_TOFF | 每次关时间,单位0.1s,为0就是连续开 |
2535   -| 1 | R | LED灯颜色 红值 LED才有 |
2536   -| 1 | G | LED灯颜色 绿值 LED才有 |
2537   -| 1 | B | LED灯颜色 蓝值 LED才有 |
2538   -
2539   -#### 5.5.2.8 遥控关机
2540   -
2541   -| **字节** | **标识符** | **描述** |
2542   -| --- | --- | --- |
2543   -| 1 | CMD | 类型 <br>40:遥控关机 |
2544   -| 1 | LEN | 长度 0 |
2545   -
2546   -#### 5.5.2.9 遥改配对码
2547   -
2548   -| **字节** | **标识符** | **描述** |
2549   -| --- | --- | --- |
2550   -| 1 | CMD | 类型<br> 41:遥改配对码 |
2551   -| 1 | LEN | 长度 4 |
2552   -| 4 | ATC | 配对码 |
2553   -
2554   -#### 5.5.2.10 键盘参数设置 - CID
2555   -
2556   -| **字节** | **标识符** | **描述** |
2557   -| --- | --- | --- |
2558   -| 1 | CMD | 类型<br> 42:键盘设置CID |
2559   -| 1 | LEN | 长度 2 |
2560   -| 2 | CID | 编号 |
2561   -
2562   -#### 5.5.2.11 指定答题
2563   -
2564   -正常单体的指定答题
2565   -
2566   -| **字节** | **标识符** | **描述** |
2567   -| --- | --- | --- |
2568   -| 1 | CMD | 类型<br> 50:指定答题 |
2569   -| 1 | LEN | 长度 LEN 后面的数据长度 |
2570   -| 1 | DATAPOS | ~~从本字节开始16字节,等同于2.2节第4字节起的16字节~~<br> ==这里保留,指定答题,SDK 不更改DataPos , 键盘根据基站下发包中提供的 Tr\_Count 作为去重(一次 SDK 指令键盘只生效一次)<br>基站响应指定投票时,不需要像 T2 一样关闭投票信标。不做特殊处理。将指定答题当成一包传输数据,并且数据不需要同步到信标中去。<br> 键盘处理,记录当前投票信标中的DataPos ,在这个过程中发生了指定答题之后,键盘再收到投票信标 DataPos 不变则不响应投票信标的内容。== |
2571   -| 1 | MODE | 投票模式 |
2572   -| N<18 | MODES | 投票参数 这里SDK是否可以优化,识别到不同的题目后面全0的省掉 减少LEN长度。 |
2573   -
2574   -#### 5.5.2.12 答题标题
2575   -
2576   -| **字节** | **标识符** | **描述** |
2577   -| --- | --- | --- |
2578   -| 1 | CMD | 类型<br>51:答题标题 (只能50指定答题打包在同一条内,固定为这次指定答题的标题) |
2579   -| 1 | LEN | 长度 LEN 后面的数据长度 |
2580   -| N | TEST | 文本 |
2581   -
2582   -#### 5.5.2.13 预置配置显示
2583   -
2584   -| **字节** | **标识符** | **描述** |
2585   -| --- | --- | --- |
2586   -| 1 | CMD | 类型<br> 52:"发送中"预置 <br>53:"发送中"预置清 <br>54:"已发送"预置<br> 55:"已发送"预置清 |
2587   -| 1 | LEN | 文本字符串长度(清LEN=0) |
2588   -| 16 | TEXT | 最大16字节(目前键盘限制到16字节) |
2589   -
2590   -#### 5.5.2.14 短消息下发
2591   -
2592   -| **字节** | **标识符** | **描述** |
2593   -| --- | --- | --- |
2594   -| 1 | CMD | 类型 60:订餐短消息。 |
2595   -| 1 | LEN | 文本字符串长度(清LEN=0) |
2596   -| 1 | NULL | 预留 |
2597   -| 1 | month | 月份 1 - 12 |
2598   -| 1 | date | 日期 1 - 31 |
2599   -| 16 | TEXT | 最大80字节 |
2600   -
2601   -#### 5.5.2.15 生僻字12号字体
2602   -
2603   -用于生僻字12号字体 字符下传。最多单条内支持三个生僻字。多的需要SDK拆包。
2604   -
2605   -只有一个生僻字下发时 只需根据LED长度设置即可
2606   -
2607   -| **字节** | **标识符** | **描述** |
2608   -| --- | --- | --- |
2609   -| 1 | CMD | 70生僻字12号字体 |
2610   -| 1 | LEN | 文本字符串长度(清LEN=0) 26/52/78 |
2611   -| 2 | GB_CODE1 | GB18030_编码 |
2612   -| 24 | GB_DATA1 | 点阵库数据(24字节) |
2613   -| 2 | GB_CODE2 | GB18030_编码 |
2614   -| 24 | GB_DATA2 | 点阵库数据(24字节) |
2615   -| 2 | GB_CODE3 | GB18030_编码 |
2616   -| 24 | GB_DATA3 | 点阵库数据(24字节) |
2617   -
2618   -#### 5.5.2.16 测验题补题答案
2619   -
2620   -逻辑,SDK进入测验结束时,自动判断谁漏题了,启用快速设置询问键盘该题,键盘若未达,则提交空答案
2621   -
2622   -| **字节** | **标识符** | **描述** |
2623   -| --- | --- | --- |
2624   -| 1 | CMD | 80答案补交 |
2625   -| 1 | LEN | 文本字符串长度(清LEN=0) |
2626   -| 1 | SendPos | 缺第几题 |
2627   -
2628   -#### 5.5.2.17 恢复出厂设置
2629   -
2630   -包含:
2631   -&emsp;&emsp;清空短信消息/姓名/分数/自定义信息等等 键盘内缓存不清除配对码
2632   -
2633   -| **字节** | **标识符** | **描述** |
2634   -| --- | --- | --- |
2635   -| 1 | CMD | 类型 61:恢复出厂设置 |
2636   -| 1 | LEN | 文本字符串长度(清LEN=0) |
2637   -| 1 | NULL | 预留 |
2638   -
2639   -# 六、下载多包类
2640   -
2641   -## 6.1 概述
2642   -
2643   -&emsp;&emsp;下载多包类主要用于下载一批数据。例如项目名称表、评议规则表等。
2644   -
2645   -&emsp;&emsp;我们统一使用《广播式下载方式》来下载多包(即数据表),具体原理参见《表决系统通讯协议-应用文档-原理》。
2646   -
2647   -## 6.2 进入和退出下载状态
2648   -
2649   -通知表决器进入下载模式的好处:
2650   -
2651   -1、在重新下载未成功的表决器时候,仅通知未成功的进入下载状态,其他成功的表决器就可以不处理下载数据;
2652   -
2653   -2、能立即知道是否在线,表决器可以准备擦除FLASH,V4.52对于支持文件下载的就按文件名称创建文件;
2654   -
2655   -3、退出时,表决器能知道下载完成。
2656   -
2657   -| **字节** | **标识符** | **描述** |
2658   -| --- | --- | --- |
2659   -| 1 | DOWNCMD | 0x40 下载多包类指令 |
2660   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>一般要指定表决器编号使指定键盘进入或退出下载状态<br>但0x0000广播时候,键盘也执行<br>FF01到FFFE时候,是用序列号指定键盘 V4.74<br>低位字节01-FE,表示下载次序,由SDK管理,新下载变化一次,<br>键盘收到的时候,记录下,同时,此次序也出现在下载数据包中,这样键盘可判断是否是我可以下载的数据,避免上次下载状态没正常退出而错误接受数据 |
2661   -| 4 | DOWNCMD | 1 进入或退出下载状态 |
2662   -| 5 | DOWNTYPE | 多包类型 |
2663   -| 6 | DOWNID | 数据包标识码 |
2664   -| 7 | DCMD | 模式 1进入下载 0退出下载 |
2665   -| ~~8-24~~ | ~~INFO~~ | ~~在DOWNTYPE=40下载文件模式时候,是下载文件名称,16字符~~ |
2666   -| 8-13 | SN | 序列号模式时候,6字节键盘序列号,用于指定键盘<br>对教育新体系,后4字节SN有效,前2字节FFFF<br>暂不支持文件下载 |
2667   -| 14-23 | BIN_INFO | 在DOWNTYPE=30固件升级模式,待下载固件的信息定义:1BYTE可升硬件版本 + 3BYTE待升固件版本 + 2BYTE待升固件校验字(CRC-16) + 4BYTE待升固件大小,共10字节<br>其他模式参数无意义 |
2668   -||||
2669   -| 27-28 | CRC16 | 这里如果有值不等于0,表示指令带效验,从1计算到26字节<br>这里如果是0,或者数据包只有24字节,表示老体系的不带效验<br>本章节后面,长度24字节的,都可以变成28字节,不修改文档了 |
2670   -
2671   -表决器回应结果状态:
2672   -
2673   -| **字节** | **标识符** | **描述** |
2674   -| --- | --- | --- |
2675   -| 1 | DOWNCMD | 0xC0 下载多包类指令应答 |
2676   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>不是0000也不是FFFF,是要询问的表决器的编号<br>FFFF 表示用SN号代表键盘 |
2677   -| 4 | DOWNCMD | 1回应下载状态 |
2678   -| 5 | DOWNTYPE | 多包类型 |
2679   -| 6 | DOWNID | 数据包标识码 |
2680   -| 7 | DCMDACK | 现在模式 1已经进入下载模式 0已经退出下载模式 |
2681   -| 8-24 | SN | 使用SN号模式时候,键盘的SN,6字节否则参数无意义 |
2682   -
2683   -## 6.3 广播式下载数据包和查询状态
2684   -
2685   -具体原理参见《表决系统通讯协议-应用文档-原理》。
2686   -下载数据包指令结构如下:
2687   -
2688   -| **字节** | **标识符** | **描述** |
2689   -| --- | --- | --- |
2690   -| 1 | DOWNCMD | 0x40 下载多包类指令 |
2691   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>0xFFFF的时候是部分表决器下载,是常用模式,进入下载模式的表决器才处理数据 <br>0x0000时候是广播下载,所有表决器都接收和处理<br>其他值是指定下载,编号和KEYID相同的才处理数据<br>FF01到FFFE时候,是序列号模式 V4.74<br>低位字节和进入下载模式时候的低位字节相同,用于键盘判断是否是当前下载数据 |
2692   -| 4 | DOWNCMD | 2 广播式下载具体数据 |
2693   -| 5 | DOWNTYPE | 多包类型 |
2694   -| 6 | DOWNID | 数据包标识码<br>文件下载模式时候是最高位地址 V4.52<br>由于非文件下载模式PACKH加上PACKL,只能下载65536字节,文件下载模式为支持大文件,用DOWNID作为高位地址,可以下载16384K字节 |
2695   -| 7 | PACKH | 数据段编号,0-255 |
2696   -| 8 | PACKL | 数据片编号, 0-15 |
2697   -| 9-24 | PACKDATA | 16字节的数据 |
2698   -||||
2699   -| 27-28 | CRC16 | 这里如果有值不等于0,表示指令带效验,从1计算到26字节<br>这里如果是0,或者数据包只有24字节,表示老体系的不带效验<br>本章节后面,长度24字节的,都可以变成28字节,不修改文档了 |
2700   -
2701   -备注:
2702   -1. 投票器先判断PACKH是否发生变化,发生变化就表示新的16片数据下载开始了,要把标志16片段下载成功状态的OKBITS全置1;
2703   -2. 然后计算地址,把PACKDATA16字节数据写到指定位置,对于非文件下载,地址=(PACKH\*16+PACKL)\*16,对于文件下载,地址=((DOWNID\*256+PACKH)\*16+PACKL)\*16;
2704   -3. 然后把OKBITS中对应PACKL的比特位置0表示已经对应片段下载成功,用于应答下面的下载状态询问指令
2705   -
2706   -询问下载成功状态指令结构:
2707   -
2708   -| **字节** | **标识符** | **描述** |
2709   -| --- | --- | --- |
2710   -| 1 | DOWNCMD | 0x40 下载多包类指令 |
2711   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>使用键盘编号模式时候,不是0000也不是FFFF,是要询问的表决器的编号<br>FFFF,使用SN号询问键盘 |
2712   -| 4 | DOWNCMD | 3 询问广播式下载的执行状态 |
2713   -| 5 | DOWNTYPE | 多包类型 |
2714   -| 6 | DOWNID | 数据包标识码 |
2715   -| 7 | PACKH | 数据段编号 |
2716   -| 8-24 | SN | 指定键盘的SN号,6字节参数无意义 |
2717   -
2718   -表决器回应下载成功状态:
2719   -
2720   -| **字节** | **标识符** | **描述** |
2721   -| --- | --- | --- |
2722   -| 1 | DOWNCMD | 0xC0 下载多包类指令应答 |
2723   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br>不是0000也不是FFFF,是要询问的表决器的编号<br>FFFF,使用SN号回答 |
2724   -| 4 | DOWNCMD | 3 回应广播式下载的执行状态 |
2725   -| 5 | DOWNTYPE | 多包类型 |
2726   -| 6 | DOWNID | 数据包标识码 |
2727   -| 7 | PACKH | 数据段编号 |
2728   -| 8-9 | OKBITS_L<br>OKBITS_H | 下载成功状态,共16Bit,代表0-15号数据片,Bit=0表示下载成功<br>注意是低位字节在前,例如OKBITS_L=3,OKBITS_H=128时候,表示第1、2、16个数据片没下载成功,即0、1号和15号数据片不成功 |
2729   -| 10-24 | SN | 指定键盘的SN号,6字节<br>不是SN模式时参数无意义 |
2730   -
2731   -## 6.4 数据包类型分类
2732   -
2733   -通过DOWNTYPE和DOWNID两个字节的组合,可以决定下载数据包的类型。
2734   -
2735   -下面列出目前使用的几种类型。具体数据包的格式和含义,请参见《数据表规范-政务商务》。
2736   -
2737   -| **DOWNTYPE 值**| **DOWNID 值** | **数据包类型** |
2738   -| --- | --- | --- |
2739   -| ~~1~~ | ~~1~~ | ~~固定编号项目名称表~~ |
2740   -| ~~1~~ | ~~2~~ | ~~随机名称编号表~~ |
2741   -| ~~1~~ | ~~3~~ | ~~二维评测指标名称表~~ |
2742   -| ~~2~~ | ~~1~~ | ~~评议规则表~~ |
2743   -| ~~2~~ | ~~2~~ | ~~评议规则说明信息表~~ |
2744   -| ~~3~~ | ~~1~~ | ~~评分规则表~~ |
2745   -| ~~3~~ | ~~2~~ | ~~评分规则说明信息表~~ |
2746   -||||
2747   -| 10 | 变化 | 即时信息 |
2748   -| 11 | 变化 | 短消息 |
2749   -| 12 || 股东信息 |
2750   -||||
2751   -| **20** | **变化** | **多题答案数据** |
2752   -| **21** | **变化** | **测验 100 题的纯多选模式答案** |
2753   -||||
2754   -| **30** | **0** | **键盘固件升级 bin 文件** |
2755   -| **31** | **0** | **T2 键盘升级 bin 文件(每片传输不是 16 字节)** |
2756   -| **32** | **0** | **T2 模块升级 bin 文件** |
2757   -||||
2758   -| 40 | 高位地址 | 指定文件名称(可含目录)下载文件 |
2759   -| 50 || xPad的透传多包信息 |
2760   -
2761   -### 6.4.1 关于即时信息短信的特殊说明
2762   -
2763   -即时信息定义为马上显示在屏幕上的信息,不保存,看完即丢。
2764   -
2765   -短信定义为保存的,可查看,即时显示或提醒。
2766   -
2767   -下载数据包指令结构不变,但DOWNID和PACKH含义不同:
2768   -
2769   -| **字节** | **标识符** | **描述** |
2770   -| --- | --- | --- |
2771   -| 1 | DOWNCMD | 0x40 下载多包类指令 |
2772   -| 2-3 | KEYID | 表决器编号,2字节,高位在前<br> 0x0000时候是广播发信息,所有表决器都接收和处理,不需进入下载模式 <br>0xFFFF的时候是对多个表决器发信息,已经进入下载模式的才处理其他值是指定下载,编号和KEYID相同的才接收信息 |
2773   -| 4 | DOWNCMD | 2 广播式下载具体数据 |
2774   -| 5 | DOWNTYPE | 固定为10即时信息或11短信 12股东信息 50是xPad透传多包信息,一般是字符串信息20 多题答案数据 |
2775   -| 6 | DOWNID | 发一次信息就变化一次,表决器据此可知道是新的信息来了 |
2776   -| 7 | PACKH | 数据片总数,0表示1,F表示最多16片,也就是所短信息最多256字符,但一般限定64字符以内 |
2777   -| 8 | PACKL | 0-15,当前发送的数据片的编号 |
2778   -| 9-24 | PACKDATA | 16字节的数据 |
2779   -
2780   -&emsp;&emsp;对于短信接收,表决器只要判断DOWNTYPE为10或11,然后DOWNID和以前的不同,就知道是新短信过来,并根据PACKH知道信息的长度,建立新的下载状态位。
2781   -
2782   -&emsp;&emsp;然后根据PACKH判断所有片段是否都接收完毕,可以自动显示。
2783   -
2784   -&emsp;&emsp;对于广播给所有表决器的信息,表决器不需单个单个进入下载模式,由SDK控制各片段信息多广播几次,表决器自己判断接收完整就显示。
2785   -
2786   -&emsp;&emsp;对应指定单个表决器发信息,为提高速度,不对表决器执行进入下载模式,但要查询下载状态,确保信息完整下载,并且不执行退出下载模式。
2787   -
2788   -&emsp;&emsp;对应指定多个表决器发信息,就必须进入下载模式,然后下载,然后查询,为提高下载速度,对表决器不执行退出下载模式。
2789   -
2790   -&emsp;&emsp;所以,因为不执行退出下载状态,要注意的是,表决器要对短信模式下的进入下载状态要单独处理,避免和指定多个的表决器下载项目名称表等其他操作搞混。
2791   -
2792   -### 6.4.2 多题答案
2793   -
2794   -&emsp;&emsp;多题答案广播的处理方式,和6.4.1节的即时信息处理是一样的,按ID=0000广播方式处理,键盘也不需先进入下载模式,但DOWNTYPE值是专用的20。键盘收到完整的答案信息后,自动进行对错判断处理和显示。
2795   -
2796   -&emsp;&emsp;下载的数据的内部格式,和 2.4.1节的多题答案相同。
2797   -
2798   -&emsp;&emsp;软件调用流程,是先打开持续监听信标开关,然后启动测验的多题模式,键盘按键后进入作答,时间到后,软件调用测验停止,然后启动多题答案发送流程,SDK广播信息的次数,根据实际测试情况调整,保证99%键盘正确收到,然后软件调用停止投票进入空闲模式。考虑到需求上,键盘在考试完毕后需要重新显示答案信息,答案信息保存入EEPROM为好。
2799   -
2800   -### 6.4.3 100题纯多选答案
2801   -
2802   -&emsp;&emsp;多题答案广播的处理方式,和6.4.1节的即时信息处理是一样的,按ID=0000广播方式处理,键盘也不需先进入下载模式,但DOWNTYPE值是专用的21。键盘收到完整的答案信息后,自动进行对错判断处理和显示。
2803   -
2804   -&emsp;&emsp;下载的数据的内部格式,和 2.4.3节的100题多选答案相同。
2805   -
2806   -&emsp;&emsp;软件调用流程,是先打开持续监听信标开关,然后启动测验的多题模式,键盘按键后进入作答,时间到后,软件调用测验停止,然后启动多题答案发送流程,SDK广播信息的次数,根据实际测试情况调整,保证99%键盘正确收到,然后软件调用停止投票进入空闲模式。考虑到需求上,键盘在考试完毕后需要重新显示答案信息,答案信息保存入EEPROM为好。
2807   -
2808   -### 8.4.4 键盘固件升级
2809   -
2810   -键盘升级流程:(软件控制)
2811   -
2812   -1. 键盘开机
2813   -2. 软件启用2.2.7节在线测试的模式3,带SN号状态报告,获取所有开机的键盘的SN号及固件版本信息;——报告状态中需要增加硬件版本信息域
2814   -3. 人工确认开始无线升级
2815   -4. 软件调用6.2节指令,按SN模式,告诉键盘进入无线升级固件下载模式,键盘可以显示固件下载中,逐个操作键盘进入固件下载模式(键盘中将严格比对,硬件版本号是否适合升级、固件版本号是否适合升级。符合升级要求则启动升级,否则不进入升级——避免同一固件多次升级或者硬件版本的不支持等情况)
2816   -5. 软件调用6.3节流程, ~~按~~~~ SN模式~~ 按照0xFF01-FFFE方式对启动升级功能的键盘,实行固件数据包广播(DOWNTYPE=30,按文件方式,DOWNID是高位地址),并查询键盘,最终保证每个键盘的固件能下载成功,当然也有失败的
2817   -6. 软件用6.2节的退出下载指令,按SN模式,让键盘退出下载模式,同时键盘自己启动固件升级过程;
2818   -7. 软件回到2.2.7节的在线扫描模式3,读取升级完成的键盘的SN号和版本号,版本成功的显示升级正确;——报告状态中需要增加硬件版本信息域
2819   -8. 软件可以指定SN关闭键盘,然后对升级不成功的键盘,尝试下一轮升级,人工同意的情况下
2820   -
2821   -由于固件长度不一,这里只定义文件的前16字节含义:
2822   -
2823   -| **字节** | **标识符** | **描述** |
2824   -| --- | --- | --- |
2825   -| 1 | BINTYPE | 格式号,暂固定=0xF0 |
2826   -| 2-9 | MODELNAME | 键盘型号字符串,8字节,用于上位机软件显示<br>例如S6plus |
2827   -| 10 | HMODEL | 键盘的型号代码,一定要和键盘型号代码相同<br>用于上位机软件,判断连接的键盘是否适合升级这个固件 |
2828   -| 11 | HVER | 键盘硬件版本 |
2829   -| 12-14 | SVER | 键盘软件版本,3字节,10进制数字<br>一定要和固件内部版本号相同,便于上位机软件好对比版本,知道键盘升级成功 |
2830   -| 15-16 | CRC-16 | 固件校验字 |
2831   -
2832   -## 6.5 透传升级
2833   -
2834   -### 6.5.1 概述
2835   -
2836   -**流程:准备 -> 开始 -> 透传 -> 询问 -> 补传 -> 结束**
2837   -
2838   -**准备阶段:** 只在基站端 键盘无感知 监听到相对干净的信道。(这阶段现阶段不设计,后续可根据实际情况看是否添加)
2839   -
2840   -**开始阶段:** 在升级频点,开始4S广播告知键盘开始传输,包含数据量长度 总CRC 数据类型 本轮传输POS等信息。
2841   -
2842   -**透传阶段:** 以100MS为间隔,1K为单位 发送2-3次 循环 直到发送完所有数据。
2843   -
2844   -**询问阶段:** 透传完成之后,开始询问键盘接收进度。(Bit表表示)已收全键盘不回复基站。
2845   -
2846   -**补传阶段:** 根据bit表透传键盘漏收数据/并重复询问与透传直到接收完成或者超时。
2847   -
2848   -**结束阶段:** 发送4S广播告知键盘升级结束可以结束固件升级。
2849   -
2850   -BIN文件头类型总结:
2851   -
2852   -T2-KEYBOARD-BIN- &emsp;原始16字节头 不带任何信息
2853   -
2854   -T2-BIN-XX.XX.XX &emsp;16字节带版本号信息的头(ST版本)
2855   -
2856   -T2-GDB-XX.XX.XX &emsp;16字节带版本号信息的头(GD版本)
2857   -
2858   -T2 &emsp;&emsp;&emsp;&emsp;&emsp;表示改BIN支持的类型 识别符
2859   -
2860   -BIN/GDB &emsp;&emsp;表示改型号下 不同的MCU 类型 BIN文件识别符
2861   -
2862   -| HEAD | 含义 | HW |
2863   -| --- | --- | --- |
2864   -| T2-BIN | T2_ST版本BIN文件 | 71 |
2865   -| T2-GDB | T2_GD版本BIN文件 | 72 |
2866   -
2867   -### 6.5.2 广播开始/结束
2868   -
2869   -| **字节** | **标识符** | **描述** |
2870   -| --- | --- | --- |
2871   -| 4 | ATC | 配对码 |
2872   -| 1 | DOWNCMD | 0x42 透传下载多包方式 |
2873   -| 1 | DOWNTYPE | 透传多包类型 1 固件下载 |
2874   -| 1 | DOWNPOS | 透传序号 不能为0 1-255基站自增(新的一轮升级) |
2875   -| 1 | DOWNACT | 1进入透传 2退出透传(只ST支持)<br> 11进入透传 12退出透传 (区分硬件型号的开始升级,用于兼容以前未做GD和ST区分升级的兼容)<br>基站处理:针对S6 若SDK下发HW为空 则使用 1/2 ,不为空则使用11/12} |
2876   -| 6 | SN | 6字节键盘序列号,用于指定键盘<br>对教育新体系,前2字节FFFF后4字节SN有效,全0表示所有键盘 |
2877   -| 4 | DOWNLEN | 4BYTE待升固件大小 |
2878   -| 2 | DOWNCRC | 2BYTE待升固件校验字(CRC-16) |
2879   -| 1 | SendPos | 发送序号 |
2880   -| 1 | HW | 硬件版本 -> (区分硬件,键盘自己识别) |
2881   -| 3 | SW | 固件版本 |
2882   -| 5 | 预留 ||
2883   -| 2 | CRC16 ||
2884   -
2885   -### 6.5.3 透传数据
2886   -
2887   -| **字节** | **标识符** | **描述** |
2888   -| --- | --- | --- |
2889   -| 4 | ATC | 配对码 |
2890   -| 4 | MATCHCODE | 核准匹配码 0xfe 48 de 7f |
2891   -| 1 | PACKMAX | 后续传输包数量 此处为32 |
2892   -| 1 | DOWNCMD | 0x01 透传数据传输 |
2893   -| 2 | CRC16 | 本包透传数据的CRC |
2894   -| 1 | DOWNPOS | 透传序号 不能为0 1-255基站自增(新的一轮升级) |
2895   -| 1 | DOWNCount | 当前包序号 0开始 |
2896   -| 1 | $\color {red} {HW} $ | $\color {red} {硬件版本 (区分硬件,键盘自己识别)} $ |
2897   -| 17 | 预留 ||
2898   -| 1024 | DownData | 透传数据 暂定 1K |
2899   -
2900   -### 6.5.4 询问
2901   -
2902   -2包32
2903   -
2904   -| **字节** | **标识符** | **描述** |
2905   -| --- | --- | --- |
2906   -| 4 | ATC | 配对码 |
2907   -| 4 | MATCHCODE | 核准匹配码 0xfe 48 de 7f |
2908   -| 1 | PACKMAX | 后续传输包数量 此处为1 |
2909   -| 1 | DOWNCMD | 0x02 透传询问带回复SN |
2910   -| 2 | CRC16 | 计算 所有SN区域的CRC校验 |
2911   -| 1 | Pos | 询问序号从1开始累计 不等于0 |
2912   -| 1 | $\color {red} {HW} $ | $\color {red} {硬件版本 (区分硬件,键盘自己识别)} $ |
2913   -| 2 | NULL | 预留 |
2914   -| 48 | SN | 4字节键盘序列号,用于回复上一轮已收到的键盘SN号12个SN |
2915   -
2916   -### 6.5.5 键盘回复
2917   -
2918   -2包32
2919   -
2920   -(已收齐键盘不响应回复)
2921   -
2922   -| **字节** | **标识符** | **描述** |
2923   -| --- | --- | --- |
2924   -| 4 | ATC | 配对码 |
2925   -| 4 | MATCHCODE | 核准匹配码 7f de 48 0xfe |
2926   -| 1 | PACKMAX | 后续传输包数量 此处为1 |
2927   -| 1 | DOWNCMD | 0x82 透传键盘询问回复 |
2928   -| 2 | CRC16 | LostBuf 的校验和 |
2929   -| 4 | SN | 4字节SN |
2930   -| 1 | $\color {red} {HW} $ | $\color {red} {硬件版本} $ |
2931   -| 15 | 预留 ||
2932   -| 32 | LostBuf | Bit 位判断收齐数组,单位1K 1表示没收到 0表示收到 最多256K |
2933   -
2934   -## 6.6 透传多包(题干)
2935   -
2936   -&emsp;&emsp;用类似透传升级的方法,来实现多包数据对键盘的下载,例如带题干内容的题型数据的下载,往往可能4K字节,相比2.4节的广播信息信标1包只能16字节,透传数据包的传输效率差不多高一倍。
2937   -
2938   -步骤如下:
2939   -
2940   -1. 基站以1K字节为单位(透传数据包的单位),广播所有数据,执行N遍,也可以每1K广播N次,然后下1K字节;
2941   -2. 转投票信标环节,表示业务开始,例如测验,这样接收完整的键盘就可以开始答题了;
2942   -3. 没接收完整的键盘,或者后开机的键盘,就在投票信标环节发申请重播,包含哪些1K字节没收到的信息;
2943   -4. 基站自动重播键盘没收到的数据段M遍,然后继续第2步骤;
2944   -
2945   -# 七、版本历史
2946   -
2947   -V0.5新体系基本框架。
2948   -
2949   -V0.6增加发信息信标(基站控制的广播信息,用于快速传递信息,2.4节),但综合考虑,多题答案下载,还是先用老体系的多包下载流程,由SDK完成,见6.4.2节。
2950   -
2951   -V0.7 1. 对码模式快速配对可带密码(2.2.11节) 2. 考勤由基站控制开关(2.2.1节) 3 考勤频率和功率由基站控制 ~~4. 键盘后期需增加液晶老化测试,基站需支持该命令~~ 4、基站控制键盘不关机
2952   -
2953   -V0.8增加3.2.9节键盘主动发信模式,同时2.3节确认信标,补充了S61考勤开关、心跳开关;3.2.8节考勤定位数据包减少到6字节;
2954   -
2955   -V0.85 增加白名单模式支持,基站带监听信道的,3.2.4键盘登录加了白名单模式3,对应应答处理增加了2.3.2节确认包带信息;3.2.5节状态报告增加键盘编号ID用于测试
2956   -
2957   -V0.9版本对应S6plus体系修改: 3.2节序列号结果,增加0x94模式,同时传SN和ID号;点赞举手原来3.2.6节支持,增加一种键码发送方式;2.2.12抢答模式增加键值抢答;2.2.13测验中的多题模式5,由于S6Plus多选是去重的,所以增加排序模式4;3.2.4节登录信息增加CH-UID模式;对应CH-UID模式,增加5.2.4节表决器授权指令(和政务SN地址有点不同);增加5.2.6节读写姓名,12字符;测验100题纯多选答案,增加6.4.3节和2.4.3节;键盘无线升级,修改6.4节多包下载类型,增加6.4.4节固件升级流程说明和格式定义;2.3.2节白名单基站确认包信息修改成可支持多个键盘确认;
2958   -
2959   -V0.91 3.2.3节增加能龙多题数据说明;
2960   -
2961   -V0.92 5.2.1节增加固定配对模式和白名单模式切换指令(优化信标控制后可以不用);2.2.1节投票信标里面Mode值修改成可区分白名单基站和普通配对基站;5.2.4节键盘授权指令增加白名单键盘重新登录控制(用于白名单基站换名单后,前面在线键盘需要重新登录);
2962   -
2963   -测验多题里面,增加32题目题型控制,有主观题不可作答,但多选选项数目固定
2964   -
2965   -【V0.95增加wifi语音答题器相关功能】
2966   -
2967   -1、投票模式增加2.2.15语音答题、2.2.16分组PK模式
2968   -
2969   -2、键盘管理类增加5.2.11-16节—wifi服务器信息、遥控绑定和解绑、分组设置、外设控制、文字自定义显示、获取调试信息,完善5.1节里面的模式列表
2970   -
2971   -3、概述补充完善数据打包格式,增加用于传递语音数据的大包格式;
2972   -
2973   -4、3.2.10增加语音录音数据类型;3.2.3节增加分组PK答案的说明;
2974   -
2975   -5、3.2.5节状态报告信息,增加学号信息,仅用于wifi体系
2976   -
2977   -6、2.2.7节在线测试增加wifi底层数据收发测试模式
2978   -
2979   -【V0.96】
2980   -
2981   -1. 抢答模式修正,原先模式1是带按键值抢答,应该是3,否则和抢红包等冲突
2982   -2. 2.1节投票信标增加控制关机时间4档,同时2.3.1节确认信标也增加
2983   -
2984   -【V0.97】
2985   -
2986   -1、3.2节序列号结果类,加上CRC16效验值,但暂不支持字符串结果类型
2987   -
2988   -### 【V0.99】-【V1.0】
2989   -
2990   -迈向V1.0的pre版本,根据K1键盘设计新的特性,新加蛮多
2991   -
2992   -1. 基站下发指令加上效验,避免空中数据出错,2.2节投票信标加效验;下载单包、上传单包、下载多包统统加上效验,但可以K1开始支持;
2993   -2. 支持新基站广播信息包,以完成题型下载、答案下载等大数据下发,但必须同样数据
2994   -
2995   -细化2.4节,细化2.4.1节题型控制,2.4.2节答案下发,删除2.4.3节bit位答案;3.2.6节增加键盘申请基站重新广播数据
2996   -
2997   -1. 第2.2.13节测验题支持模式9快速小测、模式10题号分段、模式11自动测试模式;
2998   -2. 第2.2.12抢答模式增加字母数字显示、游戏模式,可自定义名称,指定按键,去重规则;
2999   -3. 第2.2.2空闲模式增加即时反馈细节、状态监控细节;
3000   -4. 第2.2.6节数字评分支持上下限和格式化,K1支持;
3001   -5. 第2.2.10节填空增加字母填空、数字填空、自动测试;
3002   -6. 5.2.8节显示增加闪烁显示用于找投票器;5.2.6节增加写金币数,可设置总的和这次增减的;
3003   -7. 第2.2.5节判断题增加显示模式√/×;增加5.2.7节用于即时反馈的按键等级自定义;
3004   -8. 增加3.2.11节,带电量数据格式,而且数字题支持16位数字;
3005   -9. 单选多选、判断、数字、排序、填空增加大小题号信息;
3006   -10. 3.2.5节状态报告单独分出SN+ID+姓名,用于生产排查;
3007   -11. 3.2.3节完善字符串提交带效验,设计新类型格式;
3008   -12. 无线升级键盘报告升级成功?--使用状态报告即可,键盘主流程做
3009   -13. 2.12节抢答增加自动测试,满足速度测试要求
3010   -14. 99_3 2.2.12节抢答抢红包,应青果要求增加是否允许修改
3011   -15. 2.15节录音增加自动测试模式
3012   -16. 2.7节增加锐捷键盘蓝牙芯片MAC地址读写
3013   -17. 99_4 3.2.3节字符串结果支持课后练习单题提交结果;2.2.14节收作业支持课后练习单题提交自动测试;
3014   -18. 2.14节收作业支持多科目带日期以及自动测试,3.2.7节申请多包提交支持多个家庭作业
3015   -19. 2.15节语音题增加语音红包模式
3016   -20. 99_5 2.2.12节抢答模式增加青果OK键抢红包的说明,和3.2.11节多题结果增加OK按键确认提交不再修改的特殊说明;多选模式补充多2个测试模式和极域模式(老S62极域版本支持?)
3017   -21. 99_5 5.2.6节增加清除姓名,语音增加16Kspeex
3018   -22. 99_6 2.2.13测验增加小测模式12,支持64题目题型
3019   -23. 99_6 2.2.8单选多选增加网龙模式,显示定项或不定项
3020   -
3021   -【V0.99_7】
3022   -
3023   -高思语音答题器增加很多功能特性,需要扩展投票信标,用2.2.17节实现
3024   -
3025   -1、所有题型都需要支持设置6个汉字—2.2.17节
3026   -
3027   -2、抢答功能需要支持判断题—2.2.12节增加
3028   -
3029   -3、多题功能需要支持30道题,可以设置题目类型单选、多选、判断、语音答题所有题型
3030   -
3031   -4、需要支持震动设置,开机震动,刷卡震动,启动答题震动
3032   -
3033   -5、需要支持蜂鸣设置,开机蜂鸣,刷卡蜂鸣,启动答题蜂鸣
3034   -
3035   -6、需要支持LED设置,可设置指示灯开启/关闭
3036   -
3037   -7、需要支持心跳包设置,此处是否可以用定时报告状态处理?如果OK,则不需要修改协议—按状态报告做
3038   -
3039   -8、需要支持写批次号,此处是不是用极域的OEM信息处理?如果是,则不需要修改协议—按OEM做
3040   -
3041   -9、2.2.1节投票信标增加锐捷的请教申请控制位
3042   -
3043   -【V0.99_8】完善基站广播信息包协议
3044   -
3045   -1、2.4节广播命令码改0x31、0x32,原0x41、0x42(AES加密用了0x40类)
3046   -
3047   -2、2.2.13-2节广播信息类型确定答案下发支持键盘得分,但答案和得分是分别下载,这样,答案可以提前先下载到基站
3048   -
3049   -3、2.4.2节答案下发格式修改成答案用字符串
3050   -
3051   -4、增加2.2.13-3键盘得分表格式
3052   -
3053   -5、完成5.2.15文字自定义显示指令,可用于抢红包结果显示,后面修改成4字节SN,以支持高思要求8汉字
3054   -
3055   -【V0.99_9】针对A1键盘功能,手写协议等
3056   -
3057   -1、增加2.2.18节手写投票模式
3058   -
3059   -2、2.2.1节完善文档,把2.2.17节扩展信标信息附上说明,控制震动、背光等
3060   -
3061   -3、200题型格式修改,2.4.1节,测验名称支持到16中文,题型加语音、手写----但测验里面的手写、语音怎么传输?还是可以动态传输,只是数据带题号
3062   -
3063   -4、在5.2.14节指定键盘外设动作,增加麦克风和手写
3064   -
3065   -5、单选多选等增加题号显示模式
3066   -
3067   -6、2.4.1节200题型,增加A1用的版本
3068   -
3069   -【V0.99_10】
3070   -
3071   -1、2.2.17节扩展信标,增加了新东方的自定义题型名称
3072   -
3073   -2、增加 2.4.4节的乐教乐学多题题型格式
3074   -
3075   -3、新东方泡泡,2.2.12节抢答游戏模式,对游戏按键做详细说明,以满足快速按键测试
3076   -
3077   -4、游戏按键模式增加自动测试
3078   -
3079   -5、泡泡,心跳用状态报告,加开关机状态,3.2.5节
3080   -
3081   -6、泡泡,一键唤醒,补充到空闲模式2.2.2节,原先高思实现过
3082   -
3083   -7、5.2.3节遥控关机,增加支持是否进入遥控开机模式
3084   -
3085   -【V0.99_11】
3086   -
3087   -1、5.2.16节乐教乐学,给替换键盘回写已答题内容
3088   -
3089   -2、3.2.6节完善键盘申请基站重新广播信息信标(题目内容),可指定全部或部分
3090   -
3091   -【V0.99_12】
3092   -
3093   -1、增加指定题号取数据,临时解决漏题问题;
3094   -
3095   -【V0.99_13】
3096   -
3097   -1、增加5.3节手机参数设置类
3098   -
3099   -【V0.99_14】
3100   -
3101   -1、2.2.17扩展信标增加指定答题器答题,并修改信标发送方式在0x17前而不是交替
3102   -
3103   -2、支持图片拍照
3104   -
3105   -【V0.99_15】
3106   -
3107   -1、2.3.1节确认包,支持带CRC,可解决200题测验丢题并保持老协议键盘兼容
3108   -
3109   -2、图片拍照支持自动多次测试
3110   -
3111   -3、图片拍照加压缩等级,用于判断原图好不好
3112   -
3113   -【V0.99_16】
3114   -
3115   -1、指定键盘答题,有键盘可能先收到0x17投票启动指令,会出现投票界面闪一下,由于也有同时用到多种扩展信标的情况,所以0x17用剩余的1bit告诉键盘要收多条扩展信标,2.2.17的扩展信标原NULL字节改成bit位告诉键盘这次有哪些内容(多条)要完整接收;
3116   -
3117   -2、5.2.6节读写个人信息加清除金币小模式
3118   -
3119   -3、5.2.6节读写姓名增加8汉字模式,原只能6汉字
3120   -
3121   -4、针对扫描模式带姓名,原3.2.3节由于crc位置只能传10字节5汉字的问题,做了解决方案的调整,3.2.5节可传16字符,但基站CRC要做兼容调整
3122   -
3123   -5、空闲模式补充了高思停止模式下,第7字节是刚才投票模式参数
3124   -
3125   -【V0.99_17】
3126   -
3127   -1、判断题增加错题本小模式,2.2.5节
3128   -
3129   -2、投票信标增加积分显示屏蔽控制位,2.2.1节
3130   -
3131   -【V0.99_18】
3132   -
3133   -1、2.2.2节空闲模式-增加停止显示自定义信息
3134   -
3135   -2、2.2.17-1节自定义题型名称增加频点信息
3136   -
3137   -3、修改投票信标里面积分显示控制描述,因为T1lite实际做反了
3138   -
3139   -【V0.99_19】
3140   -
3141   -多选增加科大讯飞10小题模式
3142   -
3143   -BCD码增加空格、负号的定义
3144   -
3145   -【V0.99_20】
3146   -
3147   -1、确定5.2.15节文本自定义显示,用于T2答题后回显自定义文字信息
3148   -
3149   -2、增加和补充2.2.19 T2扩展信标,可自定义答题开始和提交ok后提示语
3150   -
3151   -3、5.2.6写个人信息增加单题得分显示
3152   -
3153   -4、2.4.4节200题格式增加题号显示模式,第9字节
3154   -
3155   -【V0.99_21】
3156   -
3157   -1、多选修改迫选模式,增加可重复选项,等同于排序题
3158   -
3159   -2、签到模式增加可指定按键
3160   -
3161   -3、多选模式增加10小题判断题模式
3162   -
3163   -4、增加键盘固件升级成功和失败结果类型,3.2.12节
3164   -
3165   -【V0.99_22】
3166   -
3167   -1、设计用于T2Soc的统一的单包设置指令,5.4节
3168   -
3169   -【V0.99_23】
3170   -
3171   -1、修改5.4.1 自定义文本显示
3172   -
3173   -2、修改5.4.3 外设控制加马达
3174   -
3175   -3、增加5.4.8 键盘CID设置
3176   -
3177   -4、增加5.2.19写键盘OEM型号名称
3178   -
3179   -【V0.99_24】
3180   -
3181   -增加4.6节键盘多包上传透传模式(李傲寒设计)
3182   -
3183   -【V0.99-25】
3184   -
3185   -1、语音模式,多1字节,控制是否录音完毕要提交OK确认
3186   -
3187   -2、空闲模式,增加控制中英文切换
3188   -
3189   -3、5.2.7节增加出厂日期信息
3190   -
3191   -【V0.99-26】
3192   -
3193   -1、修改5.4.1节自定义文本显示
3194   -
3195   -2、增加5.4.9 长姓名下载
3196   -
3197   -3、2.2.12节抢答增加指定按键
3198   -
3199   -4、修改4.6节透传多包上传,和基站配合
3200   -
3201   -5、录音增加语音质量测试模式
3202   -
3203   -【V0.99-28】
3204   -
3205   -1、2.4.4节多题型格式,增加带上限的全数字题模式,用于给老师打分
3206   -
3207   -2、2.2.6数字模式加上下限
3208   -
3209   -3、2.2.2节空闲模式,中英文设置修改
3210   -
3211   -【V0.99-29】题干
3212   -
3213   -1. 增加6.6节透传多包流程说明
3214   -2. 增加2.2.13-3节带题干内容的测验模式
3215   -3. 2.13-3节同时增加离线下载模式,确保离线下载每个键盘成功;和接收离线答题结果模式
3216   -4. 键盘请求3.2.6节增加透传多包申请重播和全部下载ok报告
3217   -5. 增加2.4.5节带题干内容的测验题型结构
3218   -
3219   -【V0.99-30】
3220   -
3221   -1. 增加5.4.10 T2语音答题器的生僻字下载
3222   -
3223   -【V0.99-31】
3224   -
3225   -1. 增加5.5 章节S6体系快速设置,包含指定标题、部分预置设置,并添加12号生僻字字库数据下载。
3226   -2. 修改2.2.8 选择投票模式信标 怎么MODE1=30的可设置键盘上次答案的投票测试方式
3227   -3. 将2.2.13-2小节内答案下发指令修改成30
3228   -4. 5.4章节添加数据包内最后一个字节(第58字节)解释:为COUNT传输序号位。(已实现并使用,补充文档)
3229   -5. 2.2.1添加投票信标第24位 低四位表示休眠周期位。当前信标处于WCT中的第几个周期
3230   -6. 增加2.5章节 投票数据的附加信息发送方式
3231   -7. 补充快速下发爱心与测验题分数
3232   -8. 5.5.2.16 测验题补题逻辑
3233   -9. ATTRIB1修改BIT6位改成登录允许位置
3234   -10. 新增5.5.2.17 键盘恢复出厂设置
3235   -
3236   -【V0.99-32】
3237   -
3238   -1、3.2.5 3.2.11 添加第21位发送次数,键盘自身统计,SDK显示。
3239   -
3240   -2.修改3.2.5 SendPos到第17字节
3241   -