Summary

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

Details

Page properties

Author

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

Content

...	...	@@ -6,20 +6,21 @@
6	6	Draft Document
7	7	{{/warning}}
8	8
9		-= Introduction =
	9	+= 1. Introduction =
10	10
	11	+
11	11	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.
12	12
13	13	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**.
14	14
15	15
16		-= Add New Device =
	17	+= 2. Add New Device =
17	17
	19	+
18	18	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.
19	19
20	20	In the left navigation, click **Entities** and then click **Devices**.
21	21
22		-
23	23	[[image:device-list-empty.png]]
24	24
25	25
...	...	@@ -85,22 +85,22 @@
85	85	[[image:virtual-device-active.png]]
86	86
87	87
88		-= Data Converters =
	89	+= 3. Data Converters =
89	89
	91	+
90	90	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.
91	91
92	92
93		-== Uplink ==
	95	+== 3.1 Uplink ==
94	94
	97	+
95	95	In the left navigation, click **Integrations center**, and then click **Data converters**.
96	96
97		-
98	98	[[image:data-converter-list-page.png]]
99	99
100	100
101	101	On the **Data converters** page, click on the ‘+’ button, and then click on the **Create new converter** from the dropdown menu.
102	102
103		-
104	104	[[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
105	105
106	106
...	...	@@ -231,24 +231,22 @@
231	231
232	232	{{/code}}
233	233
	235	+
234	234	Click on the **Add** button.
235	235
236		-
237	237	[[image:uplink-data-converter.png||height="529" width="500"]]
238	238
239	239
240		-
241	241	You should see that the newly added **uplink data converter** is listed on the **Data Converters** page.
242	242
243		-
244	244	[[image:data-converter-list-showing-uplink-dc.png]]
245	245
246	246
247		-== Downlink ==
	246	+== 3.2 Downlink ==
248	248
	248	+
249	249	On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
250	250
251		-
252	252	[[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
253	253
254	254
...	...	@@ -289,24 +289,21 @@
289	289
290	290	Click on the **Add** button.
291	291
292		-
293	293	[[image:downlink-data-converter.png||height="530" width="500"]]
294	294
295	295
296		-
297	297	You should see that the newly added **downlink data converter** is listed on the **Data Converters** page.
298	298
299		-
300	300	[[image:data-converter-list.png]]
301	301
302	302
303		-= Add Integration =
	299	+= 4. Add Integration =
304	304
	301	+
305	305	In the left navigation, click **Integrations center**, and then click **Integrations**.
306	306
307	307	On the **Integrations** page, click on the '**+**' button.
308	308
309		-
310	310	[[image:data-converter-list-page.png]]
311	311
312	312
...	...	@@ -322,11 +322,9 @@
322	322
323	323	Click **Next** button.
324	324
325		-
326	326	[[image:add-integration-basic-settings.png||height="511" width="500"]]
327	327
328	328
329		-
330	330	**Uplink data converter:**
331	331
332	332	* Click on the **Select existing** button.
...	...	@@ -334,11 +334,9 @@
334	334
335	335	Click **Next** button.
336	336
337		-
338	338	[[image:add-integration-uplink-data-converter.png||width="500"]]
339	339
340	340
341		-
342	342	**Downlink data converter:**
343	343
344	344	* Click on the **Select existing** button.
...	...	@@ -346,11 +346,9 @@
346	346
347	347	Click **Next** button.
348	348
349		-
350	350	[[image:add-integration-downlink-data-converter.png||height="510" width="500"]]
351	351
352	352
353		-
354	354	**Connection:**
355	355
356	356	* **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 @@
363	363
364	364	Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
365	365
366		-
367	367	[[image:add-integration-connection.png||width="500"]]
368	368
369	369
...	...	@@ -371,7 +371,6 @@
371	371
372	372	Click on the **Add** button.
373	373
374		-
375	375	[[image:add-connection-success.png||height="511" width="500"]]
376	376
377	377
...	...	@@ -379,18 +379,18 @@
379	379
380	380	Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
381	381
382		-
383		-
384	384	[[image:integrations-list-added-pending.png]]
385	385
386	386
387		-= Verifying the receipt of data from the device =
	373	+= 5. Verifying the receipt of data from the device =
388	388
	375	+
389	389	On the terminal, issue the following MQTT command which simulates the device S31B-NB.
390	390
391		-
392	392	{{code language="none"}}
393	393	mosquitto_pub -d -q 1 -h mqtt.eu.thingsboard.cloud -p 1883 -t v1/devices/S31B-NB/telemetry -u "24vk3w9h7sqdld1me5eh" -m "{temperature:20}"
394	394	{{/code}}
395	395
396	396	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.
	383	+
	384	+