Changes for page ThingsBoard

Last modified by Dilisi S on 2025/04/02 02:09

From version < 62.1 >

edited by Dilisi S
on 2025/03/06 13:28

To version < 64.2 >

edited by Xiaoling
on 2025/03/07 11:46

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.pradeeka
++XWiki.Xiaoling

Content

@@ -6,20 +6,21 @@
  Draft Document
  {{/warning}}
--= Introduction =
++= 1. Introduction =
++
  This document guides you on integrating Dragino **-NB** and **-CB** series devices data with ThingsBoard. For this guide, we use ThingsBoard Cloud, which is one of the ThingsBoard versions that allows you to try it for free.
  The **NB series** devices end with the suffix **-NB**, and the **CB series** devices end with the suffix **-CB**. For example, **S31B-NB** is an **NB device**, and **S31-CB** is a **CB device**.
--= Add New Device =
++= 2. Add New Device =
++
  First, we will add a device to simulate data using MQTT. This device does not represent a real physical device but serves as a common virtual device for all Dragino NB/CB devices.
  In the left navigation, click **Entities** and then click **Devices**.
--
  [[image:device-list-empty.png]]
@@ -67,7 +67,7 @@
  [[image:mqtt-command-1.png||height="228" width="700"]]
--If the command is successful, you can see the telemetry data you sent under the **Latest telemetry** section.
++If the command is successful, you can see the telemetry data you sent under the **Latest telemetry** section. Note that the **State** is now **'Active'** in the **Latest telemetry** section.
  [[image:new-device-telemetry-test.png||height="520" width="500"]]
@@ -81,22 +81,26 @@
  [[image:mqtt-command-2.png||height="227" width="700"]]
--= Data Converters =
++[[image:virtual-device-active.png]]
++
++
++= 3. Data Converters =
++
++
  In **ThingsBoard**, **Data Converters** are components used to transform incoming or outgoing data between different formats, typically to convert raw telemetry data from devices into a structured format that ThingsBoard can understand, or vice versa.
--== Uplink ==
++== 3.1 Uplink ==
++
  In the left navigation, click **Integrations center**, and then click **Data converters**.
--
  [[image:data-converter-list-page.png]]
  On the **Data converters** page, click on the ‘+’ button, and then click on the **Create new converter** from the dropdown menu.
--
  [[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
@@ -227,24 +227,22 @@
  {{/code}}
++
  Click on the **Add** button.
--
  [[image:uplink-data-converter.png||height="529" width="500"]]
--
  You should see that the newly added **uplink data converter** is listed on the **Data Converters** page.
--
  [[image:data-converter-list-showing-uplink-dc.png]]
--== Downlink ==
++== 3.2 Downlink ==
++
  On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
--
  [[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
@@ -285,24 +285,21 @@
  Click on the **Add** button.
--
  [[image:downlink-data-converter.png||height="530" width="500"]]
--
  You should see that the newly added **downlink data converter** is listed on the **Data Converters** page.
--
  [[image:data-converter-list.png]]
--= Add Integration =
++= 4. Add Integration =
++
  In the left navigation, click **Integrations center**, and then click **Integrations**.
  On the **Integrations** page, click on the '**+**' button.
--
  [[image:data-converter-list-page.png]]
@@ -318,11 +318,9 @@
  Click **Next** button.
--
  [[image:add-integration-basic-settings.png||height="511" width="500"]]
--
  **Uplink data converter:**
  * Click on the **Select existing** button.
@@ -330,11 +330,9 @@
  Click **Next** button.
--
  [[image:add-integration-uplink-data-converter.png||width="500"]]
--
  **Downlink data converter:**
  * Click on the **Select existing** button.
@@ -342,11 +342,9 @@
  Click **Next** button.
--
  [[image:add-integration-downlink-data-converter.png||height="510" width="500"]]
--
  **Connection:**
  * **Host**: mqtt.eu.thingsboard.cloud (This is the host name you copied from the device - See section xxxxx for more information)
@@ -359,7 +359,6 @@
  Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
--
  [[image:add-integration-connection.png||width="500"]]
@@ -367,7 +367,6 @@
  Click on the **Add** button.
--
  [[image:add-connection-success.png||height="511" width="500"]]
@@ -375,11 +375,18 @@
  Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
++[[image:integrations-list-added-pending.png]]
--[[image:integrations-list-added-pending.png]]
++= 5. Verifying the receipt of data from the device =
--= Verifying the receipt of data from the device =
++On the terminal, issue the following MQTT command which simulates the device S31B-NB.
--Connect **S31B-NB** to transfer information. If the integration was performed without errors, after the transmission of the first telemetry, a new device with the name “xxxxx” will appear in the Devices → All. Also, you can verify the input and output data, respectively, before and after conversion in Data converters → UDP Uplink Converter  NB/CB → Events.
++{{code language="none"}}
++mosquitto_pub -d -q 1 -h mqtt.eu.thingsboard.cloud -p 1883 -t v1/devices/S31B-NB/telemetry -u "24vk3w9h7sqdld1me5eh" -m "{temperature:20}"
++{{/code}}
++
++If the integration was performed without errors, after the transmission of the first telemetry, a new device with the name “S31B-NB” will appear in the Devices → All. Also, you can verify the input and output data, respectively, before and after conversion in Data converters → UDP Uplink Converter  NB/CB → Events.
++
++

Changes for page ThingsBoard

Summary

Details

Applications

Navigation