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 -