GSM Test Modem
This sketch tests the modem on the GSM shield to see if it is working correctly. You do not need a SIM card for this example.
Hardware Required
- Arduino or Genuino Board
- Arduino + Telefonica GSM/GPRS Shield
Circuit
image of the Arduino GSM Shield on top of an Arduino or Genuino board
Code
First, import the GSM library
#include <GSM.h>
Create an instance of the GSMModem class:
GSMModem modem;
Create a variable to hold the IMEI number of the modem
In setup, open a serial connection to the computer. After opening the connection, send a message indicating the sketch has started.
Serial.begin(9600);
Serial.print("Starting modem test...");
Call modem.begin() to start the modem. Send a status message depending on the outcome, and end setup().
Serial.println("modem.begin() succeeded");
else
Serial.println("ERROR, no modem answer.");
}
Inside loop, use modem.getIMEI() to return the IMEI number of the modem. This number is unique to your GSM shield.
{
// get modem IMEI
Serial.print("Checking IMEI...");
IMEI = modem.getIMEI();
If there is a valid response from getIMEI(), print it to the serial monitor and reset the modem with modem.begin().
{
// show IMEI in serial monitor
Serial.println("Modem's IMEI: " + IMEI);
// reset modem to check booting:
Serial.print("Reseting modem...");
modem.begin();
Once reset, check the IMEI again. If it is a valid return again, the modem is functioning as expected.
{
Serial.println("Modem is functoning properly");
}
If, after resetting the modem, there is not a valid return from getIMEI(), report an error
{
Serial.println("Error: getIMEI() failed after modem.begin()");
}
If you never received an IMEI after starting the sketch, report it, and end the program.
else
{
Serial.println("Error: Could not get IMEI");
}
// do nothing:
while(true);
}
Once your code is uploaded, open the serial monitor. You should see the HTML of http://arduino.cc print out on screen when it is received.
The complete sketch is below.
This example tests to see if the modem of the
GSM shield is working correctly. You do not need
a SIM card for this example.
Circuit:
* GSM shield attached
Created 12 Jun 2012
by David del Peral
modified 21 Nov 2012
by Tom Igoe
http://www.arduino.cc/en/Tutorial/GSMToolsTestModem
This sample code is part of the public domain
*/
// libraries
#include <GSM.h>
// modem verification object
GSMModem modem;
// IMEI variable
String IMEI = "";
void setup() {
// initialize serial communications and wait for port to open:
Serial.begin(9600);
while (!Serial) {
; // wait for serial port to connect. Needed for Leonardo only
}
// start modem test (reset and check response)
Serial.print("Starting modem test...");
if (modem.begin()) {
Serial.println("modem.begin() succeeded");
} else {
Serial.println("ERROR, no modem answer.");
}
}
void loop() {
// get modem IMEI
Serial.print("Checking IMEI...");
IMEI = modem.getIMEI();
// check IMEI response
if (IMEI != NULL) {
// show IMEI in serial monitor
Serial.println("Modem's IMEI: " + IMEI);
// reset modem to check booting:
Serial.print("Resetting modem...");
modem.begin();
// get and check IMEI one more time
if (modem.getIMEI() != NULL) {
Serial.println("Modem is functoning properly");
} else {
Serial.println("Error: getIMEI() failed after modem.begin()");
}
} else {
Serial.println("Error: Could not get IMEI");
}
// do nothing:
while (true);
}
See Also
- Arduino GSM Shield – Complete product description.
- Getting started with the GSM Shield – Get everything set up in minutes.
- GSM library – Your reference for the GSM Library.
- GSMToolsTestGPRS - Tries to access the internet over GPRS with supplied APN and credentials.
- GSMToolsBandManagement - Checks the band currently configured in the modem and allows you to change it.
- GSMToolsGsmScanNetworks - Scans the available networks and prints informations about IMEI and number of the SIM card.
- GSMToolsPinManagement - How to to change or remove the PIN number.
- GSMToolsTestWebServer - A simple web server that replies with nothing, but prints the client's request and the server IP address.
- GSMExamplesMakeVoiceCall - How to make a voice call with mic and speaker.
Last revision 2018/08/23 by SM
