Version 69.1 by Xiaoling on 2023/04/26 08:46

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