Last modified by Xiaoling on 2024/04/23 14:37
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -9,6 +9,15 @@ 9 9 ))) 10 10 11 11 12 + 13 + 14 + 15 + 16 + 17 + 18 + 19 + 20 + 12 12 **Table of Contents:** 13 13 14 14 (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %) ... ... @@ -29,15 +29,25 @@ 29 29 == 1.1 What is GroPoint Air == 30 30 31 31 41 +((( 32 32 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. 43 +))) 33 33 45 +((( 34 34 (% 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**(%%). 47 +))) 35 35 49 +((( 36 36 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. 51 +))) 37 37 53 +((( 38 38 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. 55 +))) 39 39 57 +((( 40 40 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. 59 +))) 41 41 42 42 (% 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" %) 43 43 ... ... @@ -56,14 +56,15 @@ 56 56 57 57 58 58 59 - 60 - 61 - 62 62 == 1.3 Probe Specification == 63 63 80 +((( 64 64 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. 82 +))) 65 65 84 +((( 66 66 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]] 86 +))) 67 67 68 68 69 69 == 1.4 Applications == ... ... @@ -72,9 +72,6 @@ 72 72 73 73 74 74 75 - 76 - 77 - 78 78 == 1.5 Pin Mapping == 79 79 80 80 Inner PCB Pin mapping for reference: ... ... @@ -94,9 +94,6 @@ 94 94 95 95 96 96 97 - 98 - 99 - 100 100 == 2.2 Firmware and Changelog == 101 101 102 102 ((( ... ... @@ -116,12 +116,20 @@ 116 116 117 117 == 3.1 Connect to GroPoint Profile == 118 118 133 +((( 119 119 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: 135 +))) 120 120 121 -* Support RS485 Interface 122 -* with M12 5pin connector. 137 +* ((( 138 +Support RS485 Interface 139 +))) 140 +* ((( 141 +with M12 5pin connector. 142 +))) 123 123 144 +((( 124 124 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). 146 +))) 125 125 126 126 127 127 == 3.2 Connect to LoRaWAN Network? == ... ... @@ -131,16 +131,29 @@ 131 131 132 132 == 3.3 Example to use for LoRaWAN network == 133 133 156 +((( 134 134 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar. 158 +))) 135 135 136 -* 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. 160 +* ((( 161 +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. 162 +))) 137 137 164 +((( 138 138 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: 166 +))) 139 139 168 +((( 169 + 170 +))) 140 140 172 +((( 141 141 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air. 174 +))) 142 142 176 +((( 143 143 Each GroPoint Air is shipped with a sticker with the default device EUI as below: 178 +))) 144 144 145 145 146 146 (% 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" %) ... ... @@ -162,9 +162,13 @@ 162 162 163 163 (% style="color:blue" %)**Step 2**(%%): Power on GroPoint Air 164 164 165 -(% 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"]] (% title="Click and drag to resize" %)200 +(% 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"]] 166 166 202 +(% title="Click and drag to resize" %) 203 + 204 +((( 167 167 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. 206 +))) 168 168 169 169 (% 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" %) 170 170 ... ... @@ -181,26 +181,40 @@ 181 181 182 182 == 3.4 Uplink Payload Analyze == 183 183 223 +((( 184 184 Uplink payloads have two types: 225 +))) 185 185 186 186 * ((( 228 +((( 187 187 Report temperature and humidity status normally: Use FPORT=2 188 188 ))) 231 +))) 189 189 * ((( 233 +((( 190 190 Other control commands: Use other FPORT fields. 191 191 ))) 236 +))) 192 192 238 +((( 193 193 The application server should parse the correct value based on FPORT settings. 240 +))) 194 194 195 195 196 196 == 3.5 temperature and humidity Value, Uplink FPORT~=2 == 197 197 198 198 246 +((( 199 199 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will: 248 +))) 200 200 250 +((( 201 201 periodically send this uplink every 20 minutes, this interval can be changed. 252 +))) 202 202 254 +((( 203 203 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below: 256 +))) 204 204 205 205 (% 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" %) 206 206 ... ... @@ -217,20 +217,32 @@ 217 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" %) 218 218 219 219 273 +((( 220 220 For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1. 275 +))) 221 221 277 +((( 222 222 For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 279 +))) 223 223 281 +((( 224 224 For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 283 +))) 225 225 226 226 227 227 == 3.6 Show data on Datacake == 228 228 288 +((( 229 229 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: 290 +))) 230 230 292 +((( 231 231 (% 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]] 294 +))) 232 232 296 +((( 233 233 (% style="color:blue" %)**Step 2**(%%): Configure SW3L in Datacake 298 +))) 234 234 235 235 (% 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" %) 236 236 ... ... @@ -256,31 +256,53 @@ 256 256 257 257 = 4. Configure GroPoint Air via AT Command or LoRaWAN Downlink = 258 258 324 +((( 259 259 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink. 326 +))) 260 260 261 -* AT Command Connection: See [[FAQ>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/#H6.FAQ]]. 262 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]] 328 +* ((( 329 +AT Command Connection: See [[FAQ>>||anchor="H7.A0FAQ"]]. 330 +))) 331 +* ((( 332 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]] 333 +))) 263 263 335 +((( 264 264 There are two kinds of commands to configure GroPoint Air, they are: 337 +))) 265 265 266 266 * ((( 340 +((( 267 267 **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %). 268 268 ))) 343 +))) 269 269 345 +((( 270 270 These commands are to configure: 347 +))) 271 271 272 -* General system settings like: uplink interval. 273 -* LoRaWAN protocol & radio-related command. 349 +* ((( 350 +General system settings like: uplink interval. 351 +))) 352 +* ((( 353 +LoRaWAN protocol & radio-related command. 354 +))) 274 274 356 +((( 275 275 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/]] 358 +))) 276 276 277 277 278 278 279 279 * ((( 363 +((( 280 280 **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)** 281 281 ))) 366 +))) 282 282 368 +((( 283 283 These commands only valid for GroPoint Air, as below: 370 +))) 284 284 285 285 286 286 ... ... @@ -304,9 +304,6 @@ 304 304 305 305 306 306 307 - 308 - 309 - 310 310 == 4.2 Set Interrupt Mode == 311 311 312 312 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -327,18 +327,23 @@ 327 327 328 328 329 329 330 - 331 - 332 - 333 333 == 4.3 Set the sensor delay time == 334 334 416 +((( 335 335 Feature: Change the sensor delay time. 418 +))) 336 336 420 +((( 337 337 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. 422 +))) 338 338 424 +((( 339 339 The default delay is 1000ms. 426 +))) 340 340 428 +((( 341 341 (% style="color:#037691" %)**AT Command: AT+SDELAY** 430 +))) 342 342 343 343 (% 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" %) 344 344 ... ... @@ -354,9 +354,6 @@ 354 354 355 355 356 356 357 - 358 - 359 - 360 360 == 4.4 Query sensor model function == 361 361 362 362 Feature: Using this function will re-update the model. ... ... @@ -453,7 +453,9 @@ 453 453 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 454 454 455 455 542 +((( 456 456 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: 544 +))) 457 457 458 458 (% 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" %) 459 459 ... ... @@ -464,9 +464,13 @@ 464 464 465 465 == 6.1 Battery Type == 466 466 555 +((( 467 467 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. 557 +))) 468 468 559 +((( 469 469 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 561 +))) 470 470 471 471 472 472 (% aria-label="1654593587246-335.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/1654593587246-335.png?rev=1.1||alt="1654593587246-335.png" data-widget="image" height="408" width="574"]](% 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" %) ... ... @@ -478,27 +478,43 @@ 478 478 479 479 == 6.2 Power Consumption Analyze == 480 480 573 +((( 481 481 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. 575 +))) 482 482 577 +((( 483 483 Instruction to use as below: 579 +))) 484 484 485 485 582 +((( 486 486 (% style="color:blue" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 584 +))) 487 487 488 488 587 +((( 489 489 (% style="color:blue" %)**Step 2**(%%): Open it and choose 589 +))) 490 490 491 491 * ((( 592 +((( 492 492 Product Model 493 493 ))) 595 +))) 494 494 * ((( 597 +((( 495 495 Uplink Interval 496 496 ))) 600 +))) 497 497 * ((( 602 +((( 498 498 Working Mode 499 499 ))) 605 +))) 500 500 607 +((( 501 501 And the Life expectation in different cases will be shown on the right. 609 +))) 502 502 503 503 (% aria-label="1654593605679-189.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/1654593605679-189.png?rev=1.1||alt="1654593605679-189.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" %) 504 504 ... ... @@ -577,11 +577,15 @@ 577 577 578 578 = 10. Packing Info = 579 579 688 +((( 580 580 **Package Includes: ** 690 +))) 581 581 582 582 * GroPoint Air-M x 1 583 583 694 +((( 584 584 **Dimension and weight:** 696 +))) 585 585 586 586 * Device Size: cm 587 587 * Device Weight: g