Tunnel – Link Configuration parameters: “LINK_”

/in /by
¿Buscas alguna otra cosa?
< Back to Knowledge Base

Parameters with the prefix LINK_ are related to MTX-Tunnel configurations for scenarios where you want to supervise/configure the modem by means of a real-time connection to a web platform.

MTX-Tunnel, as it is stated throughout this manual, permits its remote supervision through AT commands or via Telnet, SMS, Webserver, a GPRS-RS232 gateway with embedded AT commands, etc. With the new service LINK_ Mtx-Tunnel creates a permanent TCP client socket exclusively designed for this option. It appears to be very practical, because since it is TCP client connection type, it does not depend on whether the modem has a SIM with public IP.

For better understanding see the examples of this manual. Also remember that MTX-Tunnel supports MQTT, so if you are starting a web platform from scratch, it is advisable to use MQTT.

LINK_enabled

Description: Allows to enable or not the LINK socket for the real-time remote supervision of a MTX-Tunnel modem.

Possible values:

  • on, off
  • Default value: off

Additional notes:

  • Consult this example for better understanding of this parameter
  • For additional help send an email to iotsupport@mtxm2m.com

LINK_IP

Description: If the parameter LINK_enabled is in “on” mode,it allows to specify the IP or DNS address to which MTXTunnel will be connected for real-time supervision.

Parameter valid from the version MTX-Tunnel v9.06.

Possible values:

  • IP o DNS (example: 1.2.3.4 at ip.mydomain.com)
  • Default value: none

Additional notes:

  • To use LINK option it is not necessary to make sure that the IP of the SIM of the modem is neither static nor public, because it is the modem who establishes connection. However it is recommended that the IP address of the Server to which the modem will connect (specified in LINK_IP) is a fixed one

LINK_port

Description: If the parameter LINK_enabled is in “on” mode, it allows to specify the TCP port to which MTX-Tunnel will be connected for real-time supervision.

Parameter valid from the version MTX-Tunnel v9.06.

Possible values:

  • 1… 65535
  • Default value: 20023

LINK_retryPeriod

Description: When the connectivity with the IP address specified in LINK_IP is lost, this time period shows the duration (in seconds) of the pause before a new connection is established.

The parameter is valid starting MTX-Tunnel v9.06.

Possible values:

  • 0… 3600
  • Default value: 30 (seconds)

Additional notes:

  • It is recommended to set at least 30 seconds interval. Otherwise, in case of remote server crash (the one that corresponds to the IP address specified in LINK_IP), the modem will keep on trying to re-establish a socket with the consequent data consumption. Be especially careful with this option if you do not dispose of a SIM with a flat-rate data plan

LINK_timeout

Description: Indicates the time period in seconds that should pass without any data received by LINK socket in order to close the socket and re-establish the connection.

Parameter valid from the version MTX-Tunnel v9.06.

Possible values:

  • 0… 3600
  • Default value: 1800 (seconds)

Additional notes:

  • This parameter allows to solve connectivity loss problems when connecting to a remote control server. Sometimes a connectivity server might suddenly switch off (for example, power supply cut-off, some kind of hangs…). In such cases a socket disconnection notification is not sent to connected devices (in this case MTX-Tunnel modem). If a socket closed notification is not received, MTX-Tunnel will understand that the socket is alive and will not be re-established. To solve this problem, if data are not received in LINK_timeout seconds, the LINK socket closes and opens again, thus ensuring a new connectio

LINK_keyId

Description: Allows to configure a text string in terms of device identification. It will be the first information MTX-Tunnel will send through LINK socket having established connection with the maintenance server.

Parameter valid from the version MTX-Tunnel v9.06.

Possible values:

  • ASCII string up to 64 characters
  • Default value: none

Additional notes:

  • Use this parameter on your server because it will help you identify the modem among other modems connected. It is interesting to use KEYID instead of modem IMEI, because in case of malfunction of a modem, you will only have to substitute the damaged modem with another one with the same configuration without having to make any change on the maintenance server, despite the fact that the modem’s IMEI is different

LINK_ssl

Description: Indicates if the LINK socket to be created with the maintenance server should be SSL or not.

Parameter valid starting MTX-Tunnel v9.06.

Possible values:

  • 0, 1 (0=no, 1=yes)
  • Default value: 0