7,851
edits
Changes
Template:Networking rutos manual mobile utilities (view source)
Revision as of 11:58, 22 April 2024
, 22 Aprilno edit summary
==Summary==
==Summary==
The <b>Mobile Utilities</b> page is used to configure various SMS{{#ifeq:{{{name}}}| TRB255| | and Call}} related device control options and to read, send and manage SMS messages and SMS storage space.
The <b>Mobile Utilities</b> page is used to configure various SMS{{#switch:{{{name}}}| TRB255 | TRB256= | #default= and Call}} related device control options and to read, send and manage SMS messages and SMS storage space.
This manual page provides an overview of the Mobile Utilities page in {{{name}}} devices.
This manual page provides an overview of the Mobile Utilities page in {{{name}}} devices.
The <b>SMS Utilities</b> section contains a list of rules that perform certain actions when they are activated by SMS messages.
The <b>SMS Utilities</b> section contains a list of rules that perform certain actions when they are activated by SMS messages.
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_sms_rules.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_sms_rules_v1.png|border|class=tlt-border]]
The entire list contains more than 20 rules, but it does not include all possible SMS actions. You can also create custom rules or modify existing rules. All possible SMS rule actions, their default SMS texts and descriptions are listed in the table below.
The entire list contains more than 20 rules, but it does not include all possible SMS actions. You can also create custom rules or modify existing rules. All possible SMS rule actions, their default SMS texts and descriptions are listed in the table below.
<td><b>Mobile Data limit status</b></td>
<td><b>Mobile Data limit status</b></td>
<td><i>no default text</i></td>
<td><i>no default text</i></td>
<td>Sends a status report message that includes data limit usage information for mobile network interfaces (that have [[{{{name}}}_Interfaces#Mobile_Data_Limit|Mobile Data Limit]] enabled) </td>
<td>Sends a status report message that includes data limit usage information for mobile network interfaces (that have [[{{{name}}}_WAN#Mobile_Data_Limit|Mobile Data Limit]] enabled) </td>
</tr>
</tr>
<tr>
<tr>
<td><b>Restore to user's defaults</b></td>
<td><b>Restore to user's defaults</b></td>
<td><i>userdefaults</i></td>
<td><i>userdefaults</i></td>
<td>Restores user's default configuration on the device. [[{{{name}}}_Backup#Create_default_configuration|Click here]] for more information on User's default configuration.</td>
<td>Restores user's default configuration on the device. [[{{{name}}}_Maintenance#Create_default_configuration|Click here]] for more information on User's default configuration.</td>
</tr>{{#switch:{{{name}}}
</tr>{{#switch:{{{name}}}
| TRB141|TRB142|TRB145=
| TRB141|TRB142|TRB145=
===Modify SMS Rule===
===Modify SMS Rule===
----
----
Every SMS rule can be edited to your liking. To begin configuring a rule, click the click the 'Edit' button located next to it:
Every SMS rule can be edited to your liking. To begin configuring a rule, click the click the 'Edit' button under "Actions" column:
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_edit_button.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_edit_button_v1.png|border|class=tlt-border]]
After this you should redirected to configuration page for that rule. Below are examples of what the configuration page for the <i>reboot</i> rule looks like.
After this you should redirected to configuration page for that rule. Below are examples of what the configuration page for the <i>reboot</i> rule looks like.
<b>General settings</b>
<b>General settings</b>
----
----
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
<ol>
<ol>
<li>The <b>Enable</b> slider turn the rule on or off. In order to use a rule, this slider must be set to 'on'. By default, all existing SMS rules are turned on.</li>
<li>The <b>Enable</b> slider turn the rule on or off. In order to use a rule, this slider must be set to 'on'. By default, all existing SMS rules are turned on.</li>
<li>The <b>Action</b> dropdown selection specifies which action should be performed when the rule is executed.</li>
<li>The <b>Action</b> dropdown selection specifies which action should be performed when the rule is executed.</li>
{{#ifeq: {{{dualmodem}}} | 1 |<li>The <b>Receiving modem</b>, which is used to receive the message.</li>|}}
<li>The <b>SMS text</b> field specifies the text that will trigger the rule upon receiving a message.</li>
<li>The <b>SMS text</b> field specifies the text that will trigger the rule upon receiving a message.</li>
<li>The <b>Get status via SMS after reboot</b> slider specifies whether the device should send a status report message after an action is executed. The name of this slider may differ from rule to rule and it is only available for some rules.</li>
<li>The <b>Get status via SMS after reboot</b> slider specifies whether the device should send a status report message after an action is executed. The name of this slider may differ from rule to rule and it is only available for some rules.</li>
<li>The <b>Message forwarding</b> slider specifies whether the device should send a status report message to another number (besides the original sender). Setting this slider to 'on' will prompt you to enter an additional phone number(s) of the status message recipient(s).</li>
<li>The <b>Message forwarding</b> slider specifies whether the device should send a status report message to another number (besides the original sender). Setting this slider to 'on' will prompt you to enter an additional phone number(s) of the status message recipient(s).</li>
{{#ifeq: {{{dualmodem}}} | 1 |<li>The <b>Modem</b> option is used to specify which modem to get<nowiki>/</nowiki>set information to<nowiki>/</nowiki>from.</li>
{{#ifeq: {{{dualmodem}}} | 1 |<li>The <b>Modem</b>, which is used to get information from or managed for change mobile settings action.</li>|}}
<li>The <b>Message text</b> box is used to modify the text that should be included in an SMS rule's response message.</li>
<li>The <b>Text messagetext</b> box is used to modify the text that should be included in an SMS rule's response message.</li>
</ol>
</ol>
<b>Authorization</b>
<b>Authorization</b>
----
----
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_authorization.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_authorization_v1.png|border|class=tlt-border]]
<ol>
<ol>
The <b>Change mobile settings</b> rule is used to change the configuration settings of the mobile data connection. The usage of this rule is a bit more complex because the SMS text in and of itself does nothing, as you must also specify the parameters and values that you wish to set. For example, you can send a message that will change your APN only or a message that will change multiple parameters at once.
The <b>Change mobile settings</b> rule is used to change the configuration settings of the mobile data connection. The usage of this rule is a bit more complex because the SMS text in and of itself does nothing, as you must also specify the parameters and values that you wish to set. For example, you can send a message that will change your APN only or a message that will change multiple parameters at once.
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_cellular_dualsim_{{{dualsim}}}_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_cellular_dualsim_{{{dualsim}}}_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
Below is the full list of parameters that can be changed with this rule.
Below is the full list of parameters that can be changed with this rule.
The <b>UCI API</b> rule is used to configure any parameters on the device.
The <b>UCI API</b> rule is used to configure any parameters on the device.
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_uci_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_uci_{{{dualmodem}}}_v4.png|border|class=tlt-border]]
----
----
The following are syntax examples for the UCI API rule:
The following are syntax examples for the UCI API rule:
<td>uci <b>get</b> <config>.<section>.<option_name></td>
<td>uci <b>get</b> <config>.<section>.<option_name></td>
<td>Returns the value of a single configuration option.</td>
<td>Returns the value of a single configuration option.</td>
<td><li><i>uci get network.wan.ipaddr</i></li>Returns the router's WAN IP address.</td>
<td><ul><li><i>uci get network.wan.ipaddr</i></li></ul>Returns the router's WAN IP address.</td>
</tr>
</tr>
<tr>
<tr>
<td>uci <b>set</b> <config>.<section>.<option_name>="value"</td>
<td>uci <b>set</b> <config>.<section>.<option_name>="value"</td>
<td>Sets the value of a specified configuration option.</td>
<td>Sets the value of a specified configuration option.</td>
<td><li><i>uci set network.mobile.apn=example</i></li>Changes mobile APN value to "example".</td>
<td><ul><li><i>uci set network.mobile.apn=example</i></li></ul>Changes mobile APN value to "example".</td>
</tr>
</tr>
<tr>
<tr>
<td>uci <b>show</b> <config></td>
<td>uci <b>show</b> <config></td>
<td>Returns the contents of a config file</td>
<td>Returns the contents of a config file</td>
<td><li><i>uci show openvpn</i></li>Returns the contents of the "openvpn" config file.</td>
<td><ul><li><i>uci show openvpn</i></li></ul>Returns the contents of the "openvpn" config file.</td>
</tr>
</tr>
<tr>
<tr>
<td>uci <b>show</b> <config>.<section></td>
<td>uci <b>show</b> <config>.<section></td>
<td>Returns the exact part (section) of a config file.</td>
<td>Returns the exact part (section) of a config file.</td>
<td><li><i>uci show network.lan</i></li>Returns the configuration of the "lan" section from the "network" config file.</td>
<td><ul><li><i>uci show network.lan</i></li></ul>Returns the configuration of the "lan" section from the "network" config file.</td>
</tr>
</tr>
<!--
<!--
API allows creating, reading, updating, or deleting configurations using the allowed API endpoints from a list.
API allows creating, reading, updating, or deleting configurations using the allowed API endpoints from a list.
[[File:Networking rutos manual mobile utilities sms utilities modify sms rule api v1.png|border|class=tlt-border]]
[[File:Networking rutos manual mobile utilities sms utilities modify sms rule api {{{dualmodem}}}_v3.png|border|class=tlt-border]]
----
----
The following are syntax examples for the API rule:
The following are syntax examples for the API rule:
<td>api <b>get</b> <method>.<config>.<section></td>
<td>api <b>get</b> <method>.<config>.<section></td>
<td>Returns specified config options.</td>
<td>Returns specified config options.</td>
<td><li><i>api get /auto_reboot/periodic/config</i></li>Returns periodic reboot options.</td>
<td><ul><li><i>api get /auto_reboot/periodic/config</i></li></ul>Returns periodic reboot options.</td>
</tr>
</tr>
<tr>
<tr>
<td>api <b>post</b><method> <config>.<section>.<option_name>="value"</td>
<td>api <b>post</b><method> <config>.<section>.<option_name>="value"</td>
<td>Sets the value of a specified configuration option.</td>
<td>Sets the value of a specified configuration option.</td>
<td><li><i>api post /auto_reboot/periodic/config {"data": {"action": "1", "period": "week", "days": ["mon"], "time": ["12:00"]}}</i></li>Creates a periodic reboot configuration with options to reboot device every monday on 12:00.</td>
<td><ul><li><i>api post /auto_reboot/periodic/config {"data": {"action": "1", "period": "week", "days": ["mon"], "time": ["12:00"]}}</i></li></ul>Creates a periodic reboot configuration with options to reboot device every monday on 12:00.</td>
</tr>
</tr>
<tr>
<tr>
<td>api <b>put</b> <method> <config>.<section>.<option_name>="value"</td>
<td>api <b>put</b> <method> <config>.<section>.<option_name>="value"</td>
<td>Edits a specified config options.</td>
<td>Edits a specified config options.</td>
<td><li><i>api put /auto_reboot/periodic/config/{id} {"data": { "enable": "1"}}</i></li>Sets a specified periodic reboot config to enabled.</td>
<td><ul><li><i>api put /auto_reboot/periodic/config/{id} {"data": { "enable": "1"}}</i></li></ul>Sets a specified periodic reboot config to enabled.</td>
</tr>
</tr>
<tr>
<tr>
<td>api <b>delete</b> <method> <config>.<section>.<config_id></td>
<td>api <b>delete</b> <method> <config>.<section>.<config_id></td>
<td>Deletes a specified configuration.</td>
<td>Deletes a specified configuration.</td>
<td><li><i>api delete /auto_reboot/periodic/config/{id}</i></li>Deletes a specified periodic reboot configuration.</td>
<td><ul><li><i>api delete /auto_reboot/periodic/config/{id}</i></li></ul>Deletes a specified periodic reboot configuration.</td>
</tr>
</tr>
</table>
</table>
<tr>
<tr>
<td>Access</td>
<td>Access</td>
<td>mobile_data | sms_delete | sms_list | sms_read | sms_send | sms_total; default: <b>mobile_data, sms_delete, sms_list, sms_read, sms_send, sms_total</b></td>
<td>mobile_data | mobile_sim_pin | sms_delete | sms_list | sms_read | sms_send | sms_total; default: <b>mobile_data, sms_delete, sms_list, sms_read, sms_send, sms_total</b></td>
<td>Methods available for Post/Get. All methods are allowed if this list is left empty.</td>
<td>Methods available for Post/Get. All methods are allowed if this list is left empty.</td>
</tr>
</tr>
<tr>
<tr>
<td>Read mobile message</td>
<td>Read mobile message</td>
<td>http://<span
<td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_read?username=user1&password=user_pass&number=1
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>Send mobile message to a single number</td>
<td>Send mobile message to a single number</td>
<td>http://<span
<td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>Send mobile message to a group</td>
<td>Send mobile message to a group</td>
<td>http://<span
<td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&group=group_name&text=testmessage
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>Delete mobile message</td>
<td>Delete mobile message</td>
<td>http://<span
<td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
</td>
</td>
</tr>
</tr>
<b>Auto reply</b> allows you to configure automatic replying to SMS messages that the router receives.
<b>Auto reply</b> allows you to configure automatic replying to SMS messages that the router receives.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_auto_reply_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_auto_reply_dualmodem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<td>default: '''Everyone'''</td>
<td>default: '''Everyone'''</td>
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<ul>
<li>Everyone</li>
<li>Listed numbers</li>
<li>From user group</li>
</ul>
</td>
</td>
</tr>
</tr>
<td>default: '''Everyone'''</td>
<td>default: '''Everyone'''</td>
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<ul>
<li>Everyone</li>
<li>Listed numbers</li>
<li>From phone group</li>
</ul>
</td>
</td>
</tr>
</tr>
<td>HTTPS certificate verification</td>
<td>HTTPS certificate verification</td>
<td>default: '''Ignore'''</td>
<td>default: '''Ignore'''</td>
<td>Select whether to ignore or verify server certificate. Available options: <li>Ignore</li> <li>Verify</li>
<td>Select whether to ignore or verify server certificate. Available options: <ul><li>Ignore</li> <li>Verify</li></ul>
</td>
</td>
</tr>
</tr>
<td>Method</td>
<td>Method</td>
<td>default: '''Get'''</td>
<td>default: '''Get'''</td>
<td>Choose witch HTTP request method will be used. Available options: <li>Get</li> <li>Post</li>
<td>Choose witch HTTP request method will be used. Available options: <ul><li>Get</li> <li>Post</li></ul>
</td>
</td>
</tr>
</tr>
<td>default: '''Everyone'''</td>
<td>default: '''Everyone'''</td>
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<ul>
<li>Everyone</li>
<li>Listed numbers</li>
<li>From user group</li>
</ul>
</td>
</td>
</tr>
</tr>
The '''SMS Forwarding To Email''' function forwards SMS messages to email.
The '''SMS Forwarding To Email''' function forwards SMS messages to email.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_email_v1.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_email_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
</tr>
</tr>
<tr>
<tr>
<td>Add sender's number</td>
<td>Include sender's number</td>
<td>off | on; default: <b>off</b></td>
<td>off | on; default: <b>off</b></td>
<td>Enable/disable adding sender phone number at the end of email text body</td>
<td>Enable/disable adding sender phone number at the end of email text body</td>
</tr>
<tr>
<td>Mode</td>
<td>default: '''Everyone'''</td>
<td>Specifies whether to auto reply to every phone number or just just specified phone numbers. Available options:
<ul>
<li>Everyone</li>
<li>Listed numbers</li>
<li>From user group</li>
</ul>
</td>
</tr>
</tr>
<tr>
<tr>
</tr>
</tr>
<tr>
<tr>
<td>Email group</td>
<td>Sender's email account</td>
<td>default: <b>none</b></td>
<td>default: <b>none</b></td>
<td>Sender's email configuration</td>
<td>Sender's email configuration</td>
<td>default: <b>none</b></td>
<td>default: <b>none</b></td>
<td>For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)</td>
<td>For whom you want to send an email to. Allowed characters (a-zA-Z0-9._%+-)</td>
</tr>
</tr>
</table>
</table>
</tr>|}}
</tr>|}}
</table>
</table>
{{#ifeq:{{{name}}}| TRB255| |
{{#switch:{{{name}}}| TRB255 | TRB256 = | #default =
==Call Utilities==
==Call Utilities==
----
----
To create a new rule, select an 'Action' and click the 'Add' button. After this, a new configuration window should appear.
To create a new rule, select an 'Action' and click the 'Add' button. After this, a new configuration window should appear.
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_authorization.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_general_{{{dualmodem}}}_v4.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_authorization_v1.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_incoming_calls.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_incoming_calls.png|border|class=tlt-border]]
}}
}}
==Messages==
==Messages==
In the <b>Read Messages</b> section you can read and delete received/stored SMS messages. The layout is simple, there is a list of received SMS messages and you can choose how many entries of that list should be visible at one time with SMS per page drop box in the top left corner of the page and there is a Search field to help you navigate more efficiently through the list of messages in the top right corner of the page.
In the <b>Read Messages</b> section you can read and delete received/stored SMS messages. The layout is simple, there is a list of received SMS messages and you can choose how many entries of that list should be visible at one time with SMS per page drop box in the top left corner of the page and there is a Search field to help you navigate more efficiently through the list of messages in the top right corner of the page.
[[File:Networking_rutos_manual_mobile_utilities_messages_read_messages_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_messages_read_messages_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
===Send Messages===
===Send Messages===
