Skip to Content

Changes for page ThingsBoard

Last modified by Dilisi S on 2025/04/23 19:23
From version 186.1
edited by Dilisi S
on 2025/03/27 22:48
Change comment: Uploaded new attachment "add-integration-ul-data-converter.png", version {1}
To version 193.1
edited by Dilisi S
on 2025/03/27 23:31
Change comment: Mar 27 edits - part 2

Summary

Details

Page properties
Content
... ... @@ -205,8 +205,10 @@
205 205  [[image:create-new-converter-menu.png||height="259" width="500"]]
206 206  
207 207  
208 -The **Add data converter** window will appear. Name it ‘**MQTT Uplink Converter NB/CB**’ and select the Type as **Uplink**.
208 +The **Add data converter** window will appear.
209 209  
210 +Let's create an uplink data converter for the device named '**Device A**'. Name it ‘**MQTT Uplink Converter - Device A**’ and select the Type as **Uplink**.
211 +
210 210  Click on the **TBEL** button if it has not been selected by default.
211 211  
212 212  Modify the default TBEL function to match with your device as described below:
... ... @@ -283,16 +283,17 @@
283 283  Once you modify the decoder function, click on the **Add** button.
284 284  
285 285  
286 -[[image:mqtt-uplink.png||width="500"]]
287 287  
289 +[[image:ul-data-converter-device-a.png||height="524" width="500"]]
288 288  
289 289  
290 290  You should see that the newly added **MQTT Uplink converter **NB/CB is listed on the **Data Converters** page.
291 291  
292 292  
293 -[[image:data-converter-list-showing-uplink-dc.png]]
295 +[[image:ul-data-converter-added.png||height="257"]]
294 294  
295 295  
298 +
296 296  = 5. Add Integration =
297 297  
298 298  
... ... @@ -313,7 +313,7 @@
313 313  **Basic settings:**
314 314  
315 315  * **Integration type**: MQTT
316 -* **Name**: MQTT integration NB/CB
319 +* **Name**: MQTT integration - Device A
317 317  * **Enable integration**: YES
318 318  * **Allows create devices or assets**: YES
319 319  
... ... @@ -320,9 +320,11 @@
320 320  Click **Next** button.
321 321  
322 322  
323 -[[image:add-integration-basic-settings.png||height="511" width="500"]]
326 +[[image:add-integration-basic-settings.png||height="504" width="500"]]
324 324  
325 325  
329 +
330 +
326 326  **Uplink data converter:**
327 327  
328 328  * Click on the **Select existing** button.
... ... @@ -331,9 +331,10 @@
331 331  Click **Next** button.
332 332  
333 333  
334 -[[image:add-integration-uplink-data-converter.png||height="511" width="500"]]
339 +[[image:add-integration-ul-data-converter.png||height="505" width="500"]]
335 335  
336 336  
342 +
337 337  **Downlink data converter:**
338 338  
339 339  Dragino NB/CB devices don't require a downlink data converter to decode their payloads, so you can skip this step.
... ... @@ -358,9 +358,10 @@
358 358  * **Topic: device/a** (The topic can be anything; you can even use just the device name.)
359 359  * **QoS:** 0-At most once
360 360  
361 -[[image:add-integration-connection.png||height="511" width="500"]]
362 362  
368 +[[image:add-integartion-connection.png||height="505" width="500"]]
363 363  
370 +
364 364  Click on the **Advanced settings** button.
365 365  
366 366  * **Clean session:** YES
... ... @@ -388,9 +388,10 @@
388 388  Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
389 389  
390 390  
391 -[[image:new-integration-pending.png]]
398 +[[image:integration-added.png]]
392 392  
393 393  
401 +
394 394  = 6. Verifying the receipt of data from virtual devices =
395 395  
396 396  
... ... @@ -413,7 +413,7 @@
413 413  == 5.2 Sending messages ==
414 414  
415 415  
416 -On the terminal, issue the following MQTT command which simulates the device S31B-NB. The message payload contains the fields temperature and humidity, which hold the values S31B-NB and 27, respectively. This payload is also (technically) known as telemetry.
424 +On your computer's terminal, issue the following MQTT command which simulates the device '**Device A'**. The message payload contains the fields IMEI, temperature, humidity, and pressure, which hold the values 350693903995577, 30, 80, and 1005 respectively. This payload is also (technically) known as telemetry.
417 417  
418 418  {{code language="none"}}
419 419  mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" -t "device/a" -m '{"IMEI":"350693903995577", "temperature":30, "humidity":80, "pressure":1005}'
... ... @@ -425,8 +425,6 @@
425 425  [[image:integration-active.png]]
426 426  
427 427  
428 -
429 -
430 430  == 6.3 Viewing messages ==
431 431  
432 432  
... ... @@ -445,21 +445,28 @@
445 445  Then click on the **Apply changes** (//**tick icon**//) button.
446 446  
447 447  
448 -[[image:Screenshot 2025-03-18 at 09.23.10.png]]
454 +[[image:debug-enabled.png||height="301" width="700"]]
449 449  
450 450  
457 +
458 +
451 451  Now go to the **Events** tab.
452 452  
453 -Select the Event type as **Debug** from the dropdown list.
461 +Select the **Event type** as **Debug** from the dropdown list.
454 454  
455 -Now you can see all the Uplink messages you are simulating through the MQTT broker. The status should be **OK **if there is no errors in your integration.
463 +Publish another message (of course, you can repeat the previous message by pressing the UP arrow on your keyboard and then press Enter key) to your MQTT broker from your terminal, for example:
456 456  
465 +{{code language="none"}}
466 +mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" -t "device/a" -m '{"IMEI":"350693903995577", "temperature":30, "humidity":80, "pressure":1005}'
467 +{{/code}}
457 457  
458 -[[image:Screenshot 2025-03-26 at 19.49.31.png]]
469 +Now you can see that uplink message in the **Events** tab (Click the **refresh** button if you didn't see any messages in the Events tab). The status should be **OK **if there is no errors in your integration.
459 459  
460 460  
472 +[[image:Screenshot 2025-03-26 at 19.49.31.png]]
461 461  
462 462  
475 +
463 463  Then click on the **three dots (...)** in the **Message** column. You can see the uplink message's **payload** in the **Message** window.
464 464  
465 465  
... ... @@ -583,6 +583,3 @@
583 583  {{/info}}
584 584  
585 585  [[image:image-4.png]]
586 -
587 -
588 -
integration-active.png
Size
... ... @@ -1,1 +1,1 @@
1 -64.2 KB
1 +64.1 KB
Content
add-integartion-connection.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +110.3 KB
Content
add-integartion-connetcion.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +146.0 KB
Content
debug-enabled.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +196.3 KB
Content
integration-added.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +196.2 KB
Content