Skip to Content

Changes for page ThingsBoard

Last modified by Dilisi S on 2025/04/23 19:23
From version 69.1
edited by Dilisi S
on 2025/03/08 03:35
Change comment: Deleted image "data-converter-list-showing-uplink-dc.png"
To version 64.1
edited by Dilisi S
on 2025/03/07 00:17
Change comment: Mar 6 edits - part 2

Summary

Details

Page properties
Content
... ... @@ -6,29 +6,26 @@
6 6  Draft Document
7 7  {{/warning}}
8 8  
9 += Introduction =
9 9  
10 -
11 -
12 -= 1. Introduction =
13 -
14 -
15 15  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.
16 16  
17 17  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**.
18 18  
19 19  
20 -= 2. Add New Device =
16 += Add New Device =
21 21  
22 -
23 23  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.
24 24  
25 25  In the left navigation, click **Entities** and then click **Devices**.
26 26  
22 +
27 27  [[image:device-list-empty.png]]
28 28  
29 29  
30 30  On the **Devices **page, click on the ‘**+**’ button, and then click on the **Add new device **from the dropdown menu.
31 31  
28 +
32 32  [[image:ThingsBoard-add-new-device.png||height="279" width="500"]]
33 33  
34 34  
... ... @@ -36,6 +36,7 @@
36 36  
37 37  Click on the **Next: Credentials** button.
38 38  
36 +
39 39  [[image:new-device-device-details.png||height="529" width="500"]]
40 40  
41 41  
... ... @@ -87,22 +87,22 @@
87 87  [[image:virtual-device-active.png]]
88 88  
89 89  
90 -= 3. Data Converters =
88 += Data Converters =
91 91  
92 -
93 93  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.
94 94  
95 95  
96 -== 3.1 Uplink ==
93 +== Uplink ==
97 97  
98 -
99 99  In the left navigation, click **Integrations center**, and then click **Data converters**.
100 100  
97 +
101 101  [[image:data-converter-list-page.png]]
102 102  
103 103  
104 104  On the **Data converters** page, click on the ‘+’ button, and then click on the **Create new converter** from the dropdown menu.
105 105  
103 +
106 106  [[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
107 107  
108 108  
... ... @@ -233,22 +233,24 @@
233 233  
234 234  {{/code}}
235 235  
236 -
237 237  Click on the **Add** button.
238 238  
236 +
239 239  [[image:uplink-data-converter.png||height="529" width="500"]]
240 240  
241 241  
240 +
242 242  You should see that the newly added **uplink data converter** is listed on the **Data Converters** page.
243 243  
243 +
244 244  [[image:data-converter-list-showing-uplink-dc.png]]
245 245  
246 246  
247 -== 3.2 Downlink ==
247 +== Downlink ==
248 248  
249 -
250 250  On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
251 251  
251 +
252 252  [[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
253 253  
254 254  
... ... @@ -289,21 +289,24 @@
289 289  
290 290  Click on the **Add** button.
291 291  
292 +
292 292  [[image:downlink-data-converter.png||height="530" width="500"]]
293 293  
294 294  
296 +
295 295  You should see that the newly added **downlink data converter** is listed on the **Data Converters** page.
296 296  
299 +
297 297  [[image:data-converter-list.png]]
298 298  
299 299  
300 -= 4. Add Integration =
303 += Add Integration =
301 301  
302 -
303 303  In the left navigation, click **Integrations center**, and then click **Integrations**.
304 304  
305 305  On the **Integrations** page, click on the '**+**' button.
306 306  
309 +
307 307  [[image:data-converter-list-page.png]]
308 308  
309 309  
... ... @@ -319,9 +319,11 @@
319 319  
320 320  Click **Next** button.
321 321  
325 +
322 322  [[image:add-integration-basic-settings.png||height="511" width="500"]]
323 323  
324 324  
329 +
325 325  **Uplink data converter:**
326 326  
327 327  * Click on the **Select existing** button.
... ... @@ -329,9 +329,11 @@
329 329  
330 330  Click **Next** button.
331 331  
337 +
332 332  [[image:add-integration-uplink-data-converter.png||width="500"]]
333 333  
334 334  
341 +
335 335  **Downlink data converter:**
336 336  
337 337  * Click on the **Select existing** button.
... ... @@ -339,9 +339,11 @@
339 339  
340 340  Click **Next** button.
341 341  
349 +
342 342  [[image:add-integration-downlink-data-converter.png||height="510" width="500"]]
343 343  
344 344  
353 +
345 345  **Connection:**
346 346  
347 347  * **Host**: mqtt.eu.thingsboard.cloud (This is the host name you copied from the device - See section xxxxx for more information)
... ... @@ -354,6 +354,7 @@
354 354  
355 355  Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
356 356  
366 +
357 357  [[image:add-integration-connection.png||width="500"]]
358 358  
359 359  
... ... @@ -361,6 +361,7 @@
361 361  
362 362  Click on the **Add** button.
363 363  
374 +
364 364  [[image:add-connection-success.png||height="511" width="500"]]
365 365  
366 366  
... ... @@ -368,18 +368,18 @@
368 368  
369 369  Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
370 370  
371 -[[image:integrations-list-added-pending.png]]
372 372  
373 373  
374 -= 5. Verifying the receipt of data from the device =
384 +[[image:integrations-list-added-pending.png]]
375 375  
376 376  
387 += Verifying the receipt of data from the device =
388 +
377 377  On the terminal, issue the following MQTT command which simulates the device S31B-NB.
378 378  
391 +
379 379  {{code language="none"}}
380 380  mosquitto_pub -d -q 1 -h mqtt.eu.thingsboard.cloud -p 1883 -t v1/devices/S31B-NB/telemetry -u "24vk3w9h7sqdld1me5eh" -m "{temperature:20}"
381 381  {{/code}}
382 382  
383 383  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.
384 -
385 -
add-connection-success.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +202.8 KB
Content
add-integration-connection.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +124.4 KB
Content
add-integration-uplink-data-converter.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +120.7 KB
Content
data-converter-list-showing-uplink-dc.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +194.9 KB
Content