Skip to Content
Last modified by Xiaoling on 2022/09/02 18:11
From version 44.4
edited by Xiaoling
on 2022/05/31 14:33
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  )))
... ... @@ -66,9 +66,13 @@
66 66  
67 67  = 4. Preparation =
68 68  
79 +
69 69  == 4.1 Hardware ==
70 70  
82 +
71 71  1. [[image:image-20220531135650-5.png]](((
84 +
85 +
72 72  Listening on the LoRa wireless channel, while there is new LoRa packet arrives, parse it and send out to IoT Server.
73 73  
74 74  
... ... @@ -75,11 +75,17 @@
75 75  
76 76  )))
77 77  1. [[image:image-20220531135750-6.png]](((
92 +
93 +
78 78  The LoRa End node keeps getting temperature and humidity from the sensor and sends out via LoRa periodically.
95 +
96 +
97 +
79 79  )))
80 80  
81 81  == 4.2 Software ==
82 82  
102 +
83 83  1. [[4.3.4 version>>url:http://www.dragino.com/downloads/index.php?dir=motherboards/ms14/Firmware/IoT/]]
84 84  1. [[MQTT_Client>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/IoTServer/ThingSpeak/MQTT_Client]]
85 85  1. [[MQTT_Simple_Server MQTT_Simeple_Server>>url:https://github.com/dragino/Arduino-Profile-Examples/tree/master/libraries/Dragino/examples/LoRa/MQTT_Simple_Server]]
... ... @@ -87,12 +87,20 @@
87 87  
88 88  
89 89  
110 +
111 +
90 90  == 4.3 Server(For example) ==
91 91  
114 +
92 92  * [[ThingSpeak>>url:https://thingspeak.com/]]
93 93  
117 +
118 +
119 +
120 +
94 94  == 4.4 Configure IoT Server ==
95 95  
123 +
96 96  * Need this keys:
97 97  
98 98  1. [[image:image-20220531140054-8.png]](((
... ... @@ -102,6 +102,8 @@
102 102  
103 103  )))
104 104  1. [[image:image-20220531140326-13.png]](((
133 +
134 +
105 105  Account->My Profile,MQTT API Key
106 106  
107 107  
... ... @@ -109,12 +109,17 @@
109 109  )))
110 110  1. (((
111 111  [[image:image-20220531140304-12.png]]
142 +
143 +
144 +
112 112  )))
113 113  
114 114  == 4.5 Configure LG01 settings ==
115 115  
116 -Tips:Please confirm that your LG01 version is 4.3.3.
117 117  
150 +Tips:  Please confirm that your LG01 version is 4.3.3.
151 +
152 +
118 118  [[image:image-20220531140248-11.png]]
119 119  
120 120  **Overview**
... ... @@ -126,6 +126,7 @@
126 126  **Senosor->IOT Server**
127 127  
128 128  
164 +
129 129  [[image:image-20220531140458-15.png]]
130 130  
131 131  **MQTT->Configure MQTT Server**
... ... @@ -146,29 +146,44 @@
146 146  
147 147  [[image:image-20220531140651-18.png]]
148 148  
185 +
149 149  Configure network access.**Network->Internet Access**
150 150  
151 151  
189 +
152 152  == 4.6 Try MQTT API call with LG01 Linux command ==
153 153  
192 +
154 154  === 4.6.1 Input the command at the console ===
155 155  
195 +
156 156  1. [[image:image-20220531140811-19.png]](((
197 +
198 +
157 157  Open this Application.
158 158  
201 +
159 159  
160 160  )))
161 161  1. [[image:image-20220531140842-20.png]](((
205 +
206 +
162 162  Input passward(dragino).After into the console.
163 163  
209 +
164 164  
165 165  )))
166 166  1. [[image:image-20220531140915-21.png]](((
213 +
214 +
167 167  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
168 168  
217 +
169 169  
170 170  )))
171 171  1. [[image:image-20220531140955-22.png]](((
221 +
222 +
172 172  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.
173 173  
174 174  
... ... @@ -175,7 +175,11 @@
175 175  
176 176  )))
177 177  1. [[image:image-20220531141026-23.png]](((
229 +
230 +
178 178  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 +
179 179  )))
180 180  
181 181  * This command:
... ... @@ -195,9 +195,13 @@
195 195  )))
196 196  
197 197  
253 +
198 198  === 4.6.2 Input the command at the console(LG01 new version:4.3.4) ===
199 199  
256 +
200 200  1. [[image:image-20220531141150-24.png]](((
258 +
259 +
201 201  Open this Application.
202 202  
203 203  
... ... @@ -206,6 +206,7 @@
206 206  1. (((
207 207  [[image:image-20220531141400-27.png]]
208 208  
268 +
209 209  Check the settings.
210 210  
211 211  
... ... @@ -214,6 +214,7 @@
214 214  1. (((
215 215  [[image:image-20220531141601-30.png]]
216 216  
277 +
217 217  input this command.
218 218  
219 219  
... ... @@ -220,6 +220,8 @@
220 220  
221 221  )))
222 222  1. [[image:image-20220531141515-29.png]](((
284 +
285 +
223 223  Check the result.
224 224  
225 225  
... ... @@ -228,6 +228,7 @@
228 228  
229 229  == 4.7 Updata data to Server(Through MQTT) ==
230 230  
294 +
231 231  * This version of Sketch implements these features:
232 232  
233 233  1. Read the LG01 configuration information from Linux.
... ... @@ -235,7 +235,11 @@
235 235  1. Send reply after then receive LoRa node data.
236 236  1. Sketch will write active content to /tmp/iot/status periodically (every 5 minutes).(Watchdog feature)
237 237  
238 -1. [[image:image-20220531141656-31.png]](((
302 +
303 +
304 +1. [[image:image-20220531143822-49.png]](((
305 +
306 +
239 239  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.
240 240  
241 241  
... ... @@ -242,12 +242,16 @@
242 242  
243 243  )))
244 244  1. [[image:image-20220531141800-32.png]](((
313 +
314 +
245 245  Open Serial monitor.
246 246  
247 247  
248 248  
249 249  )))
250 -1. [[image:image-20220531141842-33.png]](((
320 +1. [[image:image-20220531143748-48.png]](((
321 +
322 +
251 251  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.
252 252  
253 253  
... ... @@ -254,6 +254,8 @@
254 254  
255 255  )))
256 256  1. [[image:image-20220531141927-34.png]](((
329 +
330 +
257 257  Open Serial monitor.
258 258  
259 259  
... ... @@ -261,13 +261,13 @@
261 261  )))
262 262  1. Go to IoT Server to check the result.
263 263  1. (((
264 -[[image:image-20220531142023-35.png]]
338 +[[image:image-20220531143707-47.png]]
265 265  
266 266  
267 267  
268 268  )))
269 269  1. (((
270 -[[image:image-20220531142155-36.png]]
344 +[[image:image-20220531143632-46.png]]
271 271  
272 272  
273 273  
... ... @@ -275,8 +275,10 @@
275 275  
276 276  = 5. FAQ =
277 277  
352 +
278 278  == 5.1 Configure to support general mqtt server ==
279 279  
355 +
280 280  First, try to run **mosquitto_pub** in Linux console to send a data to MQTT server.
281 281  
282 282  For example: for ThingSpeak, a MQTT publish command is:
... ... @@ -291,6 +291,8 @@
291 291  1. LG01 web console -> Sensor -> MQTT
292 292  1. Choose general Server
293 293  1. [[image:image-20220531142342-37.png]](((
370 +
371 +
294 294  Refer to your server to fill in.
295 295  
296 296  
... ... @@ -297,6 +297,8 @@
297 297  
298 298  )))
299 299  1. [[image:image-20220531142447-38.png]](((
378 +
379 +
300 300  Ex:ThingSpeak Server
301 301  
302 302  
... ... @@ -320,13 +320,17 @@
320 320  
321 321  [[image:image-20220531142525-39.png]]
322 322  
403 +
323 323  MQTT Logread example
324 324  
325 325  
407 +
326 326  == 5.2 What is Watchdog feature? ==
327 327  
410 +
328 328  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.
329 329  
413 +
330 330  * [[image:image-20220531142558-40.png]](((
331 331  Enable Sensor->Micro-Controller settings
332 332  
... ... @@ -334,6 +334,8 @@
334 334  
335 335  )))
336 336  * [[image:image-20220531142629-41.png]](((
421 +
422 +
337 337  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.
338 338  
339 339  
... ... @@ -340,6 +340,8 @@
340 340  
341 341  )))
342 342  * [[image:image-20220531142659-42.png]](((
429 +
430 +
343 343  Each time the function loops, it uses the watchdog function once.
344 344  
345 345  
... ... @@ -346,6 +346,8 @@
346 346  
347 347  )))
348 348  * [[image:image-20220531142720-43.png]](((
437 +
438 +
349 349  Open SSH and check watchdog result.If the result change constantly,the feature enable successfully.
350 350  
351 351  
... ... @@ -352,6 +352,8 @@
352 352  
353 353  )))
354 354  * [[image:image-20220531142748-44.png]](((
445 +
446 +
355 355  If the time doesnt's change,you can refer it to calculate for checking status.
356 356  )))
357 357  
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