STM32NET学习笔记 UDP部分

1.前言
嵌入式以太网开发是一个很有挑战性的工作。通过几个月的学习，我个人觉得大致有两条途径。第一条途径，先通过高级语言熟悉socket编程，例如C#或C++，对bind，listen，connect，accept等函数熟悉之后，应用 lwIP。第二种途径，通过分析嵌入式以太网代码，结合TCPIP协议栈规范逐步实践代码。第一种途径效率高，开发周期短，编写出来的代码性能稳定，第二种途径花的时间长，开发出来的代码功能不完善，但是由于紧紧结合TCPIP规范，可以了解的内容较多，适合学习。本文通过分析和修改AVRNET源码，逐步实现TCPIP协议栈的各个子部分，包括ETHERNET部分，ARP部分，IP部分，ICMP部分，UDP部分，TCP部分和HTTP部分。【 STM32NET学习笔记——索引】【代码仓库】
本文将实现UDP部分。

UDP协议全称为用户数据协议，是一种简单有效的运输协议。和以太网首部和IP首部相似，UDP首部也有自身的数据结构定义。从运输协议开始引入端口的概念，端口相当于一个应用程序的标识符。相对于TCP协议而言，UDP协议简单的多。本文将实现UDP协议，并通过几个简单的案例说明UDP的使用。

1.2 相关资料
【ENC28J60学习笔记】
【AVRNET项目(国外) 】
【AVR webserver项目(国外) 】

1.3 代码仓库
【代码仓库】——CSDN Code代码仓库。

2 UDP部分实现
UDP功能的实现可分为UDP首部填充，UDP缓冲区填充和UDP报文查询。UDP首部填充是一个按部就班的过程，即填充源端口、目标端口、长度和校验和。UDP缓冲区填充即往UDP负载部分逐个填充数据。UDP报文查询功能即匹配本机UDP端口号并进行函数处理。为了实现这些功能，首先需要以下宏定义。需要注意以太网传输协议中数据被以大端的形式保存，即低地址存放了高字节内容。

[cpp]
view plaincopy





// UDP默认端口号
#define UDP_AVR_PORT_V 3000
#define UDP_AVR_PORT_H_V (UDP_AVR_PORT_V>>8)
#define UDP_AVR_PORT_L_V (UDP_AVR_PORT_V&0xff)
// 源端口
#define UDP_SRC_PORT_H_P 0x22
#define UDP_SRC_PORT_L_P 0x23
// 目标端口
#define UDP_DST_PORT_H_P 0x24
#define UDP_DST_PORT_L_P 0x25
// UDP负载长度
#define UDP_LENGTH_H_P 0x26
#define UDP_LENGTH_L_P 0x27
// UDP校验和
#define UDP_CHECKSUM_H_P 0x28
#define UDP_CHECKSUM_L_P 0x29
// UDP负载起始地址
#define UDP_DATA_P 0x2A

2.1 UDP首部填充
UDP首部填充中需要明确UDP的端口号，STMNET项目中通过常数宏定义实现。

[cpp]
view plaincopy





#define UDP_AVR_PORT_V 3000
#define UDP_AVR_PORT_H_V (UDP_AVR_PORT_V>>8)
#define UDP_AVR_PORT_L_V (UDP_AVR_PORT_V&0xff)

从这段代码中可以看出，STMNET的UDP端口号为3000。

[cpp]
view plaincopy





void udp_generate_header ( BYTE *rxtx_buffer, WORD_BYTES dest_port, WORD_BYTES length )
{
WORD_BYTES ck;

// 默认端口号 3000
rxtx_buffer[UDP_SRC_PORT_H_P] = UDP_AVR_PORT_H_V;
rxtx_buffer[UDP_SRC_PORT_L_P] = UDP_AVR_PORT_L_V;

// 目标端口地址
rxtx_buffer[UDP_DST_PORT_H_P] = dest_port.byte.high;
rxtx_buffer[UDP_DST_PORT_L_P] = dest_port.byte.low;

// 负载长度
rxtx_buffer[UDP_LENGTH_H_P] = length.byte.high;
rxtx_buffer[UDP_LENGTH_L_P] = length.byte.low;

// 计算校验和
rxtx_buffer[UDP_CHECKSUM_H_P] = 0;
rxtx_buffer[UDP_CHECKSUM_L_P] = 0;
// length+8 for source/destination IP address length (8-bytes)
ck.word = software_checksum ( (BYTE*)&rxtx_buffer[IP_SRC_IP_P], length.word+8, length.word+IP_PROTO_UDP_V);
rxtx_buffer[UDP_CHECKSUM_H_P] = ck.byte.high;
rxtx_buffer[UDP_CHECKSUM_L_P] = ck.byte.low;
}

2.2 UDP负载长度查询
UDP首部中包含UDP长度描述字节，长度占有两个字节并以大端格式保存，由于宏定义的提示作用，弱化了大端格式的影响。长度中也包括了UDP首部的长度，UDP首部的长度为固定的8字节。

