Biblioteca GSM

La biblioteca GSM está incluida en el  Arduino IDE 1.0.4 y versiones posteriores.

Con el escudo Arduino GSM Shield, esta biblioteca permite a una placa Arduino hacer la mayoría de las operaciones que se pueden hacer con un teléfono GSM: realizar y recibir llamadas de voz, enviar y recibir SMS, y conectarse a Internet a través de una red GPRS.

El escudo GSM tiene un módem que transfiere datos desde un puerto serie a la red GSM. El módem realiza operaciones a través de una serie de comandos AT. La biblioteca abstrae comunicaciones de bajo nivel entre el módem y la tarjeta SIM. Se basa en la  Sbiblioteca Software Serial para comunicación entre el modem y Arduino.

Típicamente, cada comando individual es parte de una serie mayor de comandos necesarios para ejecutar una función en particular. La biblioteca también puede recibir información y devolverserla a usted cuando sea necesario.

Estructura de la biblioteca

Como la biblioteca permite múltiples tipos de funcionalidad, hay un número de diferentes clases.

• La clase GSM se encarga de comandos para el módem de radio. Este se encarga de los aspectos de conectividad del escudo y registra el sistema en la infraestructura GSM. Todos sus programas GSM / GPRS tendrán que incluir un objeto de esta clase para manejar la comunicación bajo el nivel necesario.
• La gestión de llamadas de voz, gestionada por la clase GSMVoiceCall.
• Enviar / recibir mensajes SMS, gestionados por la clase GSM_SMS.
• La clase GPRS para la conexión a internet.
• GSMClient incluye implementaciones para un cliente, similar a las bibliotecas Ethernet y WiFi.
• Gsmserver incluye implementaciones para un servidor, de forma similar a las bibliotecas de Ethernet y WiFi. Nota: Algunos operadores de red no permiten conexiones entrantes desde Internet público, pero las permitirá desde su prpia red . Consulte con su operador para ver cuales son las restricciones sobre el uso de datos.
• Un número de clases de utilidad como GSMScanner y GSMModem.

Compatibilidad de la biblioteca Ethernet

La biblioteca intenta ser lo más compatible posible con la biblioteca actual de Ethernet. Trasladar un programa desde un Arduino Ethernet o  biblioteca WiFi a un Arduino con el Escudo GSM debería ser bastante fácil. Si bien no es posible simplemente ejecutar código compatible con Ethernet en el escudo GSM, serán necesarias alguna modificaciones, como incluir las librerías específicas GSM y GPRS y obtener los valores de configuración de red de su proveedor de red celular.

Funciones de la biblioteca GSM
Clase GSM	Esta clase prepara a las funciones con las que se comunicará con el módem.
Clase GSMVoiceCall	Permite la comunicación de voz a través del módem. Necesita añadir para su uso completo un micrófono y un altavoz.
Clase GSM_SMS	Facilita el envío y recepción de servicio de mensajes cortos (SMS).
Clase GPRS	Esta clase es responsable de incluir los archivos que forman parte de la biblioteca que implica la comunicación TCP.
Clase GSMClient	La clase cliente crea clientes que pueden conectarse a los servidores y enviar y recibir datos.
Clase GSMServer	La clase Server crea servidores que pueden enviar datos y recibir datos de clientes conectados (programas que se ejecutan en otros ordenadores o dispositivos).
Clase GSMModem	La clase de módem GSM facilita la comunicación para el diagnóstico del módem.
Clase GSMScanner	La clase GSMScan ner proporciona información de diagnóstico acerca de la red y la portadora.
Clase GSMPin	La clase GSMPIN tiene utilidades para la comunicación con la tarjeta SIM.
Clase GSMBand	La clase Band GSM proporciona información acerca de la banda de frecuencia con la que el módem se conecta. Existen también métodos para la configuración de la banda.

Ejemplos

Hay dos grupos de ejemplos para el escudo GSM. Hay ejemplos para ilustrar las posibilidades del escudo, como la forma de enviar mensajes SMS y conectarse a internet. También hay ejemplos de herramientas que se pueden utilizar para depurar la funcionalidad de la biblioteca y el hardware en el nivel inferior.

Gsm Web Client: Descarga el contenido de un sitio web a su placa Arduino a través de GPRS.
Gsm Web Server: Crea un servidor web inalámbrica a través de GPRS.
Make Voice Call: Realiza llamadas telefónicas desde el Monitor serie.
Send SMS: Utiliza el Monitor serie para escribir mensajes SMS a números de teléfono distintos.
Receive Voice Call: Comprueba el estado del módem mientras recibe llamadas de voz.
Receive SMS: Lee un mensaje SMS y lo imprime en el Monitor serie.

HERRAMIENTAS

Band Management: Gestiona la banda GSM del escudo.
GSM Scan Networks: Verifica si hay redes disponibles.
Pin Management: Administra el número PIN de su tarjeta SIM.
Test GPRS: Prueba de la correcta funcionalidad de la red GPRS usando su tarjeta SIM.
Test Modem: Lea el IMEI de su módem.
Test Web Server: Crea un servidor web con su escudo GSM.

Para obtener información adicional sobre el escudo GSM, consulte la página Introducción  y la página de hardware del escudo GSM.