孙向锦 / VoteC5

  package com.sunvote.cmd.app;
  
  import com.sunvote.cmd.BaseCmd;
  import com.sunvote.cmd.ICmd;
  import com.sunvote.cmd.push.PushBaseCmd;
  
  import java.io.ByteArrayOutputStream;
  import java.util.Arrays;
  
  /**
   * Created by Elvis on 2017/8/29.
   * Email:Eluis@psunsky.com
   * 版权所有：长沙中天电子设计开发有限公司
   * Description:平板模块键盘投票功能模块
   *
   * 6.1 概述
   下载多包类主要用于下载一批数据。例如项目名称表、评议规则表等。
   我们统一使用《广播式下载方式》来下载多包（即数据表），具体原理参见《表决系统通讯协议-应用文档-原理》。
   6.2 进入和退出下载状态
   通知表决器进入下载模式的好处：
   1、在重新下载未成功的表决器时候，仅通知未成功的进入下载状态，其他成功的表决器就可以不处理下载数据；
   2、能立即知道是否在线，表决器可以准备擦除FLASH，V4.52对于支持文件下载的就按文件名称创建文件；
   3、退出时，表决器能知道下载完成。
  
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   一般要指定表决器编号使指定键盘进入或退出下载状态
   但0x0000广播时候，键盘也执行
   FF01到FFFE时候，是用序列号指定键盘 V4.74
   低位字节01-FE，表示下载次序，由SDK管理，新下载变化一次，
   键盘收到的时候，记录下，同时，此次序也出现在下载数据包中，这样键盘可判断是否是我可以下载的数据，避免上次下载状态没正常退出而错误接受数据
   4	DOWNCMD	1 进入或退出下载状态
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	DCMD	模式 1进入下载 0退出下载
   8-24	FILENAME	在DOWNTYPE=40下载文件模式时候，是下载文件名称，16字符
   其他模式参数无意义
   SN	序列号模式时候，6字节键盘序列号，用于指定键盘
   暂不支持文件下载
  
   表决器回应结果状态：
   字节	标识符	描述
   1	DOWNCMD	0xC0 下载多包类指令应答
   2-3	KEYID	表决器编号，2字节，高位在前
   不是0000也不是FFFF，是要询问的表决器的编号
   FFFF 表示用SN号代表键盘
   4	DOWNCMD	1回应下载状态
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	DCMDACK	现在模式  1已经进入下载模式  0已经退出下载模式
   8-24	SN	使用SN号模式时候，键盘的SN，6字节
   否则参数无意义
  
  
   6.3 广播式下载数据包和查询状态
   具体原理参见《表决系统通讯协议-应用文档-原理》。
   下载数据包指令结构如下：
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   0xFFFF的时候是部分表决器下载，是常用模式，进入下载模式的表决器才处理数据
   0x0000时候是广播下载，所有表决器都接收和处理
   其他值是指定下载，编号和KEYID相同的才处理数据
   FF01到FFFE时候，是序列号模式 V4.74
   低位字节和进入下载模式时候的低位字节相同，用于键盘判断是否是当前下载数据
   4	DOWNCMD	2 广播式下载具体数据
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   文件下载模式时候是最高位地址 V4.52
   由于非文件下载模式PACKH加上PACKL，只能下载65536字节，文件下载模式为支持大文件，用DOWNID作为高位地址，可以下载16384K字节
   7	PACKH	数据段编号，0-255
   8	PACKL	数据片编号， 0-15
   9-24	PACKDATA	16字节的数据
   备注：
   1、	投票器先判断PACKH是否发生变化，发生变化就表示新的16片数据下载开始了，要把标志16片段下载成功状态的OKBITS全置1；
   2、	然后计算地址，把PACKDATA16字节数据写到指定位置，对于非文件下载，地址=(PACKH*16+PACKL)*16，对于文件下载，地址=（（DOWNID*256+PACKH）*16+PACKL)*16;
   3、	然后把OKBITS中对应PACKL的比特位置0表示已经对应片段下载成功，用于应答下面的下载状态询问指令
  
   询问下载成功状态指令结构：
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   使用键盘编号模式时候，不是0000也不是FFFF，是要询问的表决器的编号
   FFFF，使用SN号询问键盘
   4	DOWNCMD	3 询问广播式下载的执行状态
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	PACKH	数据段编号
   8-24	SN	指定键盘的SN号，6字节
   参数无意义
  
   表决器回应下载成功状态：
   字节	标识符	描述
   1	DOWNCMD	0xC0 下载多包类指令应答
   2-3	KEYID	表决器编号，2字节，高位在前
   不是0000也不是FFFF，是要询问的表决器的编号
   FFFF，使用SN号回答
   4	DOWNCMD	3 回应广播式下载的执行状态
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	PACKH	数据段编号
   8-9	OKBITS_L
   OKBITS_H	下载成功状态，共16Bit，代表0-15号数据片，Bit=0表示下载成功
   注意是低位字节在前，例如OKBITS_L=3，OKBITS_H=128时候，表示第1、2、16个数据片没下载成功，即0、1号和15号数据片不成功
   10-24	SN	指定键盘的SN号，6字节
   不是SN模式时参数无意义
  
   6.4 数据包类型分类
   通过DOWNTYPE和DOWNID两个字节的组合，可以决定下载数据包的类型。
   下面列出目前使用的几种类型。具体数据包的格式和含义，请参见《数据表规范-政务商务》。
   DOWNTYPE值	DOWNID值	数据包类型
   1	1	固定编号项目名称表
   1	2	随机名称编号表
   1	3	二维评测指标名称表
   2	1	评议规则表
   2	2	评议规则说明信息表
   3	1	评分规则表
   3	2	评分规则说明信息表
  
   10	变化	即时信息
   11	变化	短消息
   12	页号	屏幕点阵显示信息
   12	1或2	股东信息
  
   20	1	空闲液晶信息
   20	2	开机信息
  
   30	1	汉字自造字字库，16x16点阵
   31	1	多国语言资源包（未实现）
  
   40	高位地址	指定文件名称（可含目录）下载文件
   50		xPad的透传多包信息
  
   6.4.1 关于即时信息和短信的特殊说明
   即时信息定义为马上显示在屏幕上的信息，不保存，看完即丢。
   短信定义为保存的，可查看，即时显示或提醒。
   下载数据包指令结构不变，但DOWNID和PACKH含义不同：
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   0x0000时候是广播发信息，所有表决器都接收和处理，不需进入下载模式
   0xFFFF的时候是对多个表决器发信息，已经进入下载模式的才处理
   其他值是指定下载，编号和KEYID相同的才接收信息
   4	DOWNCMD	2 广播式下载具体数据
   5	DOWNTYPE	固定为10即时信息或11短信
   50是xPad透传多包信息，一般是字符串信息
   6	DOWNID	发一次信息就变化一次，表决器据此可知道是新的信息来了
   7	PACKH	数据片总数，0表示1，F表示最多16片，也就是所短信息最多256字符，但一般限定64字符以内
   8	PACKL	0-15，当前发送的数据片的编号
   9-24	PACKDATA	16字节的数据
  
   对于短信接收，表决器只要判断DOWNTYPE为10或11，然后DOWNID和以前的不同，就知道是新短信过来，并根据PACKH知道信息的长度，建立新的下载状态位。
   然后根据PACKH判断所有片段是否都接收完毕，可以自动显示。
   对于广播给所有表决器的信息，表决器不需单个单个进入下载模式，由SDK控制各片段信息多广播几次，表决器自己判断接收完整就显示。
   对应指定单个表决器发信息，为提高速度，不对表决器执行进入下载模式，但要查询下载状态，确保信息完整下载，并且不执行退出下载模式。
   对应指定多个表决器发信息，就必须进入下载模式，然后下载，然后查询，为提高下载速度，对表决器不执行退出下载模式。
   所以，因为不执行退出下载状态，要注意的是，表决器要对短信模式下的进入下载状态要单独处理，避免和指定多个的表决器下载项目名称表等其他操作搞混。
   6.4.2 桌牌点阵显示信息数据格式
   桌牌点阵显示信息一般是按规则排布的点阵亮灭二进制字节数据。例如96x32点阵的显示屏，实际的数据是96x32/8=384字节。为保证以后点阵屏幕变更，在实际点阵数据前加16字节的格式说明。
  
   字节	标识符	描述
   1	TYPE	点阵格式
   1	96x32点阵，（排列方式？）
   2-16		根据点阵格式有不同含义，暂时为空
   17-…	BITMAP	显示点阵数据，根据不同格式有不同的长度
  
   这样，如果格式为1，实际要传输的数据是16+384=400字节。
   6.4.3 股东信息
   特定型号需要显示股东姓名等信息。
   请参考6.4.1节短信，下载方法一样，就是国外应用需要考虑unicode编码，所以DOWNID来标志。
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   0x0000时候是广播发信息，所有表决器都接收和处理，不需进入下载模式
   0xFFFF的时候是对多个表决器发信息，已经进入下载模式的才处理
   其他值是指定下载，编号和KEYID相同的才接收信息
   FF01到FFFE时候，是用序列号指定键盘 V4.77
   （采用SN号模式下载股东信息时候，键盘先进入下载状态，参见6.6节序列号下载多包方法，和6.2节进入和退出下载状态）
   4	DOWNCMD	2 广播式下载具体数据
   5	DOWNTYPE	12 股东信息
   6	DOWNID	0 GB2312编码
   1 UTF8编码
   2 Unicode编码
   7	PACKH	数据片总数，0表示1，F表示最多16片，也就是所短信息最多256字符，但一般限定64字符以内
   8	PACKL	0-15，当前发送的数据片的编号
   9-24	PACKDATA	16字节的数据
  
   6.5 简单下载模式（不使用）
   简单下载方式只是作为解决方案提出，因为效率比广播式低，没有采用。
   下载数据包指令结构如下：
   字节	标识符	描述
   1	DOWNCMD	0x40 下载多包类指令
   2-3	KEYID	表决器编号，2字节，高位在前
   必须指定一个具体的表决器编号
   4	DOWNCMD	4 简单下载模式
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	PACKH	数据段编号
   8	PACKL	0-7，数据片编号
   9-24	PACKDATA	16字节的数据
  
   表决器回应下载成功状态：
   字节	标识符	描述
   1	DOWNCMD	0xB0 下载多包类指令应答
   2-3	KEYID	表决器编号，2字节，高位在前
   不是0000也不是FFFF，是要询问的表决器的编号
   4	DOWNCMD	4 回应下载状态
   5	DOWNTYPE	多包类型
   6	DOWNID	数据包标识码
   7	PACKH	数据段编号
   8	PACKL	0-7，数据片编号
   9	STATUS	1 成功
   0 不成功
   10-24		参数无意义
  
   6.6 序列号下载多包
   键盘使用序列号模式时，也分广播、指定多个、指定单个键盘下载。
   指定多个，修改了6.2节指定键盘进入下载状态和退出下载状态，可用SN号指定，同样，6.3节的询问下载结果，修改为同样支持SN号。而下载数据，仍然沿用原来的ID=FFFF，在下载模式的才接受。
   指定单个，包含到指定多个里面，这样，即使单个发短信，也要先进入下载模式。
   广播，则沿用ID=0000的原来模式。
   然后，发现一个问题，如果上次键盘没能正常退出下载模式，就有可能错误接受数据，包括原来使用键盘编号的，都有这个可能。所以，进入和退出下载模式，广播数据时，原来的FFFF改为FF01到FFFE，低字节01-FE表示次序，SDK管理，下载一次改变一次，这样键盘就能判断数据是不是这次的，同时如果不是，键盘改自己次序为0。
  
   *
   */
  public class MutiPkgDownCmd extends BaseCmd {
  
  
      /***
       * 下载数据包指令结构如下：
       字节	标识符	描述
       1	DOWNCMD	0x40 下载多包类指令
       2-3	KEYID	表决器编号，2字节，高位在前
       0xFFFF的时候是部分表决器下载，是常用模式，进入下载模式的表决器才处理数据
       0x0000时候是广播下载，所有表决器都接收和处理
       其他值是指定下载，编号和KEYID相同的才处理数据
       FF01到FFFE时候，是序列号模式 V4.74
       低位字节和进入下载模式时候的低位字节相同，用于键盘判断是否是当前下载数据
       4	DOWNCMD	2 广播式下载具体数据
       5	DOWNTYPE	多包类型
       6	DOWNID	数据包标识码
       文件下载模式时候是最高位地址 V4.52
       由于非文件下载模式PACKH加上PACKL，只能下载65536字节，文件下载模式为支持大文件，用DOWNID作为高位地址，可以下载16384K字节
       7	PACKH	数据段编号，0-255
       8	PACKL	数据片编号， 0-15
       9-24	PACKDATA	16字节的数据
  
       * @return
       */
  
      public static  final  byte DOWNCMD = 0x40 ;
  
      private byte cmd = DOWNCMD;
  
      private byte[] keyId = new byte[2];
  
      private byte downType ;
  
      private byte downid ;
  
      private byte packh;
  
      private byte packl;
  
      private byte[] packdata = new byte[16];
  
      /**
       * 1 进入或退出下载状态
       * 2 广播式下载具体数据
       * 3 询问广播式下载的执行状态
       */
      private byte cmd1 ;
  
      @Override
      public byte[] toBytes() {
          ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
          try{
              outputStream.write(getCmd());
              outputStream.write(getKeyId());
              outputStream.write(getCmd1());
              outputStream.write(getDownType());
              outputStream.write(getDownid());
              outputStream.write(getPackh());
              outputStream.write(getPackl());
              outputStream.write(getPackdata());
              return outputStream.toByteArray();
          }catch (Exception e){}
          return new byte[0];
      }
  
      @Override
      public ICmd parseCmd(byte[] source, int start) {
          if(source.length > start){
              setCmd(source[start]);
          }
          if(source.length > start + 2){
              setKeyId(Arrays.copyOfRange(source,start+2,start+4));
          }
          if(source.length > start + 4){
              setCmd1(source[start+4]);
          }
          if(source.length > start + 5){
              setDownType(source[start+5]);
          }
          if(source.length > start + 6){
             setDownid(source[start+6]);
          }
          if(source.length > start + 7){
              setPackh(source[start+7]);
          }
          if(source.length > start + 8){
              setPackl(source[start+8]);
          }
          if(source.length > start + 24){
              setPackdata(Arrays.copyOfRange(source,start+9,start+24));
          }
          return this;
      }
  
      public static MutiPkgDownCmd parseRequest(byte[] bytes, int length){
          MutiPkgDownCmd mutiPkgDownCmd = new MutiPkgDownCmd();
          mutiPkgDownCmd.parseCmd(bytes);
          return mutiPkgDownCmd;
      }
  
      public byte getCmd() {
          return cmd;
      }
  
      public void setCmd(byte cmd) {
          this.cmd = cmd;
      }
  
      public byte[] getKeyId() {
          return keyId;
      }
  
      public void setKeyId(byte[] keyId) {
          this.keyId = keyId;
      }
  
      public byte getDownType() {
          return downType;
      }
  
      public void setDownType(byte downType) {
          this.downType = downType;
      }
  
      public byte getDownid() {
          return downid;
      }
  
      public void setDownid(byte downid) {
          this.downid = downid;
      }
  
      public byte getPackh() {
          return packh;
      }
  
      public void setPackh(byte packh) {
          this.packh = packh;
      }
  
      public byte getPackl() {
          return packl;
      }
  
      public void setPackl(byte packl) {
          this.packl = packl;
      }
  
      public byte[] getPackdata() {
          return packdata;
      }
  
      public void setPackdata(byte[] packdata) {
          this.packdata = packdata;
      }
  
      public byte getCmd1() {
          return cmd1;
      }
  
      public void setCmd1(byte cmd1) {
          this.cmd1 = cmd1;
      }
  }