Template:Networking rutos manual cloud solutions: Difference between revisions
No edit summary |
No edit summary |
||
(48 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
{{Template: | {{Template: Networking_device_manual_fw_disclosure | ||
| 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}}} IoT Platforms (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}}} IoT Platforms (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>|}} | |||
__TOC__ | __TOC__ | ||
==Summary== | |||
The <b>Cloud Solutions</b> section is used to configure how the device will connect to certain cloud management systems. | |||
This chapter of the user manual provides an overview of the Cloud Solutions page for {{{name}}} devices. | |||
<u><b>Note:</b> Each Cloud Solutions service, except RMS, is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u> | |||
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer | |||
| series = {{{series}}} | |||
}} | |||
==RMS== | ==RMS== | ||
<b>RMS</b> (<b>Remote Management System</b>) is a cloud system designed by Teltonika and intended for remote monitoring and management of | <b>RMS</b> (<b>Remote Management System</b>) is a cloud system designed by Teltonika and intended for remote monitoring and management of [[Main Page|Teltonika-Networks products]]. | ||
In order to add a device(s) to RMS, get yourself acquainted by watching [https://www.youtube.com/watch?v=bZeqdrAcdVU this instructional video] and register an account by [https://rms.teltonika.lt/ clicking here]. <b>Each unique device receives a free month-long RMS license</b> when added to RMS for the first time. | In order to add a device(s) to RMS, get yourself acquainted by watching [https://www.youtube.com/watch?v=bZeqdrAcdVU this instructional video] and register an account by [https://rms.teltonika.lt/ clicking here]. <b>Each unique device receives a free month-long RMS license</b> when added to RMS for the first time. | ||
Line 19: | Line 30: | ||
The figure below is a screenshot of the RMS section taken from a device which has been connected to RMS: | The figure below is a screenshot of the RMS section taken from a device which has been connected to RMS: | ||
[[File:Networking_rutos_manual_setup_wizard_rms_{{{rms}}}_v4.png|border|class=tlt-border]] | |||
| | |||
<table class="nd-mantable"> | <table class="nd-mantable"> | ||
Line 51: | Line 58: | ||
<td>integer [0..65535]; default: <b>15009</b></td> | <td>integer [0..65535]; default: <b>15009</b></td> | ||
<td>Port number for connecting to RMS. If you're using regular RMS, just leave the default port (<i>15009</i>).</td> | <td>Port number for connecting to RMS. If you're using regular RMS, just leave the default port (<i>15009</i>).</td> | ||
</tr> | |||
<tr> | |||
<td>Authentication code</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Authentication code provided by RMS after adding the device.</td> | |||
</tr> | </tr> | ||
</table> | </table> | ||
Line 58: | Line 70: | ||
The RMS server waits for incoming connections. Since the device attempts to connect at a fixed interval, it may not connect instantly after you add it to RMS. While it is disconnected, you can check how much time is left until the next connection attempt in the Status section: | The RMS server waits for incoming connections. Since the device attempts to connect at a fixed interval, it may not connect instantly after you add it to RMS. While it is disconnected, you can check how much time is left until the next connection attempt in the Status section: | ||
{{#ifeq:{{{ | [[File:Networking_rutos_manual_cloud_solutions_rms_disconnected_rms_{{{rms}}}_v5.png|border|class=tlt-border]] | ||
[[File: | |||
| | To speed up the process by initiating an immediate connection attempt, click the <b>Connect</b> button. | ||
[[File: | |||
}} | [[File:Networking_rutos_manual_cloud_solutions_rms_connect_{{{rms}}}_v3.png|border|class=tlt-border]] | ||
If a failure or unknown status occurs, there is an alternative to try to reconnect again, click the <b>Reconnect</b> button. | |||
[[File:Networking_rutos_manual_cloud_solutions_rms_reconnect_{{{rms}}}_v3.png|border|class=tlt-border]] | |||
When the device is already connected a <b>Reset</b> button becomes visible. Use it to terminate the device's connection to RMS. | |||
[[File:Networking_rutos_manual_cloud_solutions_rms_unregister_{{{rms}}}_v3.png|border|class=tlt-border]] | |||
For more information on Teltonika Networks Remote Management System (RMS) refer to the <b>[[RMS Manual]]</b> or <b>[[RMS FAQ]]</b> pages. | |||
==Azure IoT Hub== | |||
<b>Azure IoT Hub</b> is Microsoft's ever-expanding set of cloud services to help your organization meet your business challenges. Azure IoT Hub is compatible with Teltonika Networks devices. | |||
{{#ifeq: {{{modem}}} | 1 | | |||
The figure and table below provides explanations for Azure IoT Hub configuration parameters when selected 'Message Type' is <i>GSM values</i>. | |||
[[File:Networking_rutos_manual_cloud_solutions_azure_iot_hub_modem_1.png|border|class=tlt-border]] | |||
<table class="nd-mantable"> | |||
<tr> | |||
<th>Field</th> | |||
<th>Value</th> | |||
<th>Description</th> | |||
</tr> | |||
<tr> | |||
<td>Enable Azure IoT Hub monitoring</td> | |||
<td>off <nowiki>|</nowiki> on; default: <b>off</b></td> | |||
<td>Turns the Azure IoT Hub service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Connection string</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Unique connection string a.k.a. server address provided by the Azure Iot Hub service.</td> | |||
</tr> | |||
<tr> | |||
<td>Message Type</td> | |||
<td>GSM values <nowiki>|</nowiki> MQTT messages; default: <b>MQTT messages</b></td> | |||
<td>Values that are to be sent to the Azure server.</td> | |||
</tr> | |||
<tr> | |||
<td>Message sending interval (sec.)</td> | |||
<td>integer; default: <b>300</b></td> | |||
<td>Device data sending frequency in seconds. Minimum value is 10 s.</td> | |||
</tr> | |||
<tr> | |||
<td>Mobile Interface</td> | |||
<td>mobile interface; default: <b>mobs1a1</b></td> | |||
<td>Interface name for which IP address and sent/received bytes should be selected.</td> | |||
</tr> | |||
<tr> | |||
<td>GSM Values</td> | |||
<td>IMSI <nowiki>|</nowiki> IP Address <nowiki>|</nowiki> RSRP <nowiki>|</nowiki> ICCID {{#ifeq:{{{series}}}|TRB5||<nowiki>|</nowiki> Bytes received }}<nowiki>|</nowiki> Cell ID <nowiki>|</nowiki> RSCP <nowiki>|</nowiki> PIN state <nowiki>|</nowiki> Manufacturer <nowiki>|</nowiki>{{#ifeq:{{{series}}}|TRB5|| Bytes sent <nowiki>|</nowiki>}} RSRQ <nowiki>|</nowiki> Revision number <nowiki>|</nowiki> Serial number <nowiki>|</nowiki> ECIO <nowiki>|</nowiki> SINR <nowiki>|</nowiki>Data carrier type <nowiki>|</nowiki> Network link state <nowiki>|</nowiki> Operator <nowiki>|</nowiki> PIN count <nowiki>|</nowiki> Signal level <nowiki>|</nowiki> Model <nowiki>|</nowiki> Connection state <nowiki>|</nowiki> Temperature <nowiki>|</nowiki> IMEI <nowiki>|</nowiki> SIM card state <nowiki>|</nowiki> Operator number; default: <b>none</b></td> | |||
<td>Selects the mobile connection values that to be sent to the Azure IoT Hub service.</td> | |||
</tr> | |||
</table>|}}The figure and table below provides explanations for Azure IoT Hub configuration parameters{{#ifeq:{{{modem}}}|1| when selected 'Message Type' is <i>MQTT messages</i>|}}. | |||
[[File:Networking_rutos_manual_cloud_solutions_azure_iot_hub_modem_0_v2.png|border|class=tlt-border]] | |||
<table class="nd-mantable"> | |||
<tr> | |||
<th>Field</th> | |||
<th>Value</th> | |||
<th>Description</th> | |||
</tr> | |||
<tr> | |||
<td>Enable Azure IoT Hub monitoring</td> | |||
<td>off | on; default: <b>off</b></td> | |||
<td>Turns the Azure IoT Hub service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Connection string</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Unique connection string a.k.a. server address provided by the Azure Iot Hub service.</td> | |||
</tr> | |||
<tr> | |||
<td>Message Type</td> | |||
<td>{{#ifeq:{{{modem}}}|1|GSM values <nowiki>|</nowiki>|}} MQTT messages; default: <b>MQTT messages</b></td> | |||
<td>Values that are to be sent to the Azure server.</td> | |||
</tr> | |||
<tr> | |||
<td>MQTT Host</td> | |||
<td>ip | host; default: <b>none</b></td> | |||
<td>MQTT broker's IP address or hostname.</td> | |||
</tr> | |||
<tr> | |||
<td>MQTT Port</td> | |||
<td>integer [0..65535]; default: <b>none</b></td> | |||
<td>MQTT broker's IP port number.</td> | |||
</tr> | |||
<tr> | |||
<td>Topic</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>MQTT topic to be used for publishing the data.</td> | |||
</tr> | |||
<tr> | |||
<td>Username</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Username used for authentication to the MQTT broker.</td> | |||
</tr> | |||
<tr> | |||
<td>Require password</td> | |||
<td><span style="color:red">on</span> | off; default: <b>off</b></td> | |||
<td>Enables password field.</td> | |||
</tr> | |||
<tr> | |||
<td><span style="color:red">Password</span></td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Password used for authentication to the MQTT broker.</td> | |||
</tr> | |||
</table> | |||
==Cloud of Things== | |||
The <b>Cloud of Things</b> is an IoT cloud platform which provides the possibility to remotely monitor, manage and control your connected devices and machines – plug-and-play, without extensive installation. | |||
[[File:Networking_rutos_manual_cloud_solutions_cloud_of_things_v1.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 the Cloud of Things service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Server Address</td> | |||
<td>ip | host; default: <b>none</b></td> | |||
<td>Cloud of Things server IP address or hostname.</td> | |||
</tr> | |||
<tr> | |||
<td>Interval</td> | |||
<td>integer; default: <b>none</b></td> | |||
<td>Push connection interval in minutes.</td> | |||
</tr> | |||
<tr> | |||
<td>Reset Auth</td> | |||
<td>- (interactive button)</td> | |||
<td>Resets authentication data so that device could be re-registered on the Cloud of Things Device Management platform.</td> | |||
</tr> | |||
</table> | |||
==Cumulocity== | |||
<b>Cumulocity IoT</b> is a cloud-based, real-time IoT management platform that's also compatible with Teltonika-Networks devices. | |||
The figure and table below provide explanations for Cumulocity configuration parameters available on the device. For a detailed configuration guide, [[Cumulocity Configuration|click here]]. | |||
[[File:Networking_rutos_manual_cloud_solutions_cumulocity_v1.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 the Cumulocity service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Use SSL/TLS</td> | |||
<td>off | on; default: <b>off</b></td> | |||
<td>Turn SSL/TLS protocol support on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Server Address</td> | |||
<td>host; default: <b>none</b></td> | |||
<td>Hostname of your Cumulocity server. It should match the <i>Environment name</i> from the Cumulocity registration.<br>For example: <i><nowiki>teltonika-networks.</nowiki><b><nowiki>eu-latest.cumulocity.com</nowiki></b></i></td> | |||
</tr> | |||
<tr> | |||
<td>Interval</td> | |||
<td>integer; default: <b>none</b></td> | |||
<td>Connection push interval in minutes. This field defines how often the device will try to connect to the Cumulocity server.</td> | |||
</tr> | |||
<tr> | |||
<td>Reset Auth</td> | |||
<td>- (interactive button)</td> | |||
<td>Resets authentication for this device. If you click this, you'll have to authorize this from Cumulocity dashboard before it can successfully connect to the server.</td> | |||
</tr> | |||
</table> | |||
==ThingWorx== | |||
[[File:Networking_rutos_manual_cloud_solutions_thingworx_modem_{{{modem}}}.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 the ThingWorx service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Server Address</td> | |||
<td>ip | host; default: <b>none</b></td> | |||
<td>Thingworx server IP address or hostname.</td> | |||
</tr> | |||
<tr> | |||
<td>Server Port</td> | |||
<td>integer [0..65535]; default: <b>none</b></td> | |||
<td>Thingworx server's port number.</td> | |||
</tr> | |||
<tr> | |||
<td>Thing Name</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Thing name defined in ThingWorx CP.</td> | |||
</tr> | |||
<tr> | |||
<td>Application Key</td> | |||
<td>string; default: <b>none</b></td> | |||
<td>Application key generated in ThingWorx CP.</td> | |||
</tr>{{#ifeq:{{{modem}}}|1| | |||
<tr> | |||
<td>Mobile Interface</td> | |||
<td>network interface; default: <b>mob1s1a1</b></td> | |||
<td>Interface whose GSM parameters will be sent to the ThingWorx server for monitoring.</td> | |||
</tr>|}} | |||
</table> | |||
{{#switch:{{{series}}} | |||
|RUTX|RUTM= | |||
==Greengrass== | |||
[[File:Networking_rutos_manual_cloud_solutions_greengrass_v1.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 the AWS Greengrass service on or off.</td> | |||
</tr> | |||
<tr> | |||
<td>Config file</td> | |||
<td>.tar.gz file; default: <b>none</b></td> | |||
<td>Core-specific config file.</td> | |||
</tr> | |||
</table> | |||
|#default=}} | |||
[[Category:{{{name}}} Services section]] | [[Category:{{{name}}} Services section]] |
Revision as of 09:21, 15 April 2024
The information in this page is updated in accordance with firmware version .
Summary
The Cloud Solutions section is used to configure how the device will connect to certain cloud management systems.
This chapter of the user manual provides an overview of the Cloud Solutions page for {{{name}}} devices.
Note: Each Cloud Solutions service, except RMS, is additional software that can be installed from the System → [[{{{name}}} Package Manager|Package Manager]] page.
If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.
RMS
RMS (Remote Management System) is a cloud system designed by Teltonika and intended for remote monitoring and management of Teltonika-Networks products.
In order to add a device(s) to RMS, get yourself acquainted by watching this instructional video and register an account by clicking here. Each unique device receives a free month-long RMS license when added to RMS for the first time.
The figure below is a screenshot of the RMS section taken from a device which has been connected to RMS:
[[File:Networking_rutos_manual_setup_wizard_rms_{{{rms}}}_v4.png|border|class=tlt-border]]
Field | Value | Description |
---|---|---|
Connection type | Enabled | Standby | Disabled; default: Enabled | Defines how the device will connect to RMS:
|
Hostname | host | ip; default: rms.teltonika.lt | Address of the RMS server. If you're using regular RMS, just leave the default address (rms.teltonika.lt). |
Port | integer [0..65535]; default: 15009 | Port number for connecting to RMS. If you're using regular RMS, just leave the default port (15009). |
Authentication code | string; default: none | Authentication code provided by RMS after adding the device. |
The RMS server waits for incoming connections. Since the device attempts to connect at a fixed interval, it may not connect instantly after you add it to RMS. While it is disconnected, you can check how much time is left until the next connection attempt in the Status section:
[[File:Networking_rutos_manual_cloud_solutions_rms_disconnected_rms_{{{rms}}}_v5.png|border|class=tlt-border]]
To speed up the process by initiating an immediate connection attempt, click the Connect button.
[[File:Networking_rutos_manual_cloud_solutions_rms_connect_{{{rms}}}_v3.png|border|class=tlt-border]]
If a failure or unknown status occurs, there is an alternative to try to reconnect again, click the Reconnect button.
[[File:Networking_rutos_manual_cloud_solutions_rms_reconnect_{{{rms}}}_v3.png|border|class=tlt-border]]
When the device is already connected a Reset button becomes visible. Use it to terminate the device's connection to RMS.
[[File:Networking_rutos_manual_cloud_solutions_rms_unregister_{{{rms}}}_v3.png|border|class=tlt-border]]
For more information on Teltonika Networks Remote Management System (RMS) refer to the RMS Manual or RMS FAQ pages.
Azure IoT Hub
Azure IoT Hub is Microsoft's ever-expanding set of cloud services to help your organization meet your business challenges. Azure IoT Hub is compatible with Teltonika Networks devices.
The figure and table below provides explanations for Azure IoT Hub configuration parameters.
Field | Value | Description |
---|---|---|
Enable Azure IoT Hub monitoring | off | on; default: off | Turns the Azure IoT Hub service on or off. |
Connection string | string; default: none | Unique connection string a.k.a. server address provided by the Azure Iot Hub service. |
Message Type | MQTT messages; default: MQTT messages | Values that are to be sent to the Azure server. |
MQTT Host | ip | host; default: none | MQTT broker's IP address or hostname. |
MQTT Port | integer [0..65535]; default: none | MQTT broker's IP port number. |
Topic | string; default: none | MQTT topic to be used for publishing the data. |
Username | string; default: none | Username used for authentication to the MQTT broker. |
Require password | on | off; default: off | Enables password field. |
Password | string; default: none | Password used for authentication to the MQTT broker. |
Cloud of Things
The Cloud of Things is an IoT cloud platform which provides the possibility to remotely monitor, manage and control your connected devices and machines – plug-and-play, without extensive installation.
Field | Value | Description |
---|---|---|
Enable | off | on; default: off | Turns the Cloud of Things service on or off. |
Server Address | ip | host; default: none | Cloud of Things server IP address or hostname. |
Interval | integer; default: none | Push connection interval in minutes. |
Reset Auth | - (interactive button) | Resets authentication data so that device could be re-registered on the Cloud of Things Device Management platform. |
Cumulocity
Cumulocity IoT is a cloud-based, real-time IoT management platform that's also compatible with Teltonika-Networks devices.
The figure and table below provide explanations for Cumulocity configuration parameters available on the device. For a detailed configuration guide, click here.
Field | Value | Description |
---|---|---|
Enable | off | on; default: off | Turns the Cumulocity service on or off. |
Use SSL/TLS | off | on; default: off | Turn SSL/TLS protocol support on or off. |
Server Address | host; default: none | Hostname of your Cumulocity server. It should match the Environment name from the Cumulocity registration. For example: teltonika-networks.eu-latest.cumulocity.com |
Interval | integer; default: none | Connection push interval in minutes. This field defines how often the device will try to connect to the Cumulocity server. |
Reset Auth | - (interactive button) | Resets authentication for this device. If you click this, you'll have to authorize this from Cumulocity dashboard before it can successfully connect to the server. |
ThingWorx
[[File:Networking_rutos_manual_cloud_solutions_thingworx_modem_{{{modem}}}.png|border|class=tlt-border]]
Field | Value | Description |
---|---|---|
Enable | off | on; default: off | Turns the ThingWorx service on or off. |
Server Address | ip | host; default: none | Thingworx server IP address or hostname. |
Server Port | integer [0..65535]; default: none | Thingworx server's port number. |
Thing Name | string; default: none | Thing name defined in ThingWorx CP. |
Application Key | string; default: none | Application key generated in ThingWorx CP. |
[[Category:{{{name}}} Services section]]