TRB141 Mobile Utilities

From Wiki Knowledge Base | Teltonika Networks
Main Page > TRBxxx Gateways > TRB141 > TRB141 Manual > TRB141 WebUI > TRB141 Mobile Utilities

Summary

TRB 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 trb manual mobile utilities sms rules v1.png

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

All default configuration options are listed below:

  • Reboot
  • Send_status
  • Mobile (on)
  • Mobile (off)
  • SSH_access
  • Web_access
  • Firstboot
  • Fw_upgrade
  • Uci
  • Gpio_direction
  • Gpio_state
  • Iostatus

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.

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

This field appears only if you have checked Get status via SMS after reboot

Reboot


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable SMS reboot functionAllows router to restart via SMS
ActionThe action to be performed when this rule is metReboots the router
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: reboot
Get status via SMS after rebootCheck this to receive connection status via SMS after the rebootIf enabled, the router will send a status message once it has rebooted and is operational again. This is both a separate SMS Rule and an option under the SMS Reboot rule. After checking this, the Send status SMS to other number field will become available
Send status SMS to other numberEnable this if you want the status message to be sent to another (other than the sender) number (s)If this is enabled, you will be prompted to enter a phone number (s)
Message textWhich status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available You can select which status elements to display
Authorization methodWhat kind of authorization to usePossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Send status


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable SMS status functionAllows you to get the router‘s status via SMS. This is both a separate SMS Rule and an option under the SMS Reboot rule
ActionThe action to be performed when this rule is metReturns an SMS message containing information about the status of the router. The type of information contained within the message can be specified in the Message text field
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: status
Send status SMS to other numberEnable this if you want the status message to be sent to another (other than the sender) number (s)If this is enabled, you will be prompted to enter a phone number(s)
Message textWhich status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW available You can select which status elements to display
Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

I/O status


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable SMS I/O status functionAllows you to get the router‘s I/O status via SMS
ActionThe action to be performed when this rule is metReturns an SMS message containing information about the Input/Output status of the router
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: iostatus
Send status SMS to other numberEnable this if you want a status message to be sent to another (other than the sender) number (s)If this is enabled, you will be prompted to enter a phone number (s)
Message textWhich status information should be included in SMS. Default message includes: Configurable Input/Output (3), Configurable Input/Output (4) You can select which status elements to display
Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Switch mobile data ON/OFF


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the Switch mobile data functionAllows mobile control via SMS
ActionThe action to be performed when this rule is metTurn mobile data ON or OFF
StateThe state to which mobile data will be set when this rule is met.If you set is as ON it will turn on mobile data if OFF it will turn it off.
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter; Default text: mobileon or mobileoff
Write to configPermanently saves mobile network stateWith 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

Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

SSH access control


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the SSH access control functionAllows SSH access control via SMS
ActionThe action to be performed when this rule is metTurns SSH access ON or OFF
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: ssh

Enable SSH accessEnables or Disables SSH access from LANIf this is ON, SMS will enable SSH access from LAN, if not, SMS will disable SSH access from LAN
Enable remote SSH accessEnables or Disables SSH access from WANIf this is ON, SMS will enable SSH access from WAN, if not, SMS will disable SSH access from WAN
Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers


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


Networking trb manual mobile utilities ssh access edit v2.png

  • In the next window you can customize whether the rule will turn local/remote SSH access ON or OFF:

Networking trb manual mobile utilities ssh access settings 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 Rules page.

Web access Control


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the Web access control functionAllows Web access control via SMS
ActionThe action to be performed when this rule is metTurns access to WebUI ON or OFF
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: web

Enable HTTP accessEnables or Disables HTTP access from LANIf this is ON, SMS will enable HTTP access from LAN, if not, SMS will disable HTTP access from LAN
Enable remote HTTP accessEnables or Disables HTTP access from WANIf this is ON, SMS will enable HTTP access from WAN, if not, SMS will disable HTTP access from WAN
Enable remote HTTPS accessEnables or Disables HTTPs access from WANIf this is ON, SMS will enable HTTPS access from WAN, if not, SMS will disable HTTPS access from WAN
Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers


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

Networking trb manual mobile utilities web access settings1 v2.png

  • In the next window you can customize whether the rule will turn local/remote HTTP/HTTPS access ON or OFF:

