Last modified by Xiaoling on 2025/04/25 10:03
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -3,13 +3,26 @@ 3 3 {{/box}} 4 4 5 5 6 +(% style="text-align:center" %) 6 6 [[image:image-20220530000243-1.png||height="332" width="531"]] 7 7 8 8 9 - =Introduction=10 +Table of Contents: 10 10 11 - == Whatis GroPoint Air ==12 +{{toc/}} 12 12 14 + 15 + 16 + 17 + 18 + 19 + 20 + 21 += 1. Introduction = 22 + 23 +== 1.1 What is GroPoint Air == 24 + 25 + 13 13 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. 14 14 15 15 (% 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**(%%). ... ... @@ -23,7 +23,7 @@ 23 23 [[image:image-20220530002019-2.png||height="295" width="655"]] 24 24 25 25 26 -== Features == 39 +== 1.2 Features == 27 27 28 28 29 29 * LoRaWAN 1.0.3 Class A ... ... @@ -36,28 +36,37 @@ 36 36 * IP66 Waterproof Enclosure 37 37 * 8500mAh Battery for long term use 38 38 39 -== Probe Specification == 40 40 53 + 54 + 55 + 56 + 57 +== 1.3 Probe Specification == 58 + 41 41 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. 42 42 43 43 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]] 44 44 45 45 46 -== Applications == 64 +== 1.4 Applications == 47 47 48 48 * Smart Agriculture 49 49 50 -== Pin Mapping == 51 51 69 + 70 + 71 + 72 +== 1.5 Pin Mapping == 73 + 52 52 Inner PCB Pin mapping for reference: 53 53 54 54 [[image:image-20220530002453-3.png||height="262" width="493"]] 55 55 56 56 57 -= Connect LoRaWAN Network = 79 += 2. Connect LoRaWAN Network = 58 58 59 59 60 -== LED Indicator == 82 +== 2.1 LED Indicator == 61 61 62 62 The GroPoint Air has an internal LED which can show the status of different states. 63 63 ... ... @@ -64,21 +64,36 @@ 64 64 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. 65 65 * Blink once when device transmits a packet. 66 66 67 -== Firmware and Changelog == 68 68 90 + 91 + 92 + 93 + 94 +== 2.2 Firmware and Changelog == 95 + 69 69 Firmware Download Location: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/GroPoint_Air/firmware/>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/GroPoint_Air/firmware/]] 70 70 71 71 Change Log: 72 72 73 73 74 -= OperationMode =101 += 3. How to use? = 75 75 76 -== Howitworks?==103 +== 3.1 Connect to GroPoint Profile == 77 77 105 +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: 106 + 107 +* Support RS485 Interface 108 +* with M12 5pin connector. 109 + 110 +Such model in GroPoint Profile is: **2625-N-T-x-M-M **(Where x is different depending on how many levels it detects). 111 + 112 + 113 +== 3.2 Connect to LoRaWAN Network? == 114 + 78 78 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 79 79 80 80 81 -== Example to use for LoRaWAN network == 118 +== 3.3 Example to use for LoRaWAN network == 82 82 83 83 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar. 84 84 ... ... @@ -116,7 +116,7 @@ 116 116 [[image:image-20220611174943-1.png||height="139" width="1008"]] 117 117 118 118 119 -=== Decoder in TTN V3 === 156 +=== **Decoder in TTN V3** === 120 120 121 121 [[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" height="359" width="723"]] 122 122 ... ... @@ -125,13 +125,53 @@ 125 125 [[https:~~/~~/www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0>>https://www.dropbox.com/sh/4strg6w7kkekdc4/AAAUKdAV3XKhOi3t6YjA8j9za?dl=0]] 126 126 127 127 128 -== Uplink Payload Analyze == 165 +== 3.4 Uplink Payload Analyze == 129 129 167 +Uplink payloads have two types: 130 130 169 +* ((( 170 +Report temperature and humidity status normally: Use FPORT=2 171 +))) 172 +* ((( 173 +Other control commands: Use other FPORT fields. 174 +))) 131 131 176 +The application server should parse the correct value based on FPORT settings. 132 132 133 -== Show data on Datacake == 134 134 179 +== 3.5 temperature and humidity Value, Uplink FPORT~=2 == 180 + 181 + 182 +GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will: 183 + 184 +periodically send this uplink every 20 minutes, this interval can be changed. 185 + 186 +The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below: 187 + 188 +[[image:image-20220621093414-1.png||height="932" width="816"]] 189 + 190 +GroPoint Air's sensors come in six models:GPLP-2,GPLP-3,GPLP-4,GPLP-5,GPLP-6,GPLP-8. 191 + 192 +The amount of temperature and humidity is different for each model, so the payload of each model is different. 193 + 194 +Take GPLP-3 as an example: 195 + 196 +Uplink Payload totals 21 bytes. 197 + 198 +[[image:image-20220621100751-2.png||height="124" width="774"]] 199 + 200 +[[image:image-20220611174943-1.png||height="139" width="1008"]] 201 + 202 + 203 +For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1. 204 + 205 +For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 206 + 207 +For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 208 + 209 + 210 +== 3.6 Show data on Datacake == 211 + 135 135 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: 136 136 137 137 **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]] ... ... @@ -154,7 +154,7 @@ 154 154 155 155 156 156 157 -= Configure GroPoint Air via AT Command or LoRaWAN Downlink = 234 += 4. Configure GroPoint Air via AT Command or LoRaWAN Downlink = 158 158 159 159 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink. 160 160 ... ... @@ -181,8 +181,10 @@ 181 181 182 182 These commands only valid for GroPoint Air, as below: 183 183 184 -== 3.1 Set Transmit Interval Time == 185 185 262 + 263 +== 4.1 Set Transmit Interval Time == 264 + 186 186 Feature: Change LoRaWAN End Node Transmit Interval. 187 187 188 188 **AT Command: AT+TDC** ... ... @@ -198,8 +198,13 @@ 198 198 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 199 199 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 200 200 201 -== 3.2 Set Interrupt Mode == 202 202 281 + 282 + 283 + 284 + 285 +== 4.2 Set Interrupt Mode == 286 + 203 203 Feature, Set Interrupt mode for GPIO_EXIT. 204 204 205 205 **AT Command: AT+INTMOD** ... ... @@ -215,10 +215,17 @@ 215 215 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 216 216 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 217 217 218 -== (% id="cke_bm_55968S" style="display:none" %) (%%)3.3 Set the sensor delay time == 219 219 303 + 304 + 305 + 306 + 307 +== (% id="cke_bm_55968S" style="display:none" %) (%%)4.3 Set the sensor delay time == 308 + 220 220 Feature: Change the sensor delay time. 221 221 311 +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. 312 + 222 222 The default delay is 1000ms. 223 223 224 224 **AT Command: AT+SDELAY** ... ... @@ -234,8 +234,20 @@ 234 234 * Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms 235 235 * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms 236 236 237 -== 3.4 Get Firmware Version Info == 238 238 329 + 330 + 331 + 332 + 333 +== 4.4 Query sensor model function == 334 + 335 +Feature: Using this function will re-update the model. 336 + 337 +**Downlink Command: 0xFA00** 338 + 339 + 340 +== 4.5 Get Firmware Version Info == 341 + 239 239 Feature: use downlink to get firmware version. 240 240 241 241 **Downlink Command: 0x26** ... ... @@ -245,22 +245,25 @@ 245 245 * Reply to the confirmation package: 26 01 246 246 * Reply to non-confirmed packet: 26 00 247 247 351 + 352 + 248 248 Device will send an uplink after got this downlink command. With below payload: 249 249 250 250 Configures info payload: 251 251 252 -|=((( 357 +(% border="1" cellspacing="8" style="background-color:#ffffcc; color:green; width:510px" %) 358 +|=(% style="width: 96px;" %)((( 253 253 **Size(bytes)** 254 -)))|=**1**|=**1**|=**1**|=**2**|=**1**|=4|=**1** 255 -|**Value**|Software Type|((( 360 +)))|=(% style="width: 119px;" %)**1**|=(% style="width: 88px;" %)**1**|=(% style="width: 88px;" %)**1**|=(% style="width: 82px;" %)**2**|=(% style="width: 108px;" %)**1**|=(% style="width: 76px;" %)4|=(% style="width: 102px;" %)**1** 361 +|(% style="width:96px" %)**Value**|(% style="width:119px" %)Software Type|(% style="width:88px" %)((( 256 256 Frequency 257 257 258 258 Band 259 -)))|Sub-band|((( 365 +)))|(% style="width:88px" %)Sub-band|(% style="width:82px" %)((( 260 260 Firmware 261 261 262 262 Version 263 -)))|Sensor Type|Reserve|((( 369 +)))|(% style="width:108px" %)Sensor Type|(% style="width:76px" %)Reserve|(% style="width:102px" %)((( 264 264 [[Message Type>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/#H2.3.6MessageType]] 265 265 Always 0x02 266 266 ))) ... ... @@ -313,10 +313,11 @@ 313 313 314 314 0x08: LSLP01 315 315 316 -= Use AT Command = 317 317 318 -= =AccessAT Commands==423 += 5. Use AT Command = 319 319 425 +== 5.1 Access AT Commands == 426 + 320 320 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. 321 321 322 322 [[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654593668970-604.png||height="297" width="474"]] ... ... @@ -337,9 +337,9 @@ 337 337 Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLLMS01viaATCommandorLoRaWANDownlink"]]. 338 338 339 339 340 -= Battery & How to replace = 447 += 6. Battery & How to replace = 341 341 342 -== Battery Type == 449 +== 6.1 Battery Type == 343 343 344 344 GroPoint Air is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. The battery is an un-rechargeable battery with a low discharge rate targeting more than 5 years use. This type of battery is commonly used in IoT targets for long-term running, such as water meters. 345 345 ... ... @@ -353,7 +353,7 @@ 353 353 GroPoint Air: 2.45v ~~ 3.6v 354 354 355 355 356 -== Power Consumption Analyze == 463 +== 6.2 Power Consumption Analyze == 357 357 358 358 Dragino Battery-powered products are all runs in Low Power mode. We have an updated battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit intervals. 359 359 ... ... @@ -394,22 +394,25 @@ 394 394 [[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-20220607172042-11.png?rev=1.1||alt="image-20220607172042-11.png"]] 395 395 396 396 397 -=== Battery Note === 504 +=== 6.2.1 Battery Note === 398 398 399 399 The Li-SICO battery is designed for small current / long period applications. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period to transmit LoRa, then the battery life may be decreased. 400 400 401 401 402 -=== Replace the battery === 509 +=== 6.2.2 Replace the battery === 403 403 511 +((( 404 404 You can change the battery in GroPoint Air. The type of battery is not limited as long as the output is between 3v to 3.6v. 513 +))) 405 405 406 -The default battery pack of GroPoint Air includes a ER26500 plus supercapacitor. If users can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most cases. The SPC can enlarge the battery life for high-frequency use (update period below 5 minutes) 515 +((( 516 +The default battery pack of GroPoint Air includes a ER26500 plus supercapacitor. If users can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most cases. The SPC can enlarge the battery life for high-frequency use (update period below 5 minutes). 517 +))) 407 407 408 408 409 409 521 += 7. FAQ = 410 410 411 -= FAQ = 412 - 413 413 == How to change the LoRa Frequency Bands/Region == 414 414 415 415 You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]]. ... ... @@ -422,7 +422,9 @@ 422 422 423 423 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. 424 424 535 +== Why i see the payload is 7FFF? == 425 425 537 +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. 426 426 427 427 = Order Info = 428 428
- image-20220621093414-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +158.4 KB - Content
- image-20220621100751-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +6.7 KB - Content