第40章 RL-TCPnet之TFTP客户端

STM32

转帖

本章节为大家讲解RL-TCPnet的TFTP客户端应用，学习本章节前，务必要优先学习第38章的TFTP基础知识。有了这些基础知识之后，再搞本章节会有事半功倍的效果。

本章教程含STM32F407开发板和STM32F429开发板。

40.1 初学者重要提示

40.2 TFTP函数

40.3 TFTP配置说明（Net_Config.c）

40.4 TFTP调试说明（Net_Debug.c）

40.5 TFTP服务器端软件和板子的操作步骤

40.6实验例程说明（RTX）

40.7 总结

lee_st · 2018-1-2 10:48:54

5、第5个参数填此函数的回调函数，当TFTP会话即将结束时，会调用这个函数。此回调函数只有一个形参，形参类型如下：

6、返回值，返回__TRUE表示TFTP客户端启动成功（注意，仅仅是客户端启动成功，并不是文件传输已经完成），返回__FALSE表示启动失败。

lee_st · 2018-1-2 10:49:11

使用这个函数要注意以下问题：
1. 标准TFTP的端口号是用的UDP端口69。
2. 用户是通过此函数启动RL-TCPnet的TFTP客户端下载TFTP服务器上的文件。

lee_st · 2018-1-2 10:49:32

使用举例：
/*
*********************************************************************************************************
*                            宏定义，远程FTP服务器的IP和端口
*********************************************************************************************************
*/
/* 要访问的远程FTP服务器IP配置 */
#define IP1          192
#define IP2          168
#define IP3          1
#define IP4          4

#define PORT_NUM    69  /* FTP服务器，默认端口号是69，无需改动 */

/*
*********************************************************************************************************
*                                        变量
*********************************************************************************************************
*/
uint8_t ServerIP[4] = {IP1, IP2, IP3, IP4};

/*
*********************************************************************************************************
* 函数名: ftpc_notify
* 功能说明: 函数tftpc_put和tftpc_get的回调函数。
* 形参: event  事件类型
* 返回值: 无
*********************************************************************************************************
*/
static void tftpc_notify (U8 event)
{
   switch (event)
   {
      /* 文件传输成功 */
      case TFTPC_EVT_SUCCESS:
            printf_debug ("File successfully transferred.rn");
            break;

      /* TFTP服务器响应超时，因此TFTP客户端终止操作 */
      case TFTPC_EVT_TIMEOUT:
            printf_debug ("TFTP Server timeout.rn");
            break;

      /* 访问的是禁止操作的文件 */
      case TFTPC_EVT_NOACCESS:
            printf_debug ("File access on TFTP server is not allowed for a specified file.rn");
            break;

      /* 在TFTP服务器上找不到要访问的文件 */
      case TFTPC_EVT_NOTFOUND:
            printf_debug ("Requested file is not found on TFTP server.rn");
            break;

      /* TFTP服务器的存储器空间已经满，无法再进行文件传输 */
      case TFTPC_EVT_DISKFULL:
            printf_debug ("The TFTP server has run out of disk space.rn");
            break;

      /* 文件传输过程中，TFTP服务器遇到一个错误 */
      case TFTPC_EVT_ERROR:
            printf_debug ("The TFTP server has encountered an error during file transfer process.rn");
            break;

      /* 其它未定义 */
      default:
            printf_debug ("No Defined.n");
            break;
   }
}

/*
*********************************************************************************************************
* 函数名: TCPnetTest
* 功能说明: TCPent测试函数。
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void TCPnetTest(void)
{
   OS_RESULT xResult;

   while (1)
   {
      os_evt_wait_or(0x0007, 0xFFFF);

      xResult = os_evt_get ();
      switch (xResult)
      {
            /* 接收到K2键按下，从TFTP服务器下载文件server.pdf，并重命名为client.pdf  */
            case KEY2_BIT1:
               if (tftpc_get (ServerIP, PORT_NUM, "server.pdf", "client.pdf", tftpc_notify) == __FALSE)
               {
                     printf_debug("File transfer not started, TFTP Client not ready.n");
               }
               else
               {
                     printf_debug("File transfer started.n");
               }
               break;


            /* 其他的键值不处理 */
            default:
               break;
      }

      while (main_TcpNet() == __TRUE);
   }
}