[cpp]
view plaincopy





WORD udp_get_dlength( BYTE *rxtx_buffer )
{
WORD length = 0;
// 获得UDP长度
length = rxtx_buffer[UDP_LENGTH_H_P] << 8 | rxtx_buffer[UDP_LENGTH_L_P];
// 去除首部长度
length = length - 8;

return length;
}

2.3 UDP负载区填充
UDP负载去填充即在UDP首部之后填充有用的数据。在这段真实负载之前包括了UDP首部，IP首部和以太网首部，分别占用了8字节，20字节和14字节。UDP负载的起始地址通过宏由UDP_DATA_P定义。

[cpp]
view plaincopy





WORD udp_puts_data ( BYTE *rxtx_buffer, BYTE *data, WORD offset )
{
while(*data)
{
rxtx_buffer[UDP_DATA_P + offset] = *data++;
offset++;
}
return offset;
}

2.4 UDP报文查询
UDP报文查询需要匹配接收数据包中的UDP端口号，若匹配成功则可对输入数据包进行处理，这些处理包括解析数据包格式，分析出控制命令或查询命令。也可以通过udp_puts_data向发送缓冲区中填写响应数据。接着逐步生成以太网首部，IP首部和UDP首部，以太网首部中包含目标MAC地址，IP首部中包含目标IP地址，UDP首部中包含目标端口号。

[cpp]
view plaincopy





BYTE udp_receive ( BYTE *rxtx_buffer, BYTE *dest_mac, BYTE *dest_ip )
{
WORD dlength = 0;
// udp负载长度
WORD udp_loadlen = 0;

// 匹配UDP协议 UDP端口号
if ( rxtx_buffer[IP_PROTO_P] == IP_PROTO_UDP_V && rxtx_buffer[UDP_DST_PORT_H_P] == UDP_AVR_PORT_H_V && rxtx_buffer[ UDP_DST_PORT_L_P ] == UDP_AVR_PORT_L_V )
{
// 获得UDP负载长度
udp_loadlen = udp_get_dlength(rxtx_buffer);

// 复制UDP接收
memcpy(udp_recbuf, (char*)&rxtx_buffer[UDP_DATA_P], udp_loadlen);

#if UDP_DEBUG
printf("UDP Message!\r\n");
printf("Send Form:%d.%d.%d.%d ",\
rxtx_buffer[IP_SRC_IP_P+0],rxtx_buffer[IP_SRC_IP_P+1],\
rxtx_buffer[IP_SRC_IP_P+2],rxtx_buffer[IP_SRC_IP_P+3]);
printf("Port:%d\r\n",(rxtx_buffer[UDP_SRC_PORT_H_P] << 8) | rxtx_buffer[UDP_SRC_PORT_L_P]);
printf("Reccive:%s\r\n",udp_recbuf);
#endif

// 生成以太网首部
eth_generate_header(rxtx_buffer, (WORD_BYTES){ETH_TYPE_IP_V}, dest_mac );
// 生成IP首部
ip_generate_header(rxtx_buffer, (WORD_BYTES){sizeof(IP_HEADER)+sizeof(UDP_HEADER)+dlength}, IP_PROTO_UDP_V, dest_ip );
// 生成UDP首部
udp_generate_header(rxtx_buffer, (WORD_BYTES){(rxtx_buffer[UDP_SRC_PORT_H_P]<<8)|rxtx_buffer[UDP_SRC_PORT_L_P]}, (WORD_BYTES){sizeof(UDP_HEADER)+dlength});
// 发送所有首部和UDP负载数据
enc28j60_packet_send(rxtx_buffer, sizeof(ETH_HEADER)+sizeof(IP_HEADER)+sizeof(UDP_HEADER)+dlength );

// 返回1代表数据包已被处理
return 1;
}

// 返回0代表数据包未被处理
return 0;
}

3 实验
实验部分主要是为了验证UDP协议，通过PC机上的网络调试软件开辟一个PC机的UDP端口，假定端口号为3001；STMNET的UDP默认端口号为3000，IP地址为192.168.1.115。

3.1 程序结构
在运行UDP程序之前，需要运行ARP，IP和ICMP各部分，并保存发起发的MAC地址和IP地址。

[cpp]
view plaincopy





// 获得新的IP报文
plen = enc28j60_packet_receive( (BYTE*)&rxtx_buffer, MAX_RXTX_BUFFER );
if(plen==0) return;

// 保存客服端的MAC地址
memcpy ( (BYTE*)&client_mac, &rxtx_buffer[ ETH_SRC_MAC_P ], sizeof( MAC_ADDR) );
// 检查该报文是不是ARP报文
if ( arp_packet_is_arp( rxtx_buffer, (WORD_BYTES){ARP_OPCODE_REQUEST_V} ) )
{
// 向客户端返回ARP报文
arp_send_reply ( (BYTE*)&rxtx_buffer, (BYTE*)&client_mac );
return;
}

