Guía de Implementación Twido - Envío y recepción de SMS con módem SR2MOD02/03 mediante SGT Producto y Versión: Twido >=v3.2 SGT SMS v2.0 TwidoSoft >=v3.2 ó TwidoSuite Módem SR2MOD02, SR2MOD03 (Wavecom y/o Schneider) Revisión Fecha Autor Comentarios 1.0 02/02/2010 Marc Casanova Primera versión Centro de Competencia Técnica

Índice Función SGT y ¿Qué es la SGT SMS? parámetros Arquitectura y conexionado Diagnóstico Configuración Diagnóstico Módem Configurar Módem Diagnóstico SGT Configurar Proyecto TwidoSuite Puesta en Marcha del Programa Documentación Asociada de Interés

1. ¿Qué es la SGT SMS? Solución Garantizada Twido por Schneider Electric Componentes preprogramados para TwidoSuite  simplificación tiempo de desarrollo SGT SMS es el componente del control MODEM, que será el encargado de la gestión del envío y recepción de mensajes de texto a un teléfono móvil Se trata de un proyecto ya diseñado y testeado que permite enviar y recibir SMS con Twido y un módem SR2MOD02/03 sin necesidad de realizar programación adicional, tan sólo configurando determinadas áreas de memoria y siguiendo una sencilla secuencia de ejecución de los comandos

2. Arquitectura y conexionado La arquitectura básica para comunicar Twido y módem es: Se debe montar accesorio RS232: - TWDNOZ232D para bases modulares (módulo de comunicación con conector mini DIN) - TWDNAC232D para bases compactas (adaptador de comunicación con conector mini DIN) Las bases compactas TWDLC*A10DRF no es posible utilizarlas ya que no admiten ningún puerto adicional. Cable referencia: TWDXCAMD030 SR2MOD02/03 (Wavecom ó Schneider)

2. Arquitectura y conexionado El conexionado alternativo y pinout entre Twido y módem es: Conector SUBD-9 macho Cable mini DIN a punteras

2. Arquitectura y conexionado La arquitectura básica para comunicar PC y módem (para configurarlo desde el Hyperterminal de Windows) es: SR2MOD02/03 (Wavecom ó Schneider)

3. Configuración El módem, a menos que sea un SR2MOD03 con parámetros por defecto, deberá ser configurado para adaptarlo al puerto accesorio RS232 de Twido El proyecto de TwidoSuite debe quedar configurado de un modo concreto para el correcto funcionamiento de la SGT SMS El programa debe ser puesto en marcha bajo un procedimiento determinado que permite el correcto envío y recepción de los mensajes

3.1 Configurar módem Este paso sólo es necesario para módems distintos del SR2MOD03 Schneider, o si éste ha sido configurado diferente a los parámetros de fábrica La configuración del módem debe quedar acorde con los parámetros de comunicación por defecto del puerto RS232 accesorio para Twido, que son:

3.1 Configurar módem El primer paso es ejecutar el Hyperterminal de Windows, aplicación desde la cual conectaremos PC con módem para enviar los comandos AT necesarios y cambiar los parámetros de éste:

3.1 Configurar módem A continuación crearemos la nueva conexión, seleccionaremos el puerto COM que usaremos para la misma y la configuraremos según los ajustes actuales del módem:

3.1 Configurar módem Para evitar confusiones a la hora de enviar los comandos AT conviene activar la opción de eco local de los caracteres escritos:

3.1 Configurar módem Desde la pantalla del Hyperterminal debemos enviar los siguientes comandos AT al módem: Si al reconectar realizamos un comando AT&V debemos recibir esta respuesta: El comando &W realizará la escritura de las configuraciones en el módem, por lo que la comunicación desde el PC se interrumpirá y será necesario cambiar las configuraciones de conexión del Hyperterminal para reconectar con el SR2MODxx

3.1 Configurar módem A modo informativo, la descripción de los comandos AT enviados en el punto anterior es: AT+ICF=3,4  formato de datos 8N1 (8 bits datos, sin paridad, 1 bit de stop) AT+IFC=0,0  sin control de flujo AT+IPR=19200  velocidad 19200 bps AT+CBST=0,0  autovelocidad para llamadas salientes y conexión transparente para salientes y entrantes ATE0  caracteres recibidos sin eco AT&S1  señal DSR desactivada para modo comando y activada para modo datos ATS0=2  respuesta automática tras 2 rings AT&W  guardar modificaciones en la EEPROM AT&V  visualizar configuración actual del módem

