初始提交
This commit is contained in:
@@ -0,0 +1,67 @@
|
||||
# UDP大数据包发送模块
|
||||
|
||||
## 功能描述
|
||||
|
||||
`udpSendBigPacket` 函数用于将大数据包(最大60KB)拆分成多个小包发送。每个小包的有效载荷最大为1024字节,包含包头信息。
|
||||
|
||||
## 包头结构
|
||||
|
||||
每个发送的包都包含以下包头信息:
|
||||
|
||||
```c
|
||||
typedef struct {
|
||||
uint16_t magic; // 魔数 (0xAA55)
|
||||
uint16_t total_size; // 总数据大小
|
||||
uint32_t big_packet_id; // 大包ID,32位随机整数,用于区分不同的大包
|
||||
uint16_t packet_id; // 包序号 (0, 1, 2, ...)
|
||||
uint16_t total_packets; // 总包数
|
||||
uint16_t payload_len; // 当前包的有效载荷长度
|
||||
uint8_t reserved[2]; // 保留字段
|
||||
} udp_packet_header_t;
|
||||
```
|
||||
|
||||
## 使用示例
|
||||
|
||||
```c
|
||||
#include "udp.h"
|
||||
|
||||
// 准备要发送的数据
|
||||
uint8_t data[5000]; // 5KB数据
|
||||
// ... 填充数据 ...
|
||||
|
||||
// 发送大数据包
|
||||
int result = udpSendBigPacket(data, 5000, "192.168.1.100", 8080);
|
||||
if (result >= 0) {
|
||||
printf("发送成功\n");
|
||||
} else {
|
||||
printf("发送失败,错误码: %d\n", result);
|
||||
}
|
||||
```
|
||||
|
||||
## 错误码说明
|
||||
|
||||
- `0`: 发送成功
|
||||
- `-1`: 参数错误(空指针、长度超出范围等)
|
||||
- `-2`: 内存分配失败
|
||||
- 其他负值: `udpSendTo` 函数返回的错误码
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. 函数会自动将数据拆分成多个包发送,无需手动处理
|
||||
2. 每个包都会包含完整的包头信息
|
||||
3. 第一包会指定总数据大小,便于接收端重组
|
||||
4. 函数不等待回复,采用异步发送方式
|
||||
5. 最大支持60KB的数据包
|
||||
6. 每个包的有效载荷最大1024字节
|
||||
7. 每个大包都有唯一的32位随机ID,用于区分并发传输的不同大包
|
||||
8. 大包ID使用 `rand()` 函数生成,确保唯一性
|
||||
|
||||
## 接收端处理
|
||||
|
||||
接收端需要:
|
||||
1. 检查魔数 (0xAA55)
|
||||
2. 根据 `big_packet_id` 区分不同的大包
|
||||
3. 根据 `total_size` 和 `total_packets` 分配缓冲区
|
||||
4. 按 `packet_id` 顺序重组数据
|
||||
5. 验证所有包是否接收完整
|
||||
6. 使用 `big_packet_id` 可以同时处理多个并发的大包传输
|
||||
Reference in New Issue
Block a user