Changes for page ThingsBoard

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

From version < 20.1 >

edited by Dilisi S
on 2025/03/04 04:18

To version < 21.1 >

edited by Dilisi S
on 2025/03/04 04:23

Change comment: Mar 3 edits - part 3

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -8,9 +8,9 @@
  = 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.
++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.
++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 =
@@ -21,7 +21,7 @@
  [[image:ThingsBoard-Device.png]]
--On the ‘**Devices**’ page, click on the ‘**+**’ button, and then click on the ‘**Add new device**’ from the dropdown menu.
++On the **Devices **page, click on the ‘**+**’ button, and then click on the **Add new device **from the dropdown menu.
  [[image:ThingsBoard-add-new-device.png||height="279" width="500"]]
@@ -30,24 +30,26 @@
  = 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 ==
--In the left navigation, click ‘Integrations center’, and then click ‘Data converters’.
++In the left navigation, click **Integrations center**, and then click **Data converters**.
  [[image:ThingsBoard-Data-Converters.png]]
--On the ‘Data converters’ page, click on the ‘+’ button, and then click on the ‘Create new converter’ from the dropdown menu.
++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"]]
--The ‘Add data converter’ window will appear. Name it ‘**UDP Uplink Converter NB/CB**’ and select the Type as ‘Uplink’.
++The **Add data converter** window will appear. Name it ‘**UDP Uplink Converter NB/CB**’ and select the Type as **Uplink**.
--Click on the ‘JavaScript’ button. Now copy and paste the following script to the ‘Decoder function’ section:
++Click on the **JavaScript** button. Now copy and paste the following script to the **Decoder function** section:
  {{code language="JavaScript"}}
  //Version: 0.1
@@ -172,26 +172,29 @@
  {{/code}}
--Click on the ‘Add’ button.
++Click on the **Add** button.
  [[image:ThingsBoard-add-data-converter-uplink.png||width="500"]]
--The uplink data converter is added to ThingsBoard and appears on the ‘Data Converters’ page
++The uplink data converter is added to ThingsBoard and is listed on the **Data Converters** page.
++[[image:Data-converter-list-uplink-only.png]]
++
++
  == Downlink ==
--On the ‘Data converters’ page, click on the ‘+’ button, and then click on the ‘Create new converter’ from the dropdown menu.
++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"]]
--The ‘**Add data converter**’ window will appear. Name it ‘**UDP Downlink Converter NB/CB**’ and select the Type as ‘**Downlink**’.
++The **Add data converter** window will appear. Name it ‘**UDP Downlink Converter NB/CB**’ and select the Type as **Downlink**.
--Click on the ‘**JavaScript**’ button. Now copy and paste the following script to the ‘**Encoder function**’ section:
++Click on the **JavaScript** button. Now copy and paste the following script to the **Encoder function **section:
  {{code language="JavaScript"}}
@@ -230,20 +230,28 @@
  [[image:ThingsBoard-add-data-converter-downlink.png||height="532" width="500"]]
++The downlink data converter is added to ThingsBoard and is listed on the **Data Converters** page.
++
++
++[[image:Data-converter-list.png]]
++
++
  = Add Integration =
--In the left navigation, click ‘Integrations center’, and then click ‘Integrations’.
++In the left navigation, click **Integrations center**, and then click **Integrations**.
--On the ‘Integrations’ page, click on the “+” button.
++On the **Integrations** page, click on the '**+**' button.
  [[image:ThingsBoard-add-integration.png]]
--The ‘Add integration’ window appears.
++The **Add integration** window appears.
  In the Add Integration window, configure the following settings:
++
++
  **Basic settings:**
  * **Integration type**: UDP
@@ -257,8 +257,8 @@
  **Uplink data converter:**
--* Click on the ‘**Select existing**’ button.
--* Uplink data converter: Select ‘**UDP Uplink Converter NB/CB**’ from the dropdown list.
++* Click on the **Select existing** button.
++* **Uplink data converter**: Select **UDP Uplink Converter NB/CB **from the dropdown list.
  Click **Next** button.
@@ -268,8 +268,8 @@
  **Downlink data converter:**
--* Click on the ‘**Select existing**’ button.
--* Downlink data converter: Select ‘**UDP Downlink Converter NB/CB**’ from the dropdown list.
++* Click on the **Select existing** button.
++* **Downlink data converter**: Select **UDP Downlink Converter NB/CB **from the dropdown list.
  Click **Next** button.
@@ -279,15 +279,11 @@
  **Connection:**
--**Port**: 11582
++* **Port**: 11582
++* **Size of the buffer for inbound socket (in KB)**: 64
++* **Cache Size**: 10000000
++* **Cache time to live in minutes**: 1440
--**Size of the buffer for inbound socket (in KB)**: 64
--
--**Cache Size**: 10000000
--
--**Cache time to live in minutes**: 1440
--
--
  Copy the two keys, **Integration key** and **Integration secret** into a text editor, as you will need them in the section ‘xxxxx’.
  Click on the **Add** button.