Commit 10bf968554057ac43d998708deb905cf5a93a21f

Authored by DMchen
1 parent 51b0c781

1.SDK应用部分,初版完成,上传备份。

Showing 1 changed file with 594 additions and 1219 deletions
通讯协议-SDK应用部分.md
... ... @@ -5022,835 +5022,610 @@ infos:{ "keySn":"1", "value":"A"}//返回键盘反馈模式参数值
5022 5022 | B100-2.4G+S6 | 支持 | |
5023 5023 | B200-2.4G+S6 | 支持 | |
5024 5024  
5025   -#### 键盘心跳反馈\[上报\]
  5025 +#### 键盘上线通知[上报]
5026 5026  
  5027 +S6键盘上线后上报键盘SN信息。
5027 5028 接收:
5028   -
5029   -fun: \" keyboardHeartbeat\"
5030   -
  5029 +fun: "keyboardOnlineOne"
5031 5030 baseId: 1//基站ID
  5031 +infos:{ "keySn":"1479824643"}//返回键盘反馈模式参数值
5032 5032  
5033   -infos:{
5034   -\"keySn\":\"1479824643\",\"keyValue\":\"0\",\"ver\":\"1.0.0\",\"volt\":\"50\"}//返回键盘反馈模式参数值
5035   -
5036   - ----------------- --------------- --------------------------------------
5037   - Json字段 字段含义 赋值及含义
5038   -
5039   - hModel 键盘型号 75: T2-5.8G\
5040   - 76: S6-2.4G
5041   -
5042   - keySn 键盘Sn
5043   -
5044   - keyVer 键盘版本
5045   -
5046   - Volt 键盘电量 T2百分比值,S6无效
5047   - ----------------- --------------- --------------------------------------
  5033 +| **Json字段** | **字段含义** | **赋值及含义** |
  5034 +| --- | --- | --- |
  5035 +|keySn|键盘Sn||
5048 5036  
5049 5037 指令样例:
5050 5038  
5051   -{\
5052   -    \"fun\":\"keyboardHeartbeat\",\
5053   -    \"baseId\":1,\
5054   -     \"infos\":{
5055   -
5056   -\"hModel\":\"67\",
5057   -
5058   -\"keySn\":\"1479824643\",\
5059   -        \"keyValue\":\"0\",
5060   -
5061   -\"ver\":\"1.0.0\",
5062   -
5063   -\"volt\":\"50\"\
5064   -    },
5065   -
5066   - \"packetTag\":\"0\"}\
  5039 +```json
  5040 +{
  5041 + "fun": "keyboardOnlineOne",
  5042 + "baseId": 1,
  5043 + "infos": {
  5044 + "keySn": "1479824643"
  5045 + },
  5046 + "packetTag": "0"
5067 5047 }
  5048 +```
5068 5049  
5069 5050 支持设备说明
5070 5051  
5071   - ----------------------- ----------------------- ----------------------------------------------
5072   - 基站+键盘 支持/不支持 备注
5073   -
5074   - B100-2.4G+S6 支持 出厂配置有心跳时反馈,出厂配置无心跳时不反馈
5075   -
5076   - B200-2.4G+S6 支持 出厂配置有心跳时反馈,出厂配置无心跳时不反馈
5077   -
5078   - B200-5.8G+T2 不支持
5079   - ----------------------- ----------------------- ----------------------------------------------
5080   -
5081   -#### 键盘上线通知\[上报\]
5082   -
5083   -S6键盘上线后上报键盘SN信息。
  5052 +| **基站+键盘** | **支持** | **备注** |
  5053 +| --- | --- | --- |
  5054 +| B200-2.4G+S6 | 支持 | |
5084 5055  
  5056 +#### 键盘心跳反馈[上报]
5085 5057 接收:
5086   -
5087   -fun: \"keyboardOnlineOne\"
5088   -
  5058 +fun: " KeyboardHeartbeat"
5089 5059 baseId: 1//基站ID
  5060 +infos:{ "keySn":"1479824643","keyValue":"0","ver":"1.0.0","volt":"50"}//返回键盘反馈模式参数值
5090 5061  
5091   -infos:{ \"keySn\":\"1479824643\"}//返回键盘反馈模式参数值
5092   -
5093   - ----------------- --------------- --------------------------------------
5094   - Json字段 字段含义 赋值及含义
5095   -
5096   - keySn 键盘Sn
5097   - ----------------- --------------- --------------------------------------
  5062 +| **Json字段** | **字段含义** | **赋值及含义** |
  5063 +| --- | --- | --- |
  5064 +|hModel|键盘型号|75: T2-5.8G<br>76: S6-2.4G|
  5065 +|keySn|键盘Sn||
  5066 +|keyVer|键盘版本||
  5067 +|Volt|键盘电量|T2百分比值,S6无效|
5098 5068  
5099 5069 指令样例:
5100 5070  
5101   -{\
5102   -    \"fun\":\"keyboardOnlineOne\",\
5103   -    \"baseId\":1,\
5104   -     \"infos\":{
5105   -
5106   -\"keySn\":\"1479824643\"      
5107   -
5108   -    },
5109   -
5110   - \"packetTag\":\"0\"}\
  5071 +```json
  5072 +{
  5073 + "fun": "KeyboardHeartbeat",
  5074 + "baseId": 1,
  5075 + "infos": {
  5076 + "hModel": "67",
  5077 + "keySn": "1479824643",
  5078 + "keyValue": "0",
  5079 + "ver": "1.0.0",
  5080 + "volt": "50"
  5081 + },
  5082 + "packetTag": "0"
5111 5083 }
  5084 +```
5112 5085  
5113 5086 支持设备说明
5114 5087  
5115   - ----------------------- ----------------------- -----------------------
5116   - 基站+键盘 支持/不支持 备注
5117   -
5118   - B100-2.4G+S6 不支持
  5088 +| **基站+键盘** | **支持** | **备注** |
  5089 +| --- | --- | --- |
  5090 +| B100-2.4G+S6 | 支持 |出厂配置有心跳时反馈,出厂配置无心跳时不反馈|
  5091 +| B200-2.4G+S6 | 支持 |出厂配置有心跳时反馈,出厂配置无心跳时不反馈|
5119 5092  
5120   - B200-2.4G+S6 支持
5121 5093  
5122   - B200-5.8G+T2 不支持
5123   - ----------------------- ----------------------- -----------------------
5124 5094  
5125 5095 #### 遥控键盘关机
5126 5096  
5127 5097
5128   -
5129   -发送:
5130   -
5131   -fun: \"remoteKeyShutdown\" //遥控键盘关机
5132   -
5133   -params:{}//
5134   -
5135   -指令样例:
5136   -
5137   -{\
5138   -    \"fun\":\"remoteKeyShutdown\",
5139   -
5140   - \"baseId\":1,
5141   -
5142   -\"params\":\[\
5143   -        {\
5144   -            \"keySn\":\"1837454011\"            
5145   -
5146   -}
5147   -
5148   -\],\
5149   -      \"packetTag\":\"1\"\
5150   -}
5151   -
5152   -返回
5153   -
5154   -接收:
5155   -
5156   -fun: \"remoteKeyShutdown\"
5157   -
5158   -baseId: 1//基站ID
5159   -
5160   -infos:{\"keySn\":\"1837454011\",\"state\":\"OK\"}//遥控键盘关机
5161   -
5162   -指令样例:
5163   -
5164   -{\
5165   -    \"fun\":\"remoteKeyShutdown\",\
5166   -    \"baseId\":1,\
5167   -     \"infos\":{\
5168   -        \"keySn\":\"1837454011\",\
5169   -          \"state\":\"OK\"\
5170   -    },
5171   -
5172   - \"packetTag\":\"1\"\
5173   -}
5174   -
5175 5098 发送:
5176   -
5177   -fun: \"remoteKeyShutdown\" //遥控所有键盘关机
5178   -
5179   -params:{}//
5180   -
  5099 +fun: "remoteKeyShutdown" //遥控键盘关机
  5100 +params:{}//
5181 5101 指令样例:
5182 5102  
5183   -{\
5184   -    \"fun\":\"remoteKeyShutdown\",
5185   -
5186   - \"baseId\":1,
5187   -
5188   -\"params\":\[\],\
5189   -      \"packetTag\":\"1\"\
  5103 +```json
  5104 +{
  5105 + "fun": "remoteKeyShutdown",
  5106 + "baseId": 1,
  5107 + "params": [{
  5108 + "keySn": "1837454011"
  5109 + }],
  5110 + "packetTag": "1"
5190 5111 }
5191   -
  5112 +```
5192 5113 返回
5193   -
5194 5114 接收:
5195   -
5196   -fun: \"remoteKeyShutdown\"
5197   -
  5115 +fun: "remoteKeyShutdown"
5198 5116 baseId: 1//基站ID
  5117 +infos:{"keySn":"1837454011","state":"OK"}//遥控键盘关机
5199 5118  
5200   -infos:{\"keySn\":\"0000000000\",\"state\":\"OK\"}//遥控所有键盘关机
5201 5119  
5202 5120 指令样例:
5203   -
5204   -{\
5205   -    \"fun\":\"remoteKeyShutdown\",\
5206   -    \"baseId\":1,\
5207   -     \"infos\":{\
5208   -        \"keySn\":\"0000000000\",\
5209   -          \"state\":\"OK\"\
5210   -    },
5211   -
5212   - \"packetTag\":\"1\"\
  5121 +```json
  5122 +{
  5123 + "fun": "remoteKeyShutdown",
  5124 + "baseId": 1,
  5125 + "infos": {
  5126 + "keySn": "1837454011",
  5127 + "state": "OK"
  5128 + },
  5129 + "packetTag": "1"
5213 5130 }
  5131 +```
5214 5132  
5215 5133 支持设备说明
5216   -
5217   - ----------------------- ----------------------- -----------------------
5218   - 基站+键盘 支持/不支持 备注
5219   -
5220   - B100-2.4G+S6 支持
5221   -
5222   - B200-2.4G+S6 支持
5223   -
5224   - B200-5.8G+T2 支持
5225   - ----------------------- ----------------------- -----------------------
  5134 +| **基站+键盘** | **支持** | **备注** |
  5135 +| --- | --- | --- |
  5136 +| B100-2.4G+S6 | 支持 ||
  5137 +| B200-2.4G+S6 | 支持 ||
  5138 +| B200-5.8G+T2 | 支持 ||
5226 5139  
5227 5140 #### 键盘暂停休眠
5228 5141  
5229 5142
5230 5143  
5231 5144 发送:
  5145 +fun: "writeKeyboardPauseSleep" //键盘暂停休眠
  5146 +params:{"value"} //
5232 5147  
5233   -fun: \"writeKeyboardPauseSleep\" //键盘暂停休眠
5234   -
5235   -params:{\"value\"} //
5236   -
5237   - ----------------- --------------- --------------------------------------
5238   - Json字段 字段含义 赋值及含义
5239   -
5240   - baseId 基站ID 0-32 0:所有基站,默认值
  5148 +| **Json字段** | **字段含义** | **赋值及含义** |
  5149 +| --- | --- | --- |
  5150 +|baseId|基站ID|0-32<br> 0:所有基站,默认值|
  5151 +|value|预留|0 :10秒有效(默认值)|
5241 5152  
5242   - value 预留 0 :10秒有效(默认值)
5243   - ----------------- --------------- --------------------------------------
5244 5153  
5245 5154 指令样例:
5246 5155  
5247   -{\
5248   -    \"fun\":\"writeKeyboardPauseSleep\",
5249   -
5250   - \"baseId\":0,
5251   -
5252   -\"params\":\
5253   -        {\
5254   -            \"value\":\"0\"            
5255   -
5256   -},\
5257   -      \"packetTag\":\"1\"\
  5156 +```json
  5157 +{
  5158 + "fun": "writeKeyboardPauseSleep",
  5159 + "baseId": 0,
  5160 + "params": {
  5161 + "value": "0"
  5162 + },
  5163 + "packetTag": "1"
5258 5164 }
  5165 +```
5259 5166  
5260 5167 返回
5261 5168  
5262 5169 接收:
5263   -
5264   -fun: \"writeKeyboardPauseSleep\"
5265   -
  5170 +fun: "writeKeyboardPauseSleep"
5266 5171 baseId: 1//基站ID
  5172 +infos:{"value":"0"}//10秒
5267 5173  
5268   -infos:{\"value\":\"0\"}//10秒
5269 5174  
5270 5175 指令样例:
5271 5176  
5272   -{\
5273   -    \"fun\":\"writeKeyboardPauseSleep\",\
5274   -    \"baseId\":1,\
5275   -     \"infos\":{\
5276   -        \"value\":\"0\"\
5277   -    },
5278   -
5279   - \"packetTag\":\"1\"\
  5177 +```json
  5178 +{
  5179 + "fun": "writeKeyboardPauseSleep",
  5180 + "baseId": 1,
  5181 + "infos": {
  5182 + "value": "0"
  5183 + },
  5184 + "packetTag": "1"
5280 5185 }
  5186 +```
5281 5187  
5282 5188 支持设备说明
5283 5189  
5284   - ----------------------- ----------------------- -----------------------
5285   - 基站+键盘 支持/不支持 备注
5286   -
5287   - B100-2.4G+S6 支持
5288   -
5289   - B200-2.4G+S6 支持
5290   -
5291   - B200-5.8G+T2 不支持
5292   - ----------------------- ----------------------- -----------------------
  5190 +| **基站+键盘** | **支持** | **备注** |
  5191 +| --- | --- | --- |
  5192 +| B100-2.4G+S6 | 支持 ||
  5193 +| B200-2.4G+S6 | 支持 ||
5293 5194  
5294 5195 #### 键盘短消息
5295 5196  
5296 5197
  5198 +fun: "writeKeyMessage" //写键盘短消息
  5199 +params:{} // 数组对象,对象中的默认值为空字符串
5297 5200  
5298   -fun: \"writeKeyMessage\" //写键盘短消息
5299   -
5300   -params:{} // 数组对象,对象中的默认值为空字符串,
5301   -
5302   - --------------- ----------------- --------------------------------------
5303   - Json字段 字段含义 赋值及含义
5304   -
5305   - keySn 键盘SN 空字符串,为所有在线键盘
  5201 +| **Json字段** | **字段含义** | **赋值及含义** |
  5202 +| --- | --- | --- |
  5203 +|keySn|键盘SN|空字符串,为所有在线键盘|
  5204 +|txt|短消息内容|字符串最长80字节|
5306 5205  
5307   - txt 短消息内容 字符串最长80字节
5308   - --------------- ----------------- --------------------------------------
5309 5206  
5310 5207 指令样例:
5311 5208  
5312 5209 所有键盘
5313   -
5314   -{\
5315   -    \"fun\":\"writeKeyMessage\",
5316   -
5317   - \"baseId\":0,\
5318   -    \"params\":\
5319   -        {\
5320   -            \"txt\":\"最新消息\"           
5321   -
5322   -},
5323   -
5324   - \"packetTag\":\"1\"\
  5210 +```json
  5211 +{
  5212 + "fun": "writeKeyMessage",
  5213 + "baseId": 0,
  5214 + "params": {
  5215 + "txt": "最新消息"
  5216 + },
  5217 + "packetTag": "1"
5325 5218 }
  5219 +```
5326 5220  
5327 5221 返回
  5222 +fun: "writeKeyMessage"
  5223 +infos:{"state":"OK"}//返回状态,成功为OK
5328 5224  
5329   -fun: \"writeKeyMessage\"
5330   -
5331   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
5332 5225  
5333 5226 指令样例:
5334 5227  
5335   -{\
5336   -    \"fun\":\"writeKeyMessage\",\
5337   -    \"baseId\":0,\
5338   -    \"infos\":{
5339   -
5340   -\"keySn\":\"0000000000\"\
5341   -        \"state\":\"OK\"\
5342   -    },\
5343   -    \"packetTag\":\"1\"\
  5228 +```json
  5229 +{
  5230 + "fun": "writeKeyMessage",
  5231 + "baseId": 0,
  5232 + "infos": {
  5233 + "keySn": "0000000000",
  5234 + "state": "OK"
  5235 + },
  5236 + "packetTag": "1"
5344 5237 }
  5238 +```
5345 5239  
5346 5240 指定键盘
5347 5241  
5348   -{\
5349   -    \"fun\":\"writeKeyMessage\",
5350   -
5351   -\"keySnList\":\[{\"keySn\":\"0007899478\"}\],\
5352   -    \"params\":\
5353   -        {\
5354   -           \"txt\":\"最新消息\"
5355   -
5356   -     },\
5357   -    \"packetTag\":\"1\"\
  5242 +```json
  5243 +{
  5244 + "fun": "writeKeyMessage",
  5245 + "keySnList": [{
  5246 + "keySn": "0007899478"
  5247 + }],
  5248 + "params": {
  5249 + "txt": "最新消息"
  5250 + },
  5251 + "packetTag": "1"
5358 5252 }
  5253 +```
5359 5254  
5360 5255 返回
5361 5256  
5362   -fun: \"writeKeyMessage\"
5363   -
  5257 +fun: "writeKeyMessage"
5364 5258 infos:{}//数组对象,同发送的
5365 5259  
  5260 +
5366 5261 指令样例:
5367 5262  
  5263 +```json
5368 5264 {
5369   -
5370   -\"baseId\": 3,
5371   -
5372   -\"fun\": \"writeKeyMessage\",
5373   -
5374   -\"infos\": {
5375   -
5376   -\"keySn\": \"0007899478\",
5377   -
5378   -\"state\": \"OK\"
5379   -
5380   -},
5381   -
5382   -\"packetTag\": \"1\"
5383   -
  5265 + "baseId": 3,
  5266 + "fun": "writeKeyMessage",
  5267 + "infos": {
  5268 + "keySn": "0007899478",
  5269 + "state": "OK"
  5270 + },
  5271 + "packetTag": "1"
5384 5272 }
  5273 +```
5385 5274  
5386 5275 支持设备说明
5387 5276  
5388   - ----------------------- ----------------------- -----------------------
5389   - 基站+键盘 支持/不支持 备注
5390   -
5391   - B100-2.4G+S6 支持
5392   -
5393   - B200-2.4G+S6 支持
5394   -
5395   - B200-5.8G+T2 不支持
5396   - ----------------------- ----------------------- -----------------------
  5277 +| **基站+键盘** | **支持** | **备注** |
  5278 +| --- | --- | --- |
  5279 +| B100-2.4G+S6 | 支持 ||
  5280 +| B200-2.4G+S6 | 支持 ||
5397 5281  
5398   -#### 指定键盘修改FSN\[内部\]
  5282 +#### 指定键盘修改FSN[公司内部使用指令]
5399 5283  
5400 5284
5401 5285  
5402   -fun: \"writeKeyFSN\" //写键盘修改FSN
5403   -
5404   -params:{} // 数组对象,对象中的默认值为空字符串,
  5286 +fun: "writeKeyFSN" //写键盘修改FSN
  5287 +params:{} // 数组对象,对象中的默认值为空字符串
5405 5288  
5406   - --------------- ----------------- --------------------------------------
5407   - Json字段 字段含义 赋值及含义
5408   -
5409   - keySnOld 旧键盘SN
  5289 +| **Json字段** | **字段含义** | **赋值及含义** |
  5290 +| --- | --- | --- |
  5291 +|keySnOld|键盘旧SN||
  5292 +|keySnNew|键盘新SN||
5410 5293  
5411   - keySnNew 新键盘 SN
5412   - --------------- ----------------- --------------------------------------
5413 5294  
5414 5295 指令样例:
5415 5296  
5416 5297 指定键盘
5417 5298  
5418   -{\
5419   -    \"fun\":\"writeKeyFSN\",
5420   -
5421   -    \"params\":\
5422   -        {\
5423   -           \"keySnList\":\[
5424   -
5425   -{
5426   -
5427   -\"keySnOld\":\"0007899478\",
5428   -
5429   -\"keySnNew\":\"0007899479\"
5430   -
5431   -},
5432   -
  5299 +```json
5433 5300 {
5434   -
5435   -\"keySnOld\":\"0007899488\",
5436   -
5437   -\"keySnNew\":\"0007899489\"
5438   -
5439   -} \]\
5440   -     },\
5441   -    \"packetTag\":\"1\"\
  5301 + "fun": "writeKeyFSN",
  5302 + "params": {
  5303 + "keySnList": [{
  5304 + "keySnOld": "0007899478",
  5305 + "keySnNew": "0007899479"
  5306 + },
  5307 + {
  5308 + "keySnOld": "0007899488",
  5309 + "keySnNew": "0007899489"
  5310 + }
  5311 + ]
  5312 + },
  5313 + "packetTag": "1"
