diff --git a/通讯协议-平台化-应用部分[内部].md b/通讯协议-平台化-应用部分[内部].md index 79e4e54..27ec1d5 100644 --- a/通讯协议-平台化-应用部分[内部].md +++ b/通讯协议-平台化-应用部分[内部].md @@ -32,7 +32,7 @@ SunVote 二次开发
通讯协议

-Ver 1.0.8 +Ver 1.0.9


@@ -75,6 +75,7 @@ Ver 1.0.8 |1.0.6| 2025年6月18日|刘琴|1. 增加遥控修改键盘配对码
2. 增加设置基站是否自动清除白名单| |1.0.7| 2025年6月24日|刘琴|1. 增加自定义科目名称和清除科目名称
2. 增加控制键盘灯光、震动、蜂鸣(T2)
3. 增加空闲标题下发(T2)
4. 增加下发和清除分数(T2)| |1.0.8| 2025年7月8日|刘琴|1. 增加读写基站MAC地址(内部)| +|1.0.9| 2025年7月17日|刘琴|1. 基站自检项增加字库检测
2. 键盘扫描指令增加键盘id返回
3. 修改设置键盘ID和返回事件为外部指令|

@@ -261,7 +262,7 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 |交互设置 - 设置键盘外设|实时设置键盘外设信息|[rtSetKpDevice](#rtsetkpdevice)|[sEvtStateCode](#sevtstatecode)
[fEvtSetKpDevice](#fevtsetkpdevice)| |交互设置 - 用户内置状态语|设置用户内置状态语(内)|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)| |识别设置 - 出厂编码(内)|设置键盘出厂编码(内)|[setKpSN](#setkpsn)|[fEvtSetKpSN](#fevtsetkpsn)
| -|识别设置 - 键盘编号(内)|设置键盘编号(内)|[setKpID](#setkpid)|[fEvtSetKpID](#fevtsetkpid)| +|识别设置 - 键盘编号|设置键盘编号|[setKpID](#setkpid)|[fEvtSetKpID](#fevtsetkpid)| |识别设置 - 键盘信息(内)|开始获取键盘信息(内)|[startGetKpInfo](#setkpid)|[sEvtStateCode](#sevtstatecode)
[fEvtKpInfo](#fevtkpinfo)| ||停止获取键盘信息(内)|[stopGetKpInfo](#setkpid)|[sEvtStateCode](#sevtstatecode)| |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)
[fEvtKpOnlineMsg](#fevtkponlinemsg)| @@ -3189,7 +3190,7 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 |dataTag|string|-|否|数据包标识,可为空字符串| |baseSn|string||是|基站的出厂编码| |data|array|-|是|传送参数的对象数组| -|++name|string||是|检测项名称:MCU、RF、FLASH、EEPROM| +|++name|string||是|检测项名称:MCU、RF、FLASH、EEPROM、FONTLIB| |++state|int||是|检测结果
0-功能正常
1-功能异常| - **示例代码** @@ -3214,6 +3215,10 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 { "name":"EEPROM", "state":0 + }, + { + "name":"FONTLIB", + "state":0 } ] } @@ -3434,7 +3439,6 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 ``` ## 键盘管理 - ### 识别设置 #### 方法 ##### setKpSN @@ -3467,7 +3471,7 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 ``` ##### setKpID -- **主题**:/manage/{baseSN}/send +- **主题**:/client/{baseSN}/send - **功能描述**:设置键盘编号 - **参数说明** @@ -3564,8 +3568,9 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 } } ``` + ##### fEvtSetKpID -- **主题**:/manage/{baseSN}/receive +- **主题**:/basestation/{baseSN}/receive - **功能描述**:返回键盘编号 - **参数说明** @@ -3590,6 +3595,7 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 } } ``` + ##### fEvtKpInfo - **主题**:/manage/{baseSN}/receive - **功能描述**:返回键盘信息 @@ -4099,6 +4105,7 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 |baseSn|string||是|基站的出厂编码| |data|array|-|是|传送参数的对象数组| |++keySn|string||是|键盘SN| +|++keyId|int||是|键盘编号| |++version|string||是|键盘固件版本| |++model|int||是|键盘型号| |++voltage|double||是|键盘电量(待键盘修改成百分比)| @@ -4112,12 +4119,14 @@ WebSocket方式应用与SDK建立长连接后,通过WebSocket接口发送接 "baseSn":"2024061101", "data":[{ "keySn":"1234567890", + "keyId":1, "version":"1.0.0", "model":67, "voltage":2.8, "offTime":30 },{ "keySn":"1234567891", + "keyId":2, "version":"1.0.0", "model":67, "voltage":2.8,