//=====================================================================
//TITLE:
6 L. d% o7 V  j, \3 N//    STM32F2xx的tcp_echoserver例程解说
( ~' V" Q& c- N- X" q/ n* ?//AUTHOR:
//    norains
2 W. b3 _( n1 d! A. O+ ~//DATE:
, W( g1 T5 k  b. b- t2 e//    Monday  04-July-2011
//Environment:
' a0 A) Z# Y& t$ p# \//    Keil MDK 4.2
//    STM32F207 核心版
) J1 S+ Y. j6 ~% H) c6 w//=====================================================================

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

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
     1. 创建一个新的TCP协议控制块
* P# W8 W! A0 |3 [7 t     2. 绑定地址和端口号（port）
1 w( j( }1 v7 l- e$ N" z     3. 开始监听（listen）
     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   ( Q' a  T& |: @9 S% |
2. {  
   * Y, W$ a5 L9 Q  `2 z
3.   //创建一个新的TCP控制块  
   
4.   tcp_echoserver_pcb = tcp_new();  
   - K1 J- h- b# h; P: ^1 ?/ B
5.   
   
6.   if (tcp_echoserver_pcb != NULL)  
   ( C- l/ P( n9 L4 d# U
7.   {  
   
8.     err_t err;  
   7 G5 m% E! ]" \- _# v( _. ?- T7 A
9.       
   : ]9 t  E4 s- i4 [6 `
10.     //绑定到端口7  
    
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    ) ]! Z; D  f/ O8 I* A9 M) i" J  f# Q
12.       
    
13.     if (err == ERR_OK)  
    
14.     {  
    / C4 x- j  `; ^
15.       //开始监听  
    
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    4 m' o3 K( U! K# \' T( R# w
20.      }  
    ( G% n5 e' R+ z: [# J( n
21.     else   
    
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    
25.   }  
    $ I( j2 L" p9 O, T6 w; S6 }
26.   else  
    
27.   {  
    , W' t! y7 d5 `# r; \+ R
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    ' Q8 q1 g" t% M
29.   }  
    
30. }

复制代码

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

1. static err_t tcp_echoserver_accept(void *arg, struct tcp_pcb *newpcb, err_t err)  
     b. j2 M$ i7 |+ N7 f- t  V! z: E
2. {  
   
3.   err_t ret_err;  
   ( ~! b! S7 p; f
4.   struct tcp_echoserver_struct *es;  
   8 [! T: o, s2 Q% W% S" A$ o
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   " s# o! l, C+ a# U
7.   LWIP_UNUSED_ARG(err);  
   
8.   
   
9.   ///给新的连接设置优先级  
   
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    
11.   
    # j" @1 K, H! f8 Y2 k7 A
12.   //分配一个结构体空间以保持TCP的连接  
    % Y2 O6 m* m' ?9 m4 _
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    8 t& g. i6 {0 E  S
14.   if (es != NULL)  
    
15.   {  
    & u# ]8 N2 x' A1 Y( I$ N, ~' A2 K
16.     es->state = ES_ACCEPTED;  
    7 x, A2 p* b+ e# w' Q
17.     es->pcb = newpcb;  
    
18.     es->p = NULL;  
    
19.       
    , Q# t" ^/ J7 p+ o$ m) U4 k
20.     //传递新分配的结构体数据给新的pcb  
    * Y/ w2 t( q- O* ~/ w) o
21.     tcp_arg(newpcb, es);  
    7 \! W" I) k$ K# ^% \3 E& q8 i
22.       
    6 l+ x4 x9 p. `. ~; ^$ R
23.     //为新的连接设置receive回调函数   
      l5 c( N7 a8 P$ n% \3 I* @
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    ) a$ |" y) Y, v' k) j4 Y
25.       
    $ [6 H, y( k; N7 b; H) {
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    9 D" `5 T6 t5 o3 s! j
28.       
    
29.     //为新的连接设置poll回调函数  
    ) N1 t* ?; S) i: w7 T: v6 M2 N
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    
32.     ret_err = ERR_OK;  
    
33.   }  
    , y! Q: q# I6 L# c0 E" K
34.   else  
    
35.   {  
    
36.     /* return memory error */  
    
37.     ret_err = ERR_MEM;  
    / |8 ^) \1 L7 l( h) h7 L4 m8 B
38.   }  
    - z. ^* E  P0 y4 p! K: C" |
39.   return ret_err;   
    4 r; h! q3 q6 `9 z2 \
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   
2. {  
   # Q2 E' C% w9 y) r8 v5 r6 X' X
3.   struct tcp_echoserver_struct *es;  
   : p- Y& J1 ^6 h
4.   err_t ret_err;  
   , K+ J' ?& T. U
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   : B3 c2 }9 P( N* O$ W, h, B0 |
7.    
   9 f5 ^6 q  I/ v& Z/ n& M5 F. s1 p  j
8.   es = (struct tcp_echoserver_struct *)arg;  
   ( R7 N. D. t: [7 K, }
9.   
   , k$ i1 p9 j, u0 Y7 J
10.   if (p == NULL)  
    2 f  Q4 `' `0 M' N
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
    
13.    ...  
    
14.   }     
    
15.   else if(err != ERR_OK)  
    
16.   {  
    
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    0 E8 S/ I( d( {9 y, O
18.    ...  
    
19.   }  
    3 _" E+ \% M/ R+ E: S4 R; S
20.   else if(es->state == ES_ACCEPTED)  
    1 m. |* G; x* B, C3 c8 c% s. W$ q
21.   {  
    
22.    //连接成功，在这里需要设置sent回调函数  
    
23.    ...  
    
24.   }  
    
25.   else if (es->state == ES_RECEIVED)  
    
26.   {  
    ! Y1 N, G$ U5 H+ R! U
27.    //从客户端收到数据  
    
28.    ...  
    ) b  ]. i$ f) ]
29.   }  
    " x# w) F( \. D3 h
30.   else  
    
31.   {  
    * T8 U3 ?% ^7 W( _, `7 B- J
32.    //当连接关闭时，还收到了数据  
    
33.    ...  
    $ s$ b$ L$ z& |0 X- u7 u" x
34.   
    . [2 L: @" [0 L# I/ U, \
35.   }  
    
36.    
    : e: q+ T" I6 N$ w% Q
37.   return ret_err;  
    
38. }  

复制代码

STM32F207的代码部分就暂时说到这里，现在的问题是，如何 测试这代码的正确性呢？这就必须用到ST提供的echotool.exe程序了。该程序位于stm32f2x7_eth_lwip的PC_Software文件夹中。该程序必须在命令行打开，其大致参数如下所示：
+ I8 {* I  v' z) }
$ [* V. _5 ^) ?) j

4 Z# E  ?5 v0 w0 `2 ]1 d9 E
. A6 M9 k* D7 {4 m0 F9 M　如果我们的serverip地址为192.168.0.8，那么可以输入如下命令进行测试：
, V% C- Q4 q1 X: D9 `) K　　 echotool.exe 192.168.0.8 /p tcp /r 7 /n 15 /t 2 /d Testing LwIP TCP echo server
1 s& {& J+ i' x; Z2 I* [  b* }　　
2 C& g9 l( a5 C! m/ X2 j　　如果网络联通的话，测试成功将如下如下的画面，如图：

3 _3 o2 _. Q5 J" A1 G: g0 W8 _

: a9 d" ^# z5 l6 l$ m. |% n