Jump to content

RUT955 Mobile: Difference between revisions

no edit summary
No edit summary
Line 15: Line 15:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Connection type</td>
       <td>Connection type</td>
       <td>QMI | NCM | NDIS | PPP; Default: '''QMI'''</td>
       <td>QMI | NCM | NDIS | PPP; default: <b>QMI</b></td>
       <td>Defines how the router's modem will establish a connection to the ISP (Internet Service Provider)
       <td>Defines how the router's modem will establish a connection to the ISP (Internet Service Provider)
'''PPP''' uses a dialling number to establish a data connection
'''PPP''' uses a dialling number to establish a data connection
Line 31: Line 31:
     <tr>
     <tr>
       <td>Mode</td>
       <td>Mode</td>
       <td>NAT | Passthrough'''*''' | Bridge'''**'''; Default: '''NAT'''</td>
       <td>NAT | Passthrough'''*''' | Bridge'''**'''; default: <b>NAT</b></td>
       <td>'''NAT''' mode enables network address translation on the router
       <td>'''NAT''' mode enables network address translation on the router
'''Bridge''' mode bridges the LTE data connection with LAN. In this mode the router does not have an internet connection as the ISP provides an IP address directly to the end device (e.g., computer). Using Bridge mode will disable most of the router’s capabilities and you will only be able to access your router's settings with a static IP address.  
'''Bridge''' mode bridges the LTE data connection with LAN. In this mode the router does not have an internet connection as the ISP provides an IP address directly to the end device (e.g., computer). Using Bridge mode will disable most of the router’s capabilities and you will only be able to access your router's settings with a static IP address.  
Line 39: Line 39:
     <tr>
     <tr>
     <td>APN</td>
     <td>APN</td>
         <td>string; Default: " "</td>
         <td>string; default: <b>none</b></td>
         <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require to enter the APN just to complete the registration to a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract. <br> '''NOTE''': an APN Network Identifier cannot start with any of the following strings: "rac", "lac", "sgsn" or "rnc"; it cannot end in ".gprs" and it cannot take the value "*"</td>
         <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require to enter the APN just to complete the registration to a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract. <br> '''NOTE''': an APN Network Identifier cannot start with any of the following strings: "rac", "lac", "sgsn" or "rnc"; it cannot end in ".gprs" and it cannot take the value "*"</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>PIN number</td>
     <td>PIN number</td>
         <td>string; Default: " "</td>
         <td>string; default: <b>none</b></td>
         <td>A personal identification number (PIN) is a numeric password used to authenticate a user to a system (in this case, the user to the SIM card)</td>
         <td>A personal identification number (PIN) is a numeric password used to authenticate a user to a system (in this case, the user to the SIM card)</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Dialing number</td>
       <td>Dialing number</td>
       <td>string; Default: " "</td>
       <td>string; default: <b>none</b></td>
       <td>A Dialling number is used to establish a mobile PPP connection</td>
       <td>A Dialling number is used to establish a mobile PPP connection</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>MTU</td>
       <td>MTU</td>
       <td>integer [0..1500]; Default: '''1500'''</td>
       <td>integer [0..1500]; default: <b>1500</b></td>
       <td>MTU (Maximum Transmission Unit) specifies the largest possible size of a data packet</td>
       <td>MTU (Maximum Transmission Unit) specifies the largest possible size of a data packet</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Authentication method</td>
     <td>Authentication method</td>
         <td>CHAP | PAP | None; Default: '''None'''</td>
         <td>CHAP | PAP | None; default: <b>None</b></td>
         <td>The Authentication method that your GSM carrier uses to authenticate new connections on its network</td>
         <td>The Authentication method that your GSM carrier uses to authenticate new connections on its network</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Username</td>
     <td>Username</td>
         <td>string; Default: " "</td>
         <td>string; default: <b>none</b></td>
         <td>The username used to connect to your carrier’s network. This field becomes available when you select an Auth Mode (i.e., the selected Auth Mode is not “None”)</td>
         <td>The username used to connect to your carrier’s network. This field becomes available when you select an Auth Mode (i.e., the selected Auth Mode is not “None”)</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Password</td>
       <td>Password</td>
       <td>string; Default: " "</td>
       <td>string; default: <b>none</b></td>
       <td>The password used to connect to your carrier’s network</td>
       <td>The password used to connect to your carrier’s network</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Service mode</td>
       <td>Service mode</td>
       <td>2G only | 3G only | 4G (LTE) only | Automatic; Default: '''Automatic'''</td>
       <td>2G only | 3G only | 4G (LTE) only | Automatic; default: <b>Automatic</b></td>
       <td>Your service mode preference. If your local mobile network supports 2G, 3G and 4G (LTE) you can specify to which type of network you wish to connect to, e.g., if you choose 2G only, the router will connect to a 2G network, so long as it is available, otherwise it will connect to a network that provides better connectivity. If you select Automatic, then the router will connect to the network that provides the best connectivity</td>
       <td>Your service mode preference. If your local mobile network supports 2G, 3G and 4G (LTE) you can specify to which type of network you wish to connect to, e.g., if you choose 2G only, the router will connect to a 2G network, so long as it is available, otherwise it will connect to a network that provides better connectivity. If you select Automatic, then the router will connect to the network that provides the best connectivity</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Deny data roaming</td>
     <td>Deny data roaming</td>
         <td>yes | no; Default: '''no'''</td>
         <td>yes | no; default: <b>no</b></td>
         <td>When enabled this function prevents the device from establishing mobile data connection while not in your home network</td>
         <td>When enabled this function prevents the device from establishing mobile data connection while not in your home network</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Use IPv4 only</td>
     <td>Use IPv4 only</td>
         <td>yes | no; Default: '''yes'''</td>
         <td>yes | no; default: <b>yes</b></td>
         <td>When enabled this function makes the device use only IPv4 settings when connecting to an operator</td>
         <td>When enabled this function makes the device use only IPv4 settings when connecting to an operator</td>
     </tr>
     </tr>
