Skip to Content
Last modified by Xiaoling on 2022/09/02 18:11
From version 44.2
edited by Xiaoling
on 2022/05/31 14:32
Change comment: There is no comment for this version
To version 50.2
edited by Xiaoling
on 2022/09/02 18:10
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -**Contents: **
1 +**Table of Contents: **
2 2  
3 3  {{toc/}}
4 4  
... ... @@ -7,11 +7,14 @@
7 7  
8 8  = 1. What is MQTT API? =
9 9  
10 -{{{MQTT is a publish/subscribe model that runs over TCP/IP sockets or WebSockets. MQTT over WebSockets can be secured with SSL.}}}
11 11  
11 +MQTT is a publish/subscribe model that runs over TCP/IP sockets or WebSockets. MQTT over WebSockets can be secured with SSL.
12 12  
13 +
14 +
13 13  = 2. MQTT Features =
14 14  
17 +
15 15  The MQTT protocol runs on TCP / IP or other network protocols and provides an ordered, lossless, bidirectional connection. Features include:
16 16  
17 17  * The publish / subscribe messaging pattern used, which provides one-to-many messaging for decoupling from the application.
... ... @@ -24,10 +24,15 @@
24 24  
25 25  
26 26  
30 +
31 +
27 27  = 3. What does this example shows? How it works? =
28 28  
34 +
29 29  (((
30 30  The server we use here is ThingSpeak which has an intuitive chart to show the test result for our test.The ThingSpeak IoT service now supports MQTT subscriptions to receive instant updates when [[ThingSpeak>>url:https://thingspeak.com/]] channel gets updated. The method here is general and can be used with other IoT servers for MQTT connection as well.
37 +
38 +
31 31  )))
32 32  
33 33  [[image:image-20220531135402-1.png]]
... ... @@ -40,6 +40,7 @@
40 40  working principle
41 41  
42 42  
51 +
43 43  [[image:image-20220531135521-3.png]]
44 44  
45 45  (((
... ... @@ -50,6 +50,7 @@
50 50  
51 51  [[image:image-20220531135607-4.png]]
52 52  
62 +
53 53  (((
54 54  Schematic diagram:downlink.In this section, we will try to program LG01 to fetch download data from ThingSpeak, then broadcast this data to local LoRa network. The end node will get this message and check if they need to do something. Similar with Uplink Example, we will first try to do it in PC, then do it in Linux side, and finally integrate it with LoRa.
55 55  )))
... ... @@ -63,11 +63,16 @@
63 63  )))
64 64  
65 65  
76 +
66 66  = 4. Preparation =
67 67  
79 +
68 68  == 4.1 Hardware ==
69 69  
82 +
70 70  1. [[image:image-20220531135650-5.png]](((
84 +
85 +
71 71  Listening on the LoRa wireless channel, while there is new LoRa packet arrives, parse it and send out to IoT Server.
72 72  
73 73  
... ... @@ -74,22 +74,38 @@
74 74  
75 75  )))
76 76  1. [[image:image-20220531135750-6.png]](((
92 +
93 +
77 77  The LoRa End node keeps getting temperature and humidity from the sensor and sends out via LoRa periodically.
95 +
96 +
97 +
78 78  )))
79 79  
80 80  == 4.2 Software ==
81 81  
102 +
82 82  1. [[4.3.4 version>>url:http://www.dragino.com/downloads/index.php?dir=motherboards/ms14/Firmware/IoT/]]
83 83  1. [[MQTT_Client>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/IoTServer/ThingSpeak/MQTT_Client]]
84 84  1. [[MQTT_Simple_Server MQTT_Simeple_Server>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/LoRa/MQTT_Simple_Server]]
85 85  1. [[DHTlib>>url:https://github.com/goodcheney/Lora/blob/patch-1/Lora%20Shield/Examples/DHTlib.zip]]
86 86  
108 +
109 +
110 +
111 +
87 87  == 4.3 Server(For example) ==
88 88  
114 +
89 89  * [[ThingSpeak>>url:https://thingspeak.com/]]
90 90  
117 +
118 +
119 +
120 +
91 91  == 4.4 Configure IoT Server ==
92 92  
123 +
93 93  * Need this keys:
94 94  
95 95  1. [[image:image-20220531140054-8.png]](((
... ... @@ -99,6 +99,8 @@
99 99  
100 100  )))
101 101  1. [[image:image-20220531140326-13.png]](((
133 +
134 +
102 102  Account->My Profile,MQTT API Key
103 103  
104 104  
... ... @@ -106,12 +106,17 @@
106 106  )))
107 107  1. (((
108 108  [[image:image-20220531140304-12.png]]
142 +
143 +
144 +
109 109  )))
110 110  
111 111  == 4.5 Configure LG01 settings ==
112 112  
113 -Tips:Please confirm that your LG01 version is 4.3.3.
114 114  
150 +Tips:  Please confirm that your LG01 version is 4.3.3.
151 +
152 +
115 115  [[image:image-20220531140248-11.png]]
116 116  
117 117  **Overview**
... ... @@ -123,6 +123,7 @@
123 123  **Senosor->IOT Server**
124 124  
125 125  
164 +
126 126  [[image:image-20220531140458-15.png]]
127 127  
128 128  **MQTT->Configure MQTT Server**
... ... @@ -143,29 +143,44 @@
143 143  
144 144  [[image:image-20220531140651-18.png]]
145 145  
185 +
146 146  Configure network access.**Network->Internet Access**
147 147  
148 148  
189 +
149 149  == 4.6 Try MQTT API call with LG01 Linux command ==
150 150  
192 +
151 151  === 4.6.1 Input the command at the console ===
152 152  
195 +
153 153  1. [[image:image-20220531140811-19.png]](((
197 +
198 +
154 154  Open this Application.
155 155  
201 +
156 156  
157 157  )))
158 158  1. [[image:image-20220531140842-20.png]](((
205 +
206 +
159 159  Input passward(dragino).After into the console.
160 160  
209 +
161 161  
162 162  )))
163 163  1. [[image:image-20220531140915-21.png]](((
213 +
214 +
164 164  First, we need to make sure the LG01 has internet access. We can log in the SSH and ping an Internet address and see if it get through. As below
165 165  
217 +
166 166  
167 167  )))
168 168  1. [[image:image-20220531140955-22.png]](((
221 +
222 +
169 169  LG01 has built-in Linux tool mosquitto. It is a very powerful tool for http communication. We can use this tool to handle MQTT API call in LG01. Input this command and replace your keys.
170 170  
171 171  
... ... @@ -172,7 +172,11 @@
172 172  
173 173  )))
174 174  1. [[image:image-20220531141026-23.png]](((
229 +
230 +
175 175  Go to Server check out result.We success to use LG01 to uplink data to ThingSpeak,the mosquitto_pub command is executed in the Linux side, finally, we will have to call mosquitto_pub command with sensor data variable in Arduino side. This is through the process class in Arduino and we will show it in the final sketch.
232 +
233 +
176 176  )))
177 177  
178 178  * This command:
... ... @@ -192,9 +192,13 @@
192 192  )))
193 193  
194 194  
253 +
195 195  === 4.6.2 Input the command at the console(LG01 new version:4.3.4) ===
196 196  
256 +
197 197  1. [[image:image-20220531141150-24.png]](((
258 +
259 +
198 198  Open this Application.
199 199  
200 200  
... ... @@ -203,6 +203,7 @@
203 203  1. (((
204 204  [[image:image-20220531141400-27.png]]
205 205  
268 +
206 206  Check the settings.
207 207  
208 208  
... ... @@ -211,6 +211,7 @@
211 211  1. (((
212 212  [[image:image-20220531141601-30.png]]
213 213  
277 +
214 214  input this command.
215 215  
216 216  
... ... @@ -217,6 +217,8 @@
217 217  
218 218  )))
219 219  1. [[image:image-20220531141515-29.png]](((
284 +
285 +
220 220  Check the result.
221 221  
222 222  
... ... @@ -225,6 +225,7 @@
225 225  
226 226  == 4.7 Updata data to Server(Through MQTT) ==
227 227  
294 +
228 228  * This version of Sketch implements these features:
229 229  
230 230  1. Read the LG01 configuration information from Linux.
... ... @@ -232,7 +232,11 @@
232 232  1. Send reply after then receive LoRa node data.
233 233  1. Sketch will write active content to /tmp/iot/status periodically (every 5 minutes).(Watchdog feature)
234 234  
235 -1. [[image:image-20220531141656-31.png]](((
302 +
303 +
304 +1. [[image:image-20220531143822-49.png]](((
305 +
306 +
236 236  Open the sketch [[MQTT_Simple_Server>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/LoRa/MQTT_Simple_Server]].(Board:Dragino Yun + UNO or LG01/OLG01,Port:Network ports.)and upload.
237 237  
238 238  
... ... @@ -239,12 +239,16 @@
239 239  
240 240  )))
241 241  1. [[image:image-20220531141800-32.png]](((
313 +
314 +
242 242  Open Serial monitor.
243 243  
244 244  
245 245  
246 246  )))
247 -1. [[image:image-20220531141842-33.png]](((
320 +1. [[image:image-20220531143748-48.png]](((
321 +
322 +
248 248  Open the Sketch [[MQTT_Client>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/IoTServer/ThingSpeak/MQTT_Client]]. (Board:Arduino/Genuino Uno.Port:Serial ports.)and upload.
249 249  
250 250  
... ... @@ -251,6 +251,8 @@
251 251  
252 252  )))
253 253  1. [[image:image-20220531141927-34.png]](((
329 +
330 +
254 254  Open Serial monitor.
255 255  
256 256  
... ... @@ -258,13 +258,13 @@
258 258  )))
259 259  1. Go to IoT Server to check the result.
260 260  1. (((
261 -[[image:image-20220531142023-35.png]]
338 +[[image:image-20220531143707-47.png]]
262 262  
263 263  
264 264  
265 265  )))
266 266  1. (((
267 -[[image:image-20220531142155-36.png]]
344 +[[image:image-20220531143632-46.png]]
268 268  
269 269  
270 270  
... ... @@ -272,8 +272,10 @@
272 272  
273 273  = 5. FAQ =
274 274  
352 +
275 275  == 5.1 Configure to support general mqtt server ==
276 276  
355 +
277 277  First, try to run **mosquitto_pub** in Linux console to send a data to MQTT server.
278 278  
279 279  For example: for ThingSpeak, a MQTT publish command is:
... ... @@ -288,6 +288,8 @@
288 288  1. LG01 web console -> Sensor -> MQTT
289 289  1. Choose general Server
290 290  1. [[image:image-20220531142342-37.png]](((
370 +
371 +
291 291  Refer to your server to fill in.
292 292  
293 293  
... ... @@ -294,6 +294,8 @@
294 294  
295 295  )))
296 296  1. [[image:image-20220531142447-38.png]](((
378 +
379 +
297 297  Ex:ThingSpeak Server
298 298  
299 299  
... ... @@ -317,13 +317,17 @@
317 317  
318 318  [[image:image-20220531142525-39.png]]
319 319  
403 +
320 320  MQTT Logread example
321 321  
322 322  
407 +
323 323  == 5.2 What is Watchdog feature? ==
324 324  
410 +
325 325  LG01 for 4.3.3 version,we have added watchdog feature. In order to avoid the gateway running process will get stuck. So add writing action on every times.
326 326  
413 +
327 327  * [[image:image-20220531142558-40.png]](((
328 328  Enable Sensor->Micro-Controller settings
329 329  
... ... @@ -331,6 +331,8 @@
331 331  
332 332  )))
333 333  * [[image:image-20220531142629-41.png]](((
421 +
422 +
334 334  Open the sketch [[MQTT_Simple_Server>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/LoRa/MQTT_Simple_Server]].(Board:Dragino Yun + UNO or LG01/OLG01,Port:Network ports.)and upload.
335 335  
336 336  
... ... @@ -337,6 +337,8 @@
337 337  
338 338  )))
339 339  * [[image:image-20220531142659-42.png]](((
429 +
430 +
340 340  Each time the function loops, it uses the watchdog function once.
341 341  
342 342  
... ... @@ -343,6 +343,8 @@
343 343  
344 344  )))
345 345  * [[image:image-20220531142720-43.png]](((
437 +
438 +
346 346  Open SSH and check watchdog result.If the result change constantly,the feature enable successfully.
347 347  
348 348  
... ... @@ -349,6 +349,8 @@
349 349  
350 350  )))
351 351  * [[image:image-20220531142748-44.png]](((
445 +
446 +
352 352  If the time doesnt's change,you can refer it to calculate for checking status.
353 353  )))
354 354  
image-20220531143604-45.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.6 KB
Content
image-20220531143632-46.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.4 KB
Content
image-20220531143707-47.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +34.2 KB
Content
image-20220531143748-48.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +38.8 KB
Content
image-20220531143822-49.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +38.1 KB
Content