Editing Template:Networking rut2xx manual mobile

==Summary==

The <b>Mobile</b> page is used for setting parameters related to the mobile data connection. This page is an overview of the Mobile section for {{{name}}} routers.

{{Template: Networking_rutxxx_manual_fw_disclosure
| fw_version = {{{fw_version}}}
}}
==General==
The <b>General</b> section is used to configure the SIM card parameters that define how the router establishes a cellular connection.

===Mobile Configuration===
----
The <b>Mobile Configuration</b> section is used to configure main SIM card parameters. Refer to the figure and table below for information on the fields contained in that section.

[[File:Networking rut2xx manual mobile general mobile configuration v2.png|border|class=tlt-border]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>Connection type</td>
       	<td>QMI | PPP; default: <b>QMI</b></td>
       	<td>How the router's modem will establish a connection to the carrier.
            <ul>
                <li><b>PPP</b> - uses a dialling number to establish a data connection.</li>
                <li><b>QMI</b> - does not use a dialling number to connect and is usually faster than PPP.</li>
            </ul>
        </td>
    </tr>
    <tr>
      	<td>Mode</td>
       	<td>NAT | Passthrough<span class="asterisk">*</span>{{#ifeq:{{{3g}}}|0| | Bridge <span class="asterisk">**</span>}}; default: <b>NAT</b></td>
       	<td>Mobile connection operating mode.
            <ul>
                <li><b>NAT</b> - the mobile connection uses NAT (network address translation).</li>
                <li><b>Bridge</b> - bridges the LTE data connection with LAN. In this mode the router relay the IP address received from the ISP to another LAN device (e.g., computer). Using Bridge mode will disable most of the router’s capabilities.</li>
                <li><b>Passthrough</b> - works in a similar fashion to Bridge mode, except in Passthrough mode the router will have an Internet connection and be reachable from LAN, because the router's DHCP Server is not disabled.</li>
            </ul>
        </td>
    </tr>
    <tr>
    	<td>APN</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 you to use an APN just to complete the registration on 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>An APN Network Identifier cannot start with any of the following strings:
            <ul>
                <li>rac;</li>
                <li>lac;</li>
                <li>sgsn;</li>
                <li>rnc;</li>
            </ul>it cannot end in:
            <ul>
                <li>.gprs;</li>
            </ul>and it cannot contain the asterisk symbol (<b>*</b>).
        </td>
    </tr>
    <tr>
    	<td>Auto</td>
        <td>yes | no; default: <b>yes</b></td>
        <td>Select APN automatically</td>
    </tr>
    <tr>
    	<td>PIN number</td>
        <td>string; default: <b>none</b></td>
        <td>A 4-12 digit long numeric password used to authenticate the modem to the SIM card.</td>
    </tr>
    <tr>
      	<td>Dialing number</td>
       	<td>string; default: <b>none</b></td>
       	<td>A [[Dial Codes|dial code]] used to establish a mobile PPP connection.</td>
    </tr>
    <tr>
      	<td>MTU</td>
       	<td>integer [0..1500]; default: <b>1500</b></td>
       	<td>Sets the maximum transmission unit (MTU) size. It is the largest size of a protocol data unit (PDU) that can be transmitted in a single network layer transaction.</td>
    </tr>
    <tr>
    	<td>Authentication method</td>
        <td>CHAP | PAP | None; default: <b>None</b></td>
        <td>Authentication method that your GSM carrier uses to authenticate new connections on its network. If you select PAP or CHAP, you will also be required to enter a username and password.</td>
    </tr>
    <tr>
      	<td>Service mode</td>
       	<td>2G only | 3G only {{#ifeq:{{{3g}}}|0||> 4G (LTE) only |2G + 3G| 2G + 4G| 3G + 4G |}} | 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. For example, 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>
    	<td>Deny data roaming</td>
        <td>yes | no; default: <b>no</b></td>
        <td>When enabled, this option prevents the device from establishing a mobile data connection while not in your home network (roaming conditions).</td>
    </tr></table>
<font size="-1"><span class="asterisk">*</span> more on Passthrough mode in [[#Passthrough_mode|section {{#ifeq:{{{3g}}}|0|2.5|2.3}}]] of this page.</font><br>
{{#ifeq:{{{3g}}}|0|<font size="-1"><span class="asterisk">**</span> more on Bridge mode in [[#Bridge_mode|section {{#ifeq:{{{3g}}}|0|2.6|2.4}}]] of this page.</font>|}}

===Mobile data on demand===
----
The <b>mobile data on demand</b> function keeps the mobile data connection <i>on</i> only when it is in use. When the router detects that there is no traffic, it shuts down the mobile data connection and turns it back <i>on</i> only when there is a "Demand" (a user trying to reach a website, for example). Refer to the figure and table below for more information.

[[File:{{{file_general_demand}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>Enable</td>
       	<td>yes | no; default: <b>no</b></td>
       	<td>Turns mobile data on demand on or off<br><b>Important</b>: this function is only available with PPP Connection type.</td>
    </tr>
    <tr>
      	<td>No data timeout (sec)</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>
    </tr>
</table>
{{#ifeq:{{{3g}}}|0|{{Template:Networking_rut9xx_manual_mobile_bands|file_general_bands={{{file_general_bands}}}|name={{{name}}}}}|}}
{{#ifeq:{{{3g}}}|0|{{Template:Networking_rut9xx_manual_mobile_force_lte|file_general_force_lte={{{file_general_force_lte}}}}}|}}
===Passthrough mode===
----
In <b>Passthrough</b> mode the router assigns its mobile WAN IP address to another device. It is similar to <i>Bridge</i> mode, except in Passthrough mode other devices can still connect to the router and get LAN IP addresses and both other clients and the router retain Internet access, while Bridge mode also disables the router's DHCP Server.

To begin configuring Passthrough mode, make sure that WAN failover is turned off and mobile is set as main WAN in the <i>Network → [[{{{name}}} WAN|WAN]]</i> page. Then in the <i>Network → Mobile</i> page select <i>Mode: Passthrough</i> in the mobile configuration section. You will then see additional configuration fields appear at the bottom of the section.

<b>Important</b>: using Passthrough mode will disable most of the router’s other capabilities.

[[File:{{{file_passthrough}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>DHCP mode</td>
       	<td>Static | Dynamic | No DHCP; default: <b>Static</b></td>
       	<td>Specifies DHCP mode used with Passthrough.
            <ul>
                <li><b>Static</b> - manually binds the WAN IP address to the device with the specified MAC address. This 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.</li>
                <li><b>Dynamic</b> - the GSM operator will connect to the router first and give out an IP address to one of your connected devices. The device will be selected at random. Therefore, you should usually use Dynamic mode when you have only one device (e.g., computer) connected to the router. When using Passthrough in Dynamic mode, the router‘s LAN DHCP server will be disabled, but it will enabled again automatically when you switch to a different mode.</li>
                <li><b>No DHCP</b> - IP address, subnet mask, default gateway and DNS information from the GSM operator will have to be entered on your computer manually. When using Passthrough in No DHCP mode, the router‘s LAN DHCP server will be disabled, but it will become enabled automatically when you switch to a different mode.</li>
            </ul>
        </td>
    </tr>
    <tr>
      	<td>MAC address</td>
       	<td>mac; default: <b>none</b></td>
       	<td>MAC address of a LAN device (e.g., computer).</td>
    </tr>
    <tr>
      	<td>Lease time</td>
       	<td>integer; default: <b>2 min</b></td>
       	<td>A DHCP lease will expire after the amount of time specified in this field and the device that was using the lease will have to request a new one. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes (e.g., if lease time is 12 hours, then every 6 hours the device will ask the DHCP server to renew its lease).<br>The minimum amount of time that can be specified is 2 minutes.</td>
    </tr>
</table>
{{#ifeq:{{{3g}}}|0|{{Template:Networking_rut2xx_manual_mobile_bridge_mode|name={{{name}}}|file_bridge={{{file_bridge}}}}}|}}

==Network Operators==

The <b>Network Operators</b> tab provides you with the possibility to scan for and manually manage mobile network opertors to which the router's SIM card can connect to. Operator selection is only available for the primary SIM card. In order to specify an operator for the other SIM card it must first be selected as the primary SIM in the [[#SIM_Management|SIM Management]] section.

===Scan For Network Operators===
----
<b>Scan For Network Operators</b> is a function that initiates a scan for mobile network operators available in your area. To initiate a scan, press the 'Scan for operators' button. After you do, you will be prompted with a pop-up asking if you wish to proceed. This is because while the scan is in progress you will lose your data connection for approximately 2 minutes.

[[File:{{{file_network_operators_scan}}}]]

After the scan is complete you will be presented with a list of operators available in your area. The list provides such information as operator's name, code and network access type. You can also choose to which operator you would like to connect provided that the operator's status is not <i>Forbidden</i>.
----
Below the list you can select how to the router should connect to network operators:

[[File:{{{file_network_operators_settings}}}]]

The 'Reconnect interval' box specifies how often the device will attempt to reconnect to a network operator, while the 'Connection mode' specifies the logic of how the router will connect operators:

<ul>
    <li><b>Auto</b> - the router automatically connects to the network operator that provides the best connectivity.</li>
    <li><b>Manual</b> - prompts you to enter an operator's code<span class="asterisk">*</span>. The router will then only attempt to connect to the operator whose code was specified (even if previous attempts have been unsuccessful).</li>
    <li><b>Manual-Auto</b> - prompts you to enter an operator's code<span class="asterisk">*</span> but if the router can't complete the connection, it will automatically connect to the next available operator.</li>
</ul>

<font size="-1"><span class="asterisk">*</span> Most network operators' codes can be found online or you can initiate a scan for operators - if the operator you're looking for can be reached from your current area, the list of available network operators will contain the desired operator's code.</font>

===Operators List===
----
The <b>Operators List</b> section is used for creating a blacklist or whitelist for undesired or desired operators. 
<br><br>
<b>Settings</b><br>
[[File:{{{file_operator_list_settings}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>Enable</td>
       	<td>yes | no; default: <b>no</b></td>
        <td>Turns operator list on or off.</td>
    </tr>
    <tr>
      	<td>Mode</td>
       	<td>Blacklist | Whitelist; default: <b>Whitelist</b></td>
       	<td>Defines how operators will be filtered.
            <ul>
                <li><b>Blacklist</b> - operators contained in the blacklist are considered forbidden and your router will not attempt to connect to them even if they are available.</li>
                <li><b>Whitelist</b> - operators contained in the whitelist will be the only operators that the router will be trying to connect to. Other operators that are not in the whitelist will be considered forbidden.</li>
            </ul>
        </td>
    </tr>
</table>
<br>
<b>Operators List</b><br>
[[File:{{{file_operator_list}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
    	<td>Name</td>
        <td>string; default: <b>none</b></td>
        <td>Operator's name. Used only for easier management purposes and not in the actual filtering process.</td>
    </tr>
    <tr>
    	<td>Operator code</td>
        <td>integer; default: <b>none</b></td>
        <td>Operator's code used to identify a network operator. You can find network operator codes online or use the router's scan for operators function described [[#Scan_for_network_operators|here]].</td>
    </tr>
</table>
<br>
<b>Important</b>: be mindful when using the Operators List function as it very easy to block yourself from the right operators and lose your data connection.

==Mobile Data Limit==

The <b>Mobile Data Limit</b> page provides you with the possibility to set data usage 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===
----
The <b>Data Connection Limit Configuration</b> section is used to configure custom mobile data limits for your SIM card. When the mobile data limit set for the SIM card is reached, the router will no longer use the mobile connection to establish a data connection until the limit period is over or the limit is reset by the user.

[[File:{{{file_data_limit_configuration}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>Enable data connection limit</td>
       	<td>yes | no; default: <b>no</b></td>
       	<td>Turns mobile data limitations on or off.</td>
    </tr>
    <tr>
      	<td>Data limit<span class="asterisk">*</span> (MB)</td>
       	<td>integer; default: <b>none</b></td>
       	<td>The amount 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 the data limit is reset.</td>
    <tr>
    	<td>Period</td>
        <td>Month | Week | Day; default: <b>Month</b></td>
        <td>Data limit period after which the data counter is reset on the specified <i>Start day</i>.</td>
    </tr>
    <tr>
    	<td>Start day | Start hour</td>
        <td>day [1..31] | day [Monday..Sunday] | hour [1..24]; default: <b>day 1</b></td>
       	<td>Specifies when the period of counting data usage should begin. After the period is over, the limit is reset and the count begins over again.</td>
    </tr>
</table>
<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===
----
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 uses a specified amount of mobile data.

[[File:{{{file_data_limit_warning}}}]]

<table class="nd-mantable">
    <tr>
        <th>Field</th>
       	<th>Value</th>
       	<th>Description</th>
    </tr>
    <tr>
      	<td>Enable SMS warning</td>
       	<td>yes | no; default: <b>no</b></td>
       	<td>Toggles SMS warning On or OFF</td>
    </tr>
    <tr>
      	<td>Data limit* (MB)</td>
       	<td>integer; default: <b>none</b></td>
       	<td>The received data limit before sending an SMS warning. After reaching using the the amount of data specified in this field, the router will send an SMS warning message to the specified phone number.</td>
    </tr>
    <tr>
    	<td>Period</td>
        <td>Month | Week | Day; default: <b>Month</b></td>
        <td>Period to which the data limit applies to.</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 data usage should begin. After the period is over, the limit is reset and the count begins over again.</td>
    </tr>
    <tr>
    	<td>Phone number</td>
        <td>phone number; default: <b>none</b></td>
        <td>Recipient's phone numbers</td>
    </tr>
</table>

===Clear Data Limit===
----
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:{{{file_data_limit_clear}}}]]

<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 the router's SIM card can send in a 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. In order to limit sent SMS messages, enable SMS limit and configure the limit conditions. For related information, refer to the figure and table below.

[[File:{{{file_sms_limit_config}}}]]

<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 is 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 SIM card is allowed to send 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 the SMS limit is reset.</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 amount 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:{{{file_sms_limit_clear}}}]]

<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.
-->
[[Category:{{{name}}} Network section]]