Line 100: Line 100:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable</td>
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles Mobile Data On Demand ON or OFF<br>
       <td>Toggles Mobile Data On Demand ON or OFF<br>
'''NOTE:''' This function is only available whith PPP Connection type</td>
'''NOTE:''' This function is only available whith PPP Connection type</td>
Line 112: Line 112:
     <tr>
     <tr>
       <td>No data timeout (sec)</td>
       <td>No data timeout (sec)</td>
       <td>integer [10..3600]; Default: '''10'''</td>
       <td>integer [10..3600]; default: <b>10</b></td>
       <td>Mobile data connection will be terminated if no data is transferred during the timeout period specified in this field</td>
       <td>Mobile data connection will be terminated if no data is transferred during the timeout period specified in this field</td>
     </tr>
     </tr>
Line 125: Line 125:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable</td>
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles Force LTE network ON or OF</td>
       <td>Toggles Force LTE network ON or OF</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Reregister</td>
       <td>Reregister</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>When enabled the modem will reregister before trying to connect to an LTE network</td>
       <td>When enabled the modem will reregister before trying to connect to an LTE network</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Timeout (sec)</td>
     <td>Timeout (sec)</td>
         <td>integer [180..3600]; Default: '''300'''</td>
         <td>integer [180..3600]; default: <b>300</b></td>
         <td>Time in seconds between attempts to connect to an LTE network</td>
         <td>Time in seconds between attempts to connect to an LTE network</td>
     </tr>
     </tr>
Line 154: Line 154:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>DHCP mode</td>
       <td>DHCP mode</td>
       <td>Static | Dynamic | No DHCP; Default: '''Static'''</td>
       <td>Static | Dynamic | No DHCP; default: <b>Static</b></td>
       <td>Specifies DHCP mode used with Passthrough mode
       <td>Specifies DHCP mode used with Passthrough mode
