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

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/3G.

Valores posibles:

• on, off
• Valor por defecto: off

Notas adicionales:

• Consulte los ejemplos de los anexos para un mejor entendimiento de este parámetro

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 de los Anexos para un mejor entendimiento de este parámetro

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: www.midominio.com/set.asp?V=, donde en la variable V llegará al servidor la cadena JSON.
• Consulte los ejemplos de los Anexos para un mejor entendimiento de este parámetro

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”:357973041110401,”TS”:”18/10/12 10:04:37”,”P”:”matrix”,”A”:0B19083000D3,”BAT”:0,”T1”:23.4375,”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:

• 10… 1024
• Valor por defecto: 100

Notas adicionales:

• Consulte los ejemplos de los Anexos para un mejor entendimiento de este parámetro
• Si está usando el Logger para almacenar lecturas de equipo ModBus, le recomendamos que especifique un valor que sea superior a 100 + 12 x el número máximo de registros modbus a leer en una lectura

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:

• 1… 10000
• 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 2G/3G/4G para el envío de información. Dicha memoria se utiliza para no perder lecturas. En el momento que vuelva la conectividad 2G/3G/4G se irán reenviando los datos acumulados vía GPRS/3G
• 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

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), 30… 2592000
• Valor por defecto: 0

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

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

LOGGER_serialFrequency

Descripción: permite establecer la frecuencia con la que el logger interno del MTX debe registrar tramas serie recibidas.

Valores posibles:

• 0… 1000 (segundos)
• Valor por defecto: 0

Notas adicionales:

• Parámetro de configuración válido desde la versión MTX-Tunnel 8.10
• 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

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

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), 30… 2592000
• Valor por defecto: 0

Notas adicionales:

• Parámetro de configuración válido desde la versión MTX-Tunnel 8.10
• Consulte los ejemplos del anexo para un mejor entendimiento de este parámetro

LOGGER_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

LOGGER_httpMode

Descripción: permite seleccionar el tipo de comunicación que se realizará contra una Plataforma Web. Podrá escogerse entre “getjson” o “postjson”.

Possible values:

• getjson, postjson
• Default value: getjson

Notas adicionales:

• A continuación dispone de unos ejemplos de formato de datos enviados tanto con el método getjson como postjson. Recuerde que las tramas enviadas por el Logger pueden ser muy diversas, ya que el Logger es utilizado por diferentes procesos internos del MTX-Tunnel. Es decir, a continuación dispone de unos ejemplos de tramas Logger donde se envían las E/S del MTX-Tunnel cada cierto periodo de tiempo (LOGGER_ioPeriod >0). Serán del tipo “IOS”, pero pueden recibirse del tipo “IOS”, “SERIAL”, “TEMP”, “POWER”, “MBUS”.
• Ejemplo de envío de datos en modo “getjson”

{“TYPE”:”IOS”,”IMEI”:357042060366409, “P”:”ID00001”, “TS”:”09/08/16 18:32:53”,”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”}

Donde:
TYPE: tipo de trama IOS
IMEI: identificativo interno del MTX
P: campo de usuario especificado en el parámetro LOGGER_password
TS: TimeStamp de cuando se recogieron los datos
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)

• Ejemplo de envío de datos en modo “postjson”. En el caso de modo “postjson”, los datos se
  envían en un JSON como el mostrado a continuación.

{“IMEI”:357042060366409,”TS”:”09/08/16 18:32:53”,”TYPE”:”IOS”,”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”,”CO3”:”0”}

TYPE: tipo de trama IOS
IMEI: identificativo interno del MTX
P: campo de usuario especificado en el parámetro LOGGER_password
TS: TimeStamp de cuando se recogieron los datos
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)

LOGGER_header1, LOGGER_header2, LOGGER_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 cabeceras es: nombreCabecera;valorCabecera, o sea, campos separados por ;
• Son imprescindibles para comunicar el MTX-Tunnel con plataformas genéricas. Por ejemplo, en caso de comunicación con la plataforma de Thingworks deberá especificar algo similar a:
  LOGGER_header1: Content-Type;application/json
  LOGGER _header2: Accept;application/json
  LOGGER _header3: appKey;194f5476-7346-4638-ac30-bbca28595be1

LOGGER_mode

Descripción: permite seleccionar el mecanismo de envío de los datos registrados en el datalogger interno.

Valores posibles:

• http, mqtt, ftp
• Valor por defecto: http

Notas adicionales:

• Si selecciona “mqtt” recuerde utilizar los parámetros MQTT_ indicados en este manual
• Si especifica “mqtt” debe configurar también el parámetro LOGGER_mqttTopic
• Si especifica FTP debe especificar en los parámetros LOGGER_server, LOGGER_serverLogin, LOGGER_serverPassword la dirección del servidor FTP, el username y password respectivamente

LOGGER_mqttTopic

Descripción: configura el topic que utilizará el Tunnel para publicar los datos almacenados en el Logger.

Valores posibles:

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

Notas adicionales:

• Igual que los parámetros MQTT_attopicX, puede utilizar [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:
  LOGGER_mqttTopic: [IMEI]/LOGGER
  Y el MTX-Tunnel enviaría los datos del logger usando el topic:
  354740050182909/LOGGER
  And the MTX-Tunnel would send logger data using the topic::
  354740050182909/LOGGER

LOGGER_addGPS

Descripción: en caso de estar a “on” este parámetro y el módem MTX contar con GPS, la posición GPS es adjuntada en cualquier registro almacenado en el Logger.

Valores posibles:

• on. off
• Valor por defecto: off

Notas adicionales:

• La trama de datos con la posición GPS estará incluida en el JSON enviado por el LOGGER, en el campo de nombre “GPSDATA”