//=====================================================================
5 l+ B" g$ U! A//TITLE:
3 Y) j$ D5 {2 k% r1 G$ [//    STM32F2xx的tcp_echoserver例程解说
2 u8 o: E* T) v//AUTHOR:
//    norains
) v! Q) |$ g2 w- S+ \8 |/ c7 v% z//DATE:
//    Monday  04-July-2011
# p9 u6 b: z0 g, j1 ?" V% I//Environment:
//    Keil MDK 4.2
//    STM32F207 核心版
//=====================================================================

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

( j9 ~4 o4 ]( d5 p

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

    在tcp_echoserver_init()函数里，主要做了这么几件事情：
. I6 q1 c$ M9 n8 a- R     1. 创建一个新的TCP协议控制块
     2. 绑定地址和端口号（port）
8 j7 N& j5 v: V! J; o     3. 开始监听（listen）
) |- x3 w- ]  O* @) g2 L1 o$ G: Q     4. 设置accept的回调函数

    其完整代码如下：

1. void tcp_echoserver_init(void)  
   
2. {  
   , Z2 H( G! z+ C
3.   //创建一个新的TCP控制块  
   4 l7 i* X/ L9 W2 m
4.   tcp_echoserver_pcb = tcp_new();  
   0 i0 ~7 }9 Y+ l: w; n7 X: Q& ?: I
5.   
   
6.   if (tcp_echoserver_pcb != NULL)  
   ! T) Q* l3 ]7 }" s
7.   {  
   
8.     err_t err;  
   
9.       
   4 D4 z- S: ]- y* P. ?
10.     //绑定到端口7  
    + Q/ u0 R5 F& U! b1 W$ C
11.     err = tcp_bind(tcp_echoserver_pcb, IP_ADDR_ANY, 7);  
    / g4 V5 o+ }) X3 i
12.       
    ! X. E& f" g( J
13.     if (err == ERR_OK)  
    2 v+ Y$ {" `6 ?! E# P  q8 D* i; g
14.     {  
    ; d8 L. z8 m( W1 V
15.       //开始监听  
    6 g- w* u) h+ j* T
16.       tcp_echoserver_pcb = tcp_listen(tcp_echoserver_pcb);  
    + b  M9 H6 N' y5 E
17.         
    
18.       //设置tcp_echoserver_accept为accept的回调函数  
    
19.        tcp_accept(tcp_echoserver_pcb, tcp_echoserver_accept);  
    ) {/ L. d: X, E" k
20.      }  
    
21.     else   
    
22.     {  
    
23.         printf("Can not bind pcb\n");  //norains 2011-7-4 comment  
    ' @, P- o$ T! s7 X7 T7 M/ Y, i
24.     }  
    6 B; E' ^5 M4 m( ]
25.   }  
    8 j  g& ?% `% Q: A9 a: ^+ j) H" n2 e
26.   else  
    7 P7 I# d8 T0 o- d8 \$ i
27.   {  
    0 h" D4 G- a& p1 M% h, E; h, V
28.     printf("Can not create new pcb\n");   //norains 2011-7-4 comment  
    
29.   }  
    
30. }

复制代码

    当客户端开始连接之后，那么被设置的tcp_echoserver_accept()回调函数就会被调用。该函数主要是创建一个新的数据结构，并且将该数据结构传递给底层的TCP，最后分别是设置receive，error和poll这三个回调函数。
! A, J& n2 D; O+ U4 O) I　　
0 l3 M9 d2 u/ T2 n2 E  ?　　tcp_echoserver_accept()代码如下所示：

1. static err_t tcp_echoserver_accept(void *arg, struct tcp_pcb *newpcb, err_t err)  
   
2. {  
     e2 W% j# O& H. G7 e# _: Y! O
3.   err_t ret_err;  
   ; J. G! F4 F2 ~" @- a( H' R' z
4.   struct tcp_echoserver_struct *es;  
   
5.   
   
6.   LWIP_UNUSED_ARG(arg);  
   / p' X1 s9 N6 j) o0 m+ C9 f
7.   LWIP_UNUSED_ARG(err);  
   ; u" U9 B: G  g$ u
8.   
   
9.   ///给新的连接设置优先级  
   3 C+ B9 A# _5 N) [
10.   tcp_setprio(newpcb, TCP_PRIO_MIN);  
    3 @" p2 u3 B- T0 @* f
11.   
    
12.   //分配一个结构体空间以保持TCP的连接  
    
13.   es = (struct tcp_echoserver_struct *)mem_malloc(sizeof(struct tcp_echoserver_struct));  
    / V3 ?6 `1 t' ~* X' Q- v' q6 @
14.   if (es != NULL)  
    
