FTP Client

The embedded FTP client allows you to connect to remote FTP server and perform various file operations. Using the FTP client you can:

• transfer files from local system to remote FTP server,
• transfer files from remote FTP server to a local system,
• append a local file to remote file on FTP server,
• delete a file from the FTP server,
• list the files stored on FTP server,
• rename a file or directory on FTP server,
• create a directory on FTP server,
• remove a directory from FTP server.

The FTP client session starts with a connect request. The FTP client then opens a FTP connection to the server. The file operation to perform is specified in the connect request parameter. Once the file operation has completed, the FTP session ends and the connection closes. FTP session performs only one file operation. If you want to transfer more files, you need to start FTP session again.

All parameters, needed for the session, are given in the callback function. This function is in the FTPC_uif.c user interface module, which is in the \Keil\ARM\RL\TCPnet\User folder. You must copy it to your project directory and add it to your project. From the callaback function, you can specify the username/password to access the FTP server, a working directory on the FTP server, a filename for the file operation, etc.

Relative path operation

In FTP Client version 4.60 and newer, the operation mode is changed from absolute path to relative path. This means the filename can not contain a path information anymore. Instead of this, a working directory must be specified in the FTPC_uif.c user interface module. After logon the FTP Client first changes the working directory to the path specified in user interface module, and then performs a file command.

The new version of FTP Client supports also directory manipulation and rename commands. This allows you to create or remove directories, and to rename files or directories on the server.

This new version was tested on various FTP servers such as:

• Linux Debian 6 FTP server,
• Microsoft IIS FTP server,
• Android FTPDroidPro FTP server,
• Android FTPServer application.

Note

• In order to use an Embedded FTP Client, you have to enable and configure it in the configuration file, and provide the File System Interface functions.