增加表决功能的相关接口，暂只有三键表决，适配M5

刘琴
1 parent f552a473
Showing 1 changed file with 84 additions and 1 deletions
通讯协议-平台化-应用部分[内部].md
@@ -32,7 +32,7 @@ SunVote äºŒæ¬¡å¼€å‘&lt;br&gt;é€šè®¯åè®®
 <br>
 <br>
 <div  style="text-align: center;font-size: 30px;">
-Ver 1.0.10
+Ver 1.0.11
 </div>
 <br>
 <br>
@@ -77,6 +77,7 @@ Ver 1.0.10
 |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åž‹å·åç§°|
+|1.0.11| 2025å¹´7æœˆ30æ—¥|åˆ˜ç´|1. å¢žåŠ è¡¨å†³åŠŸèƒ½(æš‚åªæœ‰ä¸‰é”®è¡¨å†³)|
 <br>
 <br>
@@ -304,6 +305,8 @@ WebSocketæ–¹å¼åº”ç”¨ä¸ŽSDKå»ºç«‹é•¿è¿žæŽ¥åŽï¼Œé€šè¿‡WebSocketæŽ¥å£å‘é€æŽ¥æ”
 |æ–‡æœ¬é¢˜|å¯åŠ¨æ–‡æœ¬é¢˜ç”é¢˜|[startQAEText](#startqaetext)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAEText](#fevtqaetext)|
 ||åœæ¢æ–‡æœ¬é¢˜ç”é¢˜|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
 |çŸæ¶ˆæ¯|å‘é€çŸæ¶ˆæ¯|[sendKpMsg](#sendkpmsg)|[sEvtStateCode](#sevtstatecode)<br>[fEvtKpMsg](#fevtkpmsg)|
+|è¡¨å†³|å¯åŠ¨è¡¨å†³|[startQAVote](#startqavote)|[sEvtStateCode](#sevtstatecode)<br>[fEvtQAVote](#fevtqavote)|
+||åœæ¢è¡¨å†³|[stopKpVote](#stopkpvote)|[sEvtStateCode](#sevtstatecode)|
 |å¾…æœºå®žæ—¶åé¦ˆ|è®¾ç½®å¾…æœºå®žæ—¶åé¦ˆçŠ¶æ€|[setKpStbResponse](#setkpstbresponse)|[fEvtKpStbResponse](#fevtkpstbresponse)<br>[sEvtKpRtFeedback](#sevtkprtfeedback)<br>[sEvtKpHandUp](#sevtkphandup)|
 ||èŽ·å–å¾…æœºå®žæ—¶åé¦ˆçŠ¶æ€|[getKpStbResponse](#getkpstbresponse)|[fEvtKpStbResponse](#fevtkpstbresponse)|
 ### è¯éŸ³åé¦ˆ
@@ -1445,6 +1448,7 @@ WebSocketæ–¹å¼åº”ç”¨ä¸ŽSDKå»ºç«‹é•¿è¿žæŽ¥åŽï¼Œé€šè¿‡WebSocketæŽ¥å£å‘é€æŽ¥æ”
     }
 }
 ```
+
 ##### fEvtBsCapacity
 - **ä¸»é¢˜**: /basestation/{baseSN}/receive
 - **åŠŸèƒ½æè¿°**ï¼šè¿”å›žåŸºç«™å®¹é‡
@@ -1469,6 +1473,7 @@ WebSocketæ–¹å¼åº”ç”¨ä¸ŽSDKå»ºç«‹é•¿è¿žæŽ¥åŽï¼Œé€šè¿‡WebSocketæŽ¥å£å‘é€æŽ¥æ”
     }
 }
 ```
+
 ##### fEvtBsChannel
 - **ä¸»é¢˜**: /basestation/{baseSN}/receive
 - **åŠŸèƒ½æè¿°**ï¼šè¿”å›žåŸºç«™ä¿¡é“
@@ -5310,6 +5315,84 @@ WebSocketæ–¹å¼åº”ç”¨ä¸ŽSDKå»ºç«‹é•¿è¿žæŽ¥åŽï¼Œé€šè¿‡WebSocketæŽ¥å£å‘é€æŽ¥æ”
 }
 ```
+### è¡¨å†³
+#### æ–¹æ³•
+##### startQAVote
+- **ä¸»é¢˜**ï¼š/client/{baseSN}/send
+- **åŠŸèƒ½æè¿°**ï¼šå¯åŠ¨è¡¨å†³
+- **å‚æ•°è¯´æ˜Ž**
+
+|å‚æ•°å|ç±»åž‹|é™åˆ¶|æ˜¯å¦å¿…å¡«|è¯´æ˜Ž|
+|---|---|---|---|---|
+|fun|string|-|æ˜¯|æŒ‡ä»¤åç§°|
+|dataTag|string|-|å¦|æ•°æ®åŒ…æ ‡è¯†,å¯ä¸ºç©ºå—ç¬¦ä¸²|
+|baseSn|string||æ˜¯|åŸºç«™çš„å‡ºåŽ‚ç¼–ç |
+|data|object|-|æ˜¯|ä¼ é€å‚æ•°çš„å¯¹è±¡|
+|+keySns|array||æ˜¯|æŒ‡å®šçš„é”®ç›˜SNæ•°ç»„ï¼Œç©ºæ•°ç»„è¡¨ç¤ºå…¨éƒ¨åœ¨çº¿é”®ç›˜|
+|+mode|int||æ˜¯|1 - èµžæˆ/åå¯¹/å¼ƒæƒ|
+|+allowModify|int||æ˜¯|0 - ä¸å…è®¸ä¿®æ”¹<br>1 - å…è®¸ä¿®æ”¹|
+|+isSecrecy|int||æ˜¯|0 - ä¸ä¿å¯†<br>1 - ä¿å¯†|
+|+tip|string||å¦|æç¤ºçš„æ ‡é¢˜ï¼Œé•¿åº¦ä¸è¶…è¿‡16å—ç¬¦|
+|+simParams|object||å¦|å†…éƒ¨æ¨¡æ‹Ÿæµ‹è¯•å‚æ•°è®¾ç½®å¯¹è±¡|
+|++answer|string||æ˜¯|é¢„è®¾æäº¤çš„æŒ‰é”®å€¼<br>1-å¯¹ <br>2-é”™|
+
+- **ç¤ºä¾‹ä»£ç **
+
+```json
+{
+  "fun":"startQAVote",
+  "dataTag":"1",
+  "baseSn":"2024061101",
+  "data":{
+    "keySns":[],
+    "mode":1,
+    "allowModify":1,
+    "isSecrecy":0,
+    "tip":"è¯·æŒ‰é”®è¡¨å†³"
+  }
+}
+```
+
+##### [stopKpVote](#stopkpvote)
+åœæ¢åˆ¤æ–é¢˜ç”é¢˜
+
+#### äº‹ä»¶
+##### [sEvtStateCode](#sevtstatecode)
+å‘é€æŒ‡ä»¤åŽè¿”å›žæŽ¥æ”¶çŠ¶æ€
+
+##### fEvtQAVote
+- **ä¸»é¢˜**ï¼š/basestation/{baseSN}/receive
+- **åŠŸèƒ½æè¿°**ï¼šè¿”å›žé”®ç›˜æäº¤è¡¨å†³ä¿¡æ¯
+- **å‚æ•°è¯´æ˜Ž**
+
+|å‚æ•°å|ç±»åž‹|é™åˆ¶|éžç©º|è¯´æ˜Ž|
+|---|---|---|---|---|
+|fun|string|-|æ˜¯|æŒ‡ä»¤åç§°|
+|dataTag|string|-|å¦|æ•°æ®åŒ…æ ‡è¯†,å¯ä¸ºç©ºå—ç¬¦ä¸²|
+|baseSn|string||æ˜¯|åŸºç«™çš„å‡ºåŽ‚ç¼–ç |
+|data|array|-|æ˜¯|ä¼ é€å‚æ•°çš„å¯¹è±¡æ•°ç»„|
+|++keySn|string||æ˜¯|é”®ç›˜SN|
+|++keyValue|string||æ˜¯|é”®ç›˜æäº¤çš„æŒ‰é”®å€¼<br>1-èµžæˆ<br>2-åå¯¹<br>3-å¼ƒæƒ|
+|++keyTime|double||æ˜¯|ç”é¢˜æ—¶é—´ï¼Œä»Žå¯åŠ¨å¼€å§‹è®¡ç®—ï¼Œå•ä½æ¯«ç§’|
+|++voltage|double||æ˜¯|é”®ç›˜ç”µé‡|
+|++retryCount|int||æ˜¯|é”®ç›˜æäº¤æ•°æ®çš„é‡å‘æ¬¡æ•°|
+
+- **ç¤ºä¾‹ä»£ç **
+
+```json
+{
+  "fun":"fEvtQAVote",
+  "dataTag":"1",
+  "baseSn":"2024061101",
+  "data": [{
+      "keySn": "1234567890",
+      "keyValue":"1",
+      "keyTime":2300
+    }
+  ]
+}
+```
+
 ### å¾…æœºå®žæ—¶åé¦ˆ
 #### æ–¹æ³•
 ##### setKpStbResponse