//=====================================================================
//TITLE:
8 ^& L) r' U0 i7 Q//    STM32F2xx的tcp_echoserver例程解说
//AUTHOR:
//    norains
1 {% g. q; U' o//DATE:
//    Monday  04-July-2011
4 c: n/ {: h# H% F! M3 W1 l- ?//Environment:
8 g0 b+ N0 ~8 e$ T8 L$ b% F8 G//    Keil MDK 4.2
" \; v( ~+ m( Q3 f6 O//    STM32F207 核心版
//=====================================================================

     最近拿到STM32F207的核心版，板载有网卡芯片，自然要拿过来捣鼓一番。而对于一个从未接触过网络的菜鸟来说，最好的入门方式就是揣测ST公司的例程，所以今天norains也不例外。那么我们就一起来看看这个官方的例程吧！

+ Y" c/ x7 g3 Y# i/ \" d: O( Z

    ST关于TCP的例程分为client和server，根据字面意思，可以知道tcp_echoserver例程是将STM32F2xx作为server来用。而例程的第一步呢，便是初始化，调用的是tcp_echoserver_init()函数。

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
; j. P2 y# ?% z, U% _     1. 创建一个新的TCP协议控制块
     2. 绑定地址和端口号（port）
' H; j) N% X( E9 O     3. 开始监听（listen）
* g) ^, y9 ], l' V+ `. q     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   " k3 q. i0 x& |% y+ K9 j4 q* r
2. {  
   
3.   //创建一个新的TCP控制块  
   - \9 K2 z4 H# k& J& z$ E
4.   tcp_echoserver_pcb = tcp_new();  
   . P% F6 |8 d( H" p- p0 T$ w
5.   
   
6.   if (tcp_echoserver_pcb != NULL)  
   
7.   {  
   6 e9 C' E. h/ n# r# F6 Y$ {
8.     err_t err;  
   
9.       
   ; [7 r# E2 p3 o1 S
10.     //绑定到端口7  
    
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    8 ^3 c( \7 Q/ l1 g8 @* D
12.       
    0 @7 Z9 F: D. T' v
13.     if (err == ERR_OK)  
    
14.     {  
    ! `' R: b1 S1 }
15.       //开始监听  
    
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    & s+ d) \' ]# U; `1 K) k' [
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    
20.      }  
    
21.     else   
    ' N$ g4 P* c) c9 U. X" u
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    , V: Z; T4 o6 L) @; |" L% s
25.   }  
    
26.   else  
    4 `) D; j8 v7 O4 u% }. B
27.   {  
    
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    $ ~& V, k) a7 _4 X3 t: {
29.   }  
    1 D  ~$ v- x" h+ L- P! o
30. }

复制代码

    当客户端开始连接之后，那么被设置的tcp_echoserver_accept()回调函数就会被调用。该函数主要是创建一个新的数据结构，并且将该数据结构传递给底层的TCP，最后分别是设置receive，error和poll这三个回调函数。
　　
　　tcp_echoserver_accept()代码如下所示：

1. static err_t tcp_echoserver_accept(void *arg, struct tcp_pcb *newpcb, err_t err)  
   4 H8 N) y- [) p* [  q* R
2. {  
   
3.   err_t ret_err;  
   # |; k2 D; c- z7 G
4.   struct tcp_echoserver_struct *es;  
   + p( A; ]7 }% F& j' ^0 O9 z
5.   
   : e- U1 I: S$ e8 t2 ~5 a
6.   LWIP_UNUSED_ARG(arg);  
   
7.   LWIP_UNUSED_ARG(err);  
   8 R) P7 ~* r* S: I( G; n1 r
8.   
   
9.   ///给新的连接设置优先级  
   % f* J& }& N( T: j  A, E% d
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    + c0 L. L  R+ q0 N
11.   
    % A6 V  j/ G+ H. p, F8 V$ ~
12.   //分配一个结构体空间以保持TCP的连接  
    ! @+ B. W" H) ~# k7 c, Z0 |5 P+ }
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    ) n' W. `. |6 P( l1 X5 }- n
14.   if (es != NULL)  
    
15.   {  
    
16.     es->state = ES_ACCEPTED;  
    
17.     es->pcb = newpcb;  
    
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    
21.     tcp_arg(newpcb, es);  
    . D/ L: t  `- ]
22.       
    
23.     //为新的连接设置receive回调函数   
      P: p0 J& G5 G( |3 u
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    * p+ o& L" V  G
25.       
    
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    
28.       
    
29.     //为新的连接设置poll回调函数  
    0 }3 }* ]$ F, g/ V: ^" }8 Z
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    5 j- X/ ^, e4 C" `' r' c
32.     ret_err = ERR_OK;  
    ' p( m& ^2 N2 i0 N8 d! }
33.   }  
    
34.   else  
    
35.   {  
    
36.     /* return memory error */  
    5 ]  D1 x3 j" \3 y# v# k8 I  |" y
37.     ret_err = ERR_MEM;  
    
38.   }  
    
39.   return ret_err;   
    
40. }

