2.0 KiB
2.0 KiB
UDP大数据包发送模块
功能描述
udpSendBigPacket 函数用于将大数据包(最大60KB)拆分成多个小包发送。每个小包的有效载荷最大为1024字节,包含包头信息。
包头结构
每个发送的包都包含以下包头信息:
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;
使用示例
#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函数返回的错误码
注意事项
- 函数会自动将数据拆分成多个包发送,无需手动处理
- 每个包都会包含完整的包头信息
- 第一包会指定总数据大小,便于接收端重组
- 函数不等待回复,采用异步发送方式
- 最大支持60KB的数据包
- 每个包的有效载荷最大1024字节
- 每个大包都有唯一的32位随机ID,用于区分并发传输的不同大包
- 大包ID使用
rand()函数生成,确保唯一性
接收端处理
接收端需要:
- 检查魔数 (0xAA55)
- 根据
big_packet_id区分不同的大包 - 根据
total_size和total_packets分配缓冲区 - 按
packet_id顺序重组数据 - 验证所有包是否接收完整
- 使用
big_packet_id可以同时处理多个并发的大包传输