Tunnel – Parámetros de configuración 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 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 de datos 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 MTXTunnel esté configurado como cliente, es decir, cuando las conexiones se realizan DESDE el MTX hacia un servidor o equipo remoto

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 o vía MQTT.

Valores posibles:

• socket, socketjson, http, mqtt
• 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”
• Si va a enviar los datos de sensores a un bróker MQTT, obviamente resultará mucho más conveniente usar el método “mqtt”. Desde la versión MTX-Tunnel 9.25 es posible configurar el modo “mqtt”. Si selecciona este método no olvide configurar los parámetros MQTT_ y el parámetro DNS_mqttTopic

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”

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 “http://”. Por ejemplo: DNS_server: www.mtxtunnel.com/dns.asp
• 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 Public>

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

DNS_port

Descripción: indica el puerto a usar en caso de utilizar un modo socket (DNS_mode: socket).

Valores posibles:

• 1… 65535
• Valor por defecto: 20011

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:
  www.mtxtunnel.com:20011/dns.asp

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 Public> &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>

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.

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

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, 250 … 47750
• 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_adc1 < 1200mV – 250mV se enviará una trama DNS.
• Parámetro disponible a partir del MTX-Tunnel v5.3

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, 30… 2592000
• 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

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”, “getjson” o “postjson”.

Valores posibles:

• get, getjson, postjson
• Valor por defecto: get

Notas adicionales:

• Parámetro disponible desde la versión MTX-Tunnel 8.10. Hasta esta versión la única opción posible era “get”. Se recomienda encarecidamente NO usar la opción get y usar la opción getjson o postjson
• Ejemplo de envío de datos en modo “get” y el parámetro DNS_extended está a un valor “off”:
  http://www.mydomain.com?TYPE=DNS&IMEI=357973041110401&PASS=ID000001&IP=95.126.113.202&CSQ=24&VER=9.12&AUX=0&MOD=201
• Ejemplo de envío de datos en modo “getjson” y el parámetro DNS_extended está a un valor “off”:
  {“TYPE”,”DNS”,”IMEI”: 357973041110401,“P”:”ID001”,”IP”:”95.126.113.202”, ”CSQ”:24,”VER”:”9.12”, “AUX”:”0”,”MOD”:201}
  Donde:
  TYPE: tipo de trama DNS
  IMEI: identificativo interno del MTX
  P: campo de usuario especificado en el parámetro DNS_password
  IP: IP actual del MTX-Tunnel
  CSQ: cobertura gsm del MTX (0 … 31)
  VER: versión de firmware del MTX-Tunnel
  AUX: reservado para control de versión de configuración
  MOD: modelo terminal MTX
• Ejemplo de envío de datos en modo “getjson” y el parámetro DNS_extended está a un valor “on”:
  {“TYPE”,”DNS”,”IMEI”: 357973041110401, “P”:”ID001”,”IP”:”95.126.113.202”, ”CSQ”:24,”VER”:”9.12”, “AUX”:”0”,”MOD”:201,”IO1”:0,”IO2”:0,”IO3”:0,”IO4”:0,”IO5”:0, ”IO6”:0,“IO7”:0,”IO8”:0,”IO9”:0,”IO10”:0,”AD1”:100,”AD2”:2000,”CO1”:”0”,”CO2”:”0”, ”CID”:”214;07;0322;4E8F”}”}
  Donde:
  TYPE: tipo de trama DNS
  IMEI: identificativo interno del MTX
  P: campo de usuario especificado en el parámetro DNS_password
  IP: IP actual del MTX-Tunnel
  CSQ: cobertura gsm del MTX (0 … 31)
  VER: versión de firmware del MTX-Tunnel
  AUX: reservado para control de versión de configuración
  MOD: modelo terminal MTX
  IO1: es el valor de la entrada/salida digital 1 del módem (si la tiene disponible)
  IO2: es el valor de la entrada/salida digital 2 del módem (si la tiene disponible)
  IO3: es el valor de la entrada/salida digital 3 del módem (si la tiene disponible)
  IO4: es el valor de la entrada/salida digital 4 del módem (si la tiene disponible)
  IO5: es el valor de la entrada/salida digital 5 del módem (si la tiene disponible)
  IO6: es el valor de la entrada/salida digital 6 del módem (si la tiene disponible)
  IO7: es el valor de la entrada/salida digital 7 del módem (si la tiene disponible)
  IO8: es el valor de la entrada/salida digital 8 del módem (si la tiene disponible)
  IO9: es el valor de la entrada/salida digital 9 del módem (si la tiene disponible)
  IO10: es el valor de la entrada/salida digital 10 del módem (si la tiene disponible)
  AD1: es el valor de la entrada analógica 1 del módem (si la tiene disponible)
  AD2: es el valor de la entrada analógica 2 del módem (si la tiene disponible)
  CO1: es el valor de la entrada contadora de pulsos 1 (si la tiene disponible)
  CO2: es el valor de la entrada contadora de pulsos 2 (si la tiene disponible)
  CO3: es el valor de la entrada contadora de pulsos 3 (si la tiene disponible)
  CID: información de celda GSM (para localización GSM)
