FTP Server

The File Transfer Protocol (FTP) is a protocol used to transfer and manage files and folders. Using this protocol, you can send files to the System or read files from it. You can also create and delete folders and rename files or folders on the system.

The following FTP Server options are configurable from the Net_Config.c configuration file:

• FTP Server switch enables or disables the FTP Server service in your application. It is enabled when this value is set to 1. It should be set to 0 when FTP server is not used in your application.

  #define FTP_ENABLE     1
  

• Number of FTP Sessions specifies the number of available FTP sessions. The default value is one, and this enables only one concurrent client connection. You should increase this number if multiple FTP clients must connect to the Telnet server at the same time.
  
  If you are using Windows Explorer as a FTP client, you should also increase this number because the Windows Explorer creates multiple simultaneous connections.

  #define FTP_NUMSESS    3
  

• Port Number specifies the listening TCP port number. The default FTP server listening port is 21.

  #define FTP_PORTNUM    21
  

• Welcome Message specifies the custom FTP server welcome message. This message is sent to the user on login. When this option contains an empty string, a default Welcome Message from the library is used instead. The default definition is an empty string.

  #define FTP_WELMSG     ""
  

• Idle Session Timeout in seconds specifies the interval of user inactivity, after which the connection is closed. In idle session, no TCP frames are exchanged. A value of 0 disables a disconnection on timeout.

  #define FTP_IDLETOUT   120
  

  A value of 0 also enables keep-alive mode of TCP socket. After expiration of TCP_DEFTOUT, a TCP socket sends keep-alive probe to remote peer and expects the acknowledge response. Received acknowledge reloads the timeout counter for the socket. If a response is not received after certain number of retries, a connection is closed.
• Enable User Authentication switch enables or disables the FTP Server authentication with a username and a password. The user authentication is enabled when this value is set to 1.

  #define FTP_ENAUTH     1
  

• Authentication Username is the username identification.

  #define FTP_AUTHUSER   "admin"
  

• Authentication Password is the default password, that must be stored in Non volatile memory. The user may change the password later.

  #define FTP_AUTHPASSW  ""
  

Note

• You must also add the FTP_uif.c user interface module to your project and customize it. This file is in the \Keil\ARM\RL\TCPnet\User folder.
• One FTP session uses two TCP sockets, one control and one data socket. Have this in mind when you are configuring the number of TCP sockets.
• When the FTP server is not enabled, the ARM linker does not link the FTP support modules to your application and thus reduces the code size and memory usage.