Difference between revisions of "SMS Utilities"

From Teltonika Networks Wiki
(Redirected page to SMS Commands)
Tag: New redirect
 
(46 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==Summary==
+
#REDIRECT [[SMS Commands]]
  
RUT 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.
+
{{Template: Networking_device_manual_mutual_page
 
+
| page = Mobile Utilities
==SMS Utilities==
+
}}
 
+
<ul>
===Execution===
+
    <li><b>RUT routers</b>
----
+
        <ul>
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 provided 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.
+
            <li>[[RUT230 SMS Utilities]]</li>
 
+
            <li>[[RUT240 SMS Utilities]]</li>
Here are a few examples of how certain rules can be executed with various Authorization methods:
+
            <li>[[RUT850 SMS Utilities]]</li>
+
            <li>[[RUT900 SMS Utilities]]</li>
{| class="wikitable"
+
            <li>[[RUT950 SMS Utilities]]</li>
|+
+
            <li>[[RUT955 SMS Utilities]]</li>
! style="width: 250px; background: black; color: white;" | Command
+
        </ul>
! style="width: 250px; background: black; color: white;" | Authorization method
+
    </li>
! style="width: 250px; background: black; color: white;" | SMS Text
+
    <li><b>RUTX routers</b>
|-
+
        <ul>
| style="text-align: left; vertical-align: top;" | Status
+
            <li>[[RUTX09 Mobile Utilities]]</li>
| style="vertical-align: top;" | By router admin password
+
            <li>[[RUTX11 Mobile Utilities]]</li>
! style="vertical-align: top;" | ROUTER_PASSWORD status
+
            <li>[[RUTX12 Mobile Utilities]]</li>
|-
+
            <li>[[RUTXR1 Mobile Utilities]]</li>
| style="text-align: left; vertical-align: top;" | Reboot
+
        </ul>
| style="vertical-align: top;" | By serial
+
    </li>
! style="vertical-align: top;" | SERIAL_NUMBER reboot
+
    <li><b>TRB gateways</b>
|-
+
        <ul>
| style="text-align: left; vertical-align: top;" | Switch mobile data off
+
            <li>[[TRB140 Mobile Utilities]]</li>
| style="vertical-align: top;" | No authorization
+
            <li>[[TRB141 Mobile Utilities]]</li>
! style="vertical-align: top;" | mobileoff
+
            <li>[[TRB142 Mobile Utilities]]</li>
|-
+
            <li>[[TRB145 Mobile Utilities]]</li>
|}
+
            <li>[[TRB245 Mobile Utilities]]</li>
 
+
            <li>[[TRB255 Mobile Utilities]]</li>
===Default Rules===
+
        </ul>
 
+
    </li>
The SMS Utilities section contains a list of rules that perform certain actions when they are activated by SMS messages.
+
</ul>
 
 
[[Image:Services sms utils.PNG]]
 
 
 
The figure above is an illustration of the SMS Utilities rules list. The entire list contains 26 rules but you are also be provided with the possibility to configure custom ones.
 
 
 
All default configuration options are listed below:
 
 
*Reboot
 
*Get status
 
*Get I/O status
 
*Get OpenVPN status
 
*Switch WiFi on / off
 
*Switch mobile data on / off
 
*Switch OpenVPN on / off
 
*Change mobile data settings
 
*Get list of profiles
 
*Change profile
 
*SSH access control
 
*Web access control
 
*Restore to default
 
*Force SIM switch
 
*GPS coordinates
 
*GPS on / off
 
*FW upgrade from server
 
*Config update from server
 
*Switch monitoring on / off
 
*Monitoring status
 
*UCI API
 
 
 
===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 section will contain information on editing every signle SMS Utilities rule.
 
 
 
====Reboot====
 
----
 
[[Image:Services sms utils reboot.PNG]]
 
 
 
Above is an example of what an '''SMS Configuration''' window 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.
 
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable SMS reboot function
 
| style="vertical-align: top;" | Allows router restart via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met
 
| Reboots the router
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: '''reboot'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Get status via SMS after reboot
 
| style="vertical-align: top;" | Check this to receive connection status via SMS after the reboot
 
| style="vertical-align: top;" | If checked, 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. After checking this, the '''Send status SMS to other number''' field will become available
 
|-
 
! style="text-align: left; vertical-align: top;" | Send status SMS to other number
 
| style="vertical-align: top;" | Enable this if you want the status message to be sent to another (other than the sender) number (s)
 
| style="vertical-align: top;" | If this is checked, you will be prompted to enter a phone number (s)
 
This field appears only if you have checked '''Get status via SMS after reboot'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Message text
 
| style="vertical-align: top;" | Which status information should be included in SMS:
 
Data state, Operator, Connection type, Signal Strength, Connection State, IP
 
| style="vertical-align: top;" | You can select which status elements to display
 
|-
 
|}
 
 
 
