Template:Networking rutos manual mobile utilities: Difference between revisions

{{Template:Networking_rutos_manual_fw_disclosure

| fw_version = {{{series}}}_R_00.02.05.1

| series     = {{{series}}}

{{{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.

[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_sms_rules.png|border|class=tlt-border]]

The entire list contains more than 20 rules, but it does not all possible SMS action. 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.

         <td>ioset</td>

         <td>cellular</td>

     </tr>{{#ifeq: {{{dualsim}}} | 1 |

         <td>switch_sim</td>

     </tr>|}}

         <td>fw_upgrade</td>

         <td>profdisp</td>

     </tr>

         <td>gpson</td>

         <td>gps</td>

     </tr>

         <td>ipunblock</td>

                 <li><i>ipunblock 192.168.1.2</i> - removes this IP address from the block list (unblock Web/SSH access for that device).</li>

         <td>iostatus</td>

         <td>vpnon</td>

         <td>vpnoff</td>

         <td><b>Mobile data limit status</b></td>

         <td>Sends a status report message that includes data limit usage information for mobile network interfaces (that have [[{{{name}}}_Interfaces#Mobile_Data_Limit|Mobile Data Limit]] enabled) </td>

     </tr>

         <td>monitoring_status</td>

         <td>more</td>

         <td>vpnstatus</td>

         <td>reboot</td>

         <td>restore</td>

         <td>rms_on</td>

         <td>rms_off</td>

         <td>rms_connect</td>

         <td>rms_status</td>

         <td>status</td>

         <td>sshon</td>

         <td>sshoff</td>

         <td>mobileon</td>

         <td>mobileoff</td>

         <td>wifion</td>

         <td>wifioff</td>

         <td>uci</td>

         <td>Is used to change the configuration settings on the device. [[Click here|#UCI_API_rule]] for more information on the UCI API rule.</td>

         <td>wakeup</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>

         <td>webon</td>

         <td>weboff</td>

     <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 password authorization:<pre>admin01 vpnon</pre> <font size="-1"><i>(replace admin01 with your device's admin password)</i></font></li>

Every SMS rule can be edited to your liking. If a rule does not meet your requirements, click the click the 'Edit' button next to it. Below are examples of what the configuration page for the <i>reboot</i> rule looks like.

[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general.png|border|class=tlt-border]]

     <li>The <b>Send status SMS to other number</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>

[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_authorization.png|border|class=tlt-border]]

     <li>The <b>Authorization method</b> dropdown selection specifies the type of authorization an SMS rule requires (device admin password, serial number or none).</li>

===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.

<table class="nd-mantable">

         <th>Field</th>

         <th>Description</th>

         <th>Explanation</th>

         <td>Enable</td>

         <td>This check box will enable or disable the Change mobile data settings function</td>

         <td>Allows you to change mobile settings via SMS</td>

         <td>Action</td>

         <td>The action to be performed when this rule is met.</td>

         <td>Changes the specified mobile settings</td>

         <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: '''cellular'''. '''Detailed explanations on how to use this function are presented in the table below'''</td>

         <td>Authorization method</td>

        <td>What kind of authorization to use for SIM management</td>

         <td>Possible values:

        <li>No authorization</li>

        <li>By serial</li>

        <li>By router admin password; default: '''By router admin password'''</li>

         <td>Allowed users</td>

        <td>White list of allowed users</td>

         <td>Possible values:

        <li>From all numbers</li>

        <li>From group</li>

        <li>From single number; default: '''From all numbers'''</li>

         <th>Parameter</th>

         <th>Value</th>

         <th>Description</th>

        <th>Default message example</th>

         <td>apn=</td>

        <td>e.g., internet</td>

         <td>Sets APN</td>

         <td>'''cellular apn=internet'''</td>

         <td>dialnumber=</td>

        <td>e.g., *99***1#</td>

        <td>Sets Dialing number</td>

         <td>'''cellular dialnumber=*99***1#'''</td>

    </tr>

    <tr>

        <td>auth_mode=</td>

        <li>none</li>

        <li>pap</li>

        <li>chap</li>

        </td>

        <li>3gonly</li>

        <li>4gonly</li>

        <li>auto</li>

         <td>Sets the mobile Service mode</td>

        <td>'''cellular service=auto'''</td>

        <td>username=</td>

        <td>Sets the user name for PAP or CHAP authentication</td>

        <td>'''cellular username=user'''</td>

         <td>password=  

        <td>e.g., pass</td>

         <td>Sets the password for PAP or CHAP authentication</td>

         <td>'''cellular password=pass'''</td>

        <td>roaming=</td>

        <td>'''0''' for OFF; '''1''' for ON</td>

        <td>'''cellular roaming=0'''</td>

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

The <b>UCI API</b> rule lets you set or get any parameter from the router's configuration files.

<table class="nd-mantable">

         <th>Field</th>

         <th>Description</th>

         <th>Explanation, notes</th>

         <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>

         <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>

         <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>

         <td>Modem</td>

         <td>Select which modem you want to use</td>

         <td>Which modem is configured</td>

         <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>

         <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>

The following are syntax examples for the UCI API rule:

<table class="nd-mantable">

         <th>Field</th>

         <th>Description</th>

         <th>Explanation, notes</th>

         <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>

         <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>

         <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>

         <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>

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_rutos_manual_mobile_utilities_sms_gateway_post_get_dualmodem_{{{dualmodem}}}.png]]

         <td>http://<span

                style="color: black;">192.168.1.1</span>/cgi-bin/sms_read?username=user1&password=user_pass&number=1

         <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

                style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1

[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_auto_reply_dualmodem_{{{dualmodem}}}.png]]

 

            <li>Everyone</li>

            <li>Listed numbers</li>

            <li>From user group</li>

[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_http.png|border|class=tlt-border]]

         <td>Select whether to ignore or verify server certificate. Available options: <li>Ignore</li> <li>Verify</li>

         <td>Choose witch HTTP request method will be used. Available options: <li>Get</li> <li>Post</li>

[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_sms_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]

         <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'''

[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_email.png|border|class=tlt-border]]

         <td>Add sender's number</td>

         <td>Email group</td>

[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_email_to_sms_forwarding_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]

         <th>Field name</th>

     <td>Secure connection (SSL)</td>

         <td>yes | no; default: <b>no</b></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>

     <td>SMS limit</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>{{#ifeq: {{{dualsim}}} | 1 |

{{#ifeq:{{{name}}}| TRB255| |

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.

To create a new rule, select an 'Action' and click the 'Add' button. The new rule will appear in the 'Call Rules' list. Click the 'Edit' button next to it to configure the rule.

[[File:Networking_rutos_manual_mobile_utilities_call_utilities_edit_button.png|border|class=tlt-border]]

Then you should be redirected to that rule's configuration page. The Call Configuration window is similar to SMS Configuration but less complex.

Call Configuration also has similar Authorization settings.

[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_authorization.png|border|class=tlt-border]]

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_rutos_manual_mobile_utilities_messages_read_messages_dualmodem_1.png|border|class=tlt-border]]

The Send Messages tab let's you send SMS messages from the router‘s SIM card.

All you have to do is enter the recipient’s phone number, type in your message and hit the '''Send''' button.

[[File:Networking_rutos_manual_mobile_utilities_messages_storage_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]

         <td>Save messages on SIM</td>

         <td>off | on; default: <b>on</b></td>

         <td>If this is enabled, messages from SIM card will not be removed after they have been read</td>

         <td>SIM card memory</td>

         <td> -</td>

         <td>default: '''5'''</td>

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