Version 69.3 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
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 68.9 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 68.9 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.2 182 [[image:image-20230426084611-1.png]]
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 68.6 220
Xiaoling 64.2 221 === **Decoder in TTN V3** ===
David Huang 42.1 222
Xiaoling 65.10 223 (% 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 224
Xiaoling 68.6 225 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 226
227
Xiaoling 64.2 228 == 3.4  Uplink Payload Analyze ==
Edwin Chen 56.2 229
Xiaoling 68.5 230
Xiaoling 67.12 231 (((
David Huang 61.1 232 Uplink payloads have two types:
Xiaoling 67.12 233 )))
Edwin Chen 56.2 234
David Huang 61.1 235 * (((
Xiaoling 67.12 236 (((
David Huang 61.1 237 Report temperature and humidity status normally: Use FPORT=2
238 )))
Xiaoling 67.12 239 )))
David Huang 61.1 240 * (((
Xiaoling 67.12 241 (((
David Huang 61.1 242 Other control commands: Use other FPORT fields.
243 )))
Xiaoling 67.12 244 )))
Edwin Chen 56.2 245
Xiaoling 67.12 246 (((
David Huang 61.1 247 The application server should parse the correct value based on FPORT settings.
Xiaoling 67.12 248 )))
Edwin Chen 56.2 249
David Huang 61.1 250
Xiaoling 64.2 251 == 3.5  temperature and humidity Value, Uplink FPORT~=2 ==
David Huang 61.1 252
253
Xiaoling 67.12 254 (((
David Huang 61.1 255 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
Xiaoling 67.12 256 )))
David Huang 61.1 257
Xiaoling 67.12 258 (((
David Huang 61.1 259 periodically send this uplink every 20 minutes, this interval can be changed.
Xiaoling 67.12 260 )))
David Huang 61.1 261
Xiaoling 67.12 262 (((
David Huang 61.1 263 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
Xiaoling 67.12 264 )))
David Huang 61.1 265
Xiaoling 65.10 266 (% 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 267
Xiaoling 65.5 268 GroPoint Air's sensors come in six models: GPLP-2,GPLP-3,GPLP-4,GPLP-5,GPLP-6,GPLP-8.
David Huang 61.1 269
270 The amount of temperature and humidity is different for each model, so the payload of each model is different.
271
272 Take GPLP-3 as an example:
273
274 Uplink Payload totals 21 bytes.
275
Xiaoling 65.10 276 (% 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 277
Xiaoling 65.10 278 (% 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 279
280
Xiaoling 67.13 281 (((
David Huang 63.1 282 For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1.
Xiaoling 67.13 283 )))
David Huang 63.1 284
Xiaoling 67.13 285 (((
David Huang 64.1 286 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 287 )))
David Huang 63.1 288
Xiaoling 67.13 289 (((
David Huang 64.1 290 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 291 )))
David Huang 64.1 292
David Huang 42.1 293
Xiaoling 64.2 294 == 3.6  Show data on Datacake ==
295
Xiaoling 68.5 296
Xiaoling 67.14 297 (((
David Huang 42.1 298 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 299 )))
David Huang 42.1 300
Xiaoling 67.14 301 (((
Xiaoling 65.5 302 (% 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 303 )))
David Huang 42.1 304
Xiaoling 67.14 305 (((
Xiaoling 65.5 306 (% style="color:blue" %)**Step 2**(%%):  Configure SW3L in Datacake  ​​​​
Xiaoling 67.14 307 )))
David Huang 42.1 308
Xiaoling 65.10 309 (% 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 310
Xiaoling 65.6 311 (% 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 312
Xiaoling 65.6 313 (% 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 314
Xiaoling 65.10 315 (% 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 316
Xiaoling 65.10 317 (% title="Click and drag to resize" %)​
David Huang 42.1 318
Xiaoling 65.10 319 (% 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 320
Xiaoling 65.10 321 (% title="Click and drag to resize" %)​
David Huang 42.1 322
Xiaoling 65.10 323 (% 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 324
Xiaoling 65.10 325 (% title="Click and drag to resize" %)​
David Huang 42.1 326
Xiaoling 65.10 327 (% 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" %)​
328
329
Xiaoling 64.2 330 = 4.  Configure GroPoint Air via AT Command or LoRaWAN Downlink =
Edwin Chen 32.1 331
Xiaoling 68.5 332
Xiaoling 67.15 333 (((
Edwin Chen 32.1 334 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
Xiaoling 67.15 335 )))
Edwin Chen 32.1 336
Xiaoling 67.15 337 * (((
Xiaoling 68.3 338 AT Command Connection: See [[FAQ>>||anchor="H7.A0FAQ"]].
Xiaoling 67.15 339 )))
340 * (((
341 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
342 )))
Edwin Chen 32.1 343
Xiaoling 67.15 344 (((
Edwin Chen 34.1 345 There are two kinds of commands to configure GroPoint Air, they are:
Xiaoling 67.15 346 )))
Edwin Chen 32.1 347
348 * (((
Xiaoling 67.15 349 (((
Xiaoling 65.12 350 **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %).
Edwin Chen 32.1 351 )))
Xiaoling 67.15 352 )))
Edwin Chen 32.1 353
Xiaoling 67.15 354 (((
Edwin Chen 32.1 355 These commands are to configure:
Xiaoling 67.15 356 )))
Edwin Chen 32.1 357
Xiaoling 67.15 358 * (((
359 General system settings like: uplink interval.
360 )))
361 * (((
362 LoRaWAN protocol & radio-related command.
363 )))
Edwin Chen 32.1 364
Xiaoling 67.15 365 (((
Edwin Chen 32.1 366 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 367 )))
Edwin Chen 32.1 368
369
Xiaoling 65.10 370
Edwin Chen 32.1 371 * (((
Xiaoling 67.15 372 (((
Xiaoling 65.12 373 **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)**
Edwin Chen 32.1 374 )))
Xiaoling 67.15 375 )))
Edwin Chen 32.1 376
Xiaoling 67.15 377 (((
Edwin Chen 34.1 378 These commands only valid for GroPoint Air, as below:
Xiaoling 67.15 379 )))
Edwin Chen 32.1 380
381
Xiaoling 64.2 382 == 4.1  Set Transmit Interval Time ==
383
Xiaoling 68.5 384
Edwin Chen 32.1 385 Feature: Change LoRaWAN End Node Transmit Interval.
386
Xiaoling 68.5 387
Xiaoling 65.12 388 (% style="color:#037691" %)**AT Command: AT+TDC**
Edwin Chen 32.1 389
Xiaoling 65.6 390 (% 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 391
Xiaoling 65.12 392 (% style="color:#037691" %)**Downlink Command: 0x01**
Edwin Chen 32.1 393
394 Format: Command Code (0x01) followed by 3 bytes time value.
395
396 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
397
Xiaoling 68.6 398 * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
399 * Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
Edwin Chen 32.1 400
Xiaoling 68.9 401
Xiaoling 64.2 402 == 4.2  Set Interrupt Mode ==
403
Xiaoling 68.5 404
Edwin Chen 32.1 405 Feature, Set Interrupt mode for GPIO_EXIT.
406
Xiaoling 68.5 407
Xiaoling 65.12 408 (% style="color:#037691" %)**AT Command: AT+INTMOD**
Edwin Chen 32.1 409
Xiaoling 65.6 410 (% 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 411
Xiaoling 65.12 412 (% style="color:#037691" %)**Downlink Command: 0x06**
Edwin Chen 32.1 413
414 Format: Command Code (0x06) followed by 3 bytes.
415
416 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
417
Xiaoling 68.6 418 * Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
419 * Example 2: Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
Edwin Chen 32.1 420
Xiaoling 68.9 421
Xiaoling 65.10 422 == 4.3  Set the sensor delay time ==
423
Xiaoling 68.5 424
Xiaoling 67.16 425 (((
David Huang 54.1 426 Feature: Change the sensor delay time.
Xiaoling 68.5 427
428
Xiaoling 67.16 429 )))
David Huang 54.1 430
Xiaoling 67.16 431 (((
David Huang 62.1 432 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 433 )))
David Huang 62.1 434
Xiaoling 67.16 435 (((
David Huang 55.1 436 The default delay is 1000ms.
Xiaoling 68.5 437
438
Xiaoling 67.16 439 )))
David Huang 55.1 440
Xiaoling 67.16 441 (((
Xiaoling 65.12 442 (% style="color:#037691" %)**AT Command: AT+SDELAY**
Xiaoling 67.16 443 )))
David Huang 54.1 444
Xiaoling 65.6 445 (% 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 446
Xiaoling 65.12 447 (% style="color:#037691" %)**Downlink Command: 0xA1**
David Huang 54.1 448
449 Format: Command Code (0xA1) followed by 3 bytes time value.
450
451 If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
452
Xiaoling 68.6 453 * Example 1: Downlink Payload: A10003E8  ~/~/ Set the sensor delay time = 1000ms
454 * Example 2: Downlink Payload: A10007D0  ~/~/ Set the sensor delay time = 2000ms
David Huang 54.1 455
Xiaoling 68.9 456
Xiaoling 64.2 457 == 4.4  Query sensor model function ==
458
Xiaoling 68.5 459
David Huang 62.1 460 Feature: Using this function will re-update the model.
461
Xiaoling 68.5 462
Xiaoling 65.12 463 (% style="color:#037691" %)**Downlink Command: 0xFA00**
David Huang 62.1 464
465
Xiaoling 64.2 466 == 4.5  Get Firmware Version Info ==
David Huang 62.1 467
Xiaoling 68.5 468
Edwin Chen 32.1 469 Feature: use downlink to get firmware version.
470
Xiaoling 68.5 471
Xiaoling 65.12 472 (% style="color:#037691" %)**Downlink Command: 0x26**
Edwin Chen 32.1 473
Xiaoling 65.6 474 (% 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 475
476 * Reply to the confirmation package: 26 01
477 * Reply to non-confirmed packet: 26 00
478
479 Device will send an uplink after got this downlink command. With below payload:
480
481 Configures info payload:
482
Xiaoling 66.2 483 [[image:image-20220625101917-1.png]]
Edwin Chen 32.1 484
485
Xiaoling 65.12 486 (% style="color:#037691" %)**Software Type**(%%): Always 0x03 for GroPoint Air
Edwin Chen 32.1 487
488
Xiaoling 65.12 489 (% style="color:#037691" %)**Frequency Band**(%%):
Xiaoling 65.10 490
Edwin Chen 32.1 491 *0x01: EU868
492
493 *0x02: US915
494
495 *0x03: IN865
496
497 *0x04: AU915
498
499 *0x05: KZ865
500
501 *0x06: RU864
502
503 *0x07: AS923
504
505 *0x08: AS923-1
506
507 *0x09: AS923-2
508
David Huang 41.1 509 *0x0A: AS923-3
Edwin Chen 32.1 510
David Huang 41.1 511 *0x0B: AS923-4
512
Edwin Chen 32.1 513
Xiaoling 66.2 514 (% style="color:#037691" %)**Sub-Band**(%%):  value 0x00 ~~ 0x08
Edwin Chen 32.1 515
516
Xiaoling 66.2 517 (% style="color:#037691" %)**Firmware Version**(%%):  0x0100, Means: v1.0.0 version
Xiaoling 65.11 518
Xiaoling 66.2 519
Xiaoling 65.12 520 (% style="color:#037691" %)**Sensor Type**(%%):
Xiaoling 65.11 521
Edwin Chen 32.1 522 0x01: LSE01
523
524 0x02: LDDS75
525
526 0x03: LDDS20
527
528 0x04: LLMS01
529
530 0x05: LSPH01
531
532 0x06: LSNPK01
533
David Huang 41.1 534 0x07: LDDS45
Edwin Chen 32.1 535
David Huang 41.1 536 0x08: LSLP01
Edwin Chen 32.1 537
Edwin Chen 11.1 538
Xiaoling 64.2 539 = 5.  Use AT Command =
Edwin Chen 25.1 540
Xiaoling 64.2 541 == 5.1  Access AT Commands ==
542
Xiaoling 68.5 543
Edwin Chen 25.1 544 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.
545
Xiaoling 65.6 546 (% 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 547
548 **Connection:**
549
550 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
551
552 (% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
553
554 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
555
556
Xiaoling 67.17 557 (((
Edwin Chen 25.1 558 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 559 )))
Edwin Chen 25.1 560
Xiaoling 65.6 561 (% 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 562
Xiaoling 66.3 563 Valid AT Command please check [[Configure Device>>||anchor="H4.A0ConfigureGroPointAirviaATCommandorLoRaWANDownlink"]].
Edwin Chen 25.1 564
565
Xiaoling 68.7 566 = 6. Battery & Power Consumption =
Edwin Chen 28.1 567
568
Xiaoling 68.7 569 GroPoint Air uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
Xiaoling 68.5 570
Xiaoling 68.7 571 [[**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 572
Xiaoling 68.9 573
Xiaoling 64.3 574 = 7.  FAQ =
Edwin Chen 28.1 575
Xiaoling 64.4 576 == 7.1  How to change the LoRa Frequency Bands/Region ==
Edwin Chen 18.1 577
Xiaoling 68.5 578
Edwin Chen 24.1 579 You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]].
580 When downloading the images, choose the required image file for download. ​
Edwin Chen 18.1 581
582
Xiaoling 64.4 583 = 8.  Trouble Shooting =
Edwin Chen 18.1 584
Xiaoling 66.4 585 == 8.1  AT Commands input doesn't work ==
Edwin Chen 18.1 586
587
Xiaoling 68.5 588 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 589
Xiaoling 68.5 590
Xiaoling 64.4 591 == 8.2  Why i see the payload is 7FFF? ==
592
Xiaoling 68.5 593
David Huang 62.1 594 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 595
Edwin Chen 11.1 596
Xiaoling 64.4 597 = 9.  Order Info =
598
Xiaoling 68.5 599
Xiaoling 66.4 600 Part Number: (% style="color:blue" %)**GROPOINT AIR-M-XX**
Edwin Chen 11.1 601
Xiaoling 66.4 602 (% style="color:blue" %)**XX**(%%): The default frequency band
Edwin Chen 11.1 603
Xiaoling 66.4 604 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
605 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
606 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
607 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
608 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
609 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
Xiaoling 66.5 610 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
Xiaoling 66.4 611 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
Edwin Chen 11.1 612
Xiaoling 64.4 613
Edwin Chen 16.1 614
Xiaoling 64.4 615
Xiaoling 68.5 616 = 10.  Packing Info =
Xiaoling 64.4 617
618
Xiaoling 67.20 619 (((
Edwin Chen 17.1 620 **Package Includes:  **
Xiaoling 67.20 621 )))
Edwin Chen 16.1 622
Edwin Chen 17.1 623 * GroPoint Air-M x 1
624
Xiaoling 67.20 625 (((
Edwin Chen 17.1 626 **Dimension and weight:**
Xiaoling 67.20 627 )))
Edwin Chen 17.1 628
629 * Device Size: cm
630 * Device Weight: g
631 * Package Size / pcs : cm
632 * Weight / pcs : g
Xiaoling 68.9 633