3.2 Configurar proyecto de TwidoSuite En el apartado ‘Documentación Asociada de Interés ’ aparece el proyecto SGTSMS ejemplo para TwidoSuite En caso de necesitar agregar programa adicional dejar siempre al final de todo el tramo de código que ya viene generado y, sobre todo, no añadir ni quitar nada de las líneas ya programadas en la SGT SMS Es posible que se necesite utilizar otra CPU. Para ello en la pantalla de descripción no es necesario eliminar los componentes sino simplemente arrastrar una CPU sobre la otra. Al hacerlo se borrarán únicamente los enlaces entre dispositivos (Twido-módem) si la nueva CPU es modulable. En este caso deberán ser generados de nuevo respetando las configuraciones que aparecen a continuación (previa inclusión de un módulo TWDNOZ232D en el proyecto):

3.2 Configurar proyecto de TwidoSuite Previamente se debe configurar el puerto RS232 en modo ASCII. De otra forma no será posible realizar el enlace con el módem.

3.2 Configurar proyecto de TwidoSuite Será necesario que al final del programa se realice la llamada a la subrutina nº 5. Para ello confirmar que tenemos el siguiente código insertado y que se ejecuta desde el primero ciclo de scan del PLC:

3.2 Configurar proyecto de TwidoSuite En el apartado ‘Documentación Asociada de Interés ’ aparece una tabla de animación para la depuración y prueba del proyecto (también adjunto) llamada TWDSMS.tat. En ella se incluyen todas las variables de entrada y salida del módulo:

3.3 Puesta en marcha del programa Se deben respetar las siguientes condiciones iniciales: Subrutina habilitada  %MW530:X0 = 1 Si tarjeta tiene PIN cargarlo en %MW538 y %MW539 Bit ready activo  %MW555:X0 = 1 (no error, PIN válido, cobertura OK y tarjeta registrada en red) Envío de SMS: Activación orden de envío  %MW530:X5 (funciona con flanco ascendente y siempre que bit ready esté activo). Es necesario evitar, por diseño de programa, que se dé la siguiente circunstancia: Señal de orden de envío no debe caer a 0 hasta que no se recibe señal de End

3.3 Puesta en marcha del programa El mensaje enviado debe estar cargado en las variables %MW825-%MW900 El nº teléfono destinatario debe estar cargado en %MW531-%MW537 Durante el envío permanece %MW555:X10=1 No es posible un nuevo envío hasta que %MW555:X11=1 (END) La confirmación de la señal End y Error de envío se realiza desactivando la orden de envío: La señal de error se activa en %MW555:X1 y el código de error se puede consultar en %MW556

3.3 Puesta en marcha del programa Recepción de SMS: Por defecto siempre está el modo recepción activo En el momento en que se recibe un SMS se procede a su lectura y se activa el bit %MW555:X2 Para eliminar el mensaje de las variables es necesario realizar un ACK del mismo (%MW530:X4=1) Si antes de realizar el ACK siguen llegando SMS quedan almacenados en la tarjeta y posteriormente se van recibiendo en el mismo orden de llegada (FIFO) El usuario queda informado de que el SMS se ha recibido a través del bit %MW555:X2 La SIM no debe tener mensajes cuando se inserte en el módem. De otra forma se procederá a su lectura al conectarlo

3.3 Puesta en marcha del programa Variables reservadas (que nunca deben ser usadas por el usuario para otros propósitos que no sean el módulo TWDSMS): %KW0…%KW87: en estas constantes tenemos los valores del protocolo de comunicación con el módem %MW530…%MW899: variables utilizadas ya sean como palabras de entrada/salida ó como palabras de control de la subrutina %L5…%L14: etiquetas de salto reservadas para el funcionamiento de la rutina SR5: la subrutina 5 es la que tiene la programación del módulo TWDSMS

3.3 Puesta en marcha del programa Ejemplo de programa para enviar SMS:

3.3 Puesta en marcha del programa

3.3 Puesta en marcha del programa