// 保存客服端的IP地址
memcpy ( (BYTE*)&client_ip, &rxtx_buffer[ IP_SRC_IP_P ], sizeof(IP_ADDR) );
// 检查该报文是否为IP报文
if ( ip_packet_is_ip ( (BYTE*)&rxtx_buffer ) == 0 )
{
return;
}

// 如果是ICMP报文 向发起方返回数据
if ( icmp_send_reply ( (BYTE*)&rxtx_buffer, (BYTE*)&client_mac, (BYTE*)&client_ip ) )
{
return;
}

// 进行UDP处理
if (udp_receive ( (BYTE *)&rxtx_buffer, (BYTE *)&client_mac, (BYTE *)&client_ip ))
{
return;
}

3.2 源IP和源端口
在udp_receive函数中需判断UDP端口号和目标IP地址是否匹配。若匹配则先获得UDP的负载长度，使用memcpy命令复制到udp_recbuf中，接着通过串口打印源IP地址（位于IP首部），源端口号（UDP首部）。

[cpp]
view plaincopy





// 获得UDP负载长度
udp_loadlen = udp_get_dlength(rxtx_buffer);
// 复制UDP接收
memcpy(udp_recbuf, (char*)&rxtx_buffer[UDP_DATA_P], udp_loadlen);
#if UDP_DEBUG
printf("UDP Message!\r\n");
printf("Send Form:%d.%d.%d.%d ",\
rxtx_buffer[IP_SRC_IP_P+0],rxtx_buffer[IP_SRC_IP_P+1],\
rxtx_buffer[IP_SRC_IP_P+2],rxtx_buffer[IP_SRC_IP_P+3]);
printf("Port:%d\r\n",(rxtx_buffer[UDP_SRC_PORT_H_P] << 8) | rxtx_buffer[UDP_SRC_PORT_L_P]);
printf("Reccive:%s\r\n",udp_recbuf);
#endif



图1 网络调试助手

网络调试助手使用时，先设定协议类型为【UDP】，并修改本机端口号改为【3001】，点击【连接】。然后修改目标IP地址【192.168.1.115】，目标端口号改为【3000】，最后填入数据点击【发送】。



图2 UDP调试输出结果
可以看出，PC机先发送UDP命令之前先发送了一个ARP请求，找出AVR的MAC地址，接着发送UDP数据包。这个实验可以验证UDP接收数据包正确。

3.3 返回Hello UDP
接着稍微修改程序，接收到UDP数据包之后，在负载数据之前加入Hello字符，如果输入为xukai871105，则返回Hello xukai871105。可以通过网络调试助手看到返回结果。使用strcpy函数把Hello复制到udp_sendbuf数组中，接着使用strcat把udp_recbuf中的字符串连接到udp_sendbuf之后，最后调用udp_puts_date填充到发送缓冲区中，udp_puts_date的最后一个参数为UDP负载缓冲区的起始字节，第一次填入时应使用0。

[cpp]
view plaincopy





#if UDP_ECHO
// Hello 范例
// 复制Hello
strcpy(udp_sendbuf,"UDP:Hello ");
// 连接数据
strcat(udp_sendbuf, udp_recbuf);
dlength = udp_puts_data(rxtx_buffer, (BYTE*)udp_sendbuf, 0);
#endif



图3 UDP Hello Echo测试结果
通过前面两个实验可以证明UDP的接收和发送工作正常。

3.4 LED控制
验证了UDP的发送和接收，可以通过定义一组指令实现LED的控制。
led,x,y
x表示LED编号，取值范围为1或2
y表示LED状态，1为打开，2为关闭

具体代码如下：

[cpp]
view plaincopy





#if UDP_LEDCTRL
int match_count = 0;
int led_index = 0;
int led_status = 0;
// 匹配led,x,y
match_count = sscanf(udp_recbuf,"led,%d,%d", &led_index, &led_status);
if(match_count == 2)
{
switch(led_index)
{
case 1:
led_status?BSP_LEDOn(1):BSP_LEDOff(1);
dlength = udp_puts_data(rxtx_buffer, (BYTE*)"LED1 Control OK\r\n", 0);
break;
case 2:
led_status?BSP_LEDOn(2):BSP_LEDOff(2);
dlength = udp_puts_data(rxtx_buffer, (BYTE*)"LED2 Control OK\r\n", 0);
break;
default:
dlength = udp_puts_data(rxtx_buffer, (BYTE*)"Invalid Led Index\r\n", 0);
break;
}
}
else
{
dlength = udp_puts_data(rxtx_buffer, (BYTE*)"unknow command\r\n", 0);
}
#endif



图4 通过UDP控制LED
4总结
UDP是一个非常简答有效的协议。研究完UDP协议之后便可研究分析TCP协议，在熟悉的TCP协议的基础上才可实践HTTP制作WEB网页。使用嵌入式实践WEB服务器之前还需要练习静态网页动态网页的制作方法，熟悉HTTP请求格式等等工作。