Commit 8f3821b1b89e2f2d0402f37819da3aa3e6a250d2

Authored by 李外
0 parents

V0.99-32

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