//=====================================================================
8 Y& M  \" u$ x//TITLE:
& ~! [! v. ?/ P  Z& r//    STM32F2xx的tcp_echoserver例程解说
//AUTHOR:
//    norains
//DATE:
//    Monday  04-July-2011
9 _' j# H! [* u! N2 [//Environment:
; k5 g) u/ {/ g% C' `//    Keil MDK 4.2
//    STM32F207 核心版
. Z/ v$ Y4 [6 u% z//=====================================================================

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

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
     1. 创建一个新的TCP协议控制块
4 [+ b% w" J8 F; G  I     2. 绑定地址和端口号（port）
     3. 开始监听（listen）
     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   
2. {  
   ( w# a5 O5 s2 E& b
3.   //创建一个新的TCP控制块  
   
4.   tcp_echoserver_pcb = tcp_new();  
   9 R& [2 p; D; }4 y
5.   
   
6.   if (tcp_echoserver_pcb != NULL)  
   / f$ E1 m- ~. Y' d3 D" Q
7.   {  
   
8.     err_t err;  
   8 F0 g$ }# F% Z7 A6 E* i- Y
9.       
   
10.     //绑定到端口7  
    8 N0 J" o& T6 d1 U
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    ! \, r- ^* b5 P
12.       
    
13.     if (err == ERR_OK)  
    : z5 v+ y' ^' L7 V* h  O" `& m
14.     {  
    
15.       //开始监听  
    8 m  [/ u* _. C- ~/ z( J% x
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    
17.         
    5 S3 h1 v0 X5 `4 L! }3 \: i/ N
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    6 f9 X) N  `% k
20.      }  
    
21.     else   
    
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    
24.     }  
    
25.   }  
      H! ?' ?/ L* z1 V9 S# P6 D
26.   else  
    
27.   {  
    % I# R( F6 e8 b- n* t
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    . W7 X* u* O' X6 W
29.   }  
    : l3 l0 H: Y* G
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)  
   $ @; S2 `9 {6 Z/ O) w2 B& p: Z3 n1 K
2. {  
   ) b# T0 Z  P9 [' N! G
3.   err_t ret_err;  
   
4.   struct tcp_echoserver_struct *es;  
   ) J1 K2 t- R6 Z3 ~
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   " o0 @0 R. F6 p7 ^; ]/ b) H
7.   LWIP_UNUSED_ARG(err);  
   ; h4 T) c: s  D& S$ f
8.   
   2 ?1 L( j! T8 m$ V
9.   ///给新的连接设置优先级  
   * P. t( [3 u: S7 [; e
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    $ _6 v) ]* p$ ^, q  O$ L
11.   
    
12.   //分配一个结构体空间以保持TCP的连接  
    
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    
14.   if (es != NULL)  
    
15.   {  
    + c( E1 {. a' R: ?( S
16.     es->state = ES_ACCEPTED;  
    . s4 Q2 n& Q- B  i3 O8 p% P3 M' I
17.     es->pcb = newpcb;  
    + t# I* y( C. P' Q2 F( B" ^5 j
18.     es->p = NULL;  
    
19.       
    ) i0 W$ m0 z2 r; R0 |+ n
20.     //传递新分配的结构体数据给新的pcb  
    
21.     tcp_arg(newpcb, es);  
    / k' L0 t/ C9 M2 X2 u* R2 N
22.       
    
23.     //为新的连接设置receive回调函数   
    0 s1 p7 D, V" z+ L& ]' r& c
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    
25.       
    % x% J! ~1 o7 c! @; O2 O
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    
28.       
    
29.     //为新的连接设置poll回调函数  
    
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    4 H9 Y* \& V3 q) Q7 y% N
32.     ret_err = ERR_OK;  
    3 p. @# X& E: z& `' g5 a6 s) u! q
33.   }  
    ) D- ]) T- J% ~2 E$ ]( e( I
34.   else  
    
35.   {  
    
36.     /* return memory error */  
    " x# k' f4 s# Q( e! H  u
37.     ret_err = ERR_MEM;  
    
38.   }  
      E5 J: {0 v: ?! U* u5 N$ P: Q
39.   return ret_err;   
    : X8 F5 ]6 k; B  D% p9 M0 S
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   % l7 Z0 k5 o% n, ^3 c
2. {  
   
3.   struct tcp_echoserver_struct *es;  
   
4.   err_t ret_err;  
   
5.   
   ' D5 ^3 z) [5 A9 i$ k
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   
7.    
   $ L% L0 l) e/ ]6 N8 s% C
8.   es = (struct tcp_echoserver_struct *)arg;  
   3 C# Z6 I. ]3 X  }
9.   
   
10.   if (p == NULL)  
    
11.   {  
    
12.    //如果接收到空的帧，则释放连接  
      k/ n, u& A/ U, t. @
13.    ...  
    
14.   }     
    ; R9 S) M3 z& F. R! B# z
15.   else if(err != ERR_OK)  
    
16.   {  
    # n" V1 N& ^) R6 X* V+ e
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    * e# u( @) |" G/ {
18.    ...  
    
19.   }  
    
20.   else if(es->state == ES_ACCEPTED)  
    
21.   {  
    & p$ F& |$ S( I$ y- l; p" }! H
22.    //连接成功，在这里需要设置sent回调函数  
    
23.    ...  
    
24.   }  
    $ W: c% ~: F! v
25.   else if (es->state == ES_RECEIVED)  
    9 L: y, i/ A- M$ S
26.   {  
    
27.    //从客户端收到数据  
    
28.    ...  
    7 M! D- Y' g0 R) @
29.   }  
    
30.   else  
      k. D9 G* D- P; Z3 I: C$ s
31.   {  
    - l7 G2 _0 {5 K/ B* V
32.    //当连接关闭时，还收到了数据  
    & B! S3 B3 \% r! [' R3 k) G! x6 X2 l
33.    ...  
    7 u2 A  H  J6 l: ~
34.   
    . p, ?2 g% `2 f
35.   }  
    6 c) @2 z: u6 U* E2 H
36.    
    
37.   return ret_err;  
    2 N1 c: k+ q- Q: B4 Z6 u, k0 ^
38. }  

复制代码

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

: s5 H, f1 |6 R& @8 m/ Y

& u9 O6 D/ F& t7 u  r
　如果我们的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
2 O1 Z8 G- x3 |, [+ C　　
　　如果网络联通的话，测试成功将如下如下的画面，如图：
8 y5 K' t7 E4 j" t; b
# G( ], j! i. F

- P6 L. a' X! j/ q% x' u( M

: b- M; ~* k% Y4 ?, c0 ^