适配海亮C200K功能

1. 增加测验题中自判题题型 2. 多科测验的科目数量为从9增加至11 3. 增加测验自定义题型标题下发和清除 4. 增加自定义tag，可自定义最长128位的数据包标签

适配海亮C200K功能
1. 增加测验题中自判题题型 2. 多科测验的科目数量为从9增加至11 3. 增加测验自定义题型标题下发和清除 4. 增加自定义tag，可自定义最长128位的数据包标签
刘琴
1 parent deff7695
Showing 1 changed file with 334 additions and 165 deletions
通讯协议-B200W-MQTT协议[内部].md
@@ -14,6 +14,7 @@
   }
 </style>
+[TOC]
 <br>
 <br>
 <br>
@@ -26,7 +27,7 @@ SunVote B200W &lt;br&gt;MQTT通讯协议
 <br>
 <br>
 <div  style="text-align: center;font-size: 30px;">
-Ver 1.0.1
+Ver 1.0.2
 </div>
 <br>
 <br>
@@ -42,7 +43,7 @@ Ver 1.0.1
 <br>
 <div  style="text-align: center;font-size: 30px;">
-二〇二四年十月
+二〇二四年十二月
 </div>
 <br>
@@ -61,33 +62,32 @@ Ver 1.0.1
 | 文档版本 | 日期 | 作者 | 版本说明 |
 |---|---|---|---|
 |1.0.1| 2024年10月22日|刘琴|1.  初始版|
+|1.0.2| 2024年12月27日|刘琴|1. 增加测验题中自判题题型<br>2. 多科测验的科目数量为从9增加至11<br>3. 增加测验自定义题型标题下发和清除<br>4. 增加自定义tag，可自定义最长128位的数据包标签<br><font color=red>注：(基站版本需高于0.0.10)</font>|
 <br>
 <br>
-[TOC]
-
 # SunVote B200W MQTT通讯协议
 # 功能说明
 ## 主题说明
-\${baseSN}为指定的基站的SN编码，不能为空，接收基站反馈数据需要订阅对应基站SN的接收主题。
+{baseSN}为指定的基站的SN编码，不能为空，接收基站反馈数据需要订阅对应基站SN的接收主题。
 ### 发布的主题
 应用程序发布的主题，基站订阅
-/client/\${baseSN}/send
+/client/{baseSN}/send
 /client/multiBase/send
 <span class="yellowFill">内部应用发布的主题，基站订阅
-/manage/\${baseSN}/send</span>
+/manage/{baseSN}/send</span>
 ### 订阅的主题
 应用程序订阅的主题，基站发布
-/basestation/\\${baseSN}/receive
+/basestation/\{baseSN}/receive
 /basestation/multiBase/receive 
 <span class="yellowFill">内部应用订阅的主题，基站发布
-/manage/\${baseSN}/receive</span>
+/manage/{baseSN}/receive</span>
 ## 指令说明
 |指令功能标识	|说明	|约束|
