Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Mengting Qiu on 2025/07/03 15:42
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 23 removed)
- 1675213652444-622.png
- 1675213661769-223.png
- 1675213675852-577.png
- 1675213686734-883.png
- 1675213704414-644.png
- 1675214845056-885.png
- 1675214856590-846.png
- image-20230201090139-2.png
- image-20230201090139-3.png
- image-20230201090139-4.png
- image-20230201090528-5.png
- image-20230201091027-6.png
- image-20230201091027-7.png
- image-20230201091257-8.png
- image-20230201091257-9.png
- image-20230201091630-10.png
- image-20230201091630-11.png
- image-20230201091954-12.png
- image-20230201091954-13.png
- image-20230201092208-14.png
- image-20230201092208-15.png
- image-20230201092355-16.png
- image-20230201092355-17.png
Details
- Page properties
-
- Content
-
... ... @@ -16,34 +16,36 @@ 16 16 17 17 18 18 19 -= 1. Introduction = 19 +1. Introduction 20 +11. What is LoRaWAN Pressure Sensor 20 20 21 - == 1.1 Whatis SDI-12 to LoRaWAN Converter==22 +The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Convert **designed for Smart Agriculture solution. 22 22 23 23 24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution. 25 - 26 26 SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors. 27 27 27 + 28 28 **SDI-12-LB** has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol. 29 29 30 + 30 30 The LoRa wireless technology used in **SDI-12-LB** allows device 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. 31 31 33 + 32 32 **SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years. 33 33 36 + 34 34 Each **SDI-12-LB** is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 35 35 36 36 37 -[[image:image-20230201084414-1.png||height="464" width="1108"]] 38 38 41 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 39 39 40 40 41 41 42 42 43 43 44 -== 1.2 Features == 45 - 46 - 47 +* 48 +*1. Features 47 47 * LoRaWAN 1.0.3 Class A 48 48 * Ultra-low power consumption 49 49 * Controllable 5v and 12v output to power external sensor ... ... @@ -56,8 +56,9 @@ 56 56 * Downlink to change configure 57 57 * 8500mAh Battery for long term use 58 58 59 -== 1.3 Specification == 60 60 62 +1. 63 +11. Specification 61 61 62 62 **Micro Controller:** 63 63 ... ... @@ -77,6 +77,7 @@ 77 77 * RX sensitivity: down to -139 dBm. 78 78 * Excellent blocking immunity 79 79 83 + 80 80 **Current Input Measuring :** 81 81 82 82 * Range: 0 ~~ 20mA ... ... @@ -83,6 +83,7 @@ 83 83 * Accuracy: 0.02mA 84 84 * Resolution: 0.001mA 85 85 90 + 86 86 **Voltage Input Measuring:** 87 87 88 88 * Range: 0 ~~ 30v ... ... @@ -89,6 +89,7 @@ 89 89 * Accuracy: 0.02v 90 90 * Resolution: 0.001v 91 91 97 + 92 92 **Battery:** 93 93 94 94 * Li/SOCI2 un-chargeable battery ... ... @@ -97,57 +97,68 @@ 97 97 * Max continuously current: 130mA 98 98 * Max boost current: 2A, 1 second 99 99 106 + 100 100 **Power Consumption** 101 101 102 102 * Sleep Mode: 5uA @ 3.3v 103 103 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 104 104 105 -== 1.4 Connect to SDI-12 Sensor == 106 106 113 +1. 114 +11. Connect to SDI-12 Sensor 107 107 116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 108 108 109 -[[image:1675212538524-889.png]] 110 110 111 111 112 -== 1.5 Sleep mode and working mode == 120 +1. 121 +11. Sleep mode and working mode 113 113 114 114 115 -**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.124 +**Deep Sleep Mode: Sensor doesn’t have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.** 116 116 117 -**Working Mode: **In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 118 118 127 +**Working Mode: In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.** 119 119 120 -== 1.6 Button & LEDs == 121 121 122 122 123 -[[image:1675212633011-651.png]] 124 124 125 125 133 +1. 134 +11. Button & LEDs 126 126 127 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 128 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action** 129 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 130 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]] 137 + 138 + 139 + 140 +|**Behavior on ACT**|**Function**|**Action** 141 +|Pressing ACT between 1s < time < 3s|Send an uplink|((( 142 +If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, **blue led** will blink once. 143 + 131 131 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 132 132 ))) 133 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 134 -(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. 135 -(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 146 +|Pressing ACT for more than 3s|Active Device|((( 147 +**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. 148 + 149 +**Green led** will solidly turn on for 5 seconds after joined in network. 150 + 136 136 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network. 137 137 ))) 138 -| (% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red"%)**Redled**(%%)will solid on for 5 seconds. MeansPS-LBisin Deep Sleep Mode.153 +|Fast press ACT 5 times.|Deactivate Device|red led will solid on for 5 seconds. Means SDI-12-LB are in Deep Sleep Mode. 139 139 140 -== 1.7 Pin Mapping == 141 141 142 142 143 -[[image:1675213198663-754.png]] 157 +1. 158 +11. Pin Mapping 144 144 160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 145 145 146 -== 1.8 BLE connection == 162 +1. 163 +11. BLE connection 147 147 148 - 149 149 SDI-12-LB support BLE remote configure. 150 150 167 + 151 151 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: 152 152 153 153 * Press button to send an uplink ... ... @@ -157,34 +157,33 @@ 157 157 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 158 158 159 159 160 -== 1.9 Mechanical == 161 161 162 162 179 +1. 180 +11. Mechanical 163 163 182 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 164 164 184 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 165 165 166 -[[image:image -20230201090139-2.png]]186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 167 167 168 -[[image:image-20230201090139-3.png]] 169 169 170 -[[image:image-20230201090139-4.png]] 171 171 172 172 173 -= 2. Configure SDI-12 to connect to LoRaWAN network = 191 +1. Configure SDI-12 to connect to LoRaWAN network 192 +11. How it works 174 174 175 -== 2.1 How it works == 176 - 177 - 178 178 The SDI-12-LB is configured as **LoRaWAN OTAA Class A** mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes. 179 179 180 180 181 -== 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 197 +1. 198 +11. Quick guide to connect to LoRaWAN server (OTAA) 182 182 183 - 184 184 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example. 185 185 186 186 187 -[[image:image -20230201090528-5.png||height="465" width="1111"]]203 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]] 188 188 189 189 190 190 The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server. ... ... @@ -195,7 +195,7 @@ 195 195 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 196 196 197 197 198 -[[image:image -20230131134744-2.jpeg]]214 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]] 199 199 200 200 201 201 ... ... @@ -206,24 +206,24 @@ 206 206 207 207 **Register the device** 208 208 209 -[[image: 1675213652444-622.png]]225 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] 210 210 211 211 212 212 **Add APP EUI and DEV EUI** 213 213 214 214 215 -[[image: 1675213661769-223.png]]231 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] 216 216 217 217 218 218 **Add APP EUI in the application** 219 219 220 220 221 -[[image: 1675213675852-577.png]]237 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] 222 222 223 223 224 224 **Add APP KEY** 225 225 226 -[[image: 1675213686734-883.png]]242 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 227 227 228 228 229 229 **Step 2**: Activate on SDI-12-LB ... ... @@ -235,100 +235,98 @@ 235 235 **Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network. 236 236 237 237 238 -[[image: 1675213704414-644.png]]254 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] 239 239 240 240 241 -== 2.3 SDI-12 Related Commands == 242 242 243 243 244 -User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 245 245 260 +1. 261 +11. SDI-12 Related Commands 246 246 247 -=== 2.3.1 Basic SDI-12 debug command === 248 248 264 +User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 249 249 250 -User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command. 251 251 252 -If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server. 267 +1. 268 +11. 269 +111. Basic SDI-12 debug command 253 253 254 - Thefollowingisthedisplayinformation onthe serial portandthe server.271 +User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command. 255 255 256 256 274 +If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server. 257 257 258 -[[image:image-20230201091027-6.png]] 259 259 277 +The following is the display information on the serial port and the server. 260 260 261 -[[image:i mage-20230201091027-7.png||height="261" width="1179"]]279 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] 262 262 281 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]] 263 263 264 - ==== **al! ~-~- Get SDI-12 sensor Identification** ====283 +al! ~-~- Get SDI-12 sensor Identification 265 265 266 - 267 267 * AT Command: AT+ADDRI=aa 268 268 * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa 269 269 270 - **Parameter:**aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)288 +Parameter: aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 271 271 272 - **Example :**AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)290 +Example : AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 273 273 274 274 293 + 275 275 The following is the display information on the serial port and the server. 276 276 277 277 278 -[[image:image -20230201091257-8.png]]297 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]] 279 279 299 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]] 280 280 281 -[[image:image-20230201091257-9.png||height="225" width="1242"]] 282 282 302 +aM!,aMC!, aM1!- aM9!, aMC1!- aMC9! 283 283 284 - ==== **aM!,aMC!,aM1!-aM9!, aMC1!-aMC9!**====304 +aM!: Start Non-Concurrent Measurement 285 285 306 +aMC!: Start Non-Concurrent Measurement – Request CRC 286 286 287 - **aM!**:Start Non-ConcurrentMeasurement308 +aM1!- aM9!: Additional Measurements 288 288 289 - **aMC!**:Start Non-ConcurrentMeasurement – Request CRC310 +aMC1!- aMC9!: Additional Measurements – Request CRC 290 290 291 -**aM1!- aM9! **: Additional Measurements 292 292 293 -**aMC1!- aMC9!** : Additional Measurements – Request CRC 294 - 295 - 296 296 * AT Command : AT+ADDRM=0,1,0,1 297 297 * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 298 298 299 299 Downlink:AA 01 aa bb cc dd 300 300 301 - **aa**: SDI-12 sensor address.318 +aa: SDI-12 sensor address. 302 302 303 - **bb**: 0: no CRC, 1: request CRC320 +bb: 0: no CRC, 1: request CRC 304 304 305 - **cc**: 1-9: Additional Measurement, 0: no additional measurement322 +cc: 1-9: Additional Measurement, 0: no additional measurement 306 306 307 - **dd**: delay (in second) to send **aD0!** to get return.324 +dd: delay (in second) to send **aD0!** to get return. 308 308 309 309 310 310 The following is the display information on the serial port and the server. 311 311 329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]] 312 312 313 -[[image:image -20230201091630-10.png]]331 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 314 314 315 315 316 -[[image:image-20230201091630-11.png||height="247" width="1165"]] 317 317 335 +aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! 318 318 337 +aC!: Start Concurrent Measurement 319 319 320 - ==== **aC!, aCC!,aC1!-aC9!,aCC1!-aCC9!**====339 +aCC!: Start Concurrent Measurement – Request CRC 321 321 341 +aC1!- aC9!: Start Additional Concurrent Measurements 322 322 323 - **aC!**: Start Concurrent Measurement343 +aCC1!- aCC9!: Start Additional Concurrent Measurements – Request CRC 324 324 325 -**aCC!** : Start Concurrent Measurement – Request CRC 326 326 327 -**aC1!- aC9!** : Start Additional Concurrent Measurements 328 - 329 -**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC 330 - 331 - 332 332 * AT Command : AT+ADDRC=0,1,0,1 333 333 334 334 * LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01 ... ... @@ -335,29 +335,24 @@ 335 335 336 336 Downlink: AA 02 aa bb cc dd 337 337 338 - **aa**: SDI-12 sensor address.352 +aa: SDI-12 sensor address. 339 339 340 - **bb**: 0: no CRC, 1: request CRC354 +bb: 0: no CRC, 1: request CRC 341 341 342 - **cc**: 1-9: Additional Measurement, 0: no additional measurement356 +cc: 1-9: Additional Measurement, 0: no additional measurement 343 343 344 - **dd**: delay (in second) to send **aD0!** to get return.358 +dd: delay (in second) to send **aD0!** to get return. 345 345 346 346 347 347 The following is the display information on the serial port and the server. 348 348 363 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] 349 349 350 -[[image:image -20230201091954-12.png]]365 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]] 351 351 352 352 353 - [[image:image-20230201091954-13.png||height="203"width="1117"]]368 +aR0!- aR9!, aRC0!- aRC9! 354 354 355 - 356 -(% style="display:none" %) (%%) 357 - 358 -==== **aR0!- aR9!, aRC0!- aRC9!** ==== 359 - 360 - 361 361 Start Continuous Measurement 362 362 363 363 Start Continuous Measurement – Request CRC ... ... @@ -368,48 +368,46 @@ 368 368 369 369 Downlink: AA 03 aa bb cc dd 370 370 371 - **aa**: SDI-12 sensor address.380 +aa: SDI-12 sensor address. 372 372 373 - **bb**: 0: no CRC, 1: request CRC382 +bb: 0: no CRC, 1: request CRC 374 374 375 - **cc**: 1-9: Additional Measurement, 0: no additional measurement384 +cc: 1-9: Additional Measurement, 0: no additional measurement 376 376 377 - **dd**: delay (in second) to send **aD0!** to get return.386 +dd: delay (in second) to send **aD0!** to get return. 378 378 379 379 380 380 The following is the display information on the serial port and the server. 381 381 391 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]] 382 382 393 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]] 383 383 384 -[[image:image-20230201092208-14.png]] 395 +1. 396 +11. 397 +111. Advance SDI-12 Debug command 385 385 386 - 387 -[[image:image-20230201092208-15.png||height="214" width="1140"]] 388 - 389 - 390 -=== 2.3.2 Advance SDI-12 Debug command === 391 - 392 - 393 393 This command can be used to debug all SDI-12 command. 394 394 395 395 396 396 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 397 397 398 - **aa**: total SDI-12 command length404 +(aa: total SDI-12 command length) 399 399 400 - **xx**: SDI-12 command406 +(xx: SDI-12 command) 401 401 402 - **bb**: Delay to wait for return408 +(bb: Delay to wait for return) 403 403 404 - **cc**: 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100410 +(cc: 0: don’t uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100) 405 405 406 406 407 - **Example:**AT+CFGDEV =0RC0!,1413 +Example: AT+CFGDEV =0RC0!,1 408 408 409 - **0RC0!**: SDI-12 Command,415 +0RC0!: SDI-12 Command, 410 410 411 - **1**: Delay 1 second. ( 0: 810 mini-second)417 +1: Delay 1 second. ( 0: 810 mini-second) 412 412 419 + 413 413 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 414 414 415 415 ... ... @@ -416,41 +416,36 @@ 416 416 The following is the display information on the serial port and the server. 417 417 418 418 419 -[[image:image -20230201092355-16.png]]426 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]] 420 420 428 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 421 421 422 -[[image:image-20230201092355-17.png||height="426" width="1135"]] 430 +1. 431 +11. 432 +111. Convert ASCII to String 423 423 424 - 425 - 426 - 427 -=== 2.3.3 Convert ASCII to String === 428 - 429 - 430 430 This command is used to convert between ASCII and String format. 431 431 436 + 432 432 AT+CONVFORM ( Max length: 80 bytes) 433 433 439 +Example: 434 434 435 - **Example:**441 +1)AT+CONVFORM=0,string Convert String from String to ASCII 436 436 437 - 1) AT+CONVFORM=0, stringonvertString fromStringto ASCII443 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]] 438 438 439 -[[image:1675214845056-885.png]] 440 440 446 +2)AT+CONVFORM=1,ASCII Convert ASCII to String. 441 441 442 - 2) AT+CONVFORM=1, ASCII ConvertASCIItoString.448 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]] 443 443 444 -[[image:1675214856590-846.png]] 445 445 446 446 452 +1. 453 +11. 454 +111. Define periodically SDI-12 commands and uplink. 447 447 448 - 449 - 450 - 451 -=== 2.3.4 Define periodically SDI-12 commands and uplink. === 452 - 453 - 454 454 AT+COMMANDx & AT+DATACUTx 455 455 456 456 User can define max 15 SDI-12 Commands (AT+COMMAND1 ~~ AT+COMMANDF). On each uplink period (TDC time, default 20 minutes), SDI-12-LB will send these SDI-12 commands and wait for return from SDI-12 sensors. SDI-12-LB will then combine these returns and uplink via LoRaWAN. ... ... @@ -460,21 +460,21 @@ 460 460 461 461 **AT+COMMANDx=var1,var2,var3,var4.** 462 462 463 - **var1**: SDI-12 command , for example: 0RC0!465 +var1: SDI-12 command , for example: 0RC0! 464 464 465 - **var2**: Wait timeout for return. (unit: second)467 +var2: Wait timeout for return. (unit: second) 466 466 467 - **var3**: Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0!469 +var3: Whether to send //addrD0!// to get return after var2 timeout. 0: Don’t Send //addrD0!//; 1: Send //addrD0!//. 468 468 469 - **var4**: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.471 +var4: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 470 470 471 - **0**No validation check;473 +0 No validation check; 472 472 473 - **1**Check if return chars are printable char(0x20 ~~ 0x7E);475 +1 Check if return chars are printable char(0x20 ~~ 0x7E); 474 474 475 - **2**Check if there is return from SDI-12 sensor477 +2 Check if there is return from SDI-12 sensor 476 476 477 - **3**Check if return pass CRC check ( SDI-12 command var1 must include CRC request);479 +3 Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 478 478 479 479 480 480 Each AT+COMMANDx is followed by a **AT+DATACUT** command. AT+DATACUT command is used to take the useful string from the SDI-12 sensor so the final payload will have the minimum length to uplink. ... ... @@ -482,17 +482,17 @@ 482 482 483 483 **AT+DATACUTx** : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes. 484 484 485 -(% border="1" style="background-color:#f7faff; width:436px" %) 486 -|(% style="width:433px" %)((( 487 +|((( 487 487 AT+DATACUTx=a,b,c 488 488 489 - **a**:490 +a: length for the return of AT+COMMAND 490 490 491 - **b**:492 +b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 492 492 493 - **c**:494 +c: define the position for valid value. 494 494 ))) 495 495 497 + 496 496 For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload: 497 497 498 498 ... ... @@ -501,6 +501,8 @@ 501 501 |34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 502 502 |34,2,1~~34|0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A 503 503 506 + 507 + 504 504 * ** Downlink Payload:** 505 505 506 506 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. ... ... @@ -521,7 +521,7 @@ 521 521 522 522 Example: 523 523 524 -**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 528 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1** 525 525 526 526 **AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10** 527 527 ... ... @@ -618,6 +618,7 @@ 618 618 1. 619 619 11. Uplink Payload 620 620 625 + 621 621 Uplink payloads have two types: 622 622 623 623 * Distance Value: Use FPORT=2 ... ... @@ -640,6 +640,7 @@ 640 640 |**Size (bytes)**|**1**|**2**|**1**|**1**|**2** 641 641 |**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 642 642 648 + 643 643 Example parse in TTNv3 644 644 645 645 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]] ... ... @@ -701,6 +701,7 @@ 701 701 11. 702 702 111. Uplink Payload, FPORT=2 703 703 710 + 704 704 There are different cases for uplink. See below 705 705 706 706 * SDI-12 Debug Command return: FPORT=100 ... ... @@ -707,6 +707,7 @@ 707 707 708 708 * Periodically Uplink: FPORT=2 709 709 717 + 710 710 |((( 711 711 **Size** 712 712 ... ... @@ -724,11 +724,12 @@ 724 724 Payload length in server,server will show payload not provided in the LoRaWAN server. 725 725 ))) 726 726 735 + 727 727 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]] 728 728 729 729 730 730 731 -1. 740 +1. 732 732 11. 733 733 111. Battery Info 734 734 ... ... @@ -761,6 +761,8 @@ 761 761 762 762 763 763 773 + 774 + 764 764 1. 765 765 11. 766 766 111. Decode payload in The Things Network ... ... @@ -1027,6 +1027,7 @@ 1027 1027 Set transmit interval to 60000ms = 60 seconds 1028 1028 ))) 1029 1029 1041 + 1030 1030 **Downlink Command: 0x01** 1031 1031 1032 1032 Format: Command Code (0x01) followed by 3 bytes time value. ... ... @@ -1036,6 +1036,8 @@ 1036 1036 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1037 1037 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1038 1038 1051 + 1052 + 1039 1039 1. 1040 1040 11. Set Interrupt Mode 1041 1041 ... ... @@ -1060,6 +1060,7 @@ 1060 1060 1. (Trigger by rising edge) 1061 1061 )))|OK 1062 1062 1077 + 1063 1063 **Downlink Command: 0x06** 1064 1064 1065 1065 Format: Command Code (0x06) followed by 3 bytes. ... ... @@ -1069,6 +1069,7 @@ 1069 1069 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1070 1070 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1071 1071 1087 + 1072 1072 1. 1073 1073 11. Set the output time 1074 1074 ... ... @@ -1098,6 +1098,7 @@ 1098 1098 1099 1099 ))) 1100 1100 1117 + 1101 1101 **AT Command: AT+5VT** 1102 1102 1103 1103 |**Command Example**|**Function**|**Response** ... ... @@ -1122,6 +1122,7 @@ 1122 1122 1123 1123 ))) 1124 1124 1142 + 1125 1125 **AT Command: AT+12VT** 1126 1126 1127 1127 |**Command Example**|**Function**|**Response** ... ... @@ -1137,6 +1137,7 @@ 1137 1137 1138 1138 ))) 1139 1139 1158 + 1140 1140 **Downlink Command: 0x07** 1141 1141 1142 1142 Format: Command Code (0x07) followed by 3 bytes. ... ... @@ -1150,6 +1150,7 @@ 1150 1150 * Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 1151 1151 * Example 6: Downlink Payload: 07030000 -> AT+12VT=0 1152 1152 1172 + 1153 1153 1. 1154 1154 11. Set the all data mode 1155 1155 ... ... @@ -1166,6 +1166,7 @@ 1166 1166 ))) 1167 1167 |AT+ALLDATAMOD=1|Set all data mode is 1.|OK 1168 1168 1189 + 1169 1169 **Downlink Command: 0xAB** 1170 1170 1171 1171 Format: Command Code (0xAB) followed by 1 bytes. ... ... @@ -1173,6 +1173,7 @@ 1173 1173 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1174 1174 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 1175 1175 1197 + 1176 1176 1. 1177 1177 11. Set the splicing payload for uplink 1178 1178 ... ... @@ -1203,6 +1203,7 @@ 1203 1203 1204 1204 )))|OK 1205 1205 1228 + 1206 1206 **Downlink Command: 0xAD** 1207 1207 1208 1208 Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. ... ... @@ -1230,6 +1230,7 @@ 1230 1230 ))) 1231 1231 |AT+PAYVER=5|Set payload version is 5.|OK 1232 1232 1256 + 1233 1233 **Downlink Command: 0xAE** 1234 1234 1235 1235 Format: Command Code (0xAE) followed by 1 bytes. ... ... @@ -1237,6 +1237,8 @@ 1237 1237 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1238 1238 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1239 1239 1264 + 1265 + 1240 1240 1. Battery & how to replace 1241 1241 11. Battery Type 1242 1242 ... ... @@ -1265,6 +1265,7 @@ 1265 1265 1. 1266 1266 11. Power Consumption Analyze 1267 1267 1294 + 1268 1268 Dragino Battery powered product are all runs in Low Power mode. We have an update 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 interval. 1269 1269 1270 1270 ... ... @@ -1293,6 +1293,8 @@ 1293 1293 * [[Lithium-Thionyl Chloride Battery>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet-EN.pdf]] datasheet, [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet_PM-ER18505-S-02-LF_EN.pdf]] 1294 1294 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]] 1295 1295 1323 + 1324 + 1296 1296 |((( 1297 1297 JST-XH-2P connector 1298 1298 ))) ... ... @@ -1301,7 +1301,7 @@ 1301 1301 1302 1302 1303 1303 1304 -1. 1333 +1. 1305 1305 11. 1306 1306 111. Battery Note 1307 1307 ... ... @@ -1325,6 +1325,7 @@ 1325 1325 1. Remote Configure device 1326 1326 11. Connect via BLE 1327 1327 1357 + 1328 1328 Please see this instruction for how to configure via BLE: 1329 1329 1330 1330 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]] ... ... @@ -1333,6 +1333,8 @@ 1333 1333 1. 1334 1334 11. AT Command Set 1335 1335 1366 + 1367 + 1336 1336 1. OTA firmware update 1337 1337 1338 1338 Please see this link for how to do OTA firmware update. ... ... @@ -1355,6 +1355,7 @@ 1355 1355 1356 1356 * SDI-12-LB SDI-12 to LoRaWAN Converter 1357 1357 1390 + 1358 1358 **Dimension and weight**: 1359 1359 1360 1360 * Device Size: cm ... ... @@ -1364,6 +1364,8 @@ 1364 1364 1365 1365 1366 1366 1400 + 1401 + 1367 1367 1. Support 1368 1368 1369 1369 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
- 1675213652444-622.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.6 KB - Content
- 1675213661769-223.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -53.8 KB - Content
- 1675213675852-577.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -83.1 KB - Content
- 1675213686734-883.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -65.2 KB - Content
- 1675213704414-644.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -50.1 KB - Content
- 1675214845056-885.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -20.4 KB - Content
- 1675214856590-846.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -18.6 KB - Content
- image-20230201090139-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -8.3 KB - Content
- image-20230201090139-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -4.9 KB - Content
- image-20230201090139-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -7.2 KB - Content
- image-20230201090528-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -560.9 KB - Content
- image-20230201091027-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -10.4 KB - Content
- image-20230201091027-7.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -43.7 KB - Content
- image-20230201091257-8.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -15.8 KB - Content
- image-20230201091257-9.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.3 KB - Content
- image-20230201091630-10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -15.1 KB - Content
- image-20230201091630-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -53.1 KB - Content
- image-20230201091954-12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -13.8 KB - Content
- image-20230201091954-13.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.7 KB - Content
- image-20230201092208-14.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -14.3 KB - Content
- image-20230201092208-15.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.6 KB - Content
- image-20230201092355-16.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.6 KB - Content
- image-20230201092355-17.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -80.0 KB - Content