Tunnel – Parámetros de configuración SMS: “SMS_”

El MTX-Tunnel dispone de multitud de características interesantes donde interviene la mensajería SMS. Los siguientes parámetros de configuración hacen referencia a ello.

SMS_sendIP

Descripción: especifica si cuando el MTX-Tunnel recibe un mensaje SMS con el texto “mtxtunnel on” o se recibe una llamada perdida, además de iniciar la sesión GPRS y por tanto activarse los servicios asociados (túnel, webserver, telnet, …) el MTX-Tunnel debe informar de la IP obtenida del operador devolviendo un SMS.

Valores posibles: on, off
Valor por defecto: off

Notas adicionales:

• Si el parámetro está a “on” y la sesión de datos ya estaba establecida, por ejemplo, porque la conexión es permanente, el MTX-Tunnel también devolverá la dirección IP actual al remitente
• Únicamente obtendrán respuesta los números de teléfono autorizados si el parámetro SMS_allPhones está establecido a “off”

SMS_ATEnabled

Descripción: especifica si es posible ejecutar un comando AT enviado desde un teléfono móvil.

Valores posibles: on, off
Valor por defecto: off

Notas adicionales:

• Si el parámetro está a “on” un SMS será interpretado como un comando AT (para ser ejecutado) siempre que el mensaje esté encabezado por el texto “MTXTUNNEL AT” ó “mtxtunnel at”. Por ejemplo, para conocer la cobertura remota habría que enviar un SMS con el texto “MTXTUNNEL AT+CSQ”
• Únicamente podrán ejecutar comandos AT los números de teléfono autorizados si el parámetro SMS_allPhones está establecido a “off”

SMS_ATResponse

Descripción: cuando se recibe un SMS en el MTX-Tunnel y se ejecuta, este parámetro indicará si se debe enviar un SMS de vuelta con la respuesta o no.

Valores posibles: on, off
Valor por defecto: off

Notas adicionales:

• En caso de ejecutar un comando túnel SMS-RS232/485 (véase parámetro SMS_tunnelString) para enviar un texto recibido por SMS por el puerto serie hacia un dispositivo X, el MTX-Tunnel esperará hasta 5 segundos a recibir la respuesta de dicho dispositivo X antes de enviar un SMS con la respuesta

SMS_allPhones

Descripción: indica si todos los números de teléfono son autorizados o no para activar la sesión de datos del MTX-Tunnel (y por tanto servicios asociados: túnel 2g/3g/4g-serie, webserver, telnet…) enviando un SMS con texto “mtxtunnel on” o realizando una llamada perdida o ejecutar comandos AT por SMS.

Valores posibles: on, off
Valor por defecto: off

Notas adicionales:

• El parámetro a “on” implicará que todos los números de teléfono anónimos están autorizados. A “off” implicará que sólo un grupo de números de teléfono son autorizados

SMS_validPhone1, SMS_validPhone2, … , SMS_validPhone10

Descripción: en caso de estar el parámetro SMS_allPhones a “off”, estos parámetros indicarán los números de teléfono autorizados, hasta un total de 10.

Valores posibles: un número de teléfono válido
Valor por defecto: ninguno

Notas adicionales:

• Los únicos caracteres válidos para introducir un número de teléfono son el carácter “+” y los caracteres “0” … “9”

SMS_alias1, SMS_alias2, … , SMS_alias20

Descripción: los parámetros de de configuración anteriores muestran cómo se puede enviar comandos AT por SMS para que sean ejecutados por el MTX-Tunnel. Sin embargo, en ocasiones, puede resultar incómodo enviar un SMS con el texto AT^MTXTUNNEL=SETIO,3,1 para conmutar una salida digital, especialmente si el MTX-Tunnel forma parte de un sistema para un tercero.

Es posible establecer hasta 20 alias (10 para versiones anteriores a MTX-Tunnel 11) para la ejecución de comandos AT. Siguiendo el ejemplo anterior, se podría establecer un alias:    Rele1on> AT^MTXTUNNEL=SETIO,3,1 . Con ello, un SMS recibido por el MTX-Tunnel con el texto “Rele1on” sería interpretado como el comando “AT^MTXTUNNEL=SETIO,3,1”.

Valores posibles: una cadena máximo de 64 caracteres
Valor por defecto: ninguno

Notas adicionales:

• La cadena siempre debe contener el carácter “>”, que es el separador entre el alias y su comando AT correspondiente

SMS_aliasOk

Descripción: el parámetro SMS_ATResponse permitía configurar al MTX-Tunnel para devolver un SMS con la respuesta de un comando AT que hubiese sido recibido por SMS. Este parámetro permite substituir la respuesta proporcionada por el módem al comando AT por un texto de usuario cuando el comando AT se ejecutó correctamente.

Valores posibles: una cadena máximo de 100 caracteres
Valor por defecto: ninguno

Notas adicionales:

• Si el parámetro SMS_aliasOk tiene una longitud mayor de 0 caracteres, se enviará dicho parámetro por SMS como respuesta a un comando AT en lugar del resultado técnico del comando AT devuelto por el módem

SMS_aliasError

Descripción: el parámetro SMS_ATResponse permitía configurar al MTX-Tunnel para devolver un SMS con la respuesta de un comando AT que hubiese sido recibido por SMS. Este parámetro permite substituir la respuesta proporcionada por el módem al comando AT por un texto de usuario cuando el comando AT no se ejecutó correctamente.

Valores posibles: una cadena máximo de 100 caracteres
Valor por defecto: ninguno

