Tunnel – Parámetros de configuración entradas analógicas: “ADC_”

La mayoría de los módems MTX disponen de una o varias entradas analógicas (0-50V ó 4-20mA). Los parámetros ADC_ permiten configurar el comportamiento de estas entradas analógicas. Por ejemplo, puede configurar una entrada analógica para que, cuando ésta supere un nivel, se envíe SMS de alarma, o envíe un mensaje MQTT, o realice una llamada de voz, o ejecute un comando AT automáticamente (o un batch de comandos AT), etc. Le recomendamos encarecidamente que de un vistazo a los ejemplos del Anexo 8 para entender mejor el funcionamiento.

ADC_mode0, ADC_mode1, ADC_mode2

Descripción: los ADCs de los módems MTX (entradas analógicas) pueden ser de varios tipos en función del modelo del módem utilizado.  Pueden ser de tipo voltaje (0-50V) o bien de tipo corriente (4-20mA). Mediante este parámetro se indica al módem cómo va a utilizarse cada entrada analógica Consulte las tablas de características del Anexo A del presente manual para conocer las posibilidades de cada ADC en función del modelo de módem MTX. Recuerde que para configurar una entrada analógica como voltaje o corriente, además de indicarlo en este parámetro, debe configurar apropiadamente los microswitches del módem.

Valores posibles:

• voltage, current
• Valor por defecto: voltage

Notas adicionales:

• Configure el valor del parámetro como “voltage” si el ADCx quiere utilizarse como entrada de voltaje (0-50V). Recuerde configurar también los microswitches del módem para tal fin.
• Configure el valor del parámetro como “current” si el ADCx quiere utilizarse como entrada de corriente (0-20mA). Recuerde configurar también los microswitches del módem para tal fin.

ADC_config0, ADC_config1, ADC_config2

Descripción: mediante estos parámetros puede configurar el comportamiento de cada una de las entradad ADC (entradas analógicas) del módem.

• Valor por defecto: normal

 

• normal

Con este valor la entrada ADC está simplemente configurada como entrada analógica sin ningún comportamiento especial asignado.  Este valor es útil, por ejemplo,  cuando se desea simplemente consultar el valor de una entrada analógica (por ejemplo con el comando AT^MTXTUNNEL=GETIOS, o con el datalogger periódico, etc)

Ejemplo:

ADC_mode0: voltage

ADC_config3: normal

Este ejemplo configura el ADC0 como entrada de voltaje normal.

• sms;<minValue>;<maxValue>;<hist>;<timeout>;<messageMin>;<messageMax>;<messageNormal>

Con este valor la entrada ADC se configura para enviar una alarma SMS en función del valor del ADC.

sms: texto que indica que el ADC se asocia a una alarma SMS
<minValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea inferior a este valor, una alarma SMS será generada con el texto <messageMin>
<maxValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea superior a este valor, una alarma SMS será generada con el texto <messageMax>
<hist>: 0 … 50000 histéresis
<timeout>: 0 … 3600 En caso de producirse una condición de alarma SMS, este valor indica el tiempo máximo entre envíos. Esto evita que, si una entrada analógica cambia de estado continuamente por accidente, se realicen  continuos envíos de SMS.
<messageMin>: máximo 160 caracteres (sin ; )
En caso de producirse una condición de alarma SMS por valor bajo, este es el texto del mensaje SMS que se enviará.
<messageMax>: máximo 160 caracteres (sin ; )
En caso de producirse una condición de alarma SMS por valor alto, este es el texto del mensaje SMS que se enviará.
<messageNormal>: máximo 160 caracteres (sin ; )

El caso de que el valor del ADC vuelva a un estado normal tras un estado de alarma, este es el texto del mensaje SMS que se enviará

Ejemplo:

ADC_mode0: voltage

ADC_config0: sms;2000;8000;100;60;Alarm ADC0 Low;Alarm ADC0 High;Alarm ADC0 normal

Nota: Este ejemplo configura el ADC0 como entrada de voltaje y enviará un  mensaje SMS cada vez que el valor esté por debajo de 2000mV o por encima de 8000mV, con una histéresis de 100mV y un timeout de 60 segundos.

Nota2: Los números de teléfonos de los destinatarios se configuran en los parámetros ALARM_smsNumberX

