Last modified by Alec Chen on 2025/04/02 18:03
From version 2.2
edited by Alec Chen
on 2025/04/02 16:28
Change comment: There is no comment for this version
To version 1.1
edited by Alec Chen
on 2025/04/02 14:48
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -How to communice Dragino -NB and -CB series devices data by MQTT with Thingseye
1 +How to integrating Dragino -NB and -CB series devices data with Thingseye
Content
... ... @@ -1,5 +3,3 @@
1 -**Table of Contents:**
2 -
3 3  = 1. Introduction =
4 4  
5 5  This document guides you on integrating Dragino **-NB** and **-CB** series devices data with Thingseye.
... ... @@ -10,36 +10,28 @@
10 10  
11 11  To complete this tutorial, you need to have certificate files. [[lns1.thingseye.io>>url:http://lns1.thingseye.io/]] is the Dragino's MQTT broker, which requires a CA certificate file, Certificate file, and the Private key file to use.
12 12  
13 -If customers need to use this MQTT connection with Thingseye, they need to contact TE team to obtain three license files or click this [[link>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates..
11 +If customers need to use this MQTT connection with Thingseye, they need to contact the TE team to obtain three license files.
14 14  
15 15  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/ins1.png?width=500&height=310&rev=1.1||alt="ins1.png" height="310" width="500"]]
16 16  
17 17  
18 -= 3.General MQTT Connection =
16 += 3. Creating Devices (Optional) =
19 19  
20 -The NB-IoT Sensor can send packet to server use MQTT protocol.
18 +**The following procedure is optional. If you haven't created any device in Thingseye first, Thingseye will automatically create a device for you based on the integration settings (the device name defined in the uplink decoder) just after it receives the first uplink from your device.Type your information message here.**
21 21  
22 -Below are the commands.
20 +First, you need to create devices in Thingseye to represent your physical devices. For example, you can name it **Device A**, and the second device could be **Device B** or any name you prefer. The device name should be unique within the **Devices** space.
23 23  
24 -**AT Commands:**
22 +In the left navigation, click **Entities -> Devices**.
25 25  
26 -{{code language="none"}}
27 -AT+PRO=3,0                           //  Set to use MQTT protocol to uplink, Payload Type select Hex payload.
28 -AT+SERVADDR=120.24.4.116,1883        //  Set MQTT server address and port
29 -AT+CLIENT=CLIENT                     //  Set up the CLIENT of MQTT
30 -AT+UNAME=UNAME                       //  Set the username of MQTT
31 -AT+PWD=PWD                           //  Set the password of MQTT
32 -AT+PUBTOPIC=NSE01_PUB                //  Set the sending topic of MQTT
33 -AT+SUBTOPIC=NSE01_SUB                //  Set the subscription topic of MQTT
34 -{{/code}}
24 +Click the **Add Device** button (the button with the **+** sign), and from the dropdown menu, click **Add new device**.
35 35  
36 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20230802112413-4.png?rev=1.1||alt="image-20230802112413-4.png"]]
26 +In the **Add new device** dialog box, enter the device name in the **Name** text box. For example, we will use **Device A**.
37 37  
38 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20230802112413-5.png?width=987&height=530&rev=1.1||alt="image-20230802112413-5.png" height="530" width="987"]]
28 +Click the **Add** button.
39 39  
40 -(% class="text-uppercase small mark" %)##**Notice: MQTT protocol has a much higher power consumption compare with UDP/CoAP protocol. Please check the power analyze document and adjust the uplink**##
30 +Skip the **connectivity testing** by clicking the **Close** button.
41 41  
42 -(% class="text-uppercase small mark" %)##**period to a suitable interval.**##
32 +The device is created and listed on the **Devices** page. Note that its initial state is **Inactive** because it has not received any data yet.
43 43  
44 44  = 4. Data Converters =
45 45  
... ... @@ -49,13 +49,12 @@
49 49  
50 50  In the left navigation, click **Integrations center**, and then click **Data converters**.
51 51  
42 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/data-converters-list-empty.png?rev=1.1||alt="data-converters-list-empty.png"]]
43 +
52 52  On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
53 53  
54 -[[image:1743578461281-635.png]]
46 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/create-new-converter-menu.png?width=500&height=259&rev=1.1||alt="create-new-converter-menu.png"]]
55 55  
56 -
57 -
58 -
59 59  The **Add data converter** window will appear.
60 60  
61 61  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**.
... ... @@ -139,15 +139,12 @@
139 139  
140 140  = 5. Add Integration =
141 141  
142 -== 5.1. Creat new MQTT integration ==
143 -
144 144  In the left navigation, click **Integrations center**, and then click **Integrations**.
145 145  
133 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/integrations-list-empty.png?rev=1.1||alt="integrations-list-empty.png"]]
134 +
146 146  On the **Integrations** page, click on the '**+**' button.
147 147  
148 -[[image:1743578691561-822.png]]
149 -
150 -
151 151  The **Add integration** window appears.
152 152  
153 153  In the **Add integration** window, configure the following settings:
... ... @@ -155,99 +155,71 @@
155 155  **Basic settings:**
156 156  
157 157  * **Integration type**: MQTT
158 -* **Name**: MQTT integration
144 +* **Name**: MQTT integration - Device A
159 159  * **Enable integration**: YES
160 -* **Debug mode**：YES
161 161  * **Allows create devices or assets**: YES
162 162  
163 163  Click **Next** button.
164 164  
165 -[[image:1743578960106-916.png||height="549" width="547"]]
150 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/add-integration-basic-settings.png?width=500&height=504&rev=1.2||alt="add-integration-basic-settings.png"]]
166 166  
152 +**Uplink data converter:**
167 167  
168 -**Uplink/downlink  data converter:**
154 +* Click on the **Select existing** button.
155 +* **Uplink data converter**: Select **MQTT Uplink Converter NB/CB **from the dropdown list.
169 169  
170 -* (((
171 -Next, directly select to create a new Uplink data converter .
172 -)))
173 -
174 174  Click **Next** button.
175 175  
176 -[[image:1743581191958-140.png||height="547" width="543"]]
159 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/add-integration-ul-data-converter.png?width=500&height=505&rev=1.1||alt="add-integration-ul-data-converter.png"]]
177 177  
178 -
179 -
180 180  **Downlink data converter:**
181 181  
182 -* Next, directly select to create a new Uplink data converter .
163 +Dragino NB/CB devices don't require a downlink data converter to decode their payloads, so you can skip this step.
183 183  
165 +* Click on the **Skip **button in the Downlink data converter section.
166 +
184 184  Click **Skip** button.
185 185  
186 -[[image:1743581287837-189.png||height="547" width="542"]]
169 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/integration-dl-skip.png?width=500&height=511&rev=1.1||alt="integration-dl-skip.png"]]
187 187  
188 -
189 189  **Connection:**
190 190  
191 -* **Host**: [[lns1.thingseye.io>>url:http://lns1.thingseye.io/]]
173 +* **Host**: Host URL (Eg. **//011731f7xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud//**)
192 192  * **Port**: 8883
193 -* **Credentials **: PEM(Paste 3 certificates to boxs below)Click this [[link>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates.
194 -* **Password:** Password or nothng
175 +* **Credentials type**: Basic
176 +* **Username**: Username (from your HiveMQ Cloud Cluster with your credentials)
177 +* **Password:** Password (from your HiveMQ Cloud Cluster with your credentials)
195 195  * **Enable SSL**: YES
196 -* **Topic: ** **It needs to align with the device's topic.**
197 -* **QoS:** 0-At most once or an MQTT QoS level
179 +* **Topic: device/a** (The topic can be anything; you can even use just the device name.)
180 +* **QoS:** 0-At most once
198 198  
199 -Click **Skip** button.
182 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/add-integartion-connection.png?width=500&height=505&rev=1.1||alt="add-integartion-connection.png"]]
200 200  
201 -[[image:1743579352961-586.png||height="507" width="502"]]
184 +Click on the **Advanced settings** button.
202 202  
203 -[[image:1743580606618-281.png||height="495" width="504"]]
186 +* **Clean session:** YES
187 +* **Retained**: YES
204 204  
189 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/add-integration-connection-advanced-settings.png?width=500&height=510&rev=1.2||alt="add-integration-connection-advanced-settings.png"]]
205 205  
206 -Click on the **Add** button.
191 +Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
207 207  
208 -You should see that the newly added integration is listed on the **Integrations** page.
193 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/check-connection.png?width=300&height=83&rev=1.1||alt="check-connection.png"]]
209 209  
210 -Since we haven't received data from a device yet, the integration **Status** is shown as **Pending,  Active  instead if it have.**
195 +If the connection is successful, you will see the **Connected** message. If not, check your connection parameters again.
211 211  
197 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/connection-success.png?width=500&height=511&rev=1.1||alt="connection-success.png"]]
212 212  
199 +Click on the **Add** button.
213 213  
201 +You should see that the newly added integration is listed on the **Integrations** page.
214 214  
203 +Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
215 215  
216 -== 5.2. Setup uplink and downlink converters ==
205 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/integration-added.png?rev=1.1||alt="integration-added.png"]]
217 217  
218 -First, you need to download the [[**MQTT uplink/downlink JS** **code**>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]].
207 += 6. Verifying the receipt of data from virtual devices =
219 219  
220 -* **Uplink Converter**
221 -
222 -The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume.
223 -
224 -Go to the **Integrations center** -> **Data converters** page, and find that MQTT uplink converter that was newly created when the integration was created.
225 -
226 -[[image:1743581830822-223.png]]
227 -
228 -
229 -Enter edit mode and apply **MQTT uplink JS code** to this uplink converter.
230 -
231 -[[image:1743581965585-763.png]]
232 -
233 -
234 -* **Downlink Converter**
235 -
236 -Go to the **Integrations center** -> **Data converters** page, and find that MQTT downlink converter that was newly created when the integration was created.
237 -
238 -
239 -Enter edit mode and apply **MQTT downlink JS code** to this downlink converter.
240 -
241 -[[image:1743582084494-111.png]]
242 -
243 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126190737-17.png?width=1114&height=527&rev=1.1||alt="image-20241126190737-17.png" height="527" width="1114"]]
244 -
245 -
246 -
247 -== ==
248 -
249 -== 6. Verifying the receipt of data from virtual devices ==
250 -
251 251  == 6.1 How does it work? ==
252 252  
253 253  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.
1743578461281-635.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -272.1 KB
Content
1743578691561-822.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -230.6 KB
Content
1743578748298-164.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -86.7 KB
Content
1743578921379-944.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -85.5 KB
Content
1743578960106-916.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -85.4 KB
Content
1743579352961-586.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -104.7 KB
Content
1743580188942-159.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -157.1 KB
Content
1743580264901-750.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -154.8 KB
Content
1743580288154-524.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -154.3 KB
Content
1743580307872-530.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -155.1 KB
Content
1743580606618-281.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -127.1 KB
Content
1743581191958-140.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -154.2 KB
Content
1743581219626-974.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -156.7 KB
Content
1743581287837-189.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -180.8 KB
Content
1743581830822-223.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -249.6 KB
Content
1743581965585-763.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -418.9 KB
Content
1743582084494-111.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Alec
Size
... ... @@ -1,1 +1,0 @@
1 -418.8 KB
Content