@@ -112,6 +112,7 @@ Ver 1.0.1
   {
     "fun":"xxx", 
     "dataTag":"xxx", 
+    "tag":"",  //此字段非必需
     "data":{    
        //内容
     }
@@ -121,7 +122,8 @@ Ver 1.0.1
 |参数	|说明	|约束|
 |---|---|---|
 |fun|	指令或事件名称||
-|dataTag|	数据标签，用于对应收发数据|长度不超过4，可为0-9a-zA-Z的组合|
+|dataTag|	数据标签，用于对应收发数据|长度不超过4个字符，可为字母数字的组合，区分大小写|
+|tag|	自定义标签|长度不超过128个字符，可以为字母数字下划线"_"的组合,区分大小写,非必填，可不传本字段|
 |data|	数据内容|对象或者数组，可为空|
 <font color="red">注意：基站接收指令数据单次不超过2K长度，在指定键盘发送指令时，如果指令长度超出限制，建议将指令进行拆分，分次发送，如果是所有键盘执行的指令，可将keySns设为空数组不使用指定键盘的模式</font>
@@ -255,10 +257,12 @@ Ver 1.0.1
 ||停止标准测验|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
 |自主录分|启动自主录分|[startKpScoreInput](#startkpscoreinput)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpScore](#fevtkpscore)<br>[fEvtFinalSubmit](#fevtfinalsubmit)|
 ||停止自主录分|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
+|自定义测验题型标题|自定义测验题型标题内容|[setKpExamQuesTitle](#setKpexamquestitle)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpExamQuesTitle](#fevtkpexamquestitle)|
+||清除自定义测验题型标题内容|[clearKpExamQuesTitle](#clearkpexamquestitle)|[sEvtStateCode](#sevtstatecode)<br>[fEvtClearKpExamQuesTitle](#fevtclearkpexamquestitle)|
 ## 公共方法
 ### stopKpVote
-- **主题**: /client/\${baseSN}/send
+- **主题**: /client/{baseSN}/send
 - **功能描述**：通用停止键盘答题方法，可以停止如同步签到、按键反馈、在线测验中调用startXXX方法启动的业务
 - **参数说明**
@@ -277,7 +281,7 @@ Ver 1.0.1
 ## 公共事件
 ### sEvtBsConnectState
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：基站连接成功时返回基站型号和基站SN,基站从已连接状态断开返回连接断开
 - **参数说明**
@@ -314,7 +318,7 @@ Ver 1.0.1
 }
 ```
 ### sEvtBsChannelConflict
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：基站信道冲突时主动上报，应用程序可根据实际业务修改基站信道
 - **参数说明**
@@ -336,7 +340,7 @@ Ver 1.0.1
 }
 ```
 ### sEvtBsNfcResults
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：键盘刷卡时主动上报，如果超出基站容量会上报失败
 - **参数说明**
@@ -363,7 +367,7 @@ Ver 1.0.1
 ```
 ### sEvtBsKpOnlineMsg
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：键盘上线通知，主动上报,键盘升级成功后也会上报
 - **参数说明**
@@ -389,7 +393,7 @@ Ver 1.0.1
 }
 ```
 ### sEvtKpRtFeedback
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：开启键盘实时反馈后，键盘按键时上报
 - **参数说明**
@@ -417,7 +421,7 @@ Ver 1.0.1
 }
 ```
 ### sEvtKpHandUp
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：开启键盘举手功能后，键盘按举手键时上报
 - **参数说明**
@@ -439,7 +443,7 @@ Ver 1.0.1
 }
 ```
 ### sEvtStateCode
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站接收指令状态信息
 - **参数说明**
@@ -505,7 +509,7 @@ Ver 1.0.1
 ```
 ##### getBsConnectState
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：主动获取基站连接状态
 - **参数说明**
@@ -553,10 +557,11 @@ Ver 1.0.1
     }
 }
 ```
+
 ### 基站授时
 #### 方法
 ##### timeSync
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：发送当前时间戳给基站进行校时
 - **参数说明**
@@ -584,7 +589,7 @@ Ver 1.0.1
 ### 识别设置
 #### 方法
 ##### setBsSN
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置基站的SN，<font color="red">需预先订阅新SN的主题,以获取事件返回</font>
 - **参数说明**
@@ -608,7 +613,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsModel
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站型号
 - **参数说明**
@@ -625,7 +630,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsFWVersion
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站固件版本
 - **参数说明**
@@ -642,7 +647,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsBIC
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：获取基站品牌识别码
 - **参数说明**
@@ -659,7 +664,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsBIC
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置基站品牌识别码
 - **参数说明**
@@ -684,7 +689,7 @@ Ver 1.0.1
 ```
 #### 事件
 ##### fEvtBsSN
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站的出厂编码
 - **参数说明**
@@ -706,7 +711,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsModel
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站的型号
 - **参数说明**
@@ -728,7 +733,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsFWVersion
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站的固件版本
 - **参数说明**
@@ -750,7 +755,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsBIC
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站的品牌码
 - **参数说明**
@@ -774,7 +779,7 @@ Ver 1.0.1
 ### 组网设置
 #### 方法
 ##### getBsNetworkMode
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站组网模式
 - **参数说明**
@@ -791,7 +796,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsNetworkMode
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站组网模式
 - **参数说明**
@@ -813,7 +818,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsPairCode
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站配对码
 - **参数说明**
@@ -830,7 +835,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsPairCode
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置基站配对码
 - **参数说明**
@@ -854,7 +859,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsNfcLogin
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取刷卡配对状态
 - **参数说明**
@@ -871,7 +876,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsNfcLogin
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站刷卡配对状态
 - **参数说明**
@@ -893,7 +898,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsChannel
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站信道
 - **参数说明**
@@ -910,7 +915,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsChannel
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站信道
 - **参数说明**
@@ -933,7 +938,7 @@ Ver 1.0.1
 ```
 ##### getBsRFIChannel
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取已被其他基站占用的信道
 - **参数说明**
@@ -952,7 +957,7 @@ Ver 1.0.1
 #### 事件
 ##### fEvtBsNetworkMode
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站组网模式
 - **参数说明**
@@ -974,7 +979,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsPairCode
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站配对码
 - **参数说明**
@@ -997,7 +1002,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsChannel
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站信道
 - **参数说明**
@@ -1020,7 +1025,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsRFIChannel
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回其他基站已占用的信道，频点冲突时，可以根据返回结果修改基站信道避开干扰
 - **参数说明**
@@ -1052,7 +1057,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsNfcLogin
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站是否允许NFC刷卡
 - **参数说明**
@@ -1077,7 +1082,7 @@ Ver 1.0.1
 #### 方法
 ##### getBsSSID
 获取基站登录名称
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站登录名称
 - **参数说明**
@@ -1094,7 +1099,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsSSID
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站登录名称
 - **参数说明**
@@ -1116,7 +1121,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsLoginPwd
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站登录密码
 - **参数说明**
@@ -1133,7 +1138,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsLoginPwd
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站登录密码
 - **参数说明**
@@ -1156,7 +1161,7 @@ Ver 1.0.1
 ```
 ##### getBsLoginState
 获取基站登录名称
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站登录状态
 - **参数说明**
@@ -1173,7 +1178,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsLoginState
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站登录状态
 - **参数说明**
@@ -1197,7 +1202,7 @@ Ver 1.0.1
 #### 事件
 ##### fEvtBsSSID
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站名称
 - **参数说明**
@@ -1219,7 +1224,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsLoginPwd
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站登录密码
 - **参数说明**
@@ -1250,7 +1255,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsLoginState
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站登录状态
 - **参数说明**
@@ -1274,7 +1279,7 @@ Ver 1.0.1
 ### 键盘统一设置
 #### 方法
 ##### getBsKpLanguage
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取键盘语言
 - **参数说明**
@@ -1291,7 +1296,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsKpLanguage
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置键盘语言
 - **参数说明**
@@ -1313,7 +1318,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsKpStbMsgMode
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取状态语设置状态
 - **参数说明**
@@ -1330,7 +1335,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsKpStbMsgMode
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置状态语工作状态
 - **参数说明**
@@ -1352,7 +1357,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsKpLoginMenu
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取键盘登录菜单显示状态
 - **参数说明**
@@ -1370,7 +1375,7 @@ Ver 1.0.1
 ```
 ##### setBsKpLoginMenu
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置键盘登录菜单显示状态
 - **参数说明**
@@ -1392,7 +1397,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsKpSleepLevel
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：获取键盘休眠时间等级
 - **参数说明**
@@ -1410,7 +1415,7 @@ Ver 1.0.1
 ```
 ##### setBsKpSleepLevel
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置键盘休眠时间等级
 - **参数说明**
@@ -1433,7 +1438,7 @@ Ver 1.0.1
 ```
 ##### setBsKpPauseSleep
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置键盘暂停休眠是否开启<br><font color="red">注意：请谨慎使用本功能，务必在相关测试或功能完成后关闭，否则可能会导致键盘异常耗电<br>设置单次生效，基站拔插后复位成关闭状态</font>
 - **参数说明**
@@ -1456,7 +1461,7 @@ Ver 1.0.1
 ```
 ##### getBsKpPauseSleep
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：获取键盘暂停休眠是否开启
 - **参数说明**
@@ -1475,7 +1480,7 @@ Ver 1.0.1
 #### 事件
 ##### fEvtBsKpLanguage
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回键盘语言
 - **参数说明**
@@ -1497,7 +1502,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsKpStbMsgMode
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回状态语工作状态
 - **参数说明**
@@ -1519,7 +1524,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsKpLoginMenu
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回键盘登录菜单显示状态
 - **参数说明**
@@ -1541,7 +1546,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsKpSleepLevel
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘休眠时间等级
 - **参数说明**
@@ -1564,7 +1569,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsKpPauseSleep
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回暂停键盘休眠开启状态
 - **参数说明**
@@ -1589,7 +1594,7 @@ Ver 1.0.1
 ### 配对模式
 #### 方法
 ##### startBsFastPair
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动快速配对,键盘配对成功返回键盘信息 [sEvtBsKpOnlineMsg](#sevtbskponlinemsg)
 - **参数说明**
@@ -1606,7 +1611,7 @@ Ver 1.0.1
 }
 ```
 ##### stopBsFastPair
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止快速配对
 - **参数说明**
@@ -1632,7 +1637,7 @@ Ver 1.0.1
 ### 白名单模式
 #### 方法
 ##### getBsWhitelist
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站白名单列表
 - **参数说明**
@@ -1649,7 +1654,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsWhitelist
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站白名单列表，将基站白名单替换为写入的键盘SN列表
 - **参数说明**
@@ -1671,7 +1676,7 @@ Ver 1.0.1
 }
 ```
 ##### clearBsWhitelist
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：清空基站白名单列表
 - **参数说明**
@@ -1688,7 +1693,7 @@ Ver 1.0.1
 }
 ```
 ##### addBsWhitelist
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：添加键盘至基站白名单列表
 - **参数说明**
@@ -1710,7 +1715,7 @@ Ver 1.0.1
 }
 ```
 ##### delBsWhitelist
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：从基站白名单列表中删除键盘
 - **参数说明**
@@ -1736,7 +1741,7 @@ Ver 1.0.1
 发送指令后返回此事件
 ##### fEvtBsWhitelist
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回基站白名单列表
 - **参数说明**
@@ -1759,7 +1764,7 @@ Ver 1.0.1
 ```
 ##### fEvtSetBsWhitelist
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回设置白名单状态
 - **参数说明**
