Summary

• Page properties (1 modified, 0 added, 0 removed)
• Attachments (0 modified, 1 added, 0 removed)
  • dashboard-3.png

Details

Page properties

Content

...	...	@@ -384,6 +384,7 @@
384	384
385	385	== 5.1 How does it work? ==
386	386
	387	+
387	387	We use the Mosquitto MQTT client to simulate MQTT messages, acting as a virtual device. First, install the Mosquitto client on your computer from [[this link>>url:https://mosquitto.org/download/]]. The Mosquitto client publishes messages to the MQTT broker (HiveMQ) on a specified MQTT topic. ThingsBoard subscribes to these messages using the same topic.
388	388
389	389	The Mosquitto client publishes messages on the topic v1/devices/[device_name]/telemetry. The [device_name]placeholder can be replaced with any device name, for example, 'S31B-NB'. Then, the MQTT topic would be v1/devices/S31B-NB/telemetry.
...	...	@@ -397,12 +397,12 @@
397	397	For example, if you send two MQTT messages with different device names in the topic:
398	398
399	399	1. v1/devices/**S31B-NB**/telemetry
400		-1. v1/devices/**S31B-CB**/telemetry
	401	+1. v1/devices/**LDS25-NB**/telemetry
401	401
402		-ThingsBoard will create two devices named **S31B-NB** and **S31B-CB** in the **//Devices//** section.
	403	+ThingsBoard will create two devices named **S31B-NB** and **LDS25-NB** in the **//Devices//** section.
403	403
404	404
405		-The MQTT payload format is as follows, for example:
	406	+The MQTT payload format is as follows, which is common for all ~-~-NB and ~-~-CB series devices:
406	406
407	407	{{code language="none"}}
408	408	{"temperature":10.4, "humidity":85}
...	...	@@ -415,7 +415,73 @@
415	415	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 10.4 and 85, respectively. This payload is also (technically) known as telemetry.
416	416
417	417	{{code language="none"}}
418		-mosquitto_pub -d -q 1 -h 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/SN-001/telemetry" -u "pradeeka" -P "Kalpani123@" -m '{"temperature":10.4, "humidity":85}'
	419	+mosquitto_pub -d -q 1 -h 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/S31B-NB/telemetry" -u "pradeeka" -P "Kalpani123@" -m '{"temperature":10.4, "humidity":85}'
419	419	{{/code}}
420	420
421		-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.
	422	+If the integration was performed without errors, the status of the integration changes to 'Active' after the first telemetry transmission.
	423	+
	424	+
	425	+[[image:integration-active.png]]
	426	+
	427	+
	428	+Also, a new device named **S31B-NB** will appear under **//Entities -> Devices -> All//**. This means the first MQTT message triggers ThingsBoard to provision a device named **S31B-NB**.
	429	+
	430	+
	431	+[[image:device-provision-1.png]]
	432	+
	433	+
	434	+Click on the device S31B-NB on the devices list to see its details.
	435	+
	436	+Then go to the **Latest telemetry** tab.
	437	+
	438	+You can see the fields temperature and humidity with the values you previously sent using the MQTT message.
	439	+
	440	+
	441	+[[image:telemetry-1.png]]
	442	+
	443	+
	444	+Now, change the values of the fields and send the MQTT message again. For example, set temperature to 20 and humidity to 70. Observe how the values update in //Latest Telemetry//.
	445	+
	446	+
	447	+[[image:telemetry-2.png]]
	448	+
	449	+
	450	+Let's provision the second device named **LDS25-NB **with initial telemetry. Use the following MQTT message.
	451	+
	452	+
	453	+{{code language="none"}}
	454	+mosquitto_pub -d -q 1 -h 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/LDS25-NB/telemetry" -u "pradeeka" -P "Kalpani123@" -m '{"temperature":11, "humidity":87}'
	455	+{{/code}}
	456	+
	457	+Now, refresh the **Devices** page, and you will see the second device, **LDS25-NB**, which was recently provisioned.
	458	+
	459	+
	460	+[[image:device-provision-2.png]]
	461	+
	462	+
	463	+= 6. Creating a Dashboard =
	464	+
	465	+
	466	+In ThingsBoard, from the left navigation menu, click **Dashboards**. Then, click the **+** button and select **Create new dashboard** from the dropdown menu.
	467	+
	468	+
	469	+[[image:dashboard-1.png]]
	470	+
	471	+
	472	+In the **Title** text box, enter **NB/CB Test Dashboard** as the title of the dashboard.
	473	+
	474	+Click on the **Add** button.
	475	+
	476	+
	477	+[[image:dashboard-2.png||height="526" width="500"]]
	478	+
	479	+
	480	+Click on the **Add widget / Add new widget** button.
	481	+
	482	+
	483	+[[image:dashboard-3.png]]
	484	+
	485	+
	486	+
	487	+
	488	+

dashboard-3.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+141.3 KB

Content