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 == ... ... @@ -70,6 +70,10 @@ 70 70 71 71 * Smart Agriculture 72 72 86 + 87 + 88 + 89 + 73 73 == 1.5 Pin Mapping == 74 74 75 75 Inner PCB Pin mapping for reference: ... ... @@ -86,6 +86,11 @@ 86 86 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. 87 87 * Blink once when device transmits a packet. 88 88 106 + 107 + 108 + 109 + 110 + 89 89 == 2.2 Firmware and Changelog == 90 90 91 91 ((( ... ... @@ -105,12 +105,20 @@ 105 105 106 106 == 3.1 Connect to GroPoint Profile == 107 107 130 +((( 108 108 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 +))) 109 109 110 -* Support RS485 Interface 111 -* with M12 5pin connector. 134 +* ((( 135 +Support RS485 Interface 136 +))) 137 +* ((( 138 +with M12 5pin connector. 139 +))) 112 112 141 +((( 113 113 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 +))) 114 114 115 115 116 116 == 3.2 Connect to LoRaWAN Network? == ... ... @@ -120,16 +120,29 @@ 120 120 121 121 == 3.3 Example to use for LoRaWAN network == 122 122 153 +((( 123 123 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar. 155 +))) 124 124 125 -* 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 +))) 126 126 161 +((( 127 127 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 +))) 128 128 165 +((( 166 + 167 +))) 129 129 169 +((( 130 130 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air. 171 +))) 131 131 173 +((( 132 132 Each GroPoint Air is shipped with a sticker with the default device EUI as below: 175 +))) 133 133 134 134 135 135 (% 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" %) ... ... @@ -151,9 +151,13 @@ 151 151 152 152 (% style="color:blue" %)**Step 2**(%%): Power on GroPoint Air 153 153 154 -(% 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"]] 155 155 199 +(% title="Click and drag to resize" %) 200 + 201 +((( 156 156 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 +))) 157 157 158 158 (% 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" %) 159 159 ... ... @@ -170,26 +170,40 @@ 170 170 171 171 == 3.4 Uplink Payload Analyze == 172 172 220 +((( 173 173 Uplink payloads have two types: 222 +))) 174 174 175 175 * ((( 225 +((( 176 176 Report temperature and humidity status normally: Use FPORT=2 177 177 ))) 228 +))) 178 178 * ((( 230 +((( 179 179 Other control commands: Use other FPORT fields. 180 180 ))) 233 +))) 181 181 235 +((( 182 182 The application server should parse the correct value based on FPORT settings. 237 +))) 183 183 184 184 185 185 == 3.5 temperature and humidity Value, Uplink FPORT~=2 == 186 186 187 187 243 +((( 188 188 GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will: 245 +))) 189 189 247 +((( 190 190 periodically send this uplink every 20 minutes, this interval can be changed. 249 +))) 191 191 251 +((( 192 192 The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below: 253 +))) 193 193 194 194 (% 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" %) 195 195 ... ... @@ -206,20 +206,32 @@ 206 206 (% 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" %) 207 207 208 208 270 +((( 209 209 For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1. 272 +))) 210 210 274 +((( 211 211 For AU915 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 276 +))) 212 212 278 +((( 213 213 For AS923 frequency, when DR=2,Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3. 280 +))) 214 214 215 215 216 216 == 3.6 Show data on Datacake == 217 217 285 +((( 218 218 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 +))) 219 219 289 +((( 220 220 (% 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 +))) 221 221 293 +((( 222 222 (% style="color:blue" %)**Step 2**(%%): Configure SW3L in Datacake 295 +))) 223 223 224 224 (% 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" %) 225 225 ... ... @@ -245,31 +245,53 @@ 245 245 246 246 = 4. Configure GroPoint Air via AT Command or LoRaWAN Downlink = 247 247 321 +((( 248 248 Use can configure GroPoint Air via AT Command or LoRaWAN Downlink. 323 +))) 249 249 250 -* 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]]. 251 -* 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 +))) 252 252 332 +((( 253 253 There are two kinds of commands to configure GroPoint Air, they are: 334 +))) 254 254 255 255 * ((( 337 +((( 256 256 **~ (% style="color:#4472c4" %)General Commands(%%)**(% style="color:#4472c4" %). 257 257 ))) 340 +))) 258 258 342 +((( 259 259 These commands are to configure: 344 +))) 260 260 261 -* General system settings like: uplink interval. 262 -* LoRaWAN protocol & radio-related command. 346 +* ((( 347 +General system settings like: uplink interval. 348 +))) 349 +* ((( 350 +LoRaWAN protocol & radio-related command. 351 +))) 263 263 353 +((( 264 264 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 +))) 265 265 266 266 267 267 268 268 * ((( 360 +((( 269 269 **~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)** 270 270 ))) 363 +))) 271 271 365 +((( 272 272 These commands only valid for GroPoint Air, as below: 367 +))) 273 273 274 274 275 275 ... ... @@ -290,6 +290,11 @@ 290 290 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 291 291 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 292 292 388 + 389 + 390 + 391 + 392 + 293 293 == 4.2 Set Interrupt Mode == 294 294 295 295 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -307,15 +307,28 @@ 307 307 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 308 308 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 309 309 410 + 411 + 412 + 413 + 414 + 310 310 == 4.3 Set the sensor delay time == 311 311 417 +((( 312 312 Feature: Change the sensor delay time. 419 +))) 313 313 421 +((( 314 314 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 +))) 315 315 425 +((( 316 316 The default delay is 1000ms. 427 +))) 317 317 429 +((( 318 318 (% style="color:#037691" %)**AT Command: AT+SDELAY** 431 +))) 319 319 320 320 (% 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" %) 321 321 ... ... @@ -328,6 +328,11 @@ 328 328 * Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms 329 329 * Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms 330 330 444 + 445 + 446 + 447 + 448 + 331 331 == 4.4 Query sensor model function == 332 332 333 333 Feature: Using this function will re-update the model. ... ... @@ -406,6 +406,7 @@ 406 406 0x08: LSLP01 407 407 408 408 527 + 409 409 = 5. Use AT Command = 410 410 411 411 == 5.1 Access AT Commands == ... ... @@ -423,7 +423,9 @@ 423 423 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 424 424 425 425 545 +((( 426 426 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 +))) 427 427 428 428 (% 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" %) 429 429 ... ... @@ -434,9 +434,13 @@ 434 434 435 435 == 6.1 Battery Type == 436 436 558 +((( 437 437 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 +))) 438 438 562 +((( 439 439 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 564 +))) 440 440 441 441 442 442 (% 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" %)