Commit 6d80349f63fcb0ecc19078ef50174373cc0101fb

Authored by 李傲寒
1 parent 8bbd538f

V1.0.0

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