【RL-TCPnet网络教程】第32章 RL-TCPnet之Telnet服务器

席萌0209

第32章      RL-TCPnet之Telnet服务器

         本章节为大家讲解RL-TCPnet的Telnet应用，学习本章节前，务必要优先学习第31章的Telnet基础知识。有了这些基础知识之后，再搞本章节会有事半功倍的效果。
        本章教程含STM32F407开发板和STM32F429开发板。
32.1 初学者重要提示
32.2 Telnet函数
32.3 Telnet配置说明（Net_Config.c）
32.4 Telnet调试说明（Net_Debug.c）
32.5 Telnet访问方法和板子的操作步骤
32.6 实验例程说明（裸机）
32.7 实验例程说明（RTX）
32.8      总结



32.1  初学者重要提示

1、学习本章节前，务必保证已经学习了第31章的基础知识。
2、对于初学者，务必要看本章节32.5小节的测试方法。

席萌0209

32.2 Telnet函数


       使用如下9个函数可以实现RL-TCPnet的Telnet：
（1）tnet_check_account
（2）tnet_accept_host
（3）tnet_cbfunc
（4）tnet_ccmp
（5）tnet_get_info
（6）tnet_get_user_id
（7）tnet_process_cmd
（8）tnet_set_delay
（9）tnet_msg_poll
关于这9个函数的讲解及其使用方法可以看教程第 3 章 3.4 小节里面说的参考资料 rlarm.chm 文件：

这里我们重点的说以下4个函数，因为本章节配套的例子使用的是这4个函数：
（1）tnet_cbfunc
（2）tnet_process_cmd
（3）tnet_ccmp
（4）tnet_get_info
关于这些函数注意以下一点：
1、Telnet的所有函数都不支持重入，也就是不支持多任务调用。

32.2.1    函数tnet_cbfunc


函数原型：

1. U16 tnet_cbfunc (
2.     U8  code,        /* 消息类型 */
3.     U8* buf,         /* 输出缓冲区地址 */
4. U16 buflen );    /* 输出缓冲区大小 */

复制代码

函数描述：
函数tnet_cbfunc是Telnet服务器的回调函数，主要用于设置Telnet服务器给Telnet客户端发送连接和登录消息（为了更好理解此函数，实际操作一遍本章节配套的例子就明白了）。
1、第1个参数是消息类型，具体支持的消息类型如下：

2、第2个参数是输出缓冲区地址，用于存储服务器返回给客户端的消息。
3、第3个参数是输出缓冲区大小，单位字节。
4、返回值，返回使用的输出缓冲区大小，单位字节。
使用这个函数要注意以下问题：
1.     输出缓冲区的大小是由TCP Socket的MSS最大报文段大小决定的，局域网中一般是1400字节左右，但是也可减小到500字节，甚至更小。
2.     写到输出缓冲区的数据，不可以超过第三个参数buflen的大小，否则会造成内存指针链表的损坏，从而很容易造成系统崩溃。
3.     Telnet服务器不会自动扩展回车符，所以每个消息结束后务必自行加上回车和换行符。
使用举例：

1. /*----------------------------------------------------------------------------
2. *      Telnet CallBack Functions
3. *---------------------------------------------------------------------------*/
4. /*--------------------------- tnet_cbfunc -----------------------------------*/
6. U16 tnet_cbfunc (U8 code, U8 *buf, U16 buflen)
7. {
8.      /* This function is called by the Telnet Client to get formated system    */
9.      /* messages for different code values.                                    */
10.      /* Values for 'code':                                                     */
11.      /*    0 - initial header                                                  */
12.      /*    1 - prompt string                                                   */
13.      /*    2 - header for login only if authorization is enabled               */
14.      /*    3 - string 'Username' for login                                     */
15.      /*    4 - string 'Password' for login                                     */
16.      /*    5 - message 'Login incorrect'                                       */
17.      /*    6 - message 'Login timeout'                                         */
18.      /*    7 - Unsolicited messages from Server (ie. Basic Interpreter)        */
19.      U16 len = 0;
21.      /* Make a reference to disable compiler warning. */
22.      buflen = buflen;
24.      switch (code)
25.      {
26.          case 0:
27.               /* Write initial header after login. */
28.               len = str_copy (buf, (U8 *)&tnet_header);
29.               break;
30.         
31.          case 1:
32.               /* Write a prompt string. */
33.               len = str_copy (buf, "\\r\\narmfly> ");
34.               break;
35.          case 2:
36.               /* Write Login header. */
37.               len = str_copy (buf, CLS "\\r\\nRL-TCPnet之Telnet服务器,"
38.                                           " 请登录...\\r\\n");
39.               break;
40.         
41.          case 3:
42.               /* Write 'username' prompt. */
43.               len = str_copy (buf, "\\r\\n用户名: ");
44.               break;
45.         
46.          case 4:
47.               /* Write 'Password' prompt. */
48.               len = str_copy (buf, "\\r\\n密  码: ");
49.               break;
50.         
51.          case 5:
52.               /* Write 'Login incorrect'.message. */
53.               len = str_copy (buf, "\\r\\n登录失败");
54.               break;
55.         
56.          case 6:
57.               /* Write 'Login Timeout' message. */
58.               len = str_copy (buf, "\\r\\n120秒无操作，退出登录\\r\\n");
59.               break;
60.      }
61.    
62.      return (len);
63. }

复制代码

32.2.2   函数tnet_process_cmd


函数原型：

1. U16 tnet_process_cmd (
2.     U8*  cmd,       /* 指针变量，指向从Telnet客户端接收到的命令字符 */
3.     U8*  buf,       /* 输出缓冲区地址 */
4.     U16  buflen,    /* 输出缓冲区大小，单位字节 */
5. U32* pvar );    /* 指针变量，指向一个不会被改变的变量  */

复制代码

函数描述：
函数tnet_process_cmd用于处理Telnet客户端请求的命令。Telnet服务器从Telnet客户端收到连续的回车（CR）和换行（LF）字符序列时，会调用tnet_process_cmd函数（通常由用户在telnet客户端终端上按Enter键）。
1、第1个参数指向从Telnet客户端接收到的命令字符。
2、第2个参数是输出缓冲区地址，用于函数tnet_process_cmd执行过程中存储要返回给Telnet客户端的消息。
3、第3个参数是输出缓冲区的大小，单位字节。
4、第4个参数指向不会被Telnet服务器更改的变量。用户可以将其作为重复计数器，或者简单地区分tnet_process_cmd函数的不同调用，亦或者任何其它应用均可。
5、返回值，返回写入到输出缓冲区的字节数。返回值是U16类型的，其中bit15和bit14还可以作为其它用途，而剩余的bit0-bit13表示的最大值是16383，足够表示TCP Socket的MSS最大报文段大小的1460字节。
        （1）bit14作为函数tnet_process_cmd是否重复调用的标志，如果此位设置为1，表示退出函数后，依然保持第1个参数cmd和第4个参数*pvar的数值，并再次调用函数tnet_process_cmd。如果此位设置为0，将不再重复调用。
        （2）bit15是断开连接标志，如果此位设置为1，Telnet服务器将断开客户端会话。如果此位是0，表示继续保证连接。
使用这个函数要注意以下问题：
1.     输出缓冲区的大小是由TCP Socket的MSS最大报文段大小决定的，局域网中一般是1400字节左右，但是也可减小到500字节，甚至更小。
2.     写到输出缓冲区的数据，不可以超过第三个参数buflen的大小，否则会造成内存指针链表的损坏，从而很容易造成系统崩溃。
3.     Telnet服务器不会自动扩展回车符，所以每个消息结束后务必自行加上回车和换行符。
4.     对于每个Telnet会话，*pvar（注意，这里是指的指针变量pvar所指向的存储单元）变量都是独立的，也就是说新创建一个会话，都会有一个独立的*pvar变量。另外，每个会话首次调用函数tnet_process_cmd之前都会将变量*pvar清零（注意，这里是指的指针变量pvar所指向的存储单元清零）。
使用举例：