@@ -1787,7 +1792,7 @@ Ver 1.0.1
 ```
 ##### fEvtAddBsWhitelist
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回增加键盘状态
 - **参数说明**
@@ -1815,7 +1820,7 @@ Ver 1.0.1
 ```
 ##### fEvtDelBsWhitelist
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回删除键盘状态
 - **参数说明**
@@ -1845,7 +1850,7 @@ Ver 1.0.1
 ### 网络参数设置
 #### 方法
 ##### getBsTcpipParams
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站TCP/IP参数
 - **参数说明**
@@ -1862,7 +1867,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsTcpipParams
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站TCP/IP参数
 - **参数说明**
@@ -1890,7 +1895,7 @@ Ver 1.0.1
 }
 ```
 ##### getBsMqttParams
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站MQTT参数
 - **参数说明**
@@ -1907,7 +1912,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsMqttParams
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站MQTT参数
 - **参数说明**
@@ -1938,7 +1943,7 @@ Ver 1.0.1
 ```
 #### 事件
 ##### fEvtBsTcpipParams
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站TCP/IP参数
 - **参数说明**
@@ -1968,7 +1973,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtBsMqttParams
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：返回基站MQTT参数
 - **参数说明**
@@ -2000,7 +2005,7 @@ Ver 1.0.1
 ### 基站加密
 #### 方法
 ##### getBsSoftwareKey
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取基站软件狗密钥
 - **参数说明**