lee_st · 2018-1-2 10:49:53

40.2.6 函数ftpc_put
函数原型：
BOOL tftpc_put (
U8* ipadr,                /* 远程TFTP服务器的IP地址. */
U16 port,                   /* 远程TFTP服务器的IP地址. */
const char *src,             /* 本地要上传文件的文件名 */
const char *dst,             /* 远程TFTP服务器上文件的文件名 */
void (*cbfunc)(U8 event) ); /* 回调函数 */

lee_st · 2018-1-2 10:50:12

函数描述：
函数tftpc_put用于启动RL-TCPnet系统上的TFTP客户端，将本地文件上传到TFTP服务器。这样TFTP客户端就可以通过连接到UDP端口号为port（本函数的第2个形参）的TFTP服务器来启动TFTP会话。如果第2个参数的端口号填0，系统将使用TFTP服务器的标准端口号69进行连接。
1、第1个参数填TFTP服务器的IP地址。
2、第2个参数填TFTP服务器的端口号。
3、第3个参数是TFTP客户端上的文件名，此文件是要被上传到TFTP服务器。
4、第4个参数是TFTP服务器上新建文件的文件名，用于存储从TFTP客户端上传的文件。如果这个参数填NULL，那么此文件在TFTP客户端上文件名是什么，上传到TFTP服务器后还是什么。

lee_st · 2018-1-2 10:50:38

5、第5个参数填此函数的回调函数，当TFTP会话即将结束时，会调用这个函数。此回调函数只有一个形参，形参类型如下：

6、返回值，返回__TRUE表示TFTP客户端启动成功（注意，仅仅是客户端启动成功，并不是文件传输已经完成），返回__FALSE表示启动失败。

lee_st · 2018-1-2 10:50:53

使用这个函数要注意以下问题：
1. 标准TFTP的端口号是用的UDP端口69。
2. 用户是通过此函数启动RL-TCPnet的TFTP客户端上传本地文件到TFTP服务器。

lee_st · 2018-1-2 10:51:10

使用举例：
/*
*********************************************************************************************************
*                            宏定义，远程FTP服务器的IP和端口
*********************************************************************************************************
*/
/* 要访问的远程FTP服务器IP配置 */
#define IP1          192
#define IP2          168
#define IP3          1
#define IP4          4

#define PORT_NUM    69  /* FTP服务器，默认端口号是69，无需改动 */

/*
*********************************************************************************************************
*                                        变量
*********************************************************************************************************
*/
uint8_t ServerIP[4] = {IP1, IP2, IP3, IP4};

/*
*********************************************************************************************************
* 函数名: ftpc_notify
* 功能说明: 函数tftpc_put和tftpc_get的回调函数。
* 形参: event  事件类型
* 返回值: 无
*********************************************************************************************************
*/
static void tftpc_notify (U8 event)
{
   switch (event)
   {
      /* 文件传输成功 */
      case TFTPC_EVT_SUCCESS:
            printf_debug ("File successfully transferred.rn");
            break;

      /* TFTP服务器响应超时，因此TFTP客户端终止操作 */
      case TFTPC_EVT_TIMEOUT:
            printf_debug ("TFTP Server timeout.rn");
            break;

      /* 访问的是禁止操作的文件 */
      case TFTPC_EVT_NOACCESS:
            printf_debug ("File access on TFTP server is not allowed for a specified file.rn");
            break;

      /* 在TFTP服务器上找不到要访问的文件 */
      case TFTPC_EVT_NOTFOUND:
            printf_debug ("Requested file is not found on TFTP server.rn");
            break;

      /* TFTP服务器的存储器空间已经满，无法再进行文件传输 */
      case TFTPC_EVT_DISKFULL:
            printf_debug ("The TFTP server has run out of disk space.rn");
            break;

      /* 文件传输过程中，TFTP服务器遇到一个错误 */
      case TFTPC_EVT_ERROR:
            printf_debug ("The TFTP server has encountered an error during file transfer process.rn");
            break;

      /* 其它未定义 */
      default:
            printf_debug ("No Defined.n");
            break;
   }
}

