Tunnel – GPRS connection configuration parameters: “GPRS_”

The following parameters are mandatory. They make reference to the MTX-Tunnel connection parameters related to the network operator. It depends on the SIM card and provisioned 2G/3G/4G service. Ask your network operator for further information.

GPRS_apn, GPRS_apn2

Description: 2G/3G/4G Access Point Name -APN- Possible values:

• <100 characters text string
• Default value: movistar.es

Additional notes:

• Some APN examples : Movistar Spain (dynamic IP addressing): movistar.es Movistar Spain (fixed IP address): internerestatico.movistar.es Vodafone Spain (dynamic IP addressing): airtelnet.es Vodafone Spain (fixed IP address): ipfija.vodafone.es Orange Spain (dynamic IP address): internet
• Not all network operators are recommended for MTX-Tunnel applications
• Some mobile network operators like Orange or other virtual network operators like Simyo or Yoigo use proxies and block incoming data traffic at TCP ports. Therefore MTX-Tunnel cannot be used in server mode (MTX_mode: server) and only in client mode, so MTX-Tunnel would be waiting for incoming connections
• We have found that other operators use fixed (or also dynamic IP) addressing in a private range. This means that you have lots of security but you have to create a VPN to allow communication
• Please do not hesitate to contact MTXterminals support line iotsupport@mtxm2m.com for further information
• The GPRS_apn2 parameter is for the exclusive use of models that have the “DUAL SIM” feature and refers to the APN used by the secondary SIM. In the case of the MTX-IOT-S family modems, the secondary SIM is the one inside the modem, accessible by opening the case

GPRS_login, GPRS_login2

Description: 2G/3G/4G connection LOGIN access parameter value. Your network operator will provide you with this value. Possible values:

• Text string < 32 characters
• Default value: Movistar

Additional notes:

• Login examples

Movistar Spain (dynamic IP addressing): Movistar

Movistar Spain (fixed IP address): Movistar

Vodafone Spain (dynamic IP addressing): Vodafone

Vodafone Spain (fixed IP address): Vodafone

Orange Spain (dynamic IP address): Cliente

• Not all network operators are recommended for MTX-Tunnel applications. Some mobile network operators use proxies and block incoming data traffic at TCP ports, meaning MTX-Tunnel can only be used in server mode (MTX_mode: server). Contact your distributor for further information.
• The GPRS_login2 parameter is for exclusive use for models that have the “DUAL SIM” feature and refers to the Username used by the secondary SIM. In the case of MTX-IOT-S family modems, the secondary SIM is the one located inside the modem, accessible by opening its casing.

GPRS_password, GPRS_password2

Description: PASSWORD for 2G/3G/4G setting. Ask your network operator to provide you with this value. Possible values:

• Text string < 32 characters
• Default value: Movistar

Additional notes:

• Some “password” value examples:

Movistar Spain (dynamic IP addressing): Movistar

Movistar Spain (fixed IP address): Movistar

Vodafone Spain (dynamic IP addressing): Vodafone

Vodafone Spain (fixed IP address): Vodafone

Orange Spain (dynamic IP address): Amena

• Not all network operators are recommended for MTX-Tunnel applications. Some mobile network operators use proxies and block incoming data traffic at TCP ports, meaning MTX-Tunnel can only be used in server mode (MTX_mode: server). Contact your distributor for further information.
• The GPRS_password2 parameter is for the exclusive use of models that have the “DUAL SIM” feature and refers to the Password used by the secondary SIM. In the case of the MTX-IOT-S family modems, the secondary SIM is the one inside the modem, accessible by opening the case.

GPRS_timeout

Description: This parameter sets the time period during which the 2G/3G/4G connection (and associated services – serial tunnel, WebServer, Telnet) will remain active when it is activated by an SMS, missed call, change in a digital or analog input, alarm timing, etc. Possible values:

• 0… 100000 (minutes)
• Default value: 0

Additional notes:

• Value=0 will establish a permanent GPRS connection; this means that the modem (and associated services –serial tunnel, WebServer, Telnet) will be connected to the 2G/3G/4G 100% of the time after power-up. MTX-Tunnel has intelligent procedures allowing persistent connectivity all the time, therefore it will reconnect after any failure in network signal coverage or power down
• Value>0 specifies the length of time that the 2G/3G/4G connection is active after activation (from SMS, missed call, change in a digital or analog input, alarm timing…)
• The time value is in minutes for MTX platforms, except the “ULP” models where the number represents the number of seconds, not minutes, that the GPRS connection will be active. This is to improve consumption

GPRS_autoTimeout

Description: Parameter available from version MTX-Tunnel v7.15. Only useful when the parameter GPRS_timeout > 0. It allows the 2G/3G/4G session timer to restart every time 2G/3G/4G data is sent/received. Possible values:

• on, off
• Default value: on

Additional notes:

• Example: if the parameter GPRS_timeout = 2, it implies that when the 2G/3G/4G session is activated (for example to set a 2G/3G/4G-Serie gateway against a server) it will last for 2 minutes. If the parameter GPRS_autoTimeout = on, every time that data is received via the 2G/3G/4G gateway, the 2G/3G/4G session timer will restart after 2 minutes, that is, 2 minutes with no traffic must pass for the session to close. If GPRS_autoTimeout = off, once the 2G/3G/4G session started, after 2 minutes, regardless of whether there was traffic or not, the session will close
• Very useful for low consumption scenarios

GPRS_dns, GPRS_dns2

Description: Public DNS IP address. Possible values:

• IP address in format XXX.XXX.XXX.XXX
• Default value: 0.0.0.0 (0.0.0.0 = automatically provided by GSM)

Additional notes:

• You should use the DNS parameter if you use names instead of IP addresses in any other parameter like TCP_IP, MTX_TPServer…
• The GPRS_dns2 parameter is for the exclusive use of models that have the “DUAL SIM” feature and refers to the DNS used by the secondary SIM. In the case of MTX-IOT-S family modems, the secondary SIM is the one located inside the modem, accessible by opening its casing.

GPRS_auto

Description: This parameter will automatically use APN, login and password information from the SIM card. Possible values:

• on, off
• Default value: off

Additional notes:

• New parameter from version MTX-Tunnel v5.7
• When the GPRS_auto parameter has the value “on”, MTX-Tunnel will not take into account the values of the GPRS_apn, GPRS_login & GPRS_password parameters
• When the GPRS_auto parameter has the value “on”, it is necessary to add a new configuration file to MTX-Tunnel memory called “operators.txt”. This file has the following syntax: IDOperador1,apn,login,password,name[ENTER] IDOperador2,apn,login,password,name[ENTER] … operators.txt file example 21407:movistar.es,MOVISTAR,MOVISTAR,Movistar 21401:airtelnet.es,vodafone,vodafone,Vodafone 21403:internet,CLIENTE,AMENA,Orange 21404:internet,,Yoigo
• MTX-Tunnel gets the network operator (IDOperator variable) from “operator.txt” file and then gets the login and password information from it too
• This is useful if you do not know which SIM card operator the end customer will use and it also makes it possible to change the SIM card operator without any further configuration or operation

GPRS_mode

Description: Parameter available from version MTX-Tunnel v7.15. This parameter allows to choose the technology. It is possible to choose between “auto” (automatic change 2G/3G/4G), 2G only or 3G only or 4G only. Possible values:

• auto, 2g, 3g, 4g
• Default value: auto

Additional notes:

• This parameter is only allowed by modems with 3G and 4G technology Don’t use with 2G models