//=====================================================================
, ]7 G5 o$ L, U; x//TITLE:
; ?  A( \7 v. H2 m+ a9 ^9 i$ l# e2 k  y" a//    STM32F2xx的tcp_echoserver例程解说
, _8 D& y2 B" d/ a. E$ S, e/ y5 b//AUTHOR:
# h; A1 s$ Q' B5 |5 v//    norains
" V. b9 `9 o# _* C7 f9 v1 {& X//DATE:
//    Monday  04-July-2011
//Environment:
/ x! ]( C/ J  {//    Keil MDK 4.2
//    STM32F207 核心版
//=====================================================================

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

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
     1. 创建一个新的TCP协议控制块
     2. 绑定地址和端口号（port）
     3. 开始监听（listen）
# y# Z: |6 V2 m+ E% Y2 ^     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   
2. {  
   
3.   //创建一个新的TCP控制块  
   
4.   tcp_echoserver_pcb = tcp_new();  
   
5.   
   * o( N5 A9 B0 n$ K8 b1 L" f2 Y
6.   if (tcp_echoserver_pcb != NULL)  
   3 d. l9 K0 h- p* g3 C7 s7 V5 l
7.   {  
   
8.     err_t err;  
   
9.       
     T; G1 m# S5 ^5 R! H/ o9 m
10.     //绑定到端口7  
    # p- N2 Z8 R" \1 E6 \
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    
12.       
    
13.     if (err == ERR_OK)  
    
14.     {  
    2 C' T# K3 U' d: I; c" C
15.       //开始监听  
    
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    - I- _0 G6 P; j) }8 v& }
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    ; {/ C& i: [8 r& R  m2 {+ m
20.      }  
    : h0 L# }# h' D. b$ D* u6 r# k
21.     else   
    
22.     {  
    , I  W0 `0 o) V* b6 ~" h% r
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    
25.   }  
    
26.   else  
    ; h% e6 q9 X* I, E1 f
27.   {  
    
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    ' {6 u* S/ K3 E" c, u. d4 y
29.   }  
    
30. }

复制代码

    当客户端开始连接之后，那么被设置的tcp_echoserver_accept()回调函数就会被调用。该函数主要是创建一个新的数据结构，并且将该数据结构传递给底层的TCP，最后分别是设置receive，error和poll这三个回调函数。
) ]' j/ `7 i$ d+ a, w! G) g7 V　　
$ e" z& }1 O" h　　tcp_echoserver_accept()代码如下所示：

1. static err_t tcp_echoserver_accept(void *arg, struct tcp_pcb *newpcb, err_t err)  
   : f( z0 s) h  i' s9 |( c  X
2. {  
   
3.   err_t ret_err;  
   $ [" X$ `/ }# P; F" p  h6 S/ k
4.   struct tcp_echoserver_struct *es;  
   
5.   
   ) @) F, ^, s% f" P+ J8 O( w
6.   LWIP_UNUSED_ARG(arg);  
   
7.   LWIP_UNUSED_ARG(err);  
   & c' h9 o& u: G5 Q7 m
8.   
   
9.   ///给新的连接设置优先级  
   5 e& @) a1 |" _  y+ ~1 ]
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    
11.   
    
12.   //分配一个结构体空间以保持TCP的连接  
    
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    
14.   if (es != NULL)  
    
15.   {  
    ) ~2 y6 F) W1 d' J3 o
16.     es->state = ES_ACCEPTED;  
    7 m8 ?, F& E6 `' \8 S
17.     es->pcb = newpcb;  
    5 N! u( q. W- b
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    
21.     tcp_arg(newpcb, es);  
    
22.       
    5 M: [% O- o& S% w7 d
23.     //为新的连接设置receive回调函数   
    
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    : ?& w/ p) Y$ B$ ]+ z
25.       
    & ]1 Z/ F; [) C7 n6 ?
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    2 @5 J: ?0 C/ j( M- {/ ?
28.       
    
29.     //为新的连接设置poll回调函数  
    
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
      Z% J. o/ {7 H7 I! B1 `
31.       
      G" J( d3 ^7 s/ T3 o
32.     ret_err = ERR_OK;  
    ( i4 ^4 p: b/ C/ I' y  |6 q6 ^4 w
33.   }  
    
34.   else  
    # t7 ]9 h: Y% Y: J, r
35.   {  
    
36.     /* return memory error */  
    0 C, z$ t$ e; x7 c
37.     ret_err = ERR_MEM;  
    
38.   }  
    
39.   return ret_err;   
    . z& \6 D9 o% a, m5 J) X
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   
2. {  
   2 O% x; I8 O* {' O
3.   struct tcp_echoserver_struct *es;  
   ( d2 D8 ?2 u1 e
4.   err_t ret_err;  
   
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   : ?: L9 z5 X9 C/ }& q
7.    
   
8.   es = (struct tcp_echoserver_struct *)arg;  
   
9.   
   
10.   if (p == NULL)  
    - n4 e/ e, O$ W, s" i% d
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
    7 A% G8 L  d& L6 C- H
13.    ...  
    3 h. p9 @- @! J8 a
14.   }     
    3 t3 K2 R4 J- W5 T
15.   else if(err != ERR_OK)  
    * n/ D' M* N5 m$ i& j
16.   {  
    / f1 d9 m' d, B8 r4 F
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    7 q  t, o5 z& I: H- q9 |
18.    ...  
    
19.   }  
    ) q1 p) t# Q5 r+ N% `9 q2 f/ D
20.   else if(es->state == ES_ACCEPTED)  
      E/ b1 v0 A* N3 x! z9 v5 o
21.   {  
    + d9 Q$ C1 y5 P. U: D8 V
22.    //连接成功，在这里需要设置sent回调函数  
    
23.    ...  
    
24.   }  
    
25.   else if (es->state == ES_RECEIVED)  
    - R, n$ c8 c. g9 |! S( V% C! v
26.   {  
      ^& ~1 K3 h; e4 J4 b9 m+ q5 j
27.    //从客户端收到数据  
    
28.    ...  
    
29.   }  
    6 @3 G  m% i' ?5 E
30.   else  
    
31.   {  
    7 A  t3 `5 a( l$ S% ?' a, y- O
32.    //当连接关闭时，还收到了数据  
    1 _3 X; |$ A: n5 O
33.    ...  
    & R2 s# F9 S& q/ @" ]
34.   
    7 l( \7 g! z$ N
35.   }  
    $ V# C& [; p9 X) e* M) B+ _9 o
36.    
    8 Q3 |* |2 U; J1 l0 G
37.   return ret_err;  
    
38. }  

复制代码

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

5 ]/ |" q6 L" }* C$ ], Y3 u- |, K

　如果我们的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
4 o: o& u7 \& D# f1 t# T+ c* q　　
　　如果网络联通的话，测试成功将如下如下的画面，如图：

. a9 B. h& r' F- E# Y: t) R' ]

( T+ I8 I. z: [4 h4 a
7 o# J# M2 `+ b4 k1 ]6 ^
1 f1 g6 t& Q0 R1 b/ Z8 n