Summary

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

Details

Page properties

Author

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

Content

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