Files
2026-08-24 15:49:57 +08:00
..
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00
2026-08-24 15:49:57 +08:00

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 函数返回的错误码

注意事项

  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 可以同时处理多个并发的大包传输