7,849
edits
Changes
Template:Networking rutos manual mobile utilities (view source)
Revision as of 13:59, 22 January 2024
, 22 Januaryno edit summary
{{Template:Networking_rutos_manual_fw_disclosure
{{Template: Networking_device_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.02.05.1
| series = {{{series}}}
| series = {{{series}}}
| name = {{{name}}}
| fw_version ={{Template: Networking_device_manual_latest_fw
| series = {{{series}}}
| name = {{{name}}}
}}
}}
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} SMS Utilities (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} SMS Utilities (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
==Summary==
==Summary==
The <b>Mobile Utilities</b> page is used to configure various SMS 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.
<td><i>cellular</i></td>
<td><i>cellular</i></td>
<td>Is used to configure the device's mobile data connection. [[#Change_mobile_settings_.28cellular.29_rule|Click here]] for more information on this rule.</td>
<td>Is used to configure the device's mobile data connection. [[#Change_mobile_settings_.28cellular.29_rule|Click here]] for more information on this rule.</td>
</tr>{{#ifeq: {{{dualsim}}} | 1 |
<tr>
<td><b>Change profile</b></td>
<td><i>no default text</i></td>
<td>Is used to change profiles on the device. Include the name of the profile that you wish to change to after the rule's SMS text, for example if SMS text is set to <i>changeprof</i>:
<ul>
<li><i>changeprof default</i></li>
<li><i>changeprof custom</i></li>
</ul>
</td>
</tr>
<tr>
<td><b>Execute custom script</b></td>
<td><i>-</i></td>
<td>Executes a custom shell script.</td>
</tr>
</tr>{{#ifeq: {{{dualsim}}} | 1 |{{#ifeq: {{{dualmodem}}} | 0 |
<tr>
<tr>
<td><b>Force SIM switch</b></td>
<td><b>Force SIM switch</b></td>
<td><i>switch_sim</i></td>
<td><i>switch_sim</i></td>
<td>Switches from using one SIM card to another.</td>
<td>Switches from using one SIM card to another.</td>
</tr>|}}
</tr>|}}|}}
<tr>
<td><b>Reset moble connection</b></td>
<td><i>reset_conn</i></td>
<td>Resets mobile connection. Useful when you want to reconnect to the best available operator.</td>
</tr>
<tr>
<td><b>Reload config</b></td>
<td><i>config_reload</i></td>
<td>Reloads the config and all affected services.</td>
</tr>
<tr>
<tr>
<td><b>FW upgrade from server</b></td>
<td><b>FW upgrade from server</b></td>
<td><i>profdisp</i></td>
<td><i>profdisp</i></td>
<td>Sends a list of configuration profiles existing on the device.</td>
<td>Sends a list of configuration profiles existing on the device.</td>
</tr>
</tr>{{#ifeq: {{{gps}}} | 1 |
<tr>
<tr>
<td><b>GPS control</b></td>
<td><b>GPS control</b></td>
<td><i>gps</i></td>
<td><i>gps</i></td>
<td>Sends the device's current GPS coordinates.</td>
<td>Sends the device's current GPS coordinates.</td>
</tr>
</tr>|}}
<tr>
<tr>
<td><b>IP unblock</b></td>
<td><b>IP unblock</b></td>
</ul>
</ul>
</td>
</td>
</tr>{{#ifeq:{{{series}}}|TRB5||
<tr>
<td><b>Mobile Data limit status</b></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}}}_WAN#Mobile_Data_Limit|Mobile Data Limit]] enabled) </td>
</tr>
</tr>
<tr>
<tr>
<td><b>Mobile data limit status</b></td>
<td><b>Mobile Data usage reset</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>Resets mobile data usage for specified interface.</td>
</tr>
</tr>}}
<tr>
<tr>
<td><b>Monitoring status</b></td>
<td><b>Monitoring status</b></td>
</tr>
</tr>
<tr>
<tr>
<td><b>Restore to user's defaults</b></td>
<td><i>userdefaults</i></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}}}
| TRB141|TRB142|TRB145=
| #default=<tr>
<td><b>Wake on LAN</b></td>
<td><b>Wake on LAN</b></td>
<td><i>wakeup</i></td>
<td><i>wakeup</i></td>
<td>Sends a magic packet that "wakes up" a specified device from standby mode. If you have multiple Wake-on-LAN-capable devices, you will have to create a separate rule with a different SMS text for each one. Configuration for each device must include the MAC address of that device.</td>
<td>Sends a magic packet that "wakes up" a specified device from standby mode. If you have multiple Wake-on-LAN-capable devices, you will have to create a separate rule with a different SMS text for each one. Configuration for each device must include the MAC address of that device.</td>}}
</tr>
</tr>
<tr>
<tr>
<td><i>weboff</i></td>
<td><i>weboff</i></td>
<td>Turns HTTP and HTTPS access off. This rule can also modified to turn of either HTTP or HTTPS separately.</td>
<td>Turns HTTP and HTTPS access off. This rule can also modified to turn of either HTTP or HTTPS separately.</td>
</tr>
<tr>
<td><b>API</b></td>
<td><i>api</i></td>
<td>Is used to change the configuration settings on the device. [[#API_rule|Click here]] for more information on the UCI API rule.</td>
</tr>
</tr>
</table>
</table>
<li><b>No authorization</b> - no special keyword required; simply send a rule's <i>SMS Text</i>. For example, to execute the <i>reboot</i> rule without authorization:<pre>reboot</pre></li>
<li><b>No authorization</b> - no special keyword required; simply send a rule's <i>SMS Text</i>. For example, to execute the <i>reboot</i> rule without authorization:<pre>reboot</pre></li>
<li><b>By serial</b> - include the device's serial number before a rule's <i>SMS Text</i>. For example, to execute the <i>iostatus</i> rule with serial authorization:<pre>1111111111 iostatus</pre> <font size="-1"><i>(replace 1111111111 with your device's serial number)</i></font></li>
<li><b>By serial</b> - include the device's serial number before a rule's <i>SMS Text</i>. For example, to execute the <i>iostatus</i> rule with serial authorization:<pre>1111111111 iostatus</pre> <font size="-1"><i>(replace 1111111111 with your device's serial number)</i></font></li>
<li><b>By device admin password</b> - include the device's password before a rule's <i>SMS Text</i>. For example, to execute the <i>vpnon</i> rule with password authorization:<pre>admin01 vpnon</pre> <font size="-1"><i>(replace admin01 with your device's admin password)</i></font></li>
<li><b>By device admin password</b> - include the device's password before a rule's <i>SMS Text</i>. For example, to execute the <i>vpnon</i> rule with admin password authorization:<pre>admin01 vpnon</pre> <font size="-1"><i>(replace admin01 with your device's admin password)</i></font></li>
<li><b>By password</b> - include the configured custom password before a rule's <i>SMS Text</i>. For example, to execute the <i>sshon</i> rule with password authorization:<pre>Custompw1 sshon</pre> <font size="-1"><i>(replace Custompw1 with your configured custom password)</i></font></li>
</ul>
</ul>
<b>General settings</b>
<b>General settings</b>
----
----
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_general_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
<ol>
<ol>
<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>Send status SMS to other number</b> slider specifies whether the device should send a status report message to another number (besides the original sender). Setting this slider to 'on' will prompt you to enter an additional phone number(s) of the status message recipient(s).</li>
<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 text</b> box is used to modify the text that should be included in an SMS rule's response message.</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>
<li>The <b>Gateway modem</b> option is used to specify which modem to use for sending SMS.</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>
<ol>
<ol>
<li>The <b>Authorization method</b> dropdown selection specifies the type of authorization an SMS rule requires (device admin password, serial number or none).</li>
<li>The <b>Authorization method</b> dropdown selection specifies the type of authorization an SMS rule requires (device admin password, serial number, password or none). If <b>By password</b> is selected a <b>Password</b> field will appear and a custom password will be required. A custom password must have at least one uppercase letter, one lowercase letter, one number and must be from a minimum of 8 to a maximum of 80 characters in length. </li>
<li>The <b>Allowed number(s)</b> dropdown selection specifies who can execute an SMS rule (based on phone number).</li>
<li>The <b>Allowed number(s)</b> dropdown selection specifies who can execute an SMS rule (based on phone number).</li>
</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}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_cellular_dualsim_{{{dualsim}}}_{{{dualmodem}}}.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.
<td>Sets APN.</td>
<td>Sets APN.</td>
<td><i>cellular apn=internet</i></td>
<td><i>cellular apn=internet</i></td>
</tr>
<tr>
<td><b>auto_apn=</b></td>
<td>Turns auto APN on or off. Possible values are 0/1.</td>
<td><i>cellular auto_apn=1</i></td>
</tr>
</tr>
<tr>
<tr>
<td>Sets the service mode. Possible values are:
<td>Sets the service mode. Possible values are:
<ul>
<ul>
<li>3gonly</li>
{{#ifeq:{{{2g}}}|1|<li>2g</li>|}}
<li>4gonly</li>
{{#ifeq:{{{3g}}}|1|<li>3g</li>|}}
{{#ifeq:{{{4g}}}|1|<li>lte</li>|}}
{{#ifeq:{{{5g}}}|1|<li>nr5g</li>|}}
<li>mixture of any two modes (ex.: 3g_lte)</li>
<li>auto</li>
<li>auto</li>
</ul>
</ul>
Each example above contains a single parameter but you can also send out multiple parameters in one message. For example:
Each example above contains a single parameter but you can also send out multiple parameters in one message. For example:
cellular apn=internet service=3gonly
cellular apn=internet service=3g
This message would set your APN to "internet" and the service mode of the mobile connection to "3G Only". You can also send a message that would include all of the parameters above:
This message would set your APN to "internet" and the service mode of the mobile connection 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 roaming=0
cellular apn=internet auth_mode=pap service=3g username=user password=pass roaming=0
<b>Note:</b> only "apn=" or "auto_apn=" is required in a message. For example, to set custom APN:
cellular apn=internet
or if you want to turn auto APN on:
cellular auto_apn=1
===UCI API rule===
===UCI API 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.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_utilities_modify_sms_rule_uci_v2.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:
<th width=30%>Structure example</th>
<th width=30%>Structure example</th>
<th width=35%>Description</th>
<th width=35%>Description</th>
<th width=35%>SMS text example</th>
<th width=30%>SMS text example</th>
</tr>
</tr>
<tr>
<tr>
<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>
<!--
<tr>
<tr>
<td>uci <b>delete</b> <config>.<section></td>
<td>uci <b>delete</b> <config>.<section></td>
<td><li><i>uci delete dhcp.lan.force</i></li>Deletes the "force" option for DHCP server of the "lan" interface (which in turn disables the "Force DHCP" function of that DHCP server).</td>
<td><li><i>uci delete dhcp.lan.force</i></li>Deletes the "force" option for DHCP server of the "lan" interface (which in turn disables the "Force DHCP" function of that DHCP server).</td>
</tr>
</tr>
-->
</table>
</table>
The UCI rule requires that you know the names of the configuration files and sections and parameters contained within them. You can find the config file list and some examples of the UCI system usage in our <b>[[UCI command usage]]</b> article.
The UCI rule requires that you know the names of the configuration files and sections and parameters contained within them. You can find the config file list and some examples of the UCI system usage in our <b>[[UCI command usage]]</b> article.
'''Disclaimer''': do not enclose values in '''escape characters''' like you would when executing UCI commands via CLI. For example: '''uci set network.mobile.apn="example"''' will cause an error in SMS API and your value will be altered, as a result, UCI commands execution will fail. Instead, simply write '''uci set network.mobile.apn=example''' without any escape characters or quotes.
===API rule===
----
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]]
----
The following are syntax examples for the API rule:
<table class="nd-othertables_2" style="width: 100%;">
<tr>
<th width=30%>Structure example</th>
<th width=35%>Description</th>
<th width=30%>SMS text example</th>
</tr>
<tr>
<td>api <b>get</b> <method>.<config>.<section></td>
<td>Returns specified config options.</td>
<td><ul><li><i>api get /auto_reboot/periodic/config</i></li></ul>Returns periodic reboot options.</td>
</tr>
<tr>
<td>api <b>post</b><method> <config>.<section>.<option_name>="value"</td>
<td>Sets the value of a specified configuration option.</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>
<td>api <b>put</b> <method> <config>.<section>.<option_name>="value"</td>
<td>Edits a specified config options.</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>
<td>api <b>delete</b> <method> <config>.<section>.<config_id></td>
<td>Deletes a specified configuration.</td>
<td><ul><li><i>api delete /auto_reboot/periodic/config/{id}</i></li></ul>Deletes a specified periodic reboot configuration.</td>
</tr>
</table>
===Custom Rules===
===Custom Rules===
<b>Post/Get</b> allows you to perform action requests by writing them in the URL after your device’s IP address.
<b>Post/Get</b> allows you to perform action requests by writing them in the URL after your device’s IP address.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_post_get_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_post_get_dualmodem_{{{dualmodem}}}_v3.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<td>Enable SMS management functionality through POST/GET
<td>Enable SMS management functionality through POST/GET
</td>
</td>
</tr>
<tr>
<td>Access</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>
</tr>
</tr>
{{#ifeq: {{{dualmodem}}} | 1 |
{{#ifeq: {{{dualmodem}}} | 1 |
<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>
</tr>
<tr>
<td>Send mobile message to a single number</td>
<td>http://<span>style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>Send mobile message</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&number=0037060000001&text=testmessage
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
style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
</td>
</td>
<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 HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.
The SMS Forwarding To HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_http.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_http_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<td>off | on; default: <b>off</b></td>
<td>off | on; default: <b>off</b></td>
<td>Enable/disable adding original message sender phone number at the end of message text</td>
<td>Enable/disable adding original message sender phone number at the end of message text</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 phone group</li>
</ul>
</td>
</tr>
<tr>
<td>Encode message text to Base64</td>
<td>off | on; default: <b>off</b></td>
<td>Message text will be encoded to a Base64 string. Enable this to preserve Unicode characters in the message text.</td>
</tr>
</tr>
<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: <b>none</b></td>
<td>default: <b>none</b></td>
<td>Extra html query name/value pair. Enter name to the left field and value to right</td>
<td>Extra html query name/value pair. Enter name to the left field and value to right</td>
</tr>
</tr>
</table>
</table>
The '''SMS Forwarding To SMS''' function forwards SMS messages to one or several recipients.
The '''SMS Forwarding To SMS''' function forwards SMS messages to one or several recipients.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_sms_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_sms_forwarding_to_sms_dualmodem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
<td>Mode</td>
<td>Mode</td>
<td>default: '''All messages'''</td>
<td>default: '''Everyone'''</td>
<td>Choose which messages are going to be forwarded. Available options: <li>All messages'''
<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.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>
<b>Important note</b>: all POP3 server email messages from inbox will be deleted when using this service.
<b>Important note</b>: all POP3 server email messages from inbox will be deleted when using this service.
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_email_to_sms_forwarding_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_email_to_sms_forwarding_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
<th>Field name</th>
<th>Field</th>
<th>Value</th>
<th>Value</th>
<th>Description</th>
<th>Description</th>
</tr>
</tr>
<tr>
<tr>
<td>Secure connection (SSL)</td>
<td>Secure connection (TLS)</td>
<td>yes | no; default: <b>no</b></td>
<td>off | on; default: <b>off</b></td>
<td><b>SSL</b> is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message</td>
<td>Enables/diables secure connection (TLS 1.2 and up). <b>TLS</b> (Transport Layer Security) is a cryptographic protocol designed to provide communications security over a computer network. TLS uses a combination of symmetric cryptography (sigle secret key known to both sender and receiver to encrypt data) and asymmetric cryptography (a public key known to everyone and a private or secret key known only to the recipient of the message) to encrypt data.</td>
</tr>
</tr>
<tr>
<tr>
<td>SMS limit</td>
<td>Verify TLS certificate validity</td>
<td>off | on; default: <b>off</b></td>
<td>Enables/disables TLS certificate validation. When enabled verifies the validity of the POP3 server certificate</td>
</tr>
<tr>
<td>SMS PDU limit</td>
<td>integer; default: <b>5</b></td>
<td>integer; default: <b>5</b></td>
<td>Limit of SMS count that can be contained in the email body of text, SMS length is limited to 160 seven-bit characters. Emails that contain more symbols than it is specified in this field will not be sent as SMS messages</td>
<td>Longer email text will be sent in multiple PDUs (Protocol Data Units), each of them is approximately 130 characters. Specify maximum allowed PDU count</td>
</tr>
</tr>
<tr>
<tr>
<td>Minutes | Hours| Days; default: <b>Minutes</b></td>
<td>Minutes | Hours| Days; default: <b>Minutes</b></td>
<td>Email inbox check interval</td>
<td>Email inbox check interval</td>
</tr>{{#ifeq: {{{dualsim}}} | 1 |
</tr>{{#ifeq: {{{dualmodem}}} | 1 |
<tr>
<tr>
<td>Gateway modem</td>
<td>Gateway modem</td>
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)
<b>Recommendations note</b>:
<ul>
<li>Email to SMS application can't guarantee best results when working with flooded email inbox. It is recommended to have less than 100 emails in the inbox.</li>
<li>Less emails - better performance.</li>
<li>In most cases it is best to use dedicated inbox. </li>
</ul>
===SMPP===
----
<b>Short Message Peer-to-Peer</b> (<b>SMPP</b>) is a protocol used for exchanging SMS messages between Short Message Service Centers (SMSC) and/or External Short Messaging Entities (ESME). It supports both IPv4 and IPv6 addresses. The figure below is an example of the SMPP section and the table below provides information on the configuration fields contained in that section:
[[File:Networking_rutos_manual_mobile_utilities_sms_gateway_smpp_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>off</b></td>
<td>Turns SMPP on or off.</td>
</tr>
<tr>
<td>User name</td>
<td>string; default: <b>admin</b></td>
<td>User name used for authentication on the SMPP server.</td>
</tr>
<tr>
<td>Password</td>
<td>string; default: <b>admin01</b></td>
<td>Password used for authentication on the SMPP server.</td>
</tr>
<tr>
<td>Server port</td>
<td>integer [0..65535]; default: <b>2775</b></td>
<td>SMPP server port.</td>
</tr>{{#ifeq: {{{dualmodem}}} | 1 |
<tr>
<td>Modem</td>
<td>Primary modem <nowiki>|</nowiki> Secondary modem; default: <b>Primary modem</b></td>
<td>Modem that will be used for SMPP server communications.</td>
</tr>|}}
</table>
{{#switch:{{{name}}}| TRB255 | TRB256 = | #default =
==Call Utilities==
==Call Utilities==
Just like SMS Utilities, Call Utilities provide you with the possibility to issue certain commands to the router from
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.
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.
{{#switch: {{{series}}}
| RUT9|RUT2=<b>Note:</b> Devices with <i>EC25-AFxD</i> (where <i>x</i> is any character) modem do not support voice calls. <b>Call Utilities</b> section is not present on devices with these modems. You can find the module present on your device in [[{{{name}}} System]] page.
| #default=
}}
===Call Rules===
===Call Rules===
----
----
To create a new rule, select an 'Action' and click the 'Add' button. The new rule will appear in the 'Call Rules' list. Click the 'Edit' button next to it to configure the rule.
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_edit_button.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]]
Call Configuration also has similar Authorization settings.
===Incoming Calls===
----
This option specifies the action to be performed on incoming calls. Call utilities rules will keep getting executed while the call is active.
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_call_configuration_authorization.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_call_utilities_incoming_calls.png|border|class=tlt-border]]
}}
==Messages==
==Messages==
With the help of the '''Messages''' window you can read and send SMS messages.
With the help of the <b>Messages</b> window you can read and send SMS messages.
===Read SMS===
===Read Messages===
----
----
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.
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_1.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===
----
----
The Send Messages tab let's you send SMS messages from the router‘s SIM card.
The <b>Send Messages</b> section lets you send SMS messages from the router‘s SIM card.
[[File:Networking_rutos_manual_mobile_utilities_messages_send_messages_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_messages_send_messages_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
All you have to do is enter the recipient’s phone number, type in your message and hit the '''Send''' button.
All you have to do is enter the recipient’s phone number, type in your message and hit the <b>Send</b> button.
===Storage===
===Storage===
In the Storage tab you can find settings associated with message storage.
In the Storage tab you can find settings associated with message storage.
[[File:Networking_rutos_manual_mobile_utilities_messages_storage_dualmodem_{{{dualmodem}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_mobile_utilities_messages_storage_dualmodem_{{{dualmodem}}}_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
</tr>
</tr>
<tr>
<tr>
<td>Save messages on SIM</td>
<td>Save messages to</td>
<td>off | on; default: <b>on</b></td>
<td>SIM card | Modem storage; default: <b>SIM card</b></td>
<td>If this is enabled, messages from SIM card will not be removed after they have been read</td>
<td>Specify location where to save messages</td>
</tr>
</tr>
<tr>
<tr>
<td>Memory</td>
<td>-</td>
<td>SIM card memory</td>
<td> -</td>
<td>Information about used/available SIM card memory</td>
<td>Information about used/available SIM card memory</td>
</tr>
</tr>
<tr>
<tr>
<td>Leave free space</td>
<td>Leave free space</td>
<td>default: '''5'''</td>
<td>integer; default: <b>5</b></td>
<td>How much memory (number of messages) should be left free</td>
<td>How much memory (number of messages) should be left free</td>
</tr>
</tr>
</table>
</table>
[[Category:{{{name}}} Services section]]
[[Category: {{{name}}} Services section]]