Notas adicionales:

• Si el parámetro SMS_aliasError tiene una longitud mayor de 0 caracteres, se enviará dicho parámetro por SMS como respuesta a un comando AT (con error) en lugar del resultado técnico del comando AT devuelto por el módem

SMS_aliasResponse

Descripción: el parámetro SMS_aliasResponse permite definir cual será la respuesta a un alias. Esto es, permite escoger entre devolver la respuesta íntegra del comando a ejecuta, es decir, incluyendo en el SMS el comando ejecutado) o bien incluir solo la respuesta.

Valores posibles: full, result
Valor por defecto: full

Notas adicionales:

• Ejemplo:
• En el caso de disponer en el parámetro SMS_aliasResponse un valor “full”, ocurriría lo siguiente:
  SMS enviado: TEMP
  SMS recibido: AT^MTXTUNNEL=GETMODBUS,1;10;1;3
  25
  OK
• En el caso de disponer en el parámetro SMS_aliasResponse un valor “result”, ocurriría lo siguiente:
  SMS enviado: TEMP
  SMS recibido: TEMP > 25

SMS_tunnelString

Descripción: el parámetro SMS_tunnelString permite definir una cabecera especial para que el MTXTunnel interprete que el texto recibido es para enviar directamente por el puerto COM1 del módem.

Ejemplo: si el parámetro SMS_tunnelString tiene el valor “MTX”, un mensaje recibido por SMS con un texto como “MTX+[espacio]+123456789” haría que el MTX-Tunnel envíe por su puerto serie la cadena “123456789”. Esto permite implementar de forma muy simple un “túnel SMS-Serie RS232/485”.

Valores posibles: una cadena máximo de 16 caracteres
Valor por defecto: ninguno

Notas adicionales:

• El SMS enviado siempre tiene que tener un espacio entre la cadena establecida en el parámetro SMS_tunnelString y la cadena a enviar por el puerto serie COM1
• En el caso de estar configurado el parámetro SMS_responseAT a “on”, una vez el MTX-Tunnel envíe por el puerto serie COM1 la cadena recibida esperará hasta 5 segundos para recibir respuesta por el puerto serie del dispositivo conectado al COM1. Dicha respuesta será enviada como respuesta al SMS recibido
• Las respuestas deben tener una cadena inferior a los 160 caracteres. Una cadena de mayor tamaño será truncada a ese tamaño

SMS_urc

Descripción: parámetro disponible desde la versión MTX-Tunnel v7.15.

Un valor a “on” hará que, cada vez que se reciba un mensaje SMS, el módem envíe un URC por el puerto serie indicando la recepción del SMS.

Valores posibles: on, off
Valor por defecto: off

Notas adicionales:

• El formato del URC es:
  ^MTX_SMS[space]PhoneNumber,Textmessage
  Puede resultar muy útil si además de usar una pasarela serie-2G/3G/4G quiere poder recibir en modo RAW un SMS enviado desde un teléfono móvil

SMS_header

Descripción: parámetro disponible desde la versión MTX-Tunnel v7.17

Hasta la versión v7.16 del MTX-Tunnel, todos los comandos AT enviados por SMS debían ir precedidos por la key “mtxtunnel”. Por ejemplo, para enviar el comando AT para averiguar la cobertura remota era necesario enviar un SMS con el texto “mtxtunnel at+csq”. O para averiguar la IP actual del módem, había que enviar un SMS con el texto “mtxtunnel on”.

Ahora es posible personalizar esta key.

Valores posibles: un texto de hasta 16 caracteres. Un valor “none” hará que no sea necesario introducir ninguna cabecera en los SMS
Valor por defecto: mtxtunnel (por compatibilidad con versiones anteriores)

Notas adicionales:

• Es siempre recomendable el uso de una cabecera adicional, especialmente si cualquier número de teléfono está autorizado para el envío de comandos por SMS

SMS_replaceText

Descripción: este parámetro permite reemplazar una cadena recibida en un mensaje SMS por otra cadena diferente. Es decir, por ejemplo, podría hacerse que si en un SMS se incluye el texto con los caracteres “XX”, éste se substituya por “@12345”, por ejemplo.

Valores posibles: textoAReemplazar;textoDeReemplazo
Valor por defecto: ninguno

Notas adicionales:

• Puede resultarle útil si necesita enviar caracteres especiales como @
• Un ejemplo de configuración de parámetro puede ser: SMS_replaceText: XX,@12345 (textos separados por punto y coma)

SMS_defaultPrefix

Descripción: con este parámetro es posible establecer el prefijo internacional que se considerará para aquellas llamadas SMS o GSM perdidas que se reciban en el módem con cualquier prefijo. Es decir, si el módem recibe una llamada GSM y no incluye el prefijo, se utilizará este prefijo.

Valores posibles: una cadena máximo de 16 caracteres
Valor por defecto: ninguno

Notas adicionales:

• Este parámetro solo lo utiliza el módem cuando el parámetro SMS_allPhones tiene el valor “apagado”, es decir, cuando los números de teléfono autorizados están autorizados
• Ejemplo: necesitamos hacer una llamada perdida al módem para obtener la dirección IP actual. Además, queremos enviar el comando AT por SMS desde números de teléfono autorizados
  SMS_allPhones: off
  SMS_sendIP: on
  SMS_ATEnabled: on
  SMS_ATResponse: on
  SMS_validPhone1: +34666123456
  SMS_validPhone2: +34666123457
  SMS_defaultPrefix: +34