consoleGSM.h

Console - Library

Description

utils/consoleGSM.h provides the following function (from the DICENB / DICEGSM – Library) to your console application:

  • s_console_gsm() : delivers the following commands
    • gsm info – give some information about GSM
    • gsm on/off – disconnect and switch modem supply on or off
    • gsm connect – establish internet connection
    • gsm ping IP/URL – pings a peer
    • gsm get <URL> – http example get request to server www.di-ce.de or URL
    • gsm download <URL> <version> – downloads a file and writes it into the serial flash, optional save a <version number> of the file
    • gsm socket <server> <port> – opens a TCP socket
    • gsm post <URL> <Element> <Value> – sends a POST request to a server
    • gsm SysSync <account> – Starts a remote update process, opt.:<account> for first registration.

The consoleGSM function should only be used for evaluation and learning purposes. The source code of the consoleGSM function can be found in the path below. It could also serve as examples to build your own application.

Parameters

String s_console_string – String that holds the user command. Normally returned by s_console_routine() or a previous console function.

Returns

String : the user command or an empty String “” if the user command was recognised and processed by this function. (see of commands above)

Example Code:

#include "consoleLogin.h"
#include "utils/consoleGSM.h"

void setup() {
  SerialFlash.begin();
  console_init(&Serial);
}

void loop() {
  String s_console_string = s_console_routine();
  s_console_gsm( s_console_string );  
}

Notes and Warnings

This console-function and its commands are helpful to test and learn to work with the DICENB / DICEGSM – Library. See the source code as example code for your own application:

C:\Users\yourName\AppData\Local\Arduino15\packages\dice\hardware\samc\1.0.0\libraries\Console\src\...

In a ‘real world’ application, these commands should not be required but during development it could be helpful to test the DICENB library.

Please keep in mind that each included file and its used function increase the size of the resulting application. So in order to keep the application binaries as small as possible, include only functions that are really necessary for the final application.

An example can be found in the Arduino IDE menu:
File -> Examples -> Consoles -> Dev_Console

See also

DICENB / DICEGSM – Library
SerialFlash – Library
HTTP_Client Class