/*
*********************************************************************************************************
* 函数名: TCPnetTest
* 功能说明: TCPent测试函数。
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void TCPnetTest(void)
{
   OS_RESULT xResult;

   while (1)
   {
      os_evt_wait_or(0x0007, 0xFFFF);

      xResult = os_evt_get ();
      switch (xResult)
      {
            /* 接收到K3键按下，K2按键按下后下载的client.pdf文件上传到TFTP服务器 */
            case KEY3_BIT2:
               if (tftpc_put (ServerIP, PORT_NUM, "client.pdf", NULL, tftpc_notify) == __FALSE)
               {
                     printf("File transfer not started, TFTP Client not ready.n");
               }
               else
               {
                     printf_debug("File transfer started.n");
               }
               break;

            /* 其他的键值不处理 */
            default:
               break;
      }

      while (main_TcpNet() == __TRUE);
   }
}

lee_st · 2018-1-2 10:51:41

40.3 TFTP配置说明（Net_Config.c）

（本章节配套例子的配置与本小节的说明相同）

RL-TCPnet的配置工作是通过配置文件Net_Config.c实现。在MDK工程中打开文件Net_Config.c，可以看到下图所示的工程配置向导：

lee_st · 2018-1-2 10:52:05

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

lee_st · 2018-1-2 10:52:20

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。

lee_st · 2018-1-2 10:52:40

系统滴答时钟间隔，也就是网络协议栈的系统时间基准，默认情况下，取值100ms。

lee_st · 2018-1-2 10:52:55

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

lee_st · 2018-1-2 10:53:15

（4）Default Gateway

默认网关。

lee_st · 2018-1-2 10:53:41

Ethernet Network Interface

以太网接口配置，这个配置里面还有如下两项比较重要的配置需要说明。

（1）NetBIOS Name Service

NetBIOS局域网域名服务，这里打上对勾就使能了。这样我们就可以通过前面配置的Local Host Name局域网域名进行访问，而不需要通过IP地址访问了。

（2）Dynaminc Host Configuration

即DHCP，这里打上对勾就使能了。使能了DHCP后，RL-TCPnet就可以从外接的路由器上获得动态IP地址。

lee_st · 2018-1-2 10:54:20

UDP Sockets

UDP Sockets配置，打上对勾就使能了此项功能

（1）Number of UDP Sockets

用于配置可创建的UDP Sockets数量，这里配置了5个。

范围1 – 20。

lee_st · 2018-1-2 10:54:38

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数据包能够传输的最大数据分段。

lee_st · 2018-1-2 10:55:16

（6）Receive Window Size

范围536-65535，单位字节。

TCP接收窗口大小。

lee_st · 2018-1-2 10:55:30

TFTP Client
TFTP 配置，打上对勾就使能了此项功能
（1）Block Size
   每次传输的块大小，可以选择128，256，512，1024和1428，单位字节。
（2）Number of Retries
   TFTP客户端放弃发送前，可以尝试的发送次数，超过这个次数还没有发送成功，将放弃发送。
   范围1-10次。
（3）Retry Timeout
   如果这段时间内数据帧未被确认，TFTP客户端将重新发送数据。
   可以选择的重传溢出时间有200ms，500ms，1sec，2sec，5sec和10sec。