====Status====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable SMS status function
 
| style="vertical-align: top;" | 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
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | 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
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: '''status'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Send status SMS to other number
 
| style="vertical-align: top;" | Enable this if you want the status message to be sent to another (other than the sender) number (s)
 
| style="vertical-align: top;" | If this is checked, you will be prompted to enter a phone number (s)
 
|-
 
! style="text-align: left; vertical-align: top;" | Message text
 
| style="vertical-align: top;" | Which status information should be included in SMS:
 
Data state, Operator, Connection type, Signal Strength, Connection State, IP
 
| style="vertical-align: top;" | You can select which status elements to display
 
|-
 
|}
 
 
 
====Get I/O status====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable SMS I/O status function
 
| style="vertical-align: top;" | Allows you to get the router‘s I/O status via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met
 
| Returns an SMS message containing information about the Input/Output status of the router
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: '''iostatus'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Send status SMS to other number
 
| style="vertical-align: top;" | Enable this if you want a status message to be sent to another (other than the sender) number (s)
 
| style="vertical-align: top;" | If this is checked, you will be prompted to enter a phone number (s)
 
|-
 
|}
 
 
 
====Get OpenVPN status====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable  the OpenVPN status function
 
| style="vertical-align: top;" | Allows to get the router‘s OpenVPN status via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met
 
| Returns an SMS message containing information about an OpenVPN instance's status
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: '''vpnstatus'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Send status SMS to other number
 
| style="vertical-align: top;" | Enable this if you want a status message to be sent to another (other than the sender) number (s)
 
| style="vertical-align: top;" | If this is checked, you will be prompted to enter a phone number (s)
 
|-
 
|}
 
 
 
====Switch WiFi On/Off====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Switch WiFi function
 
| style="vertical-align: top;" | Allows Wi-Fi control via SMS.
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns WiFi ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''wifion''' to turn WiFi ON; '''wifioff''' to turn WiFi OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Write to config
 
| style="vertical-align: top;" | Permanently saves Wi-Fi state
 
| style="vertical-align: top;" | With this setting enabled, the router will keep the new Wi-Fi state even after reboot.
 
If it is not selected, the router will revert the Wi-Fi state after reboot
 
|-
 
|}
 
 
 
====Switch mobile data ON/OFF====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Switch mobile data function
 