1. /*--------------------------- tnet_process_cmd ------------------------------*/
3. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
4. {
5.      /* This is a Telnet Client callback function to make a formatted output   */
6.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
7.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
8.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
9.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
10.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
11.      /* can be used for storing different status variables for this function.  */
12.      /* It is set to 0 by Telnet server on first call and is not altered by    */
13.      /* Telnet server for repeated calls. This function should NEVER write     */
14.      /* more than 'buflen' bytes to the buffer.                                */
15.      /* Parameters:                                                            */
16.      /*   cmd    - telnet received command string                              */
17.      /*   buf    - Telnet transmit buffer                                      */
18.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
19.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
20.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
21.      /*            - on 1st call = 0                                           */
22.      /*            - 2nd call    = as set by this function on first call       */
23.      REMOTEM rm;
24.      U16 len = 0;
26.    
27.      switch (MYBUF(pvar)->id)
28.      {
29.          case 0:
30.               /* First call to this function, the value of '*pvar' is 0 */
31.               break;
33.          case 1:
34.               /* Request a repeated call, bit 14 is a repeat flag. */
35.               return (len | 0x4000);
37.          case 2:
38.               /* Request a repeated call, bit 14 is a repeat flag. */
39.               return (len |= 0x4000);
40.      }
42.      /* Simple Command line parser */
43.      len = strlen ((const char *)cmd);
44.    
45.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
46.      {
47.           /* 'LED4' command received */
48.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
49.          bsp_LedOn(4);
50.          return (len);
51.      }
52.    
53.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
54.      {
55.          /* 'LED4' command received */
56.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
57.          bsp_LedOff(4);
58.          return (len);
59.      }
60.    
61.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
62.      {
63.           /* 'BYE' command, send message and disconnect */
64.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
65.          /* Hi bit of return value is a disconnect flag */
66.          return (len | 0x8000);
67.      }
69.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
70.      {
71.           /* Display Remote Machine IP and MAC address. */
72.          tnet_get_info (&rm);
73.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
74.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
75.          len += sprintf ((char *)(buf+len),
76.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
77.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
78.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
79.          return (len);
80.      }
82.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
83.      {
84.           /* 'HELP' command, display help text */
85.          len = str_copy (buf,(U8 *)tnet_help1);   
86.          len += str_copy (buf+len,(U8 *)tnet_help2);
87.          return (len);
88.      }
89.    
90.      /* Unknown command, display message */
91.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
92.      len += str_copy (buf+len, cmd);
93.      return (len);
94. }

复制代码

32.2.3   函数tnet_ccmp


函数原型：

1. BOOL tnet_ccmp (
2.     U8* buf,      /* 字符串地址 */
3.     U8* cmd );    /* 要比较的字符串地址 */

复制代码

函数描述：
函数tnet_ccmp用于查询字符串中是否有要找的字符。
1、第1个参数是字符串地址。
2、第2个参数是要比较的字符串，即判断第1个参数的字符串里面是否有要查找的字符。
3、返回值，如果字符串中含有要查找的字符，返回__TRUE。如果没有，返回__FALSE。
使用这个函数要注意以下问题：
1.     此函数类似C标准库函数strcmp，区别是tnet_ccmp仅比较第一个字符串，即在第1个参数buf中，该字符串由NULL字符终止，或后跟空格字符。
2.     字符串cmd中的所有字符必须大写，因为参数buf中的字符串也只有大写字母。这是因为在调用tnet_ccmp函数之前进行了内部转换。
使用举例：

1. /*--------------------------- tnet_process_cmd ------------------------------*/
3. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
4. {
5.      /* This is a Telnet Client callback function to make a formatted output   */
6.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
7.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
8.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
9.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
10.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
11.      /* can be used for storing different status variables for this function.  */
12.      /* It is set to 0 by Telnet server on first call and is not altered by    */
13.      /* Telnet server for repeated calls. This function should NEVER write     */
14.      /* more than 'buflen' bytes to the buffer.                                */
15.      /* Parameters:                                                            */
16.      /*   cmd    - telnet received command string                              */
17.      /*   buf    - Telnet transmit buffer                                      */
18.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
19.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
20.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
21.      /*            - on 1st call = 0                                           */
22.      /*            - 2nd call    = as set by this function on first call       */
23.      REMOTEM rm;
24.      U16 len = 0;
26.    
27.      switch (MYBUF(pvar)->id)
28.      {
29.          case 0:
30.               /* First call to this function, the value of '*pvar' is 0 */
31.               break;
33.          case 1:
34.               /* Request a repeated call, bit 14 is a repeat flag. */
35.               return (len | 0x4000);
37.          case 2:
38.               /* Request a repeated call, bit 14 is a repeat flag. */
39.               return (len |= 0x4000);
40.      }
42.      /* Simple Command line parser */
43.      len = strlen ((const char *)cmd);
44.    
45.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
46.      {
47.           /* 'LED4' command received */
48.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
49.          bsp_LedOn(4);
50.          return (len);
51.      }
52.    
53.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
54.      {
55.          /* 'LED4' command received */
56.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
57.          bsp_LedOff(4);
58.          return (len);
59.      }
60.    
61.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
62.      {
63.           /* 'BYE' command, send message and disconnect */
64.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
65.          /* Hi bit of return value is a disconnect flag */
66.          return (len | 0x8000);
67.      }
69.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
70.      {
71.           /* Display Remote Machine IP and MAC address. */
72.          tnet_get_info (&rm);
73.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
74.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
75.          len += sprintf ((char *)(buf+len),
76.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
77.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
78.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
79.          return (len);
80.      }
82.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
83.      {
84.           /* 'HELP' command, display help text */
85.          len = str_copy (buf,(U8 *)tnet_help1);   
86.          len += str_copy (buf+len,(U8 *)tnet_help2);
87.          return (len);
88.      }
89.    
90.      /* Unknown command, display message */
91.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
92.      len += str_copy (buf+len, cmd);
93.      return (len);
94. }

复制代码

32.2.4   函数tnet_get_info


函数原型：

1. void tnet_get_info (
2.     REMOTEM* info );    /* 结构体变量地址 */

复制代码

函数描述：
函数tnet_get_info用于返回远程客户端的IP地址和MAC地址。
1、第1个参数填写结构体变量地址，用于存储远程客户端的IP和MAC地址。
使用这个函数要注意以下问题：
1.     用户可以使用此函数设置远程客户端的操作权限，即通过此函数获取客户端地址，然后对这个客户端做操作限制。
2.     对于SLIP或者PPP连接方式，MAC地址是00-00-00-00-00-00。
使用举例：

1. /*--------------------------- tnet_process_cmd ------------------------------*/
3. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
4. {
5.      /* This is a Telnet Client callback function to make a formatted output   */
6.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
7.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
8.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
9.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
10.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
11.      /* can be used for storing different status variables for this function.  */
12.      /* It is set to 0 by Telnet server on first call and is not altered by    */
13.      /* Telnet server for repeated calls. This function should NEVER write     */
14.      /* more than 'buflen' bytes to the buffer.                                */
15.      /* Parameters:                                                            */
16.      /*   cmd    - telnet received command string                              */
17.      /*   buf    - Telnet transmit buffer                                      */
18.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
19.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
20.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
21.      /*            - on 1st call = 0                                           */
22.      /*            - 2nd call    = as set by this function on first call       */
23.      REMOTEM rm;
24.      U16 len = 0;
26.    
27.      switch (MYBUF(pvar)->id)
28.      {
29.          case 0:
30.               /* First call to this function, the value of '*pvar' is 0 */
31.               break;
33.          case 1:
34.               /* Request a repeated call, bit 14 is a repeat flag. */
35.               return (len | 0x4000);
37.          case 2:
38.               /* Request a repeated call, bit 14 is a repeat flag. */
39.               return (len |= 0x4000);
40.      }
42.      /* Simple Command line parser */
43.      len = strlen ((const char *)cmd);
44.    
45.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
46.      {
47.           /* 'LED4' command received */
48.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
49.          bsp_LedOn(4);
50.          return (len);
51.      }
52.    
53.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
54.      {
55.          /* 'LED4' command received */
56.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
57.          bsp_LedOff(4);
58.           return (len);
59.      }
60.    
61.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
62.      {
63.           /* 'BYE' command, send message and disconnect */
64.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
65.          /* Hi bit of return value is a disconnect flag */
66.          return (len | 0x8000);
67.      }
69.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
70.      {
71.           /* Display Remote Machine IP and MAC address. */
72.          tnet_get_info (&rm);
73.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
74.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
75.          len += sprintf ((char *)(buf+len),
76.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
77.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
78.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
79.          return (len);
80.      }
82.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
83.      {
84.           /* 'HELP' command, display help text */
85.          len = str_copy (buf,(U8 *)tnet_help1);   
86.          len += str_copy (buf+len,(U8 *)tnet_help2);
87.          return (len);
88.      }
89.    
90.      /* Unknown command, display message */
91.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
92.      len += str_copy (buf+len, cmd);
93.      return (len);
94. }

复制代码

席萌0209

32.3 Telnet配置说明（Net_Config.c）


         （本章节配套例子的配置与本小节的说明相同）
        RL-TCPnet的配置工作是通过配置文件Net_Config.c实现。在MDK工程中打开文件Net_Config.c，可以看到下图所示的工程配置向导：

RL-TCPnet要配置的选项非常多，我们这里把几个主要的配置选项简单介绍下。

System Definitions
（1）Local Host Name
        局域网域名。
        这里起名为armfly，使用局域网域名限制为15个字符。
（2）Memory Pool size
        参数范围1536-262144字节。
        内存池大小配置，单位字节。另外注意一点，配置向导这里显示的单位是字节，如果看原始定义，MDK会做一个自动的4字节倍数转换，比如我们这里配置的是8192字节，那么原始定义是#define MEM_SIZE  2048，也就是8192/4 = 2048。
（3）Tick Timer interval
        可取10，20，25，40，50，100，200，单位ms。
        系统滴答时钟间隔，也就是网络协议栈的系统时间基准，默认情况下，取值100ms。

Ethernet Network Interface
        以太网接口配置，勾选了此选项就可以配置了，如果没有使能DHCP的话，将使用这里配置的固定IP。
（1）MAC Address
       局域网内可以随意配置，只要不跟局域网内其它设备的MAC地址冲突即可。
（2）IP Address
        IP地址。
（3）Subnet mask
        子网掩码。
（4）Default Gateway
        默认网关。

Ethernet Network Interface
        以太网接口配置，这个配置里面还有如下两项比较重要的配置需要说明。
（1）NetBIOS Name Service
        NetBIOS局域网域名服务，这里打上对勾就使能了。这样我们就可以通过前面配置的Local Host Name局域网域名进行访问，而不需要通过IP地址访问了。
（2）Dynaminc Host Configuration
        即DHCP，这里打上对勾就使能了。使能了DHCP后，RL-TCPnet就可以从外接的路由器上获得动态IP地址。

UDP Sockets
UDP Sockets配置，打上对勾就使能了此项功能
（1）Number of UDP Sockets
        用于配置可创建的UDP Sockets数量，这里配置了5个。
        范围1 – 20。

TCP Sockets
TCP Sockets配置，打上对勾就使能了此项功能
（1）Number of TCP Sockets
        用于配置可创建的TCP Sockets数量。
（2）Number of Retries
        范围0-20。
        用于配置重试次数，TCP数据传输时，如果在设置的重试时间内得不到应答，算一次重试失败，这里就是配置的最大重试次数。
（3）Retry Timeout in seconds
        范围1-10，单位秒。
        重试时间。如果发送的数据在重试时间内得不到应答，将重新发送数据。
（4）Default Connect Timeout in seconds
        范围1-600，单位秒。
        用于配置默认的保持连接时间，即我们常说的Keep Alive时间，如果时间到了将断开连接。常用于HTTP Server，Telnet Server等。
（5）Maximum Segment Size
        范围536-1460，单位字节。
        MSS定义了TCP数据包能够传输的最大数据分段。
（6）Receive Window Size
        范围536-65535，单位字节。
        TCP接收窗口大小。

Telnet Server
Telnet配置，打上对勾就使能了此项功能
（1）Number of Telnet Connections
        范围1-10。
        服务器可以同时连接的客户端数。
（2）Port Number
        范围1-65535。
        监听的端口号，Telnet的端口号一般就是23。
（3）Idle Connection Timeout in seconds
        范围0-3600秒。
        空闲连接溢出时间，如果连接后，这段时间内无操作，Telnet服务器将断开客户端的连接。
        配置为数值0，将禁止超时断开连接，即一直保持连接。
（4）Disable Echo
        禁止回显。如果此选项打上对勾的话，服务器将不会回显接收到的字符。即用户在客户端输入的字符，不会在客户端上面显示出来，比如输入用户名，就不会将其显示出来。
（5）Enable User Authentication
        用户认证，如果此选项打上对勾的话，将使能用户认证。
        AuthenticationUsername 是用户名。
        AuthenticationPassword 是用户密码。

32.4 Telnet调试说明（Net_Debug.c）


        （重要说明，RL-TCPnet的调试是通过串口打印出来的）
        RL-TCPnet的调试功能是通过配置文件Net_Debug.c实现。在MDK工程中打开文件Net_Debug.c，可以看到下图所示的工程配置向导：

Print Time Stamp
        勾选了此选项的话，打印消息时，前面会附带时间信息。
其它所有的选项
        默认情况下，所有的调试选项都关闭了，每个选项有三个调试级别可选择，这里我们以Telnet Server Debug为例，点击下拉列表，可以看到里面有Off，Errors only和Full debug三个调试级别可供选择，每个调试选项里面都是这三个级别。

Off：表示关闭此选项的调试功能。
Errorsonly：表示仅在此选项出错时，将其错误打印出来。
Fulldebug：表示此选项的全功能调试。
具体测试，我们这里就不做了，大家可以按照第11章讲解的调试方法进行测试。

席萌0209

32.5 Telnet的访问方法和板子的操作步骤


        我们这里使用电脑端自带的Telnet客户端功能访问开发板上面建立的Telnet服务器功能。

32.5.1 使能电脑端Telnet客户端


        这里以WIN764bit为例进行说明：
1、点击电脑左下角开始按钮，选择控制面板：

2、打开后，点击“程序”：

3、弹出的界面里面选择“打开或关闭Windows功能”。

4、点击后，就会弹出Windows功能窗口：

弹出后要稍等一会，界面会变成如下这个样子：

将Telnet客户端前面单选框打上对勾，点击确定。这样就使能了电脑上的Telnet客户端。

32.5.2 登陆Telnet服务器并进行操作


        登陆开发板的Telnet方法如下：
1、WIN+R组合键打开“运行”窗口，输入cmd。

2、弹出的命令窗口中，输入telnet armfly，当然，也可以将armfly换成板子实际的IP地址：

3、输入telnet armfly后，回车。

4、用户名填admin，点击回车，密码填写123456：

最后再点击回车，就进入到开发板上的Telnet服务器。

输入命令字符“？”或者“help”就可以打印出Telnet支持的命令，输入后点击回车，可以看到支持的命令如下：

我们这里简单的测试下命令“lendon”和“rinfo”，输出命令后记得点击回车：

另外注意，如果120秒内无操作，服务器将自动断开客户端的连接，同时弹出如下消息：

还需要操作的话，重新登录即可。

席萌0209

32.6 实验例程说明（裸机）



32.6.1 STM32F407开发板实验


配套例子：
    V5-1044_RL-TCPnet实验_Telnet应用（裸机）
实验目的：
    1.     学习RL-TCPnet的Telnet应用。
实验内容：
    1.      强烈推荐将网线接到路由器或者交换机上面测试，因为已经使能了DHCP，可以自动获取IP地址。
    2.      程序中实现了一个Telnet服务器，用户名是admin，密码123456。
实验操作：
    详见本章节32.5小节。
配置向导文件设置（Net_Config.c）：
    详见本章节32.3小节。
调试文件设置（Net_Debug.c）：
    详见本章节32.4小节。
程序设计：
主函数初始化
    在main.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
14.      /* 进入RL-TCPnet测试函数 */
15.      TCPnetTest();
16. }

复制代码

硬件外设初始化
    硬件外设的初始化是在 bsp.c 文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
18.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
20.      bsp_InitUart();    /* 初始化串口 */
21.      bsp_InitKey();     /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
22.      bsp_InitLed();     /* 初始LED指示灯端口 */
23.      bsp_InitTimer();   /* 初始化滴答定时器 */
24. }

复制代码

RL-TCPnet功能测试
    这里专门创建了一个app_tcpnet_lib.c文件用于RL-TCPnet功能的测试，此文件主要实现网络主函数main_TcpNet的调用。

1. /*
2. *********************************************************************************************************
3. *    函 数 名: tcpnet_poll
4. *    功能说明: 使用TCPnet必须要一直调用的函数
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void tcpnet_poll(void)
10. {
11.      if(bsp_CheckTimer(0))
12.      {
13.          bsp_LedToggle(2);
14.         
15.          /* 此函数坚决不可以放在中断里面跑 */
16.          timer_tick ();
17.      }
18.    
19.      main_TcpNet ();
20. }
22. /*
23. *********************************************************************************************************
24. *    函 数 名: TCPnetTest
25. *    功能说明: TCPnet应用
26. *    形    参: 无
27. *    返 回 值: 无
28. *********************************************************************************************************
29. */
30. void TCPnetTest(void)
31. {
32.    
33.      /* 初始化网络协议栈 */
34.      init_TcpNet ();
36.      /* 创建一个周期是100ms的软定时器 */
37.     bsp_StartAutoTimer(0, 100);
38.    
39.      while (1)
40.      {
41.           /* TCP轮询 */
42.           tcpnet_poll();
43.      }
44. }

