Summary

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

Details

Page properties

Content

...	...	@@ -15,12 +15,10 @@
15	15
16	16	= Add New Device =
17	17
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		-
20	20	In the left navigation, click **Entities** and then click **Devices**.
21	21
22	22
23		-[[image:device-list-empty.png]]
	21	+[[image:ThingsBoard-Device.png]]
24	24
25	25
26	26	On the **Devices **page, click on the ‘**+**’ button, and then click on the **Add new device **from the dropdown menu.
...	...	@@ -29,50 +29,7 @@
29	29	[[image:ThingsBoard-add-new-device.png||height="279" width="500"]]
30	30
31	31
32		-The **Add new device** window appears. Name the device, for example '**Virtual NB/CB device**'.
33	33
34		-Click on the **Next: Credentials** button.
35		-
36		-
37		-[[image:new-device-device-details.png||height="529" width="500"]]
38		-
39		-
40		-Click the **Access token** button if it is not selected by default.
41		-
42		-Copy the **Access token** to a text editor, as you will need it in the section **'Sending data from an MQTT client'**.
43		-
44		-Click on the **Add** button.
45		-
46		-[[image:new-device-access-token.png||height="528" width="500"]]
47		-
48		-
49		-Click on the **MQTT** button.
50		-
51		-Then, select the operating system you are going to use with the **Mosquitto MQTT Broker**. This example shows sending a command from a computer running **MacOS**. First, install the necessary client tools on your computer.
52		-
53		-Copy the MQTT pub command in the '**Execute the following command**' section.
54		-
55		-{{code language="none"}}
56		-mosquitto_pub -d -q 1 -h mqtt.eu.thingsboard.cloud -p 1883 -t v1/devices/me/telemetry -u "24vk3w9h7sqdld1me5eh" -m "{temperature:25}"
57		-{{/code}}
58		-
59		-Note that the **State** is still shown as **'Inactive'** in the **Latest telemetry** section.
60		-
61		-[[image:new-device-check-connectivity.png||height="522" width="500"]]
62		-
63		-
64		-On the terminal, enter the command you copied. This command sends the MQTT payload **{temperature:25}** as telemetry data from a virtual device named **'me'**.
65		-
66		-
67		-[[image:mqtt-command-1.png||height="228" width="700"]]
68		-
69		-
70		-
71		-
72		-[[image:new-device-telemetry-test.png||height="520" width="500"]]
73		-
74		-
75		-
76	76	= Data Converters =
77	77
78	78	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.
...	...	@@ -346,7 +346,7 @@
346	346	* **Credentials**: Basic
347	347	* **Username**: Access token (This is the access token you copied from the device)
348	348	* **Password** - Leave it as blank
349		-* **Topic** - v1/devices/+/telemetry (sightly modify the topic 'v1/devices/me/telemetry' you copied from the device to enable receiving data from any 'device name')
	304	+* **Topic** - v1/devices/+/telemetry (sightly modify the topic 'v1/devices/me/telemetry' you copied for the device to enable receiving data from any 'device name')
350	350	* **QoS** - 0-At most once
351	351
352	352	Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
...	...	@@ -363,15 +363,18 @@
363	363	[[image:add-connection-success.png||height="511" width="500"]]
364	364
365	365
366		-You should see that the newly added integration is listed on the **Integrations** page.
367	367
368		-Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
369	369
370	370
371	371
372		-[[image:integrations-list-added-pending.png]]
373	373
	326	+You should see that the newly added integration is listed on the **Integrations** page.
374	374
	328	+Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
	329	+
	330	+[[image:Integrations-list.png]]
	331	+
	332	+
375	375	= Verifying the receipt of data from the device =
376	376
377	377	Connect **S31B-NB** to transfer information. If the integration was performed without errors, after the transmission of the first telemetry, a new device with the name “xxxxx” 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.