李外 / Protocol

Commit 86f5a9ef657a8095984c89ab40de88e529b2c42d

Authored by 刘琴
1 parent 4def48f9

完善一期全部需要完成功能的协议，修改停止答题为公共的停止答题方法

Inline Side-by-side
Showing 1 changed file with 1120 additions and 219 deletions
通讯协议-B200W-MQTT协议[内部].md
  View file @86f5a9e
@@ -76,6 +76,24 @@ @@ -76,6 +76,24 @@
76 76
77 77
78 ## 功能速查一览表 78 ## 功能速查一览表
  79 +### 公共方法
  80 +可以在多种业务中调用的通用方法
  81 +|功能归类|功能|API指令|指令/系统事件|
  82 +|---|---|---|---|
  83 +|停止投票|可停止通过调用startXXX启动的答题业务|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)||
  84 +
  85 +### 公共事件
  86 +无需调用指令，自动返回的事件
  87 +|功能归类|功能|API指令|指令/系统事件|
  88 +|---|---|---|---|
  89 +|公共事件|指令接收状态|-|[sEvtStateCode](#sevtstatecode)|
  90 +|公共事件|基站连接状态变化|-|[sEvtBsConnectState](#sevtbsconnectstate)|
  91 +|公共事件|基站信道冲突|-|[sEvtBsChannelConflict](#sevtbschannelconflict)|
  92 +|公共事件|键盘上线通知|-|[sEvtBsKpOnlineMsg](#sevtbskponlinemsg)|
  93 +|公共事件|键盘刷卡事件|-|[sEvtBsNfcResults](#sevtbsnfcresults)|
  94 +|公共事件|键盘待机实时按键反馈|-|[sEvtKpRtFeedback](#sevtkprtfeedback)|
  95 +|公共事件|键盘举手键实时按键反馈|-|[sEvtKpHandUp](#sevtkphandup)|
  96 +
79 ### 基站管理 97 ### 基站管理
80 |功能归类|功能|API指令|指令/系统事件| 98 |功能归类|功能|API指令|指令/系统事件|
81 |---|---|---|---| 99 |---|---|---|---|
@@ -99,8 +117,16 @@ @@ -99,8 +117,16 @@
99 ||设置基站工作信道|[setBsChannel](#setbschannel)|[fEvtBsChannel](#fevtbschannel)|| 117 ||设置基站工作信道|[setBsChannel](#setbschannel)|[fEvtBsChannel](#fevtbschannel)||
100 |登录设置 - 登录名称|获取基站登录名称|[getBsSSID](#getbsssid)|[fEvtBsSSID](#fevtbsssid)| 118 |登录设置 - 登录名称|获取基站登录名称|[getBsSSID](#getbsssid)|[fEvtBsSSID](#fevtbsssid)|
101 ||设置基站登录名称|[setBsSSID](#setbsssid)|[fEvtBsSSID](#fevtbsssid)|| 119 ||设置基站登录名称|[setBsSSID](#setbsssid)|[fEvtBsSSID](#fevtbsssid)||
  120 +|登录设置 - 登录密码|获取基站登录密码|[getBsLoginPwd](#getbsloginpwd)|[fEvtBsLoginPwd](#fevtbsloginpwd)|
  121 +||设置基站登录密码|[setBsLoginPwd](#setbsloginpwd)|[fEvtBsLoginPwd](#fevtbsloginpwd)||
  122 +|登录设置 - 基站登录状态|获取基站登录状态|[getBsLoginState](#getbsloginstate)|[fEvtBsLoginState](#fevtbsloginstate)|
  123 +||设置基站登录状态|[setBsLoginState](#setbsloginstate)|[fEvtBsLoginState](#fevtbsloginstate)||
102 |键盘统一设置 - 键盘语言|获取键盘语言|[getBsKpLanguage](#getbskplanguage)|[fEvtBsKpLanguage](#fevtbskplanguage)| 124 |键盘统一设置 - 键盘语言|获取键盘语言|[getBsKpLanguage](#getbskplanguage)|[fEvtBsKpLanguage](#fevtbskplanguage)|
103 ||设置键盘语言|[setBsKpLanguage](#setbskplanguage)|[fEvtBsKpLanguage](#fevtbskplanguage)|| 125 ||设置键盘语言|[setBsKpLanguage](#setbskplanguage)|[fEvtBsKpLanguage](#fevtbskplanguage)||
  126 +|键盘统一设置 - 状态语模式|获取状态语设置状态|[getBsKpStbMsgMode](#getbskpstbmsgmode)|[fEvtBsKpStbMsgMode](#fevtbskpstbmsgmode)|
  127 +||设置状态语工作状态|[setBsKpStbMsgMode](#setbskpstbmsgmode)|[fEvtBsKpStbMsgMode](#fevtbskpstbmsgmode)|||
  128 +|键盘统一设置 - 登录菜单|获取键盘登录菜单状态|[getBsKpLoginMenu](#getbskploginmenu)|[fEvtBsKpLoginMenu](#fevtbskploginmenu)|
  129 +||设置键盘登录菜单状态|[setBsKpLoginMenu](#setbskploginmenu)|[fEvtBsKpLoginMenu](#fevtbskploginmenu)|||
104 |键盘统一设置 - 键盘休眠|<font color="red">设置键盘休眠等级(内)</font>|[setBsKpSleepLevel](#setbskpsleeplevel)|[fEvtBsKpSleepLevel](#fevtbskpsleeplevel)| 130 |键盘统一设置 - 键盘休眠|<font color="red">设置键盘休眠等级(内)</font>|[setBsKpSleepLevel](#setbskpsleeplevel)|[fEvtBsKpSleepLevel](#fevtbskpsleeplevel)|
105 ||<font color="red">获取键盘休眠等级(内)</font>|[getBsKpSleepLevel](#getbskpsleeplevel)|[fEvtBsKpSleepLevel](#fevtbskpsleeplevel)| 131 ||<font color="red">获取键盘休眠等级(内)</font>|[getBsKpSleepLevel](#getbskpsleeplevel)|[fEvtBsKpSleepLevel](#fevtbskpsleeplevel)|
106 ||<font color="red">设置键盘暂停休眠状态(内)</font>|[setBsKpPauseSleep](#setbskppausesleep)|[fEvtBsKpPauseSleep](#fevtbskppausesleep)| 132 ||<font color="red">设置键盘暂停休眠状态(内)</font>|[setBsKpPauseSleep](#setbskppausesleep)|[fEvtBsKpPauseSleep](#fevtbskppausesleep)|
@@ -111,6 +137,8 @@ @@ -111,6 +137,8 @@
111 ||清空白名单|[clearBsWhitelist](#clearbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtBsWhitelist](#fevtbswhitelist)| 137 ||清空白名单|[clearBsWhitelist](#clearbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtBsWhitelist](#fevtbswhitelist)|
112 ||增加白名单|[addBsWhitelist](#addbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtAddBsWhitelist](#fevtaddbswhitelist)<br>[fEvtBsWhitelist](#fevtbswhitelist)| 138 ||增加白名单|[addBsWhitelist](#addbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtAddBsWhitelist](#fevtaddbswhitelist)<br>[fEvtBsWhitelist](#fevtbswhitelist)|
113 ||删除白名单|[delBsWhitelist](#delbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtDelBsWhitelist](#fevtdelbswhitelist)<br>[fEvtBsWhitelist](#fevtbswhitelist)| 139 ||删除白名单|[delBsWhitelist](#delbswhitelist)|[sEvtStateCode](#sevtstatecode)<br>[fEvtDelBsWhitelist](#fevtdelbswhitelist)<br>[fEvtBsWhitelist](#fevtbswhitelist)|
  140 +|基站加密 - 软件狗|获取基站软件狗|[getBsSoftwareKey](#getbssoftwarekey)|[fEvtBsSoftwareKey](#fevtbssoftwarekey)|
  141 +||设置基站软件狗|[setBsSoftwareKey](#setbssoftwarekey)|[fEvtBsSoftwareKey](#fevtbssoftwarekey)|
114 |网络设置 - TCP/IP参数|获取TCP/IP参数|[getBsTcpipParams](#getbstcpipparams)|[fEvtBsTcpipParams](#fevtbstcpipparams)| 142 |网络设置 - TCP/IP参数|获取TCP/IP参数|[getBsTcpipParams](#getbstcpipparams)|[fEvtBsTcpipParams](#fevtbstcpipparams)|
115 ||设置TCP/IP参数|[setBsTcpipParams](#setbstcpipparams)|[fEvtBsTcpipParams](#fevtbstcpipparams)|| 143 ||设置TCP/IP参数|[setBsTcpipParams](#setbstcpipparams)|[fEvtBsTcpipParams](#fevtbstcpipparams)||
116 |网络设置 - MQTT参数|获取MQTT参数|[getBsMqttParams](#getbsmqttparams)|[fEvtBsMqttParams](#fevtbsmqttparams)| 144 |网络设置 - MQTT参数|获取MQTT参数|[getBsMqttParams](#getbsmqttparams)|[fEvtBsMqttParams](#fevtbsmqttparams)|
@@ -123,6 +151,13 @@ @@ -123,6 +151,13 @@
123 ### 键盘管理 151 ### 键盘管理
124 |功能归类|功能|API指令|指令事件| 152 |功能归类|功能|API指令|指令事件|
125 |---|---|---|---| 153 |---|---|---|---|
  154 +|<font color="red">识别设置 - 出厂编码(内)|<font color="red">设置键盘出厂编码(内)|[setKpSN](#setkpsn)|[fEvtKpSN](#fevtkpsn)|
  155 +|识别设置 - 键盘编号|获取键盘编号|[getKpID](#getkpid)|[fEvtKpID](#fevtkpid)|
  156 +|<font color="red">识别设置 - 键盘编号(内)|<font color="red">设置键盘编号(内)|[setKpID](#setkpid)|[fEvtKpID](#fevtkpid)|
  157 +|识别设置 - 键盘型号|获取键盘型号|[getKpModel](#getkpmodel)|[fEvtKpModel](#fevtkpmodel)|
  158 +|识别设置 - 键盘固件版本|获取键盘固件版本|[getKpFWVersion](#getKpfwversion)|[fEvtKpFWVersion](#fevtkpfwversion)|
  159 +|<font color="red">识别设置 - 识别模式(内)|<font color="red">获取键盘识别模式(内)|[getKpIdentityMode](#getkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
  160 +||<font color="red">设置键盘识别模式(内)|[setKpIdentityMode](#setkpidentitymode)|[fEvtKpIdentityMode](#fevtkpidentitymode)|
126 |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)| 161 |交互设置 - 用户内置状态语|设置用户内置状态语|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)|
127 |交互设置 - 用户实时提示反馈信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)<br>[fEvtSetKpUserPrompt](#fevtsetkpuserprompt)| 162 |交互设置 - 用户实时提示反馈信息|实时设置提示反馈信息|[rtSetKpUserPrompt](#rtsetkpuserprompt)|[sEvtStateCode](#sevtstatecode)<br>[fEvtSetKpUserPrompt](#fevtsetkpuserprompt)|
128 |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpOnlineMsg](#fevtkponlinemsg)| 163 |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpOnlineMsg](#fevtkponlinemsg)|
@@ -140,7 +175,7 @@ @@ -140,7 +175,7 @@
140 |功能归类|功能|API指令|指令事件| 175 |功能归类|功能|API指令|指令事件|
141 |---|---|---|---| 176 |---|---|---|---|
142 |同步签到|启动同步签到|[startKpSignIn](#startkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)| 177 |同步签到|启动同步签到|[startKpSignIn](#startkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)|
143 -||停止同步签到|[stopKpSignIn](#stopkpsignin)|[sEvtStateCode](#sevtstatecode)| 178 +||停止同步签到|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
144 |随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)| 179 |随时签到|启动随时签到|[rtStartKpSignIn](#rtstartkpsignin)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpSignIn](#fevtkpsignin)|
145 ||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[sEvtStateCode](#sevtstatecode)| 180 ||停止随时签到|[rtStopKpSignIn](#rtstopkpsignin)|[sEvtStateCode](#sevtstatecode)|
146 ||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpLoginAllowed](#fevtkploginallowed)| 181 ||实时PIN签到授权|[rtSetKpLoginAllowed](#rtsetkploginallowed)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpLoginAllowed](#fevtkploginallowed)|
@@ -148,22 +183,44 @@ @@ -148,22 +183,44 @@
148 |功能归类|功能|API指令|指令事件| 183 |功能归类|功能|API指令|指令事件|
149 |---|---|---|---| 184 |---|---|---|---|
150 |判断题|启动判断题答题|[startQATrueFalse](#startqatruefalse)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQATrueFalse](#fevtqatruefalse)| 185 |判断题|启动判断题答题|[startQATrueFalse](#startqatruefalse)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQATrueFalse](#fevtqatruefalse)|
151 -||停止判断题答题|[stopQATrueFalse](#stopqatruefalse)|[sEvtStateCode](#sevtstatecode)| 186 +||停止判断题答题|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
152 |选择题|启动选择题答题|[startQAChoice](#startqachoice)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAChoice](#fevtqachoice)| 187 |选择题|启动选择题答题|[startQAChoice](#startqachoice)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAChoice](#fevtqachoice)|
153 -||停止选择题答题|[stopQAChoice](#stopqachoice)|[sEvtStateCode](#sevtstatecode)| 188 +||停止选择题答题|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
154 |数字题|启动数字题答题|[startQANum](#startqanum)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQANum](#fevtqanum)| 189 |数字题|启动数字题答题|[startQANum](#startqanum)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQANum](#fevtqanum)|
155 -||停止数字题答题|[stopQANum](#stopqanum)|[sEvtStateCode](#sevtstatecode)| 190 +||停止数字题答题|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
156 |抢答题|启动抢答题答题|[startQAQuicker](#startqaquicker)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAQuicker](#fevtqaquicker)| 191 |抢答题|启动抢答题答题|[startQAQuicker](#startqaquicker)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAQuicker](#fevtqaquicker)|
157 -||停止抢答题答题|[stopQAQuicker](#stopqaquicker)|[sEvtStateCode](#sevtstatecode)| 192 +||停止抢答题答题|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
  193 +|待机实时反馈|设置待机实时反馈状态|[setKpStbResponse](#setkpstbresponse)|[fEvtKpStbResponse](#fevtkpstbresponse)<br>[sEvtKpRtFeedback](#sevtkprtfeedback)<br>[sEvtKpHandUp](#sevtkphandup)|
158 ### 在线测验 194 ### 在线测验
159 |功能归类|功能|API指令|指令事件| 195 |功能归类|功能|API指令|指令事件|
160 |---|---|---|---| 196 |---|---|---|---|
161 |标准测验|启动标准测验|[startKpExam](#startkpexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)| 197 |标准测验|启动标准测验|[startKpExam](#startkpexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
162 -||停止标准测验|[stopKpExam](#stopkpexam)|[sEvtStateCode](#sevtstatecode)|  
163 -||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[fEvtKpExam](#fevtkpexam)| 198 +||停止标准测验|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
  199 +||刷新作答数据|[rtGetKpExamData](#rtgetkpexamdata)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)|
164 ||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)<br>[fEvtFinalSubmit](#fevtfinalsubmit)| 200 ||允许键盘提交后退回修改|[rtAllowEdited](#rtkpallowedited)|[sEvtStateCode](#sevtstatecode)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
165 |多科测验|启动多科测验|[startKpMultiExam](#startkpmultiexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)| 201 |多科测验|启动多科测验|[startKpMultiExam](#startkpmultiexam)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExam](#fevtkpexam)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
166 -||停止标准测验|[stopKpMultiExam](#stopkpmultiexam)|[sEvtStateCode](#sevtstatecode)| 202 +||停止标准测验|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
  203 +|自主录分|启动自主录分|[startKpScoreInput](#startkpscoreinput)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpScore](#fevtkpscore)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
  204 +||停止自主录分|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
  205 +
  206 +## 公共方法
  207 +### stopKpVote
  208 +- **主题**: /client/\${baseSN}/send
  209 +- **功能描述**：通用停止键盘答题方法，可以停止如同步签到、按键反馈、在线测验中调用startXXX方法启动的业务
  210 +- **参数说明**
  211 +
  212 +|参数名|类型|限制|非空|说明|
  213 +|-----|-----|-----|-----|-----|
  214 +|fun|string|-|是|事件类型|
  215 +|dataTag|string||否|数据包标识，不需要时可传空字符串|
  216 +
  217 +- **示例代码**
  218 +```json
  219 +{
  220 + "fun":"stopKpVote",
  221 + "dataTag":"1"
  222 +}
  223 +```
167 224
168 ## 公共事件 225 ## 公共事件
169 ### sEvtBsConnectState 226 ### sEvtBsConnectState
@@ -182,7 +239,7 @@ @@ -182,7 +239,7 @@
182 |+version|string||否|基站固件版本| 239 |+version|string||否|基站固件版本|
183 240
184 - **示例代码** 241 - **示例代码**
185 -```Json 242 +```json
186 //连接成功 243 //连接成功
187 { 244 {
188 "fun":"sEvtBsConnectState", 245 "fun":"sEvtBsConnectState",
@@ -216,7 +273,7 @@ @@ -216,7 +273,7 @@
216 |+value|int||是|有冲突的信道| 273 |+value|int||是|有冲突的信道|
217 274
218 - **示例代码** 275 - **示例代码**
219 -```Json 276 +```json
220 { 277 {
221 "fun":"sEvtBsChannelConflict", 278 "fun":"sEvtBsChannelConflict",
222 "dataTag":"1", 279 "dataTag":"1",
@@ -239,7 +296,7 @@ @@ -239,7 +296,7 @@
239 |+value|int||是|刷卡的状态<br>1-成功<br>2-失败| 296 |+value|int||是|刷卡的状态<br>1-成功<br>2-失败|
240 297
241 - **示例代码** 298 - **示例代码**
242 -```Json 299 +```json
243 { 300 {
244 "fun":"sEvtBsNfcResults", 301 "fun":"sEvtBsNfcResults",
245 "dataTag":"1", //不需要时可传空字符串 302 "dataTag":"1", //不需要时可传空字符串
@@ -265,7 +322,7 @@ @@ -265,7 +322,7 @@
265 |+model|int||是|键盘型号| 322 |+model|int||是|键盘型号|
266 323
267 - **示例代码** 324 - **示例代码**
268 -```Json 325 +```json
269 { 326 {
270 "fun":"sEvtBsKpOnlineMsg", 327 "fun":"sEvtBsKpOnlineMsg",
271 "dataTag":"1", 328 "dataTag":"1",
@@ -276,6 +333,52 @@ @@ -276,6 +333,52 @@
276 } 333 }
277 } 334 }
278 ``` 335 ```
  336 +### sEvtKpRtFeedback
  337 +- **主题**: /basestation/\${baseSN}/receive
  338 +- **功能描述**：开启键盘实时反馈后，键盘按键时上报
  339 +- **参数说明**
  340 +
  341 +|参数名|类型|限制|非空|说明|
  342 +|---|---|---|---|---|
  343 +|fun|string|-|是|事件名称|
  344 +|dataTag|string|-|否|数据包标识|
  345 +|data|object|-|是|传送参数的对象|
  346 +|+keySn|string||是|键盘SN|
  347 +|+keyValue|string||是|键盘提交的按键值|
  348 +
  349 +- **示例代码**
  350 +```json
  351 +{
  352 + "fun":"sEvtKpRtFeedback",
  353 + "dataTag":"1",
  354 + "data":{
  355 + "keySn":"1234567890",
  356 + "keyValue":"A"
  357 + }
  358 +}
  359 +```
  360 +### sEvtKpHandUp
  361 +- **主题**: /basestation/\${baseSN}/receive
  362 +- **功能描述**：开启键盘举手功能后，键盘按举手键时上报
  363 +- **参数说明**
  364 +
  365 +|参数名|类型|限制|非空|说明|
  366 +|---|---|---|---|---|
  367 +|fun|string|-|是|事件名称|
  368 +|dataTag|string|-|否|数据包标识|
  369 +|data|object|-|是|传送参数的对象|
  370 +|+keySn|string||是|举手的键盘SN|
  371 +
  372 +- **示例代码**
  373 +```json
  374 +{
  375 + "fun":"sEvtKpHandUp",
  376 + "dataTag":"1",
  377 + "data":{
  378 + "keySn":"1234567890"
  379 + }
  380 +}
  381 +```
279 ### sEvtStateCode 382 ### sEvtStateCode
280 - **主题**: /basestation/\${baseSN}/receive 383 - **主题**: /basestation/\${baseSN}/receive
281 - **功能描述**：返回基站接收指令状态信息 384 - **功能描述**：返回基站接收指令状态信息
@@ -304,7 +407,7 @@ @@ -304,7 +407,7 @@
304 |60001|此功能必须指定键盘SN| 407 |60001|此功能必须指定键盘SN|
305 408
306 - **示例代码** 409 - **示例代码**
307 -```Json 410 +```json
308 { 411 {
309 "fun":"sEvtStateCode", 412 "fun":"sEvtStateCode",
310 "dataTag":"1", 413 "dataTag":"1",
@@ -327,7 +430,7 @@ @@ -327,7 +430,7 @@
327 |fun|string|-|是|固定指令名称| 430 |fun|string|-|是|固定指令名称|
328 |dataTag|string|-|否|数据包标识| 431 |dataTag|string|-|否|数据包标识|
329 - **示例代码** 432 - **示例代码**
330 -```Json 433 +```json
331 { 434 {
332 "fun":"getBsOnlineState", 435 "fun":"getBsOnlineState",
333 "dataTag":"1" 436 "dataTag":"1"
@@ -344,7 +447,7 @@ @@ -344,7 +447,7 @@
344 |fun|string|-|是|固定指令名称| 447 |fun|string|-|是|固定指令名称|
345 |dataTag|string|-|否|数据包标识| 448 |dataTag|string|-|否|数据包标识|
346 - **示例代码** 449 - **示例代码**
347 -```Json 450 +```json
348 { 451 {
349 "fun":"getBsConnectState", 452 "fun":"getBsConnectState",
350 "dataTag":"1" 453 "dataTag":"1"
@@ -370,7 +473,7 @@ @@ -370,7 +473,7 @@
370 |+baseSN|string||否|基站SN| 473 |+baseSN|string||否|基站SN|
371 474
372 - **示例代码** 475 - **示例代码**
373 -```Json 476 +```json
374 //连接成功 477 //连接成功
375 { 478 {
376 "fun":"fEvtBsOnlineState", 479 "fun":"fEvtBsOnlineState",
@@ -398,7 +501,7 @@ @@ -398,7 +501,7 @@
398 |+timeStamp|long ||否|当前时间的时间戳| 501 |+timeStamp|long ||否|当前时间的时间戳|
399 502
400 - **示例代码** 503 - **示例代码**
401 -```Json 504 +```json
402 { 505 {
403 "fun":"timeSync", 506 "fun":"timeSync",
404 "dataTag":"1", 507 "dataTag":"1",
@@ -428,7 +531,7 @@ @@ -428,7 +531,7 @@
428 |+verCode|string||是|内部主题校验码，时间+固定key加密| --> 531 |+verCode|string||是|内部主题校验码，时间+固定key加密| -->
429 532
430 - **示例代码** 533 - **示例代码**
431 -```Json 534 +```json
432 { 535 {
433 "fun":"setBsSN", 536 "fun":"setBsSN",
434 "dataTag":"1", 537 "dataTag":"1",
@@ -448,7 +551,7 @@ @@ -448,7 +551,7 @@
448 |dataTag|string|-|否|数据包标识,可为空字符串| 551 |dataTag|string|-|否|数据包标识,可为空字符串|
449 552
450 - **示例代码** 553 - **示例代码**
451 -```Json 554 +```json
452 { 555 {
453 "fun":"getBsModel", 556 "fun":"getBsModel",
454 "dataTag":"1" 557 "dataTag":"1"
@@ -465,7 +568,7 @@ @@ -465,7 +568,7 @@
465 |dataTag|string|-|否|数据包标识,可为空字符串| 568 |dataTag|string|-|否|数据包标识,可为空字符串|
466 569
467 - **示例代码** 570 - **示例代码**
468 -```Json 571 +```json
469 { 572 {
470 "fun":"getBsFWVersion", 573 "fun":"getBsFWVersion",
471 "dataTag":"1" 574 "dataTag":"1"
@@ -482,7 +585,7 @@ @@ -482,7 +585,7 @@
482 |dataTag|string|-|否|数据包标识,可为空字符串| 585 |dataTag|string|-|否|数据包标识,可为空字符串|
483 586
484 - **示例代码** 587 - **示例代码**
485 -```Json 588 +```json
486 { 589 {
487 "fun":"getBsBIC", 590 "fun":"getBsBIC",
488 "dataTag":"1" 591 "dataTag":"1"
@@ -503,7 +606,7 @@ @@ -503,7 +606,7 @@
503 |+verCode|string||是|内部主题校验码，时间+固定key加密| --> 606 |+verCode|string||是|内部主题校验码，时间+固定key加密| -->
504 607
505 - **示例代码** 608 - **示例代码**
506 -```Json 609 +```json
507 { 610 {
508 "fun":"setBsBIC", 611 "fun":"setBsBIC",
509 "dataTag":"1", 612 "dataTag":"1",
@@ -526,7 +629,7 @@ @@ -526,7 +629,7 @@
526 |+value|string|-|是|基站的出厂编码| 629 |+value|string|-|是|基站的出厂编码|
527 630
528 - **示例代码** 631 - **示例代码**
529 -```Json 632 +```json
530 { 633 {
531 "fun":"fEvtBsSN", 634 "fun":"fEvtBsSN",
532 "dataTag":"1", 635 "dataTag":"1",
@@ -548,7 +651,7 @@ @@ -548,7 +651,7 @@
548 |+value|string|-|是|基站的型号名称| 651 |+value|string|-|是|基站的型号名称|
549 652
550 - **示例代码** 653 - **示例代码**
551 -```Json 654 +```json
552 { 655 {
553 "fun":"fEvtBsModel", 656 "fun":"fEvtBsModel",
554 "dataTag":"1", 657 "dataTag":"1",
@@ -570,7 +673,7 @@ @@ -570,7 +673,7 @@
570 |+value|string||是|基站的固件版本号| 673 |+value|string||是|基站的固件版本号|
571 674
572 - **示例代码** 675 - **示例代码**
573 -```Json 676 +```json
574 { 677 {
575 "fun":"fEvtBsFWVersion", 678 "fun":"fEvtBsFWVersion",
576 "dataTag":"1", 679 "dataTag":"1",
@@ -592,7 +695,7 @@ @@ -592,7 +695,7 @@
592 |+value|string||是|基站的品牌码| 695 |+value|string||是|基站的品牌码|
593 696
594 - **示例代码** 697 - **示例代码**
595 -```Json 698 +```json
596 { 699 {
597 "fun":"fEvtBsBIC", 700 "fun":"fEvtBsBIC",
598 "dataTag":"1", 701 "dataTag":"1",
@@ -614,7 +717,7 @@ @@ -614,7 +717,7 @@
614 |dataTag|string|-|否|数据包标识,可为空字符串| 717 |dataTag|string|-|否|数据包标识,可为空字符串|
615 718
616 - **示例代码** 719 - **示例代码**
617 -```Json 720 +```json
618 { 721 {
619 "fun":"getBsNetworkMode", 722 "fun":"getBsNetworkMode",
620 "dataTag":"1" 723 "dataTag":"1"
@@ -633,7 +736,7 @@ @@ -633,7 +736,7 @@
633 |+value|string|-|是|设置的基站组网模式<br>1-配对模式<br>2-白名单模式| 736 |+value|string|-|是|设置的基站组网模式<br>1-配对模式<br>2-白名单模式|
634 737
635 - **示例代码** 738 - **示例代码**
636 -```Json 739 +```json
637 { 740 {
638 "fun":"setBsNetworkMode", 741 "fun":"setBsNetworkMode",
639 "dataTag":"1", 742 "dataTag":"1",
@@ -653,7 +756,7 @@ @@ -653,7 +756,7 @@
653 |dataTag|string|-|否|数据包标识,可为空字符串| 756 |dataTag|string|-|否|数据包标识,可为空字符串|
654 757
655 - **示例代码** 758 - **示例代码**
656 -```Json 759 +```json
657 { 760 {
658 "fun":"getBsPairCode", 761 "fun":"getBsPairCode",
659 "dataTag":"1" 762 "dataTag":"1"
@@ -674,7 +777,7 @@ @@ -674,7 +777,7 @@
674 |+verCode|string||是|内部主题校验码，时间+固定key加密| --> 777 |+verCode|string||是|内部主题校验码，时间+固定key加密| -->
675 778
676 - **示例代码** 779 - **示例代码**
677 -```Json 780 +```json
678 { 781 {
679 "fun":"setBsPairCode", 782 "fun":"setBsPairCode",
680 "dataTag":"1", 783 "dataTag":"1",
@@ -694,7 +797,7 @@ @@ -694,7 +797,7 @@
694 |dataTag|string|-|否|数据包标识,可为空字符串| 797 |dataTag|string|-|否|数据包标识,可为空字符串|
695 798
696 - **示例代码** 799 - **示例代码**
697 -```Json 800 +```json
698 { 801 {
699 "fun":"getBsNfcLogin", 802 "fun":"getBsNfcLogin",
700 "dataTag":"1" 803 "dataTag":"1"
@@ -713,7 +816,7 @@ @@ -713,7 +816,7 @@
713 |+value|string|-|是|设置的基站刷卡配对状态<br>0-关闭刷卡配对<br>1-开启刷卡配对| 816 |+value|string|-|是|设置的基站刷卡配对状态<br>0-关闭刷卡配对<br>1-开启刷卡配对|
714 817
715 - **示例代码** 818 - **示例代码**
716 -```Json 819 +```json
717 { 820 {
718 "fun":"setBsNfcLogin", 821 "fun":"setBsNfcLogin",
719 "dataTag":"1", 822 "dataTag":"1",
@@ -733,7 +836,7 @@ @@ -733,7 +836,7 @@
733 |dataTag|string|-|否|数据包标识,可为空字符串| 836 |dataTag|string|-|否|数据包标识,可为空字符串|
734 837
735 - **示例代码** 838 - **示例代码**
736 -```Json 839 +```json
737 { 840 {
738 "fun":"getBsChannel", 841 "fun":"getBsChannel",
739 "dataTag":"1" 842 "dataTag":"1"
@@ -752,7 +855,7 @@ @@ -752,7 +855,7 @@
752 |+value|string|-|是|设置的基站信道，可设范围：1-80| 855 |+value|string|-|是|设置的基站信道，可设范围：1-80|
753 856
754 - **示例代码** 857 - **示例代码**
755 -```Json 858 +```json
756 { 859 {
757 "fun":"setBsChannel", 860 "fun":"setBsChannel",
758 "dataTag":"1", 861 "dataTag":"1",
@@ -775,7 +878,7 @@ @@ -775,7 +878,7 @@
775 |+value|string||是|基站的组网模式<br>1-配对模式<br>2-白名单模式| 878 |+value|string||是|基站的组网模式<br>1-配对模式<br>2-白名单模式|
776 879
777 - **示例代码** 880 - **示例代码**
778 -```Json 881 +```json
779 { 882 {
780 "fun":"fEvtBsNetworkMode", 883 "fun":"fEvtBsNetworkMode",
781 "dataTag":"1", 884 "dataTag":"1",
@@ -797,7 +900,7 @@ @@ -797,7 +900,7 @@
797 |+value|string||是|基站的配对码| 900 |+value|string||是|基站的配对码|
798 901
799 - **示例代码** 902 - **示例代码**
800 -```Json 903 +```json
801 { 904 {
802 "fun":"fEvtBsPairCode", 905 "fun":"fEvtBsPairCode",
803 "dataTag":"1", 906 "dataTag":"1",
@@ -820,7 +923,7 @@ @@ -820,7 +923,7 @@
820 |+value|string||是|基站信道| 923 |+value|string||是|基站信道|
821 924
822 - **示例代码** 925 - **示例代码**
823 -```Json 926 +```json
824 { 927 {
825 "fun":"fEvtBsChannel", 928 "fun":"fEvtBsChannel",
826 "dataTag":"1", 929 "dataTag":"1",
@@ -842,7 +945,7 @@ @@ -842,7 +945,7 @@
842 |+value|string||是|0-关闭 1-开启| 945 |+value|string||是|0-关闭 1-开启|
843 946
844 - **示例代码** 947 - **示例代码**
845 -```Json 948 +```json
846 { 949 {
847 "fun":"fEvtBsNfcLogin", 950 "fun":"fEvtBsNfcLogin",
848 "dataTag":"1", 951 "dataTag":"1",
@@ -865,7 +968,7 @@ @@ -865,7 +968,7 @@
865 |dataTag|string|-|否|数据包标识| 968 |dataTag|string|-|否|数据包标识|
866 969
867 - **示例代码** 970 - **示例代码**
868 -```Json 971 +```json
869 { 972 {
870 "fun":"getBsSSID", 973 "fun":"getBsSSID",
871 "dataTag":"1" 974 "dataTag":"1"
@@ -884,7 +987,7 @@ @@ -884,7 +987,7 @@
884 |+value|string||是|设置的基站SSID，最长12字符| 987 |+value|string||是|设置的基站SSID，最长12字符|
885 988
886 - **示例代码** 989 - **示例代码**
887 -```Json 990 +```json
888 { 991 {
889 "fun":"setBsSSID", 992 "fun":"setBsSSID",
890 "dataTag":"1", 993 "dataTag":"1",
@@ -893,6 +996,86 @@ @@ -893,6 +996,86 @@
893 } 996 }
894 } 997 }
895 ``` 998 ```
  999 +##### getBsLoginPwd
  1000 +- **主题**：/client/\${baseSN}/send
  1001 +- **功能描述**：获取基站登录密码
  1002 +- **参数说明**
  1003 +
  1004 +|参数名|类型|限制|是否必填|说明|
  1005 +|---|---|---|---|---|
  1006 +|fun|string|-|是|固定指令名称|
  1007 +|dataTag|string|-|否|数据包标识|
  1008 +
  1009 +- **示例代码**
  1010 +```json
  1011 +{
  1012 + "fun":"getBsLoginPwd",
  1013 + "dataTag":"1"
  1014 +}
  1015 +```
  1016 +##### setBsLoginPwd
  1017 +- **主题**：/client/\${baseSN}/send
  1018 +- **功能描述**：设置基站登录密码
  1019 +- **参数说明**
  1020 +
  1021 +|参数名|类型|限制|是否必填|说明|
  1022 +|---|---|---|---|---|
  1023 +|fun|string|-|是|指令名称|
  1024 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1025 +|data|object|-|是|传送参数的对象|
  1026 +|+value|string||是|设置的基站登录密码，数字类型，为空代表无需密码登录|
  1027 +
  1028 +- **示例代码**
  1029 +```json
  1030 +{
  1031 + "fun":"setBsLoginPwd",
  1032 + "dataTag":"1",
  1033 + "data":{
  1034 + "value":"123456"
  1035 + }
  1036 +}
  1037 +```
  1038 +##### getBsLoginState
  1039 +获取基站登录名称
  1040 +- **主题**：/client/\${baseSN}/send
  1041 +- **功能描述**：获取基站登录状态
  1042 +- **参数说明**
  1043 +
  1044 +|参数名|类型|限制|是否必填|说明|
  1045 +|---|---|---|---|---|
  1046 +|fun|string|-|是|固定指令名称|
  1047 +|dataTag|string|-|否|数据包标识|
  1048 +
  1049 +- **示例代码**
  1050 +```json
  1051 +{
  1052 + "fun":"getBsLoginState",
  1053 + "dataTag":"1"
  1054 +}
  1055 +```
  1056 +##### setBsLoginState
  1057 +- **主题**：/client/\${baseSN}/send
  1058 +- **功能描述**：设置基站登录状态
  1059 +- **参数说明**
  1060 +
  1061 +|参数名|类型|限制|是否必填|说明|
  1062 +|---|---|---|---|---|
  1063 +|fun|string|-|是|指令名称|
  1064 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1065 +|data|object|-|是|传送参数的对象|
  1066 +|+value|string||是|设置是否允许键盘自主登入<br>0 - 不允许键盘登入<br>1 - 允许键盘登入|
  1067 +
  1068 +- **示例代码**
  1069 +```json
  1070 +{
  1071 + "fun":"setBsLoginState",
  1072 + "dataTag":"1",
  1073 + "data":{
  1074 + "value":"1"
  1075 + }
  1076 +}
  1077 +```
  1078 +
896 #### 事件 1079 #### 事件
897 ##### fEvtBsSSID 1080 ##### fEvtBsSSID
898 - **主题**: /basestation/\${baseSN}/receive 1081 - **主题**: /basestation/\${baseSN}/receive
@@ -907,7 +1090,7 @@ @@ -907,7 +1090,7 @@
907 |+value|string||是|基站名称| 1090 |+value|string||是|基站名称|
908 1091
909 - **示例代码** 1092 - **示例代码**
910 -```Json 1093 +```json
911 { 1094 {
912 "fun":"fEvtBsSSID", 1095 "fun":"fEvtBsSSID",
913 "dataTag":"1", 1096 "dataTag":"1",
@@ -916,6 +1099,50 @@ @@ -916,6 +1099,50 @@
916 } 1099 }
917 } 1100 }
918 ``` 1101 ```
  1102 +##### fEvtBsLoginPwd
  1103 +- **主题**: /basestation/\${baseSN}/receive
  1104 +- **功能描述**：返回基站登录密码
  1105 +- **参数说明**
  1106 +
  1107 +|参数名|类型|限制|非空|说明|
  1108 +|---|---|---|---|---|
  1109 +|fun|string|-|是|事件名称|
  1110 +|dataTag|string|-|否|数据包标识，可传空字符串|
  1111 +|data|object|-|是|传送参数的对象|
  1112 +|+value|string||是|基站登录密码|
  1113 +
  1114 +- **示例代码**
  1115 +```json
  1116 +{
  1117 + "fun":"fEvtBsLoginPwd",
  1118 + "dataTag":"1",
  1119 + "data":{
  1120 + "value":"123456"
  1121 + }
  1122 +}
  1123 +```
  1124 +##### fEvtBsLoginState
  1125 +- **主题**: /basestation/\${baseSN}/receive
  1126 +- **功能描述**：返回基站登录状态
  1127 +- **参数说明**
  1128 +
  1129 +|参数名|类型|限制|非空|说明|
  1130 +|---|---|---|---|---|
  1131 +|fun|string|-|是|事件名称|
  1132 +|dataTag|string|-|否|数据包标识，可传空字符串|
  1133 +|data|object|-|是|传送参数的对象|
  1134 +|+value|string||是|基站登录状态|
  1135 +
  1136 +- **示例代码**
  1137 +```json
  1138 +{
  1139 + "fun":"fEvtBsLoginState",
  1140 + "dataTag":"1",
  1141 + "data":{
  1142 + "value":"1"
  1143 + }
  1144 +}
  1145 +```
919 ### 键盘统一设置 1146 ### 键盘统一设置
920 #### 方法 1147 #### 方法
921 ##### getBsKpLanguage 1148 ##### getBsKpLanguage
@@ -929,7 +1156,7 @@ @@ -929,7 +1156,7 @@
929 |dataTag|string|-|否|数据包标识,可为空字符串| 1156 |dataTag|string|-|否|数据包标识,可为空字符串|
930 1157
931 - **示例代码** 1158 - **示例代码**
932 -```Json 1159 +```json
933 { 1160 {
934 "fun":"getBsKpLanguage", 1161 "fun":"getBsKpLanguage",
935 "dataTag":"1" 1162 "dataTag":"1"
@@ -948,7 +1175,7 @@ @@ -948,7 +1175,7 @@
948 |+value|string||是|设置键盘显示的语言<br>1-简体中文<br>2-英文| 1175 |+value|string||是|设置键盘显示的语言<br>1-简体中文<br>2-英文|
949 1176
950 - **示例代码** 1177 - **示例代码**
951 -```Json 1178 +```json
952 { 1179 {
953 "fun":"setBsKpLanguage", 1180 "fun":"setBsKpLanguage",
954 "dataTag":"1", 1181 "dataTag":"1",
@@ -957,10 +1184,9 @@ @@ -957,10 +1184,9 @@
957 } 1184 }
958 } 1185 }
959 ``` 1186 ```
960 -  
961 -##### getBsKpSleepLevel  
962 -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>  
963 -- **功能描述**：获取键盘休眠时间等级 1187 +##### getBsKpStbMsgMode
  1188 +- **主题**：/client/\${baseSN}/send
  1189 +- **功能描述**：获取状态语设置状态
964 - **参数说明** 1190 - **参数说明**
965 1191
966 |参数名|类型|限制|是否必填|说明| 1192 |参数名|类型|限制|是否必填|说明|
@@ -969,16 +1195,15 @@ @@ -969,16 +1195,15 @@
969 |dataTag|string|-|否|数据包标识,可为空字符串| 1195 |dataTag|string|-|否|数据包标识,可为空字符串|
970 1196
971 - **示例代码** 1197 - **示例代码**
972 -```Json 1198 +```json
973 { 1199 {
974 - "fun":"getBsKpSleepLevel", 1200 + "fun":"getBsKpStbMsgMode",
975 "dataTag":"1" 1201 "dataTag":"1"
976 } 1202 }
977 ``` 1203 ```
978 -  
979 -##### setBsKpSleepLevel  
980 -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>  
981 -- **功能描述**：设置键盘休眠时间等级 1204 +##### setBsKpStbMsgMode
  1205 +- **主题**：/client/\${baseSN}/send
  1206 +- **功能描述**：设置状态语工作状态
982 - **参数说明** 1207 - **参数说明**
983 1208
984 |参数名|类型|限制|是否必填|说明| 1209 |参数名|类型|限制|是否必填|说明|
@@ -986,94 +1211,217 @@ @@ -986,94 +1211,217 @@
986 |fun|string|-|是|指令名称| 1211 |fun|string|-|是|指令名称|
987 |dataTag|string|-|否|数据包标识,可为空字符串| 1212 |dataTag|string|-|否|数据包标识,可为空字符串|
988 |data|object|-|是|传送参数的对象| 1213 |data|object|-|是|传送参数的对象|
989 -|+value|string||是|设置键盘休眠的时间等级<br>0-30秒<br>1-2分钟<br>2-10分钟<br>3-45分钟| 1214 +|+value|string||是|设置状态语工作状态<br>0-系统默认<br>1-用户内置|
990 1215
991 - **示例代码** 1216 - **示例代码**
992 -```Json 1217 +```json
993 { 1218 {
994 - "fun":"setBsKpSleepLevel", 1219 + "fun":"setBsKpStbMsgMode",
995 "dataTag":"1", 1220 "dataTag":"1",
996 "data":{ 1221 "data":{
997 - "value":"1" 1222 + "value":"0"
998 } 1223 }
999 } 1224 }
1000 ``` 1225 ```
1001 -  
1002 -##### setBsKpPauseSleep  
1003 -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>  
1004 -- **功能描述**：设置键盘暂停休眠是否开启<br><font color="red">注意：请谨慎使用本功能，务必在相关测试或功能完成后关闭，否则可能会导致键盘异常耗电<br>设置单次生效，基站拔插后复位成关闭状态</font> 1226 +##### getBsKpLoginMenu
  1227 +- **主题**：/client/\${baseSN}/send
  1228 +- **功能描述**：获取键盘登录菜单显示状态
1005 - **参数说明** 1229 - **参数说明**
1006 1230
1007 |参数名|类型|限制|是否必填|说明| 1231 |参数名|类型|限制|是否必填|说明|
1008 |---|---|---|---|---| 1232 |---|---|---|---|---|
1009 |fun|string|-|是|指令名称| 1233 |fun|string|-|是|指令名称|
1010 |dataTag|string|-|否|数据包标识,可为空字符串| 1234 |dataTag|string|-|否|数据包标识,可为空字符串|
1011 -|data|object|-|是|传送参数的对象|  
1012 -|+value|string||是|设置键盘暂停休眠是否开启<br>0-关闭暂停休眠<br>1-开启暂停休眠|  
1013 1235
1014 - **示例代码** 1236 - **示例代码**
1015 -```Json 1237 +```json
1016 { 1238 {
1017 - "fun":"setBsKpPauseSleep",  
1018 - "dataTag":"1",  
1019 - "data":{  
1020 - "value":"1"  
1021 - } 1239 + "fun":"getBsKpLoginMenu",
  1240 + "dataTag":"1"
1022 } 1241 }
1023 ``` 1242 ```
1024 1243
1025 -#### 事件  
1026 -##### fEvtBsKpLanguage  
1027 -- **主题**: /basestation/\${baseSN}/receive  
1028 -- **功能描述**：返回键盘语言 1244 +##### setBsKpLoginMenu
  1245 +- **主题**：/client/\${baseSN}/send
  1246 +- **功能描述**：设置键盘登录菜单显示状态
1029 - **参数说明** 1247 - **参数说明**
1030 1248
1031 -|参数名|类型|限制|非空|说明| 1249 +|参数名|类型|限制|是否必填|说明|
1032 |---|---|---|---|---| 1250 |---|---|---|---|---|
1033 |fun|string|-|是|指令名称| 1251 |fun|string|-|是|指令名称|
1034 |dataTag|string|-|否|数据包标识,可为空字符串| 1252 |dataTag|string|-|否|数据包标识,可为空字符串|
1035 |data|object|-|是|传送参数的对象| 1253 |data|object|-|是|传送参数的对象|
1036 -|+value|string||是|键盘显示的语言<br>1-简体中文<br>2-英文| 1254 +|+value|string||是|设置键盘登录菜单显示状态<br>0-不显示<br>1-显示|
1037 1255
1038 - **示例代码** 1256 - **示例代码**
1039 -```Json 1257 +```json
1040 { 1258 {
1041 - "fun":"fEvtBsKpLanguage", 1259 + "fun":"setBsKpLoginMenu",
1042 "dataTag":"1", 1260 "dataTag":"1",
1043 "data":{ 1261 "data":{
1044 "value":"1" 1262 "value":"1"
1045 } 1263 }
1046 } 1264 }
1047 ``` 1265 ```
1048 -  
1049 -##### fEvtBsKpSleepLevel  
1050 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1051 -- **功能描述**：返回键盘休眠时间等级 1266 +##### getBsKpSleepLevel
  1267 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1268 +- **功能描述**：获取键盘休眠时间等级
1052 - **参数说明** 1269 - **参数说明**
1053 1270
1054 -|参数名|类型|限制|非空|说明| 1271 +|参数名|类型|限制|是否必填|说明|
1055 |---|---|---|---|---| 1272 |---|---|---|---|---|
1056 |fun|string|-|是|指令名称| 1273 |fun|string|-|是|指令名称|
1057 |dataTag|string|-|否|数据包标识,可为空字符串| 1274 |dataTag|string|-|否|数据包标识,可为空字符串|
1058 -|data|object|-|是|传送参数的对象|  
1059 -|+value|string||是|键盘休眠的时间等级<br>0-30秒<br>1-2分钟<br>2-10分钟<br>3-45分钟|  
1060 1275
1061 - **示例代码** 1276 - **示例代码**
1062 -```Json 1277 +```json
1063 { 1278 {
1064 - "fun":"fEvtBsKpSleepLevel",  
1065 - "dataTag":"1",  
1066 - "data":{  
1067 - "value":"1"  
1068 - } 1279 + "fun":"getBsKpSleepLevel",
  1280 + "dataTag":"1"
1069 } 1281 }
1070 ``` 1282 ```
1071 1283
1072 -##### fEvtBsKpPauseSleep  
1073 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1074 -- **功能描述**：返回暂停键盘休眠开启状态  
1075 -- **参数说明**  
1076 - 1284 +##### setBsKpSleepLevel
  1285 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1286 +- **功能描述**：设置键盘休眠时间等级
  1287 +- **参数说明**
  1288 +
  1289 +|参数名|类型|限制|是否必填|说明|
  1290 +|---|---|---|---|---|
  1291 +|fun|string|-|是|指令名称|
  1292 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1293 +|data|object|-|是|传送参数的对象|
  1294 +|+value|string||是|设置键盘休眠的时间等级<br>0-30秒<br>1-2分钟<br>2-10分钟<br>3-45分钟|
  1295 +
  1296 +- **示例代码**
  1297 +```json
  1298 +{
  1299 + "fun":"setBsKpSleepLevel",
  1300 + "dataTag":"1",
  1301 + "data":{
  1302 + "value":"1"
  1303 + }
  1304 +}
  1305 +```
  1306 +
  1307 +##### setBsKpPauseSleep
  1308 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  1309 +- **功能描述**：设置键盘暂停休眠是否开启<br><font color="red">注意：请谨慎使用本功能，务必在相关测试或功能完成后关闭，否则可能会导致键盘异常耗电<br>设置单次生效，基站拔插后复位成关闭状态</font>
  1310 +- **参数说明**
  1311 +
  1312 +|参数名|类型|限制|是否必填|说明|
  1313 +|---|---|---|---|---|
  1314 +|fun|string|-|是|指令名称|
  1315 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1316 +|data|object|-|是|传送参数的对象|
  1317 +|+value|string||是|设置键盘暂停休眠是否开启<br>0-关闭暂停休眠<br>1-开启暂停休眠|
  1318 +
  1319 +- **示例代码**
  1320 +```json
  1321 +{
  1322 + "fun":"setBsKpPauseSleep",
  1323 + "dataTag":"1",
  1324 + "data":{
  1325 + "value":"1"
  1326 + }
  1327 +}
  1328 +```
  1329 +
  1330 +#### 事件
  1331 +##### fEvtBsKpLanguage
  1332 +- **主题**: /basestation/\${baseSN}/receive
  1333 +- **功能描述**：返回键盘语言
  1334 +- **参数说明**
  1335 +
  1336 +|参数名|类型|限制|非空|说明|
  1337 +|---|---|---|---|---|
  1338 +|fun|string|-|是|指令名称|
  1339 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1340 +|data|object|-|是|传送参数的对象|
  1341 +|+value|string||是|键盘显示的语言<br>1-简体中文<br>2-英文|
  1342 +
  1343 +- **示例代码**
  1344 +```json
  1345 +{
  1346 + "fun":"fEvtBsKpLanguage",
  1347 + "dataTag":"1",
  1348 + "data":{
  1349 + "value":"1"
  1350 + }
  1351 +}
  1352 +```
  1353 +##### fEvtBsKpStbMsgMode
  1354 +- **主题**: /basestation/\${baseSN}/receive
  1355 +- **功能描述**：返回状态语工作状态
  1356 +- **参数说明**
  1357 +
  1358 +|参数名|类型|限制|非空|说明|
  1359 +|---|---|---|---|---|
  1360 +|fun|string|-|是|指令名称|
  1361 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1362 +|data|object|-|是|传送参数的对象|
  1363 +|+value|string||是|返回状态语工作状态<br>0-系统默认<br>1-用户内置|
  1364 +
  1365 +- **示例代码**
  1366 +```json
  1367 +{
  1368 + "fun":"fEvtBsKpStbMsgMode",
  1369 + "dataTag":"1",
  1370 + "data":{
  1371 + "value":"0"
  1372 + }
  1373 +}
  1374 +```
  1375 +##### fEvtBsKpLoginMenu
  1376 +- **主题**: /basestation/\${baseSN}/receive
  1377 +- **功能描述**：返回键盘登录菜单显示状态
  1378 +- **参数说明**
  1379 +
  1380 +|参数名|类型|限制|非空|说明|
  1381 +|---|---|---|---|---|
  1382 +|fun|string|-|是|指令名称|
  1383 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1384 +|data|object|-|是|传送参数的对象|
  1385 +|+value|string||是|返回键盘登录菜单显示状态<br>0-不显示<br>1-显示|
  1386 +
  1387 +- **示例代码**
  1388 +```json
  1389 +{
  1390 + "fun":"fEvtBsKpLoginMenu",
  1391 + "dataTag":"1",
  1392 + "data":{
  1393 + "value":"0"
  1394 + }
  1395 +}
  1396 +```
  1397 +##### fEvtBsKpSleepLevel
  1398 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  1399 +- **功能描述**：返回键盘休眠时间等级
  1400 +- **参数说明**
  1401 +
  1402 +|参数名|类型|限制|非空|说明|
  1403 +|---|---|---|---|---|
  1404 +|fun|string|-|是|指令名称|
  1405 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1406 +|data|object|-|是|传送参数的对象|
  1407 +|+value|string||是|键盘休眠的时间等级<br>0-30秒<br>1-2分钟<br>2-10分钟<br>3-45分钟|
  1408 +
  1409 +- **示例代码**
  1410 +```json
  1411 +{
  1412 + "fun":"fEvtBsKpSleepLevel",
  1413 + "dataTag":"1",
  1414 + "data":{
  1415 + "value":"1"
  1416 + }
  1417 +}
  1418 +```
  1419 +
  1420 +##### fEvtBsKpPauseSleep
  1421 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  1422 +- **功能描述**：返回暂停键盘休眠开启状态
  1423 +- **参数说明**
  1424 +
1077 |参数名|类型|限制|非空|说明| 1425 |参数名|类型|限制|非空|说明|
1078 |---|---|---|---|---| 1426 |---|---|---|---|---|
1079 |fun|string|-|是|指令名称| 1427 |fun|string|-|是|指令名称|
@@ -1082,7 +1430,7 @@ @@ -1082,7 +1430,7 @@
1082 |+value|string||是|返回暂停键盘休眠开启状态<br>0-未开启暂停休眠<br>1-开启暂停休眠| 1430 |+value|string||是|返回暂停键盘休眠开启状态<br>0-未开启暂停休眠<br>1-开启暂停休眠|
1083 1431
1084 - **示例代码** 1432 - **示例代码**
1085 -```Json 1433 +```json
1086 { 1434 {
1087 "fun":"fEvtBsKpPauseSleep", 1435 "fun":"fEvtBsKpPauseSleep",
1088 "dataTag":"1", 1436 "dataTag":"1",
@@ -1254,7 +1602,7 @@ @@ -1254,7 +1602,7 @@
1254 |+keySns|array||是|基站当前的白名单列表| 1602 |+keySns|array||是|基站当前的白名单列表|
1255 1603
1256 - **示例代码** 1604 - **示例代码**
1257 -```Json 1605 +```json
1258 { 1606 {
1259 "fun":"fEvtBsWhitelist", 1607 "fun":"fEvtBsWhitelist",
1260 "dataTag":"1", 1608 "dataTag":"1",
@@ -1278,7 +1626,7 @@ @@ -1278,7 +1626,7 @@
1278 |++state|int||是|键盘SN的写入状态 <br>0-写入成功<br> 1-写入失败| 1626 |++state|int||是|键盘SN的写入状态 <br>0-写入成功<br> 1-写入失败|
1279 1627
1280 - **示例代码** 1628 - **示例代码**
1281 -```Json 1629 +```json
1282 { 1630 {
1283 "fun":"fEvtSetBsWhitelist", 1631 "fun":"fEvtSetBsWhitelist",
1284 "dataTag":"1", 1632 "dataTag":"1",
@@ -1306,7 +1654,7 @@ @@ -1306,7 +1654,7 @@
1306 |++state|int||是|键盘的增加状态 <br>0-增加成功<br> 1-增加失败| 1654 |++state|int||是|键盘的增加状态 <br>0-增加成功<br> 1-增加失败|
1307 1655
1308 - **示例代码** 1656 - **示例代码**
1309 -```Json 1657 +```json
1310 { 1658 {
1311 "fun":"fEvtAddBsWhitelist", 1659 "fun":"fEvtAddBsWhitelist",
1312 "dataTag":"1", 1660 "dataTag":"1",
@@ -1334,7 +1682,7 @@ @@ -1334,7 +1682,7 @@
1334 |++state|int||是|键盘的删除状态 <br>0-删除成功<br> 1-删除失败| 1682 |++state|int||是|键盘的删除状态 <br>0-删除成功<br> 1-删除失败|
1335 1683
1336 - **示例代码** 1684 - **示例代码**
1337 -```Json 1685 +```json
1338 { 1686 {
1339 "fun":"fEvtDelBsWhitelist", 1687 "fun":"fEvtDelBsWhitelist",
1340 "dataTag":"1", 1688 "dataTag":"1",
@@ -1361,7 +1709,7 @@ @@ -1361,7 +1709,7 @@
1361 |dataTag|string|-|否|数据包标识,可为空字符串| 1709 |dataTag|string|-|否|数据包标识,可为空字符串|
1362 1710
1363 - **示例代码** 1711 - **示例代码**
1364 -```Json 1712 +```json
1365 { 1713 {
1366 "fun":"getBsTcpipParams", 1714 "fun":"getBsTcpipParams",
1367 "dataTag":"1" 1715 "dataTag":"1"
@@ -1383,7 +1731,7 @@ @@ -1383,7 +1731,7 @@
1383 |+ipAllocation|int||否|基站IP获取方式<br>0 - 手动指定<br>1 - DHCP获取| 1731 |+ipAllocation|int||否|基站IP获取方式<br>0 - 手动指定<br>1 - DHCP获取|
1384 1732
1385 - **示例代码** 1733 - **示例代码**
1386 -```Json 1734 +```json
1387 { 1735 {
1388 "fun":"setBsTcpipParams", 1736 "fun":"setBsTcpipParams",
1389 "dataTag":"1", 1737 "dataTag":"1",
@@ -1406,7 +1754,7 @@ @@ -1406,7 +1754,7 @@
1406 |dataTag|string|-|否|数据包标识,可为空字符串| 1754 |dataTag|string|-|否|数据包标识,可为空字符串|
1407 1755
1408 - **示例代码** 1756 - **示例代码**
1409 -```Json 1757 +```json
1410 { 1758 {
1411 "fun":"getBsMqttParams", 1759 "fun":"getBsMqttParams",
1412 "dataTag":"1" 1760 "dataTag":"1"
@@ -1429,7 +1777,7 @@ @@ -1429,7 +1777,7 @@
1429 |+interval|int|>=10|否|基站连接服务器失败后重连的间隔时长，单位秒| 1777 |+interval|int|>=10|否|基站连接服务器失败后重连的间隔时长，单位秒|
1430 1778
1431 - **示例代码** 1779 - **示例代码**
1432 -```Json 1780 +```json
1433 { 1781 {
1434 "fun":"setBsMqttParams", 1782 "fun":"setBsMqttParams",
1435 "dataTag":"1", 1783 "dataTag":"1",
@@ -1460,7 +1808,7 @@ @@ -1460,7 +1808,7 @@
1460 |+ipAllocation|int||否|基站IP获取方式<br>0 - 手动指定<br>1 - DHCP获取| 1808 |+ipAllocation|int||否|基站IP获取方式<br>0 - 手动指定<br>1 - DHCP获取|
1461 1809
1462 - **示例代码** 1810 - **示例代码**
1463 -```Json 1811 +```json
1464 { 1812 {
1465 "fun":"fEvtBsTcpipParams", 1813 "fun":"fEvtBsTcpipParams",
1466 "dataTag":"1", 1814 "dataTag":"1",
@@ -1490,7 +1838,7 @@ @@ -1490,7 +1838,7 @@
1490 |+interval|int|>=10|否|基站连接服务器失败后重连的间隔时长，单位秒| 1838 |+interval|int|>=10|否|基站连接服务器失败后重连的间隔时长，单位秒|
1491 1839
1492 - **示例代码** 1840 - **示例代码**
1493 -```Json 1841 +```json
1494 { 1842 {
1495 "fun":"fEvtBsMqttParams", 1843 "fun":"fEvtBsMqttParams",
1496 "dataTag":"1", 1844 "dataTag":"1",
@@ -1503,6 +1851,70 @@ @@ -1503,6 +1851,70 @@
1503 } 1851 }
1504 } 1852 }
1505 ``` 1853 ```
  1854 +### 基站加密
  1855 +#### 方法
  1856 +##### getBsSoftwareKey
  1857 +- **主题**：/client/\${baseSN}/send
  1858 +- **功能描述**：获取基站软件狗密钥
  1859 +- **参数说明**
  1860 +
  1861 +|参数名|类型|限制|是否必填|说明|
  1862 +|---|---|---|---|---|
  1863 +|fun|string|-|是|指令名称|
  1864 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1865 +
  1866 +- **示例代码**
  1867 +```json
  1868 +{
  1869 + "fun":"getBsSoftwareKey",
  1870 + "dataTag":"1"
  1871 +}
  1872 +```
  1873 +##### setBsSoftwareKey
  1874 +- **主题**：/client/\${baseSN}/send
  1875 +- **功能描述**：设置基站软件狗密钥
  1876 +- **参数说明**
  1877 +
  1878 +|参数名|类型|限制|是否必填|说明|
  1879 +|---|---|---|---|---|
  1880 +|fun|string|-|是|指令名称|
  1881 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1882 +|data|object|-|是|传送参数的对象|
  1883 +|+value|string|-|是|基站软件狗密钥，长度不超过32字节|
  1884 +
  1885 +- **示例代码**
  1886 +```json
  1887 +{
  1888 + "fun":"setBsSoftwareKey",
  1889 + "dataTag":"1",
  1890 + "data":{
  1891 + "value":"sunvote123456"
  1892 + }
  1893 +}
  1894 +```
  1895 +#### 事件
  1896 +##### fEvtBsSoftwareKey
  1897 +- **主题**：/basestation/\${baseSN}/receive
  1898 +- **功能描述**：返回基站的软件狗密钥
  1899 +- **参数说明**
  1900 +
  1901 +|参数名|类型|限制|非空|说明|
  1902 +|---|---|---|---|---|
  1903 +|fun|string|-|是|指令名称|
  1904 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1905 +|data|object|-|是|传送参数的对象|
  1906 +|+value|string||是|返回基站的软件狗密钥|
  1907 +
  1908 +- **示例代码**
  1909 +```json
  1910 +{
  1911 + "fun":"fEvtBsSoftwareKey",
  1912 + "dataTag":"1",
  1913 + "data":{
  1914 + "value":"sunvote123456"
  1915 + }
  1916 +}
  1917 +```
1506 ### 基站维护 1918 ### 基站维护
1507 #### 方法 1919 #### 方法
1508 ##### getBsLogInfo 1920 ##### getBsLogInfo
@@ -1516,7 +1928,7 @@ @@ -1516,7 +1928,7 @@
1516 |dataTag|string|-|否|数据包标识,可为空字符串| 1928 |dataTag|string|-|否|数据包标识,可为空字符串|
1517 1929
1518 - **示例代码** 1930 - **示例代码**
1519 -```Json 1931 +```json
1520 { 1932 {
1521 "fun":"getBsLogInfo", 1933 "fun":"getBsLogInfo",
1522 "dataTag":"1" 1934 "dataTag":"1"
@@ -1534,7 +1946,7 @@ @@ -1534,7 +1946,7 @@
1534 |dataTag|string|-|否|数据包标识,可为空字符串| 1946 |dataTag|string|-|否|数据包标识,可为空字符串|
1535 1947
1536 - **示例代码** 1948 - **示例代码**
1537 -```Json 1949 +```json
1538 { 1950 {
1539 "fun":"resetBsSystem", 1951 "fun":"resetBsSystem",
1540 "dataTag":"1" 1952 "dataTag":"1"
@@ -1552,7 +1964,7 @@ @@ -1552,7 +1964,7 @@
1552 |dataTag|string|-|否|数据包标识,可为空字符串| 1964 |dataTag|string|-|否|数据包标识,可为空字符串|
1553 1965
1554 - **示例代码** 1966 - **示例代码**
1555 -```Json 1967 +```json
1556 { 1968 {
1557 "fun":"resetBsPower", 1969 "fun":"resetBsPower",
1558 "dataTag":"1" 1970 "dataTag":"1"
@@ -1567,35 +1979,334 @@ @@ -1567,35 +1979,334 @@
1567 ##### [sEvtBsConnectState](#sevtbsconnectstate) 1979 ##### [sEvtBsConnectState](#sevtbsconnectstate)
1568 复位基站后，基站重新连接成功后上报 1980 复位基站后，基站重新连接成功后上报
1569 1981
1570 -##### fEvtBsLogInfo  
1571 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1572 -- **功能描述**：返回基站存储的日志内容 1982 +##### fEvtBsLogInfo
  1983 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  1984 +- **功能描述**：返回基站存储的日志内容
  1985 +- **参数说明**
  1986 +
  1987 +|参数名|类型|限制|非空|说明|
  1988 +|---|---|---|---|---|
  1989 +|fun|string|-|是|指令名称|
  1990 +|dataTag|string|-|否|数据包标识,可为空字符串|
  1991 +|data|object|-|是|传送参数的对象|
  1992 +|+index|int||是|数据包序号，从1开始，传0代表日志已传完|
  1993 +|+info|string||是|日志内容<br><font color="red">日志的时间依赖于基站授时，需要加上时区得到具体的时间</font>|
  1994 +
  1995 +- **示例代码**
  1996 +```json
  1997 +{
  1998 + "fun":"fEvtBsLogInfo",
  1999 + "dataTag":"1",
  2000 + "data":{
  2001 + "index":1,
  2002 + "info":"XXXXXXXXXXXXX"
  2003 + }
  2004 +}
  2005 +```
  2006 +### 基站升级
  2007 +#### 方法
  2008 +##### startBsUpdate
  2009 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2010 +- **功能描述**:基站固件升级
  2011 +- **参数说明**
  2012 +
  2013 +|参数名|类型|限制|是否必填|说明|
  2014 +|---|---|---|---|---|
  2015 +|fun|string|-|是|指令名称|
  2016 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2017 +|data|object|-|是|传送参数的对象|
  2018 +|+partition|int||是|存储区域<br> 1-备份区<font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，然后上电，这时基站固件就会更新成备份区的固件</font><br>2-更新区，实时升级基站固件|
  2019 +|+url|string||是|待升级的固件地址，可访问的网络url|
  2020 +|+version|string||是|待升级的基站固件版本|
  2021 +|+crc|uint||是|固件CRC校验码，10进制数字|
  2022 +<!-- |+time|string||是|时间，yyyyMMddHHmmss|
  2023 +|+verCode|string||是|内部主题校验码，时间+固定key加密| -->
  2024 +
  2025 +- **示例代码**
  2026 +```json
  2027 +{
  2028 + "fun":"startBsUpdate",
  2029 + "dataTag":"1",
  2030 + "data":{
  2031 + "partition":2,
  2032 + "url":"http://192.168.10.10/V1.0.3.bin",
  2033 + "version":"1.0.3",
  2034 + "crc":1429319861
  2035 + }
  2036 +}
  2037 +```
  2038 +##### downloadFontLib
  2039 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2040 +- **功能描述**:下载更新基站字库文件
  2041 +- **参数说明**
  2042 +
  2043 +|参数名|类型|限制|是否必填|说明|
  2044 +|---|---|---|---|---|
  2045 +|fun|string|-|是|指令名称|
  2046 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2047 +|data|object|-|是|传送参数的对象|
  2048 +|+partition|int||是|存储区域<br> 1-备份区<br>2-更新区|
  2049 +|+url|string||是|待下载的字库地址，可访问的网络url|
  2050 +|+version|string||是|待升级的字库版本|
  2051 +|+crc|int||是|字库CRC校验码，10进制数字|
  2052 +<!-- |+time|string||是|时间，yyyyMMddHHmmss|
  2053 +|+verCode|string||是|内部主题校验码，时间+固定key加密| -->
  2054 +
  2055 +- **示例代码**
  2056 +```json
  2057 +{
  2058 + "fun":"downloadFontLib",
  2059 + "dataTag":"1",
  2060 + "data":{
  2061 + "partition":2,
  2062 + "url":"http://192.168.10.10/V1.0.3.bin",
  2063 + "version":"1.0.3",
  2064 + "crc":1429319861
  2065 + }
  2066 +}
  2067 +```
  2068 +
  2069 +#### 事件
  2070 +##### [sEvtStateCode](#sevtstatecode)
  2071 +返回升级指令的接收状态
  2072 +注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
  2073 +
  2074 +##### fEvtBsUpateState
  2075 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2076 +- **功能描述**：返回基站启动升级状态
  2077 +- **参数说明**
  2078 +
  2079 +|参数名|类型|限制|非空|说明|
  2080 +|---|---|---|---|---|
  2081 +|fun|string|-|是|指令名称|
  2082 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2083 +|data|object|-|是|传送参数的对象|
  2084 +|+state|int||是|启动升级状态<br>0 - 准备升级<br>1 - 升级成功<br>2 - 升级失败
  2085 +|+msg|string||否|返回的失败原因
  2086 +
  2087 +- **示例代码**
  2088 +```json
  2089 +{
  2090 + "fun":"fEvtBsUpateState",
  2091 + "dataTag":"1",
  2092 + "data":{
  2093 + "state":2,
  2094 + "msg":"error msg"
  2095 + }
  2096 +}
  2097 +```
  2098 +
  2099 +##### fEvtBsUpdateProgress
  2100 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2101 +- **功能描述**：返回基站升级进度
  2102 +- **参数说明**
  2103 +
  2104 +|参数名|类型|限制|非空|说明|
  2105 +|---|---|---|---|---|
  2106 +|fun|string|-|是|指令名称|
  2107 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2108 +|data|object|-|是|传送参数的对象|
  2109 +|+progress|int||是|升级进度，百分比|
  2110 +
  2111 +- **示例代码**
  2112 +```json
  2113 +{
  2114 + "fun":"fEvtBsUpdateProgress",
  2115 + "dataTag":"1",
  2116 + "data":{
  2117 + "progress":20
  2118 + }
  2119 +}
  2120 +```
  2121 +
  2122 +##### fEvtBsFontLibState
  2123 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2124 +- **功能描述**：返回基站下载字库状态
  2125 +- **参数说明**
  2126 +
  2127 +|参数名|类型|限制|非空|说明|
  2128 +|---|---|---|---|---|
  2129 +|fun|string|-|是|指令名称|
  2130 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2131 +|data|object|-|是|传送参数的对象|
  2132 +|+state|int||是|启动升级状态<br>0 - 准备下载<br>1 - 下载完成<br>2 - 下载失败
  2133 +|+msg|string||否|返回的失败原因
  2134 +
  2135 +- **示例代码**
  2136 +```json
  2137 +{
  2138 + "fun":"fEvtBsFontLibState",
  2139 + "dataTag":"1",
  2140 + "data":{
  2141 + "state":2,
  2142 + "msg":"error msg"
  2143 + }
  2144 +}
  2145 +```
  2146 +
  2147 +##### fEvtBsFontLibProgress
  2148 +- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2149 +- **功能描述**：返回基站下载字库进度
  2150 +- **参数说明**
  2151 +
  2152 +|参数名|类型|限制|非空|说明|
  2153 +|---|---|---|---|---|
  2154 +|fun|string|-|是|指令名称|
  2155 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2156 +|data|object|-|是|传送参数的对象|
  2157 +|+progress|int||是|下载进度，百分比|
  2158 +
  2159 +- **示例代码**
  2160 +```json
  2161 +{
  2162 + "fun":"fEvtBsFontLibProgress",
  2163 + "dataTag":"1",
  2164 + "data":{
  2165 + "progress":20
  2166 + }
  2167 +}
  2168 +```
  2169 +
  2170 +## 键盘管理
  2171 +### 识别设置
  2172 +#### 方法
  2173 +##### setKpSN
  2174 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
  2175 +- **功能描述**:设置指定键盘的出厂编码
  2176 +- **参数说明**
  2177 +
  2178 +|参数名|类型|限制|是否必填|说明|
  2179 +|---|---|---|---|---|
  2180 +|fun|string|-|是|指令名称|
  2181 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2182 +|data|object|-|是|传送参数的对象|
  2183 +|+oldKeySn|string||是|键盘原SN|
  2184 +|+newKeySn|string||是|待设置的新SN|
  2185 +|+time|string|数字|是|时间，yyyyMMddHHmmss|
  2186 +|+verCode|string||是|内部主题校验码，时间+固定key加密|
  2187 +
  2188 +- **示例代码**
  2189 +```json
  2190 +{
  2191 + "fun":"setKpIdentityMode",
  2192 + "dataTag":"1",
  2193 + "data":{
  2194 + "oldKeySn":"1234567890",
  2195 + "newKeySn":"2024021011"
  2196 + }
  2197 +}
  2198 +```
  2199 +##### getKpID
  2200 +- **主题**：/client/\${baseSN}/send
  2201 +- **功能描述**：获取键盘编号
  2202 +- **参数说明**
  2203 +
  2204 +|参数名|类型|限制|是否必填|说明|
  2205 +|---|---|---|---|---|
  2206 +|fun|string|-|是|指令名称|
  2207 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2208 +|data|object|-|是|传送参数的对象|
  2209 +|+keySn|string||是|需读取编号的键盘SN|
  2210 +
  2211 +- **示例代码**
  2212 +```json
  2213 +{
  2214 + "fun":"getKpID",
  2215 + "dataTag":"1",
  2216 + "data":{
  2217 + "keySn":"2024021011"
  2218 + }
  2219 +}
  2220 +```
  2221 +##### setKpID
  2222 +- **主题**：/client/\${baseSN}/send
  2223 +- **功能描述**：设置键盘编号
  2224 +- **参数说明**
  2225 +
  2226 +|参数名|类型|限制|是否必填|说明|
  2227 +|---|---|---|---|---|
  2228 +|fun|string|-|是|指令名称|
  2229 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2230 +|data|object|-|是|传送参数的对象|
  2231 +|+keySn|string||是|需设置编号的键盘SN|
  2232 +|+keyId|int||是|键盘编号，不超过65535|
  2233 +- **示例代码**
  2234 +```json
  2235 +{
  2236 + "fun":"setKpID",
  2237 + "dataTag":"1",
  2238 + "data":{
  2239 + "keySn":"2024021011",
  2240 + "keyId":1
  2241 + }
  2242 +}
  2243 +```
  2244 +##### getKpModel
  2245 +- **主题**：/client/\${baseSN}/send
  2246 +- **功能描述**：获取键盘型号
  2247 +- **参数说明**
  2248 +
  2249 +|参数名|类型|限制|是否必填|说明|
  2250 +|---|---|---|---|---|
  2251 +|fun|string|-|是|指令名称|
  2252 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2253 +|data|object|-|是|传送参数的对象|
  2254 +|+keySn|string||是|需读取型号的键盘SN|
  2255 +
  2256 +- **示例代码**
  2257 +```json
  2258 +{
  2259 + "fun":"getKpModel",
  2260 + "dataTag":"1",
  2261 + "data":{
  2262 + "keySn":"2024021011"
  2263 + }
  2264 +}
  2265 +```
  2266 +
  2267 +##### getKpFWVersion
  2268 +- **主题**：/client/\${baseSN}/send
  2269 +- **功能描述**：获取键盘型号
1573 - **参数说明** 2270 - **参数说明**
1574 2271
1575 -|参数名|类型|限制|非空|说明| 2272 +|参数名|类型|限制|是否必填|说明|
1576 |---|---|---|---|---| 2273 |---|---|---|---|---|
1577 |fun|string|-|是|指令名称| 2274 |fun|string|-|是|指令名称|
1578 |dataTag|string|-|否|数据包标识,可为空字符串| 2275 |dataTag|string|-|否|数据包标识,可为空字符串|
1579 |data|object|-|是|传送参数的对象| 2276 |data|object|-|是|传送参数的对象|
1580 -|+index|int||是|数据包序号，从1开始，传0代表日志已传完|  
1581 -|+info|string||是|日志内容<br><font color="red">日志的时间依赖于基站授时，需要加上时区得到具体的时间</font>| 2277 +|+keySn|string||是|需读取版本的键盘SN|
1582 2278
1583 - **示例代码** 2279 - **示例代码**
1584 -```Json 2280 +```json
1585 { 2281 {
1586 - "fun":"fEvtBsLogInfo", 2282 + "fun":"getKpFWVersion",
1587 "dataTag":"1", 2283 "dataTag":"1",
1588 "data":{ 2284 "data":{
1589 - "index":1,  
1590 - "info":"XXXXXXXXXXXXX" 2285 + "keySn":"2024021011"
1591 } 2286 }
1592 } 2287 }
1593 ``` 2288 ```
1594 -### 基站升级  
1595 -#### 方法  
1596 -##### startBsUpdate 2289 +
  2290 +##### getKpIdentityMode
  2291 +- **主题**：/client/\${baseSN}/send
  2292 +- **功能描述**：获取键盘识别模式
  2293 +- **参数说明**
  2294 +
  2295 +|参数名|类型|限制|是否必填|说明|
  2296 +|---|---|---|---|---|
  2297 +|fun|string|-|是|指令名称|
  2298 +|dataTag|string|-|否|数据包标识,可为空字符串|
  2299 +
  2300 +- **示例代码**
  2301 +```json
  2302 +{
  2303 + "fun":"getKpIdentityMode",
  2304 + "dataTag":"1"
  2305 +}
  2306 +```
  2307 +##### setKpIdentityMode
1597 - **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span> 2308 - **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
1598 -- **功能描述**:基站固件升级 2309 +- **功能描述**：设置键盘识别模式
1599 - **参数说明** 2310 - **参数说明**
1600 2311
1601 |参数名|类型|限制|是否必填|说明| 2312 |参数名|类型|限制|是否必填|说明|
@@ -1603,65 +2314,46 @@ @@ -1603,65 +2314,46 @@
1603 |fun|string|-|是|指令名称| 2314 |fun|string|-|是|指令名称|
1604 |dataTag|string|-|否|数据包标识,可为空字符串| 2315 |dataTag|string|-|否|数据包标识,可为空字符串|
1605 |data|object|-|是|传送参数的对象| 2316 |data|object|-|是|传送参数的对象|
1606 -|+partition|int||是|存储区域<br> 1-备份区 <font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，然后上电，这时基站固件就会更新成备份区的固件</font><br>2-更新区|  
1607 -|+url|string||是|待升级的固件地址，可访问的网络url|  
1608 -|+version|string||是|待升级的基站固件版本|  
1609 -|+crc|uint||是|固件CRC校验码，10进制数字|  
1610 -<!-- |+time|string||是|时间，yyyyMMddHHmmss|  
1611 -|+verCode|string||是|内部主题校验码，时间+固定key加密| --> 2317 +|+value|string||是|设置键盘识别模式<br>0 - SN模式<br>1 - ID+SN模式|
  2318 +|+time|string|数字|是|时间，yyyyMMddHHmmss|
  2319 +|+verCode|string||是|内部主题校验码，时间+固定key加密|
1612 2320
1613 - **示例代码** 2321 - **示例代码**
1614 -```Json 2322 +```json
1615 { 2323 {
1616 - "fun":"startBsUpdate", 2324 + "fun":"setKpIdentityMode",
1617 "dataTag":"1", 2325 "dataTag":"1",
1618 "data":{ 2326 "data":{
1619 - "partition":2,  
1620 - "url":"http://192.168.10.10/V1.0.3.bin",  
1621 - "version":"1.0.3",  
1622 - "crc":1429319861 2327 + "value":"0"
1623 } 2328 }
1624 } 2329 }
1625 ``` 2330 ```
1626 -##### downloadFontLib  
1627 -- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>  
1628 -- **功能描述**:下载更新基站字库文件 2331 +#### 事件
  2332 +##### fEvtKpIdentityMode
  2333 +- **主题**：/basestation/\${baseSN}/receive
  2334 +- **功能描述**：返回键盘识别模式
1629 - **参数说明** 2335 - **参数说明**
1630 2336
1631 -|参数名|类型|限制|是否必填|说明| 2337 +|参数名|类型|限制|非空|说明|
1632 |---|---|---|---|---| 2338 |---|---|---|---|---|
1633 |fun|string|-|是|指令名称| 2339 |fun|string|-|是|指令名称|
1634 |dataTag|string|-|否|数据包标识,可为空字符串| 2340 |dataTag|string|-|否|数据包标识,可为空字符串|
1635 |data|object|-|是|传送参数的对象| 2341 |data|object|-|是|传送参数的对象|
1636 -|+partition|int||是|存储区域<br> 1-备份区<br>2-更新区|  
1637 -|+url|string||是|待下载的字库地址，可访问的网络url|  
1638 -|+version|string||是|待升级的字库版本|  
1639 -|+crc|int||是|字库CRC校验码，10进制数字|  
1640 -<!-- |+time|string||是|时间，yyyyMMddHHmmss|  
1641 -|+verCode|string||是|内部主题校验码，时间+固定key加密| --> 2342 +|+value|string||是|设置键盘识别模式<br>0 - SN模式<br>1 - ID+SN模式|
1642 2343
1643 - **示例代码** 2344 - **示例代码**
1644 -```Json 2345 +```json
1645 { 2346 {
1646 - "fun":"downloadFontLib", 2347 + "fun":"fEvtKpIdentityMode",
1647 "dataTag":"1", 2348 "dataTag":"1",
1648 "data":{ 2349 "data":{
1649 - "partition":2,  
1650 - "url":"http://192.168.10.10/V1.0.3.bin",  
1651 - "version":"1.0.3",  
1652 - "crc":1429319861 2350 + "value":"0"
1653 } 2351 }
1654 } 2352 }
1655 ``` 2353 ```
1656 -  
1657 -#### 事件  
1658 -##### [sEvtStateCode](#sevtstatecode)  
1659 -返回升级指令的接收状态  
1660 -注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回  
1661 -  
1662 -##### fEvtBsUpateState  
1663 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1664 -- **功能描述**：返回基站启动升级状态 2354 +##### fEvtKpSN
  2355 +- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
  2356 +- **功能描述**：返回写键盘SN状态
1665 - **参数说明** 2357 - **参数说明**
1666 2358
1667 |参数名|类型|限制|非空|说明| 2359 |参数名|类型|限制|非空|说明|
@@ -1669,24 +2361,23 @@ @@ -1669,24 +2361,23 @@
1669 |fun|string|-|是|指令名称| 2361 |fun|string|-|是|指令名称|
1670 |dataTag|string|-|否|数据包标识,可为空字符串| 2362 |dataTag|string|-|否|数据包标识,可为空字符串|
1671 |data|object|-|是|传送参数的对象| 2363 |data|object|-|是|传送参数的对象|
1672 -|+state|int||是|启动升级状态<br>0 - 准备升级<br>1 - 升级成功<br>2 - 升级失败  
1673 -|+msg|string||否|返回的失败原因 2364 +|+keySn|string||是|设置键盘SN的原SN|
  2365 +|+state|string||是|设置是否成功<br>0-设置成功<br>1-设置失败|
1674 2366
1675 - **示例代码** 2367 - **示例代码**
1676 -```Json 2368 +```json
1677 { 2369 {
1678 - "fun":"fEvtBsUpateState", 2370 + "fun":"fEvtKpSN",
1679 "dataTag":"1", 2371 "dataTag":"1",
1680 "data":{ 2372 "data":{
1681 - "state":2,  
1682 - "msg":"error msg" 2373 + "keySn":"1234567890",
  2374 + "state":"0"
1683 } 2375 }
1684 } 2376 }
1685 ``` 2377 ```
1686 -  
1687 -##### fEvtBsUpdateProgress  
1688 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1689 -- **功能描述**：返回基站升级进度 2378 +##### fEvtKpID
  2379 +- **主题**：/basestation/\${baseSN}/receive
  2380 +- **功能描述**：返回键盘编号
1690 - **参数说明** 2381 - **参数说明**
1691 2382
1692 |参数名|类型|限制|非空|说明| 2383 |参数名|类型|限制|非空|说明|
@@ -1694,22 +2385,23 @@ @@ -1694,22 +2385,23 @@
1694 |fun|string|-|是|指令名称| 2385 |fun|string|-|是|指令名称|
1695 |dataTag|string|-|否|数据包标识,可为空字符串| 2386 |dataTag|string|-|否|数据包标识,可为空字符串|
1696 |data|object|-|是|传送参数的对象| 2387 |data|object|-|是|传送参数的对象|
1697 -|+progress|int||是|升级进度，百分比| 2388 +|+keySn|string||是|设置键盘SN的原SN|
  2389 +|+keyId|int||是|键盘编号|
1698 2390
1699 - **示例代码** 2391 - **示例代码**
1700 -```Json 2392 +```json
1701 { 2393 {
1702 - "fun":"fEvtBsUpdateProgress", 2394 + "fun":"fEvtKpID",
1703 "dataTag":"1", 2395 "dataTag":"1",
1704 "data":{ 2396 "data":{
1705 - "progress":20 2397 + "keySn":"2024021011",
  2398 + "keyId":11
1706 } 2399 }
1707 } 2400 }
1708 ``` 2401 ```
1709 -  
1710 -##### fEvtBsFontLibState  
1711 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1712 -- **功能描述**：返回基站下载字库状态 2402 +##### fEvtKpModel
  2403 +- **主题**：/basestation/\${baseSN}/receive
  2404 +- **功能描述**：返回键盘型号
1713 - **参数说明** 2405 - **参数说明**
1714 2406
1715 |参数名|类型|限制|非空|说明| 2407 |参数名|类型|限制|非空|说明|
@@ -1717,24 +2409,24 @@ @@ -1717,24 +2409,24 @@
1717 |fun|string|-|是|指令名称| 2409 |fun|string|-|是|指令名称|
1718 |dataTag|string|-|否|数据包标识,可为空字符串| 2410 |dataTag|string|-|否|数据包标识,可为空字符串|
1719 |data|object|-|是|传送参数的对象| 2411 |data|object|-|是|传送参数的对象|
1720 -|+state|int||是|启动升级状态<br>0 - 准备下载<br>1 - 下载完成<br>2 - 下载失败  
1721 -|+msg|string||否|返回的失败原因 2412 +|+keySn|string||是|设置键盘SN的原SN|
  2413 +|+model|int||是|键盘型号代码|
1722 2414
1723 - **示例代码** 2415 - **示例代码**
1724 -```Json 2416 +```json
1725 { 2417 {
1726 - "fun":"fEvtBsFontLibState", 2418 + "fun":"fEvtKpModel",
1727 "dataTag":"1", 2419 "dataTag":"1",
1728 "data":{ 2420 "data":{
1729 - "state":2,  
1730 - "msg":"error msg" 2421 + "keySn":"2024021011",
  2422 + "model":67
1731 } 2423 }
1732 } 2424 }
1733 ``` 2425 ```
1734 2426
1735 -##### fEvtBsFontLibProgress  
1736 -- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>  
1737 -- **功能描述**：返回基站下载字库进度 2427 +##### fEvtKpFWVersion
  2428 +- **主题**：/basestation/\${baseSN}/receive
  2429 +- **功能描述**：返回键盘型号
1738 - **参数说明** 2430 - **参数说明**
1739 2431
1740 |参数名|类型|限制|非空|说明| 2432 |参数名|类型|限制|非空|说明|
@@ -1742,20 +2434,21 @@ @@ -1742,20 +2434,21 @@
1742 |fun|string|-|是|指令名称| 2434 |fun|string|-|是|指令名称|
1743 |dataTag|string|-|否|数据包标识,可为空字符串| 2435 |dataTag|string|-|否|数据包标识,可为空字符串|
1744 |data|object|-|是|传送参数的对象| 2436 |data|object|-|是|传送参数的对象|
1745 -|+progress|int||是|下载进度，百分比| 2437 +|+keySn|string||是|设置键盘SN的原SN|
  2438 +|+version|string||是|键盘固件版本|
1746 2439
1747 - **示例代码** 2440 - **示例代码**
1748 -```Json 2441 +```json
1749 { 2442 {
1750 - "fun":"fEvtBsFontLibProgress", 2443 + "fun":"fEvtKpFWVersion",
1751 "dataTag":"1", 2444 "dataTag":"1",
1752 "data":{ 2445 "data":{
1753 - "progress":20 2446 + "keySn":"2024021011",
  2447 + "version":"1.0.0"
1754 } 2448 }
1755 } 2449 }
1756 ``` 2450 ```
1757 2451
1758 -## 键盘管理  
1759 ### 交互设置 2452 ### 交互设置
1760 #### 方法 2453 #### 方法
1761 ##### setKpUserStbMsg 2454 ##### setKpUserStbMsg
@@ -1774,7 +2467,7 @@ @@ -1774,7 +2467,7 @@
1774 |+submitted|string||是|已提交状态语<br>空字符串清除| 2467 |+submitted|string||是|已提交状态语<br>空字符串清除|
1775 2468
1776 - **示例代码** 2469 - **示例代码**
1777 -```Json 2470 +```json
1778 { 2471 {
1779 "fun":"setKpUserStbMsg", 2472 "fun":"setKpUserStbMsg",
1780 "dataTag":"1", 2473 "dataTag":"1",
@@ -1845,7 +2538,7 @@ @@ -1845,7 +2538,7 @@
1845 |+state|string||是|设置状态语是否成功<br> 0 - 成功<br> 1 - 失败| 2538 |+state|string||是|设置状态语是否成功<br> 0 - 成功<br> 1 - 失败|
1846 2539
1847 - **示例代码** 2540 - **示例代码**
1848 -```Json 2541 +```json
1849 { 2542 {
1850 "fun":"fEvtKpUserStbMsg", 2543 "fun":"fEvtKpUserStbMsg",
1851 "dataTag":"1", 2544 "dataTag":"1",
@@ -1946,7 +2639,7 @@ @@ -1946,7 +2639,7 @@
1946 |+voltage|double||是|键盘电量<font color="red">（待键盘修改成百分比）</font>| 2639 |+voltage|double||是|键盘电量<font color="red">（待键盘修改成百分比）</font>|
1947 2640
1948 - **示例代码** 2641 - **示例代码**
1949 -```Json 2642 +```json
1950 { 2643 {
1951 "fun":"fEvtKpOnlineMsg", 2644 "fun":"fEvtKpOnlineMsg",
1952 "dataTag":"1", 2645 "dataTag":"1",
@@ -1974,7 +2667,7 @@ @@ -1974,7 +2667,7 @@
1974 |+keySns|array||否|需要执行指令的键盘SN数组,<br>空数组表示所有键盘| 2667 |+keySns|array||否|需要执行指令的键盘SN数组,<br>空数组表示所有键盘|
1975 2668
1976 - **示例代码** 2669 - **示例代码**
1977 -```Json 2670 +```json
1978 { 2671 {
1979 "fun":"remoteKpPowerOff", 2672 "fun":"remoteKpPowerOff",
1980 "dataTag":"1", 2673 "dataTag":"1",
@@ -1996,7 +2689,7 @@ @@ -1996,7 +2689,7 @@
1996 |+keySns|array||否|需要执行指令的键盘SN数组，空数组表示所有键盘| 2689 |+keySns|array||否|需要执行指令的键盘SN数组，空数组表示所有键盘|
1997 2690
1998 - **示例代码** 2691 - **示例代码**
1999 -```Json 2692 +```json
2000 { 2693 {
2001 "fun":"remoteKpSleep", 2694 "fun":"remoteKpSleep",
2002 "dataTag":"1", 2695 "dataTag":"1",
@@ -2023,7 +2716,7 @@ @@ -2023,7 +2716,7 @@
2023 |+verCode|string||是|内部主题校验码，时间+固定key加密| --> 2716 |+verCode|string||是|内部主题校验码，时间+固定key加密| -->
2024 2717
2025 - **示例代码** 2718 - **示例代码**
2026 -```Json 2719 +```json
2027 { 2720 {
2028 "fun":"startKpFWUpdate", 2721 "fun":"startKpFWUpdate",
2029 "dataTag":"1", 2722 "dataTag":"1",
@@ -2049,7 +2742,7 @@ @@ -2049,7 +2742,7 @@
2049 |+verCode|string||是|内部主题校验码，时间+固定key加密| --> 2742 |+verCode|string||是|内部主题校验码，时间+固定key加密| -->
2050 2743
2051 - **示例代码** 2744 - **示例代码**
2052 -```Json 2745 +```json
2053 { 2746 {
2054 "fun":"stopKpFWUpdate", 2747 "fun":"stopKpFWUpdate",
2055 "dataTag":"1" 2748 "dataTag":"1"
@@ -2075,7 +2768,7 @@ @@ -2075,7 +2768,7 @@
2075 |+msg|string||否|返回的失败原因 2768 |+msg|string||否|返回的失败原因
2076 2769
2077 - **示例代码** 2770 - **示例代码**
2078 -```Json 2771 +```json
2079 { 2772 {
2080 "fun":"fEvtKpFWUpdateState", 2773 "fun":"fEvtKpFWUpdateState",
2081 "dataTag":"1", 2774 "dataTag":"1",
@@ -2098,7 +2791,7 @@ @@ -2098,7 +2791,7 @@
2098 |+progress|int||是|升级进度，百分比| 2791 |+progress|int||是|升级进度，百分比|
2099 2792
2100 - **示例代码** 2793 - **示例代码**
2101 -```Json 2794 +```json
2102 { 2795 {
2103 "fun":"fEvtKpUpdateProgress", 2796 "fun":"fEvtKpUpdateProgress",
2104 "dataTag":"1", 2797 "dataTag":"1",
@@ -2239,7 +2932,7 @@ @@ -2239,7 +2932,7 @@
2239 |+tipTitle |string|-|否| 提示标题,长度最多不超过16个字节| 2932 |+tipTitle |string|-|否| 提示标题,长度最多不超过16个字节|
2240 2933
2241 - **示例代码** 2934 - **示例代码**
2242 -```Json 2935 +```json
2243 //按键签到 2936 //按键签到
2244 { 2937 {
2245 "fun":"startKpSignIn", 2938 "fun":"startKpSignIn",
@@ -2264,8 +2957,7 @@ @@ -2264,8 +2957,7 @@
2264 } 2957 }
2265 } 2958 }
2266 ``` 2959 ```
2267 -  
2268 -##### stopKpSignIn 2960 +<!-- ##### stopKpSignIn
2269 - **主题**：/client/\${baseSN}/send 2961 - **主题**：/client/\${baseSN}/send
2270 - **功能描述**：停止同步签到 2962 - **功能描述**：停止同步签到
2271 - **参数说明** 2963 - **参数说明**
@@ -2276,12 +2968,15 @@ @@ -2276,12 +2968,15 @@
2276 |dataTag|string|-|否|数据包标识,可为空字符串| 2968 |dataTag|string|-|否|数据包标识,可为空字符串|
2277 2969
2278 - **示例代码** 2970 - **示例代码**
2279 -```Json 2971 +```json
2280 { 2972 {
2281 "fun":"stopKpSignIn", 2973 "fun":"stopKpSignIn",
2282 "dataTag":"1" 2974 "dataTag":"1"
2283 } 2975 }
2284 -``` 2976 +``` -->
  2977 +##### [stopKpVote](#stopkpvote)
  2978 +停止同步签到
  2979 +
2285 #### 事件 2980 #### 事件
2286 ##### [sEvtStateCode](#sevtstatecode) 2981 ##### [sEvtStateCode](#sevtstatecode)
2287 发送指令后返回接收状态 2982 发送指令后返回接收状态
@@ -2452,7 +3147,7 @@ @@ -2452,7 +3147,7 @@
2452 } 3147 }
2453 } 3148 }
2454 ``` 3149 ```
2455 -##### stopQATrueFalse 3150 +<!-- ##### stopQATrueFalse
2456 - **主题**：/client/\${baseSN}/send 3151 - **主题**：/client/\${baseSN}/send
2457 - **功能描述**：停止判断题答题 3152 - **功能描述**：停止判断题答题
2458 - **参数说明** 3153 - **参数说明**
@@ -2468,7 +3163,11 @@ @@ -2468,7 +3163,11 @@
2468 "fun":"stopQATrueFalse", 3163 "fun":"stopQATrueFalse",
2469 "dataTag":"1" 3164 "dataTag":"1"
2470 } 3165 }
2471 -``` 3166 +``` -->
  3167 +
  3168 +##### [stopKpVote](#stopkpvote)
  3169 +停止判断题答题
  3170 +
2472 #### 事件 3171 #### 事件
2473 ##### [sEvtStateCode](#sevtstatecode) 3172 ##### [sEvtStateCode](#sevtstatecode)
2474 发送指令后返回接收状态 3173 发送指令后返回接收状态
@@ -2543,7 +3242,7 @@ @@ -2543,7 +3242,7 @@
2543 } 3242 }
2544 } 3243 }
2545 ``` 3244 ```
2546 -##### stopQAChoice 3245 +<!-- ##### stopQAChoice
2547 - **主题**：/client/\${baseSN}/send 3246 - **主题**：/client/\${baseSN}/send
2548 - **功能描述**：停止选择题答题 3247 - **功能描述**：停止选择题答题
2549 - **参数说明** 3248 - **参数说明**
@@ -2559,7 +3258,10 @@ @@ -2559,7 +3258,10 @@
2559 "fun":"stopQAChoice", 3258 "fun":"stopQAChoice",
2560 "dataTag":"1" 3259 "dataTag":"1"
2561 } 3260 }
2562 -``` 3261 +``` -->
  3262 +##### [stopKpVote](#stopkpvote)
  3263 +停止选择题答题
  3264 +
2563 #### 事件 3265 #### 事件
2564 ##### [sEvtStateCode](#sevtstatecode) 3266 ##### [sEvtStateCode](#sevtstatecode)
2565 发送指令后返回接收状态 3267 发送指令后返回接收状态
@@ -2631,7 +3333,7 @@ @@ -2631,7 +3333,7 @@
2631 } 3333 }
2632 } 3334 }
2633 ``` 3335 ```
2634 -##### stopQANum 3336 +<!-- ##### stopQANum
2635 - **主题**：/client/\${baseSN}/send 3337 - **主题**：/client/\${baseSN}/send
2636 - **功能描述**：停止数字题答题 3338 - **功能描述**：停止数字题答题
2637 - **参数说明** 3339 - **参数说明**
@@ -2647,7 +3349,10 @@ @@ -2647,7 +3349,10 @@
2647 "fun":"stopQANum", 3349 "fun":"stopQANum",
2648 "dataTag":"1" 3350 "dataTag":"1"
2649 } 3351 }
2650 -``` 3352 +``` -->
  3353 +##### [stopKpVote](#stopkpvote)
  3354 +停止数字题答题
  3355 +
2651 #### 事件 3356 #### 事件
2652 ##### [sEvtStateCode](#sevtstatecode) 3357 ##### [sEvtStateCode](#sevtstatecode)
2653 发送指令后返回接收状态 3358 发送指令后返回接收状态
@@ -2713,7 +3418,7 @@ @@ -2713,7 +3418,7 @@
2713 } 3418 }
2714 } 3419 }
2715 ``` 3420 ```
2716 -##### stopQAQuicker 3421 +<!-- ##### stopQAQuicker
2717 - **主题**：/client/\${baseSN}/send 3422 - **主题**：/client/\${baseSN}/send
2718 - **功能描述**：停止抢答答题 3423 - **功能描述**：停止抢答答题
2719 - **参数说明** 3424 - **参数说明**
@@ -2729,7 +3434,11 @@ @@ -2729,7 +3434,11 @@
2729 "fun":"stopQAQuicker", 3434 "fun":"stopQAQuicker",
2730 "dataTag":"1" 3435 "dataTag":"1"
2731 } 3436 }
2732 -``` 3437 +``` -->
  3438 +
  3439 +##### [stopKpVote](#stopkpvote)
  3440 +停止抢答
  3441 +
2733 #### 事件 3442 #### 事件
2734 ##### [sEvtStateCode](#sevtstatecode) 3443 ##### [sEvtStateCode](#sevtstatecode)
2735 发送指令后返回接收状态 3444 发送指令后返回接收状态
@@ -2760,6 +3469,82 @@ @@ -2760,6 +3469,82 @@
2760 }] 3469 }]
2761 } 3470 }
2762 ``` 3471 ```
  3472 +### 待机实时反馈
  3473 +#### 方法
  3474 +##### setKpStbResponse
  3475 +- **主题**：/client/\${baseSN}/send
  3476 +- **功能描述**：启动待机实时反馈
  3477 +- **参数说明**
  3478 +
  3479 +|参数名|类型|限制|是否必填|说明|
  3480 +|---|---|---|---|---|
  3481 +|fun|string|-|是|指令名称|
  3482 +|dataTag|string|-|否|数据包标识,可为空字符串|
  3483 +|data|object|-|是|传送参数的对象|
  3484 +|+state|int||是|启用待机实时反馈<br>0-不启用<br>1-启用|
  3485 +|+mode|int||是|启动待机反馈类型，state=1时有效<br>0-举手<br>1-指定按键反馈|
  3486 +|+keys|int||是|有效按键数量，state=1且mode=1时有效, 范围1-10|
  3487 +
  3488 +- **示例代码**
  3489 +```json
  3490 +//启用举手反馈
  3491 +{
  3492 + "fun":"setKpStbResponse",
  3493 + "dataTag":"1",
  3494 + "data":{
  3495 + "state":1,
  3496 + "mode":0
  3497 + }
  3498 +}
  3499 +//启用待机按键反馈
  3500 +{
  3501 + "fun":"setKpStbResponse",
  3502 + "dataTag":"1",
  3503 + "data":{
  3504 + "state":1,
  3505 + "mode":1,
  3506 + "keys":4
  3507 + }
  3508 +}
  3509 +//关闭待机按键反馈
  3510 +{
  3511 + "fun":"setKpStbResponse",
  3512 + "dataTag":"1",
  3513 + "data":{
  3514 + "state":0
  3515 + }
  3516 +}
  3517 +```
  3518 +
  3519 +#### 事件
  3520 +#### fEvtKpStbResponse
  3521 +- **主题**：/basestation/\${baseSN}/receive
  3522 +- **功能描述**：返回当前待机按键反馈开启状态
  3523 +- **参数说明**
  3524 +
  3525 +|参数名|类型|限制|非空|说明|
  3526 +|---|---|---|---|---|
  3527 +|fun|string|-|是|指令名称|
  3528 +|dataTag|string|-|否|数据包标识,可为空字符串|
  3529 +|data|array|-|是|传送参数的对象数组|
  3530 +|+state|int||是|启用待机实时反馈<br>0-不启用<br>1-启用|
  3531 +
  3532 +- **示例代码**
  3533 +```json
  3534 +{
  3535 + "fun":"fEvtKpStbResponse",
  3536 + "dataTag":"1",
  3537 + "data": {
  3538 + "state": 1
  3539 + }
  3540 +}
  3541 +```
  3542 +
  3543 +##### [sEvtKpRtFeedback](#sevtkprtfeedback)
  3544 +返回待机时键盘返回的按键值
  3545 +
  3546 +##### [sEvtKpHandup](#sevtkphandup)
  3547 +启动待机按键反馈类型为举手提问时返回此事件
2763 ## 在线测验 3548 ## 在线测验
2764 ### 标准测验 3549 ### 标准测验
2765 #### 方法 3550 #### 方法
@@ -2865,7 +3650,7 @@ @@ -2865,7 +3650,7 @@
2865 } 3650 }
2866 } 3651 }
2867 ``` 3652 ```
2868 -##### stopKpExam 3653 +<!-- ##### stopKpExam
2869 - **主题**：/client/\${baseSN}/send 3654 - **主题**：/client/\${baseSN}/send
2870 - **功能描述**：停止标准测验 3655 - **功能描述**：停止标准测验
2871 - **参数说明** 3656 - **参数说明**
@@ -2881,7 +3666,10 @@ @@ -2881,7 +3666,10 @@
2881 "fun":"stopKpExam", 3666 "fun":"stopKpExam",
2882 "dataTag":"1" 3667 "dataTag":"1"
2883 } 3668 }
2884 -``` 3669 +``` -->
  3670 +##### [stopKpVote](#stopkpvote)
  3671 +停止在线测验
  3672 +
2885 ##### rtGetKpExamData 3673 ##### rtGetKpExamData
2886 - **主题**：/client/\${baseSN}/send 3674 - **主题**：/client/\${baseSN}/send
2887 - **功能描述**：刷新作答数据 3675 - **功能描述**：刷新作答数据
@@ -3101,7 +3889,7 @@ @@ -3101,7 +3889,7 @@
3101 } 3889 }
3102 ``` 3890 ```
3103 3891
3104 -##### stopKpMultiExam 3892 +<!-- ##### stopKpMultiExam
3105 - **主题**：/client/\${baseSN}/send 3893 - **主题**：/client/\${baseSN}/send
3106 - **功能描述**：停止多科测验 3894 - **功能描述**：停止多科测验
3107 - **参数说明** 3895 - **参数说明**
@@ -3117,7 +3905,9 @@ @@ -3117,7 +3905,9 @@
3117 "fun":"stopKpMultiExam", 3905 "fun":"stopKpMultiExam",
3118 "dataTag":"1" 3906 "dataTag":"1"
3119 } 3907 }
3120 -``` 3908 +``` -->
  3909 +##### [stopKpVote](#stopkpvote)
  3910 +停止多科测验
3121 3911
3122 #### 事件 3912 #### 事件
3123 ##### [sEvtStateCode](#sevtstatecode) 3913 ##### [sEvtStateCode](#sevtstatecode)
@@ -3127,4 +3917,115 @@ @@ -3127,4 +3917,115 @@
3127 返回测验中键盘提交答题数据 3917 返回测验中键盘提交答题数据
3128 3918
3129 ##### [fEvtFinalSubmit](#fevtfinalsubmit) 3919 ##### [fEvtFinalSubmit](#fevtfinalsubmit)
3130 -返回键盘手动交卷标识  
3131 \ No newline at end of file 3920 \ No newline at end of file
  3921 +返回键盘手动交卷标识
  3922 +
  3923 +### 自主录分
  3924 +#### 方法
  3925 +##### startKpScoreInput
  3926 +- **主题**：/client/\${baseSN}/send
  3927 +- **功能描述**：启动标准测验
  3928 +- **参数说明**
  3929 +
  3930 +|参数名|类型|限制|是否必填|说明|
  3931 +|---|---|---|---|---|
  3932 +|fun|string|-|是|指令名称|
  3933 +|dataTag|string|-|否|数据包标识,可为空字符串|
  3934 +|data|object|-|是|传送参数的对象|
  3935 +|+examNo|int||是|0-9999<br>=0，新的录分<br>>0时,与上次启动卷号一致继续录分，不一致进入新的录分|
  3936 +|+mode|int||是|录分模式<br>0-自主录分<br>1-交叉录分，需先输入录分的人员标识|
  3937 +|+questions|array||是|题目详情|
  3938 +|++symbol | string||是 | 题号前缀,可为空 |
  3939 +|++min |int||是|可输入的最小值，默认为0|
  3940 +|++max |int||是|可输入的最大值，<=100|
  3941 +|++digits|int||是|可输入的小数位数，范围0-2|
  3942 +|++startNo | int||是| 起始题号|
  3943 +|++count | int||是| 题目数量|
  3944 +
  3945 +- **示例代码**
  3946 +```json
  3947 +{
  3948 + "fun":"startKpScoreInput",
  3949 + "dataTag":"1",
  3950 + "data":{
  3951 + "mode": 0,
  3952 + "examNo": 0,
  3953 + "questions": [{
  3954 + //题号1-1-1 到1-1-2 共2题,单题满分10分
  3955 + "symbol": "1-",
  3956 + "min": 0,
  3957 + "max":10,
  3958 + "digits":1,
  3959 + "startNo": 1,
  3960 + "count":2
  3961 + }, {
  3962 + //题号3到6 共4道题，单题满分5
  3963 + "symbol": "",
  3964 + "min": 0,
  3965 + "max":5,
  3966 + "digits":0,
  3967 + "startNo": 3,
  3968 + "count":4
  3969 + }]
  3970 + }
  3971 +}
  3972 +```
  3973 +<!--
  3974 +##### stopKpScoreInput
  3975 +- **主题**：/client/\${baseSN}/send
  3976 +- **功能描述**：停止自主录分
  3977 +- **参数说明**
  3978 +
  3979 +|参数名|类型|限制|是否必填|说明|
  3980 +|---|---|---|---|---|
  3981 +|fun|string|-|是|指令名称|
  3982 +|dataTag|string|-|否|数据包标识,可为空字符串|
  3983 +
  3984 +- **示例代码**
  3985 +```json
  3986 +{
  3987 + "fun":"stopKpScoreInput",
  3988 + "dataTag":"1"
  3989 +}
  3990 +``` -->
  3991 +##### [stopKpVote](#stopkpvote)
  3992 +停止自主录分
  3993 +
  3994 +#### 事件
  3995 +##### [sEvtStateCode](#sevtstatecode)
  3996 +发送指令后返回接收状态
  3997 +
  3998 +##### fEvtKpScore
  3999 +- **主题**：/basestation/\${baseSN}/receive
  4000 +- **功能描述**：返回键盘提交录分信息
  4001 +- **参数说明**
  4002 +
  4003 +|参数名|类型|限制|非空|说明|
  4004 +|---|---|---|---|---|
  4005 +|fun|string|-|是|指令名称|
  4006 +|dataTag|string|-|否|数据包标识,可为空字符串|
  4007 +|data|array|-|是|传送参数的对象数组|
  4008 +|++scoreTag|string||是|录分标识，自主录分为空，交叉录分为键盘录分前输入的标识|
  4009 +|++keySn|string||是|键盘SN|
  4010 +|++keyValue|string||是|键盘提交的分值,1:10;2:0表示第1题提交10分，第二题提交0分|
  4011 +|++keyTime|double||是|录分时间，从启动录分开始计算，单位秒|
  4012 +
  4013 +- **示例代码**
  4014 +```json
  4015 +{
  4016 + "fun":"fEvtKpScore",
  4017 + "dataTag":"1",
  4018 + "data": [{
  4019 + "scoreTag":"5",
  4020 + "keySn": "1234567890",
  4021 + "keyValue":"1:8;2:7.5;3:2;4:3",
  4022 + "keyTime":3.2
  4023 + },
  4024 + {
  4025 + "scoreTag":"3",
  4026 + "keySn": "1234567891",
  4027 + "keyValue":"1:10;2:0",
  4028 + "keyTime":3.5
  4029 + }
  4030 + ]
  4031 +}
  4032 +```
3132 \ No newline at end of file 4033 \ No newline at end of file