复制代码

Telnet用户接口文件的实现
    KEIL官网有提供Telnet的接口文件，名为Telnet_uif.c文件。我们就是在这个文件上修改。具体修改后的代码如下：

1. /* Net_Config.c */
2. extern struct tcp_cfg   tcp_config;
3. extern struct tnet_cfg  tnet_config;
4. #define tcp_NumSocks    tcp_config.NumSocks
5. #define tcp_socket      tcp_config.Scb
6. #define tnet_EnAuth     tnet_config.EnAuth
7. #define tnet_auth_passw tnet_config.Passw
9. /* ANSI ESC Sequences for terminal control. */
10. #define CLS     "\\033[2J"
11. #define TBLUE   "\\033[37;44m"
12. #define TNORM   "\\033[0m"
15. /* My structure of a Telnet U32 storage variable. This variable is private */
16. /* for each Telnet Session and is not altered by Telnet Server. It is only */
17. /* set to zero when tnet_process_cmd() is called for the first time.       */
18. typedef struct
19. {
20.      U8 id;
21.      U8 nmax;
22.      U8 idx;
23. } MY_BUF;
25. #define MYBUF(p)        ((MY_BUF *)p)
27. /* Local variables */
28. static U8 const tnet_header[] =
29. {
30.      CLS "\\r\\n"
31.      "        " TBLUE
32.      "*=============================================================*\\r\\n" TNORM
33.      "        " TBLUE
34.      "*               RL-TCPnet之Telnet服务器实验                   *\\r\\n" TNORM
35.      "        " TBLUE
36.      "*=============================================================*\\r\\n" TNORM
37. };
39. static U8 const tnet_help1[] =
40. {
41.      "\\r\\n\\r\\n"
42.      "    当前支持的命令:\\r\\n"
43.      "    ----------------------------\\r\\n"
44.      "    ledon      - 打开LED4\\r\\n"
45.      "    ledoff     - 关闭LED4\\r\\n"
46.      "    rinfo      - 显示远程设备的IP地址和MAC\\r\\n"
47. };
49. static U8 const tnet_help2[] =
50. {
51.      "    help, ?     - 显示帮助\\r\\n"
52.      "    bye         - 断开连接\\r\\n\\r\\n"
53.      "    <ESC>,<^C>  - ESC按键，断开连接\\r\\n"
54.      "    <BS>        - 回车函数，删除左侧字符\\r\\n"
55.      "    <UP><DOWN>  - 按键UP和DOWM，浏览历史命令\\r\\n"
56. };
59. /*----------------------------------------------------------------------------
60. *      Telnet CallBack Functions
61. *---------------------------------------------------------------------------*/
62. /*--------------------------- tnet_cbfunc -----------------------------------*/
64. U16 tnet_cbfunc (U8 code, U8 *buf, U16 buflen)
65. {
66.      /* This function is called by the Telnet Client to get formated system    */
67.      /* messages for different code values.                                    */
68.      /* Values for 'code':                                                     */
69.      /*    0 - initial header                                                  */
70.      /*    1 - prompt string                                                   */
71.      /*    2 - header for login only if authorization is enabled               */
72.      /*    3 - string 'Username' for login                                     */
73.      /*    4 - string 'Password' for login                                     */
74.      /*    5 - message 'Login incorrect'                                       */
75.      /*    6 - message 'Login timeout'                                         */
76.      /*    7 - Unsolicited messages from Server (ie. Basic Interpreter)        */
77.      U16 len = 0;
79.      /* Make a reference to disable compiler warning. */
80.      buflen = buflen;
82.      switch (code)
83.      {
84.          case 0:
85.               /* Write initial header after login. */
86.               len = str_copy (buf, (U8 *)&tnet_header);
87.               break;
88.         
89.          case 1:
90.               /* Write a prompt string. */
91.               len = str_copy (buf, "\\r\\narmfly> ");
92.               break;
93.          case 2:
94.               /* Write Login header. */
95.               len = str_copy (buf, CLS "\\r\\nRL-TCPnet之Telnet服务器,"
96.                                           " 请登录...\\r\\n");
97.               break;
98.         
99.          case 3:
100.               /* Write 'username' prompt. */
101.               len = str_copy (buf, "\\r\\n用户名: ");
102.               break;
103.         
104.          case 4:
105.               /* Write 'Password' prompt. */
106.               len = str_copy (buf, "\\r\\n密  码: ");
107.               break;
108.         
109.          case 5:
110.               /* Write 'Login incorrect'.message. */
111.               len = str_copy (buf, "\\r\\n登录失败");
112.               break;
113.         
114.          case 6:
115.               /* Write 'Login Timeout' message. */
116.               len = str_copy (buf, "\\r\\n120秒无操作，退出登录\\r\\n");
117.               break;
118.      }
119.    
120.      return (len);
121. }
123. /*--------------------------- tnet_process_cmd ------------------------------*/
125. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
126. {
127.      /* This is a Telnet Client callback function to make a formatted output   */
128.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
129.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
130.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
131.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
132.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
133.      /* can be used for storing different status variables for this function.  */
134.      /* It is set to 0 by Telnet server on first call and is not altered by    */
135.      /* Telnet server for repeated calls. This function should NEVER write     */
136.      /* more than 'buflen' bytes to the buffer.                                */
137.      /* Parameters:                                                            */
138.      /*   cmd    - telnet received command string                              */
139.      /*   buf    - Telnet transmit buffer                                      */
140.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
141.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
142.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
143.      /*            - on 1st call = 0                                           */
144.      /*            - 2nd call    = as set by this function on first call       */
145.      REMOTEM rm;
146.      U16 len = 0;
148.    
149.      switch (MYBUF(pvar)->id)
150.      {
151.          case 0:
152.               /* First call to this function, the value of '*pvar' is 0 */
153.               break;
155.          case 1:
156.               /* Request a repeated call, bit 14 is a repeat flag. */
157.               return (len | 0x4000);
159.          case 2:
160.               /* Request a repeated call, bit 14 is a repeat flag. */
161.               return (len |= 0x4000);
162.      }
164.      /* Simple Command line parser */
165.      len = strlen ((const char *)cmd);
166.    
167.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
168.      {
169.           /* 'LED4' command received */
170.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
171.          bsp_LedOn(4);
172.          return (len);
173.      }
174.    
175.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
176.      {
177.          /* 'LED4' command received */
178.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
179.          bsp_LedOff(4);
180.          return (len);
181.      }
182.    
183.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
184.      {
185.           /* 'BYE' command, send message and disconnect */
186.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
187.          /* Hi bit of return value is a disconnect flag */
188.          return (len | 0x8000);
189.      }
191.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
192.      {
193.           /* Display Remote Machine IP and MAC address. */
194.          tnet_get_info (&rm);
195.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
196.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
197.          len += sprintf ((char *)(buf+len),
198.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
199.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
200.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
201.          return (len);
202.      }
204.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
205.      {
206.           /* 'HELP' command, display help text */
207.          len = str_copy (buf,(U8 *)tnet_help1);   
208.          len += str_copy (buf+len,(U8 *)tnet_help2);
209.          return (len);
210.      }
211.    
212.      /* Unknown command, display message */
213.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
214.      len += str_copy (buf+len, cmd);
215.      return (len);
216. }

复制代码

32.6.2 STM32F429开发板实验


配套例子：
    V5-1044_RL-TCPnet实验_Telnet应用（裸机）
实验目的：
    1.     学习RL-TCPnet的Telnet应用。
实验内容：
    1.      强烈推荐将网线接到路由器或者交换机上面测试，因为已经使能了DHCP，可以自动获取IP地址。
    2.      程序中实现了一个Telnet服务器，用户名是admin，密码123456。
实验操作：
    详见本章节32.5小节。
配置向导文件设置（Net_Config.c）：
    详见本章节32.3小节。
调试文件设置（Net_Debug.c）：
    详见本章节32.4小节。
程序设计：
主函数初始化
    在main.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
14.      /* 进入RL-TCPnet测试函数 */
15.      TCPnetTest();
16. }