复制代码

　　接下来便是tcp_echoserver_recv()这个回调函数，因为该函数比较大，这里就不再全部罗列代码了。对于使用者来说，只需要知道相应的判定条件来代表什么意思就足够了，如：

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   
2. {  
     W. E  N& n, G: I
3.   struct tcp_echoserver_struct *es;  
   ) s( {) r; ?/ x2 D
4.   err_t ret_err;  
   
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   / \) X' X: ?7 c& G% n
7.    
   . D9 \& R2 r0 {5 u$ C& K( T
8.   es = (struct tcp_echoserver_struct *)arg;  
   
9.   
   & v7 n0 b0 B, ?/ @! h4 G
10.   if (p == NULL)  
    # M( b* M, R$ l' l# q+ {1 r
11.   {  
    4 }) L( N0 ^8 k" G
12.    //如果接收到空的帧，则释放连接  
      e7 s% O' m, F' A  s% N7 s6 c
13.    ...  
    
14.   }     
    
15.   else if(err != ERR_OK)  
    
16.   {  
    9 Q2 `9 I* c/ y  I1 z! e
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    
18.    ...  
    % G) Q( h( K' Y
19.   }  
    
20.   else if(es->state == ES_ACCEPTED)  
    ' |4 Y, W- g$ z4 P) ?9 z) q1 o; Q' q
21.   {  
    - |" \8 p' n/ S2 i
22.    //连接成功，在这里需要设置sent回调函数  
    ( {" f# I/ d) `7 D4 d0 q
23.    ...  
    # J( I& \. q( F/ F4 p0 h" k( _
24.   }  
    
25.   else if (es->state == ES_RECEIVED)  
    + t" h* Y0 M1 J6 Q3 g
26.   {  
    5 e7 ~! \7 L8 y; i7 B* t: ]& x5 {
27.    //从客户端收到数据  
    
28.    ...  
    2 d. d' g* w0 N; V. b8 H
29.   }  
    
30.   else  
    
31.   {  
    
32.    //当连接关闭时，还收到了数据  
    7 m8 T/ f/ o6 |, C3 A# m% ^
33.    ...  
    
34.   
    
35.   }  
    
36.    
    8 P' O7 G" d# a; A4 B! P' B4 O  e
37.   return ret_err;  
    
38. }  

复制代码

STM32F207的代码部分就暂时说到这里，现在的问题是，如何 测试这代码的正确性呢？这就必须用到ST提供的echotool.exe程序了。该程序位于stm32f2x7_eth_lwip的PC_Software文件夹中。该程序必须在命令行打开，其大致参数如下所示：

' N; ~; y4 T+ s! K

　如果我们的serverip地址为192.168.0.8，那么可以输入如下命令进行测试：
$ Q0 d: T; `/ _. b- i( |# s6 Y7 z% G　　 echotool.exe 192.168.0.8 /p tcp /r 7 /n 15 /t 2 /d Testing LwIP TCP echo server
) I7 s+ O9 [  b: N0 I7 N6 K　　
　　如果网络联通的话，测试成功将如下如下的画面，如图：
4 \+ I( t0 a( A% ]

3 }1 i1 D8 m0 ~- t  W