From fdfbc1520e1240bfdd603ae3c1264758ff9119e8 Mon Sep 17 00:00:00 2001
From: liuqin <lydia@psunsky.com>
Date: Thu, 24 Jul 2025 10:14:34 +0800
Subject: [PATCH] 增加写键盘OEM型号名称的接口

---
 通讯协议-平台化-应用部分[内部].md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 67 insertions(+), 1 deletion(-)

diff --git a/通讯协议-平台化-应用部分[内部].md b/通讯协议-平台化-应用部分[内部].md
index 27ec1d5..9651a3e 100644
--- a/通讯协议-平台化-应用部分[内部].md
+++ b/通讯协议-平台化-应用部分[内部].md
@@ -32,7 +32,7 @@ SunVote 二次开发<br>通讯协议
 <br>
 <br>
 <div  style="text-align: center;font-size: 30px;">
-Ver 1.0.9
+Ver 1.0.10
 </div>
 <br>
 <br>
@@ -76,6 +76,7 @@ Ver 1.0.9
 |1.0.7| 2025年6月24日|刘琴|1. 增加自定义科目名称和清除科目名称<br>2. 增加控制键盘灯光、震动、蜂鸣(T2)<br>3. 增加空闲标题下发(T2)<br>4. 增加下发和清除分数(T2)|
 |1.0.8| 2025年7月8日|刘琴|1. 增加读写基站MAC地址(内部)|
 |1.0.9| 2025年7月17日|刘琴|1. 基站自检项增加字库检测<br>2. 键盘扫描指令增加键盘id返回<br>3. 修改设置键盘ID和返回事件为外部指令|
+|1.0.10| 2025年7月24日|刘琴|1. 增加写键盘OEM型号名称|
 
 <br>
 <br>
@@ -263,6 +264,7 @@ WebSocket方式应用与SDK建立长连接后，通过WebSocket接口发送接�
 |交互设置 - 用户内置状态语|<font color="red">设置用户内置状态语(内)</font>|[setKpUserStbMsg](#setkpuserstbmsg)|[fEvtKpUserStbMsg](#fevtkpuserstbmsg)|
 |<font color="red">识别设置 - 出厂编码(内)|<font color="red">设置键盘出厂编码(内)|[setKpSN](#setkpsn)|[fEvtSetKpSN](#fevtsetkpsn)<br>|
 |识别设置 - 键盘编号|设置键盘编号|[setKpID](#setkpid)|[fEvtSetKpID](#fevtsetkpid)|
+|<font color="red">识别设置 - OEM型号名称(内)|<font color="red">设置键盘OEM型号名称(内)</font>|[setKpOemModel](#setkpoemmodel)|[sEvtStateCode](#sevtstatecode)<br>[fEvtSetKpOemModel](#fevtsetkpoemmodel)|
 |<font color="red">识别设置 - 键盘信息(内)|<font color="red">开始获取键盘信息(内)|[startGetKpInfo](#setkpid)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpInfo](#fevtkpinfo)|
 ||<font color="red">停止获取键盘信息(内)|[stopGetKpInfo](#setkpid)|[sEvtStateCode](#sevtstatecode)|
 |在线状态获取|开启扫描在线键盘|[startGetKpOnline](#startgetkponline)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpOnlineMsg](#fevtkponlinemsg)|
@@ -3496,6 +3498,33 @@ WebSocket方式应用与SDK建立长连接后，通过WebSocket接口发送接�
 }
 ```
 
+##### setKpOemModel
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
+- **功能描述**：设置键盘OEM定制型号名称
+- **参数说明**
+
+|参数名|类型|限制|是否必填|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|baseSn|string||是|基站的出厂编码|
+|data|object|-|是|传送参数的对象|
+|+keySns|array||否|需要执行指令的键盘SN数组，空数组表示所有键盘|
+|+value|string||是|OEM定制型号名称，不超过16个字符|
+
+- **示例代码**
+```json
+{
+  "fun":"setKpOemModel",
+  "dataTag":"1",
+  "baseSn":"2024061101",
+  "data":{
+    "keySns":[],
+    "value":"S5"
+  }
+}
+```
+
 ##### startGetKpInfo
 - **主题**：<sapn class="yellowFill">/manage/{baseSN}/send</span>
 - **功能描述**：开始获取键盘信息
@@ -3596,6 +3625,43 @@ WebSocket方式应用与SDK建立长连接后，通过WebSocket接口发送接�
 }
 ```
 
+##### fEvtSetKpOemModel
+- **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
+- **功能描述**：返回写键盘OEM型号名称的状态
+- **参数说明**
+
+|参数名|类型|限制|非空|说明|
+|---|---|---|---|---|
+|fun|string|-|是|指令名称|
+|dataTag|string|-|否|数据包标识,可为空字符串|
+|baseSn|string||是|基站的出厂编码|
+|data|array|-|是|传送参数的对象数组|
+|++keySn|string||是|设置的键盘SN|
+|++state|string||是|设置的OEM型号名称是否成功<br>0 - 成功<br>1 - 超时失败<br>2 - 参数错误|
+
+- **示例代码**
+```json
+{
+  "fun":"fEvtSetKpOemModel",
+  "dataTag":"1",
+  "baseSn":"2024061101",
+  "data": [
+    {
+      "keySn": "1479824643",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824645",
+      "state": "0"
+    },
+    {
+      "keySn": "1479824644",
+      "state": "1"
+    }
+  ]
+}
+```
+
 ##### fEvtKpInfo
 - **主题**：<sapn class="yellowFill">/manage/{baseSN}/receive</span>
 - **功能描述**：返回键盘信息
--
libgit2 0.21.4