复制代码

硬件外设初始化
    硬件外设的初始化是在 bsp.c 文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
18.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
20.      bsp_InitUart();    /* 初始化串口 */
21.      bsp_InitKey();     /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
22.      bsp_InitLed();     /* 初始LED指示灯端口 */
23.      bsp_InitTimer();   /* 初始化滴答定时器 */
24. }

复制代码

RL-TCPnet功能测试
        这里专门创建了一个app_tcpnet_lib.c文件用于RL-TCPnet功能的测试，此文件主要实现网络主函数main_TcpNet的调用。

1. /*
2. *********************************************************************************************************
3. *    函 数 名: tcpnet_poll
4. *    功能说明: 使用TCPnet必须要一直调用的函数
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void tcpnet_poll(void)
10. {
11.      if(bsp_CheckTimer(0))
12.      {
13.          bsp_LedToggle(2);
14.         
15.          /* 此函数坚决不可以放在中断里面跑 */
16.          timer_tick ();
17.      }
18.    
19.      main_TcpNet ();
20. }
22. /*
23. *********************************************************************************************************
24. *    函 数 名: TCPnetTest
25. *    功能说明: TCPnet应用
26. *    形    参: 无
27. *    返 回 值: 无
28. *********************************************************************************************************
29. */
30. void TCPnetTest(void)
31. {
32.    
33.      /* 初始化网络协议栈 */
34.      init_TcpNet ();
36.      /* 创建一个周期是100ms的软定时器 */
37.     bsp_StartAutoTimer(0, 100);
38.    
39.      while (1)
40.      {
41.           /* TCP轮询 */
42.           tcpnet_poll();
43.      }
44. }

复制代码

Telnet用户接口文件的实现
       KEIL官网有提供Telnet的接口文件，名为Telnet_uif.c文件。我们就是在这个文件上修改。具体修改后的代码如下：

