<
From version < 67.1 >
edited by Xiaoling
on 2022/06/25 10:36
To version < 67.21 >
edited by Xiaoling
on 2022/06/25 11:13
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -29,15 +29,25 @@
29 29  == 1.1  What is GroPoint Air ==
30 30  
31 31  
32 +(((
32 32  The Dragino GroPoint is a (% style="color:blue" %)**LoRaWAN Multi Soil Segment Converter**(%%) for IoT of Agriculture. It is designed to connect to [[GroPoint Profile Multi-depth Soil moisture and temperature profile Sensor>>url:https://www.gropoint.com/products/soil-sensors/gropoint-profile]] and get GroPoint Profile’s reading and send it to IoT server via LoRaWAN wireless network.
34 +)))
33 33  
36 +(((
34 34  (% style="color:blue" %)**GroPoint Profile is plug-and-play with GroPoint Air**(%%) to get soil moisture and send via wireless. GroPoint Profile is powered by GroPoint Air, (% style="color:blue" %)**no need external power source**(%%).
38 +)))
35 35  
40 +(((
36 36  The LoRa wireless technology used in GroPoint Air allows devices to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
42 +)))
37 37  
44 +(((
38 38  GroPoint Air is powered by (% style="color:blue" %)**an 8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use for up to 5 years.
46 +)))
39 39  
48 +(((
40 40  Each GroPoint Air is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to the local LoRaWAN server and it will auto-connect after power on.
50 +)))
41 41  
42 42  (% aria-label="image-20220530002019-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220530002019-2.png||data-widget="image" height="295" width="655"]](% title="Click and drag to resize" %)​
43 43  
... ... @@ -54,11 +54,19 @@
54 54  * IP66 Waterproof Enclosure
55 55  * 8500mAh Battery for long term use
56 56  
67 +
68 +
69 +
70 +
57 57  == 1.3  Probe Specification ==
58 58  
73 +(((
59 59  GroPoint Air includes an M12 5-pin connector, the pins definition matches GroPoint Profile M12 version probes. Users can connect this connector to GroPoint Profile directly.
75 +)))
60 60  
77 +(((
61 61  GroPoint Profile includes a series of multi-depth soil moisture and temperature sensors. The specification for GroPoint Profile can be found here: [[https:~~/~~/www.gropoint.com/products/soil-sensors/gropoint-profile>>https://www.gropoint.com/products/soil-sensors/gropoint-profile]]
79 +)))
62 62  
63 63  
64 64  == 1.4  Applications ==
... ... @@ -65,6 +65,10 @@
65 65  
66 66  * Smart Agriculture
67 67  
86 +
87 +
88 +
89 +
68 68  == 1.5  Pin Mapping ==
69 69  
70 70  Inner PCB Pin mapping for reference:
... ... @@ -81,6 +81,11 @@
81 81  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
82 82  * Blink once when device transmits a packet.
83 83  
106 +
107 +
108 +
109 +
110 +
84 84  == 2.2  Firmware and Changelog ==
85 85  
86 86  (((
... ... @@ -100,12 +100,20 @@
100 100  
101 101  == 3.1  Connect to GroPoint Profile ==
102 102  
130 +(((
103 103  GroPoint Air must be used with [[GroPoint Profile>>https://www.gropoint.com/products/soil-sensors/gropoint-profile]]. There are different interface model from GroPoint, users need to choose the one:
132 +)))
104 104  
105 -* Support RS485 Interface
106 -* with M12 5pin connector.
134 +* (((
135 +Support RS485 Interface
136 +)))
137 +* (((
138 +with M12 5pin connector.
139 +)))
107 107  
141 +(((
108 108  Such model in GroPoint Profile is: (% style="color:blue" %)**2625-N-T-x-M-M **(%%)(Where x is different depending on how many levels it detects).
143 +)))
109 109  
110 110  
111 111  == 3.2  Connect to LoRaWAN Network? ==
... ... @@ -115,16 +115,29 @@
115 115  
116 116  == 3.3  Example to use for LoRaWAN network ==
117 117  
153 +(((
118 118  This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.
155 +)))
119 119  
120 -* In this use case, the GroPoint Air measures soil moisture and temperature and sends the status to the LoRaWAN server.The GroPoint Air will uplink different types of messages to the LoRaWAN server. See [[Uplink payload>>||anchor="H3.4A0UplinkPayloadAnalyze"]] for detail.
157 +* (((
158 +In this use case, the GroPoint Air measures soil moisture and temperature and sends the status to the LoRaWAN server.The GroPoint Air will uplink different types of messages to the LoRaWAN server. See [[Uplink payload>>||anchor="H3.4A0UplinkPayloadAnalyze"]] for detail.
159 +)))
121 121  
161 +(((
122 122  Assume the DLOS8 is already set to connect to the [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the GroPoint Air device in TTN V3:
163 +)))
123 123  
165 +(((
166 +
167 +)))
124 124  
169 +(((
125 125  (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air.
171 +)))
126 126  
173 +(((
127 127  Each GroPoint Air is shipped with a sticker with the default device EUI as below:
175 +)))
128 128  
129 129  
130 130  (% aria-label="1652944593868-618.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652944593868-618.png?rev=1.1||alt="1652944593868-618.png" data-widget="image"]](% title="Click and drag to resize" %)​
... ... @@ -146,9 +146,13 @@
146 146  
147 147  (% style="color:blue" %)**Step 2**(%%):  Power on GroPoint Air
148 148  
149 -(% aria-label="image-20220519094347-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519094347-1.png?width=725&height=430&rev=1.1||alt="image-20220519094347-1.png" data-widget="image" height="430" width="725"]](% title="Click and drag to resize" %)​
197 +(% aria-label="image-20220519094347-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519094347-1.png?width=725&height=430&rev=1.1||alt="image-20220519094347-1.png" data-widget="image" height="430" width="725"]]
150 150  
199 +(% title="Click and drag to resize" %)​
200 +
201 +(((
151 151  Put the jumper to power on GroPoint Air and it will auto-join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and the user can see it in the panel.
203 +)))
152 152  
153 153  (% aria-label="image-20220611174943-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611174943-1.png||data-widget="image" height="139" width="1008"]](% title="Click and drag to resize" %)​
154 154  
... ... @@ -165,26 +165,40 @@
165 165  
166 166  == 3.4  Uplink Payload Analyze ==
167 167  
220 +(((
168 168  Uplink payloads have two types:
222 +)))
169 169  
170 170  * (((
225 +(((
171 171  Report temperature and humidity status normally: Use FPORT=2
172 172  )))
228 +)))
173 173  * (((
230 +(((
174 174  Other control commands: Use other FPORT fields.
175 175  )))
233 +)))
176 176  
235 +(((
177 177  The application server should parse the correct value based on FPORT settings.
237 +)))
178 178  
179 179  
180 180  == 3.5  temperature and humidity Value, Uplink FPORT~=2 ==
181 181  
182 182  
243 +(((
183 183  GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
245 +)))
184 184  
247 +(((
185 185  periodically send this uplink every 20 minutes, this interval can be changed.
249 +)))
186 186  
251 +(((
187 187  The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
253 +)))
188 188  
189 189  (% aria-label="image-20220621093414-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220621093414-1.png||data-widget="image" height="932" width="816"]](% title="Click and drag to resize" %)​
190 190  
... ... @@ -201,20 +201,32 @@
201 201  (% aria-label="image-20220611174943-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611174943-1.png||data-widget="image" height="139" width="1008"]](% title="Click and drag to resize" %)​
202 202  
203 203  
270 +(((
204 204  For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1.
272 +)))
205 205  
274 +(((
206 206  For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
276 +)))
207 207  
278 +(((
208 208  For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
280 +)))
209 209  
210 210  
211 211  == 3.6  Show data on Datacake ==
212 212  
285 +(((
213 213  Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
287 +)))
214 214  
289 +(((
215 215  (% style="color:blue" %)**Step 1**(%%):  Link TTNv3 to Datacake [[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]
291 +)))
216 216  
293 +(((
217 217  (% style="color:blue" %)**Step 2**(%%):  Configure SW3L in Datacake  ​​​​
295 +)))
218 218  
219 219  (% aria-label="image-20220613171007-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171007-1.png||data-widget="image" height="567" width="542"]](% title="Click and drag to resize" %)​
220 220  
... ... @@ -240,31 +240,53 @@
240 240  
241 241  = 4.  Configure GroPoint Air via AT Command or LoRaWAN Downlink =
242 242  
321 +(((
243 243  Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
323 +)))
244 244  
245 -* AT Command Connection: See [[FAQ>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/#H6.FAQ]].
246 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
325 +* (((
326 +AT Command Connection: See [[FAQ>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/#H6.FAQ]].
327 +)))
328 +* (((
329 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
330 +)))
247 247  
332 +(((
248 248  There are two kinds of commands to configure GroPoint Air, they are:
334 +)))
249 249  
250 250  * (((
337 +(((
251 251  **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %).
252 252  )))
340 +)))
253 253  
342 +(((
254 254  These commands are to configure:
344 +)))
255 255  
256 -* General system settings like: uplink interval.
257 -* LoRaWAN protocol & radio-related command.
346 +* (((
347 +General system settings like: uplink interval.
348 +)))
349 +* (((
350 +LoRaWAN protocol & radio-related command.
351 +)))
258 258  
353 +(((
259 259  They are the same for all Dragino Device that support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>url:http://8.211.40.43/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
355 +)))
260 260  
261 261  
262 262  
263 263  * (((
360 +(((
264 264  **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)**
265 265  )))
363 +)))
266 266  
365 +(((
267 267  These commands only valid for GroPoint Air, as below:
367 +)))
268 268  
269 269  
270 270  
... ... @@ -286,6 +286,10 @@
286 286  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
287 287  
288 288  
389 +
390 +
391 +
392 +
289 289  == 4.2  Set Interrupt Mode ==
290 290  
291 291  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -304,15 +304,27 @@
304 304  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
305 305  
306 306  
411 +
412 +
413 +
414 +
307 307  == 4.3  Set the sensor delay time ==
308 308  
417 +(((
309 309  Feature: Change the sensor delay time.
419 +)))
310 310  
421 +(((
311 311  There are six models of GroPoint Air, and each model returns a different number of temperature and humidity. The more bytes of the returned value, the longer the delay. The AT+SDELAY command can adjust the time that the sensor returns data to the node, and can adjust different delays according to different types of sensors.
423 +)))
312 312  
425 +(((
313 313  The default delay is 1000ms.
427 +)))
314 314  
429 +(((
315 315  (% style="color:#037691" %)**AT Command: AT+SDELAY**
431 +)))
316 316  
317 317  (% aria-label="image-20220613175511-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613175511-8.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
318 318  
... ... @@ -326,6 +326,10 @@
326 326  * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms
327 327  
328 328  
445 +
446 +
447 +
448 +
329 329  == 4.4  Query sensor model function ==
330 330  
331 331  Feature: Using this function will re-update the model.
... ... @@ -404,6 +404,7 @@
404 404  0x08: LSLP01
405 405  
406 406  
527 +
407 407  = 5.  Use AT Command =
408 408  
409 409  == 5.1  Access AT Commands ==
... ... @@ -421,7 +421,9 @@
421 421  (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
422 422  
423 423  
545 +(((
424 424  In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for GroPoint Air. GroPoint Air will output system info once power on as below:
547 +)))
425 425  
426 426  (% aria-label="1654653659449-932.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654653659449-932.png||data-widget="image" height="471" width="674"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
427 427  
... ... @@ -432,9 +432,13 @@
432 432  
433 433  == 6.1  Battery Type ==
434 434  
558 +(((
435 435  GroPoint Air is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. The battery is an un-rechargeable battery with a low discharge rate targeting more than 5 years use. This type of battery is commonly used in IoT targets for long-term running, such as water meters.
560 +)))
436 436  
562 +(((
437 437  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
564 +)))
438 438  
439 439  
440 440  (% aria-label="1654593587246-335.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/WebHome/1654593587246-335.png?rev=1.1||alt="1654593587246-335.png" data-widget="image" height="408" width="574"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
... ... @@ -446,27 +446,43 @@
446 446  
447 447  == 6.2  Power Consumption Analyze ==
448 448  
576 +(((
449 449  Dragino Battery-powered products are all runs in Low Power mode. We have an updated battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit intervals.
578 +)))
450 450  
580 +(((
451 451  Instruction to use as below:
582 +)))
452 452  
453 453  
585 +(((
454 454  (% style="color:blue" %)**Step 1**(%%):  Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
587 +)))
455 455  
456 456  
590 +(((
457 457  (% style="color:blue" %)**Step 2**(%%):  Open it and choose
592 +)))
458 458  
459 459  * (((
595 +(((
460 460  Product Model
461 461  )))
598 +)))
462 462  * (((
600 +(((
463 463  Uplink Interval
464 464  )))
603 +)))
465 465  * (((
605 +(((
466 466  Working Mode
467 467  )))
608 +)))
468 468  
610 +(((
469 469  And the Life expectation in different cases will be shown on the right.
612 +)))
470 470  
471 471  (% aria-label="1654593605679-189.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/WebHome/1654593605679-189.png?rev=1.1||alt="1654593605679-189.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
472 472  
... ... @@ -545,11 +545,15 @@
545 545  
546 546  = 10.  Packing Info =
547 547  
691 +(((
548 548  **Package Includes:  **
693 +)))
549 549  
550 550  * GroPoint Air-M x 1
551 551  
697 +(((
552 552  **Dimension and weight:**
699 +)))
553 553  
554 554  * Device Size: cm
555 555  * Device Weight: g
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0