首页 | 新闻 | 新品 | 文库 | 方案 | 视频 | 下载 | 商城 | 开发板 | 数据中心 | 座谈新版 | 培训 | 工具 | 博客 | 论坛 | 百科 | GEC | 活动 | 主题月 | 电子展
返回列表 回复 发帖

嵌入式以太网uIP应用笔记

嵌入式以太网uIP应用笔记

本帖最后由 xukai871105 于 2013-6-12 15:26 编辑

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相连。具体接口如下:
    [email=SPI1_MISO@PA6]SPI1_MISO@PA6[/email]
    [email=SPI1_MOSI@PA7]SPI1_MOSI@PA7[/email]
    [email=SPI1_SCK@PA5]SPI1_SCK@PA5[/email]
    [email=ENC28J60_CS@PA4]ENC28J60_CS@PA4[/email]
    [email=ENC28J60_INT@PA1]ENC28J60_INT@PA1[/email](不过本例并没有使用外部中断,不过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;
  • }

复制代码

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();
  • }
  • }
  • }
  • }

复制代码
做几点简单说明
    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);
  • }

复制代码
  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

复制代码
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

复制代码
  • #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);
  • }
  • }

复制代码
实验结果如下图所示。

     代码做如下分析
    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格式等手段实现更广泛的应用。
返回列表