@@ -2017,7 +2022,7 @@ Ver 1.0.1
 }
 ```
 ##### setBsSoftwareKey
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置基站软件狗密钥
 - **参数说明**
@@ -2040,7 +2045,7 @@ Ver 1.0.1
 ```
 #### 事件
 ##### fEvtBsSoftwareKey
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回基站的软件狗密钥
 - **参数说明**
@@ -2064,7 +2069,7 @@ Ver 1.0.1
 ### 基站维护
 #### 方法
 ##### getBsLogInfo
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：获取基站日志,用于出现故障需要排查问题时获取基站内部日志记录
 - **参数说明**
@@ -2082,7 +2087,7 @@ Ver 1.0.1
 ```
 ##### clearBsLogInfo
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：清空基站内部日志记录
 - **参数说明**
@@ -2100,7 +2105,7 @@ Ver 1.0.1
 ```
 ##### resetBsSystem
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：软复位基站<sapn class="yellowFill">（公共主题可用，但不体现在外部版本协议中</span>）
 - **参数说明**
@@ -2118,7 +2123,7 @@ Ver 1.0.1
 ```
 ##### resetBsPower
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：断电复位基站<sapn class="yellowFill">（公共主题可用，但不体现在外部版本协议中）</span>
 - **参数说明**
@@ -2136,7 +2141,7 @@ Ver 1.0.1
 ```
 ##### startBsSelfCheck
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：开始基站自检,基站自检状态中不接收其他指令，空闲状态中才进入自检
 - **参数说明**
@@ -2156,13 +2161,13 @@ Ver 1.0.1
 #### 事件
 ##### [sEvtStateCode](#sevtstatecode)
 返回指令的接收状态
-注意：内部指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
+注意：内部指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
 ##### [sEvtBsConnectState](#sevtbsconnectstate)
 复位基站后，基站重新连接成功后上报
 ##### fEvtBsLogInfo
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站存储的日志内容
 - **参数说明**
@@ -2187,7 +2192,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsSelfCheck
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站自检的结果
 - **参数说明**
@@ -2228,7 +2233,7 @@ Ver 1.0.1
 ### 基站升级
 #### 方法
 ##### startBsUpdate
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**:基站固件升级
 - **参数说明**
@@ -2237,7 +2242,7 @@ Ver 1.0.1
 |fun|string|-|是|指令名称|
 |dataTag|string|-|否|数据包标识,可为空字符串|
 |data|object|-|是|传送参数的对象|
-|+partition|int||是|存储区域<br> 1-备份区<font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，然后上电，这时基站固件就会更新成备份区的固件</font><br>2-更新区，实时升级基站固件|
+|+partition|int||是|存储区域<br> 1-备份区<font class="yellowFill"> 使用备份区固件的方法：打开基站盖子，按住SW1按钮，上电后松开按钮，这时基站固件就会更新成备份区的固件</font><br>2-更新区，实时升级基站固件|
 |+url|string||是|待升级的固件地址，可访问的网络url|
 |+version|string||是|待升级的基站固件版本|
 |+crc|uint||是|固件CRC校验码，10进制数字|
@@ -2258,7 +2263,7 @@ Ver 1.0.1
 }
 ```
 ##### downloadFontLib
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**:下载更新基站字库文件
 - **参数说明**
@@ -2291,10 +2296,10 @@ Ver 1.0.1
 #### 事件
 ##### [sEvtStateCode](#sevtstatecode)
 返回升级指令的接收状态
-注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
+注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
 ##### fEvtBsUpateState
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站启动升级状态
 - **参数说明**
@@ -2319,7 +2324,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsUpdateProgress
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站升级进度
 - **参数说明**
@@ -2342,7 +2347,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsFontLibState
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站下载字库状态
 - **参数说明**
@@ -2367,7 +2372,7 @@ Ver 1.0.1
 ```
 ##### fEvtBsFontLibProgress
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回基站下载字库进度
 - **参数说明**
@@ -2393,7 +2398,7 @@ Ver 1.0.1
 ### 识别设置
 #### 方法
 ##### setKpSN
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**:设置指定键盘的出厂编码
 - **参数说明**
@@ -2420,7 +2425,7 @@ Ver 1.0.1
 ```
 ##### setKpID
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：设置键盘编号
 - **参数说明**
@@ -2444,7 +2449,7 @@ Ver 1.0.1
 ```
 ##### startGetKpInfo
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：开始获取键盘信息
 - **参数说明**
