FTP CLIENT#

1. Purpose / Scope#

This application demonstrates how to update new firmware to RS9116W EVK using remote FTP server.

File Transfer Protocol (FTP) is a protocol through which internet users can upload files from their computers to a website or download files from a website to their PCs. FTP is a client-server protocol that relies on two TCP communications channels between client and server and a command channel for controlling the conversation (command port) and a data channel for transmitting file content(data port).

2. Prerequisites / Setup Requirements#

Before running the application, set up the following.

2.1 Hardware Requirements#

Setup Diagram for FTP CLIENT ExampleSetup Diagram for FTP CLIENT Example

2.2 Software Requirements#

  • WiSeConnect SDK

  • Embedded Development Environment

  • Install and configure Wamp-Apache HTTP server, refer to Appendix section 6.3 Configuring and uploading firmware on Apache HTTP.

  • Install and configure Wamp-Apache HTTPs server, refer to Appendix section 6.4 Configuring and uploading firmware on Apache HTTPs.

  • Configure AWS S3 bucket, refer to Appendix setion 6.1 Configuring AWS S3 Bucket.

  • Configure Azure Blob storage, refer to Appendix section 6.2 Configuring Azure Blob Storage.

3. Application Build Environment#

3.1 Platform#

The Application can be built and executed on below Host platforms

3.2 Host Interface#

  • By default, the application is configured to use the SPI bus for interfacing between Host platforms(STM32F411 Nucleo / EFR32MG21) and the RS9116W EVK.

  • This application is also configured to use the SDIO bus for interfacing between Host platforms(EFM32GG11) and the RS9116W EVK.

3.3 Project Configuration#

The Application is provided with the project folder containing Keil and Simplicity Studio project files.

  • Keil Project

    • The Keil project is used to evaluate the application on STM32.

    • Project path: <SDK>/examples/snippets/wlan/ftp_client/projects/ftp_client-nucleo-f411re.uvprojx

  • Simplicity Studio

    • The Simplicity Studio project is used to evaluate the application on EFR32MG21.

    • Project path:

      • If the Radio Board is BRD4180A or BRD4181A, then access the path <SDK>/examples/snippets/wlan/ftp_client/projects/ftp_client-brd4180a-mg21.slsproj

      • If the Radio Board is BRD4180B or BRD4181B, then access the path <SDK>/examples/snippets/wlan/ftp_client/projects/ftp_client-brd4180b-mg21.slsproj

      • User can find the Radio Board version as given below

EFR Radio BoardsEFR Radio Boards

  • EFM32GG11 platform

    • The Simplicity Studio project is used to evaluate the application on EFM32GG11.

      • Project path:<SDK>/examples/snippets/wlan/ftp_client/projects/ftp_client-brd2204a-gg11.slsproj

3.4 Bare Metal/RTOS Support#

This application supports bare metal environment. The application project files (Keil and Simplicity studio) are provided with bare metal configuration in the SDK.

4. Application Configuration Parameters#

The application can be configured to suit user requirements and development environment. Read through the following sections and make any changes needed.

4.1 Open rsi_ftp_client.c file#

4.1.1 User must update the below common parameters#

SSID refers to the name of the Access point.

 #define SSID                                 "<REDPINE_AP>"

SECURITY_TYPE refers to the type of security. In this application STA supports Open, WPA-PSK, WPA2-PSK securities. Valid configuration is: RSI_OPEN - For OPEN security mode RSI_WPA - For WPA security mode RSI_WPA2 - For WPA2 security mode 

 #define SECURITY_TYPE                         RSI_OPEN

PSK refers to the secret key if the Access point configured in WPA-PSK/WPA2-PSK security modes.

 #define PSK                                  "<psk>"

FTP_SERVER_PORT port refers remote FTP server port number. By default FileZilla Server runs on port number 21. #define FTP_SERVER_PORT 21 SERVER_IP_ADDRESS refers remote peer IP address to connect with TCP server socket. IP address should be in long format and in little endian byte order. Example: To configure "192.168.0.100" as remote IP address, update the macro SERVER_IP_ADDRESS as 0x6400A8C0. #define SERVER_IP_ADDRESS 0x6400A8C0 FTP Server login username #define FTP_SERVER_LOGIN_USERNAME "username" FTP Server login password #define FTP_SERVER_LOGIN_PASSWORD "password" File to read which is on FTP server Create a file on FTP server with the file name along with the path with data given below #define FTP_FILE_TO_READ "read.txt" (Or) #define FTP_FILE_TO_READ "D:\FTP Test\read.txt" FILE_CONTENT_LENGTH refers content length of the read file from FTP server (Ex: configure FILE_CONTENT_LENGTH >= Sizeof ("read.txt")) #define FILE_CONTENT_LENGTH 10000 File name to create on FTP server and write the same content which is read from "read.txt" #define FTP_FILE_TO_WRITE "write.txt" (Or) #define FTP_FILE_TO_WRITE "D:\FTP Test\write.txt" To rename a file on FTP server #define FTP_FILE_TO_RENAME "example.txt" To set the directory on FTP server #define FTP_DIRECTORY_SET "/work/FTP_EXAMPLE/FTP" To create directory on FTP server #define FTP_DIRECTORY_CREATE "FTP" To list the directories on FTP server #define FTP_DIRECTORY_LIST "/work/FTP_EXAMPLE" To configure IP address

DHCP_MODE refers whether IP address configured through DHCP or STATIC

 #define DHCP_MODE                            1
Note:
 If user wants to configure STA IP address through DHCP then set DHCP_MODE to 1 and skip configuring the following DEVICE_IP,GATEWAY and NETMASK macros.
 (Or)