'''Static''' mode requires that you enter your computer’s MAC address (xx:xx:xx:xx:xx:xx) and select a lease time (expiration time for the leased address). The device will get an IP address from your GSM operator. Other devices that are connected to the router will get IP addresses from the router’s DHCP server, but they will not have internet access.  
'''Static''' mode requires that you enter your computer’s MAC address (xx:xx:xx:xx:xx:xx) and select a lease time (expiration time for the leased address). The device will get an IP address from your GSM operator. Other devices that are connected to the router will get IP addresses from the router’s DHCP server, but they will not have internet access.  
Line 170: Line 170:
     <tr>
     <tr>
       <td>MAC address</td>
       <td>MAC address</td>
       <td>mac; Default: " "</td>
       <td>mac; default: <b>none</b></td>
       <td>MAC address of the device (e.g., computer)</td>
       <td>MAC address of the device (e.g., computer)</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Lease time</td>
     <td>Lease time</td>
         <td>time; Default: '''12h'''</td>
         <td>time; default: <b>12h</b></td>
         <td>The duration of an IP lease. Leased out addresses will expire after the amount of time specified in this field and the device that was using the lease will have to send a new DHCP request to the router's DHCP server. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes, e.g., if the lease time is 12 hours, then every 6 hours the device will send a request to the router asking to renew its lease.<br>
         <td>The duration of an IP lease. Leased out addresses will expire after the amount of time specified in this field and the device that was using the lease will have to send a new DHCP request to the router's DHCP server. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes, e.g., if the lease time is 12 hours, then every 6 hours the device will send a request to the router asking to renew its lease.<br>
Lease time can be set in hours or minutes. The minimal amount of time that can be specified is 2min</td>
Lease time can be set in hours or minutes. The minimal amount of time that can be specified is 2min</td>
Line 191: Line 191:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Bind to MAC</td>
       <td>Bind to MAC</td>
       <td>mac; Default: " "</td>
       <td>mac; default: <b>none</b></td>
       <td>Specifies the MAC address of the device that will work with the router in Bridge mode, i.e., the device whose MAC is specified in this field will be assigned the router's Mobile WAN IP address.</td>
       <td>Specifies the MAC address of the device that will work with the router in Bridge mode, i.e., the device whose MAC is specified in this field will be assigned the router's Mobile WAN IP address.</td>
     </tr>
     </tr>
Line 221: Line 221:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Primary SIM card</td>
       <td>Primary SIM card</td>
       <td>SIM1 | SIM2; Default: '''SIM1'''</td>
       <td>SIM1 | SIM2; default: <b>SIM1</b></td>
       <td>Specifies which SIM card is the primary one. The primary SIM card is the one the router uses by default, which means that after a reboot or a modem restart, the router will start using the primary SIM card even if secondary SIM cad was in use before</td>
       <td>Specifies which SIM card is the primary one. The primary SIM card is the one the router uses by default, which means that after a reboot or a modem restart, the router will start using the primary SIM card even if secondary SIM cad was in use before</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable automatic switching'''*'''</td>
       <td>Enable automatic switching<span class="asterisk">*</span></td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Enables SIM Switching rules</td>
       <td>Enables SIM Switching rules</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Check interval</td>
     <td>Check interval</td>
         <td>integer; Default: '''30'''</td>
         <td>integer; default: <b>30</b></td>
         <td>A time interval after which the router checks for condition changes corresponding to SIM switch rules. If such condition exist, the router will perform a SIM switch, if not - it will check for the same conditions again after the amount of time specified in this field</td>
         <td>A time interval after which the router checks for condition changes corresponding to SIM switch rules. If such condition exist, the router will perform a SIM switch, if not - it will check for the same conditions again after the amount of time specified in this field</td>
     </tr>
     </tr>
</table>
</table>
'''*Remember to check this field in order for your SIM Switching rules to work'''
<font size="-1"><span class="asterisk">*</span>Remember to check the <i>Enable automatic switching</i> field in order to make you SIM switching rules work</font>


