Tunnel – Comandos AT especiales (API) soportados

¿Buscas alguna otra cosa?

Tunnel – Comandos AT especiales (API) soportados

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 2G/3G/4G. Recuerde que puede enviar comandos AT por los 2 puertos serie de los MTX, vía IP (webserver, Telnet, mqtt, snmp, pasarela, …) o vía SMS. A continuación se detalla cada uno de los comandos AT especiales:

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,port,speed

Este comando sirve para cambiar la velocidad de un puerto serie del módem de forma temporal (sin necesidad de resetear el MTX-Tunnel). En este ejemplo, el primer comando cambiaría la velocidad del puerto 0 a 9600 y el segundo cambiaría la velocidad del puerto 1 a 19200 baudios. Únicamente disponible a partir del MTX-Tunnel V7. AT^MTXTUNNEL=SETBAUDRATE, 0, 9600 AT^MTXTUNNEL=SETBAUDRATE, 1, 19200

AT^MTXTUNNEL=GETPARAM,parameter_name

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.

AT^MTXTUNNEL= SETPARAM,parameter_name,ValueParametro

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= SETPARAM,parameter_name1:parameter_value1rnparameter_name2:parameter_value2|rn.....parameter_nameN:parameter_valueN}

Este comando sirve para cambiar el valor de varios parámetros de configuración de forma simultánea, en un solo comando. AT^MTXTUNNEL=SETPARAMS,{COMM_baudrate:9600rnCOMM_bitsperchar:8} 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 el estado de todos los GPIOs (valor de E/S o contadores de pulsos en función de cómo esté configurada cada GPIO) y ADCs disponibles del módem. Tiene especial utilidad a la hora del envío de comandos AT por IP 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. A partir de la versión MTX-Tunnelv11 cambia el formato de respuesta, devolviendo el resultado en un formato JSON. Ejemplo: AT^MTXTUNNEL=GETIOS {IO0:0,IO1:0,IO2:0,IO3:1,IO4:1,IO5:0,AD0:3828,ADM0:voltage,AD1:0,ADM1:voltage} OK

AT^MTXTUNNEL=GETIO,numGPIO

Este comando devuelve el valor de una determinada entrada digital. numGPIO indica el nº de GPIO (0, … 9). Consulte las GPIOs en las tablas del final de este manual para más información.

AT^MTXTUNNEL=GETADC,numADC

Este comando devuelve el valor de una determinada entrada analógica. numADC indica el nº de ADC (0,1). Consulte los ADCs en las tablas del final de este manual para más información.

AT^MTXTUNNEL=RS232,mode,data

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. En datos es posible especificar valores hexadecimales (es decir, no alfanuméricos) si éstos están comprendidos entre los tags <HEX></HEX>. Ejemplo <HEX>414243</HEX> enviará los valores 0x41 0x42 0x43 por el puerto serie.

AT^MTXTUNNEL=SMS,phone_number,message

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=SETMODBUS,address;position1;data_1;data_2;...;data_n

Este comando AT le permite, si tiene conectado un dispositivo MODBUS al puerto secundario del MTXTunnel, cambiar uno o varios parámetros de la tabla de memoria. 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 “,”. Este comando siempre usa el comando modbus 16.

AT^MTXTUNNEL=SETMODBUS2,address;position1;command;data_1;data_2;...;data_n

Este comando AT le permite, si tiene conectado un dispositivo MODBUS al puerto secundario del MTXTunnel, cambiar uno o varios parámetros de la tabla de memoria. 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 comando: indica el comando a utilizar. Puede ser el comando 15 (coils) o 16 (registros) 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 “,”. Este comando puede usar el comando modbus 15 o 16.

AT^MTXTUNNEL=GETMODBUS,address;position;numData;command

Este comando AT le permite, si tiene conectado un dispositivo MODBUS al puerto secundario del MTXTunnel, leer uno o varios parámetros de la tabla de memoria. address: indica la dirección modbus del dispositivo (0… 255) posicion1: indica la primera posición de memoria a leer dentro de la tabla modbus numDatos: 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=GETMODBUSALL

En este manual encontrará multitud de ejemplos (Anexo 6) de escenarios en los que se configura el MTX-Tunnel para leer de forma periódica los registros de uno a varios dispositivos modbus esclavos. Por ejemplo, podría configurar el MTX-Tunnel para leer X dispositivos cada hora. Pero si en un determinado momento quiere lanzar la lectura Modbus de todos los dispositivos que tiene configurados (por ejemplo para realizar una prueba sin necesidad de esperar 1 hora hasta que suceda el envento) puede ejecutar este comando AT. Lanzará de forma inmediata el proceso de lectura modbus y de envío de los datos al servidor.

AT^MTXTUNNEL=TEMPORALCLIENT,IPaddress,TCPport,seconds

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: indica la dirección IP a la que conectar puertoTCP: indica el puerto TCP al que conectar Importante: un socket cliente temporal se cerrará automáticamente si no se reciben datos 2g/3g/4g 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 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

