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