===SIM switching scenarios===
===SIM switching scenarios===
Line 251: Line 251:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>On weak signal</td>
       <td>On weak signal</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Performs a SIM switch when signal strength falls below the specified threshold (next field)</td>
       <td>Performs a SIM switch when signal strength falls below the specified threshold (next field)</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Signal strength (dBm)</td>
       <td>Signal strength (dBm)</td>
       <td>integer; Default: " "</td>
       <td>integer; default: <b>none</b></td>
       <td>Specifies the signal strength threshold. If signal strength fall below this threshold, the router will perform a SIM switch</td>
       <td>Specifies the signal strength threshold. If signal strength fall below this threshold, the router will perform a SIM switch</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>On data limit</td>
     <td>On data limit</td>
         <td>yes | no; Default: '''no'''</td>
         <td>yes | no; default: <b>no</b></td>
         <td>Performs a SIM switch when the SIM card reaches the specified data limit for the designated period. Mobile Data Limit can be configured in the '''[[Mobile#Mobile_Data_Limit|Services → Mobile → Mobile Data Limit]]''' section</td>
         <td>Performs a SIM switch when the SIM card reaches the specified data limit for the designated period. Mobile Data Limit can be configured in the '''[[Mobile#Mobile_Data_Limit|Services → Mobile → Mobile Data Limit]]''' section</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>On SMS limit</td>
       <td>On SMS limit</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Performs a SIM switch when the SIM card reaches the specified SMS limit for the designated period (next three fields)</td>
       <td>Performs a SIM switch when the SIM card reaches the specified SMS limit for the designated period (next three fields)</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Period</td>
       <td>Period</td>
       <td>Month | Week | Day; Default: '''Month'''</td>
       <td>Month | Week | Day; default: <b>Month</b></td>
       <td>SMS limit period</td>
       <td>SMS limit period</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Start day | Start hour</td>
     <td>Start day | Start hour</td>
         <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; Default: '''day 1'''</td>
         <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; default: <b>day 1</b></td>
         <td>SMS limit counting start time. For example, if the selected Period is Month and Start day is 5, every month on the fifth day the SMS limit counter will reset and start counting the SMS limit over again</td>
         <td>SMS limit counting start time. For example, if the selected Period is Month and Start day is 5, every month on the fifth day the SMS limit counter will reset and start counting the SMS limit over again</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>SMS limit'''*'''</td>
     <td>SMS limit<span class="asterisk">*</span></</td>
         <td>integer; Default: " "</td>
         <td>integer; default: <b>none</b></td>
         <td>Specifies the SMS limit after which the router will perform a SIM switch </td>
         <td>Specifies the SMS limit after which the router will perform a SIM switch </td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>On roaming</td>
       <td>On roaming</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Performs a SIM switch when roaming is detected (when the SIM card connects to foreign operators)</td>
       <td>Performs a SIM switch when roaming is detected (when the SIM card connects to foreign operators)</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>No network</td>
     <td>No network</td>
         <td>yes | no; Default: '''no'''</td>
         <td>yes | no; default: <b>no</b></td>
         <td>Performs a SIM switch when no operator is detected</td>
         <td>Performs a SIM switch when no operator is detected</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>On network denied</td>
       <td>On network denied</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Performs a SIM switch when access to a network is denied (usually by an operator)</td>
       <td>Performs a SIM switch when access to a network is denied (usually by an operator)</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>On data connection fail</td>
     <td>On data connection fail</td>
         <td>yes | no; Default: '''no'''</td>
         <td>yes | no; default: <b>no</b></td>
         <td>Performs a SIM switch when access to a network is denied (usually by an operator)</td>
         <td>Performs a SIM switch when access to a network is denied (usually by an operator)</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Method</td>
     <td>Method</td>
         <td>LCP echo | ICMP echo; Default: '''LCP echo'''</td>
         <td>LCP echo | ICMP echo; default: <b>LCP echo</b></td>
         <td>The method used to identify a connection failure </td>
         <td>The method used to identify a connection failure </td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Health monitor ICMP host(s)</td>
       <td>Health monitor ICMP host(s)</td>
       <td>ip | hostname; Default: '''8.8.8.8'''</td>
       <td>ip | hostname; default: <b>8.8.8.8</b></td>
       <td>A remote host to ping (send an ICMP (Internet Control Message Protocol) packet to) and determine when the connection goes down. Choose a host that is always reachable through WAN (Wide Area Network) and is rarely down, for example, Google's DNS (8.8.8.8)</td>
       <td>A remote host to ping (send an ICMP (Internet Control Message Protocol) packet to) and determine when the connection goes down. Choose a host that is always reachable through WAN (Wide Area Network) and is rarely down, for example, Google's DNS (8.8.8.8)</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Health monitor ICMP timeout</td>
       <td>Health monitor ICMP timeout</td>
       <td>1 sec. | 2 sec. | 3 sec. | 4 sec. | 5 sec. | 10 sec.; Default: '''3 sec.'''</td>
       <td>1 sec. | 2 sec. | 3 sec. | 4 sec. | 5 sec. | 10 sec.; default: <b>3 sec.</b></td>
       <td>The timeout value for ICMP packets, i.e., how frequently ICMP packets will be sent to the specified host</td>
       <td>The timeout value for ICMP packets, i.e., how frequently ICMP packets will be sent to the specified host</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Attempts before SIM failover</td>
     <td>Attempts before SIM failover</td>
         <td>1 | 3 | 5 | 10 | 15 | 20; Default: '''3'''</td>
         <td>1 | 3 | 5 | 10 | 15 | 20; default: <b>3</b></td>
         <td>Failed ping attempts' count before switching to the secondary SIM card. For example, if '''3''' is chosen, the router will perform a SIM switch after three unsuccessful ping attempts to the specified host</td>
         <td>Failed ping attempts' count before switching to the secondary SIM card. For example, if '''3''' is chosen, the router will perform a SIM switch after three unsuccessful ping attempts to the specified host</td>
     </tr>
     </tr>
</table>
</table>
'''*Your carrier's data and SMS usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur'''
<font size="-1"><span class="asterisk">*</span>Your carrier's data and SMS usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur</font>


