Changes for page ThingsBoard

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

From version < 63.1 >

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

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]]
@@ -85,22 +85,22 @@
  [[image:virtual-device-active.png]]
--= Data Converters =
++= 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"]]
@@ -231,24 +231,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"]]
@@ -289,24 +289,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]]
@@ -322,11 +322,9 @@
  Click **Next** button.
--
  [[image:add-integration-basic-settings.png||height="511" width="500"]]
--
  **Uplink data converter:**
  * Click on the **Select existing** button.
@@ -334,11 +334,9 @@
  Click **Next** button.
--
  [[image:add-integration-uplink-data-converter.png||width="500"]]
--
  **Downlink data converter:**
  * Click on the **Select existing** button.
@@ -346,11 +346,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)
@@ -363,7 +363,6 @@
  Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
--
  [[image:add-integration-connection.png||width="500"]]
@@ -371,7 +371,6 @@
  Click on the **Add** button.
--
  [[image:add-connection-success.png||height="511" width="500"]]
@@ -379,11 +379,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