MTX-Tunnel-v8 Manual de usuario

Transcripción

1 MTX-Tunnel-v8 Manual de usuario Página 1

2 General Notes Product is deemed accepted by recipient and is provided without interface to recipient s products. The documentation and/or product are provided for testing, evaluation, integration and information purposes. The documentation and/or product are provided on an as is basis only and may contain deficiencies or inadequacies. The documentation and/or products are provided without warranty of any kind, express or implied. To the maximum extent permitted by applicable law, Matrix Electronica further disclaims all warranties, including without limitation any implied warranties of merchantability, completeness, fitness for a particular purpose and non-infringement of third-party rights. The entire risk arising out of the use or performance of the product and documentation remains with recipient. This product is not intended for use in life support appliances, devices or systems where a malfunction of the product can reasonably be expected to result in personal injury. Applications incorporating the described product must be designed to be in accordance with the technical specifications provided in these guidelines. Failure to comply with any of the required procedures can result in malfunctions or serious discrepancies in results. Furthermore, all safety instructions regarding the use of mobile technical systems, including GSM products, which also apply to cellular phones must be followed. Matrix Electronica or its suppliers shall, regardless of any legal theory upon which the claim is based, not be liable for any consequential, incidental, direct, indirect, punitive or other damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information or data, or other pecuniary loss) arising out the use of or inability to use the documentation and/or product, even if Matrix Electronica has been advised of the possibility of such damages. The foregoing limitations of liability shall not apply in case of mandatory liability, e.g. under the Spanish Product Liability Act, in case of intent, gross negligence, injury of life, body or health, or breach of a condition which goes to the root of the contract. However, claims for damages arising from a breach of a condition, which goes to the root of the contract, shall be limited to the foreseeable damage, which is intrinsic to the contract, unless caused by intent or gross negligence or based on liability for injury of life, body or health. The above provision does not imply a change on the burden of proof to the detriment of the recipient. Subject to change without notice at any time. The interpretation of this general note shall be governed and construed according to Spanish law without reference to any other substantive law. Important information This technical description contains important information for start up and use of the MTX-Tunnel application. Read it carefully before you start working with MTXTerminals & MTX-TUNNEL. The warranty will be void should damage occur due to non-compliance with these instructions for use. We cannot accept any responsibility for consequential loss. Service and Support To contact customer support please use the contact details below: Matrix Electronica Alejandro Sanchez, Madrid Spain gsmsupport@matrix.es Information about MTX-TUNNEL product is available on the following web site: Information about MTX-65 product and accessories is available on the following web site: And following FTP server (ask for user&password access): ftp://ftp.matrixelectronica.eu/ Or contact your local distributor / sales agent: REVISION INFORMATION VERSION. V8.10 Release: July 2014 Página 2

3 Índice 1.- Introducción Prestaciones de la nueva versión MTX-Tunnel v FAQ. Conceptos básicos MTX-Tunnel Configuración del MTX-Tunnel - Paso a paso Servicio WebServer Servicio TELNET Comandos AT. API de usuario Cómo y desde donde se pueden envían comandos AT al MTX-Tunnel? Comandos AT estándar soportados por el MTX-Tunnel Comandos AT especiales (API) soportados por el MTX-Tunnel Parámetros de configuración del MTX-Tunnel...53 Anexo 1 Escenarios y Configuraciones de Ejemplo Básicos ESCENARIO EJEMPLO 1.1 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS permanentemente y usando una tarjeta SIM provisionada por el operador con una dirección IP fija ESCENARIO EJEMPLO 1.2 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS de forma ocasional y usando una tarjeta SIM con dirección IP dinámica ESCENARIO EJEMPLO 1.3 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS de forma ocasional usando una tarjeta SIM con dirección IP dinámica con servicios de Firewall y números de teléfono autorizados activados ESCENARIO EJEMPLO 1.4 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Cliente TCP/IP conectado a GPRS de forma permanente usando una tarjeta SIM con dirección IP dinámica Anexo 2 Escenarios y Configuraciones de Ejemplo Avanzados ESCENARIO EJEMPLO 2.1 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Servidor TCP/IP permanentemente conectado y configurado para el envío de su IP por socket a un servidor de DNS privado ESCENARIO EJEMPLO 2.2 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Servidor TCP/IP permanentemente conectado y configurado para el envío de su IP a un servidor Web por HTTP GET ESCENARIO EJEMPLO 2.3 Túnel GPRS-RS232 - Configuración del módem como Servidor TCP/IP permanentemente conectado, con DynDNS y con socket Cliente Temporal habilitado Página 3

4 ESCENARIO EJEMPLO 2.4. Túnel avanzado GPRS-RS232 - Configuración del módem como Servidor TCP/IP conectado ocasionalmente por cambio de GPIO y ADC ESCENARIO EJEMPLO 2.5 Túnel dual GPRS-RS232 - Control de dos dispositivos RS232 con un único módem y una única tarjeta SIM. Conexión socket tipo servidor ESCENARIO EJEMPLO 2.5-bis Túnel dual GPRS-RS232 - Control de dos dispositivos RS232 con un único módem y una única tarjeta SIM. Conexión socket tipo cliente ESCENARIO EJEMPLO 2.6. Alarma por SMS ante el cambio de una entrada Digital ESCENARIO EJEMPLO 2.7 Cable serie replacer RS232-GPRS-RS ESCENARIO EJEMPLO 2.8 Túnel GPRS-Serie UDP. MTX-Tunnel configurado como Cliente/Servidor UDP conectado a GPRS permanentemente y usando una tarjeta SIM provisionada por el operador con una dirección IP fija ESCENARIO EJEMPLO 2.9 Control de Relés por SMS con posibilidad de acceso por WebBrowser al MTX-Tunnel ESCENARIO EJEMPLO 2.10 Túnel GPRS-Serie con seguridad SSL. MTX-Tunnel configurado como Cliente TCP/IP conectado a GPRS de forma permanente usando una tarjeta SIM con dirección IP dinámica ESCENARIO EJEMPLO 2.11 Envío de telemetrías y posición GPS a un Servidor Web por HTTP de forma ocasional. Ejemplo antirrobo / antisecuestro ESCENARIO EJEMPLO 2.12 Envío de telemetrías periódico (GPIOs y ADCs) a Servidor WEB por HTTP ESCENARIO EJEMPLO 2.13 Envío de telemetrías (GPIOs y ADCs) por detección de cambio digital y entradas analógicas fuera de rango ESCENARIO EJEMPLO 2.14 Envío de telemetrías periódicas (entradas digitales y analógicas) mediante objeto JSON a servidor WEB ESCENARIO EJEMPLO 2.15 Pasarela GPRS ModBus TCP / ModBus RTU ESCENARIO EJEMPLO 2.16 Envío de replicación de entradas digitales en relés vía GPRS ESCENARIO EJEMPLO 2.17 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Cliente TCP/IP con conexión de 3 veces a la hora ESCENARIO EJEMPLO 2.18 Túnel avanzado GPRS-Serie - Envío y recepción de datos a múltiples servidores mediante paquetes de datos UDP ESCENARIO EJEMPLO 2.19 Pasarela GPRS-Serie con envío de datos a un servidor de las tramas que empiecen únicamente por una cabecera concreta ESCENARIO EJEMPLO 2.20 Conversión de un sistema basado con antiguas comunicaciones GSM en un sistema de comunicaciones IP (GPRS) ESCENARIO EJEMPLO 2.21 Alarmas SMS ante detección de pérdida de alimentación 220V y ante el retorno de alimentación ESCENARIO EJEMPLO 2.22 Uso del MTX-Tunnel como pasarela GPRS-RS232 y como elemento de Sincronización horaría de un dispositivo externo conectado al módem Página 4

5 ESCENARIO EJEMPLO 2.23 Uso del MTX-Tunnel como Logger de tramas serie ESCENARIO EJEMPLO 2.24 Uso del MTX-Tunnel como Logger de tramas serie. Envío de tramas serie customizadas y periódicas para protocolos propietarios Anexo 3 Escenarios y Configuraciones de Ejemplo ULP (Ultra Low Power) ESCENARIO EJEMPLO 3.1 Envío de SMS de alarma ante la activación de entrada digital con módem de ultrabajo consumo ESCENARIO EJEMPLO 3.2 Monitorización periódica por SMS de entradas digitales/analógicas con módem de ultrabajo consumo ESCENARIO EJEMPLO 3.2 Monitorización periódica por SMS de entradas digitales/analógicas con módem de ultrabajo consumo ESCENARIO EJEMPLO 3.3 Monitorización periódica por GPRS de entradas digitales/analógicas con módem de ultrabajo consumo ESCENARIO EJEMPLO 3.4 Monitorización no periódica (por evento) mediante GPRS de entradas digitales / analógicas con módem de ultrabajo consumo ESCENARIO EJEMPLO 3.5 Túnel GPRS-RS232 con módem de ultrabajo consumo. Activación por tiempo ESCENARIO EJEMPLO 3.6 Túnel GPRS-RS232/RS485 con módem de ultrabajo consumo. Activación por fecha / hora Anexo 4 Escenarios y Configuraciones de Ejemplo API ESCENARIO EJEMPLO 4.1 Uso de la API para Lectura de las GPIOs y ADCs del MTX-Tunnel desde una página WEB externa ESCENARIO EJEMPLO 4.2 Uso de la API para el envío de datos por el puerto serie del MTX-Tunnel desde un Formulario web ubicado en una página web externa ESCENARIO EJEMPLO 4.3 Uso de la API para conmutar 4 Relés desde una página WEB externa ESCENARIO EJEMPLO 4.4 Uso de la API para el envío de un mensaje SMS mediante un dispositivo (PLC) a través del puerto serie COM1 mientras el túnel Serie-GPRS está activo Anexo 5 Escenarios y Configuraciones de Ejemplo para la comunicación con dispositivos Wavenis ESCENARIO EJEMPLO 5.1 Lectura de sensores radio de temperaturas y 4-20mA. Concentrador GPRS con envío de datos a servidor web mediante objeto JSON Anexo 6 Escenarios y Configuraciones de Ejemplo para la lectura automática de dispositivos MODBUS.336 ESCENARIO EJEMPLO 6.1 Lectura y envío periódico a un servidor Web de los registros MODBUS de un PLC ESCENARIO EJEMPLO 6.2 Lectura y envío periódico a un servidor Web de los registros de 5 Contadores eléctricos con protocolo ModBus RTU ESCENARIO EJEMPLO 6.3 Lectura y envío periódico a un servidor Web de los registros de 5 Contadores eléctricos con protocolo ModBus RTU y mapa de memoria de registros distintos Página 5

6 ESCENARIO EJEMPLO 6.4 Lectura y envío periódico a un servidor Web de los registros de 3 sondas de temperatura Modbus (Modelo MTX-Temp-RS485-IP65 de los accesorios MTX) ESCENARIO EJEMPLO 6.5 Lectura y envío periódico a un servidor Web de los registros MODBUS de un PLC + pasarela GPRS para actualización remota del firmware del PLC ESCENARIO EJEMPLO 6.6 Ejemplo AVANZADO de lectura de dispositivos modbus con envío a Plataforma Web mediante objeto JSON ESCENARIO EJEMPLO 6.7 Uso de un MTX como datalogger modbus local, sin tarjeta SIM ni conexiones GPRS.355 ESCENARIO EJEMPLO 6.8 Lectura de registros Modbus tipo Word y Binarios y envío mediante JSON a plataforma web Anexo 7 Escenarios ejemplo de Metering. Escenarios de lectura de contadores vía GSM y GPRS ESCENARIO EJEMPLO 7.1 Ejemplo básico para lectura de contadores, simultaneando conexiones GPRS y llamadas GSM ESCENARIO EJEMPLO 7.2 Ejemplo avanzado para lectura de 2 equipos serie, usando un único módem / SIM y simultaneando conexiones GPRS y llamadas GSM. Pasarela adicional Serie-Serie cuando no hay conexiones GSM / GPRS Anexo 8 Escenarios y Configuraciones de Ejemplo para el uso de las Salida Digitales y Relés ESCENARIO EJEMPLO 8.1 Apertura de puerta mecánica mediante una llamada perdida desde un número de teléfono autorizado ESCENARIO EJEMPLO 8.2 Envío alarma SMS y activación de salida digital ante una temperatura fuera de márgenes. Uso de una sonda modbus RS ESCENARIO EJEMPLO 8.3 Activación de Relés en función de la Hora, del valor de un dispositivo 4-20mA y del valor de los registros modbus de una sonda de temperatura. Envío de alarmas SMS en función de un registro modbus ESCENARIO EJEMPLO 8.4 Conmutación de un relé en función del reloj astronómico del MTX ESCENARIO EJEMPLO 8.5 Conmutando un Relé durante X segundos con un único mensaje SMS Anexo 9 Escenarios ejemplo con Bluetooth ESCENARIO EJEMPLO 9.1 Acceso al puerto RS232 de lectura de una máquina de vending a través de 3G y de Bluetooth ESCENARIO EJEMPLO 9.2 Lectura de entradas digitales y analógicas y conmutación de relés desde una App Android, vía Bluetooth y vía GPRS/3G Anexo 10 Escenarios ejemplo de pagos mediante Bitcoin ESCENARIO EJEMPLO 10.1 Pago instantáneo on-line con Bitcoin para activación temporal de relés. Activación de un sistema de autolavado de coches ESCENARIO EJEMPLO 10.2 Recepción de pago on-line mediante teléfono móvil con Bitcoin para máquina de Vending Página 6

7 Anexo A Descripción de las E/S usadas por el MTX-Tunnel MTX-65i + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65i MTX-65i-ULP + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65i-ULP (MTX-65-GPS-V3 / MTX-65-GPS-BAT-V5 / MTX-65i-GPS-V6 / MTX-65i-GPS-BAT-V7) + MTX-Tunnel MTX-IND / MTX-IND-V1 / MTX-IND-3G-JAVA + MTX-Tunnel MTX-65i-RS485 + MTX-Tunnel MTX-3G-JAVA + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-3G-JAVA MTX-3G-JAVA-BAT / MTX-3G-JAVA-GPS + MTX-Tunnel Anexo B Cómo usar Puerto Serie Virtuales com VSPE SOFTWARE DE EMULACIÓN DE PUERTOS SERIE: VSPE Guía breve del software de emulación de puertos serie Anexo C Release notes de versiones MTX-Tunnel Página 7

8 1.- Introducción. El MTX-Tunnel es principalmente un Gateway (pasarela) serie-gprs y serie-gsm pensado para aplicaciones de tele-lectura de dispositivos serie y tele-mantenimiento, es decir, para evitar desplazamientos por el simple hecho de conectar un cable serie RS232/RS485 a un dispositivo. Podrá conectar con sus dispositivos serie como si los tuviera conectados al puerto serie de su ordenador (contadores eléctricos, PLCs, estaciones metereológicas, etc etc) La actual versión del MTX-Tunnel ha aumentado muchísimo sus prestaciones en relación a las versiones previas, permitiendo resolver muchos de los escenarios reales relacionados con el tele-mantenimiento y telemetría (control de entradas y salidas digitales y analógicas, control de relés, bus I2C/SPI, envío posición GPS, control por SMS, webserver, telnet ) Cómo usar este manual? Si usted no está familiarizado con el MTX-Tunnel, se recomienda que utilice este manual de la siguiente manera: 1.- Lea el capítulo 3) sobre los Conceptos básicos del MTX-Tunnel. FAQ. Con una lectura rápida de 10 páginas entenderá qué puede hacer con MTX-Tunnel y sabrá rápidamente si le es de utilidad o no. 2.- Lea el capítulo 4) sobre Cómo configurar el MTX-Tunnel. Aprenderá rápidamente a configurar un MTX-Tunnel con un paso a paso muy breve. Aprenderá una primera configuración básica y real del MTX-Tunnel para que vea físicamente cómo funciona. 3.- Lea el Anexo con los Ejemplos de Escenarios. Tiene disponible decenas de ejemplos de escenarios reales que actualmente están trabajando en campo. Es muy probable que la solución que busca ya esté en uno de los ejemplos y que no necesite mucho más esfuerzo por su parte. Busque el más parecido a lo que necesite y modifíquelo ajustándolo totalmente. 4.- Lea la descripción de los Parámetros de Configuración que necesite. Una vez localice en el Anexo el ejemplo de escenario más similar a lo que necesita hacer, use el capítulo donde se encuentran explicados los parámetros de configuración para comprenderlos y ajustarlos a sus necesidades. Página 8

9 2.- Prestaciones de la nueva versión MTX-Tunnel v8 Multiplataforma El nuevo MTX-Tunnel v8 permite ser usado sobre toda la familia disponible de módems MTX. El hecho de usar el MTX-Tunnel sobre un determinado tipo de módem determinará algunos detalles del comportamiento de éste. En general, el MTX-Tunnel puede solicitarse a su distribuidor sobre un módem modelo: MTX-65i: MTX-65i-RS485: MTX-IND-V1: MTX-65i-ULP: MTX-65-GPS-V3: para los túneles serie-gprs, serie-gsm y control de telemetrías más genéricos. para los túneles serie-gprs, serie-gsm cuando necesite usar un puerto RS485 cuando se necesite usar un bus RS485 y/o controlar relés. para aplicaciones con necesidad de ultra-bajo consumo (2uA) cuando además se precisen prestaciones GPS MTX-65-GPS-BAT-V5: cuando además se precisen prestaciones GPS con batería MTX-65i-GPS-V6: evolución terminal MTX-65-GPS-V3 MTX-65-GPS-BAT-V7 evolución terminal MTX-65-GPS-BAT-V5 MTX-IND: MTX-3G-JAVA: MTX-3G-JAVA-BAT: cuando se necesite RS485, relés, comunicaciones RF, alimentación de 220/110Vac mismas prestaciones que el MTX-65i pero en versión 3G Versión 3G con Batería MTX-3G-JAVA-GPS: Versión 3G con GPS MTX-3G-JAVA-ULP: mismas prestaciones que el MTX-65i-ULP pero en versión 3G MTX-3G-JAVA-ULP-GPS: mismas prestaciones que el MTX-65i-ULP pero añadiendo GPS MTX-IND-3G-JAVA: mismas prestaciones que el MTX-IND pero en versión 3G Página 9

10 Pasarelas TCP, UDP y GSM Los 4 tipos de túneles básicos que permite realizar el MTX-Tunnel son: 1.- Tunnel GPRS-Serie (modo TCP Server) El MTX-Tunnel permanece conectado a GPRS a la espera de recibir conexiones remotas por un puerto TCP. Al recibir una conexión se establece una pasarela transparente GPRS-Serie. 2.- Tunnel GPRS-Serie (modo TCP Client) El MTX-Tunnel conectado a GPRS se conecta por iniciativa propia a un servidor remoto estableciendo una pasarela transparente GPRS-Serie. 3.- Tunnel GPRS-Serie (modo UDP) El MTX-Tunnel conectado a GPRS permite establecer una pasarela transparente GPRS-Serie pero utilizando protocolo UDP en lugar de TCP. 4.- Tunnel GSM-Serie. El MTX-Tunnel permite la recepción de llamadas GSM convencionales (por ejemplo para aceptar las típicas llamadas de operadoras de energía (Endesa, Iberdrola, ) para la lectura de contadores. MTX-Tunnel permite además, la simultaneidad de llamadas GSM con conexiones GPRS. Es decir, usted puede acceder tanto vía GPRS a su dispositivo como vía GSM. Conexión GPRS permanente o bajo demanda. A diferencia de versiones previas del MTX-Tunnel, a partir de la versión 5.0 se permite activar cualquier tipo de túnel GPRS-Serie (TCP Server, TCP Client, UDP, ) bajo demanda. Es decir, además de la posibilidad de mantener la sesión GPRS activa el 100% del tiempo (llamada también conexión permanente) es posible activar la sesión GPRS (y por tanto un túnel serie-gprs) mediante... un SMS (desde cualquier teléfono o sólo autorizados)... una llamada perdida (desde cualquier teléfono o sólo autorizados)... un cambio en una entrada digital Página 10

11 ... una tensión analógica fuera de márgenes... datos recibidos en el puerto serie (sólo túnel TCP Server) Pasarelas GSM-Serie con prioridad a GPRS-Serie. Desde la versión MTX-Tunnelv7.11 se gestiona la recepción de llamadas de datos GSM con prioridad a GPRS. Muy importante en aplicaciones de Metering (lectura de contadores). El MTX-Tunnel puede establecer una pasarela GPRS-Serie para la lectura en tiempo real de un contador, pero cuando recibe una llamada GSM (típicamente de un operador de energía como Endesa, Iberdrola, ) para leer el contador, las pasarelas GPRS-Serie se interrumpen para dar paso a la llamada GSM, reestableciéndose al finalizar ésta. WebServer. El MTX-Tunnel incluye un pequeño WebServer embebido que puede activarse o desactivarse según las necesidades. Activar el WebServer permite el acceso al MTX-Tunnel de forma remota a través de Internet usando el navegador de un ordenador. Las características principales de este WebServer son:... WebServer público o de acceso restringido (login y password)... muestra el estado de las entradas digitales y analógicas del MTX-Tunnel permite cambiar el estado de las salidas digitales y relés con un clic de ratón.... permite cambiar los parámetros de configuración del MTX-Tunnel de forma remota.... permite ejecutar comandos AT a través de un simple formulario Web (por ejemplo, se puede enviar el comando AT+CSQ para comprobar la cobertura de forma remota).... API. El WebServer incluye una pequeña API (mediante peticiones HTTP GET) que permite la integración y control remoto del MTX-Tunnel desde páginas Web de terceros (por ejemplo, para cambiar el estado de un relé del desde una página Web externa). Telnet. El software MTX-Tunnel incluye un pequeño servidor Telnet embebido que puede activarse o desactivarse según convenga. Activando el Telnet podrá acceder a su MTX-Tunnel de forma remota a través de Internet usando un PC con un cliente Telnet. Las características principales de este servidor Telnet son: Página 11

12 ... Telnet público o de acceso restringido (login y password)... le permite leer el estado de las entradas digitales y analógicas del MTX- Tunnel permite cambiar el estado de las salidas digitales y relés... permite cambiar los parámetros de configuración del MTX-Tunnel de forma remota.... permite ejecutar comandos AT genéricos de forma remota a través de Telnet... el uso de Telnet también permite el control del MTX-Tunnel a través de aplicaciones terceras. En definitiva, con Telnet podrá acceder a su módem remotamente, sin necesidad de desplazamientos, para cambiar configuraciones, chequear coberturas Alarmas SMS Es posible configurar el MTX-Tunnel para enviar un SMS con un texto configurable de alarma ante el cambio de una entrada digital. El mensaje SMS puede enviarse hasta a 10 números de teléfono. Le permite enviar un SMS de texto distinto, si lo desea, en función del valor de la entrada digital. Control total del MTX-Tunnel por SMS La nueva versión MTX-Tunnel permite un control total mediante SMS. Es posible enviar comandos AT al MTX-Tunnel desde un teléfono móvil (desde cualquier número o únicamente desde los números de teléfono autorizados). Esto permite leer o cambiar el estado de una entrada ó salida digital, cambiar el estado de un relé, conocer la cobertura de forma remota, obtener la posición GPS por SMS etc etc. Se permite la creación de ALIAS personalizados por parte del usuario. Por ejemplo, si se crea el ALIAS: RELE1ON>AT^SSIO=0,0 implica que el envío de un SMS con el texto RELE1ON sea interpretado por el módem como el comando AT AT^SSIO=0,0, lo que hará conmutar el Relé1. DynDNS DynDNS, servicio ofrecido por permite asignar un nombre de DNS a una dirección IP dinámica de forma gratuita. Una tarjeta SIM aprovisionada con GPRS puede ser de 2 tipos. Con dirección IP fija o dirección IP dinámica. La tarjeta SIM con Página 12

13 dirección IP dinámica es más económica, pero el operador de telefonía asignará una dirección IP diferente al MTX-Tunnel cada vez que éste inicie una sesión GPRS. El servicio DynDNS permite asociar una DNS tipo sudispositivo.dyndns.org a la dirección IP que tenga en todo momento el MTX-Tunnel. Compatible también con el servicio de No-IP DNS privado Una de las características más importantes del MTX-Tunnel es la capacidad de enviar su dirección IP cada vez que ésta cambie. En un escenario con varios cientos de MTX-Tunnel funcionando con tarjetas SIM con dirección IP dinámica resulta complicado y tedioso usar DynDNS. Es mucho más sencillo (y económico) el mantenimiento de un servidor privado para ello. El MTX-Tunnel es capaz de informar con su IP cada vez que ésta cambie, o de forma periódica, y lo puede hacer contra un servidor por socket TCP o bien puede informar mediante HTTP GET a un servidor WEB. Firewall Cualquier conexión entrante al MTX-Tunnel, si así está configurado, pasará por su firewall. Es decir, es posible proteger los Túneles GPRS-Serie, los servicios WEB, Telnet, etc de conexiones no autorizadas y especificar hasta 10 direcciones IP autorizadas. Sincronización automática horaria MTX-Tunnel no necesita ponerse en hora, lo hace automáticamente. Permite el uso de hasta 2 servidores de hora, tomando automáticamente la hora vía GPRS. Necesario para usar las nuevas tareas de Datalogger de MTX-Tunnel, para activar la pasarela automáticamente a una hora Túnel GPRS-I2C/SPI MTX-Tunnel permite el control y monitoreo remoto de dispositivos SPI/I2C (pantallas SPI, sensores I2C...) conectados al bus SPI/I2C de cualquier plataforma MTX-65i, MTX-IND, MTX-65i-ULP y MTX-65-GPS-V3. MTX-Tunnel permite el acceso vía GPRS a dispositivos I2C / SPI como si estuvieran directamente conectados a un ordenador por bus cable. Sólo disponible en versión MTX- Tunnel v7. Página 13

14 Túnel GPRS HTTP-Serie (RS232/485) MTX-Tunnel permite crear un túnel HTTP-Serie. De esa manera es posible acceder a los dispositivos serie que estén conectados al MTX-Tunnel a partir de una página Web externa. Túnel SMS-Serie (RS232/485) MTX-Tunnel permite crear un túnel SMS-Serie. De esta manera es posible redirigir el texto enviado en un mensaje SMS hacia el puerto serie del MTX-Tunnel. Túneles ULP (Ultra Low Power) El MTX-Tunnel soporta las plataformas MTX-65i-ULP, MTX-3G-JAVA-ULP y son pues ideales para escenarios en los que el consumo sea absolutamente determinante y sólo se requiera que el módem y la sesión GPRS estén activos un corto espacio de tiempo a horas muy concretas. Resumidamente, MTX-Tunnel permite: Encendido del módem + sesión GPRS/3G (y servicios asociados, túneles, webserver, telnet, SMS, ) de forma periódica cada X horas configurables. Encendido del módem + sesión GPRS/3G (y servicios asociados, túneles, webserver, telnet, SMS, ) de forma periódica a ciertas fechas/horas determinadas. Encendido del módem + envío de telemetrías por SMS cada X horas configurables. Envío de telemetrías vía GSM/GPRS MTX-Tunnel dispone de la capacidad de reportar telemetrías (estado de entradas y salidas digitales, entradas analógicas y posición GPS (si se usa sobre un modelo MTX que incluya GPS)). Es posible configurar el MTX-Tunnel para enviar las telemetrías de forma periódica, a unas fechas/horas determinadas, ante un cambio de un estado digital, valor de entrada analógica fuera de orden, por llamada perdida o por un SMS. El MTX-Tunnel puede enviar las telemetrías a un servidor mediante una conexión tipo TCP socket a un servidor mediante protocolo UDP a un servidor WEB por HTTP GET por SMS Seguridad SSL MTX-Tunnel es capaz de establecer sockets seguros con encriptación habilitada contra un servidor SSL. Únicamente posible para conexiones túnel tipo Socket TCP Cliente. Página 14

15 Monitorización de equipos Modbus MTX-Tunnel es capaz de leer de forma periódica tablas de memoria de dispositivos Modbus (serie 232/485 RTU) y enviarlos de forma automática a un servidor web mediante un objeto JSON (http). En caso de no haber cobertura GPRS es capaz de almacenar en memoria flash hasta 1500 registros de lecturas. Monitorización de sensores RF 868MHz (Wavenis) MTX-Tunnel puede trabajar como concentrador de dispositivos radio Wavenis. Pensado para trabajar con sensores Wavetherm (sondas de temperatura), Wavesense (entradas analógicas 0-10V y 4-20mA), Waveflow (contador de pulsos) y Wavelog (entradas digitales) API para la integración del MTX-Tunnel con aplicaciones terceras MTX-Tunnel permite la fácil integración con aplicaciones de usuario mediante comandos AT, pues admite la recepción de comandos desde múltiples interfaces, que son: - vía el puerto serie COM1 (esté establecido un túnel GPRS-serie o no) - vía el puerto serie COM2 - vía SMS - vía HTTP - vía Telnet - Vía un socket cliente (por el propio túnel serie/gprs pueden enviarse comandos AT) Es posible ejecutar comandos AT de módems estándar, específicos de los módems Siemens/Cinterion y específicos del MTX-Tunnel. Consulte en este manual el capítulo referente a la API para obtener más información. Página 15

16 3.- FAQ. Conceptos básicos MTX-Tunnel. Si leyendo el anterior listado de prestaciones del MTX-Tunnel tiene dudas, le aconsejamos que lea las siguientes FAQ donde se explica de manera detallada todo lo que necesita saber de las principales características del MTX-Tunnel Qué es el MTX-Tunnel? El MTX-Tunnel es un software que puede solicitar a su distribuidor instalado dentro los módems de la familia MTX. Formato caja MTX-IND Formato caja MTX-65i, MTX-65i-ULP MTX-65-GPS, MTX-3G-JAVA Para qué sirve el software MTX-Tunnel? La funcionalidad básica del MTX-Tunnel es que es una pasarela transparente GPRS/GSM- Serie (RS232/485). Es decir, si usted dispone de equipos con un puerto serie y quiere controlarlos remotamente de igual forma a lo que lo haría si estuviera conectado físicamente con un cable serie a su PC, el MTX-Tunnel es la solución que necesita. Es decir, un escenario como éste, en el que tiene un equipo serie conectado a su PC para poder leer / escribir datos en el equipo Cable serie RS232/485 Equipo con Puerto Serie RS232/485 con la pasarela transparente GPRS-Serie MTX-Tunnel, el anterior escenario se convierte en uno como el mostrado a continuación. Su PC sólo debe realizar una conexión TCP/IP con el MTX-Tunnel y todo lo que envíe por esa conexión TCP/IP el MTX-Tunnel lo reenviará por el puerto serie hacia el dispositivo a controlar. Y al revés, todo lo que el dispositivo a controlar envíe al MTX-Tunnel por el puerto serie, será reenviado tal cual hacia su servidor vía GPRS. Será como si tuviera conectado el equipo a su PC. Página 16

17 RS232/485 MTXTunnel Equipo con Puerto Serie RS232/485 Es necesario otro MTX-Tunnel en el lado del PC Servidor? Depende. Por lo general, en el 99% de los caso no. Si el software de control del PC lo va a realizar usted o bien este software ya incluye la opción de conexión con el equipo remoto vía TCP/IP ó UDP no será necesario colocar un módem en el lado del servidor, simplemente introduzca en el software del PC la IP y puerto TCP del MTX-Tunnel remoto y su PC podrá realizar la conexión a través de Internet sin problemas y enviar datos directamente a su equipo serie remoto. Si el software del PC no tiene la opción de conexión con un equipo vía IP y la única opción que le permite es seleccionar un puerto COM, tampoco es necesario usar un módem en el lado del servidor. Existen drivers gratuitos para Windows que permiten emular un puerto serie. Instalado este driver, en su PC aparecerá, por ejemplo, el COM virtual 100 que usted puede apuntar hacia la IP y puerto TCP del MTX-Tunnel. Usted sólo deberá seleccionar este COM virtual en las opciones del software del PC. Contacte con Matrix para más información sobre los drivers serie virtuales recomendados. Por último, si usted necesita un cable serie-replacer puro, por ejemplo, porque va a comunicar 2 equipos RS232 entre sí, y ninguno es un PC, es decir, ninguno cuenta con sistema operativo y por tanto sin la posibilidad de instalar un driver de COM virtual, entonces sí necesitará usar 2 MTX-Tunnel, uno en cada extremo. En este caso el gráfico del escenario resultante sería algo como: RS232/485 RS232/485 Equipo con Puerto Serie RS232/485 MTXTunnel MTXTunnel Equipo con Puerto Serie RS232/485 La conexión la debe iniciar siempre el PC? No es posible que el MTX-Tunnel sea quien se conecte al PC? Página 17

18 El MTX-Tunnel puede funcionar en modo TCP Server, TCP Client y UDP. En modo TCP Server el MTX-Tunnel permanece a la espera de conexiones entrantes, es decir, espera que un equipo remoto (por ejemplo un PC) se conecte a él para establecer la pasarela transparente GPRS-Serie. (En las nuevas versiones de MTX-Tunnel es posible crear un socket cliente temporal cuando no hay una conexión establecida y el MTX-Tunnel recibe datos por el puerto serie). En modo TCP Client es el MTX-Tunnel quien se conecta a la IP y puerto de un PC Servidor para establecer la pasarela transparente GPRS-Serie. En modo UDP, protocolo NO orientado a conexión, el MTX-Tunnel simplemente espera paquetes llegados vía UDP para reenviarlos por su puerto serie y viceversa, espera datos en su puerto serie para enviarlos vía UDP hacia un PC. Entonces, debe permanecer el MTX-Tunnel conectado permanentemente a GPRS, ya esté configurado como TCP Server, TCP Client o UDP? No es necesario. Si su aplicación lo requiere puede estar el 100% del tiempo conectado a GPRS. Recuerde que en conexiones de datos los operadores no suelen facturar por tiempo, sino por volumen de datos. Si no necesita que el MTX-Tunnel esté el 100% del tiempo conectado a GPRS, sino que lo desea en un momento puntual, sepa que el MTX-Tunnel puede activarse con las siguientes situaciones: 1.- Por una llamada perdida desde un número de teléfono autorizado 2.- Por un SMS desde un número de teléfono autorizado con el texto: mtxtunnel on 3.- Por una activación de una entrada digital del MTX-Tunnel 4.- Por un valor fuera de márgenes de una entrada analógica 5.- En función de las fechas/horas programadas. 6.- Cuando hayan datos serie (sólo en modo TCP Server, cuando esté configurado un socket cliente temporal). Y cuanto tiempo permanecerá activo el MTX-Tunnel conectado a GPRS? Un parámetro de nombre GPRS_timeout le permitirá especificar los minutos tras los que, de no detectarse tráfico GPRS, el MTX-Tunnel cerrará la sesión. La opción que más me interesa es la de que los MTX-Tunnel se configuren como TCP Server, para así conectarme a ellos periódicamente desde mi PC situado en la central. Necesito una tarjeta SIM con dirección IP fija? No es imprescindible. Usted dispone de varios mecanismos para averiguar la dirección IP de un equipo remoto en el caso de usar una tarjeta SIM con dirección IP dinámica (no fija). Si usted realiza una llamada perdida o envía un SMS con el texto mtxtunnel on al MTX- Tunnel, éste le devolverá otro SMS con la dirección IP asignada en ese momento por el operador de telefonía. Página 18

19 Si se envía un SMS o llamada perdida el MTXTunnel devuelve un SMS con la dirección IP asignada por el operador RS232/485 MTXTunnel Equipo con Puerto Serie RS232/485 También el nuevo MTX-Tunnel soporta DynDNS. El servicio de DynDNS le permite que una DNS del tipo modem1.dyndns.org apunte siempre a la IP que tenga el MTX-Tunnel en cada momento. Puede crearse una cuenta gratuita en la Web También es totalmente compatible con el servicio gratuito No-IP ( El problema es que en mi escenario voy a usar cientos de MTX-Tunnel y no es posible utilizar SMSs ni llamadas perdidas para averiguar las direcciones IPs. Tampoco quiero usar DynDNS, pues resulta muy tedioso la gestión de estas cuentas además de costar dinero, ya que únicamente es posible crear unas pocas cuentas sin coste. No puedo hacer que los MTX-Tunnel informen a un PC de mi oficina cada vez que alguno cambie su dirección IP? Sí, es posible. Habilitando un parámetro de configuración puede hacer que los MTX-Tunnel informen a un PC que tenga en su oficina. Cada vez que un MTX-Tunnel obtenga una nueva dirección IP se la comunicarán a dicho PC, enviando una trama a través de una conexión socket TCP/IP con el IMEI (código identificativo y único de cada módem), un texto configurable por usted y la nueva dirección IP. Base de datos El MTXTunnel puede enviar su IP, cada vez que ésta cambia, a un servidor RS232/485 MTXTunnel Equipo con Puerto Serie RS232/485 Página 19

20 Y no podría enviar la nueva IP a un servidor Web? Me sería mucho más sencillo, ya que estoy mucho más familiarizado con los servidores Web que con los sockets TCP/IP y no me costaría nada crear una página ASP o PHP para ir almacenando, en una Base de Datos, las direcciones IP que me vayan enviando los MTX-Tunnel. Es esto posible? Es posible. Si usted lo prefiere, es posible hacer que los MTX-Tunnel informen de su nueva IP a un servidor WEB mediante una petición http GET (una URL + parámetros). Veo que es posible pedir el MTX-Tunnel instalado en varias plataformas, concretamente en los módems MTX-65i, MTX-IND, MTX-IND-V1, MTX-65i-ULP, MTX- 65i-GPS-V6, MTX-65i-RS485 además de sus versiones 3G. Cuándo debo usar una plataforma u otra? Para la mayor parte de aplicaciones le servirá el módem MTX-65i. Si necesita que la comunicación serie sea RS485 necesita un módem MTX-65i-RS485. Si necesita poder controlar relés a distancia, o leer sensores 4-20mA, el módem recomendado es el MTX-IND Si en la aplicación que va a realizar el consumo es crítico y el módem permanecer completamente apagado (consumiendo 2uA) en todo momento excepto en situaciones / momentos puntuales, el módem recomendado es el MTX-65i-ULP. Si en cambio necesita una pasarela serie-gprs pero además necesita conocer la posición GPS del módem, el módem adecuado es el MTX-65i-GPS-V6 ó MTX-65i-GPS-V7. Por supuesto, si necesita velocidad de datos, puede utilizar la versión 3G de dichos modelos. Hablas de relés y entradas analógicas. Es que además de la pasarela GPRS-Serie el MTX-Tunnel tiene otras funcionalidades? Efectivamente. En paralelo a la pasarela Serie-GPRS el MTX-Tunnel puede controlar entradas y salidas digitales, entradas analógicas, relés, gps, buses I2C, SPI, leer dispositivos modbus serie, leer dispositivos radio 868MHz Por ejemplo, con el MTX-Tunnel puede leerse remotamente el estado de una entrada digital, o bien conmutar remotamente un relé. El MTX-Tunnel también puede enviar automáticamente cada X segundos el estado de todas las entradas/salidas digitales o posición GPS a un PC Servidor (o un servidor WEB) o por UDP, o por SMS, o controlar remotamente un sensor SPI ó I2C De un vistazo a los ejemplos del final del manual para hacerse una idea. Y por ejemplo, el control de un Relé la podría hacer desde un PC desde mi oficina, enviando un comando AT mediante una conexión TCP/IP contra el MTX-Tunnel? Sí, pero además del envío del comando AT por TCP/IP, hay otras maneras. Usted puede enviar un comando AT vía TCP/IP o lo puede enviar por cualquiera de los puertos serie del módem, o por incluso por SMS. Además usted podría conmutar un relé o leer un estado de una entrada digital y/o analógica del MTX-Tunnel desde su propia una página Web (consulte el manual de la API de este manual y los escenarios de ejemplo del Anexo) Página 20

21 Entonces, si no he entendido mal, como puedo enviar comandos AT desde un SMS, también podría conmutar un relé por SMS no? De todas maneras, enviar un comando AT por SMS es poco práctico, ya que no son intuitivos. Es posible enviar comandos AT por SMS y por tanto conmutar, por ejemplo, un relé. Pero no es necesario enviar el comando AT. El MTX-Tunnel soporta ALIAS de usuario, es decir, usted puede definir que el SMS con el texto RELE1ON sea interpretado por el módem como el comando AT^SSIO=0,0 que haría conmutar el Relé1. Puede crear hasta 10 ALIAS. Según leo en las especificaciones de los módems soportados, el MTX-65i, el MTX- IND, MTX-IND-V1 y el MTX-65i-ULP disponen de 2 puertos serie. Podría llegar a controlar 2 dispositivos serie RS232 con un único módem y una única tarjeta SIM? Sí, podría hacer eso. El MTX-Tunnel, le permite controlar 2 equipos RS232, uno por cada puerto serie y con una única tarjeta SIM. Para ello el MTX-Tunnel creará 2 túneles GPRS- Serie corriendo en paralelo. Recuerde que los módems MTX-65i y MTX-65i-ULP sólo disponen de las líneas TX y RX en el puerto serie secundario, por lo que no es posible usar una comunicación serie con control de flujo (líneas RTS y CTS) en el segundo puerto serie. En los ejemplos del anexo encontrará un ejemplo de esta configuración. RS232/485 RS232/485 Equipo con Puerto Serie RS232/485 Equipo con Puerto Serie RS232/485 Y respecto al montar el MTX-Tunnel sobre un MTX-65i-GPS-V6 con GPS, para qué sirve? puedo usarlo para hacer mi sistema de localización de flotas por GPS? Para hacer un sistema de control de flotas profesional, no. La posibilidad de montar el MTX- Tunnel sobre un módem MTX-65i-GPS-V6 está pensada para que en un momento dado pueda leer la posición GPS de la ubicación del MTX-Tunnel. Es decir que siempre pueda saber donde está el módem, ya sea solicitándolo por IP, por WebServer, Telnet, SMS Y sí, usted también podría programar el MTX-Tunnel, si está montado sobre un MTX-65i- GPS-V6, para enviar la posición GPS periódicamente cada X segundos de forma automática, pero el MTX-Tunnel no guarda logs con las posiciones GPS en su memoria interna. Es decir, en caso de no haber cobertura GPRS y no poder enviar la posición GPS en un momento dado, las posiciones que no puedan enviarse no se almacenarán internamente para un envío posterior. De ahí que sólo pueda ser usado para un control de flotas muy básico, ya que un sistema de control de flotas profesional guarda dichas posiciones GPS para enviarlas cuando haya cobertura GPRS. El MTX-Tunnel no está concebido para ser usado como dispositivo de control de flotas. Si necesita crear un control Página 21

22 de flotas consulte la información del software MTX-TunnelGPS, que sí es apropiado para ello. Veo que el MTX-Tunnel también cuenta con un WebServer. Para qué sirve? Con el pequeño WebServer que incluye usted podrá, desde cualquier PC conectado a Internet, leer el estado de las entradas/salidas digitales y analógicas y cambiar el estado de las salidas digitales o relés. También podrá ver y modificar los parámetros de configuración del MTX-Tunnel de forma remota, así como ejecutar comandos AT. Por ejemplo, si ejecuta el comando AT+CSQ podrá ver remotamente el nivel cobertura GSM que tiene en ese momento su MTX-Tunnel. Y el Telnet que veo que también tiene, para qué sirve? Con Telnet puede hacer básicamente lo mismo que con el WebServer. Puede acceder por Telnet y ejecutar comandos AT remotos. Está más pensado para poder controlar el MTX- Tunnel de forma remota a través de aplicaciones de terceros. Consulte el capítulo de Telnet y de la API para más información. Siempre que dude entre usar Webserver y Telnet, le recomendamos Telnet, pues es acceso remoto es mucho más rápido Pero si activo el WebServer o el Telnet en Internet puedo tener a ellos accesos no autorizados? El MTX-Tunnel dispone de un firewall que puede activar si lo necesita. Con este firewall puede hacer que el MTX-Tunnel no acepte ninguna conexión desde una IP que no sea una autorizada. Así no tendrá accesos no autorizados ni a los túneles GPRS-Serie, ni al WebServer ni al Telnet. Eso es un problema, porque me interesa activar el Firewall en la pasarela GPRS-Serie, pero quiero poder acceder al WebServer, por razones de mantenimiento, desde cualquier PC, es decir, necesito tener acceso desde cualquier IP. En ese caso puede desactivar el Firewall del WebServer, pero se recomienda proteger el WebServer del MTX-Tunnel con un Login y Password. El MTX-Tunnel puede trabajar tanto sin Login y Password (webserver público) como con Login y Password. Antes de que lo pregunte, lo mismo para el Telnet. Volviendo al tema de los SMS, comentas que es posible controlar una salida digital o un relé por SMS, pero, sería posible enviar un SMS de alarma cuando cambie una entrada digital? También. Usted puede configurar el MTX-Tunnel para que envíe un mensaje SMS (hasta a 10 números de teléfono) con un texto configurable por usted cuando se detecte un cambio en una entrada digital. Página 22

23 En las prestaciones del nuevo MTX-Tunnel hablas de, además del túnel GPRS-Serie, de túneles GPRS-I2C, GPRS-SPI, HTTP-Serie o incluso SMS-Serie. Qué es eso? Puedes dar un ejemplo de uso para hacerme una idea? Por ejemplo. Tunnel GPRS-I2C: Podría leer un sensor I2C de forma remota, por ejemplo, un sensor de temperatura. Tunnel GPRS-SPI: Podría, por ejemplo, escribir datos remotamente en una pantalla controlada por SPI. Tunnel HTTP-Serie: Podría, por ejemplo, construir una página Web con un formulario y todos los datos que envíe desde su formulario Web al MTX-Tunnel, éste los reenviaría por el puerto serie hacia el dispositivo que tenga conectado al MTX-Tunnel. El MTX-Tunnel también recogería la respuesta del dispositivo serie y se la reenviaría como respuesta WEB a su página Web. Tunnel SMS-Serie: Usted puede definir un texto clave, por ejemplo MTX, para que cuando envíe un SMS con dicha clave al principio, como por ejemplo un SMS con el texto MTX 12345, el MTX-Tunnel reenvíe por su puerto serie 12345, recoja la respuesta del dispositivo serie conectado al MTX-Tunnel y se la reenvíe con otro SMS.. Veo que también el MTX-Tunnel puede usarse en la plataforma módem MTX-65i-ULP, para aplicaciones de muy bajo consumo. Básicamente, que me permite hacer? Pues básicamente te permite que el módem permanezca completamente apagado (apagado total, sin poder recibir SMS, ni llamadas, ni nada. Apagado) consumiendo 2uA hasta que ocurra un evento. Este evento puede ser un cambio en una entrada digital, o bien que se despierte cada cierto tiempo. Por ejemplo, podría hacer que el MTX-Tunnel se despierte cada 24 horas, envíe el estado de sus entradas digitales y analógicas y permanezca 5 minutos encendido por si hay que comunicarse desde un puesto central con un equipo serie conectado al MTX-Tunnel. Después volverá a apagarse durante 24 horas. También es posible definir horarios. Por ejemplo, puede hacer que el módem se despierte X minutos todos los días a las 10am, o sólo los días 1 y 15 de cada mes a las 8am y a las 8pm, o lo que necesite. Indicas que el MTX-Tunnel se puede despertar a horas concretas Eso quiere decir que tiene un reloj? El MTX-65i-ULP cuenta con un reloj interno que es lo que le permite despertarse en un tiempo / fecha determinada. Página 23

24 Y no tiene derivas ese reloj? Cómo voy a hacer que siempre esté en hora? El MTX-Tunnel soporta la sincronización horaria por GPRS, de hecho es obligatorio su uso si utiliza el reloj del MTX-65i-ULP. De esa manera, cada vez que se conecta a GPRS, se conecta a un servidor de tiempo para sincronizar la hora y que siempre sea exacta (hora UTC). También es obligatorio el uso del servidor horario al utilizar el Datalogger incluido en el MTX-Tunnel Servidor Hora TP protocol Hora UTC El MTXTunnel sincroniza su reloj en cada conexión GPRS Qué hora es? RS232/485 MTXTunnel Equipo con Puerto Serie RS232/485 Cuando indicas que el MTX-Tunnel, montado sobre un MTX-65i-ULP, se despierta a una hora en concreta durante X minutos, te refieres a que la pasarela GPRS-Serie estará activa durante ese tiempo? Durante ese tiempo el módem arrancará y hará todo lo que tenga configurado. Si tiene configurado un túnel GPRS-Serie lo activará, pero si tiene habilitado el WebServer se activará, lo mismo con Telnet, si tiene que enviar las entradas/salidas digitales, también lo hará durante ese espacio de tiempo. Y con lo de seguridad SSL A qué te refieres? Cómo funciona? Para algunas aplicaciones muy sensibles puede utilizar si lo desea encriptación SSL. Mediante SSL sus datos viajan encriptados desde el MTX-Tunnel hacia su PC, no siendo posible desencriptarlos con algún sniffer que hubiera dentro de la red LAN de su propia empresa. Únicamente es posible usar SSL cuando el módem está configurado en modo TCP Client y el PC Servidor al que se conecte el MTX-Tunnel esté preparado para soportar sockets SSL bajo las especificaciones: TLS Protocol Version 1.0 como se especifica en RFC SSL V3 como se especifica en The SSL Protocol Version 3.0 WAP(TM) TLS Profile and Tunneling Specification como se especifica en WAP-219- TLS a Página 24

25 En cualquier caso, salvo que sea totalmente imprescindible, no se recomienda su uso, ya que la encriptación provoca un volumen de datos considerablemente mayor, lo que se traduce en una menor velocidad en la transferencia de datos. Una duda más, el tema de la API Qué es? Para qué sirve? La API son básicamente comandos AT especiales pensados para que aplicaciones de terceros puedan integrar el MTX-Tunnel en su sistema como un equipo propio. Es decir, imagine que usted quiere crear un sistema para que sus clientes, desde su propia página web, puedan acceder a dispositivos serie que tengan conectados al MTX-Tunnel o simplemente conmutar un relé desde su propia página web. La API le permitirá acceder a la configuración remota del MTX-Tunnel y al envío de comandos AT al mismo (por ejemplo, para conmutar un relé) sin que sus clientes tengan para nada que usar directamente los ficheros de configuración del MTX-Tunnel, como usted verá en el siguiente capítulo. Me gustaría conectar un dispositivo modbus a un puerto serie del MTX-Tunnel y que sea el propio MTX-Tunnel quien lea periódicamente la tabla de memoria ModBus del PLC, guarde los datos en memoria y los envíe a mi servidor http. Es posible? También. El MTX-Tunnel es capaz de interrogar de forma periódica un dispositivo modbus conectado en su puerto serie, almacena en memoria las variables y las enviará a su servidor http mediante un objeto JSON. Si hay problemas en el envío, por temas de cobertura o por el tema que sea, puede almacenar hasta1500 lecturas. La última pregunta. Es posible solicitar el módem MTX-IND con una tarjeta de radio Wavecard 868MHz. Puedes poner algunos ejemplos de uso? Ejemplos de uso del MTX-Tunnel instalado en un MTX-IND con wavecard 868MHz: 1.- Concentrador de comunicaciones GPRS / 868MHz para lectura de Waveflows (contadores de pulsos radio para contadores de agua, gas, electricidad). 2.- Concentrador de comunicaciones GPRS / 868MHz para lectura de dispositivos Wavetherm (sondas radio 868MHz de temperatura) 3.- Concentrador de comunicaciones GPRS/868 para lectura de sensores 4-20mA (mediante wavesense, equipos 868MHz) 4.- Concentrador de comunicaciones GPRS/868 para lectura de entradas digitales (mediante wavelog, equipos 868MHz) El MTX-Tunnel se encarga de interrogar periódicamente los sensores radio y de enviar a su servidor web, mediante http JSON, la información leída. Página 25

26 Es posible hacer una pasarela GPRS-Serie con un dispositivo pero a la vez poder realizar una llamada GSM al módem? Es decir, podría acceder al dispositivo sería vía GPRS pero también GSM? Efectivamente, desde la versión MTX-Tunnelv7.11 es posible establecer pasarelas GPRS- Serie y GSM-Serie con el módem, dando preferencia a las llamadas GSM. Caso muy típico es la de un operador de energía (Endesa, Iberdrola, ) que quiere acceder a un contador vía GSM de forma diaria para realizar una lectura y usted también quiere acceder al contador, pero vía GPRS. MTX-Tunnel le permite hacer eso. La verdad es que el nuevo MTX-Tunnel tiene muchas opciones. Imagino que será muy difícil de configurar para un escenario concreto La nueva versión del MTX-Tunnel ciertamente tiene muchas opciones, de hecho muchas más de las explicadas en estas breves FAQ, como podrá ver si lee la descripción de los parámetros de configuración, pero su configuración no es realmente una tarea complicada. En el siguiente capítulo tiene un detallado paso a paso de cómo realizar una primera configuración del MTX-Tunnel para que si no lo ha utilizado nunca, se familiarice con él. Lo más importante de la documentación lo tiene al final de este manual, en el Anexo. Ahí encontrará muchos ejemplos de escenarios, todos bien explicados y con la configuración apropiada del MTX-Tunnel para su funcionamiento. Verá como en muchos casos, lo único que tiene que hacer es buscar el escenario que más se asemeje a lo que necesita y hacer poco más que un copy & paste de la configuración sugerida. Por supuesto puede contactar con Matrix Electrónica, en gsmsupport@matrix.es, si tiene cualquier duda al respecto, le atenderemos gustosamente. Página 26

27 4.- Configuración del MTX-Tunnel - Paso a paso. En esta sección va a crear su primer túnel GPRS-Serie. Le guiaremos paso a paso, desde qué software debe instalar en su PC para la configuración del MTX-Tunnel y cómo utilizarlo, hasta la creación de un túnel básico TCP Server para que pueda conectarse al MTX-Tunnel desde su PC y vea cómo enviar y recibir datos. Para configurar un módem MTX con el software MTX-Tunnel instalado necesita: - Un PC con sistema operativo Windows 2000 ó XP y con puerto RS232. Si su PC no dispone de puerto serie puede utilizar un conversor USB-RS232 de los existentes en el mercado. - Un cable serie RS232 para conectar el módem MTX con el PC. El cable debe ser un cable pin a pin (pin1-pin1,pin2-pin2,, pin9-pin9). Es decir, NO utilizar un cable serie null-modem (cruzado). - El software gratuito MES (Module Exchange Suite). Se lo proporcionará Matrix Electrónica o lo puede descargar directamente de: ftp://ftp.matrixelectronica.eu/mtx-terminals/tools/mes_ zip Instalación y configuración del Software MES Qué es el software MES y para qué lo necesito? El software MES es un software que permite ver el módem MTX como una llave de memoria tipo pendrive. Y es que el MTX-Tunnel se configura mediante un fichero especial de configuración llamado config.txt que se encuentra, de fábrica, dentro del módem y que puede/debe editarse con cualquier editor de texto, como puede ser el Notepad de Windows. Nota importante: en versiones anteriores al MTX- Tunnel v7 el fichero de configuración tenía el nombre MTXTunnel.jad Una vez tenga la configuración apropiada del MTX-Tunnel ajustada a sus necesidades dentro del fichero config.txt deberá copiar este fichero dentro del módem. Para copiar este fichero es para lo que necesitará el software MES. Cómo se configura el software MES? Una vez instalado el software MES deberá configurarlo antes de usarlo por primera vez. Debe indicar al software MES cual es el puerto serie COM de su PC al que conectará el módem. Para ello vaya a Mi PC, verá un icono de color azul: Página 27

28 Haga click con el botón derecho del ratón sobre el icono azul del MES y seleccione Propiedades. Después seleccione la pestaña Port Podrá visualizar una lista con los puertos COM serie disponibles en su PC. Seleccione de la lista el puerto COM de su PC al que tiene conectado el módem con Página 28

29 el MTX-Tunnel y pulse el botón Aplicar. Una vez hecho esto ya tiene configurado el software MES. No será necesario repetir el proceso a menos que conecte el módem a un puerto COM distinto. Primera configuración del MTX-Tunnel. Si usted no está familiarizado con el MTX-Tunnel, le recomendamos que haga la siguiente configuración de prueba para familiarizarse con la aplicación, un MTX- Tunnel TCP-Server. Para ello, siga los siguientes pasos: 1.- Con el módem sin alimentación, extraiga la tarjeta SIM del módem MTX. 2.- Conecte el módem al PC con el cable serie RS232 (cable serie RS232 pin a pin, no cruzado) 3.- Conecte la alimentación al módem y espere al menos 10 segundos. Al alimentar el módem sin la tarjeta SIM, el módem siempre entra en modo configuración. 4.- Haga doble click en el icono del MES (icono azul en Mi PC ). Aparecerá la siguiente ventana: 5.- Después haga doble click en Module Disk A:/ (o pulse ENTER) para ver los archivos que están dentro del módem MTX. Página 29

30 6.- Una vez vea los archivos, copie el archivo config.txt en su disco duro para así poder editarlo. 7.- Con el Notepad o programa de edición similar, edite el fichero config.txt y escriba directamente la siguiente configuración: MTX_PIN: 0000 MTX_mode: server MTX_urc: on MTX_model: MTX-65i GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 GPRS_DNS: TCP_port: Página 30

31 COMM_baudrate: COMM_bitsperchar: 8 COMM_autorts: on COMM_autocts: on COMM_stopbits: 1 COMM_parity: none FIREWALL_enabled: off SMS_allPhones: on Para esta primera toma de contacto, modifique sólo los marcados en AZUL. En MTX_PIN debe introducir el PIN de la tarjeta SIM que va a utilizar. Si no tiene PIN, puede poner En MTX_model indique el modelo de módem que está usando (MTX-65i, MTX-65i-ULP, MTX-IND, ). En los parámetros GPRS_apn, GPRS_login, GPRS_password debe especificar los del operador que esté usando. Le recomendamos enérgicamente que para esta primera prueba use una tarjeta SIM de MoviStar o Vodafone, ya que va a configurar un Túnel TCP/Server. Hay muchos operadores de telefonía móvil que usan Proxys y bloquean las conexiones entrantes (de forma similar a como actúa un router ADSL, en los que es posible hacer una conexión saliente (desde dentro de casa o la oficina hacia afuera), pero no entrante, a menos que se haga NAT). En caso de no usar MoviStar o Vodafone, asegúrese de que su operador no va a bloquear las conexiones entrantes. (Compañías como Orange, Symio, Yoigo las bloquean por defecto. Estas compañías van muy bien para conexiones tipo cliente (MTX_mode: client) pero no para configuraciones tipo Server (MTX_mode: server) como la que estamos haciendo en este ejemplo, ya que, como se indica, bloquean las conexiones entrantes. Consulte con su operador de telefonía para más información. 8.- Salve los cambios realizados en el archivo config.txt y copie el archivo modificado dentro del módem MTX usando el MES (sobrescribiendo el archivo actual). 9.- Apague el módem quitándole la alimentación e introduzca la tarjeta SIM. En estos momentos, ya tiene configurado el MTX-Tunnel listo para funcionar. Probando la configuración realizada al MTX-Tunnel. 1.- Para probar la configuración anterior haga lo siguiente. Abra una ventana de hyperterminal (o programa similar) y configure el puerto serie del PC tal y como lo tiene el MTX, es decir, tal y como lo configuró en el archivo de configuración config.txt del ejemplo (115200, 8, N, 1 con control de flujo HW). 2.- Después, con el módem conectado al puerto serie del PC, conecte la alimentación al módem. Enseguida verá que el led verde parpadea lentamente, señal de que todavía no se ha registrado en la red GSM. Al cabo de unos segundos Página 31

32 verá que el led hace 1 flash rápido cada 4 segundos. Señal que se ha registrado en la red GSM. Al cabo de unos pocos segundos más, verá que el led hace 2 flashes rápidos cada 4 segundos, señal que está conectado a GPRS. De hecho en paralelo podrá ir observando en el hyperterminal (al tener MTX_urc a on) los distintos mensajes que el MTX-Tunnel le va a ir enviado. La IP que verá en su pantalla será la que el operador de telefonía le ha asignado en ese momento. Ahora mismo tiene al MTX-Tunnel esperando una conexión TCP por el puerto configurado Ahora abra otro hyperterminal, pero en este caso, cuando aparezca la opción de escoger el puerto COM, seleccione la última opción, TCP/IP Winsock, y especifique la dirección IP que le asignó el operador al módem y el puerto TCP Página 32

33 4.- En cuanto pulse el botón Aceptar verá que en la ventana del hyperterminal que está conectado al MTX-Tunnel por el puerto serie, se indica la nueva conexión. Ya tiene el túnel GPRS-Serie establecido. 5.- En estos momentos, todo lo que escriba (envíe) desde la ventana del hyperterminal desde la que realizó la conexión IP será recibido por el MTX-Tunnel y reenviado por su puerto serie. Si escribe (envía) HOLA, COMO ESTÁS desde el hyperterminal con la conexión TCP/IP WinSock, recibirá lo enviado en el hyperminal del MTX-Tunnel: Página 33

34 En resumidas cuentas, usted acaba de realizar su primer túnel GPRS serie. A modo de esquema, aunque lo tenga todo encima de la mesa, las conexiones que ha realizado han sido: HOLA, COMO ESTAS MTXTunnel Cable serie RS232 HOLA, COMO ESTAS Página 34

35 5.- Servicio WebServer A partir de la versión 5.0 del MTX-Tunnel se incluye un pequeño servicio WebServer que puede habilitar si lo desea. Habilitando el web server, podrá acceder al MTX-Tunnel de forma remota desde el navegador de su PC conectado a Internet. Para acceder al WebServer del MTX-Tunnel únicamente necesita abrir el navegador de su PC (preferiblemente Microsoft Internet Explorer) y especificar la dirección IP que tiene el MTX-Tunnel o bien la DNS si tiene activado el servicio DynDNS tal y como muestra la siguiente pantalla. Si en los parámetros de configuración del webserver ha especificado un Login y un Password, eso mismo será lo primero que le solicitará el WebServer: Una vez introducidos el Login y Password correctos, irá directamente a la pantalla de Status del WebServer. En esa pantalla obtendrá información del MTX-Tunnel, como la versión de firmware, el Core que monta el módem y el estado de las entradas y salidas digitales y analógicas del equipo. Fíjese en la siguiente pantalla de ejemplo. Verá que la GPIO3 y la GPIO4 son salidas digitales de usuario. Si ve el valor asociado a ellas, verá que son un link. Puede cambiar remotamente el estado de una de esas salidas simplemente haciendo click con el ratón. Para este ejemplo se ha usado un MTX-65i, pero si el ejemplo hubiese usado un MTX-IND, en lugar de conmutar una salida digital, estaría conmutando un Relé. Página 35

36 Haciendo click en Settings podrá ver y cambiar la mayoría de los parámetros de configuración del MTX-Tunnel. Los cambios se deben realizar parámetro a parámetro, puesto que está orientado a hacer únicamente cambios puntuales. Una vez cambiados todos los parámetros que se necesite, debe hacerse click en Reset para resetear el MTX-Tunnel y usar la nueva configuración. Se recomienda encarecidamente el uso de Telnet frente a WebBrowser. Página 36

37 En la sección AT Commands, podrá ejecutar comandos AT de forma remota. En la siguiente pantalla se muestra un ejemplo de ejecución del comando AT remoto AT+CSQ, para poder ver la cobertura de forma remota. También dispone de una sección de Maps. Es esa sección podrá ver unos mapas con la localización GSM (localización de la celda GSM en la que está el módem) y, en el caso de usar el MTX-Tunnel sobre un módem MTX con GPS también podrá ver un mapa con la localización GPS. Página 37

38 Ya por último restan los menús Reset y Logout. Si hace clic en reset el MTX-Tunnel se reseteará automáticamente (lo necesitará hacer cuando haga cambios de configuración desde el menú settings). Nótese que hay 3 parámetros muy importantes en la sección Settings relativos al webserver embebido dentro del MTX-Tunnel. Estos parámetros son: WEBSERVER_skin WEBSERVER_gsmScript WEBSERVER_gpsScript Por favor, lea atentamente en este manual las descripciones de cada uno de esos parámetros de configuración. Página 38

39 6.- Servicio TELNET MTX-Tunnel incluye un pequeño servicio de servidor Telnet que puede habilitar si lo desea. Habilitando el Telnet podrá acceder al MTX-Tunnel de forma remota desde un cliente Telnet. Telnet es la forma recomendada de acceder remotamente al MTX-Tunnel, mucho más ágil que acceder a través de WebServer. Para acceder al servicio Telnet del MTX-Tunnel únicamente necesita abrir la consola MSDos de su PC y especificar la dirección IP que tiene el MTX-Tunnel o bien la DNS si tiene activado el servicio DynDNS tal y como muestra la siguiente pantalla. Si en los parámetros de configuración del Telnet ha especificado un Login y un Password, eso será lo primero que se solicitará: Una vez introducidos el Login y Password correctos, podrá enviar comandos AT directamente al MTX-Tunnel. Comandos AT estándar y/o especiales, como por ejemplo, ver la cobertura del módem (AT+CSQ) ó cambiar una configuración de un parámetro del MTX-Tunnel. Página 39

40 7.- Comandos AT. API de usuario. En la mayoría de aplicaciones el MTX-Tunnel es usado como una simple pasarela GPRS-Serie. Pero en ocasiones puede resultar necesario el poder integrar el MTX-Tunnel dentro de un sistema de un tercero y que desde un componente de ese sistema se pueda, por ejemplo, acceder al MTX- Tunnel para solicitar el estado de una entrada digital, conocer la cobertura, o cambiar un parámetro de configuración de forma remota o local sin necesidad de recurrir al software MES. La API de usuario consiste básicamente en una serie de comandos AT especiales. Usted puede ejecutar comandos AT estándar sobre el MTX-Tunnel, comandos como puede ser el típico AT+CSQ para conocer la cobertura o un comando AT^SSIO para, por ejemplo, cambiar una salida digital o conmutar un Relé. Pero como se indica el MTX-Tunnel incluye una serie de comandos especiales (API), que permite la integración sencilla del MTX-Tunnel dentro del sistema o entorno de un tercero Cómo y desde donde se pueden envían comandos AT al MTX-Tunnel? Dispone de varias opciones para enviar comandos AT al módem, que son: 1.- Vía el puerto serie principal COM1 (esté o no establecido un túnel GPRS-serie) Para enviar un comando AT por puerto serie COM1 del MTX-Tunnel debe encapsularlo de una forma especial. Tenga en cuenta que usted va a enviar un comando AT por el mismo canal serie por el que puede estar establecido un túnel Serie-GPRS. Para ello debe encapsular el comando AT entre los TAGS <MTXTunnel> y </MTXTUNNEL> Por ejemplo, si envía el comando: <MTXTUNNEL>AT</MTXTUNNEL> recibirá como respuesta: <MTXTUNNEL>AT OK</MTXTUNNEL> Es decir, todo lo que envíe por el puerto COM1 encapsulado entre dichos tags no será reenviado vía GPRS, sino que será interpretado por el MTX-Tunnel como un Página 40

41 comando AT. De esa manera, un dispositivo conectado al COM1 del MTXTunnel puede tener también el control total del módem. Para poder enviar comandos AT por el puerto COM1 el parámetro MTX_ATMux debe estar a on. Si no va a utilizar esta funcionalidad no lo active. De esa manera no gastará recursos de CPU innecesariamente. 2.- Vía el puerto serie COM2 Para enviar comandos AT por el puerto secundario, no tiene que encapsularlos, puede enviarlos directamente. Para ello lo único que debe establecer es el parámetro MTX_portAux a on. Si no va a utilizar esta funcionalidad no lo active, para no gastar recursos de CPU innecesariamente. Tenga presente que no puede configurar una conexión Telnet bypass (para crear un segundo túnel Serie-GPRS y controlar 2 equipos, uno por cada puerto serie) si va a utilizar el puerto COM2 como entrada auxiliar de comandos AT. 3.- Vía SMS Puede enviar comandos AT desde un mensaje SMS y recibir respuestas a los mismos. Para ello debe establecer el parámetro SMS_ATEnabled a on y SMS_ATResponse a on. De esta manera, cualquier SMS que empiece por AT o at será interpretado como un comando SMS por el MTX-Tunnel. 4.- Vía HTTP En capítulos anteriores se explicó cómo enviar comandos AT desde el WebBrowser embebido en el MTX-Tunnel. Existe otro método más recomendado si necesita, por ejemplo, leer el estado de una entrada digital o conmutar un relé desde su propia página web. Es el uso de la página api.html del WebServer. Página 41

42 Por ejemplo, para conocer la cobertura de forma remota mediante este api, bastaría con hacer una llamada a la API con la siguiente URL: &PASS=1234 y el MTX-Tunnel le contestaría con: <MTXTUNNEL>AT+CSQ +CSQ: 25,99 OK </MTXTUNNEL> Para que usted pueda extraer de entre los tags <MTXTunnel> la respuesta al comando AT enviado. Fíjese en la URL, debe indicar siempre, y en orden, los parámetros ATCOMMAND, LOGIN y PASSWORD. Fíjese también en el comando enviado en el ejemplo, AT+CSQ, marcado en rojo en la URL. Recuerde que no es posible, en una URL, utilizar todos los caracteres ASCII. Los caracteres especiales debe codificarlos según el estándar. %20 > espacio en blanco + > espacio en blanco %21 >! %22 > \ %23 > " %24 > $ %25 > % %26 > & %27 > ' %28 > ( %29 > ) %2ª > * Página 42

43 %2B > + %2C >, %2D > - %2E >. %2F > / %3A > : %3B > ; %3C > < %3D > = %3E > > %3F >? %40 %5B > [ %5C > \ %5D > ] %5E > ^ %5F > _ En rojo tiene marcados los que probablemente más usará, al tener comandos AT tipo AT+ y AT^ 5.- Vía Telnet Tal y como se vio en el capítulo anterior, es posible enviar vía TELNET comandos AT al MTX-Tunnel sin mayor complicación 6.- Vía socket client A partir del MTX-Tunnelv7, es posible enviar comandos AT remotos a través de la propia pasarela gprs/serie cuando el MTX-Tunnel está configurado para usar un socket tipo cliente. Le resultará muy útil si está utilizando un operador que NO PERMITE la configuración en modo Server. Para poder enviar comandos AT embebidos en un socket cliente, previamente tiene que configurar el parámetro MTX_ATEmbedded a on. Página 43

44 Para enviar comandos AT Remotos a través de un socket client debe encapsular el comando entre los tags <MTXTUNNELR></MTXTUNNELR> Por ejemplo, si envía el comando: <MTXTUNNELR>AT</MTXTUNNELR> recibirá como respuesta: <MTXTUNNELR>AT OK</MTXTUNNELR> Página 44

45 7.2.- Comandos AT estándar soportados por el MTX-Tunnel El MTX-Tunnel funciona sobre un módem MTX cuyo Core, a su vez, es un módulo gsm/gprs Cinterion modelotc65i(para el MTX-65i, MTX-65i-ULP MTX-IND, MTX-IND-V1, MTX-65i-GPS-V6, MTX-65-GPS-BAT-v7), XT65 (para el MTX-65+G, MTX-65+G+Bv5) y EHS6 para todos los modelos 3G. Estos módulos soportan una serie de comandos AT, que llamaremos comandos AT estándar de Cinterion. El MTX-Tunnel le permite ejecutar una parte de toda la colección de estos comandos AT estándar, que son: AT > devuelve un OK ATI > devuelve el firmware del módulo TC65i, XT65 ó EHS6 AT+CSQ > devuelve la cobertura GSM AT+CCLK > devuelve la hora AT^SSIO > cambia el estado de una salida digital AT^SGIO > devuelve el estado de una entrada digital AT^SRADC > devuelve el valor de una entrada analógica AT^SGPSR > devuelve la posición GPS AT^MONI > devuelve información sobre la BTS AT^SMONI > devuelve información sobre la BTS AT+CFUN=1,1 > resetea el MTX-Tunnel AT^SMSO > resetea el MTX-Tunnel (con apagado total) Consulte en el manual de comandos AT de Siemens / Cinterion sobre el formato y la funcionalidad exacta de cada uno de estos comandos AT. Si no dispone de la documentación solicítesela a su distribuidor Matrix Electrónica. Página 45

46 7.3- Comandos AT especiales (API) soportados por el MTX-Tunnel El MTX-Tunnel dispone de una serie de comandos AT especiales que permiten el control del MTX- Tunnel por aplicaciones terceras, ya sea vía puerto serie o vía GPRS. Recuerde que puede enviar comandos AT por los 2 puertos serie de los MTX, vía GPRS (webserver o Telnet), vía SMS o embebido en un socket client. A continuación se detalla cada uno de los comandos AT espaciales: AT^MTXTUNNEL=END Este comando AT finaliza la ejecución del software MTX-Tunnel y deja el módem MTX como un módem GSM/GPRS convencional. La utilidad de este comando radica en que equipos con cierta inteligencia conectados al puerto serie del MTX pueden activar y desactivar el MTX-Tunnel a voluntad. Por ejemplo, un equipo podría activar el MTX-Tunnel en un momento dado y desactivarlo en otro para realizar ó recibir una llamada de voz o datos GSM. AT^MTXTUNNEL=VERSION Devuelve la versión del MTX-Tunnel. Únicamente disponible a partir del MTX-Tunnel v7 AT^MTXTUNNEL=SETBAUDRATE,puerto,velocidad Este comando sirve para cambiar la velocidad de un puerto serie del módem de forma temporal (sin necesidad de resetear el MTX-Tunnel). Por ejemplo AT^MTXTUNNEL=SETBAUDRATE,0,9600 AT^MTXTUNNEL=SETBAUDRATE,1,19200 El primer ejemplo cambiaría la velocidad del puerto 0 a 9600 y el segundo ejemplo cambiaría la velocidad del puerto 1 a baudios. Únicamente disponible a partir del MTX-Tunnel V7. AT^MTXTUNNEL=GETPARAM,nombreDelParametro Este comando sirve para leer el valor de un parámetro de configuración del MTX-Tunnel almacenado en el fichero de configuración config.txt. Por ejemplo, si pretendemos leer el APN que tenemos configurado en el MTX-Tunnel, usaríamos: AT^MTXTUNNEL=GETPARAM,GPRS_apn AT^MTXTUNNEL=GETCONFIG Comando disponible desde la versión MTX-Tunnel v7.15. Devuelve todo el fichero de configuración config.txt, lo que evita tener que usar reiteradamente AT^MTXTUNNEL=GETPARAM Página 46

47 AT^MTXTUNNEL= SETPARAM,nombreDelParametro,valorParametro Este comando sirve para cambiar el valor de un parámetro de configuración del MTX- Tunnel. Por ejemplo, si pretendemos cambiar la velocidad (baudios) del puerto serie COM1 a 9600 haríamos: AT^MTXTUNNEL=SETPARAM,COMM_baudrate,9600 Tenga presente que cuando cambie un parámetro de configuración el MTX-Tunnel no adoptará la nueva configuración hasta haberse realizado un reset. Recuerde que el comando de reset es: AT+CFUN=1,1 AT^MTXTUNNEL=GETIOS Este comando sirve para leer de una vez todos los GPIOs y los ADCs del MTX-Tunnel. Tiene especial utilidad a la hora del envío de comandos AT por GPRS o por SMS, debido a que este comando es mucho más rápido que ir enviando un comando AT por cada GPIO y ADC por separado. En la respuesta de este comando AT se devuelven los estados separados por,. GPIO1,GPIO2,GPIO3,GPIO4,GPIO5,GPIO6,GPIO7,GPIO8,GPIO9,GPIO10,ADC1,ADC2 AT^MTXTUNNEL=RS232,direccion,datos Este comando permite enviar directamente datos por un puerto serie del MTX-Tunnel. Puede resultar muy útil para aplicaciones WEB, para que, por ejemplo, desde un formulario WEB pueda enviarse directamente datos al MTX-Tunnel, que éste reenvíe los datos por el puerto serie, recoja una posible respuesta y la devuelva a la página del formulario. En el Anexo de este manual encontrará un ejemplo de esta funcionalidad. El parámetro dirección puede tomar el valor 0,1, 2 ó 3. 0: se reenviarán los datos por el puerto serie COM1 sin espera de posible respuesta del dispositivo conectado al COM1 del puerto serie. 1: se reenviarán los datos por el puerto serie COM1 y se espera la respuesta del dispositivo conectado al COM1 del puerto serie, que será reenviada como respuesta del comando AT. 2: se reenviarán los datos por el puerto serie COM2 sin espera de posible respuesta del dispositivo conectado al COM2 del puerto serie. 3: se reenviarán los datos por el puerto serie COM2 y se espera la respuesta del dispositivo conectado al COM2 del puerto serie, que será reenviada como respuesta del comando AT. En el caso de la opción 1 y 3 la longitud máxima de la respuesta del dispositivo conectado al MTX no debe ser superior a 160 caracteres. En el parámetro datos se debe especificar los datos (cadena de texto) a enviar por el puerto serie del MTX-Tunnel. Página 47

48 AT^MTXTUNNEL=SMS,telefono,mensaje Este comando AT es el que debe utilizar si desea enviar un SMS. El comando AT+CMGS no está soportado por el MTX-Tunnel para ser utilizado por aplicaciones terceras. En el parámetro teléfono debe especificar el número de teléfono al que enviar el SMS. En el parámetro mensaje debe especificar el texto del mensaje SMS AT^MTXTUNNEL=I2CSPI,comando,datos Este comando AT le permite crear un túnel GPRS-I2C/SPI, es decir, puede usarlo para controlar un dispositivo remoto con conectividad I2C o SPI como puede ser una sonda de temperatura, una pantalla, No es posible su uso con MTXTunnelv8, únicamente hasta la versión v7. Encontrará un ejemplo de uso en el ANEXO de este manual. Los valores que puede tomar el parámetro comando son: CONNECT: activa el túnel GPRS-I2C/SPI En el parámetro datos debe especificar la cadena equivalente a la usada en el comando AT^SSPI del manual de comandos AT de los módulos TC65i y/o XT65. Si no dispone del manual de comandos AT de estos módulos, pídalo a Matrix Electrónica. En datos debe especificar la velocidad del bus, etc. DATA: envía datos por el puerto I2C/SPI del MTX-Tunnel En el parámetro datos debe especificar la cadena a enviar en el formato equivalente a la usada en el envío de datos I2C/SPI de los módulos TC65i y/o XT65. Si no dispone del manual de comandos AT de estos módulos, pídalo a Matrix Electrónica. DISCONNECT: desactiva el túnel GPRS-I2C/SPI En el parámetro datos debe especificar el valor 0. AT^MTXTUNNEL=SETMODBUS,address;posicion1;dato_1;dato_2;...;dato_n Este comando AT le permite, si tiene conectado un dispositivo MODBUS al puerto secundario del MTX-Tunnel, cambiar uno o varios parámetros de la tabla de memoria. Página 48

49 address: indica la dirección modbus del dispositivo (0 255) posicion1: indica la primera posición de memoria a cambiar dentro de la tabla modbus dato_1, dato_2: indica los datos que se van a modificar en el dispositivo modbus a partir de la dirección establecida en posición1. Importante: note que los parámetros address, posición y los datos están separados por ; y no por,. AT^MTXTUNNEL=GETMODBUS,address;posicion;numDatos;comando Este comando AT le permite, si tiene conectado un dispositivo MODBUS al puerto secundario del MTX-Tunnel, leer uno o varios parámetros de la tabla de memoria. address: indica la dirección modbus del dispositivo (0 255) posicion1: numdatos: indica la primera posición de memoria a leer dentro de la tabla modbus indica el número de variables a leer de la tabla modbus. comando: indica si debe usarse el comando 3 ó 4 Importante: note que los parámetros address, posición y numdatos están separados por ; y no por,. AT^MTXTUNNEL=TEMPORALCLIENT,direccionIP,puertoTCP,segundos Comando útil para lanzar un comando socket temporal cliente a una IP y puerto específicos. Sólo útil cuando el parámetro MTX_mode está configurado como server o none. Recuerde que puede enviar comandos AT remotos encapsulados con <MTXTUNNELR></MTXTUNNELR> a través de un socket client y éste incluye al socket temporalclient. direccionip: puertotcp: indica la dirección IP a la que conectar indica el puerto TCP al que conectar Importante: un socket cliente temporal se cerrará automáticamente si no se reciben datos gprs o se envían datos en 60 segundos. El parámetro segundos está disponible a partir del MTX-Tunnel v7.15. Permite especificar los segundos en que el socket va a estar abierto. Si una vez establecido el socket se vuelve Página 49

50 a enviar el comando con el parámetro segundos=0, el socket temporal se cierra inmediatamente sin esperar a su fin. AT^MTXTUNNEL=DELETEBBDD Este comando puede resultar de utilidad si en alguna ocasión quiere borrar la base de datos interna del datalogger del MTX-Tunnel. Cuando ejecute el comando el fichero de almacenamiento de datos (data.txt) se eliminará y tras ello, el módem se reiniciará. AT^MTXTUNNEL=SETIO,X,Y Los terminales MTX con tecnología 3G no permiten usar el comando AT^SSIO que puede utilizarse con los terminales GPRS para cambiar el estado de una salida digital. Cuando se utilice un MTX 3G el comando a usar es AT^MTXTUNNEL=SETIO,X,Y (Siendo X la GPIO a cambiar (0 9) y Y el valor a establecer (0, 1) AT^MTXTUNNEL=FTP,loginServerFTP,passwordServerFTP,directorioFTP,nombre FicheroRemoto,nombreFicheroMTX,URLdeNotificacion Es posible realizar una descarga FTP de un archivo ubicado en un servidor remoto en el terminal MTX. Útil para cambiar el fichero de configuración config.txt, cambiar el fichero operators.txt o descargar otro tipo de arhivo. Debe de introducirse el Login y Password del servidor, el directorio del servidor donde se encuentra el arvhivo, el nombre del archivo a descargar, el nombre que se quiere que tenga el archivo dentro del MTX y una URL de notificación (una página web que será llamada cuando la descarga se procese correctamente). AT^MTXTUNNEL=SETCONFIG,fileConfigRaw Permite establecer el contenido completo del fichero de configuración de un MTX-Tunnel sin necesidad de cambiar parámetro por parámetro. Pensado únicamente para ser usado como respuesta desde una plataforma web al envío de un objeto JSON. Por ejemplo, cuando el MTX envía un objeto JSON de su logger interno a una plataforma web, ésta puede responder al MTX con este comando, entre los tags <MTXTUNNELR> y </MTXTUNNELR> para cambiar la configuración completa. El MTX, una vez procesado este comando AT, se reiniciará con la nueva configuración. AT^MTXTUNNEL=SETOUTPUTTIMER,numOutput,value Permite activar una salida digital o relé durante X segundos con un único comando AT. La salida afectada debe estar previamente configurada con OUTPUT_mode en modo Timer (ver ejemplo 8.5). numoutput es un valor que puede ir de 0 3 en función del modelo de MTX. Value puede tomar los valores 0, 1 Página 50

51 Los siguientes comandos AT son únicamente para usar cuando el parámetro MTX_portAux está configurado como wavenis, o lo que es lo mismo, cuando se está utilizando un módem MTX (como el modelo MTX-IND-V2) con soporte de comunicaciones Wavenis: AT^MTXTUNNEL= READWAVETHERM, direccionmacwavenis Este comando devuelve la lectura en tiempo real de la temperatura de un dispositivo Wavetherm, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. AT^MTXTUNNEL= READWAVEFLOW, direccionmacwavenis Este comando devuelve la lectura en tiempo real de los contadores de pulsos de un dispositivo Waveflow, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. AT^MTXTUNNEL= READWAVESENSEC, direccionmacwavenis Este comando devuelve la lectura en tiempo real de corriente de un dispositivo Wavesense 4-20mA, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. AT^MTXTUNNEL= READWAVESENSEV, direccionmacwavenis Este comando realiza la lectura en tiempo real de tensión de un dispositivo Wavesense 0-5V, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. AT^MTXTUNNEL= READWAVELOG, direccionmacwavenis Este comando realiza la lectura en tiempo real de las 4 entradas digitales de un dispositivo Wavelog, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. AT^MTXTUNNEL= WAVENISRSSI, direccionmacwavenis Este comando realiza la lectura en tiempo real del RSSI (nivel de señal recibido) con respecto a un equipo wavenis, cuya dirección MAC debe especificarse en el parámetro direccionmacwavenis. Página 51

52 AT^MTXTUNNEL= REPEATERS, xxxxxxxxxxxxxxxxx Si para realizar la medida de un dispositivo en tiempo real (mediante los comandos AT indicados en las páginas previas) es necesario usar repetidores es necesario usar este comando de forma previa. En xxxxxxxxxxxxxxxxx debe indicarse el número de repetidores a usar seguido de las MAC de los repetidores. Por ejemplo, si se pretende usar 2 repetidores de MACS: 0A y 0B el comando AT a ejecutar sería: AT^MTXTUNNEL=REPEATERS,020A B Recuerde que únicamente pueden especificarse 01, 02 ó 03 repetidores AT^MTXTUNNEL= RESETWAVECARD Permite resetear físicamente la tarjeta comunicaciones Wavecard del MTX-IND-V2 Página 52

53 8.- Parámetros de configuración del MTX-Tunnel Parámetros de configuración Generales: MTX_ Los parámetros de configuración que empiezan por el prefijo MTX_ son los parámetros de configuración más generales del MTX-Tunnel. MTX_PIN Descripción. PIN de la tarjeta SIM de telefonía. Valores posibles. Cadena de máximo 16 caracteres Valor por defecto: 0000 Notas adicionales. - En caso de usar una tarjeta SIM sin número PIN puede dejar el parámetro MTX_PIN en blanco. Página 53

54 MTX_mode Descripción. Indica el modo de funcionamiento principal del software MTX-Tunnel. Este parámetro indicará si el módem debe comportarse como un socket tcp servidor (a la espera de conexiones remotas), como un socket tcp cliente (conectándose el propio módem a un servidor remoto) o como socket UDP (para recibir y enviar tramas mediante el protocolo UDP) Si no se necesita crear ningún túnel GPRS-Serie debe establecerse el valor MTX_mode a none. Por ejemplo, puede ser útil cuando únicamente se necesita una alarma SMS ante el cambio de una entrada digital. Valores posibles. server, client, udp, none Valor por defecto: server Notas adicionales. - Se recomienda la lectura del Anexo especial con los Ejemplos de escenarios para una mayor comprensión de este parámetro. - El uso de none es útil para escenarios en los que no se va a usar ningún túnel GPRS- Serie (véase los Anexos de ejemplo). Página 54

55 MTX_urc Descripción. Durante el funcionamiento normal del MTX-Tunnel, éste puede informar sobre el estado de las conexiones, mediante el envío de mensajes especiales enviados a través del puerto serie COM1. Los mensajes URC que pueden recibirse son: ^MTXTunnel_8.x_running Es el primer mensaje que se muestra tras el arranque del módem MTXTunnel, indicando que está en modo funcionamiento ^MTX_IP_XXX.XXX.XXX.XXX Se muestra cuando el MTX-Tunnel consigue una nueva dirección IP del operador de telefonía GSM. ^MTX_DTR_END_APPLICATION Se muestra cuando finaliza la aplicación MTX-Tunnel a petición de usuario (por comando AT o por manejo programado de la línea DTR). ^MTX_CONNECTION_CLIENT_ESTABLISHED Se muestra cuando un MTX-Tunnel configurado como client se ha conectado con un servidor remoto ^MTX_CONNECTION_CLIENT_END Se muestra cuando finaliza la conexión de un MTX-Tunnel configurado como client, ya sea por desconexión propia o por cierre de socket de forma remota. ^MTX_CONNECTION_ESTABLISHED Se muestra cuando un MTX-Tunnel configurado como server acepta una conexión de un socket de un equipo remoto. ^MTX_CONNECTION_END Se muestra cuando finaliza una conexión a un MTX-Tunnel configurado como server, ya sea por desconexión propia o por cierre del socket a iniciativa de un equipo remoto Página 55

56 ^MTX_SOCKET_UDP_ESTABLISHED Se muestra cuando un MTX-Tunnel configurado como udp está preparado para enviar y recibir tramas UDP. ^MTX_SOCKET_UDP_END Se muestra cuando un MTX-Tunnel configurado como udp cierra el socket UDP a iniciativa propia (por ejemplo, porque se ha terminado el tiempo que teníamos configurado con la sesión GPRS abierta). ^MTX_BITCOIN_INCOME_ Se muestra cuando el MTX-Tunnel está configurado para recibir pagos en bitcoin. Consulte los ejemplos de los anexos para más información. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Se recomienda desactivar los mensajes URC si no son necesarios. Debe comprender que, en un funcionamiento normal del túnel GPRS-RS232, estas cadenas son enviadas por el propio puerto serie de trabajo del túnel, pudiendo interferir, si no son correctamente gestionados, en las comunicaciones. - Puede resultar útil tenerlos activos durante la primera toma de contacto con el MTX- Tunnel, para obtener de forma rápida y sencilla información valiosa como la IP Pública obtenida del operador. Página 56

57 MTX_reset Descripción. El parámetro indica los minutos que deben transcurrir para que el MTX-Tunnel se autoresetee de forma automática. Una vez reseteado, el MTX-Tunnel arrancará de nuevo automáticamente. Un valor 0 hará que el módem nunca se resetee automáticamente. Valores posibles (43200 minutos = 30 días) Valor por defecto: 0 Notas adicionales. - Se recomienda no utilizar el reset automático si no es totalmente necesario. El MTX- Tunnel incorpora los mecanismos necesarios para asegurar la conectividad GPRS. Página 57

58 MTX_resetHour Descripción. El parámetro indica la hora a la que el MTX-Tunnel debe autoresetearse automáticamente. Una vez reseteado, el MTX-Tunnel arrancará de nuevo automáticamente. Un valor 99 hará que el módem nunca se resetee a ninguna hora. Valores posibles Valor por defecto: 99 Notas adicionales. - Se recomienda no utilizar el reset programado si no es totalmente necesario. El MTX- Tunnel incorpora los mecanismos necesarios para asegurar la conectividad GPRS. - Es obligatorio el uso del parámetro MTX_TPServer para indicar un servidor de hora. El módem sincronizará periódicamente su hora con la de dicho servidor mediante protocolo TP (Time Protocol). - La hora utilizada por el módem es HORA UTC (por favor, tenga en cuenta a qué hora UTC corresponde su región. Por ejemplo, en España: UTC+1 ó UTC+2 en verano (Ejemplo, hora UTC 09:00 en Julio en España, corresponde a las 11:00 hora local) - Si se usa MTX_resetHour, se recomienda también usar MTX_reset, estableciendo un valor de 25 horas. De esa manera, si por cualquier razón la sincronización horaria falla (recuerde que pasa usar el reset programado a una hora determinada se usa sincronización horaria) MTX_reset se encargará, poco después, de reiniciar el equipo. Página 58

59 MTX_ping Descripción. Indica los minutos tras los cuales el MTX-Tunnel hará un PING a una determinada dirección IP (que puede ser la propia IP del equipo), asegurando la conectividad. Un 0 hará que nunca se use el PING Valores posibles (1 día) Valor por defecto: 30 Notas adicionales. - Se recomienda encarecidamente el uso del parámetro MTX_ping con al menos un valor de 30 minutos - El uso es todavía más recomendado si la conexión es de tipo server. En una conexión tipo server el MTX-Tunnel está a la espera de conexiones entrantes provenientes de equipos remotos. Si no hay tráfico durante largo tiempo el operador de telefonía puede llegar a bloquear la sesión ppp sin notificación al módem. El MTX-Tunnel, al estar a la espera de conexiones entrantes, no tiene posibilidad de detectar dicho bloqueo (no hay tráfico saliente) y la única manera de detectar esta posible situación es mediante este PING periódico, que supone un tráfico insignificante. Este PING, además de detectar un posible bloqueo de la sesión ppp, sirve para generar un pequeño tráfico de datos e impedir en gran manera un bloqueo por parte del operador de telefonía. Página 59

60 MTX_pingIP Descripción. En caso de que el parámetro MTX_ping > 0, es decir, que esté activada la opción de ping periódico, este parámetro especifica la dirección IP contra la que realizar el PING. Si no se utiliza en el fichero de configuración este parámetro, el MTX-Tunnel hará ping a su propia IP. No todos los operadores de telefonía soportan ping a la propia IP del equipo (es decir, no todos los operadores soportan que un equipo se haga ping a sí mismo), por lo que es recomendable especificar aquí una dirección IP (la IP fija de un servidor, la IP del servidor de DNS de Google , Valores posibles. xxx.xxx.xxx.xxx ó una URL tipo Valor por defecto: si no se especifica nada, la IP del propio equipo Notas adicionales. - Se recomienda el uso del método ping especialmente en conexiones permanentes. Página 60

61 MTX_portAux Descripción. La mayoría de los terminales MTX cuentan con 2 puertos serie COM1 y COM2. Si este parámetro se establece a on un equipo externo conectado al COM2 del módem podrá enviar comandos AT a través de este puerto COM. Valores posibles. on, off, wavenis, modbusmaster, gateway Valor por defecto: off Notas adicionales. - Pueden enviarse comandos AT por el puerto COM2, pero en caso de no usar esta característica, se recomienda establecer el parámetro a off para no dedicar recursos de la CPU del módem a esta tarea. - Este parámetro debe permanecer a off en caso de que el MTX-Tunnel se use sobre un MTX que cuente sólo con un puerto serie COM1. - Se recomienda la lectura del capítulo 7, donde se muestra una lista de los comandos AT autorizados. También se recomienda la lectura del parámetro MTX_ATLimited - A partir de la versión MTX-Tunnel 5.6 es posible establecer el valor wavenis. Con este valor podrá controlar dispositivos RF con protocolo Wavenis. - A partir de la versión MTX-Tunnel v7 es posible establecer el valor modbusmaster. Con este valor podrá controlar leer dispositivos modbus RTU conectados al puerto secundario de los módem MTX. Consulte los parámetros LOGGER_, MODBUS_ para más información - A partir de la versión MTX-Tunnelv7.10 es posible establecer el valor gateway. Con este valor, el módem, cuando NO tiene establecidas conexiones GPRS ni GSM, actúa de Gateway entre sus puertos serie. Todos los datos que entran por el COM1 son redirigidos al COM2 y viceversa. Puede encontrar un ejemplo en el Anexo 7.2 Página 61

62 MTX_portAuxEcho Descripción. En caso de tener el parámetro MTX_portAux a on, indica si el MTX-Tunnel debe devolver el eco de los comandos AT enviados a través del puerto serie COM2 Valores posibles. on, off Valor por defecto: on Notas adicionales. - Este parámetro sólo aplica si el parámetro MTX_portAux está configurado a on, siendo irrelevante el valor en caso de estar a off. Página 62

63 MTX_IDClient Descripción. En caso de tener configurado el MTX-Tunnel como cliente (MTX_mode a client ) el MTX- Tunnel enviará una cadena identificativa cada vez que se establece una conexión con un servidor remoto. Esta cadena será lo primero que se enviará tras realizar la conexión contra el servidor remoto. Esto permite a un MTX-Tunnel identificarse con el servidor remoto al cual se conecta, especialmente en casos en los que se use una tarjeta SIM provisionada con dirección IP dinámica (no fija). Valores posibles. Cadena de texto máximo 255 caracteres. Valor por defecto: (cadena vacía, no se envía nada) Notas adicionales. - En caso de no especificar ningún valor en MTX_IDClient el MTX-Tunnel no enviará ninguna cadena identificativa tras realizar la conexión. Página 63

64 MTX_IDClientExtended Descripción. Con un valor de on en este parámetro y establecido una cadena identificativa en el parámetro MTX_IDClient, se adjunta a la cadena identificativa unos datos adicionales, a fin de reportar mayor información a un servidor remoto. La cadena enviada, en caso de estar MTX_IDClientExtended a on es: MTX_IDClient#IMEI#gpio1#gpio2# #gpio10#adc1#adc2# Donde MTX_IDClient es la cadena especificada en ese parámetro, IMEI es el IMEI del módem, gpiox una entrada digital y adcx una entrada analógica. Si no necesita las entradas / salidas, especificando un valor imei en este parámetro y establecido una cadena identificativa en el parámetro MTX_IDClient, se envía la siguiente cadena: MTX_IDClient#IMEI# Donde MTX_IDClient es la cadena especificada en ese parámetro y IMEI es el IMEI del módem Valores posibles. on, off, imei Valor por defecto: off Notas adicionales. - En caso de no especificar ningún valor en MTX_IDClient el MTX-Tunnel no enviará ninguna cadena identificativa tras realizar la conexión. Página 64

65 MTX_IDClientPeriod Descripción. El texto especificado en MTX_IDClient se envía justo tras una conexión de tipo cliente contra un servidor remoto. Se envía siempre que se establece una nueva conexión pero sólo 1 vez. Si es necesario, IDClient puede enviarse de forma periódica cada X segundos, sin necesidad de que se cierre el socket cliente, para ello debe especificarse un valor >0. Valores posibles (30 días) Valor por defecto: 0 (sólo se envía 1 vez tras la conexión con un servidor remoto) Notas adicionales. - Este parámetro puede resultar muy útil para monitorizar de forma remota el estado de las entradas/salidas digitales y conversores analógicos/digital, pues permite el envío periódico de éstas. Página 65

66 MTX_dtr Descripción. En algún escenario puede ser necesario detener la aplicación MTX-Tunnel en un momento determinado para disponer de un módem GSM convencional (por ejemplo para realizar una llamada de datos CSD o de audio). Existen 2 formas de detener la aplicación MTX-Tunnel. Una es por el envío de un comando AT especial (AT^MTXTUNNEL=EXIT) y la otra es mediante el uso de la línea DTR del puerto serie COM1 del módem. Estableciendo este parámetro a on hará que la aplicación MTX-Tunnel finalice cuando se active la línea DTR del puerto serie COM1 del módem. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Una vez desactivado el MTX-Tunnel, puede volver a activarse el MTX-Tunnel reiniciando el módem (comando AT+CFUN=1,1 (recomendado)) o bien mediante el comando AT^SJRA= A:/MTXTunnel.jar Página 66

67 MTX_TPServer Descripción. El MTX-Tunnel admite sincronización horaria mediante la comunicación con un servidor de tiempo, a través del protocolo TP (Time Protocol). Esto permite al módem mantener su hora exacta y evitar cualquier tipo de deriva de su RTC (real time clock) así como recoger la horas tras los apagados de éste. Puede usarse un servidor de hora privado (un servidor de oficina) o bien uno de los muchos servidores gratuitos que existen en la actualidad, como son los siguientes: time-a.timefreq.bldrdoc.gov > time-a.timefreq.bldrdoc.gov time-b.timefreq.bldrdoc.gov time-c.timefreq.bldrdoc.gov utcnist.colorado.edu time-nw.nist.gov nist1.nyc.certifiedtime.com nist1.dc.certifiedtime.com nist1.sjc.certifiedtime.com nist1.datum.com ntp2.cmc.ec.gc.ca ntps1-0.uni-erlangen.de ntps1-1.uni-erlangen.de ntps1-2.uni-erlangen.de ntps1-0.cs.tu-berlin.de time.ien.it ptbtime1.ptb.de ptbtime2.ptb.de recomendado como servidor público y gratuito. Valores posibles. Cadena de texto < 255 caracteres Valor por defecto: Ninguno Notas adicionales. - Los servidores de hora devuelven hora URC por lo que la hora utilizada por el módem es también hora UTC (por favor, tenga en cuenta a qué hora UTC corresponde su región. Por ejemplo, en España: UTC+1 ó UTC+2 en verano (Ejemplo, hora UTC 09:00 en Julio en España, corresponde a las 11:00 hora local) - Desde la versión MTX-Tunnel 7.15 es posible establecer a este parámetro un valor null. Especificar un valor null hará que el módem tome como hora válida su hora actual, sin consultarla con un servidor externo. Esto resulta MUY útil en escenarios donde se usan los parámetros WAKEUP_ donde puede ser necesario realizar una actividad cada cierto tiempo, sin importar realmente si la hora es válida o no. Página 67

68 MTX_TPServer2 Descripción. Servidor de hora de backup. Puede especificar un servidor de tiempo para el caso que falle el primero se tome este segundo como backup de seguridad. time-b.timefreq.bldrdoc.gov > time-a.timefreq.bldrdoc.gov time-b.timefreq.bldrdoc.gov time-c.timefreq.bldrdoc.gov utcnist.colorado.edu time-nw.nist.gov nist1.nyc.certifiedtime.com nist1.dc.certifiedtime.com nist1.sjc.certifiedtime.com nist1.datum.com ntp2.cmc.ec.gc.ca ntps1-0.uni-erlangen.de ntps1-1.uni-erlangen.de ntps1-2.uni-erlangen.de ntps1-0.cs.tu-berlin.de time.ien.it ptbtime1.ptb.de ptbtime2.ptb.de recomendado como servidor público y gratuito. Valores posibles. Cadena de texto < 255 caracteres Valor por defecto: Ninguno Notas adicionales. - Sólo debe utilizar el servidor de backup si previamente ha configurado un servidor de tiempo MTX_TPServer2 Página 68

69 MTX_ATMux Descripción. Un valor de on permitirá activar el multiplexor de comandos AT en el puerto serie COM1 del puerto serie del módem. Con el multiplexor de comandos AT activado es posible enviar comandos AT a través del puerto COM1 incluso cuando el túnel GPRS-RS232 está activado. Esto permite al dispositivo que está conectado al puerto COM1 del MTX-Tunnel consultar parámetros como la cobertura GSM, cambiar/leer el estado de una entrada digital, desactivar el MTX-Tunnel, cambiar un parámetro de configuración, Para que el MTX-Tunnel interprete los datos recibidos como un comando AT (es decir, para que no envíe directamente los datos recibidos a un servidor remoto, sino que los interprete) es necesario encapsular los datos (el comando AT) entre los tags <MTXTUNNEL></MTXTUNNEL> Por ejemplo, enviando los datos: <MTXTUNNEL>AT+CSQ</MTXTUNNEL> El MTX-Tunnel devolverá: <MTXTUNNEL>AT+CSQ +CSQ: 22,99 OK</MTXTUNNEL> Valores posibles. on, off Valor por defecto: off Notas adicionales. - El comando AT multiplexado debe enviarse en bloque (no debe haber una pausa superior a 50ms entre caracteres) y debe estar precedido de una pausa (sin envío de datos por el puerto serie) de 1 segundo. - Lea el capítulo 7 para obtener más información sobre los comandos AT soportados por MTX-Tunnel. Página 69

70 MTX_WatchdogOnExit Descripción. Un valor de on hace que una vez desactivada la aplicación MTX-Tunnel (bien por MTX_DTR o por un comando AT mediante MTX_ATMUX) el watchdog siga activo. El watchdog interno del MTX-Tunnel debe refrescarse cada 300 segundos (5 minutos). En caso de no refrescarse el módem se reseteará automáticamente a los 5 minutos, reiniciando de nuevo la aplicación MTX-Tunnel. En pocas palabras, un valor de on provocará que irremediablemente el módem se resetee a los 5 minutos tras desactivar el MTX-Tunnel. Un valor de off hace que el watchdog se desactive al finalizar la aplicación MTX-Tunnel, no reiniciándose automáticamente. Valores posibles. on, off Valor por defecto: on Notas adicionales. - Puede resultar útil este parámetro para aplicaciones en el que el usuario necesite desactivar momentáneamente el MTX-Tunnel para realizar ciertas tareas (por ejemplo, una llamada GSM o de voz). Con este parámetro a on se asegura que a los 5 minutos el MTX-Tunnel volverá a estar activo (arranca automáticamente tras cada reset del módem). Página 70

71 MTX_model Descripción. Permite especificar el tipo de dispositivo sobre el que se está ejecutando la aplicación MTX- Tunnel. Valores posibles. MTX-65i, MTX-IND, MTX-65-GPS-V3, MTX-65-GPS-BAT-V5, MTX-65i-GPS-V6, MTX-65-GPS-BAT-V7, MTX-65i-ULP, MTX-IND-V1, MTX-65i-RS485, MTX-3G-JAVA, MTX-3G-JAVA-BAT, MTX-3G-JAVA-GPS, MTX-3G-JAVA-ULP, MTX-3G-JAVA-ULP-GPS, MTX-IND-3G-JAVA Valor por defecto: MTX-65i Notas adicionales. - Es obligatorio especificar el modelo correcto de módem MTX sobre el que se está ejecutando la aplicación MTX-Tunnel debido a que cada modelo de módem MTX dispone de una configuración específica de entradas / salidas. Un valor incorrecto de este parámetro implica que la aplicación puede no trabajar correctamente especialmente en lo relativo a entradas / salidas (alarmas SMS, ) - Los nombres de los terminales difieren ligeramente con el valor que debe establecerse en el parámetro MTX_model. A continuación una lista con la relación. Debe prestarse atención a las mayúsculas / minúsculas. Modem MTX-65i Modem MTX-65i-RS485 Modem MTX-65ULP Modem MTX-IND Modem MTX-IND-V1 Modem MTX-65+G Modem MTX-65+G+Bv5 Modem MTX-65+Gv6 Modem MTX-65+G+Bv7 Modem MTX-3G-JAVA Modem MTX-3G-JAVA+B MTX_model: MTX-65i MTX_model: MTX-65i-RS485 MTX_model: MTX-65i-ULP MTX_model: MTX-IND MTX_model: MTX-IND-V1 MTX_model: MTX-65-GPS-V3 MTX_model: MTX-65-GPS-BAT-V5 MTX_model: MTX-65-GPS-V6 MTX_model: MTX-65-GPS-BAT-V7 MTX_model: MTX-3G-JAVA MTX_model: MTX-3G-JAVA-BAT Página 71

72 Modem MTX-3G-JAVA+G Modem MTX-3G-JAVA-ULP MTX_model: MTX-3G-JAVA-GPS MTX_model: MTX-3G-JAVA-ULP Modem MTX-3G-JAVA-ULP-GPS MTX_model: MTX-3G-JAVA-ULP-GPS Modem MTX-IND-3G-JAVA MTX_model: MTX-IND-3G-JAVA Página 72

73 MTX_atLimited Descripción. Parámetro especial que permite quitar la limitación para la ejecución de comandos AT (vía ATMux por el COM1, por el COM2, por SMS, por HTTP ó por SMS). Estableciendo este parámetro a off la limitación desaparece. Valores posibles. on, off Valor por defecto: on Notas adicionales. - Es MUY RECOMENDABLE mantener este parámetro a on. Sólo debería establecerse a off tras consultar con el fabricante los comandos AT que se pretende utilizar. Utilizar comandos AT sin limitación puede interferir en el buen funcionamiento del MTX-Tunnel si los comandos AT no se usan con precaución. Página 73

74 MTX_clientSSL Descripción. Permite usar sockets con seguridad SSL cuando el MTX-Tunnel está configurado en modo cliente (MTX_mode: client). Para ello el servidor al cual se conectará el MTX-Tunnel debe soportar sockets SSL Valores posibles. on, off Valor por defecto: off Notas adicionales. - Sólo es posible establecer seguridad SSL para sockets tipo cliente (MTX_mode: client). - No se recomienda su uso si no es necesario, ya que las comunicaciones son más lentas y el volumen de tráfico mayor. - Sólo para conectar con servidores SSL bajo los standard: + TLP protocol version 1.0 (RFC 2246) + SSL v3.0 + WAP TLS Profile and Tunneling Specification Página 74

75 MTX_temporalClient Descripción. Permite establecer un socket cliente temporal cuando se utiliza el MTX-Tunnel en modo servidor (MTX_mode: server) y no hay ninguna conexión establecida. Escenario ejemplo: se dispone de una serie de módems MTX-Tunnel. Cada MTX-Tunnel tiene conectado en su puerto serie COM1 una estación metereológica. Todos los MTX- Tunnel están configurados en modo server, pues se pretende establecer una conexión periódicamente desde un PC central para recoger el histórico de temperaturas de cada estación metereológica. Las estaciones metereológicas pueden enviar datos por el puerto serie si surge una alarma (una temperatura fuera de límites), por lo que el MTX-Tunnel debe, si en ese momento no hay una conexión establecida desde el PC central, establecer una conexión con un servidor remoto para el envío de dicha alarma. Este escenario es posible implementarlo activando este parámetro. Revise los Ejemplos de Escenarios en los anexos de este manual. Valores posibles. on, off Valor por defecto: off Notas adicionales. - El túnel temporal sólo tiene una duración de 1 minuto. Una vez pasado un minuto sin tráfico, el túnel temporal se cerrará. - Cuando se inicia un túnel temporal, se activan también todos los servicios asociados (socket server, webserver, ). Pese a que el cliente temporal se cierre al cabo de 1 minuto, los servicios activados se cerrarán al cabo del tiempo establecido en el parámetro GPRS_timeout, salvo que este parámetro sea 0, que no se cerrarán. - El cliente temporal puede activarse tanto si la conexión GPRS está siempre activa (GPRS_timeout=0) como si no (GPRS_timeout>0). - Cuando hay una conexión establecida (un socket conectado al MTX-Tunnel) no es posible iniciar un socket temporal. - Cuando un cliente temporal está establecido no se aceptan conexiones entrantes. Página 75

76 - Para usar un cliente temporal es OBLIGATORIO que el parámetro MTX_ATMux esté a off, de lo contrario el cliente temporal NO se activará. - Recuerde que a partir del MTX-Tunnel v7 es posible utilizar un comando AT remoto para lanzar en un momento dado un cliente temporal. Página 76

77 MTX_msToSend Descripción. Permite establecer una pausa que indica cuantos milisegundos deben pasar sin recibir datos por el puerto serie para que el MTX envíe los datos vía GPRS. Valores posibles Valor por defecto: 50 Notas adicionales. - Puede resultar útil con equipos que no envíen todos los bytes vía serie de forma concatenada. Aumentando el valor del parámetro las comunicaciones serán más lentas, pero los paquetes de datos se enviarán vía GPRS de manera compactada. Página 77

78 MTX_gatewayModBus Descripción. Permite establecer que un túnel configurado como SERVIDOR con el (parámetro MTX_mode: server) actúe como una pasarela ModBus TCP / ModBus RTU Valores posibles. on, off Valor por defecto: off Notas adicionales. - Es importante recalcar que el MTX-Tunnel sólo puede configurarse como MODBUS TCP / MODBUS RTU cuando está configurado como servidor (a la espera de una conexión TCP por parte de un PC remoto). Véase ejemplo 2.14 en los Anexos de este manual. - Página 78

79 MTX_alwaysConnectedClient Descripción. Parámetro que, cuando el MTX-Tunnel está configurado como cliente (MTX_modeClient), indica si el socket TCP debe establecerse únicamente una vez (valor off ) o si de lo contrario, en caso de detectarse el cierre del socket, debe intentarse una y otra vez cada 30 segundos (valor on ). Valores posibles. on, off Valor por defecto: on Notas adicionales. - Sólo debe utilizar este parámetro con valor off si va a utilizar el MTX-Tunnel en modo client (MTX_mode: client) por ejemplo para que el MTX-Tunnel se conecte cada X tiempo a un servidor para volcado de datos. - Es decir, si establece el parámetro a off el módem se conectará a su servidor y hará el volcado de datos. Una vez finalizado el volcado usted puede cerrar el socket desde su servidor y el MTX-Tunnel no reintentará la reconexión de forma continua cada 30 segundos durante el tiempo establecido en (GPRS_timeout) ahorrando recursos en su servidor. Página 79

80 MTX_init1, MTX_init2, MTX_init3 Descripción. Estos tres parámetros permiten especificar hasta 3 comandos AT que se ejecutarán automáticamente cada vez que arranque el MTX-Tunnel. Por ejemplo, permitirían el envío de un SMS cada vez que se enciende el equipo. Valores posibles. Cualquier comando AT Valor por defecto: ninguno Notas adicionales. - Estos parámetros están concebidos para cubrir las necesidades de la gran cantidad de escenarios en los que puede llegar a estar presente el MTX-Tunnel. Le recomendamos que consulte con Matrix Electrónica antes de utilizarlos. Página 80

81 MTX_ATEmbedded Descripción. Este parámetro permite que el módem interprete comandos AT recibidos por un socket cliente. Es decir, si este parámetro está a on desde el propio servidor podrán enviarse comandos AT hacia el MTX-Tunnel encapsulado entre los tags: <MTXTUNNELR> y </MTXTUNNELR>. Podrá consultar la cobertura, cambiar configuraciones Muy útil en el caso de usar socket tipo client. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Si envía un comando AT embebido a través de un socket, la respuesta también la recibirá entre los tags <MTXTUNNELR></MTXTUNNELR> - Este modo de envío de comandos AT embebidos le permite sortear firewalls y proxys que utilizan muchos operadores telefónicos. Si usted no puede utilizar Telnet para enviar comandos AT remotos a su MTX-Tunnel porque su operador se lo impide, use esta vía. Válido tanto para sockets client, server y para sockets cliente temporales. Página 81

82 MTX_radioBand Descripción. Este parámetro permite especificar las bandas radio preferidas para el módem. Normalmente no es necesario su especificación, pero en ciertos países de Sudamérica como Chile, si es necesario Valores posibles. none, europe, america Valor por defecto: none Notas adicionales. - Si su módem va a ser usado en Europa le recomendamos que o use el valor none o que use el valor europe. - Si su módem va a ser usado en el continente americano, le recomendamos que use el valor america. Página 82

83 MTX_invertedCom Descripción. Este parámetro permite invertir el orden de los puertos COM de un módem que cuente con 2 puertos serie. Por ejemplo, el módem MTX-65i dispone de dos puertos serie, uno en conector DB9 (el COM principal) y otro en el conector DB15 (el COM secundario). Si MTX_invertedCOM está a on el puerto serie del conector DB15 se convierte en el COM principal y el DB15 el secundario. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Este parámetro puede resultarle útil especialmente en el módem MTX-65i, si en lugar de utilizar el conector DB9 prefiere utilizar el conector DB15 o viceversa. - Tenga en cuenta que el puerto RS485 del módem MTX-65iRS485 es el com secundario. Si necesita usarlo como primario (por ejemplo para atender una llamada GSM) debe usar MTX_invertedCOM a on. Página 83

84 MTX_flushSerialBuffers Descripción. Este parámetro permite limpiar los buffers serie de cualquier dato pendiente de envío antes de la conexión del socket TCP/IP. Es decir, que de haber algún dato serie pendiente antes de establecerse la pasarela serie-gprs, es eliminado de los buffers del módem. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Ninguna. Página 84

85 MTX_ATEmbeddedPass Descripción. Con el parámetro MTX_ATEmbedded a on (véase la descripción de este parámetro de configuración) es posible enviar comandos AT de configuración al módem en la propia pasarela gprs-serie. Con MTX_ATEmbeddedPass es posible establecer un password en los comandos AT embebidos para una mayor seguridad. Valores posibles. Cadena de hasta 32 caracteres Valor por defecto: ninguno Notas adicionales. - Si especifica un password en este parámetro MTX_ATEmbeddedPass, cuando envíe un comando AT embebido deberá especificar el password. Por Ejemplo, si necesita enviar el comando AT+CSQ, si no especifica un password deberá enviar <MTXTUNNELR>AT+CSQ</MTXTUNNELR>, si especifica el password XXX deberá enviar <MTXTUNNELR XXX>AT+CSQ</MTXTUNNELR>, es decir, <MTXTUNNELR[espacio][password]>comandoAT</MTXTUNNELR> Página 85

86 MTX_clientReconnection Descripción. Parámetro útil para aquellos escenarios de configuración en el que estén presente conexiones tipo cliente (MTX_mode: client). En tales escenarios este parámetro de configuración especifica el tiempo en que, tras un cierre por parte del Server remoto, el MTX-Tunnel reintenta la conexión. Valores posibles (segundos) Valor por defecto: 30 Notas adicionales. - Tenga presente que en el caso de especificar un número muy bajo (por ejemplo 0 ), ante una caída o problema constante en el servidor remoto el MTX-Tunnel reintentará de forma muy rápida la conexión, incrementando el ancho de banda. Página 86

87 MTX_urcPort Descripción. Parámetro disponible desde la versión MTX-Tunnel v7.15. Permite especificar el puerto de salida de los mensajes URC. Valores posibles. asc0, asc1 y usb Valor por defecto: asc0 Notas adicionales. - El valor ASC0 hace referencia al puerto serie principal del equipo (COMM_) - El valor ASC1 hace referencia al puerto serie secundario del equipo (COMM2_ ) - El valor USB úselo solo bajo indicaciones de Matrix Electrónica Página 87

88 MTX_clientTimeout Descripción. Parámetro disponible desde la versión MTX-Tunnel v7.15. Permite especificar el tiempo, en segundos, en el un socket de tipo cliente se debe cerrar en caso de no haber intercambio de datos GPRS. Valores posibles Valor por defecto: 1800 (30 minutos) Página 88

89 MTX_rssiLevel Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.16 Parámetro útil únicamente para el modelo de módem MTX-65i. Si se especifica un valor mayor que 0, se iluminará el led rojo del módem en caso de problemas de cobertura GSM (señal de que hay que cambiar la antena de ubicación o bien utilizar una antena de mayor ganancia). En caso de ser utilizado este parámetro, se recomienda un valor de 10. Por ejemplo, un valor de 10, hará que si el módem lee una cobertura GSM de valores comprendidos entre 0 y 9 ilumine su led rojo, indicando situación de mala cobertura. En caso de obtener una cobertura entre 10 y 31 (adecuada), el led rojo dejará de iluminarse). Valores posibles Valor por defecto: 0 (desactivado) Notas adicionales. - Los valores de nivel de cobertura de un módem están normalizados entre 0 y 31, siendo 0 el peor valor y 31 la mayor cobertura. - El módem actualiza el estado de su led de cobertura cada 10 segundos. Página 89

90 MTX_fullDuplex Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.19 Permite mejorar la capacidad full-duplex de las pasarelas GPRS-Serie. Especialmente pensado para aplicaciones NO basadas en comunicaciones pregunta-respuesta, sino con trasmisiones / recepciones independientes Valores posibles. on, off Valor por defecto: off (desactivado) Notas adicionales. - Se recomienda únicamente ponerlo a on en el caso de aplicaciones con comunicaciones bidireccionales asíncronas independientes. Si usted dispone de una aplicación pregunta/respuesta (típica pregunta desde un servidor a la que el esclavo responde) no active este parámetro. - Activar este parámetro mejorará ligeramente las comunicaciones bidireccionales asíncronas pero penalizará en tiempo otros servicios (Telnet, ) - Si no sabe si activar o no este parámetro, le recomendamos que no lo incluya en el fichero de configuración config.txt Página 90

91 MTX_filter Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.20 Permite usar un filtro en las pasarelas GPRS-Serie (tanto en modo tcp server, como tcp client como udp). El uso de un filtro implica que únicamente las tramas de datos que lleguen al puerto serie del módem con una determinada cabecera serán enviadas vía GPRS Valores posibles. x,x,x,x (los bytes de la cabecera separados por coma, ) Valor por defecto: ninguna (no se usan cabeceras) Notas adicionales. - La cabecera debe especificarse con bytes (en decimal, no hexadecimal) separados por,. - Por ejemplo, si únicamente quiere que las tramas que comiencen con ABC sean enviadas, el parámetro MTX_filter en el fichero de configuración debería ser así: MTX_filter: 65,66,67 Pues la A corresponde con el ASCII 65, la B con el 66, la C con el 67 - Otro ejemplo, si el MTX-Tunnel está conectado a una red modbus y a usted únicamente le interesa enviar vía GPRS las tramas de datos encaminadas al dispositivo MODBUS con dirección 1, el parámetro MTX_filter en el fichero de configuración debería ser así: MTX_filter: 1 - Si no necesita el uso de filtros, simplemente no incluya este parámetro en el fichero de configuración. - Tenga presente que debe tener en cuenta el parámetro MTX_msToSend para usar este parámetro. Página 91

92 MTX_latitude Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.27 Especifica la latitud (relativa a la posición GPS, en formato decimal) donde se encuentra instalado el MTX-Tunnel. Este parámetro es necesario usar cuando se usa el reloj astronómico del MTX-Tunnel, por ejemplo para conmutar un relé o una salida digital automáticamente a la puesta/salida del Sol. Valores posibles a Valor por defecto: Ninguno Notas adicionales. - Vea el escenario del Anexo 8.4 para un mejor entendimiento de este parámetro. Página 92

93 MTX_longitude Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.27 Especifica la longitud (relativa a la posición GPS, en formato decimal) donde se encuentra instalado el MTX-Tunnel. Este parámetro es necesario usar cuando se usa el reloj astronómico del MTX-Tunnel, por ejemplo para conmutar un relé o una salida digital automáticamente a la puesta/salida del Sol. Valores posibles a Valor por defecto: Ninguno Notas adicionales. - Vea el escenario del Anexo 8.4 para un mejor entendimiento de este parámetro. Página 93

94 MTX_configMode Descripción. Parámetro válido a partir de la versión MTX-Tunnel v7.27 Permite escoger si el modo config o running del MTX-Tunnel es con tarjeta SIM insertada o sin tarjeta SIM insertada. Es decir, en modo normal (modo por defecto) el MTX-Tunnel entra en modo configuración cuando se alimenta el MTX sin tener una tarjeta SIM introducida y entra en modo running cuando se alimenta con una tarjeta SIM introducida. En modo reverse el MTX entra en modo config con una tarjeta SIM introducida y entra en modo running cuando no hay una tarjeta SIM Valores posibles. -normal, reverse Valor por defecto: normal Notas adicionales. - No utilice el modo reverse si no está seguro de para qué sirve este parámetro. Únicamente es posible usarlo en modo reverse en escenarios muy concretos. - Útilice únicamente el modo reverse si necesita el MTX-Tunnel para Logger sin envío de datos por GPRS. Es decir, por ejemplo para almacenar los registros modbus de un dispositivo durante un tiempo en la memoria interna del módem. Pasado ese tiempo, se recoge el módem y se extrae del módem, manualmente, el fichero data.txt con los datos almacenados. - Consulte el ejemplo del Anexo 6.7 para más información sobre este parámetro de configuración. Página 94

95 MTX_interface Descripción. Permite establecer si el interfaz de comunicaciones es serie o usb. Es decir, si se desea que la pasarela serie GPRS/3G Serie ó GPRS/3G - USB Valores posibles. serial, usb Valor por defecto: serial Notas adicionales. - Parámetro disponible únicamente en los modelos 3G (MTX-3G-JAVA, ) no siendo soportado por los equipos GPRS (MTX-65i, ) Página 95

96 Parámetros de configuración relacionados con el COM1: COMM_ Los parámetros de configuración que empiezan con el prefijo COMM_ hacen referencia a la configuración del puerto serie principal del módem MTX (conector DB9). Este puerto serie es al que habitualmente conectará el dispositivo serie que pretenda controlar y debe tener la configuración apropiada para dicha comunicación. Es decir, por ejemplo, si el dispositivo que pretende controlar funciona a una velocidad de 9600 baudios, debe configurar el parámetro COMM_baudrate a 9600 baudios también. Lo mismo se aplica para el resto de parámetros relacionados con este puerto serie. COMM_baudrate Descripción. Especifica la velocidad del puerto serie COM1 Valores posibles , , , 57600, 38400, 19200, 9600, 4800, 2400, 1200, 600, 300 Valor por defecto: Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. Página 96

97 COMM_autorts Descripción. Configura el puerto serie COM1 para usar control de flujo hardware (RTS). A on se utiliza el control de flujo hardware. A off no se utiliza control de flujo hardware. Valores posibles. on, off Valor por defecto: on Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Debe especificarse el mismo valor en COMM_autocts Página 97

98 COMM_autocts Descripción. Configura el puerto serie COM1 para usar control de flujo hardware (CTS). A on se utiliza el control de flujo hardware. A off no se utiliza control de flujo hardware. Valores posibles. on, off Valor por defecto: on Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Debe especificarse el mismo valor en COMM_autorts Página 98

99 COMM_bitsperchar Descripción. Especifica el número de bits por carácter para las comunicaciones del puerto serie COM1 Valores posibles. 7, 8 Valor por defecto: 8 Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. Página 99

100 COMM_stopbits Descripción. Configura el número de bits de stop para las comunicaciones con el puerto serie COM1 Valores posibles. 1, 2 Valor por defecto: 1 Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Desde la versión 7.27 pueden especificarse 2 bits de datos. Estas comunicaciones a 2 bits de datos pueden resultar algo más lentas que las comunicaciones con 1 bits de stop, especialmente en comunicaciones con gran volumen de datos. Siempre que sea posible se recomienda 1 bit de stop. Página 100

101 COMM_parity Descripción. Configura la paridad para las comunicaciones con el puerto serie COM1 Valores posibles. none, odd, even Valor por defecto: none Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. Página 101

102 Parámetros de configuración relacionados con el COM2: COMM2_ Los parámetros de configuración que empiezan con el prefijo COMM2_ hacen referencia a la configuración del puerto serie secundario del módem MTX, si es que dispone de él (conector DB15 habitualmente). Este puerto serie habitualmente es utilizado para enviar comandos AT al módem, por ejemplo, para solicitar la cobertura, para enviar un SMS, para cambiar desde una aplicación externa una parámetro de configuración del MTX-Tunnel, etc También es posible utilizarlo para controlar otro equipo serie mediante un túnel GPRS-Serie adicional al principal. En el Anexo encontrará un ejemplo de cómo realizar dicha configuración. COMM2_baudrate Descripción. Especifica la velocidad del puerto serie COM2 Valores posibles , , , 57600, 38400, 19200, 9600, 4800, 2400, 1200, 600, 300 Valor por defecto: Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Este parámetro no es posible utilizarlo en los modelos MTX-65-GPS-V3, MTX-65-GPS- BAT-V5 al tener únicamente un puerto serie. En los modelos MTX-65i-GPS-V6, MTX- 65-GPS-BAT-V7 debe configurarse a 9600 baudios para poder leer el GPS Página 102

103 COMM2_autorts Descripción. Configura el puerto serie COM2 para usar control de flujo hardware (RTS). A on se utiliza el control de flujo hardware. A off no se utiliza control de flujo hardware. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Debe especificarse el mismo valor en COMM_autocts - Este parámetro sólo es posible usarlo con las plataformas MTX-IND y MTX-IND-V1. El resto de modelos no dispones de líneas de control de flujo en el puerto secundario. Página 103

104 COMM2_autocts Descripción. Configura el puerto serie COM2 para usar control de flujo hardware (CTS). A on se utiliza el control de flujo hardware. A off no se utiliza control de flujo hardware. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Debe especificarse el mismo valor en COMM_autorts - Este parámetro sólo es posible usarlo con las plataformas MTX-IND y MTX-IND-V1. El resto de modelos no dispones de líneas de control de flujo en el puerto secundario. Página 104

105 COMM2_bitsperchar Descripción. Especifica el número de bits por carácter para las comunicaciones el puerto serie COM2 Valores posibles. 7, 8 Valor por defecto: 8 Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Este parámetro sólo es posible usarlo con las plataformas MTX-IND y MTX-IND-V1. El resto de modelos no dispones de líneas de control de flujo en el puerto secundario. Página 105

106 COMM2_stopbits Descripción. Configura el número de bits de stop para las comunicaciones con el puerto serie COM2 Valores posibles. 1, 2 Valor por defecto: 1 Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Este parámetro sólo es posible usarlo con las plataformas MTX-IND y MTX-IND-V1. El resto de modelos no dispones de líneas de control de flujo en el puerto secundario. - Desde la versión 7.27 pueden especificarse 2 bits de datos. Estas comunicaciones a 2 bits de datos pueden resultar algo más lentas que las comunicaciones con 1 bits de stop, especialmente en comunicaciones con gran volumen de datos. Siempre que sea posible se recomienda 1 bit de stop. Página 106

107 COMM2_parity Descripción. Configura la paridad para las comunicaciones con el puerto serie COM2 Valores posibles. none, odd, even Valor por defecto: none Notas adicionales. - Debe especificarse el mismo valor que en la configuración del puerto serie del dispositivo a controlar. - Este parámetro sólo es posible usarlo con las plataformas MTX-IND y MTX-IND-V1. El resto de modelos no dispones de líneas de control de flujo en el puerto secundario. Página 107

108 Parámetros de configuración relacionados con Telnet: TELNET_ Los parámetros de configuración que empiezan con el prefijo TELNET_ hacen referencia a la configuración del servicio Telnet del equipo. Si habilita el Telnet podrá enviar remotamente comandos AT al MTX-Tunnel, es decir, por ejemplo, podrá consultar la cobertura de forma remota, leer el estado de una entrada digital, conmutar un relé, etc etc TELNET_enabled Descripción. Especifica si debe activarse o no el servidor de telnet. Mediante telnet podrá enviar comandos AT de forma remota al MTX-Tunnel, bien desde una consola telnet de MSDos o mediante un software específico. Valores posibles. on, off Valor por defecto: off Notas adicionales. - El MTX-Tunnel soporta únicamente 2 sockets listener de forma simultánea. Eso implica que no será posible activar el Telnet si el MTX-Tunnel está configurado como server (MTX_mode: server) y con el webserver activo (WEBSERVER_enabled: on) Página 108

109 TELNET_login Descripción. Especifica el login para poder acceder al servidor telnet del MTX-Tunnel Valores posibles. Cadena de texto de longitud máxima 32 caracteres Valor por defecto: (Ninguno) Notas adicionales. - Si especifica un login y password el MTX-Tunnel solicitará dichos parámetros tras la conexión telnet remota. Si no se especifica un login y password se accederá directamente al servicio tras la conexión. - Se recomienda el uso de un login y password si el parámetro TELNET_firewall está configurado a off. Página 109

110 TELNET_password Descripción. Especifica el password para poder acceder al servidor telnet del MTX-Tunnel Valores posibles. Cadena de texto de longitud máxima 32 caracteres Valor por defecto: (Ninguno) Notas adicionales. - Si especifica un login y password el MTX-Tunnel solicitará dichos parámetros tras la conexión telnet remota. Si no se especifica un login y password se accederá directamente al servicio tras la conexión. - Se recomienda el uso de un login y password si el parámetro TELNET_firewall está configurado a off. Página 110

111 TELNET_firewall Descripción. Especifica si se debe habilitar o no el firewall para las conexiones telnet. Si no se habilita el firewall se aceptarán conexiones desde cualquier dirección IP. Si se habilita el firewall únicamente se aceptarán conexiones desde direcciones IP autorizadas (parámetros FIREWALL_IP1, ) Valores posibles. on, off Valor por defecto: on Notas adicionales. - Si configura el firewall a off será altamente recomendado el uso de un login (TELNET_login) y un password (TELNET_password) para impedir accesos no autorizados. Página 111

112 TELNET_port Descripción. Especifica el puerto TCP que usará el MTX-Tunnel para las conexiones Telnet. Valores posibles Valor por defecto: 23 Notas adicionales. - No debe utilizarse el mismo puerto TCP usados en los parámetros TCP_port y/o WEBSERVER_port Página 112

113 TELNET_bypass Descripción. Este parámetro permite especificar si la conexión telnet debe utilizarse como una conexión bypass para controlar un equipo conectado al COM auxiliar del módem MTX-Tunnel. En otras palabras, la activación de este parámetro permitirá controlar simultáneamente un equipo conectado al COM1 del MTX-Tunnel y otro equipo conectado al COM2, es decir, se dispone de 2 túneles GPRS-Serie con un mismo MTX-Tunnel. Valores posibles. on, off Valor por defecto: off Notas adicionales. - En caso de estar activo este parámetro no se toman en consideración los parámetros TELNET_login, TELNET_password. Página 113

114 Parámetros de configuración relacionados con el WebServer: WEBSERVER_ Los parámetros de configuración que empiezan con el prefijo WEBSERVER_ hacen referencia a la configuración del pequeño servicio WebServer que incorpora el MTX-Tunnel. Si habilita el WebServer podrá acceder al MTX-Tunnel desde su navegador. Podrá consultar el estado del módem, consultar la cobertura de forma remota, leer el estado de una entrada digital, conmutar un relé, etc etc WEBSERVER_enabled Descripción. Especifica si debe activarse o no el webserver del MTX-Tunnel. Mediante el webserver podrá visualizar de forma cómoda el estado de las entradas y salidas (tanto digitales como analógicas) del módem así como cambiar el estado de las salidas digitales (o relés en caso de usar el módem MTX-IND-V1 ó MTX-IND). Además podrá visualizar y modificar la configuración del equipo así como enviar comandos AT remotos (por ejemplo para leer la cobertura de forma remota). También está disponible una pequeña API que le permitirá integrar cómodamente el MTX- Tunnel en sus aplicaciones, pudiendo: 1. Crear un túnel HTTP-RS232 (por ejemplo para que usted pueda crear un formulario WEB y que los datos de una caja de texto sean enviados al MTX-Tunnel y enviados por el puerto serie del mismo hacia el equipo que esté conectado en el módem y viceversa, recibir la respuesta del mismo. 2. Obtener y cambiar cualquier parámetro de configuración del MTX-Tunnel desde su propia aplicación. Su cliente no sabrá que está utilizando un MTX-Tunnel quedando su aplicación totalmente personalizada. 3. Le permitirá crear en minutos una página web para mostrar el estado de las entradas/salidas de sus MTXTunel. Valores posibles. on, off Página 114

115 Valor por defecto: off Notas adicionales. - Se recomienda encarecidamente leer los Escenarios de Ejemplo de este manual para una correcta comprensión de las posibilidades del webserver. Página 115

116 WEBSERVER_login Descripción. Especifica el login para poder acceder al servidor web del MTX-Tunnel Valores posibles. Cadena de texto de longitud máxima 32 caracteres Valor por defecto: (Ninguno) Notas adicionales. - Si especifica un login y password el MTX-Tunnel solicitará dichos parámetros tras la conexión web. Si no se especifica un login y password se accederá directamente al contenido. - Se recomienda el uso de un login y password si el parámetro WEBSERVER_firewall está configurado a off. Página 116

117 WEBSERVER_password Descripción. Especifica el password para poder acceder al servidor web del MTX-Tunnel Valores posibles. Cadena de texto de longitud máxima 32 caracteres Valor por defecto: (Ninguno) Notas adicionales. - Si especifica un login y password el MTX-Tunnel solicitará dichos parámetros tras la conexión web. Si no se especifica un login y password se accederá directamente al contenido. - Se recomienda el uso de un login y password si el parámetro WEBSERVER_firewall está configurado a off. Página 117

118 WEBSERVER_firewall Descripción. Especifica si se debe habilitar o no el firewall para las conexiones al webserver. Si no se habilita el firewall se aceptarán conexiones desde cualquier dirección IP. Si se habilita el firewall únicamente se aceptarán conexiones desde direcciones IP autorizadas (parámetros FIREWALL_IP1, ) Valores posibles. on, off Valor por defecto: on Notas adicionales. - Si configura el firewall a off será altamente recomendado el uso de un login (WEBSERVER_login) y un password (WEBSERVER_password) para impedir accesos no autorizados. Página 118

119 WEBSERVER_port Descripción. Especifica el puerto TCP que usará el MTX-Tunnel para las conexiones Web. Valores posibles Valor por defecto: 80 Notas adicionales. - No debe utilizarse el mismo puerto TCP usados en los parámetros TCP_port y/o TELNET_port Página 119

120 WEBSERVER_skin Descripción. Indica la URL de donde se encuetra el SKIN del webserver del MTX-Tunnel. Es posible personalizar el aspecto del MTX-Tunnel, incluyendo, por ejemplo, el logo de otra empresa. Para ello debe especificarse la URL donde se encuentran todas y cada una de las siguientes imágenes: 1.- header0.gif (858x268). Cabecera mostrada en la pantalla de Login. 2.- header1.gif (858x268). Cabecera mostrada en la sección Status 3.- header2.gif (858x268). Cabecera mostrada en la sección Settings Página 120

121 4.- header3.gif (858x268). Cabecera mostrada en la sección AT Commands 5.- header4.gif (858x268). Cabecera mostrada en la sección Map 6.- header5.gif (858x268). Cabecera mostrada en la sección Reboot 7.- footer.gif (858x55). Pie mostrado en cada página del webserver. 7.- espera.gif (32x32). Gif animado para espera entre carga de páginas. Página 121

122 7.- onbutton.gif (35x42). Salida digital / relé activado. 8.- offbutton.gif (35x42). Salida digital / relé desactivado. Valores posibles. URL de hasta 100 caracteres. Valor por defecto: Ninguno Notas adicionales. - La URL debe acabar con /. Por ejemplo, una URL correcta que puede especificar, sino quiere indicar su propio servidor WEB es: /webserverimg/ Página 122

123 Parámetros de configuración relacionados con el WakeUp: WAKEUP_ En versiones previas a la v5 del MTX-Tunnel, únicamente podía configurarse el túnel GPRS-Serie para estar activo en las siguientes circunstancias: 1.- Activo el 100% del tiempo desde que se enciende el módem 2.- Activo X minutos bajo demanda, para lo que hay que enviar un SMS con el texto mtxtunnel on o realizar una llamada perdida desde un número de teléfono autorizado. A partir de la versión 5.0 se añaden, además de las anteriores, las siguientes posibilidades para activar el túnel GPRS-Serie: 3.- Activo X minutos por detección de cambio en entrada digital 4.- Activo X minutos por detección de entrada analógica fuera de límites 5.- Activo X minutos a una hora determinada (es posible introducir 10 horarios) Adicionalmente, a partir de esta versión 5.0, a diferencia de versiones previas, todos los tipos de túnel (cliente o servidor) pueden activarse mediante una de las 5 opciones anteriores. En versiones previas el MTX-Tunnel, una configuración en modo cliente (MTX_mode: client) obligaba a una configuración activa el 100% del tiempo. Las siguientes páginas muestran en detalle los parámetros de configuración relacionados con las distintas opciones de configuración del MTX-Tunnel. Página 123

124 WAKEUP_gpioEnabled Descripción. Especifica si la conexión GPRS del MTX-Tunnel debe activarse cuando se detecte un cambio en una entrada digital. Es decir, el túnel GPRS-Serie permanecerá inactivo hasta detectarse dicho cambio en la entrada (o haya otro método de wakeup que lo active o se reciba un SMS o una llamada perdida autorizada). Valores posibles. on, off Valor por defecto: off. Notas adicionales - Cada tipo de plataforma tiene asignada una entrada para wakeup. Consulte el Anexo 10 para más información. - Una vez activo el MTX-Tunnel por esta entrada digital de wakeup, éste permanecerá activo durante los minutos especificados en GPRS_timeout. Cuando transcurran GPRS_timeout minutos sin tráfico en el MTX-Tunnel, la sesión GPRS se cerrará hasta una nueva activación por Wakeup. Página 124

125 WAKEUP_gpioValue Descripción. Indica qué valor debe tomar la entrada digital de wakeup para que la sesión GPRS se active X minutos. Valores posibles. 0, 1, 2 Valor por defecto: 0 Notas adicionales. - El MTX-Tunnel debe detectar UN CAMBIO en la entrada digital para su activación. Es decir, si el valor configurado en WAKEUP_gpioValue es 1 debe detectarse un cambio de 0 a 1 para que se active la sesión GPRS del MTX-Tunnel. Si el valor es un 2 un cambio ( 0 ó 1 ) en el GPIO activará la sesión GPRS del MTX- Tunnel. Página 125

126 WAKEUP_adcEnabled Descripción. Especifica si la conexión GPRS del MTX-Tunnel debe activarse cuando se detecte un cambio en una entrada digital. Es decir, el túnel GPRS-Serie permanecerá inactivo hasta detectarse dicho cambio en la entrada (o haya otro método de wakeup que lo active o se reciba un SMS o una llamada perdida autorizada). Valores posibles. on, off Valor por defecto: off Notas adicionales. - Todos los tipos de plataforma usan el ADC1 como entrada de wakeup analógico. - Una vez activo el MTX-Tunnel por esta entrada analógica de wakeup, éste permanecerá activo durante los minutos especificados en GPRS_timeout (sin tráfico GPRS) o si el valor de la entrada analógica sigue fuera de los límites especificados en los parámetros WAKEUP_adcValueMin y WAKEUP_adcValueMax. Página 126

127 WAKEUP_adcValueMin Descripción. Especifica el valor mínimo que el MTX-Tunnel debe leer en la entrada ADC1, por debajo del cual se activará el túnel GPRS-Serie. Valores posibles (mv) Valor por defecto: 0 Notas adicionales. - Recuerde que el MTX-Tunnel permanecerá con la conexión GPRS activa mientras el valor leído por el ADC1 esté por debajo del límite establecido en este parámetro, independientemente del valor configurado en GPRS_timeout Página 127

128 WAKEUP_adcValueMax Descripción. Especifica el valor máximo que el MTX-Tunnel debe leer en la entrada ADC1, por encima de la cual se activará el túnel GPRS-Serie. Valores posibles (mv) Valor por defecto: 2400 Notas adicionales. - Recuerde que el MTX-Tunnel permanecerá con la conexión GPRS activa mientras el valor leído por el ADC1 esté por encima del límite establecido en este parámetro, independientemente del valor configurado en GPRS_timeout Página 128

129 WAKEUP_timeEnabled Descripción. Especifica si la sesión GPRS del MTX-Tunnel (y servicios GPRS asociados: túneles, webserver, telnet, ) deben activarse a una hora determinada. Pueden especificarse hasta un total de 10 horarios distintos. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Una vez activada la sesión GPRS debido a un horario, ésta permanecerá activa durante el tiempo especificado en GPRS_timeout (o mientras haya tráfico GPRS o mientras esté activa otra condición de wakeup, por ejemplo, la entrada ADC1). - Habilitar WAKEUP_timeEnabled implica el USO OBLIGATORIO de un servidor de tiempo. Consulte el parámetro de configuración MTX_TPServer para más información. - La hora utilizada por el módem es HORA UTC (por favor, tenga en cuenta a qué hora UTC corresponde su región. Por ejemplo, en España: UTC+1 ó UTC+2 en verano (Ejemplo, hora UTC 09:00 en Julio en España, corresponde a las 11:00 hora local) Página 129

130 WAKEUP_time1, WAKEUP_time2,, WAKEUP_time10 Descripción. Es posible especificar hasta 10 horarios distintos para que se active la sesión GPRS del MTX-Tunnel (y por tanto los servicios GPRS asociados: túneles, webserver, telnet, ) Valores posibles. DDHHMM Valor por defecto: (donde DD son días, HH horas (24h) y MM (minutos) Ninguno Notas adicionales. - En DD y HH puede establecerse el valor XX, esto indica cualquier valor. Ejemplos de horarios: WAKEUP_time1: (la sesión GPRS se activará cada día 01 del mes, a las 22:00 horas) WAKEUP_time1: WAKEUP_time2: (la sesión GPRS se activará cada día 01 y 15 del mes, a las 10:30 horas) WAKEUP_time1: XX1800 (la sesión GPRS se activará cada día del mes, a las 18:00 horas) WAKEUP_time1: XX0200 WAKEUP_time2: XX1400 (la sesión GPRS se activará cada día del mes, a las 02:00 horas y a las 14:00 horas) WAKEUP_time1: XXXX00 (la sesión GPRS se activará cada día del mes, a cada hora en punto) Página 130

131 - Recuerde que la hora utilizada por el módem es HORA UTC (por favor, tenga en cuenta a qué hora UTC corresponde su país / región. Por ejemplo, en España: UTC+1 ó UTC+2 en verano (Ejemplo, hora UTC 09:00 en Julio en España, corresponde a las 11:00 hora local) Página 131

132 Parámetros de configuración relacionados con la sesión GPRS: GPRS_ Los siguientes parámetros de configuración hacen referencia a la configuración de la sesión GPRS del MTX-Tunnel (o 3G si está usando el nuevo terminal MTX-3G-JAVA). El valor de dichos parámetros deberá proporcionárselos su proveedor de telefonía GSM/GPRS, es decir, dependerá de la tarjeta SIM de telefonía que utilice. GPRS_apn Descripción. Especifica el APN para la conexión GPRS. Debe proporcionarlo el operador GSM Valores posibles. Cadena de texto < 100 caracteres Valor por defecto: movistar.es Notas adicionales. - Algunos ejemplos de APN: Movistar España (IP dinámica): Movistar España (IP fija): Vodafone España (IP dinámica): Vodafone España (IP fija): Orange España (IP dinámica): movistar.es internerestatico.movistar.es airtelnet.es vodafone.es internet - Recuerde que NO todos los operadores de telefonía son apropiados para aplicaciones de telemetría. MTX-Tunnel recomienda, por orden, Vodafone, MoviStar. Operadores como Orange, Simyo o Yoigo usan proxys y suelen bloquean los puertos TCP de entrada y posiblemente no podrá usar el MTX-Tunnel en modo servidor (MTX_mode: server). Si va a utilizar un operador de telefonía distinto de Vodafone o Movistar, y necesita realizar una conexión tipo Server, es decir, que el MTX-Tunnel va a estar a la espera de conexiones entrantes, consulte con su operador de telefonía para que le confirme que no le va a bloquear el tráfico entrante. También consulte con Matrix Electrónica si necesita más información sobre este punto. Página 132

133 GPRS_login Descripción. Especifica el LOGIN para la conexión GPRS. Debe proporcionarlo el operador GSM Valores posibles. Cadena de texto < 32 caracteres Valor por defecto: MOVISTAR Notas adicionales. - Algunos ejemplos de LOGIN: Movistar España (IP dinámica): Movistar España (IP fija): Vodafone España (IP dinámica): Vodafone España (IP fija): Orange España (IP dinámica): MOVISTAR MOVISTAR vodafone vodafone CLIENTE - Recuerde que NO todos los operadores de telefonía son apropiados para aplicaciones de telemetría. MTX-Tunnel recomienda, por orden, Vodafone, Movistar, Orange. Operadores como Simyo o Yoigo usan proxys, es hace que no sea posible usar el MTX- Tunnel en modo servidor (MTX_mode: server). Consulte con su distribuidor de MTX- Tunnel si necesita más información. Página 133

134 GPRS_password Descripción. Especifica el PASSWORD para la conexión GPRS. Debe proporcionarlo el operador GSM Valores posibles. Cadena de texto < 32 caracteres Valor por defecto: MOVISTAR Notas adicionales. - Algunos ejemplos de PASSWORD: Movistar España (IP dinámica): Movistar España (IP fija): Vodafone España (IP dinámica): Vodafone España (IP fija): Orange España (IP dinámica): MOVISTAR MOVISTAR vodafone vodafone AMENA - Recuerde que NO todos los operadores de telefonía son apropiados para aplicaciones de telemetría. MTX-Tunnel recomienda, por orden, Vodafone, Movistar, Orange. Operadores como Simyo o Yoigo usan proxys, es hace que no sea posible usar el MTX- Tunnel en modo servidor (MTX_mode: server). Consulte con su distribuidor de MTX- Tunnel si necesita más información. Página 134

135 GPRS_timeout Descripción. Especifica el tiempo que debe permanecer la sesión GPRS del MTX-Tunnel activa (y servicios GPRS asociados: túneles, webserver, telnet, ) tras una activación (por sms, llamada perdida, cambio en GPIO, valor analógico, hora, ) Valores posibles Valor por defecto: 0 Notas adicionales. - Un valor 0 indica UNA CONEXIÓN PERMANENTE el 100% del tiempo. El módem desde que recibe alimentación mantiene activa la sesión GPRS (y servicios GPRS asociados: túneles, webserver, telnet, ) usando los mecanismos pertinentes pasa asegurar la conectividad en todo momento - Un valor >0 especifica los minutos que debe permanecer la sesión GPRS activa una vez activada (por un sms, llamada perdida, GPIO, ). Esto es válido únicamente para las plataformas MTX excepto los modelos ULP. En estos modelos Ultra Low Power el parámetro GPRS_timeout no indica minutos, sino segundos. La razón, el consumo. Página 135

136 GPRS_autoTimeout Descripción. Parámetro introducido en la versión MTX-Tunnel v7.15. Únicamente útil cuando el parámetro GPRS_timeout > 0. Permite reiniciar el contador de tiempo de sesión GPRS cada vez que se reciben/envían datos GPRS. Valores posibles. on, off Valor por defecto: on Notas adicionales. - Ejemplo: Si el parámetro GPRS_timeout = 2, implica que cuando se active la sesión GPRS (por ejemplo para establecer una pasarela GPRS-Serie contra un servidor) lo hará durante 2 minutos. Si el parámetro GPRS_autoTimeout = on, cada vez que se reciben datos por la pasarela GPRS el contador de fin de sesión GPRS se reiniciará a 2 minutos, esto es, deben transcurrir 2 minutos sin tráfico GPRS para que la sesión se cierre. Si GPRS_autoTimeout = off, una vez iniciada la sesión GPRS, a los 2 minutos, independientemente de si ha habido tráfico GPRS o no, se cerrará la sesión. - Muy útil para escenarios de bajo consumo, especialmente con el terminal MTX-65i-ULP. Página 136

137 GPRS_dns Descripción. Especifica un servidor de DNS público. Valores posibles. Una dirección IP del tipo XXX.XXX.XXX.XXX Valor por defecto: (DNS de Google) Notas adicionales. - Indicar una DNS será necesario si se utiliza en algún momento una DNS en lugar de una IP (en el parámetro TCP_IP, MTX_TPServer, ) Página 137

138 GPRS_auto Descripción. Indica al MTX-Tunnel que debe usar un APN, Login y Password automáticos en función de la tarjeta SIM introducida. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Parámetro disponible desde la versión MTX-Tunnel v5.7 - Cuando el parámetro GPRS_auto está a on el MTX-Tunnel no tiene en cuenta los parámetros GPRS_apn, GPRS_login y GPRS_password. - Si se especifica el parámetro GPRS_auto a on debe añadirse al MTX-Tunnel un nuevo archivo de configuración de nombre operators.txt. Este fichero debe tener la siguiente estructura: IDOperador1,apn,login,password,nombre_descriptivo[ENTER] IDOperador2,apn,login,password,nombre_descriptivo[ENTER] Ejemplo REAL del fichero operators.txt: 21407:movistar.es,MOVISTAR,MOVISTAR,Movistar 21401:airtelnet.es,vodafone,vodafone,Vodafone 21403:internet,CLIENTE,AMENA,Orange 21404:internet,,Yoigo - Cuando el parámetro GPRS_auto está a on el MTX-Tunnel lo primero que hace el leer de la tarjeta SIM el código de operador (IDOperador) y los buscará dentro del fichero operators.txt. Una vez encontrado cogerá el apn, login y password adecuados del operador. - Este parámetro puede resultar muy útil si el MTX-Tunnel es entregado a terceras personas sin tener certeza del operador de la tarjeta SIM que va a ser usada. También permite poder cambiar en cualquier momento la tarjeta SIM del equipo (por ejemplo para tener una mejor tarifa) SIN NECESIDAD DE MODIFICAR EL FICHERO DE CONFIGURACIÓN config.txt. Página 138

139 Parámetros de configuración relacionados con TCP: TCP_ Los siguientes parámetros de configuración son referentes a la configuración del MTX-Tunnel cuando debe enviar y recibir lo datos mediante el protocolo TCP, o lo que es lo mismo, cuando se debe configurar un túnel GPRS (TCP) Serie (RS232/485), ya sea una configuración TCP cliente (MTX_mode: client) o TCP servidor (MTX_mode: server). TCP_IP Descripción. Especifica la dirección IP a la que el MTX-Tunnel se conectará cuando éste esté configurado como Cliente (MTX_mode: client). Valores posibles. Una dirección IP del tipo XXX.XXX.XXX.XXX ó una DNS Valor por defecto: Ninguna Notas adicionales. - Este parámetro también será utilizado en el caso de que el MTX-Tunnel esté configurado como Servidor (MTX_mode: server) y el parámetro MTX_temporalClient a on. Esta IP ó DNS será la utilizada por el cliente temporal para realizar la conexión. Consulte la documentación del parámetro MTX_temporalClient para más información. Página 139

140 TCP_port Descripción. Específica el puerto TCP a la que el MTX-Tunnel se conectará cuando éste esté configurado como Cliente (MTX_mode: client). Si está configurado como Servidor (MTX_mode: server) este parámetro indicará el puerto TCP de escucha del MTX-Tunnel, donde recibirá las conexiones entrantes. Valores posibles Valor por defecto: Notas adicionales. - Este parámetro también será utilizado en el caso de que el MTX-Tunnel esté configurado como Servidor (MTX_mode: server) y el parámetro MTX_temporalClient a on. Este puerto TCP será el utilizado por el cliente temporal para realizar la conexión con un equipo remoto. Consulte la documentación del parámetro MTX_temporalClient para más información. Página 140

141 TCP_IP2 Descripción. Parámetro disponible únicamente a partir del MTX-Tunnelv7.8 En el caso de que el módem está configurado como client (MTX_mode: client) y que la conexión sea de tipo permanente (GPRS_timeout: 0) indicando una dirección IP en este parámetro le permitirá establecer una segunda pasarela GPRS-Serie. Es decir, por un lado tendrá la pasarela GPRS-Serie asociada al puerto COM1 del módem y por otro lado esta nueva pasarela asociada al puerto serie COM2 del módem Valores posibles. Una dirección IP del tipo XXX.XXX.XXX.XXX ó una DNS Valor por defecto: Ninguna Notas adicionales. - Este parámetro únicamente se puede utilizar con aquellos módems que cuenten con dos puertos serie, lo que implica que no puede utilizarse con los módems MTX que dispongan de un único puerto serie. Página 141

142 TCP_port2 Descripción. Parámetro disponible únicamente a partir del MTX-Tunnelv7.8 En el caso de que el módem está configurado como client (MTX_mode: client), que la conexión sea de tipo permanente (GPRS_timeout: 0) y que haya indicado una dirección IP en TCP_IP2, este parámetro le permitirá especificar el puerto TCP de conexión. Es decir, por un lado tendrá la pasarela GPRS-Serie asociada al puerto COM1 del módem y por otro lado esta nueva pasarela asociada al puerto serie COM2 del módem Valores posibles Valor por defecto: Notas adicionales. - Este parámetro únicamente se puede utilizar con aquellos módems que cuenten con dos puertos serie, lo que implica que no puede utilizarse con los módems MTX que dispongan de un único puerto serie. Página 142

143 Parámetros de configuración relacionados con UDP: UDP_ Los siguientes parámetros de configuración son referentes a la configuración del MTX-Tunnel cuando debe enviar y recibir lo datos mediante el protocolo UDP, o lo que es lo mismo, cuando se debe configurar un túnel GPRS (UDP) Serie (RS232/485) UDP_IP Descripción. Especifica la dirección IP a la que el MTX-Tunnel enviará los datos mediante el protocolo UDP cuando el MTX-Tunnel esté configurado como UDP (MTX_mode: udp). Valores posibles. Una dirección IP del tipo XXX.XXX.XXX.XXX ó una DNS Valor por defecto: Ninguna Notas adicionales. - UDP sólo es recomendado como protocolo de comunicación para aquellas aplicaciones con gran cantidad de dispositivos que deben comunicar contra un servidor, debido a que no es un protocolo orientado a conexión. - Desde la versión 7.17 del MTX-Tunnel es posible especificar hasta 5 direcciones IP para enviar / recibir los datos UDP, para ello basta con separar las direcciones IP por,. Por ejemplo: UDP_IP: , , Página 143

144 UDP_localPort Descripción. Especifica el puerto UDP desde el que el MTX-Tunnel enviará los datos serie cuando esté configurado en modo UDP (MTX_mode: udp). Valores posibles Valor por defecto: Notas adicionales. - UDP sólo es recomendado como protocolo de comunicación para aquellas aplicaciones con gran cantidad de dispositivos que deben comunicar contra un servidor, debido a que no es un protocolo orientado a conexión. Página 144

145 UDP_remotePort Descripción. Especifica el puerto UDP del dispositivo remoto hacia el que el MTX-Tunnel enviará los datos serie cuando esté configurado en modo UDP (MTX_mode: udp). Valores posibles Valor por defecto: Notas adicionales. - UDP sólo es recomendado como protocolo de comunicación para aquellas aplicaciones con gran cantidad de dispositivos que deben comunicar contra un servidor, debido a que no es un protocolo orientado a conexión. Página 145

146 Parámetros de configuración relacionados con ALARMAS: ALARM_ El MTX-Tunnel permite el envío de mensajes SMS de alarma ante cambios de una entrada digital. Los siguientes parámetros de configuración hacen referencia a esta característica. ALARM_gpioEnabled Descripción. Especifica si debe activarse el sistema de alarmas SMS por cambio de entrada digital del MTX-Tunnel. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Cada tipo de plataforma tiene asignada una entrada específica para alarma SMS. Estas son las asignadas en función del tipo de plataforma donde está instalado el MTX-Tunnel: - Consulte el anexo 10 para averiguar el GPIO que debe utilizar del conector del terminal para la función de alarma Página 146

147 ALARM_gpioValue Descripción. Especifica si la alarma salta cuando el valor del pin GPIO específico es 0 ó 1 Valores posibles. 0, 1 Valor por defecto: 0 Notas adicionales. - La alarma funciona por flanco, es decir, si se especifica un 1 la alarma saltará cuando el MTX-Tunnel detecte una transición de 0 a 1. Si en el parámetro se especifica un 0 la alarma saltará cuando el MTX-Tunnel detecte una transición de 1 a 0. Página 147

148 ALARM_gpioMessage, ALARM_gpioMessage1 Descripción. Indica el texto del mensaje de alarma que se enviará mediante un SMS ante un cambio de una entrada digital. El parámetro ALARM_gpioMessage es el mensaje de texto enviado cuando la entrada digital asociada cambia de 1 a 0. El parámetro ALARM_gpioMessage1 es el mensaje de texto enviado cuando la entrada digital asociada cambia de 0 a 1. Valores posibles. Un texto inferior a 160 caracteres. Valor por defecto: Alarm Notas adicionales. - El Texto más largo que se puede introducir son 160 caracteres, que es la longitud máxima de un mensaje SMS de texto. Página 148

149 ALARM_gpioPause Descripción. Este parámetro evita que en caso de producirse constantes cambios de estado en el PIN de alarma del MTX-Tunnel se envíen continuamente mensajes SMS. El MTX-Tunnel sólo permitirá el envío de un único bloque de mensajes SMS de alarma durante los segundos especificados en este parámetro. Valores posibles (1 día) Valor por defecto: 60 (1 minuto) Notas adicionales. Página 149

150 ALARM_smsNumber1, ALARM_smsNumber2,, ALARM_smsNumber10 Descripción. Indica los números de teléfonos a los que se enviará el mensaje SMS en caso de producirse una alarma. Valores posibles. Un número de teléfono válido Valor por defecto: Ninguno Notas adicionales. - Los únicos caracteres válidos para introducir un número de teléfono son el carácter + y los caracteres 0 9. Página 150

151 ALARM_powerEnabled Descripción. Especifica si la alarma SMS salta cuando se detecta un fallo en el sistema de alimentación o cuando éste vuelve a la normalidad Valores posibles. on, off Valor por defecto: off Notas adicionales. - Este parámetro únicamente funcionará correctamente con los equipos MTX que cuenten con batería interna. Página 151

152 ALARM_powerMessageOn, ALARM_powerMessageOff Descripción. Indica el texto del mensaje de alarma que se enviará mediante un SMS ante un cambio dedectado en el sistema de alimentación. Puede especificarse el mensaje para pérdida de alimentación y el mensaje para retorno de alimentación. Valores posibles. Un texto inferior a 160 caracteres. Valor por defecto: Power On y Power Off Notas adicionales. - El Texto más largo que se puede introducir son 160 caracteres, que es la longitud máxima de un mensaje SMS de texto. - Estos parámetros únicamente funcionarán correctamente con los equipos MTX-65-GPS- BAT-V5, MTX-65i-GPS-V6 y MTX-3G-JAVA-BAT Página 152

153 Parámetros de configuración relacionados con FIREWALL: FIREWALL_ El MTX-Tunnel, por defecto, permite el acceso desde cualquier dirección IP. Si se necesita incrementar la seguridad del sistema para evitar accesos no autorizados al módem puede habilitarse el firewall proporcionado. Habilitando el firewall únicamente podrá accederse a los servicios del MTX-Tunnel (túnel, webserver, telnet, ) desde las direcciones IP autorizadas. FIREWALL_enabled Descripción. Especifica si debe activarse el firewall para permitir el acceso a los recursos del MTX- Tunnel únicamente desde direcciones IP determinadas Valores posibles. on, off Valor por defecto: on Notas adicionales. - El firewall evitará el acceso no autorizado a los servicios de tunneling del MTX-Tunnel, no obstante, para que los servicios WebServer y Telnet usen también el firewall, deben especificarse a on los parámetros WEBSERVER_firewall y TELNET_firewall Página 153

154 FIREWALL_IP1, FIREWALL_IP2,, FIREWALL_IP10 Descripción. Especifica las direcciones IP autorizadas en caso del que el firewall esté habilitado (FIREWALL_enabled: on). Valores posibles. Dirección IP del tipo XXX.XXX.XXX.XXX Valor por defecto: Ninguno Notas adicionales. - Puede especificar hasta 10 direcciones IP autorizadas. Página 154

155 Parámetros de configuración relacionados con SMS: SMS_ El MTX-Tunnel dispone de multitud de características interesantes donde interviene la mensajería SMS. Los siguientes parámetros de configuración hacen referencia a ello. SMS_sendIP Descripción. Especifica si cuando el MTX-Tunnel recibe un mensaje SMS con el texto mtxtunnel on o se recibe una llamada perdida, además de iniciar la sesión GPRS y por tanto activarse los servicios asociados (túnel, webserver, telnet, ) el MTX-Tunnel debe informar de la IP obtenida del operador devolviendo un SMS. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Si el parámetro está a on y la sesión GPRS ya estaba establecida, por ejemplo, porque la conexión es permanente, el MTX-Tunnel también devolverá la dirección IP actual al remitente. - Únicamente obtendrán respuesta los números de teléfono autorizados si el parámetro SMS_allPhones está establecido a off. Página 155

156 SMS_ATEnabled Descripción. Especifica si es posible ejecutar un comando AT enviado desde un teléfono móvil. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Si el parámetro está a on un SMS será interpretado como un comando AT (para ser ejecutado) siempre que el mensaje esté encabezado por el texto MTXTUNNEL AT ó mtxtunnel at. Por ejemplo, para conocer la cobertura remota habría que enviar un SMS con el texto MTXTUNNEL AT+CSQ. - Únicamente podrán ejecutar comandos AT los números de teléfono autorizados si el parámetro SMS_allPhones está establecido a off. Página 156

157 SMS_ATResponse Descripción. Cuando se recibe un SMS en el MTX-Tunnel y se ejecuta, este parámetro indicará si se debe enviar un SMS de vuelta con la respuesta o no. Valores posibles. on, off Valor por defecto: off Notas adicionales. - En caso de ejecutar un comando túnel SMS-RS232/485 (véase parámetro SMS_tunnelString) para enviar un texto recibido por SMS por el puerto serie hacia un dispositivo X, el MTX-Tunnel esperará hasta 5 segundos a recibir la respuesta de dicho dispositivo X antes de enviar un SMS con la respuesta. Página 157

158 SMS_allPhones Descripción. Indica si todos los números de teléfono son autorizados o no para activar la sesión GPRS del MTX-Tunnel (y por tanto servicios asociados: túnel gprs-serie, webserver, telnet, ) enviando un SMS con texto mtxtunnel on o realizando una llamada perdida o ejecutar comandos AT por SMS. Valores posibles. on, off Valor por defecto: off Notas adicionales. - El parámetro a on implicará que todos los números de teléfono anónimos están autorizados. A off implicará que sólo un grupo de números de teléfono son autorizados. Página 158

159 SMS_validPhone1, SMS_validPhone2,, SMS_validPhone10 Descripción. En caso de estar el parámetro SMS_allPhones a off, estos parámetros indicarán los números de teléfono autorizados, hasta un total de 10. Valores posibles. Un número de teléfono válido Valor por defecto: Ninguno Notas adicionales. - Los únicos caracteres válidos para introducir un número de teléfono son el carácter + y los caracteres 0 9. Página 159

160 SMS_alias1, SMS_alias2,, SMS_alias10 Descripción. Los parámetros de de configuración anteriores muestran cómo se puede enviar comandos AT por SMS para que sean ejecutados por el MTX-Tunnel. Sin embargo, en ocasiones, puede resultar incómodo enviar un SMS con el texto AT^SSIO=0,0 para conmutar un relé, especialmente si el MTX-Tunnel forma parte de un sistema para un tercero. Es posible establecer hasta 10 alias para la ejecución de comandos AT. Siguiendo el ejemplo anterior, se podría establecer un alias: Rele1on>AT^SISO=0,0. Con ello, un SMS recibido por el MTX-Tunnel con el texto Rele1on sería interpretado como el comando AT^SISO=0,0 Valores posibles. Una cadena máximo de 64 caracteres Valor por defecto: Ninguno Notas adicionales. - La cadena siempre debe contener el carácter >, que es el separador entre el alias y su comando AT correspondiente. Página 160

161 SMS_aliasOk Descripción. El parámetro SMS_ATResponse permitía configurar al MTX-Tunnel para devolver un SMS con la respuesta de un comando AT que hubiese sido recibido por SMS. Este parámetro permite substituir la respuesta proporcionada por el módem al comando AT por un texto de usuario cuando el comando AT se ejecutó correctamente. Valores posibles. Una cadena máximo de 100 caracteres Valor por defecto: Ninguno Notas adicionales. - Si el parámetro SMS_aliasOk tiene una longitud mayor de 0 caracteres, se enviará dicho parámetro por SMS como respuesta a un comando AT en lugar del resultado técnico del comando AT devuelto por el módem. Página 161

162 SMS_aliasError Descripción. El parámetro SMS_ATResponse permitía configurar al MTX-Tunnel para devolver un SMS con la respuesta de un comando AT que hubiese sido recibido por SMS. Este parámetro permite substituir la respuesta proporcionada por el módem al comando AT por un texto de usuario cuando el comando AT no se ejecutó correctamente. Valores posibles. Una cadena máximo de 100 caracteres Valor por defecto: Ninguno Notas adicionales. - Si el parámetro SMS_aliasError tiene una longitud mayor de 0 caracteres, se enviará dicho parámetro por SMS como respuesta a un comando AT (con error) en lugar del resultado técnico del comando AT devuelto por el módem. Página 162

163 SMS_tunnelString Descripción. El parámetro SMS_tunnelString permite definir una cabecera especial para que el MTX- Tunnel interprete que el texto recibido es para enviar directamente por el puerto COM1 del módem. Ejemplo: Si el parámetro SMS_tunnelString tiene el valor MTX, un mensaje recibido por SMS con un texto como MTX+[espacio] haría que el MTX-Tunnel envíe por su puerto serie la cadena Esto permite implementar de forma muy simple un túnel SMS-Serie RS232/485. Valores posibles. Una cadena máximo de 16 caracteres Valor por defecto: Ninguno Notas adicionales. - El SMS enviado siempre tiene que tener un espacio entre la cadena establecida en el parámetro SMS_tunnelString y la cadena a enviar por el puerto serie COM1. - En el caso de estar configurado el parámetro SMS_responseAT a on, una vez el MTX- Tunnel envíe por el puerto serie COM1 la cadena recibida esperará hasta 5 segundos para recibir respuesta por el puerto serie del dispositivo conectado al COM1. Dicha respuesta será enviada como respuesta al SMS recibido. - Las respuestas deben tener una cadena inferior a los 160 caracteres. Una cadena de mayor tamaño será truncada a ese tamaño. Página 163

164 SMS_urc Descripción. Parámetro disponible desde la versión MTX-Tunnel v7.15 Un valor a on hará que, cada vez que se reciba un mensaje SMS, el módem envíe un URC por el puerto serie indicando la recepción del SMS. Valores posibles. on, off Valor por defecto: off Notas adicionales. - El formato del URC es: ^MTX_SMS[espacio]numeroTelefono,mensajeDeTexto - Puede resultar muy útil si además de usar una pasarela serie-gprs quiere poder recibir en modo RAW un SMS enviado desde un teléfono móvil Página 164

165 SMS_header Descripción. Parámetro disponible desde la versión MTX-Tunnel v7.17 Hasta la versión v7.16 del MTX-Tunnel, todos los comandos AT enviados por SMS debían ir precedidos por la key mtxtunnel. Por ejemplo, para enviar el comando AT para averiguar la cobertura remota era necesario enviar un SMS con el texto mtxtunnel at+csq. O para averiguar la IP actual del módem, había que enviar un SMS con el texto mtxtunnel on Ahora es posible personalizar esta key. Valores posibles. Un texto de hasta 16 caracteres Un valor none hará que no sea necesario introducir ninguna cabecera en los SMS Valor por defecto: mtxtunnel (por compatibilidad con versiones anteriores) Notas adicionales. - Es siempre recomendable el uso de una cabecera adicional, especialmente si cualquier número de teléfono está autorizado para el envío de comandos por SMS Página 165

166 SMS_replaceText Descripción. Este parámetro permite reemplazar una cadena recibida en un mensaje SMS por otra cadena diferente. Es decir, por ejemplo, podría hacerse que si en un SMS se incluye el texto con los caracteres XX, éste se substituya por ejemplo. Valores posibles. textoareemplazar;textodereemplazo Valor por defecto: ninguno Notas adicionales. - Puede resultarle útil si necesita enviar caracteres especiales - Un ejemplo de configuración de parámetro puede ser SMS_replaceText: XX,@12345 (textos separados por punto y coma) Página 166

167 Parámetros de configuración relacionados con DynDNS: DYNDNS_ Los parámetros con prefijo DYNDNS_ hacen referencia al servicio DynDNS soportado a partir de la versión MTX-Tunnel 5.0. El servicio de DynDNS permite asignar a una DNS una dirección IP dinámica, de esa manera una DNS del tipo mimodem.dyndns.org siempre apuntará a la dirección IP asignada en cada momento por el operador. El MTX-Tunnel detecta automáticamente cualquier cambio de dirección IP refrescando automáticamente la DNS en el servidor de DynDNS. Puede obtener una cuenta gratuita de DynDNS y una mayor información acudiendo a la web del prestador del servicio en DYNDNS_enabled Descripción. Especifica si el módem debe usar o no el servicio DynDNS. En caso afirmativo, cada vez que el módem active una sesión GPRS automáticamente se actualizará la nueva IP en el servidor de DynDNS, de la mima manera que ocurrirá si se detecta cualquier cambio en la dirección IP proporcionada por el operador. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Para abrir una cuenta gratuita DynDNS debe darse de alta en la empresa prestadora del servicio en - El servicio DynDNS es recomendable cuando se utilice una tarjeta SIM con dirección IP dinámica, careciendo de sentido su uso si la tarjeta SIM está provisonada con una dirección IP estática. - El servicio DynDNS es recomendable cuando se utilicen los servicios del MTX-Tunnel que implican un socket server (túnel server, Webserver, Telnet), es decir, cuando las conexiones se realizan desde un servidor o equipo HACIA el MTX. En cambio DynDNS Página 167

168 carece de sentido cuando el MTX-Tunnel esté configurado como cliente, es decir, cuando las conexiones se realizan DESDE el MTX hacia un servidor o equipo remoto Página 168

169 DYNDNS_server Descripción. Especifica el servidor DynDNS especificado por el proveedor del servicio. Valores posibles. Cadena de máximo 128 caracteres Valor por defecto: Ninguno Notas adicionales. - Si abre una cuenta en normalmente el servidor DynDNS es algo como members.dyndns.org Página 169

170 DYNDNS_hostname Descripción. Especifica el nombre de la DNS creado en el proveedor del servicio DynDNS. Valores posibles. Cadena de máximo 128 caracteres Valor por defecto: Ninguno Notas adicionales. - Por ejemplo, puede ser algo como MiModem.dyndns.org Página 170

171 DYNDNS_login Descripción. Especifica el Login de su cuenta DynDNS Valores posibles. Cadena de máximo 32 caracteres Valor por defecto: Ninguno Notas adicionales. Página 171

172 DYNDNS_password Descripción. Especifica el Password de su cuenta DynDNS Valores posibles. Cadena de máximo 32 caracteres Valor por defecto: Ninguno Notas adicionales. Página 172

173 DYNDNS_period Descripción. La cadena DNS se envía siempre que el MTX-Tunnel cambia de IP, pero también puede definirse un tiempo para forzar el envío de dicha cadena. Esto es útil porque implica mayor seguridad en la indicación del cambio de IP. Valores posibles. 0, Valor por defecto: 0 Notas adicionales. Un valor 0 quiere decir que NO se actualizará DynDNS de forma periódica sino sólo cuando el equipo cambia de IP. - El tiempo indicado en valor está expresado en segundos. - Se recomienda su uso para evitar ciertas situaciones: si los servidores de DynDNS se cayeran y perdieran, por el motivo que sea, la dirección actual IP del equipo, si este parámetro DYNDNS_period no está activo el MTX-Tunnel no actualizará de nuevo el servidor de DynDNS hasta que cambie de dirección IP, no estando activo DynDNS hasta ese momento. Página 173

174 Parámetros de configuración relacionados con DNS: DNS_ En la sección anterior se mostró la característica DynDNS soportada por el MTX-Tunnel. DynDNS resulta muy útil en aplicaciones con tarjetas SIMs con dirección IP dinámica, pero resulta engorroso de usar y mantener cuando hay un número elevado de dispositivos a controlar. Además, DynDNS obliga a usar su propio servidor, por lo que se pierde el control sobre posibles caídas de dicho servidor. Los parámetros descritos a continuación resultarán interesantes para aplicaciones en las que sea necesario contar con un servidor propio para recoger los cambios de las direcciones IP que obtengan en cada momento los MTX-Tunnel. En pocas palabras, el uso de los siguientes parámetros de configuración hará que cada vez que un módem MTX-Tunnel cambie de dirección IP (ó cada DNS_period segundos), éste informe a un servidor alojado en su empresa de la nueva dirección IP, teniendo pues el control de la totalidad del sistema en todo momento. DNS_enabled Descripción. Especifica si el módem debe usar o no el servicio DNS. En caso afirmativo, cada vez que el módem active una sesión GPRS automáticamente se actualizará la nueva IP en el servidor DNS especificado (cuya ubicación puede ser un servidor de su propia empresa), de la mima manera que ocurrirá si se detecta cualquier cambio en la dirección IP proporcionada por el operador. Valores posibles. on, off Valor por defecto: off Notas adicionales. - El uso de DNS es recomendable cuando se utilice una tarjeta SIM con dirección IP dinámica, careciendo de sentido su uso si la tarjeta SIM está provisonada con una dirección IP estática. - El servicio DNS es recomendable cuando se utilicen los servicios del MTX-Tunnel que implican un socket server (túnel server, Webserver, Telnet), es decir, cuando las conexiones se realizan desde un servidor o equipo HACIA el MTX. En cambio DNS carece de sentido cuando el MTX-Tunnel esté configurado como cliente, es decir, cuando las conexiones se realizan DESDE el MTX hacia un servidor o equipo remoto. Página 174

175 DNS_mode Descripción. Indica el modo en el que el MTX-Tunnel informará a un servidor sobre su nueva dirección IP. El MTX-Tunnel permite el volcado de información a un servidor mediante el establecimiento de un socket o bien a un servidor Web Valores posibles. socket, http, remoteat Valor por defecto: socket Notas adicionales. - Si usted pretende implementar y compilar un programa para la gestión dinámica de las IPs, la opción recomendada es socket. - Si usted pretende usar los recursos que ya dispone en un servidor web (ASP ó PHP), para el paso de la nueva dirección IP del MTX-Tunnel, la opción recomendada es http Para el valor remoteat, nuevo desde la versión MTX-Tunnelv7.8, consulte el ejemplo de los Anexos 2.16 Página 175

176 DNS_password Descripción. Con el fin de incrementar la seguridad, es posible establecer un password. Cada vez que el MTX-Tunnel informe sobre su dirección IP enviará su DNS_password para que el servidor destino tome las acciones oportunas. Valores posibles. Cadena de texto de menos de 64 caracteres Valor por defecto: Ninguno Notas adicionales. - El parámetro DNS_password se enviará tanto si se usa el modo socket como si se usa el modo http. Página 176

177 DNS_server Descripción. En caso de usar el modo socket (DNS_mode: socket) indica la dirección IP (o DNS) del servidor al cual enviar la información sobre la nueva dirección IP. En caso de usar el modo http (DNS_mode: http) indica la URL (dominio + página web) del servidor web al cual se le pasará la información sobre la nueva dirección IP Valores posibles. Cadena inferior a 255 caracteres Valor por defecto: Ninguno Notas adicionales. - Si pretende usar el modo DNS_mode: http, recuerde que en DNS_server debe indicar la URL completa, sin Por ejemplo: DNS_server: - La cadena que el MTX-Tunnel enviará a un servidor en modo socket será: #IMEI#DNS_password#IPPublica# - La cadena que el MTX-Tunnel enviará a un servidor en modo http será: URL?IMEI=<suIMEI>&PASS=<DNS_password>&IP=<IP Pública> Si utiliza páginas ASP un método muy sencillo de recoger esta información es: <% IMEI=Request.QueryString( IMEI ) Password=Request.QueryString( PASS ) IP=Request.QueryString( IP ) %> Página 177

178 DNS_port Descripción. Indica el puerto a usar en caso de utilizar un modo socket (DNS_mode: socket) Valores posibles Valor por defecto: Notas adicionales. - Este parámetro es única y exclusivamente para usar con el modo socket. Si se usa el modo http y no se utiliza el puerto standard http 80, deberá incluirlo en el parámetro DNS_server. Por ejemplo, si el puerto a utilizar es el 20011, el parámetro DNS_server tendría que especificarse de la siguiente manera: Página 178

179 DNS_extended Descripción. Con el servicio DNS activo (DNS_enabled: on) el MTX-Tunnel envía el IMEI, un password identificativo y la dirección IP cada vez que la dirección IP cambia. Sin embargo es posible añadir más información, como son es estado de las entradas/salidas digitales, que puede resultar muy interesante para aplicaciones de telemetría. Para el envío de información adicional el parámetro DNS_extended debe establecerse a on. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Cuando el parámetro DNS_extended está a on y se usa un DNS_mode como socket, la información enviara al servidor será: #IMEI#DNS_password#IPPublica#gpio1#gpio2#gpio3#gpio4#gpio5#gpio6#gpio7# gpio8#gpio9#gpio10#adc1#adc2#<gpslocation># Estando en azul la información adicional extendida, siendo gpiox el estado de la entrada/salida digital X (0 ó 1) y ADCX el valor del conversor analógico/digital X. En caso de utilizar la plataforma MTX con GPS se incluye también información sobre la localización GPS, indicada en el ejemplo en naranja. - Cuando el parámetro DNS_extended está a on y se usa un DNS_mode como http, la información enviara al servidor será: URL?IMEI=<suIMEI>&PASS=<DNS_password>&IP=<IP Pública> &GPIO1=X &GPIO2=X &GPIO3=X &GPIO4=X &GPIO5=X &GPIO6=X &GPIO7=X &GPIO8=X &GPIO9=X &GPIO10=X &ADC1=X&ADC2=X&GPS=<gpsLocation> Página 179

180 Estando en azul la información adicional extendida, siendo GPIOX el estado de la entrada/salida digital X (0 ó 1) y ADCX el valor del conversor analógico/digital X. En caso de utilizar una plataforma MTX con GPS se incluye también información sobre la localización GPS, indicada en el ejemplo en naranja. Página 180

181 DNS_gpios Descripción. Este parámetro permite enviar la trama DNS (incluyendo el estado de las entradas digitales y analógicas si DNS_extended está a on ) cuando el equipo detecta un cambio en una entrada digital. Valores posibles. on, off Valor por defecto: off Notas adicionales. - Cuando se detecte un cambio en una entrada digital, el MTX-Tunnel hará una lectura de todas las entradas digitales y analógicas en ese momento y enviará la cadena DNS. Eso significa que NO SIEMPRE se va a enviar una trama DNS por cada vez que cambia una entrada digital, es decir, puede ocurrir que 3 entradas digitales cambien de estado simultáneamente y sólo se envíe una trama DNS. Es decir, el MTX-Tunnel va a enviar siempre una trama con el último estado tras un cambio de una entrada digital, sea el cambio de una entrada o de varias. - Parámetro disponible a partir del MTX-Tunnel v5.3 Página 181

182 DNS_adc1, DNS_adc2 Descripción. Estos parámetros permiten enviar la trama DNS (incluyendo el estado de las entradas digitales y analógicas si DNS_extended está a on ) cuando el equipo detecta una entrada analógica por encima o por debajo de un umbral. Valores posibles. 0, Valor por defecto: 0 Notas adicionales. Un valor 0 quiere decir que NO se enviará la cadena DNS por una lectura de ADC - Si DNS_adcX >=250, cuando se detecte un cambio en una entrada analógica por encima o por debajo del valor establecido +-250mV, se enviará la trama DNS. Ejemplo: DNS_adc1: 1200 implica que cuando DNS_adc1 > 1200mV + 250mV se enviará una trama DNS y cuando DNS_adc2 < 1200mV 250mV se enviará una trama DNS. - Parámetro disponible a partir del MTX-Tunnel v5.3 Página 182

183 DNS_period Descripción. La cadena DNS se envía siempre que el MTX-Tunnel cambia de IP, pero también puede definirse un tiempo para forzar el envío de dicha cadena. Esto es útil por dos motivos: mayor seguridad en la indicación del cambio de IP y permite establecer una cadencia para el envío de telemetrías si el parámetro DNS_extended está a on. Valores posibles. 0, Valor por defecto: 0 Notas adicionales. Un valor 0 quiere decir que NO se enviará la cadena DNS de forma periódica. - El tiempo indicado en valor está expresado en segundos. Página 183

184 DNS_httpMode Descripción. Permite seleccionar, en el caso de usar el modo http en DNS_mode, el tipo de comunicación que se realizará contra una plataforma web. Podrá escogerse get o json Valores posibles. get, json Valor por defecto: get Notas adicionales. Parámetro disponible desde la versión MTX-Tunnel Hasta esta versión la única opción posible era get. - Si utiliza el modo json la trama de datos que recibirá será la del siguiente ejemplo: {"IMEI": ,"P":"ID001","IP":" ","CSQ":20," VER":"8.10", "AUX":"","MOD":1} Donde: IMEI: identificativo interno del MTX P: Password definido en el parámetro DNS_password IP: IP actual del MTX CSQ: Cobertura gsm del MTX (0 31) VER: Versión de firmware del MTX-Tunnel AUX: Reservado MOD: modelo terminal MTX (1: MTX-65i, 2: MTX-IND-V1, 3: MTX-IND, 4: MTX-65-GPS-V3, 5: MTX-65-GPS- BAT-V5, 6: MTX-65-GPS-V6, 7:MTX-65-GPS-BAT-V7, 8: MTX-65i-ULP, 9: MTX-65i-RS485, 10: MTX-3G-JAVA, 11: MTX-3G-JAVA-BAT, 12: MTX-3G-JAVA-GPS, 13: MTX-3G-JAVA-ULP, 14: MTX-3G-JAVA-ULP-GPS, 15:MTX-IND-3G-JAVA ) - En caso de utilizar la opción DNS_extendes a on también recibiría las E/S digitales, los ADs y la posición GPS, si el terminal lo soporta (Variables: IO1, IO2, IO10, AD1, AD2, GPS) Página 184

185 DNS_serverLogin Descripción. Permite establecer el login (nombre de usuario) que debe usar el MTX-Tunnel para en envío de datos a una Plataforma Web que cuente con un sistema de autenticación basado en Login y Password. Valores posibles. Cadena hasta 64 caracteres Valor por defecto: Ninguno Notas adicionales.. - Si su plataforma web no usa un sistema de autenticación simple basado en Login y Password no es necesario que incluya este parámetro en el fichero de configuración. Sólo es obligatorio su uso en plataformas web que usen mecanismos de autenticación. - Este parámetro está disponible desde la versión MTX-Tunnel 8.10 Página 185

186 DNS_serverPassword Descripción. Permite establecer el password que debe usar el MTX-Tunnel para en envío de datos a una Plataforma Web que cuente con un sistema de autenticación basado en Login y Password. Valores posibles. Cadena hasta 64 caracteres Valor por defecto: Ninguno Notas adicionales.. - Si su plataforma web no usa un sistema de autenticación simple basado en Login y Password no es necesario que incluya este parámetro en el fichero de configuración. Sólo es obligatorio su uso en plataformas web que usen mecanismos de autenticación. Página 186

187 Parámetros de configuración relacionados con ULP: ULP_ Los parámetros con prefijo ULP_ son los relacionados con las configuraciones del MTX-Tunnel en escenarios de Ultra Bajo Consumo (2uA). Los parámetros ULP son únicamente para ser usados cuando el MTX-Tunnel esté corriendo sobre una plataforma MTX-65i-ULP. Esta plataforma tiene la característica de ser un módem GPRS con capacidad ULP (Ultra Low Power). Cuando el módem está apagado, el consumo es de 2uA. Los parámetros ULP_ están concebidos para configurar el MTX-Tunnel de manera apropiada activando los túneles y servicios GPRS en un momento dado, ya sea una fecha/hora o una entrada digital, y apagarlos de nuevo pasado un tiempo configurable, para regresar al modo ULP. Si el escenario de su aplicación requiere bajo consumo, se recomienda la atenta lectura de los siguientes parámetros de configuración. ULP_mode Descripción. El modo de trabajo por defecto del MTX-Tunnel montado sobre un módem MTX-65ULP es gprs, esto es, cuando el MTX-Tunnel sale del modo ultrabajo consumo activará una sesión GPRS para la activación de sus servicios (túnel serie, envío de telemetrías por GPRS, webserver, ) Sin embargo es posible establecer un modo especial de trabajo para aplicaciones que requieran de un consumo tan mínimo, que no ser posible o necesario una transmisión GPRS. Es el modo SMS. En este modo, cuando el MTX-Tunnel despierte, únicamente leerá las entradas digitales y analógicas y enviará un SMS con el estado de las mismas, tras lo cual, volverá a modo ultrabajo consumo. El objetivo es un sistema de monitorización de telemetrías por SMS de muy bajo consumo. Valores posibles. gprs, sms Valor por defecto: gprs Notas adicionales. - En modo SMS (ULP_mode: sms) es OBLIGATORIO usar el modo ULP_sleepMode: minutes. Es decir, no es posible especificar una fecha para salir del modo ULP, sino que hay que especificar los minutos (ULP_minutes) que el módem debe dormir. La Página 187

188 razón es que en modo ULP_sleepMode: date es obligatorio la sincronización horaria por GPRS y en cambio no es posible establecer una sesión GPRS en este modo SMS. - El SMS enviado tiene el formato: MTX_IDClient#GPIO1#GPIO2# #GPIO10#ADC1#ADC2# Donde GPIOx son las entradas/salidas digitales y ADCx las entradas analógicas. Estas telemetrías marcadas de color naranja sólo se envían si el parámetro ULP_smsExtended está a valor on. Página 188

189 ULP_sleepMode Descripción. Especifica el modo de sleep del MTX-Tunnel. Si el valor especificado es minutes el comportamiento del MTX-Tunnel será el siguiente: - El MTX-Tunnel se despertará y habilitará los servicios GPRS que tenga configurados (túneles serie, webserver, telnet, ). El MTX-Tunnel estará activo mientras haya transferencia de datos GPRS. Una vez finalice el envío de datos GPRS el MTX-Tunnel esperará el tiempo especificado en GPRS_timeout (que en modo ULP, GPRS_timeout no especifica minutos, sino segundos, por razones de consumo). Pasado ese tiempo, el MTX-Tunnel entrará en modo ULP (2uA), volviendo a despertarse a los X minutos especificados en el parámetro ULP_minutes. Si el valor especificado es date el comportamiento del MTX-Tunnel será el siguiente: - El MTX-Tunnel se despertará y habilitará los servicios GPRS que tenga configurados (túneles serie, webserver, telnet, ). Tras despertarse el MTX-Tunnel estará activo mientras haya transferencia de datos GPRS. Una vez finalice el envío de datos GPRS el MTX-Tunnel esperará el tiempo especificado en el parámetro GPRS_timeout (que en modo ULP, GPRS_timeout no especifica minutos sino segundos por razones de consumo). Pasado ese tiempo, el MTX-Tunnel entrará en modo ULP (2uA), volviendo a despertarse a la hora más próxima especificada en los parámetros: ULP_time1. ULP_time2, ULP_time10 Valores posibles. minutes, date Valor por defecto: minutes Notas adicionales. - En modo date es OBLIGATORIO tener configurado un servidor horario en el parámetro MTX_TPServer. El módem siempre sincronizará su hora con la del servidor de tiempo cada vez que despierte. Se recuerda que la hora que maneja el MTX-Tunnel es hora UTC. Página 189

190 ULP_minutes Descripción. Especifica los minutos que el módem permanecerá dormido en modo ULP (Ultra Low Power) si el parámetro ULP_rtc= on. Pasados los minutos especificados el módem se activará de nuevo. Valores posibles Valor por defecto: 0 Notas adicionales. - Si el módem está trabajando en modo sms (ULP_mode: sms ) sin RTC (ULP_rtc: off ), es decir, en el modo de trabajo en el que el módem permanecerá dormido siempre hasta que se active una entrada digital, un valor del parámetro ULP_minutes>0 hará que en caso de no poder enviar el SMS (por ejemplo, por un fallo puntual de cobertura) el módem se despierte al cabo de ULP_minutes para reintentar el envío del SMS. Página 190

191 ULP_time1, ULP_time2,, ULP_time10 Descripción. Es posible especificar hasta 10 horarios distintos para sacar al MTX-Tunnel del modo ULP (Ultra Low Power, 2uA) y activar la sesión GPRS (y por tanto los servicios GPRS asociados: túneles, webserver, telnet, ) durante los segundos especificados en GPRS_timeout. Valores posibles. DDHHMM Valor por defecto: (donde DD son días, HH horas (24h) y MM (minutos) Ninguno Notas adicionales. - En DD y HH puede establecerse el valor XX, esto indica cualquier valor. Ejemplos de horarios: ULP_time1: (el MTX-Tunnel saldrá del modo ULP cada día 01 del mes, a las 22:00 horas) ULP_time1: ULP_time2: (el MTX-Tunnel saldrá del modo ULP cada día 01 y 15 del mes, a las 10:30 horas) ULP_time1: XX1800 (el MTX-Tunnel saldrá del modo ULP cada día del mes, a las 18:00 horas) ULP_time1: XX0200 ULP_time2: XX1400 (el MTX-Tunnel saldrá del modo ULP cada día del mes, a las 02:00 horas y a las 14:00 horas) ULP_time1: XXXX00 (el MTX-Tunnel saldrá del modo ULP cada día del mes, a cada hora en punto) Página 191

192 - Recuerde que la hora utilizada por el módem es HORA UTC (por favor, tenga en cuenta a qué hora UTC corresponde su país / región. Por ejemplo, en España: UTC+1 ó UTC+2 en verano (Ejemplo, hora UTC 09:00 en Julio en España, corresponde a las 11:00 hora local) Página 192

193 ULP_smsExtended Descripción. Si el parámetro se establece a off y el modo de trabajo del ULP es sms (ULP_mode: sms) únicamente se enviará un SMS con la cadena especificada en el parámetro MTX_IDClient. Si el parámetro se establece a on, además del parámetro MTX_IDClient se enviarán todas las telemetrías tal y como se especificaba en las explicaciones del parámetro ULP_mode. Valores posibles. on, off Valor por defecto: on Notas adicionales. - En hecho de permitir enviar únicamente el parámetro configurable por el usuario MTX_IDClient y no las telemetrías es para poder realizar un sistema de alarma de ultrabajo consumo, en el que sólo sea preciso enviar un determinado mensaje SMS cuando se detecte un momento, sin necesidad de enviar el estado técnico de las entradas digitales y analógicas del módem. Por ejemplo para enviar: Entrada no autorizada detectada cada vez que se active una señal de tamper. Página 193

194 ULP_smsNumber1, ULP_smsNumber2, ULP_smsNumber3 Descripción. Indica los números de teléfono donde se enviarán por SMS las telemetrías de las entradas/salidas digitales y entradas analógicas cuando el modo de funcionamiento es ULP_mode: sms Pueden introducirse hasta 3 números de teléfono. Valores posibles. Número de teléfono válido Valor por defecto: Ninguno Notas adicionales. Página 194

195 ULP_rtc Descripción. El software MTX-Tunnel montado sobre un módem modelo ULP cuenta con una RTC (Real Time Clock) que le permite despertarse a una hora determinada. Adicionalmente el MTX- 65ULP cuenta con unas entradas denominadas tamper. La activación de una de estas entradas de tamper provoca también que el MTX-Tunnel salga del modo ultrabajo consumo. Si el escenario de la aplicación necesita que el MTX-Tunnel se despierte únicamente por la activación de una señal digital (sin necesidad de despertarse periódicamente a una hora determinada) debe desactivarse la RTC, en caso contrario, debe activarse Valores posibles. on, off Valor por defecto: on Notas adicionales. - El uso de un módem ULP junto con el hecho de desactivar la RTC y dejar únicamente activos las entradas de tamper, es la configuración del MTX-Tunnel de menor consumo posible. Página 195

196 Parámetros de configuración relacionados con LOGGER: LOGGER_ Los parámetros con prefijo LOGGER_ son los relacionados con las configuraciones del MTX-Tunnel relativos al datalogger interno del MTX-Tunnel. La activación del datalogger interno permite almacenar en memoria interna datos leídos de sensores remotos Wavenis (sondas radio de temperatura, contadores de pulsos, ), de entradas y salidas propias del módem y de lecturas de un equipo modbus conectado al puerto serie del módem. La activación del datalogger es OBLIGATORIA cuando se usan dispositivos remotos Wavenis o dispositivos Modbus que deben leerse por el puerto serie. Consulte los ejemplos del anexo para más información. LOGGER_enabled Descripción. Este parámetro permite habilitar el datalogger interno del MTX-Tunnel. Permitirá almacenar en memoria lecturas de dispositivos radio, E/S del módem y lecturas de dispositivos Modbus. El datalogger almacena los datos en memoria y los envía a un servidor HTTP GET mediante un objeto JSON vía GPRS Valores posibles. on, off Valor por defecto: off Notas adicionales. - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 196

197 LOGGER_password Descripción. Este parámetro permite especificar un password (o cadena de usuario, de uso libre) que se enviará en cada trama JSON enviada al servidor. Valores posibles. Cadena < 64 caracteres Valor por defecto: Ninguno Notas adicionales. - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 197

198 LOGGER_server Descripción. Este parámetro permite especificar la URL del servidor a la que enviar la cadena JSON con los datos recogidos por el datalogger. Valores posibles. Cadena < 256 caracteres Valor por defecto: Ninguno Notas adicionales. - Una URL de ejemplo puede ser: donde en la variable V llegará al servidor la cadena JSON. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 198

199 LOGGER_registerSize Descripción. Este parámetro permite especificar la longitud máxima del registro de almacenamiento interno (memoria FLASH) de una trama JSON. Es decir, por ejemplo, se realiza una lectura radio para leer un wavetherm (sonda de temperatura). La lectura se almacena en memoria en formato JSON. {"IMEI": ,"TS":"18/10/12 10:04:37","P":"matrix","A":0B D3,"BAT":0,"T1": ,"T2 ":0.0 } Es decir, el tamaño a indicar en este parámetro debería tener al menos la longitud máxima que pueda tener el JSON que puede recibir. En el ejemplo anterior 110 sería el valor mínimo. Si no sabe que valor establecer indique 300 Valores posibles Valor por defecto: 200 Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. - Si está usando el Logger para almacenar lecturas de equipos Wavenis, le recomendamos que especifique un valor de Si está usando el Logger para almacenar lecturas de equipo ModBus, le recomendamos que especifique un valor que sea superior a x el número máximo de registros modbus a leer en una lectura. Página 199

200 LOGGER_numRegistersFlash Descripción. Este parámetro permite definir el número máximo de registros que el MTX-Tunnel puede almacenar en su memoria flash interna. Valores posibles Valor por defecto: 1500 Notas adicionales. - Recuerde que la memoria flash del equipo se utiliza para el caso de que el MTX-Tunnel no disponga, en un momento puntual, de conectividad GPRS para el envío de información. Dicha memoria se utiliza para no perder lecturas. En el momento que vuelva la conectividad GPRS se irán reenviando los datos acumulados vía GPRS. - Recomendable que el fichero de datos (data.txt que se creará automáticamente en el interior del módem) no ocupe más de 1MByte. Recuerde que el tamaño del fichero corresponde a la multiplicación LOGGER_numRegistersFlash x Logger_registerSize Página 200

201 LOGGER_ioPeriod Descripción. Especifica cada cuantos segundos el módem debe leer todas sus entradas digitales y analógicas, registrar las lecturas en memoria interna (datalogger) y enviarlos al servidor mediante un objeto JSON Valores posibles. 0 (desactivado) Valor por defecto: 0 Notas adicionales.. - Consulte el ejemplo 2.14 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional Página 201

202 LOGGER_serverLogin Descripción. Permite establecer el login (nombre de usuario) que debe usar el MTX-Tunnel para en envío de datos a una Plataforma Web que cuente con un sistema de autenticación basado en Login y Password. Valores posibles. Cadena hasta 64 caracteres Valor por defecto: Ninguno Notas adicionales.. - Si su plataforma web no usa un sistema de autenticación simple basado en Login y Password no es necesario que incluya este parámetro en el fichero de configuración. Sólo es obligatorio su uso en plataformas web que usen mecanismos de autenticación. - Este parámetro está disponible desde la versión MTX-Tunnel 7.27 Página 202

203 LOGGER_serverPassword Descripción. Permite establecer el password que debe usar el MTX-Tunnel para en envío de datos a una Plataforma Web que cuente con un sistema de autenticación basado en Login y Password. Valores posibles. Cadena hasta 64 caracteres Valor por defecto: Ninguno Notas adicionales.. - Si su plataforma web no usa un sistema de autenticación simple basado en Login y Password no es necesario que incluya este parámetro en el fichero de configuración. Sólo es obligatorio su uso en plataformas web que usen mecanismos de autenticación. Página 203

204 LOGGER_serialFrequency Descripción. Permite establecer la frecuencia con la que el logger interno del MTX debe registrar tramas serie recibidas. Valores posibles (en segundos) Valor por defecto: 0 Notas adicionales. - Parámetro de configuración válido desde la versión MTX-Tunnel Un valor 0 hace que no se registren los datos serie recibidos por el puerto serie del módem. - Un valor 1 hace que se registren todas las tramas serie recibidas por el puerto serie del MTX - Un valor 6 hace que se registren 1 de cada 6 tramas recibidas. Por ejemplo útil si se dispone de un sensor de temperatura que emite tramas serie con la temperatura de forma automática 10 (sin opción a cambio) y queremos que se registren datos cada 1 minuto. - Los datos deben recibirse de forma consecutiva en el puerto serie del módem, sin pausas. El tamaño máximo de la trama a loggear no debe superar los 256 bytes o los datos quedarán truncados. Página 204

205 LOGGER_serialData1,, LOGGER_serialData10 Descripción. Permite configurar hasta 10 tramas de datos a enviar de forma autónoma por el módem. Es decir, cada X segundos configurados en el parámetro LOGGER_serialPeriod el MTX enviará dichas tramas por el puerto serie, loggeando las respuestas para posteriormente enviarlas a una plataforma. Valores posibles. A5B78912.FE80916F (trama en exadecimal) Valor por defecto: ninguno Notas adicionales. - Parámetro de configuración válido desde la versión MTX-Tunnel Las tramas tienen que estar en formato hexadecimal. - En inicia el envío de tramas con el periodo indicado en LOGGER_serialPeriod. La pausa mínima entre cada una de las 10 tramas enviadas que puede enviar el MTX es de 2 segundos. - Una vez enviada una trama de datos, la respuesta del equipo conectado al puerto serie del MTX tampoco debe superar los 256 bytes. Página 205

206 LOGGER_serialPeriod Descripción. Especifica cada cuantos segundos el módem enviará las tramas serie especificadas en los parámetros LOGGER_serialData1, LOGGER_serialData10 Valores posibles. 0 (desactivado) Valor por defecto: 0 Notas adicionales. - Parámetro de configuración válido desde la versión MTX-Tunnel Consulte los ejemplos del anexo para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional Página 206

207 Parámetros de configuración relacionados con MODBUS: MODBUS_ Los parámetros con prefijo MODBUS_ permiten configurar al MTX-Tunnel para realizar una lectura periódica de una tabla de memoria (de posiciones de registros consecutivos) de un dispositivo modbus RTU conectado al puerto serie de un módem MTX. También es posible leer y escribir variables modbus en tiempo real con los comandos AT^MTXTUNNEL=GETMODBUS y AT^MTXTUNNEL=SETMODBUS MODBUS_address Descripción. Este parámetro especifica la dirección del equipo ModBus RTU Valores posibles Valor por defecto: 1 Notas adicionales. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. - Consulte con gsmsupport@matrix.es si necesita ayuda adicional. - A partir de la versión 7.12 de MTX-Tunnel es posible establecer múltiples direcciones en este parámetro lo cual permite leer varios dispositivos modbus con un único módem. Debe especificar la dirección de cada dispositivo separado por ;. Por ejemplo, si desea leer la tabla de memoria de los dispositivos con dirección 1, 2 y 3, el parámetro MODBUS_address tendría un valor: 1;2;3 Página 207

208 MODBUS_start Descripción. Este parámetro indica la primera posición a leer de la tabla de registros modbus Valores posibles Valor por defecto: 1 Notas adicionales.. - Los datos que va a leer el MTX-Tunnel van a ser siempre de tipo Word (2 bytes). En caso de utilizar otro tipo de datos tendrá que realizar las operaciones necesarias con los datos recibidos en su servidor al recibir la trama JSON. - A partir de MTX-Tunnelv7.18 es posible establecer varios puntos de inicio, para poder leer varios rangos de memoria diferentes. Para especificar un punto de inicio diferente para cada dispositivo, debe especificarse cada uno separado por ; - Consulte los ejemplos del Anexo 6.3 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 208

209 MODBUS_numWords Descripción. Este parámetro indica cuantos registros debe leer el MTX-Tunnel del dispositivo ModBus a partir de la dirección indicada en el parámetro MODBUS_start Valores posibles Valor por defecto: 1 Notas adicionales.. - Recuerde que en función del datos indicado aquí va a tener que ajustar el parámetro LOGGER_registerSize - A partir de MTX-Tunnelv7.18 es posible establecer diferentes números de registros a leer, para poder leer varios rangos de memoria diferentes. Para especificar un número de registros diferente para cada dispositivo, debe especificarse cada uno separado por ; - Consulte los ejemplos del Anexo 6.3 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 209

210 MODBUS_period Descripción. Este parámetro indica cada cuantos segundos el MTX-Tunnel debe interrogar al dispositivo ModBus para realizar la lectura de los registros de memoria. Valores posibles (de 30 segundos a 30 días) Valor por defecto: 900 (15 minutos) Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 210

211 MODBUS_onlyChanges Descripción. Este parámetro permite decidir si se envían todos los registros leídos de un dispositivo modbus (valor off ) o bien sólo se envían los registros cuando hay un cambio en al menos uno de los registros leídos (valor on ). Valores posibles. on, off Valor por defecto: off (se envían todas las lecturas) Notas adicionales.. - Este parámetro se mantiene por compatibilidad con versiones anteriores. No lo use. En su lugar, por favor, use el parámetro MODBUS_changeDiff Página 211

212 MODBUS_readCommand Descripción. Este parámetro permite escoger el comando de lectura ModBus para aplicaciones donde el MTX-Tunnel actúa como modbusmaster para la recogida y envío de registros modbus. En la mayoría de dispositivos las lecturas se hacen empleando el comando 0x03, pero en otros se puede requerir el empleo del comando 0x04. Mediante este parámetro de configuración podrá escoger entre el 0x03 y 0x04. Desde la versión MTX-Tunnel v8.07 puede usar también los valores 0x01 y 0x02 para leer registros binarios. Valores posibles. 1, 2, 3, 4 Valor por defecto: 3 Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. - Si no sabe cual escoger, le recomendamos que especifique el 3 - Puede especificar un comando de lectura diferente para cada dispositivo a leer. Para especificar un comando de lectura diferente para cada dispositivo, debe especificarse cada uno separado por ; - A partir de la versión MTXTunnel v8.07 es posible leer registros binarios usando los comandos 1 y 2. Página 212

213 MODBUS_logFrequency Descripción. Con este parámetro es posible escoger la frecuencia de grabación en la memoria interna del Logger para su envío GPRS. Es decir, es posible establecer por ejemplo un MODBUS_period a 60, indicando que el periodo de lectura de los registros modbus será cada 60 segundos y establecer, por ejemplo, un MODBUS_logFrequency de 3, lo que implica que una de cada 3 lecturas se almacenará internamente y será retransmitido vía GPRS. Valores posibles Valor por defecto: 1 (frecuencia almacenamiento = MODBUS_period Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. - Este parámetro resulta de especial utilidad en escenario en los que el MTX-Tunnel tenga que interrogar a varios equipos. Por ejemplo, puede configurarse un equipo con MODBUS_logFrequency a 1 y otro con MODBUS_logFrequency a 5. Si estuviera configurado un MODBUS_period de 60 segundos, de un equipo se recogerían enviarían datos cada 60 segundos y del otro cada 5x60=300 segundos - Este parámetro está muy relacionado con el parámetro de configuración MODBUS_logType. Por favor, lea en el manual acerca de él. Lo necesita para usar correctamente MODBUS_logFrequency. Página 213

214 MODBUS_changeDiff Descripción. Con este parámetro es posible hacer que únicamente se almacenen / envíen gprs aquellas lecturas de registros modbus en las cuales haya algún registro cuyo valor haya cambiado según lo especificado en MODBUS_changeDiff. Es decir, por ejemplo, si especifica un parámetro MODBUS_changeDiff con un valor 10 y lee los registros desde la dirección 40 a la 45 de un equipo, si uno de los registros 40 a 45 de la lectura realizada presenta una diferencia (en valor absoluto) >=10 respecto a la última lectura (que fue almacenada/enviada), dicha lectura (de los registros 40 a 45) será almacenada en el logger para su posterior envío vía GPRS Valores posibles Valor por defecto: 0 Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. - Este parámetro resulta de especial utilidad en aquellos escenarios en los que sólo se deseen almacenar/enviar datos cuando sufran cambios significativos en una variable. Por ejemplo, imagine que tiene una aplicación en la que se recogen temperaturas de una sonda modbus que se leer cada 60 segundos, pero no quiere enviar vía GPRS cada 60 segundos la temperatura si ésta no ha sufrido cambios. Pues por ejemplo, estableciendo un MODBUS_changeDiff con un valor a 1 sólo se enviarías las temperaturas cuando difieran en 1 grado. - Este parámetro está muy relacionado con el parámetro de configuración MODBUS_logType. Por favor, lea en el manual acerca de él. Lo necesita para usar correctamente MODBUS_changeDiff. Página 214

215 MODBUS_logType Descripción. Con este parámetro es posible especificar si se va a usar MODBUS_logFrequency, MODBUS_changeDiff o ambos. Es decir, puede escoger, por ejemplo, que las lecturas modbus de un dispositivo se almacenen/envíen cada MODBUS_logFrecuency, el de otro dispositivo lo hagan cuando un registro cambie más de MODBUS_changeDiff o bien ambas cosas a la vez. Valores posibles. 0 (MODBUS_logFrecuency), 1 (MODBUS_changeDiff), 2 (MODBUS_logFrecuency y MODBUS_changeDiff). Valor por defecto: 0 Notas adicionales.. - Consulte los ejemplos del Anexo 6 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 215

216 MODBUS_custom Descripción. Con este parámetro se añade a la trama JSON un nuevo valor C donde puede especificar una cadena de texto de manera arbitraria. Por ejemplo, puede resultarle útil en el caso de querer indicar al servidor si los datos de la lectura son binarios, words, long, Puede utilizar este campo de texto para lo que desee. Únicamente se envía si se especifica un valor. Valores posibles. Una cadena de texto de usuario. Valor por defecto: Ninguno Notas adicionales.. - Consulte los ejemplos del Anexo 6.8 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 216

217 MODBUS_regType Descripción. Este parámetro permite definir el tipo de registro modbus que se pretende leer durante una lectura automática. Permite elegir entre Word y dobleword Valores posibles. 2 bytes (unsigned word), 4 bytes (unsigned dobleword) Valor por defecto: 2 Notas adicionales.. - Parámetro disponible desde la versión MTX-Tunnelv8.08. Hasta esta versión únicamente era posible usar el valor 2 (Word) - Consulte los ejemplos del Anexo 6.4 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 217

218 Parámetros de configuración relacionados con WAVENIS: WAVENIS_ Los parámetros con prefijo WAVENIS_ son los relacionados con las configuraciones del MTX- Tunnel en escenarios de telemedidas va RF 868MHz. Los parámetros WAVENIS_ son únicamente para ser usados cuando el MTX-Tunnel esté funcionando sobre una plataforma MTX-IND con la opción de tarjeta de comunicaciones RF 868MHz Wavecard instalada. Consulte también la especificación de los parámetros LOGGER_ Consulte el ejemplo del Anexo 5 para un mayor entendimiento y para obtener el formato usado del objeto JSON WAVENIS_mac1, WAVENIS_mac2, WAVENIS_mac32 Descripción. Este parámetro permite especificar las direcciones MAC de los dispositivos Coronis a leer. Especifique la dirección MAC de dispositivos Wavetherm, Waveflow, WaveSense ó Wavelog. Las direcciones MAC especificadas en este parámetro serán los dispositivos que se leerán periódicamente por parte del MTX-Tunnel. También permite especificar los repetidores que, de ser el caso, se utilizarán. Valores posibles. AABBCCDDEEFF;XX;YY;ZZ AABBCCDDEEFF : dirección MAC wavenis válida XX;YY;ZZ: Valor por defecto: Ninguno 1,2, 10 indicando, en orden, los repetidores a utilizar. Notas adicionales. - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 218

219 WAVENIS_rep1, WAVENIS_rep2, WAVENIS_rep10 Descripción. Permite especificar la MAC de hasta 10 repetidores para ser utilizado en las comunicaciones wavenis. Valores posibles. AABBCCDDEEFF Valor por defecto: dirección MAC wavenis válida Ninguno Notas adicionales. - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 219

220 WAVENIS_period Descripción. Este parámetro permite especificar cada cuantos segundos se lanza el barrido de lectura del MTX-Tunnel hacia los dispositivos Coronis especificados en los parámetros WAVENIS_macXX Valores posibles. 0, Valor por defecto: 0 Notas adicionales. - Tenga en cuenta que la lectura de un único dispositivo puede durar desde 2.5 segundos hasta 10 segundos en función de los repetidores utilizados. Si por ejemplo en su instalación el MTX-Tunnel controla 10 dispositivos Coronis, el barrido completo de lectura puede llevar desde 25 segundos hasta 100 segundos, sin considerar fallos en las comunicaciones, por lo que el valor del parámetro debe especificarlo de forma adecuada. - No se recomienda en ningún caso un valor inferior a 30 segundos para el caso de controlar un único dispositivo Coronis. - Las lecturas efectuadas se almacenan en el Logger interno del MTX-Tunnel. Consulte los parámetros Logger_ para más información - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 220

221 WAVENIS_retries Descripción. Este parámetro permite especificar cuantos reintentos de comunicación debe hacer la aplicación MTX-Tunnel en el caso de ocurrir un fallo en la lectura de un dispositivo. Valores posibles. 0,1,2,3 Valor por defecto: 2 Notas adicionales. - Es recomendable usar un valor de 2 reintentos - Consulte los ejemplos del Anexo 5 para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 221

222 Parámetros de configuración relacionados con CSD: CSD_ Los parámetros con prefijo CSD_ son los relacionados con las configuraciones del MTX-Tunnel en escenarios de telemedidas por llamada de datos GSM convencional. MTX-Tunnel permite la recepción de llamadas GSM de datos (CSD) para la creación de una pasarela GSM-Serie. Además permite simultaneidad con una pasarela GPRS-Serie, dando prioridad a la llamada GSM. Este funcionamiento es ideal para lectura de contadores, donde debe poderse comunicar con un contador eléctrico mediante una llamada GSM (típico de operadores de energía como Endesa, Iberdrola, ) y mediante una comunicación GPRS para lecturas muy constantes o en tiempo real. CSD_enabled Descripción. Permite habilitar o no las llamadas de datos GSM. Establecido este parámetro a on, el módem descolgará las llamadas de datos GSM tras el primer RING, estableciendo una pasarela GSM-Serie. Si en el momento de entrar una llamada GSM de datos hubiere establecida una pasarela GPRS-Serie, la pasarela GPRS-Serie se congela para dar paso a la pasarela GSM-Serie. Una vez finalizada la llamada GSM, la pasarela GPRS-Serie se reestablece a su estado anterior. Valores posibles. on, off Valor por defecto: off Notas adicionales. Consulte los ejemplos del Anexo (7.1 y 7.2) para un mejor entendimiento de este parámetro. Consulte con gsmsupport@matrix.es si necesita ayuda adicional. Página 222

223 CSD_commPort Descripción. Si el parámetro CSD_enabled está a on, CSD_commPort permite especificar si el puerto serie a utilizar en la recepción de una llamada GSM es el COM1 ó el COM2. Por ejemplo, si en un modelo MTX-65i queremos recibir la llamada por el DB9 (COM1) el valor del parámetro CSD_commPort será 1. Si queremos recibir la llamada GSM por el puerto DB15 (COM2) el valor a usar será el 2. Parámetro válido desde la versión MTX-Tunnel v7.29 Valores posibles. 1, 2 Valor por defecto: 1 Notas adicionales. - Ciertamente el poder escoger el COM de una llamada CSD se podía elegir con el parámetro MTX_invertedCom. Sin embargo este parámetro será indispensable si que quiere tener una pasarela GPRS-Serie por el COM1 y una pasarela GSM-Serie por el COM2, por ejemplo, para controlar 2 dispositivos diferentes con un único módem. Página 223

224 Parámetros de configuración relacionados con SALIDAS: OUTPUT_ Todos los modelos de módems MTX disponen de salidas ya sean éstas digitales o por relé. Con los parámetros OUTPUT_ podrá controlarlas fácilmente. Por ejemplo, podrá conmutar un relé dentro de un horario programado, en función del valor de una entrada analógica, en función de la lectura de un registro de un equipo modbus etc etc. Adicionalmente los parámetros OUTPUT_ le permiten, de forma indirecta, programar ciertas alarmas por SMS. Por ejemplo, podrá especificar que se envíe un SMS cuando el valor de una entrada analógica o el valor de un registro MODBUS estén por encima o por debajo de un determinado valor. Le recomendamos encarecidamente que de un vistazo a los ejemplos del Anexo 8 que son los relacionados con los parámetros OUTPUT_ para entender mejor el funcionamiento. Estos parámetros de configuración OUTPUT_ están disponibles desde la versión MTX-Tunnel v7.21 OUTPUT_mode1, OUTPUT_mode2, OUTPUT_mode3, OUTPUT_mode4 Descripción. MTX-Tunnel le permite configurar hasta cuatro salidas de un dispositivo MTX. No todos los módems MTX disponen del mismo número de salidas. Los equipos que mayor número de salidas disponen (en este caso de relé) son los MTX modelos: MTX-IND y MTX-IND-V1 de ahí que puedan especificarse desde OUTPUT_mode1 hasta OUTPUT_mode4 Valores posibles. manual, on, off, time, analog, modbus, call, astronomical, socket Valor por defecto: manual Notas adicionales. - Descripción de cada uno de los valores posibles: manual: es el comportamiento que tenían hasta la versión MTX-Tunnel v7.20 las salidas de los equipos MTX. Mediante el modo manual usted puede cambiar el estado de una salida digital / relé mediante un SMS, por webserver o por Telnet on: especificando una salida a modo on, ésta estará permanentemente activada (por ejemplo, un relé permanentemente conmutado). off: especificando una salida a modo off, ésta estará permanentemente desactivada (por ejemplo, un relé permanentemente no conmutado). Página 224

225 time: especificando una salida a modo time, podrá especificar un horario de activación / desactivación de una salida digital / relé. analog: especificando una salida a modo analog, podrá especificar un valor máximo y un valor mínimo de una entrada analógica a partir de la cual una salida digital / relé debe activarse. También, entre otras cosas, podrá enviar un mensaje de alarma SMS cuando se supere por encima o por abajo un determinado valor analógico. modbus: especificando una salida a modo modbus, podrá especificar un valor máximo y un valor mínimo de un registro de un equipo modbus a partir de la cual una salida digital / relé debe activarse. También, entre otras cosas, podrá enviar un mensaje de alarma SMS cuando se supere por encima o por abajo un determinado valor de un registro modbus. call: especificando una salida a modo call, le permite hacer que una determinada salida digital / relé se active por 2 segundos ante la llamada digital de un número de teléfono (muy últil en escenarios de apertura de puertas automáticas, generación de resets a equipos externos, ) astronomical: especificando una salida a modo astronomical, le permite hacer que una determinada salida digital / relé se active / desactive en función del Sol. El MTX-Tunnel, dada la posición GPS con los parámetros MTX_latitude y MTX_longitude, es capaz de calcular para cualquier punto del globo terráqueo y para cada día de año, la hora de salida y puesta de Sol. Es posible hacer que una salida del MTX se active en el momento de la salida/puesta de Sol e incluso asignar un diferencial configurable para estos momentos. socket: Cambia el estado de una salida digital o relé en función de si hay un socket conectado o no. timer: Permite el uso del comando AT^MTXTUNNEL=SETOUTPUTTIMER. Eso permite que mediante un único comando AT, ya sea enviado por SMS, TELNET,, poder conmutar un relé durante unos segundos. bitcoin: Permite activar una salida digital ó relé en un función de si se produce un ingreso online mediante el método de pago Bitcoin. Página 225

226 OUTPUT_config1, OUTPUT_config2, OUTPUT_config3, OUTPUT_config4 Descripción. Mediante estos parámetros puede configurar el comportamiento de cada una de las hasta 4 salidas de un módem MTX. Es un parámetro complejo, le recomendamos la lectura de los ejemplos del Anexo 8 para un mayor entendimiento. La estructura de un parámetro OUTPUT_configX depende del modo especificado en OUTPUT_modeX, es decir, la configuración de OUTPUT_configX será diferente si está configurando una salida que depende del estado de un valor analógico (OUTPUT_modeX: analog) que de un valor de un registro modbus (OUTPUT_modeX: modbus), etc. Valores posibles. Valor por defecto: ninguno Si el valor especificado en OUTPUT_modeX es manual, on, off ó call este parámetro OUTPUT_configX no tiene uso, ya que carece de sentido. Debe utilizarse obligatoriamente si en OUTPUT_modeX espeficifica un valor time, analog o modbus. Si el valor especificado en OUTPUT_modeX es time, el parámetro OUTPUT_configX debe tener la siguiente estructura: HH;MM;HH;MM Donde se indica la hora y minutos de activación de la salida digital / relé y la hora de desactivación de la salida digital / relé. Por ejemplo, si quiere activar la salida 3 a las 20:30 y desactivarla a las 07:15, el valor del parámetro en el fichero de configuración config.txt debería ser: OUTPUT_config3: 20;30;07;15 Si el valor especificado en OUTPUT_modeX es analog, el parámetro OUTPUT_configX debe tener la siguiente estructura: ID;ValorMax;ValorMin;ATCommandMax;ATCommandMin Donde: ID: 0 1 puede valer 0 ó 1 en función de si se desea leer el valor del adc0 ó adc1 del módem MTX Página 226

227 ValorMax: Valor máximo del conversor analógico digital (adc) a partir del cual la salida digital / relé debe activarse. ValorMin: Valor mínimo del conversor analógico digital (adc) a partir del cual la salida digital / relé debe desactivarse. ATCommandMax: comando AT a ejecutar MTX-Tunnel le permite ejecutar un comando AT opcional cuando el valor del adc iguale o supere el valor indicado en ValorMax ATCommandMin: comando AT a ejecutar MTX-Tunnel le permite ejecutar un comando AT opcional cuando el valor del adc iguale o supere por debajo el valor indicado en ValorMin Por ejemplo, si se pretende activar el relé de la salida 3 cuando el valor leído por el conversor analógico digital 0 esté por encima de 2000 y que se desactive cuando esté por debajo de 1800, y no se pretende ejecutar un comando AT, el valor a especificar en el parámetro sería: OUTPUT_config3: 0,2000;1800;; Si el valor especificado en OUTPUT_modeX es modbus, el parámetro OUTPUT_configX debe tener la siguiente estructura: dir;comando;registro;valormax;valormin;atcommandmax;atcommandmin Donde: dir: comando: 3, 4 indica la dirección modbus del equipo a leer permite especificar si el comando modbus es 3 ó 4 registro: permite especificar el número de registro modbus a leer. ValorMax: Valor máximo del registro modbus a partir del cual la salida digital / relé debe activarse. ValorMin: Página 227

228 Valor mínimo del registro modbus a partir del cual la salida digital / relé debe desactivarse. ATCommandMax: comando AT a ejecutar MTX-Tunnel le permite ejecutar un comando AT opcional cuando el valor del registro modbus sea igual o supere el valor indicado en ValorMax ATCommandMin: comando AT a ejecutar MTX-Tunnel le permite ejecutar un comando AT opcional cuando el valor registro modbus sea igual o supere por debajo el valor indicado en ValorMin Por ejemplo, si se pretende activar el relé de la salida 3 del MTX-IND cuando el valor del registro número 100 del equipo modbus con dirección 7 (cuyo comando de lectura modbus es 3) sea igual o esté por encima de 2000 y que se desactive cuando sea igual o inferior a 1800, y además se envíe un SMS de alarma (con texto alarma mtx ) cuando el valor sea igual o inferior a 1800 el valor a especificar en el parámetro sería: OUTPUT_config3: 100;7;3;100;2000;1800;;AT^MTXTUNNEL=SMS, ,alarma mtx Si el valor especificado en OUTPUT_modeX es call, el parámetro OUTPUT_configX no debe ser incluido en el fichero de configuración. Si el valor especificado en OUTPUT_modeX es astronomical, el parámetro OUTPUT_configX debe tener la siguiente estructura: minutosocaso, minutosorto Donde: minutosorto: permite indicar un offset de tiempo para que la salida/relé desconmute X minutos antes o después de la salida del Sol. minutosocaso: permite indicar un offset de tiempo para que la salida/relé conmute X minutos antes o después de la puesta de Sol. Página 228

229 Si el valor especificado en OUTPUT_modeX es bitcoin, el parámetro OUTPUT_configX debe tener la siguiente estructura: pagominimo, tiempopagominimo, tiempoproporcionalpago, tiempomaximo Donde: pagominimo: 0.001, permite indicar el pago mínimo en Bitcoins para activar el relé. tiempopagominimo: permite indicar el tiempo (en segundos) que debe permanecer activado una salida digital / relé cuando se recibe el pago mínimo. tiempoproporcionalpago: 0 (no), 1 (sí) permite indicar si se acepta o no que el tiempo sea proporcional al pago. Es decir, que si se realiza, por ejemplo, un pago del doble del pagomínimo, el tiempo de activación sea también el doble. tiempomáximo: permite indicar el tiempo máximo que se puede tener activada la salida digital / relé independientemente del pago recibido. Notas adicionales. - Es un parámetro complejo, puede consultar los ejemplos del Anexo 8 para entender perfectamente las posibilidades del parámetro. - Fíjese que puede introducir la posibilidad de ejecutar comandos AT además de activar / desactivar una salida digital ó relé. Esto le permite, por ejemplo, enviar un SMS de alarma, cambiar el registro de un equipo modbus, etc ante la lectura de un determinado valor analógico o registro modbus. - El periodo actualización de las salidas es 15 segundos. Es decir, cada 15 segundos el MTX-Tunnel comprueba la hora, lee los conversores a/d, lee los registros modbus y activa/desactiva las salidas conrrespondientes. - Recuerde que el MTX-Tunnel utiliza hora UTC. Esto es, si especifica un horario para las salidas digitales / relés la hora debe corresponder con horario UTC. Página 229

230 Parámetros de configuración relacionados con BLUETOOTH: BLUETOOTH_ Los parámetros con prefijo BLUETOOTH_ son los relacionados con las configuraciones del MTX- Tunnel para ser usados en dispositivos MTX (únicamente en su versión 3G) que incorporen módulo bluetooth. Usando un MTX con módulo bluetooth incorporado podrá desde acceder a un dispositivo por vía 3G o vía bluetooth, hasta controlar las entradas y salidas (digitales, analógicas y relés) desde un teléfono Android con Bluetooth (o cualquier teléfono del mercado con bluetooth que soporte SSP). BLUETOOTH_enabled Descripción. Permite habilitar el módulo bluetooth para ser usado por el MTX-Tunnel. Si desea usar el módulo bluetooth debe estar establecido a on Valores posibles. on, off Valor por defecto: off Página 230

231 BLUETOOTH_pin Descripción. Permite establecer el PIN del módulo bluetooth. Pin necesario para establecer una conexión bluetooth segura desde un móvil hacia el MTX. Valores posibles. Cadena de hasta 16 caracteres Valor por defecto: 1234 Notas adicionales. - Si no establece un valor para BLUETOOTH_pin en el fichero config.txt, podrá conectarse cualquier móvil bluetooth (compatible con SSP) sin necesidad de PIN. Página 231

232 BLUETOOTH_name Descripción. Establece el friendly name para el módulo Bluetooth Valores posibles. Cadena de hasta 16 caracteres Valor por defecto: MTXTunnel Notas adicionales. - El friendly name de un módulo bluetooth asociado al MTX es el nombre que aparecerá al realizar un SCAN bluetooth desde un teléfono móvil. Página 232

233 BLUETOOTH_mode Descripción. Establece el modo de funcionamiento del módulo bluetooth. Valores posibles. server Valor por defecto: server Notas adicionales. - En la versión actual 8.09 del MTX-Tunnel únicamente es posible establecer un modo de conexión server. Es decir, únicamente puede configurarse el módulo bluetooth para ser un receptor de conexiones. - El modo client, modo en el que el módulo bluetooth del MTX realiza la conexión sobre otros dispositivos será implementado en un futuro Página 233

234 BLUETOOTH_initCommands Descripción. Permite enviar comandos de inicialización al módulo bluetooth del MTX Valores posibles. Una cadena de hasta 256 caracteres Valor por defecto: ninguno Notas adicionales. - Los módulos bluetooth que pueden montar opcionalmente los módems MTX son el WT12 ó WT11 de la marca Bluegiga. Ambos módulos cuentan con un firmware llamado iwrap, que permite controlar la configuración bluetooth mediante comandos AT. (Solicite el manual iwrap a Matrix Electrónica en caso de serle necesario). - Dichos comandos son enviados tras cada arranque/reset del MTX - Pueden enviarse N comandos, siempre separados por ; - Por ejemplo, si quisiéramos que siempre que se reinicie el MTX se borren las tablas de pairing bluetooth (es decir, para que si un día cambiamos remotamente el PIN bluetooth un móvil que ya se encontrara pareado tenga que ingresar el nuevo PIN, el comando sería: BLUETOOTH_initCommands: SET BT PAIR *;reset Página 234

235 Parámetros de configuración relacionados con BITCOIN: BITCOIN_ Los parámetros de configuración con prefijo BITCOIN_ son los relacionados con las configuraciones del MTX-Tunnel usados en escenarios de pago con esta nueva moneda electrónica. Consulte los ejemplos prácticos del escenario 10 para una mayor comprensión de lo que puede llegar a hacer. BITCOIN_enabled Descripción. Permite habilitar el sistema de pagos Bitcoin. Si usted pretende gestionar la recepción de esta moneda electrónica en un terminal MTX, debe seleccionar on. En caso contrario, off Valores posibles. on, off Valor por defecto: off Página 235

236 BITCOIN_address Descripción. La dirección de una cuenta bitcoin de su propiedad asociada a un único terminal MTX. Valores posibles. Una cuenta bitcoin ( por ejemplo: 1FTvXXEJCEFuRLe9A8ZZt2865KGiGet57r ) Valor por defecto: ninguna Notas adicionales. Cada terminal MTX debe contar con una única cuenta bitcoin, es decir, debe crear una cuenta bitcoin (la creación es instantánea y gratuita) por cada terminal que desee utilizar. No puede utilizar una única cuenta para especificarla en todos sus terminales. Página 236

237 BITCOIN_period Descripción. Especifica el periodo de tiempo (en segundos) con los que el MTX-Tunnel comprobará si hay un nuevo ingreso en la cuenta bitcoin asociada. Valores posibles Valor por defecto: 0 (desactivado) Notas adicionales. - Debido a las limitaciones del procesador, no es posible detectar en tiempo real un nuevo ingreso en una cuenta bitcoin asociada. MTX-Tunnel por tando debe comprobar de forma periódica si se ha producido o no un nuevo ingreso. - Por ejemplo si introduce un valor de 60, cada 60 segundos el MTX-Tunnel comprobará si hay un nuevo ingreso por procesar en la cuenta asociada. - Si quiere introducir un número pequeño, por ejemplo 15, es altamente recomendable que especifique el parámetro BITCOIN_wakeup: on. De esa manera el MTX-Tunnel únicamente comprobará cada 15 segundos y 10 veces si ha habido un nuevo ingreso en una cuenta bitcoin tras detectarse un cambio de estado en la entrada digital de WAKEUP del terminal MTX (Consulte anexo 11). Es decir, un usuario pulsará un botón y el terminal MTX comprobará 10 veces (cada 15 segundos) si hay un nuevo ingreso bitcoin. Esta manera de trabajar reducirá drásticamente el consumo de datos GPRS/3G. Página 237

238 BITCOIN_WAKEUP Descripción. Especifica si debe utilizarse la entrada de wakeup del terminal MTX (especificada en el Anexo 11) para que el terminal compruebe los ingresos bitoin Valores posibles. on, off Valor por defecto: off Página 238

239 BITCOIN_CONFIRMATIONS Descripción. Permite indicar el número de confirmaciones necesario para considerar válido un ingreso en una cuenta Bitcoin. Debe consultar información sobre el protocolo Bitcoin si desea ampliar información de este punto. Valores posibles. 0,, 6 Valor por defecto: 0 Notas adicionales. - El MTX-Tunnel, como procesador de pagos bitcoin, está concebido para gestionar pequeñas transferencias. Por ejemplo activar un motor de una atracción para niños, una máquina de lavado de coches, una lavadora de lavandería, gestionar los ingresos en máquina de vending. Para este tipo de escenarios, es recomendable utilizar un valor 0. De esa manera las transacciones son en tiempo real. Es decir, desde que una persona realiza la transferencia con tu teléfono móvil hasta que el MTX recibe confirmación del ingreso pasan muy pocos segundos. Si las transferencias fueran de un importe significativo, si debería especificar un valor de confirmaciones alto, pero piense que por cada escalón de seguridad, debe añadir 10 minutos para la recepción de la transferencia. Para transferencias pequeñas, el coste de la infrastuctura necesaria para montar un escenario de doble gasto, lo hace extraordinariamente improbable. Página 239

240 Anexo 1 Escenarios y Configuraciones de Ejemplo Básicos Nota MTX-Tunnel V8: Cualquier ejemplo con el parámetro: MTX_model: MTX-65i puede usarse en un módem MTX-3G-JAVA cambiando el valor a: MTX_model: MTX-3G-JAVA Página 240

241 ESCENARIO EJEMPLO 1.1 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS permanentemente y usando una tarjeta SIM provisionada por el operador con una dirección IP fija. Detalles del escenario ejemplo: Se dispone de 3 dispositivos con puerto RS232 (configurados a ,8,N,1 y control de flujo HW) los cuales se necesitan monitorizar desde un PC situado en puesto de Control Central con acceso a Internet. Se debe poder acceder a los dispositivos RS232 en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo debe permanecer conectado a GPRS el 100% del tiempo a la espera de una conexión. El módem permanecerá a la espera de conexiones entrantes por el puerto TCP Se utilizarán tarjetas telefónicas SIM con dirección IP fija. Solución. módem MTX-65i + software MTX-Tunnel RS232 GPRS GPRS RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 Página 241

242 EJEMPLO de configuración (fichero config.txt) para el escenario indicado que debe contener cada MTX-Tunnel: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: internetestatico.movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i para RS232 MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_port: FIREWALL_enabled: off Puerto TCP del MTX donde se esperará conexiones IP. Firewall desactivado para aceptar conexiones desde cualquier IP Página 242

243 ESCENARIO EJEMPLO 1.2 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS de forma ocasional y usando una tarjeta SIM con dirección IP dinámica. Detalles del escenario ejemplo: Se dispone de 3 dispositivos con puerto RS232 (configurados a 9600,8,N,1 y sin control de flujo) los cuales se necesitan monitorizar desde un puesto de control central mediante un túnel GPRS-serie. Se necesita acceder a los dispositivos serie RS232 muy ocasionalmente para labores de telemantenimiento, por lo que no se necesita que los módems estén permanentemente conectados a GPRS. El módem debe conectarse a GPRS durante 10 minutos cuando reciba una llamada perdida o un SMS con el texto mtxtunnel on desde cualquier número de teléfono. A ese número de teléfono que envíe el SMS o haga la llamada perdida el módem deberá mandar un SMS con la IP que obtenga del operador GSM. El módem permanecerá a la espera de conexiones entrantes por el puerto TCP Solución. módem MTX-65i + software MTX-Tunnel RS232 GPRS GPRS RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 Página 243

244 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 10 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado Control de flujo hardware RTS desactivado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem permanecerá 10 minutos conectado a GPRS si no hay datos. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_port: FIREWALL_enabled: off SMS_allPhones: on SMS_sendIP: on Puerto TCP del MTX donde se esperará conexiones IP. Firewall desactivado para aceptar conexiones desde cualquier IP Todos los números de teléfono serán autorizados Enviaremos la IP al móvil autorizado que haga una llama perdida o envíe un SMS con el texto mtxtunnel on. Detalles. 1.- El parámetro GPRS_timeout: 10 hará que el módem esté con la conexión GPRS activada desde que recibe una llamada perdida o recibe un SMS con el texto mtxtunnel on hasta que pasen 10 minutos sin tráfico GPRS-Serie. Es decir, no debe preocupar que una transferencia dure 30 minutos. Tras esos 30 minutos, si no hay transferencias de datos, en 10 minutos, se cerrará la conexión. Página 244

245 ESCENARIO EJEMPLO 1.3 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Servidor TCP/IP conectado a GPRS de forma ocasional usando una tarjeta SIM con dirección IP dinámica con servicios de Firewall y números de teléfono autorizados activados. Detalles del escenario ejemplo: Se dispone de 3 dispositivos con puerto RS232 (configurados a 9600,8,N,1 y sin control de flujo) los cuales se necesitan monitorizar desde un puesto de control central mediante un túnel GPRS-serie. Se necesita acceder a los dispositivos serie RS232 muy ocasionalmente para labores de telemantenimiento, por lo que no se necesita que los módems estén permanentemente conectados a GPRS. El módem debe conectarse a GPRS durante 10 minutos cuando reciba una llamada perdida o un SMS con el texto mtxtunnel on desde cualquier número de teléfono. A ese número de teléfono que envíe el SMS o haga la llamada perdida el módem deberá mandar un SMS con la IP que obtenga del operador GSM. El módem permanecerá a la espera de conexiones entrantes por el puerto TCP Por motivos de seguridad, los módems sólo deben hacer caso a las llamadas de teléfono o mensajes SMS de activación con los números de teléfono y Adicionalmente el MTX-Tunnel sólo permitirá conexiones realizadas desde la IP de la oficina central, que es la Solución. módem MTX-65i + software MTX-Tunnel RS232 GPRS GPRS RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 Página 245

246 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 10 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado Control de flujo hardware RTS desactivado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem permanecerá 10 minutos conectado a GPRS si no hay datos. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_port: FIREWALL_enabled: on FIREWALL_IP1: Puerto TCP del MTX donde se esperará conexiones IP. Firewall activado para aceptar conexiones desde IPs autorizadas IP autorizada para acceder a los MTX-Tunnel SMS_allPhones: off Todos los números de teléfono NO son autorizados SMS_sendIP: on Enviaremos la IP al móvil autorizado que haga una llama perdida o envíe un SMS con el texto mtxtunnel on. SMS_validPhone1: Número de teléfono autorizado nº 1 SMS_validPhone2: Número de teléfono autorizado nº 2. Detalles. 1.- El parámetro GPRS_timeout: 10 hará que el módem esté con la conexión GPRS activada desde que recibe una llamada perdida o recibe un SMS con el texto mtxtunnel on hasta que pasen 10 minutos sin tráfico GPRS-Serie. Es decir, no debe preocupar que una transferencia dure 30 minutos. Tras esos 30 minutos, si no hay transferencias de datos, en 10 minutos, se cerrará la conexión. Página 246

247 ESCENARIO EJEMPLO 1.4 Túnel básico GPRS-Serie. MTX-Tunnel configurado como Cliente TCP/IP conectado a GPRS de forma permanente usando una tarjeta SIM con dirección IP dinámica. Detalles del escenario ejemplo: Solución. Se dispone de 3 dispositivos con puerto serie RS232 (configurados a 9600,8,N,1 y sin control de flujo) los cuales envían cierta información de forma periódica por su puerto serie y se pretende recoger y almacenar toda esa información desde un PC Servidor ubicado en las oficinas centrales. El PC servidor espera recibir conexiones entrantes de los distintos MTX-Tunnel, es decir, el PC Servidor no se conecta con los MTX-Tunnel, sino que son los MTX-Tunnel quienes se conectarán a la dirección IP de la oficina donde se encuentra el PC Servidor y que es: oficina.midominio.com y puerto TCP Los módems MTX-Tunnel deben permanecer conectados al PC servidor de forma permanente, ya que el envío de información es muy frecuente. Obviamente al ser los MTX- Tunnel quienes se conectan a la IP de la Oficina Central no tiene sentido plantear usar SIM con dirección IP fija, por lo que se usarán SIMs con dirección IP dinámica, mucho más económicas. módem MTX-65i + software MTX-Tunnel RS232 GPRS GPRS RS232 MTXTunnel Equipo con Puerto Serie RS232 de envío de info. RS232 MTXTunnel Equipo con Puerto Serie RS232 de envío de info. Sentido del establecimiento de la conexión TCP/IP. MTXTunnel Equipo con Puerto Serie RS232 de envío de info. Página 247

248 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado Control de flujo hardware RTS desactivado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Servidor de DNS para resolver nombres de dominio a IP El módem permanecerá conectado a GPRS permanentemente MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: client El módem se configura como clienttcp MTX_IDClient: equipox Identificador de MTX-Tunnel, X debe ser diferente para cada módem. MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_IP: oficina.midominio.com TCP_port: IP (DNS) del PC Servidor al que se conectará. Puerto TCP del PC Servidor al que se conectará. Página 248

249 Anexo 2 Escenarios y Configuraciones de Ejemplo Avanzados Página 249

250 ESCENARIO EJEMPLO 2.1 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Servidor TCP/IP permanentemente conectado y configurado para el envío de su IP por socket a un servidor de DNS privado. Detalles del escenario ejemplo: Se dispone de 100 dispositivos con puerto RS232 (115200,8,N,1 y control flujo HW) los cuales se necesitan monitorizar desde un puesto de Control Central vía GPRS, para ello se utilizarán MTX-Tunnel, para que actúen como un túnel transparente GPRS-Serie Se debe poder acceder a los dispositivos RS232 en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo a controlar debe permanecer conectado a GPRS de forma permanente a la espera de una conexión. El acceso a los módems deberá estar únicamente autorizado para la IP del PC de Control ( ) y para una IP del ADSL de backup de las oficinas centrales, cuya IP es: Por motivos de ahorro se utilizarán tarjetas SIM con dirección IP dinámica. Al ser un número elevado de módems se descarta el uso de DynDNS, por lo que debe ser el MTX-Tunnel quien deberá enviar a un servidor DNS privado de un centro de control la IP que tenga en cada momento (asignada por el operador GSM). Cada vez que un módem cambie la dirección IP éste debe enviar al centro de control (con IP y puerto TCP 20000) su nueva IP para informar del cambio. De esa manera desde el PC del Centro de Control siempre se conocerá la IP actual de cada módem. Solución. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) Base de datos IP Servidor DNS: Cada MTXTunnel enviará su IP, cada vez que ésta cambia, a un servidor RS232/485 IP PC Control: MTXTunnel Equipo con Puerto Serie RS232/485 Página 250

251 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_port: FIREWALL_enabled: on FIREWALL_IP1: FIREWALL_IP2: DNS_enabled: on DNS_mode: socket DNS_password: DNS_server: DNS_port: DNS_extended: off Puerto TCP del MTX donde se esperará conexiones IP. Firewall activado para aceptar conexiones desde IPs autorizadas IP autorizada del PC de control IP autorizada del ADSL de backup Servicio envío IP a DNS activado Se informará por vía socket al servidor de DNS Cadena password para mayor seguridad Dirección IP del servidor DNS al que se enviará la IP del módem Puerto TCP del servidor DNS al que se enviará la IP del módem No queremos que envíe el estado de los GPIOs y ADCs Página 251

252 ESCENARIO EJEMPLO 2.2 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Servidor TCP/IP permanentemente conectado y configurado para el envío de su IP a un servidor Web por HTTP GET Detalles del escenario ejemplo: Se dispone de 100 dispositivos con puerto RS232 (115200,8,N,1 y control flujo HW) los cuales se necesitan monitorizar desde un puesto de Control Central vía GPRS, para ello se utilizarán MTX-Tunnel, para que actúen como un túnel transparente GPRS-Serie Se debe poder acceder a los dispositivos RS232 en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo debe permanecer conectado a GPRS de forma permanente a la espera de una conexión. El acceso a los módems deberá estar únicamente autorizado para la IP del PC de Control ( ) y para una IP del ADSL de backup de las oficinas centrales: Por motivos de ahorro se utilizarán tarjetas SIM con dirección IP dinámica. Al ser un número elevado de módems se descarta el uso de DynDNS, por lo que debe ser el MTX-Tunnel quien deberá enviar a un servidor WEB por HTTP GET la IP que tenga en cada momento (asignada por el operador GSM). Cada vez que un módem cambie la dirección IP éste debe enviar al centro de control (con URL y puerto 8080) su nueva IP para informar del cambio. De esa manera el WebServer externo almacenará la IP en una base de datos SQLServer para que el PC del Centro de Control pueda acceder en cada momento a los dispositivos. Solución. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) Base de datos URL Servidor WEB: Cada MTXTunnel enviará su IP, cada vez que ésta cambia, a un servidor WEB RS232 IP PC Control: MTXTunnel Equipo con Puerto Serie RS232/485 Página 252

253 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_rssiLevel: 10 Activamos el led de cobertura del MTX-65i TCP_port: FIREWALL_enabled: on FIREWALL_IP1: FIREWALL_IP2: Puerto TCP del MTX donde se esperará conexiones IP. Firewall activado para aceptar conexiones desde IPs autorizadas IP autorizada del PC de control IP autorizada del ADSL de backup DNS_enabled: on Servicio envío IP a DNS activado DNS_mode: http Se informará por HTTP GET DNS_password: Cadena password para mayor seguridad DNS_server: URL del servidor DNS al que se enviará la IP del módem DNS_extended: off No queremos que envíe el estado de los GPIOs y ADCs Detalles. 1.- Fíjese que, usando http, en caso de usar un puerto TCP distinto al estándar HTTP (TCP 80), el puerto debe incluirse en el parámetro DNS_server y no en DNS_port. 2.- Cada vez que un MTX-Tunnel cambie su IP, llamará a la siguiente URL: Pública> El servidor web deberá recoger los parámetros enviados por el MTX-Tunnel y almacenar la IP en una base de datos. Para recoger los parámetros usando una página ASP, puede hacerse con este simple código insertado en datosip.asp <% IMEI=Request.QueryString( IMEI ) Password=Request.QueryString( PASS ) IP=Request.QueryString( IP ) %> Página 253

254 ESCENARIO EJEMPLO 2.3 Túnel GPRS-RS232 - Configuración del módem como Servidor TCP/IP permanentemente conectado, con DynDNS y con socket Cliente Temporal habilitado Detalles del escenario ejemplo: Solución. Se dispone de una serie de dispositivos con puerto RS232 los cuales se necesitan monitorizar desde un puesto de Control Central vía GPRS. Se debe poder acceder a los dispositivos RS232 en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo debe permanecer conectado a GPRS continuamente a la espera de una conexión. Los módems únicamente aceptarán conexiones entrantes desde la IP de las oficinas centrales: , rechazando cualquier conexión proveniente de otra IP. Por motivos de ahorro se utilizarán tarjetas SIM con dirección IP dinámica. Al no ser un número elevado de dispositivos a controlar no es preciso configurar un servidor privado de DNS (DNS_enabled: off) y bastará con utilizar el servicio proporcionado por DynDNS. Las conexiones de monitorización con los distintos dispositivos desde el puesto de Control Central serán periódicas. En ocasiones puede ocurrir que los dispositivos envíen por el puerto serie una ALARMA. En el caso de no haber una conexión en ese momento establecida entre el PC del puesto de control central y el MTX-Tunnel, el propio MTX-Tunnel debe crear una conexión cliente temporal contra otro servidor (también , puerto 20011) para informar de dicha alarma. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) Base de datos de DynDNS PC Control ADSL El MTXTunnel usa DynDNS para informar de su IP RS232 MTXTunnel Equipo con Puerto Serie RS232 PC receptor Alarmas Si no hay una conexión establecida desde el PC de Control y se reciben datos por el puerto serie, se crea una conexión temporal con el PC receptor de alarmas Página 254

255 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: server MTX_temporalClient: on MTX_urc: off MTX_rssiLevel: 10 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado Control de flujo hardware RTS desactivado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Con 0 el módem estará permanentemente conectado a GPRS. El modelo MTX escogido es el MTX-65i El módem se configura como server TCP Activamos el servicio de Cliente Temporal No necesitamos los mensajes de información URC Activamos el led de cobertura del MTX-65i TCP_IP: TCP_port: Dirección IP del servidor al que se conectará el Cliente Temporal Puerto TCP del MTX donde se esperará conexiones IP que provengan del PC de Control central. También indica el puerto TCP del servidor donde se conectará el Cliente Temporal. FIREWALL_enabled: on FIREWALL_IP1: Sólo se aceptarán conexiones autorizadas Únicamente se aceptarán conexiones desde esta IP DYNDNS_enabled: on DYNDNS_server: members.dyndns.org DYNDNS_hostname: mtxtunnel.dyndns.org DYNDNS_login: usuario DYNDNS_password: mipassword DYNDNS_period: haya Servicio DynDNS activo Servidor de DynDNS de la cuenta creada Nombre de la DNS de un MTX-Tunnel creado en DynDNS Usuario de la cuenta de DynDNS Password de la cuenta de DynDNS Por seguridad cada segundos (3 horas) actualizamos el servidor DynDNS independientemente de que el MTX-Tunnel cambiado la IP o no desde la última actualización. Detalles. 1.- MTX-Tunnel es compatible con DynDNS y NO-IP. Si va a usar no-ip (gratuito) en lugar de dyndns, debe establecer donde indica members.dyndns.org el valor dynupdate.no-ip.com Página 255

256 ESCENARIO EJEMPLO 2.4. Túnel avanzado GPRS-RS232 - Configuración del módem como Servidor TCP/IP conectado ocasionalmente por cambio de GPIO y ADC Detalles del escenario ejemplo: Se dispone de una serie de dispositivos con puerto RS232 los cuales se necesitan monitorizar desde un PC Central mediante un túnel GPRS-serie. Se necesitará acceder a los dispositivos serie RS232 muy ocasionalmente, sólo cuando se solicite desde un SMS o llamada perdida o cuando se detecte un cambio de 0 a 1 en una entrada digital ó mientras la lectura del conversor Analógico/Digital del módem esté por debajo de 500mV o por encima de 1500mV. Por ello, el túnel GPRS-RS232 deberá activarse durante 10 minutos cuando reciba una llamada perdida o un SMS con el texto mtxtunnel on desde cualquier número de teléfono o cuando se detecte la condición indicada para la entrada digital y analógica. En caso de llamada o SMS el MTX-Tunnel deberá devolver un SMS con la IP que obtenga del operador GSM, ya que van a utilizarse tarjetas SIM con dirección IP dinámica. El módem también deberá enviar su IP actual a un servidor del Centro de Control (para informar que se ha producido un evento) junto con la lectura de las GPIOs y ADCs. Solución. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) Base de datos IP Servidor DNS y TELEMETRÍAS: El MTXTunnel enviará la IP y TELEMETRÍAS a un servidor cada vez que se produzca un evento. MTXTunnel RS232/485 Equipo con Puerto Serie RS232/485 PC Control Página 256

257 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 10 MTX_model: MTX-65i MTX_mode: server MTX_urc: off TCP_port: FIREWALL_enabled: off SMS_sendIP: on SMS_alPhones: on Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) El módem permanecerá 10 minutos conectado a GPRS si no hay datos. El modelo MTX escogido es el MTX-65i El módem se configura como server TCP No necesitamos los mensajes de información URC Puerto TCP del MTX donde se esperará conexiones IP. El MTX acepta conexiones desde cualquier IP Enviaremos la IP al móvil autorizado que haga una llama perdida o envíe un SMS con el texto mtxtunnel on. indica que todos los números son autorizados WAKEUP_gpio: on Haremos que se active el túnel GPRS-Serie cuando cambie una GPIO WAKEUP_gpioValue: 1 La activación del túnel lo hará una transición de la entrada de 0 a 1 WAKEUP_adc: on Haremos que se active el túnel GPRS-Serie por el ADC1 WAKEUP_adcValueMin: 500 Un valor menor o igual a 500mV activará el túnel serie-gprs WAKEUP_adcValueMax: 1500 Un valor mayor o igual a 1500mV activará el túnel serie-gprs DNS_server: DNS_mode: socket DNS_password: DNS_port: DNS_extended: on Dirección IP del servidor al que se enviará la IP y telemetrías Se informará por socket Cadena password para mayor seguridad Puerto TCP del servidor al que se enviará la IP y telemetrías Para que envíe el IMEI + las entradas digitales y analógicas Página 257

258 ESCENARIO EJEMPLO 2.5 Túnel dual GPRS-RS232 - Control de dos dispositivos RS232 con un único módem y una única tarjeta SIM. Conexión socket tipo servidor. Detalles del escenario ejemplo: Se pretende controlar 2 dispositivos serie RS232 que están próximos. Para ello, como el módem MTX-65i dispone de 2 puertos serie, se conectará cada puerto serie del módem con uno de los dos dispositivos a controlar, economizando el sistema, al utilizar un único módem y una única tarjeta SIM. Se requiere poder acceder simultáneamente a los 2 dispositivos serie desde un PC de Control, para ello el módem debe escuchar, configurado como servidor, por dos puertos TCP/IP. Por el puerto TCP se podrá acceder al dispositivo serie conectado al COM1 del módem y por el puerto TCP al dispositivo serie conectado al COM2 del módem. El túnel debe permanecer conectado permanentemente. No es necesario configurar un servidor de DNS que se usarán una tarjeta SIM con dirección IP fija. Sólo se permitirá el acceso desde dos IPs del Centro de Control. Cualquier intento de conexión (conexión no autorizada) desde otra IP debe ser abortada. Solución. módem MTX-65i + software MTX-Tunnel (para 2 túneles GPRS-RS232) Conexión de sockets tipo servidor RS232 RS232 Equipo con Puerto Serie RS232/485 Equipo con Puerto Serie RS232/485 Página 258

259 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 Baudios del puerto serie 1 COMM_bitsperchar: 8 8 bits de datos COMM_autocts: on Control de flujo hardware CTS activado COMM_autorts: on Control de flujo hardware RTS activado COMM_stopbits: 1 1 bit de stop. COMM_parity: none Sin paridad. COMM2_baudrate: Baudios del puerto serie 2 COMM2_bitsperchar: 8 8 bits de datos COMM2_stopbits: 1 1 bit de stop. COMM2_parity: none Sin paridad. GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: server MTX_urc: off MTX_rssiLevel: 10 TCP_port: FIREWALL_enabled: on FIREWALL_IP1: FIREWALL_IP2: APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El modelo MTX escogido es el MTX-65i El módem se configura como server TCP No necesitamos los mensajes de información URC Activamos el led de cobertura del MTX-65i Puerto TCP para acceder al dispositivo serie conectado al COM1 Sólo se permitirá el acceso desde IPs autorizadas Dirección IP1 autorizada del Centro de Control Dirección IP2 autorizada del Centro de Control TELNET_enabled: on Usaremos la capacidad telnet para el control del COM 2 TELNET_bypass: on Redirigimos el tráfico TELNET al COM 2 para el control del dispositivo TELNET_port: Puerto TCP para acceder al dispositivo serie conectado al COM2 Detalles. 1.- Recuerde que el MTX-Tunnel es capaz de controlar hasta 2 sockets server. En este caso se está utilizando uno (TCP 20010) para la conexión principal y otro (TCP 20011) para la conexión secundaria. Esto implica que NO es posible activar el WebServer con esta configuración. Página 259

260 ESCENARIO EJEMPLO 2.5-bis Túnel dual GPRS-RS232 - Control de dos dispositivos RS232 con un único módem y una única tarjeta SIM. Conexión socket tipo cliente. Detalles del escenario ejemplo: Se pretende controlar 2 dispositivos serie RS232 que están próximos. Para ello, como el módem MTX-65i dispone de 2 puertos serie, se conectará cada puerto serie del módem con uno de los dos dispositivos a controlar, economizando el sistema, al utilizar un único módem y una única tarjeta SIM. Se requiere que el módem cree simultáneamente dos pasarelas serie-gprs, en modo socket cliente, contra un servidor. Por el puerto TCP del PC servidor se conectará la pasarela que da acceso al dispositivo serie conectado al COM1 del módem y por el puerto TCP del PC se conectará la pasarela que da acceso al dispositivo serie conectado al COM2 del módem. Los dos túneles deben permanecer conectados permanentemente. Solución. módem MTX-65i + software MTX-Tunnel (para 2 túneles GPRS-RS232) IP: Conexión de sockets tipo cliente RS232 RS232 Equipo con Puerto Serie RS232/485 Equipo con Puerto Serie RS232/485 Página 260

261 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 Baudios del puerto serie 1 COMM_bitsperchar: 8 8 bits de datos COMM_autocts: on Control de flujo hardware CTS activado COMM_autorts: on Control de flujo hardware RTS activado COMM_stopbits: 1 1 bit de stop. COMM_parity: none Sin paridad. COMM2_baudrate: Baudios del puerto serie 2 COMM2_bitsperchar: 8 8 bits de datos COMM2_stopbits: 1 1 bit de stop. COMM2_parity: none Sin paridad. GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: client MTX_urc: off MTX_urc: off MTX_IDClient: ID1234ABCD MTX_rssiLevel: 10 TCP_IP: TCP_port: TCP_IP2: TCP_port2: APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El modelo MTX escogido es el MTX-65i El módem se configura como server TCP No necesitamos los mensajes de información URC No necesitamos los mensajes de información URC Cadena identificativa del MTX Activamos el led de cobertura del MTX-65i Dirección IP a la que se conectará la pasarela asociada al COM1 Puerto TCP al que se conectará la pasarela asociada al COM1 Dirección IP a la que se conectará la pasarela asociada al COM2 Puerto TCP al que se conectará la pasarela asociada al COM2 Página 261

262 ESCENARIO EJEMPLO 2.6. Alarma por SMS ante el cambio de una entrada Digital. Detalles del escenario ejemplo: El escenario es muy simple. Tan sólo se necesita enviar un SMS cuando una señal digital proveniente de un circuito externo pasa de 0 a 1. La alarma SMS debe de enviarse por seguridad a 5 números de teléfono ( , , , y ). El texto debe ser, ALARMA DETECTADA. Una vez producida la alarma, la señal digital puede cambiar continuamente, por lo que debe limitarse el envío de SMSs de Alarma a no más de 1 vez a la hora. Solución. módem MTX-65i + software MTX-Tunnel SMS: ALARMA DETECTADA Página 262

263 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_model: MTX-65i MTX_mode: none MTX_urc: off El modelo MTX escogido es el MTX-65i No es necesario un túnel GPRS-Serie No necesitamos los mensajes de información URC ALARM_gpioEnabled: on Activamos el servicio de alarma por SMS por cambio de entrada digital ALARM_gpioValue: 1 La alarma saltará cuando la entrada digital haga el cambio 0 -> 1 ALARM_gpioMessage1: ALARMA DETECTADA Texto de la alarma a enviar por SMS ALARM_gpioPause: 3600 No queremos que el módem mande más de un bloque de SMS por hora. ALARM_smsNumber1: Teléfono 1 de envío de SMS de alarma ALARM_smsNumber2: Teléfono 2 de envío de SMS de alarma ALARM_smsNumber3: Teléfono 3 de envío de SMS de alarma ALARM_smsNumber4: Teléfono 4 de envío de SMS de alarma ALARM_smsNumber5: Teléfono 5 de envío de SMS de alarma Detalles. 1.- Tenga en cuenta que cada modelo de módem MTX tiene una entrada digital especial para las alarmas SMS. La correspondiente a este ejemplo, que utiliza el MTX-65i, es la GPIO2 que corresponde con el PIN11 del conector DB15 del módem. 2.- Nótese que se ha utilizado GPRS_timeout, pese a ser una aplicación que no utiliza GPRS, sólo SMS. Se ha establecido un valor 1 a GPRS_timeout y SMS_allPhones a off sin especificar ningún teléfono autorizado precisamente para que nunca se active la sesión GPRS. Página 263

264 ESCENARIO EJEMPLO 2.7 Cable serie replacer RS232-GPRS-RS232 Detalles del escenario ejemplo: Actualmente se tienen 2 dispositivos RS232 (115200,8,N,1 control flujo HW) unidos por un cable serie por el cual se envían datos. Se pretende substituir dicho cable serie por un enlace transparente RS232-GPRS-RS232 Ninguno de los equipos es un PC, son equipos sin apenas inteligencia y cuyos programas internos de control no pueden modificarse. Es decir, pueden verse como cajas negras con un puerto serie RS232 sin posibilidad de modificar nada, por lo que se necesitará usar un MTX-Tunnel en cada lado de la comunicación, uno actuando como server y otro actuando como client. Uno de ellos, el Server, va a usar una tarjeta SIM con dirección IP fija (aunque podría usarse en este escenario, por simplificar, no se va a usar DynDNS). El Cliente, por su parte, tiene que estar programado para estar siempre conectado a la dirección IP fija del MTX-Tunnel Server, para que el túnel Serie-GPRS-Serie esté siempre establecido. Solución. 2 módem MTX-65i + software MTX-Tunnel El MTXTunnel Client siempre se conecta con el MTXTunnel Server RS232 RS232 Equipo con Puerto Serie RS232 MTXTunnel Client MTXTunnel Server Equipo con Puerto Serie RS232 Página 264

265 Ejemplos de configuración (fichero config.txt) para el escenario indicado. MTX-Tunnel SERVER: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. GPRS_apn: internetestatico.movistar.es APN GPRS proporcionado por el operador GSM GPRS_login: MOVISTAR Login GPRS proporcionado por el operador GSM GPRS_password: MOVISTAR Password GPRS proporcionado por el operador GSM GPRS_timeout: 0 Con 0 el módem estará permanentemente conectado a GPRS. MTX_model: MTX-65i MTX_mode: server TCP_port: El modelo MTX escogido es el MTX-65i para RS232 El módem se configura como server TCP Puerto TCP del MTX donde se esperará conexiones IP. MTX-Tunnel CLIENT: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: client TCP_IP: TCP_port: Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Con 0 el módem estará permanentemente conectado a GPRS. El modelo MTX escogido es el MTX-65i para RS232 El módem se configura como client TCP Dirección IP fija del MTX-Tunnel configurado como Server Puerto TCP del MTX remoto al que conectarse Detalles. 1.- Se está utilizando una tarjeta SIM con dirección IP fija para mayor comodidad, pero el MTX- Tunnel Server podría usar DynDNS si fuera preciso. Página 265

266 ESCENARIO EJEMPLO 2.8 Túnel GPRS-Serie UDP. MTX-Tunnel configurado como Cliente/Servidor UDP conectado a GPRS permanentemente y usando una tarjeta SIM provisionada por el operador con una dirección IP fija. Detalles del escenario ejemplo: Se dispone de 3 dispositivos con puerto RS232 (configurados a ,8,N,1 y control de flujo HW) los cuales se necesitan monitorizar desde un PC situado en puesto de Control Central con acceso a Internet. Se debe poder acceder a los dispositivos RS232 en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo debe permanecer conectado a GPRS el 100% del tiempo. El protocolo a utilizar no va a ser orientado a conexión (TCP), pues se pretende usar UDP para las comunicaciones. Los MTX-Tunnel esperarán paquetes de datos por el puerto UDP enviados desde el PC de control central. Cada vez que se reciba un paquete será retransmitido por el puerto serie. De forma análoga, los paquetes de datos que un MTX- Tunnel recibe por su puerto serie RS232, serán retransmitidos al PC de control vía UDP, hacia el puerto UDP del PC. Se utilizarán tarjetas telefónicas SIM con dirección IP fija. La IP del PC de Control es fija, pero ante previsión de posibles cambios futuros, se usará la DNS oficina.dominio.com en lugar de una IP. Los MTX-Tunnel, por tanto, deberán resolver la DNS. Solución. módem MTX-65i + software MTX-Tunnel UDP UDP RS232 UDP UDP GPRS GPRS RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 UDP RS232 MTXTunnel UDP Equipo a monitorizar con Puerto Serie RS232 MTXTunnel Equipo a monitorizar con Puerto Serie RS232 Página 266

267 EJEMPLO de configuración (fichero config.txt) para el escenario indicado que debe contener cada MTX-Tunnel: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. GPRS_apn: internetestatico.movistar.es APN GPRS proporcionado por el operador GSM GPRS_login: MOVISTAR Login GPRS proporcionado por el operador GSM GPRS_password: MOVISTAR Password GPRS proporcionado por el operador GSM GPRS_DNS: Servidor de DNS al utilizar una DNS en lugar de una IP en UDP_IP GPRS_timeout: 0 Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i para RS232 MTX_mode: udp El módem se configura como udp MTX_urc: off No necesitamos los mensajes de información URC UDP_IP: oficina.dominio.com UDP_localPort: UDP_remotePort: FIREWALL_enabled: off Dirección IP Pública del PC de la oficina Puerto local UDP, donde el módem espera recibir paquetes Puerto remoto UDP, donde el PC de Control espera recibir paquetes Firewall desactivado para aceptar conexiones desde cualquier IP Detalles. 1.- Recuerde que es necesario hacer NAT en el puerto UDP (no TCP) seleccionado (en el caso del ejemplo 20011) del router en el que se encuentre el PC de control. Página 267

268 ESCENARIO EJEMPLO 2.9 Control de Relés por SMS con posibilidad de acceso por WebBrowser al MTX-Tunnel Detalles del escenario ejemplo: Se necesita controlar 4 relés por SMS para activar o desactivar unas luminarias en una ubicación remota. Se pretende que al enviar un SMS con el texto ONx o OFFx, donde x es 1,2,3,4 se activen o desactiven los relés, respectivamente, para ello se necesitarán crear unos ALIAS en el módem. Sólo deben tener poder enviar SMS los 100 números autorizados que tiene la empresa, los cuales empiezan por XX Sólo se necesita el acceso a los relés por SMS, pero debe poderse activar el WEBSERVER del MTX-Tunnel vía SMS (enviando SMS con el texto mtxtunnel on o llamada perdida) en sesiones de 10 minutos para realizar tareas de mantenimiento, como el acceso a los relés desde el navegador de un PC o el cambio de parámetros de configuración. Solución. módem MTX-IND + software MTX-Tunnel SMS Página 268

269 EJEMPLO de configuración (fichero config.txt) para el escenario indicado que debe contener cada MTX-Tunnel: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 10 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Las sesiones GPRS de mantenimiento serán de 10 minutos. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-V1 El modelo MTX escogido es el MTX-IND por los relés MTX_mode: none No necesitamos túneles serie-gprs MTX_urc: off No necesitamos los mensajes de información URC WEBSERVER_enabled: on Habilitamos el servicio WebServer WEBSERVER_login: user El Login de acceso al webserver WEBSERVER_password: 1234 El Password de acceso al webserver WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM FIREWALL_enabled: off SMS_allPhones: off SMS_validPhone1: SMS_ATEnabled: on SMS_ATResponse: on SMS_alias1: ON1>AT^SSIO=0,0 SMS_alias2: OFF1>AT^SSIO=0,1 SMS_alias3: ON2>AT^SSIO=1,0 SMS_alias4: OFF2>AT^SSIO=1,1 SMS_alias5: ON3>AT^SSIO=2,0 SMS_alias6: OFF3>AT^SSIO=2,1 SMS_alias7: ON4>AT^SSIO=6,0 SMS_alias8: OFF4>AT^SSIO=6,1 SMS_aliasOk: Comando Ok SMS_aliasError: Comando Error Firewall desactivado para aceptar conexiones desde cualquier IP Sólo queremos los 100 números de teléfono autorizados Indicamos la parte común de los 100 números de teléfono Se aceptan comandos AT por SMS Se devuelve la respuesta al comando enviado por SMS Activamos el Relé1 cuando se reciba un SMS con ON1 Desactivamos el Relé1 cuando se reciba un SMS con OFF1 Activamos el Relé2 cuando se reciba un SMS con ON2 Desactivamos el Relé2 cuando se reciba un SMS con OFF2 Activamos el Relé3 cuando se reciba un SMS con ON3 Desactivamos el Relé3 cuando se reciba un SMS con OFF3 Activamos el Relé7 cuando se reciba un SMS con ON4 Desactivamos el Relé7 cuando se reciba un SMS con OFF4 Se envía este texto por SMS si el comando SMS se ejecutó bien Se envía este texto por SMS si el comando SMS se ejecutó mal Detalles. 1.- Recuerde que los relés del módem MTX-IND van marcados como RL1, RL2, RL3 y RL7 y que corresponden a las GPIO1, GPIO2, GPIO3 y GPIO7 respectivamente. Página 269

270 ESCENARIO EJEMPLO 2.10 Túnel GPRS-Serie con seguridad SSL. MTX-Tunnel configurado como Cliente TCP/IP conectado a GPRS de forma permanente usando una tarjeta SIM con dirección IP dinámica. Detalles del escenario ejemplo: Solución. Se dispone de 3 dispositivos con puerto serie RS232 (configurados a 9600,8,N,1 y sin control de flujo) los cuales envían cierta información de forma periódica por su puerto serie y se pretende recoger y almacenar toda esa información desde un PC Servidor ubicado en las oficinas centrales. El PC servidor espera recibir conexiones entrantes de los distintos MTX-Tunnel, es decir, el PC Servidor no se conecta con los MTX-Tunnel, sino que son los MTX-Tunnel quienes se conectarán a la dirección IP de la oficina donde se encuentra el PC Servidor y que es: oficina.midominio.com y puerto TCP El software de control del PC Servidor soporta comunicaciones socket SSL, y al ser muy sensible la información transferida, se pretende evitar que, ni utilizando un sniffer ethernet (dentro de la propia red LAN donde se haya el PC Servidor) pueda accederse a dicha información. Los módems MTX-Tunnel deben permanecer conectados al PC servidor de forma permanente, ya que el envío de información es muy frecuente. Obviamente al ser los MTX- Tunnel quienes se conectan a la IP de la Oficina Central no tiene sentido plantear usar SIM con dirección IP fija, por lo que se usarán SIMs con dirección IP dinámica, mucho más económicas. módem MTX-65i + software MTX-Tunnel RS232 GPRS GPRS RS232 MTXTunnel Equipo con Puerto Serie RS232 de envío de info. RS232 MTXTunnel Equipo con Puerto Serie RS232 de envío de info. Sentido del establecimiento de la conexión TCP/IP. MTXTunnel Equipo con Puerto Serie RS232 de envío de info. Página 270

271 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado Control de flujo hardware RTS desactivado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Servidor de DNS para resolver nombres de dominio a IP El módem permanecerá conectado a GPRS permanentemente MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: client El módem se configura como clienttcp MTX_IDClient: equipox Identificador de MTX-Tunnel, X debe ser diferente para cada módem. MTX_urc: off No necesitamos los mensajes de información URC MTX_clientSSL: on Las comunicaciones serán SSL TCP_IP: oficina.midominio.com TCP_port: IP (DNS) del PC Servidor al que se conectará. Puerto TCP del PC Servidor al que se conectará Detalles. 1.- Recuerde que el MTX-Tunnel sólo puede establecer conexiones SSL cuando éste trabaja en modo cliente. 2.- El uso de SSL sólo debería emplearse en situaciones muy concretas donde la seguridad puede estar claramente comprometida, como servidores alojados en una empresa externa. El uso de SSL implica mayor lentitud en las comunicaciones (debido al mayor volumen de información enviada y a la carga de procesado que debe efectuar el MTX-Tunnel durante el proceso de encriptación. Página 271

272 ESCENARIO EJEMPLO 2.11 Envío de telemetrías y posición GPS a un Servidor Web por HTTP de forma ocasional. Ejemplo antirrobo / antisecuestro. Detalles del escenario ejemplo: Se dispone de una serie de vehículos a los cuales se les quiere dotar de un sistema de seguridad por GPS. En caso de robo o secuestro del vehículo (habrá un sensor de alarma conectado a una entrada digital del módem, el MTX-Tunnel debe de enviar automáticamente un SMS a 3 números de teléfono determinados (para indicar que ha habido una alarma) e iniciar una sesión GPRS durante 3 horas. Después, cada 30 segundos, el MTX-Tunnel debe enviar la posición GPS y las telemetrías del vehículo a un Servidor WEB ubicado en las oficinas centrales, con el fin de hacer un seguimiento del vehículo sustraído. El MTX-Tunnel debe activar también su propio servidor web interno. En caso de que el vehículo robado sea introducido en un camión o en un parking subterráneo (es decir, en caso de que no haya cobertura GPS) debe poderse acceder al webserver interno del MTX- Tunnel para poder observar la posición de localización por celdas GSM (que devolverá una posición GPS aproximada) Así mismo, el MTX-Tunnel tendrá una salida digital adaptada, conectada al sistema de alimentación del vehículo, para poderlo detener remotamente si es totalmente preciso. Solución. módem MTX-65i-GPS-V6 + software MTX-Tunnel GPS Satellites WEBSERVER Consulta a WebServer El MTXTunnel envía GPS y telemetrías a WEB server Datos GPS SMS alarma MTXTunnel Página 272

273 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i-GPS-V6 El modelo MTX escogido (con GPS) MTX_mode: none No se precisa ningún túnel GPRS-Serie MTX_IDClient: equipox Identificador de MTX-Tunnel, X debe ser diferente para cada módem. MTX_urc: off No necesitamos los mensajes de información URC GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 60 TCP_port: FIREWALL_enabled: off APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Servidor de DNS para resolver nombres de dominio a IP Cuando la sesión GPRS se active lo estará al menos 1 hora Puerto TCP del MTX donde se esperará conexiones IP (a su webserver) Firewall desactivado. DNS_enabled: on Servicio envío IP / telemetrías a DNS activado DNS_mode: http Se informará por HTTP GET DNS_password: Cadena password para mayor seguridad DNS_server: URL del servidor al que se enviará la IP y telemetrías del módem. DNS_extended: on Queremos que el MTX-Tunnel envíe el estado de los GPIOs y ADCs DNS_period: 30 Cuando salte la alarma (se activará GPRS) se enviará posición y telemetrías cada 30 segundos. WEBSERVER_enabled: on Habilitamos el servicio WebServer WEBSERVER_login: user El Login de acceso al webserver WEBSERVER_password: 1234 El Password de acceso al webserver WEBSERVER_skin: /webserverimg/ WEBSERVER_gsmScript: WEBSERVER_gpsScript: Skin del WebServer Script localiz. GSM Script localiz. GPS WAKEUP_gpioEnabled: on Habilitamos la activación de sesión GPRS por cambio en GPIO WAKEUP_gpioValue: 1 Se activará la sesión GPRS cuando GPIO valga 1 ALARM_gpioEnabled: on Habilitamos el servicio de alarmas SMS por GPIO ALARM_gpioValue: 1 Se enviará la alarma SMS cuando GPIO valga 1 ALARM_gpioMessage: ALARMA ROBO Mensaje de alarma SMS ALARM_gpioPause: 300 No se enviará más de 1 SMS de alarma cada 5 minutos ALARM_smsNumber1: Nº de teléfono 1 al que se enviará la alarma SMS ALARM_smsNumber1: Nº de teléfono 1 al que se enviará la alarma SMS ALARM_smsNumber1: Nº de teléfono 1 al que se enviará la alarma SMS Detalles. 1.- Recuerde que el pin usado por el MTX-65i-GPS-V6 para WAKEUP es el GPIO5 (PIN5 del conector RJ11 del módem). Página 273

274 2.- El PIN usado para las alarmas SMS en el módem MTX-65i-GPS-V6 es el GPIO9, que corresponde con el PIN 4 del conector DB15. Página 274

275 ESCENARIO EJEMPLO 2.12 Envío de telemetrías periódico (GPIOs y ADCs) a Servidor WEB por HTTP. Detalles del escenario ejemplo: Se pretende monitorizar el nivel de un depósito de agua. Para ello, se utilizará una entrada analógica de un módem gprs. Se pretende que el módem esté permanentemente conectado a GPRS y usando una tarjeta con dirección IP dinámica. El módem debe tomar una medida cada 5 minutos y enviárselo a un servidor Web vía gprs mediante HTTP GET para que éste cree un fichero LOG con las estadísticas de consumo diario. Así mismo, se debe poder acceder al webserver interno del módem para comprobar en tiempo real el estado del depósito. Desde el webserver interno también se debe poder actuar sobre un relé que permite la entrada de caudal en el depósito. El acceso al webserver será sin firewall (desde cualquier IP), pero protegido por usuario y contraseña. Solución. módem MTX-IND + software MTX-Tunnel WEBSERVER Consulta a WebServer El MTXTunnel envía telemetrías a WEB server MTXTunnel Página 275

276 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-V1 El modelo MTX escogido es el MTX-IND-V1 MTX_mode: none El módem se configura como nada (no usaremos gateway serie-gprs) MTX_urc: off No necesitamos los mensajes de información URC TCP_port: FIREWALL_enabled: off Puerto TCP del MTX donde se esperará conexiones IP (a su webserver) Firewall desactivado. WAKEUP_gpioEnabled: on Se activará la sesión GPRS por una entrada digital WAKEUP_value: 0 Se activará cuando la entrada digital valga 0. DNS_enabled: on Servicio envío IP a DNS activado DNS_mode: http Se informará por HTTP GET DNS_password: Cadena password para mayor seguridad DNS_server: URL del servidor al que se enviará la IP y telemetrías del módem. DNS_extended: on Queremos que el MTX-Tunnel envíe el estado de los GPIOs y ADCs DNS_period: 300 Queremos enviar los valores cada 300 segundos (5 minutos) WEBSERVER_enabled: on Habilitamos el servicio WebServer WEBSERVER_login: user El Login de acceso al webserver WEBSERVER _password: 1234 El Password de acceso al webserver WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM Página 276

277 ESCENARIO EJEMPLO 2.13 Envío de telemetrías (GPIOs y ADCs) por detección de cambio digital y entradas analógicas fuera de rango. Detalles del escenario ejemplo: Se pretende monitorizar el estado de 6 entradas digitales y 2 entradas analógicas. El MTX-Tunnel debe detectar cuando cambian una o varias entradas digitales y enviar el estado de éstas a un servidor central vía un socket TCP/IP mediante GPRS. También se necesita que se monitoricen 2 entradas analógicas. Debe enviarse una trama de estado a un servidor central vía GPRS cuando una entrada analógica esté por encima de 1200mV+250mV o cuando esté por debajo de 1200mV-250mV. Así mismo se necesita poder activar en paralelo a las telemetrías una pasarela GPRS- RS232 para la telelectura de un dispositivo. No se usarán tarjetas SIM con dirección IP fija, ya que la trama con el estado de las entradas digitales y analógicas también se enviará cada vez que se detecte un cambio de dirección IP, de esa manera, en el servidor, siempre se tendrá la dirección IP actual del MTX-Tunnel. Solución. módem MTX-IND + software MTX-Tunnel Server: Consulta a Server la IP El MTXTunnel envía telemetrías a server MTXTunnel Equipo RS232 Página 277

278 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 Baudios del puerto serie 1 para la pasarela GPRS-RS232 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND MTX_mode: server El módem se configura como server MTX_urc: off No necesitamos los mensajes de información URC TCP_port: FIREWALL_enabled: off Puerto TCP del MTX donde se esperará conexiones IP Firewall desactivado. Se aceptarán conexiones desde cualquier IP DNS_enabled: on Servicio envío IP a DNS activado DNS_mode: socket Se informará por socket TCP/IP DNS_password: Cadena password para mayor seguridad DNS_server: URL del servidor al que se enviará la IP y telemetrías del módem. DNS_port: Puerto TCP del servidor al que se enviará la IP y telemetrías del módem. DNS_extended: on Queremos que el MTX-Tunnel envíe el estado de los GPIOs y ADCs DNS_gpios: on Enviará las telemetrías cuando se detecte cambio en Opios DNS_adc1: 1200 Enviará las telemetrías ante cambio entrada analógica 1 DNS_adc2: 1200 Enviará las telemetrías ante cambio entrada analógica 2 Detalles. 1.- El mensaje GPRS enviado al servidor tiene el siguiente formato: #IMEI#DNS_password#IPPublica#gpio1#gpio2#gpio3#gpio4#gpio5#gpio6#gpio7# gpio8#gpio9#gpio10#adc1#adc2# Página 278

279 ESCENARIO EJEMPLO 2.14 Envío de telemetrías periódicas (entradas digitales y analógicas) mediante objeto JSON a servidor WEB Detalles del escenario ejemplo: Se debe enviar 6 entradas digitales y 2 entradas analógicas a un servidor web mediante un objeto JSON. El MTX recogerá los datos digitales y analógicos cada 10 minutos, enviándolos al servidor web mediante un objeto JSON. En caso de no haber cobertura GPRS o no estar disponible el servidor web, el MTX debe almacenar en memoria los registros leídos (un máximo de 1000 registros). Así mismo se necesita poder activar en paralelo a las telemetrías una pasarela GPRS- RS232 para la telelectura de un dispositivo. Por comodidad se dispone de SIM con dirección IP fija. Solución. módem MTX-IND + software MTX-Tunnel Server: Consulta a Server la IP El MTXTunnel envía telemetrías a server MTXTunnel Equipo RS232 Página 279

280 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Baudios del puerto serie 1 para la pasarela GPRS-RS232 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND MTX_mode: server El módem se configura como server MTX_urc: off No necesitamos los mensajes de información URC TCP_port: FIREWALL_enabled: off Puerto TCP del MTX donde se esperará conexiones IP Firewall desactivado. Se aceptarán conexiones desde cualquier IP LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1000 El número máximo de registros dentro del MTX LOGGER_ioPeriod: 600 Cada 10 minutos se leerán y enviar las entradas digitales y analógicas del módem. Detalles. 1.- El objeto JSON enviado vía GPRS al servidor tendría el siguiente formato de ejemplo {"IMEI": ,"P":"ID00001","TS":"11/11/12 08:31:44","IO1":1,"IO2":0,"IO3":1,"IO4":1, IO5 :0, IO6 :0, IO7 :1, IO8 :0, IO9 :1, IO10 :0, A D1 :1250, AD2 :1700} Página 280

281 ESCENARIO EJEMPLO 2.15 Pasarela GPRS ModBus TCP / ModBus RTU. Detalles del escenario ejemplo: Se dispone de una serie de dispositivos ModBus RTU con puerto RS485 (configurados a 9600bps) los cuales se necesitan monitorizar desde un PC situado en puesto de Control Central con acceso a Internet y que cuenta con un software de gestión de equipos vía ModBus TCP. Por ello el MTX-Tunnel debe implementar una pasarela ModBus TCP / ModBus RTU Se debe poder acceder a los dispositivos ModBus RTU en cualquier momento, por lo que el módem conectado al puerto serie del dispositivo debe permanecer conectado a GPRS el 100% del tiempo a la espera de una conexión. El módem permanecerá a la espera de conexiones entrantes por el puerto estándar ModBus TCP 502. Se utilizarán tarjetas telefónicas SIM con dirección IP fija para mayor facilidad (pero podría usarse DynDNS o un servidor de DNS privado en caso de querer IP dinámica). Solución. módem MTX-IND + software MTX-Tunnel Software ModBus TCP MTXTunnel Bus RS485 Equipo RS485 ModBus RTU Equipo RS485 ModBus RTU Equipo RS485 ModBus RTU Equipo RS485 ModBus RTU Página 281

282 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS no activado Control de flujo hardware RTS no activado 1 bit de stop. Sin paridad. GPRS_apn: internetestatico.movistar.es APN GPRS proporcionado por el operador GSM GPRS_login: MOVISTAR Login GPRS proporcionado por el operador GSM GPRS_password: MOVISTAR Password GPRS proporcionado por el operador GSM GPRS_timeout: 0 Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-V1 El modelo MTX escogido es el MTX-IND-V1 MTX_mode: server El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_gatewayModBus: on Activamos la pasarela ModBus TCP ModBus RTU TCP_port: 502 FIREWALL_enabled: off Puerto TCP del MTX donde se esperará conexiones IP. Standard ModBus Firewall desactivado para aceptar conexiones desde cualquier IP Página 282

283 ESCENARIO EJEMPLO 2.16 Envío de replicación de entradas digitales en relés vía GPRS Detalles del escenario ejemplo: Se debe poder replicar el estado de 4 entradas digitales de un módem MTX-IND (1) en los relés de otro módem remoto MTX-IND (2) El MTX-IND (1), cada vez que cambie el estado de una de sus entradas digitales, enviará el cambio de éstas a otro módem MTX-IND (2) para que conmute el relé apropiado. Por simplicidad, aunque se podría llegar a usar DynDNS en el módem MTX-IND (2) vamos a suponer que se utiliza una tarjeta SIM con dirección IP fija. Solución. 2 módem MTX-IND-V1 + software MTX-Tunnel 4 Entradas digitales MTX-IND-V1 (1) MTX-IND-V1 (2) Página 283

284 EJEMPLO de configuración (fichero config.txt) para del módem MTX-IND (1): GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-V1 El modelo MTX escogido es el MTX-IND-V1 MTX_mode: server El módem se configura como server MTX_ping: 35 Para asegurar conexión permanente MTX_pingIP: El ping de comprobación de conexión lo haremos contra google MTX_ATEmbeddedPass: ABCD Para más seguridad, especificamos un password en las comunicaciones con el MTX-IND (2) DNS_enabled: on Activamos el DNS para el envío de tramas DNS_mode: remoteat Envía una trama especial con un comando AT remoto de GPIOs DNS_server: La IP fija del MTX-IND (2) DNS_port: El puerto TCP del MTX-IND (2) DNS_period: 300 Cada 5 minutos se enviarán por seguridad las E/S DNS_gpios: on Se van a enviar las entradas digitales, por lo que se pondrá a on EJEMPLO de configuración (fichero config.txt) para del módem MTX-IND (2): GPRS_apn: internetestatico.movistar.es APN GPRS proporcionado por el operador GSM GPRS_login: MOVISTAR Login GPRS proporcionado por el operador GSM GPRS_password: MOVISTAR Password GPRS proporcionado por el operador GSM GPRS_timeout: 0 Con 0 el módem estará permanentemente conectado a GPRS. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-V1 El modelo MTX escogido es el MTX-IND-V1 MTX_mode: server El módem se configura como server MTX_ping: 35 Para asegurar conexión permanente MTX_pingIP: El ping de comprobación de conexión lo haremos contra google MTX_ATEmbedded: on Activamos la recepción de comandos AT remotos MTX_ATEmbeddedPass: ABCD Para más seguridad, especificamos un password en las comunicaciones con el MTX-IND (1) TCP_port: puerto TCP a la escucha FIREWALL_enabled: off No se quiere el firwarell activo, ya que no se conoce la IP de (1) Página 284

285 ESCENARIO EJEMPLO 2.17 Túnel avanzado GPRS-Serie - Configuración del MTX-Tunnel como Cliente TCP/IP con conexión de 3 veces a la hora. Detalles del escenario ejemplo: Se dispone de 100 dispositivos con puerto RS232 (115200,8,N,1 y control flujo HW) los cuales se necesitan monitorizar desde un puesto de Control Central vía GPRS, para ello se utilizará MTX-Tunnel, para que actúen como un túnel transparente GPRS-Serie Los módem serán los que se conecten periódicamente, cada 20 minutos y durante 5 minutos, a un servidor central mediante un socket TCP cliente. Una vez conectados al servidor central, los módems deben identificarse enviando una cadena identificativa+imei. Tras el envío con la cadena identificativa, el módem debe establecer una pasarela GPRS-RS232 transparente durante los 5 minutos. Para poder acceder al mantenimiento remoto del módem, el módem debe tener habilitado el servicio Telnet y la configuración por SMS. Solución. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) Base de datos IP Servidor ipservidor.midominio.com Cada 20 minutos se establecerá una conexión RS232/485 IP PC Control: MTXTunnel Equipo con Puerto Serie RS232/485 Página 285

286 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 5 GPRS_autoTimeout: off Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM La pasarela durará 5 minutos La duración de 5 minutos no se reinicia en cada dato recibido MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i (indicar MTX-IND para RS485) MTX_mode: client El módem se configura como server TCP MTX_urc: off No necesitamos los mensajes de información URC MTX_IDClient: ID0001 Identificador del módem MTX_IDClientExtended: imei Además del identificador queremos que envíe el IMEI MTX_TPServer: null No queremos que use un servidor de tiempo real, ya que para una temporización de 20 minutos no necesitamos una hora exacta. MTX_alwaysConnectedClient: off Si cerramos el socket desde el servidor no queremos que se vuelva a establecer hasta la siguiente vez. WAVEUP_timeEnabled: on WAVEUP_time1: XXXX00 WAVEUP_time2: XXXX20 WAVEUP_time3: XXXX40 TCP_IP: ipservidor.midominio.com TCP_port: FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off SMS_allPhones: on SMS_ATEnabled: on SMS_ATResponse: on Queremos una temporización por hora El socket se establecerá en el minuto 00 de cada hora El socket se establecerá en el minuto 20 de cada hora El socket se establecerá en el minuto 40 de cada hora DNS (o IP) donde se conectará el módem Puerto TCP del servidor donde se conectará el módem Firewall no activado Habilitamos el Telnet para poder enviar comandos remotos, configs, Login de Telnet Password de telnet El MTX acepta conexiones telnet desde cualquier IP Todos los teléfonos son autorizados Habilitamos los comandos AT por SMS Habilitamos las respuestas por SMS a los comandos AT enviados Página 286

287 ESCENARIO EJEMPLO 2.18 Túnel avanzado GPRS-Serie - Envío y recepción de datos a múltiples servidores mediante paquetes de datos UDP Detalles del escenario ejemplo: Se dispone de un dispositivo con puerto RS232 (9600,8,N,1 y sin control flujo HW). Este dispositivo, cuando genera una alarma, envía un paquete de datos que debe ser enviado a 3 servidores diferentes por motivo de seguridad. La comunicación con los servidores debe ser mediante paquetes de datos UDP. Las direcciones de los distintos servidores son: , y Los 3 servidores esperan recibir los datos en el puerto UDP Así mismo, los servidores también deben de poder enviar datos al dispositivo por temas de configuración y supervisión. Enviarán los paquetes de datos al puerto UDP Solución. módem MTX-65i + software MTX-Tunnel (para túnel GPRS-RS232) IP Servidor: GPRS RS232/485 IP Servidor: MTXTunnel Equipo con Puerto Serie RS232/485 IP Servidor: Página 287

288 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autocts: off COMM_autorts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Sin control de flujo Sin control de flujo 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Conexión GPRS activa el 100% del tiempo MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i (indicar MTX-IND para RS485) MTX_mode: udp El módem se configura como UDP MTX_urc: off No necesitamos los mensajes de información URC UDP_IP: , , Las direcciones de los 3 servidores, separadas por comas UDP_remotePort: Puerto UDP remoto de los servidores a donde se enviarán los datos UDP_localPort: Puerto UDP local a donde los servidores enviarán los datos FIREWALL_enabled: off Firewall no activado Página 288

289 ESCENARIO EJEMPLO 2.19 Pasarela GPRS-Serie con envío de datos a un servidor de las tramas que empiecen únicamente por una cabecera concreta. Detalles del escenario ejemplo: Aunque el MTX-Tunnel permite realizar lecturas de dispositivos ModBus de forma autónoma (ver ejemplos de los Anexos 6), en este ejemplo consideraremos que es un PLC el que va a hacer de master en una comunicación MODBUS con una red de contadores. El PLC únicamente permite el uso de protocolo MODBUS y se desea poder enviar ciertos datos de los contadores a un servidor central Para ello el PLC considerará el MTX-Tunnel como un dispositivo modbus (esclavo) más, con Es decir, el MTX-Tunnel debe enviar vía GPRS no todo el tráfico del bus RS485 (es decir, no todo el tráfico entre el PLC de control y los contadores), sino únicamente las tramas que vayan encaminadas a la de esa manera, en el servidor central únicamente se recibirán dichos datos. La comunicación debe ser en modo TCP Client, es decir, el MTX-Tunnel debe conectarse en modo cliente contra la IP del servidor ( ) y puerto TCP Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i-RS485 Contador modbus BUS 485 Contador modbus IP: Puerto TCP: Contador modbus PLC de control MODBUS Contador modbus Página 289

290 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Velocidad del puerto serie de comunicación con contadores Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente MTX_PIN: 0000 El PIN de la tarjeta SIM MTX_mode: client Modo de trabajo TCP client MTX_model: MTX-65i-RS485 Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel MTX_ping: 35 Cada 35 minutos sin comunicaciones, haremos un ping MTX_pingIP: Dirección donde se realiza el ping MTX_radioBand: europe No necesario. Se indica Europe si el MTX se instala en Europa MTX_filter: 100 Se enviarán únicamente las tramas que empiecen por el byte 100 MTX_msToSend: 200 Pausa mínima (ms) sin datos para ser considerada trama nueva TCP_IP: TCP_port: Dirección IP del servidor a donde se conectará el MTX-Tunnel Pausa mínima (ms) sin datos para ser considerada trama nueva Detalles. 1.- En una trama MODBUS el primer byte indica la dirección. Por ello, al especificar en el parámetro MTX_filter el valor 100, únicamente las tramas que empiecen por 100 serán enviadas al servidor central. 2.- Si por ejemplo se quisiera reenvíar al servidor únicamente las tramas cuyo comando modbus fuera el de escritura (0x10), como este, el byte de comando, es el segundo byte en una trama modbus, el parámetro MTX_filter tendría que ser: MTX_filter: 100,16 (100 corresponde a la dirección modbus 100 y 16 al valor decimal del comando 0x10) Página 290

291 ESCENARIO EJEMPLO 2.20 Conversión de un sistema basado con antiguas comunicaciones GSM en un sistema de comunicaciones IP (GPRS) Detalles del escenario ejemplo: Se dispone de una serie de PLCs antiguos los cuales usan un módem GSM para realizar y recibir llamadas GSM convencionales. Se pretende cambiar el antiguo sistema de comunicaciones basado en GSM por otro con comunicaciones GPRS modificando lo menos posible el sistema anterior. Es decir, sin modificar el software del PLC y modificando lo menos posible el software del PC servidor. Cada PLC debe poder realizar llamadas como hasta ahora y debe poder recibirlas, pero en lugar de realizar llamadas GSM, serán conexiones IP (GPRS). Es decir, únicamente será necesario substituir el módem GSM actual del PLC por un módem MTX + MTX-Tunnel. De la misma manera será necesario substituir el módem GSM conectado al PC servidor por un software conversor TCP/RS232 Para ello el módem MTX se comporta de la siguiente manera. Para emular la recepción de llamadas GSM el módem permanece a la escucha en un puerto TCP. En esta aplicación el puerto escogido es el TCP Cuando recibe una conexión GPRS contra dicho puerto TCP el módem MTX debe establecer una pasarela GPRS-Serie de la misma manera que lo haría con una llamada GSM convencional. Por otro lado debe poderse establecer una conexión GPRS desde el PLC emulando una llamada GSM. Para ello el PLC enviará el típico comando de conexión GSM ATD xxx.xxx.xxx.xxx (como si fuera una llamada GSM pero especificando una dirección IP o DNS en lugar de un teléfono). El MTX-Tunnel debe conectarse a esa dirección también a través del puerto El PLC controlará la línea DTR del módem, cortando las comunicaciones GPRS con dicha línea. El módem enviará CONNECT al establecerse/recibirse una conexión y NO CARRIER cuando esta finalice. Solución. módem MTX-65i + software MTX-Tunnel Página 291

292 RS232 GSM RED GSM GSM Modem GSM GSM Modem GSM Equipo a monitorizar con Puerto Serie RS232 GSM RS232 RS232 Módem GSM Equipo a monitorizar con Puerto Serie RS232 Modem GSM Equipo a monitorizar con Puerto Serie RS232 Migración de Sistema basado en GSM a sistema basado en GPRS sin modificar software de equipos RS232. Únicamente substituyendo módems. RS232 GPRS INTERNET GPRS MTX-65i + MTXTunnel GPRS MTX-65i + MTXTunnel Equipo a monitorizar con Puerto Serie RS232 GPRS RS232 RS232 MTX-65i + MTXTunnel Equipo a monitorizar con Puerto Serie RS232 MTX-65i + MTXTunnel Equipo a monitorizar con Puerto Serie RS232 Página 292

293 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none Velocidad del puerto serie de comunicación con el PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad GPRS_apn: movistar.es APN GPRS proporcionado por el operador GSM GPRS_login: MOVISTAR Login GPRS proporcionado por el operador GSM GPRS_password: MOVISTAR Password GPRS proporcionado por el operador GSM GPRS_timeout: 10 Obligatorio para este escenario un valor >5 GPRS_autoTimeout: off Obligatorio para este escenario a off MTX_PIN: 0000 MTX_mode: server MTX_model: MTX-65i MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe MTX_ATMux: modem MTX_urc: modem MTX_DTR: modem TCP_port: El PIN de la tarjeta SIM Modo de trabajo TCP ser ver. Obligatorio en este escenario Modelo de MTX-65i donde está instalado el MTX-Tunnel Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Modo obligatorio para este escenario. Obligatorio para recibir CONNECT y NO CARRIER Obligatorio para este escenario Puerto TCP para escuchar conexiones y realizarlas Página 293

294 ESCENARIO EJEMPLO 2.21 Alarmas SMS ante detección de pérdida de alimentación 220V y ante el retorno de alimentación. Detalles del escenario ejemplo: Se precisa monitorizar un sistema de alimentación 220V para prevenir la mercancía de unos congeladores industriales. Para ello se va a utilizar un módem con batería. Este módem debe enviar una alerta por SMS a 5 números de teléfono diferentes cuando se detecte un fallo de alimentación 220V. Debe hacer lo mismo cuando detecte que la alimentación se ha recuperado. Solución. módem MTX-65+G + software MTX-Tunnel SMS: FALLO ALIMENTACIÓN 220V Página 294

295 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65-GPS-V3 El PIN de la tarjeta SIM Modo de trabajo ninguno Modelo de MTXdonde está instalado el MTX-Tunnel ALARM_powerEnabled: on Alarma SMS por fallo alimentación habilitada ALARM_powerMessageOn: Alimentación on Texto alarma alimentación reestablecida ALARM_powerMessageOff: FALLO ALIMENTACIÓN 220V: Texto alarma por fallo alimentación ALARM_smsNumber1: Teléfonos de envío de alarma ALARM_smsNumber2: ALARM_smsNumber3: ALARM_smsNumber4: ALARM_smsNumber5: Página 295

296 ESCENARIO EJEMPLO 2.22 Uso del MTX-Tunnel como pasarela GPRS-RS232 y como elemento de Sincronización horaría de un dispositivo externo conectado al módem. Detalles del escenario ejemplo: Un sistema PLC precisa de una pasarela GPRS-RS232 para enviar datos a un servidor central y para recibir órdenes de configuración. El módem debe permanecer a la escucha, a la espera de una conexión por parte del servidor, en el puerto TCP Por otro lado, el PLC puede enviar alarmas al servidor. En caso de que el módem reciba datos por el puerto serie (una alarma) debe abrir un socket cliente contra el servidor para enviar los datos. La IP destino de las alarmas será la El puerto de conexión será también el TCP Así mismo el PLC debe poder usar el módem para sincronizar la hora. Debe configurarse el MTX-Tunnel para que se sincronice la hora automáticamente y periódicamente con un servidor externo. Así mismo debe poderse leer la hora del módem desde el PLC con un comando. El puerto serie del PLC funciona a 9600bps, 8 bits de datos, 1 bit de stop y sin paridad. Solución. módem MTX-65i + software MTX-Tunnel IP: Puerto TCP: <MTXTUNNEL>AT+CCLK?</MTXTUNNEL> Página 296

297 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: server MTX_model: MTX-65i MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe MTX_temporalClient: on MTX_urc: off MTX_rssiLevel: 10 MTX_ATMux: on MTX_ATLimited: off Velocidad del puerto serie de comunicación con el PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie en modo server Modelo de MTX donde está instalado el MTX-Tunnel Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Activamos el servicio de Cliente Temporal No necesitamos los mensajes de información URC Activamos el led de cobertura del MTX-65i Activamos los comandos AT embebidos para poder enviar comandos por el puerto serie (para averiguar la hora) Para poder ejecutar cualquier comando AT sin estar limitado a los indicados en el manual. TCP_IP: TCP_port: Dirección IP del servidor al que se conectará el Cliente Temporal Puerto TCP del MTX donde se esperará conexiones IP que provengan del PC de Control central. También indica el puerto TCP del servidor donde se conectará el Cliente Temporal. Página 297

298 ESCENARIO EJEMPLO 2.23 Uso del MTX-Tunnel como Logger de tramas serie. Detalles del escenario ejemplo: Se dispone de un dispositivo no inteligente que envía tramas de bytes por su puerto serie cada 10 segundos, correspondientes a una medida de un sensor. Las tramas serie serán máximo de 256 bytes. Para la aplicación recoger una lectura cada 10 segundos resulta excesivo. El MTX deberá recoger sólo 1 lectura cada minuto (descartando por tanto 5 de cada minuto) y enviarla a una plataforma web El módem debe enviar los datos serie recogidos adjuntando la hora mediante un objeto JSON a una plataforma web. La configuración del puerto serie del equipo es baudios, 8,N,1. Solución. módem MTX-65i + software MTX-Tunnel Plataforma WEB IP: x23 0x92 0x23 0x56 0xF5 0xAA 0xA9 Página 298

299 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_ATEmbedded: on MTX_radioBand: europe MTX_rssiLevel: 10 MTX_ATLimited: off Velocidad del puerto serie de comunicación Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie en modo none Modelo de MTX donde está instalado el MTX-Tunnel Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping Para poder enviar comandos AT desde la plataforma web No necesario. Se indica Europe si el MTX se instala en Europa Activamos el led de cobertura del MTX-65i Para poder ejecutar cualquier comando AT sin estar limitado a los indicados en el manual. TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off SMS_allPhones: on SMS_ATEnabled: on SMS_ATResponse: on Habilitamos el Telnet para poder enviar comandos remotos, configs, Login de Telnet Password de telnet El MTX acepta conexiones telnet desde cualquier IP Todos los teléfonos son autorizados Habilitamos los comandos AT por SMS Habilitamos las respuestas por SMS a los comandos AT enviados LOGGER_enabled: on Logger habilitado LOGGER_password: ID Password que se enviará a la plataforma web LOGGER_server: /json/set.asp?data= Dirección de la plataforma web LOGGER_registerSize: 600 Tamaño del registro LOGGER_numRegistersFlash: 200 Número de registros en flash LOGGER_numRegistersRam: 3 Número de registros en memoria RAM LOGGER_serialFrequency: 6 De cada 6 tramas serie recibidas, se logea 1 LOGGER_serverLogin: user Nombre de usuario de servidor web LOGGER_serverPassword: 1234 Password de servidor web Página 299

300 Detalles. 1.- El objeto JSON que recibirá el servidor tendrá un formato como el del siguiente ejemplo real: {"IMEI": ,"TS":"08/06/14 13:39:33","P":"ID ","SER":" d0a"} Siendo los campos : IMEI: el IMEI del módem TS: La fecha / hora UTC del módem (Time stamp) P: Un campo Password de usuario SER: Los datos serie en formato hexadecimal (2 dígitos por byte) Es decir, por cada trama logeada por el MTX-Tunnel éste enviará por GPRS o 3G, según el modelo de módem, un objeto JSON con el anterior formato (recibido por HTTP GET en la variable data como puede verse en el parámetro LOGER_server. Página 300

301 ESCENARIO EJEMPLO 2.24 Uso del MTX-Tunnel como Logger de tramas serie. Envío de tramas serie customizadas y periódicas para protocolos propietarios Detalles del escenario ejemplo: Se dispone de un dispositivo con un puerto serie RS232. Se necesita leer una serie de registros internos de ese dispositivo y enviarlos a una plataforma web cada 10 minutos. Para poder leer los registros del dispositivo se precisa el uso de un protocolo propietario, esto es, hay que enviar unas determinadas tramas de bytes (protocolo propietario) por el puerto serie del dispositivo para que éste responda con los valores de los registros internos. Por lo tanto, el módem debe enviar unas tramas de bytes preprogramadas de forma periódica por su puerto serie RS232, recoger las respuestas del dispositivo a las mismas y, adjuntando la hora de recogida, enviar los datos a un servidor web mediante un objeto JSON Las tramas a enviar para la lectura de los registros serán dos, enviadas cada 10 minutos F435 y 41A12D42421F4343 La configuración del puerto serie del equipo es baudios, 8,N,1. Solución. módem MTX-65i + software MTX-Tunnel Plataforma WEB IP: x31 0x32 0x33 0xF4 0x35 (pregunta) 0x23 0x92 0x23 0x56 0xF5 0xAA 0xA9 (respuesta) Página 301

302 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_ATEmbedded: on MTX_radioBand: europe MTX_rssiLevel: 10 MTX_ATLimited: off Velocidad del puerto serie de comunicación Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie en modo none Modelo de MTX donde está instalado el MTX-Tunnel Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping Para poder enviar comandos AT desde la plataforma web No necesario. Se indica Europe si el MTX se instala en Europa Activamos el led de cobertura del MTX-65i Para poder ejecutar cualquier comando AT sin estar limitado a los indicados en el manual. TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off SMS_allPhones: on SMS_ATEnabled: on SMS_ATResponse: on Habilitamos el Telnet para poder enviar comandos remotos, configs, Login de Telnet Password de telnet El MTX acepta conexiones telnet desde cualquier IP Todos los teléfonos son autorizados Habilitamos los comandos AT por SMS Habilitamos las respuestas por SMS a los comandos AT enviados LOGGER_enabled: on Logger habilitado LOGGER_password: ID Password que se enviará a la plataforma web LOGGER_server: :20011/json/set.asp?data= Dirección de la plataforma web LOGGER_registerSize: 600 Tamaño del registro LOGGER_numRegistersFlash: 200 Número de registros en flash LOGGER_numRegistersRam: 3 Número de registros en memoria RAM LOGGER_serialFrequency: 6 De cada 6 tramas serie recibidas, se logea 1 LOGGER_serverLogin: user Nombre de usuario de servidor web LOGGER_serverPassword: 1234 Password de servidor web LOGGER_serialData1: F435 Trama de bytes 1 a enviar LOGGER_serialData2: Trama de bytes 2 a enviar LOGGER_ serialperiod: 600 Envía las tramas cada 600 segundos (10 minutos) Página 302

303 Detalles. 1.- El objeto JSON que recibirá el servidor tendrá un formato como el del siguiente ejemplo real: {"IMEI": ,"TS":"08/06/14 13:39:33","P":"ID ","SER":" d0a"} Siendo los campos : IMEI: el IMEI del módem TS: La fecha / hora UTC del módem (Time stamp) P: Un campo Password de usuario SER: Los datos serie en formato hexadecimal (2 dígitos por byte) Es decir, por cada trama logeada por el MTX-Tunnel éste enviará por GPRS o 3G, según el modelo de módem, un objeto JSON con el anterior formato (recibido por HTTP GET en la variable data como puede verse en el parámetro LOGER_server. El MTX-Tunnel envía una trama JSON por cada lectura recibida. En el caso del ejemplo, se recibirían 2 JSON cada 10 minutos. Página 303

304 Anexo 3 Escenarios y Configuraciones de Ejemplo ULP (Ultra Low Power) Página 304

305 ESCENARIO EJEMPLO 3.1 Envío de SMS de alarma ante la activación de entrada digital con módem de ultrabajo consumo. Detalles del escenario de ejemplo: Se han colocado unas pequeñas jaulas en un monte para hacer un seguimiento veterinario de una determinada especie animal. Se pretende enviar un SMS de alarma cuando se active una entrada digital que está conectada a la puerta de unas jaulas. Al estar los equipos en campo, el MTX-Tunnel se alimentará con batería, por lo que debe permanecer en modo ultrabajo consumo (2 uamperios) hasta que se detecte el cierre de la puerta de una jaula (señal de que ha entrado un animal), pues el detector de cierre de la puerta de la jaula estará conectado a una entrada digital del MTX-Tunnel. Entonces, en el instante que se detecte el cierre de la puerta de la jaula, el módem se despertará y enviará un SMS con el texto JAULA-45 Tras el envío del SMS el módem debe volver a modo ultrabajo consumo hasta que vuelva a detectarse una nueva apertura de la puerta. La integridad del animal debe estar totalmente garantizada, por lo que en caso de fallo en el envío del SMS (por ejemplo, por falta de cobertura GSM en un momento puntual) el módem debe entrar en bajo consumo de nuevo pero deberá despertarse al cabo de 30 minutos para reintentar el envío del SMS y así sucesivamente hasta el envío correcto del SMS. Solución. módem MTX-65i-ULP + software MTX-Tunnel SMS: JAULA-45 MTXTunnel - ULP Batería de Alimentación Página 305

306 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_model: MTX-65i-ULP MTX_mode: none MTX_IDClient: PUERTA-45 ULP_mode: sms ULP_rtc: off ULP_minutes: 30 ULP_smsNumber1: ULP_smsExtended: off El modelo MTX escogido es el de ultrabajo consumo No se usarán túneles Serie-GPRS Texto del SMS que se enviará al detectar la apertura de la puerta El envío de la alarma será por SMS (no por GPRS) Nos queremos despertar sólo por una entrada de tamper En caso de fallo de envío del SMS, se reenviará en 30 minutos Nº de teléfono al que enviar el SMS Desactivamos el envío de GPIOs y ADCs. Sólo se envía MTX_IDClient. Detalles. 1.- El mensaje SMS enviado tiene el siguiente formato: MTX_IDClient Donde MTX_IDClient es un texto configurable por el usuario, en el caso del ejemplo: PUERTA Fíjese que las variables de configuración de este ejemplo nada tienen que ver con el escenario de ejemplo anterior de alarma por SMS. Eso es porque el MTX-Tunnel usando la plataforma MTX- 65-ULP tiene un modo de funcionamiento especial. Lea en el presente manual la descripción del parámetro ULP_mode para más información. 3.- Si el parámetro ULP_minutes es >0 (aunque ULP_rtc esté a off ) se utilizará en caso de fallo en el envío del SMS e indicará el número de minutos que el módem permanecerá en bajo consumo antes de volver a despertar para enviar de nuevo el SMS fallido. Página 306

307 ESCENARIO EJEMPLO 3.2 Monitorización periódica por SMS de entradas digitales/analógicas con módem de ultrabajo consumo. Detalles del escenario de ejemplo: Se pretende monitorizar varias entradas digitales / analógicas con un módem GSM. El módem, al estar alimentado por baterías, debe permanecer en modo ultrabajo consumo (2 uamperios) 24 horas. Cada 24 horas debe despertarse, leer el estado de las entradas digitales y analógicas y enviar un SMS con el estado de éstas a un módem GSM conectado a un servidor central. Tras el envío del SMS el módem debe volver a modo ultrabajo consumo otras 24h, tiempo tras el que se repetirá el proceso de nuevo y así sucesivamente. Solución. módem MTX-65i-ULP + software MTX-Tunnel SMS con telemetrías MTX-65i MTXTunnel PC Control Página 307

308 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_model: MTX-65i-ULP MTX_mode: none MTX_IDClient: ABB123 ULP_mode: sms ULP_sleepMode: minutes ULP_minutes: 1440 ULP_rtc: on ULP_smsNumber1: ULP_smsExtended: on El modelo MTX escogido es el de ultrabajo consumo No se usarán túneles Serie-GPRS Texto de usuario (p.el para identificar mejor el equipo) El envío de la telemetría será por SMS (no por GPRS) Indica que se despertará cada X minutos Se despertará cada 1440 minutos = 24 horas Nos queremos despertar cada X minutos. Se usa la RTC. Nº de teléfono al que enviar el SMS Activamos el envío de telemetrías (GPIOs y ADCs) Detalles. 1.- El mensaje SMS enviado tiene el siguiente formato: MTX_IDClient#gpio1#gpio2# #gpio10#adc1#adc2# Donde MTX_IDClient es un texto configurable por el usuario, gpiox una entrada digital y adcx una entrada analógica. 2.- Tenga presente que el módem, tras el envío de las telemetrías, volverá a dormirse otras 24 horas desde ese momento. Es decir, la temporización de 24 horas no es completamente exacta. (dependerá del tiempo que tarde el módem en despertar, registrar en la red GSM, enviar el SMS y volver a dormirse, cosa que puede llevar algo menos de 1 minuto). 3.- Fíjese que la diferencia fundamental con el ejemplo anterior 3.1 es que en esta ocasión el parámetro ULP_rtc está a on. Eso provoca que el módem se despierte periódicamente cada X segundos, los especificados en ULP_minutos. Recuerde que si ULP_rtc está a off, el módem sólo va a despertarse ante un cambio de GPIO, usándose el parámetro ULP_minutes con un sentido distinto (lea la documentación del parámetro ULP_minutes y el ejemplo 3.1). Página 308

309 ESCENARIO EJEMPLO 3.3 Monitorización periódica por GPRS de entradas digitales/analógicas con módem de ultrabajo consumo. Detalles del escenario. Se pretende monitorizar varias entradas digitales/analógicas con un módem GPRS. El módem va a estar alimentado por baterías, por lo que debe permanecer en modo ultrabajo consumo (2 uamperios) despertándose sólo para hacer las medidas y enviarlas vía GPRS. Cada 24 horas el MTX-Tunnel debe despertarse, leer el estado de las entradas digitales/analógicas y conectarse con un PC de Control (IP: y puerto TCP: 20010) vía GPRS mediante un socket TCP/IP para enviar el estado de dichas entradas. Tras el envío de la información el módem debe volver a modo ultrabajo consumo otras 24h. Solución. módem MTX-65i-ULP + software MTX-Tunnel #MTX_IDClient#IMEI#gpio1#gpio2# #gpio10#adc1#adc2# MTXTunnel ADSL GPRS PC Control Página 309

310 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 60 MTX_model: MTX-65i-ULP MTX_mode: client MTX_IDClient: MTX_IDClientExtended: on TCP_IP: TCP_port: ULP_sleepMode: minutes ULP_rtc: on ULP_minutes: 1440 ULP_mode: gprs APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Estará conectado únicamente 1 minuto (tiempo suficiente para envío) El modelo MTX escogido es el de ultrabajo consumo El módem se configura como cliente TCP (se conecta con un servidor) Identificador de nuestro módem. El que nosotros pongamos. Para que enviar también el IMEI, GPIOs y ADCs Dirección IP del Servidor donde enviará la información Puerto TCP del Servidor a donde enviará la información Indica que se despertará cada X minutos Se activa el reloj, pues el módem se despertará cada X minutos Se despertará cada 1440 minutos = 24 horas El envío de la telemetría será por GPRS (no SMS) Detalles. 1.- La trama enviada al servidor tiene el siguiente formato: #MTX_IDClient#IMEI#gpio1#gpio2# #gpio10#adc1#adc2# Donde MTX_IDClient es un parámetro de configuración (MTXIDClient) IMEI es el IMEI del módem, gpiox una entrada digital y adcx una entrada analógica. 2.- Recuerde que con el MTX-65i-ULP el parámetro GPRS_timeout especifica segundos, no minutos. 3.- Tenga presente que los ULP_minutos que el MTX-Tunnel permanecerá dormido empiezan a contar justo en el momento que el módem entra en modo ultrabajo consumo. Página 310

311 ESCENARIO EJEMPLO 3.4 Monitorización no periódica (por evento) mediante GPRS de entradas digitales / analógicas con módem de ultrabajo consumo. Detalles del escenario. Se pretende monitorizar varias entradas digitales/analógicas con un módem GPRS. El módem se alimentará a baterías, por lo que debe permanecer en modo ultrabajo consumo (2 uamperios) hasta que se produzca una activación en una de las entradas digitales de tamper del módem. Cuando se detecte dicho cambio en una entrada de tamper, el módem debe despertarse, leer el estado de las entradas digitales/analógicas y conectarse con un servidor central mediante un socket TCP/IP (vía GPRS) para enviar el estado de dichas entradas digitales/analógicas. Tras el envío de la información el módem debe volver a modo ultrabajo consumo hasta detectar otra activación de una entrada digital de tamper momento en el que repetirá el proceso indicado. Solución. módem MTX-65i-ULP + software MTX-Tunnel #MTX_IDClient#IMEI#gpio1#gpio2# #gpio10#adc1#adc2# MTXTunnel ADSL GPRS PC Control EJEMPLO de configuración (fichero config.txt) para el escenario indicado: Página 311

312 GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 1 MTX_model: MTX-65i-ULP MTX_mode: client MTX_IDClient: MTX_IDClientExtended: on TCP_IP: TCP_port: ULP_rtc: off ULP_mode: gprs APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Estará conectado únicamente 1 minuto (tiempo suficiente para envío) El modelo MTX escogido es el de ultrabajo consumo El módem se configura como cliente TCP (se conecta con un servidor) Identificador de nuestro módem. El que nosotros pongamos. Para que nos envíe el IMEI, GPIOs y ADCs Dirección IP del Servidor donde enviará la información Puerto TCP del Servidor a donde enviará la información Desactivamos la RTC. No se despertará por tiempo, sólo por ent. digital. El envío de la telemetría será por GPRS (no SMS) Detalles. 1.- La trama enviada al servidor tiene el siguiente formato: #MTX_IDClient#IMEI#gpio1#gpio2# #gpio10#adc1#adc2# Donde MTX_IDClient es un parámetro de configuración (MTX_IDClient) IMEI es el IMEI del módem, gpiox una entrada digital y adcx una entrada analógica. Página 312

313 ESCENARIO EJEMPLO 3.5 Túnel GPRS-RS232 con módem de ultrabajo consumo. Activación por tiempo. Detalles del escenario ejemplo: Se dispone de una serie de estaciones metereológicas con puerto RS232. Éstas funcionan con baterías y recogen continuamente parámetros metereológicos que almacenan en su interior. Se precisa recoger estos datos metereológicos mediante GPRS una vez al día, pero sin comprometer el consumo del sistema, es decir, se precisa un consumo mínimo por parte del módem GPRS conectado a la estación metereológica. Por esa razón los módems deben permanecer en modo ultrabajo consumo (2 uamperios) 24 horas. Cada 24 horas los módems deben despertarse, conectarse a GPRS y enviar su IP actual (que será dinámica, por coste) a un servidor en la central, que la almacenará en una base de datos. Otro proceso en el Servidor Central detectará la nueva entrada en la base de datos y se conectará inmediatamente a la IP del módem. Una vez el Servidor Central se ha conectado al módem, estará creado un túnel GPRS-RS232/485 transparente entre el Servidor Central y la estación metereológica y se podrá leer entonces la información de ésta. Una vez leída la información de la estación metereológica, el módem debe dormir otras 24 horas, tras lo cual, se repetirá el proceso. Solución. módem MTX-65i-ULP + software MTX-Tunnel EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 120 MTX_model: MTX-65i-ULP MTX_mode: server TCP_port: Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Estará como máximo 2 minutos conectado a GPRS si no hay datos. El modelo MTX escogido es el de ultrabajo consumo El módem se configura como server TCP Puerto TCP del MTX donde se esperará conexiones IP. Página 313

314 FIREWALL_enabled: off DNS_serverIP: DNS_serverPort: ULP_sleepMode: minutes ULP_rtc: on ULP_minutes: 1440 ULP_mode: gprs El MTX acepta conexiones desde cualquier IP Dirección IP del servidor al que se enviará la IP del módem Puerto TCP del servidor al que se enviará la IP del módem Indica que se despertará cada X minutos Se usará la RTC para despertarse cada X minutos Se despertará cada 1440 minutos = 24 horas El envío de la telemetría será por GPRS (no SMS) Detalles. 1.- La trama enviada al servidor para que este obtenga la IP tiene el siguiente formato: #IMEI#DNS_password#IPPublica# Donde IMEI es el IMEI del módem, DNS_password es un parámetro configurable de usuario y IPPublica es la dirección IP que tiene el módem en un momento determinado. Si fuera necesario, podría especificarse el parámetro DNS_extended: on, con lo cual el servidor recibiría la trama extendida: #IMEI#DNS_password#IPPublica#gpio1#gpio2# #gpio10#adc1#adc2# 2.- GPRS_timeout a 120 hará que el módem está con la conexión GPRS activada hasta que haya 2 minutos sin intercambio de datos entre el servidor y la estación metereológica. (Recuerde que GPRS_timeout para la plataforma MTX-65i-ULP indica segundos, no minutos como en el rest de plataformas). Es decir, no debe preocupar que una transferencia dure 10 minutos. De ser así, en aproximadamente 10+2=12 minutos el módem entrará en modo ultrabajo consumo. 3.- Si se precisa que únicamente pueda accederse al módem desde una IP determinada para evitar intentos de intrusión puede especificarse una o varias IPs autorizadas en los parámetros: FIREWALL_enabled, FIREWALL_IP1, Página 314

315 ESCENARIO EJEMPLO 3.6 Túnel GPRS-RS232/RS485 con módem de ultrabajo consumo. Activación por fecha / hora. Detalles del escenario ejemplo: Se dispone de una serie de contadores de energía con puerto RS232. Se precisa leer estos contadores por GPRS una vez al día a las 22:00, pero sin comprometer el consumo del sistema, es decir, se precisa un consumo mínimo por parte del módem GPRS conectado al contador, ya que el módem va a estar alimentado a baterías. El módem debe permanecer en modo ultrabajo consumo (2 uamperios) hasta las 22:00. A las 22:00 el módem debe despertarse, conectarse a GPRS y enviar su IP actual (IP dinámica) a un servidor en la central que la almacenará en una base de datos. Otro proceso en el Servidor Central detectará la nueva entrada en la base de datos y se conectará inmediatamente vía GPRS al módem. Una vez conectado, estará creado un túnel GPRS- RS232/485 transparente entre el Servidor Central y el contador de energía, pudiéndose recoger las lecturas de éste. Una vez leídos los datos del contador, el módem debe dormir hasta las 22:00 horas del día siguiente, tras lo cual, se repetirá el proceso. Solución. módem MTX-65i-ULP + software MTX-Tunnel EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: COMM_bitsperchar: 8 COMM_autocts: on COMM_autorts: on COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 120 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS activado Control de flujo hardware RTS activado 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Google, por si en TCP_IP se especifica DNS en vez de IP) Estará como máximo 2 minutos conectado a GPRS si no hay datos. MTX_model: MTX-65i-ULP El modelo MTX escogido es el de ultrabajo consumo MTX_mode: server El módem se configura como server TCP MTX_TPServer: time-a.timefreq.bldrdoc.gov Servidor Horario. Ver detalles abajo. Punto 4. TCP_port: Puerto TCP del MTX donde se esperará conexiones IP. Página 315

316 FIREWALL_enabled: off DNS_enabled: on DNS_mode: socket DNS_password: DNS_server: DNS_port: El MTX acepta conexiones desde cualquier IP Servicio envío IP a DNS activado Se informará por socket TCP Cadena password para mayor seguridad IP del servidor al que se enviará la IP actual del MTX Puerto TCP del servidor al que se enviará la IP del módem ULP_sleepMode: date Indica que se despertará por fecha/hora ULP_mode: gprs El envío de la telemetría será por GPRS (no SMS) ULP_time1: XX2200 El MTX se despertará cada día (XX) a las 22:00 Detalles. 1.- La trama enviada al servidor (con IP especificada en : DNS_serverIP) tiene el siguiente formato: #IMEI# Donde IMEI es el IMEI del módem Si fuera necesario, podría especificarse el parámetro DNS_extended: on, con lo cual el servidor recibiría la trama extendida: #IMEI#gpio1#gpio2# #gpio10#adc1#adc2# 2.- GPRS_timeout a 2 hará que el módem está con la conexión GPRS activada hasta que haya 2 minutos sin intercambio de datos entre el servidor y el contador de energía. Es decir, no debe preocupar que una transferencia dure 10 minutos. De ser así, en aproximadamente 10+2=12 minutos el módem entrará en modo ultrabajo consumo. 3.- Si se precisa que únicamente pueda accederse al módem desde una IP determinada para evitar intentos de intrusión puede especificarse una o varias IPs autorizadas en los parámetros: TCP_validIP 4.- Es necesario indicar un servidor de hora con protocolo TP, de ahí el parámetro MTX_TPServer. La RTC (reloj del módem) puede tener ciertas derivas (hasta 4-5 segundos / día) que a la larga, de no sincronizarse, puede provocar que hayan grandes diferencias entre el reloj del módem y la hora real. Además, la primera vez que se conecta el módem éste NO tendrá la hora correcta y se necesita el servidor horario para esa primera sincronización. El usuario puede implementarse un servidor horario sencillo (basado en el protocolo TP) pero existen hoy en día muchos públicos y gratuitos que funcionan sin problema. Se recomienda es servidor expuesto en el ejemplo, aunque en el manual de configuración puede obtenerse una larga lista de estos servidores. Cada vez que el módem se despierte intentará sincronizar su reloj para tener la hora exacta. De no poder, se intentará la sincronización horaria la siguiente vez que se despierte. La excepción es la primera vez que se despierta el módem en la que éste necesita obligatoriamente sincronizar la hora y permanecerá despierto hasta conseguirlo (no es posible programar una hora para despertarse si se desconoce la hora actual). El consumo tanto de energía como de datos para la sincronización horaria es mínimo. Página 316

317 Anexo 4 Escenarios y Configuraciones de Ejemplo API Página 317

318 ESCENARIO EJEMPLO 4.1 Uso de la API para Lectura de las GPIOs y ADCs del MTX-Tunnel desde una página WEB externa. Detalles del escenario ejemplo: Se precisa monitorizar una serie de entradas digitales y analógicas de forma remota y además hacer la monitorización en tiempo real a través de una página web de un tercero. Para ello se realizará una página web externa en la que mostrar el estado de las entradas y salidas digitales de un MTX-Tunnel, que debe permanecer el 100% del tiempo activo, configurado en modo Server, respondiendo a las peticiones HTTP GET realizadas desde dicha página web. La página web estará programada en ASP y deberá coger los datos del MTX-Tunnel para mostrarlos adecuadamente. Solución. módem MTX-65i + software MTX-Tunnel WEBSERVER Consulta a WebServer ADSL El WebServer pide al MTXTunnel su estado GPRS MTXTunnel PC User Página 318

319 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: server APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El modelo MTX escogido es el MTX-65i (indicar MTX-IND para RS485) El módem se configura como server TCP -WEBSERVER_enabled: on Se habilita el webserver del módem WEBSERVER_firewall: off No habilitamos el firewall, basta con Login y Password WEBSERVER_login: user Login del WebServer WEBSERVER_password: 1234 Password del WebServer WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM EJEMPLO de página ASP La página web ASP para este ejemplo es muy simple. A continuación dispone de un código de ejemplo de una página funcional programada en ASP. Básicamente lo que realiza es una ejecución de un comando AT remoto en el MTX-Tunnel y recoge la respuesta, concretamente ejecuta el comando AT^MTXTUNNEL=GETIOS para recoger el estado de las E/S digitales y analógicas de una sola vez. Una vez recogida la respuesta con los datos, obtiene los distintos estados de cada uno de los GPIOs y ADCs y los muestra en el explorador. <% set XmlObj = Server.CreateObject("Microsoft.XMLHTTP") XmlObj.open "GET", " 1234", false XmlObj.send datosdelmtxtunnel = XmlObj.responseText cadenainicio="<mtxtunnel>at^mtxtunnel=getios " posiini=instr(1,datosdelmtxtunnel,cadenainicio) posifin=instr(1,datosdelmtxtunnel,"</mtxtunnel>") datosio=mid(datosdelmtxtunnel,len(cadenainicio),posifin-len(cadenainicio)) Página 319

320 vectordatos=split(datosio,",") for i=0 to 9 Response.write("El valor de GPIO" & i+1 & " es: " & vectordatos(i) & "<br>") next Response.write("El valor de ADC1 es: " & vectordatos(10) & "<br>") Response.write("El valor de ADC2 es: " & vectordatos(11) & "<br>") %> El resultado es el que se muestra en la siguiente pantalla. Página 320

321 ESCENARIO EJEMPLO 4.2 Uso de la API para el envío de datos por el puerto serie del MTX-Tunnel desde un Formulario web ubicado en una página web externa. Detalles del escenario ejemplo: Se dispone de una pantalla especial con entrada serie RS232. Enviando datos por su interfaz serie es posible escribir datos en ella. Se pretende controlar la pantalla remotamente vía GPRS, para ello se utilizará un MTX- Tunnel que haga la pasarela GPRS-RS232 Para el control de la pantalla no se utilizará el método más sencillo, que resultaría de implementar un programa de PC que directamente se conectase vía TCP/IP con el MTX- Tunnel. La escritura en la pantalla se pretende hacer desde una página web externa. De esa manera, el texto escrito en una caja de texto de un formulario de una página Web debe poder enviarse al MTX-Tunnel, para que éste lo reenvíe a la pantalla vía serie RS232 y tras ello recoja la respuesta serie de la pantalla y la reenvíe de nuevo a la página web. Solución. módem MTX-65i + software MTX-Tunnel Página 321

322 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: server APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Telefónica, por si en TCP_IP se especifica DNS en vez de IP) El módem estará conectado permanentemente El modelo MTX escogido es el MTX-65i (indicar MTX-IND para RS485) El módem se configura como server TCP WEBSERVER_firewall: off No habilitamos el firewall, basta con Login y Password WEBSERVER_enabled: on Se habilita el webserver del módem WEBSERVER_login: user Login del WebServer WEBSERVER_password: 1234 Password del WebServer WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM EJEMPLO de página web con formulario: La página web HTML será muy simple para no complicar el ejemplo. Contendrá básicamente un formulario con una caja de texto y un botón. La página también tendrá un pequeño script programado en javascript, para hacer la llamada al MTX-Tunnel. El aspecto de la página web es el siguiente: Página 322

323 El código íntegro de esta página HTML es el siguiente: Una vez enviado el texto LED DISPLAY desde el formulario web al MTX-Tunnel, éste lo reenvía directamente por su puerto serie a la pantalla para ser mostrado. La pantalla responde con un texto Set TEXT OK que será recogido por el MTX-Tunnel y reenviado como respuesta al formulario. Obviamente la respuesta mostrada es muy simple al tratarse de un ejemplo. En una aplicación real se capturaría esta respuesta mostrando una página mucho más elaborada al usuario final. Página 323

324 Nótese que en este ejemplo se ha controlado una única pantalla, pero que el comando AT^MTXTUNNEL=RS232,1, permite enviar datos por el puerto COM1 y puerto COM2 del MTX- Tunnel (poniendo 1 ó 3 en el texto anterior marcado en rojo), por lo que sería muy sencillo controlar un escenario como: Página 324

325 ESCENARIO EJEMPLO 4.3 Uso de la API para conmutar 4 Relés desde una página WEB externa. Detalles del escenario ejemplo: Se pretende realizar una página web desde la que poder conmutar 4 relés, para conectar y desconectar luminarias. Un usuario, mediante dicha página web, debe poder conmutar directamente y con un clic de ratón los relés del MTX-Tunnel para poder encender y apagar las luces. Por lo tanto, la página web debe poder comunicarse con el MTX-Tunnel. Solución. módem MTX-IND-V1 + software MTX-Tunnel EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 MTX_model: MTX-IND-V1 MTX_mode: server APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Telefónica, por si en TCP_IP se especifica DNS en vez de IP) El módem estará conectado permanentemente El modelo MTX escogido es el MTX-IND-V1 ya que dispone de RELÉS El módem se configura como server TCP WEBSERVER_firewall: off No habilitamos el firewall, basta con Login y Password WEBSERVER_enabled: on Se habilita el webserver del módem WEBSERVER_login: user Login del WebServer WEBSERVER_password: 1234 Password del WebServer WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM EJEMPLO de página HTML Página 325

326 En este ejemplo únicamente se va a permitir conmutar los 4 relés del MTX-IND. Por sencillez no se va a mostrar el estado inicial de los relés. Para conocer el estado inicial de los relés, bastaría con añadir a este ejemplo parte del código del Ejemplo 12. La página web tendría un aspecto como el mostrado en la siguiente pantalla. Esta simple web sería lo único que habría que hacer para activar los relés de un MTX-Tunnel. Básicamente cada enlace ejecuta un comando AT remoto sobre el MTX-Tunnel haciendo conmutar el relé adecuado. A continuación se muestra el código fuente de esta simple página web: Página 326

327 ESCENARIO EJEMPLO 4.4 Uso de la API para el envío de un mensaje SMS mediante un dispositivo (PLC) a través del puerto serie COM1 mientras el túnel Serie-GPRS está activo. Detalles del escenario ejemplo: Desde un PC de las oficinas centrales se necesita acceder periódicamente vía GPRS al puerto serie de un PLC para enviar instrucciones y recoger resultados. Para el acceso a dicho PLC es utilizará un MTX-Tunnel que haga de pasarela GPRS-Serie. El MTX-Tunnel debe tener siempre la sesión GPRS establecida para poder acceder al dispositivo PLC rápidamente en todo momento. Además, el PLC debe poder enviar un SMS en todo momento, ya que en ciertas situaciones debe poder enviar un SMS de alarma. El PLC está conectado al MTX-Tunnel por un único puerto serie, por lo que, de algún modo, debe poder coexistir el túnel Serie-GPRS con el envío de comandos AT por parte del PLC usando el mismo puerto serie. Solución. módem MTX-65i + software MTX-Tunnel SMS: ALARMA DE BAJO NIVEL EN DEPOSITO <MTXTUNNEL>AT^MTXTUNNEL=SMS, ,ALARMA DE BAJO NIVEL EN DEPOSITO</MTXTUNNEL> Página 327

328 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_DNS: GPRS_timeout: 0 MTX_model: MTX-65i MTX_mode: server MTX_ATMux: on APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM (DNS de Telefónica, por si en TCP_IP se especifica DNS en vez de IP) El módem estará conectado permanentemente El modelo MTX escogido es el MTX-65i El módem se configura como server TCP Se habilita el multiplexado de comandos AT por el puerto serie del módem WEBSERVER_firewall: off No habilitamos el firewall, basta con Login y Password WEBSERVER_enabled: on Se habilita el webserver del módem WEBSERVER_login: user Login del WebServer WEBSERVER_password: 1234 Password del WebServer WEBSERVER_skin: /webserverimg/ Skin del WebServer WEBSERVER_gsmScript: Script localiz. GSM EJEMPLO de funcionamiento La solución más sencilla consiste en usar el multiplexor de comandos AT por el puerto serie. De esa manera es posible enviar comandos AT por el mismo puerto serie en el cual está trabajando el túnel Serie-GPRS. Para activar el multiplexor basta con establecer el parámetro MTX_ATMux a on. El PLC debe enviar por el puerto serie un comando AT encapsulado entre los TAGS: <MTXTUNNEL></MTXTUNNEL> Por ejemplo, si el mensaje debe enviarse al número de teléfono con el texto: ALARMA DE BAJO NIVEL EN DEPOSITO, el comando que deberá enviar el PLC será: <MTXTUNNEL>AT^MTXTUNNEL=SMS, ,ALARMA DE BAJO NIVEL EN DEPOSITO</MTXTUNNEL> El mensaje recibido por el puerto serie encapsulado entre dichos tags no será reenviado vía GPRS, sino que el MTX-Tunnel lo interpretará como un comando AT y lo ejecutará, devolviendo el resultado también entre los tags. Página 328

329 Anexo 5 Escenarios y Configuraciones de Ejemplo para la comunicación con dispositivos Wavenis Página 329

330 Qué son los equipos Wavenis de Coronis? Coronis es una empresa fabricante de soluciones RF cuyos productos sin distribuidos en España por Matrix Electrónica. Básicamente los productos disponibles de la casa Coronis son: Waveflow: Wavetherm: Wavesense: Wavelog: equipo RF 868MHz acoplable a contadores de agua / energía / gas o a cualquier sistema que se desee contar pulsos sonda de temperatura RF 868MHz equipo RF 868MHz de entradas analógicas (0-10V y 4-20mA) equipo RF 868MHz de 4 entradas digitales Todos estos equipos pueden ser adquiridos bien con batería interna (carcasa IP68) o bien con toma de alimentación 220V (carcasa IP65). El módem MTX-IND se suministra OPCIONALMENTE Y BAJO PEDIDO con una tarjeta WAVECARD integrada dentro. Esta tarjeta RF está internamente conectada al puerto COM2 del MTX-IND y debe funcionar a 9600,8,N,1 sin control de flujo. Cómo funciona este sistema? El funcionamiento es muy sencillo. Es posible conectarse remotamente al MTX-Tunnel vía telnet y mediante un comando AT para realizar lecturas en tiempo real de los equipos RF (es decir, leer temperaturas, entradas analógicas, ) o bien es posible configurar el MTX-Tunnel para que, de forma autónoma y periódica, realice lecturas de los distintos sensores, almacene internamente los resultados y los envíe a un servidor mediante un objeto JSON Explicado con ejemplos ilustrativos resulta mucho más sencillo de entender, por lo que mostramos a continuación un ejemplo completo, donde podrá entender enseguida el funcionamiento. Página 330

331 ESCENARIO EJEMPLO 5.1 Lectura de sensores radio de temperaturas y 4-20mA. Concentrador GPRS con envío de datos a servidor web mediante objeto JSON Detalles del escenario ejemplo: Se precisa realizar una telelectura remota (vía GPRS) de una serie de 6 sensores. 3 de ellos cuentan con una salida 4-20mA y otros 3 de ellos son sensores de temperatura. Para ello se usarán equipos WaveSense y equipos Wavetherm de la casa Coronis. Estos equipos RF, con protección IP68, cuentan con una entrada 4-20mA para el caso de los wavesense y una sonda Dallas de temperatura para los wavetherm. Ambos tipos de equipos disponen de un alcance de 1Km en visión directa. En caso de no haber alcance suficiente se podrían intercalar hasta 3 repetidores Wavetalk de Coronis, aunque en este escenario, por simplicidad, no se utilizarán. Como equipo GPRS se empleará un MTX-IND (con una tarjeta Wavecard de Coronis en su interior). El MTX-IND se parametrizará de forma que realice una lectura vía radio de cada sensor cada 2 horas, y envíe las lecturas a un servidor web mediante un objeto JSON. Solución. módem MTX-IND + software MTX-Tunnel Server: Equipo 4-20ma + wavesense Mac: Equipo 4-20mA + wavesense Equipo 4-20mA + wavesense El MTXTunnel envía las lecturas vía HTTP JSON Wavetherm (temperatura) Wavetherm (temperatura) Wavetherm (temperatura) Página 331

332 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autocts: off COMM2_autorts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Baudios del puerto serie 8 bits de datos Control de flujo hardware CTS desactivado para Wavenis Control de flujo hardware RTS desactivado para Wavenis 1 bit de stop. Sin paridad. APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem permanecerá permanentemente conectado a GPRS. MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND (CON OPCIÓN WAVECARD) MTX_mode: none No es necesario en este escenario una pasarela serie-gprs MTX_urc: off No necesitamos los mensajes de información URC MTX_portAux: wavenis El puerto Com2 del MTX-IND-V2 está usando la wavecard de comunic. MTX_TPServer: time-a.timefreq.bldrdoc.gov Servidor de sincronización de hora MTX_TPServer2: time-b.timefreq.bldrdoc.gov Servidor de sincronización de hora de backup MTX_ATEmbedded: on Permitimos el envío de comandos AT remotos por telnet MTX_ping: 30 Por seguridad, el módem realizará un PING cada 30 minutos MTX_pingIP: Dirección IP a donde se realiza el PING FIREWALL enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off SMS_sendIP: on SMS_alPhones: on SMS_ATEnabled: on SMS_ATResponse: on El MTX acepta conexiones desde cualquier IP Habilitamos el Telnet para poder enviar comandos remotos, configs, Login de Telnet Password de telnet El MTX acepta conexiones telnet desde cualquier IP Enviaremos la IP al móvil autorizado que haga una llama perdida o envíe un SMS con el texto mtxtunnel on. Indica que todos los números son autorizados Permitimos el envío de comandos AT por SMS El módem responderá con un comando AT a un comando AT LOGGER_enabled: on Habilitamos el Logger LOGGER_password: ID001 Campo password que podemos usar como ID de dispositivo LOGGER_server: URL donde se envía el JSON (datos) LOGGER_registerSize: 250 El tamaño del registro LOGGER_numRegistersFlash: 300 Número de registros que almacenará el equipo en memoria en caso de no haber cobertura, para envío posterior. WAVENIS_mac1: 0B Dirección MAC del wavesense 1 WAVENIS_mac2: 0B Dirección MAC del wavesense 2 WAVENIS_mac3: 0B Dirección MAC del wavesense 3 WAVENIS_mac4: 0B D3 Dirección MAC del wavetherm 1 WAVENIS_mac5: 0B F4 Dirección MAC del wavetherm 2 Página 332

333 WAVENIS_mac6: 0B A2 Dirección MAC del wavetherm 3 WAVENIS_period: 7200 WAVENIS_retries: 2 Cada 7200 segundos (2 horas) hacemos una lectura En caso de fallo RF, se realizan 2 intentos Detalles. 1.- El dispositivo MTX-IND, de forma autónoma cada 2 horas, realiza un barrido de lecturas de todos los sensores configurados. Una vez realiza la lectura envía mediante un objeto JSON los datos al servidor configurado en el parámetro LOGGER_server. En caso de fallo de cobertura GPRS o de problemas de envío contra el servidor, el MTX almacena los datos en memoria para su posterior envío. 2.- El formato de los objetos JSON enviados es muy simple. Para el caso de los dispositivos wavethem (temperaturas), un ejemplo de objeto JSON enviado es el siguiente: {"IMEI": ,"TS":"18/10/12 10:04:32","P":"ID001","A":0B D3,"BAT":0,"T1": ,"T2" :0.0 } Parámetros enviados: IMEI: El IMEI del módem, único para cada dispositivo (el DNI del módem). TS: Time Stamp. La hora de la lectura realizada al wavethem P: Campo de usuario. A: Dirección MAC del dispositivo leído (en este caso, del wavetherm1) BAT: Indica si la batería del equipo está baja (1) ó bien si está correcta (0) T1: Temperatura de la sonda Dallas T2: El wavetherm soporta hasta 2 sondas de temperatura, en caso de haber una segunda indicaría la segunda temperatura. Para el caso de los equipos wavesense de corriente (los lectores de 4-20mA) el formato JSON es muy similar {"IMEI": ,"TS":"18/10/12 10:04:37","P":"ID001","A":0B ,"BAT":0,"CU":8.20} Parámetros enviados por el JSON del MTX: IMEI: El IMEI del módem, único para cada dispositivo (el DNI del módem). TS: Time Stamp. La hora de la lectura realizada al wavesense P: Campo de usuario. A: Dirección MAC del dispositivo leído (en este caso, del wavesense1) BAT: Indica si la batería del equipo está baja (1) ó bien si está correcta (0) CU: Corriente leída del wavesense Página 333

334 Para el caso de los equipos wavesense de tensión (los lectores de 0-5V) el formato JSON es muy similar {"IMEI": ,"TS":"18/10/12 10:04:37","P":"ID001","A":0B ,"BAT":0,"VO":2.5} Parámetros enviados por el JSON del MTX: IMEI: El IMEI del módem, único para cada dispositivo (el DNI del módem). TS: Time Stamp. La hora de la lectura realizada al wavesense P: Campo de usuario. A: Dirección MAC del dispositivo leído (en este caso, del wavesense1) BAT: Indica si la batería del equipo está baja (1) ó bien si está correcta (0) VO: Voltaje leído del wavesense Para el caso de los equipos waveflow (los contadores de pulsos) el formato JSON es: {"IMEI": ,"TS":"18/10/12 10:04:37","P":"ID001","A":0B ,"BAT":0,"CT1":10, "CT2":11,"CT3":12,"CT4":13,"AC1":0,"AC2":0,"AC3":0,"AC4":0} Parámetros enviados por el JSON del MTX: IMEI: El IMEI del módem, único para cada dispositivo (el DNI del módem). TS: Time Stamp. La hora de la lectura realizada al wavesense P: Campo de usuario. A: Dirección MAC del dispositivo leído (en este caso, del wavesense1) BAT: Indica si la batería del equipo está baja (1) ó bien si está correcta (0) CT1: Cuentas del contador 1 del waveflow CT2: Cuentas del contador 2 del waveflow CT3: Cuentas del contador 3 del waveflow CT4: Cuentas del contador 4 del waveflow AC1: Indica si el cable del contador 1 está cortado (1) ó no (0) AC2: Indica si el cable del contador 2 está cortado (1) ó no (0) AC3: Indica si el cable del contador 3 está cortado (1) ó no (0) AC4: Indica si el cable del contador 4 está cortado (1) ó no (0) Para el caso de los equipos wavelog (entradas digitales) el formato JSON es: {"IMEI": ,"TS":"18/10/12 10:04:37","P":"ID001","A":0B ,"BAT":0,"IN1":1, "IN2":1,"IN3":1,"IN4":1,"OUT1":0," OUT2":0," OUT3":0," OUT4":0} Página 334

335 Parámetros enviados por el JSON del MTX: IMEI: El IMEI del módem, único para cada dispositivo (el DNI del módem). TS: Time Stamp. La hora de la lectura realizada al wavesense P: Campo de usuario. A: Dirección MAC del dispositivo leído (en este caso, del wavesense1) BAT: Indica si la batería del equipo está baja (1) ó bien si está correcta (0) IN1: Estado de la entrada digital 1 IN 2: Estado de la entrada digital 2 IN 3: Estado de la entrada digital 3 IN 4: Estado de la entrada digital 4 OUT1: Estado de la salida digital 1 (sin uso en MTX-Tunnelv7.8) OUT2: Estado de la salida digital 2 (sin uso en MTX-Tunnelv7.8) OUT3: Estado de la salida digital 3 (sin uso en MTX-Tunnelv7.8) OUT4: Estado de la salida digital 4 (sin uso en MTX-Tunnelv7.8) 3.- En cualquier momento podemos hacer una consulta en tiempo real de cualquier sensor. Para ello, basta con enviar un comando AT remoto. Es posible enviar el comando AT vía SMS o bien vía TELNET. En la página 45 del presente manual están detallados todos los comandos AT especialmente pensados para comunicaciones Wavenis. Por ejemplo, estos comandos permitirían la lectura en tiempo real del wavethem1 y wavesense1 AT^MTXTUNNEL= READWAVETHERM, 0B D3 AT^MTXTUNNEL= READWAVESENSEC, 0B Página 335

336 Anexo 6 Escenarios y Configuraciones de Ejemplo para la lectura automática de dispositivos MODBUS Página 336

337 ESCENARIO EJEMPLO 6.1 Lectura y envío periódico a un servidor Web de los registros MODBUS de un PLC Detalles del escenario ejemplo: Disponemos de un PLC Modbus RTU. Este PLC dispone en su memoria interna de una serie de variables/registros (por ejemplo, una temperatura y 3 contadores, ) las cuales deben leerse y enviarse periódicamente a un servidor Web. Por ello, el MTX-Tunnel debe interrogar periódicamente, cada 15 minutos, por un puerto serie, al PLC para leer dichos registros. Los registros a leer son, para la temperatura el registro nº20, y los contadores están en los registros 21,22 y 23 respectivamente. El MTX-Tunnel debe enviar tras cada lectura el valor de los registros a un servidor web vía HTTP GET usando un objeto JSON, pero debe ser capaz, en caso de fallo de comunicaciones GPRS, de almacenar en memoria flash hasta 1500 lecturas que enviará cuando se restauren las comunicaciones. Debe poderse acceder al MTX-Tunnel en cualquier momento para, de esa manera poder leer en tiempo real los registros del PLC, así como para poder escribir en ellos y modificar registros de configuración del PLC Solución. módem MTX-65i + software MTX-Tunnel PLC ModBus RS232 (si fuera RS485 podría usarse un MTX-65i-RS485) Página 337

338 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe MTX_rssiLevel: 10 SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación con el PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Activamos el led de cobertura del MTX-65i Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX MODBUS_address: 1 MODBUS_start: 20 MODBUS_numwords: 4 MODBUS_period: 900 Dirección modbus del equipo a leer Dirección del registro inicial modbus a leer Número de registros a leer a partir del inicial Cada cuantos segundos se realiza una lectura Página 338

339 Detalles. 1.- En este ejemplo se utiliza un MTX-65i con comunicación RS232 para comunicación MODBUS contra un PLC, pero podría ser RS485 sin problemas. Para ello podría usarse un modelo MTX-65i- RS485 (con comunicación RS485 incorporada). 2.- El resumen de este ejemplo es el siguiente: el módem va leyendo periódicamente, cada 15 minutos una serie de registros ModBus del PLC y los va enviando mediante un objeto JSON a un servidor web (a la url especificada en el parámetro LOGGER_server). En caso de no poder enviar el registro (por no haber cobertura gprs en ese momento o estar el servidor caído) almacena los datos en memoria para enviarlos posteriormente. Mediante Telnet es posible conectarse al equipo directamente y consultar/cambiar en tiempo real los registros del PLC (para ello buscar en este manual los comandos AT^MTXTunnel=getmodbus y AT^MTXTUNNEL=setmodbus) 3.- El objeto JSON enviado a la URL especificada en LOGGER_server está codificado de la siguiente manera, a modo de ejemplo: {"IMEI": ,"P":"ID00001","A":1,"TS":"20/08/12 08:31:44","ST":20,"V1":23,"V2":275,"V3":274,"V4":32765} Es decir, el servidor web recibe un objeto JSON con el IMEI (IMEI) del módem, un campo password (P) que también puede utilizarse para identificar el equipo (si no se quiere usar el IMEI), la dirección modbus del equipo (A), el time stamp (TS) de cuando se han leído los datos modbus, la dirección inicial leída (ST) y V1,V2, con cada una de las variables leídas. Nota importante: tenga presente que si lo que necesita es una simple pasarela modbustcp / modbusrtu también puede hacerlo, simplemente consulte el ejemplo de configuración 2.15 del presente manual. Página 339

340 ESCENARIO EJEMPLO 6.2 Lectura y envío periódico a un servidor Web de los registros de 5 Contadores eléctricos con protocolo ModBus RTU. Detalles del escenario ejemplo: Disponemos de 5 contadores eléctricos con protocolo modbus rtu. Estos contadores disponen en su memoria interna de una serie de variables/registros (por ejemplo, consumo acumulado y consumo medio) las cuales deben leerse y enviarse periódicamente a un servidor Web. Por ello, el MTX-Tunnel debe interrogar periódicamente, cada 15 minutos, por un puerto serie, a los 5 contadores para leer dichos registros. Los registros a leer son para el consumo acumulado el registro nº20, y para el consumo medio el registro nº 21. El MTX-Tunnel debe enviar tras cada lectura el valor de los registros a un servidor web vía HTTP GET usando un objeto JSON, pero debe ser capaz, en caso de fallo de comunicaciones GPRS, de almacenar en memoria flash hasta 1500 lecturas que enviará cuando se restauren las comunicaciones. Para cada contador enviará una trama JSON, donde se indica con un identificador (la dirección modbus) el contador leído. Debe poderse acceder al MTX-Tunnel en cualquier momento para, de esa manera poder leer en tiempo real los registros del PLC, así como para poder escribir en ellos y modificar registros de configuración del PLC Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i- RS485 Contador modbus RS485 BUS 485 Contador modbus RS485 Contador modbus RS485 Contador modbus RS485 Contador modbus RS485 Página 340

341 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación con contadores Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX MODBUS_address: 1;2;3;4;5 MODBUS_start: 20 MODBUS_numwords: 2 MODBUS_period: 900 Direcciones modbus de los contadores a leer Dirección del registro inicial modbus a leer Número de registros a leer a partir del inicial Cada cuantos segundos se realiza una lectura Página 341

342 Detalles. 1.- El resumen de este ejemplo es el siguiente: el módem va leyendo periódicamente, cada 15 minutos dos registros ModBus de cada contador y va enviando mediante un objeto JSON a un servidor web (a la url especificada en el parámetro LOGGER_server). En caso de no poder enviar el registro (por no haber cobertura gprs en ese momento o estar el servidor caído) almacena los datos en memoria para enviarlos posteriormente. Mediante Telnet es posible conectarse al equipo directamente y consultar/cambiar en tiempo real los registros del PLC (para ello buscar en este manual los comandos AT^MTXTunnel=getmodbus y AT^MTXTUNNEL=setmodbus) 2.- El objeto JSON enviado a la URL especificada en LOGGER_server está codificado de la siguiente manera, a modo de ejemplo: {"IMEI": ,"P":"ID00001","A":1,"TS":"20/04/13 08:31:44","ST":20 "V1":23,"V2":275} Es decir, el servidor web recibe un objeto JSON con el IMEI (IMEI) del módem, un campo password (P) que también puede utilizarse para identificar el equipo (si no se quiere usar el IMEI), la dirección modbus del contador (A) que servirá para distinguir el contador al que se refiere la lectura, el time stamp (TS) de cuando se han leído los datos modbus de cada contador, la dirección inicial leída (ST) y V1,V2 con cada uno de los registros leídos. Página 342

343 ESCENARIO EJEMPLO 6.3 Lectura y envío periódico a un servidor Web de los registros de 5 Contadores eléctricos con protocolo ModBus RTU y mapa de memoria de registros distintos. Detalles del escenario ejemplo: Disponemos de 5 contadores eléctricos con protocolo modbus rtu. Estos contadores disponen en su memoria interna de una serie de variables/registros (por ejemplo, consumo acumulado y consumo medio) las cuales deben leerse y enviarse periódicamente a un servidor Web. Por ello, el MTX-Tunnel debe interrogar periódicamente, cada 15 minutos, por un puerto serie, a los 5 contadores para leer dichos registros. Los registros a leer son diferentes para cada contador. Contador 1: registros 20 a 21 y registros 100 a 105 Contador 2 y 3: registros 30 a 35 Contador 4 y 5: registros 40 a 60 Los contadores 1,2 y 3 usarán el comando de lectura modbus 0x03 (el más habitual), los contadores 4 y 5 usarán el comando de lectura modbus 0x04 El MTX-Tunnel debe enviar tras cada lectura el valor de los registros a un servidor web vía HTTP GET usando un objeto JSON, pero debe ser capaz, en caso de fallo de comunicaciones GPRS, de almacenar en memoria flash hasta 1500 lecturas que enviará cuando se restauren las comunicaciones. Para cada contador enviará una trama JSON, donde se indica con un identificador (la dirección modbus) el contador leído. Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i-RS485 Contador modbus RS485 BUS 485 Contador modbus RS485 Contador modbus RS485 Contador modbus RS485 Contador modbus RS485 Página 343

344 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación con contadores Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX MODBUS_address: 1;1;2;3;4;5 MODBUS_start: 20;100;30;30;40;40 MODBUS_numwords: 2;6;6;6;21;21 MODBUS_period: 900 MODBUS_readCommand: 3;3;3;3;4;4 Direcciones modbus de los contadores a leer Direcciones iniciales de cada contador Número de registros a leer a partir del inicial de cada contador Cada cuantos segundos se realiza una lectura Los 3 primeros contadores usan el comando de lectura 0x03 y los otros 2 usan el comando 0x04 Página 344

345 Detalles. 1.- El resumen de este ejemplo es el siguiente: el módem va leyendo periódicamente, cada 15 minutos los registros ModBus de cada contador y va enviando mediante un objeto JSON a un servidor web (a la url especificada en el parámetro LOGGER_server). En caso de no poder enviar el registro (por no haber cobertura gprs en ese momento o estar el servidor caído) almacena los datos en memoria para enviarlos posteriormente. Mediante Telnet es posible conectarse al equipo directamente y consultar/cambiar en tiempo real los registros del PLC (para ello buscar en este manual los comandos AT^MTXTunnel=getmodbus y AT^MTXTUNNEL=setmodbus) 2.- Desde la versión MTX-Tunnel v7.18 es posible leer un mapa de memoria diferente para cada equipo, para ello fíjese en lo siguiente: MODBUS_address: 1;1;2;3;4;5 Aquí se ha especificado la dirección de cada contador separado por ; (punto y coma). Note que el contador 1 se ha duplicado. La razón es que es tratado como 2 dispositivos diferentes (se harán dos lecturas del mismo) porque deben de leerse 2 rangos de registros diferentes, del y MODBUS_start: 20;100;30;30;40;40 Para cada contador, se indica el registro inicial de lectura. Fíjese que como en el caso anterior, para el contador 1, que es tratado como dos contadores diferentes, y se indica el registro inicial de cada rango de registros a leer (20 y 100) MODBUS_numwords: 2;6;6;6;21;21 Para cada contador, se indica cuantos registros se van a leer. Análogamente, para el contador 1 se indica la cantidad para el primer rango de registros a leer (2 registros) y para el segundo (6 registros) 3.- El objeto JSON enviado a la URL especificada en LOGGER_server está codificado de la siguiente manera, a modo de ejemplo: {"IMEI": ,"P":"ID00001","A":1,"TS":"20/04/13 08:31:44","ST":20, "V1":23,"V2":275} Es decir, el servidor web recibe un objeto JSON con el IMEI (IMEI) del módem, un campo password (P) que también puede utilizarse para identificar el equipo (si no se quiere usar el IMEI), la dirección modbus del contador (A) que servirá para distinguir el contador al que se refiere la lectura, el time stamp (TS) de cuando se han leído los datos modbus de cada contador, y V1,V2 con cada uno de los registros leídos. Fíjese que a partir de la versión MTX-Tunnel 7.18 se introduce en el JSON el campo ST (start) en él se devuelve el número de registro inicial de lectura. Con ello podrá distinguir, en caso de hacer 2 lecturas de un mismo dispositivo (por tener rangos diferentes de registros a leer) de qué registros se tratan. Puede conocer rápidamente el número de registro leído. Si usted quiere saber a qué registro pertenece Vx, NumReg= ST+x-1. Por ejemplo V2, el caso del JSON anterior: numreg= = 21 Página 345

346 ESCENARIO EJEMPLO 6.4 Lectura y envío periódico a un servidor Web de los registros de 3 sondas de temperatura Modbus (Modelo MTX-Temp-RS485-IP65 de los accesorios MTX) Detalles del escenario ejemplo: Se dispone de 3 sondas de temperatura MTX-Temp-RS485-IP65, sondas que puede encontrar en el catálogo de accesorios MTX de Matrix Electrónica. El MTX-Tunnel debe interrogar periódicamente, cada 10 minutos a las 3 sondas de temperatura, que usan el protocolo ModBus. El registro modbus de temperatura es el 1. Las direcciones ModBus de las sondas han sido previamente configuradas y son 1,2 y 3. El MTX-Tunnel debe enviar tras cada lectura el valor de los registros a un servidor web vía HTTP GET usando un objeto JSON, pero debe ser capaz, en caso de fallo de comunicaciones GPRS, de almacenar en memoria flash hasta 100 lecturas que enviará cuando se restauren las comunicaciones. Para cada contador enviará una trama JSON, donde se indica con un identificador (la dirección modbus) el contador leído. Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i-RS485 Página 346

347 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación las sondas Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 120 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 100 El número máximo de registros dentro del MTX MODBUS_address: 1;2;3 MODBUS_start: 1;1;1 MODBUS_numwords: 1;1;1 MODBUS_period: 600 MODBUS_readCommand: 4;4;4 MODBUS_regType: 2;2;2 Direcciones modbus de las sondas a leer Direcciones iniciales de cada contador Número de registros a leer a partir del inicial de cada sonda Cada cuantos segundos se realiza una lectura Las sondas deben leerse con el comando modbus 0x04 Los registros son de 2 bytes (unsigned Word) Página 347

348 Detalles. 1.- El formato del objeto JSON que el MTX-Tunnel enviará al servidor web, será análogo a la siguiente estructura, para la sonda 1 (23.0º) {"IMEI": ,"P":"ID00001","A":1,"TS":"20/04/13 08:31:44","ST":1, "V1":230} para la sonda 2 (24.5º) {"IMEI": ,"P":"ID00001","A":2,"TS":"20/04/13 08:31:44","ST":1, "V1":245} para la sonda 3 (22.1º) {"IMEI": ,"P":"ID00001","A":2,"TS":"20/04/13 08:31:44","ST":1, "V1":221} Página 348

349 ESCENARIO EJEMPLO 6.5 Lectura y envío periódico a un servidor Web de los registros MODBUS de un PLC + pasarela GPRS para actualización remota del firmware del PLC Detalles del escenario ejemplo: Disponemos de un PLC Modbus RTU. Este PLC dispone en su memoria interna de una serie de variables/registros (por ejemplo, una temperatura y 3 contadores, ) las cuales deben leerse y enviarse periódicamente a un servidor Web. Por ello, el MTX-Tunnel debe interrogar periódicamente, cada 15 minutos, por un puerto serie RS485 al PLC para leer dichos registros. Los registros a leer son, para la temperatura el registro nº20, y los contadores están en los registros 21,22 y 23 respectivamente. El MTX-Tunnel debe enviar tras cada lectura el valor de los registros a un servidor web vía HTTP GET usando un objeto JSON, pero debe ser capaz, en caso de fallo de comunicaciones GPRS, de almacenar en memoria flash hasta 1500 lecturas que enviará cuando se restauren las comunicaciones. El PLC dispone de un puerto serie RS232 que se utiliza para actualizar el firmware. Debe poderse acceder en cualquier momento al puerto de programación del PLC, para ello se utilizará el puerto RS232 del módem MTX-65i-RS485 Solución. módem MTX-65i-RS485 + software MTX-Tunnel Bus RS232 para actualización firmware PLC Bus RS485 para lectura datos modbus Página 349

350 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: on COMM_autocts: on COMM_stopbits: 1 COMM_parity: none COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: server MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe TCP_port: SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de programación del PLC Número de bits de datos Sí hay control de flujo Sí hay control de flujo Configuramos 1 bit de stop No hay bit de paridad Velocidad del puerto serie de comunicación con el PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Activaremos la pasarela GPRS-Serie para actualización PLC Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Puerto TCP para la pasarela GPRS-Serie de actualiz. firmware Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX MODBUS_address: 1 MODBUS_start: 20 Dirección modbus del equipo a leer Dirección del registro inicial modbus a leer Página 350

351 MODBUS_numwords: 4 MODBUS_period: 900 Número de registros a leer a partir del inicial Cada cuantos segundos se realiza una lectura Detalles. 1.- El resumen de este ejemplo es el siguiente: el módem va leyendo periódicamente, cada 15 minutos una serie de registros ModBus del PLC y los va enviando mediante un objeto JSON a un servidor web (a la url especificada en el parámetro LOGGER_server). En caso de no poder enviar el registro (por no haber cobertura gprs en ese momento o estar el servidor caído) almacena los datos en memoria para enviarlos posteriormente. Mediante Telnet es posible conectarse al equipo directamente y consultar/cambiar en tiempo real los registros del PLC (para ello buscar en este manual los comandos AT^MTXTunnel=getmodbus y AT^MTXTUNNEL=setmodbus) 2.- El objeto JSON enviado a la URL especificada en LOGGER_server está codificado de la siguiente manera, a modo de ejemplo: {"IMEI": ,"P":"ID00001","A":1,"TS":"20/08/12 08:31:44","ST":20,"V1":23,"V2":275,"V3":274,"V4":32765} Es decir, el servidor web recibe un objeto JSON con el IMEI (IMEI) del módem, un campo password (P) que también puede utilizarse para identificar el equipo (si no se quiere usar el IMEI), la dirección modbus del equipo (A), el time stamp (TS) de cuando se han leído los datos modbus, la dirección inicial de las variables leídas (ST) y V1,V2, con cada una de las variables leídas. 3.- Para la pasarela GPRS-Serie de actualización de firmware del PLC se ha escogido trabajar en modo Server (MTX_mode: server) de esa manera resulta muy sencillo conectarse remotamente al MTX-Tunnel vía el programa habitual de actualización de firmware del PLC, simplemente indicando la dirección IP y puerto del MTX-Tunnel (la IP si no es fija puede obtenerse mediante una llamada perdida, un SMS o incluso utilizando DynDNS entre otras formas). Si su software de actualización de firmware del PLC no permite introducir una dirección IP, sino únicamente un puerto COM, puede usar un puerto COM virtual como el indicado en el Anexo 9. Página 351

352 ESCENARIO EJEMPLO 6.6 Ejemplo AVANZADO de lectura de dispositivos modbus con envío a Plataforma Web mediante objeto JSON Detalles del escenario ejemplo: Disponemos de 3 equipos modbus rtu. Se precisa que el MTX-Tunnel los interrogue periódicamente enviando los datos leídos a una plataforma Web mediante un objeto JSON. La plataforma web requiere autenticación por login y password. El MTX-Tunnel debe interrogar periódicamente, cada 2 minutos y por su puerto serie RS485, a los 3 dispositivos ModBus. Los registros a leer son diferentes para cada dispositivo. Dispositivo 1: registros 20 a 21 y registros 100 a 105 Dispositivo 2: registros 30 a 35 Dispositivo 3: registros 40 a 60 Los dispositivos 1 y 2 usarán el comando de lectura modbus 0x03 (el más habitual). El dispositivo 3 usará el comando de lectura modbus 0x04 Los registros 20 a 21 del Dispositivo1 deben leerse y enviarse a la plataforma web cada 2 minutos. Los registros 100 a 105 se leerán también cada 2 minutos pero únicamente queremos que se envíen a la plataforma web cada 10 minutos. Los registros 30 a 35 del Dispositivo 2 se leerán cada 2 minutos, pero únicamente se enviarán los datos a la plataforma web cuando el valor de uno de los registros varíe en 10 de la última lectura/ envío realizado. Los registros 40 a 60 del Dispositivo 3 se leerán cada 2 minutos. Se enviarán a la plataforma cada 60 minutos pero también se enviará una lectura si algún registro difiere en un valor de 25 de la última lectura/envío. Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i-RS485 Dispositivo 1 modbus RS485 BUS 485 Dispositivo 2 modbus RS485 Dispositivo 3 modbus RS485 Página 352

353 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación con dispositivos Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX LOGGER_serverLogin: milogin El Login de la plataforma web LOGGER_serverPassword: El password de la plataforma web MODBUS_address: 1;1;2;3 Direcciones modbus de los dispositivos a leer MODBUS_start: 20;100;30;40 Direcciones iniciales de cada dispositivo MODBUS_numwords: 2;6;6;21 Número de registros a leer a partir del inicial de cada dispositivo MODBUS_period: 120 Cada 120 segundos (2 min) se realiza una lectura de los registros MODBUS_readCommand: 3;3;3;4 Los 2 primeros dispositivos usan el comando de lectura 0x03 y el otro 2 usa el comando 0x04 MODBUS_logFrequency: 1;5;1;30 El dispositivo 1 manda sus variables cada 1 lectura y cada 5 Página 353

354 lecturas (es decir, 2 y 10 minutos). El dispositivo 3 lo hará 30 lecturas (es decir, cada 60 minutos). MODBUS_changeDiff: 0;0;10;25 El dispositivo 2 controla si registro varía en >=10 El dispositivo 3 controla si registro varía en >=25 MODBUS_logType: 0;0;1;2 El dispositivo 1 envía por tiempo El dispositivo 2 envía por cambio en valor El dispositivo 3 envía por tiempo y/o cambio en valor Página 354

355 ESCENARIO EJEMPLO 6.7 Uso de un MTX como datalogger modbus local, sin tarjeta SIM ni conexiones GPRS Detalles del escenario ejemplo: Se pretende tener los registros de las temperaturas máximas y mínimas de una nave industrial durante un mes completo para llevar a cabo un estudio energético Se pretende que el MTX-Tunnel haga de datalogger modbus local, es decir, que actúe y lea datos sin necesidad de enviarlos a ningún servidor web. Se pretende que el MTX-Tunnel lea los datos y los almacene internamente a modo de pendrive. Pasado el mes, un operario recogerá físicamente el módem MTX y extraerá el archivo de datos para su posterior análisis. Como dispositivo para leer la temperatura se utilizará una sonda de temperatura modbus, concretamente el modelo MTX-TEMP-IP65. Se leerá la temperatura cada 30 minutos Solución. módem MTX-65i-RS485 + software MTX-Tunnel Modem MTX-65i-RS485 Página 355

356 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_timeout: 10 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: null MTX_ping: 0 MTX_configMode: reverse LOGGER_enabled: on LOGGER_registerSize: 100 LOGGER_numRegistersFlash: 1500 MODBUS_address: 49 MODBUS_start: 1 MODBUS_numwords: 1 MODBUS_period: 600 MODBUS_readCommand: 4 Velocidad del puerto serie de comunicación las sondas Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad El módem estará conectado El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65iRS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus No habrá sincronización de tiempo Cada 35 minutos sin comunicaciones, haremos un ping Para que funcione sin tarjeta SIM Activamos el Logger del MTX, para almacenar las lecturas El tamaño del registro interno del MTX El número máximo de registros dentro del MTX Direccion modbus de la sonda Direcciones inicial a leer Número de registros a leer a partir del inicial de la sonda Cada 10 minutos se realiza una lectura Las sondas deben leerse con el comando modbus 0x04 Detalles. 1.- Fíjese que no está especificado el parámetro LOGGER_server, ya que no se utilizará ninguno. No especifique ninguno en el fichero de configuración para que el MTX-Tunnel no intente usarlo. 2.- Es muy importante que los parámetros marcados en negrita para un buen funcionamiento del escenario. 3.- Para el número de registros, se ha tenido en cuenta que las lecturas de temperatura son cada 30 minutos, lo que implica 48 lecturas al día. 48 lecturas al día por 30 días (1 mes) son 48 x 30 = 1440 registros que tiene que tener como mínimo para registrar 30 días. Especificamos 1500 registros por seguridad. Página 356

357 ESCENARIO EJEMPLO 6.8 Lectura de registros Modbus tipo Word y Binarios y envío mediante JSON a plataforma web Detalles del escenario ejemplo: Se pretende tener 12 registros modbus de un PLC De los 12 registros, 10 de ellos corresponden a registros Binarios y 2 de ellos a registros de tipo Word. Se precisa utilizar el comando 0x01 para la lectura de los registros tipo Binario y el 0x03 para los registros tipo Word. Los registros binarios se encuentran en la dirección 10,11,12, 17 y los tipo Word en la dirección 100,101 Se necesita informar a la plataforma si los datos recogidos son de tipo binario o Word, por lo que se utilizará el parámetro de usuario MODBUS_custom con tal fin. Se leerán datos cada 60 segundos. La plataforma web está protegida con un sistema de Login y Password, por lo que debe configurarse el logger con el login y Password adecuado. Solución. módem MTX-65i-RS485 + software MTX-Tunnel Bus RS485 para lectura datos modbus Página 357

358 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-65i-RS485 MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe SMS_allPhones: on SMS_sendIP: on SMS_ATEnabled: on SMS_ATResponse: on FIREWALL_enabled: off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off Velocidad del puerto serie de comunicación con el PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de MTX-65i-RS485 donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping No necesario. Se indica Europe si el MTX se instala en Europa Se pueden enviar SMS con comandos desde cualquier móvil El módem responderá con su IP a una llamada perdida o SMS Se pueden enviar comandos al MTX por SMS El MTX responderá con un SMS a un SMS de comando enviado Se podrán conectar al módem (para el Telnet) desde cualquier IP Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX LOGGER_enabled: on Activamos el Logger del MTX, para almacenar las lecturas LOGGER_password: ID00001 Campo que nos permitirá identificar de donde vienen las tramas LOGGER_server: URL donde se enviará el JSON con datos LOGGER_registerSize: 300 El tamaño del registro interno del MTX LOGGER_numRegistersFlash: 1500 El número máximo de registros dentro del MTX LOGGER_serverLogin: miusuario Login de la plataforma web LOGGER_serverPassword: mipassword Password de la plataforma web MODBUS_address: 1;1 MODBUS_start: 10;100 MODBUS_numwords: 10;2 MODBUS_period: 60 MODBUS_readCommand: 1;3 MODBUS_custom: BIN;WORD Dirección modbus del equipo a leer Dirección del registro inicial modbus a leer Número de registros a leer a partir del inicial Cada cuantos segundos se realiza una lectura Comandos a utilizar en la lectura binaria y Word Textos custom que se enviarán a la plataforma web Página 358

359 Detalles. 1.- Ejemplos de JSON recibidos por la plataforma web: Para la lectura de Words: {"IMEI": ,"TS":"02/03/14 10:15:51","C":"WORD","A":2,"ST":100,"V1":77,"V2":88 } Para la lectura de Binarios: {"IMEI": ,"TS":"02/03/14 16:32:00","C":"BIN","A":1,"ST":10,"NB":10,"V1":85,"V2":3 } 2.- Fíjese que en el caso de la lectura de registros binarios estos se devueven agrupados en registros tipo byte (2 bytes, 8 bits 2 bits. Es decir, el valor del registro binario de la dirección 10 estaría en el bit0 de V1, el valor del registro de la dirección 17 en el bit7 de V1, el registro de la dirección 18 estaría en el bit 0 de V2 y el valor del registro de la dirección 19 estaría en el bit1 del V2. En el caso anterior se usa la variable Custom para indicar que los registros son de tipo Binario. Fíjese también que en el caso de lectura de binarios aparece también la variable NB, que indica el número de bits leídos. Página 359

360 Anexo 7 Escenarios ejemplo de Metering. Escenarios de lectura de contadores vía GSM y GPRS Página 360

361 ESCENARIO EJEMPLO 7.1 Ejemplo básico para lectura de contadores, simultaneando conexiones GPRS y llamadas GSM Detalles del escenario ejemplo: Se pretende realizar lecturas de un contador eléctrico de forma periódica cada 10 minutos. Al ser un periodo de lecturas tan frecuente se accederá al contador vía GPRS en lugar de con llamadas GSM con el fin de economizar costes. Paralelamente, el operador de energía (Endesa, Iberdrola, ) va a realizar una vez al día una llamada convencional GSM de datos para realizar la lectura del contador. La llamada GSM debe ser prioritaria. Cuando el módem recibe una llamada del operador de energía debe congelar las conexiones GPRS para dar paso a las lecturas del operador. Una vez finalizada la llamada GSM, deben restablecerse las conexiones GPRS. 1 RS232/485 GPRS MTX-65i + MTXTunnel Desde sus propias oficinas se pueden realizar, de forma continua y en tiempo real, lecturas del contador eléctrico vía GPRS. Página 361

362 2 Llamada GSM RS232/485 GPRS MTX-65i + MTXTunnel Cuando diariamente la operadora eléctrica (Endesa, Iberdrola, ) hace una llamada GSM al módem para hacer una lectura del contador, las comunicaciones GPRS con el contador se congelan para dejar paso a la llamada de la operadora, que tiene prioridad. RS232/485 GPRS MTX-65i + MTXTunnel Finalizada la llamada GSM de la operadora, las comunicaciones GPRS en tiempo real se restablecen. Página 362

363 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_mode: server MTX_model: MTX-65i MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe TCP_port: Firewall_enabled: off CSD_enabled: on Velocidad del puerto serie del contador de energía Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente Conexión GPRS de tipo server Modelo del módem Tiempo de ping para supervisar conexión IP (por ejem) de Google para realizar el Ping Bandas GSM europeas Puerto TCP para establecer la pasarela gprs-serie serie y leer el contador de energía Firewall no activado Habilita la recepción de llamadas de datos GSM del operador de energía (Iberdrola, Endesa, ) Página 363

364 ESCENARIO EJEMPLO 7.2 Ejemplo avanzado para lectura de 2 equipos serie, usando un único módem / SIM y simultaneando conexiones GPRS y llamadas GSM. Pasarela adicional Serie-Serie cuando no hay conexiones GSM / GPRS. Detalles del escenario ejemplo: En el escenario actual se dispone de un módem con 2 puertos serie. En un puerto serie está conectado un contador de energía. En el otro puerto serie está conectado un PLC Cuando no existe una conexión GPRS con el módem ni está una llamada GSM establecida por parte del operador, el módem debe actuar como Gateway serie-serie, es decir, todos los datos que llegan al módem del PLC éste los debe redirigir al contador de energía y viceversa, todos los datos serie que envía el contador de energía deben reenviarse al PLC. Se deben poder establecer 2 pasarelas GPRS-Serie funcionando en paralelo. Mediante una se tendrá acceso al contador eléctrico para hacer lecturas periódicas, mediante la otra se debe poder tener acceso a los registros modbus del PLC Adicionalmente el operador de energía (Iberdrola, Endesa, ) hará una llamada GSM diaria para realizar una lectura de los datos del contador. Dicha llamada GSM debe ser prioritaria, congelando las conexiones GPRS hasta la finalización de ésta. 1 RS232/485 MTX-65i + MTXTunnel PLC RS232/485 RS232/485 Cuando no hay una conexión GPRS desde sus oficinas ni hacia el módem ni al PLC, ni hay una llamada GSM de la operadora eléctrica (Endesa, Iberdrola, ) el módem actúa como una pasarela transparente Serie-Serie, es decir, reenviando los datos del PLC directamente al contador y viceversa, reenviando los datos del contador al PLC. Página 364

365 2 RS232/485 GPRS MTX-65i + MTXTunnel RS232/485 PLC RS232/485 En el momento que se realiza una conexión GPRS con el módem, la pasarela Serie-Serie entre el PLC y el contador se interrumpe y se da paso a la pasarela transparente GPRS-RS232 entre sus oficinas y el contador, para poder realizar las lecturas de éste. 3 RS232/485 GPRS MTX-65i + MTXTunnel PLC RS232/485 GPRS RS232/485 Incluso, si lo desea, pueden realizarse 2 pasarelas GPRS-RS232/485 simultáneas desde sus oficinas hacia los dispositivos, una para acceder al contador y otra para acceder al PLC, aprovechando que el módem MTX-65i dispone de 2 puertos serie. Obviamente la pasarela Serie- Serie entre el PLC y el contador, continúa interrumpida. Página 365

366 4 Llamada GSM RS232/485 GPRS MTX-65i + MTXTunnel GPRS PLC RS232/485 Cuando disponemos de 2 pasarelas GPRS- RS232/485 simultáneas, todavía puede acceder una llamada GSM desde el operador de energía (Iberdrola, Endesa, ) y el MTXTunnel será capaz de gestionarla. En ese instante se congelan las pasarelas GPRS-RS232/485, dando prioridad a la llamada GSM del operador. 5 RS232/485 GPRS MTX-65i + MTXTunnel PLC RS232/485 GPRS RS232/485 Una vez finalizada la llamada de la operadora de energía (Endesa, Iberdrola, ) para la lectura del contador, se reestablecen las pasarelas GPRS- RS232/485 que estuvieran establecidas desde sus oficinas bien para leer el contador en tiempo real, bien para acceder al PLC, bien para ambas cosas. Página 366

367 6 RS232/485 MTX-65i + MTXTunnel RS232/485 PLC RS232/485 Y de nuevo, en el momento en que no haya llamadas GSM ni conexiones GPRS establecidas para acceder al contador o al PLC, el MTXTunnel restaura la pasarela transparente Serie-Serie entre el PLC y el contador eléctrico EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 Velocidad del puerto serie del contador de energía Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad Velocidad del puerto serie del PLC Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente Página 367

368 MTX_mode: server MTX_model: MTX-65i MTX_ping: 35 MTX_pingIP: MTX_radioBand: europe MTX_portAux: gateway TCP_port: Firewall_enabled: off CSD_enabled: on Telnet_enabled: on Telnet_port: Telnet_bypass: on Conexión GPRS de tipo server Modelo del módem Tiempo de ping para supervisar conexión IP (por ejem) de Google para realizar el Ping Bandas GSM europeas Habilita la pasarela serie-serie entre los puertos serie del módem cuando no hay conexiones (gprs ó gsm) externas. Puerto TCP para establecer la pasarela gprs-serie serie y leer el contador de energía Firewall no activado Habilita la recepción de llamadas de datos GSM del operador de energía (Iberdrola, Endesa, ) Se habilita el Telnet para usarlo como pasarela secundaria de acceso al PLC. Puerto TCP de recepción de conexiones para acceder al PLC (segunda pasarela GPRS-Serie) A on para usar el Telnet como pasarela secundaria Detalles. 1.- En este ejemplo está utilizando el Telnet como pasarela secundaria. Si no tuviera que establecer una pasarela secundaria, podría utilizar Telnet para la configuración y supervisión remota del módem. 2.- Si utiliza Telnet como pasarela secundaria (como se muestra en todo este ejemplo) podría seguir teniendo acceso remoto al módem, bien con comandos embebidos entre los tags <MTXTUNNELR></MTXTUNNELR> o bien, más sencillo, mediante simples mensajes SMS de comando. Por ejemplo vía SMS puede consultar la cobertura del módem, cambiar ó leer una configuración, Página 368

369 Anexo 8 Escenarios y Configuraciones de Ejemplo para el uso de las Salida Digitales y Relés Página 369

370 ESCENARIO EJEMPLO 8.1 Apertura de puerta mecánica mediante una llamada perdida desde un número de teléfono autorizado. Detalles del escenario ejemplo: Se dispone de la puerta mecánica de un garaje que actualmente se abre mediante un pulsador. Se pretende poder abrir la puerta adicionalmente mediante una llamada perdida. Para ello, al realizar una llamada perdida, debe conmutarse un relé durante un par de segundos. Ese relé estará conectado en paralelo al pulsador actual de apertura de puerta. Únicamente los números de teléfono autorizados podrán abrir la puerta Se deberán poder modificar los números autorizados para realizar la llamada por SMS Solución. módem MTX-IND + software MTX-Tunnel MTX-INDv2 Página 370

371 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND MTX_mode: none No queremos GPRS MTX_urc: off No necesitamos los mensajes de información URC SMS_allPhones: off SMS_ATEnabled: on SMS_ATResponse: on Todos los teléfonos no van a ser utilizados Por si queremos modificar números autorizados Por si queremos modificar números autorizados SMS_validPhone1: Número autorizado 1 SMS_validPhone2: Número autorizado 2 SMS_validPhone3: Número autorizado 3 OUTPUT_mode1: call El relé asociado a OUTPUT1 controlará la puerta Detalles. 1.- Para poder modificar los números de teléfono autorizados por SMS, es necesario enviar un SMS desde un número de teléfono autorizado con el texto, por ejemplo: mtxtunnel at^mtxtunnel=setparam,sms_validphone1, La cabecera anterior marcada en rojo (mtxtunnel) es posible personalizarla con el texto que desee, para ello consulte el parámetro de configuración SMS_header Página 371

372 ESCENARIO EJEMPLO 8.2 Envío alarma SMS y activación de salida digital ante una temperatura fuera de márgenes. Uso de una sonda modbus RS485 Detalles del escenario ejemplo: Se necesita comprobar la temperatura de una sala para que esté dentro de unos márgenes comprendidos entre 22 y 28 grados. En el caso de que la temperatura sea igual o inferior a 21 grados el módem debe de enviar un mensaje SMS de alarma al teléfono con el texto: Alarma temperatura baja. En el caso de que la temperatura sea igual o superior a 29 grados el módem debe de enviar un mensaje SMS de alarma al teléfono con el texto: Alarma temperatura alta. Se utilizará una sonda de temperatura RS485 modbus (por ejemplo el accesorio MTX- Temp-RS485-IP65), con dirección modbus 1. En esta sonda de temperatura el comando de lectura modbus es el 4 y el registro donde está almacenada la temperatura es el 2. Además de enviar el SMS, el equipo debe conmutar una salida de relé cuando la temperatura esté por encima de los 29º, pues se necesita activar una advertencia luminosa. Solución. módem MTX-IND + software MTX-Tunnel SMS: Alarma temperatura alta Salida relé MTX-IND Sensor temperatura Modbus RS485 (modelo MTX-Temp-RS485-IP65) Página 372

373 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none Velocidad del puerto serie de comunicación con la soinda Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND MTX_mode: none No queremos GPRS MTX_portAux: modbusmaster El puerto aux se va a utilizar como master modbus para lectura sonda OUTPUT_mode1: modbus La salida OUTPUT 1 (relé 1) conmutará en función de un registro modbus OUTPUT_config1: 1;4;2;29;21;AT^MTXTUNNEL=SMS, ,Alarma temperatura alta;at^mtxtunnel=sms, ,alarma temperatura baja Por orden, esta es la explicación de OUTPUT_config1: 1: dirección modbus de la sonda de temperatura 4: el comando de lectura modbus de la sonda de temperatura 2: la temperatura de la sonda está en el registro número 2 29: el relé se activará si el valor leído de la sonda es igual o superior a 29 21: el relé se activará si el valor leído de la sonda es igual o inferior a 21 AT^MTXTUNNEL=SMS, ,Alarma temp alta: Cuando el valor leído supere el límite superior (> =29) se ejecutará este comando AT. Este comando AT envía un SMS de alerta. AT^MTXTUNNEL=SMS, ,Alarma temp baja: Cuando el valor leído supere el límite inferior (< =22) se ejecutará este comando AT. Este comando AT envía un SMS de alerta. Página 373

374 ESCENARIO EJEMPLO 8.3 Activación de Relés en función de la Hora, del valor de un dispositivo 4-20mA y del valor de los registros modbus de una sonda de temperatura. Envío de alarmas SMS en función de un registro modbus. Detalles del escenario ejemplo: Disponemos de una fábrica que cuenta con 2 sistemas de refrigeración: A y B. Se pretende que los sistemas de refrigeración estén detenidos cuando la temperatura ambiente esté por debajo de los 25ºC. A partir de los 26º (1 grado de histéresis) el Sistema de dlimatización A debe de entrar en funcionamiento. A partir de los 30º el Sistema de climatización B también debe entrar en funcionamiento. El sistema B de refrigeración se desactivará cuando la temperatura esté de nuevo por debajo de los 28º (2 grados de histéresis). Cada uno de los sistemas de refrigeración A y B será controlado con un relé del modem MTX La fábrica cuenta en su interior con una sonda de temperatura modbus RS485 (modelo MTX-Temp-RS485-IP65), con la cual se leerán las lecturas de temperatura. Dicha sonda tiene la dirección modbus 1 y el registro modbus donde almacena la temperatura es el nº 2. El comando de lectura modbus de esta sonda es el 4. Adicionalmente, cuando el sistema de refrigeración B entre en funcionamiento, se debe enviar un SMS de aviso al número de teléfono con el texto: sistema B activado. Debe controlarse también con un relé el alumbrado de apoyo interior de la fábrica. Se pretende activar las luces de apoyo interior desde las 20:00 UTC hasta las 07:30 UTC. Para ello se usará otro relé del módem MTX También se pretende controlar el alumbrado exterior con otro relé del MTX. Para este caso se utiliza un sensor lumínico LDR01 de 4-20mA. Cuando el valor leido sea <10mA debe activarse el relé para activar las luces exteriores. Cuando el valor leído sea >11mA (1mA de histéresis) el relé debe desconectarse. Solución. módem MTX-IND + software MTX-Tunnel Página 374

375 Iluminación Exterior Iluminación Interrior Sistema climatización A 4-20mA Sensor LUZ 4-20mA Bus RS485 Sistema climatización B MTX-INDv2 Sensor temperatura Modbus RS485 (MTX-Temp-RS485-IP65) EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM2_baudrate: 9600 COMM2_bitsperchar: 8 COMM2_autorts: off COMM2_autocts: off COMM2_stopbits: 1 COMM2_parity: none GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 MTX_PIN: 0000 MTX_mode: none MTX_model: MTX-IND MTX_portAux: modbusmaster MTX_TPServer: time-a.timefreq.bldrdoc.gov MTX_TPServer2: ptbtime1.ptb.de MTX_ping: 35 MTX_pingIP: Velocidad del puerto serie de comunicación con la soinda Número de bits de datos No hay control de flujo No hay control de flujo Configuramos 1 bit de stop No hay bit de paridad APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente El PIN de la tarjeta SIM Modo de trabajo de pasarela gprs/serie. A none pq no las usamos Modelo de módem donde está instalado el MTX-Tunnel El puerto aux se va a utilizar como master modbus Servidor de hora (el MTX debe sincronizar la hora) Servidor de hora de backup Cada 35 minutos sin comunicaciones, haremos un ping Dirección donde se realiza el ping Página 375

376 MTX_radioBand: europe No necesario. Se indica Europe si el MTX se instala en Europa TELNET_enabled: on TELNET_login: user TELNET_password: 1234 TELNET_firewall: off OUTPUT_mode1: time OUTPUT_config1: 20;00;07;30 Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Se podrán conectar por telnet desde cualquier IP al MTX El Output1 controlará la iluminación exterior por Hora La hora de encendido / apagado de Output1 OUTPUT_mode2: analog El Output2 controlará iluminación exterior con sensor 4-20mA OUTPUT_config2: 0;11;10;; Se usará el canal 0, y el relé conmutará con valores >11 y <10 OUTPUT_mode3: modbus El Output3 controlará el aparato climatización A OUTPUT_config3: 1;4;2;26;25;; Direccion modbus 1, comando 4, registro 2, se activa para > 26 grados y se desactiva para < 25 grados OUTPUT_mode4: modbus El Output4 controlará el aparato climatización B OUTPUT_config4: 1;4;2;30;28;AT^MTXTUNNEL=SMS, ,Sistema B Activado; Direccion modbus 1, comando 4, registro 2, se activa para > 30 grados y se desactiva para < 28 grados. Cuando la temperatura supere los 30 grados enviará el mensaje Sistema B Desactivado Detalles. 1.- El relé asociado a OUTPUT 1 controla la iluminación interna mediante un sistema horario, de ahí que el modo de funcionamiento sea time. Se especifica un encendido a las 20:00 y un apagado a las 07: El relé asociado a OUTPUT 2 controla la iluminación externa. Este relé se activará cuando haya se lea del conversor ADC 0 del MTX (el MTX-IND tiene dos, el 0 y el 1) un valor <10 y se desactivará cuando se lea del conversor ADC 0 del MTX un valor > 11. En dicho conversor ADC0, funcionando en modo 4-20mA, está conectado el sensor de luz 4-20mA. Nótese que realmente el relé va a conmutar cuando el valor leído sea > 11 y desconmutar cuando sea <10, por lo que en lugar de utilizar la borna NA del relé (normalmente abierto) debe usar la borna NC (normalmente cerrado). Fíjese en los 2 ; del final. Recuerde que son necesarios ua que no especificamos ningún comando AT a ejecutar. 3.- El relé asociado a OUTPUT3 controla el equipo de climatización A. Éste se activará cuando la temperatura exceda de 26 grados y se desconectará cuando baje de 25 grados. Esta temperatura se lee de una sonda de temperatura modbus con dirección 1, para la cual se usa el comando de lectura modbus 4 y el registro donde está almacenada la temperatura es el nº 2. Fíjese en los 2 ; del final. Recuerde que son necesarios ua que no especificamos ningún comando AT a ejecutar. 4.- El relé asociado a OUTPUT4 controla el equipo de climatización B. Éste se activará cuando la temperatura exceda de 30 grados y se desconectará cuando baje de 28 grados. Esta temperatura se lee de una sonda de temperatura modbus con drección 1, para la cual se usa el comando de lectura modbus 4 y el registro donde está almacenada la temperatura es el nº 2. En el caso de superarse los 30º y por tanto activarse el relé, se mandará un SMS de alarma al número de teléfono con el mensaje Sistema B Activado. Página 376

377 ESCENARIO EJEMPLO 8.4 Conmutación de un relé en función del reloj astronómico del MTX Detalles del escenario ejemplo: Se necesita conmutar un relé en función de la salida y puesta del Sol para activar un sistema de iluminación. No es posible establecer una hora fija, puesto que la hora de Salida y Puesta de Sol depende del lugar (no amanece / anochece a la misma hora en Madrid, que Barcelona o México DF) y del día del año (no ananece / anochece a la misma hora en Verano que en Invierno). Para ello debe configurarse el módem MTX como un reloj astronómico. Se desea además que las luminarias se activen 30 minutos antes de la puesta de sol y se desactiven 30 minutos después a la salida del Sol. La ubicación del dispositivo es la localidad de Cardedeu, con posición GPS latitud: y longitud: Solución. módem MTX-IND + software MTX-Tunnel MTX-INDv2 En función de la Salida / Puesta del Sol, el relé conmutará. Salida relé activación luminaria Página 377

378 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND MTX_mode: none No queremos pasarelas GPRS MTX_TPServer: time-a.timefreq.bldrdoc.gov Servidor de hora (el MTX debe sincronizar la hora) MTX_TPServer2: ptbtime1.ptb.de Servidor de hora de backup MTX_latitude: Posición GPS latitud MTX_longtude: Posición GPS longitud GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 1 OUTPUT_mode1: astronomical OUTPUT_config1: -30;30 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem no estará conectado permanentemente La salida OUTPUT 1 (relé 1) en función del SOL Offset de -30 minutos (puesta) y 30 minutos (salida) Detalles. 1.- Por supuesto este escenario puede combinarse con otros que simultáneamente realicen pasarelas Serie/GPRS para acceder a dispositvos serie (modbus u otros) así como otros en los que el MTX-Tunnel recolecte de forma autónoma datos modbus y los envíe mediante JSON a plataformas Web. Página 378

379 ESCENARIO EJEMPLO 8.5 Conmutando un Relé durante X segundos con un único mensaje SMS Detalles del escenario ejemplo: Se necesita poder activar una serie de relés durante unos segundos mediante el envío de un único mensaje SMS. Se pretende que al enviar un SMS con el texto ONx, donde x es 1,2,3,4 se activen durante X segundos el relé correspondiente. Se pretende que el Relé 1 (al recibir el texto ON1 ) se active durante 10 segundos, el Relé 2 durante 20 segundos (al recibir el texto ON2 ), el Relé 3 durante 30 segundos (al recibir el texto ON3 )y el Relé 4 durante 60 segundos (al recibir el texto ON4 ). Únicamente se podrá activar un Relé desde los números de teléfono autorizados y Se necesita poder activar también remotamente, mediante Telnet, los relés, así como poder cambiar la configuración del MTX remotamente. Solución. módem MTX-IND + software MTX-Tunnel SMS Página 379

380 EJEMPLO de configuración (fichero config.txt) para el escenario indicado que debe contener cada MTX-Tunnel: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 10 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM Las sesiones GPRS de mantenimiento serán de 10 minutos. MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND El modelo MTX escogido es el MTX-IND por los relés MTX_mode: none No necesitamos túneles serie-gprs MTX_urc: off No necesitamos los mensajes de información URC FIREWALL_enabled: off OUTPUT_mode1: timer OUTPUT_mode2: timer OUTPUT_mode3: timer OUTPUT_mode4: timer Firewall desactivado para aceptar conexiones desde cualquier IP El salida 1 del MTX (Relé1) la ponemos en modo Timer El salida 2 del MTX (Relé2) la ponemos en modo Timer El salida 3 del MTX (Relé3) la ponemos en modo Timer El salida 4 del MTX (Relé4) la ponemos en modo Timer SMS_allPhones: off Sólo queremos los 100 números de teléfono autorizados SMS_validPhone1: Indicamos el número de teléfono autorizado 1 SMS_validPhone2: Indicamos el número de teléfono autorizado 2 SMS_ATEnabled: on Se aceptan comandos AT por SMS SMS_ATResponse: on Se devuelve la respuesta al comando enviado por SMS SMS_alias1: ON1>AT^MTXTUNNEL=SETOUTPUTTIMER,1,10 Se activará Output1 durante 10 seg SMS_alias2: ON2>AT^MTXTUNNEL=SETOUTPUTTIMER,2,20 Se activará Output2 durante 20 seg SMS_alias3: ON3>AT^MTXTUNNEL=SETOUTPUTTIMER,3,30 Se activará Output3 durante 30 seg SMS_alias4: ON4>AT^MTXTUNNEL=SETOUTPUTTIMER,4,60 Se activará Output4 durante 60 seg SMS_aliasOk: Comando Ok Se envía este texto por SMS si el comando SMS se ejecutó bien SMS_aliasError: Comando Error Se envía este texto por SMS si el comando SMS se ejecutó mal TELNET_enabled: on TELNET_login: user TELNET_password: 1234 Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Detalles. 1.- Recuerde que en los módems MTX-IND y MTX-IND-V1 (tablas de los anexos de este manual), Output1 hace referencia al Relé1, Output2 hace referencia al Relé2, Output3 al Relé3 y Output4 al Relé4. Página 380

381 Anexo 9 Escenarios ejemplo con Bluetooth. Página 381

382 ESCENARIO EJEMPLO 9.1 Acceso al puerto RS232 de lectura de una máquina de vending a través de 3G y de Bluetooth. Detalles del escenario ejemplo: Se precisa poder acceder al puerto RS232 de una máquina de Vending de forma remota desde las oficinas centrales de la compañía. Se usará una tarjeta SIM con dirección IP fija y el módem debe estar siempre online a la espera de conexiones en el puerto TCP Es necesario que varios operarios puedan acceder al mismo puerto RS232 de forma local. Dichos operarios llevan consigo un teléfono Android con Bluetooth y con una App que les debe poder permitir establecer una conexión bluetooth SPP contra el puerto RS232 de la máquina a través del MTX Desde las oficinas centrales podrá accederse a la máquina en cualquier momento y, cuando no haya conexión, cualquier operario podrá acceder vía bluetooth para hacer las lecturas de la máquina. Por seguridad el módulo bluetooth tiene que tener un PIN (123499) y el friendly name bluetooth tiene que tener por nombre será: MTXTUNNEL. Solución. módem MTX-3G-JAVA-BAT (con bluetooth) + software MTX-Tunnel RS232 3G/GPRS MTX-3G-JAVA- BAT MTXTunnel Página 382

383 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none Velocidad del puerto serie de la máquina de Vending Número de bits de datos de la máquina de Vending No hay control de flujo en la máquina de Vending No hay control de flujo en la máquina de Vending Configuramos 1 bit de stop para la máquina de Vending No hay bit de paridad len a máquina de Vending COMM2_baudrate: Velocidad del puerto serie bluetooth (obligatorio ) COMM2_bitsperchar: 8 Número de bits de datos bluetooth (obligatorio 8) COMM2_autorts: on No hay control de flujo bluetooth (obligatorio on) COMM2_autocts:on No hay control de flujo bluetooth (obligatorio on) COMM2_stopbits: 1 Configuramos 1 bit de stop bluetooth (obligatorio 1) COMM2_parity: none No hay bit de paridad bluetooth (obligatorio none) GPRS_apn: internetestatico.movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-3G-JAVA-BAT El modelo MTX escogido es el MTX-3G-JAVA-BAT MTX_mode:server No queremos pasarelas GPRS MTX_portAux: gateway Gateway serie-serie necesaro para bluetooth MTX_ping: 30 Ping para asegurar la conectividad 3G/Gprs MTX_pingIP: IP para realizar el ping MTX_urc: on Mensajes URC habilitados. TCP:port: BLUETOOTH_enabled: on BLUETOOTH_name: MTXTunnel BLUETOOTH_pin: BLUETOOTH_mode: server FIREWALL_enabled:off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 Puerto TCP de espera de conexiones Bluetooth habilitado Bluetooth friendly name Pin de seguridad del módulo bluetooth Modo de funcionamiento del módulo bluetooth Firewall deshabilitado Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Página 383

384 Detalles. 1.- Los parámetro COMM_ hacen referencia a la configuración del puerto serie RS232 de la máquina de Vending. Los parámetros COMM2_ hacen referencia a la configuración RS232 del módulo bluetooth interno del MTX y deben permanecer así con los valores del ejemplo. 2.- La pasarela Bluetooth podrá establecerse siempre que no haya un socket establecido (es decir, una pasarela GPRS-Serie accediendo a la máquina). Página 384

385 ESCENARIO EJEMPLO 9.2 Lectura de entradas digitales y analógicas y conmutación de relés desde una App Android, vía Bluetooth y vía GPRS/3G. Detalles del escenario ejemplo: Se pretende diseñar una App para teléfonos Android que permita realizar el control domótico de un loft. Se necesita poder conocer el estado de tres ventanas (abierta / cerrada) así como el estado de la puerta de entrada (abierta / cerrada). Del mismo modo se quiere poder monitorizar en cualquier momento la temperatura de la estancia. También, mediante el uso de 4 relés se quiere poder: 1.- activar / desactivar la calefacción, 2.- activar / desactivar la luz principal de la estancia, 3.- Subir / Bajar tres persianas motorizadas. La App que se diseñará para teléfonos Android debe presentar en pantalla la información indicada en el apartado anterior. Del mismo modo presentará botones para poder conmutar los diferentes relés. Tanto la lectura de las entradas como digitales, la lectura de la temperatura y la conmutación de relés debe poderse hacer tanto por Bluetooth como vía GPRS/3G Para la lectura de la temperatura se usará una sonda MTX-Temp-RS485 (modbus) conectada al terminal. Solución. módem MTX-IND-3G-JAVA (con bluetooth) + software MTX-Tunnel Bus RS485 3G/GPRS Página 385

386 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none Velocidad del puerto serie de la máquina de Vending Número de bits de datos de la máquina de Vending No hay control de flujo en la máquina de Vending No hay control de flujo en la máquina de Vending Configuramos 1 bit de stop para la máquina de Vending No hay bit de paridad len a máquina de Vending COMM2_baudrate: Velocidad del puerto serie bluetooth (obligatorio ) COMM2_bitsperchar: 8 Número de bits de datos bluetooth (obligatorio 8) COMM2_autorts: on No hay control de flujo bluetooth (obligatorio on) COMM2_autocts:on No hay control de flujo bluetooth (obligatorio on) COMM2_stopbits: 1 Configuramos 1 bit de stop bluetooth (obligatorio 1) COMM2_parity: none No hay bit de paridad bluetooth (obligatorio none) GPRS_apn: internetestatico.movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-3G-JAVA El modelo MTX escogido (con opción bluetooth) MTX_mode:server No queremos pasarelas GPRS MTX_portAux: gateway Gateway serie-serie necesaro para bluetooth MTX_ping: 30 Ping para asegurar la conectividad 3G/Gprs MTX_pingIP: IP para realizar el ping MTX_urc: on Mensajes URC habilitados. TCP:port: BLUETOOTH_enabled: on BLUETOOTH_name: MTXTunnel BLUETOOTH_pin: BLUETOOTH_mode: server FIREWALL_enabled:off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 Puerto TCP de espera de conexiones Bluetooth habilitado Bluetooth friendly name Pin de seguridad del módulo bluetooth Modo de funcionamiento del módulo bluetooth Firewall deshabilitado Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Página 386

387 Detalles. 1.- La aplicación únicamente vale para teléfonos Android, Windows y cualquier otro sistema operativo que soporte comunicaciones bluetooth con perfil SPP (los productos Apple no soportan SSP). 2.- Como puede extraerse del análisis del fichero de configuración, la app debe programarse para comunicarse con el MTX-IND-3G-JAVA y realizar las lecturas de las entradas digitales, conmutación de relés y lectura de sonda de temperatura mediante comandos AT enviados desde el teléfono móvil al terminal MTX En este manual encontrará los comandos AT necesario para ello. Para la lectura de las entradas digitales dispone del comando AT^MTXTUNNEL=GETIOS. Para la conmutación de relés el comando AT^MTXTUNNEL=SETRELAYS. Para la lectura de dispositivos modbus: AT^MTXTUNNEL=GETMODBUS 3.- Los comandos AT pueden enviarse mediante 3G o mediante Bluetooth. Para poder enviar comandos AT vía 3G hay que hacer primero una conexión Telnet contra el MTX. Para poder enviar comandos AT vía Bluetooth hay que hacer primero una conexión bluetooth SPP (Serial Port Profile) desde el teléfono móvil al MTX. Página 387

388 Anexo 10 Escenarios ejemplo de pagos mediante Bitcoin Página 388

389 ESCENARIO EJEMPLO 10.1 Pago instantáneo on-line con Bitcoin para activación temporal de relés. Activación de un sistema de autolavado de coches. Detalles del escenario ejemplo: Se dispone de un sistema de lavado de coches que funciona con monedas. Actualmente, cada vez que se introduce una moneda (1 ) se activa durante 2 minutos mediante un relé la manguera a presión de lavado. Se quiere añadir un sistema online de pago por teléfono móvil que permita activar el relé de la manguera a presión, además de conservar, en paralelo, el sistema de pago por moneda. Como sistema de pago on-line se va a utilizar la red de pago Bitcoin. Por cada bitcoins (aprox 1 al cambio) el sistema activará la manguera durante 2 minutos. Se pretende que sea proporcional, es decir, si la dirección bitcoin asociada al MTX recibe bitcoins, la manguera se activará durante 4 minutos. En ningún caso se admitirá que una manguera pueda estar activa más de 10 minutos consecutivos. El usuario deberá pulsar un pulsador conectado a una entrada digital del terminal MTX tras realizar la transferencia para activar la manguera. La dirección Bitcoin asociada al MTX-Tunnel que gestiona los relés será la siguiente : 1FTvXXEJCEFuRLe9A8ZZt2865KGiGet57r Solución. módem MTX-IND-3G-JAVA + software MTX-Tunnel QR de dirección bitcoin Modem MTX-IND-3G-JAVA Pulsador de activación Página 389

390 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: GPRS_apn: movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-IND-3G-JAVA El modelo MTX escogido es el MTX-IND-3G-JAVA MTX_mode: none No queremos pasarelas GPRS MTX_ping: 30 Ping para asegurar la conectividad 3G/Gprs MTX_pingIP: IP para realizar el ping MTX_urc: on Mensajes URC habilitados. FIREWALL_enabled:off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 OUTPUT_mode1: bitcoin OUTPUT_config1: 0.002;120;1;600 WAKEUP_gpioEnabled: on WAKEUP_gpioValue: 2 Firewall deshabilitado Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet Modo de trabajo del relé por Bitcoin bitcoin por 120 segundos. Tiempo proporcional activado. Máximo 600 segundos (10 minutos). Debe activarse la entrada digital del terminal (de wakeup) para. activar el sistema. El GPIO de wakeup se activará por cambio de estado. BITCOIN_enabled: on Habilitado sistema Bitcoin BITCOIN_address: 1ECacP1YxYPQoZZjfd5bVp885RA4tqRkki Dirección bitcoin asociado al MTX BITCOIN_period: 15 Tras activarse la entrada digital de wakeup el sistema comprueba la cuenta cada 15 segundos durante 3 minutos BITCOIN_wakeup: on Entrada de wakeup habilitada BITCOIN_confirmations: 0 0 confirmaciones porque queremos tiempo real Página 390

391 Detalles. 1.- El funcionamiento es muy simple. El cliente que quiera activar el relé de encendido envía una cantidad determinada de bitcoins a una dirección bitcoin que está asociada al MTX. Después, el cliente presiona un pulsador que está conectado a la entrada digital de WakeUp del MTX. El MTX conmutará el relé el tiempo programado cuanto detecte que la transacción de bitcoins ha sido realizada. 2.- La dirección bitcoin debe ser única para cada dispositivo MTX. Es decir, si usted posee 10 MTX necesita generar 10 direcciones bitcoin. Recuerde que las direcciones bitcoin son gratuitas y puede generar tantas como desee. 3.- Se recomienda el uso de un código QR que codifique la dirección bitcon para mayor comodidad del usuario final. Actualmente todos los monederos bitcoin para teléfono móvil permiten la conversión de códigos QR el direcciones bitcoin mediante la cámara de fotos. 4.- Si lo desea, puede convertir sus bitcoin en dinero fiat (, $, ) con cualquier Exchange (BTC-E, Coinbase, Bitstamp, ) 5.- Si necesita más información sobre el sistema de pagos bitcoin puede encontrar información aquí: Otros escenarios de ejemplo donde puede aplicarse este método de activación temporal de relé por pago on-line: Atracciones temporizadas activadas por monedas Sistemas de energía temporizados (campings, ) Televisiones de hospitales temporizadas Lavadoras temporizadas por monedas Página 391

392 ESCENARIO EJEMPLO 10.2 Recepción de pago on-line mediante teléfono móvil con Bitcoin para máquina de Vending Detalles del escenario ejemplo: Se dispone de una máquina de vending de latas de refresco. Dicha máquina actualmente funciona con monedas. En función del dinero ingresado en la máquina ésta te entrega un refresco u otro. Se quiere añadir un sistema online de pago por teléfono móvil. Para ello se utilizará la red de pagos Bitcoin. Cada vez que se realice un ingreso en la dirección Bitcoin asociada al MTX-Tunnel, el módem enviará un mensaje URC por su puerto serie con la transferencia recibida al puerto serie de la máquina para que ésta pueda contabilizar el ingreso y permita que el usuario extraiga un refresco. La dirección Bitcoin asociada al MTX-Tunnel será la siguiente : 1FTvXXEJCEFuRLe9A8ZZt2865KGiGet57r Solución. módem MTX-65i + software MTX-Tunnel QR de dirección bitcoin Modem MTX-65i Página 392

393 EJEMPLO de configuración (fichero config.txt) para el escenario indicado: COMM_baudrate: 9600 COMM_bitsperchar: 8 COMM_autorts: off COMM_autocts: off COMM_stopbits: 1 COMM_parity: none Velocidad del puerto serie de la máquina de Vending Número de bits de datos de la máquina de Vending No hay control de flujo en la máquina de Vending No hay control de flujo en la máquina de Vending Configuramos 1 bit de stop para la máquina de Vending No hay bit de paridad len a máquina de Vending MTX_PIN: 0000 Si la tarjeta SIM no tiene PIN, dejar en 0000 MTX_model: MTX-65i El modelo MTX escogido es el MTX-65i MTX_mode: none No queremos pasarelas GPRS MTX_ping: 30 Ping para asegurar la conectividad 3G/Gprs MTX_pingIP: IP para realizar el ping MTX_urc: on Mensajes URC habilitados. GPRS_apn: internetestatico.movistar.es GPRS_login: MOVISTAR GPRS_password: MOVISTAR GPRS_timeout: 0 FIREWALL_enabled:off TELNET_enabled: on TELNET_login: user TELNET_password: 1234 APN GPRS proporcionado por el operador GSM Login GPRS proporcionado por el operador GSM Password GPRS proporcionado por el operador GSM El módem estará conectado permanentemente Firewall deshabilitado Habilitamos el Telnet del módem Login para el Telnet Password para el Telnet BITCOIN_enabled: on Habilitado sistema Bitcoin BITCOIN_address: 1ECacP1YxYPQoZZjfd5bVp885RA4tqRkki Dirección bitcoin asociado al MTX BITCOIN_period: 30 El sistema comprueba la cuenta cada 30 segundos BITCOIN_wakeup: off Entrada de wakeup no habilitada BITCOIN_confirmations: 0 0 confirmaciones porque queremos tiempo real Detalles. 1.- El funcionamiento es muy simple. Los clientes que quieran una bebida realizan una transferencia de bitcoins a la dirección asociada al MTX. El MTX no utiliza la entrada de wakeup y está comprobando cada 30 segundos si hay una nueve transferencia bitcoin (necesaria tarifa plana si no se usa entrada de wakeup). Cuando detecta un nuevo ingreso informa de este enviando un mensaje URC por su puerto serie ( ejemplo: ^MTX_BITCOIN_INCOME_0.002 ) 2.- La dirección bitcoin debe ser única para cada dispositivo MTX. Es decir, si usted posee 10 MTX necesita generar 10 direcciones bitcoin. Recuerde que las direcciones bitcoin son gratuitas y puede generar tantas como desee. Página 393

394 3.- Se recomienda el uso de un código QR que codifique la dirección bitcon para mayor comodidad del usuario final. Actualmente todos los monederos bitcoin para teléfono móvil permiten la conversión de códigos QR el direcciones bitcoin mediante la cámara de fotos. 4.- Si lo desea, convertir sus bitcoin en dinero fiat (, $, ) con cualquier Exchange (BTC-E, Coinbase, Bitstamp, ) Página 394

395 Anexo A Descripción de las E/S usadas por el MTX-Tunnel Página 395

396 MTX-65i + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65i Descripción: El módem MTX-65i dispone, en su conexión de expansión DB15, de 4 entradas/salidas digitales y de 2 conversores A/D. El software MTX-Tunnel usa las entradas salidas de la siguiente manera: TC65i Situación Nº PIN E/S Función GPIO1 DB15 4 Entrada digital Wake up GPIO2 DB15 11 Entrada digital Alarma SMS GPIO3 DB15 5 Salida digital 1 * User GPIO4 DB15 12 Salida digital 2 * User ADC1 DB15 15 Entrada analog. User ADC2 DB15 13 Entrada analog. User La columna TC65i hace referencia al GPIO correspondiente del módulo TC65i que lleva interno el MTX-65i. La columna Situación indica en qué conector del MTX-65i se encuentra dicha E/S La columna Nº PIN indica en qué pin del conector se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX-65i, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO1 y GPIO2 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO1 y GPIO2 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al PIN 5 del conector DB15 Los parámetros OUTPUT_xxx2 hacen referencia al PIN 12 del conector DB15 * a partir de la versión MTX-Tunnelv5.3, GPIO3 y GPIO4 son consideradas entradas digitales si el parámetro DNS_gpios está establecido a on. Página 396

397 MTX-65i-ULP + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65i-ULP Descripción: El módem MTX-65i-ULP dispone, en su conexión de expansión DB15, de 5 entradas/salidas digitales ) y de 1 conversores A/D. En el conector RJ de alimentación dispone de otras 4 entradas de tamper (para despertar el módem). El software MTX-Tunnel usa las entradas salidas de la siguiente manera: TC65 Situación Nº PIN E/S Función GPIO1 DB15 4 Entrada digital Wake up GPIO2 DB15 11 Entrada digital Alarma SMS GPIO3 DB15 5 Salida digital 1 User GPIO4 DB15 12 Salida digital 2 User GPIO6 RJ12 2 Entrada tamper Tamper1 GPIO7 RJ12 3 Entrada tamper Tamper2 GPIO8 RJ12 4 Salida tamper Tamper3 GPIO9 RJ12 5 Salida tamper Tamper4 GPIO10 DB15 13 Entrada digital User ADC1 DB15 15 Entrada analog. User La columna TC65 hace referencia al GPIO correspondiente del módulo TC65 que lleva interno el MTX-65i-ULP. La columna Situación indica en qué conector del MTX-65i-ULP se encuentra dicha E/S La columna Nº PIN indica en qué pin del conector se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX-65i-ULP, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO1 y GPIO2 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO1 y GPIO2 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al PIN 5 del conector DB15 Los parámetros OUTPUT_xxx2 hacen referencia al PIN 12 del conector DB15 Página 397

398 (MTX-65-GPS-V3 / MTX-65-GPS-BAT-V5 / MTX-65i-GPS-V6 / MTX-65i-GPS- BAT-V7) + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65+G Descripción: El módem serie +GPS dispone, en su conexión de expansión DB15, de 5 entradas/salidas digitales, 4 entradas de tamper (para despertar el módem) y de 1 conversores A/D. El software MTX-Tunnel usa las entradas salidas de la siguiente manera: XT65 Situación Nº PIN E/S Función GPIO4 DB15 12 Salida digital 1 User GPIO5 RJ12 5 Entrada digital Wake up GPIO7 DB15 11 Entrada digital User GPIO8 DB15 5 Salida digital 2 User GPIO9 DB15 4 Entrada digital Alarma SMS GPIO10 DB15 13 Entrada digital User ADC1 DB15 15 Entrada analog. User ADC2 DB15 9 Entrada analog. User La columna XT65 hace referencia al GPIO correspondiente del módulo XT65 que lleva interno el MTX-65+G. La columna Situación indica en qué conector del MTX se encuentra dicha E/S La columna Nº PIN indica en qué pin del conector se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO5 y GPIO9 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO5 y GPIO9 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al PIN 12 del conector DB15 Los parámetros OUTPUT_xxx2 hacen referencia al PIN 5 del conector DB15 Página 398

399 MTX-IND / MTX-IND-V1 / MTX-IND-3G-JAVA + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-IND, MTX-IND-V1 y MTX-IND-3G-JAVA Descripción: El módem MTX-IND dispone de las siguientes entradas/salidas digitales, analógicas y relés: TC65i Situación Nº Borna E/S Función GPIO1 Bornas 5,6,7 Relé 1 User GPIO2 Bornas 8,9,10 Relé 2 User GPIO3 Bornas 11,12,13 Relé 3 User GPIO4 Bornas 41 Entrada digital Wake up GPIO5 Bornas 17,18 Entrada digital User GPIO6 Bornas 19,20 Entrada digital User GPIO7 Bornas 14,15,16 Relé 4 User GPIO8 Bornas 40 Entrada digital Alarma SMS GPIO9 Bornas 39 Entrada digital User GPIO10 Bornas 38 Entrada digital User ADC1 Bornas 36 Entrada analog. User ADC2 Bornas 35 Entrada analog. User La columna TC65i hace referencia al GPIO correspondiente del módulo TC65i que lleva interno el MTX-IND. La columna Situación indica en qué conector del MTX-IND se encuentra dicha E/S La columna Nº PIN indica en qué borna se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX-IND, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO4 y GPIO8 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO4 y GPIO8 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al Relé 1 Página 399

400 Los parámetros OUTPUT_xxx2 hacen referencia al Relé 2 Los parámetros OUTPUT_xxx3 hacen referencia al Relé 3 Los parámetros OUTPUT_xxx4 hacen referencia al Relé 4 Página 400

401 MTX-65i-RS485 + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-65i-RS485 Descripción: El módem MTX-65iRS485 no dispone de entradas/salidas. Únicamente dispone de puerto serie RS232 y puerto serie RS485. Es un dispositivo pensado únicamente para pasarelas GPRS-Serie o GSM-Serie. Página 401

402 MTX-3G-JAVA + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-3G-JAVA Descripción: El módem MTX-3G-JAVA dispone, en su conexión de expansión DB15, de 4 entradas/salidas digitales y de 2 conversores A/D. El software MTX-Tunnel usa las entradas salidas de la siguiente manera: EHS6 Situación Nº PIN E/S Función GPIO1 DB15 4 Entrada digital Wake up GPIO2 DB15 11 Entrada digital Alarma SMS GPIO3 DB15 5 Salida digital 1 * User GPIO4 DB15 12 Salida digital 2 * User ADC1 DB15 15 Entrada analog. User ADC2 DB15 13 Entrada analog. User La columna EHS6 hace referencia al GPIO correspondiente del módulo EHS6 que lleva interno el terminal La columna Situación indica en qué conector del MTX-3G-JAVA se encuentra dicha E/S La columna Nº PIN indica en qué pin del conector se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX-65i, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO1 y GPIO2 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO1 y GPIO2 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al PIN 5 del conector DB15 Los parámetros OUTPUT_xxx2 hacen referencia al PIN 12 del conector DB15 * a partir de la versión MTX-Tunnelv5.3, GPIO3 y GPIO4 son consideradas entradas digitales si el parámetro DNS_gpios está establecido a on. Página 402

403 MTX-3G-JAVA-BAT / MTX-3G-JAVA-GPS + MTX-Tunnel Descripción de las E/S usadas con el módem MTX-3G-JAVA-BAT y MTX-3G-JAVA-GPS Descripción: Los módems MTX-3G-JAVA-BAT ó MTX-3G-JAVA-GPS disponen, en su conexión de expansión DB15, de 6 entradas/salidas digitales y de 2 conversores A/D. El software MTX-Tunnel usa las entradas salidas de la siguiente manera: EHS6 Situación Nº PIN E/S Función GPIO4 DB15 12 Salida digital 1 User GPIO5 RJ12 5 Entrada digital Wake up GPIO7 DB15 11 Entrada digital User GPIO8 DB15 5 Salida digital 2 User GPIO9 DB15 4 Entrada digital Alarma SMS GPIO10 DB15 13 Entrada digital User ADC1 DB15 15 Entrada analog. User ADC2 DB15 9 Entrada analog. User La columna MTX hace referencia al GPIO correspondiente del módulo EHS6 que lleva interno el MTX. La columna Situación indica en qué conector del MTX se encuentra dicha E/S La columna Nº PIN indica en qué pin del conector se encuentra la E/S La columna E/S indica el tipo de E/S La columna Función indica si el GPIO tiene alguna misión especial dentro del MTX-Tunnel. En el caso del MTX, si no usa las funcionalidades Wake up ni Alarma SMS podrá usar las entradas digitales GPIO5 y GPIO9 como entradas digitales de usuario. Si usa las funcionalidades Wake up y Alarma SMS las entradas digitales GPIO5 y GPIO9 son usadas por el MTX-Tunnel. Los parámetros OUTPUT_xxx1 hacen referencia al PIN 12 del conector DB15 Los parámetros OUTPUT_xxx2 hacen referencia al PIN 5 del conector DB15 Página 403

404 Anexo B Cómo usar Puerto Serie Virtuales com VSPE Página 404

405 SOFTWARE DE EMULACIÓN DE PUERTOS SERIE: VSPE Guía breve del software de emulación de puertos serie. Introducción: Uno de los software más usados en la actualidad para emular puertos series es el VSPE. VSPE es un software gratuito para sistemas operativos Windows de 32 bits y de pago para plataformas 64 bits. Un software de emulación de puertos serie a TCP/IP debe usarlo si dispone de un software antiguo para conectarse con sus equipos serie que únicamente le permite la conexión con tales equipos mediante la selección de un puerto serie COM. Este software le permite crear en su PC COMs virtuales (COM1, COM2, COM 3, ) que en realidad apunten a una determinada IP/puerto TCP. Puede realizar la descarga del software desde aquí: Ejemplo de Uso: Los siguientes pasos muestran como configurar un puerto COM virtual que apunte a una determinada dirección IP / puerto TCP: 1.- Menú: Device > Create Página 405

406 2.- Seleccionamos la opción Connector 3.- Seleccionamos el número de COM virtual que queremos usar. Por ejemplo, el COM Pulsar Finalizar. Aparecerá en la lista el COM virtual creado. Página 406

407 5.- Volvemos a Menú: Device > Create 6.- Seleccionamos la opción TCPClient en el desplegable. 7.- En la siguiente pantalla, indicamos la dirección IP remota de nuestro MTX-Tunnel. Podemos introducir una dirección IP numérica (si usamos una SIM con dirección IP fija, o bien porque obtenemos la IP actual por SMS, llamada perdida, ) o introducir una DNS, por ejemplo si usamos el conocido servicio DynDNS. También seleccionaremos el puerto TCP en el cual esté escuchando el MTX-Tunnel (por defecto 20010). Por último seleccionaremos el puerto COM virtual que hemos creado anteriormente, en nuestro ejemplo el COM10. Pulsamos el botón Finalizar Página 407

408 7.- Ahora tendremos el COM 10 conectado a nuestro MTX-Tunnel. 8.- El último paso es acceder a nuestra aplicación de control y seleccionar el COM10 como puerto de comunicaciones. En ese momento podrá acceder remotamente a sus dispositivos serie. Recuerde que la configuración del puerto serie del módem (baudios, número de bits de datos, ) debe establecerse en el fichero config.txt del módem, tal y como se indica en este manual. Página 408