Development

Communication / 3G + GPS:

» 3G 23: Downloading files to Waspmote’s SD from a FTPS server

This example shows how to download a file to Waspmote's SD card from a FTP server.

Required Materials

1 x Waspmote
1 x battery
1 x 3G + GPS module
1 x GPRS/3G antenna
1 x SIM card
1 x SD card in Waspmote

Notes

- 3G module must be powered with a battery
- When 3G is in use, interrupts can't be used
- 8.3 codification for name of the files
- Be sure that the name and the path are correct
- The 3G+ GPS module doesn’t support FTPS server with certificate authentication. An explicit FTPS server without certificate authentication must be used with these functions
- This example can be executed in Waspmote v12 and Waspmote v15

Code

/*  
 *  ----  3G_23 - Downloading files to Waspmote SD from a FTPS server   ------ 
 *  
 *  Explanation: This example shows how to download a file to Waspmote's SD card
 *  from a FTPS server.
 *  
 *  Copyright (C) 2014 Libelium Comunicaciones Distribuidas S.L. 
 *  http://www.libelium.com 
 *  
 *  This program is free software: you can redistribute it and/or modify 
 *  it under the terms of the GNU General Public License as published by 
 *  the Free Software Foundation, either version 3 of the License, or 
 *  (at your option) any later version. 
 *  
 *  This program is distributed in the hope that it will be useful, 
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of 
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
 *  GNU General Public License for more details. 
 *  
 *  You should have received a copy of the GNU General Public License 
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>. 
 *  
 *  Version:           1.1 
 *  Design:            David Gascón 
 *  Implementation:    Alejandro Gállego
 */

#include "Wasp3G.h"

char apn[] = "apn";
char login[] = "login";
char password[] = "password";

char ftp_server[] = "ftp_server";
uint16_t ftp_port = 990;
char ftp_user_name[] = "ftp_user_name";
char ftp_password[] = "ftp_password";

int answer;

void setup()
{
    USB.println(F("**************************"));
    // 1. sets operator parameters
    _3G.set_APN(apn, login, password);
    // And shows them
    _3G.show_APN();
    USB.println(F("**************************"));
}

void loop()
{

    // setup for Serial port over USB:
    USB.ON();
    USB.println(F("USB port started..."));

    // 2. activates the 3G module:
    answer = _3G.ON();
    if ((answer == 1) || (answer == -3))
    {
        USB.println(F("3G module ready..."));

        // 3. sets pin code:
        USB.println(F("Setting PIN code..."));
        // **** must be substituted by the SIM code
        if (_3G.setPIN("****") == 1) 
        {
            USB.println(F("PIN code accepted"));
        }
        else
        {
            USB.println(F("PIN code incorrect"));
        }

        // 4. waits for connection to the network
        answer = _3G.check(180);    
        if (answer == 1)
        { 
            USB.println(F("3G module connected to the network..."));

            // 5. setting FTPS parameters
            answer = _3G.loginFPTS(ftp_server, ftp_port, ftp_user_name, ftp_password);
            if (answer == 1)
            {     

                USB.println(F("Downloading the file 1..."));

                // 6a. downloads file to SD card from the FTPS server:
                answer = _3G.downloadDataSecure("/ftp_path/ftp_filename", "/SD_path/filename", 180);
                if (answer == 1)
                {
                    USB.println(F("Download done"));
                }
                else if(answer == -2)
                {
                    USB.print(F("Download failed. Error code: "));
                    USB.println(answer, DEC);
                    USB.print(F("CME error code: "));
                    USB.println(_3G.CME_CMS_code, DEC);
                }
                else 
                {
                    USB.print(F("Download failed1. Error code: "));
                    USB.println(answer, DEC);
                }

                // a little delay between downloads
                delay(5000);

                USB.println(F("Downloading the file 2..."));

                // 6b. downloads file to SD card from the FTPS server:
                answer = _3G.downloadDataSecure("/ftp_filename", "SD_filename", 180);
                if (answer == 1)
                {
                    USB.println(F("Download done"));
                }
                else if(answer == -2)
                {
                    USB.print(F("Download failed. Error code: "));
                    USB.println(answer, DEC);
                    USB.print(F("CME error code: "));
                    USB.println(_3G.CME_CMS_code, DEC);
                }
                else 
                {
                    USB.print(F("Download failed. Error code: "));
                    USB.println(answer, DEC);
                }
            }
            else
            {
                USB.println(F("Configuration failed. Error code:"));
                USB.println(answer, DEC);
            }
        }
        else
        {
            USB.println(F("3G module cannot connect to the network..."));
        }
    }
    else
    {
        // Problem with the communication with the 3G module
        USB.println(F("3G module not started"));
    }  

    // 7. powers off the 3G module
    _3G.OFF(); 

    USB.println(F("Sleeping..."));

    // 8. sleeps one hour
    PWR.deepSleep("00:01:00:00", RTC_OFFSET, RTC_ALM1_MODE1, ALL_OFF);

}

Output

H#
USB port started...
3G module ready...
Setting PIN code...
PIN code accepted
3G module connected to the network...
Downloading the file 1...
Download done
Downloading the file 2...
Download done
Sleeping...

Quick Publish: