//=====================================================================
//TITLE:
7 Y5 @9 g5 n3 l//    STM32F2xx的tcp_echoserver例程解说
//AUTHOR:
//    norains
: J* c, ^* _: h//DATE:
+ k8 m9 ?: n' f//    Monday  04-July-2011
0 b( G# y2 G# e/ D//Environment:
//    Keil MDK 4.2
. b5 A) e& a) r$ f5 t//    STM32F207 核心版
6 I6 |9 m3 A. w: K& r6 c//=====================================================================

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

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
/ F9 R' Y; ~1 A9 q+ Y* _7 p# I     1. 创建一个新的TCP协议控制块
& G4 \8 W6 v& i, R0 z1 h     2. 绑定地址和端口号（port）
     3. 开始监听（listen）
( F. U4 U8 d$ ?     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   , f' J/ @4 Z1 z- \
2. {  
   
3.   //创建一个新的TCP控制块  
   : F! _8 D  }5 u2 |: @9 q- T
4.   tcp_echoserver_pcb = tcp_new();  
   
5.   
   3 ]+ V& v; b) p5 O# v* R( H
6.   if (tcp_echoserver_pcb != NULL)  
   
7.   {  
   9 X, v! U/ }# l. D) @! m9 a; B
8.     err_t err;  
   , M% N  ^" i7 u9 Y  Y2 w
9.       
   
10.     //绑定到端口7  
    ) `. I+ D9 m  j: A5 s, l' i
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    7 f# v; f3 h+ t( z' K* _
12.       
    
13.     if (err == ERR_OK)  
    " q, H( @% _' F5 F' x/ K! E, ]
14.     {  
    
15.       //开始监听  
    
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    # L% i. G0 P- Z' u+ e
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    , E6 g6 A% y8 X$ R5 |2 l
20.      }  
    
21.     else   
    % N: L9 H% X; @# O7 {( R* L2 O
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    8 \2 {; u$ W6 z1 i$ F; m$ C( N( M
24.     }  
    
25.   }  
    
26.   else  
      j9 m- w, ?, x' H* Y- n/ c5 s% G
27.   {  
    & x) r/ K, F( r6 f* |- [
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    
29.   }  
    % c. b3 Y1 Z$ n# ^! E0 ^9 i
30. }

复制代码

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

1. static err_t tcp_echoserver_accept(void *arg, struct tcp_pcb *newpcb, err_t err)  
   
2. {  
   
3.   err_t ret_err;  
   
4.   struct tcp_echoserver_struct *es;  
   
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   
7.   LWIP_UNUSED_ARG(err);  
   ' E  f8 T' M- F9 [' V
8.   
   6 `+ f5 d0 I! `0 g& O9 F/ f0 D
9.   ///给新的连接设置优先级  
     T; ?9 q4 o* M1 T! L0 G% `) a; i: W  A( y
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    
11.   
    ( J; Y9 W6 Z% t1 ~
12.   //分配一个结构体空间以保持TCP的连接  
    , w( [3 t+ G* J7 J2 z
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    
14.   if (es != NULL)  
    
15.   {  
    
16.     es->state = ES_ACCEPTED;  
    8 [6 ~: q# n6 B2 M) U8 L7 o1 g8 j
17.     es->pcb = newpcb;  
    ( n% J5 v' _& B8 g" A
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    ! S% t' T6 l1 ]
21.     tcp_arg(newpcb, es);  
    6 i, d' q4 _, y% }
22.       
    . ~4 [3 E0 v* F! T" M% H9 J- Z. Q) L
23.     //为新的连接设置receive回调函数   
    0 n5 ]+ T$ t2 A& a# T# @
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    7 L9 \1 J5 G, K6 w
25.       
    : Q( Y6 J$ [8 w9 `/ ~/ z
26.     //为新的连接设置error回调函数  
    & M6 A) }; F* n1 ~# ]
27.     tcp_err(newpcb, tcp_echoserver_error);  
    
28.       
    ! O$ L$ Q' m/ V3 Y* D+ Y: }
29.     //为新的连接设置poll回调函数  
    1 a/ s. [3 x/ f
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    ; {3 ~9 o8 t+ b( @: g9 Y$ G7 h
31.       
    
32.     ret_err = ERR_OK;  
    . E( z3 \% S8 T5 P
33.   }  
    7 t+ z* N: q6 M8 S8 N1 R0 O+ F8 Z
34.   else  
    
35.   {  
    0 d% u; |) W) x9 `
36.     /* return memory error */  
    
37.     ret_err = ERR_MEM;  
    
38.   }  
    ) O! L+ G/ L; f4 U' m; K1 {- `
39.   return ret_err;   
    : K7 J, Z% F* G' E9 l
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   ; W- k6 z- \7 p& F
2. {  
   
3.   struct tcp_echoserver_struct *es;  
   
4.   err_t ret_err;  
   
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   
7.    
   
8.   es = (struct tcp_echoserver_struct *)arg;  
   
9.   
   . ^" F) r1 a/ Q
10.   if (p == NULL)  
    ! l+ H- |( I" Y& `. h/ A5 L. D
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
    9 [% h8 x* x* L! Y5 F: u; F
13.    ...  
    
14.   }     
    
15.   else if(err != ERR_OK)  
    
16.   {  
    , S' {: e% I! w
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    
18.    ...  
    6 @# S6 C. ~' a+ W6 @" m8 c$ `
19.   }  
    
20.   else if(es->state == ES_ACCEPTED)  
    
21.   {  
    & T$ p: h. f/ S7 r, {7 Q- p
22.    //连接成功，在这里需要设置sent回调函数  
    6 w; d$ p: n% X1 q
23.    ...  
    
24.   }  
    
25.   else if (es->state == ES_RECEIVED)  
    ) C' A; X2 X2 Z, `
26.   {  
    * S. ]' L$ h5 G7 v5 o& M4 Y# H. h
27.    //从客户端收到数据  
      x- L2 G$ ~" _+ T9 t
28.    ...  
    , G* d% |; m8 [" D4 T
29.   }  
    * F3 L4 G  m. B. W: a& y# s
30.   else  
    
31.   {  
    3 }/ b8 h5 Q! p/ v& O# `0 P4 W
32.    //当连接关闭时，还收到了数据  
    
33.    ...  
    " a6 v9 V4 Z6 u* m  L  L5 f
34.   
    
35.   }  
    ; P( Z5 B, g$ p) s8 B# b) ]; l
36.    
    
37.   return ret_err;  
    / ?; @9 d& _. s
38. }  

复制代码

STM32F207的代码部分就暂时说到这里，现在的问题是，如何 测试这代码的正确性呢？这就必须用到ST提供的echotool.exe程序了。该程序位于stm32f2x7_eth_lwip的PC_Software文件夹中。该程序必须在命令行打开，其大致参数如下所示：
  X) B2 d+ \$ X# u1 X# E
' x; b5 K. B$ x' J0 Z+ O4 U

　如果我们的serverip地址为192.168.0.8，那么可以输入如下命令进行测试：
　　 echotool.exe 192.168.0.8 /p tcp /r 7 /n 15 /t 2 /d Testing LwIP TCP echo server
　　
  Z1 A1 B9 P/ Y3 \5 p4 u　　如果网络联通的话，测试成功将如下如下的画面，如图：

) {  r6 T! \4 [7 m- D, h' ?' V

* x9 H* }1 @: N& U7 Z
6 p- s5 Z! Q* R% ~3 u6 {


9 z3 a: g& ]; a3 m