4. Función SGT y parámetros Aunque TwidoSuite no admite el lenguaje basado en bloques de función, el módulo TWDSMS (el conjunto de líneas de código) podría extrapolarse a un bloque funcional como el siguiente:

4. Función SGT y parámetros Entradas: Enable SR: habilitación del módulo (0 = desactivado). Nunca deshabilitar dejando de llamar a la subrutina. Reset: flanco ascendente provoca borrado de errores memorizados y se reinicia el ciclo ACKrecepciónSMS: el usuario informa (bit a 1) que se ha recibido el SMS y habilita para que en las variables se carguen los sucesivos mensajes recibidos Orden_Envio_SMSx: bit a 1 guarda orden de envío. Se realizará cuando la secuencia del programa lo permita (no lectura en curso) Texto_Envio: texto que se envía al dar orden correspondiente (en ASCII) Telefono_Envio: nº al que se realiza el envío (en ASCII y con código internacional incluído  +34612345678) Codigo_Pin: PIN de la tarjeta insertada si tiene esta seguridad activa (en ASCII)

4. Función SGT y parámetros Salidas: Ready: indica que la función está lista para enviar/recibir SMS Error: indica que la función está en error (código en Error_Code) Tarjeta_SIM_Defecto: indica que la SIM está en defecto por: 1. SIM no existente 2. Necesidad de introducir PUK 3. Necesidad de introducir PIN2 4. Necesidad de introducir PUK2 Tarjeta_SIM_insertada_sin_código_PIN: indica que la SIM está insertada en el módem pero no se ha introducido el PIN Tarjeta_SIM_insertada_con_código_PIN: tarjeta insertada y PIN correcto introducido Cobertura insuficiente: cobertura de red insuficiente Tarjeta_SIM_no_registrada_en_la_red: tarjeta insertada en módem y código PIN correcto pero no registrada en la red Para los defectos 2 al 4 es necesario sacar la SIM y verificarla en algún teléfono con los códigos que precise

4. Función SGT y parámetros SMS_recibido: bit a 1 cuando se recibe un SMS. Pasa a 0 al realizar un ACK del mensaje (ver apartado anterior de entradas) Fecha_recepción: indica la fecha en la que se ha recibido el SMS (formato: MMDD [%MW559] AAAA [%MW560]) Hora_recepción: indica la hora en la que se ha recibido el SMS (formato: HHMM [%MW563] 00SS [%MW564]) Teléfono: indica el nº desde el que se ha enviado el SMS Datos recibidos: aquí se encuentra el mensaje recibido (en ASCII) Busy: indica que el SMS está en proceso de envío End: indica que ha finalizado el envío del mensaje (aunque puede ser sin éxito). Para verificar si el envío ha sido correcto consultar el bit error_envío=0 Error_envio: indica si envío realizado con éxito o no Error_code_envío: se codifica el tipo de error en caso de existir durante el envío

5. Diagnóstico En este apartado aparecen los diagnósticos a realizar frente a posibles errores Los diagnósticos pueden hacerse desde el módem o a través de los códigos y bits relacionados de la SGT

5.1 Diagnóstico módem El diagnóstico del módem puede realizarse a través del LED que incorpora: A través de comandos AT es posible realizar un diagnóstico más exhaustivo del módem. No se entra en este detalle ya que la SGT se encarga de esta comunicación (ver diagnóstico SGT en apartado 5.2)

5.2 Diagnóstico SGT Existen 2 tipos de errores: Errores bloqueantes  bloquean el ciclo no permitiendo ni envío ni recepción de SMS. La reanudación se realiza mediante un reset Errores no bloqueantes  dan código de error pero permiten que se vuelva a intentar el envío/recepción, es decir, no detienen el ciclo. Se trata de avisos informativos y desaparecen si la condición que lo provocó deja de existir (por ejemplo cobertura insuficiente). Estos errores disponen de una salida específica: - Defecto SIM - Tarjeta SIM sin código PIN - Cobertura insuficiente - Tarjeta no registrada

5.2 Diagnóstico SGT Los posibles códigos de error para realizar un diagnóstico desde la %MW556 son:

Documentación Asociada de Interés SGT SMS V2.0 (incluye proyecto, manual, tabla animación…):

Make the most of your energy www.schneiderelectric.es