Arduino Function: GSM.begin

Description

Connects to the GSM network identified on the SIM card.

Syntax

gsm.begin()
gsm.begin(pin)
gsm.begin(pin, restart)
gsm.begin(pin, restart, sync)

Parameters

  • pin : character array with the PIN to access a SIM card (default = 0)
  • restart : boolean, determines whether to restart modem or not (default= true)
  • sync : boolean, synchronous (true, default) or asynchronous (false) mode

Returns

 char : 0 if asynchronous. If synchronous, returns status : ERROR, IDLE, CONNECTING, GSM_READY, GPRS_READY, TRANSPARENT_CONNECTED

Examples

#include <GSM.h>

#define PINNUMBER ""

GSM gsm; // include a 'true' parameter for debug enabled

void setup()
{
// initialize serial communications
Serial.begin(9600);

// connection state
boolean notConnected = true;

// Start GSM shield
// If your SIM has PIN, pass it as a parameter of begin() in quotes
while(notConnected)
{
if(gsm.begin(PINNUMBER)==GSM_READY)
notConnected = false;
else
{
Serial.println("Not connected");
delay(1000);
}
}

Serial.println("GSM initialized");
}

void loop()
{
// once connected do something interesting
}

Related Functions


Based on the reference originally written by Arduino Community,  wiring.org.co and  arduino.cc