Version 61.1 by David Huang on 2022/06/21 10:26
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5
6 [[image:image-20220530000243-1.png||height="332" width="531"]]
7
8
9 = Introduction =
10
11 == What is GroPoint Air ==
12
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
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**(%%).
16
17 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.
18
19 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.
20
21 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.
22
23 [[image:image-20220530002019-2.png||height="295" width="655"]]
24
25
26 == Features ==
27
28
29 * LoRaWAN 1.0.3 Class A
30 * Ultra-low power consumption
31 * Supports GroPoint Profile
32 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
33 * AT Commands to change parameters
34 * Uplink on periodically
35 * Downlink to change configure
36 * IP66 Waterproof Enclosure
37 * 8500mAh Battery for long term use
38
39 == Probe Specification ==
40
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
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
45
46 == Applications ==
47
48 * Smart Agriculture
49
50 == Pin Mapping ==
51
52 Inner PCB Pin mapping for reference:
53
54 [[image:image-20220530002453-3.png||height="262" width="493"]]
55
56
57 = Connect LoRaWAN Network =
58
59
60 == LED Indicator ==
61
62 The GroPoint Air has an internal LED which can show the status of different states.
63
64 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
65 * Blink once when device transmits a packet.
66
67 == Firmware and Changelog ==
68
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
71 Change Log:
72
73
74 = How to use? =
75
76 == Connect to GroPoint Profile ==
77
78 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:
79
80 * Support RS485 Interface
81 * with M12 5pin connector.
82
83 Such model in GroPoint Profile is: **2625-N-T-x-M-M **(Where x is different depending on how many levels it detects).
84
85
86 == Connect to LoRaWAN Network? ==
87
88 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
89
90
91 == Example to use for LoRaWAN network ==
92
93 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.
94
95 * 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>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/#H2.3UplinkPayload]] for detail.
96
97 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:
98
99 **Step 1**: Create a device in TTN V3 with the OTAA keys from GroPoint Air.
100
101 Each GroPoint Air is shipped with a sticker with the default device EUI as below:
102
103
104 [[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"]]
105
106 Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
107
108 Add APP EUI in the application.
109
110 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-1.png?rev=1.1||alt="image-20220519151704-1.png"]]
111
112 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-2.png?width=717&height=322&rev=1.1||alt="image-20220519151704-2.png" height="322" width="717"]]
113
114 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-3.png?rev=1.1||alt="image-20220519151704-3.png"]]
115
116 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-4.png?rev=1.1||alt="image-20220519151704-4.png"]]
117
118 Add APP KEY and DEV EUI
119
120 **Step 2**: Power on GroPoint Air
121
122 [[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" height="430" width="725"]]
123
124 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.
125
126 [[image:image-20220611174943-1.png||height="139" width="1008"]]
127
128
129 === Decoder in TTN V3 ===
130
131 [[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"]]
132
133 Please check the decoder [gropoint_Decoder_V1.0.0.js] from this link:
134
135 [[https:~~/~~/www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0>>https://www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0]]
136
137
138 == Uplink Payload Analyze ==
139
140 Uplink payloads have two types:
141
142 * (((
143 Report temperature and humidity status normally: Use FPORT=2
144 )))
145 * (((
146 Other control commands: Use other FPORT fields.
147 )))
148
149 The application server should parse the correct value based on FPORT settings.
150
151
152 == temperature and humidity Value, Uplink FPORT~=2 ==
153
154
155 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
156
157 periodically send this uplink every 20 minutes, this interval can be changed.
158
159 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
160
161 [[image:image-20220621093414-1.png||height="932" width="816"]]
162
163 GroPoint Air's sensors come in six models:GPLP-2，GPLP-3，GPLP-4，GPLP-5，GPLP-6，GPLP-8.
164
165 The amount of temperature and humidity is different for each model, so the payload of each model is different.
166
167 Take GPLP-3 as an example：
168
169 Uplink Payload totals 21 bytes.
170
171 [[image:image-20220621100751-2.png||height="124" width="774"]]
172
173 [[image:image-20220611174943-1.png||height="139" width="1008"]]
174
175
176 == Show data on Datacake ==
177
178 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:
179
180 **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]]
181
182 **Step 2**: Configure SW3L in Datacake  ​​​​
183
184 [[image:image-20220613171007-1.png||height="567" width="542"]]
185
186 [[image:image-20220613171015-2.png||height="600" width="586"]]
187
188 [[image:image-20220613171029-3.png||height="507" width="513"]]
189
190 [[image:image-20220613171038-4.png||height="469" width="786"]]
191
192 [[image:image-20220613171105-5.png||height="533" width="949"]]
193
194 [[image:image-20220613171117-6.png||height="501" width="925"]]
195
196 [[image:image-20220613171124-7.png||height="466" width="877"]]
197
198
199
200 = Configure GroPoint Air via AT Command or LoRaWAN Downlink =
201
202 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
203
204 * 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]].
205 * LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
206
207 There are two kinds of commands to configure GroPoint Air, they are:
208
209 * (((
210 **~ General Commands**.
211 )))
212
213 These commands are to configure:
214
215 * General system settings like: uplink interval.
216 * LoRaWAN protocol & radio-related command.
217
218 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/]]
219
220
221 * (((
222 **~ Commands special design for GroPoint Air**
223 )))
224
225 These commands only valid for GroPoint Air, as below:
226
227 == 3.1 Set Transmit Interval Time ==
228
229 Feature: Change LoRaWAN End Node Transmit Interval.
230
231 **AT Command: AT+TDC**
232
233 [[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-20220607171554-8.png?rev=1.1||alt="image-20220607171554-8.png"]]
234
235 **Downlink Command: 0x01**
236
237 Format: Command Code (0x01) followed by 3 bytes time value.
238
239 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
240
241 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
242 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
243
244 == 3.2 Set Interrupt Mode ==
245
246 Feature, Set Interrupt mode for GPIO_EXIT.
247
248 **AT Command: AT+INTMOD**
249
250 [[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-20220607171716-9.png?rev=1.1||alt="image-20220607171716-9.png"]]
251
252 **Downlink Command: 0x06**
253
254 Format: Command Code (0x06) followed by 3 bytes.
255
256 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
257
258 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
259 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
260
261 == (% id="cke_bm_55968S" style="display:none" %) (%%)3.3 Set the sensor delay time ==
262
263 Feature: Change the sensor delay time.
264
265 The default delay is 1000ms.
266
267 **AT Command: AT+SDELAY**
268
269 [[image:image-20220613175511-8.png]]
270
271 **Downlink Command: 0xA1**
272
273 Format: Command Code (0xA1) followed by 3 bytes time value.
274
275 If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
276
277 * Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms
278 * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms
279
280 == 3.4 Get Firmware Version Info ==
281
282 Feature: use downlink to get firmware version.
283
284 **Downlink Command: 0x26**
285
286 [[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-20220607171917-10.png?rev=1.1||alt="image-20220607171917-10.png"]]
287
288 * Reply to the confirmation package: 26 01
289 * Reply to non-confirmed packet: 26 00
290
291 Device will send an uplink after got this downlink command. With below payload:
292
293 Configures info payload:
294
295 |=(((
296 **Size(bytes)**
297 )))|=**1**|=**1**|=**1**|=**2**|=**1**|=4|=**1**
298 |**Value**|Software Type|(((
299 Frequency
300
301 Band
302 )))|Sub-band|(((
303 Firmware
304
305 Version
306 )))|Sensor Type|Reserve|(((
307 [[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]]
308 Always 0x02
309 )))
310
311 **Software Type**: Always 0x03 for LLMS01
312
313 **Frequency Band**:
314
315 *0x01: EU868
316
317 *0x02: US915
318
319 *0x03: IN865
320
321 *0x04: AU915
322
323 *0x05: KZ865
324
325 *0x06: RU864
326
327 *0x07: AS923
328
329 *0x08: AS923-1
330
331 *0x09: AS923-2
332
333 *0x0A: AS923-3
334
335 *0x0B: AS923-4
336
337 **Sub-Band**: value 0x00 ~~ 0x08
338
339 **Firmware Version**: 0x0100, Means: v1.0.0 version
340
341 **Sensor Type**:
342
343 0x01: LSE01
344
345 0x02: LDDS75
346
347 0x03: LDDS20
348
349 0x04: LLMS01
350
351 0x05: LSPH01
352
353 0x06: LSNPK01
354
355 0x07: LDDS45
356
357 0x08: LSLP01
358
359 = Use AT Command =
360
361 == Access AT Commands ==
362
363 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.
364
365 [[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654593668970-604.png||height="297" width="474"]]
366
367 **Connection:**
368
369 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
370
371 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
372
373 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
374
375
376 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:
377
378 [[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654653659449-932.png||height="471" width="674"]]
379
380 Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLLMS01viaATCommandorLoRaWANDownlink"]].
381
382
383 = Battery & How to replace =
384
385 == Battery Type ==
386
387 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.
388
389 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
390
391
392 [[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" height="408" width="574"]]
393
394 Minimum Working Voltage for the GroPoint Air:
395
396 GroPoint Air:  2.45v ~~ 3.6v
397
398
399 == Power Consumption Analyze ==
400
401 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.
402
403 Instruction to use as below:
404
405
406 **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/]]
407
408
409 **Step 2**: Open it and choose
410
411 * (((
412 Product Model
413 )))
414 * (((
415 Uplink Interval
416 )))
417 * (((
418 Working Mode
419 )))
420
421 And the Life expectation in different cases will be shown on the right.
422
423 [[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"]]
424
425 The battery-related documents as below:
426
427 * (((
428 [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
429 )))
430 * (((
431 [[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
432 )))
433 * (((
434 [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
435 )))
436
437 [[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"]]
438
439
440 === ​Battery Note ===
441
442 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.
443
444
445 === Replace the battery ===
446
447 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.
448
449 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)
450
451
452
453
454 = FAQ =
455
456 == How to change the LoRa Frequency Bands/Region ==
457
458 You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]].
459 When downloading the images, choose the required image file for download. ​
460
461
462 = Trouble Shooting =
463
464 == AT Commands input doesn’t work ==
465
466 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.
467
468
469
470 = Order Info =
471
472 Part Number: **GROPOINT AIR-M-XX**
473
474 **XX**: The default frequency band
475
476 * **AS923**: LoRaWAN AS923 band
477 * **AU915**: LoRaWAN AU915 band
478 * **EU433**: LoRaWAN EU433 band
479 * **EU868**: LoRaWAN EU868 band
480 * **KR920**: LoRaWAN KR920 band
481 * **US915**: LoRaWAN US915 band
482 * **IN865**: LoRaWAN IN865 band
483 * **CN470**: LoRaWAN CN470 band
484
485 = ​Packing Info =
486
487 **Package Includes:  **
488
489 * GroPoint Air-M x 1
490
491 **Dimension and weight:**
492
493 * Device Size: cm
494 * Device Weight: g
495 * Package Size / pcs : cm
496 * Weight / pcs : g

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0