@@ -2463,7 +2468,7 @@ Ver 1.0.1
 ```
 ##### stopGetKpInfo
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：停止获取键盘信息
 - **参数说明**
@@ -2486,7 +2491,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtSetKpSN
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回写键盘SN状态
 - **参数说明**
@@ -2510,7 +2515,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtSetKpID
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘编号
 - **参数说明**
@@ -2534,7 +2539,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtKpInfo
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘信息
 - **参数说明**
@@ -2565,7 +2570,7 @@ Ver 1.0.1
 ### 交互设置
 #### 方法
 ##### setKpUserStbMsg
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：设置用户内置状态语
 - **参数说明**
@@ -2593,7 +2598,7 @@ Ver 1.0.1
 }
 ```
 ##### rtSetKpUserPrompt
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：实时设置提示反馈信息
 - **参数说明**
@@ -2606,6 +2611,7 @@ Ver 1.0.1
 |++info|string||否|设置的反馈信息<br>不同键盘可设置不同反馈信息|
 - **示例代码**
+
 ```json
 //分别提示
 {
@@ -2639,7 +2645,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtKpUserStbMsg
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回设置状态语的状态
 - **参数说明**
@@ -2661,7 +2667,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtSetKpUserPrompt
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回实时设置提示语是否成功
 - **参数说明**
@@ -2698,7 +2704,7 @@ Ver 1.0.1
 ### 在线状态
 #### 方法
 ##### startGetKpOnline
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：开始获取键盘在线信息,键盘在线返回键盘信息
 - **参数说明**
@@ -2708,6 +2714,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"startGetKpOnline",
@@ -2716,7 +2723,7 @@ Ver 1.0.1
 ```
 ##### stopGetKpOnline
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止获取键盘在线信息
 - **参数说明**
@@ -2726,6 +2733,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopGetKpOnline",
@@ -2737,7 +2745,7 @@ Ver 1.0.1
 发送指令后返回此事件
 ##### fEvtKpOnlineMsg
-- **主题**: /basestation/\${baseSN}/receive
+- **主题**: /basestation/{baseSN}/receive
 - **功能描述**：主动获取在线键盘时，在线键盘状态报告
 - **参数说明**
@@ -2768,7 +2776,7 @@ Ver 1.0.1
 ### 维护功能
 #### 方法
 ##### remoteKpSleep
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：遥控键盘休眠
 - **参数说明**
@@ -2790,7 +2798,7 @@ Ver 1.0.1
 }
 ```
 ##### startKpFWUpdate
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**:键盘升级
 - **参数说明**
@@ -2820,7 +2828,7 @@ Ver 1.0.1
 }
 ```
 ##### stopKpFWUpdate
-- **主题**：<sapn class="yellowFill">/manage/\${baseSN}/send</span>
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**:停止键盘升级
 - **参数说明**
@@ -2843,10 +2851,10 @@ Ver 1.0.1
 #### 事件
 ##### [sEvtStateCode](#sevtstatecode)
 返回升级指令的接收状态
-注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>** 返回
+注意：升级指令的接收状态需从**主题: <sapn class="yellowFill">/manage/{baseSN}/receive</span>** 返回
 ##### fEvtKpFWUpdateState
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘升级状态
 - **参数说明**
@@ -2870,7 +2878,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtKpUpdateProgress
-- **主题**: <sapn class="yellowFill">/manage/\${baseSN}/receive</span>
+- **主题**: <sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘升级进度
 - **参数说明**
@@ -2895,7 +2903,7 @@ Ver 1.0.1
 ### 无线绑定
 #### 方法
 ##### rtSetKpBindingInfo
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：实时设置绑定信息到键盘
 - **参数说明**
@@ -2908,6 +2916,7 @@ Ver 1.0.1
 |++info|string||是|设置的绑定信息，一般为学生姓名<br>最长48个字符，显示在键盘左上角|
 - **示例代码**
+
 ```json
 {
   "fun":"rtSetKpBindingInfo",
@@ -2926,7 +2935,7 @@ Ver 1.0.1
 ```
 ##### clearKpBindingInfo
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：清除键盘绑定信息
 - **参数说明**
@@ -2938,6 +2947,7 @@ Ver 1.0.1
 |+keySns|array||否|需要清除绑定信息键盘SN数组，<br>空数组表示清空所有键盘|
 - **示例代码**
+
 ```json
 {
   "fun":"clearKpBindingInfo",
@@ -2952,7 +2962,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtKpBindingInfo
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘实时设置绑定信息的状态是否成功
 - **参数说明**
@@ -2965,6 +2975,7 @@ Ver 1.0.1
 |++state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtKpBindingInfo",
@@ -2982,7 +2993,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtClearKpBindingInfo
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回清空绑定信息的指令状态是否成功
 - **参数说明**
@@ -2994,6 +3005,7 @@ Ver 1.0.1
 |+state|string||是|设置的绑定信息是否成功<br>0 - 成功<br>1 - 失败|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtClearKpBindingInfo",
@@ -3007,7 +3019,7 @@ Ver 1.0.1
 ### 同步签到
 #### 方法
 ##### startKpSignIn
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动同步签到
 - **参数说明**
@@ -3049,7 +3061,7 @@ Ver 1.0.1
 }
 ```
 <!-- ##### stopKpSignIn
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止同步签到
 - **参数说明**