| style="vertical-align: top;" | Allows mobile control via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turn mobile data ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''mobileon''' to turn mobile data ON; '''mobileoff''' to turn mobile data OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Write to config
 
| style="vertical-align: top;" | Permanently saves mobile network state
 
| style="vertical-align: top;" | With this setting enabled, the router will keep the new mobile data state even after reboot.
 
If it is not selected, the router will revert the mobile data state after reboot
 
|-
 
|}
 
 
 
====Manage OpenVPN====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Manage OpenVPN function
 
| style="vertical-align: top;" | Allows OpenVPN control via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns an OpenVPN instance ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | 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"'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Get list of profiles====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Get list of profiles function
 
| style="vertical-align: top;" | Allows you to get the list of profiles via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Sends you the list of existing profiles
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''profdisp'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Change profile====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Change profile function
 
| style="vertical-align: top;" | Allows changing profiles via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Changes the current profile to the one specified in the message
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | 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"'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====SSH access Control====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the SSH access control function
 
| style="vertical-align: top;" | Allows SSH access control via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns SSH access ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''ssh'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable SSH access
 
| style="vertical-align: top;" | Enables or Disables SSH access from LAN
 
| style="vertical-align: top;" | If this is checked, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable remote SSH access
 
| style="vertical-align: top;" | Enables or Disables SSH access from WAN
 
| style="vertical-align: top;" | If this is checked, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN
 
|-
 
|}
 
----
 
* Note that by default the ssh rule will '''enable both local and remote SSH access'''. You can change how the rule acts by clicking the "Edit" button located next to it:
 
 
 
[[File:Sms utilities ssh edit v2.png]]
 
----
 
* In the next window you can customize whether the rule will turn local/remote SSH access ON or OFF:
 
 
 
[[File:Sms utilities ssh configuration v2.png]]
 
----
 
If you are using this rule frequently, we suggest that you create a new custom rule. For example, you can use the default rule to turn SSH access ON and use the custom rule to turn SSH access OFF. You can create new SMS Utilities rules from the '''New SMS Rule''' section located at the bottom of the SMS Utilities page.
 
 
 
====Web access Control====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Web access control function
 
| style="vertical-align: top;" | Allows Web access control via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns access to WebUI ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''web'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable HTTP access
 
| style="vertical-align: top;" | Enables or Disables HTTP access from LAN
 
| style="vertical-align: top;" | If this is checked, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable remote HTTP access
 
| style="vertical-align: top;" | Enables or Disables HTTP access from WAN
 
| style="vertical-align: top;" | If this is checked, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable remote HTTPS access
 
| style="vertical-align: top;" | Enables or Disables HTTPs access from WAN
 
| style="vertical-align: top;" | If this is checked, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN
 
|-
 
|}
 
 
 
* Note that by default the web rule will '''enable both local and remote HTTP access''' as well as '''remote HTTPS access'''. You can change how the rule acts by clicking the "Edit" button located next to it:
 
 
 
[[File:Sms utilities web edit v2.png]]
 
 
 
* In the next window you can customize whether the rule will turn local/remote HTTP/HTTPS access ON or OFF:
 
 
 
[[File:Sms utilities web configuration v2.png]]
 
 
 
If you are using this rule frequently, we suggest that you create a new custom rule. For example, you can use the default rule to turn HTTP/HTTPS access ON and use the custom rule to turn HTTP/HTTPS access OFF. You can create new SMS Utilities rules from the '''New SMS Rule''' section located at the bottom of the SMS Utilities page.
 
 
 
====Restore to default====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Restore to default function
 
| style="vertical-align: top;" | Allows you to restore the router to its default settings via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | 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
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''restore'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Force SIM switch====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Force SIM switch function
 
| style="vertical-align: top;" | Allows SIM switch via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | 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)
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''switch_sim'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====GPS Coordinates====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the GPS coordinates function
 
| style="vertical-align: top;" | Allows you to get GPS coordinates via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Sends you GPS coordinates of the router
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''gps'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====GPS ON/OFF====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the GPS ON/OFF function
 
| style="vertical-align: top;" | Allows you to control GPS via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns GPS ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''gpson''' to turn GPS ON; '''gpsoff''' to turn GPS OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Force FW upgrade from server====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the FW upgrade from server function
 
| style="vertical-align: top;" | Allows you to upgrade the router‘s FW via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | 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
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''fw_upgrade'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Force Config update from server====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Config update from server function
 
| style="vertical-align: top;" | Allows you to load a different configuration file on to your router via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Upgrades your router's current Configuration 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
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''config_update'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Switch monitoring ON/OFF====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Switch monitoring function
 
