31,703
edits
Changes
Template:Networking rut manual iot platforms (view source)
Revision as of 11:07, 15 June 2021
, 11:07, 15 June 2021Created page with "{{Template: Networking_rutos_manual_fw_disclosure | fw_version = {{#switch: {{{series}}} | RUT2XX = {{{series}}}_R_00.01.14 | RUT9XX = {{{series}}}_R_00.06.08.2}} }} ==Su..."
{{Template: Networking_rutos_manual_fw_disclosure
| fw_version = {{#switch: {{{series}}}
| RUT2XX = {{{series}}}_R_00.01.14
| RUT9XX = {{{series}}}_R_00.06.08.2}}
}}
==Summary==
The <b>IoT Platforms</b> section is used to configure various cloud solutions used for remote control of this device.
This chapter of the user manual provides an overview of the Cloud Solutions page for {{{name}}} devices.
==Azure IoT Hub==
<b>Azure IoT Hub</b> is a set of cloud services by Microsoft's designed to help an organization meet various business challenges related to remote device monitoring.
Monitoring can be configured in two different ways:
<ul>
<li><b>GSM Values</b> - the device periodically sends information on selected mobile connection parameters.</li>
<li><b>MQTT messages</b> - the device connects to an MQTT broker and subscribes to a specified topic.</li>
</ul>
More information on <i>Message Types</i> in the sections below.
===GSM values===
----
[[File:Networking_rut_manual_iot_platforms_azure_iot_hub_gsm_values.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>yes | no; default: <b>no</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><nowiki>
<tr>
<td>Message Type</td>
<td>GSM values | MQTT messages; default: <b>GSM values</b></td>
<td>Values that are to be sent to the Azure server.</td>
</tr></nowiki>
<tr>
<td>Message sending interval (sec.)</td>
<td>integer [10..99999]; default: <b>300</b></td>
<td>data sending frequency in seconds.</td>
</tr>
<tr>
<td>GSM Values</td>
<td>IP Address | Number of bytes sent | Number of bytes received | Mobile connection state | Network link state | IMEI | ICCID | Model | Manufacturer | Serial | Revision | IMSI | SIM state | PIN state | GSM signal | WCDMA RSCP | WCDMA EC/IO {{#ifeq:{{{name}}}|RUT900||{{!}} LTE RSRP {{!}} LTE SINR {{!}} LTE RSRQ }}| Cell ID | Operator | Operator number | Connection type | Temperature | PIN count;<br>default: <b>none</b></td>
<td>Selects the mobile connection parameter values that should be sent to the Azure IoT Hub service.</td>
</tr>
</table>
===MQTT messages===
----
[[File:Networking_rut_manual_iot_platforms_azure_iot_hub_mqtt_messages.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>yes | no; default: <b>no</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><nowiki>
<tr>
<td>Message Type</td>
<td>GSM values | MQTT messages; default: <b>GSM values</b></td>
<td>Values that are to be sent to the Azure server.</td>
</tr></nowiki>
<tr>
<td>MQTT Host</td>
<td>ip | host; default: <b>none</b></td>
<td>IP address or hostname of an MQTT broker.</td>
</tr>
<tr>
<td>MQTT Port</td>
<td>integer [0..65535]; default: <b>none</b></td>
<td>Port number of an MQTT broker.</td>
</tr>
<tr>
<td>MQTT Host</td>
<td>ip | host; default: <b>none</b></td>
<td>.</td>
</tr>
<tr>
<td>Topic</td>
<td>string; default: <b>none</b></td>
<td>MQTT topic to subscribe to.</td>
</tr>
<tr>
<td>Username/Password</td>
<td>string; default: <b>none</b></td>
<td>Username and password used for authentication to n MQTT broker.</td>
</tr>
</table>
==Cumulocity==
<b>Cumulocity</b> is a cloud-based, real-time IoT management platform 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_rut_manual_iot_platforms_cumulocity.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>yes | no; default: <b>no</b></td>
<td>Turns the Cumulocity service on or off.</td>
</tr>
<tr>
<td>Use SSL/TLS</td>
<td>yes | no; default: <b>no</b></td>
<td>Turn SSL/TLS protocol support on or off.</td>
</tr>
<tr>
<td>Server Address</td>
<td>ip | 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 again.</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_rut_manual_iot_platforms_cloud_of_things.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>yes | no; default: <b>no</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>Hostname of your Cloud of Things server.</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>
==ThingWorx==
The <b>ThingWorx</b> platform is used for remote device management and monitoring in the form of user configured custom "things" and applications.
The figure and table below provide explanations for ThingWorx configuration parameters available on the device. For a detailed configuration guide, [[ThingWorx|click here]].
[[File:Networking_rut_manual_iot_platforms_thingworx.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>yes | no; default: <b>no</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>Hostname of your ThingWorx server.</td>
</tr>
<tr>
<td>Server Port</td>
<td>integer [0..65535]; default: <b>none</b></td>
<td>Port number of your ThingWorx server.</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>
</table>
[[Category:{{{name}}} Services section]]
| fw_version = {{#switch: {{{series}}}
| RUT2XX = {{{series}}}_R_00.01.14
| RUT9XX = {{{series}}}_R_00.06.08.2}}
}}
==Summary==
The <b>IoT Platforms</b> section is used to configure various cloud solutions used for remote control of this device.
This chapter of the user manual provides an overview of the Cloud Solutions page for {{{name}}} devices.
==Azure IoT Hub==
<b>Azure IoT Hub</b> is a set of cloud services by Microsoft's designed to help an organization meet various business challenges related to remote device monitoring.
Monitoring can be configured in two different ways:
<ul>
<li><b>GSM Values</b> - the device periodically sends information on selected mobile connection parameters.</li>
<li><b>MQTT messages</b> - the device connects to an MQTT broker and subscribes to a specified topic.</li>
</ul>
More information on <i>Message Types</i> in the sections below.
===GSM values===
----
[[File:Networking_rut_manual_iot_platforms_azure_iot_hub_gsm_values.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>yes | no; default: <b>no</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><nowiki>
<tr>
<td>Message Type</td>
<td>GSM values | MQTT messages; default: <b>GSM values</b></td>
<td>Values that are to be sent to the Azure server.</td>
</tr></nowiki>
<tr>
<td>Message sending interval (sec.)</td>
<td>integer [10..99999]; default: <b>300</b></td>
<td>data sending frequency in seconds.</td>
</tr>
<tr>
<td>GSM Values</td>
<td>IP Address | Number of bytes sent | Number of bytes received | Mobile connection state | Network link state | IMEI | ICCID | Model | Manufacturer | Serial | Revision | IMSI | SIM state | PIN state | GSM signal | WCDMA RSCP | WCDMA EC/IO {{#ifeq:{{{name}}}|RUT900||{{!}} LTE RSRP {{!}} LTE SINR {{!}} LTE RSRQ }}| Cell ID | Operator | Operator number | Connection type | Temperature | PIN count;<br>default: <b>none</b></td>
<td>Selects the mobile connection parameter values that should be sent to the Azure IoT Hub service.</td>
</tr>
</table>
===MQTT messages===
----
[[File:Networking_rut_manual_iot_platforms_azure_iot_hub_mqtt_messages.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>yes | no; default: <b>no</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><nowiki>
<tr>
<td>Message Type</td>
<td>GSM values | MQTT messages; default: <b>GSM values</b></td>
<td>Values that are to be sent to the Azure server.</td>
</tr></nowiki>
<tr>
<td>MQTT Host</td>
<td>ip | host; default: <b>none</b></td>
<td>IP address or hostname of an MQTT broker.</td>
</tr>
<tr>
<td>MQTT Port</td>
<td>integer [0..65535]; default: <b>none</b></td>
<td>Port number of an MQTT broker.</td>
</tr>
<tr>
<td>MQTT Host</td>
<td>ip | host; default: <b>none</b></td>
<td>.</td>
</tr>
<tr>
<td>Topic</td>
<td>string; default: <b>none</b></td>
<td>MQTT topic to subscribe to.</td>
</tr>
<tr>
<td>Username/Password</td>
<td>string; default: <b>none</b></td>
<td>Username and password used for authentication to n MQTT broker.</td>
</tr>
</table>
==Cumulocity==
<b>Cumulocity</b> is a cloud-based, real-time IoT management platform 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_rut_manual_iot_platforms_cumulocity.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>yes | no; default: <b>no</b></td>
<td>Turns the Cumulocity service on or off.</td>
</tr>
<tr>
<td>Use SSL/TLS</td>
<td>yes | no; default: <b>no</b></td>
<td>Turn SSL/TLS protocol support on or off.</td>
</tr>
<tr>
<td>Server Address</td>
<td>ip | 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 again.</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_rut_manual_iot_platforms_cloud_of_things.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>yes | no; default: <b>no</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>Hostname of your Cloud of Things server.</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>
==ThingWorx==
The <b>ThingWorx</b> platform is used for remote device management and monitoring in the form of user configured custom "things" and applications.
The figure and table below provide explanations for ThingWorx configuration parameters available on the device. For a detailed configuration guide, [[ThingWorx|click here]].
[[File:Networking_rut_manual_iot_platforms_thingworx.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>yes | no; default: <b>no</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>Hostname of your ThingWorx server.</td>
</tr>
<tr>
<td>Server Port</td>
<td>integer [0..65535]; default: <b>none</b></td>
<td>Port number of your ThingWorx server.</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>
</table>
[[Category:{{{name}}} Services section]]