Last modified by Xiaoling on 2024/04/23 14:37
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -29,15 +29,25 @@ 29 29 == 1.1 What is GroPoint Air == 30 30 31 31 32 +((( 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. 34 +))) 33 33 36 +((( 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**(%%). 38 +))) 35 35 40 +((( 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. 42 +))) 37 37 44 +((( 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. 46 +))) 39 39 48 +((( 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. 50 +))) 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 ... ... @@ -58,12 +58,15 @@ 58 58 59 59 60 60 61 - 62 62 == 1.3 Probe Specification == 63 63 73 +((( 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. 75 +))) 65 65 77 +((( 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]] 79 +))) 67 67 68 68 69 69 == 1.4 Applications == ... ... @@ -74,7 +74,6 @@ 74 74 75 75 76 76 77 - 78 78 == 1.5 Pin Mapping == 79 79 80 80 Inner PCB Pin mapping for reference: ... ... @@ -91,6 +91,11 @@ 91 91 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. 92 92 * Blink once when device transmits a packet. 93 93 106 + 107 + 108 + 109 + 110 + 94 94 == 2.2 Firmware and Changelog == 95 95 96 96 ((( ... ... @@ -110,12 +110,20 @@ 110 110 111 111 == 3.1 Connect to GroPoint Profile == 112 112 130 +((( 113 113 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: 132 +))) 114 114 115 -* Support RS485 Interface 116 -* with M12 5pin connector. 134 +* ((( 135 +Support RS485 Interface 136 +))) 137 +* ((( 138 +with M12 5pin connector. 139 +))) 117 117 141 +((( 118 118 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). 143 +))) 119 119 120 120 121 121 == 3.2 Connect to LoRaWAN Network? == ... ... @@ -125,16 +125,29 @@ 125 125 126 126 == 3.3 Example to use for LoRaWAN network == 127 127 153 +((( 128 128 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar. 155 +))) 129 129 130 -* 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. 157 +* ((( 158 +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. 159 +))) 131 131 161 +((( 132 132 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: 163 +))) 133 133 165 +((( 166 + 167 +))) 134 134 169 +((( 135 135 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air. 171 +))) 136 136 173 +((( 137 137 Each GroPoint Air is shipped with a sticker with the default device EUI as below: 175 +))) 138 138 139 139 140 140 (% 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" %) ... ... @@ -156,9 +156,13 @@ 156 156 157 157 (% style="color:blue" %)**Step 2**(%%): Power on GroPoint Air 158 158 159 -(% 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" %)197 +(% 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"]] 160 160 199 +(% title="Click and drag to resize" %) 200 + 201 +((( 161 161 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. 203 +))) 162 162 163 163 (% 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" %) 164 164 ... ... @@ -175,26 +175,40 @@ 175 175 176 176 == 3.4 Uplink Payload Analyze == 177 177 220 +((( 178 178 Uplink payloads have two types: 222 +))) 179 179 180 180 * ((( 225 +((( 181 181 Report temperature and humidity status normally: Use FPORT=2 182 182 ))) 228 +))) 183 183 * ((( 230 +((( 184 184 Other control commands: Use other FPORT fields. 185 185 ))) 233 +))) 186 186 235 +((( 187 187 The application server should parse the correct value based on FPORT settings. 237 +))) 188 188 189 189 190 190 == 3.5 temperature and humidity Value, Uplink FPORT~=2 == 191 191 192 192 243 +((( 193 193 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will: 245 +))) 194 194 247 +((( 195 195 periodically send this uplink every 20 minutes, this interval can be changed. 249 +))) 196 196 251 +((( 197 197 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below: 253 +))) 198 198 199 199 (% 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" %) 200 200 ... ... @@ -211,20 +211,32 @@ 211 211 (% 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" %) 212 212 213 213 270 +((( 214 214 For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1. 272 +))) 215 215 274 +((( 216 216 For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 276 +))) 217 217 278 +((( 218 218 For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 280 +))) 219 219 220 220 221 221 == 3.6 Show data on Datacake == 222 222 285 +((( 223 223 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: 287 +))) 224 224 289 +((( 225 225 (% 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]] 291 +))) 226 226 293 +((( 227 227 (% style="color:blue" %)**Step 2**(%%): Configure SW3L in Datacake 295 +))) 228 228 229 229 (% 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" %) 230 230 ... ... @@ -250,31 +250,53 @@ 250 250 251 251 = 4. Configure GroPoint Air via AT Command or LoRaWAN Downlink = 252 252 321 +((( 253 253 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink. 323 +))) 254 254 255 -* 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]]. 256 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]] 325 +* ((( 326 +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]]. 327 +))) 328 +* ((( 329 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]] 330 +))) 257 257 332 +((( 258 258 There are two kinds of commands to configure GroPoint Air, they are: 334 +))) 259 259 260 260 * ((( 337 +((( 261 261 **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %). 262 262 ))) 340 +))) 263 263 342 +((( 264 264 These commands are to configure: 344 +))) 265 265 266 -* General system settings like: uplink interval. 267 -* LoRaWAN protocol & radio-related command. 346 +* ((( 347 +General system settings like: uplink interval. 348 +))) 349 +* ((( 350 +LoRaWAN protocol & radio-related command. 351 +))) 268 268 353 +((( 269 269 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/]] 355 +))) 270 270 271 271 272 272 273 273 * ((( 360 +((( 274 274 **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)** 275 275 ))) 363 +))) 276 276 365 +((( 277 277 These commands only valid for GroPoint Air, as below: 367 +))) 278 278 279 279 280 280 ... ... @@ -295,6 +295,11 @@ 295 295 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 296 296 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 297 297 388 + 389 + 390 + 391 + 392 + 298 298 == 4.2 Set Interrupt Mode == 299 299 300 300 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -312,15 +312,28 @@ 312 312 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 313 313 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 314 314 410 + 411 + 412 + 413 + 414 + 315 315 == 4.3 Set the sensor delay time == 316 316 417 +((( 317 317 Feature: Change the sensor delay time. 419 +))) 318 318 421 +((( 319 319 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. 423 +))) 320 320 425 +((( 321 321 The default delay is 1000ms. 427 +))) 322 322 429 +((( 323 323 (% style="color:#037691" %)**AT Command: AT+SDELAY** 431 +))) 324 324 325 325 (% 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" %) 326 326 ... ... @@ -333,6 +333,11 @@ 333 333 * Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms 334 334 * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms 335 335 444 + 445 + 446 + 447 + 448 + 336 336 == 4.4 Query sensor model function == 337 337 338 338 Feature: Using this function will re-update the model. ... ... @@ -411,6 +411,7 @@ 411 411 0x08: LSLP01 412 412 413 413 527 + 414 414 = 5. Use AT Command = 415 415 416 416 == 5.1 Access AT Commands == ... ... @@ -428,7 +428,9 @@ 428 428 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 429 429 430 430 545 +((( 431 431 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: 547 +))) 432 432 433 433 (% 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" %) 434 434 ... ... @@ -439,9 +439,13 @@ 439 439 440 440 == 6.1 Battery Type == 441 441 558 +((( 442 442 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. 560 +))) 443 443 562 +((( 444 444 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 564 +))) 445 445 446 446 447 447 (% 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" %)