Building and Running Sample Application
- Former user (Deleted)
- WES Admin
- Anonymous
This section describes all the steps required to build a FTPs-based application. The instructions provided in this section are not intended for any particular toolchain, but instead are described in a generic way that can be adapted to any toolchain.
The best way to start building a FTPs-based project is to start from an existing µC/TCP-IP project.
Working project with µC/TCP-IP
The first step before including the µC/FTPs is to have a working project with the µC/TCP-IP. As previously mentioned, Micriµm may offer starting example with µC/OS-III kernels and µC/TCP-IP and even with µC/FTPs for many evalboards.
If no project that include µC/TCP-IP is available, you should follow the µC/TCP-IP Getting Started Guide to ensure to have a working project which use fix IP address before installing µC/FTPs. Then you can follow the following steps to build and run a first µC/FTPs sample application.
Including Additional Modules to the Project
Once you have a working project with your RTOS and µC/TCP-IP additional modules are needed by the Micriµm FTP server that are not necessarily already included in your project. Therefore, be sure to add µC/CPU, µC/LIB and µC/TCP-IP to your project.
Refer to the following manuals for further information about MIcrium modules:.
Including µC/FTPs Source Code
Include the following files in your project tree from the µC/FTPs source code distribution, as indicated in Figure - µC/FTPs Source Code.
Compiler settings
Finally, add the following include paths to your project’s C compiler settings:
\Micrium\Software\uC-FTPs
\Micrium\Software\uC-TCPIP
\Micrium\Software\uC-<OS-Version>
Copying and Modifying Template Files
Copy the files from the uC-FTPs configuration folder into your application as illustrated in Figure - Copying Template Files.
ftp-s_cfg.h is a configuration file used to setup µC/FTPs module static parameters and features such as path length, ports and so on. Refer to section Module Configuration for more details on all the configurations inside ftp-s_cfg.h
Adding µC/FTPs application function
Before running the sample application, you will need to add the new function call, in your application file to initialize and setup the µC/FTPs module. Section Sample Application gives an example of how to initialize µC/FTPs and start a FTP server instance.
This code example will need to be modified in accordance with your project.
Adding Additional includes
#include <Source/ftp-s.h>
#include <FS/uC-FS-V4/net_fs_v4.h> (optional if uC/FS is used)