Networking trb manual mobile utilities web access settings2 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


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the Restore to default functionAllows you to restore the router to its default settings via SMS
ActionThe action to be performed when this rule is metExecutes a router Reset, which means the router will reboot after this rule is executed and all custom configurations will be deleted and restored to default
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: restore

Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Force FW upgrade from server


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the FW upgrade from server functionAllows you to upgrade the router‘s FW via SMS
ActionThe action to be performed when this rule is metUpgrades your router's current Firmware to the one uploaded and assigned to your router in FOTA. The router will reboot and be unreachable for a couple of minutes after this rule is executed
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: fw_upgrade

Keep SettingsIf enabled it will keep the existing configurationPossibility to keep settings after firmware upgrade
Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Change GPIO state


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the possibility to change GPIO stateAllows you to change GPIO state via SMS
ActionThe action to be performed when this rule is metChanges GPIO state on the selected output
GPIOWhich socked will be configuredYou can select, on which socket you want to change the settings
StateChanges GPIO state to ON or OFFIf this is switched ON, SMS will change GPIO state to ON , if not, SMS will change it to OFF
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: gpio_state

Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Change GPIO direction


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the possibility to change GPIO directionAllows you to change GPIO direction via SMS
ActionThe action to be performed when this rule is metChanges GPIO direction on the selected output
GPIOWhich socked will be configuredYou can select, on which socket you want to change the settings
GPIO directionChanges GPIO direction to input or outputIf Configurable input is selected the socket direction will be changed to input, if Configurable output is selected the direction will be changed to output
SMS textSMS text that will trigger the ruleSMS text can contain letters, numbers, spaces and special symbols. Capital letters also matter

Default text: gpio_direction

Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

UCI API rule


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

FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable the UCI API functionAllows you to set or get any configurations from the router
ActionThe action to be performed when this rule is met.Sets or sends you any specified configurations of the router
SMS textSMS text that will trigger the ruleSMS 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

Authorization methodWhat kind of authorization to use for SIM managementPossible values:

No authorization | By serial | By router admin password; Default: By router admin password

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

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.

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.

Networking trb manual mobile utilities edit call rule 2.png

Call Configuration also has similar Authorization settings.

Networking trb manual mobile utilities edit call rule auth.png

Reboot


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable call Reboot functionAllows router to restart after receiving a call
ActionThe action to be performed when this rule is metReboots the router
Get status via SMS after rebootCheck this to receive connection status via SMS after the rebootIf enabled, the router will send a status message once it has rebooted and is operational again. This is an option under the Call Reboot rule.
Message textWhich status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW availableYou can select which status elements to display
Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Send status


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable call to receive status functionAllows you to get the router‘s status via SMS after calling it. This is both a separate Call Rule and an option under the Call Reboot rule
ActionThe action to be performed when this rule is metSends 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
Message textWhich status information should be included in SMS. Default message includes: Device name, Wan IP, Data Connection state, Connection type, Signal strength, New FW availableYou can select which status elements to display
Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

Switch mobile data


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
EnableThis will enable or disable call to switch mobile data ON/OFFAllows mobile data control via call
ActionThe action to be performed when this rule is metTurn mobile data ON/OFF
StateThe state to which mobile data will be set when this rule is met.If you set is as ON it will turn on mobile data if OFF it will turn it off.
Write to configPermanently saves mobile network stateWith 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

Allowed usersWhite list of allowed usersPossible values:

From all numbers | From group | From single number; Default: From all numbers

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


The Send SMS tab lets you send SMS messages from the router‘s SIM card.

Networking trb manual mobile utilities send sms v1.png

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


Storage


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.

Networking trb manual mobile utilities store sms v2.png

User Groups

User Groups provides you with the possibility to manage which numbers can use 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 Name text field and clicking the Add button located next to it. Then to add numbers, simply press Edit button.

Networking trb manual mobile utilities groups 1 v1.png

Here is an example, how Modify User Group window looks like.


FIELD NAMEDESCRIPTIONEXPLANATION, NOTES
Group nameName of the groupName of the group of phone numbers. Used for easier management purposes
Phone numberphone number; Default: " "Add numbers to the user group. Must match international format. You can add more phone number fields by clicking on the blue + symbol