5442 5314 }
  5315 +```
5443 5316  
5444 5317 返回
5445 5318  
5446   -fun: \"writeKeyFSN\"
5447   -
  5319 +fun: "writeKeyFSN"
5448 5320 infos:{}//数组对象,同发送的
5449 5321  
  5322 +
5450 5323 指令样例:
5451 5324  
  5325 +```json
5452 5326 {
  5327 + "baseId": 3,
  5328 + "fun": "writeKeyFSN",
  5329 + "infos": {
  5330 + "keySn": "0007899478",
  5331 + "state": "OK"
  5332 + },
  5333 + "packetTag": "1"
  5334 +}
  5335 +```
5453 5336  
5454   -\"baseId\": 3,
5455   -
5456   -\"fun\": \"writeKeyFSN\",
  5337 +支持设备说明
  5338 +| **基站+键盘** | **支持** | **备注** |
  5339 +| --- | --- | --- |
  5340 +| B100-2.4G+S6 | 支持 ||
  5341 +| B200-2.4G+S6 | 支持 ||
5457 5342  
5458   -\"infos\": {
  5343 +## 键盘显示设置
5459 5344  
5460   -\"keySn\": \"0007899478\",
  5345 +注:返回指令中的\"baseId\":0, 可忽略不处理
5461 5346  
5462   -\"state\": \"OK\"
  5347 +### 空闲标题
5463 5348  
5464   -},
  5349 +修改参数后设备重启生效。
5465 5350  
5466   -\"packetTag\": \"1\"
  5351 +发送:
  5352 +fun: "writeKeypadFreeTitle" //写键盘空闲标题显示
  5353 +params:{}
5467 5354  
5468   -}
5469   -
5470   -支持设备说明
5471   -
5472   - ----------------------- ----------------------- -----------------------
5473   - 基站+键盘 支持/不支持 备注
5474   -
5475   - B100-2.4G+S6 支持
5476   -
5477   - B200-2.4G+S6 支持
5478   -
5479   - B200-5.8G+T2 不支持
5480   - ----------------------- ----------------------- -----------------------
5481   -
5482   -## 键盘显示设置
5483   -
5484   -> 注:返回指令中的\"baseId\":0, 可忽略不处理
5485   -
5486   -### 空闲标题
5487   -
5488   -修改参数后设备重启生效。
5489   -
5490   -发送:
5491   -
5492   -fun: \"writeKeypadFreeTitle\" //写键盘空闲标题显示
5493   -
5494   -params:{}
5495   -
5496   - ----------------- --------------- --------------------------------------
5497   - Json字段 字段含义 赋值及含义
5498   -
5499   - title 标题 最多8个汉字(16个字符)
5500   - ----------------- --------------- --------------------------------------
  5355 +| **Json字段** | **字段含义** | **赋值及含义** |
  5356 +| --- | --- | --- |
  5357 +|title|标题|最多8个汉字(16个字符)|
5501 5358  
5502 5359 指令样例:
5503   -
5504   -{\
5505   -    \"fun\":\"writeKeypadFreeTitle\",
5506   -
5507   -  \"baseId\":1,\
5508   -    \"params\":\
5509   -        {
5510   -
5511   -            \"title\":\"请认真听讲\"
5512   -
5513   -  }\
5514   - }
  5360 +```json
  5361 +{
  5362 + "fun": "writeKeypadFreeTitle",
  5363 + "baseId": 1,
  5364 + "params": {
  5365 + "title": "请认真听讲"
  5366 + }
  5367 +}
  5368 +```
5515 5369  
5516 5370 接收:
5517   -
5518   -fun: \"writeKeypadFreeTitle\" //写键盘空闲标题显示
5519   -
  5371 +fun: "writeKeypadFreeTitle" //写键盘空闲标题显示
5520 5372 baseId: 1//接收到指令的基站ID
5521   -
5522 5373 infos:{}//
5523 5374  
5524   - ----------------- --------------- --------------------------------------
5525   - Json字段 字段含义 赋值及含义
5526   -
5527   - keySn 键盘SN
  5375 +| **Json字段** | **字段含义** | **赋值及含义** |
  5376 +| --- | --- | --- |
  5377 +|keySn|键盘SN||
  5378 +|state|返回信息|OK(成功)|
5528 5379  
5529   - state 返回信息 OK(成功)
5530   - ----------------- --------------- --------------------------------------
5531 5380  
5532 5381 指令样例:
5533 5382  
5534   -{\
5535   -    \"fun\":\"writeKeypadFreeTitle\",
5536   -
5537   -\"baseId\":0,\
5538   -    \"infos\":{\
5539   -        \"state\":\"OK\"\
5540   -    },\
5541   -    \"packetTag\":\"1\"\
  5383 +```json
  5384 +{
  5385 + "fun": "writeKeypadFreeTitle",
  5386 + "baseId": 0,
  5387 + "infos": {
  5388 + "state": "OK"
  5389 + },
  5390 + "packetTag": "1"
5542 5391 }
  5392 +```
5543 5393  
5544 5394 支持设备说明
5545   -
5546   - ----------------------- ----------------------- -----------------------
5547   - 基站+键盘 支持/不支持 备注
5548   -
5549   - B100-2.4G+S6 不支持
5550   -
5551   - B200-2.4G+S6 不支持
5552   -
5553   - B200-5.8G+T2 支持
5554   - ----------------------- ----------------------- -----------------------
  5395 +| **基站+键盘** | **支持** | **备注** |
  5396 +| --- | --- | --- |
  5397 +| B100-2.4G+S6 | 支持 ||
  5398 +| B200-2.4G+S6 | 支持 ||
5555 5399  
5556 5400 ### 自定义信息
5557 5401  
5558 5402 当启动PIN码签到绑定模式,则可对键盘进行绑定操作
5559   -
5560 5403 发送:
  5404 +fun: "writeKeypadCustomInfo" //写键盘的自定义信息
  5405 +params:{}//数组对象,字段不填则保留上次值。
5561 5406  
5562   -fun: \"writeKeypadCustomInfo\" //写键盘的自定义信息
  5407 +| **Json字段** | **字段含义** | **赋值及含义** |
  5408 +| --- | --- | --- |
  5409 +| keySn| 键盘Sn| 空则为所有在线键盘,其他数组值无效|
  5410 +| scoreMode| 分数模式|1-清除<br>2-字符显示(默认值)<br>3-五角星显示<br>4-爱心显示[S6有效]|
  5411 +| scoreValue| 分数值|scoreMode == 1,此处无效. <br>scoreMode == 2,8个字符长度. <br>scoreMode == 3, 0~6,2个分数表示1个五角星,最多3个. <br> scoreMode == 4,0~6,2个分数表示1个爱心,最多3个 [S6有效]|
  5412 +|tipText|提示文本| 最多8个汉字(16个字符),键盘第二行显示|
5563 5413  
5564   -params:{}//数组对象,字段不填则保留上次值。
5565 5414  
5566   -+----------------+--------------+-------------------------------------+
5567   -| Json字段 | 字段含义 | 赋值及含义 |
5568   -+----------------+--------------+-------------------------------------+
5569   -| keySn | 键盘Sn | 空则为所有在线键盘,其他数组值无效 |
5570   -+----------------+--------------+-------------------------------------+
5571   -| scoreMode | 分数模式 | 1-清除 |
5572   -| | | |
5573   -| | | 2-字符显示(默认值) |
5574   -| | | |
5575   -| | | 3-五角星显示 |
5576   -| | | |
5577   -| | | 4-爱心显示\[S6有效\] |
5578   -+----------------+--------------+-------------------------------------+
5579   -| scoreValue | 分数值 | scoreMode==1,此处无效 |
5580   -| | | |
5581   -| | | scoreMode==2,8个字符长度 |
5582   -| | | |
5583   -| | | scoreMode==3, |
5584   -| | | 0\~6,2个分数表示1个五角星,最多3个 |
5585   -| | | |
5586   -| | | scoreMode==4 |
5587   -| | | ,0\~6,2个分数表示1个爱心,最多3个 |
5588   -| | | \[S6有效\] |
5589   -+----------------+--------------+-------------------------------------+
5590   -| tipText | 提示文本 | 最多8个汉字(16个字符), |
5591   -| | | 键盘第二行显示 |
5592   -+----------------+--------------+-------------------------------------+
5593   -
5594   -指令样例:
5595   -
5596   -{\
5597   -    \"fun\":\"writeKeypadCustomInfo\",
5598   -
5599   -  \"baseId\":1,\
5600   -    \"params\":\[\
5601   -        {\
5602   -            \"keySn\":\"1479824643\",
5603   -
5604   -            \"scoreMode\":\"2\",\
5605   -            \"scoreValue\":\"99\",\
5606   -            \"tipText\":\"已绑定\"\
5607   -        }\
5608   -    \],\
5609   -    \"packetTag\":\"1\"\
  5415 +指令样例:
  5416 +样例目的:将SN为"1479824643"的键盘积分位置设置成"99",第二行文本位置设置成"已绑定"。
  5417 +
  5418 +```json
  5419 +{
  5420 + "fun": "writeKeypadCustomInfo",
  5421 + "baseId": 1,
  5422 + "params": [{
  5423 + "keySn": "1479824643",
  5424 + "scoreMode": "2",
  5425 + "scoreValue": "99",
  5426 + "tipText": "已绑定"
  5427 + }],
  5428 + "packetTag": "1"
5610 5429 }
  5430 +```
5611 5431  
5612 5432 接收:
5613 5433  
5614 5434 指定键盘
5615 5435  
5616   -fun: \"writeKeypadCustomInfo\" //写键盘的用户信息
5617   -
  5436 +fun: "writeKeypadCustomInfo" //写键盘的用户信息
5618 5437 baseId:0 //接收到指令的基站ID
5619   -
5620 5438 infos:{}//数组对象
5621 5439  
5622   - ----------------- --------------- --------------------------------------
5623   - Json字段 字段含义 赋值及含义
5624   -
5625   - keySn 键盘Sn
5626   -
5627   - state 状态 OK表示成功
5628   - ----------------- --------------- --------------------------------------
  5440 +| **Json字段** | **字段含义** | **赋值及含义** |
  5441 +| --- | --- | --- |
  5442 +|keySn|键盘SN||
  5443 +|state|状态|OK(成功)|
5629 5444  
5630 5445 指令样例:
5631 5446  
5632   -{\
5633   -    \"fun\":\"writeKeypadCustomInfo\",
5634 5447  
5635   -\"baseId\":0,\
5636   -    \"infos\":\[\
5637   -        {\
5638   -            \"keySn\":\"1479824643\",\
5639   -            \"state\":\"OK\"\
5640   -        }\
5641   -    \],\
5642   -    \"packetTag\":\"1\"\
  5448 +```json
  5449 +{
  5450 + "fun": "writeKeypadCustomInfo",
  5451 + "baseId": 0,
  5452 + "infos": [{
  5453 + "keySn": "1479824643",
  5454 + "state": "OK"
  5455 + }],
  5456 + "packetTag": "1"
5643 5457 }
  5458 +```
5644 5459  
5645 5460 所有键盘
5646 5461  
5647   -fun: \"writeKeypadCustomInfo\" //写键盘的用户信息
5648   -
  5462 +fun: "writeKeypadCustomInfo" //写键盘的用户信息
5649 5463 baseId:0 //接收到指令的基站ID
  5464 +infos:{"state":"OK"}//返回状态,成功为OK
5650 5465  
5651   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
5652 5466  
5653 5467 指令样例:
5654 5468  
5655   -{\
5656   -    \"fun\":\"writeKeypadCustomInfo\",\
5657   -    \"baseId\":0,\
5658   -    \"infos\":{\
5659   -        \"state\":\"OK\"\
5660   -    },\
5661   -    \"packetTag\":\"1\"\
  5469 +```json
  5470 +{
  5471 + "fun": "writeKeypadCustomInfo",
  5472 + "baseId": 0,
  5473 + "infos": {
  5474 + "state": "OK"
  5475 + },
  5476 + "packetTag": "1"
5662 5477 }
  5478 +```
5663 5479  
5664 5480 支持设备说明
5665 5481  
5666   - ----------------------- ----------------------- -----------------------
5667   - 基站+键盘 支持/不支持 备注
5668   -
5669   - B100-2.4G+S6 支持
5670   -
5671   - B200-2.4G+S6 支持
  5482 +| **基站+键盘** | **支持** | **备注** |
  5483 +| --- | --- | --- |
  5484 +| B100-2.4G+S6 | 支持 ||
  5485 +| B200-2.4G+S6 | 支持 ||
  5486 +| B200-5.8G+T2 | 支持 ||
5672 5487  
5673   - B200-5.8G+T2 支持
5674   - ----------------------- ----------------------- -----------------------
5675 5488  
5676 5489 ### 用户姓名
5677 5490  
5678 5491 当启动PIN码签到绑定模式,则可对键盘进行绑定操作
5679 5492  
5680 5493 发送:
5681   -
5682   -fun: \"writeKeypadUserName\" //写键盘的用户姓名
5683   -
  5494 +fun: "writeKeypadUserName" //写键盘的用户姓名
5684 5495 params:{}//数组对象,字段不填则保留上次值。
5685 5496  
5686   - ----------------- --------------- --------------------------------------
5687   - Json字段 字段含义 赋值及含义
5688   -
5689   - keySn 键盘Sn 空则为所有在线键盘,其他数组值无效
5690   -
5691   - userName 姓名 最多24个汉字(48个字符),
5692   - 键盘左上角显示
5693   - ----------------- --------------- --------------------------------------
  5497 +| **Json字段** | **字段含义** | **赋值及含义** |
  5498 +| --- | --- | --- |
  5499 +|keySn|键盘SN|空则为所有在线键盘,其他数组值无效|
  5500 +|userName|姓名|最多24个汉字(48个字符),键盘左上角显示|
5694 5501  
5695 5502 指令样例:
5696 5503  
5697   -{\
5698   -    \"fun\":\"writeKeypadUserName\",
5699   -
5700   -  \"baseId\":1,\
5701   -    \"params\":\[\
5702   -        {\
5703   -            \"keySn\":\"1479824643\",\
5704   -            \"userName\":\"张三\"
5705   -
5706   -        }\
5707   -    \],\
5708   -    \"packetTag\":\"1\"\
  5504 +```json
  5505 +{
  5506 + "fun": "writeKeypadUserName",
  5507 + "baseId": 1,
  5508 + "params": [{
  5509 + "keySn": "1479824643",
  5510 + "userName": "张三"
  5511 + }],
  5512 + "packetTag": "1"
5709 5513 }
  5514 +```
5710 5515  
5711 5516 接收:
5712 5517  
5713 5518 指定键盘
5714   -
5715   -fun: \"writeKeypadUserName\" //写键盘的用户姓名
5716   -
  5519 +fun: "writeKeypadUserName" //写键盘的用户姓名
5717 5520 baseId:0 //接收到指令的基站ID
5718   -
5719 5521 infos:{}//数组对象
5720 5522  
5721   - ----------------- --------------- --------------------------------------
5722   - Json字段 字段含义 赋值及含义
5723   -
5724   - keySn 键盘Sn
  5523 +| **Json字段** | **字段含义** | **赋值及含义** |
  5524 +| --- | --- | --- |
  5525 +|keySn|键盘SN||
  5526 +|state|状态|OK(成功)|
5725 5527  
5726   - state 状态 OK表示成功
5727   - ----------------- --------------- --------------------------------------
5728 5528  
5729 5529 指令样例:
5730 5530  
5731   -{\
5732   -    \"fun\":\"writeKeypadUserName\",
5733   -
5734   -\"baseId\":0,\
5735   -    \"infos\":\
5736   -        {\
5737   -            \"keySn\":\"1479824643\",\
5738   -            \"state\":\"OK\"\
5739   -        } ,\
5740   -    \"packetTag\":\"1\"\
  5531 +```json
  5532 +{
  5533 + "fun": "writeKeypadUserName",
  5534 + "baseId": 0,
  5535 + "infos": {
  5536 + "keySn": "1479824643",
  5537 + "state": "OK"
  5538 + },
  5539 + "packetTag": "1"
5741 5540 }
  5541 +```
5742 5542  
5743 5543 所有键盘
5744 5544  
5745   -fun: \"writeKeypadUserName\" //写键盘的用户信息
5746   -
  5545 +fun: "writeKeypadUserName" //写键盘的用户信息
5747 5546 baseId:0 //接收到指令的基站ID
  5547 +infos:{"state":"OK"}//返回状态,成功为OK
5748 5548  
5749   -infos:{\"state\":\"OK\"}//返回状态,成功为OK
5750 5549  
5751 5550 指令样例:
5752 5551  
5753   -{\
5754   -    \"fun\":\"writeKeypadUserName\",\
5755   -    \"baseId\":0,\
5756   -    \"infos\":{\
5757   -        \"state\":\"OK\"\
5758   -    },\
5759   -    \"packetTag\":\"1\"\
  5552 +```json
  5553 +{
  5554 + "fun": "writeKeypadUserName",
  5555 + "baseId": 0,
  5556 + "infos": {
  5557 + "state": "OK"
  5558 + },
  5559 + "packetTag": "1"
5760 5560 }
  5561 +```
5761 5562  
5762 5563 支持设备说明
5763 5564  
5764   - ----------------------- ----------------------- -----------------------
5765   - 基站+键盘 支持/不支持 备注
5766   -
5767   - B100-2.4G+S6 支持
5768   -
5769   - B200-2.4G+S6 支持
5770   -
5771   - B200-5.8G+T2 支持
5772   - ----------------------- ----------------------- -----------------------
  5565 +| **基站+键盘** | **支持** | **备注** |
  5566 +| --- | --- | --- |
  5567 +| B100-2.4G+S6 | 支持 ||
  5568 +| B200-2.4G+S6 | 支持 ||
  5569 +| B200-5.8G+T2 | 支持 ||
5773 5570  
5774   -### 指定用户姓名\[C100B+S6旧款\]
  5571 +### 指定用户姓名[C100B+S6旧款]
5775 5572  
5776 5573 当启动PIN码签到绑定模式,则可对键盘进行绑定操作
5777   -
5778 5574 发送:
5779   -
5780   -fun: \"writeOneKeypadUserName\" //写键盘的用户姓名
5781   -
  5575 +fun: "writeOneKeypadUserName" //写键盘的用户姓名
5782 5576 params:{}//数组对象,字段不填则保留上次值。
5783 5577  
5784   - ----------------- --------------- --------------------------------------
5785   - Json字段 字段含义 赋值及含义
5786   -
5787   - keySn 键盘Sn 空则为所有在线键盘,其他数组值无效
5788   -
5789   - value 姓名 最多5个汉字(10个字符),
5790   - 键盘左上角显示
5791   - ----------------- --------------- --------------------------------------
  5578 +| **Json字段** | **字段含义** | **赋值及含义** |
  5579 +| --- | --- | --- |
  5580 +|keySn|键盘SN|空则为所有在线键盘,其他数组值无效|
  5581 +|userName|姓名|最多5个汉字(10个字符), 键盘左上角显示|
5792 5582  
5793 5583 指令样例:
5794 5584  
5795   -{\
5796   -    \"fun\":\"writeOneKeypadUserName\",
5797   -
5798   -  \"baseId\":0,\
5799   -    \"params\":\[\
5800   -        {\
5801   -            \"keySn\":\"1479824643\",\
5802   -            \"value\":\"张三\"
5803   -
5804   -        }\
5805   -    \],\
5806   -    \"packetTag\":\"1\"\
  5585 +```json
  5586 +{
  5587 + "fun": "writeOneKeypadUserName",
  5588 + "baseId": 0,
  5589 + "params": [{
  5590 + "keySn": "1479824643",
  5591 + "value": "张三"
  5592 + }],
  5593 + "packetTag": "1"
5807 5594 }
  5595 +```
5808 5596  
5809 5597 接收:
5810 5598  
5811 5599 指定键盘
5812   -
5813   -fun: \"oneKeypadUserName\" //写键盘的用户姓名
5814   -
  5600 +fun: "oneKeypadUserName" //写键盘的用户姓名
5815 5601 baseId:1 //接收到指令的基站ID
5816   -
5817 5602 infos:{}//数组对象
5818 5603  
5819   - ----------------- --------------- --------------------------------------
5820   - Json字段 字段含义 赋值及含义
5821   -
5822   - keySn 键盘Sn
5823   -
5824   - value 姓名 最多5个汉字(10个字符)
5825   - ----------------- --------------- --------------------------------------
  5604 +| **Json字段** | **字段含义** | **赋值及含义** |
  5605 +| --- | --- | --- |
  5606 +|keySn|键盘SN|空则为所有在线键盘,其他数组值无效|
  5607 +|userName|姓名|最多5个汉字(10个字符), 键盘左上角显示|
5826 5608  
5827 5609 指令样例:
5828 5610  
5829   -{\
5830   -    \"fun\":\"oneKeypadUserName\",
5831   -
5832   -\"baseId\":1,\
5833   -    \"infos\":\
5834   -        {\
5835   -            \"keySn\":\"1479824643\",\
5836   -            \"value\":\"张三\"\
5837   -        } ,\
5838   -    \"packetTag\":\"1\"\
  5611 +```json
  5612 +{
  5613 + "fun": "oneKeypadUserName",
  5614 + "baseId": 1,
  5615 + "infos": {
  5616 + "keySn": "1479824643",
  5617 + "value": "张三"
  5618 + },
  5619 + "packetTag": "1"
5839 5620 }
  5621 +```
5840 5622  
5841 5623 支持设备说明
5842 5624  
5843   - ----------------------- ------------------ ----------------------------
5844   - 基站+键盘 支持/不支持 备注
5845   -
5846   - B100-2.4G+S6 不支持
5847   -
5848   - B200-2.4G+S6 不支持
5849   -
5850   - B200-5.8G+T2 不支持
  5625 +| **基站+键盘** | **支持** | **备注** |
  5626 +| --- | --- | --- |
  5627 +| C100B-2.4G+S6 | 支持 |S6旧款支持,不支持生僻字。|
5851 5628  
5852   - C100B-2.4G+S6 支持 S6旧款支持,不支持生僻字。
5853   - ----------------------- ------------------ ----------------------------
5854 5629  
5855 5630 ## 键盘在线信息
5856 5631  
... ... @@ -5859,704 +5634,304 @@ infos:{}//数组对象
5859 5634 基站连接成功后,自动返回所有在线的键盘信息。当键盘在线状态改变时,也会统一返回。
5860 5635  
5861 5636 接收:
5862   -
5863   -fun: \"keypadOnLine\" //键盘在线状态
5864   -
  5637 +fun: "keypadOnLine" //键盘在线状态
5865 5638 infos:{} //数组对象
5866 5639  
5867   - ----------------- --------------- --------------------------------------
5868   - Json字段 字段含义 赋值及含义
5869   -
5870   - keySn 键盘Sn
  5640 +| **Json字段** | **字段含义** | **赋值及含义** |
  5641 +| --- | --- | --- |
  5642 +|keySn|键盘SN||
  5643 +|keyVer|键盘版本||
5871 5644  
5872   - keyVer 键盘版本
5873   - ----------------- --------------- --------------------------------------
5874 5645  
5875 5646 指令样例:
5876 5647  
5877   -{\
5878   -    \"fun\":\"keypadOnLine\",
5879   -
5880   -  \"baseId\":0,\
5881   -    \"infos\":\[\
5882   -        {\
5883   -            \"baseId\":1,\
5884   -            \"keySn\":\"1837454011\",\
5885   -            \"keyVer\":\"1.0.6\"
5886   -
5887   -   },\
5888   -        {\
5889   -            \"baseId\":1,\
5890   -            \"keySn\":\"1837454012\",\
5891   -            \"keyVer\":\"1.0.6\"
5892   -
5893   -    }\
5894   -    \],\
5895   -    \"packetTag\":\"1\"\
  5648 +```json
  5649 +{
  5650 + "fun": "keypadOnLine",
  5651 + "baseId": 0,
  5652 + "infos": [{
  5653 + "baseId": "1",
  5654 + "keySn": "1837454011",
  5655 + "ver": "1.0.6"
  5656 + },
  5657 + {
  5658 + "baseId": "1",
  5659 + "keySn": "1837454012",
  5660 + "ver": "1.0.6"
  5661 + }
  5662 + ],
  5663 + "packetTag": "1"
5896 5664 }
  5665 +```
5897 5666  
5898 5667 支持设备说明
5899 5668  
5900   - ----------------------- ----------------------- -----------------------
5901   - 基站+键盘 支持/不支持 备注
5902   -
5903   - B100-2.4G+S6 不支持
5904   -
5905   - B200-2.4G+S6 不支持
  5669 +| **基站+键盘** | **支持** | **备注** |
  5670 +| --- | --- | --- |
  5671 +| B200-5.8G+T2| 支持 ||
5906 5672  
5907   - B200-5.8G+T2 支持
5908   - ----------------------- ----------------------- -----------------------
5909 5673  
5910 5674 ### 主动获取在线信息
5911 5675  
5912 5676 应用程序在需要时,也可主动获取所有在线键盘信息。
5913 5677  
5914 5678 发送:
5915   -
5916   -fun: \"getKeypadOnLine\" //获取键盘在线状态
5917   -
  5679 +fun: "getKeypadOnLine" //获取键盘在线状态
5918 5680 params:{
  5681 +"times":1 //基站扫描键盘时长,单位秒 范围1-10秒
  5682 +} //
5919 5683  
5920   -\"times\":1 //基站扫描键盘时长,单位秒 范围1-10秒
5921   -
5922   -} //
5923 5684  
5924 5685 指令样例:
5925 5686  
5926   -{\
5927   -    \"fun\":\"getKeypadOnLine\",
5928   -
5929   -\"baseId\":0,
5930   -
5931   -\"params\":{\
5932   -        \"times\":2
5933   -
5934   -},\
5935   -    \"packetTag\":\"1\"\
  5687 +```json
  5688 +{
  5689 + "fun": "getKeypadOnLine",
  5690 + "baseId": 0,
  5691 + "params": {
  5692 + "times": 2
  5693 + },
  5694 + "packetTag": "1"
5936 5695 }
  5696 +```
5937 5697  
5938 5698 接收:
5939   -
5940   -fun: \"keypadOnLine\" //键盘在线状态
5941   -
  5699 +fun: "keypadOnLine" //键盘在线状态
5942 5700 infos:{} //数组对象
5943 5701  
5944   - ----------------- --------------- --------------------------------------
5945   - Json字段 字段含义 赋值及含义
5946   -
5947   - baseId 基站id keySn键盘所在基站id
5948   -
5949   - keySn 键盘Sn
5950   -
5951   - keyVer 键盘版本
5952   -
5953   - Volt 键盘电量 T2百分比值,S6无效
5954   - ----------------- --------------- --------------------------------------
5955   -
5956   -指令样例:
5957   -
5958   -{\
5959   -    \"fun\":\"keypadOnLine\",
5960   -
5961   -\"baseId\":0,\
5962   -    \"infos\":\[\
5963   -         {\
5964   -            \"baseId\":1,\
5965   -            \"keySn\":\"1837454011\",\
5966   -            \"ver\":\"1.0.6\",
5967   -
5968   -\"hModel\":\"67\",
5969   -
5970   -\"Volt\":\"100\"\
5971   -        },\
5972   -        {\
5973   -            \"baseId\":1,\
5974   -            \"keySn\":\"1837454012\",\
5975   -            \"ver\":\"1.0.6\",
5976   -
5977   -\"hModel\":\"67\",
5978   -
5979   -\"Volt\":\"30\"\
5980   -        }\
5981   -    \],\
5982   -    \"packetTag\":\"1\"\
5983   -}
5984   -
5985   -支持设备说明
5986   -
5987   - ----------------------- ----------------------- -----------------------
5988   - 基站+键盘 支持/不支持 备注
5989   -
5990   - B100-2.4G+S6 支持 键盘电量:无效
5991   -
5992   - B200-2.4G+S6 支持 键盘电量:无效
5993   -
5994   - B200-5.8G+T2 支持 键盘电量:百分比值
5995   - ----------------------- ----------------------- -----------------------
5996   -
5997   -### 踢出单只键盘
5998   -
5999   -发送:
6000   -
6001   -fun: \"removeOneKeypadOnLine\" //踢出单只键盘
6002   -
6003   -params:{} //键盘sn
6004   -
6005   -指令样例:
6006   -
6007   -{\
6008   -    \"fun\":\"removeOneKeypadOnLine\",
6009   -
6010   -\"baseId\":0,\
6011   -    \"params\":{\
6012   -        \"keySn\":\"1837454012\"\
6013   -    },\
6014   -    \"packetTag\":\"1\"\
6015   -}
6016   -
6017   -接收:
6018   -
6019   -{\
6020   -    \"fun\":\"removeOneKeypadOnLine\",\
6021   -    \"baseId\":1,\
6022   -    \"packetTag\":\"1\",\
6023   -    \"infos\":{
6024   -
6025   - \" keySn \":\"1837454012\",
6026   -
6027   -  \"state\":\"OK\"\
6028   -    }\
6029   -}
6030   -
6031   -清掉成功后会自动返回键盘在线状态,详见4.8.1。
6032   -
6033   -支持设备说明
6034   -
6035   - ----------------------- ----------------------- -----------------------
6036   - 基站+键盘 支持/不支持 备注
6037   -
6038   - B100-2.4G+S6 不支持
6039   -
6040   - B200-2.4G+S6 不支持
6041   -
6042   - B200-5.8G+T2 支持
6043   - ----------------------- ----------------------- -----------------------
6044   -
6045   -### 清掉所有键盘
6046   -
6047   -发送:
6048   -
6049   -fun: \"clearKeypadOnLine\" //清掉所有键盘
6050   -
6051   -params:{} //无
6052   -
6053   -指令样例:
6054   -
6055   -{\
6056   -    \"fun\":\"clearKeypadOnLine\",
6057   -
6058   -\"packetTag\":\"1\"\
6059   -}
6060   -
6061   -接收:
6062   -
6063   -{\
6064   -    \"fun\":\"clearKeypadOnLine\",\
6065   -    \"baseId\":1,\
6066   -    \"packetTag\":\"1\",\
6067   -    \"infos\":{\
6068   -        \"state\":\"OK\"\
6069   -    }\
6070   -}
6071   -
6072   -支持设备说明
6073   -
6074   - ----------------------- ----------------------- -----------------------
6075   - 基站+键盘 支持/不支持 备注
6076   -
6077   - B100-2.4G+S6 不支持
6078   -
6079   - B200-2.4G+S6 不支持
6080   -
6081   - B200-5.8G+T2 支持
6082   - ----------------------- ----------------------- -----------------------
6083   -
6084   -### 锁定键盘
6085   -
6086   -发送:
6087   -
6088   -fun: \"lockKeypad\" //锁定键盘
6089   -
6090   -params:{} //数组对象,指定键盘需填
6091   -
6092   -指令样例:
6093   -
6094   -锁定指定键盘
6095   -
6096   -{\
6097   -    \"fun\":\"lockKeypad\",\
6098   -    \"params\":\[\
6099   -        {\
6100   -            \"keySn\":\"1837454011\"\
6101   -        },\
6102   -        {\
6103   -            \"keySn\":\"1837454012\"\
6104   -        }\
6105   -    \],\
6106   -    \"packetTag\":\"1\"\
6107   -}
6108   -
6109   -接收:
6110   -
6111   -{\
6112   -    \"fun\":\"lockKeypad\",\
6113   -    \"baseId\":1,\
6114   -    \"infos\":\[\
6115   -        {\
6116   -            \"keySn\":\"1837454011\",\
6117   -            \"state\":\"OK\"\
6118   -        },\
6119   -        {\
6120   -            \"keySn\":\"1837454012\",\
6121   -            \"state\":\"OK\"\
6122   -        }\
6123   -    \],\
6124   -    \"packetTag\":\"1\"\
6125   -}
6126   -
6127   -支持设备说明
6128   -
6129   - ----------------------- ----------------------- -----------------------
6130   - 基站+键盘 支持/不支持 备注
6131   -
6132   - B100-2.4G+S6 不支持
6133   -
6134   - B200-2.4G+S6 不支持
6135   -
6136   - B200-5.8G+T2 支持
6137   - ----------------------- ----------------------- -----------------------
6138   -
6139   -### 解锁键盘
6140   -
6141   -发送:
6142   -
6143   -fun: \"unlockKeypad\" //解锁键盘
  5702 +| **基站+键盘** | **支持** | **备注** |
  5703 +| --- | --- | --- |
  5704 +|baseId|基站id|keySn键盘所在基站id|
  5705 +|keySn|键盘Sn||
  5706 +|keyVer|键盘版本||
  5707 +|Volt|键盘电量|T2百分比值,S6无效|
6144 5708  
6145   -params:{} //数组对象,指定键盘需填
6146 5709  
6147 5710 指令样例:
6148 5711  
6149   -解锁指定键盘
6150   -
6151   -{\
6152   -    \"fun\":\"unlockKeypad\",\
6153   -    \"params\":\[\
6154   -        {\
6155   -            \"keySn\":\"1837454011\"\
6156   -        },\
6157   -        {\
6158   -            \"keySn\":\"1837454012\"\
6159   -        }\
6160   -    \],\
6161   -    \"packetTag\":\"1\"\
6162   -}
6163   -
6164   -接收:
6165   -
6166   -{\
6167   -    \"fun\":\"unlockKeypad\",\
6168   -    \"baseId\":1,\
6169   -    \"infos\":\[\
6170   -        {\
6171   -            \"keySn\":\"1837454011\",\
6172   -            \"state\":\"OK\"\
6173   -        },\
6174   -        {\
6175   -            \"keySn\":\"1837454012\",\
6176   -            \"state\":\"OK\"\
6177   -        }\
6178   -    \],\
6179   -    \"packetTag\":\"1\"\
  5712 +```json
  5713 +{
  5714 + "fun": "keypadOnLine",
  5715 + "baseId": 0,
  5716 + "infos": [{
  5717 + "baseId": "1",
  5718 + "keySn": "1837454011",
  5719 + "ver": "1.0.6",
  5720 + "hModel": "67",
  5721 + "Volt": "100"
  5722 + },
  5723 + {
  5724 + "baseId": "1",
  5725 + "keySn": "1837454012",
  5726 + "ver": "1.0.6",
  5727 + "hModel": "67",
  5728 + "Volt": "30"
  5729 + }
  5730 + ],
  5731 + "packetTag": "1"
6180 5732 }
  5733 +```
6181 5734  
6182 5735 支持设备说明
  5736 +| **基站+键盘** | **支持** | **备注** |
  5737 +| --- | --- | --- |
  5738 +| B100-2.4G+S6 | 支持 |键盘电量:无效|
  5739 +| B200-2.4G+S6 | 支持 |键盘电量:无效|
  5740 +| B200-5.8G+T2 | 支持 |键盘电量:百分比值|
6183 5741  
6184   - ----------------------- ----------------------- -----------------------
6185   - 基站+键盘 支持/不支持 备注
6186   -
6187   - B100-2.4G+S6 不支持
6188   -
6189   - B200-2.4G+S6 不支持
6190   -
6191   - B200-5.8G+T2 支持
6192   - ----------------------- ----------------------- -----------------------
6193 5742  
6194 5743 ## 系统参数
6195 5744  
6196   -### 退出SunVoteWSTrayapp
6197   -
6198   -应用程序发送指令给SunVoteWSTrayapp,SunVoteWSTrayapp回应后将结束SunVoteSDK.exe进程。
  5745 +### 退出WSCmdApp
6199 5746  
  5747 +WSCmdApp,WSCmdApp回应后将结束WSCmdApp.exe进程。
6200 5748 发送:
6201   -
6202   -fun: \"exit\" //退出SunVoteWSTrayapp
6203   -
  5749 +fun: "exit" //退出WSCmdApp
6204 5750 params:{}//无该值
  5751 +packetTag:"1"//收到的packetTag,可用于分析通信状态
6205 5752  
6206   -packetTag:\"1\"//收到的packetTag,可用于分析通信状态
6207 5753  
6208 5754 指令样例:
6209 5755  
6210   -{\
6211   -    \"fun\":\"exit\",\
6212   -    \"packetTag\":\"1\"\
  5756 +```json
  5757 +{
  5758 + "fun": "exit",
  5759 + "packetTag": "1"
6213 5760 }
  5761 +```
6214 5762  
6215 5763 接收:
6216 5764  
6217   -fun: \"exit\" //退出SunVoteWSTrayapp
6218   -
  5765 +fun: "exit" //退出WSCmdApp
6219 5766 infos:{}//无该值
6220 5767  
6221   -指令样例:
6222   -
6223   -{\
6224   -    \"fun\":\"exit\",
6225   -
6226   -    \"packetTag\":\"1\"\
6227   -}
6228   -
6229   -注意:配置文件中启用,命令才有效。
6230   -
6231   -### 托盘图标隐藏或显示
6232   -
6233   -发送:
6234   -
6235   -fun: \"SDKIcon\" //设置托盘图标隐藏或显示
6236   -
6237   -params:{\"value\":\"1\"}//1隐藏;0显示
6238 5768  
6239 5769 指令样例:
6240 5770  
6241   -{\
6242   -    \"fun\":\"SDKIcon\",
6243   -
6244   -\"baseId\":0,
6245   -
6246   -\"params\":{\
6247   -        \"value\":\"1\"\
6248   -    },
6249   -
6250   - \"packetTag\":\"1\"
6251   -
  5771 +```json
  5772 +{
  5773 + "fun": "exit",
  5774 + "packetTag": "1"
6252 5775 }
  5776 +```
6253 5777  
6254   -接收:
6255   -
6256   -fun: \"SDKIcon\"
6257   -
6258   -infos:{\"value\":\"OK\"}
6259   -
6260   -指令样例:
  5778 +注意:配置文件中启用,命令才有效。
6261 5779  
6262   -{\
6263   -    \"fun\":\"SDKIcon\",\
6264   -     \"infos\":{
6265 5780  
6266   -        \"value\":\"OK\"\
6267   -    },
6268   -
6269   - \"packetTag\":\"1\"}\
6270   -}
6271 5781  
6272 5782 ### 支持设备说明
6273 5783  
6274   - ----------------------- ----------------------- -----------------------
6275   - 基站+键盘 支持/不支持 备注
6276   -
6277   - B100-2.4G+S6 支持
6278   -
6279   - B200-2.4G+S6 支持
6280   -
6281   - B200-5.8G+T2 支持
6282   - ----------------------- ----------------------- -----------------------
  5784 +| **基站+键盘** | **支持** | **备注** |
  5785 +| --- | --- | --- |
  5786 +| B100-2.4G+S6 | 支持 ||
  5787 +| B200-2.4G+S6 | 支持 ||
  5788 +| B200-5.8G+T2 | 支持 ||
6283 5789  
6284 5790 ## 异常处理
6285 5791  
6286   -### SunVoteWSTrayapp收到数据异常
  5792 +### WSCmdApp收到数据异常
6287 5793  
6288   -SunVoteWSTrayapp收到异常数据,会不做处理,并返回以下错误信息描述。
  5794 +WSCmdApp收到异常数据,会不做处理,并返回以下错误信息描述。
6289 5795  
6290 5796 接收:
6291   -
6292   -fun: \"error\" //功能错误
6293   -
6294   -baseId: //无该值
6295   -
6296   -infos:{ \"funId\":\"F0001\",\"code\":\"10002\"}//
6297   -
6298   -指令样例:
6299   -
6300   -{\
6301   -    \"fun\":\"error\",\
6302   -    \"infos\":{\
6303   -        \"funId\":\"F0001\",
6304   -
6305   -\"code\":\"10002\"\
6306   -    },\
6307   -    \"packetTag\":\"1\"\
6308   -}
6309   -
6310   -发送:
6311   -
6312   -fun: \"error\" //功能错误
6313   -
  5797 +fun: "error" //功能错误
6314 5798 baseId: //无该值
  5799 +infos:{ "funId":"F0001","code":"10002"}//
6315 5800  
6316   -infos: //无该值
6317 5801  
6318 5802 指令样例:
6319   -
6320   -{\
6321   -    \"fun\":\"error\",
6322   -
6323   -\"packetTag\":\"1\"\
  5803 +```json
  5804 +{
  5805 + "fun": "error",
  5806 + "infos": {
  5807 + "funId": "F0001",
  5808 + "code": "10002"
  5809 + },
  5810 + "packetTag": "1"
6324 5811 }
  5812 +```
6325 5813  
6326   - ---------------------- ------------------------------------------------
6327   - code 含义
6328   -
6329   - 10001 不能正确解析的JSON数据
6330   -
6331   - 10002 解析JSON错误
6332   -
6333   - 20001 基站未连接
6334   -
6335   - 20002 功能不支持
6336   -
6337   - 20003 基站ID为负数,应用可以不传ID,默认为0
6338   -
6339   - 20004 参数错误
6340   -
6341   - 30001 找不到对应的SN
6342   -
6343   - 40001 升级功能只能支持一个基站在线
6344   -
6345   - 50001 此功能必须指定基站ID
6346   -
6347   - 60001 此功能必须指定键盘SN
6348   - ---------------------- ------------------------------------------------
6349   -
6350   - ---------------- ------------------------------------------------------
6351   - funId 含义
6352   -
6353   - F0001 基站未连接
6354   -
6355   - F0002 读基站信道
6356   -
6357   - F0003 写基站信道
6358   -
6359   - F0004 读基站baseId
6360   -
6361   - F0005 写基站baseId
6362   -
6363   - F0006 读基站名称
6364   -
6365   - F0007 写基站名称
6366   -
6367   - F0008 读键盘关机时间等级
6368   -
6369   - F0009 写键盘关机时间等级
6370   -
6371   - F0010 读基站配对码
6372   -
6373   - F0011 写基站配对码
6374   -
6375   - F0012 读基站序列号
6376   -
6377   - F0013 写基站序列号
6378   -
6379   - F0014 读基站硬件和软件版本
6380   -
6381   - F0015 写基站硬件版本
6382   -
6383   - F0016 读基站类型
6384   -
6385   - F0017 写基站类型
6386   -
6387   - F0018 读基站键盘容量和Lock
6388   -
6389   - F0019 写基站键盘容量和Lock
6390   -
6391   - F0020 读手动获取返回在线信息
6392   -
6393   - F0021 写手动获取返回在线信息
6394   -
6395   - F0022 读基站设备RF功率
6396   -
6397   - F0023 写基站设备RF功率
6398   -
6399   - F0024 读基站设备配对模式或基站名称(自定义)
6400   -
6401   - F0025 写基站设备配对模式
6402   -
6403   - F0026 读基站快速配对低功率模式
6404   -
6405   - F0027 写基站快速配对低功率模式
6406   -
6407   - F0028 读键盘登录菜单显示允许\[S6适用\]
6408   -
6409   - F0029 写键盘登录菜单显示允许\[S6适用\]
6410   -
6411   - F0030 读键盘登录密码\[S6适用\]
6412   -
6413   - F0031 写键盘登录密码\[S6适用\]
6414   -
6415   - F0032 读基站名称隐藏开关
6416   -
6417   - F0033 写基站名称隐藏开关
6418   -
6419   - F0034 读基站和键盘之间的心跳开关
6420   -
6421   - F0035 写基站和键盘之间的心跳开关
6422   -
6423   - F0036 读基站语言
6424   -
6425   - F0037 写基站语言
6426   -
6427   - F0038 读基站CRC
6428   -
6429   - F0039 写基站CRC
6430   -
6431   - F0040 写广播投票标题
6432   -
6433   - F0041 核对投票开启密码
6434   -
6435   - F0042 读基站获取投票开启密码
6436   -
6437   - F0043 写基站获取投票开启密码
6438   -
6439   - F0044 读基站用户自定义字符串
6440   -
6441   - F0045 写基站用户自定义字符串
6442   -
6443   - F0046 读基站UID
6444   -
6445   - F0047 写基站UID
6446   -
6447   - F0048 读键盘反馈模式参数
6448   -
6449   - F0049 写键盘反馈模式参数
6450   -
6451   - F0050 读基站当前是开启升级状态
6452   -
6453   - F0051 写基站当前是开启升级状态
6454   -
6455   - F0052 手动停止键盘升级状态
6456   -
6457   - F0053 写键盘当前是开启升级状态
6458   -
6459   - F0054 写踢出单只键盘
6460   -
6461   - F0055 写清掉所有键盘
6462   -
6463   - F0056 写锁定键盘
6464   -
6465   - F0057 写解锁键盘
6466   -
6467   - F0058 写T2键盘第二行文本【空闲模式】
6468   -
6469   - F0059 读考勤基站时钟设置
6470   -
6471   - F0060 写考勤基站时钟设置
6472   -
6473   - F0061 读考勤键盘每秒发送考勤信号次数
6474   -
6475   - F0062 写考勤键盘每秒发送考勤信号次数
6476   -
6477   - F0063 读考勤键盘发送考勤信号功率
6478   -
6479   - F0064 写考勤键盘发送考勤信号功率
6480   -
6481   - F0065 写修改键盘配对码
6482   -
6483   - F0066 写键盘功能提示预设字符串反馈
6484   -
6485   - F0067 写空闲模式
6486   -
6487   - F0068 单选多选带计时模式
6488   -
6489   - F0069 判断题带计时模式
6490   -
6491   - F0070 抢答题带计时模式
6492   -
6493   - F0071 数字题带计时模式
6494   -
6495   - F0072 绑定带计时模式
6496   -
6497   - F0073 基站快速配对
6498   -
6499   - F0074 读基站特征数据
6500   -
6501   - F0075 遥控关机
6502   -
6503   - F0076 读键盘在线SN
6504   -
6505   - F0077 写基站复位
6506   -
6507   - F0078 写键盘外设指令
6508   -
6509   - F0079 写键盘配对码
6510   -
6511   - F0080 写锁定键盘,解锁键盘
6512   -
6513   - F0081 填空题模式
6514   -
6515   - F0082 读NFC信息 姓名
6516   -
6517   - F0083 写NFC信息 姓名
6518   -
6519   - F0084 写NFC配对码
6520   -
6521   - F0085 NFC清除指令
6522   -
6523   - F0086 多题题型开始
6524   -
6525   - F0087 多题题型暂停
6526   -
6527   - F0088 多题题型继续上一次
6528   -
6529   - F0089 多题题型正确答案下发
6530   -
6531   - F0090 多题题型已答题结果转移
6532   -
6533   - F0091 写白名单
6534   -
6535   - F0092 读白名单
6536   -
6537   - F0093 写基站黑名单
6538   -
6539   - F0094 读基站黑名单
6540   -
6541   - F0095 C100B+S6\[旧款\]写键盘姓名
6542   -
6543   - F0096 C100B+S6\[旧款\]读键盘姓名
6544   -
6545   - F0097 键盘暂停休眠操作
6546   -
6547   - F0098 异步测试模式
6548   -
6549   - F0099 Tcp参数读
6550   -
6551   - F0100 Tcp参数写
6552   -
6553   - F0101 自定义题型参数
6554   -
6555   - F0102 写S6短信
6556   -
6557   - F0103 写S6键盘FSN
6558   -
6559   - F0104 自由题模式
6560   -
6561   -
6562   - ---------------- ------------------------------------------------------
  5814 +| **code** | **含义** |
  5815 +| --- | --- |
  5816 +|10001|不能正确解析的JSON数据|
  5817 +|10002|解析JSON错误|
  5818 +|20001|基站未连接|
  5819 +|20002|功能不支持|
  5820 +|20003|基站ID为负数,应用可以不传ID,默认为0|
  5821 +|20004|参数错误|
  5822 +|30001|找不到对应的SN|
  5823 +|40001|升级功能只能支持一个基站在线|
  5824 +|50001|此功能必须指定基站ID|
  5825 +|60001|此功能必须指定键盘SN|
  5826 +
  5827 +| **funId** | **含义** |
  5828 +| --- | --- |
  5829 +|F0001|基站未连接|
  5830 +|F0002|读基站信道|
  5831 +|F0003|写基站信道|
  5832 +|F0004|读基站baseId|
  5833 +|F0005|写基站baseId|
  5834 +|F0006|读基站名称|
  5835 +|F0007|写基站名称|
  5836 +|F0008|读键盘关机时间等级|
  5837 +|F0009|写键盘关机时间等级|
  5838 +|F0010|读基站配对码|
  5839 +|F0011|写基站配对码|
  5840 +|F0012|读基站序列号|
  5841 +|F0013|写基站序列号|
  5842 +|F0014|读基站硬件和软件版本|
  5843 +|F0015|写基站硬件版本|
  5844 +|F0016|读基站类型|
  5845 +|F0017|写基站类型|
  5846 +|F0018|读基站键盘容量和Lock|
  5847 +|F0019|写基站键盘容量和Lock|
  5848 +|F0020|读手动获取返回在线信息|
  5849 +|F0021|写手动获取返回在线信息|
  5850 +|F0022|读基站设备RF功率|
  5851 +|F0023|写基站设备RF功率|
  5852 +|F0024|读基站设备配对模式或基站名称(自定义)|
  5853 +|F0025|写基站设备配对模式|
  5854 +|F0026|读基站快速配对低功率模式|
  5855 +|F0027|写基站快速配对低功率模式|
  5856 +|F0028|读键盘登录菜单显示允许[S6适用]|
  5857 +|F0029|写键盘登录菜单显示允许[S6适用]|
  5858 +|F0030|读键盘登录密码[S6适用]|
  5859 +|F0031|写键盘登录密码[S6适用]|
  5860 +|F0032|读基站名称隐藏开关|
  5861 +|F0033|写基站名称隐藏开关|
  5862 +|F0034|读基站和键盘之间的心跳开关|
  5863 +|F0035|写基站和键盘之间的心跳开关|
  5864 +|F0036|读基站语言|
  5865 +|F0037|写基站语言|
  5866 +|F0038|读基站CRC|
  5867 +|F0039|写基站CRC|
  5868 +|F0040|写广播投票标题|
  5869 +|F0041|核对投票开启密码|
  5870 +|F0042|读基站获取投票开启密码|
  5871 +|F0043|写基站获取投票开启密码|
  5872 +|F0044|读基站用户自定义字符串|
  5873 +|F0045|写基站用户自定义字符串|
  5874 +|F0046|读基站UID|
  5875 +|F0047|写基站UID|
  5876 +|F0048|读键盘反馈模式参数|
  5877 +|F0049|写键盘反馈模式参数|
  5878 +|F0050|读基站当前是开启升级状态|
  5879 +|F0051|写基站当前是开启升级状态|
  5880 +|F0052|手动停止键盘升级状态|
  5881 +|F0053|写键盘当前是开启升级状态|
  5882 +|F0054|写踢出单只键盘|
  5883 +|F0055|写清掉所有键盘|
  5884 +|F0056|写锁定键盘|
  5885 +|F0057|写解锁键盘|
  5886 +|F0058|写T2键盘第二行文本【空闲模式】|
  5887 +|F0059|读考勤基站时钟设置|
  5888 +|F0060|写考勤基站时钟设置|
  5889 +|F0061|读考勤键盘每秒发送考勤信号次数|
  5890 +|F0062|写考勤键盘每秒发送考勤信号次数|
  5891 +|F0063|读考勤键盘发送考勤信号功率|
  5892 +|F0064|写考勤键盘发送考勤信号功率|
  5893 +|F0065|写修改键盘配对码|
  5894 +|F0066|写键盘功能提示预设字符串反馈|
  5895 +|F0067|写空闲模式|
  5896 +|F0068|单选多选带计时模式|
  5897 +|F0069|判断题带计时模式|
  5898 +|F0070|抢答题带计时模式|
  5899 +|F0071|数字题带计时模式|
  5900 +|F0072|绑定带计时模式|
  5901 +|F0073|基站快速配对|
  5902 +|F0074|读基站特征数据|
  5903 +|F0075|遥控关机|
  5904 +|F0076|读键盘在线SN|
  5905 +|F0077|写基站复位|
  5906 +|F0078|写键盘外设指令|
  5907 +|F0079|写键盘配对码|
  5908 +|F0080|写锁定键盘,解锁键盘|
  5909 +|F0081|填空题模式|
  5910 +|F0082|读NFC信息 姓名|
  5911 +|F0083|写NFC信息 姓名|
  5912 +|F0084|写NFC配对码|
  5913 +|F0085|NFC清除指令|
  5914 +|F0086|多题题型开始|
  5915 +|F0087|多题题型暂停|
  5916 +|F0088|多题题型继续上一次|
  5917 +|F0089|多题题型正确答案下发|
  5918 +|F0090|多题题型已答题结果转移|
  5919 +|F0091|写白名单|
  5920 +|F0092|读白名单|
  5921 +|F0093|写基站黑名单|
  5922 +|F0094|读基站黑名单|
  5923 +|F0095|C100B+S6[旧款]写键盘姓名|
  5924 +|F0096|C100B+S6[旧款]读键盘姓名|
  5925 +|F0097|键盘暂停休眠操作|
  5926 +|F0098|异步测试模式|
  5927 +|F0099|Tcp参数读|
  5928 +|F0100|Tcp参数写|
  5929 +|F0101|自定义题型参数|
  5930 +|F0102|写S6短信|
  5931 +|F0103|写S6键盘FSN|
  5932 +|F0104|自由题模式|
  5933 +|F0105|基站AES|
  5934 +|F0106|基站AES 克隆|
  5935 +|F0107|基础参数配置|
  5936 +|F0108|删除指定白名单SN|
  5937 +|F0109|追加指定SN 到白名单|
... ...