@@ -3078,7 +3090,7 @@ Ver 1.0.1
 ### 随时签到
 #### 方法
 ##### rtStartKpSignIn
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动随时签到绑定
 - **参数说明**
@@ -3090,6 +3102,7 @@ Ver 1.0.1
 |+mode|int|-|是|签到模式<br>1-按键签到，按OK键签到自动授权(<font color="red">暂不支持</font>)<br>2-PIN码签到，输入pin码后由应用程序决定是否授权|
 - **示例代码**
+
 ```json
 {
   "fun":"rtStartKpSignIn",
@@ -3100,7 +3113,7 @@ Ver 1.0.1
 }
 ```
 ##### rtStopKpSignIn
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止随时签到绑定
 - **参数说明**
@@ -3110,6 +3123,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"rtStopKpSignIn",
@@ -3117,7 +3131,7 @@ Ver 1.0.1
 }
 ```
 ##### rtSetKpLoginAllowed
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：实时PIN绑定授权,可取消授权
 - **参数说明**
@@ -3130,6 +3144,7 @@ Ver 1.0.1
 |+state|int|-|是|1-授权成功<br>2-授权失败<br>3-解除已授权|
 - **示例代码**
+
 ```json
 {
   "fun":"rtSetKpLoginAllowed",
@@ -3145,7 +3160,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtKpSignIn
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交签到信息
 - **参数说明**
@@ -3161,6 +3176,7 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtKpSignIn",
@@ -3179,7 +3195,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtKpLoginAllowed
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘授权状态
 - **参数说明**
@@ -3192,6 +3208,7 @@ Ver 1.0.1
 |+state|string||是|0-执行成功<br> 1-执行失败|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtKpLoginAllowed",
@@ -3206,7 +3223,7 @@ Ver 1.0.1
 ### 判断题
 #### 方法
 ##### startQATrueFalse
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动判断题答题
 - **参数说明**
@@ -3224,6 +3241,7 @@ Ver 1.0.1
 |++answer|string||是|预设提交的按键值<br>1-对 <br>2-错|
 - **示例代码**
+
 ```json
 {
   "fun":"startQATrueFalse",
@@ -3241,7 +3259,7 @@ Ver 1.0.1
 }
 ```
 <!-- ##### stopQATrueFalse
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止判断题答题
 - **参数说明**
@@ -3251,6 +3269,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopQATrueFalse",
@@ -3266,7 +3285,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtQATrueFalse
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交答题信息
 - **参数说明**
@@ -3282,6 +3301,7 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtQATrueFalse",
@@ -3297,7 +3317,7 @@ Ver 1.0.1
 ### 选择题
 #### 方法
 ##### startQAChoice
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动选择题答题
 - **参数说明**
@@ -3318,6 +3338,7 @@ Ver 1.0.1
 |++answer|string||是|预设提交的按键值|
 - **示例代码**
+
 ```json
 {
   "fun":"startQAChoice",
@@ -3338,7 +3359,7 @@ Ver 1.0.1
 }
 ```
 <!-- ##### stopQAChoice
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止选择题答题
 - **参数说明**
@@ -3348,6 +3369,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopQAChoice",
@@ -3362,7 +3384,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtQAChoice
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交答题信息
 - **参数说明**
@@ -3378,6 +3400,7 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtQAChoice",
@@ -3392,7 +3415,7 @@ Ver 1.0.1
 ### 数字题
 #### 方法
 ##### startQANum
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动数字题答题
 - **参数说明**
@@ -3412,6 +3435,7 @@ Ver 1.0.1
 |++answer|string||是|预设提交的按键值|
 - **示例代码**
+
 ```json
 {
   "fun":"startQANum",
@@ -3431,7 +3455,7 @@ Ver 1.0.1
 }
 ```
 <!-- ##### stopQANum
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止数字题答题
 - **参数说明**
@@ -3441,6 +3465,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopQANum",
@@ -3455,7 +3480,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtQANum
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交答题信息
 - **参数说明**
@@ -3471,11 +3496,12 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtQANum",
   "dataTag":"1",
-  "data": [{
+  "data":[{
       "keySn": "1234567890",
       "keyValue":"10",
       "keyTime":3.2
@@ -3485,7 +3511,7 @@ Ver 1.0.1
 ### 抢答题
 #### 方法
 ##### startQAQuicker
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动抢答题答题
 - **参数说明**
@@ -3518,7 +3544,7 @@ Ver 1.0.1
 }
 ```
 <!-- ##### stopQAQuicker
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止抢答答题
 - **参数说明**
@@ -3528,6 +3554,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopQAQuicker",
@@ -3543,7 +3570,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtQAQuicker
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交答题信息
 - **参数说明**
@@ -3559,6 +3586,7 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtQAQuicker",
@@ -3573,7 +3601,7 @@ Ver 1.0.1
 ### 待机实时反馈
 #### 方法
 ##### setKpStbResponse
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动待机实时反馈
 - **参数说明**
@@ -3618,7 +3646,7 @@ Ver 1.0.1
 ```
 ##### getKpStbResponse
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：获取实时反馈是否打开
 - **参数说明**
@@ -3637,8 +3665,8 @@ Ver 1.0.1
 ```
 #### 事件
-#### fEvtKpStbResponse
-- **主题**：/basestation/\${baseSN}/receive
+##### fEvtKpStbResponse
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回当前待机按键反馈开启状态
 - **参数说明**
@@ -3682,7 +3710,7 @@ Ver 1.0.1
 ### 标准测验
 #### 方法
 ##### startKpExam
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动标准测验
 - **参数说明**
@@ -3694,7 +3722,7 @@ Ver 1.0.1
 |+examNo|int||是|0-9999<br>=0，新的测验<br>>0时,与上次启动卷号一致继续测验，不一致进入新的测验|
 |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头|
 |+questions|array||是|题目详情|
-|++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
+|++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 <br>5:自判题|
 |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时  默认4;<br>范围：1-10。|
 |++startNo | string||是| 起始题号,可以为数字+“-”，单级的题号数字范围1-255，如“1”，“1-1”，“1-1-1”，最多只能输入三级<br>mode=0 时有效，mode=1或2时键盘按顺序显示题号|
 |++count | int||是| 相同参数的连续题目数量, >0 <br>注意：总题数最多支持200题 |
@@ -3892,7 +3920,7 @@ Ver 1.0.1
 ```
 <!-- ##### stopKpExam
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止标准测验
 - **参数说明**
@@ -3902,6 +3930,7 @@ Ver 1.0.1
 |dataTag|string|-|否|数据包标识,可为空字符串|
 - **示例代码**
+
 ```json
 {
   "fun":"stopKpExam",
@@ -3912,7 +3941,7 @@ Ver 1.0.1
 停止在线测验
 ##### rtGetKpExamData
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：刷新作答数据
 - **参数说明**
@@ -3934,7 +3963,7 @@ Ver 1.0.1
 }
 ```
 ##### rtKpAllowEdited
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：键盘提交后，允许键盘修改答案
 - **参数说明**
@@ -3946,6 +3975,7 @@ Ver 1.0.1
 |+keySns|array||是|指定的键盘SN数组，空数组表示全部在线键盘|
 - **示例代码**
+
 ```json
 {
   "fun":"rtKpAllowEdited",
@@ -3960,7 +3990,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtKpExam
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交答题信息
 - **参数说明**
@@ -3976,6 +4006,7 @@ Ver 1.0.1
 |++retryCount|int||是|键盘提交数据的重发次数|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtKpExam",
@@ -3994,7 +4025,7 @@ Ver 1.0.1
 }
 ```
 ##### fEvtFinalSubmit
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘手动交卷标识
 - **参数说明**
@@ -4008,6 +4039,7 @@ Ver 1.0.1
 |++keyTime|double||是|提交时间，从启动开始计算，单位秒|
 - **示例代码**
+
 ```json
 {
   "fun":"fEvtFinalSubmit",
@@ -4023,7 +4055,7 @@ Ver 1.0.1
 ### 多科测验
 #### 方法
 ##### startKpMultiExam
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动多科测验
 - **参数说明**
@@ -4035,11 +4067,11 @@ Ver 1.0.1
 |+examNo|int||是|0-9999<br>=0，新的测验<br>>0时,与上次启动卷号一致继续测验，不一致进入新的测验|
 |+mode|int||是|显示模式<br>0-不显示开头<br>1-显示“Q”开头<br>2-显示“题”开头|
 |+questions|array||是|题目详情|
-|++subject | int||是 | 科目序号,1-9,对应键盘中内置的科目1-9<br>键盘答题时可选择科目切换答题|
+|++subject | int||是 | 科目序号,1-11,对应键盘中内置的科目1-11<br>键盘答题时可选择科目切换答题|
 |++quesType | int||是| 题目类型<br>1:单选<br>2:多选（排序）<br>3:数字<br>4:判断 |
 |++option |int||是 |选项数目<br> quesType = 1 有效。<br>quesType = 2 有效。<br>此项缺省时  默认4;<br>范围：1-10。|
 |++startNo | string||是| 起始题号,可以为数字+“-”，单级的题号数字范围1-255，如“1”，“1-1”，最多支持两级题号<br>mode=0 时有效，mode=1或2时键盘按顺序显示题号|
-|++count | int||是| 相同参数的连续题目数量, >0 <br>注意：所有科目的总题数最多支持200题|
+|++count | int||是| 相同参数的连续题目数量, >0 <br><font color="red">注意：所有科目的总题数最多支持200题</font>|
 |+simParams|object||否|内部模拟测试参数设置对象|
 |++answer|array||是|预设提交的按键值<br>格式为"单选题答案,多选题答案;<br>数字题答案;判断题答案(1对2错)"<br>如["A","ABCD","10","1"]|
@@ -4126,7 +4158,7 @@ Ver 1.0.1
 ```
 <!-- ##### stopKpMultiExam
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止多科测验
 - **参数说明**
@@ -4158,7 +4190,7 @@ Ver 1.0.1
 ### 自主录分
 #### 方法
 ##### startKpScoreInput
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：启动自主录分
 - **参数说明**
@@ -4201,7 +4233,7 @@ Ver 1.0.1
 ```
 <!-- 
 ##### stopKpScoreInput
-- **主题**：/client/\${baseSN}/send
+- **主题**：/client/{baseSN}/send
 - **功能描述**：停止自主录分
 - **参数说明**
@@ -4225,7 +4257,7 @@ Ver 1.0.1
 发送指令后返回接收状态
 ##### fEvtKpScore
-- **主题**：/basestation/\${baseSN}/receive
+- **主题**：/basestation/{baseSN}/receive
 - **功能描述**：返回键盘提交录分信息
 - **参数说明**
@@ -4257,4 +4289,141 @@ Ver 1.0.1
     }
   ]
 }
+```
+
+### 自定义测验题型标题
+#### 方法
+##### setKpExamQuesTitle
+- **主题**：/client/{baseSN}/send
+- **功能描述**：设置自定义测验题题型标题，键盘需在线才能接收成功。<br>设置完成后启动测验，对应的题型显示为设置的自定义标题。<br><font color="red">题型标题相对固定，下发成功后键盘会保存标题，标题无变化时无需重复下发</font>
+- **参数说明**
+
+|参数名|类型|限制|是否必填|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|是|传送参数的对象数组，不可为空|
+|+keySns|array||是|需要设置标题的键盘SN数组，为空代表全部在线键盘<br><font color="red">注意：指定键盘下发才有单个键盘下发是否成功的事件，全部在线键盘下发只有统一回复事件</font>|
+|+type|int||是|需要设置的题目类型<br>1-单选题<br>2-多选题<br>3-数字题<br>4-判断题<br>5-对错题(自判题)|
+|+title|string||是|设置的标题内容，长度不大于15个字符|
+
+
+- **示例代码**
+```json
+//指定下发
+{
+  "fun":"setKpExamQuesTitle",
+  "dataTag":"1",
+  "data": {
+    "keySns": ["1234567890","1234567891"],
+    "type":1,
+    "title": "请选择"
+  }
+}
+
+//统一下发
+{
+  "fun":"setKpExamQuesTitle",
+  "dataTag":"1",
+  "data": {
+    "keySns": [],
+    "type":1,
+    "title": "请选择"
+  }
+}
+```
+
+##### clearKpExamQuesTitle
+- **主题**：/client/{baseSN}/send
+- **功能描述**：清除键盘自定义测验题型标题
+- **参数说明**
+
+|参数名|类型|限制|是否必填|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|是|传送参数的对象数组|
+|+type|int||是|需要清除自定义标题的题目类型<br>0-所有题型<br>1-单选题<br>2-多选题<br>3-数字题<br>4-判断题<br>5-对错题(自判题)|
+|+keySns|array||否|需要清除绑定信息键盘SN数组，<br>空数组表示清空所有键盘|
+
+- **示例代码**
+```json
+{
+  "fun":"clearKpExamQuesTitle",
+  "dataTag":"1",
+  "data": {
+    "type":0,
+    "keySns":[]
+  }
+}
+```
+
+#### 事件
+##### [sEvtStateCode](#sevtstatecode)
+发送指令后返回接收状态
+
+##### fEvtKpExamQuesTitle
+- **主题**：/basestation/{baseSN}/receive
+- **功能描述**：返回键盘实时设置绑定信息的状态是否成功
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|array|-|否|返回的对象数组|
+|++keySn|string||是|设置自定义题型的SN，如果未指定键盘，则keySn为空字符串|
+|++state|string||是|设置的自定义信息是否成功<br>0 - 成功<br>1 - 失败|
+
+- **示例代码**
+```json
+//指定下发
+{
+  "fun":"fEvtKpExamQuesTitle",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn":"1234567890",
+      "state": "0"
+    },
+    {
+      "keySn":"1234567891",
+      "state": "0"
+    }
+  ]
+}
+
+//统一下发
+{
+  "fun":"fEvtKpExamQuesTitle",
+  "dataTag":"1",
+  "data": [
+    {
+      "keySn":"",
+      "state": "0"
+    }
+  ]
+}
+```
+##### fEvtClearKpExamQuesTitle
+- **主题**：/basestation/{baseSN}/receive
+- **功能描述**：返回清空自定义题型标题的指令状态是否成功
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|data|object|-|否|传送参数的对象|
+|+state|string||是|清空自定义标题是否成功<br>0 - 成功<br>1 - 失败|
+
+- **示例代码**
+```json
+{
+  "fun":"fEvtClearKpExamQuesTitle",
+  "dataTag":"1",
+  "data": {
+    "state": "0"
+  }
+}
 ```
 \ No newline at end of file