1. /* Net_Config.c */
2. extern struct tcp_cfg   tcp_config;
3. extern struct tnet_cfg  tnet_config;
4. #define tcp_NumSocks    tcp_config.NumSocks
5. #define tcp_socket      tcp_config.Scb
6. #define tnet_EnAuth     tnet_config.EnAuth
7. #define tnet_auth_passw tnet_config.Passw
9. /* ANSI ESC Sequences for terminal control. */
10. #define CLS     "\\033[2J"
11. #define TBLUE   "\\033[37;44m"
12. #define TNORM   "\\033[0m"
15. /* My structure of a Telnet U32 storage variable. This variable is private */
16. /* for each Telnet Session and is not altered by Telnet Server. It is only */
17. /* set to zero when tnet_process_cmd() is called for the first time.       */
18. typedef struct
19. {
20.      U8 id;
21.      U8 nmax;
22.      U8 idx;
23. } MY_BUF;
25. #define MYBUF(p)        ((MY_BUF *)p)
27. /* Local variables */
28. static U8 const tnet_header[] =
29. {
30.      CLS "\\r\\n"
31.      "        " TBLUE
32.      "*=============================================================*\\r\\n" TNORM
33.      "        " TBLUE
34.      "*               RL-TCPnet之Telnet服务器实验                   *\\r\\n" TNORM
35.      "        " TBLUE
36.      "*=============================================================*\\r\\n" TNORM
37. };
39. static U8 const tnet_help1[] =
40. {
41.      "\\r\\n\\r\\n"
42.      "    当前支持的命令:\\r\\n"
43.      "    ----------------------------\\r\\n"
44.      "    ledon      - 打开LED4\\r\\n"
45.      "    ledoff     - 关闭LED4\\r\\n"
46.      "    rinfo      - 显示远程设备的IP地址和MAC\\r\\n"
47. };
49. static U8 const tnet_help2[] =
50. {
51.      "    help, ?     - 显示帮助\\r\\n"
52.      "    bye         - 断开连接\\r\\n\\r\\n"
53.      "    <ESC>,<^C>  - ESC按键，断开连接\\r\\n"
54.      "    <BS>        - 回车函数，删除左侧字符\\r\\n"
55.      "    <UP><DOWN>  - 按键UP和DOWM，浏览历史命令\\r\\n"
56. };
59. /*----------------------------------------------------------------------------
60. *      Telnet CallBack Functions
61. *---------------------------------------------------------------------------*/
62. /*--------------------------- tnet_cbfunc -----------------------------------*/
64. U16 tnet_cbfunc (U8 code, U8 *buf, U16 buflen)
65. {
66.      /* This function is called by the Telnet Client to get formated system    */
67.      /* messages for different code values.                                    */
68.      /* Values for 'code':                                                     */
69.      /*    0 - initial header                                                  */
70.      /*    1 - prompt string                                                   */
71.      /*    2 - header for login only if authorization is enabled               */
72.      /*    3 - string 'Username' for login                                     */
73.      /*    4 - string 'Password' for login                                     */
74.      /*    5 - message 'Login incorrect'                                       */
75.      /*    6 - message 'Login timeout'                                         */
76.      /*    7 - Unsolicited messages from Server (ie. Basic Interpreter)        */
77.      U16 len = 0;
79.      /* Make a reference to disable compiler warning. */
80.      buflen = buflen;
82.      switch (code)
83.      {
84.          case 0:
85.               /* Write initial header after login. */
86.               len = str_copy (buf, (U8 *)&tnet_header);
87.               break;
88.         
89.          case 1:
90.               /* Write a prompt string. */
91.               len = str_copy (buf, "\\r\\narmfly> ");
92.               break;
93.          case 2:
94.               /* Write Login header. */
95.               len = str_copy (buf, CLS "\\r\\nRL-TCPnet之Telnet服务器,"
96.                                           " 请登录...\\r\\n");
97.               break;
98.         
99.          case 3:
100.               /* Write 'username' prompt. */
101.               len = str_copy (buf, "\\r\\n用户名: ");
102.               break;
103.         
104.          case 4:
105.               /* Write 'Password' prompt. */
106.               len = str_copy (buf, "\\r\\n密  码: ");
107.               break;
108.         
109.          case 5:
110.               /* Write 'Login incorrect'.message. */
111.               len = str_copy (buf, "\\r\\n登录失败");
112.               break;
113.         
114.          case 6:
115.               /* Write 'Login Timeout' message. */
116.               len = str_copy (buf, "\\r\\n120秒无操作，退出登录\\r\\n");
117.               break;
118.      }
119.    
120.      return (len);
121. }
123. /*--------------------------- tnet_process_cmd ------------------------------*/
125. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
126. {
127.      /* This is a Telnet Client callback function to make a formatted output   */
128.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
129.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
130.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
131.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
132.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
133.      /* can be used for storing different status variables for this function.  */
134.      /* It is set to 0 by Telnet server on first call and is not altered by    */
135.      /* Telnet server for repeated calls. This function should NEVER write     */
136.      /* more than 'buflen' bytes to the buffer.                                */
137.      /* Parameters:                                                            */
138.      /*   cmd    - telnet received command string                              */
139.      /*   buf    - Telnet transmit buffer                                      */
140.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
141.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
142.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
143.      /*            - on 1st call = 0                                           */
144.      /*            - 2nd call    = as set by this function on first call       */
145.      REMOTEM rm;
146.      U16 len = 0;
148.    
149.      switch (MYBUF(pvar)->id)
150.      {
151.          case 0:
152.               /* First call to this function, the value of '*pvar' is 0 */
153.               break;
155.          case 1:
156.               /* Request a repeated call, bit 14 is a repeat flag. */
157.               return (len | 0x4000);
159.          case 2:
160.               /* Request a repeated call, bit 14 is a repeat flag. */
161.               return (len |= 0x4000);
162.      }
164.      /* Simple Command line parser */
165.      len = strlen ((const char *)cmd);
166.    
167.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
168.      {
169.           /* 'LED4' command received */
170.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
171.          bsp_LedOn(4);
172.          return (len);
173.      }
174.    
175.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
176.      {
177.          /* 'LED4' command received */
178.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
179.          bsp_LedOff(4);
180.          return (len);
181.      }
182.    
183.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
184.      {
185.           /* 'BYE' command, send message and disconnect */
186.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
187.          /* Hi bit of return value is a disconnect flag */
188.          return (len | 0x8000);
189.      }
191.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
192.      {
193.           /* Display Remote Machine IP and MAC address. */
194.          tnet_get_info (&rm);
195.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
196.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
197.          len += sprintf ((char *)(buf+len),
198.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
199.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
200.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
201.          return (len);
202.      }
204.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
205.      {
206.           /* 'HELP' command, display help text */
207.          len = str_copy (buf,(U8 *)tnet_help1);   
208.          len += str_copy (buf+len,(U8 *)tnet_help2);
209.          return (len);
210.      }
211.    
212.      /* Unknown command, display message */
213.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
214.      len += str_copy (buf+len, cmd);
215.      return (len);
216. }

复制代码

席萌0209

32.7 实验例程说明（RTX）



32.7.1 STM32F407开发板实验


配套例子：
    V5-1045_RL-TCPnet实验_Telnet应用（RTX）
实验目的：
    1.     学习RL-TCPnet的Telnet应用。
实验内容：
    1.      强烈推荐将网线接到路由器或者交换机上面测试，因为已经使能了DHCP，可以自动获取IP地址。
    2.      程序中实现了一个Telnet服务器，用户名是admin，密码123456。
实验操作：
    详见本章节32.5小节。
配置向导文件设置（Net_Config.c）：
    详见本章节32.3小节。
调试文件设置（Net_Debug.c）：
    详见本章节32.4小节。
RTX配置：
     RTX配置向导详情如下：

Task Configuration
（1）Number of concurrent running tasks
      允许创建6个任务，实际创建了如下5个任务：
      AppTaskUserIF任务   ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：按键检测。
      AppTaskTCPMain任务：RL-TCPnet测试任务。
      AppTaskStart任务  ：启动任务，也是最高优先级任务，这里实现RL-TCPnet的时间基准更新。
（2）Number of tasks with user-provided stack
      创建的5个任务都是采用自定义堆栈方式。
（3）Run in privileged mode
      设置任务运行在非特权级模式。
RTX任务调试信息：

程序设计：
任务栈大小分配：
      staticuint64_t AppTaskUserIFStk[1024/8];   /* 任务栈 */
      staticuint64_t AppTaskLEDStk[1024/8];      /* 任务栈 */
      staticuint64_t AppTaskMsgProStk[1024/8];  /* 任务栈 */
      staticuint64_t AppTaskTCPMainStk[2048/8]; /* 任务栈 */
      staticuint64_t AppTaskStartStk[1024/8];     /* 任务栈 */
      将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数、浮点运算和uint64_t类型数据运算会出问题。
系统栈大小分配：

RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,              /* 任务函数 */
16.                        5,                         /* 任务优先级 */
17.                        &AppTaskStartStk,          /* 任务栈 */
18.                        sizeof(AppTaskStartStk));  /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

硬件外设初始化
     硬件外设的初始化是在 bsp.c 文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
18.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
20.      bsp_InitDWT();     /* 初始化DWT */
21.      bsp_InitUart();    /* 初始化串口 */
22.      bsp_InitKey();    /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
23.      bsp_InitLed();    /* 初始LED指示灯端口 */
24. }

复制代码

RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25.    
26.     HandleTaskTCPMain = os_tsk_create_user(AppTaskTCPMain,             /* 任务函数 */
27.                                            4,                         /* 任务优先级 */
28.                                            &AppTaskTCPMainStk,         /* 任务栈 */
29.                                            sizeof(AppTaskTCPMainStk)); /* 任务栈大小，单位字节数 */
30. }

复制代码