• Ejemplo de envío de datos en modo “postjson” y el parámetro DNS_extended está a un valor “off”. En el caso de modo “postjson”, lol datos se envían en un JSON como el siguiente:
  {“IMEI”:”357042060366409”,”TYPE”:”DNS”,“P”:”ID-12345678”, ”IP”:”95.126.113.202”,”CSQ”:24,”VER”:”9.12”,“AUX”:”4”,”MOD”:”201,VCC:12100}
  Donde:
  TYPE: tipo de trama DNS
  IMEI: identificativo interno del MTX
  P: campo de usuario especificado en el parámetro DNS_password
  IP: IP actual del MTX-Tunnel
  CSQ: cobertura gsm del MTX (0 … 31)
  VER: versión de firmware del MTX-Tunnel
  AUX: reservado para control de versión de configuración
  MOD: modelo terminal MTX
  VCC: voltaje de alimentación MTX (en milivoltios)
• Ejemplo de envío de datos en modo “postjson” y el parámetro DNS_extended está a un valor “on”. En el caso de modo “postjson”, los datos se envían en un JSON como:
  {“IMEI”:”357042060366409”,”TYPE”:”DNS”,“P”:”ID-12345678”, ”IP”:”95.126.113.202”,”CSQ”:24,”VER”:”9.12”,“AUX”:”4”,”MOD”:”201”,VCC:12100,”IO1”:0,”IO2”:0, ”IO3”:0,”IO4”:0,”IO5”:0,”IO6”:0,”IO7”:0,“IO8”:0,”IO9”:0,”IO10”:0,”AD1”:0,”AD2”:0, ”CO1”:”0”,”CO2”:”0”,”CID”:”214;07;0322;4E8F”}
  Donde:
  TYPE: tipo de trama DNS
  IMEI: identificativo interno del MTX
  P: campo de usuario especificado en el parámetro DNS_password
  IP: IP actual del MTX-Tunnel
  CSQ: cobertura gsm del MTX (0 … 31)
  VER: versión de firmware del MTX-Tunnel
  AUX: reservado para control de versión de configuración
  MOD: modelo terminal MTX
  VCC: voltaje de alimentación MTX (en milivoltios)
  IO1: es el valor de la entrada/salida digital 1 del módem (si la tiene disponible)
  IO2: es el valor de la entrada/salida digital 2 del módem (si la tiene disponible)
  IO3: es el valor de la entrada/salida digital 3 del módem (si la tiene disponible)
  IO4: es el valor de la entrada/salida digital 4 del módem (si la tiene disponible)
  IO5: es el valor de la entrada/salida digital 5 del módem (si la tiene disponible)
  IO6: es el valor de la entrada/salida digital 6 del módem (si la tiene disponible)
  IO7: es el valor de la entrada/salida digital 7 del módem (si la tiene disponible)
  IO8: es el valor de la entrada/salida digital 8 del módem (si la tiene disponible)
  IO9: es el valor de la entrada/salida digital 9 del módem (si la tiene disponible)
  IO10: es el valor de la entrada/salida digital 10 del módem (si la tiene disponible)
  AD1: es el valor de la entrada analógica 1 del módem (si la tiene disponible)
  AD2: es el valor de la entrada analógica 2 del módem (si la tiene disponible)
  CO1: es el valor de la entrada contadora de pulsos 1 (si la tiene disponible)
  CO2: es el valor de la entrada contadora de pulsos 2 (si la tiene disponible)
  CO3: es el valor de la entrada contadora de pulsos 2 (si la tiene disponible)
  CID: información de celda GSM (para localización GSM)

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

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

DNS_https

Descripción: permite indicar si el envío de información se realiza vía http o de forma encriptada vía https.

Valores posibles:

• on, off
• Valor por defecto: off

Notas adicionales:

• Tenga presente que si quiere activar esta opción necesita un servidor web con soporte SSL

DNS_header1, DNS_header2, DNS_header3

Descripción: permite introducir cabeceras HTTP Personalizadas. Muy útil para comunicación del MTXTunnel con Plataformas web de terceros (tipo THINGWORKS).

Valores posibles:

• cadena ascii hasta 64 caracteres
• Valor por defecto: ninguno

Notas adicionales:

• El formato de las cabeceras es: nombreCabecera;valorCabecera, es decir, campos separados por ; (punto y coma)
• Le resultarán imprescindible si desea comunicar el MTX-Tunnel con algunas plataformas genéricas. Por ejemplo, en caso de comunicación con la plataforma de Thingworks deberá especificar algo similar a:
  DNS_header1: Content-Type;application/json
  DNS _header2: Accept;application/json
  DNS _header3: appKey;194f5476-7346-4638-ac30-bbca28595be1

DNS_mqttTopic

Descripción: configura el topic que utilizará el MTX-Tunnel para publicar todos los datos del servicio DNS_.

Valores posibles:

• cadena ascii hasta 64 caracteres
• Valor por defecto: ninguno

Notas adicionales:

• De la misma forma que los parámetros MQTT_attopicX, puede utilizar el tag [IMEI] en el parámetro y el MTX-Tunnel substituirá internamente dicho tag por el valor adecuado. Por ejemplo, si su modem tiene el IMEI 354740050182909 podría especificar en el fichero de configuración config.txt el valor:
  DNS_mqttTopic: [IMEI]/DNS
  Y el MTX-Tunnel enviaría los datos del servicio DNS usando el topic:
  354740050182909/DNS
• Los datos se envían al topic MQTT en formato JSON. Consulte el parámetro DNS_httpMode para encontrar información de los JSON enviados