//=====================================================================
//TITLE:
//    STM32F2xx的tcp_echoserver例程解说
7 p% i; L) X3 |) w) s- L; g2 c5 @  z4 i//AUTHOR:
//    norains
//DATE:
0 i! M6 C8 y0 \//    Monday  04-July-2011
//Environment:
2 S0 e+ {& c" F& o! `//    Keil MDK 4.2
2 ^, h0 S  Z& z: L//    STM32F207 核心版
( I: V. |' {+ v$ J3 \2 Z7 r//=====================================================================

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

( e6 u1 J: A) v$ x6 q0 @0 o, ~

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
     1. 创建一个新的TCP协议控制块
     2. 绑定地址和端口号（port）
     3. 开始监听（listen）
( W2 ~' l" I0 r. t! z     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   ! o7 _) L* Q3 q+ d( E! ^8 y
2. {  
   5 L$ J  A8 \8 _5 ^$ o4 ^
3.   //创建一个新的TCP控制块  
   
4.   tcp_echoserver_pcb = tcp_new();  
   9 j; F0 h- z  r3 t( I9 ^, @
5.   
   " H- }  o, F( w
6.   if (tcp_echoserver_pcb != NULL)  
   
7.   {  
   
8.     err_t err;  
   
9.       
   
10.     //绑定到端口7  
    ! I3 Z- L: Z& t* ~2 @# v
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    % w$ X/ s4 `1 z8 t
12.       
    5 q- P) d; T8 I, r# L0 n- s" \
13.     if (err == ERR_OK)  
    
14.     {  
    + q$ ^' ]# H1 j& T* o+ g9 C
15.       //开始监听  
    
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    
17.         
    - S% k+ ~$ `. u% o+ y/ V& a/ b7 R3 M
18.       //设置tcp_echoserver_accept为accept的回调函数  
    2 _, I$ o- G$ z0 [
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    2 R  Q, X& C' |- F3 I* l, l" z9 [8 w
20.      }  
    
21.     else   
    ! ?) F% C& v% q! Y* f! l
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    
25.   }  
    
26.   else  
    
27.   {  
    4 _- t; \1 W8 ^' u/ P. m
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    
29.   }  
    4 U- l$ G+ F+ L5 h' ^
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)  
   
2. {  
   ( k( ]1 V8 F8 D- A1 c9 U! l
3.   err_t ret_err;  
   
4.   struct tcp_echoserver_struct *es;  
   
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   
7.   LWIP_UNUSED_ARG(err);  
   # c- A8 j. F0 {. ?. u
8.   
   : ?; Y5 C5 b& K6 _& ]
9.   ///给新的连接设置优先级  
   
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    3 Q+ j+ o0 f! ~) F' s
11.   
    
12.   //分配一个结构体空间以保持TCP的连接  
    7 ]5 o, r, U! q. m( T. @
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    
14.   if (es != NULL)  
    2 C9 Y" k2 y% T( C5 J" i" ~
15.   {  
    6 @/ Y3 x- i  u3 \
16.     es->state = ES_ACCEPTED;  
    , L4 }, _/ c1 |$ h
17.     es->pcb = newpcb;  
      f3 r9 `, ~' v' B$ y
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    ( V9 c4 d6 f# \+ S
21.     tcp_arg(newpcb, es);  
    
22.       
    
23.     //为新的连接设置receive回调函数   
    6 U$ W' Z  U# W+ z" c# N8 s
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    # k% G4 A: l# s+ M8 R. n# ^3 q
25.       
    , k/ ?* r5 A) o  I$ S
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    ; y" q4 ~% S! ~, d6 s  Z
28.       
    
29.     //为新的连接设置poll回调函数  
    6 [& t# X4 k# E
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    ( D4 k) |  L0 _* ?& e; O6 e0 a" v
32.     ret_err = ERR_OK;  
    - v* F* }' p* _6 k5 k
33.   }  
    
34.   else  
    
35.   {  
    
36.     /* return memory error */  
    ) o9 ?  D$ N! O, x. a; ~
37.     ret_err = ERR_MEM;  
    
38.   }  
    % A5 P+ y! t1 u' j/ `5 O( ?, f
39.   return ret_err;   
    ' Q0 p/ {1 T2 b9 f
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   " k, V% H) D5 d" U! c8 N
2. {  
   
3.   struct tcp_echoserver_struct *es;  
   8 N7 |3 O- x* s2 R# K
4.   err_t ret_err;  
   3 {$ J  g* Z4 w
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   
7.    
   8 i/ g4 N) m, Q$ m* I1 q; q
8.   es = (struct tcp_echoserver_struct *)arg;  
   
9.   
   
10.   if (p == NULL)  
    4 K$ s# K! V1 u+ \; l9 A
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
    ) n9 X' `' y. g$ t
13.    ...  
    
14.   }     
    ' u. m6 c3 o' }1 y
15.   else if(err != ERR_OK)  
    6 m% K- g, ?. {, `' L  Z& S% s
16.   {  
    ! _- D3 P; p& B0 Z4 |2 W( ~! `
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    
18.    ...  
    8 G- H7 c0 [2 x$ C; o/ F% k2 c# h
19.   }  
    
20.   else if(es->state == ES_ACCEPTED)  
    ) p( S6 T5 H+ T# Q
21.   {  
    ; q; }6 I) v% a  [3 [  @
22.    //连接成功，在这里需要设置sent回调函数  
    
23.    ...  
    
24.   }  
    % m/ W, m* x' o% D9 V# t% p
25.   else if (es->state == ES_RECEIVED)  
    + D1 k+ k  U/ g8 b. Y* B& _& @
26.   {  
    % L( {. z3 G: H1 C
27.    //从客户端收到数据  
    
28.    ...  
    
29.   }  
    
30.   else  
    $ r7 ~* f/ a( O" u
31.   {  
    
32.    //当连接关闭时，还收到了数据  
    
33.    ...  
    
34.   
    ' J7 L: Q2 |( a) @
35.   }  
    6 n) w: @: c. M. c0 Y) r& }/ {: m% Q
36.    
    
37.   return ret_err;  
    
38. }  

复制代码

STM32F207的代码部分就暂时说到这里，现在的问题是，如何 测试这代码的正确性呢？这就必须用到ST提供的echotool.exe程序了。该程序位于stm32f2x7_eth_lwip的PC_Software文件夹中。该程序必须在命令行打开，其大致参数如下所示：
3 e  H5 G6 i' d$ t
# {* k  W% K) R* J4 i! s# k+ z

0 K" a9 m4 b  m4 \. h
5 [4 p3 U3 Q7 X& v　如果我们的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
　　
　　如果网络联通的话，测试成功将如下如下的画面，如图：
5 V' K6 M, z' k4 C4 G0 g) h0 {

2 v: e' {* P* r( s+ F: \& H
# g1 e6 e1 [, L& y4 r/ `! J