五个RTX任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskUserIF
4. *    功能说明: 按键消息处理     
5. *    形    参: 无
6. *    返 回 值: 无
7. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
8. *********************************************************************************************************
9. */
10. __task void AppTaskUserIF(void)
11. {
12.      uint8_t ucKeyCode;
14.     while(1)
15.     {
16.          ucKeyCode = bsp_GetKey();
17.         
18.          if (ucKeyCode != KEY_NONE)
19.          {
20.               switch (ucKeyCode)
21.               {
22.                    /* K1键按下 */
23.                    case KEY_DOWN_K1:
24.                        printf("K1键按下 \\r\\n");      
25.                        break;  
27.                    /* K2键按下 */
28.                    case KEY_DOWN_K2:
29.                        printf("K2键按下 \\r\\n");
30.                        break;
31.                   
32.                    /* K3键按下 */
33.                    case KEY_DOWN_K3:
34.                        printf("K3键按下 \\r\\n");
35.                        break;
37.                    /* 其他的键值不处理 */
38.                    default:                    
39.                        break;
40.               }
41.          }
42.         
43.          os_dly_wait(20);
44.      }
45. }
47. /*
48. *********************************************************************************************************
49. *    函 数 名: AppTaskLED
50. *    功能说明: LED闪烁。
51. *    形    参: 无
52. *    返 回 值: 无
53. *   优 先 级: 2
54. *********************************************************************************************************
55. */
56. __task void AppTaskLED(void)
57. {
58.      const uint16_t usFrequency = 500; /* 延迟周期 */
59.    
60.      /* 设置延迟周期 */
61.      os_itv_set(usFrequency);
62.    
63.     while(1)
64.     {
65.          bsp_LedToggle(2);
67.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
68.          os_itv_wait();
69.     }
70. }
72. /*
73. *********************************************************************************************************
74. *    函 数 名: AppTaskMsgPro
75. *    功能说明: 按键检测
76. *    形    参: 无
77. *    返 回 值: 无
78. *   优 先 级: 3
79. *********************************************************************************************************
80. */
81. __task void AppTaskMsgPro(void)
82. {
83.     while(1)
84.     {
85.          bsp_KeyScan();
86.          os_dly_wait(10);
87.     }
88. }
90. /*
91. *********************************************************************************************************
92. *    函 数 名: AppTaskTCPMain
93. *    功能说明: RL-TCPnet测试任务
94. *    形    参: 无
95. *    返 回 值: 无
96. *   优 先 级: 4
97. *********************************************************************************************************
98. */
99. __task void AppTaskTCPMain(void)
100. {
101.      while (1)
102.      {
103.          TCPnetTest();
104.      }
105. }
107. /*
108. *********************************************************************************************************
109. *    函 数 名: AppTaskStart
110. *    功能说明: 启动任务，也是最高优先级任务，这里实现RL-TCPnet的时间基准更新。
111. *    形    参: 无
112. *    返 回 值: 无
113. *   优 先 级: 5
114. *********************************************************************************************************
115. */
116. __task void AppTaskStart(void)
117. {
118.      /* 初始化RL-TCPnet */
119.      init_TcpNet ();
120.    
121.      /* 创建任务 */
122.      AppTaskCreate();
123.    
124.      os_itv_set (100);
125.    
126.     while(1)
127.     {
128.          os_itv_wait ();
129.         
130.          /* RL-TCPnet时间基准更新函数 */
131.          timer_tick ();
132.           os_evt_set(0x0001, HandleTaskTCPMain);
133.     }
134. }

复制代码

RL-TCPnet功能测试
    这里专门创建了一个app_tcpnet_lib.c文件用于RL-TCPnet功能的测试，此文件主要实现网络主函数main_TcpNet的调用。

1. #include "includes.h"
5. /*
6. *********************************************************************************************************
7. *    函 数 名: TCPnetTest
8. *    功能说明: TCPent测试函数。
9. *    形    参: 无
10. *    返 回 值: 无
11. *********************************************************************************************************
12. */
13. void TCPnetTest(void)
14. {
15.    
16.      while (1)
17.      {
18.          os_evt_wait_and(0x0001, 0xFFFF);
19.          while (main_TcpNet() == __TRUE);
20.      }
21. }

复制代码

Telnet用户接口文件的实现
    KEIL官网有提供Telnet的接口文件，名为Telnet_uif.c文件。我们就是在这个文件上修改。具体修改后的代码如下：

1. /* Net_Config.c */
2. extern struct tcp_cfg   tcp_config;
3. extern struct tnet_cfg  tnet_config;
4. #define tcp_NumSocks    tcp_config.NumSocks
5. #define tcp_socket      tcp_config.Scb
6. #define tnet_EnAuth     tnet_config.EnAuth
7. #define tnet_auth_passw tnet_config.Passw
9. /* ANSI ESC Sequences for terminal control. */
10. #define CLS     "\\033[2J"
11. #define TBLUE   "\\033[37;44m"
12. #define TNORM   "\\033[0m"
15. /* My structure of a Telnet U32 storage variable. This variable is private */
16. /* for each Telnet Session and is not altered by Telnet Server. It is only */
17. /* set to zero when tnet_process_cmd() is called for the first time.       */
18. typedef struct
19. {
20.      U8 id;
21.      U8 nmax;
22.      U8 idx;
23. } MY_BUF;
25. #define MYBUF(p)        ((MY_BUF *)p)
27. /* Local variables */
28. static U8 const tnet_header[] =
29. {
30.      CLS "\\r\\n"
31.      "        " TBLUE
32.      "*=============================================================*\\r\\n" TNORM
33.      "        " TBLUE
34.      "*               RL-TCPnet之Telnet服务器实验                   *\\r\\n" TNORM
35.      "        " TBLUE
36.      "*=============================================================*\\r\\n" TNORM
37. };
39. static U8 const tnet_help1[] =
40. {
41.      "\\r\\n\\r\\n"
42.      "    当前支持的命令:\\r\\n"
43.      "    ----------------------------\\r\\n"
44.      "    ledon      - 打开LED4\\r\\n"
45.      "    ledoff     - 关闭LED4\\r\\n"
46.      "    rinfo      - 显示远程设备的IP地址和MAC\\r\\n"
47. };
49. static U8 const tnet_help2[] =
50. {
51.      "    help, ?     - 显示帮助\\r\\n"
52.      "    bye         - 断开连接\\r\\n\\r\\n"
53.      "    <ESC>,<^C>  - ESC按键，断开连接\\r\\n"
54.      "    <BS>        - 回车函数，删除左侧字符\\r\\n"
55.      "    <UP><DOWN>  - 按键UP和DOWM，浏览历史命令\\r\\n"
56. };
59. /*----------------------------------------------------------------------------
60. *      Telnet CallBack Functions
61. *---------------------------------------------------------------------------*/
62. /*--------------------------- tnet_cbfunc -----------------------------------*/
64. U16 tnet_cbfunc (U8 code, U8 *buf, U16 buflen)
65. {
66.      /* This function is called by the Telnet Client to get formated system    */
67.      /* messages for different code values.                                    */
68.      /* Values for 'code':                                                     */
69.      /*    0 - initial header                                                  */
70.      /*    1 - prompt string                                                   */
71.      /*    2 - header for login only if authorization is enabled               */
72.      /*    3 - string 'Username' for login                                     */
73.      /*    4 - string 'Password' for login                                     */
74.      /*    5 - message 'Login incorrect'                                       */
75.      /*    6 - message 'Login timeout'                                         */
76.      /*    7 - Unsolicited messages from Server (ie. Basic Interpreter)        */
77.      U16 len = 0;
79.      /* Make a reference to disable compiler warning. */
80.      buflen = buflen;
82.      switch (code)
83.      {
84.          case 0:
85.               /* Write initial header after login. */
86.               len = str_copy (buf, (U8 *)&tnet_header);
87.               break;
88.         
89.          case 1:
90.               /* Write a prompt string. */
91.               len = str_copy (buf, "\\r\\narmfly> ");
92.               break;
93.          case 2:
94.               /* Write Login header. */
95.               len = str_copy (buf, CLS "\\r\\nRL-TCPnet之Telnet服务器,"
96.                                           " 请登录...\\r\\n");
97.               break;
98.         
99.          case 3:
100.               /* Write 'username' prompt. */
101.               len = str_copy (buf, "\\r\\n用户名: ");
102.               break;
103.         
104.          case 4:
105.               /* Write 'Password' prompt. */
106.               len = str_copy (buf, "\\r\\n密  码: ");
107.               break;
108.         
109.          case 5:
110.               /* Write 'Login incorrect'.message. */
111.               len = str_copy (buf, "\\r\\n登录失败");
112.               break;
113.         
114.          case 6:
115.               /* Write 'Login Timeout' message. */
116.               len = str_copy (buf, "\\r\\n120秒无操作，退出登录\\r\\n");
117.               break;
118.      }
119.    
120.      return (len);
121. }
123. /*--------------------------- tnet_process_cmd ------------------------------*/
125. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
126. {
127.      /* This is a Telnet Client callback function to make a formatted output   */
128.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
129.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
130.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
131.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
132.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
133.      /* can be used for storing different status variables for this function.  */
134.      /* It is set to 0 by Telnet server on first call and is not altered by    */
135.      /* Telnet server for repeated calls. This function should NEVER write     */
136.      /* more than 'buflen' bytes to the buffer.                                */
137.      /* Parameters:                                                            */
138.      /*   cmd    - telnet received command string                              */
139.      /*   buf    - Telnet transmit buffer                                      */
140.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
141.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
142.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
143.      /*            - on 1st call = 0                                           */
144.      /*            - 2nd call    = as set by this function on first call       */
145.      REMOTEM rm;
146.      U16 len = 0;
148.    
149.      switch (MYBUF(pvar)->id)
150.      {
151.          case 0:
152.               /* First call to this function, the value of '*pvar' is 0 */
153.               break;
155.          case 1:
156.               /* Request a repeated call, bit 14 is a repeat flag. */
157.               return (len | 0x4000);
159.          case 2:
160.               /* Request a repeated call, bit 14 is a repeat flag. */
161.               return (len |= 0x4000);
162.      }
164.      /* Simple Command line parser */
165.      len = strlen ((const char *)cmd);
166.    
167.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
168.      {
169.           /* 'LED4' command received */
170.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
171.          bsp_LedOn(4);
172.          return (len);
173.      }
174.    
175.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
176.      {
177.          /* 'LED4' command received */
178.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
179.          bsp_LedOff(4);
180.          return (len);
181.      }
182.    
183.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
184.      {
185.           /* 'BYE' command, send message and disconnect */
186.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
187.          /* Hi bit of return value is a disconnect flag */
188.          return (len | 0x8000);
189.      }
191.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
192.      {
193.           /* Display Remote Machine IP and MAC address. */
194.          tnet_get_info (&rm);
195.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
196.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
197.          len += sprintf ((char *)(buf+len),
198.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
199.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
200.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
201.          return (len);
202.      }
204.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
205.      {
206.           /* 'HELP' command, display help text */
207.          len = str_copy (buf,(U8 *)tnet_help1);   
208.          len += str_copy (buf+len,(U8 *)tnet_help2);
209.          return (len);
210.      }
211.    
212.      /* Unknown command, display message */
213.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
214.      len += str_copy (buf+len, cmd);
215.      return (len);
216. }

复制代码

32.7.2 STM32F429开发板实验


配套例子：
    V6-1045_RL-TCPnet实验_Telnet应用（RTX）
实验目的：
    1.     学习RL-TCPnet的Telnet应用。
实验内容：
    1.      强烈推荐将网线接到路由器或者交换机上面测试，因为已经使能了DHCP，可以自动获取IP地址。
    2.      程序中实现了一个Telnet服务器，用户名是admin，密码123456。
实验操作：
    详见本章节32.5小节。
配置向导文件设置（Net_Config.c）：
    详见本章节32.3小节。
调试文件设置（Net_Debug.c）：
    详见本章节32.4小节。
RTX配置：
    RTX配置向导详情如下：

Task Configuration
（1）Number of concurrent running tasks
      允许创建6个任务，实际创建了如下5个任务：
      AppTaskUserIF任务   ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：按键检测。
      AppTaskTCPMain任务：RL-TCPnet测试任务。
      AppTaskStart任务  ：启动任务，也是最高优先级任务，这里实现RL-TCPnet的时间基准更新。
（2）Number of tasks with user-provided stack
      创建的5个任务都是采用自定义堆栈方式。
（3）Run in privileged mode
      设置任务运行在非特权级模式。
RTX任务调试信息：

程序设计：
任务栈大小分配：
    staticuint64_t AppTaskUserIFStk[1024/8];   /* 任务栈 */
    staticuint64_t AppTaskLEDStk[1024/8];      /* 任务栈 */
    staticuint64_t AppTaskMsgProStk[1024/8];  /* 任务栈 */
    staticuint64_t AppTaskTCPMainStk[2048/8]; /* 任务栈 */
    staticuint64_t AppTaskStartStk[1024/8];     /* 任务栈 */
     将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数、浮点运算和uint64_t类型数据运算会出问题。
系统栈大小分配：

RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,              /* 任务函数 */
16.                        5,                         /* 任务优先级 */
17.                        &AppTaskStartStk,          /* 任务栈 */
18.                        sizeof(AppTaskStartStk));  /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

