//=====================================================================
//TITLE:
//    STM32F2xx的tcp_echoserver例程解说
+ s! T% Z8 S% ^' N( \' \3 V//AUTHOR:
//    norains
//DATE:
# T% T+ X1 Y4 ~/ q1 w2 d% \//    Monday  04-July-2011
//Environment:
. b* Q: P( e) G//    Keil MDK 4.2
4 E, L, _  A9 C+ N* I, x//    STM32F207 核心版
//=====================================================================

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

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
4 A( Q8 K" X2 E( E& O     1. 创建一个新的TCP协议控制块
8 T4 v5 v7 F; }9 }  h     2. 绑定地址和端口号（port）
     3. 开始监听（listen）
     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   / F' T$ S$ t! _/ E7 Z
2. {  
   
3.   //创建一个新的TCP控制块  
   
4.   tcp_echoserver_pcb = tcp_new();  
   1 H& Z0 u9 i4 k
5.   
   
6.   if (tcp_echoserver_pcb != NULL)  
   2 u& f" Y% B- u% A4 e; g4 Y
7.   {  
   
8.     err_t err;  
   
9.       
   7 a& T( y0 m/ F6 a
10.     //绑定到端口7  
    
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    3 W7 _8 i+ E! O  x: Y; C
12.       
    
13.     if (err == ERR_OK)  
    8 d, S9 p$ i0 j# u, J3 F7 E. ]
14.     {  
    ; a- p+ x1 t/ H; j  Y% N  v. V1 `
15.       //开始监听  
    & s5 `+ a+ h  L
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    # P- Y$ t3 P4 }  a8 x4 a8 E6 o
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    
20.      }  
    
21.     else   
    
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    8 K$ f1 j/ \& A8 ^( h
25.   }  
    ' T5 H6 e# m) V: o# h6 @3 k
26.   else  
    6 H( K& K: ~$ C4 H( W' y: s6 o# F, V
27.   {  
    
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    
29.   }  
    
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)  
   * N) m5 g8 ~: h3 J
2. {  
   9 r- H! p' I: X) |# c
3.   err_t ret_err;  
   
4.   struct tcp_echoserver_struct *es;  
   7 {4 p. b2 D" t  y9 S/ v2 a. {2 I
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   6 c  y2 O8 r* T
7.   LWIP_UNUSED_ARG(err);  
   8 N) [# E  Y/ }7 [( U; M+ H' s3 S3 |
8.   
   
9.   ///给新的连接设置优先级  
   
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    
11.   
    $ p1 G/ L  N1 M6 @5 D1 E
12.   //分配一个结构体空间以保持TCP的连接  
    
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    : m* s' C) t9 O% g
14.   if (es != NULL)  
    
15.   {  
    
16.     es->state = ES_ACCEPTED;  
    / S8 r( w  c' l+ e8 v
17.     es->pcb = newpcb;  
    1 f/ N, f! M4 V- Q; M9 l
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    * g9 q( x0 Y+ _/ `+ ]  p! t0 c) V  v5 A
21.     tcp_arg(newpcb, es);  
    
22.       
    
23.     //为新的连接设置receive回调函数   
    
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    
25.       
    3 V7 j1 \6 A! {2 f+ O6 j7 o
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    9 k6 J+ Q9 B* G/ ~
28.       
    
29.     //为新的连接设置poll回调函数  
    
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    
32.     ret_err = ERR_OK;  
    
33.   }  
    # H1 J5 b0 M! B# X
34.   else  
    2 B, s7 V2 T8 A( Z* @( h6 q
35.   {  
    # w( K( r; A- m* K( T
36.     /* return memory error */  
    
37.     ret_err = ERR_MEM;  
    , f, @5 W) W+ x8 u
38.   }  
    , _$ [4 N( `2 W$ ^: U7 y
39.   return ret_err;   
    ; B$ S5 V. c. q
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   
2. {  
   " t4 k& |. M' L2 B2 S
3.   struct tcp_echoserver_struct *es;  
   ) m! o& d4 ~2 G& f. w
4.   err_t ret_err;  
   * U! c2 G! H  @! b; L0 {
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   ) A. K' [$ [/ C% I1 O' Z' r
7.    
   
8.   es = (struct tcp_echoserver_struct *)arg;  
   
9.   
   % W+ }, B- O9 J% M' b) w
10.   if (p == NULL)  
    9 D1 t6 ]8 d' n' i7 N) o
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
    
13.    ...  
    
14.   }     
    
15.   else if(err != ERR_OK)  
    3 q, D; ~3 P& Y# a7 x
16.   {  
    . i) f  K5 P5 c' d
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    0 Y6 [$ y) p5 r% G
18.    ...  
    
19.   }  
    2 G- a- U$ e" C% @
20.   else if(es->state == ES_ACCEPTED)  
    ( x0 D! w+ M; g! m  i8 @
21.   {  
    
22.    //连接成功，在这里需要设置sent回调函数  
    0 F* R9 r2 C3 a; M- n& H# ?
23.    ...  
    & O6 W, y# h+ F. ~" V- i3 H
24.   }  
      g& E* x5 Q4 T: R) U
25.   else if (es->state == ES_RECEIVED)  
    / ?9 A3 _: P$ d% s
26.   {  
    : a! B+ y/ [( V
27.    //从客户端收到数据  
    , y) L" z; k3 s# H1 @
28.    ...  
    4 l1 S! I& X2 [4 M
29.   }  
    " ]6 M: y: @" s: q
30.   else  
    
31.   {  
    
32.    //当连接关闭时，还收到了数据  
    
33.    ...  
    
34.   
    
35.   }  
    
36.    
    
37.   return ret_err;  
    
38. }  

复制代码

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

2 h% w+ [' Q+ Q8 E

; o/ z$ k! s5 o6 `$ @# w: @8 e　如果我们的serverip地址为192.168.0.8，那么可以输入如下命令进行测试：
7 n- `; N% `' }1 B. M8 S4 H5 U4 L  a6 w　　 echotool.exe 192.168.0.8 /p tcp /r 7 /n 15 /t 2 /d Testing LwIP TCP echo server
% j# f! d( H/ k- X+ u　　
& G6 w3 r9 y. }- v( Y; B! T# z2 B　　如果网络联通的话，测试成功将如下如下的画面，如图：

) k& M! g( k# J# p0 `- w

% V+ \* G: R$ B+ d. d. q
& |3 |* m: q3 T* Q, e; ~
$ S; R& N6 W2 k' T- }$ G
3 q0 n) a5 m% {6 U5 E4 ^