# pig-house-controller

## LoRa通信协议约定

本项目中的LoRa通信采用自定义的帧格式，以支持精确寻址和大数据包的自动分片与重组。所有数据包均由主控节点主动发起。

### 1. 物理帧结构

每个通过LoRa UART模块发送的物理数据包都遵循以下结构：

| 字段                       | 长度 (字节) | 值 (Hex)          | 描述                            |
|:-------------------------| :------------ | :---------------- |:------------------------------|
| **帧头 (Header)**          | 1             | `0xED`            | 固定值，表示一个数据包的开始。               |
| **数据长度 (Length)**        | 1             | `0x00`-`0xFF`     | 从`总包数`字段到`数据块`末尾的总字节数，不包含源地址。 |
| **目标地址 (DestAddr)**      | 2             | `0x0000`-`0xFFFF` | 接收该数据包的设备地址。                  |
| **总包数 (TotalChunks)**    | 1             | `0x01`-`0xFF`     | 表示当前消息被分成了几个包。`0x01`代表这是唯一的包。 |
| **当前包序号 (CurrentChunk)** | 1             | `0x00`-`0xFE`     | 当前是第几个数据包（从0开始计数）。            |
| **数据块 (ChunkData)**      | N             | -                 | 实际传输的数据片段。                    |
| **源地址 (SourceAddr)**      | 2             | `0x0000`-`0xFFFF` | 发送该数据包的设备地址,由硬件自动拼接。          |

**示例:**

发送一个数据为 `[0x01, 0x02, 0x03]` 的单包消息到地址 `0x1234`，发送方地址为 `0x5678`：
`ED 05 12 34 01 00 01 02 03 56 78`
- `ED`: 帧头
- `05`: 后续长度 (1+1+3 = 5)
- `12 34`: 目标地址
- `01`: 总包数 (共1包)
- `00`: 当前包序号 (第0包)
- `01 02 03`: 数据块
- `56 78`: 源地址

### 2. 数据分片 (Fragmentation)

- LoRa模块的物理层限制单次发送的数据部分**最大为240字节**。
- 根据项目约定，为自定义协议头（总包数、当前包序号）预留2字节，地址由模块处理。
- 因此，每个物理包中 **`数据块 (ChunkData)` 的最大长度为 `238` 字节**。
- `send_packet` 方法会自动处理分片逻辑。

### 3. 数据重组 (Reassembly)

- `receive_packet` 方法会缓存收到的分片。
- 当一个设备的所有分片都接收完毕后，`receive_packet` 会将它们自动重组成一个完整的消息，并向上层返回。
- 由于通信是单向的（仅主控发送），接收端无需管理多个源地址的重组缓冲区。