Comando para poder cambiar el estado de una salida digital AT^MTXTUNNEL=SETIO,X,Y (Siendo X la GPIO a cambiar (0 … 9) y Y el valor a establecer (0 , 1).

AT^MTXTUNNEL=FTP, ftpServer, loginServerFTP, passwordServerFTP, directoriyFTP, remoteFilename, MTXFilename, NotificationURL

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 archivo.

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

EJEMPLO:

at^mtxtunnel=FTP,ftp.mydomain.com,myUser,myPass,folder1/folder2/,config.txt,config.txt,

AT^MTXTUNNEL=DOWNLOAD,http://www.myDomain.es/myPath,myUsername,myPassword,myOriginFile,myDestinationPath,myDestinationFile,timeOut

Es posible realizar una descarga HTTP/HTTPS de un archivo ubicado en un servidor web en el terminal MTX. Útil para cambiar el fichero de configuración “config.txt”, cambiar el fichero “operators.txt” o descargar otro tipo de archivo.

EJEMPLOS

AT^MTXTUNNEL=DOWNLOAD,http://myDomain.com/myPath,myUser,myPass,config. txt,,config.txt,30

AT^MTXTUNNEL=DOWNLOAD,http://myDomain.com/myPath,myUser,myPass,ServerCertificate1.jar,security/certs/servers/,ServerCertificate1.jar,30

Recuerde que si cambia la configuración de forma remota, debe reiniciar el MTX para que tome la nueva configuración (comando AT+CFUN=1,1).

La base de tiempos del parámetro timeOut es segundos. Éste comando devolverá OK o ERROR tras la descarga del archivo, no pudiendo enviar otro comando hasta la finalización del mismo (de la descarga o del timeout).

AT^MTXTUNNEL=ADOWNLOAD,http://www.myDomain.es/myPath,myUsername,myPassword,myOriginFile,myDestinationPath,myDestinationFile,timeOut

Es posible realizar una descarga HTTP/HTTPS asíncrona de un archivo ubicado en un servidor web en el terminal MTX. Útil para cambiar el fichero de configuración “config.txt”, cambiar el fichero “operators.txt” o descargar otro tipo de archivo.

EJEMPLOS

AT^MTXTUNNEL=ADOWNLOAD,http://myDomain.com/myPath,myUser,myPass,config.txt,,config.txt,30

AT^MTXTUNNEL=ADOWNLOAD,http://myDomain.com/myPath,myUser,myPass,ServerCertificate1.jar,security/certs/servers/,ServerCertificate1.jar,30

Recuerde que si cambia la configuración de forma remota, debe reiniciar el MTX para que tome la nueva configuración (comando AT+CFUN=1,1)

La base de tiempos del parámetro timeOut es segundos. Éste comando devolverá OK o ERROR inmediatamente miestras se descarga el fichero en segundo plano. Utilice el commando AT^MTXTUNNEL=ISFILE para saber si el fichero se ha descargado.

AT^MTXTUNNEL=ISFILE,path,fileName

Permite averiguar si existe un fichero dentro del módem. Útil para utilizar junto con el comando AT^MTXTUNNEL=ADOWNLOAD.

EJEMPLO

AT^MTXTUNNEL=isfile,,config.txt

Éste comando devolverá OK si existe el fichero o ERROR si no existe.

Si el fichero se encuentra en el directorio raíz, deje el campo path en blanco.

AT^MTXTUNNEL=SETCONFIGFILE,{ConfigRaw}

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. La configuración debe estar comprendida entre los tags { }.

Los parámetros pueden enviarse separados por el símbolo “rn”. EJEMPLO {COMM_baudrate:9600rnCOMM_bitsperchar:8rn …………………}

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 GPIO_modeX como “output” y GPIO_configX como “timer” (ejemplos del capítulo 8).  numOutput indica el ID de la salida digital del (0,1,…) MTX.  Value puede tomar los valores 0, 1.

AT^MTXTUNNEL= GETPOWERSTATUS

Comando para conocer si un módem MTX está siendo alimentado con alimentación externa o con batería interna. Únicamente válido para módems que cuenten con batería interna. Posibles respuestas: -1 (ERROR), 0 (funcionando con batería interna), 1 (funcionando con alimentación externa).

AT^MTXTUNNEL= GETCELLID

Devuelve el identificador de la celda de telefonía que está siendo usada. Últil para sistemas de localización por celdas.

AT^MTXTUNNEL= RESET,time

Ejecuta un reset del módem pasados los segundos indicados en el parámetro “time” (0… 86400).

AT^MTXTUNNEL= getCounters

Comando AT no disponible a partir de MTX-Tunnelv11. Utilizar en su lugar el comando AT^MTXTUNNEL=GETIOS.

AT^MTXTUNNEL= getCounter,numCounter

Devuelve el valor actual del contador numCounter. El parámetro “numCounter” indica el ID de la GPIO configurada como contador de pulsos. El valor devuelto por el comando es un valor entre 0 y 4294967294. Consulte el ejemplo 7.11 para más información.

AT^MTXTUNNEL= setCounter,numCounter,value

Establece el valor actual del contador numCounter. El parámetro “numCounter” indica el ID de la GPIO configurada como contador de pulsos. El campo “value” puede tener un valor entre 0 y 4294967294. Consulte el ejemplo 7.11 para más información.

AT^MTXTUNNEL= setSchedule,ID:Day;Hour;Minute;ATCommand

Permite configurar un comando AT temportizado para que se ejecute un determinado día de la semana (Lunes, … Domingo) a una determinada hora y minuto. Por ejemplo, puede resultar útil si quiere conmutar un relé o salida digital a determinadas horas. Recuerde que el módem utiliza hora UTC. ID: 1… 200. Índice de la temporización, máximo 200 temporizaciones Day: 1… 7. (1=lunes, 2=martes… 7=domingo, -1=todos los días) Hour: 0… 23. (-1=todas las horas) Minute: 0… 59 ATCommand: comando AT a ejecutar EJEMPLO AT^MTXTUNNEL=setSchedule,1:2;22;0;AT^SSIO=0,1 (activa la salida digital GPIO4 todos los Martes a las 22:00) Este comado escribirá en un archivo de nombre “schedule.txt” que se encuentra en el interior del módem. También se permite la copia entera de dicho fichero desde un servidor FTP mediante el comando AT^MTXTUNNEL=FTP… El formato de dicho fichero “schedule.txt” es el siguiente: 1:day;hour;minute;ATcommand 2:day;hour;minute;ATcommand 3:day;hour;minute;ATcommand … Si desea borrar un determinado horario, puede utilizar la clave “null” en el campo ATCommand. Por ejemplo, si desea borrar el horario con ID=1: AT^MTXTUNNEL=setSchedule,1:2;22;0;null

AT^MTXTUNNEL=getSchedule,ID

Devuelve la programación ID del módem, donde ID=1… 200 indica el número de programación

AT^MTXTUNNEL=getSchedules

Devuelve una lista con todas las programaciones horarias.

AT^MTXTUNNEL=delSchedules

Borra todas las programaciones horarias.

AT^MTXTUNNEL=getAstronomic,latitude,longitude,dd,mm,yyyy

Devuelve el Orto y Ocaso para una determinada latitud, longitud, día, mes y año. Ejemplo para la ciudad de Madrid: AT^MTXTUNNEL=getAstronomic,40.4893,-3.6827,12,03,2017

AT^MTXTUNNEL=SETULPSECONDS,value

Comando exclusivo para modelos MTX que cuenten con la característica ULP (Ultra Low Power). Este comando permite, una vez despierto el módem de su letargo, aumentar el tiempo que permanecerá despierto o bien finalizalo inmediatamente. Por ejemplo, imagine que quiere despertar el módem únicamente 5 minutos al día para realizar una acción. El módem se despierta y, una vez despierto, la acción se completa en 2 minutos. En lugar de esperar los 3 minutos restantes a que el módem vuelva a entrar en modo ULP puede apagarlo inmediatamente especificando un valor 0 en el valor, ahorrando batería. value: 0 … 86400 segundos

AT^MTXTUNNEL=CERTIFICATE,LISTSERVERS

Lista los Certificados SSL Root CA de usuario para conexiones SSL. Básicamente lista los ficheros disponibles en la carpeta “secutity/certs/servers”, es decir, los hasta 10 ficheros posibles ServerCertificate1.jar… ServerCertificate10.jar.

AT^MTXTUNNEL=CERTIFICATE,INSTALLSERVERS

Instala todos los Certificados SSL Root CA de usuario para conexiones SSL. Básicamente instala los certificados disponibles en la carpeta “secutity/certs/servers”, es decir, los hasta 10 ficheros posibles de certificados ServerCertificate1.jar… ServerCertificate10.jar.

AT^MTXTUNNEL=CERTIFICATE,DELETESERVER,certificateFile

Elimina el Certificado SSL Root CA indicado. El parámetro “certificateFile” indica uno de los 10 ficheros posibles de certificados ServerCertificate1.jar… ServerCertificate10.jar que se deben encontrar en el directorio security/certs/servers dentro del módem. Una vez ejecutado el comando el certificado es desinstalado y eliminado el fichero del directorio.

AT^MTXTUNNEL=CERTIFICATE,LISTCLIENTS

Lista los Certificados de cliente para conexiones SSL (únicamente necesarios si se necesita autenticación de cliente por certificado por parte del servidor). Básicamente lista los ficheros disponibles en la carpeta “secutity/certs/client”, es decir, los hasta 10 ficheros posibles ClientCertificate1.jar… ClientCertificate10.jar

AT^MTXTUNNEL=CERTIFICATE, INSTALLCLIENT,certificateFile

A diferencia de los certificados de servidor, para los que es posible instalar hasta 10 de forma simultánea, en el caso del certificado de cliente, por razones obvias, sólo es posible instalar un certificado de forma simultánea. Con este comando se especifica el certificado a instalar.

AT^MTXTUNNEL=CERTIFICATE,DELETECLIENT

Desinstala el certificado de cliente (pero a diferencia del caso del certificado de servidor, no elimina ningún fichero del directorio security/certs/client).

AT^MTXTUNNEL=CERTIFICATE,DELETEFILECLIENT,certificateFile

Elimina del directorio security/certs/client el certificado indicado.

AT^MTXTUNNEL=setAstroSchedule,ID:Day;Month;SunriseHour;SunriseMinute; SunsetHour;SunsetMinute

Permite establecer manualmente las hora de orto y ocaso para días especiales del año (excepciones). Es decir, si se activa el reloj astronómico para actuar sobre un relé, éste conmutará en función de los cálculos automáticos (orto/ocaso) realizados por el módem, a excepción de los horarios indicados mediante este comando. Esto le permitirá establecer horarios para días especiales. Consulte el ejemplo 8.7 para más información ID: 1 … 100 Indice de la temporización. Máximo 100 horarios Day: 1…31 Month: 1…12 SunriseHour: 0…23 SunriseMinute: 0…59 SunriseHour: 0…23 SunriseMinute: 0…59 Ejemplo: AT^MTXTUNNEL= setAstroSchedule,1:15;7;8;30;21;45 (para el día 15 de Julio el orto serán las 8:30 y el ocaso a las 21:45) Este comando escribirá en un archivo de nombre “astroschedule.txt” que se encuentra en el interior del módem. También se permite la copia entera de dicho fichero desde un servidor FTP mediante el comando AT^MTXTUNNEL=FTP,…. Ó AT^MTXTUNNEL=DOWNLOAD, … El formato de dicho fichero “astroschedule.txt” es el siguiente: 1:day;month;SunriseHour;SunriseMinute;SunsetHour;SunSetMinutern 2:day;month;SunriseHour;SunriseMinute;SunsetHour;SunSetMinutern 3:day;month;SunriseHour;SunriseMinute;SunsetHour;SunSetMinutern

AT^MTXTUNNEL=getAstroSchedule,ID

Devuelve la programación astronómica especial ID del módem, donde ID = 1…100 indica el número de excepción.

AT^MTXTUNNEL=getAstroSchedules

Devuelve una lista con todas las excepciones del reloj astronómico.

AT^MTXTUNNEL=delAstroSchedules

Elimina todas las excepciones del reloj astronómico.

AT^MTXTUNNEL=delAstroSchedule,ID

Elimina todas la excepcione del reloj astronómico ID del módem, donde ID = 1. 100 indica el número de la excepción.

AT^MTXTUNNEL=DOWNLOAD,url,httpUsername,httpPassword,filename,modemPath,filenameDestination

Permite descargar un fichero vía http de un servidor web al interior del módem. Ejemplos: AT^MTXTUNNEL=DOWNLOAD,http://www.miweb.com,,,config.txt,,config.txt AT^MTXTUNNEL=DOWNLOAD,http://www.miweb.com/miPath,,,astroschedule.txt,, astroschedule.txt AT^MTXTUNNEL=DOWNLOAD,http://www.miweb.com/mipath,miuser,miPassord, config.txt, security/,config.txt

AT^MTXTUNNEL=IOEVENT

Inicia un proceso de lectura de las E/S del módem (entradas y salidas digitales, entradas analógicas y contadores de pulsos) para almacenarlas en el dataloggeer interno para su posterior envío a un servidor Web o bróker MQTT, sin necesidad de esperar a que se produzca un evento o periodo de lectura.

AT^MTXTUNNEL=GETIP

Devuelve la dirección IP actual del módem.

AT^MTXTUNNEL=EXECUTE,file

Ejecuta un fichero batch de comandos AT. Dentro de la memoria flash del módem se encuentra una carpera de nombre “atscripts”. Dentro de esta carpeta pueden incorporarse ficheros batch de comandos AT para ser ejecutados mediante este comando. En file debe especificarse el nombre del archivo a ejecutar. Consulte el punto 7.4 para más información.

AT^MTXTUNNEL=FORCEDNS

Los parámetros de configuración DNS_ permiten configurar al módem para enviar periódicamente los datos de estado del módem (IP, cobertura, GPIOs, …). Este comando permite el envío inmediato de la trama DNS sin necesidad de finalizar el periodo de tiempo configurado.

AT^MTXTUNNEL=SETDAC,idDAC,valor

Comando que permite cambiar el valor de salida de un DAC de aquellos modelos de módem que cuentan con esta interfaz.

idDAC: indica el identificador del DAC (0, …)

valor: valor en milivoltios a aplicar en el DAC (0 …10100 )

AT^MTXTUNNEL=GETDAC,idDAC

Comando que permite leer el valor de salida de un DAC de aquellos modelos de módem que cuentan con esta interfaz. El valor devuelto es en milivoltios.

idDAC: indica el identificador del DAC (0, …)

AT^MTXTUNNEL=SETIOMAINTENANCE,idGPIO,mode

Comando que permite configurar una GPIO de tipo salida en modo mantenimiento. Esto le permite abandonar temporalmente el modo de configuración para pasar a modo manual y poder activarse/desactivarse con el comando AT^MTXTUNNEL=SETIO.

Por ejemplo, considere una salida GPIO configurada como reloj astronómico. La salida se activará con la puesta de sol y se desactivará con la salida del sol. Activando el modo mantenimiento la salida pasará a estar en modo manual hasta que se abandone el modo mantenimiento o se reinicie el módem MTX.

idGPIO: indica el identificador de la salida GPIO (0, …)

mode: 0: modo de trabajo normal (el cofigurado en GPIO_config)

1: modo manenimiento

AT^MTXTUNNEL=SETWMBUSFILTERS,value

Comando que permite activar o desactivar los filtros configurados de fabricante y dispositivo para la lectura de sensores W-MBUS. Útil para puestas en marcha de instalaciones donde el MTX-Tunnel trabaja como concentrador W-MBus.

value:

0: Filtros desactivados

1: Filtros activados

¿Tiene alguna pregunta? ¿Necesita un presupuesto? Póngase en contacto con nosotros para solicitar un presupuesto.

  • Este campo es un campo de validación y debe quedar sin cambios.

Appendices and other documents

Anexos y otros documentos

Preguntas frecuentes

CONFIGURACIÓN DE LA PASARELA WEBDYNSUN

  • Comience por comprobar que los parámetros IP de su ordenador son compatibles con la dirección «IP» de la WebdynSun (por defecto: 192.168.1.12).  
  • Luego, inicie un navegador web (Firefox o IE) e introduzca la dirección IP de la WebdynSun en la barra de direcciones. Se mostrará una página de autenticación: 

Los accesos por defecto son:
Nombre de usuario: userhigh
Contraseña: high

  • Haga clic en «conectar» 

Hay dos tipos de configuración: a través de la interfaz web y por SMS.

Configuración a través de la interfaz web:

1/ Acceda a la página de configuración con la dirección IP del concentrador (por defecto 192.168.1.12)
2/ Vaya a la pestaña Configuración.
3/ Seleccione el modo de conexión: Ethernet o módem:

En el caso de una conexión a través de la red local (Ethernet):

  • Edite los parámetros IP de la WebdynSun asignándole una dirección compatible con la red.

Tenga en cuenta que todos los campos deben completarse según la configuración de su red local.

En el caso de una conexión a través de la red GPRS (Módem):

  • Modifique los parámetros de conexión del módem GPRS, basándose en los parámetros proporcionados por su operador de telefonía móvil.

4/ Edite los parámetros del servidor FTP.

5/ Valide las modificaciones.
6/ Reinicie la pasarela WebdynSun para que se tengan en cuenta los nuevos parámetros.
7/ En el menú, haga clic en la pestaña «instalación», luego en la subpestaña «conexión» e inicie la conexión.

Configuración por SMS:
Este modo de configuración requiere el uso de una tarjeta SIM activa con una opción de datos y un código PIN, que debe ser «0000» o desactivado (uno u otro).
La tarjeta SIM debe estar insertada antes de encender el producto.
Una vez encendido el producto, envíe los SMS siguientes al número de la tarjeta SIM insertada:

SMS de configuración del APN:
Tras reemplazar los campos genéricos por los de su operador, envíe el SMS* siguiente:
apn=apn_name;usr=user_name;pwd=password;

Reemplace los campos del SMS anterior con la siguiente información:

  • apn_name: Nombre del APN proporcionado por su operador de telefonía móvil
  • user_name: Identificador APN proporcionado por su operador de telefonía móvil
  • password: Contraseña APN proporcionada por su operador de telefonía móvil

SMS para la configuración FTP:
Tras reemplazar los campos genéricos por los de su servidor FTP, envíe el SMS* siguiente:
Ftp=server_name:user_name:password:port;

Reemplace los campos del SMS anterior con la siguiente información:

  • server_name: Dirección del servidor FTP
  • user_name: Identificador de la cuenta FTP
  • Password: Contraseña de la cuenta FTP
  • Port: Puerto del servidor FTP (puerto por defecto 21)

SMS de conexión:
Envíe por SMS* la palabra «connect» para iniciar una conexión con el servidor FTP

*Atención: el formato del SMS debe ser estrictamente idéntico al anterior (ej.: sin espacios entre caracteres)

USO GENERAL DE LA PASARELA WEBDYNSUN

Hay 2 métodos para resetear la pasarela.

Si el modo de conexión es Ethernet:

  • Desconecte la toma de red
  • Retire la cubierta
  • Desconecte la batería
  • Ponga el dip Switch 2 presente en la tarjeta de la WebdynSun en la posición «ON»
  • Inicie la WebdynSun conectándola a la toma de red
  • Espere hasta que todos los leds parpadeen y luego dejen de parpadear (de 3 a 5 min).
  • Desconecte la toma de red
  • Vuelva a poner el dip Switch 2 en «OFF» 
  • Vuelva a conectar la batería
  • Vuelva a conectar la toma de red, la WebdynSun se inicia normalmente.

Si hay una tarjeta SIM insertada en el concentrador:

  • Envíe un SMS que contenga la palabra «factory» al número de la tarjeta SIM insertada.

Nota: El reset de la pasarela restaura la configuración a su estado original. Tenga en cuenta que se conservarán los datos, pero no la configuración específica. Por tanto, todos los parámetros deben volver a configurarse.

Es posible enviar comandos a los equipos conectados, excepto a ciertos inversores o esclavos Modbus que no aceptan solicitudes de escritura.

Para los equipos que lo permitan, es posible crear archivos de comando en el servidor FTP.

La capacidad de memoria de la WebdynSun es de aproximadamente 100 MB.

En caso de no tener acceso al servidor remoto, el concentrador WebdynSun puede almacenar los datos durante varios meses.

El tiempo máximo de almacenamiento de datos varía según la cantidad de datos que se recopilen.

El tiempo medio de registro varía entre 3 y 4 meses.

La vida útil media de la batería es de 5 años.

Puede variar según el entorno de instalación.

Sí, pueden enviarse datos a un autómata si este integra el protocolo Modbus.

El archivo de configuración «Report» permite al concentrador WebdynSun escribir automáticamente los valores leídos en un esclavo Modbus.

Todos nuestros productos tienen una garantía de 2 años.

Para más información, consulte nuestras condiciones generales de venta.

Los archivos cargados por la pasarela WebdynSun están comprimidos en formato Gz.

Los datos contenidos en estos archivos están estructurados en formato csv.

El volumen de datos depende de los archivos intercambiados.

El promedio es de alrededor de 5 MB por mes y varía para cada instalación.

 COMPATIBILIDAD DE LOS INVERSORES CON LA PASARELA WEBDYNSUN

Es posible conectar inversores de diferentes marcas en el puerto RS485(B) o mediante el puerto Ethernet si el protocolo de los inversores se basa en el protocolo Modbus (RTU o TCP).

Sin embargo, no es posible conectar onduladores de diferentes marcas en el mismo puerto RS485(A).

Para obtener la lista de inversores compatibles, consulte la página de producto de la pasarela de datos WebdynSun.

  • Compruebe si se ha seleccionado el protocolo de inversor correcto antes de iniciar la detección:

  • Compruebe el cableado y la configuración de los inversores basándose en los anexos de los inversores.
  • Compruebe que los inversores no estén en modo OFF o stand-by.
  • Compruebe que los terminales de fin de línea del bus RS 485(A) estén activados.

COMPATIBILIDAD CON LOS EQUIPOS MODBUS

Sí, hay que configurar el equipo a conectar y crear su archivo de definición Modbus.

La configuración se basa principalmente en los parámetros de serie de bus RS485 o los parámetros IP.

Sí, es posible conectar diferentes equipos Modbus en el mismo puerto RS485 (B).

Sin embargo, para que se comuniquen entre sí, deben tener los mismos parámetros de comunicación (parámetros de bus o parámetros IP compatibles).

Anexos y otros documentos

Preguntas frecuentes

Verificar estos puntos en este orden:
  • el nivel de la pila: si la pila está demasiado baja o vacía, el producto no funcionará correctamente o para nada.
  • El nivel de recepción del módem: una mala señal a nivel del módem también puede impedir al concentrador guardar los archivos. Ver para desplazar el producto o instalar una antena externa para mejorar la calidad de la señal.
  • El último archivo de configuración: un archivo incorrecto de configuración puede bloquear el producto.

A distancia, verificando los archivos guardados periódicamente si la configuración del producto se ha realizado correctamente.

A proximidad, pasando el imán por encima del producto, usted escuchará sonar 3 bips cortos.

Reemplazar el producto e inyectar la configuración del antiguo producto en el nuevo. Si se utiliza una lista blanca, no olvidar inyectarla también en el nuevo producto.
No, el concentrador no es capaz de descifrar los datos del equipo WM-BUS porque no tiene una caja fuerte a bordo que garantice la seguridad de las claves de cifrado de su equipo. Los datos recuperados son depositados sin modificación (sin descifrar) por el concentrador en su servidor remoto.

Anexos y otros documentos

Preguntas frecuentes

CONFIGURACIÓN DE LA PASARELA WEBDYNRF

  • En caso de que el archivo se elimine de la carpeta después de conectar el concentrador WebdynRF, el problema suele deberse a un error de formato de archivo. Los archivos de configuración y comando deben respetar el formato descrito en los archivos de esquema (XSD). Para comprobar la coherencia de un esquema, abra el archivo XML con el editor de texto Notepad++ e instale el complemento «XML Tool». Luego copie el archivo XSD correspondiente al archivo XML en la misma carpeta y seleccione en XML Tool «Validate now». Deben mostrarse los errores detectados por la herramienta.
  • En caso de que el archivo no se elimine del servidor, el problema más común es que el archivo no se ha guardado en la ubicación correcta. El archivo debe estar disponible en el servidor en la carpeta «INBOX», y en la subcarpeta que lleva el nombre del identificador único (UID) del producto (ejemplo «/INBOX/0045CE/»).

USO GENERAL DE LA PASARELA WEBDYNRF

La cantidad de datos intercambiados en la red GPRS varía según la configuración. No obstante, puede estimarse un consumo de unos 5 MB / mes.
El concentrador WebdynRF consume en promedio alrededor de 250mA.
Hay 2 modos de actualización de firmware: Actualización local: En la interfaz de configuración de la WebdynRF, acceda a la pestaña «Actions» y seleccione el actualizador en el menú «File upload» antes de hacer clic en el botón «Upload». Actualización remota: Descargue del servidor FTP el archivo que contiene el actualizador (archivo con la extensión «.bz2») en la carpeta «BIN». Luego inserte el comando de actualización en la carpeta INBOX correspondiente a su concentrador («INBOX/», con el identificador del concentrador respectivo) El comando de actualización debe respetar el siguiente formato: updater.tar.bz2 checksum_md5 updater.tar.bz2 checksum_md5 Con :
  • updater.tar.bz2: Nombre del archivo de actualización descargado en la carpeta «BIN»
  • checksum_md5: Código md5 del archivo de actualización

La falta de conexión con el servidor FTP puede explicarse por un problema de conexión a la red (Ethernet o GPRS), por un problema de inicio de sesión FTP o por una no activación de la conexión.

En caso de problema de conexión a la red, verifique los puntos siguientes:

  • Ethernet:
    • Modo del módem en «off» o «alwaysoff»
    • Campos «Gateway» introducidos correctamente
    • Debe configurarse al menos un servidor DNS
  • GPRS:
    • Modo del módem en «on»
    • APN, identificador APN y contraseña APN introducidos correctamente
    • Número de llamada GPRS a «* 99***1#»

 

En caso de problema de inicio de sesión, verifique los puntos siguientes:

  • Parámetros FTP incorrectos
  • Puerto TCP 21 cerrado en salida
  • Problema de resolución del nombre de dominio: no se ha indicado el servidor DNS

 

En caso de que no se active la conexión:

En este caso, solo la conexión automática no funciona. El problema suele deberse a una configuración incorrecta de los «schedules». Atención: el ID de los schedules debe ser un número entero.

USO PARTICULAR DE LA PASARELA WEBDYNRF WIRELESS M-BUS

Para que se carguen los datos de los módulos WM-bus, es necesario

  • Elegir el modo correspondiente a los módulos utilizados (S, T o N)
  • Definir los módulos o grupos de módulos a tratar

Un módulo puede definirse de forma única por todos los campos siguientes:

  • Id
  • Manufacturer
  • Version
  • Medium

Si los datos de un módulo estuviesen encriptados, es posible definir la clave de encriptado de este módulo en el campo «Key».

Para simplificar la introducción de los módulos a tratar, es posible definir un grupo de módulos respetando los campos introducidos. Los otros campos se dejarán vacíos (a continuación se muestra un ejemplo de configuración que permite recuperar todos los módulos del manufacturer Webdyn (WDN) con la clave de encriptado «00000000000000000000000000000000».

  •   Id :
  •   Manufacturer : WDN
  •   Medium :
  •   Version :
  •   Label : Webdyn
  •   Key : 00000000000000000000000000000000

Nota: Para que se tengan en cuenta los módulos (filtros) introducidos, el modo «ByPass filter» debe estar desactivado.

 USO PARTICULAR DE LA WEBDYNRF WAVENIS

La herramienta se conecta al concentrador accediendo al instalador (install).

Por lo tanto, debe utilizarse la contraseña del instalador (por defecto «middle»), y no la del administrador (por defecto «high»)

Los estados cargados por el concentrador WebdynRF son los valores brutos contenidos en los módulos Wavenis. Se cargan sin interpretación. Para obtener más detalles, consulte los manuales de los módulos Coronis.

Anexos y otros documentos

Preguntas frecuentes

CONFIGURACIÓN DE LA PASARELA WEBDYNRF

  • En caso de que el archivo se elimine de la carpeta después de conectar el concentrador WebdynRF, el problema suele deberse a un error de formato de archivo. Los archivos de configuración y comando deben respetar el formato descrito en los archivos de esquema (XSD). Para comprobar la coherencia de un esquema, abra el archivo XML con el editor de texto Notepad++ e instale el complemento «XML Tool». Luego copie el archivo XSD correspondiente al archivo XML en la misma carpeta y seleccione en XML Tool «Validate now». Deben mostrarse los errores detectados por la herramienta.
  • En caso de que el archivo no se elimine del servidor, el problema más común es que el archivo no se ha guardado en la ubicación correcta. El archivo debe estar disponible en el servidor en la carpeta «INBOX», y en la subcarpeta que lleva el nombre del identificador único (UID) del producto (ejemplo «/INBOX/0045CE/»).

USO GENERAL DE LA PASARELA WEBDYNRF

La cantidad de datos intercambiados en la red GPRS varía según la configuración. No obstante, puede estimarse un consumo de unos 5 MB / mes.
El concentrador WebdynRF consume en promedio alrededor de 250mA.
Hay 2 modos de actualización de firmware: Actualización local: En la interfaz de configuración de la WebdynRF, acceda a la pestaña «Actions» y seleccione el actualizador en el menú «File upload» antes de hacer clic en el botón «Upload». Actualización remota: Descargue del servidor FTP el archivo que contiene el actualizador (archivo con la extensión «.bz2») en la carpeta «BIN». Luego inserte el comando de actualización en la carpeta INBOX correspondiente a su concentrador («INBOX/», con el identificador del concentrador respectivo) El comando de actualización debe respetar el siguiente formato: updater.tar.bz2 checksum_md5 updater.tar.bz2 checksum_md5 Con :
  • updater.tar.bz2: Nombre del archivo de actualización descargado en la carpeta «BIN»
  • checksum_md5: Código md5 del archivo de actualización

La falta de conexión con el servidor FTP puede explicarse por un problema de conexión a la red (Ethernet o GPRS), por un problema de inicio de sesión FTP o por una no activación de la conexión.

En caso de problema de conexión a la red, verifique los puntos siguientes:

  • Ethernet:
    • Modo del módem en «off» o «alwaysoff»
    • Campos «Gateway» introducidos correctamente
    • Debe configurarse al menos un servidor DNS
  • GPRS:
    • Modo del módem en «on»
    • APN, identificador APN y contraseña APN introducidos correctamente
    • Número de llamada GPRS a «* 99***1#»

 

En caso de problema de inicio de sesión, verifique los puntos siguientes:

  • Parámetros FTP incorrectos
  • Puerto TCP 21 cerrado en salida
  • Problema de resolución del nombre de dominio: no se ha indicado el servidor DNS

 

En caso de que no se active la conexión:

En este caso, solo la conexión automática no funciona. El problema suele deberse a una configuración incorrecta de los «schedules». Atención: el ID de los schedules debe ser un número entero.

USO PARTICULAR DE LA PASARELA WEBDYNRF WIRELESS M-BUS

Para que se carguen los datos de los módulos WM-bus, es necesario

  • Elegir el modo correspondiente a los módulos utilizados (S, T o N)
  • Definir los módulos o grupos de módulos a tratar

Un módulo puede definirse de forma única por todos los campos siguientes:

  • Id
  • Manufacturer
  • Version
  • Medium

Si los datos de un módulo estuviesen encriptados, es posible definir la clave de encriptado de este módulo en el campo «Key».

Para simplificar la introducción de los módulos a tratar, es posible definir un grupo de módulos respetando los campos introducidos. Los otros campos se dejarán vacíos (a continuación se muestra un ejemplo de configuración que permite recuperar todos los módulos del manufacturer Webdyn (WDN) con la clave de encriptado «00000000000000000000000000000000».

  •   Id :
  •   Manufacturer : WDN
  •   Medium :
  •   Version :
  •   Label : Webdyn
  •   Key : 00000000000000000000000000000000

Nota: Para que se tengan en cuenta los módulos (filtros) introducidos, el modo «ByPass filter» debe estar desactivado.

 USO PARTICULAR DE LA WEBDYNRF WAVENIS

La herramienta se conecta al concentrador accediendo al instalador (install).

Por lo tanto, debe utilizarse la contraseña del instalador (por defecto «middle»), y no la del administrador (por defecto «high»)

Los estados cargados por el concentrador WebdynRF son los valores brutos contenidos en los módulos Wavenis. Se cargan sin interpretación. Para obtener más detalles, consulte los manuales de los módulos Coronis.

Anexos y otros documentos

Otros manuales

Notas de aplicación

Preguntas frecuentes

Configuración de la pasarela:

Comenzar verificando que los parámetros IP del ordenador son compatibles con la dirección IP de la WebdynSunPM (por defecto 192.168.1.12)

Lanzar un navegador Web (Chrome, Firefox, Edge, Safari…) e ingresar la dirección IP del concentrador WebdynSunPM en la barra de dirección. Se visualizará una página de autentificación:

Los accesos por defecto son:

IdentificadorContraseña
userhighhigh

Hacer clic en «Login»

Existen dos soluciones de configuración, a través de la interfaz web y a través de SMS:
  • Configuración a través de la interfaz web:
Establecer en primer lugar una conexión en el concentrador conectándose en el mismo para acceder a la configuración de los servidores: Ingresar el modo de conexión «ethernet» o «módem»: En el caso de una configuración por ethernet, tener el cuidado de que los parámetros IP sean compatibles con el acceso al servidor según la configuración de la red local del concentrador. En el caso de una conexión por ethernet, la configuración debe ser compatible con la topología de la red local del concentrador para que pueda acceder a los servidores. Esta configuración se hace a través de la página de configuración «Networks»  (ver capítulo 3.2.2.3: «Redes (Networks)«). En el caso de una conexión por módem, la configuración del módem debe ser correcta antes de poder efectuar una conexión. Esta configuración se hace en la página de configuración «Modem» (ver capítulo 3.2.2.4: «Módem«). Los parámetros de los servidores a configurar como mínimo son los siguientes: Por lo tanto, hay que los campos: «Interface», «Type», «Server type», «Address», «Port», «Login» y «Password». Los otros campos se pueden dejar a los valores por defecto, a condición de que los repertorios hayan sido creados antes correctamente. (Ver capítulo 3.1.2 : «Archivos de configuración« para más detalles.
  • Configuración por SMS:
La configuración por SMS necesita enviar los siguientes comandos:
    • Apn: para configurar el APN de la tarjeta SIM. (ver capítulo 3.2: «Comando de configuración del módem «apn»)
    • Ftp: para configurar el servidor FTP que tendrá la configuración del concentrador (ver capítulo 3.3: «Comando de configuración del FTP «ftp»«).
    • Connect: para lanzar la conexión al servidor FTP y cargar la configuración (ver capítulo 3.1: «Comando de conexión «Connect» 

El acceso al servidor FTP depende de la solución adoptada.

Si usted ha seleccionado un portal, los identificadores de acceso al servidor FTP este se los comunica.

Si desea utilizar su propio servidor FTP, contacte con su administrador de red.

Para todas las otras configuraciones y para determinar la solución que conviene mejor, hay que contactar con el servicio comercial Webdyn que sabrá aconsejarle y redirigirlo a los interlocutores pertinentes: contact@webdyn.com

Utilización general de la pasarela

Existen 2 métodos para forzar un regreso a los parámetros de fábrica del concentrador:
  • Pulsar el botón Retour Usine del concentrador durante 20 segundos:
Esperar. El concentrador arrancará con su configuración de fábrica.
  • Si está instalada y configurada una tarjeta SIM, un SMS «factory» también permite efectuar un retorno de fábrica. Basta con enviar el SMS «factory» al número de teléfono de la tarjeta SIM (ver capítulo 3.7: «Comando de regreso de fábrica «factory»«)

Es posible enviar comandos a los equipos conectados si este los acepta.

La WebdynSunPM memoriza hasta 50Mo de datos no comprimidos por equipo declarado.

En caso de no acceso al servidor distante, el concentrador WebdynSunPM puede, por esta razón, almacenar los datos durante varios mes.

El tiempo máximo de almacenamiento de datos varía en función de la cantidad de datos a recopilar y de la frecuencia de la recopilación configurada.

La duración media de salvaguardia varía entre 3 y 4 mes.

La duración de vida promedio de la batería es de 5 años.

Puede variar según el entorno de la instalación.

Todos nuestros productos tienen una garantía de 2 años.

Para más información, consulte nuestras condiciones generales de venta.

El volumen de datos depende de los archivos intercambiados.

El promedio es del orden de 5 Mo por mes y varía para cada instalación.

Compatibilidad de los inversores

Ver capítulo 1.4: «Equipos soportados».

Compatibilidad de los equipos modbus:

Sí, es posible conectar diferentes equipos Modbus en el mismo puerto serie.

Compatibilidad de los equipos:

  • Mismo tipo de enlace RS485 2 o 4 cables.
  • Todos los equipos se deben poder configurar con características de bus idénticas. Misma velocidad, misma paridad, misma cantidad de stop bits y de data bits en todos los equipos y en la WebdynSunPM.
  • A cada equipo se le debe atribuir una dirección Modbus única (entre 1 y 247) en el bus. (UnitID)

Anexos y otros documentos

Preguntas frecuentes

Anexos y otros documentos

Preguntas frecuentes

Anexos y otros documentos

Preguntas frecuentes

Anexos y otros documentos

Preguntas frecuentes

Anexos y otros documentos

Preguntas frecuentes

Anexos y otros documentos

Anexos y otros documentos

Anexos y otros documentos

Anexos y otros documentos

Annexes et autres documents

FAQ