<
From version < 56.2 >
edited by Edwin Chen
on 2022/06/19 08:17
To version < 64.4 >
edited by Xiaoling
on 2022/06/25 09:41
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -3,13 +3,26 @@
3 3  {{/box}}
4 4  
5 5  
6 +(% style="text-align:center" %)
6 6  [[image:image-20220530000243-1.png||height="332" width="531"]]
7 7  
8 8  
9 -= Introduction =
10 +Table of Contents:
10 10  
11 -== What is GroPoint Air ==
12 +{{toc/}}
12 12  
14 +
15 +
16 +
17 +
18 +
19 +
20 +
21 += 1.  Introduction =
22 +
23 +== 1.1  What is GroPoint Air ==
24 +
25 +
13 13  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.
14 14  
15 15  (% 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**(%%).
... ... @@ -23,7 +23,7 @@
23 23  [[image:image-20220530002019-2.png||height="295" width="655"]]
24 24  
25 25  
26 -== Features ==
39 +== 1.2  Features ==
27 27  
28 28  
29 29  * LoRaWAN 1.0.3 Class A
... ... @@ -36,28 +36,37 @@
36 36  * IP66 Waterproof Enclosure
37 37  * 8500mAh Battery for long term use
38 38  
39 -== Probe Specification ==
40 40  
53 +
54 +
55 +
56 +
57 +== 1.3  Probe Specification ==
58 +
41 41  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.
42 42  
43 43  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]]
44 44  
45 45  
46 -== Applications ==
64 +== 1.4  Applications ==
47 47  
48 48  * Smart Agriculture
49 49  
50 -== Pin Mapping ==
51 51  
69 +
70 +
71 +
72 +== 1.5  Pin Mapping ==
73 +
52 52  Inner PCB Pin mapping for reference:
53 53  
54 54  [[image:image-20220530002453-3.png||height="262" width="493"]]
55 55  
56 56  
57 -= Connect LoRaWAN Network =
79 += 2.  Connect LoRaWAN Network =
58 58  
59 59  
60 -== LED Indicator ==
82 +== 2.1  LED Indicator ==
61 61  
62 62  The GroPoint Air has an internal LED which can show the status of different states.
63 63  
... ... @@ -64,21 +64,36 @@
64 64  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
65 65  * Blink once when device transmits a packet.
66 66  
67 -== Firmware and Changelog ==
68 68  
90 +
91 +
92 +
93 +
94 +== 2.2  Firmware and Changelog ==
95 +
69 69  Firmware Download Location: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/GroPoint_Air/firmware/>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/GroPoint_Air/firmware/]]
70 70  
71 71  Change Log:
72 72  
73 73  
74 -= Operation Mode =
101 += 3.  How to use? =
75 75  
76 -== How it works? ==
103 +== 3.1  Connect to GroPoint Profile ==
77 77  
105 +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:
106 +
107 +* Support RS485 Interface
108 +* with M12 5pin connector.
109 +
110 +Such model in GroPoint Profile is: **2625-N-T-x-M-M **(Where x is different depending on how many levels it detects).
111 +
112 +
113 +== 3.2  Connect to LoRaWAN Network? ==
114 +
78 78  Each GroPoint Air is shipped with a worldwide unique set of OTAA keys. To use GroPoint Air in a LoRaWAN network, user needs to input the OTAA keys in the LoRaWAN network server. So GroPoint Air can join the LoRaWAN network and start to transmit sensor data
79 79  
80 80  
81 -== Example to use for LoRaWAN network ==
118 +== 3.3  Example to use for LoRaWAN network ==
82 82  
83 83  This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.
84 84  
... ... @@ -116,7 +116,7 @@
116 116  [[image:image-20220611174943-1.png||height="139" width="1008"]]
117 117  
118 118  
119 -=== Decoder in TTN V3 ===
156 +=== **Decoder in TTN V3** ===
120 120  
121 121  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652927365661-475.png?width=723&height=359&rev=1.1||alt="1652927365661-475.png" height="359" width="723"]]
122 122  
... ... @@ -125,13 +125,53 @@
125 125  [[https:~~/~~/www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0>>https://www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0]]
126 126  
127 127  
128 -== Uplink Payload Analyze ==
165 +== 3.4  Uplink Payload Analyze ==
129 129  
167 +Uplink payloads have two types:
130 130  
169 +* (((
170 +Report temperature and humidity status normally: Use FPORT=2
171 +)))
172 +* (((
173 +Other control commands: Use other FPORT fields.
174 +)))
131 131  
176 +The application server should parse the correct value based on FPORT settings.
132 132  
133 -== Show data on Datacake ==
134 134  
179 +== 3.5  temperature and humidity Value, Uplink FPORT~=2 ==
180 +
181 +
182 +GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
183 +
184 +periodically send this uplink every 20 minutes, this interval can be changed.
185 +
186 +The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
187 +
188 +[[image:image-20220621093414-1.png||height="932" width="816"]]
189 +
190 +GroPoint Air's sensors come in six models:GPLP-2,GPLP-3,GPLP-4,GPLP-5,GPLP-6,GPLP-8.
191 +
192 +The amount of temperature and humidity is different for each model, so the payload of each model is different.
193 +
194 +Take GPLP-3 as an example:
195 +
196 +Uplink Payload totals 21 bytes.
197 +
198 +[[image:image-20220621100751-2.png||height="124" width="774"]]
199 +
200 +[[image:image-20220611174943-1.png||height="139" width="1008"]]
201 +
202 +
203 +For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1.
204 +
205 +For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
206 +
207 +For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
208 +
209 +
210 +== 3.6  Show data on Datacake ==
211 +
135 135  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:
136 136  
137 137  **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]]
... ... @@ -154,7 +154,7 @@
154 154  
155 155  
156 156  
157 -= Configure GroPoint Air via AT Command or LoRaWAN Downlink =
234 += 4.  Configure GroPoint Air via AT Command or LoRaWAN Downlink =
158 158  
159 159  Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
160 160  
... ... @@ -181,8 +181,10 @@
181 181  
182 182  These commands only valid for GroPoint Air, as below:
183 183  
184 -== 3.1 Set Transmit Interval Time ==
185 185  
262 +
263 +== 4.1  Set Transmit Interval Time ==
264 +
186 186  Feature: Change LoRaWAN End Node Transmit Interval.
187 187  
188 188  **AT Command: AT+TDC**
... ... @@ -198,8 +198,13 @@
198 198  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
199 199  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
200 200  
201 -== 3.2 Set Interrupt Mode ==
202 202  
281 +
282 +
283 +
284 +
285 +== 4.2  Set Interrupt Mode ==
286 +
203 203  Feature, Set Interrupt mode for GPIO_EXIT.
204 204  
205 205  **AT Command: AT+INTMOD**
... ... @@ -215,10 +215,17 @@
215 215  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
216 216  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
217 217  
218 -== (% id="cke_bm_55968S" style="display:none" %) (%%)3.3 Set the sensor delay time ==
219 219  
303 +
304 +
305 +
306 +
307 +== (% id="cke_bm_55968S" style="display:none" %) (%%)4.3  Set the sensor delay time ==
308 +
220 220  Feature: Change the sensor delay time.
221 221  
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.
312 +
222 222  The default delay is 1000ms.
223 223  
224 224  **AT Command: AT+SDELAY**
... ... @@ -234,8 +234,20 @@
234 234  * Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms
235 235  * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms
236 236  
237 -== 3.4 Get Firmware Version Info ==
238 238  
329 +
330 +
331 +
332 +
333 +== 4.4  Query sensor model function ==
334 +
335 +Feature: Using this function will re-update the model.
336 +
337 +**Downlink Command: 0xFA00**
338 +
339 +
340 +== 4.5  Get Firmware Version Info ==
341 +
239 239  Feature: use downlink to get firmware version.
240 240  
241 241  **Downlink Command: 0x26**
... ... @@ -245,22 +245,25 @@
245 245  * Reply to the confirmation package: 26 01
246 246  * Reply to non-confirmed packet: 26 00
247 247  
351 +
352 +
248 248  Device will send an uplink after got this downlink command. With below payload:
249 249  
250 250  Configures info payload:
251 251  
252 -|=(((
357 +(% border="1" cellspacing="8" style="background-color:#ffffcc; color:green; width:510px" %)
358 +|=(% style="width: 96px;" %)(((
253 253  **Size(bytes)**
254 -)))|=**1**|=**1**|=**1**|=**2**|=**1**|=4|=**1**
255 -|**Value**|Software Type|(((
360 +)))|=(% style="width: 119px;" %)**1**|=(% style="width: 88px;" %)**1**|=(% style="width: 88px;" %)**1**|=(% style="width: 82px;" %)**2**|=(% style="width: 108px;" %)**1**|=(% style="width: 76px;" %)4|=(% style="width: 102px;" %)**1**
361 +|(% style="width:96px" %)**Value**|(% style="width:119px" %)Software Type|(% style="width:88px" %)(((
256 256  Frequency
257 257  
258 258  Band
259 -)))|Sub-band|(((
365 +)))|(% style="width:88px" %)Sub-band|(% style="width:82px" %)(((
260 260  Firmware
261 261  
262 262  Version
263 -)))|Sensor Type|Reserve|(((
369 +)))|(% style="width:108px" %)Sensor Type|(% style="width:76px" %)Reserve|(% style="width:102px" %)(((
264 264  [[Message Type>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/#H2.3.6MessageType]]
265 265  Always 0x02
266 266  )))
... ... @@ -313,10 +313,11 @@
313 313  
314 314  0x08: LSLP01
315 315  
316 -= Use AT Command =
317 317  
318 -== Access AT Commands ==
423 += 5.  Use AT Command =
319 319  
425 +== 5.1  Access AT Commands ==
426 +
320 320  GroPoint Air supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to GroPoint Air for using AT command, as below.
321 321  
322 322  [[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654593668970-604.png||height="297" width="474"]]
... ... @@ -337,9 +337,9 @@
337 337  Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLLMS01viaATCommandorLoRaWANDownlink"]].
338 338  
339 339  
340 -= Battery & How to replace =
447 += 6.  Battery & How to replace =
341 341  
342 -== Battery Type ==
449 +== 6.1  Battery Type ==
343 343  
344 344  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.
345 345  
... ... @@ -353,7 +353,7 @@
353 353  GroPoint Air:  2.45v ~~ 3.6v
354 354  
355 355  
356 -== Power Consumption Analyze ==
463 +== 6.2  Power Consumption Analyze ==
357 357  
358 358  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.
359 359  
... ... @@ -394,38 +394,45 @@
394 394  [[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/WebHome/image-20220607172042-11.png?rev=1.1||alt="image-20220607172042-11.png"]]
395 395  
396 396  
397 -=== ​Battery Note ===
504 +=== ​6.2.1  Battery Note ===
398 398  
399 399  The Li-SICO battery is designed for small current / long period applications. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period to transmit LoRa, then the battery life may be decreased.
400 400  
401 401  
402 -=== Replace the battery ===
509 +=== 6.2.2  Replace the battery ===
403 403  
511 +(((
404 404  You can change the battery in GroPoint Air. The type of battery is not limited as long as the output is between 3v to 3.6v.
513 +)))
405 405  
406 -The default battery pack of GroPoint Air includes a ER26500 plus supercapacitor. If users can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most cases. The SPC can enlarge the battery life for high-frequency use (update period below 5 minutes)
515 +(((
516 +The default battery pack of GroPoint Air includes a ER26500 plus supercapacitor. If users can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most cases. The SPC can enlarge the battery life for high-frequency use (update period below 5 minutes).
517 +)))
407 407  
408 408  
409 409  
521 += 7.  FAQ =
410 410  
411 -= FAQ =
523 +== 7.1  How to change the LoRa Frequency Bands/Region ==
412 412  
413 -== How to change the LoRa Frequency Bands/Region ==
414 -
415 415  You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]].
416 416  When downloading the images, choose the required image file for download. ​
417 417  
418 418  
419 -= Trouble Shooting =
529 += 8.  Trouble Shooting =
420 420  
421 -== AT Commands input doesn’t work ==
531 +== 8.1  AT Commands input doesn’t work ==
422 422  
423 423  In case if user can see the console output but can’t type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn’t send (% style="color:green" %)**ENTER**(%%) while pressing the send key, user need to add ENTER in their string.
424 424  
425 425  
536 +== 8.2  Why i see the payload is 7FFF? ==
426 426  
427 -= Order Info =
538 +The device will judge the length of the data received by the serial port. If the length of the received data is 0, it means that there is a problem with the sensor communication or the sensor is not connected properly, it is invalid data, and the uploaded data is 7FFF.
428 428  
540 +
541 += 9.  Order Info =
542 +
429 429  Part Number: **GROPOINT AIR-M-XX**
430 430  
431 431  **XX**: The default frequency band
... ... @@ -439,8 +439,16 @@
439 439  * **IN865**: LoRaWAN IN865 band
440 440  * **CN470**: LoRaWAN CN470 band
441 441  
442 -= ​Packing Info =
556 +(% class="wikigeneratedid" id="H200BPackingInfo" %)
557 +​
443 443  
559 +
560 +
561 +
562 +
563 +(% class="wikigeneratedid" %)
564 += 10.  Packing Info =
565 +
444 444  **Package Includes:  **
445 445  
446 446  * GroPoint Air-M x 1
image-20220621093414-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +158.4 KB
Content
image-20220621100751-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +6.7 KB
Content
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0