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, 2 removed)
Details
- Page properties
-
- Content
-
... ... @@ -17,45 +17,36 @@ 17 17 18 18 19 19 20 + 20 20 = 1. Introduction = 21 21 22 22 == 1.1 What is SDI-12 to LoRaWAN Converter == 23 23 24 24 25 -((( 26 -The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. 27 -))) 26 +The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. 28 28 29 -((( 30 30 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. 31 -))) 32 32 33 -((( 34 34 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. 35 -))) 36 36 37 -((( 38 38 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. 39 -))) 40 40 41 -((( 42 -SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 43 -))) 34 +SDI-12-LB is powered by **(% style="color:blue" %)8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 44 44 45 -((( 46 46 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. 47 -))) 48 48 49 49 50 50 [[image:image-20230201084414-1.png||height="464" width="1108"]] 51 51 52 52 42 + 43 + 53 53 == 1.2 Features == 54 54 55 55 56 56 * LoRaWAN 1.0.3 Class A 57 57 * Ultra-low power consumption 58 -* Controllable 3.3v,5v and 12v output to power external sensor49 +* Controllable 5v and 12v output to power external sensor 59 59 * SDI-12 Protocol to connect to SDI-12 Sensor 60 60 * Monitor Battery Level 61 61 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 ... ... @@ -66,22 +66,21 @@ 66 66 * 8500mAh Battery for long term use 67 67 68 68 69 - 70 70 == 1.3 Specification == 71 71 72 72 73 -(% style="color:#037691" %) **Micro Controller:**63 +**(% style="color:#037691" %)Micro Controller:** 74 74 75 75 * MCU: 48Mhz ARM 76 76 * Flash: 256KB 77 77 * RAM: 64KB 78 78 79 -(% style="color:#037691" %) **Common DC Characteristics:**69 +**(% style="color:#037691" %)Common DC Characteristics:** 80 80 81 81 * Supply Voltage: 2.5v ~~ 3.6v 82 82 * Operating Temperature: -40 ~~ 85°C 83 83 84 -(% style="color:#037691" %) **LoRa Spec:**74 +**(% style="color:#037691" %)LoRa Spec:** 85 85 86 86 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 87 87 * Max +22 dBm constant RF output vs. ... ... @@ -88,19 +88,19 @@ 88 88 * RX sensitivity: down to -139 dBm. 89 89 * Excellent blocking immunity 90 90 91 -(% style="color:#037691" %) **Current Input Measuring :**81 +**(% style="color:#037691" %)Current Input Measuring :** 92 92 93 93 * Range: 0 ~~ 20mA 94 94 * Accuracy: 0.02mA 95 95 * Resolution: 0.001mA 96 96 97 -(% style="color:#037691" %) **Voltage Input Measuring:**87 +**(% style="color:#037691" %)Voltage Input Measuring:** 98 98 99 99 * Range: 0 ~~ 30v 100 100 * Accuracy: 0.02v 101 101 * Resolution: 0.001v 102 102 103 -(% style="color:#037691" %) **Battery:**93 +**(% style="color:#037691" %)Battery:** 104 104 105 105 * Li/SOCI2 un-chargeable battery 106 106 * Capacity: 8500mAh ... ... @@ -108,13 +108,12 @@ 108 108 * Max continuously current: 130mA 109 109 * Max boost current: 2A, 1 second 110 110 111 -(% style="color:#037691" %) **Power Consumption**101 +**(% style="color:#037691" %)Power Consumption** 112 112 113 113 * Sleep Mode: 5uA @ 3.3v 114 114 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 115 115 116 116 117 - 118 118 == 1.4 Connect to SDI-12 Sensor == 119 119 120 120 ... ... @@ -125,9 +125,9 @@ 125 125 == 1.5 Sleep mode and working mode == 126 126 127 127 128 -(% style="color:blue" %) **Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.117 +**(% style="color:blue" %)Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 129 129 130 -(% style="color:blue" %) **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 +**(% style="color:blue" %)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. 131 131 132 132 133 133 == 1.6 Button & LEDs == ... ... @@ -136,21 +136,21 @@ 136 136 [[image:1675212633011-651.png]] 137 137 138 138 128 + 139 139 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 140 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 1 09px;" %)**Function**|=(% style="width: 231px;" %)**Action**141 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:1 09px" %)Send an uplink|(% style="width:231px" %)(((130 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action** 131 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 142 142 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 143 143 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 144 144 ))) 145 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:1 09px" %)Active Device|(% style="width:231px" %)(((135 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 146 146 (% 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. 147 147 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 148 148 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. 149 149 ))) 150 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:1 09px" %)Deactivate Device|(% style="width:231px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means SDI-12-LB is in Deep Sleep Mode.140 +|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode. 151 151 152 152 153 - 154 154 == 1.7 Pin Mapping == 155 155 156 156 ... ... @@ -186,7 +186,7 @@ 186 186 == 2.1 How it works == 187 187 188 188 189 -The SDI-12-LB is configured as (% style="color:#037691" %) **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.178 +The SDI-12-LB is configured as **(% style="color:#037691" %)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. 190 190 191 191 192 192 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -201,47 +201,51 @@ 201 201 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. 202 202 203 203 204 -(% style="color:blue" %) **Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.193 +**(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB. 205 205 206 206 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 207 207 208 208 209 -[[image:image-20230 201152430-20.jpeg]]198 +[[image:image-20230131134744-2.jpeg]] 210 210 211 211 201 + 202 + 203 + 212 212 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 213 213 214 214 215 -(% style="color:blue" %) **Register the device**207 +**(% style="color:blue" %)Register the device** 216 216 217 217 [[image:1675213652444-622.png]] 218 218 219 219 220 -(% style="color:blue" %) **Add APP EUI and DEV EUI**212 +**(% style="color:blue" %)Add APP EUI and DEV EUI** 221 221 222 222 223 223 [[image:1675213661769-223.png]] 224 224 225 225 226 -(% style="color:blue" %) **Add APP EUI in the application**218 +**(% style="color:blue" %)Add APP EUI in the application** 227 227 228 228 229 229 [[image:1675213675852-577.png]] 230 230 231 231 232 -(% style="color:blue" %) **Add APP KEY**224 +**(% style="color:blue" %)Add APP KEY** 233 233 234 234 [[image:1675213686734-883.png]] 235 235 236 236 237 -(% style="color:blue" %) **Step 2**(%%): Activate on SDI-12-LB229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB 238 238 239 239 240 240 Press the button for 5 seconds to activate the SDI-12-LB. 241 241 242 -(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode** (%%)for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 243 243 235 +**(% style="color:green" %)Green led**(%%) will fast blink 5 times, device will enter **(% style="color:blue" %)OTA mode** (%%)for 3 seconds. And then start to JOIN LoRaWAN network. **(% style="color:green" %)Green led**(%%) will solidly turn on for 5 seconds after joined in network. 244 244 237 + 245 245 [[image:1675213704414-644.png]] 246 246 247 247 ... ... @@ -261,6 +261,7 @@ 261 261 The following is the display information on the serial port and the server. 262 262 263 263 257 + 264 264 [[image:image-20230201091027-6.png]] 265 265 266 266 ... ... @@ -267,16 +267,15 @@ 267 267 [[image:image-20230201091027-7.png||height="261" width="1179"]] 268 268 269 269 264 +==== **(% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification** ==== 270 270 271 -==== (% style="color:blue" %)**al! ~-~- Get SDI-12 sensor Identification**(%%) ==== 272 272 273 - 274 274 * AT Command: AT+ADDRI=aa 275 275 * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa 276 276 277 -(% style="color:#037691" %) **Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)270 +**(% style="color:#037691" %)Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 278 278 279 -(% style="color:blue" %) **Example : **(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)272 +**(% style="color:blue" %)Example : **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 280 280 281 281 282 282 The following is the display information on the serial port and the server. ... ... @@ -288,16 +288,16 @@ 288 288 [[image:image-20230201091257-9.png||height="225" width="1242"]] 289 289 290 290 291 -==== (% style="color:blue" %) **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%)====284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ==== 292 292 293 293 294 -(% style="color:red" %) **aM! **(%%): Start Non-Concurrent Measurement287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement 295 295 296 -(% style="color:red" %) **aMC! **(%%): Start Non-Concurrent Measurement – Request CRC289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC 297 297 298 -(% style="color:red" %) **aM1!- aM9! **(%%): Additional Measurements291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements 299 299 300 -(% style="color:red" %) **aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 301 301 302 302 303 303 * AT Command : AT+ADDRM=0,1,0,1 ... ... @@ -306,13 +306,13 @@ 306 306 307 307 Downlink:AA 01 aa bb cc dd 308 308 309 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 310 310 311 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 312 312 313 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement306 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 314 314 315 -(% style="color:#037691" %) **dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.308 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 316 316 317 317 318 318 The following is the display information on the serial port and the server. ... ... @@ -325,16 +325,16 @@ 325 325 326 326 327 327 328 -==== (% style="color:blue" %) **aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! **(%%)====321 +==== **(% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ==== 329 329 330 330 331 -(% style="color:red" %) **aC!**(%%) : Start Concurrent Measurement324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement 332 332 333 -(% style="color:red" %) **aCC!** (%%): Start Concurrent Measurement – Request CRC326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC 334 334 335 -(% style="color:red" %) **aC1!- aC9!**(%%) : Start Additional Concurrent Measurements328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 336 336 337 -(% style="color:red" %) **aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 338 338 339 339 340 340 * AT Command : AT+ADDRC=0,1,0,1 ... ... @@ -343,13 +343,13 @@ 343 343 344 344 Downlink: AA 02 aa bb cc dd 345 345 346 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 347 347 348 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 349 349 350 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement343 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 351 351 352 -(% style="color:#037691" %) **dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)____to get return.345 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 353 353 354 354 355 355 The following is the display information on the serial port and the server. ... ... @@ -363,7 +363,7 @@ 363 363 364 364 365 365 366 -==== (% style="color:blue" %) **aR0!- aR9!, aRC0!- aRC9!**(%%)====359 +==== **(% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!** ==== 367 367 368 368 369 369 Start Continuous Measurement ... ... @@ -376,18 +376,19 @@ 376 376 377 377 Downlink: AA 03 aa bb cc dd 378 378 379 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 380 380 381 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 382 382 383 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement376 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 384 384 385 -(% style="color:#037691" %) **dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.378 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 386 386 387 387 388 388 The following is the display information on the serial port and the server. 389 389 390 390 384 + 391 391 [[image:image-20230201092208-14.png]] 392 392 393 393 ... ... @@ -402,20 +402,20 @@ 402 402 403 403 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 404 404 405 -(% style="color:#037691" %) **aa **(%%): total SDI-12 command length399 +**(% style="color:#037691" %)aa **(%%): total SDI-12 command length 406 406 407 -(% style="color:#037691" %) **xx **(%%): SDI-12 command401 +**(% style="color:#037691" %)xx **(%%): SDI-12 command 408 408 409 -(% style="color:#037691" %) **bb **(%%): Delay to wait for return403 +**(% style="color:#037691" %)bb **(%%): Delay to wait for return 410 410 411 -(% style="color:#037691" %) **cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100405 +**(% style="color:#037691" %)cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 412 412 413 413 414 -(% style="color:blue" %) **Example: **(%%) AT+CFGDEV =0RC0!,1408 +**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1 415 415 416 -(% style="color:#037691" %) **0RC0! **(%%): SDI-12 Command,410 +**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command, 417 417 418 -(% style="color:#037691" %) **1 **(%%): Delay 1 second. ( 0: 810 mini-second)412 +**(% style="color:#037691" %)1 **(%%): Delay 1 second. ( 0: 810 mini-second) 419 419 420 420 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 421 421 ... ... @@ -437,7 +437,7 @@ 437 437 AT+CONVFORM ( Max length: 80 bytes) 438 438 439 439 440 -(% style="color:blue" %) **Example:**434 +**(% style="color:blue" %)Example:** 441 441 442 442 1) AT+CONVFORM=0, string Convert String from String to ASCII 443 443 ... ... @@ -457,31 +457,31 @@ 457 457 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. 458 458 459 459 460 -* (% style="color:blue" %) **AT Command:**454 +* ** (% style="color:blue" %)AT Command:** 461 461 462 -(% style="color:#037691" %) **AT+COMMANDx=var1,var2,var3,var4.**456 +**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.** 463 463 464 -(% style="color:red" %) **var1**(%%): SDI-12 command , for example: 0RC0!458 +**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0! 465 465 466 -(% style="color:red" %) **var2**(%%): Wait timeout for return. (unit: second)460 +**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second) 467 467 468 -(% style="color:red" %) **var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.462 +**(% style="color:red" %)var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//. 469 469 470 -(% style="color:red" %) **var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max3retries.464 +**(% style="color:red" %)var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 471 471 472 -(% style="color:red" %) **0 **(%%) No validation check;466 +**(% style="color:red" %)0 **(%%) No validation check; 473 473 474 -(% style="color:red" %) **1**468 +**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 475 475 476 -(% style="color:red" %) **2**(%%) Check if there is return from SDI-12 sensor470 +**(% style="color:#red" %)2**(%%) Check if there is return from SDI-12 sensor 477 477 478 -(% style="color:red" %) **3**472 +**(% style="color:red" %)3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 479 479 480 480 481 -Each AT+COMMANDx is followed by a (% style="color:blue" %) **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.475 +Each AT+COMMANDx is followed by a **(% style="color:blue" %)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 482 483 483 484 -(% style="color:blue" %) **AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.478 +**(% style="color:blue" %)AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes. 485 485 486 486 (% border="1" style="background-color:#f7faff; width:436px" %) 487 487 |(% style="width:433px" %)((( ... ... @@ -494,59 +494,58 @@ 494 494 **c**: define the position for valid value. 495 495 ))) 496 496 497 -For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895 <CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:491 +For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload: 498 498 499 499 500 500 (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 501 -| =(% style="width:64px;" %)**AT+DATACUT1 value**|=(% style="width:44px;" %)**Final Result to combine Payload**502 -|(% style="width:1 64px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33503 -|(% style="width:1 64px" %)34,2,1~~8+12~~16|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32504 -|(% style="width:1 64px" %)34,2,1~~34|(% style="width:344px" %)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 0A495 +|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload** 496 +|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33 497 +|(% style="width:170px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 498 +|(% style="width:170px" %)34,2,1~~34|(% style="width:338px" %)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 505 505 506 -* (% style="color:blue" %) **Downlink Payload:**500 +* **(% style="color:blue" %) Downlink Payload:** 507 507 508 -(% style="color:blue" %) **0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.502 +**(% style="color:blue" %)0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 509 509 510 510 511 -(% style="color:red" %) **Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**505 +**(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.** 512 512 513 513 514 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY (%%)**508 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY** 515 515 516 516 Where: 517 517 518 -* (% style="color:#037691" %) **MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,519 -* (% style="color:#037691" %) **NN **(%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.520 -* (% style="color:#037691" %) **LL **(%%): The length of AT+COMMAND or AT+DATACUT command521 -* (% style="color:#037691" %) **XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command522 -* (% style="color:#037691" %) **YY **(%%): If YY=0, SDI-12-LBwill execute the downlink command without uplink; if YY=1, SDI-12-LBwill execute an uplink after got this command.512 +* **(% style="color:#037691" %)MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 513 +* **(% style="color:#037691" %)NN **(%%): 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value. 514 +* **(% style="color:#037691" %)LL **(%%): The length of AT+COMMAND or AT+DATACUT command 515 +* **(% style="color:#037691" %)XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command 516 +* **(% style="color:#037691" %)YY **(%%): If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 523 523 524 -(% style="color:blue" %) **Example:**518 +**(% style="color:blue" %)Example:** 525 525 526 526 [[image:image-20230201094129-18.png]] 527 527 528 528 523 +**(% style="color:blue" %)Clear SDI12 Command** 529 529 530 -(% style="color:blue" %)**Clear SDI12 Command** 531 - 532 532 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 533 533 534 534 535 -* (% style="color:#037691" %) **AT Command:**528 +* ** (% style="color:#037691" %)AT Command:** 536 536 537 -(% style="color:#4 f81bd" %)**AT+CMDEAR=mm,nn**530 +**(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase 538 538 539 539 540 540 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 541 541 542 542 543 -* (% style="color:#037691" %) **Downlink Payload:**536 +* **(% style="color:#037691" %) Downlink Payload:** 544 544 545 -(% style="color:#4 f81bd" %)**0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb538 +**(% style="color:#4F81BD" %)0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb 546 546 547 547 548 548 549 -(% style="color:blue" %) **command combination**542 +**(% style="color:blue" %)command combination** 550 550 551 551 Below shows a screen shot how the results combines together to a uplink payload. 552 552 ... ... @@ -555,27 +555,28 @@ 555 555 556 556 If user don't want to use DATACUT for some command, he simply want to uplink all returns. AT+ALLDATAMOD can be set to 1. 557 557 558 -(% style="color:blue" %) **AT+ALLDATAMOD**(%%) will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.551 +**(% style="color:blue" %)AT+ALLDATAMOD**(%%) will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command. 559 559 560 560 561 -(% style="color:#4 f81bd" %)**For example: **(%%)as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.554 +**(% style="color:#4F81BD" %)For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result. 562 562 563 563 564 564 [[image:1675215782925-448.png]] 565 565 566 566 567 -If AT+ALLDATAMOD=1, (% style="color:#4 f81bd" %)**FX,X**(%%) will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes.560 +If AT+ALLDATAMOD=1, **(% style="color:#4F81BD" %)FX,X**(%%) will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes. 568 568 569 569 570 570 571 -(% style="color:blue" %) **Compose Uplink**564 +**(% style="color:blue" %)Compose Uplink** 572 572 573 -(% style="color:#4f81bd" %)**AT+DATAUP=0** 574 574 575 - Composethe uplink payload with valuereturnsin sequence and send with **__ASIGNLEUPLINK__**.567 +**(% style="color:#4F81BD" %)AT+DATAUP=0** 576 576 577 - FinalPayload is **__BatteryInfo+PAYVER + VALID ValuefromRETURN1+ValidValuefromRETURN2+ … + RETURNx__**569 +Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 578 578 571 +Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx 572 + 579 579 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 580 580 581 581 ... ... @@ -582,12 +582,14 @@ 582 582 [[image:1675215828102-844.png]] 583 583 584 584 585 -(% style="color:#4 f81bd" %)**AT+DATAUP=1**579 +**(% style="color:#4F81BD" %)AT+DATAUP=1** 586 586 587 -Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.581 +Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 588 588 589 -Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__583 +Final Payload is 590 590 585 +__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ 586 + 591 591 1. Battery Info (2 bytes): Battery voltage 592 592 1. PAYVER (1 byte): Defined by AT+PAYVER 593 593 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. ... ... @@ -597,7 +597,7 @@ 597 597 [[image:1675215848113-696.png]] 598 598 599 599 600 -(% style="color:red" %) **Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**596 +**(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** 601 601 602 602 * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 603 603 * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). ... ... @@ -604,13 +604,22 @@ 604 604 * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 605 605 * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 606 606 607 -(% style="color:red" %) **When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**603 +**(% style="color:red" %)When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;** 608 608 609 -(% style="color:red" %) **When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**605 +**(% style="color:red" %)When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.** 610 610 611 611 612 -== 2.4 Uplink Payload == 608 +== 2.4 Uplink Payload == 613 613 610 + 611 +Uplink payloads have two types: 612 + 613 +* Distance Value: Use FPORT=2 614 +* Other control commands: Use other FPORT fields. 615 + 616 +The application server should parse the correct value based on FPORT settings. 617 + 618 + 614 614 === 2.4.1 Device Payload, FPORT~=5 === 615 615 616 616 ... ... @@ -618,10 +618,10 @@ 618 618 619 619 Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink. 620 620 621 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:4 20px" %)626 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %) 622 622 |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)** 623 -|(% style="width:1 14px" %)**Size(bytes)**|(% style="width:39px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:59px" %)**1**|(% style="width:37px" %)**2**624 -|(% style="width:1 14px" %)**Value**|(% style="width:39px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:59px" %)Sub-band|(% style="width:37px" %)BAT628 +|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2** 629 +|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT 625 625 626 626 Example parse in TTNv3 627 627 ... ... @@ -628,11 +628,11 @@ 628 628 [[image:1675215946738-635.png]] 629 629 630 630 631 -(% style="color:#037691" %) **Sensor Model**(%%): For SDI-12-LB, this value is 0x17636 +**(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17 632 632 633 -(% style="color:#037691" %) **Firmware Version**(%%): 0x0100, Means: v1.0.0 version638 +**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version 634 634 635 -(% style="color:#037691" %) **Frequency Band**:640 +**(% style="color:#037691" %)Frequency Band**: 636 636 637 637 *0x01: EU868 638 638 ... ... @@ -663,7 +663,7 @@ 663 663 *0x0e: MA869 664 664 665 665 666 -(% style="color:#037691" %) **Sub-Band**:671 +**(% style="color:#037691" %)Sub-Band**: 667 667 668 668 AU915 and US915:value 0x00 ~~ 0x08 669 669 ... ... @@ -672,7 +672,7 @@ 672 672 Other Bands: Always 0x00 673 673 674 674 675 -(% style="color:#037691" %) **Battery Info**:680 +**(% style="color:#037691" %)Battery Info**: 676 676 677 677 Check the battery voltage. 678 678 ... ... @@ -690,15 +690,15 @@ 690 690 691 691 * Periodically Uplink: FPORT=2 692 692 693 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:50 0px" %)694 -| =(% style="width:0px;" %)(((698 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 699 +|(% style="width:93px" %)((( 695 695 **Size(bytes)** 696 -)))| =(% style="width:0px;" %)**2**|=(% style="width:90px;" %)**1**|=(% style="width:0px;" %)**Length depends on the return from the commands**701 +)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands** 697 697 |(% style="width:93px" %)**Value**|(% style="width:83px" %)((( 698 698 Battery(mV) 699 699 & 700 700 Interrupt_Flag 701 -)))|(% style="width: 91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((706 +)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)((( 702 702 If the valid payload is too long and exceed the maximum support. 703 703 Payload length in server,server will show payload not provided in the LoRaWAN server. 704 704 ))) ... ... @@ -719,7 +719,7 @@ 719 719 === 2.4.4 Interrupt Pin === 720 720 721 721 722 -This data field shows if this packet is generated by (% style="color:#037691" %) **Interrupt Pin**(%%) or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.7PinMapping"]].727 +This data field shows if this packet is generated by **(% style="color:#037691" %)Interrupt Pin**(%%) or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.7PinMapping"]]. 723 723 724 724 **Example:** 725 725 ... ... @@ -730,7 +730,6 @@ 730 730 731 731 === 2.4.5 Payload version === 732 732 733 -The version number of the payload, mainly used for decoding. The default is 01. 734 734 735 735 736 736 === 2.4.6 Decode payload in The Things Network === ... ... @@ -751,91 +751,26 @@ 751 751 752 752 The SDI-12-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: 753 753 754 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]] 758 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]] 755 755 756 756 757 -== 2.6 Examples To Set SDI commands. == 758 758 759 -=== 2.6.1 Examples 1 === 760 760 763 +== 2.6 Frequency Plans == 761 761 762 -COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication. 763 763 764 -[[image:image-20230222143809-1.png||height="564" width="729"]] 765 - 766 - 767 -(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:** 768 - 769 -a. Send the first command and get the first reply: 770 - 771 -(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1** 772 - 773 -b. Send the second command and get the second reply: 774 - 775 -(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1** 776 - 777 -c. Send the third command and get the third reply: 778 - 779 -(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1** 780 - 781 -d. Send the fourth command and get the fourth reply: 782 - 783 -(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1** 784 - 785 -e. Send the fifth command plus the sixth command, get the sixth reply: 786 - 787 -(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1** 788 - 789 -f. Send the seventh command plus the eighth command, get the eighth reply: 790 - 791 -(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1** 792 - 793 -g. Send the ninth command plus the tenth command, get the tenth reply: 794 - 795 -(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1** 796 - 797 -h. Send the eleventh command plus the twelfth command, get the twelfth reply: 798 - 799 -(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1** 800 - 801 - 802 -(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:** 803 - 804 -a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>” 805 - 806 -Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**; 807 - 808 -b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>” 809 - 810 -Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**; 811 - 812 -c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>” 813 - 814 -Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**; 815 - 816 -d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>” 817 - 818 -Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**; 819 - 820 -e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>” 821 - 822 -Partial cut, the cut sensor address and the first two parameters:(% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”**. 823 - 824 - 825 -== 2.7 Frequency Plans == 826 - 827 - 828 828 The SDI-12-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets. 829 829 830 830 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 831 831 832 832 833 -== 2.8 Firmware Change Log == 834 834 772 +== 2.7 Firmware Change Log == 835 835 774 + 836 836 **Firmware download link:** 837 837 838 -[[https:~~/~~/www.dropbox.com/sh/ qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]777 +[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]] 839 839 840 840 841 841 = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = ... ... @@ -843,12 +843,12 @@ 843 843 844 844 Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. 845 845 846 -* AT Command Connection: See [[FAQ>> ||anchor="H7.FAQ"]].785 +* AT Command Connection: See [[FAQ>>path:#AT_COMMAND]]. 847 847 * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 848 848 849 849 There are two kinds of commands to configure SDI-12-LB, they are: 850 850 851 -* (% style="color:blue" %)**General Commands**.790 +* **General Commands**. 852 852 853 853 These commands are to configure: 854 854 ... ... @@ -857,15 +857,15 @@ 857 857 858 858 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 859 859 860 -[[http:~~/~~/wiki.dragino.com/ xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]799 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]] 861 861 862 862 863 -* (% style="color:blue" %)**Commands special design for SDI-12-LB**802 +* **Commands special design for SDI-12-LB** 864 864 865 865 These commands only valid for SDI-12-LB, as below: 866 866 867 867 868 -== 3.1 Set Transmit Interval Time == 807 +== 3.1 Set Transmit Interval Time == 869 869 870 870 871 871 Feature: Change LoRaWAN End Node Transmit Interval. ... ... @@ -894,8 +894,6 @@ 894 894 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 895 895 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 896 896 897 - 898 - 899 899 == 3.2 Set Interrupt Mode == 900 900 901 901 ... ... @@ -908,14 +908,14 @@ 908 908 |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)((( 909 909 0 910 910 OK 911 -the mode is 0 = DisableInterrupt848 +the mode is 0 = No interruption 912 912 ))) 913 913 |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)((( 914 914 Set Transmit Interval 915 - 0. (Disable Interrupt),916 - ~1. (Trigger by rising and falling edge)917 - 2. (Trigger by falling edge)918 - 3. (Trigger by rising edge)852 +~1. (Disable Interrupt), 853 +2. (Trigger by rising and falling edge) 854 +3. (Trigger by falling edge) 855 +4. (Trigger by rising edge) 919 919 )))|(% style="width:165px" %)OK 920 920 921 921 (% style="color:blue" %)**Downlink Command: 0x06** ... ... @@ -927,8 +927,6 @@ 927 927 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 928 928 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 929 929 930 - 931 - 932 932 == 3.3 Set the output time == 933 933 934 934 ... ... @@ -998,8 +998,6 @@ 998 998 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 999 999 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 1000 1000 1001 - 1002 - 1003 1003 == 3.4 Set the all data mode == 1004 1004 1005 1005 ... ... @@ -1022,8 +1022,6 @@ 1022 1022 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1023 1023 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 1024 1024 1025 - 1026 - 1027 1027 == 3.5 Set the splicing payload for uplink == 1028 1028 1029 1029 ... ... @@ -1060,7 +1060,6 @@ 1060 1060 1061 1061 == 3.6 Set the payload version == 1062 1062 1063 - 1064 1064 Feature, Set the payload version. 1065 1065 1066 1066 (% style="color:blue" %)**AT Command: AT+PAYVER** ... ... @@ -1080,8 +1080,6 @@ 1080 1080 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1081 1081 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1082 1082 1083 - 1084 - 1085 1085 = 4. Battery & how to replace = 1086 1086 1087 1087 == 4.1 Battery Type == ... ... @@ -1092,7 +1092,7 @@ 1092 1092 1093 1093 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1094 1094 1095 -[[image:1675 234124233-857.png]]1023 +[[image:1675146710956-626.png]] 1096 1096 1097 1097 1098 1098 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1125,10 +1125,9 @@ 1125 1125 1126 1126 And the Life expectation in difference case will be shown on the right. 1127 1127 1056 +[[image:1675146895108-304.png]] 1128 1128 1129 -[[image:1675234155374-163.png]] 1130 1130 1131 - 1132 1132 The battery related documents as below: 1133 1133 1134 1134 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]], ... ... @@ -1135,7 +1135,7 @@ 1135 1135 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1136 1136 * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]] 1137 1137 1138 -[[image:image-20230 201145019-19.png]]1065 +[[image:image-20230131145708-3.png]] 1139 1139 1140 1140 1141 1141 === 4.3.1 Battery Note === ... ... @@ -1152,6 +1152,7 @@ 1152 1152 The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes) 1153 1153 1154 1154 1082 + 1155 1155 = 5. Remote Configure device = 1156 1156 1157 1157 == 5.1 Connect via BLE == ... ... @@ -1172,58 +1172,36 @@ 1172 1172 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]] 1173 1173 1174 1174 1175 -= 7. FAQ = 1176 1176 1177 -= =7.1How to useAT Command toaccess device?==1104 += 7. Order Info = 1178 1178 1179 1179 1180 -See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]] 1107 +Part Number: SDI-12-LB-XXX 1108 +XXX: The default frequency band 1181 1181 1110 +AS923: LoRaWAN AS923 band 1111 +AU915: LoRaWAN AU915 band 1112 +EU433: LoRaWAN EU433 band 1113 +EU868: LoRaWAN EU868 band 1114 +KR920: LoRaWAN KR920 band 1115 +US915: LoRaWAN US915 band 1116 +IN865: LoRaWAN IN865 band 1117 +CN470: LoRaWAN CN470 band 1182 1182 1183 -== 7.2 How to update firmware via UART port? == 1184 1184 1185 1185 1186 -See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]] 1187 1187 1188 1188 1189 -== 7.3 How to change the LoRa Frequency Bands/Region? == 1190 1190 1191 1191 1192 -You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1193 -When downloading the images, choose the required image file for download. 1125 += 8. Packing Info = 1194 1194 1195 1195 1196 - = 8. OrderInfo =1128 +**Package Includes**: 1197 1197 1198 - 1199 -((( 1200 -(% style="color:blue" %)**Part Number: SDI-12-LB-XXX** 1201 -))) 1202 - 1203 -((( 1204 -XXX: The default frequency band 1205 -))) 1206 - 1207 -((( 1208 -(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 1209 -(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 1210 -(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 1211 -(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 1212 -(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 1213 -(% style="color:red" %)**US915**(%%): LoRaWAN US915 band 1214 -(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1215 -(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1216 -))) 1217 - 1218 - 1219 -= 9. Packing Info = 1220 - 1221 - 1222 -(% style="color:#037691" %)**Package Includes**: 1223 - 1224 1224 * SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1225 1225 1226 - (% style="color:#037691" %)**Dimension and weight**:1132 +**Dimension and weight**: 1227 1227 1228 1228 * Device Size: cm 1229 1229 * Device Weight: g ... ... @@ -1230,11 +1230,9 @@ 1230 1230 * Package Size / pcs : cm 1231 1231 * Weight / pcs : g 1232 1232 1139 += 9. Support = 1233 1233 1234 1234 1235 -= 10. Support = 1236 - 1237 - 1238 1238 * 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. 1239 1239 1240 1240 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
- image-20230201152430-20.jpeg
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -16.5 KB - Content
- image-20230222143809-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -322.1 KB - Content