Skip to Content
Version 69.10 by Xiaoling on 2023/05/16 11:23
Show last authors
1
2
3 (% aria-label="image-20220530000243-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)
4 (((
5 (% data-widget="image" style="text-align:center" %)
6 [[image:image-20220530000243-1.png||height="332" width="531"]](% title="Click and drag to resize" %)​
7
8 (% 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==||height="15" role="presentation" title="Click and drag to move" width="15"]]
9 )))
10
11
12
13
14
15
16
17
18 **Table of Contents：**
19
20 (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
21 (((
22
23 )))
24
25 {{toc/}}
26
27
28
29
30
31
32
33 = 1.  Introduction =
34
35 == 1.1  What is GroPoint Air ==
36
37
38 (((
39 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.
40 )))
41
42 (((
43 (% 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**(%%).
44 )))
45
46 (((
47 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.
48 )))
49
50 (((
51 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.
52 )))
53
54 (((
55 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.
56 )))
57
58 (% 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" %)​
59
60
61 == 1.2  Features ==
62
63
64 * LoRaWAN 1.0.3 Class A
65 * Ultra-low power consumption
66 * Supports GroPoint Profile
67 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
68 * AT Commands to change parameters
69 * Uplink on periodically
70 * Downlink to change configure
71 * IP66 Waterproof Enclosure
72 * 8500mAh Battery for long term use
73
74
75
76 == 1.3  Probe Specification ==
77
78
79 (((
80 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.
81 )))
82
83 (((
84 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]]
85 )))
86
87
88 == 1.4  Applications ==
89
90
91 * Smart Agriculture
92
93
94
95 == 1.5  Pin Mapping ==
96
97
98 Inner PCB Pin mapping for reference:
99
100 (% aria-label="image-20220530002453-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220530002453-3.png||data-widget="image" height="262" width="493"]](% 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" %)​
101
102
103 = 2.  Connect LoRaWAN Network =
104
105 == 2.1  LED Indicator ==
106
107
108 The GroPoint Air has an internal LED which can show the status of different states.
109
110 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
111 * Blink once when device transmits a packet.
112
113
114
115 == 2.2  Firmware and Changelog ==
116
117
118 (((
119 Firmware Download Location: [[https:~~/~~/www.dropbox.com/sh/xjj8dh5zs1zre20/AAB5pGtSHItnTrpPLUpRNJAYa?dl=0>>https://www.dropbox.com/sh/xjj8dh5zs1zre20/AAB5pGtSHItnTrpPLUpRNJAYa?dl=0]]
120 )))
121
122 (((
123 Change Log:
124 )))
125
126 (((
127 v1.0:  Release.
128 )))
129
130
131 = 3.  How to use? =
132
133 == 3.1  Connect to GroPoint Profile ==
134
135
136 (((
137 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:
138 )))
139
140 * (((
141 Support RS485 Interface
142 )))
143 * (((
144 with M12 5pin connector.
145 )))
146
147 (((
148 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).
149 )))
150
151
152 == 3.2  Connect to LoRaWAN Network? ==
153
154
155 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
156
157
158 == 3.3  Example to use for LoRaWAN network ==
159
160
161 (((
162 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.
163 )))
164
165 * (((
166 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.
167 )))
168
169 (((
170 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:
171 )))
172
173 (((
174
175 )))
176
177 (((
178 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air.
179 )))
180
181 (((
182 Each GroPoint Air is shipped with a sticker with the default device EUI as below:
183 )))
184
185 [[image:image-20230426084611-1.png||height="262" width="564"]](% style="display:none" %)
186
187 (% title="Click and drag to resize" %)​
188
189 Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
190
191 **Add APP EUI in the application.**
192
193 (% aria-label="image-20220519151704-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-20220519151704-1.png?rev=1.1||alt="image-20220519151704-1.png" data-widget="image"]]
194
195 (% title="Click and drag to resize" %)​
196
197 (% aria-label="image-20220519151704-2.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-20220519151704-2.png?width=717&height=322&rev=1.1||alt="image-20220519151704-2.png" data-widget="image" height="322" width="717"]]
198
199 (% title="Click and drag to resize" %)​
200
201 (% aria-label="image-20220519151704-3.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-20220519151704-3.png?rev=1.1||alt="image-20220519151704-3.png" data-widget="image"]]
202
203 (% title="Click and drag to resize" %)​
204
205 (% aria-label="image-20220519151704-4.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-20220519151704-4.png?rev=1.1||alt="image-20220519151704-4.png" data-widget="image"]](% title="Click and drag to resize" %)​
206
207 **Add APP KEY and DEV EUI**
208
209
210 (% style="color:blue" %)**Step 2**(%%):  Power on GroPoint Air
211
212 (% 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"]]
213
214 (% title="Click and drag to resize" %)​
215
216 (((
217 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.
218 )))
219
220 (% 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" %)​
221
222
223 (% style="display:none" %) (%%)
224
225 === **Decoder in TTN V3** ===
226
227 (% aria-label="1652927365661-475.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/1652927365661-475.png?width=723&height=359&rev=1.1||alt="1652927365661-475.png" data-widget="image" height="359" width="723"]](% title="Click and drag to resize" %)​
228
229 Please check the decoder [gropoint_Decoder_V1.0.0.js] from this link:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
230
231
232 == 3.4  Uplink Payload Analyze ==
233
234
235 (((
236 Uplink payloads have two types:
237 )))
238
239 * (((
240 (((
241 Report temperature and humidity status normally: Use FPORT=2
242 )))
243 )))
244 * (((
245 (((
246 Other control commands: Use other FPORT fields.
247 )))
248 )))
249
250 (((
251 The application server should parse the correct value based on FPORT settings.
252 )))
253
254
255 == 3.5  temperature and humidity Value, Uplink FPORT~=2 ==
256
257
258 (((
259 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
260 )))
261
262 (((
263 periodically send this uplink every 20 minutes, this interval can be changed.
264 )))
265
266 (((
267 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
268 )))
269
270 (% 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" %)​
271
272 GroPoint Air's sensors come in six models: GPLP-2，GPLP-3，GPLP-4，GPLP-5，GPLP-6，GPLP-8.
273
274 The amount of temperature and humidity is different for each model, so the payload of each model is different.
275
276 Take GPLP-3 as an example：
277
278 Uplink Payload totals 21 bytes.
279
280 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
281 |(% style="width:50px" %)**Size(bytes)**|(% style="width:30px" %)**2**|(% style="width:30px" %)**1**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**|(% style="width:30px" %)**2**
282 |(% style="width:94px" %)**value**|(% style="width:38px" %)Bat|(% style="width:39px" %)sen|(% style="width:52px" %)Tem1|(% style="width:52px" %)Tem2|(% style="width:52px" %)Tem3|(% style="width:52px" %)Tem4|(% style="width:50px" %)Tem5|(% style="width:52px" %)Tem6|(% style="width:55px" %)Hum1|(% style="width:55px" %)Hum2|(% style="width:56px" %)Hum3
283
284 (% title="Click and drag to resize" %)​
285
286 (% 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" %)​
287
288
289 (((
290 For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1.
291 )))
292
293 (((
294 For AU915 frequency, when DR=2，Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
295 )))
296
297 (((
298 For AS923 frequency, when DR=2，Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
299 )))
300
301
302 == 3.6  Show data on Datacake ==
303
304
305 (((
306 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:
307 )))
308
309 (((
310 (% 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]]
311 )))
312
313 (((
314 (% style="color:blue" %)**Step 2**(%%):  Configure SW3L in Datacake  ​​​​
315 )))
316
317 (% 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"]]
318
319 (% title="Click and drag to resize" %)​
320
321 (% aria-label="image-20220613171015-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171015-2.png||data-widget="image" height="600" width="586"]](% 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" %)​
322
323 (% aria-label="image-20220613171029-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171029-3.png||data-widget="image" height="507" width="513"]](% 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" %)​
324
325 (% aria-label="image-20220613171038-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171038-4.png||data-widget="image" height="469" width="786"]]
326
327 (% title="Click and drag to resize" %)​
328
329 (% aria-label="image-20220613171105-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171105-5.png||data-widget="image" height="533" width="949"]]
330
331 (% title="Click and drag to resize" %)​
332
333 (% aria-label="image-20220613171117-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171117-6.png||data-widget="image" height="501" width="925"]]
334
335 (% title="Click and drag to resize" %)​
336
337 (% aria-label="image-20220613171124-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171124-7.png||data-widget="image" height="466" width="877"]](% title="Click and drag to resize" %)​
338
339
340 = 4.  Configure GroPoint Air via AT Command or LoRaWAN Downlink =
341
342
343 (((
344 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
345 )))
346
347 * (((
348 AT Command Connection: See [[FAQ>>||anchor="H7.A0FAQ"]].
349 )))
350 * (((
351 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
352 )))
353
354 (((
355 There are two kinds of commands to configure GroPoint Air, they are:
356 )))
357
358 * (((
359 (((
360 **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %).
361 )))
362 )))
363
364 (((
365 These commands are to configure:
366 )))
367
368 * (((
369 General system settings like: uplink interval.
370 )))
371 * (((
372 LoRaWAN protocol & radio-related command.
373 )))
374
375 (((
376 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/]]
377 )))
378
379
380
381 * (((
382 (((
383 **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)**
384 )))
385 )))
386
387 (((
388 These commands only valid for GroPoint Air, as below:
389 )))
390
391
392 == 4.1  Set Transmit Interval Time ==
393
394
395 Feature: Change LoRaWAN End Node Transmit Interval.
396
397
398 (% style="color:#037691" %)**AT Command: AT+TDC**
399
400 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
401 |=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
402 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
403 30000
404 OK
405 the interval is 30000ms = 30s
406 )))
407 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
408 OK
409 Set transmit interval to 60000ms = 60 seconds​
410 )))
411
412 (% style="color:#037691" %)**Downlink Command: 0x01**
413
414 Format: Command Code (0x01) followed by 3 bytes time value.
415
416 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
417
418 * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
419 * Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
420
421 == 4.2  Set Interrupt Mode ==
422
423
424 Feature, Set Interrupt mode for GPIO_EXIT.
425
426
427 (% style="color:#037691" %)**AT Command: AT+INTMOD**
428
429 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
430 |=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Response**
431 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
432 0
433 OK
434 the mode is 0 =No interruption
435 )))
436 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
437 Set Transmit Interval
438 ~1. (Disable Interrupt),
439 2. (Trigger by rising and falling edge)
440 3. (Trigger by falling edge)
441 4. (Trigger by rising edge)
442 )))|(% style="width:157px" %)OK
443
444 (% 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" %)​
445
446 (% style="color:#037691" %)**Downlink Command: 0x06**
447
448 Format: Command Code (0x06) followed by 3 bytes.
449
450 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
451
452 * Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
453 * Example 2: Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
454
455 == 4.3  Set the sensor delay time ==
456
457
458 (((
459 Feature: Change the sensor delay time.
460
461
462 )))
463
464 (((
465 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.
466 )))
467
468 (((
469 The default delay is 1000ms.
470 )))
471
472 (((
473 (% style="color:#037691" %)**AT Command: AT+SDELAY**
474
475
476 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
477 |=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
478 |(% style="width:156px" %)AT+SDELAY=?|(% style="width:137px" %)Show the sensor delay time|(((
479 1000
480 OK
481 the sensor delay time is 1000ms
482 )))
483 |(% style="width:156px" %)AT+SDELAY=2000|(% style="width:137px" %)Set the sensor delay time|(((
484 OK
485 Set the sensor delay time to 2000ms
486 )))
487 )))
488
489 (% 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" %)​
490
491 (% style="color:#037691" %)**Downlink Command: 0xA1**
492
493 Format: Command Code (0xA1) followed by 3 bytes time value.
494
495 If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
496
497 * Example 1: Downlink Payload: A10003E8  ~/~/ Set the sensor delay time = 1000ms
498 * Example 2: Downlink Payload: A10007D0  ~/~/ Set the sensor delay time = 2000ms
499
500 == 4.4  Query sensor model function ==
501
502
503 Feature: Using this function will re-update the model.
504
505
506 (% style="color:#037691" %)**Downlink Command: 0xFA00**
507
508
509 == 4.5  Get Firmware Version Info ==
510
511
512 Feature: use downlink to get firmware version.
513
514
515 (% style="color:#037691" %)**Downlink Command: 0x26**
516
517 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
518 |(% style="width:193px" %)**Downlink Control Type**|(% style="width:57px" %)**FPort**|(% style="width:91px" %)**Type Code**|(% style="width:149px" %)**Downlink payload size(bytes)**
519 |(% style="width:193px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:149px" %)2
520
521 * Reply to the confirmation package: 26 01
522 * Reply to non-confirmed packet: 26 00
523
524 Device will send an uplink after got this downlink command. With below payload:
525
526 Configures info payload:
527
528 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
529 |(% style="width:50px" %)**Size(bytes)**|(% style="width:70px" %)**1**|(% style="width:70px" %)**1**|(% style="width:50px" %)**1**|(% style="width:70px" %)**2**|(% style="width:60px" %)**1**|(% style="width:50px" %)**4**|(% style="width:100px" %)**1**
530 |(% style="width:93px" %)**Value**|(% style="width:114px" %)Software Type|(% style="width:139px" %)Frequency Band|(% style="width:149px" %)Sub-band|(% style="width:149px" %)Firmware Version|(% style="width:149px" %)Sensor Type|(% style="width:63px" %)Reserve|(% style="width:63px" %)Message Tpye Always 0x02
531
532
533 (% style="color:#037691" %)**Software Type**(%%): Always 0x03 for GroPoint Air
534
535
536 (% style="color:#037691" %)**Frequency Band**(%%):
537
538 *0x01: EU868
539
540 *0x02: US915
541
542 *0x03: IN865
543
544 *0x04: AU915
545
546 *0x05: KZ865
547
548 *0x06: RU864
549
550 *0x07: AS923
551
552 *0x08: AS923-1
553
554 *0x09: AS923-2
555
556 *0x0A: AS923-3
557
558 *0x0B: AS923-4
559
560
561 (% style="color:#037691" %)**Sub-Band**(%%):  value 0x00 ~~ 0x08
562
563
564 (% style="color:#037691" %)**Firmware Version**(%%):  0x0100, Means: v1.0.0 version
565
566
567 (% style="color:#037691" %)**Sensor Type**(%%):
568
569 0x01: LSE01
570
571 0x02: LDDS75
572
573 0x03: LDDS20
574
575 0x04: LLMS01
576
577 0x05: LSPH01
578
579 0x06: LSNPK01
580
581 0x07: LDDS45
582
583 0x08: LSLP01
584
585
586 = 5.  Use AT Command =
587
588 == 5.1  Access AT Commands ==
589
590
591 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.
592
593 (% aria-label="1654593668970-604.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@1654593668970-604.png||data-widget="image" height="297" width="474"]](% 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" %)​
594
595 **Connection:**
596
597 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
598
599 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
600
601 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
602
603
604 (((
605 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:
606 )))
607
608 (% 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" %)​
609
610 Valid AT Command please check [[Configure Device>>||anchor="H4.A0ConfigureGroPointAirviaATCommandorLoRaWANDownlink"]].
611
612
613 = 6. Battery & Power Consumption =
614
615
616 GroPoint Air uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
617
618 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
619
620
621 = 7.  FAQ =
622
623 == 7.1  How to change the LoRa Frequency Bands/Region ==
624
625
626 You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]].
627 When downloading the images, choose the required image file for download. ​
628
629
630 = 8.  Trouble Shooting =
631
632 == 8.1  AT Commands input doesn't work ==
633
634
635 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.
636
637
638 == 8.2  Why i see the payload is 7FFF? ==
639
640
641 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.
642
643
644 = 9.  Order Info =
645
646
647 Part Number: (% style="color:blue" %)**GROPOINT AIR-M-XX**
648
649 (% style="color:blue" %)**XX**(%%): The default frequency band
650
651 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
652 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
653 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
654 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
655 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
656 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
657 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
658 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
659
660 ​
661
662
663 = 10.  Packing Info =
664
665
666 (((
667 **Package Includes:  **
668 )))
669
670 * GroPoint Air-M x 1
671
672 (((
673 **Dimension and weight:**
674 )))
675
676 * Device Size: cm
677 * Device Weight: g
678 * Package Size / pcs : cm
679 * Weight / pcs : g