Receive SMS
This sketch waits for a SMS message and prints it to the serial
monitor. It requires an Arduino with a connected GSM shield and SIM
card.
Hardware Required
- Arduino board
- Arduino + Telefonica GSM/GPRS Shield
- SIM card
Circuit
image of the Arduino GSM Shield on top of an Arduino Uno
#include <GSM.h>
SIM cards may have a PIN number that enables
their functionality. Define the PIN for your SIM. If your SIM has no
PIN, you can leave it blank :
#define PINNUMBER ""
Initialize instances of the classes you're going to use. You're going to need both the GSM and GSM_SMS class.
GSM gsmAccess;
GSM_SMS sms;
Create a char array to hold the number that is sending the message :
char remoteNumber[20];
In setup, open a serial connection to the computer. After opening the connection, send a message indicating the sketch has started.
void setup(){
Serial.begin(9600);
Serial.println("SMS Messages Receiver");
Create a local variable to track the connection
status. You'll use this to keep the sketch from starting until the SIM
is connected to the network :
boolean notConnected = true;
Connect to the network by calling gsmAccess.begin(). It takes the SIM card's PIN as an argument. By placing this inside a while() loop, you can continually check the status of the connection. When the modem does connect, gsmAccess() will return GSM_READY. Use this as a flag to set the notConnected variable to true or false. Once connected, the remainder of setup will run.
while(notConnected)
{
if(gsmAccess.begin(PINNUMBER)==GSM_READY)
notConnected = false;
else
{
Serial.println("Not connected");
delay(1000);
}
}
Finish setup with some information to the serial monitor.
Serial.println("GSM initialized.");
Serial.println("Waiting for messages");
}
SMS messages are received by the modem. SIM
cards have some memory space to store incoming SMS. The number of SMS
the card can hold can be as few as 10, or as many as 200, depending on
the SIM. You should check with your provider to determine how many your
SIM can keep in memory.
In loop(), create a variable of type char to temporarily hold characters from any SMS received. Use sms.available() to check for the presence of any messages on the SIM :
void loop()
{
char c;
if (sms.available())
{
If a SMS is available, retrieve the remote sender's number by calling sms.remoteNumber(remoteNumber, 20). the remoteNumber argument is the char
array you declared in the beginning of the sketch, it can be no longer
than 20 characters. Send this number to the serial monitor.
Serial.println("Message received from:");
sms.remoteNumber(remoteNumber, 20);
Serial.println(remoteNumber);
It's possible to delete SMS messages by calling sms.flush(). Using sms.peek() it's possible to identify the message index number, which could be helpful for removal
The code below won't remove any from the SIM, but you could iterate through a for loop, or identify a specific index number to remove, instead of the dummy # used below
if(sms.peek()=='#')
{
Serial.println("Discarded SMS");
sms.flush();
}
To read a message, use sms.read(). Here, you'll store each character from the message into the variable c and print it out as it gets read.
while(c=sms.read())
Serial.print(c);
Indicate the message is complete and remove it from memory with sms.flush().
Serial.println("\nEND OF MESSAGE");
sms.flush();
Serial.println("MESSAGE DELETED");
}
Add a brief delay and close the loop.
Once your code is uploaded, open the serial
monitor. With a phone, or other SMS enabled service, send a SMS to the
number of your SIM. You should see the message print out on screen when
it is received.
/*
SMS receiver
This sketch, for the Arduino GSM shield, waits for SMS messages
and displays them through the Serial port.
Circuit:
* GSM shield
*/
// libraries
#include <GSM.h>
// PIN Number
#define PINNUMBER ""
// initialize the library instance
GSM gsmAccess; // include a 'true' parameter for debug enabled
GSM_SMS sms;
char remoteNumber[20]; // Holds the emitting number
void setup()
{
// initialize serial communications
Serial.begin(9600);
Serial.println("SMS Messages Receiver");
// 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(gsmAccess.begin(PINNUMBER)==GSM_READY)
notConnected = false;
else
{
Serial.println("Not connected");
delay(1000);
}
}
Serial.println("GSM initialized");
Serial.println("Waiting for messages");
}
void loop()
{
char c;
// If there are any SMSs available()
if (sms.available())
{
Serial.println("Message received from:");
// Get remote number
sms.remoteNumber(remoteNumber, 20);
Serial.println(remoteNumber);
// This is just an example of message disposal
// Messages starting with # should be discarded
if(sms.peek()=='#')
{
Serial.println("Discarded SMS");
sms.flush();
}
// Read message bytes and print them
while(c=sms.read())
Serial.print(c);
Serial.println("\nEND OF MESSAGE");
// delete message from modem memory
sms.flush();
Serial.println("MESSAGE DELETED");
}
delay(1000);
}
