2025-04-22
更新历史
| 日期 | 版本 | 作者 | 更新内容 |
|---|---|---|---|
| 2025-04-22 | 0.1.0 | yono | 定义整体文档结构 |
整体协议结构
完全的简单应用层协议，以适应不同传输层接口。本协议不涉及验证和加密，应由更上层完成。
[!NOTE]
整个文档中涉及的数字均为 16 进制，不再添加 0x 或 h 指示。
整体单帧结构
| 事务号(2字节) | CMD(2字节) | 拓展信息(2字节) | 长度信息(大端2字节) | 消息(x字节) | 和校验(小端2字节) |
|---|---|---|---|---|---|
- 事务号：第一字节是累计的事务号(1~FF)，第二字节是其反码
- CMD：指示了应该使用哪个解析系统，对消息第 1 次分流
- 拓展信息：对 CMD 信息的拓展补充，可用于第 2 次解析分流，也可用于补充解析所需信息
- 长度信息：指示消息及和校验的总长。
- 消息：事实上需要处理的可变长消息
- 和校验：此前所有段的字节和，用于简单校验
事务号0专用于主动上报
通用回复表达
大部分请求不需要回复有效信息，仅需回复接收到了指令且执行成功，所以有通用的回复表达为。
| 事务号(2字节) | CMD(2字节) | 拓展信息(2字节) | 长度信息(大端2字节) | 消息(2字节) | 和校验(小端2字节) |
|---|---|---|---|---|---|
| 复制请求 | 复制请求 | 复制请求 | 00 04 | 见下方信息表 | 计算得到 |
消息为
- 00 00：成功执行
- 00 01：通用失败执行
- 00 10：当前状态忙，无法执行
- 00 11：当前状态禁止执行