| style="vertical-align: top;" | Allows you to control monitoring status via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns remote monitoring ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''monitoringon''' to turn remote monitoring ON; '''monitoringoff''' to turn remote monitoring OFF;
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Monitoring status====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Monitoring status function
 
| style="vertical-align: top;" | Allows you to get monitoring status via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Returns a text message containing information about remote monitoring status
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''monitoring_status'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
====Switch output ON/OFF====
 
----
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Switch output function
 
| style="vertical-align: top;" | Allows output control via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Turns specified output ON or OFF
 
|-
 
! style="text-align: left; vertical-align: top;" | Active timeout
 
| style="vertical-align: top;" | Make the rule active for a specific time;
 
format: '''seconds'''
 
| '''Example:''' if you configure a rule to turn a specific output on and set a 30 s timeout, the output will activate once the router receives the SMS messages and then it will deactivate after a period of 30 s
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: " "
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Output type
 
| style="vertical-align: top;" | Which output will be activated
 
| style="vertical-align: top;" | Possible values:
 
Digital OC output {{!}} Relay output; Default: '''Digital OC output'''
 
|-
 
|}
 
 
 
'''NOTE:''' No default '''SMS text''' is provided for this rule. It can be created via the '''New SMS Rule''' tab.
 
 
 
===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.
 
 
 
{| class="wikitable"
 
|+ style="text-align: left;" | Change mobile data settings
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the Change mobile data settings function
 
| style="vertical-align: top;" | Allows you to change mobile settings via SMS
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Changes the specified mobile settings
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | 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'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | 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.
 
 
 
{| class="wikitable"
 
|+ style="text-align: left;" | Mobile Settings via SMS parameters
 
! style="width: 250px; background: black; color: white;" | Parameter
 
! style="width: 500px; background: black; color: white;" | Value
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 300px; background: black; color: white;" | Default message example
 
|-
 
! style="text-align: left; vertical-align: top;" | apn=
 
| style="vertical-align: top;" | e.g., internet.gprs
 
| style="vertical-align: top;" | Sets APN
 
| style="vertical-align: top;" | '''cellular apn=internet.gprs'''
 
|-
 
! style="text-align: left; vertical-align: top;" | dialnumber=
 
| style="vertical-align: top;" | e.g., *99***1#
 
| style="vertical-align: top;" | Sets Dialing number
 
| style="vertical-align: top;" | '''cellular dialnumber=*99***1#'''
 
|-
 
! style="text-align: left; vertical-align: top;" | auth_mode=
 
| style="vertical-align: top;" | none {{!}} pap {{!}} chap
 
| style="vertical-align: top;" | Sets Authentication method
 
| style="vertical-align: top;" | '''cellular auth_method=pap'''
 
|-
 
! style="text-align: left; vertical-align: top;" | service=
 
| style="vertical-align: top;" | 2gonly {{!}} 3gonly {{!}} 4gonly {{!}} auto
 
| style="vertical-align: top;" | Sets the mobile Service mode
 
| style="vertical-align: top;" | '''cellular service=auto'''
 
|-
 
! style="text-align: left; vertical-align: top;" | username=
 
| style="vertical-align: top;" | e.g., user
 
| style="vertical-align: top;" | Sets the user name for PAP or CHAP authentication
 
| style="vertical-align: top;" | '''cellular username=user'''
 
|-
 
! style="text-align: left; vertical-align: top;" | password=
 
| style="vertical-align: top;" | e.g., pass
 
| style="vertical-align: top;" | Sets the password for PAP or CHAP authentication
 
| style="vertical-align: top;" | '''cellular password=pass'''
 
|-
 
! style="text-align: left; vertical-align: top;" | roaming=
 
| style="vertical-align: top;" | '''0''' for OFF; '''1''' for ON
 
| style="vertical-align: top;" | Turn Mobile data roaming ON or OFF
 
| style="vertical-align: top;" | '''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.
 
 
 
{| class="wikitable"
 
|+ style="text-align: left;" | UCI API
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Explanation, notes
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | This check box will enable or disable the UCI API function
 
| style="vertical-align: top;" | Allows you to set or get any configurations from the router
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | The action to be performed when this rule is met.
 
| Sets or sends you any specified configurations of the router
 
|-
 
! style="text-align: left; vertical-align: top;" | SMS text
 
| style="vertical-align: top;" | SMS text that will trigger the rule
 
| style="vertical-align: top;" | SMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter
 
Default text: '''uci'''
 
 
 
'''Detailed explanations on how to use this function are presented in the table below'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="vertical-align: top;" | What kind of authorization to use for SIM management
 
| style="vertical-align: top;" | Possible values:
 
No authorization {{!}} By serial {{!}} By router admin password; Default: '''By router admin password'''
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | White list of allowed users
 
| style="vertical-align: top;" | Possible values:
 
From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
|-
 
|}
 
 
 
The following are syntax examples for the UCI API rule:
 
 
 
