孙向锦 / public

  # C200K
  
  [TOC]
  
  # 1. 前言
  
    
  ## 1.1 背景
  
  方便客户基于C200K基站设备使用 通信基站数据接收及解析。
  
    
  ## 1.2 编写目的
  
  此说明书是为了说明协议内容，开发流程，方便基于此进行二次开发。
  
   
  ##  1.3 读者对象
  
  1. 相关研发人员
  2. 方案制定人员
  3. 决策人员
  
  
  # 2. 开发流程
  
  C200K基站，采用MQTT协议进行开发，基站接入MQTT服务器，应用从MQTT服务器下发指令和接收数据
  
  整个交互图如下:
  
  ![](img/mqtt_1.png)
  
    
  ## 2.1 MQTT服务器准备
  
  MQTT服务器要求：
  

  厂家使用<a href="https://www.emqx.io/get-started" target="_blank" >EMQX </a>进行测试

  能够正常收发MQTT数据。
  
  服务器的性能参数由业务决定。
  
  域名：
  
  公网域名或ip或者基站所处局域网ip。
  
  MQTT服务器配置结果检查
  
  使用MQTT.FX客户端，配置域名，端口，用户名和密码信息，然后连接，如果提示连接成功，则表示MQTT服务器可用。基站clientid 是基站编号。
  
  ![](img/mqtt_2.png)
  
    
  ## 2.2 基站配置
  
  通过USB连接基站，打开基站服务器配置软件。
  
  ![](img/mqtt_3.png)
  

  如果基站没有连接电脑，工具显示检测基站中，这时候读写无效。
  
  连接正常后，按照各个信息进行写入。
  
  设置基站服务器域名（ip）、端口，用户信息、密码信息，写入基站。
  
  如果MQTT服务器没有启用用户密码验证，用户密码信息可以随机设置。
  
  拔掉USB，连接网线，接入网络，查看网络是否连接正常。（基站上面的灯是否蓝色闪烁）
  

  如果选用POE供电，请使用标准的POE（48V）供电
  
  ![](img/mqtt_7.png)
  
  

  基站说明
  
  ![](img/mqtt_4.png)
  

  服务器IP设置<a href="/Elvis/public/blob/master/soft/SunVote 服务器IP设置 1.0.1.2.exe" target="_blank" >软件下载</a>

    
  ## 2.3 应用开发
  
  整体开发流程图如下：
  
  ![](img/mqtt_5.png)
  
  
  # 3. 功能清单
  
    
  ## 3.1 支持的功能清单
  
  | **功能** | **说明** |
  | --- | --- |
  | 授时 | 给基站校时 |
  | 基站上下线 | 基站上下线信息 |
  | 键盘上下线 | 键盘上下线信息 |

  | 基站信息设置与读取 | 基站信息设置与读取 |
  | 基站信息上报 | 基站信息上报 |
  | 基站错误信息上报 | 基站错误信息上报 |
  | 键盘上线 | 键盘上线 |

  | 读取白名单 | 读取白名单 |
  | 添加白名单 | 添加白名单 |
  | 删除白名单 | 删除白名单 |
  | 清空白名单 | 清空白名单 |

  | 基站复位 | 基站复位 |

  | 签到 | 键盘签到 |

  | 单题 | 下发一题练习 |

  | 抢答 | 抢答 |
  | 多级题号多题 | 多级题号多题 |

  | 基站升级 | 基站固件升级 |
  | 键盘升级 | 键盘固件升级 |

  | 文本下发 | 文本下发 |
  | 学生卡信息上报 | 学生卡信息上报 |

  | 下发生避字 | 下发生避字 |

  
    
  ## 3.2 协议简介
  
      
  ### 3.2.1 MQTT
  
  关于MQTT说明，请参考 https://mqtt.org/
  
  ${clinetId} clinetId 是基站编号，为替换字符串。
  
        

  #### 3.2.1.1 应用程序发布的主题

  | 主题 | 功能 |

  | --- | --- |
  | /client/${clientId}/operate | 基站的设置，查询等指令 |
  | /lesson/class/${clinetId}/receive | 接收答题的指令 |
  
        

  #### 3.2.1.2 应用程序订阅的主题

  | 主题 | 功能 |

  | --- | --- |
  | /client/${clientId}/online | 基站上线通知。 |
  | /client/${clientId}/offline | 基站下线通知。 |
  | /client/${clientId}/card/online | 答题器上线通知。 |

  | /client/${client}/operate  | 对基站进行设置或查询信息 |

  | /client/${clientId}/report | 基站主动上报状态，或者对设置指令的回应。 |

  | /lesson/class/${clinetId}/receive | 基站对答题的设置 |

  | /lesson/class/${clinetId}/send | 基站对答题的反馈 |
  | /client/${clientId}/error | 基站错误信息上报 |
  
      
  ### 3.2.2 协议格式
  
  ![](img/mqtt_6.png)
  
  协议采用json格式，数据中字段见属性介绍。
  
      
  ### 3.2.3 指令属性介绍
  
  | 名称 | 类型 | 说明 |
  | --- | --- | --- |

  | i | number | 消息指令类型（instruction），取值范围： 1-9999。 <br> i = 3 添加白名单 <br> i = 4 删除白名单 <br> i = 5 清除白名单 <br> i = 11 停止 <br> i = 12开启答题 <br> i = 13 接收答题数据 <br> i = 14 键盘上线  <br> i = 17 基站升级 <br> i = 18 升级报告 <br> i = 19 授时 <br>  i = 20 设置基站信息 <br> i = 21基站信息上报 <br> i = 22基站错误信息上报 <br> i = 28 键盘升级 <br> i = 29 键盘升级报告 <br> I= 30 读取白名单 <br> I= 31 白名单上传 <br> i = 40 基站上线 <br> i = 41 基站下线  <br> i = 60 文本下发 <br> i = 61 文本下发返回|

  | m | object | 答题消息的内容(message) 对象或数组 <br> 数组对象，一般与分包结合，分包原则是发送的json数据不要超过1k，如果超过1k，基站将无法接收。 大数据将采用分包发送，每包的数据不超过1k|

  | c | string | 答题器的序号(card) |

  | t | number | 时间戳(10位timestamp) 单位秒 需要先校时 |

  | qm | number | 模式(question model)取值范围：<br> 0：停止 <br> 1：单题  <br> 7：签到 <br> 14：多级编号答题 |

  | qt | number | 题型（question type），取值范围： <br> 0：字母单选 <br> 1：字母多选 <br> 2：数字题 <br> 3：判断题 <br> 5：抢答 <br> 7: 自判题判断题 |

  | qs | number | 该题型数量（question sum），单题为1，多题则为实际数量。 |
  | qn | number | 题目序号(question No)，题目顺序号 |
  | dn | string | display no 显示编号，键盘上显示的题目编号|

  | a | string | 答案（answer）<br> 示例：字母单选：A  <br> 字母多选：A&#124;B&#124;C |

  | en | string | 练习（考试）编号(exercise No)每次考试或者练习的唯一编号，用于确定提交的答案属于那次练习。 |
  | on | number | 单选和多选题的选项数量(option no) |
  | cid | string | 客户端ID(client Id) |
  | cm | string | 客户端型号(client Model) |
  | cv | string | 客户端版本(client Version)基站软件版本号 |
  | f | number | 信道频点(frequency) 基站频点取值：1-80 |

  | content | string | 题干内容（选项信息都包含在此），中文信息用hex进行传输。内容前面需要 hex:详见后面示例 |

  | sn | string | sn  序列号 |

  | et | number | 错误类型et =1 基站频点冲突 |
  | em | string | 错误消息em = "3" 配合et使用，如et=1 em=3 表示3号频点冲突 |

  | success | number | 0 成功  -1 错误/失败 -2 基站忙 |

  ### 3.2.4 分包示例
  
  如果要下发第二行文本，一次业务需要下发50个键盘。

  正常组包，基站将会接收失败：

  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 1,
  	"current": 1,
  	"qs": 50,
  	"m": [{
  		"sn": "2126833671",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833672",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833673",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833674",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833675",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833676",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833677",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833678",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833679",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833680",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833681",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833682",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833683",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833684",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833685",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833686",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833687",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833688",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833689",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833690",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833691",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833692",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833693",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833694",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833695",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833696",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833697",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833698",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833699",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833700",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833701",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833702",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833703",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833704",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833705",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833706",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833707",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833708",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833709",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833710",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833711",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833712",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833713",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833714",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833715",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833716",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833717",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833718",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833719",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833720",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }

  ```
  

  该数据大小超过了1k（实际4091字节），基站会接收失败。

  要采取分包进行分送，每包大小不要超过1k（1024字节）<br>
  

  现在对数据进行分包，通过计算每包发送10个键盘数据。分为5包。<br>

  下面是5包的每一包数据：<br>

  
  第一包：
  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 5,
  	"current": 1,

  	"qs": 50,

  	"m": [{
  		"sn": "2126833671",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833672",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833673",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833674",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833675",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833676",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833677",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833678",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833679",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833680",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }
  
  ```

  5包，total 要赋值5 <br>
  当前是第一包 current 赋值1 <br>
  总数有50个，qs赋值50<br>
  数据包大小892字节，基站能接收。 <br>
  

  
  <br>
  
  第二包:
  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 5,
  	"current": 2,

  	"qs": 50,

  	"m": [{
  		"sn": "2126833681",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833682",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833683",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833684",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833685",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833686",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833687",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833688",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833689",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833690",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }
  ```

  5包，total 要赋值5 <br>
  当前是第二包 current 赋值2 <br>
  总数有50个，qs赋值50<br>

  数据包大小892字节，基站能接收。
  
  <br>
  
  第三包:
  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 5,
  	"current": 3,

  	"qs": 50,

  	"m": [{
  		"sn": "2126833691",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833692",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833693",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833694",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833695",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833696",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833697",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833698",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833699",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833700",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }
  ```

  5包，total 要赋值5 <br>
  当前是第三包 current 赋值3 <br>
  总数有50个，qs赋值50<br>

  数据包大小892字节，基站能接收。
  
  <br>
  第四包:
  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 5,
  	"current": 4,

  	"qs": 50,

  	"m": [{
  		"sn": "2126833701",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833702",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833703",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833704",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833705",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833706",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833707",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833708",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833709",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833710",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }
  ```

  5包，total 要赋值5 <br>
  当前是第四包 current 赋值4 <br>
  总数有50个，qs赋值50<br>

  数据包大小892字节，基站能接收。
  
  <br>
  
  第五包:
  ```json
  {
  	"i": 60,
  	"en": "6",
  	"cmd": 10,
  	"total": 5,
  	"current": 5,
  	"qs": 60,
  	"m": [{
  		"sn": "2126833711",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833712",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833713",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833714",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833715",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833716",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833717",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833718",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833719",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}, {
  		"sn": "2126833720",
  		"text": "hex:cae4c8ebd1a7bac5bdf8d0d0b0f3b6a8"
  	}]
  }
  ```

  5包，total 要赋值5 <br>
  当前是第五包 current 赋值5 <br>
  总数有50个，qs赋值50<br>

  数据包大小892字节，基站能接收。<br>
  
  每包的数据计算，少于1k即可。
  

  
  ### 3.2.5 生避字检测方法
  

  下发文本姓名时，需要先检测下发的姓名内容<br>

  下发的内容当中，如果有些字属于生避字，需要在业务进行前，先把生避字对应的字码下发给到基站。<br>

  目前键盘最多存储10个生避字。<br> 

  字码表文件：<a href="/Elvis/public/blob/master/soft/code.dat" target="_blank">字码表下载</a>

  
  判断字符的GB2312编码是否是生避字，方法：
  
  字符的GB2312编码：
  ```java
  
  byte[] inputs = input.getBytes("GB2312"); // 原文内容
  
  ```
  
  byte数组转int型
  ```java
   public static int bytes2ToInt(byte[] b, int offset) {
  	int x = 0;
  	if (b.length - offset >= 2) {
  		x = (int) (((b[offset ] & 0xff) << 8) | ((b[offset + 1] & 0xff) << 0));
  	}
  
  	return x;
  }
  ```
  
  判断这个字符是否是生避字
  
  ```java
   public static boolean isGB2312Font(int code) {
  	int GB_H = (code >> 8) & 0xFF;
  	int GB_L = code & 0xFF;
  
  	if (GB_H < 0xA1 || GB_H > 0xF7) {
  		return true;
  	} else if (GB_L < 0xA1 || GB_L > 0xFE) {
  		return true;
  	}
  	return false;
  }
  ```
  

  获取这个生避字的编码：<br>
  获取字码表的方法是该字符的GB2312的16进制数，然后根据该16进制数据从字码文件中定位该字符的字码<br>
  例如计算出“綩”的GB2312得到的byte，转换byte字节为整数48719。<br>
  然后在字码表文件code.dat文件偏移48719*24位置，然后读取24个字节，为该字的字码（每个字的字码为24个字节）<br>
  下发给基站

  ```
  byte[] inputs = "綩".getBytes("GB2312"); // 原文内容
  int code = bytes2ToInt(inputs,0);
  byte[] result = readFileContent(code,24);
  String hex = bytesToHexString(inputs) + bytesToHexString(result);
  
  public byte[] readFileContent(int start, int len) {
  	byte[] buffer = new byte[len];
  	try {
  		InputStream inputStream = new FileInputStream(new File("path/code.dat"));
  		inputStream.skip(start*len);
  		inputStream.read(buffer, 0, len);
  		inputStream.close();
  	} catch (Exception e) {
  		e.printStackTrace();
  	}
  	return buffer;
  }
  
  
   public static String bytesToHexString(byte[] src) {
  	StringBuilder stringBuilder = new StringBuilder("");
  	if (src == null || src.length <= 0) {
  		return stringBuilder.toString();
  	}
  	for (int i = 0; i < src.length; i++) {
  		int v = src[i] & 0xFF;
  		String hv = Integer.toHexString(v);
  		if (hv.length() < 2) {
  			stringBuilder.append(0);
  		}
  		stringBuilder.append(hv);
  		stringBuilder.append("");
  	}
  	return stringBuilder.toString();
  }
  ```
  

  最后下发的json数据
  ```json
  
  {
      "i": 60,
  	"cmd": 70,
  	"current": 1,
  	"total": 1,
  	"qs": 1,
  	"en": "17",
  	"m": [{
  		"text": "hex:be4fdcb3c880669af203f292f6000e0006000806010007080e00",
  		"sn": "2126833671"
  	}]	
  }
  
  ```

    
  ## 3.3 功能说明
  
      
  ### 授时
  
  对客户端授时，发送指令即可，基站会完成校时。
  

  <br>主题 : /client/${client}/operate 

  
  ```
  {
  	"i": 19,
  	"t": 1634802943
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- | 
  | i = 19 | 授时 |
  | t | 当前时间轴秒 |
  
  
      
  ### 基站管理
  
        

  #### 基站上线

  由基站发给应用程序，应用需要订阅主题

  <br>主题 ： /client/${clientId}/online 

  <br>指令内容：

  ``` 
  {
  	"i": 40
  } 
  ``` 
  

  | 名称 | 备注 |

  | --- | --- |
  | i = 40 | 基站上线 |
  

  #### 基站下线

  由服务器发给应用程序，应用需要订阅主题

  <br>主题：/client/${clientId}/offline 

  <br>指令内容：

  ```json 
  { 
  	"i": 41
  } 
  ``` 

  | 名称 | 备注 |

  | --- | --- |
  | i = 41 | 基站下线 |

        
  #### 基站信息设置与读取
  
  应用程序发送给基站
  

  <br>主题： /client/${client}/operate 

  <br>指令内容：

  
  设置

  ```json 
  {
  	"i": 20,
  	"m": {
  		"f": 1,
  		"mqtt_ip": "edunew.sunvotecloud.cn",

  		"mqtt_port": 1883,

  		"mqtt_username": "admin",
  		"mqtt_password": "1223456789"
  	}
  }
  ```
  

  读取
  ```json 
  {
  	"i": 20,
  	"m": {
  	}
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- |

  | i= 20 |基站信息设置与读取 |

  | f |基站频点 频点范围1-80|

  | mqtt_ip | 连接服务器的IP| 
  | mqtt_port | 连接mqtt服务器的端口 |
  | mqtt_username | 连接mqtt服务器的用户名 |
  | mqtt_password | 连接mqtt服务器的密码 | 

  | 注意 | 如果没有该字段则不设置该值，保持原值下发对有需要修改的值设置完成后，基站信息会自动上报一次 |
  
        
  #### 基站信息上报
  
  基站发送给应用程序
  

  <br>主题: /client/${client}/report

  <br>指令内容：

  ```json
  {
  	"i": 21,
  	"cId": "2024010282",
  	"m": {
  		"f": 1,
  		"mqtt_ip": "edunew.sunvotecloud.cn",

  		"mqtt_port": 1883,

  		"mqtt_username": "admin",
  		"mqtt_password": "1223456789"
  	}
  }
  ```

  | 名称 | 备注 |

  | --- | --- |

  | i= 21 |基站信息上报 |
  | cId |客户端ID |

  | f |基站频点 |
  | mqtt_ip | 连接服务器的IP | 
  | mqtt_port | 连接mqtt服务器的端口 |
  | mqtt_username | 连接mqtt服务器的用户名 |
  | mqtt_password | 连接mqtt服务器的密码 | 
  
        

  #### 基站错误信息上报

  基站发送给应用程序主题<br>5S 报一次

  <br>主题：/client/${client}/error

  <br>指令内容：

  ```json
  {
  	"i": 22,
  	"m": {
  		"et": 1,
  		"em": "3"
  	}
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 22 | 基站错误信息上报 |
  | et |错误类型 et = 1 ：基站频点冲突 |
  | em |错误消息 em=3 ：3号频点示例 基站频点3冲突 |
  
  
     
  ### 键盘管理
  
        
  #### 键盘上线
  

  由基站发给应用程序，应用需要订阅主题

  <br>主题: /client/${clientId}/card/online

  <br>指令内容：

  ```json
  {
  	"i": 14,
  	"m": [{

  		"c": "2126833671",

  		"t": 1626016299
  	}]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 14 |键盘上线 |
  | c |键盘sn号 |

  | t |下线时间 时间戳单位秒 需要先校时|

  
        
  #### 读取白名单
  
  应用程序发送给基站

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 30
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 30 |读取白名单 |
  
  
  

  基站发给应用程序主题

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 31,
  	"total": 1,
  	"current": 1,
  	"m": ["2126932551"]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 31 |白名单上传 |

  | total |一共上传的数据包数，这里分包原则参考指令属性m介绍说明及分包示例|
  | current |当前第几包 ，这里分包原则参考指令属性m介绍说明及分包示例|

  | m |键盘序列号列表 |
  
  
  
        
  #### 添加白名单
  
  应用程序发送给基站

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 3,
  	"m": ["2126833703", "2126833671"]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 3 |添加白名单m内包含白名单键盘按编号 |
  | m |键盘序列号列表 |
  
  
  
        
  #### 删除白名单
  
  应用程序发送给基站

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 4,
  	"m": ["2126833703", "2126833671"]
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- |
  | i = 4 |删除白名单m内包含白名单键盘按编号 |
  | m |键盘序列号列表 |
  
  
        
  #### 清空白名单
  
  应用程序发送给基站

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 5
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 5 |清空白名单 |
  

  ### 签到

  #### 开启签到
  由应用程序发给基站，应用按照主题发送
  <br>主题: /lesson/class/${clinetId}/receive
  <br>指令内容：
  ```json
  {
  	"i": 12,
  	"en": "6",
  	"qm": 7,
  	"m": {
  		"tp": "pin",

  		"content": "hex:cae4c8ebd5cbbac5cdeab3c9b0f3b6a8"

  	}
  }
  ```
  | 名称 | 备注 |
  | --- | --- |
  | i = 12 |下发答题  |
  | en |序号  |
  | qm = 7 |签到 |
  | tp  |签到功能  目前支持传入固定值："pin"  为pin码签到 |

  | content |签到标题，hex: 为内容的GB2312编码的hex内容 |
  
  
  
  ####  接收签到信息
  由基站发给应用程序，应用订阅主题
  <br>主题: /lesson/class/${clinetId}/send
  <br>指令内容：
  ```json
  {
  	"i": 13,
  	"en": "6",
  	"qm": 7,
  	"c": "2126833671",
  	"m": [{
  		"a": "6542",
  		"t": 1626016599
  	}]
  }
  ```
  | 名称 | 备注 |
  | --- | --- |
  | i = 13 | 签到数据 |

  | t  |提交答案时间 时间戳单位秒 需要先校时|

  | a  | 签到信息（签到码） |
  
  
  #### 停止签到
  由应用程序发给基站，应用按照发送
  <br>主题：/lesson/class/${clinetId}/receive 
  <br>指令内容：
  ```json
  {
  	"i": 11,
  	"en": "6"
  }
  ```
  | 名称 | 备注 |
  | --- | --- |
  | i = 11 | 停止签到 |
  | en |停止对序号6的练习 |

  
  
      
  ### 单题
  
        
  #### 开启答题
  

  由应用程序发给基站，应用按照主题发送

  <br>主题: /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 12,
  	"en": "1",
  	"qm": 1,
  	"m": {
  		"qt": 0,
  		"on": 4,

  		"content": "hex:d7d4b6a8d2e5b1eacce2"

  	}
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 12 |下发答题  |
  | en |序号  |
  | qm = 1 |单题模式 示例为单题模式的字母单选 |
  | qt  |字母单选 |
  | on  |选项数 |

  | content |题目主干内容，hex: 为内容的GB2312编码的hex内容 |

  
  ```java

  System.out.println(new String(hex2Bytes(bytesToHexString("李四".getBytes("GB2312"))),"GB2312"));

  
  public static String bytesToHexString(byte[] src) {
      StringBuilder stringBuilder = new StringBuilder("");
      if (src == null || src.length <= 0) {
          return "";
      }
      for (int i = 0; i < src.length; i++) {
          int v = src[i] & 0xFF;
          String hv = Integer.toHexString(v);
          if (hv.length() < 2) {
              stringBuilder.append(0);
          }
          stringBuilder.append(hv);
          stringBuilder.append("");
      }
      return stringBuilder.toString();
  }

  
   public static byte[] hex2Bytes(String hex){
  	if(hex.length() % 2 == 0){
  		byte[] ret = new byte[hex.length() / 2];
  		for(int i = 0 ; i< hex.length() / 2 ; i++){
  			ret[i] = (byte)Integer.parseInt(hex.substring(2*i,2*i+2),16);
  		}
  		return ret;
  	}
  	return null;
  }

  ```
        
  #### 接收答题数据
  

  由基站发给应用程序，应用订阅主题

  <br>主题: /lesson/class/${clinetId}/send

  <br><br>指令内容：

  ```json
  {
  	"i": 13,
  	"en": "1",
  	"qm": 1,

  	"c": "2126833671",

  	"m": [{
  		"qn": 1,
  		"a": "A",
  		"t": 1626016299
  	}]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 13 | 答题数据 |

  | qn |上报答题数据，单题题号固定为1 |

  | t  |提交答案时间 时间戳单位秒 需要先校时|

  | a  | 答题数据 |
  
        
  #### 停止答题

  由应用程序发给基站，应用按照发送

  <br>主题：/lesson/class/${clinetId}/receive 

  <br>指令内容：

  ```json
  {
  	"i": 11,
  	"en": "1"
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 11 | 停止答题 |

  | en |停止对序号1的练习 |

  ### 抢答

  #### 开启答题

  由应用程序发给基站，应用按照发送

  <br>主题:  /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 12,
  	"en": "2",
  	"qm": 4
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 12 | 开启答题 |

  | en |序号2的练习 |

  | qm | qm =4 抢答题 |
  
  
        

  #### 接收答题数据

  由基站发给应用程序，应用订阅

  <br>主题： /lesson/class/${clinetId}/send

  <br>指令内容：

  ```json
  {
  	"i": 13,
  	"en": "2",
  	"qm": 4,

  	"m": [{

  	    "c": "2126833671",

  		"t": 1626016299
  	}]
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- |

  | i = 13 | 接收答题数据 |

  | en |序号2的练习 |

  | qm | qm =4 抢答题 |
  | c | 键盘编号 |

  | t  |提交答案时间 时间戳单位秒 需要先校时|

  #### 停止答题

  由应用程序发给基站，应用按照主题发送

  <br>主题：/lesson/class/${clinetId}/receive 

  <br>指令内容：

  ```json
  {
  	"i": 11,
  	"en": "2"
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 11 | 停止答题 |

  | en |停止对序号2的练习 |

  
  
  
  ### 多题题号多题
  
  #### 开启答题
  

  由应用程序发给基站，应用按照主题发送

  <br>主题： /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {
  	"i": 12,
  	"en": "3",
  	"qm": 14,
  	"total": 1,
      "current": 1,

  	"qs": 5,

  	"m": [{
  		"qt": 0,
  		"on": 4,

  		"dn": "1"

  	}, {

  		"qt": 1,

  		"on": 4,
  		"dn": "2-1"
  	}, {

  		"qt": 2,
  		"dn": "2-2"
  	}, {
  		"qt": 3,
  		"dn": "2-2-1"
  	}, {
  		"qt": 7,

  		"dn": "3"
  	}]
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- |
  | i = 12 | 开启答题 |

  | en |12341练习 |

  | qm = 14 | 多题多级编号模式 |

  | current |当前第几包数据，这里分包原则参考指令属性m介绍说明及分包示例 |
  | total |一共几包数据 ，这里分包原则参考指令属性m介绍说明及分包示例|

  | qs | 题目总数 |

  | qt | 0：字母单选 <br> 1: 字母多选 <br> 2: 数字题 <br> 3: 判断题 <br> 7: 自判题|

  | on | 选项数量 |
  | dn | 显示编号，题目最多3级数字编号，多级数字编号中间必须以“-”隔开，每级最大数200 |
  
        
  #### 接收答题数据
  

  由基站发给应用程序，应用订阅主题

  <br>主题: /lesson/class/${clinetId}/send

  <br>指令内容：

  ```json
  {
  	"i": 13,
  	"en": "3",
  	"qm": 14,

  	"c": "2126833671",

  	"m": [{

  		"qn": 1,

  		"a": "A",
  		"t": 1626016299
  	}]
  }
  ```
  

  | 名称 | 备注 |

  | --- | --- |
  | i = 13 | 接收答题数据 |

  | en |12341练习 |

  | qm = 14 | 多题多级编号模式 |
  | c | 键盘编号 |
  | qn |顺序题号，不为显示编号，是上述题目的顺序号 |

  | t  |提交答案时间 时间戳单位秒 需要先校时 |

  | a  | 答题数据 |
  
  
        
  #### 停止答题

  由应用程序发给基站，应用按照主题发送

  <br>主题：/lesson/class/${clinetId}/receive 

  <br>指令内容：

  ```json
  {
  	"i": 11,
  	"en": "3"
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 11 | 停止答题 |

  | en |停止对序号12341的练习 |

      
  ### 基站升级
  
  #### 开始升级

  <br>主题: /client/${client}/operate

  <br>指令内容：

  ```json
  {
  	"i": 17,

  	"m": 
  	{
  			"url": "http://120.78.57.84:8888/file/C200K-V200.0.21.bin",
  			"version": "200.0.21",
  			"CRC": 2382669270

  	}
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 17 | 基站升级 |
  | en |序号5 |
  | url |固件包地址，基站能访问到的路径 |
  | version |新固件的版本 |

  | CRC |固件文件的CRC值 |

  
  
        
  #### 升级进度报告

  <br>主题： /client/${client}/report

  <br>指令内容：

  ```json
  {
  	"i": 18,
  	"m": {

  		"cId": "3411111156",

  		"percent": 0,
  		"status": 0
  	}
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 18 | 升级进度报告 |
  | cId |基站编号 |
  | percent |升级百分比 |

  | status |升级状态信息。 <br> 0：未开始<br> 1：升级中<br> 2：升级成功<br> 4：固件版本号错误<br> 5：不在升级名单内<br> 6：升级指令错误<br> \>127：升级中的错误码。 |

  
      
  ### 键盘升级
        
  #### 开始升级

  <br>主题: /client/${client}/operate

  <br>指令内容：

  ```json
  {

      "i": 28,
      "m": {
          "url": "http://120.78.57.84:8888/file/S6_2.4G_2.1.2.50_GB2312_CGC_add_head.bin",
          "version": "2.1.2.50",
          "CRC": 10605263
      }

  }
  ```

  ### 文本下发

  #### 文本下发

  <br>主题： /lesson/class/${clinetId}/receive

  <br>指令内容：

  ```json
  {

  	"i": 60,

  	"en": "6",

  	"cmd": 1,

  	"total": 1,
      "current": 1,

  	"qs": 2,

  	"m": [{

          "sn": "2126833671",

          "text": "hex:d5c5c8fd"

  	},{
          "sn": "2126833672",

          "text": "hex:c0eecbc4"

  	}]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |

  | i = 60 | 文本下发 |

  | sn |键盘列表 |

  | current |当前第几包 ，这里分包原则参考指令属性m介绍说明及分包示例|
  | total |一共多少包，这里分包原则参考指令属性m介绍说明及分包示例 |

  | qs |键盘总数 如果是多包，是多包总和  |

  | cmd |下发的命令 <br> 1： 姓名下发 <br> 10： 第二行文本 <br> 70： 生避字，生避字规则：内容为GB2312的hex编码，先是生避字的hex编码，紧接着是生避字的字符编码，生避字的字符编码为24个字节。一个生避字是26个字节52个字符（hex编码） 一包最多发3个生避字，如果超过3个生避字，需要多包发送 <br> 85： 自判题标题  <br> 87： 清除 |

  | text |标题信息，以hex:开头添加的内容 内容为GB2312的hex编码 |

  
  
  ```java

  System.out.println(new String(hex2Bytes(bytesToHexString("李四".getBytes("GB2312"))),"GB2312"));
  
  public static String bytesToHexString(byte[] src) {
      StringBuilder stringBuilder = new StringBuilder("");
      if (src == null || src.length <= 0) {
          return "";
      }
      for (int i = 0; i < src.length; i++) {
          int v = src[i] & 0xFF;
          String hv = Integer.toHexString(v);
          if (hv.length() < 2) {
              stringBuilder.append(0);
          }
          stringBuilder.append(hv);
          stringBuilder.append("");
      }
      return stringBuilder.toString();
  }
  
   public static byte[] hex2Bytes(String hex){
  	if(hex.length() % 2 == 0){
  		byte[] ret = new byte[hex.length() / 2];
  		for(int i = 0 ; i< hex.length() / 2 ; i++){
  			ret[i] = (byte)Integer.parseInt(hex.substring(2*i,2*i+2),16);

  		}

  		return ret;

  	}

  	return null;

  }
  ```
  
  
        

  #### 文本下发返回

  <br>主题: /lesson/class/${clinetId}/send

  <br>指令内容：

  ```json
  {

  	"i": 61,

  	"cmd": 1,

  	"m": [{

          "sn": "2126833671",
          "success": 0

  	}]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |

  | i = 61 | 文本下发返回 |

  | sn |键盘号 |

  | cmd |下发的命令 <br> 1： 姓名下发 <br> 10： 第二行文本 <br> 70： 生避字，生避字规则(参考：生避字检测方法)：内容为GB2312的hex编码，先是生避字的hex编码，紧接着是生避字的字符编码，生避字的字符编码为24个字节。一个生避字是26个字节52个字符（hex编码） <br>  85：自判题标题  <br> 87：清除 |

  | success | 是否成功。<br> 0 表示成功 <br> -1 失败  <br> -2 基站忙，应用程序需要等待一段时间再发送 |

  注意：连续文本下发，需要等待上一条命令返回（成功或失败）后，再发送下一条指令。

  ### 学生卡信息上报
  卡初始化组网的时候会上报一次

  <br>主题：/client/${client}/report

  <br>指令内容：

  ```json
  {
      "i":32,
      "m":[
          {
              "c":"1873373905",
              "cv":"0.2.2",
              "hw":"67.0",
              "t":1638865040
          }
      ]
  }
  ```

  | 名称 | 备注 |

  | --- | --- |
  | i = 32 | 学生卡信息上报 |
  | c |键盘编号 |
  | cv |固件版本号 |

  | hw |硬件型号 |

  | t | 时间戳 时间戳单位秒 需要先校时|
  

  
  ### 基站复位
  
  应用程序发送给基站
  <br>主题: /lesson/class/${clinetId}/receive
  <br>指令内容：
  ```json
  {
  	"i": 62
  }
  ```
  | 名称 | 备注 |
  | --- | --- |
  | i = 62 |基站复位 |