Tunnel – Parámetros de configuración Output: “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.

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)
  • 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

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.

Valor por defectos: 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;ValueMax;ValueMin;ATCommandMax;ATCommandMin
  Donde:
  ID 0… 1: puede valer 0 o 1 en función de si se desea leer el valor del adc0 ó adc1 del módem MTX
  ValueMax 0… 2400: Valor máximo del conversor analógico digital (adc) a partir del cual la salida digital/relé debe activarse
  ValueMin 0… 2400: Valor mínimo del conversor analógico digital (adc) a partir del cual la salida digital/relé debe desactivarse
  ATCommandMax AT command to be executed: MTX-Tunnel le permite ejecutar un comando AT opcional cuando el valor del adc iguale o supere el valor indicado en ValorMax
  ATCommandMin AT command to be executed: 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;command;record;valueMax;valueMin;ATCommandMax;ATCommandMin
  Donde:
  dir 1… 254: indica la dirección modbus del equipo a leer
  command 3, 4: permite especificar si el comando modbus es 3 o 4
  record 1…65535: permite especificar el número de registro modbus a leer
  ValueMax 0… 65535: valor máximo del registro modbus a partir del cual la salida digital/relé debe activarse
  ValueMin 0… 65535: valor mínimo del registro modbus a partir del cual la salida digital / relé debe desactivarse
  ATCommandMax AT command to execute: 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 AT command to execute: 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,666123456,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:
  minutesSunset, minutesSunrise
  Donde:
  minutesSunrise -120… 120: permite indicar un offset de tiempo para que la salida/relé desconmute X minutos antes o después de la salida del sol
  minutesSunset -120… 120: permite indicar un offset de tiempo para que la salida/relé conmute X minutos antes o después de la puesta de sol

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 MTXTunnel comprueba la hora, lee los conversores a/d, lee los registros modbus y activa/desactiva las salidas correspondientes
• 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