Difference between revisions of "Template:Networking rutos manual mobile utilities"

From Teltonika Networks Wiki
(124 intermediate revisions by 13 users not shown)
Line 1: Line 1:
−
{{Template: Networking_device_manual_fw_disclosure
+
{{Template:Networking_rutos_manual_fw_disclosure
 +
| fw_version = {{{series}}}_R_00.02.03.1
 
| series = {{{series}}}
 
| series = {{{series}}}
−
| name  = {{{name}}}
 
−
| fw_version ={{Template: Networking_device_manual_latest_fw
 
−
| series = {{{series}}}
 
−
| name  = {{{name}}}
 
−
}}
 
 
}}
 
}}
−
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} SMS Utilities (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
 
−
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} SMS Utilities (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
 
 
==Summary==
 
==Summary==
  
−
The <b>Mobile Utilities</b> page is used to configure various SMS{{#switch:{{{name}}}| TRB255 | TRB256= | #default=&nbsp;and Call}} related device control options and to read, send and manage SMS messages and SMS storage space.
+
{{{name}}} routers have an extensive amount of various SMS control utilities. SMS Utilities can be used to set/get
 +
configurations, monitor and issue commands to the router.
  
−
This manual page provides an overview of the Mobile Utilities page in {{{name}}} devices.
+
==SMS Utilities==
 +
 
 +
===Default Rules===
 +
----
 +
The SMS Utilities section contains a list of rules that perform certain actions when they are activated by SMS messages.
 +
 
 +
[[Image:Networking_rutx_manual_mobile_utilities_sms_rules_v1.png]]
 +
 
 +
The entire list contains  more than 20 rules but you are also be provided with the possibility to configure custom ones or edit the
 +
existing rules.
 +
 
 +
All default configuration options are listed below:
 +
 
 +
<li>Reboot</li>
 +
<li>Send_status</li>
 +
{{#ifeq:{{{name}}}|RUTXR1||
 +
<li>I/O set</li>
 +
<li>I/O status</li>
 +
}}
 +
{{#ifeq:{{{wifi}}}|1|
 +
<li>Wifi(on) </li>
 +
<li>Wifi(off) </li>
 +
}}
 +
<li>Mobile (on)</li>
 +
<li>Mobile (off)</li>
 +
<li>SSH_access (on)</li>
 +
<li>SSH_access (off)</li>
 +
<li>Web_access (on)</li>
 +
<li>Web_access (off)</li>
 +
<li>Firstboot</li>
 +
{{#ifeq:{{{name}}}|TRB14X||
 +
<li>Switch SIM</li>
 +
}}
 +
{{#ifeq:{{{gps}}}|1|
 +
<li>GPS coordinates</li>
 +
<li>GPS (off)</li>
 +
<li>GPS (on)</li>
 +
}}
 +
<li>Fw_upgrade</li>
 +
<li>RMS status</li>
 +
<li>Rms connect</li>
 +
<li>Rms action (on)</li>
 +
<li>Rms action (off)</li>
 +
<li>Monitoring status</li>
 +
<li>More</li>
  
−
==SMS Utilities==
+
===Execution===
 +
----
 +
To execute a rule, just send an SMS message to the router‘s SIM card number with the rule's SMS Text, e.g., if you send
 +
a message with the text '''“reboot”''', the router will reboot if the selected Authorization method is '''“No
 +
authorization”'''. However, if there is an Authorization method present you will need to include the '''“Authorization
 +
key”''' in the text message. This '''“Authorization key”''' depends on the chosen '''Authorization method''', i.e., if
 +
the method is '''“By serial”''', the '''“Authorization key”''' is the router’s serial number, if the method is '''“By
 +
router admin password”''', the '''“Authorization key”''' is the router’s admin password.
 +
 
 +
The '''"Authorization key”''' must precede the activation text and they must be separated by a space symbol. For
 +
example, if the chosen Authorization method is '''“By router admin password”''' and the password is '''“admin01”''', the
 +
entire message should look like this: '''“admin01 reboot”'''. The same applies to '''“By serial”''' authorization. By
 +
default authorization for SMS utilities are set "'''By router admin password".'''
 +
 
 +
===Rule Overview and editing===
 +
----
 +
Every default SMS rule can be edited to your liking. If none of the rules suit your purposes, just click the '''Edit'''
 +
button next to any SMS Utilities rules. This guide will contain information on editing every single SMS Utilities rule.
 +
===SMS rule General settings===
 +
----
 +
[[Image:Networking rutx manual mobile utilities reboot general settings v1.png|border| class=tlt-border|1102x1102px]]
 +
 
 +
===SMS rule Authorization settings===
 +
----
 +
[[Image:Networking trb manual mobile utilities reboot Authorization settings v1.png| border |class=tlt-border]]
  
−
The <b>SMS Utilities</b> section contains a list of rules that perform certain actions when they are activated by SMS messages.
+
Above is an example of what '''SMS Configuration''' '''General''' and '''Authorization''' settings windows looks like,
 +
specifically, '''SMS Configuration''' for the '''Reboot''' rule. Below is a table with detailed explanations on how to
 +
configure the rule and what each of the fields mean. To avoid redundancy, screenshots for the other rules will not be
 +
provided, since the structures, syntax and the overall look of the configuration windows for each rule are very similar.
 +
Instead, only tables containing information on how to edit each rule will be provided.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_sms_rules_v1.png|border|class=tlt-border]]
+
====Reboot====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
      <th>FIELD NAME</th>
 +
  <th>DESCRIPTION</th>
 +
    <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable SMS reboot function</td>
 +
        <td>Allows router to restart via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Reboots the router</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter</td>
 +
</tr>
 +
<tr>
 +
        <td>Get status via SMS after reboot</td>
 +
        <td>Check this to receive connection status via SMS after the reboot</td>
 +
        <td>If enabled, the router will send a status message once it has rebooted and is operational again. This is
 +
            both a separate SMS Rule and an option under the SMS Reboot rule</td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Gateway modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Message text</td>
 +
        <td>Which status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available
 +
        </td>
 +
        <td>You can select which status elements to display</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
The entire list contains more than 20 rules, but it does not include all possible SMS actions. You can also create custom rules or modify existing rules. All possible SMS rule actions, their default SMS texts and descriptions are listed in the table below.
+
====Send status====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
    <th>FIELD NAME</th>
 +
    <th>DESCRIPTION</th>
 +
    <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable SMS status function</td>
 +
        <td>Allows you to get the router‘s status via SMS. This is both a separate SMS Rule and an option under the SMS
 +
            Reboot rule</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Returns an SMS message containing information about the status of the router. The type of information
 +
            contained within the message can be specified in the '''Message text''' field</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter</td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Gateway modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Message text</td>
 +
        <td>Which status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available
 +
        </td>
 +
        <td>You can select which status elements to display</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<table class="nd-othertables_2" style="width: 100%;">
+
====Switch mobile data ON/OFF====
−
    <tr>
+
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
         <th width=20%>Action</th>
+
  <tr>
−
         <th width=20%>SMS Text</th>
+
         <th>FIELD NAME</th>
−
         <th width=60%>Description</th>
+
         <th>DESCRIPTION</th>
−
    </tr>{{#ifeq: {{{io}}} | 1 |
+
         <th>EXPLANATION, NOTES</th>
−
    <tr>
+
</tr>
−
         <td><b>Change I/O state</b></td>
+
  <tr>
−
         <td><i>ioset</i></td>
+
         <td>Enable</td>
−
         <td>Changes the state of a selected output.</td>
+
        <td>This will enable or disable the Switch mobile data function</td>
−
    </tr>|}}
+
        <td>Allows mobile control via SMS</td>
−
    <tr>
+
</tr>
−
         <td><b>Change mobile settings</b></td>
+
  <tr>
−
         <td><i>cellular</i></td>
+
         <td>Action</td>
−
         <td>Is used to configure the device's mobile data connection. [[#Change_mobile_settings_.28cellular.29_rule|Click here]] for more information on this rule.</td>
+
        <td>The action to be performed when this rule is met</td>
−
    <tr>
+
         <td>Turn mobile data ON or OFF</td>
−
         <td><b>Change profile</b></td>
+
</tr>
−
         <td><i>no default text</i></td>
+
  <tr>
−
         <td>Is used to change profiles on the device. Include the name of the profile that you wish to change to after the rule's SMS text, for example if SMS text is set to <i>changeprof</i>:
+
         <td>State</td>
−
            <ul>
+
        <td>The state to which mobile data will be set when this rule is met.</td>
−
                <li><i>changeprof default</i></li>
+
         <td>If you set it as ON it will turn on mobile data if OFF it will turn it off.</td>
−
                <li><i>changeprof custom</i></li>
+
</tr>
−
            </ul>
+
<tr>
 +
        <td>SMS text</td>
 +
         <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter</td>
 +
</tr>
 +
<tr>
 +
         <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
         <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
         <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 
         </td>
 
         </td>
−
    </tr>
+
</table>
−
    <tr>
+
 
−
        <td><b>Execute custom script</b></td>
+
====SSH access control====
−
        <td><i>-</i></td>
+
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
        <td>Executes a custom shell script.</td>
+
<tr>
−
    </tr>
+
         <th>FIELD NAME</th>
−
    </tr>{{#ifeq: {{{dualsim}}} | 1 |{{#ifeq: {{{dualmodem}}} | 0 |
+
         <th>DESCRIPTION</th>
−
    <tr>
+
         <th>EXPLANATION, NOTES</th>
−
         <td><b>Force SIM switch</b></td>
+
</tr>
−
         <td><i>switch_sim</i></td>
+
<tr>
−
         <td>Switches from using one SIM card to another.</td>
+
         <td>Enable</td>
−
    </tr>|}}|}}
+
         <td>This will enable or disable the SSH access control function</td>
−
    <tr>
+
         <td>Allows SSH access control via SMS</td>
−
         <td><b>Reset moble connection</b></td>
+
</tr>
−
         <td><i>reset_conn</i></td>
+
<tr>
−
        <td>Resets mobile connection. Useful when you want to reconnect to the best available operator.</td>
+
         <td>Action</td>
−
    </tr>
+
         <td>The action to be performed when this rule is met</td>
−
    <tr>
+
         <td>Turns SSH access ON or OFF</td>
−
         <td><b>Reload config</b></td>
+
</tr>
−
        <td><i>config_reload</i></td>
+
<tr>
−
        <td>Reloads the config and all affected services.</td>
+
         <td>SMS text</td>
−
    </tr>
+
         <td>SMS text that will trigger the rule</td>
−
    <tr>
+
         <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
−
         <td><b>FW upgrade from server</b></td>
 
−
         <td><i>fw_upgrade</i></td>
 
−
        <td>Upgrades the device's firmware (provided a new version is available on the FOTA server).</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Get list of profiles</b></td>
 
−
        <td><i>profdisp</i></td>
 
−
        <td>Sends a list of configuration profiles existing on the device.</td>
 
−
    </tr>{{#ifeq: {{{gps}}} | 1 |
 
−
    <tr>
 
−
        <td><b>GPS control</b></td>
 
−
        <td><i>gpson</i></td>
 
−
         <td>Turns GPS on.</td>
 
−
    </tr>
 
−
    <tr>
 
−
         <td><b>GPS coordinates</b></td>
 
−
         <td><i>gps</i></td>
 
−
        <td>Sends the device's current GPS coordinates.</td>
 
−
    </tr>|}}
 
−
    <tr>
 
−
         <td><b>IP unblock</b></td>
 
−
        <td><i>ipunblock</i></td>
 
−
        <td>Unblocks Web/SSH access for devices that were blocked for too many unsuccessful connection attempts. Send the SMS text to unblock all blocked devices or include the IP address of a single blocked device after the SMS text. For example:
 
−
            <ul>
 
−
                <li><i>ipunblock</i> - clears the block list (unblocks Web/SSH access for all previously blocked devices).</li>
 
−
                <li><i>ipunblock 192.168.1.2</i> - removes this IP address from the block list (unblocks Web/SSH access for that device).</li>
 
−
            </ul>
 
 
         </td>
 
         </td>
−
    </tr>{{#ifeq: {{{io}}} | 1 |
+
</tr>
−
    <tr>
+
<tr>
−
         <td><b>I/O status</b></td>
+
         <td>Enable SSH access</td>
−
         <td><i>iostatus</i></td>
+
         <td>Enables or Disables SSH access from LAN</td>
−
         <td>Sends a status report message on the state of the device's inputs and outputs.</td>
+
         <td>If this is ON, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN</td>
−
    </tr>|}}
+
</tr>
−
    <tr>
+
<tr>
−
         <td><b>Manage OpenVPN</b></td>
+
         <td>Enable remote SSH access</td>
−
         <td><i>vpnon</i></td>
+
         <td>Enables or Disables SSH access from WAN</td>
−
         <td>Turns a selected OpenVPN instance on. Include the name of the OpenVPN instance that you wish to turn on after the rule's SMS text:
+
         <td>If this is ON, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN</td>
−
            <ul>
+
</tr>
−
                <li><i>vpnon client_name</i></li>
+
<tr>
−
                <li><i>vpnon server_name</i></li>
+
        <td>Authorization method</td>
−
            </ul>
+
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
         <td><b>Manage OpenVPN</b></td>
+
         <td>Allowed users</td>
−
         <td><i>vpnoff</i></td>
+
         <td>White list of allowed users</td>
−
         <td>Turns a selected OpenVPN instance off. Include the name of the OpenVPN instance that you wish to turn off after the rule's SMS text:
+
         <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
−
            <ul>
 
−
                <li><i>vpnoff client_name</i></li>
 
−
                <li><i>vpnoff server_name</i></li>
 
−
            </ul>
 
 
         </td>
 
         </td>
−
    </tr>{{#ifeq:{{{series}}}|TRB5||
 
−
    <tr>
 
−
        <td><b>Mobile Data limit status</b></td>
 
−
        <td><i>no default text</i></td>
 
−
        <td>Sends a status report message that includes data limit usage information for mobile network interfaces (that have [[{{{name}}}_WAN#Mobile_Data_Limit|Mobile Data Limit]] enabled) </td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Mobile Data usage reset</b></td>
 
−
        <td><i>no default text</i></td>
 
−
        <td>Resets mobile data usage for specified interface.</td>
 
−
    </tr>}}
 
−
    <tr>
 
−
        <td><b>Monitoring status</b></td>
 
−
        <td><i>monitoring_status</i></td>
 
−
        <td>Sends a status report message that includes the RMS connection type, state and the device serial number and MAC address.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>More</b></td>
 
−
        <td><i>more</i></td>
 
−
        <td>Displays next part of a composite response message (more than 160 characters).</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>OpenVPN status</b></td>
 
−
        <td><i>vpnstatus</i></td>
 
−
        <td>Sends a status report message on all OpenVPN connections.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Reboot</b></td>
 
−
        <td><i>reboot</i></td>
 
−
        <td>Reboots the device.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Restore to default</b></td>
 
−
        <td><i>restore</i></td>
 
−
        <td>Restores factory settings on the device.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>RMS action</b></td>
 
−
        <td><i>rms_on</i></td>
 
−
        <td>Turns RMS connection on.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>RMS action</b></td>
 
−
        <td><i>rms_off</i></td>
 
−
        <td>Turns RMS connection off.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>RMS connect</b></td>
 
−
        <td><i>rms_connect</i></td>
 
−
        <td>Forces the device to connect to RMS. This action is analogous to clicking the 'Connect' button in the Cloud Solutions → [[{{{name}}}_Cloud_Solutions#RMS|RMS page]].</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>RMS status</b></td>
 
−
        <td><i>rms_status</i></td>
 
−
        <td>Sends a status report message on the state of the connection to RMS.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Send status</b></td>
 
−
        <td><i>status</i></td>
 
−
        <td>Sends a status report message.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>SSH access control</b></td>
 
−
        <td><i>sshon</i></td>
 
−
        <td>Turns remote and local (by default) SSH access on. This rule can be modified to only include local SSH access.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>SSH access control</b></td>
 
−
        <td><i>sshoff</i></td>
 
−
        <td>Turns SSH access off.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Switch mobile data</b></td>
 
−
        <td><i>mobileon</i></td>
 
−
        <td>Turns mobile data usage on.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Switch mobile data</b></td>
 
−
        <td><i>mobileoff</i></td>
 
−
        <td>Turns mobile data usage off.</td>
 
−
    </tr>{{#ifeq: {{{wifi}}} | 1 |
 
−
    <tr>
 
−
        <td><b>Switch WiFi</b></td>
 
−
        <td><i>wifion</i></td>
 
−
        <td>Turns the WiFi radio on.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Switch WiFi</b></td>
 
−
        <td><i>wifioff</i></td>
 
−
        <td>Turns the WiFi radio off.</td>
 
−
    </tr>|}}
 
−
    <tr>
 
−
        <td><b>UCI API</b></td>
 
−
        <td><i>uci</i></td>
 
−
        <td>Is used to change the configuration settings on the device. [[#UCI_API_rule|Click here]] for more information on the UCI API rule.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Restore to user's defaults</b></td>
 
−
        <td><i>userdefaults</i></td>
 
−
        <td>Restores user's default configuration on the device. [[{{{name}}}_Maintenance#Create_default_configuration|Click here]] for more information on User's default configuration.</td>
 
−
    </tr>{{#switch:{{{name}}}
 
−
| TRB141|TRB142|TRB145=
 
−
| #default=<tr>
 
−
        <td><b>Wake on LAN</b></td>
 
−
        <td><i>wakeup</i></td>
 
−
        <td>Sends a magic packet that "wakes up" a specified device from standby mode. If you have multiple Wake-on-LAN-capable devices, you will have to create a separate rule with a different SMS text for each one. Configuration for each device must include the MAC address of that device.</td>}}
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Web access control</b></td>
 
−
        <td><i>webon</i></td>
 
−
        <td>Turns remote and local (by default) HTTP and HTTPS access on. This rule can be modified to only include local HTTP/HTTPS access.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>Web access control</b></td>
 
−
        <td><i>weboff</i></td>
 
−
        <td>Turns HTTP and HTTPS access off. This rule can also modified to turn of either HTTP or HTTPS separately.</td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>API</b></td>
 
−
        <td><i>api</i></td>
 
−
        <td>Is used to change the configuration settings on the device. [[#API_rule|Click here]] for more information on the UCI API rule.</td>
 
−
    </tr>
 
 
</table>
 
</table>
  
−
===SMS rule execution syntax===
+
====Web access Control====
−
----
+
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
To execute an SMS rule, send an SMS message to your device's SIM card number with the rule's <b><i>SMS Text</i></b> preceded by the selected <b><i>authorization keyword</i></b>, which depends on the selected <i>authorization method</i>:
+
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Web access control function</td>
 +
        <td>Allows Web access control via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Turns access to WebUI ON or OFF</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Enable HTTP access</td>
 +
        <td>Enables or Disables HTTP access from LAN</td>
 +
        <td>If this is ON, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN</td>
 +
</tr>
 +
<tr>
 +
        <td>Enable HTTPS access</td>
 +
        <td>Enables or Disables HTTPS access from LAN</td>
 +
        <td>If this is ON, SMS will enable HTTPS access from LAN, if not, SMS will disable HTTPS access from LAN</td>
 +
</tr>
 +
<tr>
 +
        <td>Enable remote HTTP access</td>
 +
        <td>Enables or Disables HTTP access from WAN</td>
 +
        <td>If this is ON, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN</td>
 +
</tr>
 +
<tr>
 +
        <td>Enable remote HTTPS access</td>
 +
        <td>Enables or Disables HTTPs access from WAN</td>
 +
        <td>If this is ON, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<ul>
+
====Restore to default====
−
    <li><b>No authorization</b> - no special keyword required; simply send a rule's <i>SMS Text</i>. For example, to execute the <i>reboot</i> rule without authorization:<pre>reboot</pre></li>
+
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
    <li><b>By serial</b> - include the device's serial number before a rule's <i>SMS Text</i>. For example, to execute the <i>iostatus</i> rule with serial authorization:<pre>1111111111 iostatus</pre> <font size="-1"><i>(replace 1111111111 with your device's serial number)</i></font></li>
+
<tr>
−
    <li><b>By device admin password</b> - include the device's password before a rule's <i>SMS Text</i>. For example, to execute the <i>vpnon</i> rule with admin password authorization:<pre>admin01 vpnon</pre> <font size="-1"><i>(replace admin01 with your device's admin password)</i></font></li>
+
        <th>FIELD NAME</th>
−
    <li><b>By password</b> - include the configured custom password before a rule's <i>SMS Text</i>. For example, to execute the <i>sshon</i> rule with password authorization:<pre>Custompw1 sshon</pre> <font size="-1"><i>(replace Custompw1 with your configured custom password)</i></font></li>
+
        <th>DESCRIPTION</th>
−
</ul>
+
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Restore to default function</td>
 +
        <td>Allows you to restore the router to it's default settings via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Executes a router reset, which means the router will reboot after this rule is executed and all custom
 +
            configurations will be deleted and restored to default</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
 +
====FW upgrade from server====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the FW upgrade from server function</td>
 +
        <td>Allows you to upgrade the router‘s FW via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Upgrades your router's current Firmware to the one uploaded and assigned to your router in FOTA. The router
 +
            will reboot and be unreachable for a couple of minutes after this rule is executed</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
 +
{{#ifeq:{{{name}}}|TRB14X||
 +
====Force SIM switch====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Force SIM switch function</td>
 +
        <td>Allows SIM switch via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Forces the router to switch to the other SIM card (the one that is not in use at the moment of receiving the message)
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values:<nowiki> No authorization | By serial | By router admin password; Default: '''By router admin password'''</nowiki>
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: <nowiki> From all numbers | From group | From single number; Default: '''From all numbers'''</nowiki>
 +
        </td>
 +
</table>
 +
}}
 +
{{#ifeq:{{{gps}}}|1|
 +
====GPS control====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the GPS ON/OFF function</td>
 +
        <td>Allows you to control GPS via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Turns GPS ON or OFF
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>State</td>
 +
        <td>The state to which GPS will be set when this rule is met</td>
 +
        <td>If you set it as ON it will turn on GPS if OFF it will turn it off</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: <nowiki> No authorization | By serial | By router admin password; Default: </nowiki>'''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: <nowiki> From all numbers | From group | From single number; Default:</nowiki> '''From all numbers'''
 +
        </td>
 +
</table>
  
−
===Modify SMS Rule===
+
====GPS coordinates====
−
----
+
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
Every SMS rule can be edited to your liking. To begin configuring a rule, click the click the 'Edit' button under "Actions" column:
+
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the GPS coordinates function</td>
 +
        <td>Allows you to get GPS coordinates via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Sends you GPS coordinates of the router
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: <nowiki>No authorization | By serial | By router admin password; Default:</nowiki> '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values:<nowiki> From all numbers | From group | From single number; Default: </nowiki>'''From all numbers'''
 +
        </td>
 +
</table>
 +
}}
 +
====Monitoring control====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Monitoring control function</td>
 +
        <td>Allows you to control RMS monitoring status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Turns RMS monitoring ON or OFF
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>State</td>
 +
        <td>The state to which RMS monitoring will be set when this rule is met</td>
 +
        <td>If you set is as ON it will turn on RMS monitoring if OFF it will turn it off</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_edit_button_v1.png|border|class=tlt-border]]
+
====Wake on LAN====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Wake on LAN function</td>
 +
        <td>Provides the possibility to wake computers from sleep mode</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Wakes the specified computer from sleep mode
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>MAC address</td>
 +
        <td>Computer's MAC Address</td>
 +
        <td>A MAC address of a device you want to wake up</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
After this you should redirected to configuration page for that rule. Below are examples of what the configuration page for the <i>reboot</i> rule looks like.
+
====Mobile data limit status====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the mobile data limit status function</td>
 +
        <td>Allows you to get mobile data limit status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Sends you mobile data limit status
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
 +
{{#ifeq:{{{wifi}}}|1|
 +
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
    <tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
    <tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the Switch WiFi function</td>
 +
        <td>Allows WiFi control via SMS</td>
 +
</tr>
 +
  <tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Turn WiFi ON or OFF</td>
 +
</tr>
 +
  <tr>
 +
        <td>State</td>
 +
        <td>The state to which WiFi will be set when this rule is met.</td>
 +
        <td>If you set it as ON it will turn on WiFi if OFF it will turn it off.</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter</td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: <nowiki> No authorization | By serial | By router admin password; Default: </nowiki>'''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: <nowiki> From all numbers | From group | From single number; Default: </nowiki>'''From all numbers'''
 +
        </td>
 +
</table>
 +
}}
 +
{{#ifeq:{{{name}}}|RUTXR1||
 +
====Change I/O state====
 +
----<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the possibility to change output state</td>
 +
        <td>Allows you to change output state via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Changes output state</td>
 +
</tr>
 +
<tr>
 +
        <td>I/O</td>
 +
        <td>Type of output which will be activated </td>
 +
        <td>Select which output you want to use</td>
 +
</tr>
 +
<tr>
 +
        <td>State</td>
 +
        <td>The state to which output will be set when this rule is met</td>
 +
        <td>If you set it as High it will turn on output if Low it will turn it off</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: ioset
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: <nowiki>No authorization | By serial | By router admin password; Default:</nowiki> '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: <nowiki>From all numbers | From group | From single number; Default:</nowiki> '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<b>General settings</b>
+
====I/O status====
 
----
 
----
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable SMS I/O status function</td>
 +
        <td>Allows you to get the router‘s I/O status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Returns an SMS message containing information about the Input/Output status of the router</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: iostatus</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: <nowiki>No authorization | By serial | By router admin password; Default:</nowiki> '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: <nowiki> From all numbers | From group | From single number; Default:</nowiki> '''From all numbers'''
 +
        </td>
 +
</table>
 +
}}
 +
====Monitoring status====
 +
----
 +
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the Monitoring status function</td>
 +
        <td>Allows you to get monitoring status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met</td>
 +
        <td>Returns a text message containing information about remote monitoring status</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: monitoring_status</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<ol>
+
====RMS status====
−
    <li>The <b>Enable</b> slider turn the rule on or off. In order to use a rule, this slider must be set to 'on'. By default, all existing SMS rules are turned on.</li>
+
----
−
    <li>The <b>Action</b> dropdown selection specifies which action should be performed when the rule is executed.</li>
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
    {{#ifeq: {{{dualmodem}}} | 1 |<li>The <b>Receiving modem</b>, which is used to receive the message.</li>|}}
+
<tr>
−
    <li>The <b>SMS text</b> field specifies the text that will trigger the rule upon receiving a message.</li>
+
        <th>FIELD NAME</th>
−
    <li>The <b>Get status via SMS after reboot</b> slider specifies whether the device should send a status report message after an action is executed. The name of this slider may differ from rule to rule and it is only available for some rules.</li>
+
        <th>DESCRIPTION</th>
−
    <li>The <b>Message forwarding</b> slider specifies whether the device should send a status report message to another number (besides the original sender). Setting this slider to 'on' will prompt you to enter an additional phone number(s) of the status message recipient(s).</li>
+
        <th>EXPLANATION, NOTES</th>
−
    {{#ifeq: {{{dualmodem}}} | 1 |<li>The <b>Modem</b>, which is used to get information from or managed for change mobile settings action.</li>|}}
+
</tr>
−
    <li>The <b>Message text</b> box is used to modify the text that should be included in an SMS rule's response message.</li>
+
<tr>
−
</ol>
+
        <td>Enable</td>
 +
        <td>This check box will enable or disable the RMS status function</td>
 +
        <td>Allows you to get RMS status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>Returns a text message containing information about remote monitoring status</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: RMS_status</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<b>Authorization</b>
+
====RMS action====
 
----
 
----
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_authorization_v1.png|border|class=tlt-border]]
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the RMS action function</td>
 +
        <td>Allows you to manage RMS functionality via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>
 +
  <tr>
 +
        <td>State</td>
 +
        <td>The state to which RMS will be set when this rule is met.</td>
 +
        <td>If you set it as ON it will turn on RMS functionality if OFF it will turn it off.</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: rms_on</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
<ol>
+
====RMS status====
−
    <li>The <b>Authorization method</b> dropdown selection specifies the type of authorization an SMS rule requires (device admin password, serial number, password or none). If <b>By password</b> is selected a <b>Password</b> field will appear and a custom password will be required. A custom password must have at least one uppercase letter, one lowercase letter, one number and must be from a minimum of 8 to a maximum of 80 characters in length. </li>
+
----
−
    <li>The <b>Allowed number(s)</b> dropdown selection specifies who can execute an SMS rule (based on phone number).</li>
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
−
</ol>
+
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the RMS action function</td>
 +
        <td>Allows you to manage RMS functionality via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: rms_on</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
 +
====Get OpenVPN status====
 
----
 
----
−
Most rules are configured in a similar manner. However, the configuration does differ from rule to rule, depending on a rule's purpose (selected 'Action'). If you run into trouble when configuring a rule, hover your mouse cursor over the name of a field to see a hint that explains what that field does.
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the OpenVPN status function</td>
 +
        <td>Allows to get the router‘s OpenVPN status via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>Returns an SMS message containing information about an OpenVPN instance's status</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: vpnstatus</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
===Change mobile settings (cellular) rule===
+
====Manage OpenVPN====
 
----
 
----
−
The <b>Change mobile settings</b> rule is used to change the configuration settings of the mobile data connection. The usage of this rule is a bit more complex because the SMS text in and of itself does nothing, as you must also specify the parameters and values that you wish to set. For example, you can send a message that will change your APN only or a message that will change multiple parameters at once.
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the Manage OpenVPN function</td>
 +
        <td>Allows OpenVPN control via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>Turns an OpenVPN instance ON or OFF</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default: vpnon to turn OpenVPN ON; vpnoff to turn OpenVPN OFF
 +
After the SMS text you have to write OpenVPN instance‘s name, e.g., "vpnon client_Client1"</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_cellular_dualsim_{{{dualsim}}}_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
+
====Get list of profiles====
 +
----
 +
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the Get list of profiles function</td>
 +
        <td>Allows you to get the list of profiles via SMS</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>Sends you the list of existing profiles</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: profdisp</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
Below is the full list of parameters that can be changed with this rule.
+
====Change profile====
−
 
+
----
−
<table class="nd-othertables_2" style="width: 100%;">
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 
     <tr>
 
     <tr>
−
         <th width=20%>Parameter</th>
+
         <td>FIELD NAME</td>
−
         <th width=50%>Description</th>
+
         <td>DESCRIPTION</td>
−
         <th width=30%>SMS text example</th>
+
         <td>EXPLANATION, NOTES</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td><b>apn=</b></td>
+
         <td>Enable</td>
−
         <td>Sets APN.</td>
+
         <td>This check box will enable or disable the Change profile function</td>
−
         <td><i>cellular apn=internet</i></td>
+
         <td>Allows changing profiles via SMS</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td><b>auto_apn=</b></td>
+
         <td>Action</td>
−
         <td>Turns auto APN on or off. Possible values are 0/1.</td>
+
         <td>The action to be performed when this rule is met.</td>
−
         <td><i>cellular auto_apn=1</i></td>
+
         <td>Changes the current profile to the one specified in the message</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td><b>dialnumber=</b></td>
+
         <td>SMS text</td>
−
         <td>Sets Dialing number.</td>
+
         <td>SMS text that will trigger the rule</td>
−
         <td><i>cellular dialnumber=*99***1#</i></td>
+
         <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter. Default text '''pr'''.
 +
'''After the SMS text you have to write the Profile's name, e.g., "pr John"'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td><b>auth_mode=</b></td>
+
         <td>Authorization method</td>
−
         <td>Sets the authentication method. Possible values are:
+
        <td>What kind of authorization to use for SIM management</td>
−
            <ul>
+
         <td>Possible values:
−
                <li><i>none</i></li>
+
        <li>No authorization</li>
−
                <li><i>pap</i></li>
+
        <li>By serial</li>
−
                <li><i>chap</i></li>
+
        <li>By router admin password; Default: '''By router admin password'''</li>
−
            </ul>
 
 
         </td>
 
         </td>
−
        <td><i>cellular auth_method=pap</i></td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>service=</b></td>
 
−
        <td>Sets the service mode. Possible values are:
 
−
            <ul>
 
−
                {{#ifeq:{{{2g}}}|1|<li>2g</li>|}}
 
−
                {{#ifeq:{{{3g}}}|1|<li>3g</li>|}}
 
−
                {{#ifeq:{{{4g}}}|1|<li>lte</li>|}}
 
−
                {{#ifeq:{{{5g}}}|1|<li>nr5g</li>|}}
 
−
                <li>mixture of any two modes (ex.: 3g_lte)</li>
 
−
                <li>auto</li>
 
−
            </ul>
 
−
        </td>
 
−
        <td><i>cellular service=auto</i></td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>username=</b></td>
 
−
        <td>Sets the user name for PAP or CHAP authentication.</td>
 
−
        <td><i>cellular username=user</i></td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td><b>password=</b></td>
 
−
        <td>Sets the password for PAP or CHAP authentication.</td>
 
−
        <td><i>cellular password=pass</i></td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td><b>roaming=</b></td>
+
         <td>Allowed users</td>
−
         <td>Turns mobile data roaming on or off.  Possible values are:
+
        <td>White list of allowed users</td>
−
            <ul>
+
         <td>Possible values:
−
                <li><i>0</i> - for off.</li>
+
        <li>From all numbers</li>
−
                <li><i>1</i> - for on.</li>
+
        <li>From group</li>
−
            </ul>
+
        <li>From single number; Default: '''From all numbers'''</li>
 
         </td>
 
         </td>
−
        <td><i>cellular roaming=0</i></td>
 
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
−
Each example above contains a single parameter but you can also send out multiple parameters in one message. For example:
+
====More====
−
 
 
−
cellular apn=internet service=3g
 
−
 
 
−
This message would set your APN to "internet" and the service mode of the mobile connection to "3G Only". You can also send a message that would include all of the parameters above:
 
−
 
 
−
cellular apn=internet auth_mode=pap service=3g username=user password=pass roaming=0
 
−
 
 
−
<b>Note:</b> only "apn=" or "auto_apn=" is required in a message. For example, to set custom APN:
 
−
 
 
−
cellular apn=internet
 
−
 
 
−
or if you want to turn auto APN on:
 
−
 
 
−
cellular auto_apn=1
 
−
 
 
−
===UCI API rule===
 
 
----
 
----
−
The <b>UCI API</b> rule is used to configure any parameters on the device.
+
<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This check box will enable or disable the MORE rule</td>
 +
        <td>Provides the possibility to see the next part of the message</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met/td>
 +
        <td>Returns a text message containing the next part of the message</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 +
Default text: more</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_uci_{{{dualmodem}}}_v4.png|border|class=tlt-border]]
+
===Change mobile data settings (cellular) rule===
 
----
 
----
−
The following are syntax examples for the UCI API rule:
+
The Change mobile data settings rule is exceptional to most of the other rules as it does not perform a single action like turning specific services On/Off or getting status updates. It designed to change mobile data settings and it's '''SMS text''' can't be described by a single string because the message depends on what configurations you want to change. For example, you can send a message that will change your APN only, you can send a message that will change APN and mobile service mode, or even a message that will change every single mobile setting.
  
−
<table class="nd-othertables_2" style="width: 100%;">
+
<table class="nd-mantable">
 
     <tr>
 
     <tr>
−
         <th width=30%>Structure example</th>
+
         <td>FIELD NAME</td>
−
         <th width=35%>Description</th>
+
         <td>DESCRIPTION</td>
−
         <th width=30%>SMS text example</th>
+
         <td>EXPLANATION, NOTES</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>uci <b>get</b> <config>.<section>.<option_name></td>
+
         <td>Enable</td>
−
         <td>Returns the value of a single configuration option.</td>
+
         <td>This check box will enable or disable the Change mobile data settings function</td>
−
         <td><ul><li><i>uci get network.wan.ipaddr</i></li></ul>Returns the router's WAN IP address.</td>
+
         <td>Allows you to change mobile settings via SMS</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>uci <b>set</b> <config>.<section>.<option_name>="value"</td>
+
         <td>Action</td>
−
         <td>Sets the value of a specified configuration option.</td>
+
         <td>The action to be performed when this rule is met.</td>
−
         <td><ul><li><i>uci set network.mobile.apn=example</i></li></ul>Changes mobile APN value to "example".</td>
+
         <td>Changes the specified mobile settings</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>uci <b>show</b> <config></td>
+
         <td>SMS text</td>
−
         <td>Returns the contents of a config file</td>
+
         <td>SMS text that will trigger the rule</td>
−
         <td><ul><li><i>uci show openvpn</i></li></ul>Returns the contents of the "openvpn" config file.</td>
+
         <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter. Default: '''cellular'''. '''Detailed explanations on how to use this function are presented in the table below'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>uci <b>show</b> <config>.<section></td>
+
         <td>Authorization method</td>
−
         <td>Returns the exact part (section) of a config file.</td>
+
         <td>What kind of authorization to use for SIM management</td>
−
         <td><ul><li><i>uci show network.lan</i></li></ul>Returns the configuration of the "lan" section from the "network" config file.</td>
+
         <td>Possible values:
 +
        <li>No authorization</li>
 +
        <li>By serial</li>
 +
        <li>By router admin password; Default: '''By router admin password'''</li>
 +
        </td>
 
     </tr>
 
     </tr>
−
<!--
 
 
     <tr>
 
     <tr>
−
         <td>uci <b>delete</b> <config>.<section></td>
+
         <td>Allowed users</td>
−
         <td>Deletes the specified section in a configuration file. To avoid operation issues, please use this command to delete optional configuration sections only (not mandatory ones).</td>
+
        <td>White list of allowed users</td>
−
         <td><li><i>uci delete network.lan4</i></li>Deletes a network interface called "lan4".</td>
+
        <td>Possible values:
 +
         <li>From all numbers</li>
 +
         <li>From group</li>
 +
        <li>From single number; Default: '''From all numbers'''</li>
 +
        </td>
 
     </tr>
 
     </tr>
−
    <tr>
 
−
        <td>uci <b>delete</b> <config>.<section>.<option_name></td>
 
−
        <td>Deletes the specified configuration option. To avoid operation issues, please use this command to delete optional configuration options only (not mandatory ones).</td>
 
−
        <td><li><i>uci delete dhcp.lan.force</i></li>Deletes the "force" option for DHCP server of the "lan" interface (which in turn disables the "Force DHCP" function of that DHCP server).</td>
 
−
    </tr>
 
−
-->
 
 
</table>
 
</table>
  
−
The UCI rule requires that you know the names of the configuration files and sections and parameters contained within them. You can find the config file list and some examples of the UCI system usage in our <b>[[UCI command usage]]</b> article.
+
The default '''SMS text''' for the Change mobile data settings rule is '''cellular''' but it is only an indication text and does not include any specific parameters to be changed. The list of parameters that can be changed and explanations on how to incorporate them into the '''"cellular"''' message is presented in the table below.  
  
−
'''Disclaimer''': do not enclose values in '''escape characters''' like you would when executing UCI commands via CLI. For example: '''uci set network.mobile.apn="example"''' will cause an error in SMS API and your value will be altered, as a result, UCI commands execution will fail. Instead, simply write '''uci set network.mobile.apn=example''' without any escape characters or quotes.
+
<table class="nd-mantable" >
−
 
+
    <tr>
−
===API rule===
+
        <td>PARAMETER</td>
−
----
+
        <td>VALUE</td>
−
API allows creating, reading, updating, or deleting configurations using the allowed API endpoints from a list.
+
        <td>DESCRIPTION</td>
−
 
+
        <td>DEFAULT MESSAGE EXAMPLE</td>
−
[[File:Networking rutos manual mobile utilities sms utilities modify sms rule api {{{dualmodem}}}_v3.png|border|class=tlt-border]]
+
    </tr>
−
----
+
    <tr>
−
The following are syntax examples for the API rule:
+
        <td>apn=</td>
−
 
+
        <td>e.g., internet</td>
−
<table class="nd-othertables_2" style="width: 100%;">
+
        <td>Sets APN</td>
 +
        <td>'''cellular apn=internet'''</td>
 +
    </tr>
 +
    <tr>
 +
        <td>dialnumber=</td>
 +
        <td>e.g., *99***1#</td>
 +
        <td>Sets Dialing number</td>
 +
        <td>'''cellular dialnumber=*99***1#'''</td>
 +
    </tr>
 
     <tr>
 
     <tr>
−
         <th width=30%>Structure example</th>
+
         <td>auth_mode=</td>
−
         <th width=35%>Description</th>
+
        <td>
−
         <th width=30%>SMS text example</th>
+
        <li>none</li>
 +
         <li>pap</li>
 +
        <li>chap</li>
 +
        </td>
 +
        <td>Sets Authentication method</td>
 +
         <td>'''cellular auth_method=pap'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>api <b>get</b> <method>.<config>.<section></td>
+
         <td>service=</td>
−
         <td>Returns specified config options.</td>
+
        <td>
−
         <td><ul><li><i>api get /auto_reboot/periodic/config</i></li></ul>Returns periodic reboot options.</td>
+
        <li>3gonly</li>
 +
         <li>4gonly</li>
 +
         <li>auto</li>
 +
        </td>
 +
        <td>Sets the mobile Service mode</td>
 +
        <td>'''cellular service=auto'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>api <b>post</b><method> <config>.<section>.<option_name>="value"</td>
+
         <td>username=</td>
−
         <td>Sets the value of a specified configuration option.</td>
+
        <td>e.g., user</td>
−
         <td><ul><li><i>api post /auto_reboot/periodic/config {"data": {"action": "1", "period": "week", "days": ["mon"], "time": ["12:00"]}}</i></li></ul>Creates a periodic reboot configuration with options to reboot device every monday on 12:00.</td>
+
         <td>Sets the user name for PAP or CHAP authentication</td>
 +
         <td>'''cellular username=user'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>api <b>put</b> <method> <config>.<section>.<option_name>="value"</td>
+
         <td>password=
−
         <td>Edits a specified config options.</td>
+
        <td>e.g., pass</td>
−
         <td><ul><li><i>api put /auto_reboot/periodic/config/{id} {"data": { "enable": "1"}}</i></li></ul>Sets a specified periodic reboot config to enabled.</td>
+
         <td>Sets the password for PAP or CHAP authentication</td>
 +
         <td>'''cellular password=pass'''</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
         <td>api <b>delete</b> <method> <config>.<section>.<config_id></td>
+
         <td>roaming=</td>
−
         <td>Deletes a specified configuration.</td>
+
        <td>'''0''' for OFF; '''1''' for ON</td>
−
         <td><ul><li><i>api delete /auto_reboot/periodic/config/{id}</i></li></ul>Deletes a specified periodic reboot configuration.</td>
+
         <td>Turn Mobile data roaming ON or OFF</td>
 +
         <td>'''cellular roaming=0'''</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 +
 +
Each of the above examples contain a single parameter but you can send out multiple parameters in one message. For example, '''"cellular apn=internet.gprs service=3gonly"'''. This message would set your APN to "internet.gprs" and your Service mode to 3G Only. You can also send a message that would include all of the parameters above: '''"cellular apn=internet.gprs dialnumber=*99***1# auth_mode=pap service=3gonly username=user password=pass"'''
 +
 +
 +
===UCI API rule===
 +
----
 +
The UCI rule lets you set or get any parameter from the router's configuration files.<table class="mw-collapsible mw-collapsed nd-mantable"style="width: 100%">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>Enable</td>
 +
        <td>This will enable or disable the UCI API function</td>
 +
        <td>Allows you to set or get any configurations from the router</td>
 +
</tr>
 +
<tr>
 +
        <td>Action</td>
 +
        <td>The action to be performed when this rule is met.</td>
 +
        <td>Sets or sends you any specified configurations of the router</td>
 +
</tr>
 +
<tr>
 +
        <td>SMS text</td>
 +
        <td>SMS text that will trigger the rule</td>
 +
        <td>SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter'''Detailed explanations on how to use this function are presented in the table below'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Select which modem you want to use</td>
 +
        <td>Which modem is configured</td>
 +
</tr>
 +
<tr>
 +
        <td>Authorization method</td>
 +
        <td>What kind of authorization to use for SIM management</td>
 +
        <td>Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
 +
        </td>
 +
</tr>
 +
<tr>
 +
        <td>Allowed users</td>
 +
        <td>White list of allowed users</td>
 +
        <td>Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''
 +
        </td>
 +
</table>
 +
 +
The following are syntax examples for the UCI API rule:
 +
<table class="nd-mantable">
 +
<tr>
 +
        <th>FIELD NAME</th>
 +
        <th>DESCRIPTION</th>
 +
        <th>EXPLANATION, NOTES</th>
 +
</tr>
 +
<tr>
 +
        <td>uci get config.section.option"</td>
 +
        <td>Returns config option value</td>
 +
        <td>'''uci get network.wan.ipaddr''' - returns the router's WAN IP address</td>
 +
</tr>
 +
<tr>
 +
        <td>uci set config.section.option="value"</td>
 +
        <td>Sets config option</td>
 +
        <td>'''"uci set network.mobile.apn=example"''' - Changes mobile APN to example</td>
 +
</tr>
 +
<tr>
 +
        <td>uci show config</td>
 +
        <td>Returns the contents of a config file</td>
 +
        <td>'''uci show openvpn''' - returns the contents of the openvpn config file</td>
 +
</tr>
 +
<tr>
 +
        <td>uci show config.section</td>
 +
        <td>Returns the exact part of a config file (either section or the exact option value)</td>
 +
        <td>'''uci show network.ppp''' - returns the contents of the ppp interface section from the network config file
 +
        </td>
 +
</tr>
 +
</table>As you can see, the UCI rule requires that you know the names of the configuration files and the names of the
 +
sections and parameters that they hold. You can find the config file list and some examples of UCI usage in general in
 +
our '''[[UCI command usage]]''' article.
  
 
===Custom Rules===
 
===Custom Rules===
 
----
 
----
−
If none of the default rules suit your purposes, you can also configure custom ones. To do so, scroll down to the very bottom of the SMS Utilities page, where you will find the <b>Add Rule</b> section. Enter a custom SMS text, select an Action and click the 'Add' button:
+
If default rules do not suit your purposes, you can also configure custom SMS rules. To do so, go to the bottom of the
 +
SMS Utilities page, where you will find the '''Add Rule''' tab. Write SMS text, select an Action and press the '''Add'''
 +
button located next to it.
 +
 
 +
[[Image:Networking trb manual mobile utilities add rule v1.png|border]]
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_add_rule.png|border|class=tlt-border]]
+
Configuring a new rule is very similar to editing default rules: you are provided with a list of '''Actions''', other
 +
fields are generated in accordance with which '''Action''' you choose.
  
 
==SMS Gateway==
 
==SMS Gateway==
−
 
+
This section is a summary of the SMS Gateway function in {{{name}}} routers.
−
This section provides a summary of the <b>SMS Gateway</b> functions for {{{name}}} devices.
 
  
 
===Post/Get===
 
===Post/Get===
 
----
 
----
−
<b>Post/Get</b> allows you to perform action requests by writing them in the URL after your device’s IP address.
+
'''Post/Get''' allows you to perform action requests by writing them in the URL after your device’s IP address.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_post_get_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
+
[[File:Networking rutx manual mobile utilities post get v1.png|1152x1152px]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
 
         <th>Field</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>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable SMS management functionality through POST/GET
 
         <td>Enable SMS management functionality through POST/GET
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Access</td>
 
−
        <td>mobile_data | mobile_sim_pin | sms_delete | sms_list | sms_read | sms_send | sms_total; default: <b>mobile_data, sms_delete, sms_list, sms_read, sms_send, sms_total</b></td>
 
−
        <td>Methods available for Post/Get. All methods are allowed if this list is left empty.</td>
 
−
    </tr>
 
−
{{#ifeq: {{{dualmodem}}} | 1 |
 
−
    <tr>
 
 
         <td>Modem</td>
 
         <td>Modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Gateway modem</td>
 
         <td>Gateway modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
−
    </tr>|}}
+
</tr>
−
    <tr>
+
<tr>
 
         <td>User name</td>
 
         <td>User name</td>
−
         <td>default: '''user1'''</td>
+
         <td>Default: '''user1'''</td>
 
         <td>User name used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
 
         <td>User name used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Password</td>
 
         <td>Password</td>
−
         <td>default: '''user_pass'''</td>
+
         <td>Default: '''user_pass'''</td>
 
         <td>Password used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
 
         <td>Password used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
 
</table>
 
</table>
  
Line 546: Line 1,393:
 
<tr>
 
<tr>
 
         <td>Read mobile message</td>
 
         <td>Read mobile message</td>
−
         <td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_read?username=user1&password=user_pass&number=1
+
         <td>http://<span
 +
                style="color: black;">192.168.1.1</span>/cgi-bin/sms_read?username=user1&password=user_pass&number=1
 
         </td>
 
         </td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
−
         <td>Send mobile message to a single number</td>
+
         <td>Send mobile message</td>
−
         <td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
+
         <td>http://<span
−
        </td>
+
                style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
−
</tr>
 
−
<tr>
 
−
        <td>Send mobile message to a group</td>
 
−
        <td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&group=group_name&text=testmessage
 
 
         </td>
 
         </td>
 
</tr>
 
</tr>
Line 566: Line 1,410:
 
<tr>
 
<tr>
 
         <td>Delete mobile message</td>
 
         <td>Delete mobile message</td>
−
         <td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
+
         <td>http://<span
 +
                style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
 
         </td>
 
         </td>
 
</tr>
 
</tr>
Line 602: Line 1,447:
 
     </li>
 
     </li>
 
     <li><b>text</b> - SMS message text</li>
 
     <li><b>text</b> - SMS message text</li>
−
</ul>
 
−
----
 
−
To use Post/Get via SSH instead of a browser, you may want to use the <b><i>curl -X</i></b> command. Simply add the same URL command in between quotes and specify the HTTP method.
 
−
 
−
<b>Examples:</b>
 
−
 
−
<ul>
 
−
    <li><b>View SMS list:</b><br><pre>curl -X GET "http://192.168.1.1/cgi-bin/sms_list?username=user1&password=user_pass"</pre></li>
 
−
    <li><b>Send SMS:</b><br><pre>curl -X GET "http://192.168.1.1/cgi-bin/sms_send?username=user1&password=user_pass&number=0037000000000&text=testmessage"</pre></li>
 
 
</ul>
 
</ul>
  
 
===Auto Reply===
 
===Auto Reply===
 
----
 
----
−
<b>Auto reply</b> allows you to configure automatic replying to SMS messages that the router receives.
+
'''Auto reply''' allows you to configure automatic replying to SMS messages that the router receives.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_auto_reply_dualmodem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
+
[[File:Networking rutx manual mobile utilities auto reply v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 627: Line 1,463:
 
<tr>
 
<tr>
 
         <td>Enable</td>
 
         <td>Enable</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Toggles Auto Reply ON or OFF
 
         <td>Toggles Auto Reply ON or OFF
 
         </td>
 
         </td>
Line 633: Line 1,469:
 
<tr>
 
<tr>
 
         <td>Reply SMS-Utilities rules</td>
 
         <td>Reply SMS-Utilities rules</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>It will reply to sms rules, from SMS-Utilities</td>
 
         <td>It will reply to sms rules, from SMS-Utilities</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
         <td>Don't save received messages</td>
 
         <td>Don't save received messages</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>If enabled, the router will delete received SMS messages</td>
 
         <td>If enabled, the router will delete received SMS messages</td>
 
</tr>
 
</tr>
−
{{#ifeq: {{{dualmodem}}} | 1 |
 
 
<tr>
 
<tr>
 
         <td>Modem</td>
 
         <td>Modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
         <td>Gateway modem</td>
 
         <td>Gateway modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
 
</tr>
 
</tr>
−
|}}
 
 
<tr>
 
<tr>
 
         <td>Mode</td>
 
         <td>Mode</td>
−
         <td>default: '''Everyone'''</td>
+
         <td>Default: '''Everyone'''</td>
 
         <td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
 
         <td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
−
             <ul>
+
 
−
                <li>Everyone</li>
+
             <li>Everyone</li>
−
                <li>Listed numbers</li>
+
            <li>Listed numbers</li>
−
                <li>From user group</li>
+
            <li>From user group</li>
−
            </ul>
 
 
         </td>
 
         </td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
         <td>Message text</td>
 
         <td>Message text</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>The message that will be sent in reply
 
         <td>The message that will be sent in reply
 
         </td>
 
         </td>
Line 680: Line 1,513:
 
The SMS Forwarding To HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.
 
The SMS Forwarding To HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_http_v2.png|border|class=tlt-border]]
+
[[Image:Networking trb manual mobile utilities sms to http v1.png|border|class=tlt-border|1102x1102px]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
 
         <th>Field</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>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable SMS forwarding to HTTP</td>
 
         <td>Enable/disable SMS forwarding to HTTP</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Forward SMS-Utilities rules</td>
 
         <td>Forward SMS-Utilities rules</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable sms-utilities rules forwarding</td>
 
         <td>Enable/disable sms-utilities rules forwarding</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Don't save received message</td>
 
         <td>Don't save received message</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Include sender's number</td>
 
         <td>Include sender's number</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable adding original message sender phone number at the end of message text</td>
 
         <td>Enable/disable adding original message sender phone number at the end of message text</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Mode</td>
 
−
        <td>default: '''Everyone'''</td>
 
−
        <td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
 
−
            <ul>
 
−
                <li>Everyone</li>
 
−
                <li>Listed numbers</li>
 
−
                <li>From phone group</li>
 
−
            </ul>
 
−
        </td>
 
−
    </tr>
 
−
    <tr>
 
−
        <td>Encode message text to Base64</td>
 
−
        <td>off | on; default: <b>off</b></td>
 
−
        <td>Message text will be encoded to a Base64 string. Enable this to preserve Unicode characters in the message text.</td>
 
−
    </tr>
 
−
    <tr>
 
 
         <td>HTTPS certificate verification</td>
 
         <td>HTTPS certificate verification</td>
−
         <td>default: '''Ignore'''</td>
+
         <td>Default: '''Ignore'''</td>
−
         <td>Select whether to ignore or verify server certificate. Available options: <ul><li>Ignore</li> <li>Verify</li></ul>
+
         <td>Select whether to ignore or verify server certificate. Available options: <li>Ignore</li> <li>Verify</li>
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Method</td>
 
         <td>Method</td>
−
         <td>default: '''Get'''</td>
+
         <td>Default: '''Get'''</td>
−
         <td>Choose witch HTTP request method will be used. Available options: <ul><li>Get</li> <li>Post</li></ul>
+
         <td>Choose witch HTTP request method will be used. Available options: <li>Get</li> <li>Post</li>
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>URL</td>
 
         <td>URL</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>URL to which message is going to be forwarded</td>
 
         <td>URL to which message is going to be forwarded</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Number value name</td>
 
         <td>Number value name</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Sender phone number code name for query string name/value pair</td>
 
         <td>Sender phone number code name for query string name/value pair</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Message value name</td>
 
         <td>Message value name</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Message code name for query string name/value pair</td>
 
         <td>Message code name for query string name/value pair</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Extra data pair 1</td>
 
         <td>Extra data pair 1</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Extra html query name/value pair. Enter name to the left field and value to right</td>
 
         <td>Extra html query name/value pair. Enter name to the left field and value to right</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Extra data pair 2</td>
 
         <td>Extra data pair 2</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Extra html query name/value pair. Enter name to the left field and value to right</td>
 
         <td>Extra html query name/value pair. Enter name to the left field and value to right</td>
−
    </tr>
+
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Default: '''Modem 1'''</td>
 +
        <td>Which modem is used</td>
 +
</tr>
 +
<tr>
 +
        <td>Mode</td>
 +
        <td>Default: '''All messages'''</td>
 +
        <td>Choose which messages are going to be forwarded. Available options: <li>All messages'''
 +
            <li>From listed numbers'''
 +
            <li>From user group'''
 +
        </td>
 +
</tr>
 
</table>
 
</table>
  
 
====SMS Forwarding To SMS====
 
====SMS Forwarding To SMS====
−
----
+
----The '''SMS Forwarding To SMS''' function forwards SMS messages to one or several recipients.
−
The '''SMS Forwarding To SMS''' function forwards SMS messages to one or several recipients.
 
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_sms_dualmodem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
+
[[Image:Networking rutx manual mobile utilities sms to sms v1.png|border|class=tlt-border|1102x1102px]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
 
         <th>Field</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>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enables/disables SMS forwarding to SMS
 
         <td>Enables/disables SMS forwarding to SMS
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Forward SMS-Utilities rules</td>
 
         <td>Forward SMS-Utilities rules</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable sms-utilities rules forwarding</td>
 
         <td>Enable/disable sms-utilities rules forwarding</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Don't save received message</td>
 
         <td>Don't save received message</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Add sender's number</td>
 
         <td>Add sender's number</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable adding original message sender phone number at the end of message text. Only added if total
 
         <td>Enable/disable adding original message sender phone number at the end of message text. Only added if total
 
             message length is up to 480 characters</td>
 
             message length is up to 480 characters</td>
−
    </tr>{{#ifeq: {{{dualmodem}}} | 1 |
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Modem</td>
 
         <td>Modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Gateway modem</td>
 
         <td>Gateway modem</td>
−
         <td>Modem (primary) {{!}} Modem (secondary); default: '''Modem (primary)'''</td>
+
         <td>Default: '''Modem 1'''</td>
 
         <td>Which modem is used</td>
 
         <td>Which modem is used</td>
−
    </tr>|}}
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Mode</td>
 
         <td>Mode</td>
−
         <td>default: '''Everyone'''</td>
+
         <td>Default: '''All messages'''</td>
−
         <td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
+
         <td>Choose which messages are going to be forwarded. Available options: <li>All messages'''
−
            <ul>
+
            <li>From listed numbers'''
−
                <li>Everyone</li>
+
            <li>From user group'''
−
                <li>Listed numbers</li>
 
−
                <li>From user group</li>
 
−
            </ul>
 
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Recipients phone numbers</td>
 
         <td>Recipients phone numbers</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Number(s) to which received messages will be forwarded to</td>
 
         <td>Number(s) to which received messages will be forwarded to</td>
−
    </tr>
+
</tr>
 
</table>
 
</table>
  
Line 829: Line 1,655:
 
The '''SMS Forwarding To Email''' function forwards SMS messages to email.
 
The '''SMS Forwarding To Email''' function forwards SMS messages to email.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_email_v2.png|border|class=tlt-border]]
+
[[Image:Networking rutx manual mobile utilities sms to email v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
 
         <th>Field</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>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enables/disables SMS forwarding to Email
 
         <td>Enables/disables SMS forwarding to Email
 
         </td>
 
         </td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Forward SMS-Utilities rules</td>
 
         <td>Forward SMS-Utilities rules</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enables/disables sms-utilities rules forwarding</td>
 
         <td>Enables/disables sms-utilities rules forwarding</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Don't save received message</td>
 
         <td>Don't save received message</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
 
         <td>Select whether you want to save forwarded messages or not</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
         <td>Include sender's number</td>
+
         <td>Add sender's number</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off | on; default: '''off'''</td>
 
         <td>Enable/disable adding sender phone number at the end of email text body</td>
 
         <td>Enable/disable adding sender phone number at the end of email text body</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Mode</td>
 
−
        <td>default: '''Everyone'''</td>
 
−
        <td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
 
−
            <ul>
 
−
                <li>Everyone</li>
 
−
                <li>Listed numbers</li>
 
−
                <li>From user group</li>
 
−
            </ul>
 
−
        </td>
 
−
    </tr>
 
−
    <tr>
 
 
         <td>Subject</td>
 
         <td>Subject</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Subject of an email. Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )</td>
 
         <td>Subject of an email. Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
         <td>Sender's email account</td>
+
         <td>Email group</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>Sender's email configuration</td>
 
         <td>Sender's email configuration</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
 
         <td>Recipient's email address</td>
 
         <td>Recipient's email address</td>
−
         <td>default: <b>none</b></td>
+
         <td>Default: " "</td>
 
         <td>For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)</td>
 
         <td>For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)</td>
−
    </tr>
+
</tr>
 +
<tr>
 +
        <td>Modem</td>
 +
        <td>Default: '''Modem 1'''</td>
 +
        <td>Which modem is used</td>
 +
</tr>
 +
<tr>
 +
        <td>Mode</td>
 +
        <td>Default: '''All messages'''</td>
 +
        <td>Choose which messages are going to be forwarded. Available options: <li>All messages'''
 +
            <li>From listed numbers'''
 +
            <li>From user group'''
 +
        </td>
 +
</tr>
 
</table>
 
</table>
  
−
===Email To SMS Forwarding===
+
====Email To SMS Forwarding====
−
----
+
 
 
<b>Email to SMS Forwarding</b> is a function that connects to your email account and checks its inbox at the specified frequency. If it finds any new received emails with a specific subject (phone number in email subject), it sends the body of the email as an SMS message(s) to the recipient specified in the email subject field.
 
<b>Email to SMS Forwarding</b> is a function that connects to your email account and checks its inbox at the specified frequency. If it finds any new received emails with a specific subject (phone number in email subject), it sends the body of the email as an SMS message(s) to the recipient specified in the email subject field.
  
 
<b>Important note</b>: all POP3 server email messages from inbox will be deleted when using this service.
 
<b>Important note</b>: all POP3 server email messages from inbox will be deleted when using this service.
−
 
+
{{#ifeq:{{{name}}}| RUTX12 |
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_email_to_sms_forwarding_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
+
[[File:Networking_rut12_manual_mobile_utilties_email_to_sms_v1.png|border|class=tlt-border]]
 +
|
 +
[[File:Networking_rutos_manual_mobile_utilties_email_to_sms_v1.png|border|class=tlt-border]]
 +
}}
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
−
         <th>Field</th>
+
         <th>Field name</th>
 
       <th>Value</th>
 
       <th>Value</th>
 
       <th>Description</th>
 
       <th>Description</th>
Line 902: Line 1,733:
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
−
       <td>off | on; default: <b>off</b></td>
+
       <td>off | on; Default: <b>off</b></td>
 
       <td>Turns Email to SMS Forwarding ON or OFF</td>
 
       <td>Turns Email to SMS Forwarding ON or OFF</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>POP3 server</td>
 
       <td>POP3 server</td>
−
       <td>host | ip; default: <b>none</b></td>
+
       <td>host | ip; Default: <b>none</b></td>
 
       <td>Email service provider's POP3 server address (can be looked up online)</td>
 
       <td>Email service provider's POP3 server address (can be looked up online)</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Server port</td>
 
     <td>Server port</td>
−
         <td>integer [0..65535]; default: <b>none</b></td>
+
         <td>integer [0..65535]; Default: <b>none</b></td>
 
         <td>Email service provider's POP3 server port (can be looked up online)</td>
 
         <td>Email service provider's POP3 server port (can be looked up online)</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>User name</td>
 
     <td>User name</td>
−
         <td>string; default: <b>none</b></td>
+
         <td>string; Default: <b>none</b></td>
 
         <td>Email account user name. This is information is used by router in order to atuhenticate itself when connecting to the email client</td>
 
         <td>Email account user name. This is information is used by router in order to atuhenticate itself when connecting to the email client</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Password</td>
 
       <td>Password</td>
−
       <td>string; default: <b>none</b></td>
+
       <td>string; Default: <b>none</b></td>
 
       <td>Email account password. This is information is used by router in order to atuhenticate itself when connecting to the email client</td>
 
       <td>Email account password. This is information is used by router in order to atuhenticate itself when connecting to the email client</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
     <td>Secure connection (TLS)</td>
+
     <td>Secure connection (SSL)</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>yes | no; Default: <b>no</b></td>
−
         <td>Enables/diables secure connection (TLS 1.2 and up). <b>TLS</b> (Transport Layer Security) is a cryptographic protocol designed to provide communications security over a computer network. TLS uses a combination of symmetric cryptography (sigle secret key known to both sender and receiver to encrypt data) and asymmetric cryptography (a public key known to everyone and a private or secret key known only to the recipient of the message) to encrypt data.</td>
+
         <td><b>SSL</b> is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message</td>
−
    </tr>
 
−
    <tr>
 
−
    <td>Verify TLS certificate validity</td>
 
−
        <td>off | on; default: <b>off</b></td>
 
−
        <td>Enables/disables TLS certificate validation. When enabled verifies the validity of the POP3 server certificate</td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
−
     <td>SMS PDU limit</td>
+
     <td>SMS limit</td>
−
         <td>integer; default: <b>5</b></td>
+
         <td>integer; Default: <b>5</b></td>
−
         <td>Longer email text will be sent in multiple PDUs (Protocol Data Units), each of them is approximately 130 characters. Specify maximum allowed PDU count</td>
+
         <td>Limit of SMS count that can be contained in the email body of text, SMS length is limited to 160 seven-bit characters. Emails that contain more symbols than it is specified in this field will not be sent as SMS messages</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Check email every</td>
 
     <td>Check email every</td>
−
         <td>time; default: <b>1 minute</b></td>
+
         <td>time; Default: <b>1 minute</b></td>
 
         <td>Email inbox check interval</td>
 
         <td>Email inbox check interval</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Interval</td>
 
     <td>Interval</td>
−
         <td>Minutes | Hours| Days; default: <b>Minutes</b></td>
+
         <td>Minutes | Hours| Days; Default: <b>Minutes</b></td>
 
         <td>Email inbox check interval</td>
 
         <td>Email inbox check interval</td>
−
     </tr>{{#ifeq: {{{dualmodem}}} | 1 |
+
     </tr>
 +
    {{#ifeq:{{{name}}}| RUTX12|
 
     <tr>
 
     <tr>
 
         <td>Gateway modem</td>
 
         <td>Gateway modem</td>
 
         <td>Select which modem you want to use</td>
 
         <td>Select which modem you want to use</td>
 
         <td>Which modem is configured</td>
 
         <td>Which modem is configured</td>
−
     </tr>|}}
+
     </tr>
 +
    }}
 
</table>
 
</table>
  
Line 968: Line 1,796:
 
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)
 
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)
  
−
<b>Recommendations note</b>:
+
==Call Utilities==
−
<ul>
+
 
−
<li>Email to SMS application can't guarantee best results when working with flooded email inbox. It is recommended to have less than 100 emails in the inbox.</li>
+
Just like SMS Utilities, Call Utilities provide you with the possibility to issue certain commands to the router from
−
<li>Less emails - better performance.</li>
+
your mobile phone. The list of possible rules is of course shorter because you can only make one type of call. Keep that
−
<li>In most cases it is best to use dedicated inbox. </li>
+
in mind when creating Call Utilities rules because one call will trigger all of the enabled rules at once.
−
</ul>
 
  
−
===SMPP===
+
===Call Configuration===
 
----
 
----
−
<b>Short Message Peer-to-Peer</b> (<b>SMPP</b>) is a protocol used for exchanging SMS messages between Short Message Service Centers (SMSC) and/or External Short Messaging Entities (ESME). It supports both IPv4 and IPv6 addresses. The figure below is an example of the SMPP section and the table below provides information on the configuration fields contained in that section:
+
To make a new rule, select what '''Action''' you want to make and press '''Add''' button.
  
−
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_smpp_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
+
[[File:Networking trb manual mobile utilities new call rule.png|border | class=tlt-border]]
  
−
<table class="nd-mantable">
+
Every Call rule can be edited to your liking, just click the '''Edit''' button. This guide will contain information on
−
    <tr>
+
editing every single Call Utilities rule.
−
        <th>Field</th>
 
−
      <th>Value</th>
 
−
      <th>Description</th>
 
−
    </tr>
 
−
    <tr>
 
−
      <td>Enable</td>
 
−
      <td>off | on; default: <b>off</b></td>
 
−
      <td>Turns SMPP on or off.</td>
 
−
    </tr>
 
−
    <tr>
 
−
      <td>User name</td>
 
−
      <td>string; default: <b>admin</b></td>
 
−
      <td>User name used for authentication on the SMPP server.</td>
 
−
    </tr>
 
−
    <tr>
 
−
    <td>Password</td>
 
−
        <td>string; default: <b>admin01</b></td>
 
−
        <td>Password used for authentication on the SMPP server.</td>
 
−
    </tr>
 
−
    <tr>
 
−
    <td>Server port</td>
 
−
        <td>integer [0..65535]; default: <b>2775</b></td>
 
−
        <td>SMPP server port.</td>
 
−
    </tr>{{#ifeq: {{{dualmodem}}} | 1 |
 
−
    <tr>
 
−
    <td>Modem</td>
 
−
        <td>Primary modem <nowiki>|</nowiki> Secondary modem; default: <b>Primary modem</b></td>
 
−
        <td>Modem that will be used for SMPP server communications.</td>
 
−
    </tr>|}}
 
−
</table>
 
−
{{#switch:{{{name}}}| TRB255 | TRB256 = | #default =
 
−
==Call Utilities==
 
  
−
Just like SMS Utilities, Call Utilities provide you with the possibility to issue certain commands to the router from your mobile phone. The list of possible rules is of course shorter because you can only make one type of call. Keep that in mind when creating Call Utilities rules because one call will trigger all of the enabled rules at once.
+
[[File:Networking trb manual mobile utilities edit call rule 1.png|border | class=tlt-border]]
  
−
{{#switch: {{{series}}}
+
'''Call Configuration''' window is similar to '''SMS Configuration''', but less complex.
−
| RUT9|RUT2=<b>Note:</b> Devices with <i>EC25-AFxD</i> (where <i>x</i> is any character) modem do not support voice calls. <b>Call Utilities</b> section is not present on devices with these modems. You can find the module present on your device in [[{{{name}}} System]] page.
 
−
| #default=
 
−
}}
 
−
 
 
−
===Call Rules===
 
−
----
 
−
To create a new rule, select an 'Action' and click the 'Add' button. After this, a new configuration window should appear.
 
  
−
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_general_{{{dualmodem}}}_v4.png|border|class=tlt-border]]  
+
[[File:Networking rutx manual mobile utilities edit call rule v1.png | border | class=tlt-border|1102x1102px]]
  
−
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_authorization_v1.png|border|class=tlt-border]]
+
'''Call Configuration''' also has similar Authorization settings.
  
−
 
+
[[File:Networking trb manual mobile utilities edit call rule auth.png|border|class=tlt-border]]
−
===Incoming Calls===
 
−
----
 
−
This option specifies the action to be performed on incoming calls. Call utilities rules will keep getting executed while the call is active.
 
−
 
 
−
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_incoming_calls.png|border|class=tlt-border]]
 
−
}}
 
  
 
==Messages==
 
==Messages==
 
      
 
      
−
With the help of the <b>Messages</b> window you can read and send SMS messages.
+
With the help of the '''Messages''' window you can read and send SMS messages.
 
      
 
      
−
===Read Messages===
+
===Read SMS===
 
----
 
----
−
In the <b>Read Messages</b> section you can read and delete received/stored SMS messages. The layout is simple, there is a list of received SMS messages and you can choose how many entries of that list should be visible at one time with SMS per page drop box in the top left corner of the page and there is a Search field to help you navigate more efficiently through the list of messages in the top right corner of the page.
+
In the '''Read SMS''' tab you can read and delete received/stored SMS messages. The layout is simple, there is a list of
−
 
+
received SMS messages and you can choose how many entries of that list should be visible at one time with SMS per page
−
[[File:Networking_rutos_manual_mobile_utilities_messages_read_messages_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
+
drop box in the top left corner of the page and there is a Search field to help you navigate more efficiently through
−
 
+
the list of messages in the top right corner of the page.
 +
   
 +
[[Image:Networking trb manual mobile utilities read sms v1.png]]
 +
   
 
===Send Messages===
 
===Send Messages===
 
----
 
----
−
The <b>Send Messages</b> section lets you send SMS messages from the router‘s SIM card.
+
The Send Messages tab let's you send SMS messages from the router‘s SIM card.
−
 
+
[[Image:Networking trb manual mobile utilities send sms v1.png]]
−
[[File:Networking_rutos_manual_mobile_utilities_messages_send_messages_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
+
All you have to do is enter the recipient’s phone number, type in your message and hit the '''Send''' button.
−
 
 
−
All you have to do is enter the recipient’s phone number, type in your message and hit the <b>Send</b> button.
 
  
 
===Storage===
 
===Storage===
 
----
 
----
 
In the Storage tab you can find settings associated with message storage.
 
In the Storage tab you can find settings associated with message storage.
−
 
+
   
−
[[File:Networking_rutos_manual_mobile_utilities_messages_storage_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
+
[[Image:Networking rutx manual mobile utilities storage v1.png]]
−
 
 
 
<table class="nd-mantable">
 
<table class="nd-mantable">
−
    <tr>
+
<tr>
−
        <th>Field</th>
+
            <th>Field</th>
−
        <th>Value</th>
+
            <th>Value</th>
−
        <th>Description</th>
+
            <th>Description</th>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Save messages to</td>
+
            <td>Save messages on SIM</td>
−
        <td>SIM card | Modem storage; default: <b>SIM card</b></td>
+
            <td>off | on; default: '''on'''</td>
−
        <td>Specify location where to save messages</td>
+
            <td>If this is enabled, messages from SIM card will not be removed after they have been read</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Memory</td>
+
            <td>Delete forwarded messages</td>
−
        <td>-</td>
+
            <td>off | on; default: '''off'''</td>
−
        <td>Information about used/available SIM card memory</td>
+
            <td>If enabled, all forwarded messages will be automatically deleted</td>
−
    </tr>
+
</tr>
−
    <tr>
+
<tr>
−
        <td>Leave free space</td>
+
            <td>Modem</td>
−
        <td>integer; default: <b>5</b></td>
+
            <td>Default: " "</td>
−
        <td>How much memory (number of messages) should be left free</td>
+
            <td>Which modem is configured</td>
−
    </tr>
+
</tr>
 +
<tr>
 +
            <td>Sim card memory</td>
 +
            <td> -</td>
 +
            <td>Information about used/available SIM card memory</td>
 +
</tr>
 +
<tr>
 +
            <td>Leave free space</td>
 +
            <td>Default: '''5'''</td>
 +
            <td>How much memory (number of messages) should be left free</td>
 +
</tr>
 
</table>
 
</table>
  
−
[[Category: {{{name}}} Services section]]
+
[[Category:{{{name}}} Services section]]

Revision as of 08:50, 18 May 2020

Template:Networking rutos manual fw disclosure

Summary

{{{name}}} routers have an extensive amount of various SMS control utilities. SMS Utilities can be used to set/get configurations, monitor and issue commands to the router.

SMS Utilities

Default Rules

The SMS Utilities section contains a list of rules that perform certain actions when they are activated by SMS messages.

Networking rutos manual mobile utilities sms utilities sms rules.png

The entire list contains more than 20 rules but you are also be provided with the possibility to configure custom ones or edit the existing rules.

All default configuration options are listed below:

  • Reboot
  • Send_status
  • I/O set
  • I/O status
  • Mobile (on)
  • Mobile (off)
  • SSH_access (on)
  • SSH_access (off)
  • Web_access (on)
  • Web_access (off)
  • Firstboot
  • Switch SIM
  • Fw_upgrade
  • RMS status
  • Rms connect
  • Rms action (on)
  • Rms action (off)
  • Monitoring status
  • More

    • Execution

    To execute a rule, just send an SMS message to the router‘s SIM card number with the rule's SMS Text, e.g., if you send a message with the text “reboot”, the router will reboot if the selected Authorization method is “No authorization”. However, if there is an Authorization method present you will need to include the “Authorization key” in the text message. This “Authorization key” depends on the chosen Authorization method, i.e., if the method is “By serial”, the “Authorization key” is the router’s serial number, if the method is “By router admin password”, the “Authorization key” is the router’s admin password.

    The "Authorization key” must precede the activation text and they must be separated by a space symbol. For example, if the chosen Authorization method is “By router admin password” and the password is “admin01”, the entire message should look like this: “admin01 reboot”. The same applies to “By serial” authorization. By default authorization for SMS utilities are set "By router admin password".

    Rule Overview and editing

    Every default SMS rule can be edited to your liking. If none of the rules suit your purposes, just click the Edit button next to any SMS Utilities rules. This guide will contain information on editing every single SMS Utilities rule.

    SMS rule General settings

    Networking rutos manual mobile utilities sms utilities modify sms rule general.png

    SMS rule Authorization settings

    File:Networking trb manual mobile utilities reboot Authorization settings v1.png

    Above is an example of what SMS Configuration General and Authorization settings windows looks like, specifically, SMS Configuration for the Reboot rule. Below is a table with detailed explanations on how to configure the rule and what each of the fields mean. To avoid redundancy, screenshots for the other rules will not be provided, since the structures, syntax and the overall look of the configuration windows for each rule are very similar. Instead, only tables containing information on how to edit each rule will be provided.

    Reboot

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable SMS reboot function Allows router to restart via SMS
    Action The action to be performed when this rule is met Reboots the router
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Get status via SMS after reboot Check this to receive connection status via SMS after the reboot If enabled, the router will send a status message once it has rebooted and is operational again. This is both a separate SMS Rule and an option under the SMS Reboot rule
    Modem Select which modem you want to use Which modem is configured
    Gateway modem Select which modem you want to use Which modem is configured
    Message text Which status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available You can select which status elements to display
    Authorization method What kind of authorization to use Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Send status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable SMS status function Allows you to get the router‘s status via SMS. This is both a separate SMS Rule and an option under the SMS Reboot rule
    Action The action to be performed when this rule is met Returns an SMS message containing information about the status of the router. The type of information contained within the message can be specified in the Message text field
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Modem Select which modem you want to use Which modem is configured
    Gateway modem Select which modem you want to use Which modem is configured
    Message text Which status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available You can select which status elements to display
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Switch mobile data ON/OFF

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Switch mobile data function Allows mobile control via SMS
    Action The action to be performed when this rule is met Turn mobile data ON or OFF
    State The state to which mobile data will be set when this rule is met. If you set it as ON it will turn on mobile data if OFF it will turn it off.
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Modem Select which modem you want to use Which modem is configured
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    SSH access control

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the SSH access control function Allows SSH access control via SMS
    Action The action to be performed when this rule is met Turns SSH access ON or OFF
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Enable SSH access Enables or Disables SSH access from LAN If this is ON, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN
    Enable remote SSH access Enables or Disables SSH access from WAN If this is ON, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Web access Control

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Web access control function Allows Web access control via SMS
    Action The action to be performed when this rule is met Turns access to WebUI ON or OFF
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Enable HTTP access Enables or Disables HTTP access from LAN If this is ON, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN
    Enable HTTPS access Enables or Disables HTTPS access from LAN If this is ON, SMS will enable HTTPS access from LAN, if not, SMS will disable HTTPS access from LAN
    Enable remote HTTP access Enables or Disables HTTP access from WAN If this is ON, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN
    Enable remote HTTPS access Enables or Disables HTTPs access from WAN If this is ON, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Restore to default

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Restore to default function Allows you to restore the router to it's default settings via SMS
    Action The action to be performed when this rule is met Executes a router reset, which means the router will reboot after this rule is executed and all custom configurations will be deleted and restored to default
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    FW upgrade from server

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the FW upgrade from server function Allows you to upgrade the router‘s FW via SMS
    Action The action to be performed when this rule is met Upgrades your router's current Firmware to the one uploaded and assigned to your router in FOTA. The router will reboot and be unreachable for a couple of minutes after this rule is executed
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Force SIM switch

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Force SIM switch function Allows SIM switch via SMS
    Action The action to be performed when this rule is met Forces the router to switch to the other SIM card (the one that is not in use at the moment of receiving the message)
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Modem Select which modem you want to use Which modem is configured
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: '''By router admin password'''
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: '''From all numbers'''

    Monitoring control

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Monitoring control function Allows you to control RMS monitoring status via SMS
    Action The action to be performed when this rule is met Turns RMS monitoring ON or OFF
    State The state to which RMS monitoring will be set when this rule is met If you set is as ON it will turn on RMS monitoring if OFF it will turn it off
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Wake on LAN

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the Wake on LAN function Provides the possibility to wake computers from sleep mode
    Action The action to be performed when this rule is met Wakes the specified computer from sleep mode
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    MAC address Computer's MAC Address A MAC address of a device you want to wake up
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Mobile data limit status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the mobile data limit status function Allows you to get mobile data limit status via SMS
    Action The action to be performed when this rule is met Sends you mobile data limit status
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
    Modem Select which modem you want to use Which modem is configured
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Change I/O state

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the possibility to change output state Allows you to change output state via SMS
    Action The action to be performed when this rule is met Changes output state
    I/O Type of output which will be activated Select which output you want to use
    State The state to which output will be set when this rule is met If you set it as High it will turn on output if Low it will turn it off
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: ioset
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    I/O status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable SMS I/O status function Allows you to get the router‘s I/O status via SMS
    Action The action to be performed when this rule is met Returns an SMS message containing information about the Input/Output status of the router
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: iostatus
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Monitoring status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the Monitoring status function Allows you to get monitoring status via SMS
    Action The action to be performed when this rule is met Returns a text message containing information about remote monitoring status
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: monitoring_status
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    RMS status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the RMS status function Allows you to get RMS status via SMS
    Action The action to be performed when this rule is met/td> Returns a text message containing information about remote monitoring status
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: RMS_status
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    RMS action

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the RMS action function Allows you to manage RMS functionality via SMS
    Action The action to be performed when this rule is met/td>
    State The state to which RMS will be set when this rule is met. If you set it as ON it will turn on RMS functionality if OFF it will turn it off.
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: rms_on
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    RMS status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the RMS action function Allows you to manage RMS functionality via SMS
    Action The action to be performed when this rule is met/td>
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: rms_on
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Get OpenVPN status

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the OpenVPN status function Allows to get the router‘s OpenVPN status via SMS
    Action The action to be performed when this rule is met/td> Returns an SMS message containing information about an OpenVPN instance's status
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: vpnstatus
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Manage OpenVPN

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the Manage OpenVPN function Allows OpenVPN control via SMS
    Action The action to be performed when this rule is met/td> Turns an OpenVPN instance ON or OFF
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

    Default: vpnon to turn OpenVPN ON; vpnoff to turn OpenVPN OFF

    After the SMS text you have to write OpenVPN instance‘s name, e.g., "vpnon client_Client1"
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Get list of profiles

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the Get list of profiles function Allows you to get the list of profiles via SMS
    Action The action to be performed when this rule is met/td> Sends you the list of existing profiles
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: profdisp
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Change profile

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the Change profile function Allows changing profiles via SMS
    Action The action to be performed when this rule is met. Changes the current profile to the one specified in the message
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter. Default text pr. After the SMS text you have to write the Profile's name, e.g., "pr John"
    Authorization method What kind of authorization to use for SIM management Possible values:
  • No authorization
  • By serial
  • By router admin password; Default: By router admin password
    		•
    Allowed users White list of allowed users Possible values:
  • From all numbers
  • From group
  • From single number; Default: From all numbers
    		•

    More

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the MORE rule Provides the possibility to see the next part of the message
    Action The action to be performed when this rule is met/td> Returns a text message containing the next part of the message
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter Default text: more
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    Change mobile data settings (cellular) rule

    The Change mobile data settings rule is exceptional to most of the other rules as it does not perform a single action like turning specific services On/Off or getting status updates. It designed to change mobile data settings and it's SMS text can't be described by a single string because the message depends on what configurations you want to change. For example, you can send a message that will change your APN only, you can send a message that will change APN and mobile service mode, or even a message that will change every single mobile setting.

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This check box will enable or disable the Change mobile data settings function Allows you to change mobile settings via SMS
    Action The action to be performed when this rule is met. Changes the specified mobile settings
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter. Default: cellular. Detailed explanations on how to use this function are presented in the table below
    Authorization method What kind of authorization to use for SIM management Possible values:
  • No authorization
  • By serial
  • By router admin password; Default: By router admin password
    		•
    Allowed users White list of allowed users Possible values:
  • From all numbers
  • From group
  • From single number; Default: From all numbers
    		•

    The default SMS text for the Change mobile data settings rule is cellular but it is only an indication text and does not include any specific parameters to be changed. The list of parameters that can be changed and explanations on how to incorporate them into the "cellular" message is presented in the table below.

    PARAMETER VALUE DESCRIPTION DEFAULT MESSAGE EXAMPLE
    apn= e.g., internet Sets APN cellular apn=internet
    dialnumber= e.g., *99***1# Sets Dialing number cellular dialnumber=*99***1#
    auth_mode=
  • none
  • pap
  • chap
    		•  Sets Authentication method cellular auth_method=pap
    service=
  • 3gonly
  • 4gonly
  • auto
    		•  Sets the mobile Service mode cellular service=auto
    username= e.g., user Sets the user name for PAP or CHAP authentication cellular username=user
    password= e.g., pass Sets the password for PAP or CHAP authentication cellular password=pass
    roaming= 0 for OFF; 1 for ON Turn Mobile data roaming ON or OFF cellular roaming=0

    Each of the above examples contain a single parameter but you can send out multiple parameters in one message. For example, "cellular apn=internet.gprs service=3gonly". This message would set your APN to "internet.gprs" and your Service mode to 3G Only. You can also send a message that would include all of the parameters above: "cellular apn=internet.gprs dialnumber=*99***1# auth_mode=pap service=3gonly username=user password=pass"


    UCI API rule

    The UCI rule lets you set or get any parameter from the router's configuration files.

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    Enable This will enable or disable the UCI API function Allows you to set or get any configurations from the router
    Action The action to be performed when this rule is met. Sets or sends you any specified configurations of the router
    SMS text SMS text that will trigger the rule SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matterDetailed explanations on how to use this function are presented in the table below
    Modem Select which modem you want to use Which modem is configured
    Authorization method What kind of authorization to use for SIM management Possible values: No authorization | By serial | By router admin password; Default: By router admin password
    Allowed users White list of allowed users Possible values: From all numbers | From group | From single number; Default: From all numbers

    The following are syntax examples for the UCI API rule:

    FIELD NAME DESCRIPTION EXPLANATION, NOTES
    uci get config.section.option" Returns config option value uci get network.wan.ipaddr - returns the router's WAN IP address
    uci set config.section.option="value" Sets config option "uci set network.mobile.apn=example" - Changes mobile APN to example
    uci show config Returns the contents of a config file uci show openvpn - returns the contents of the openvpn config file
    uci show config.section Returns the exact part of a config file (either section or the exact option value) uci show network.ppp - returns the contents of the ppp interface section from the network config file

    As you can see, the UCI rule requires that you know the names of the configuration files and the names of the

    sections and parameters that they hold. You can find the config file list and some examples of UCI usage in general in our UCI command usage article.

    Custom Rules

    If default rules do not suit your purposes, you can also configure custom SMS rules. To do so, go to the bottom of the SMS Utilities page, where you will find the Add Rule tab. Write SMS text, select an Action and press the Add button located next to it.

    File:Networking trb manual mobile utilities add rule v1.png

    Configuring a new rule is very similar to editing default rules: you are provided with a list of Actions, other fields are generated in accordance with which Action you choose.

    SMS Gateway

    This section is a summary of the SMS Gateway function in {{{name}}} routers.

    Post/Get

    Post/Get allows you to perform action requests by writing them in the URL after your device’s IP address.

    Networking rutx manual mobile utilities post get v1.png

    Field Value Description
    Enable off | on; default: off Enable SMS management functionality through POST/GET
    Modem Default: Modem 1 Which modem is used
    Gateway modem Default: Modem 1 Which modem is used
    User name Default: user1 User name used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
    Password Default: user_pass Password used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )

    Use a web browser or any other compatible software to send HTTP post/get strings to the router. The router must be connected to a GSM network when using the Send SMS feature. Below you will find a table with possible actions and examples on how to use them:

    Action Post/get URL examples
    View mobile messages list http://192.168.1.1/cgi-bin/sms_list?username=user1&password=user_pass
    Read mobile message http://192.168.1.1/cgi-bin/sms_read?username=user1&password=user_pass&number=1
    Send mobile message http://192.168.1.1/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
    View mobile messages total http://192.168.1.1/cgi-bin/sms_total?username=user1&password=user_pass
    Delete mobile message http://192.168.1.1/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
    • 192.168.1.1 - router's IP address. (Replace it with your [[{{{name}}}_LAN#General_Setup|LAN IP]] or [[{{{name}}}_WAN#Operation_Modes|WAN IP]] (when connecting remotely))
    • SMS related post/get commands. Possible values are:
      • sms_list - view all SMS messages in storage
      • sms_read - read a single SMS message by specified SMS index (number)
      • sms_send - send an SMS message to specified recipient
      • sms_total - display SMS storage statistics
      • sms_delete - delete a single SMS message by specified SMS index (number)
    • & - separation symbol. After specifying the SMS command, other parameters must be separated by an ampersand (&) symbol
    • username - SMS post/get configuration user name
    • password - SMS post/get configuration password
    • number - SMS message index or (depending on context) recipient's phone number. SMS message indexes can be viewed with the sms_list command.
      Correct phone number format is:
      • 00 - number must be preceded by two zeros
      • <country_code> - the next following element is the number holder's country code
      • <receivers_number> - phone number of the recipient
             For example, a valid number would be 0037012345678 (370 is country code and 12345678 is the receiver's
       phone number, all preceded by 00)
    • text - SMS message text

    Auto Reply

    Auto reply allows you to configure automatic replying to SMS messages that the router receives.

    Networking rutx manual mobile utilities auto reply v1.png

    Field Value Description
    Enable off | on; default: off Toggles Auto Reply ON or OFF
    Reply SMS-Utilities rules off | on; default: off It will reply to sms rules, from SMS-Utilities
    Don't save received messages off | on; default: off If enabled, the router will delete received SMS messages
    Modem Default: Modem 1 Which modem is used
    Gateway modem Default: Modem 1 Which modem is used
    Mode Default: Everyone Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
  • Everyone
  • Listed numbers
  • From user group
    		•
    Message text Default: " " The message that will be sent in reply

    SMS Forwarding

    This section is a summary of the SMS Forwarding function in {{{name}}} routers.

    SMS Forwarding To HTTP

    The SMS Forwarding To HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.

    Networking trb manual mobile utilities sms to http v1.png

    Field Value Description
    Enable off | on; default: off Enable/disable SMS forwarding to HTTP
    Forward SMS-Utilities rules off | on; default: off Enable/disable sms-utilities rules forwarding
    Don't save received message off | on; default: off Select whether you want to save forwarded messages or not
    Include sender's number off | on; default: off Enable/disable adding original message sender phone number at the end of message text
    HTTPS certificate verification Default: Ignore Select whether to ignore or verify server certificate. Available options:
  • Ignore
  • Verify
    		•
    Method Default: Get Choose witch HTTP request method will be used. Available options:
  • Get
  • Post
    		•
    URL Default: " " URL to which message is going to be forwarded
    Number value name Default: " " Sender phone number code name for query string name/value pair
    Message value name Default: " " Message code name for query string name/value pair
    Extra data pair 1 Default: " " Extra html query name/value pair. Enter name to the left field and value to right
    Extra data pair 2 Default: " " Extra html query name/value pair. Enter name to the left field and value to right
    Modem Default: Modem 1 Which modem is used
    Mode Default: All messages Choose which messages are going to be forwarded. Available options:
  • All messages
  • From listed numbers
  • From user group

    • SMS Forwarding To SMS

    The SMS Forwarding To SMS function forwards SMS messages to one or several recipients.

    Networking rutx manual mobile utilities sms to sms v1.png

    Field Value Description
    Enable off | on; default: off Enables/disables SMS forwarding to SMS
    Forward SMS-Utilities rules off | on; default: off Enable/disable sms-utilities rules forwarding
    Don't save received message off | on; default: off Select whether you want to save forwarded messages or not
    Add sender's number off | on; default: off Enable/disable adding original message sender phone number at the end of message text. Only added if total message length is up to 480 characters
    Modem Default: Modem 1 Which modem is used
    Gateway modem Default: Modem 1 Which modem is used
    Mode Default: All messages Choose which messages are going to be forwarded. Available options:
  • All messages
  • From listed numbers
  • From user group
    • Recipients phone numbers Default: " " Number(s) to which received messages will be forwarded to

    SMS Forwarding To Email

    The SMS Forwarding To Email function forwards SMS messages to email.

    Networking rutx manual mobile utilities sms to email v1.png

    Field Value Description
    Enable off | on; default: off Enables/disables SMS forwarding to Email
    Forward SMS-Utilities rules off | on; default: off Enables/disables sms-utilities rules forwarding
    Don't save received message off | on; default: off Select whether you want to save forwarded messages or not
    Add sender's number off | on; default: off Enable/disable adding sender phone number at the end of email text body
    Subject Default: " " Subject of an email. Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
    Email group Default: " " Sender's email configuration
    Recipient's email address Default: " " For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)
    Modem Default: Modem 1 Which modem is used
    Mode Default: All messages Choose which messages are going to be forwarded. Available options:
  • All messages
  • From listed numbers
  • From user group

    • Email To SMS Forwarding

    Email to SMS Forwarding is a function that connects to your email account and checks its inbox at the specified frequency. If it finds any new received emails with a specific subject (phone number in email subject), it sends the body of the email as an SMS message(s) to the recipient specified in the email subject field.

    Important note: all POP3 server email messages from inbox will be deleted when using this service. File:Networking rutos manual mobile utilties email to sms v1.png

    Field name Value Description
    Enable off | on; Default: off Turns Email to SMS Forwarding ON or OFF
    POP3 server host | ip; Default: none Email service provider's POP3 server address (can be looked up online)
    Server port integer [0..65535]; Default: none Email service provider's POP3 server port (can be looked up online)
    User name string; Default: none Email account user name. This is information is used by router in order to atuhenticate itself when connecting to the email client
    Password string; Default: none Email account password. This is information is used by router in order to atuhenticate itself when connecting to the email client
    Secure connection (SSL) yes | no; Default: no SSL is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message
    SMS limit integer; Default: 5 Limit of SMS count that can be contained in the email body of text, SMS length is limited to 160 seven-bit characters. Emails that contain more symbols than it is specified in this field will not be sent as SMS messages
    Check email every time; Default: 1 minute Email inbox check interval
    Interval Minutes | Hours| Days; Default: Minutes Email inbox check interval

    Additional note: you may have noticed that there is no option where you can specify the recipient's phone number. As mentioned earlier, Email to SMS doesn't forward all emails, only the ones that are meant to be forwarded. Only emails with the recipient's phone number in the subject will be forwarded to SMS

    Correct phone number format is:

    • 00 - number must be preceded by two zeros
    • <country_code> - the next following element is the number holder's country code
    • <receivers_number> - phone number of the recipient

    For example, a valid number would be 0037012345678 (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)

    Call Utilities

    Just like SMS Utilities, Call Utilities provide you with the possibility to issue certain commands to the router from your mobile phone. The list of possible rules is of course shorter because you can only make one type of call. Keep that in mind when creating Call Utilities rules because one call will trigger all of the enabled rules at once.

    Call Configuration

    To make a new rule, select what Action you want to make and press Add button.

    Networking trb manual mobile utilities new call rule.png

    Every Call rule can be edited to your liking, just click the Edit button. This guide will contain information on editing every single Call Utilities rule.

    File:Networking trb manual mobile utilities edit call rule 1.png

    Call Configuration window is similar to SMS Configuration, but less complex.

    Networking rutx manual mobile utilities edit call rule v1.png

    Call Configuration also has similar Authorization settings.

    File:Networking trb manual mobile utilities edit call rule auth.png

    Messages

    With the help of the Messages window you can read and send SMS messages.

    Read SMS

    In the Read SMS tab you can read and delete received/stored SMS messages. The layout is simple, there is a list of received SMS messages and you can choose how many entries of that list should be visible at one time with SMS per page drop box in the top left corner of the page and there is a Search field to help you navigate more efficiently through the list of messages in the top right corner of the page.

    File:Networking trb manual mobile utilities read sms v1.png

    Send Messages

    The Send Messages tab let's you send SMS messages from the router‘s SIM card. File:Networking trb manual mobile utilities send sms v1.png All you have to do is enter the recipient’s phone number, type in your message and hit the Send button.

    Storage

    In the Storage tab you can find settings associated with message storage.

    Networking rutx manual mobile utilities storage v1.png

    Field Value Description
    Save messages on SIM off | on; default: on If this is enabled, messages from SIM card will not be removed after they have been read
    Delete forwarded messages off | on; default: off If enabled, all forwarded messages will be automatically deleted
    Modem Default: " " Which modem is configured
    Sim card memory - Information about used/available SIM card memory
    Leave free space Default: 5 How much memory (number of messages) should be left free

    [[Category:{{{name}}} Services section]]

    Retrieved from "https://wiki.teltonika-networks.com/index.php?title=Template:Networking_rutos_manual_mobile_utilities&oldid=62595"