pig/pig-house-controller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新协议

Browse Source
This commit is contained in:
huang
2025-10-10 14:36:26 +08:00
parent 5f81314540
commit c3d4531870
1 changed files with 13 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
README.md
View File

@@ -8,25 +8,27 @@
每个通过LoRa UART模块发送的物理数据包都遵循以下结构： 每个通过LoRa UART模块发送的物理数据包都遵循以下结构：
| 字段 | 长度 (字节) | 值 (Hex) | 描述 | | 字段 | 长度 (字节) | 值 (Hex) | 描述 |
| :-------------------- | :------------ | :---------------- | :--------------------------------------------- | |:-------------------------| :------------ | :---------------- | :--------------------------------------------- |
| **帧头 (Header)** | 1 | `0xED` | 固定值，表示一个数据包的开始。 | | **帧头 (Header)** | 1 | `0xED` | 固定值，表示一个数据包的开始。 |
| **后续长度 (Length)** | 1 | `0x00`-`0xFF` | 从`总包数`字段到`数据块`末尾的总字节数。 | | **数据长度 (Length)** | 1 | `0x00`-`0xFF` | 从`总包数`字段到`数据块`末尾的总字节数，不包含源地址。 |
| **目标地址 (DestAddr)** | 2 | `0x0000`-`0xFFFF` | 接收该数据包的设备地址。 | | **目标地址 (DestAddr)** | 2 | `0x0000`-`0xFFFF` | 接收该数据包的设备地址。 |
| **总包数 (TotalChunks)**| 1 | `0x01`-`0xFF` | 表示当前消息被分成了几个包。`0x01`代表这是唯一的包。 | | **总包数 (TotalChunks)** | 1 | `0x01`-`0xFF` | 表示当前消息被分成了几个包。`0x01`代表这是唯一的包。 |
| **当前包序号 (CurrentChunk)**| 1 | `0x00`-`0xFE` | 当前是第几个数据包（从0开始计数）。 | | **当前包序号 (CurrentChunk)** | 1 | `0x00`-`0xFE` | 当前是第几个数据包（从0开始计数）。 |
| **数据块 (ChunkData)** | N | - | 实际传输的数据片段。 | | **数据块 (ChunkData)** | N | - | 实际传输的数据片段。 |
| **源地址 (SourceAddr)** | 2 | `0x0000`-`0xFFFF` | 发送该数据包的设备地址。 |
**示例:** **示例:**
发送一个数据为 `[0x01, 0x02, 0x03]` 的单包消息到地址 `0x1234`： 发送一个数据为 `[0x01, 0x02, 0x03]` 的单包消息到地址 `0x1234`，发送方地址为 `0x5678`：
`ED 05 12 34 01 00 01 02 03` `ED 05 12 34 01 00 01 02 03 56 78`
- `ED`: 帧头 - `ED`: 帧头
- `05`: 后续长度 (1+1+3 = 5) - `05`: 后续长度 (1+1+3 = 5)
- `12 34`: 目标地址 - `12 34`: 目标地址
- `01`: 总包数 (共1包) - `01`: 总包数 (共1包)
- `00`: 当前包序号 (第0包) - `00`: 当前包序号 (第0包)
- `01 02 03`: 数据块 - `01 02 03`: 数据块
- `56 78`: 源地址
### 2. 数据分片 (Fragmentation) ### 2. 数据分片 (Fragmentation)
@@ -39,4 +41,4 @@
- `receive_packet` 方法会缓存收到的分片。 - `receive_packet` 方法会缓存收到的分片。
- 当一个设备的所有分片都接收完毕后，`receive_packet` 会将它们自动重组成一个完整的消息，并向上层返回。 - 当一个设备的所有分片都接收完毕后，`receive_packet` 会将它们自动重组成一个完整的消息，并向上层返回。
- 由于通信是单向的（仅主控发送），接收端无需管理多个源地址的重组缓冲区。 - 由于通信是单向的（仅主控发送），接收端无需管理多个源地址的重组缓冲区。