• at;<minValue>;<maxValue>;<hist>;<atMin>;<atMax>;<atNormal>

Con este valor la entrada ADC se configura para enviar una alarma SMS en función del valor del ADC.

at: texto que indica que el ADC se asocia a la ejecución de un comando AT
<minValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea inferior a este valor, el comando <atMin> será ejecutado
<maxValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea superior a este valor, el comando <atMax> será ejecutado
<hist>: 0 … 50000 histéresis
<atMin>: en caso de producirse una condición de alarma por valor bajo, este es el comando AT que se ejecutará
<atMax>: en caso de producirse una condición de alarma por valor alto, este es el comando AT que se ejecutará
<atNormal>: el caso de que el valor del ADC vuelva a un estado normal tras un estado de alarma, este es el comando AT que se ejecutará

Ejemplo:

ADC_mode0: voltage

ADC_config0: at;2000;8000;0;AT^MTXTUNNEL=SETIO,8,1;AT^MTXTUNNEL=SETIO,8,0;AT

• mqtt;<changeValue>;<timeout>

Con este valor el ADC se configura para enviar un mensaje MQTT cuando cambie de valor el ADC un valor <changeValue>.

mqtt: texto que indica que el ADC se asocia al envio de mensajes MQTT
<changevalue>: 0 …. 50000, cuando la entrada analógica se incremente o decremente el valor configurado, se enviará un mensaje MQTT
<timeout>: 0 … 3600 (segundos)

En caso de producirse una condición de envío MQTT, este valor indica el tiempo máximo entre envíos. Esto evita que, si una entrada analógica cambia de estado continuamente por accidente, se realicen continuos envíos de mensajes MQTT.

Ejemplo:

ADC_mode0: voltage

ADC_config0: mqtt;100;0

Este ejemplo configura el ADC0 como entrada de voltaje asociada al envío de mensajes MQTT. Se enviará un mensaje cada vez que la entrada ADC0 cambie de valor 100mV, sin timeout entre mensajes. Consulte el ejemplo 8.11 para más información y para consultar el formato de envío del mensaje MQTT.

Los mensajes MQTT se enviarán al topic MQTT indicado en el parámetro MQTT_defaultIOTopic con el Qos especificado en MQTT_defaultIOQos.

• call;<minValue>;<maxValue>;<hist>;<timeout>

Con este valor el ADC se configura para realizar una llamada de voz (sin audio) cuando cambie el valor del ADC esté por debajo o por encima de unos umbrales.

call: texto que indica que la entrada ADC se asocia a la realización de una llamada de voz.
<minValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea inferior a este valor, se realizará una llamada de voz.
<maxValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea superior a este valor, se realizará una llamada de voz.
<hist>: 0 … 50000 histéresis.
<timeout>: 0 … 3600  (segundos) indica el tiempo mínimo entre 2 llamadas realizadas por el módem.

Ejemplo:

ADC_mode0: voltage

ADC_config0: call;2000;8000;100;300

Este ejemplo configura la entrada analógica ADC0 como asociada a la realización de una llamada de voz. Se realizará cada vez que ADC0 tenga un valor igual o inferior a 2000mV o igual o superior a 8000mV, con una histéresis de 100mV y un timeout (tiempo mínimo entre llamadas) de 300 segundos.

• wakeup;<minValue>;<maxValue>;<hist>

El modo “wakeup” indica que el ADC activará la sesión 2g/3g/4g durante el tiempo configurado (en el parámetro GPRS_timeout) cuando el valor analógico está pode debajo de <minValue> o por encima de <maxValue>.
call: texto que indica que la GPIO, configurada como entrada, se asocia al inicio de una sesión 2g/3g/4g

<minValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea inferior a este valor, se activará la sesión 2g/3g/4g
<maxValue>: 0 … 50000 Cuando el valor del ADC valga igual o sea superior a este valor, se activará la sesión 2g/3g/4g
<hist>: 0 … 50000 histéresis

Ejemplo:

GPRS_timeout: 10

ADC_mode0: voltage

ADC_config0: wakeup;1000;9000;100

Este ejemplo configura el ADC0 como entrada analógica de voltaje asociada a la activación de la sesión 2g/3g/4g.  Cuando ADC0<1000mV o ADC0>9000mV la sesión 2g/3g/4g se activará 10 minutos. Se configura una histéresis de 100mV.