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

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -How to integrating Dragino -NB and -CB series devices data with Thingseye
1 +How to communice Dragino -NB and -CB series devices data by MQTT with Thingseye
Content
... ... @@ -1,3 +1,5 @@
1 +**Table of Contents:**
2 +
1 1  = 1. Introduction =
2 2  
3 3  This document guides you on integrating Dragino **-NB** and **-CB** series devices data with Thingseye.
... ... @@ -8,28 +8,36 @@
8 8  
9 9  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.
10 10  
11 -If customers need to use this MQTT connection with Thingseye, they need to contact the TE team to obtain three license files.
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..
12 12  
13 13  [[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"]]
14 14  
15 15  
16 -= 3. Creating Devices (Optional) =
18 += 3.General MQTT Connection =
17 17  
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.**
20 +The NB-IoT Sensor can send packet to server use MQTT protocol.
19 19  
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.
22 +Below are the commands.
21 21  
22 -In the left navigation, click **Entities -> Devices**.
24 +**AT Commands:**
23 23  
24 -Click the **Add Device** button (the button with the **+** sign), and from the dropdown menu, click **Add new device**.
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}}
25 25  
26 -In the **Add new device** dialog box, enter the device name in the **Name** text box. For example, we will use **Device A**.
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"]]
27 27  
28 -Click the **Add** button.
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"]]
29 29  
30 -Skip the **connectivity testing** by clicking the **Close** button.
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**##
31 31  
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.
42 +(% class="text-uppercase small mark" %)##**period to a suitable interval.**##
33 33  
34 34  = 4. Data Converters =
35 35  
... ... @@ -39,12 +39,13 @@
39 39  
40 40  In the left navigation, click **Integrations center**, and then click **Data converters**.
41 41  
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 -
44 44  On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
45 45  
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"]]
54 +[[image:1743578461281-635.png]]
47 47  
56 +
57 +
58 +
48 48  The **Add data converter** window will appear.
49 49  
50 50  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**.
... ... @@ -128,12 +128,15 @@
128 128  
129 129  = 5. Add Integration =
130 130  
142 +== 5.1. Creat new MQTT integration ==
143 +
131 131  In the left navigation, click **Integrations center**, and then click **Integrations**.
132 132  
133 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/integrations-list-empty.png?rev=1.1||alt="integrations-list-empty.png"]]
134 -
135 135  On the **Integrations** page, click on the '**+**' button.
136 136  
148 +[[image:1743578691561-822.png]]
149 +
150 +
137 137  The **Add integration** window appears.
138 138  
139 139  In the **Add integration** window, configure the following settings:
... ... @@ -141,71 +141,99 @@
141 141  **Basic settings:**
142 142  
143 143  * **Integration type**: MQTT
144 -* **Name**: MQTT integration - Device A
158 +* **Name**: MQTT integration
145 145  * **Enable integration**: YES
160 +* **Debug mode**：YES
146 146  * **Allows create devices or assets**: YES
147 147  
148 148  Click **Next** button.
149 149  
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"]]
165 +[[image:1743578960106-916.png||height="549" width="547"]]
151 151  
152 -**Uplink data converter:**
153 153  
154 -* Click on the **Select existing** button.
155 -* **Uplink data converter**: Select **MQTT Uplink Converter NB/CB **from the dropdown list.
168 +**Uplink/downlink  data converter:**
156 156  
170 +* (((
171 +Next, directly select to create a new Uplink data converter .
172 +)))
173 +
157 157  Click **Next** button.
158 158  
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"]]
176 +[[image:1743581191958-140.png||height="547" width="543"]]
160 160  
161 -**Downlink data converter:**
162 162  
163 -Dragino NB/CB devices don't require a downlink data converter to decode their payloads, so you can skip this step.
164 164  
165 -* Click on the **Skip **button in the Downlink data converter section.
180 +**Downlink data converter:**
166 166  
182 +* Next, directly select to create a new Uplink data converter .
183 +
167 167  Click **Skip** button.
168 168  
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"]]
186 +[[image:1743581287837-189.png||height="547" width="542"]]
170 170  
188 +
171 171  **Connection:**
172 172  
173 -* **Host**: Host URL (Eg. **//011731f7xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud//**)
191 +* **Host**: [[lns1.thingseye.io>>url:http://lns1.thingseye.io/]]
174 174  * **Port**: 8883
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)
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
178 178  * **Enable SSL**: YES
179 -* **Topic: device/a** (The topic can be anything; you can even use just the device name.)
180 -* **QoS:** 0-At most once
196 +* **Topic: ** **It needs to align with the device's topic.**
197 +* **QoS:** 0-At most once or an MQTT QoS level
181 181  
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"]]
199 +Click **Skip** button.
183 183  
184 -Click on the **Advanced settings** button.
201 +[[image:1743579352961-586.png||height="507" width="502"]]
185 185  
186 -* **Clean session:** YES
187 -* **Retained**: YES
203 +[[image:1743580606618-281.png||height="495" width="504"]]
188 188  
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"]]
190 190  
191 -Click on the **Check connection** button to verify the MQTT connection using the provided parameters.
206 +Click on the **Add** button.
192 192  
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"]]
208 +You should see that the newly added integration is listed on the **Integrations** page.
194 194  
195 -If the connection is successful, you will see the **Connected** message. If not, check your connection parameters again.
210 +Since we haven't received data from a device yet, the integration **Status** is shown as **Pending,  Active  instead if it have.**
196 196  
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"]]
198 198  
199 -Click on the **Add** button.
200 200  
201 -You should see that the newly added integration is listed on the **Integrations** page.
202 202  
203 -Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.**
204 204  
205 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/integration-added.png?rev=1.1||alt="integration-added.png"]]
216 +== 5.2. Setup uplink and downlink converters ==
206 206  
207 -= 6. Verifying the receipt of data from virtual devices =
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]].
208 208  
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 +
209 209  == 6.1 How does it work? ==
210 210  
211 211  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,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +272.1 KB
Content
1743578691561-822.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +230.6 KB
Content
1743578748298-164.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +86.7 KB
Content
1743578921379-944.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +85.5 KB
Content
1743578960106-916.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +85.4 KB
Content
1743579352961-586.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +104.7 KB
Content
1743580188942-159.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +157.1 KB
Content
1743580264901-750.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +154.8 KB
Content
1743580288154-524.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +154.3 KB
Content
1743580307872-530.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +155.1 KB
Content
1743580606618-281.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +127.1 KB
Content
1743581191958-140.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +154.2 KB
Content
1743581219626-974.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +156.7 KB
Content
1743581287837-189.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +180.8 KB
Content
1743581830822-223.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +249.6 KB
Content
1743581965585-763.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +418.9 KB
Content
1743582084494-111.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Alec
Size
... ... @@ -1,0 +1,1 @@
1 +418.8 KB
Content