硬件外设初始化
     硬件外设的初始化是在 bsp.c 文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
18.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
20.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
22.      bsp_InitDWT();      /* 初始化DWT */
23.      bsp_InitUart();     /* 初始化串口 */
24.      bsp_InitKey();     /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
26.      bsp_InitExtIO();    /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
27.      bsp_InitLed();      /* 初始LED指示灯端口 */
28. }

复制代码

RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25.    
26.     HandleTaskTCPMain = os_tsk_create_user(AppTaskTCPMain,             /* 任务函数 */
27.                                            4,                         /* 任务优先级 */
28.                                            &AppTaskTCPMainStk,         /* 任务栈 */
29.                                            sizeof(AppTaskTCPMainStk)); /* 任务栈大小，单位字节数 */
30. }

复制代码

五个RTX任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskUserIF
4. *    功能说明: 按键消息处理     
5. *    形    参: 无
6. *    返 回 值: 无
7. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
8. *********************************************************************************************************
9. */
10. __task void AppTaskUserIF(void)
11. {
12.      uint8_t ucKeyCode;
14.     while(1)
15.     {
16.          ucKeyCode = bsp_GetKey();
17.         
18.          if (ucKeyCode != KEY_NONE)
19.          {
20.               switch (ucKeyCode)
21.               {
22.                    /* K1键按下 */
23.                    case KEY_DOWN_K1:
24.                        printf("K1键按下 \\r\\n");      
25.                        break;  
27.                    /* K2键按下 */
28.                    case KEY_DOWN_K2:
29.                        printf("K2键按下 \\r\\n");
30.                        break;
31.                   
32.                    /* K3键按下 */
33.                    case KEY_DOWN_K3:
34.                        printf("K3键按下 \\r\\n");
35.                        break;
37.                    /* 其他的键值不处理 */
38.                    default:                    
39.                        break;
40.               }
41.          }
42.         
43.          os_dly_wait(20);
44.      }
45. }
47. /*
48. *********************************************************************************************************
49. *    函 数 名: AppTaskLED
50. *    功能说明: LED闪烁。
51. *    形    参: 无
52. *    返 回 值: 无
53. *   优 先 级: 2
54. *********************************************************************************************************
55. */
56. __task void AppTaskLED(void)
57. {
58.      const uint16_t usFrequency = 500; /* 延迟周期 */
59.    
60.      /* 设置延迟周期 */
61.      os_itv_set(usFrequency);
62.    
63.     while(1)
64.     {
65.          bsp_LedToggle(2);
67.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
68.          os_itv_wait();
69.     }
70. }
72. /*
73. *********************************************************************************************************
74. *    函 数 名: AppTaskMsgPro
75. *    功能说明: 按键检测
76. *    形    参: 无
77. *    返 回 值: 无
78. *   优 先 级: 3
79. *********************************************************************************************************
80. */
81. __task void AppTaskMsgPro(void)
82. {
83.     while(1)
84.     {
85.          bsp_KeyScan();
86.          os_dly_wait(10);
87.     }
88. }
90. /*
91. *********************************************************************************************************
92. *    函 数 名: AppTaskTCPMain
93. *    功能说明: RL-TCPnet测试任务
94. *    形    参: 无
95. *    返 回 值: 无
96. *   优 先 级: 4
97. *********************************************************************************************************
98. */
99. __task void AppTaskTCPMain(void)
100. {
101.      while (1)
102.      {
103.          TCPnetTest();
104.      }
105. }
107. /*
108. *********************************************************************************************************
109. *    函 数 名: AppTaskStart
110. *    功能说明: 启动任务，也是最高优先级任务，这里实现RL-TCPnet的时间基准更新。
111. *    形    参: 无
112. *    返 回 值: 无
113. *   优 先 级: 5
114. *********************************************************************************************************
115. */
116. __task void AppTaskStart(void)
117. {
118.      /* 初始化RL-TCPnet */
119.      init_TcpNet ();
120.    
121.      /* 创建任务 */
122.      AppTaskCreate();
123.    
124.      os_itv_set (100);
125.    
126.     while(1)
127.     {
128.          os_itv_wait ();
129.         
130.          /* RL-TCPnet时间基准更新函数 */
131.          timer_tick ();
132.          os_evt_set(0x0001, HandleTaskTCPMain);
133.     }
134. }

复制代码

RL-TCPnet功能测试
    这里专门创建了一个app_tcpnet_lib.c文件用于RL-TCPnet功能的测试，此文件主要实现网络主函数main_TcpNet的调用。

1. #include "includes.h"
5. /*
6. *********************************************************************************************************
7. *    函 数 名: TCPnetTest
8. *    功能说明: TCPent测试函数。
9. *    形    参: 无
10. *    返 回 值: 无
11. *********************************************************************************************************
12. */
13. void TCPnetTest(void)
14. {
15.    
16.      while (1)
17.      {
18.          os_evt_wait_and(0x0001, 0xFFFF);
19.          while (main_TcpNet() == __TRUE);
20.      }
21. }

复制代码

Telnet用户接口文件的实现
    KEIL官网有提供Telnet的接口文件，名为Telnet_uif.c文件。我们就是在这个文件上修改。具体修改后的代码如下：