If user wants to configure STA IP address through STATIC then set DHCP_MODE macro to "0" and configure following DEVICE_IP, GATEWAY and NETMASK macros.

IP address to be configured to the device in STA mode, it should be in long format and in little endian byte order. Example: To configure "192.168.10.10" as IP address, update the macro DEVICE_IP as 0x0A0AA8C0. #define DEVICE_IP 0X0A0AA8C0 IP address of the gateway should also be in long format and in little endian byte order Example: To configure "192.168.10.1" as Gateway, update the macro GATEWAY as 0x010AA8C0 #define GATEWAY 0x010AA8C0 IP address of the network mask should also be in long format and in little endian byte order Example: To configure "255.255.255.0" as network mask, update the macro NETMASK as 0x00FFFFFF #define NETMASK 0x00FFFFFF The following parameters need to be configure if OS is used. WLAN task priority is given and this should be of low priority #define RSI_WLAN_TASK_PRIORITY 1 Driver task priority is given and this should be of highest priority #define RSI_DRIVER_TASK_PRIORITY 1 WLAN Task stack size is configured by this macro #define RSI_WLAN_TASK_STACK_SIZE 500 Driver Task stack size is configured by this macro #define RSI_DRIVER_TASK_STACK_SIZE 500

4.1.2 User must update the below server configuration parameters#

Open rsi_wlan_config.h file and update/modify following macros #define CONCURRENT_MODE RSI_DISABLE #define RSI_FEATURE_BIT_MAP FEAT_SECURITY_OPEN #define RSI_TCP_IP_BYPASS RSI_DISABLE #define RSI_TCP_IP_FEATURE_BIT_MAP TCP_IP_FEAT_DHCPV4_CLIENT| TCP_IP_FEAT_FTP_CLIENT) #define RSI_CUSTOM_FEATURE_BIT_MAP FEAT_CUSTOM_FEAT_EXTENTION_VALID #define RSI_EXT_CUSTOM_FEAT_BIT_MAP EXT_FEAT_256k_MODE #define RSI_BAND RSI_BAND_2P4GHZ

Note: rsi_wlan_config.h file is already set with desired configuration in respective example folders user need not change for each example. Installation of FTP server

  1. Download the FileZilla FTP server from below link - https://filezilla-project.org/download.php?type=server

  2. Install downloaded FileZilla FTP server in Windows PC2 which is connected to AP through LAN.

  3. Configure and run FTP server. Please refer the below images for configuring and running FileZilla FTP server.

  4. After installation, open FileZilla Server interface.

Using AWS S3 BucketUsing AWS S3 Bucket

  1. After opening FileZilla server interface, connect to server admin interface.

Using AWS S3 BucketUsing AWS S3 Bucket

  1. After connection with server, configure the user settings.

Using AWS S3 BucketUsing AWS S3 Bucket Using AWS S3 BucketUsing AWS S3 Bucket Using AWS S3 BucketUsing AWS S3 Bucket Using AWS S3 BucketUsing AWS S3 Bucket

  1. Place "read.txt" file in FTP directory (Ex: "D:\FTP Test\read.txt")

5. Testing the Application#

User has to follow the below steps for the successful execution of the application.

5.1 Loading the RS9116W Firmware#

Refer Getting started with a PC to load the firmware into RS9116W EVK. The firmware file is located in <SDK>/firmware/

5.2 Building the Application on the Host Platform#

5.2.1 Using STM32#

Refer Getting started with STM32

  • Open the project <SDK>/examples/snippets/wlan/ftp_client/projects/ftp_client-nucleo-f411re.uvprojx

  • Build and Debug the project

  • Check for the RESET pin:

    • If RESET pin is connected from STM32 to RS9116W EVK, then user need not press the RESET button on RS9116W EVK before free run.

    • If RESET pin is not connected from STM32 to RS9116W EVK, then user need to press the RESET button on RS9116W EVK before free run.

  • Free run the project

  • Then continue the common steps from Section 5.3

5.2.2 Using EFX32#

Refer Getting started with EFX32, for settin-up EFR & EFM host platforms

  • Open Simplicity Studio and import the project from <SDK>/examples/snippets/wlan/ftp_client/projects

  • Select the appropriate .slsproj as per the Radio Board type mentioned in Section 3.3

  • Compile and flash the project in to Host MCU

  • Debug the project

  • Check for the RESET pin:

    • If RESET pin is connected from STM32 to RS9116W EVK, then user need not press the RESET button on RS9116W EVK before free run

    • If RESET pin is not connected STM32 to RS9116W EVK, then user need to press the RESET button on RS9116W EVK before free run

  • Free run the project

  • Then continue the common steps from Section 5.3

5.3 Common Steps#

  1. Configure the Access point in OPEN/WPA-PSK/WPA2-PSK mode to connect the Silicon Labs device in STA mode.

  2. Run FTP server on Windows PC2 and place "read.txt" file in the FTP directory.

  3. After the program gets executed, the Silicon Labs device will be connected to same access point having the configuration same as that of in the application and get IP.

  4. After successful connection with the Access Point, the device connects to FTP server and reads the file content of given file ("read.txt") and creates a file name "write.txt" in FTP directory and writes the same content which is read from "read.txt" by replacing first few bytes with "FTP CLIENT DEMO". After successful file write WiSeConnect device disconnects from FTP server.

  5. Refer below images for message exchanges with FTP server and for read and write files,

Using Using

Using AZURE Blob StorageUsing AZURE Blob Storage