Commit 8317eb3b7e382b7ca5573e3367675453dcb7db0c
1 parent
a7145c62
增加指令拆分说明,约定单条指令长度不超过2K
Showing
2 changed files
with
11 additions
and
4 deletions
通讯协议-B200W-MQTT协议[内部].md
| ... | ... | @@ -55,6 +55,7 @@ |
| 55 | 55 | ## 数据格式约定 |
| 56 | 56 | - 数据格式统一为**Json**格式,MQTT发送接收消息编码统一为**UTF-8** |
| 57 | 57 | - Json通用格式如下: |
| 58 | + | |
| 58 | 59 | ```json |
| 59 | 60 | { |
| 60 | 61 | "fun":"xxx", |
| ... | ... | @@ -64,6 +65,9 @@ |
| 64 | 65 | } |
| 65 | 66 | } |
| 66 | 67 | ``` |
| 68 | + | |
| 69 | +<font color="red">注意:基站接收指令数据单次不超过2K长度,在指定键盘发送指令时,如果指令长度超出限制,建议将指令进行拆分,分次发送,如果是所有键盘执行的指令,可将keySns设为空数组不使用指定键盘的模式</font> | |
| 70 | + | |
| 67 | 71 | |参数 |说明 |约束| |
| 68 | 72 | |---|---|---| |
| 69 | 73 | |fun| 指令或事件名称|| |
| ... | ... | @@ -2331,7 +2335,7 @@ |
| 2331 | 2335 | ``` |
| 2332 | 2336 | ##### rtKpAllowEdited |
| 2333 | 2337 | - **主题**:/client/\${baseSN}/send |
| 2334 | -- **功能描述**:键盘键盘后,允许键盘修改答案 | |
| 2338 | +- **功能描述**:键盘提交后,允许键盘修改答案 | |
| 2335 | 2339 | - **参数说明** |
| 2336 | 2340 | |
| 2337 | 2341 | |参数名|类型|限制|是否必填|说明| |
| ... | ... | @@ -2392,7 +2396,7 @@ |
| 2392 | 2396 | |---|---|---|---|---| |
| 2393 | 2397 | |fun|string|-|是|指令名称| |
| 2394 | 2398 | |dataTag|string|-|否|数据包标识,可为空字符串| |
| 2395 | -|data|object|-|是|传送参数的对象数组| | |
| 2399 | +|data|array|-|是|传送参数的对象数组| | |
| 2396 | 2400 | |++keySn|string||是|键盘SN| |
| 2397 | 2401 | |++keyValue|string||是|0 - 未提交(修改键盘运行提交时上报)<br>1 - 已交卷| |
| 2398 | 2402 | |++keyTime|double||是|提交时间,从启动开始计算,单位秒| | ... | ... |
通讯协议-B200W-MQTT协议[外].md
| ... | ... | @@ -58,12 +58,15 @@ |
| 58 | 58 | } |
| 59 | 59 | } |
| 60 | 60 | ``` |
| 61 | + | |
| 61 | 62 | |参数 |说明 |约束| |
| 62 | 63 | |---|---|---| |
| 63 | 64 | |fun| 指令或事件名称|| |
| 64 | 65 | |dataTag| 数据标签,用于对应收发数据|长度不超过4,可为0-9a-zA-Z的组合| |
| 65 | 66 | |data| 数据内容|对象或者数组,可为空| |
| 66 | 67 | |
| 68 | +<font color="red">注意:基站接收指令数据单次不超过2K长度,在指定键盘发送指令时,如果指令长度超出限制,建议将指令进行拆分,分次发送,如果是所有键盘执行的指令,可将keySns设为空数组不使用指定键盘的模式</font> | |
| 69 | + | |
| 67 | 70 | |
| 68 | 71 | ## 功能速查一览表 |
| 69 | 72 | ### 基站管理 |
| ... | ... | @@ -1725,7 +1728,7 @@ |
| 1725 | 1728 | ``` |
| 1726 | 1729 | ##### rtKpAllowEdited |
| 1727 | 1730 | - **主题**:/client/\${baseSN}/send |
| 1728 | -- **功能描述**:键盘键盘后,允许键盘修改答案 | |
| 1731 | +- **功能描述**:键盘提交后,允许键盘修改答案 | |
| 1729 | 1732 | - **参数说明** |
| 1730 | 1733 | |
| 1731 | 1734 | |参数名|类型|限制|是否必填|说明| |
| ... | ... | @@ -1786,7 +1789,7 @@ |
| 1786 | 1789 | |---|---|---|---|---| |
| 1787 | 1790 | |fun|string|-|是|指令名称| |
| 1788 | 1791 | |dataTag|string|-|否|数据包标识,可为空字符串| |
| 1789 | -|data|object|-|是|传送参数的对象数组| | |
| 1792 | +|data|array|-|是|传送参数的对象数组| | |
| 1790 | 1793 | |++keySn|string||是|键盘SN| |
| 1791 | 1794 | |++keyValue|string||是|0 - 未提交(修改键盘运行提交时上报)<br>1 - 已交卷| |
| 1792 | 1795 | |++keyTime|double||是|提交时间,从启动开始计算,单位秒| | ... | ... |