15.   {  
    
16.     es->state = ES_ACCEPTED;  
    . O/ k0 L: B, K8 y/ ~
17.     es->pcb = newpcb;  
      W5 x; t4 n$ N- Q  V
18.     es->p = NULL;  
    
19.       
    
20.     //传递新分配的结构体数据给新的pcb  
    
21.     tcp_arg(newpcb, es);  
    / Z. G6 Q8 E1 W1 l& r
22.       
    
23.     //为新的连接设置receive回调函数   
    : m( p2 P1 w: ]% A
24.     tcp_recv(newpcb, tcp_echoserver_recv);  
    
25.       
    # D" f+ H0 l) D. N. t' o; g- b
26.     //为新的连接设置error回调函数  
    
27.     tcp_err(newpcb, tcp_echoserver_error);  
    $ [6 w; b8 t. a4 I/ }# L# c
28.       
    ' N8 ~* W% Y% D' p5 f8 ~1 h, b5 U* `
29.     //为新的连接设置poll回调函数  
    9 I2 x) j3 W: i" s2 ]4 b; T: y. _
30.     tcp_poll(newpcb, tcp_echoserver_poll, 1);  
    
31.       
    
32.     ret_err = ERR_OK;  
    
33.   }  
    
34.   else  
    + ]9 B; [+ _3 l8 U/ x
35.   {  
    . S- x1 k0 V% p: f( i9 d* G6 b
36.     /* return memory error */  
    ) s  G  Q! F% E3 A6 _1 U
37.     ret_err = ERR_MEM;  
    
38.   }  
    
39.   return ret_err;   
    
40. }

复制代码

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

1. static err_t tcp_echoserver_recv(void *arg, struct tcp_pcb *tpcb, struct pbuf *p, err_t err)  
   
2. {  
   6 J8 C; |# p$ G5 g
3.   struct tcp_echoserver_struct *es;  
   4 K& Y# Y2 V* D
4.   err_t ret_err;  
   
5.   
   
6.   LWIP_ASSERT("arg != NULL",arg != NULL);  
   7 ]# u1 D. z- E( [& C4 k+ R
7.    
   
8.   es = (struct tcp_echoserver_struct *)arg;  
   * `; r; S; O4 D( L7 O- f+ a0 g
9.   
   - _0 }# g: J5 ?0 u) ?2 M' J
10.   if (p == NULL)  
    : `' \2 V' g5 o  M
11.   {  
    7 E% l  |. O  [: {$ j" f. ^; q$ F! u2 x6 _
12.    //如果接收到空的帧，则释放连接  
    
13.    ...  
    & k: ?" n" R: G+ m+ K
14.   }     
    / w+ D/ P! Y$ w# N+ Y
15.   else if(err != ERR_OK)  
    ; H7 U# b$ d5 u& h/ M' K4 C! L
16.   {  
    
17.    //接收到一个非空的帧，但可能某些原因出错，导致返回值不为ERR_OK，故在此释放缓存  
    0 S2 o. ^. s% |$ M' O
18.    ...  
    9 |7 V' m3 |5 ], V
19.   }  
    5 \' }( K& J4 @# g2 j4 ^6 `
20.   else if(es->state == ES_ACCEPTED)  
    - o% }) r- U; f  y
21.   {  
    
22.    //连接成功，在这里需要设置sent回调函数  
    3 J- `8 Z  n$ a6 K# E0 ^& [) C
23.    ...  
    
24.   }  
    0 G6 C% {/ z. i. F) e
25.   else if (es->state == ES_RECEIVED)  
    1 x' u+ |, \4 B$ D% V% z" F
26.   {  
    - V& |/ [) U/ @2 C
27.    //从客户端收到数据  
    
28.    ...  
    ) D. o/ u, X; `% B/ p9 F
29.   }  
    
30.   else  
    
31.   {  
    
32.    //当连接关闭时，还收到了数据  
    
33.    ...  
    9 A8 v* |- ^; [& V, q
34.   
    
35.   }  
    - U3 U7 a% ?1 q
36.    
    $ G7 {' P, K+ g2 p7 v1 w2 D
37.   return ret_err;  
    ! {/ L& S7 `" _
38. }  

复制代码

STM32F207的代码部分就暂时说到这里，现在的问题是，如何 测试这代码的正确性呢？这就必须用到ST提供的echotool.exe程序了。该程序位于stm32f2x7_eth_lwip的PC_Software文件夹中。该程序必须在命令行打开，其大致参数如下所示：
7 j/ ~& Y! ]8 v/ h; Y* i) M# S1 O

+ z6 u7 w2 [8 C- w* D
　如果我们的serverip地址为192.168.0.8，那么可以输入如下命令进行测试：
" ?+ }3 p* t6 c　　 echotool.exe 192.168.0.8 /p tcp /r 7 /n 15 /t 2 /d Testing LwIP TCP echo server
0 f1 e0 f4 h5 H3 X5 Y) U; i4 y6 [　　
　　如果网络联通的话，测试成功将如下如下的画面，如图：

( @* G  i2 z4 [% N, ^0 j

. g- E# [" v$ X- }