1.前言
最近半年的时间一直在学习应用嵌入式以太网。虽然学习的动机仅仅是玩玩,但是以太网真的深深吸引了我。这里我和各位分享一下uIP的使用经验,希望对大家有所帮助。uIP是一个简单好用的嵌入式网络协议栈,易于移植且消耗的内存空间较少,非常适合学习和使用。可以肯定的说uIP是嵌入式以太网学习的好起点,但不一定是终点。毫无疑问的说,uIP的功能远不如LwIP强大,但两者并没有孰优孰劣之分,uIP和LwIP的作者同为Adam Dunkels,LwIP在前uIP在后,uIP经过这几年的发展从IPV4迁移到IPV6,最终可以适用于无线传感网络。总的来说,uIP是一个很好的起点,学好uIP可以迁移到LwIP,也可以迁移到uIPV6。
下面稍微啰嗦一下,先推荐两本图书。本人喜欢读书,书中的论述比较完整,调理液清晰一些。
1.1推荐图书资料
《基于IP的物联网架构、技术与应用》。图书的作者之一adam dunkels为uIP和LwIP的作者,虽然uIP在书中只占非常小的一部分,但是这本书的信息量非常大,技术非常新颖。书中提到的PACHUBE即是在论坛打广告乐为物联的原型。
《嵌入式Internet TCP IP基础、实现及应用》。本书的TCP IP部分介绍的非常详细,书中有实现嵌入式以太网的代码分析。本书的作者也设计了一套功能完善的TCP IP协议栈。结合书中前半部分的基础和中部的实现,会有非常大的收获。
1.2其他网络资料
第一次有学习嵌入式以太网的冲动便从淘宝上购入ENC28J60模块,卖家提供的源码为国外AVRNET项目的源码。如果耐心一点认真分析AVRNET项目的源代码,并不断修改实践,收获颇丰。顺着ARP、IP、ICMP、UDP、TCP写了几个帖子,算是自己对嵌入式以太网的第一个总结。在这里再次贴一下链接。
http://www.amobbs.com/thread-5519452-1-1.html 【ARP部分】
http://www.amobbs.com/thread-5519494-1-1.html 【IP和ICMP部分】
http://www.amobbs.com/thread-5519530-1-1.html 【UDP部分】
http://www.amobbs.com/thread-5519592-1-1.html 【TCP部分】
在这一系类帖子中,还欠了一个HTTP的帖子。通过大家的关注度我发现,ARP部分关注的人最少,因为这个离HTTP最远。包括我在内,得到网络模块ENC28J60的第一个反应就是如果实现网页(HTTP)控制LED灯,读取温度湿度数据。现在回过头来看看基础还是非常重要的。呵呵。
2.搭建实验环境
先讲一下如何搭建实验环境。我个人倾向于把开发板接到路由器上,而调试使用的PC机通过有线或者无线也接到PC机上,先保证开发板和PC机接入同一个路由器。由于uIP不支持DHCP(只能说不直接支持),所以需要保证开发板和PC位于相同的子网,开发板的IP地址、路由器地址和子网掩码都需要手动设定。设定之前最好看看调试PC机的IP地址和路由器(网关)地址。例如调试PC机的IP地址如下图所示。
之后便可确定路由器的IP地址为192.168.1.1。那么开发板的IP地址可以设定为 192.168.1.2到192.168.1.255。为保证你的调试万无一失,还是建议您访问路由器,确认现在有哪些设备连入了路由器。该步骤的主要功能是避免IP地址重复。
3.硬件和软件说明
3.1硬件环境:
奋斗开发板。奋斗开发板上有一片ENC28J60,ENC28J60通过SPI接口控制内部寄存器,并有中断输出接口。STM32通过SPI1和ENC28J60相连。具体接口如下:
SPI1_MISO@PA6
SPI1_MOSI@PA7
SPI1_SCK@PA5
ENC28J60_CS@PA4
ENC28J60_INT@PA1(不过本例并没有使用外部中断,不过LwIP中推荐使用外部中断)
由于SPI上同时挂在其他SPI从设备,所有初始化的过程中需要通过操作CS端口禁止其他SPI从设备。(别小看这步,调试的时候在这步花费了非常多的时间)其他SPI从设备包括SST25VF016,CS端位于PC5;VS1003,CS端口位于PB12。
3.2其他说明
串口调试位于UART1。有三个LED灯分别位于PB.5,PD.6和PD.3。如果您的开发板和有存在差别,请按照顺序修改相关IO口,并打开相应RCC时钟。
3.3软件说明
工具链为EWARM 5.5(如果是EWARM 6.X请修改相关CMSIS选项)
4.网卡驱动
网卡驱动采用ENC28J60。具体可参考论坛中的另一个帖子http://www.amobbs.com/thread-5519381-1-1.html
需要说明的是ENC28J60的驱动也是参考网上资料的。但是帖子中有若干说明,详细分析了如何使用ENC28J60,需要深入理解两点,第一点如何通过SPI发送命令和数据;第二点理解ENC28J60的缓冲区,在发送以太网和接受以太网数据包的过程中,ENC28J60会帮助用户做些额外的工作,例如发送时自动填充SFD,在读取接收缓冲区数据时会包含若干状态信息,包括数据包长度和CRC校验结果等。如果你比较“速食”可以跳过该部分内容,如果你比较“耐心”可以花点时间看看。其他的以太网驱动芯片包括RF芯片也遵循相同的规律,可以做到触类旁通。
5.一个简单有效的定时器
TCP通信为了保证可靠性需要采用定时重传等安全机制,所以需要一个简单有效的定时器。设计定时器的方法很多,在这里推荐uIP原作者的timer模块。简单说timer模块的原理类似于MCU硬件中的比较匹配原理,timer模块中有一个全部变量counter,每次MCU发生某个定时器中断时累加1,如果某个任务需要使用定时器服务,在该任务中声明一个timer(在该任务中为全局变量),并记录此时的counter值,在本任务中声明的timer何时发生软件溢出呢?查询现在的counter和被记录的counter的差值,如果差值超过间隔值那么软件定时器timer溢出(类似于发生比较匹配中断),那么任务该做点什么了。软件定时器的主要目的有两个。第一,更新TCP或UDP连接,第二,更新ARP缓冲区(ARP表)。虽然uIP在功能上比LwIP简单的多,但是LwIP也有类似的部分(或者说完全一样)。
详细代码如下:- #include "timer.h"
- #include "stm32f10x_it.h"
- /* 全局变量 定时器计数值 */
- uint16_t current_clock = 0;
- void timer_config(void)
- {
- /* Systick时钟每s触发一次CLOCK_SECOND次 */
- if (SysTick_Config(SystemCoreClock / CLOCK_SECOND))
- {
- while (1);
- }
- }
- void SysTick_Handler(void)
- {
- /* 时间标志累加 */
- current_clock++;
- }
- uint16_t clock_time(void)
- {
- return current_clock;
- }
- void timer_set(timer_typedef* ptimer,uint16_t interval)
- {
- /* 设置时间间隔 */
- ptimer->interval = interval;
- /* 设置启动时间 */
- ptimer->start = clock_time();
- }
- void timer_reset(timer_typedef * ptimer)
- {
- ptimer->start =ptimer->start + ptimer->interval;
- }
- int8_t timer_expired(timer_typedef* ptimer)
- {
- /* 一定要装换为有符号数,进行数学比较时,多使用有符号数 */
- if((int16_t)(clock_time() - ptimer->start) >= (int16_t)ptimer->interval)
- return 1;
- else
- return 0;
- }
[color=rgb(51, 102, 153) !important]复制代码
6.uIP基本结构与配置
6.1 uIP基本结构
uIP的代码编写需要遵守一定的结构,而且这种结构最好保持稳定(保持不变)。这个结构主要做以下几个部分任务。
1.获得以太网数据包
2.处理ARP报文
3.处理IP报文
4.定期处理TCP和UDP连接
5.定期更新ARP缓冲区- /* 引用头文件 *****************************************************************/
- #include "stm32f10x.h"
- #include <stdio.h>
- #include "uip.h"
- #include "uip_arp.h"
- #include "tapdev.h"
- #include "enc28j60.h"
- #include "bsp_spi1.h"
- #include "bsp_usart.h"
- #include "timer.h"
- /* 私有数据类型 ***************************************************************/
- // BUF指向uIP缓冲区 uip_eth_hdr为以太网首部结构体
- // 6字节目标MAC地址 6字节源MAC地址 2字节类型
- #define BUF ((struct uip_eth_hdr *)&uip_buf[0])
- /* 私有常数宏 *****************************************************************/
- /* 私有动作宏 *****************************************************************/
- /* 私有变量 *******************************************************************/
- /* 私有函数声明 ***************************************************************/
- void GPIO_Config(void);
- /* 私有函数 ******************************************************************/
- int main(void)
- {
- timer_typedef periodic_timer, arp_timer;
- uip_ipaddr_t ipaddr;
- /* 设定查询定时器 ARP定时器 */
- timer_set(&periodic_timer, CLOCK_SECOND / 2);
- timer_set(&arp_timer, CLOCK_SECOND * 10);
- GPIO_Config(); /* 禁止SPI其他设备,防止窜扰 */
- timer_config(); /* 配置systic作为1ms中断 */
- BSP_ConfigSPI1();
- tapdev_init(); /* 网卡初始化,ENC28J60,包括MAC地址初始化 */
- uip_init(); /* UIP协议栈初始化 */
- uip_ipaddr(ipaddr, 192,168,1,15); /* 设置IP地址 */
- uip_sethostaddr(ipaddr);
- uip_ipaddr(ipaddr, 192,168,1,1); /* 设置默认路由器IP地址 */
- uip_setdraddr(ipaddr);
- uip_ipaddr(ipaddr, 255,255,255,0); /* 设置网络掩码 */
- uip_setnetmask(ipaddr);
- example1_init(); /* 用户任务初始化 为TCP echo任务*/
- // example2_init();
- BSP_ConfigUSART1(); /* 初始化串口 重定义putchar */
- printf("\r\nuip start!\r\n"); /* 打印IP地址 */
- printf("ipaddr:192.168.1.15\r\n");
- printf("eID:xukai871105\r\r"); /* 打印个人信息,呵呵*/
- printf("");
- while (1)
- {
- uip_len = tapdev_read(); /* 读取以太网数据包,返回数据长度 */
- if(uip_len > 0) /* 收到数据 */
- {
- if(BUF->type == htons(UIP_ETHTYPE_IP)) /* 收到IP数据包 */
- {
- uip_arp_ipin();
- uip_input();
- if (uip_len > 0)
- {
- uip_arp_out();
- tapdev_send();
- }
- }
- else if (BUF->type == htons(UIP_ETHTYPE_ARP)) /* 收到ARP数据包 */
- {
- uip_arp_arpin();
- if (uip_len > 0)
- {
- tapdev_send();
- }
- }
- }
- if(timer_expired(&periodic_timer)) /* 查询定时器是否超时 */
- {
- timer_reset(&periodic_timer);
- GPIOB->ODR ^= GPIO_Pin_5; /* 测试使用,表现为LED灯闪烁 */
- for(uint8_t i = 0; i < UIP_CONNS; i++) /* 查询并处理所有TCP连接*/
- {
- uip_periodic(i);
- if(uip_len > 0)
- {
- uip_arp_out();
- tapdev_send();
- }
- }
- #if UIP_UDP
- for(uint8_t i = 0; i < UIP_UDP_CONNS; i++) /* 查询并处理所有UDP连接*/
- {
- uip_udp_periodic(i);
- if(uip_len > 0)
- {
- uip_arp_out();
- tapdev_send();
- }
- }
- #endif /* UIP_UDP */
- if (timer_expired(&arp_timer)) /* ARP定时是否溢出 */
- {
- timer_reset(&arp_timer);
- uip_arp_timer();
- }
- }
- }
- }
[color=rgb(51, 102, 153) !important]复制代码
做几点简单说明
1.#define BUF ((struct uip_eth_hdr *)&uip_buf[0])
指向uIP缓冲区,强制类型转化为uip_eth_hdr结构体,uip_eth_hdr即为以太网首部结构,6字节目标MAC地址 6字节源MAC地址 2字节类型。
2. tapdev_init();tapdev_read();tapdev_send();
三个函数为以太网操作函数,只有tapdev_read有返回值,其他函数即无输入参数也无返回参数。这三个函数便是ENC28J60操作的三个封装,ENC28J60发送或接收直接操作uIP的两个全局变量uip_buf和uip_len。
具体代码如下:- #include "tapdev.h"
- #include "uip.h"
- #include "uip_arp.h"
- #include "enc28j60.h"
- // MAC地址
- struct uip_eth_addr uip_mac;
- static unsigned char ethernet_mac[6] = {0x00,0x14,0x0B,0x3F,0x04,0xB1};
- void tapdev_init(void)
- {
- enc28j60_init(ethernet_mac); /*初始化enc28j60 赋值MAC地址*/
- for (uint8_t i = 0; i < 6; i++)
- {
- uip_mac.addr = ethernet_mac;
- }
- uip_setethaddr(uip_mac); /* 设定uip mac地址*/
- }
- uint16_t tapdev_read(void)
- {
- return enc28j60_packet_receive(uip_buf,1500);
- }
- void tapdev_send(void)
- {
- enc28j60_packet_send(uip_buf,uip_len);
- }
[color=rgb(51, 102, 153) !important]复制代码
6.2 uIP配置部分
IP地址配置:
IP地址设置包括,本地IP地址,网关地址和子网掩码。具体代码如下:
MAC地址配置:
MAC的地址较为特殊,由于ENC28J60本身没有唯一的EUI-48(俗称MAC地址)地址,所以EUI-48地址需要手动配置。该地址不但应用于ENC28J60也应用于uIP。相关代码在上一小节已说明。
6.3 uip-conf.h部分
uip-conf部分说明三点
1.如果不熟悉请保留默认参数,例如UIP_CONF_MAX_CONNECTIONS等
2.如果设置UIP_CONF_LOGGING为1,请添加void uip_log(char *m){}
3.必须包含用户任务头文件,且放在该头文件的最后。例如添加#include "example1.h"。这样做的主要目的便是定义uip_tcp_appstate_t和UIP_APPCALL两个关键参数。
具体代码如下- #ifndef __UIP_CONF_H
- #define __UIP_CONF_H
- #include <inttypes.h>
- typedef uint8_t u8_t;
- typedef uint16_t u16_t;
- typedef unsigned short uip_stats_t;
- /* 最大TCP连接数 */
- #define UIP_CONF_MAX_CONNECTIONS 10
- /* 最大端口监听数 */
- #define UIP_CONF_MAX_LISTENPORTS 10
- /* uIP 缓存大小*/
- #define UIP_CONF_BUFFER_SIZE 1500
- /* CPU字节顺序 */
- #define UIP_CONF_BYTE_ORDER UIP_LITTLE_ENDIAN
- /* 日志开关 */
- #define UIP_CONF_LOGGING 1
- /* UDP支持开关*/
- #define UIP_CONF_UDP 0
- /* UDP校验和开关 */
- #define UIP_CONF_UDP_CHECKSUMS 1
- /* uIP统计开关 */
- #define UIP_CONF_STATISTICS 1
- // 加入用户任务头文件
- #include "example1.h"
- #endif
[color=rgb(51, 102, 153) !important]复制代码
7.案例1——最简单的TCP echo程序
先来一个最简单的TCP程序。uIP作为server,IP地址为192.168.1.15。PC机做client,IP地址为192.168.1.10X。
1.在网络调试助手中,选择以太网通信种类为client(表示PC机为Client),IP地址输入192.168.1.15,端口号输入1234。最后点击连接。
2.在发送区域输入任意内容,点击发送数据。
3.观察返回结果,是否和发送数据相同。
为了实现该功能新建example1.c和example1.两个文件。代码如下- #ifndef __EXAMPLE1_H
- #define __EXAMPLE1_H
- #include "uipopt.h"
- // 应用程序状态 如果不使用可以定义为int或者其他类型
- typedef int uip_tcp_appstate_t;
- // 定义应用程序 并指定UIP_APPCALL宏定义
- void example1_appcall(void);
- #ifndef UIP_APPCALL
- #define UIP_APPCALL example1_appcall
- #endif
- void example1_init(void);
- #endif
[color=rgb(51, 102, 153) !important]复制代码
- #include "example1.h"
- #include "uip.h"
- #include <string.h>
- #include <stdio.h>
- #include <stdint.h>
- void example1_init(void)
- {
- uip_listen(HTONS(1234));
- }
- void example1_appcall(void)
- {
- if( uip_newdata() )
- {
- // 输出远程IP和端口号
- printf("remote ip addr:%d.%d.%d.%d\r\n",
- (uip_conn->ripaddr[0]) & 0X00ff,
- (uip_conn->ripaddr[0]) >> 8,
- (uip_conn->ripaddr[1]) & 0X00ff,
- (uip_conn->ripaddr[1]) >> 8
- );
- printf("remote ip port:%d\r\n",HTONS(uip_conn->rport));
- // TCP ECHO
- uip_send(uip_appdata,uip_len);
- }
- }
[color=rgb(51, 102, 153) !important]复制代码
实验结果如下图所示。
代码做如下分析
1.uip_listen(HTONS(1234));侦听1234端口,
2.uip_newdata()即查询uip_buf中是否有新数据,如果返回1的话,任务需要做些什么了。
3.uip_send(uip_appdata,uip_len);uip_send为发送数据包函数
4.uip_appdata指向用户数据,所谓用户数据即TCP负载数据,例如网络调试助手发送xukai871105,那么uip_appdata指向xukai871105.
5.uip_len为用户数据长度,若串口调试助手发送xukai871105,那么uip_len为11。
8.wireshark网络包分析
程序虽然简单,但是TCP通过过程还是可以好好分析一下的。通过wireshark软件抓取整个通信过程。
其中192.168.1.102为调试PC机(下文简称PC机),192.168.1.15为uIP嵌入式开发板(下文简称uIP)。
===================================================
1.建立连接阶段
【36】PC机向uIP发送SYN,表示请求连接(点击网络调试助手的连接按钮)
【37】uIP向PC机返回ACK,同时发送SYN(注意若接收到SYN标志,必须返回ACK)
【38】PC机向uIP发送应答ACK,表示该次TCP连接成功。
===================================================
2.数据交换阶段(负载数据包假定为1234)
【51】PC机向uIP发送1234,标志位PSH+ACK,表示该数据包需要立即处理,并需要应答
【52】uIP向PC机返回1234,标志位PSH+ACK,表示该数据包需要立即处理,并需要应答
【53】PC机返回应答,表示PC机接收到echo数据包。
此时数据交换完成,若在网络调试助手再次点击发送,便重复51到53部分。
===================================================
3.关闭连接部分
【65】PC机要求停止连接,发送FIN标志。(点击网络调试助手的关闭按钮)
【66】uIP返回FIN+ACK,表示同意结束本次TCP连接。
【67】PC机发送ACK,表示收到了uIP的FIN。(至此,TCP连接完全结束)
===================================================
9.案例2——uip_poll中发送数据
uip中发送数据包要稍微复杂一些。若使用uIP如果不做特殊处理的话,只能在uIP用户任务中发送以太网数据包,而不能在其他的任务中发送。虽然有人说这是uIP的bug,不过我并不认同。在多个uIP示例代码中,均定义了用户任务本身状态,例如任务处于发送状态还是接受状态,任务有独立的发送缓冲区或接收缓冲区并记缓冲区的大小。
设计一个简单的任务说明uip_poll的应用。
1.uIP作为server,IP地址为192.168.1.15,侦听端口端口为1234,PC机通过网络调试助手连接uIP。
2.建立连接之后,uIP主动发送10个数据包,数据包之前间隔1S。
3.发送完数据包只收,uIP主动关闭连接。
详细代码请查看工程附件。
实验结果,uIP向PC机连续发送10次数据,并最后主动终止连接
10.总结
1.掌握嵌入式以太网需要较多的背景知识,只能在实践的过程中一点一滴积累。回过头来想想自己的学习嵌入式以太网的经历,多数时间多是在急躁和失望中度过。唯有耐心与细致并不断学习基础知识才可以把问题解决,最终把想法变成现实
2.uIP功能简单,但是易于使用。如果觉得uIP在实际中难以发挥作用的话,还有LwIP作为补充。虽然两者存在功能上的差异,但是TCP连接还是那几个——SYN、ACK、PSH、FIN标志位。LwIP提供套接字通信,这使得嵌入式以太网应用和PC机上的以太网应用变得极为相似。
3.由于TCP协议属于运输层协议,TCP传输的内容本身并没有含义,这些被传输的数据需要被赋予含义才可以使用。从工业控制来说,MODBUS协议可以应用与TCP协议(本帖子是对modbus tcp的铺垫),并可以实现完善的检测与控制功能。从其他应用来说,嵌入式系统可以提供HTTP通信、提供web service应用,通过解析JSON格式等手段实现更广泛的应用。
最后感谢大家的关注,我一定继续努力。若有描述错误的地方请指出,定当更正。
|