1. /* Net_Config.c */
2. extern struct tcp_cfg   tcp_config;
3. extern struct tnet_cfg  tnet_config;
4. #define tcp_NumSocks    tcp_config.NumSocks
5. #define tcp_socket      tcp_config.Scb
6. #define tnet_EnAuth     tnet_config.EnAuth
7. #define tnet_auth_passw tnet_config.Passw
9. /* ANSI ESC Sequences for terminal control. */
10. #define CLS     "\\033[2J"
11. #define TBLUE   "\\033[37;44m"
12. #define TNORM   "\\033[0m"
15. /* My structure of a Telnet U32 storage variable. This variable is private */
16. /* for each Telnet Session and is not altered by Telnet Server. It is only */
17. /* set to zero when tnet_process_cmd() is called for the first time.       */
18. typedef struct
19. {
20.      U8 id;
21.      U8 nmax;
22.      U8 idx;
23. } MY_BUF;
25. #define MYBUF(p)        ((MY_BUF *)p)
27. /* Local variables */
28. static U8 const tnet_header[] =
29. {
30.      CLS "\\r\\n"
31.      "        " TBLUE
32.      "*=============================================================*\\r\\n" TNORM
33.      "        " TBLUE
34.      "*               RL-TCPnet之Telnet服务器实验                   *\\r\\n" TNORM
35.      "        " TBLUE
36.      "*=============================================================*\\r\\n" TNORM
37. };
39. static U8 const tnet_help1[] =
40. {
41.      "\\r\\n\\r\\n"
42.      "    当前支持的命令:\\r\\n"
43.      "    ----------------------------\\r\\n"
44.      "    ledon      - 打开LED4\\r\\n"
45.      "    ledoff     - 关闭LED4\\r\\n"
46.      "    rinfo      - 显示远程设备的IP地址和MAC\\r\\n"
47. };
49. static U8 const tnet_help2[] =
50. {
51.      "    help, ?     - 显示帮助\\r\\n"
52.      "    bye         - 断开连接\\r\\n\\r\\n"
53.      "    <ESC>,<^C>  - ESC按键，断开连接\\r\\n"
54.      "    <BS>        - 回车函数，删除左侧字符\\r\\n"
55.      "    <UP><DOWN>  - 按键UP和DOWM，浏览历史命令\\r\\n"
56. };
59. /*----------------------------------------------------------------------------
60. *      Telnet CallBack Functions
61. *---------------------------------------------------------------------------*/
62. /*--------------------------- tnet_cbfunc -----------------------------------*/
64. U16 tnet_cbfunc (U8 code, U8 *buf, U16 buflen)
65. {
66.      /* This function is called by the Telnet Client to get formated system    */
67.      /* messages for different code values.                                    */
68.      /* Values for 'code':                                                     */
69.      /*    0 - initial header                                                  */
70.      /*    1 - prompt string                                                   */
71.      /*    2 - header for login only if authorization is enabled               */
72.      /*    3 - string 'Username' for login                                     */
73.      /*    4 - string 'Password' for login                                     */
74.      /*    5 - message 'Login incorrect'                                       */
75.      /*    6 - message 'Login timeout'                                         */
76.      /*    7 - Unsolicited messages from Server (ie. Basic Interpreter)        */
77.      U16 len = 0;
79.      /* Make a reference to disable compiler warning. */
80.      buflen = buflen;
82.      switch (code)
83.      {
84.          case 0:
85.               /* Write initial header after login. */
86.               len = str_copy (buf, (U8 *)&tnet_header);
87.               break;
88.         
89.          case 1:
90.               /* Write a prompt string. */
91.               len = str_copy (buf, "\\r\\narmfly> ");
92.               break;
93.          case 2:
94.               /* Write Login header. */
95.               len = str_copy (buf, CLS "\\r\\nRL-TCPnet之Telnet服务器,"
96.                                           " 请登录...\\r\\n");
97.               break;
98.         
99.          case 3:
100.               /* Write 'username' prompt. */
101.               len = str_copy (buf, "\\r\\n用户名: ");
102.               break;
103.         
104.          case 4:
105.               /* Write 'Password' prompt. */
106.               len = str_copy (buf, "\\r\\n密  码: ");
107.               break;
108.         
109.          case 5:
110.               /* Write 'Login incorrect'.message. */
111.               len = str_copy (buf, "\\r\\n登录失败");
112.               break;
113.         
114.          case 6:
115.               /* Write 'Login Timeout' message. */
116.               len = str_copy (buf, "\\r\\n120秒无操作，退出登录\\r\\n");
117.               break;
118.      }
119.    
120.      return (len);
121. }
123. /*--------------------------- tnet_process_cmd ------------------------------*/
125. U16 tnet_process_cmd (U8 *cmd, U8 *buf, U16 buflen, U32 *pvar)
126. {
127.      /* This is a Telnet Client callback function to make a formatted output   */
128.      /* for 'stdout'. It returns the number of bytes written to the out buffer.*/
129.      /* Hi-bit of return value (len is or-ed with 0x8000) is a disconnect flag.*/
130.      /* Bit 14 (len is or-ed with 0x4000) is a repeat flag for the Tnet client.*/
131.      /* If this bit is set to 1, the system will call the 'tnet_process_cmd()' */
132.      /* again with parameter 'pvar' pointing to a 4-byte buffer. This buffer   */
133.      /* can be used for storing different status variables for this function.  */
134.      /* It is set to 0 by Telnet server on first call and is not altered by    */
135.      /* Telnet server for repeated calls. This function should NEVER write     */
136.      /* more than 'buflen' bytes to the buffer.                                */
137.      /* Parameters:                                                            */
138.      /*   cmd    - telnet received command string                              */
139.      /*   buf    - Telnet transmit buffer                                      */
140.      /*   buflen - length of this buffer (500-1400 bytes - depends on MSS)     */
141.      /*   pvar   - pointer to local storage buffer used for repeated loops     */
142.      /*            This is a U32 variable - size is 4 bytes. Value is:         */
143.      /*            - on 1st call = 0                                           */
144.      /*            - 2nd call    = as set by this function on first call       */
145.      REMOTEM rm;
146.      U16 len = 0;
148.    
149.      switch (MYBUF(pvar)->id)
150.      {
151.          case 0:
152.               /* First call to this function, the value of '*pvar' is 0 */
153.               break;
155.          case 1:
156.               /* Request a repeated call, bit 14 is a repeat flag. */
157.               return (len | 0x4000);
159.          case 2:
160.               /* Request a repeated call, bit 14 is a repeat flag. */
161.               return (len |= 0x4000);
162.      }
164.      /* Simple Command line parser */
165.      len = strlen ((const char *)cmd);
166.    
167.      if (tnet_ccmp (cmd, "LEDON") == __TRUE)
168.      {
169.           /* 'LED4' command received */
170.          len = str_copy (buf,"\\r\\n=====>LED4 Lights ON");
171.          bsp_LedOn(4);
172.          return (len);
173.      }
174.    
175.      if (tnet_ccmp (cmd, "LEDOFF") == __TRUE)
176.      {
177.          /* 'LED4' command received */
178.           len = str_copy (buf,"\\r\\n=====>LED4 Lights OFF");
179.          bsp_LedOff(4);
180.          return (len);
181.      }
182.    
183.      if (tnet_ccmp (cmd, "BYE") == __TRUE)
184.      {
185.           /* 'BYE' command, send message and disconnect */
186.          len = str_copy (buf, "\\r\\nDisconnect...\\r\\n");
187.          /* Hi bit of return value is a disconnect flag */
188.          return (len | 0x8000);
189.      }
191.      if (tnet_ccmp (cmd, "RINFO") == __TRUE)
192.      {
193.           /* Display Remote Machine IP and MAC address. */
194.          tnet_get_info (&rm);
195.          len  = sprintf ((char *)buf,"\\r\\n Remote IP : %d.%d.%d.%d",
196.          rm.IpAdr[0],rm.IpAdr[1],rm.IpAdr[2],rm.IpAdr[3]);
197.          len += sprintf ((char *)(buf+len),
198.          "\\r\\n Remote MAC: %02X-%02X-%02X-%02X-%02X-%02X",
199.          rm.HwAdr[0],rm.HwAdr[1],rm.HwAdr[2],
200.          rm.HwAdr[3],rm.HwAdr[4],rm.HwAdr[5]);
201.          return (len);
202.      }
204.      if (tnet_ccmp (cmd, "HELP") == __TRUE || tnet_ccmp (cmd, "?") == __TRUE)
205.      {
206.           /* 'HELP' command, display help text */
207.          len = str_copy (buf,(U8 *)tnet_help1);   
208.          len += str_copy (buf+len,(U8 *)tnet_help2);
209.          return (len);
210.      }
211.    
212.      /* Unknown command, display message */
213.      len = str_copy  (buf, "\\r\\n==> Unknown Command: ");
214.      len += str_copy (buf+len, cmd);
215.      return (len);
216. }

复制代码

席萌0209

32.8 总结


      本章节就为大家讲解这么多，其中Telnet的测试稍麻烦些，希望大家实际动手操作一遍，并将其熟练掌握。