Version 69.13 by Xiaoling on 2023/12/14 11:39

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