Select Page

RUTX11 Mobile Utilities

Summary #

RUTX11 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 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:RebootSend_statusI/O setI/O statusWifi(on)Wifi(off)Mobile (on)Mobile (off)SSH access (on)SSH access (off)Web access (on)Web access (off)FirstbootSwitch SIMGPS coordinatesGPS (off)GPS (on)Firmware upgradeRMS statusRms connectRms action (on)Rms action (off)Monitoring statusMoreUCI API

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 rutx manual mobile utilities reboot general settings v1.png

SMS rule Authorization settings #

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 NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Send status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Switch mobile data ON/OFF #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

SSH access control #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Web access Control #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Restore to default #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

FW upgrade from server #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Force SIM switch #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

GPS control #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

GPS coordinates #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Monitoring control #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Wake on LAN #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Mobile data limit status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Switch WiFi ON/OFF #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Change I/O state #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

I/O status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Monitoring status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

RMS status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

RMS action #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

RMS status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Get OpenVPN status #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Manage OpenVPN #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Get list of profiles #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

Change profile #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

More #

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

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 NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis check box will enable or disable the Change mobile data settings functionAllows you to change mobile settings via SMS
ActionThe action to be performed when this rule is met.Changes the specified mobile settings
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter. Default: cellularDetailed explanations on how to use this function are presented in the table below
Authorization methodWhat kind of authorization to use for SIM managementPossible values:No authorizationBy serialBy router admin password; Default: By router admin password
Allowed usersWhite list of allowed usersPossible values:From all numbersFrom groupFrom 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.

PARAMETERVALUEDESCRIPTIONDEFAULT MESSAGE EXAMPLE
apn=e.g., internetSets APNcellular apn=internet
dialnumber=e.g., *99***1#Sets Dialing numbercellular dialnumber=*99***1#
auth_mode=nonepapchapSets Authentication methodcellular auth_method=pap
service=3gonly4gonlyautoSets the mobile Service modecellular service=auto
username=e.g., userSets the user name for PAP or CHAP authenticationcellular username=user
password=e.g., passSets the password for PAP or CHAP authenticationcellular password=pass
roaming=0 for OFF; 1 for ONTurn Mobile data roaming ON or OFFcellular 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 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”

UCI API rule #

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

FIELD NAMEDESCRIPTIONExpandEXPLANATION, NOTES

The following are syntax examples for the UCI API rule:

FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
uci get config.section.option”Returns config option valueuci 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 configReturns the contents of a config fileuci show openvpn – returns the contents of the openvpn config file
uci show config.sectionReturns 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.

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 RUTX11 routers.

Post/Get #

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

FieldValueDescription
Enableoff | on; default: offEnable SMS management functionality through POST/GET
User nameDefault: user1User name used for authorization (5 characters minimum). Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
PasswordDefault: user_passPassword 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:

ActionPost/Get URL Examples
View mobile messages listhttp://192.168.1.1/cgi-bin/sms_list?username=user1&password=user_pass
Read mobile messagehttp://192.168.1.1/cgi-bin/sms_read?username=user1&password=user_pass&number=1
Send mobile messagehttp://192.168.1.1/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
View mobile messages totalhttp://192.168.1.1/cgi-bin/sms_total?username=user1&password=user_pass
Delete mobile messagehttp://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 LAN IP or 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 recipientFor 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. 

FieldValueDescription
Enableoff | on; default: offToggles Auto Reply ON or OFF
Reply SMS-Utilities rulesoff | on; default: offIt will reply to sms rules, from SMS-Utilities
Don’t save received messagesoff | on; default: offIf enabled, the router will delete received SMS messages
ModeDefault: EveryoneSpecifies whether to auto reply to every phone number or just just specified phone numbers. Available options:EveryoneListed numbersFrom user group
Message textDefault: ” “The message that will be sent in reply

SMS Forwarding #

This section is a summary of the SMS Forwarding function in RUTX11 routers.

SMS Forwarding To HTTP #

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

FieldValueDescription
Enableoff | on; default: offEnable/disable SMS forwarding to HTTP
Forward SMS-Utilities rulesoff | on; default: offEnable/disable sms-utilities rules forwarding
Don’t save received messageoff | on; default: offSelect whether you want to save forwarded messages or not
Include sender’s numberoff | on; default: offEnable/disable adding original message sender phone number at the end of message text
HTTPS certificate verificationDefault: IgnoreSelect whether to ignore or verify server certificate. Available options:IgnoreVerify
MethodDefault: GetChoose witch HTTP request method will be used. Available options:GetPost
URLDefault: ” “URL to which message is going to be forwarded
Number value nameDefault: ” “Sender phone number code name for query string name/value pair
Message value nameDefault: ” “Message code name for query string name/value pair
Extra data pair 1Default: ” “Extra html query name/value pair. Enter name to the left field and value to right
Extra data pair 2Default: ” “Extra html query name/value pair. Enter name to the left field and value to right
ModeDefault: All messagesChoose which messages are going to be forwarded. Available options:All messagesFrom listed numbersFrom 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 v2.png
FieldValueDescription
Enableoff | on; default: offEnables/disables SMS forwarding to SMS
Forward SMS-Utilities rulesoff | on; default: offEnable/disable sms-utilities rules forwarding
Don’t save received messageoff | on; default: offSelect whether you want to save forwarded messages or not
Add sender’s numberoff | on; default: offEnable/disable adding original message sender phone number at the end of message text. Only added if total message length is up to 480 characters
ModeDefault: All messagesChoose which messages are going to be forwarded. Available options:All messagesFrom listed numbersFrom user group
Recipients phone numbersDefault: ” “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. 

FieldValueDescription
Enableoff | on; default: offEnables/disables SMS forwarding to Email
Forward SMS-Utilities rulesoff | on; default: offEnables/disables sms-utilities rules forwarding
Don’t save received messageoff | on; default: offSelect whether you want to save forwarded messages or not
Add sender’s numberoff | on; default: offEnable/disable adding sender phone number at the end of email text body
SubjectDefault: ” “Subject of an email. Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )
Email groupDefault: ” “Sender’s email configuration
Recipient’s email addressDefault: ” “For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)
ModeDefault: All messagesChoose which messages are going to be forwarded. Available options:All messagesFrom listed numbersFrom 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. 

Field NameValueDescription
Enableoff | on; Default: offTurns Email to SMS Forwarding ON or OFF
POP3 serverhost | ip; Default: noneEmail service provider’s POP3 server address (can be looked up online)
Server portinteger [0..65535]; Default: noneEmail service provider’s POP3 server port (can be looked up online)
User namestring; Default: noneEmail account user name. This is information is used by router in order to atuhenticate itself when connecting to the email client
Passwordstring; Default: noneEmail 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: noSSL 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 limitinteger; Default: 5Limit 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 everytime; Default: 1 minuteEmail inbox check interval
IntervalMinutes | Hours| Days; Default: MinutesEmail 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.

Networking trb manual mobile utilities edit call rule 1.png

Call Configuration window is similar to SMS Configuration, but less complex.  Call Configuration also has similar Authorization settings.

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.

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

FieldValueDescription
Save messages on SIMoff | on; default: onIf this is enabled, messages from SIM card will not be removed after they have been read
Delete forwarded messagesoff | on; default: offIf enabled, all forwarded messages will be automatically deleted
Sim card memoryInformation about used/available SIM card memory
Leave free spaceDefault: 5How much memory (number of messages) should be left free

Submit a Comment

Your email address will not be published. Required fields are marked *