Jump to content
  • EN

Template:Networking rutos Thingsboard.io: Difference between revisions

Template:Networking rutos Thingsboard.io (view source)

Revision as of 07:22, 31 January 2024

17 bytes removed ,  31 January
no edit summary
VisualWikitext
No edit summary
No edit summary
(24 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__TOC__
<p style="color:red">The information on this page is updated in accordance with the [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.4'''] firmware version .</p>
 
==Introduction==
 
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 ThingsBoard IoT platform==




==Introduction==
The goal of this tutorial is to demonstrate the basic usage of the most popular ThingsBoard features which helps monitor Teltonika-Networks devices.


This article contains instructions on how to configure Thingsboard IoT platform and connect a Teltonika-Networks devices. [https://thingsboard.io/ Thingsboard IoT platform ] is an open-source IoT platform for data collection, processing, visualization, and device management.
First, you need to login into the platform. Next, you will see an overview window, scroll down to <b>Entities</b> section and simply click on the <b>Device</b> in the navigation menu.


==Configuring Thingsboard IoT platform==
<ol>
    <li> Click on one of the marked in red buttons in the overview page <b> Entities → Devices</b>. In this page you can also add additional device in order to distinguish different devices with unique data flows.</li>
    <li> Click marked "<b>+</b>" buttons to add new device to the group.</li>
</ol>
[[File:1111.png]]




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 managment</b> section or simply click on the <b>Device group</b> in the navigation  menu.
<ol>
    <li> In the pop up window set name for your device.</li>
    <li> Configure your device's <b>Label</b> (Optional)</li>
</ol>
[[File:22222222222.png]]


[[File:Thingboards_io_Overview_page.png]]


<li>1. 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>2. Click marked "<b>+</b>" buttons to add new device to the group.</li>
[[File:Thingboards_io_device_groups.png]]
<li>1. In the pop up window set name for your device.</li>
<li>2. Configure your device's <b>Access token</b>(Optional)</li>
[[File:Thingboards_io_add_new_device.png]]


==== Credentials type: Access token (HTTP protocol) ====
==== Credentials type: Access token (HTTP protocol) ====
----
----
 
<ol>
<li>1. Enable <b>Add credentials</b> option.</li>  
    <li> Enable <b>Add credentials</b> option.</li>  
<li>2. Set desirable <b>Access token</b>.  
    <li> Set desirable <b>Access token</b>.  
<li>3. Click <b>Add</b> button  to save changes. </li>
    <li> Click <b>Add</b> button  to save changes. </li>
[[File:Thingboards_io_configuring_credentials.png]]
</ol>
[[File:33333333.png |border|class=tlt-border]]


=== Credentials type: MQTT Basic ===
=== Credentials type: MQTT Basic ===
----
----
 
<ol>
<li>1. Enable <b>Add credentials</b> option.</li>  
    <li> Enable <b>Add credentials</b> option.</li>  
<li>2. Choose Credentials type:<b>MQTT  Basic</b>.</li>
    <li> Choose Credentials type:<b>MQTT  Basic</b>.</li>
<li>3. Set username which will be  used in MQTT authorization.</li>
    <li> Set username which will be  used in MQTT authorization.</li>
<li>4. Set password which will be  used in MQTT authorization.</li>
    <li> Set password which will be  used in MQTT authorization.</li>
<li>5. Click <b>Add</b> button  to save changes. </li>
    <li>  Click <b>Add</b> button  to save changes. </li>
[[File:Thingboards_io_configuring_credentials_mqtt_basic.png]]
</ol>
[[File:44444444444.png]]


==Preparing data source==
==Preparing data source==




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 Server</b> with native <b> Modbus TCP Client </b> functionality.


<li>1. First, change WEBUI mode from <b>basic</b> to <b>advanced</b>.</li>
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:05.png|border|class=tlt-border]]
<li>2. Go to <b>Services → Modbus TCP slave</b> page.</li>
2. Go to <b>Services → Modbus TCP Server</b> page.<br>
<li>3. Enable <b>Modbus TCP slave</b>.</li>
3. Enable <b>Modbus TCP Server</b>.<br>
[[File:Thingboards_io_Modbus_TCP_slave.png]]
[[File:5555555555555555555.png]]
<li>4. Go to <b>Modbus TCP master</b> page and add new slave device.</li>
4. Go to <b>Modbus TCP Client</b> page and add new Server device.<br>
[[File:Thingboards_io_Modbus_TCP_master.png]]
[[File:20.png]]
<li>5. Configure <b>Modbus TCP master's slave device</b> as shown below to return device's uptime value.</li>
5. Configure <b>Modbus TCP master's Server device</b> as shown below to return device's uptime value.<br>
[[File:Thingboards_io_Modbus_TCP_master_device.png]]
[[File:100.png|border|class=tlt-border|1152x525px]]
6. Configure '''Data Type'''.
[[File:9.png|border|class=tlt-border|1152x525px]]


==Configuring data to server with HTTP protocol==
==Configuring data to server with HTTP protocol==
Line 57: Line 68:
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.


[[File:Thingboards_io_Thingboards_io_Data_to_server_HTTP.png]]
[[File:10.png]]


[[File:Thingboards_io_data_sender_configuration.png]]
* Configure '''Data'''.
<li>1. Set name for the <b>Data sender</b>.</li>
<li>2. Set desirable name for your data variable. Make sure that your chosen parameter is shown below JSON format field.</li>
<li>3. Paste connection string with your own <b>Access token</b>.</li>
<pre>https://thingsboard.cloud/api/v1/YOUR_ACCESS_TOKEN/telemetry</pre>
<li>4. Add value to Custom header. </li>
<pre>Content-Type:application/json</pre>


[[File:110.png]]
* Configure '''HTTP Server'''.
[[File:150.png]]
<ol>
    <li> Set name for the <b>Data sender</b>.</li>
    <li> Paste connection string with your own <b>Access token</b>.</li>
    <pre>https://thingsboard.cloud/api/v1/YOUR_ACCESS_TOKEN/telemetry</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.


[[File:Thingboards_io_Thingboards_io_Data_to_server_mqtt.png]]
[[File:13.png]]
[[File:Thingboards_io_data_sender_configuration_mqtt.png]]
* Configure '''Data'''.
<li>1. Set name for the <b>Data sender</b>.</li>
[[File:14.png]]
<li>2. Choose <b>MQTT</b> protocol.</li>
* Configure '''MQTT Server'''.
<li>3. Set desirable name for your data variable. Make sure that your chosen parameter is shown below JSON format field.</li>
[[File:160.png]]
<li>4. Enter <b>thingsboard.cloud</b> as a host.</li>
<ol>
<li>5. Paste in MQTT topic. </li>
    <li> Choose <b>MQTT</b> protocol.</li>
<pre>v1/devices/me/telemetry</pre>
    <li> Enter <b>thingsboard.cloud</b> as a host.</li>
<li>6. Enable <b>Use credentials</b> option. Enter configured username and password from Thingsboard IoT platform.</li>
    <li> Paste in MQTT topic. </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>1. Click on the configured device. </li>
<ol>
<li>2. From the pop-up menu select <b>Latest telemetry </b> option. There you should see collected data.</li>
    <li> Click on the configured device. </li>
[[File:Thingboards_io_latest_telemetry.png]]
    <li> From the pop-up menu select <b>Latest telemetry </b> option. There you should see collected data.</li>
</ol>
[[File:500.png]]
 
 


In order to display data in the widget you should:
In order to display data in the widget you should:
<li>1. Click on the gathered data row.</li>
<ol>
<li>2. Press <b>Show on  widget </b> button.</li>
    <li> Click on the gathered data row.</li>
[[File:Thingboards_io_latest_telemetry_data.png]]
    <li> Press <b>Show on  widget </b> button.</li>
<li>1. Choose bundle accordingly to your data.</li>
</ol>
<li>2. Choose suitable chart for your data visualization.</li>
[[File:600.png]]
<li>3. Add widget to dashboard.</li>
<ol>
[[File:Thingboards_io_charts.png]]
    <li> Choose bundle accordingly to your data.</li>
<li>1. Create new dashboard. </li>
    <li> Choose suitable chart for your data visualization.</li>
<li>2. With this option enabled after addition you will be redirected to newly created dashboard</li>
    <li> Add widget to dashboard.</li>
<li>3. Adds widget to dashboard.</li>
</ol>
[[File:Thingboards_io_adding_widget.png]]
[[File:700.png]]
<ol>
    <li> Create new dashboard. </li>
    <li> With this option enabled after addition you will be redirected to newly created dashboard</li>
    <li> Adds widget to dashboard.</li>
</ol>
[[File:1000000.png]]




[[File:Thingboards_io_dashboard.png]]
[[File:2- Dashbord.png]]


==See also==
==See also==


* https://thingsboard.io/docs/getting-started-guides/helloworld-pe/
* https://thingsboard.io/docs/getting-started-guides/helloworld-pe/
Retrieved from "https://wiki.teltonika-networks.com/view/Special:MobileDiff/76837...119993"