Version 69.12 by Xiaoling on 2023/05/16 11:28

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:42px" %)**2**|(% style="width:42px" %)**1**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**2**|(% style="width:42px" %)**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
422
423 == 4.2  Set Interrupt Mode ==
424
425
426 Feature, Set Interrupt mode for GPIO_EXIT.
427
428 (% style="color:#037691" %)**AT Command: AT+INTMOD**
429
430 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
431 |=(% 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**
432 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
433 0
434 OK
435 the mode is 0 =No interruption
436 )))
437 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
438 Set Transmit Interval
439 ~1. (Disable Interrupt),
440 2. (Trigger by rising and falling edge)
441 3. (Trigger by falling edge)
442 4. (Trigger by rising edge)
443 )))|(% style="width:157px" %)OK
444
445 (% style="color:#037691" %)**Downlink Command: 0x06**
446
447 Format: Command Code (0x06) followed by 3 bytes.
448
449 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
450
451 * Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
452 * Example 2: Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
453
454
455
456 == 4.3  Set the sensor delay time ==
457
458
459 (((
460 Feature: Change the sensor delay time.
461
462
463 )))
464
465 (((
466 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.
467 )))
468
469 (((
470 The default delay is 1000ms.
471 )))
472
473 (((
474 (% style="color:#037691" %)**AT Command: AT+SDELAY**
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="color:#037691" %)**Downlink Command: 0xA1**
490
491 Format: Command Code (0xA1) followed by 3 bytes time value.
492
493 If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
494
495 * Example 1: Downlink Payload: A10003E8  ~/~/ Set the sensor delay time = 1000ms
496 * Example 2: Downlink Payload: A10007D0  ~/~/ Set the sensor delay time = 2000ms
497
498
499
500 == 4.4  Query sensor model function ==
501
502
503 Feature: Using this function will re-update the model.
504
505 (% style="color:#037691" %)**Downlink Command: 0xFA00**
506
507
508 == 4.5  Get Firmware Version Info ==
509
510
511 Feature: use downlink to get firmware version.
512
513 (% style="color:#037691" %)**Downlink Command: 0x26**
514
515 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
516 |(% style="width:193px" %)**Downlink Control Type**|(% style="width:57px" %)**FPort**|(% style="width:91px" %)**Type Code**|(% style="width:149px" %)**Downlink payload size(bytes)**
517 |(% style="width:193px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:149px" %)2
518
519 * Reply to the confirmation package: 26 01
520 * Reply to non-confirmed packet: 26 00
521
522 Device will send an uplink after got this downlink command. With below payload:
523
524 Configures info payload:
525
526 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
527 |(% 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**
528 |(% 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
529
530 (% style="color:#037691" %)**Software Type**(%%): Always 0x03 for GroPoint Air
531
532
533 (% style="color:#037691" %)**Frequency Band**(%%):
534
535 *0x01: EU868
536
537 *0x02: US915
538
539 *0x03: IN865
540
541 *0x04: AU915
542
543 *0x05: KZ865
544
545 *0x06: RU864
546
547 *0x07: AS923
548
549 *0x08: AS923-1
550
551 *0x09: AS923-2
552
553 *0x0A: AS923-3
554
555 *0x0B: AS923-4
556
557
558 (% style="color:#037691" %)**Sub-Band**(%%):  value 0x00 ~~ 0x08
559
560
561 (% style="color:#037691" %)**Firmware Version**(%%):  0x0100, Means: v1.0.0 version
562
563
564 (% style="color:#037691" %)**Sensor Type**(%%):
565
566 0x01: LSE01
567
568 0x02: LDDS75
569
570 0x03: LDDS20
571
572 0x04: LLMS01
573
574 0x05: LSPH01
575
576 0x06: LSNPK01
577
578 0x07: LDDS45
579
580 0x08: LSLP01
581
582
583 = 5.  Use AT Command =
584
585 == 5.1  Access AT Commands ==
586
587
588 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.
589
590 (% 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" %)​
591
592 **Connection:**
593
594 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
595
596 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
597
598 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
599
600
601 (((
602 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:
603 )))
604
605 (% 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" %)​
606
607 Valid AT Command please check [[Configure Device>>||anchor="H4.A0ConfigureGroPointAirviaATCommandorLoRaWANDownlink"]].
608
609
610 = 6. Battery & Power Consumption =
611
612
613 GroPoint Air uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
614
615 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
616
617
618 = 7.  FAQ =
619
620 == 7.1  How to change the LoRa Frequency Bands/Region ==
621
622
623 You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]].
624 When downloading the images, choose the required image file for download. ​
625
626
627 = 8.  Trouble Shooting =
628
629 == 8.1  AT Commands input doesn't work ==
630
631
632 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.
633
634
635 == 8.2  Why i see the payload is 7FFF? ==
636
637
638 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.
639
640
641 = 9.  Order Info =
642
643
644 Part Number: (% style="color:blue" %)**GROPOINT AIR-M-XX**
645
646 (% style="color:blue" %)**XX**(%%): The default frequency band
647
648 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
649 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
650 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
651 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
652 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
653 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
654 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
655 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
656
657
658
659
660 = 10.  Packing Info =
661
662
663 (((
664 **Package Includes:  **
665 )))
666
667 * GroPoint Air-M x 1
668
669 (((
670 **Dimension and weight:**
671 )))
672
673 * Device Size: cm
674 * Device Weight: g
675 * Package Size / pcs : cm
676 * Weight / pcs : g