初始提交

This commit is contained in:
2026-08-24 15:49:57 +08:00
commit 4569284de2
181 changed files with 246421 additions and 0 deletions
+67
View File
@@ -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` 可以同时处理多个并发的大包传输