===Switch back to primary SIM===
===Switch back to primary SIM===
Line 341: Line 341:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Switch back to primary SIM card after timeout</td>
       <td>Switch back to primary SIM card after timeout</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Performs a SIM switch back to the primary SIM card after a specified amount of time</td>
       <td>Performs a SIM switch back to the primary SIM card after a specified amount of time</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Initial timeout (min)</td>
       <td>Initial timeout (min)</td>
       <td>integer; Default: '''1'''</td>
       <td>integer; default: <b>1</b></td>
       <td>The amount of time after which the router will attempt to switch back to using the primary SIM card</td>
       <td>The amount of time after which the router will attempt to switch back to using the primary SIM card</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Subsequent timeout (min)</td>
     <td>Subsequent timeout (min)</td>
         <td>integer; Default: '''0'''</td>
         <td>integer; default: <b>0</b></td>
         <td>A subsequent timeout value added to Initial timeout if the previous attempt to switch back to primary SIM failed. This value is increased every time an unsuccessful switch-back is made:
         <td>A subsequent timeout value added to Initial timeout if the previous attempt to switch back to primary SIM failed. This value is increased every time an unsuccessful switch-back is made:
'''new_timeout = old_timeout + subsequent_timeout'''
'''new_timeout = old_timeout + subsequent_timeout'''
Line 395: Line 395:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable</td>
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles Operators List ON or OFF</td>
       <td>Toggles Operators List ON or OFF</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Mode</td>
       <td>Mode</td>
       <td>Blacklist | White list; Default: '''Blacklist'''</td>
       <td>Blacklist | White list; default: <b>Blacklist</b></td>
       <td>The type of list
       <td>The type of list
