第36章 RL-TCPnet之FTP服务器

STM32

转帖
本章节为大家讲解RL-TCPnet的FTP服务器应用，学习本章节前，务必要优先学习第35章的FTP基础知识。有了这些基础知识之后，再搞本章节会有事半功倍的效果。
本章教程含STM32F407开发板和STM32F429开发板。
36.1 初学者重要提示
36.2FTP函数
36.3FTP配置说明（Net_Config.c）
36.4FTP调试说明（Net_Debug.c）
36.5FTP访问方法和板子的操作步骤
36.6实验例程说明（RTX）
36.7总结

lee_st · 2017-12-17 08:41:03

36.1 初学者重要提示

1、学习本章节前，务必保证已经学习了第35章的基础知识。
2、本章配套的例子是将开发板作为FTP服务器，使用开发板上面的SD卡作为服务器的存储介质。所以测试本章节的例子，务必要准备一个SD卡。
3、由于配套例子的文件系统是采用的RL-FlashFS，此文件系统的文件名仅支持ASCII字符，不支持中文，特别注意！
4、具体FTP服务器的访问方法在本章的36.5小节有详细说明。

lee_st · 2017-12-17 08:41:28

36.2 FTP函数

使用如下18个函数可以实现RL-TCPnet的FTP：
（1）ftp_accept_host
（2）ftp_check_account
（3）ftp_fclose
（4）ftp_evt_notify
（5）ftp_fdelete
（6）ftp_ffind
（7）ftp_file_access
（8）ftp_fopen
（9）ftp_fread
（10）ftp_frename Server
（11）ftp_fwrite Server
（12）ftp_get_user_id
（13）ftpc_cbfunc
（14）ftpc_connect
（15）ftpc_fclose
（16）ftpc_fopen
（17）ftpc_fread
（18）ftpc_fwrite

lee_st · 2017-12-17 08:42:05

关于这18个函数的讲解及其使用方法可以看教程第 3 章 3.4 小节里面说的参考资料 rlarm.chm 文件：

lee_st · 2017-12-17 08:42:21

这里我们重点的说以下9个函数，因为本章节配套的例子使用的是这9个函数：
（1）ftp_fopen
（2）ftp_fclose
（3）ftp_fread
（4）ftp_fwrite
（5）ftp_fdelete
（6）ftp_frename
（7）ftp_ffind
（8）ftp_accept_host
（9）ftp_evt_notify

lee_st · 2017-12-17 08:42:36

关于这些函数注意以下三点：
1、FTP的所有函数都不支持重入，也就是不支持多任务调用。
2、以ftp_开头的函数是用于FTP服务器的。
3、以ftpc_开头的函数是用于FTP客户端的。

lee_st · 2017-12-17 08:42:53

36.2.1 函数ftp_fopen

函数原型：
void *ftp_fopen (
U8* fname, /* 文件名地址 */
U8* mode); /* 操作模式 */

lee_st · 2017-12-17 08:43:13

函数描述：
函数ftp_fopen用于打开文件。此函数在MDK的安装目录中的FTP_uif.c文件里面，属于底层接口函数，用户要在此函数里面添加具体的操作。
1、第1个参数是文件名地址。
2、第2个参数是操作模式，可以是读操作或者写操作，具体支持的形参类型如下：

图片:36.2.png

3、返回值，打开文件成功的话，返回指向此文件的指针变量，否则返回NULL。

lee_st · 2017-12-17 08:43:27

使用举例：
void *ftp_fopen (U8 *fname, U8 *mode) {
/* 打开文件 */
return (fopen ((const char *)fname, (const char *)mode));
}

lee_st · 2017-12-17 08:43:46

36.2.2 函数ftp_fclose

函数原型：
void *ftp_fclose (
FILE* file); /* 文件句柄地址 */

lee_st · 2017-12-17 08:44:05

函数描述：
函数ftp_fclose用于关闭文件。此函数在MDK的安装目录中的FTP_uif.c文件里面，属于底层接口函数，用户要在此函数里面添加具体的操作。
1、第1个参数是要关闭的文件句柄地址。
2、返回值，实际上此函数无需返回任何数值，写成下面使用举例中的形式即可。

lee_st · 2017-12-17 08:44:21

使用举例：
void ftp_fclose (void *file) {
/* 关闭文件 */
fclose (file);
}

lee_st · 2017-12-17 09:18:55

36.2.3 函数ftp_fread

函数原型：
U16 ftp_fread (
    FILE* file,     /* 文件句柄地址 */
    U8*   buf,      /* 数据缓冲地址 */
    U16   len );    /* 要读取的字节数 */

lee_st · 2017-12-17 09:23:05

函数描述：
函数ftp_fread用于从文件中读出len个字节数据。此函数在MDK的安装目录中的FTP_uif.c文件里面，属于底层接口函数，用户要在此函数里面添加具体的操作。
1、第1个参数是要读取数据的文件句柄地址。
2、第2个参数是数据缓冲地址，用于存储读取出来的数据。
3、第3个参数是要读取出来的数据大小，单位字节。
4、返回值，返回从文件中实际读出的字节数。
使用这个函数要注意以下问题：
1. 设置读取函数时，必须设置指定大小的字节数。如果实际读出的字节数小于len，将停止读取并关闭文件，这种情况一般都是文件已经读取完毕。

lee_st · 2017-12-17 09:23:24

使用举例：
U16 ftp_fread (void *file, U8 *buf, U16 len) {
/* 读取len字节到buf中，当此函数的返回值，即实际读取的字节数小于len的时候，说明文件已经读取完毕，
文件将被关闭*/
return (fread (buf, 1, len, file));
}

lee_st · 2017-12-17 09:23:41

36.2.4 函数ftp_fwrite

函数原型：
U16 ftp_fwrite (
    FILE* file,     /* 文件句柄地址 */
    U8*   buf,      /* 数据缓冲地址 */
U16   len );    /* 要写入的字节数 */

lee_st · 2017-12-17 09:23:57

函数描述：
函数ftp_fwrite用于往文件中写入len个字节数据。此函数在MDK的安装目录中的FTP_uif.c文件里面，属于底层接口函数，用户要在此函数里面添加具体的操作。
1、第1个参数是要写入数据的文件句柄地址。
2、第2个参数是数据缓冲地址，存储要写入的数据。
3、第3个参数是要写入的数据大小，单位字节。
4、返回值，返回实际写入文件的字节数。