ThreadedGSM/README_original.md

ArduinoThreadedGSM

Use this library to:

• Send/Read SMS
• Read Network Time
• Read GSM signal level

Quick-start

Initialize modem:

ThreadedGSM modem(Serial1);
...
void setup()
{
	modem.begin();
}

Set automatic intervals for syncing clock and signal levels:

modem.setInterval(ThreadedGSM::INTERVAL_CLOCK, 60000);
modem.setInterval(ThreadedGSM::INTERVAL_SIGNAL, 60000);
modem.setInterval(ThreadedGSM::INTERVAL_INBOX, 30000);

Create your event handlers

void clock(ThreadedGSM& modem, ThreadedGSM::NetworkTime& Time)
{
	/* Network time */
}

void signal(ThreadedGSM& modem, ThreadedGSM::SignalLevel& Signal)
{
	/* Signal */
}

void sms(ThreadedGSM& modem, String& Msg)
{
	/* Message received in PDU  */
}

void startup(ThreadedGSM& modem)
{
	/* READY */
}

Set event handlers for modem events as you like:

modem.setHandlers({
	.signal = signal,
	.clock = clock,
	.incoming = sms,
	.ready = startup,
	.outgoing = NULL,
	.power = NULL
});

and finally, let the modem loop as a thread in your Arduino loop()

void loop()
{ 
  // "Non-blocking" loop
  modem.loop();
}

To send SMS messages, request to send them using sendSMS:

modem.sendSMS(PDU); // PDU as String, hexadecimal

Don't forget to check whether your messages were sent successfuly, before sending more.

Use power event callbacks to set modem pins (EN/RST) on power on/off when needed

Project hosted on GitHub: https://github.com/neta540/ArduinoThreadedGSM.