Template:Networking rutos Thingsboard.io: Difference between revisions
Template:Networking rutos Thingsboard.io (view source)
Revision as of 12:00, 23 January 2023
, 23 January 2023no edit summary
No edit summary |
No edit summary |
||
(10 intermediate revisions by 2 users not shown) | |||
Line 4: | Line 4: | ||
==Introduction== | ==Introduction== | ||
This article contains instructions on how to configure | This article contains instructions on how to configure ThingsBoard IoT platform and connect Teltonika-Networks devices. [https://thingsboard.io/ ThingsBoard IoT platform ] is an open-source IoT platform for data collection, processing, visualization, and device management. It enables device connectivity via industry standard IoT protocols - MQTT, CoAP and HTTP and supports both cloud and on-premises deployments. ThingsBoard combines scalability, fault-tolerance and performance so you will never lose your data. | ||
==Configuring | ==Configuring ThingsBoard IoT platform== | ||
The goal of this tutorial is to demonstrate the basic usage of the most popular ThingsBoard features which helps monitor Teltonika-Networks devices.First, you need to login into the platform. Next, you will see an overview window, scroll down to <b>Device | The goal of this tutorial is to demonstrate the basic usage of the most popular ThingsBoard features which helps monitor Teltonika-Networks devices. First, you need to login into the platform. Next, you will see an overview window, scroll down to <b>Device management</b> section or simply click on the <b>Device group</b> in the navigation menu. | ||
[[File:Thingboards_io_Overview_page.png]] | [[File:Thingboards_io_Overview_page.png]] | ||
<ol> | |||
<li> | <li> Click on one of the marked in red buttons in the <b>Device groups</b> overview page. In this page you can also add additional device groups in order to distinguish different devices with unique data flows.</li> | ||
<li> | <li> Click marked "<b>+</b>" buttons to add new device to the group.</li> | ||
</ol> | |||
[[File:Thingboards_io_device_groups.png]] | [[File:Thingboards_io_device_groups.png]] | ||
<li> | <ol> | ||
<li> | <li> In the pop up window set name for your device.</li> | ||
[[File:Thingboards_io_add_new_device.png]] | <li> Configure your device's <b>Access token</b>(Optional)</li> | ||
</ol> | |||
[[File:Thingboards_io_add_new_device.png|border|class=tlt-border]] | |||
==== Credentials type: Access token (HTTP protocol) ==== | ==== Credentials type: Access token (HTTP protocol) ==== | ||
---- | ---- | ||
<ol> | |||
<li> Enable <b>Add credentials</b> option.</li> | |||
<li> Set desirable <b>Access token</b>. | |||
<li> Click <b>Add</b> button to save changes. </li> | |||
</ol> | |||
[[File:Thingboards_io_configuring_credentials.png|border|class=tlt-border]] | |||
=== Credentials type: MQTT Basic === | |||
=== Credentials type:MQTT Basic === | |||
---- | ---- | ||
<ol> | |||
<li> | <li> Enable <b>Add credentials</b> option.</li> | ||
<li> | <li> Choose Credentials type:<b>MQTT Basic</b>.</li> | ||
<li> | <li> Set username which will be used in MQTT authorization.</li> | ||
<li> | <li> Set password which will be used in MQTT authorization.</li> | ||
<li> | <li> Click <b>Add</b> button to save changes. </li> | ||
[[File:Thingboards_io_configuring_credentials_mqtt_basic.png]] | </ol> | ||
[[File:Thingboards_io_configuring_credentials_mqtt_basic.png|border|class=tlt-border]] | |||
==Preparing data source== | ==Preparing data source== | ||
Line 43: | Line 48: | ||
Different data streams can be selected depending on the device's supported functionality's. In this example we will be using <b>Modbus TCP slave</b> with native <b> Modbus TCP master </b> functionality. | Different data streams can be selected depending on the device's supported functionality's. In this example we will be using <b>Modbus TCP slave</b> with native <b> Modbus TCP master </b> functionality. | ||
1. First, change WEBUI mode from <b>basic</b> to <b>advanced</b>.<br> | |||
[[File:Networking_rutx_manual_webui_basic_advanced_mode.gif|border|class=tlt-border]] | [[File:Networking_rutx_manual_webui_basic_advanced_mode.gif|border|class=tlt-border]] | ||
2. Go to <b>Services → Modbus TCP slave</b> page.<br> | |||
3. Enable <b>Modbus TCP slave</b>.<br> | |||
[[File:Thingboards_io_Modbus_TCP_slave.png]] | [[File:Thingboards_io_Modbus_TCP_slave.png]] | ||
4. Go to <b>Modbus TCP master</b> page and add new slave device.<br> | |||
[[File:Thingboards_io_Modbus_TCP_master.png]] | [[File:Thingboards_io_Modbus_TCP_master.png]] | ||
5. Configure <b>Modbus TCP master's slave device</b> as shown below to return device's uptime value.<br> | |||
[[File: | [[File:Thingboards io Modbus TCP master device v2.png|border|class=tlt-border|1152x525px]] | ||
==Configuring data to server with HTTP protocol== | ==Configuring data to server with HTTP protocol== | ||
Line 60: | Line 65: | ||
[[File:Thingboards_io_data_sender_configuration.png]] | [[File:Thingboards_io_data_sender_configuration.png]] | ||
<li> | <ol> | ||
<li> | <li> Set name for the <b>Data sender</b>.</li> | ||
<li> | <li> Set desirable name for your data variable. Make sure that your chosen parameter is shown below JSON format field.</li> | ||
<pre>https://thingsboard.cloud/api/v1/YOUR_ACCESS_TOKEN/telemetry</pre> | <li> Paste connection string with your own <b>Access token</b>.</li> | ||
<li> | <pre>https://thingsboard.cloud/api/v1/YOUR_ACCESS_TOKEN/telemetry</pre> | ||
<pre>Content-Type:application/json</pre> | <li> Add value to Custom header. </li> | ||
<pre>Content-Type:application/json</pre> | |||
</ol> | |||
==Configuring data to server with MQTT protocol== | ==Configuring data to server with MQTT protocol== | ||
After configuring the data source, you can add a data sender configuration. Data sender functionality is located <b>Services → Data to server</b>. You can add data sender by clicking <b>Add</b> button. | After configuring the data source, you can add a data sender configuration. Data sender functionality is located <b>Services → Data to server</b>. You can add data sender by clicking <b>Add</b> button. | ||
Line 72: | Line 78: | ||
[[File:Thingboards_io_Thingboards_io_Data_to_server_mqtt.png]] | [[File:Thingboards_io_Thingboards_io_Data_to_server_mqtt.png]] | ||
[[File:Thingboards_io_data_sender_configuration_mqtt.png]] | [[File:Thingboards_io_data_sender_configuration_mqtt.png]] | ||
<li> | <ol> | ||
<li> | <li> Set name for the <b>Data sender</b>.</li> | ||
<li> | <li> Choose <b>MQTT</b> protocol.</li> | ||
<li> | <li> Set desirable name for your data variable. Make sure that your chosen parameter is shown below JSON format field.</li> | ||
<li> | <li> Enter <b>thingsboard.cloud</b> as a host.</li> | ||
<pre>v1/devices/me/telemetry</pre> | <li> Paste in MQTT topic. </li> | ||
<li> | <pre>v1/devices/me/telemetry</pre> | ||
<li> Enable <b>Use credentials</b> option. Enter configured username and password from ThingsBoard IoT platform.</li> | |||
</ol> | |||
==Adding widget to the dashboard== | ==Adding widget to the dashboard== | ||
The collected data can be displayed using various a widgets. To create one you should be able to see gathered data in the <b>Latest telemetry </b> section. To access it you should follow these steps: | The collected data can be displayed using various a widgets. To create one you should be able to see gathered data in the <b>Latest telemetry </b> section. To access it you should follow these steps: | ||
<li> | <ol> | ||
<li> | <li> Click on the configured device. </li> | ||
<li> From the pop-up menu select <b>Latest telemetry </b> option. There you should see collected data.</li> | |||
</ol> | |||
[[File:Thingboards_io_latest_telemetry.png]] | [[File:Thingboards_io_latest_telemetry.png]] | ||
In order to display data in the widget you should: | In order to display data in the widget you should: | ||
<li> | <ol> | ||
<li> | <li> Click on the gathered data row.</li> | ||
<li> Press <b>Show on widget </b> button.</li> | |||
</ol> | |||
[[File:Thingboards_io_latest_telemetry_data.png]] | [[File:Thingboards_io_latest_telemetry_data.png]] | ||
<li> | <ol> | ||
<li> | <li> Choose bundle accordingly to your data.</li> | ||
<li> | <li> Choose suitable chart for your data visualization.</li> | ||
<li> Add widget to dashboard.</li> | |||
</ol> | |||
[[File:Thingboards_io_charts.png]] | [[File:Thingboards_io_charts.png]] | ||
<li> | <ol> | ||
<li> | <li> Create new dashboard. </li> | ||
<li> | <li> With this option enabled after addition you will be redirected to newly created dashboard</li> | ||
[[File:Thingboards_io_adding_widget.png]] | <li> Adds widget to dashboard.</li> | ||
</ol> | |||
[[File:Thingboards_io_adding_widget.png|border|class=tlt-border]] | |||
[[File:Thingboards_io_dashboard.png]] | [[File:Thingboards_io_dashboard.png|border|class=tlt-border]] | ||
==See also== | ==See also== | ||
* https://thingsboard.io/docs/getting-started-guides/helloworld-pe/ | * https://thingsboard.io/docs/getting-started-guides/helloworld-pe/ |