{| class="wikitable"
 
|+ style="text-align: left;" | UCI API syntax
 
! style="width: 250px; background: black; color: white;" | Syntax
 
! style="width: 500px; background: black; color: white;" | Description
 
! style="width: 950px; background: black; color: white;" | Default message example
 
|-
 
! style="text-align: left; vertical-align: top;" | uci get config.section.option"
 
| style="vertical-align: top;" | Returns config option value
 
| style="vertical-align: top;" | '''uci get network.wan.ipaddr''' - returns the router's WAN IP address
 
|-
 
! style="text-align: left; vertical-align: top;" | uci set config.section.option="value"
 
| style="vertical-align: top;" | Sets config option
 
| style="vertical-align: top;" | '''uci set wireless.wifi-iface.key="12345678"''' - sets WiFi interface's password to 12345678
 
|-
 
! style="text-align: left; vertical-align: top;" | uci show config
 
| style="vertical-align: top;" | Returns the contents of a config file
 
| style="vertical-align: top;" | '''uci show openvpn''' - returns the contents of the openvpn config file
 
|-
 
! style="text-align: left; vertical-align: top;" | uci show config.section
 
| style="vertical-align: top;" | Returns the exact part of a config file (either section or the exact option value)
 
| style="vertical-align: top;" | '''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 '''New SMS Rule''' tab. Select an Action and press the '''Add''' button located next to it.
 
 
 
[[Image:Services sms utils new.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.
 
 
 
==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.
 
 
 
There is only one default rule (Reboot) configured and it is disabled. To make a new rule click the '''Edit''' button located next to the one default rule or make an entirely new entry for you Call Rules list by adding a rule from the New Call Rule tab.
 
 
 
===Call Configuration===
 
----
 
The '''Call Configuration''' window is similar to '''SMS Configuration''', but less complex.
 
 
 
[[Image:Services sms utils call.PNG]]
 
 
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Values
 
! style="width: 950px; background: black; color: white;" | Description
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
| style="vertical-align: top;" | Allows router's Call rules
 
|-
 
! style="text-align: left; vertical-align: top;" | Action
 
| style="vertical-align: top;" | Reboot {{!}} Send status {{!}} Send WiFi {{!}} Send mobile data {{!}} Send output; Default: '''Reboot'''
 
| The action to be performed when this rule is met
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="vertical-align: top;" | From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
| style="vertical-align: top;" | White list of allowed users
 
|-
 
! style="text-align: left; vertical-align: top;" | Get status via SMS after reboot
 
| style="vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
| style="vertical-align: top;" | If checked, the router will send a status message once it has rebooted and is operational again
 
|-
 
! style="text-align: left; vertical-align: top;" | Message text
 
| style="vertical-align: top;" | string; Default: '''Router name - %rn; WAN IP - %wi; Data Connection state - %cs; Connection type - %ct; Signal Strenght - %ss; New FW available - %fs;'''
 
| style="vertical-align: top;" | Which status information should be included in SMS:
 
Data state, Operator, Connection type, Signal Strength, Connection State, IP
 
|-
 
|}
 
 
 
==User Groups==
 
 
 
'''User Groups''' provides you with the possibility to group phone numbers for SMS management purposes. You can then later use these groups in all related SMS and call functionalities. This option helps if there are several Users who should have the same roles when managing the router via SMS or calls. You can create a new user group by entering a name in the '''Group name''' text field and clicking the '''Add''' button located next to it in the '''Create New User Group''' section. After this you will re redirected get to the '''Modify User Group''' section.
 
 
 
[[Image:Services sms utils user groups.PNG]]
 
 
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;" | Field name
 
! style="width: 500px; background: black; color: white;" | Values
 
! style="width: 950px; background: black; color: white;" | Description
 
|-
 
! style="text-align: left; vertical-align: top;" | Group name
 
| style="vertical-align: top;" | string; Default: " "
 
| style="vertical-align: top;" | Name of the group of phone numbers. Used for easier management purposes
 
|-
 
! style="text-align: left; vertical-align: top;" | Phone number
 
| style="vertical-align: top;" | phone number; Default: " "
 
| Add numbers to the user group. Must match international format. You can add more phone number fields by clicking on the green '''+''' symbol
 
|-
 
|}
 
 
 
==SMS Management==
 
 
 
With the help of the '''SMS Management''' 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 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.
 
 
 
[[Image:Services sms utils read.PNG]]
 
 
 
===Send SMS===
 
----
 
The Send SMS tab lets you send SMS messages from the router‘s SIM card.
 
 
 
[[Image:Services sms utils send.PNG]]
 
 
 
All you have to do is enter the recipient’s phone number, type in your message and hit the '''Send''' button. If everything went well, a green bar saying  '''Message sent''' should appear (image below).
 
 
 
[[Image:Services sms utils sent.PNG]]
 
 
 
===Storage===
 
----
 
The Storage tab shows you how much SIM card memory space is used and how much is still available. You can also chose the option for the router to not delete messages. If this option is not used, the router will automatically delete all incoming messages after they have been read. Message status '''read/unread''' is examined every 60 seconds. All '''read''' messages are deleted.
 
 
 
[[Image:Services sms utils store.PNG]]
 
 
 
==Remote Configuration==
 
 
 
RUT routers can be configured via SMS from another RUT router. You only have to select which configuration details have to be sent and type in the phone number of the other router. The router will then generate the SMS Text needed for the configurations to be applied.
 
Total count of SMS is managed automatically. '''You should be aware of the possible number of SMS and use this feature at your own responsibility'''. Generally, it should not be used if you have a high cost per SMS. This is especially relevant if you will try to send a whole OpenVPN configuration, which might accumulate to about 40 SMS messages.
 
 
 
===Receive Configuration===
 
----
 
This section controls how the configuration initiation party should identify itself.
 
 
 
[[Image:Services sms utils receive.PNG]]
 
 
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;"  | Field name
 
! style="width: 250px; background: black; color: white;"  | Values
 
! style="width: 1200px; background: black; color: white;" | Description
 
|-
 
! style="text-align: left; vertical-align: top;" | Enable
 
| style="text-align: left; vertical-align: top;" | string; Default: " "
 
| style="text-align: left; vertical-align: top;" | Name of the group of phone numbers. Used for easier management purposes
 
|-
 
! style="text-align: left; vertical-align: top;" | Authorization method
 
| style="text-align: left; vertical-align: top;" | No authorization {{!}} By serial {{!}} By router admin password; Default: '''No authorization'''
 
| style="text-align: left; vertical-align: top;" | What kind of authorization will be used to authenticate remote configurations
 
|-
 
! style="text-align: left; vertical-align: top;" | Allowed users
 
| style="text-align: left; vertical-align: top;" | From all numbers {{!}} From group {{!}} From single number; Default: '''From all numbers'''
 
| style="text-align: left; vertical-align: top;" | White list of allowed users that can send remote configurations to the router
 
|-
 
|}
 
 
 
===Send Configuration===
 
----
 
This section lets you configure remote RUTxxx devices via SMS. The authorization settings must match those that are set on the receiving party. An example of how sending a new network configuration with both WAN and LAN settings is presented below.
 
 
 
[[Image:Services sms utils send config.PNG]]
 
 
 
{| class="wikitable"
 
|+
 
! style="width: 250px; background: black; color: white;"  | Field name
 
! style="width: 250px; background: black; color: white;"  | Values
 
! style="width: 1200px; background: black; color: white;" | Description
 
|-
 
! style="text-align: left; vertical-align: top;" | Generate SMS
 
| style="text-align: left; vertical-align: top;" | New {{!}} From current configuration; Default: '''New'''
 
| style="text-align: left; vertical-align: top;" | Select whether the configuration will be newly generated or the router's current configuration
 
|-
 
! style="text-align: left; vertical-align: top;" | WAN
 
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
| style="text-align: left; vertical-align: top;" | Select whether to send WAN (Wide Area Network) configurations
 
|-
 
! style="text-align: left; vertical-align: top;" | Interface
 
| style="text-align: left; vertical-align: top;" | Wired {{!}} Mobile; Default: '''Mobile'''
 
| style="text-align: left; vertical-align: top;" | Which interface type will be used for WAN connection on the remote device
 
|-
 
! style="text-align: left; vertical-align: top;" | Primary SIM card
 
| style="text-align: left; vertical-align: top;" | SIM1 {{!}} SIM2; Default: '''SIM1'''
 
| style="text-align: left; vertical-align: top;" | Which SIM card will be used as Primary on the remote device
 
|-
 
! style="text-align: left; vertical-align: top;" | Mobile connection
 
| style="text-align: left; vertical-align: top;" | Use PPP mode {{!}} Use NDIS mode {{!}} Use NCM mode {{!}} Use QMI mode {{!}} Use QMI mode used for Quectel EC25-E modem; Default: '''Use PPP mode'''
 
| style="text-align: left; vertical-align: top;" | Which mobile connection type will be used on the remote device; select according to the remote device's modem:
 
'''NDIS''' for Huawei modems
 
 
 
'''NCM''' for Telit modems
 
 
 
'''QMI''' for Quectel modems
 
 
 
'''PPP''' for any modem
 
|-
 
! style="text-align: left; vertical-align: top;" | APN
 
| style="text-align: left; vertical-align: top;" | string; Default: " "
 
| style="text-align: left; vertical-align: top;" | APN that will be used on the remote device. APN is the name of a gateway between a GPRS or 3G mobile networks and another computer network, frequently the public Internet. APN is provided by your Internet Service Provider (ISP)
 
|-
 
! style="text-align: left; vertical-align: top;" | Dialing number
 
| style="text-align: left; vertical-align: top;" | string; Default: " "
 
| style="text-align: left; vertical-align: top;" | Dialing number that will be used on the remote device. A Dialling number is used to establish a mobile PPP connection
 
|-
 
! style="text-align: left; vertical-align: top;" | Authentication method
 
| style="text-align: left; vertical-align: top;" | CHAP {{!}} PAP {{!} None; Default: '''None'''
 
| style="text-align: left; vertical-align: top;" | Mobile authentication method that will be used on the remote device. Mobile Authentication methods are used to authenticate new connections on your GSM carrier's network
 
|-
 
! style="text-align: left; vertical-align: top;" | User name
 
| style="text-align: left; vertical-align: top;" | string; Default: " "
 
| style="text-align: left; vertical-align: top;" | User name used for new connection authentication with CHAP or PAP authentication methods. This field only becomes visible when you select CHAP or PAP authentication methods.
 
|-
 
! style="text-align: left; vertical-align: top;" | Password
 
| style="text-align: left; vertical-align: top;" | string; Default: " "
 
| style="text-align: left; vertical-align: top;" | Password used for new connection authentication with CHAP or PAP authentication methods. This field only becomes visible when you select CHAP or PAP authentication methods.
 
|-
 
! style="text-align: left; vertical-align: top;" | Service mode
 
| style="text-align: left; vertical-align: top;" | 2G Only {{!}} 2G preferred {{!}} 3G Only {{!}} 3G preferred {{!}} 4G (LTE) Only {{!}} 4G (LTE) preferred {{!}} Automatic; Default: '''3G preferred'''
 
| style="text-align: left; vertical-align: top;" | Mobile service mode that will be used on the remote device
 
|-
 
! style="text-align: left; vertical-align: top;" | LAN
 
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
| style="text-align: left; vertical-align: top;" | Select whether to send LAN (Local Area Network) configurations
 
|-
 
! style="text-align: left; vertical-align: top;" | IP address
 
| style="text-align: left; vertical-align: top;" | ip; Default: " "
 
| style="text-align: left; vertical-align: top;" | LAN IP address that will be used on the remote device
 
|-
 
! style="text-align: left; vertical-align: top;" | IP netmask
 
| style="text-align: left; vertical-align: top;" | ip; Default: " "
 
| style="text-align: left; vertical-align: top;" | A subnet mask that the remote router will use to define how large the LAN network is
 
|-
 
! style="text-align: left; vertical-align: top;" | IP broadcast
 
| style="text-align: left; vertical-align: top;" | ip; Default: " "
 
| style="text-align: left; vertical-align: top;" | A logical address at which all devices connected to a multiple-access communications network are enabled to receive datagrams
 
|-
 
|}
 
 
 
This is an example of only one scenario but you can also send different Network and VPN settings. The settings being sent are the same as they would be configured on your router locally, therefore, you can find information on what different Network and VPN parameters do in [[LAN]], [[WAN]], [[Mobile]] and [[VPN]] pages of this wiki.
 
 
 
==Statistics==
 
 
 
The Statistics page represents information about sent and received SMS messages of both SIM cards. The counters can be reset by clicking the '''Reset''' button next to each SIM card.
 
 
 
[[Image:Services sms utils statistics.PNG]]
 

Latest revision as of 15:14, 8 June 2020