'''Blacklist''' - operators residing in the blacklist will considered forbidden and your router will not attempt to connect to them even if they are available
'''Blacklist''' - operators residing in the blacklist will considered forbidden and your router will not attempt to connect to them even if they are available
Line 414: Line 414:
     <tr>
     <tr>
     <td>Name</td>
     <td>Name</td>
         <td>string; Default: " "</td>
         <td>string; default: <b>none</b></td>
         <td>Operator's name. Used only for easier management purposes</td>
         <td>Operator's name. Used only for easier management purposes</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Operator code</td>
     <td>Operator code</td>
         <td>integer; Default: " "</td>
         <td>integer; default: <b>none</b></td>
         <td>Operator's code. You can find network operator codes online or use the router's Scan for operators function described [[#Scan_for_network_operators|here]]</td>
         <td>Operator's code. You can find network operator codes online or use the router's Scan for operators function described [[#Scan_for_network_operators|here]]</td>
     </tr>
     </tr>
Line 427: Line 427:
==Mobile Data Limit==
==Mobile Data Limit==


The '''Mobile Data Limit''' window provides you with the possibility to set data limits for your SIM cards and data limit warnings via SMS message in order to protect yourself from unwanted data charges.
The <b>Mobile Data Limit</b> page provides you with the possibility to set data limits for your SIM cards and data usage warnings via SMS message in order to protect yourself from unwanted data charges.


===Data Connection Limit Configuration===
===Data Connection Limit Configuration===
----
----
The '''Data Connection Limit Configuration''' section is used to configure custom mobile data limits for your SIM cards.
The <b>Data Connection Limit Configuration</b> section is used to configure custom mobile data limits for your SIM card(s). When the mobile data limit set for the SIM card(s) is reached, the router will no longer use the mobile connection to establish data until the limit period is over or the limit is reset by the user.


[[File:Network mobile datalimit configuration v2.PNG]]
[[File:Network mobile datalimit configuration v2.PNG]]
Line 437: Line 437:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable data connection limit</td>
       <td>Enable data connection limit</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles data limit ON or OFF </td>
       <td>Turns mobile data limitations on or off.</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Data limit* (MB)</td>
       <td>Data limit<span class="asterisk">*</span> (MB)</td>
       <td>integer; Default: " "</td>
       <td>integer; default: <b>none</b></td>
       <td>The received data limit. After reaching the specified data limit, the router will kill your current mobile data connection<br>
       <td>The ammount of data that is allowed to be downloaded over the specified period of time. When the limit is reached, the router will no longer be able to establish a data connection until the period is over or data limit is reset.<br><b>Note</b>: after the router has reached the data limit it will not switch to using the secondary SIM card. If you wish to configure a SIM switch system based on received data limit, instructions can be found in the [[#SIM_Switching_rules|SIM Switching rules]] section of this page.</td>
'''NOTE:''' After the router has reached the specified data limit it will not switch to the secondary SIM card, it will only kill the current connection. Directions on how to configure a SIM switch based on data limit can be found in the [[#SIM_Switching_rules|SIM Switching rules]] section of this chapter</td>
    </tr>
     <tr>
     <tr>
     <td>Period</td>
     <td>Period</td>
         <td>Month | Week | Day; Default: '''Month'''</td>
         <td>Month | Week | Day; default: <b>Month</b></td>
         <td>Period for which the data limit applies to</td>
         <td>Data limit period after which the data counter is reset on the specified <i>Start day</i>.</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Start day | Start hour</td>
     <td>Start day | Start hour</td>
         <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; Default: '''day 1'''</td>
         <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; default: <b>day 1</b></td>
        <td>Data limit counting start time. For example, if the selected Period is Month and Start day is 5, every month on the fifth day the data limit counter will reset and start counting the data limit over again</td>
      <td>Specifies when the period of counting data usage should begin. After the period is over, the limit ir reset and the count begins over again.</td>
     </tr>
     </tr>
</table>
</table>
'''*Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur'''
<font size="-1"><span class="asterisk">*</span>Your carrier's data usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.</font>


===SMS Warning Configuration===
===SMS Warning Configuration===
----
----
In the '''SMS Warning Configuration''' section you can configure a rule that sends you an SMS message after the router reaches a specified amount of data.
The <b>SMS Warning Configuration</b> section provides you with the possibility to configure a rule that sends you an SMS message after the router's SIM card(s) uses a specified amount of mobile data.


[[File:Network mobile smswarning configuration v2.PNG]]
[[File:Network mobile smswarning configuration v2.PNG]]
Line 473: Line 471:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable SMS warning</td>
       <td>Enable SMS warning</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMS warning On or OFF</td>
       <td>Toggles SMS warning On or OFF</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Data limit* (MB)</td>
       <td>Data limit* (MB)</td>
       <td>integer; Default: " "</td>
       <td>integer; default: <b>none</b></td>
       <td>The received data limit. After reaching the specified data limit, the router will send out an SMS warning message to the specified phone number</td>
       <td>The received data limit. After reaching the specified data limit, the router will send out an SMS warning message to the specified phone number</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Period</td>
     <td>Period</td>
         <td>Month | Week | Day; Default: '''Month'''</td>
         <td>Month | Week | Day; default: <b>Month</b></td>
         <td>Period for which the data limit applies to</td>
         <td>Period for which the data limit applies to</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Start day | Start hour</td>
     <td>Start day | Start hour</td>
        <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; Default: '''day 1'''</td>
      <td>day of the month [1..31] | day of the week [Monday..Sunday] | hour of the day [1..24]; default: <b>1</b></td>
        <td>Data limit counting start time. For example, if the selected Period is Month and Start day is 5, every month on the fifth day the data limit counter will reset and start counting the data limit over again</td>
      <td>Specifies when the period of counting data usage should begin. After the period is over, the limit ir reset and the count begins over again.</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Phone number</td>
     <td>Phone number</td>
         <td>phone number; Default: " "</td>
         <td>phone number; default: <b>none</b></td>
         <td>Recipient's phone number</td>
         <td>Recipient's phone number</td>
     </tr>
     </tr>
Line 506: Line 504:
===Clear Data Limit===
===Clear Data Limit===
----
----
The Clear Data Limit section contains only one button - the '''Clear data limit''' button, which resets the counter for the configured data limit (i.e., the router begins counting the data from 0 after this button is clicked).
The <b>Clear Data Limit</b> section contains only one button - 'Clear data limit'. When clicked, the button resets the data limit counter for the related SIM card. Thus, the count is started over again regardless of the specified period.


[[File:Network mobile clear datalimit v2.PNG]]
[[File:Network mobile clear datalimit v2.PNG]]


'''Remember that the Clear data limit button doesn't clear the actual used data statistics for the SIM card, only the received data counters of the limit guard data counter!'''
<b>Important</b>: remember that the 'Clear data limit' button doesn't clear the actual data usage statistics for the SIM card, only the data counters as calculated by the router.
 
==SMS Limit==
 
The <b>SMS Limit</b> page provides you with the possibility to set up a limit of SMS messages that each of the router's SIM cards can send in period of one day, week or a month.
 
===SMS Limit Configuration===
----
The <b>SMS Limit Configuration</b> section is used to configure custom SMS limits for your SIM card(s). In order to limit sent SMS messages, select the SIM card (SIM1 or SIM2), enable SMS limit and configure the limit conditions. For related information, refer to the figure and table below.
 
[[File:Networking_rutxxx_manual_mobile_sms_limit_configuration_v1.png]]
 
<table class="nd-mantable">
    <tr>
        <th>Field</th>
      <th>Value</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>Enable SMS limit</td>
      <td>yes | no; default: <b>no</b></td>
      <td>Turns SMS limitations on or off.</td>
    </tr>
    <tr>
      <td>Period</td>
      <td>Month | Week | Day; default: <b>Month</b></td>
      <td>SMS limit period after which the sent SMS counter is reset on the specified <i>Start day</i>.</td>
    </tr>
    <tr>
      <td>Start day | Start hour</td>
      <td>day of the month [1..31] | day of the week [Monday..Sunday] | hour of the day [1..24]; default: <b>1</b></td>
      <td>Specifies when the period of counting SMS messages should begin. After the period is over, the limit ir reset and the count begins over again.</td>
    </tr>
    <tr>
      <td>SMS limit<span class="asterisk">*</span></td>
      <td>integer; default: <b>none</b></td>
      <td>Number of SMS messages that the is allowed to be sent over the specified period of time. When the limit is reached, the router will no longer be able to send SMS messages until the period is over or SMS limit is reset.<br><b>Note</b>: after the router has reached the SMS limit it will not switch to using the secondary SIM card. If you wish to configure a SIM switch system based on sent SMS limit, instructions can be found in the [[#SIM_Switching_rules|SIM Switching rules]] section of this page.</td>
    </tr>
</table>
<font size="-1"><span class="asterisk">*</span> Your carrier's SMS usage accounting may differ. Teltonika is not liable should any accounting discrepancies occur.</font>
 
===Clear SMS Limit===
----
The <b>Clear SMS Limit</b> section displays the ammount of sent SMS messages and provides the possibility to reset that counter. When the 'Clear SMS button' is clicked, it clears the SMS limit counter for the related SIM card. Thus, the count is started over again regardless of the specified period.
 
[[File:Networking_rutxxx_manual_mobile_sms_limit_clear_v1.png]]
 
<b>Important</b>: remember that the 'Clear SMS limit' button doesn't clear the actual sent SMS statistics for the SIM card, only the SMS counters as calculated by the router.


==SIM Idle Protection==
==SIM Idle Protection==
Line 524: Line 569:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Enable</td>
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
       <td>yes | no; default: <b>no</b></td>
       <td>Toggless SIM Idle Protection ON or OFF</td>
       <td>Toggless SIM Idle Protection ON or OFF</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Period</td>
       <td>Period</td>
       <td>Month | Week; Default: '''Month'''</td>
       <td>Month | Week; default: <b>Month</b></td>
       <td>Period after which a SIM switch will occur</td>
       <td>Period after which a SIM switch will occur</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Day</td>
     <td>Day</td>
         <td>day [1..31] | day [Monday..Sunday]; Default: '''day 1'''</td>
         <td>day [1..31] | day [Monday..Sunday]; default: <b>day 1</b></td>
         <td>Day of the month or week when the SIM switch will occur</td>
         <td>Day of the month or week when the SIM switch will occur</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Hour</td>
     <td>Hour</td>
         <td>hour [1..24]; Default: '''1'''</td>
         <td>hour [1..24]; default: <b>1</b></td>
         <td>Hour of the day when the SIM switch will occur</td>
         <td>Hour of the day when the SIM switch will occur</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Minute</td>
       <td>Minute</td>
       <td>minute [0..59]; Default: '''1'''</td>
       <td>minute [0..59]; default: <b>1</b></td>
       <td>Minute of the hour when the SIM switch will occur</td>
       <td>Minute of the hour when the SIM switch will occur</td>
     </tr>
     </tr>
     <tr>
     <tr>
       <td>Host to ping</td>
       <td>Host to ping</td>
       <td>ip; Default: '''127.0.0.1'''</td>
       <td>ip; default: <b>127.0.0.1</b></td>
       <td>When the SIM switch occurs, the router will ping a host specified in this field</td>
       <td>When the SIM switch occurs, the router will ping a host specified in this field</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Ping package size</td>
     <td>Ping package size</td>
         <td> integer [1..100]; Default: '''56'''</td>
         <td> integer [1..100]; default: <b>56</b></td>
         <td> Size (in bytes) of the package that will be sent</td>
         <td> Size (in bytes) of the package that will be sent</td>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>Ping requests</td>
     <td>Ping requests</td>
         <td>integer [1..30]; Default: '''2'''</td>
         <td>integer [1..30]; default: <b>2</b></td>
         <td>How many ping packets will be sent</td>
         <td>How many ping packets will be sent</td>
     </tr>
     </tr>
Line 594: Line 639:
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>Field</th>
       <th>value</th>
       <th>Value</th>
       <th>description</th>
       <th>Description</th>
     </tr>
     </tr>
     <tr>
     <tr>
     <td>APN</td>
     <td>APN</td>
         <td>string; Default: " "</td>
         <td>string; default: <b>none</b></td>
         <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require to enter the APN just to complete the registration to a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract. <br> '''NOTE''': an APN Network Identifier cannot start with any of the following strings: "rac", "lac", "sgsn" or "rnc"; it cannot end in ".gprs" and it cannot take the value "*"</td>
         <td>An Access Point Name (APN) is a gateway between a GSM, GPRS, 3G or 4G mobile network and another computer network. Depending on the contract, some operators may require to enter the APN just to complete the registration to a network. In other cases, APN is used to get special parameters from the operator (e.g., a [[Private_and_Public_IP_Addresses#Public_IP_address|public IP address]]) depending on the contract. <br> '''NOTE''': an APN Network Identifier cannot start with any of the following strings: "rac", "lac", "sgsn" or "rnc"; it cannot end in ".gprs" and it cannot take the value "*"</td>
     </tr>
     </tr>