Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Xiaoling on 2025/04/25 08:58
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -3,6 +3,7 @@ 3 3 4 4 **Table of Contents:** 5 5 6 +{{toc/}} 6 6 7 7 8 8 ... ... @@ -16,22 +16,23 @@ 16 16 17 17 18 18 20 + 19 19 = 1. Introduction = 20 20 21 21 == 1.1 What is SDI-12 to LoRaWAN Converter == 22 22 23 23 24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution. 26 +The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. 25 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 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.30 +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 -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.32 +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 32 - **SDI-12-LB**is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.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. 33 33 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.36 +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 37 [[image:image-20230201084414-1.png||height="464" width="1108"]] ... ... @@ -39,8 +39,6 @@ 39 39 40 40 41 41 42 - 43 - 44 44 == 1.2 Features == 45 45 46 46 ... ... @@ -56,21 +56,22 @@ 56 56 * Downlink to change configure 57 57 * 8500mAh Battery for long term use 58 58 59 + 59 59 == 1.3 Specification == 60 60 61 61 62 -**Micro Controller:** 63 +**(% style="color:#037691" %)Micro Controller:** 63 63 64 64 * MCU: 48Mhz ARM 65 65 * Flash: 256KB 66 66 * RAM: 64KB 67 67 68 -**Common DC Characteristics:** 69 +**(% style="color:#037691" %)Common DC Characteristics:** 69 69 70 70 * Supply Voltage: 2.5v ~~ 3.6v 71 71 * Operating Temperature: -40 ~~ 85°C 72 72 73 -**LoRa Spec:** 74 +**(% style="color:#037691" %)LoRa Spec:** 74 74 75 75 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 76 76 * Max +22 dBm constant RF output vs. ... ... @@ -77,19 +77,19 @@ 77 77 * RX sensitivity: down to -139 dBm. 78 78 * Excellent blocking immunity 79 79 80 -**Current Input Measuring :** 81 +**(% style="color:#037691" %)Current Input Measuring :** 81 81 82 82 * Range: 0 ~~ 20mA 83 83 * Accuracy: 0.02mA 84 84 * Resolution: 0.001mA 85 85 86 -**Voltage Input Measuring:** 87 +**(% style="color:#037691" %)Voltage Input Measuring:** 87 87 88 88 * Range: 0 ~~ 30v 89 89 * Accuracy: 0.02v 90 90 * Resolution: 0.001v 91 91 92 -**Battery:** 93 +**(% style="color:#037691" %)Battery:** 93 93 94 94 * Li/SOCI2 un-chargeable battery 95 95 * Capacity: 8500mAh ... ... @@ -97,11 +97,12 @@ 97 97 * Max continuously current: 130mA 98 98 * Max boost current: 2A, 1 second 99 99 100 -**Power Consumption** 101 +**(% style="color:#037691" %)Power Consumption** 101 101 102 102 * Sleep Mode: 5uA @ 3.3v 103 103 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 104 104 106 + 105 105 == 1.4 Connect to SDI-12 Sensor == 106 106 107 107 ... ... @@ -112,9 +112,9 @@ 112 112 == 1.5 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. 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. 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. 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. 118 118 119 119 120 120 == 1.6 Button & LEDs == ... ... @@ -137,6 +137,7 @@ 137 137 ))) 138 138 |(% 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. 139 139 142 + 140 140 == 1.7 Pin Mapping == 141 141 142 142 ... ... @@ -160,9 +160,6 @@ 160 160 == 1.9 Mechanical == 161 161 162 162 163 - 164 - 165 - 166 166 [[image:image-20230201090139-2.png]] 167 167 168 168 [[image:image-20230201090139-3.png]] ... ... @@ -175,7 +175,7 @@ 175 175 == 2.1 How it works == 176 176 177 177 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. 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. 179 179 180 180 181 181 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -190,7 +190,7 @@ 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. 191 191 192 192 193 -**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. 194 194 195 195 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 196 196 ... ... @@ -204,35 +204,35 @@ 204 204 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 205 205 206 206 207 -**Register the device** 207 +**(% style="color:blue" %)Register the device** 208 208 209 209 [[image:1675213652444-622.png]] 210 210 211 211 212 -**Add APP EUI and DEV EUI** 212 +**(% style="color:blue" %)Add APP EUI and DEV EUI** 213 213 214 214 215 215 [[image:1675213661769-223.png]] 216 216 217 217 218 -**Add APP EUI in the application** 218 +**(% style="color:blue" %)Add APP EUI in the application** 219 219 220 220 221 221 [[image:1675213675852-577.png]] 222 222 223 223 224 -**Add APP KEY** 224 +**(% style="color:blue" %)Add APP KEY** 225 225 226 226 [[image:1675213686734-883.png]] 227 227 228 228 229 -**Step 2**: Activate on SDI-12-LB 229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB 230 230 231 231 232 232 Press the button for 5 seconds to activate the SDI-12-LB. 233 233 234 234 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. 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. 236 236 237 237 238 238 [[image:1675213704414-644.png]] ... ... @@ -261,15 +261,15 @@ 261 261 [[image:image-20230201091027-7.png||height="261" width="1179"]] 262 262 263 263 264 -==== **al! ~-~- Get SDI-12 sensor Identification** ==== 264 +==== **(% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification** ==== 265 265 266 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) 270 +**(% style="color:#037691" %)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) 272 +**(% style="color:blue" %)Example : **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 273 273 274 274 275 275 The following is the display information on the serial port and the server. ... ... @@ -281,30 +281,31 @@ 281 281 [[image:image-20230201091257-9.png||height="225" width="1242"]] 282 282 283 283 284 -==== **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ==== 284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ==== 285 285 286 286 287 -**aM! **: Start Non-Concurrent Measurement 287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement 288 288 289 -**aMC! **: Start Non-Concurrent Measurement – Request CRC 289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC 290 290 291 -**aM1!- aM9! **: Additional Measurements 291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements 292 292 293 -**aMC1!- aMC9!** : Additional Measurements – Request CRC 293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 294 294 295 295 296 296 * AT Command : AT+ADDRM=0,1,0,1 297 + 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. 302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 302 302 303 -**bb**: 0: no CRC, 1: request CRC 304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 304 304 305 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 306 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 306 306 307 -**dd**: delay (in second) to send **aD0!** to get return. 308 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 308 308 309 309 310 310 The following is the display information on the serial port and the server. ... ... @@ -317,16 +317,16 @@ 317 317 318 318 319 319 320 -==== **aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ==== 321 +==== **(% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ==== 321 321 322 322 323 -**aC!** : Start Concurrent Measurement 324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement 324 324 325 -**aCC!** : Start Concurrent Measurement – Request CRC 326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC 326 326 327 -**aC1!- aC9!** : Start Additional Concurrent Measurements 328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 328 328 329 -**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC 330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 330 330 331 331 332 332 * AT Command : AT+ADDRC=0,1,0,1 ... ... @@ -335,13 +335,13 @@ 335 335 336 336 Downlink: AA 02 aa bb cc dd 337 337 338 -**aa**: SDI-12 sensor address. 339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 339 339 340 -**bb**: 0: no CRC, 1: request CRC 341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 341 341 342 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 343 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 343 343 344 -**dd**: delay (in second) to send **aD0!** to get return. 345 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 345 345 346 346 347 347 The following is the display information on the serial port and the server. ... ... @@ -353,11 +353,11 @@ 353 353 [[image:image-20230201091954-13.png||height="203" width="1117"]] 354 354 355 355 356 -(% style="display:none" %) (%%) 357 357 358 -==== **aR0!- aR9!, aRC0!- aRC9!** ==== 359 359 359 +==== **(% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!** ==== 360 360 361 + 361 361 Start Continuous Measurement 362 362 363 363 Start Continuous Measurement – Request CRC ... ... @@ -368,13 +368,13 @@ 368 368 369 369 Downlink: AA 03 aa bb cc dd 370 370 371 -**aa**: SDI-12 sensor address. 372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 372 372 373 -**bb**: 0: no CRC, 1: request CRC 374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 374 374 375 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 376 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 376 376 377 -**dd**: delay (in second) to send **aD0!** to get return. 378 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return. 378 378 379 379 380 380 The following is the display information on the serial port and the server. ... ... @@ -395,20 +395,20 @@ 395 395 396 396 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 397 397 398 -**aa **: total SDI-12 command length 399 +**(% style="color:#037691" %)aa **(%%): total SDI-12 command length 399 399 400 -**xx **: SDI-12 command 401 +**(% style="color:#037691" %)xx **(%%): SDI-12 command 401 401 402 -**bb **: Delay to wait for return 403 +**(% style="color:#037691" %)bb **(%%): Delay to wait for return 403 403 404 -**cc **: 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 405 +**(% style="color:#037691" %)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!,1 408 +**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1 408 408 409 -**0RC0! **: SDI-12 Command, 410 +**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command, 410 410 411 -**1 **: Delay 1 second. ( 0: 810 mini-second) 412 +**(% style="color:#037691" %)1 **(%%): Delay 1 second. ( 0: 810 mini-second) 412 412 413 413 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 414 414 ... ... @@ -419,9 +419,8 @@ 419 419 [[image:image-20230201092355-16.png]] 420 420 421 421 422 - [[image:image-20230201092355-17.png||height="426" width="1135"]]423 +[[image:image-20230201092355-17.png||height="426" width="1135"]] 423 423 424 - 425 425 426 426 === 2.3.3 Convert ASCII to String === 427 427 ... ... @@ -431,7 +431,7 @@ 431 431 AT+CONVFORM ( Max length: 80 bytes) 432 432 433 433 434 -**Example:** 434 +**(% style="color:blue" %)Example:** 435 435 436 436 1) AT+CONVFORM=0, string Convert String from String to ASCII 437 437 ... ... @@ -442,7 +442,6 @@ 442 442 443 443 [[image:1675214856590-846.png]] 444 444 445 - 446 446 447 447 === 2.3.4 Define periodically SDI-12 commands and uplink. === 448 448 ... ... @@ -452,31 +452,31 @@ 452 452 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. 453 453 454 454 455 -* ** AT Command:** 454 +* ** (% style="color:blue" %)AT Command:** 456 456 457 -**AT+COMMANDx=var1,var2,var3,var4.** 456 +**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.** 458 458 459 -**var1**: SDI-12 command , for example: 0RC0! 458 +**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0! 460 460 461 -**var2**: Wait timeout for return. (unit: second) 460 +**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second) 462 462 463 -**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!//. 464 464 465 -**var4**: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 464 +**(% style="color:red" %)var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 466 466 467 -**0 ** No validation check; 466 +**(% style="color:red" %)0 **(%%) No validation check; 468 468 469 -**1** Check if return chars are printable char(0x20 ~~ 0x7E); 468 +**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 470 470 471 -**2** Check if there is return from SDI-12 sensor 470 +**(% style="color:#red" %)2**(%%) Check if there is return from SDI-12 sensor 472 472 473 -**3** Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 472 +**(% style="color:red" %)3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 474 474 475 475 476 -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. 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. 477 477 478 478 479 -**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. 480 480 481 481 (% border="1" style="background-color:#f7faff; width:436px" %) 482 482 |(% style="width:433px" %)((( ... ... @@ -484,7 +484,7 @@ 484 484 485 485 **a**: length for the return of AT+COMMAND 486 486 487 -**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 486 +**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 488 488 489 489 **c**: define the position for valid value. 490 490 ))) ... ... @@ -498,49 +498,49 @@ 498 498 |(% 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 499 499 |(% 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 500 500 501 -* ** Downlink Payload:** 500 +* **(% style="color:blue" %) Downlink Payload:** 502 502 503 -**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. 504 504 505 505 506 -**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.** 507 507 508 508 509 -Format: ** AF MM NN LL XX XX XX XX YY** 508 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY** 510 510 511 511 Where: 512 512 513 -* **MM **: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 514 -* **NN **: 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value. 515 -* **LL **: The length of AT+COMMAND or AT+DATACUT command 516 -* **XX XX XX XX **: AT+COMMAND or AT+DATACUT command 517 -* **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. 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. 518 518 519 -**Example:** 518 +**(% style="color:blue" %)Example:** 520 520 521 521 [[image:image-20230201094129-18.png]] 522 522 523 523 524 -**Clear SDI12 Command** 523 +**(% style="color:blue" %)Clear SDI12 Command** 525 525 526 526 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 527 527 528 528 529 -* ** AT Command:** 528 +* ** (% style="color:#037691" %)AT Command:** 530 530 531 -** ~AT+CMDEAR=mm,nn** mm: start position of erase ,nn: stop position of erase530 +**(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase 532 532 533 533 534 534 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 535 535 536 536 537 -* ** Downlink Payload:** 536 +* **(% style="color:#037691" %) Downlink Payload:** 538 538 539 -** ~0x09 aa bb** same as AT+CMDEAR=aa,bb538 +**(% style="color:#4F81BD" %)0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb 540 540 541 541 542 542 543 -**command combination** 542 +**(% style="color:blue" %)command combination** 544 544 545 545 Below shows a screen shot how the results combines together to a uplink payload. 546 546 ... ... @@ -549,23 +549,23 @@ 549 549 550 550 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. 551 551 552 -**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. 553 553 554 554 555 -**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. 556 556 557 557 558 558 [[image:1675215782925-448.png]] 559 559 560 560 561 -If AT+ALLDATAMOD=1, **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. 562 562 563 563 564 564 565 -**Compose Uplink** 564 +**(% style="color:blue" %)Compose Uplink** 566 566 567 567 568 -**AT+DATAUP=0** 567 +**(% style="color:#4F81BD" %)AT+DATAUP=0** 569 569 570 570 Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 571 571 ... ... @@ -577,7 +577,7 @@ 577 577 [[image:1675215828102-844.png]] 578 578 579 579 580 -**AT+DATAUP=1** 579 +**(% style="color:#4F81BD" %)AT+DATAUP=1** 581 581 582 582 Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 583 583 ... ... @@ -594,7 +594,7 @@ 594 594 [[image:1675215848113-696.png]] 595 595 596 596 597 -**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:** 598 598 599 599 * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 600 600 * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). ... ... @@ -601,9 +601,9 @@ 601 601 * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 602 602 * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 603 603 604 -** ~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;** 605 605 606 -** ~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.** 607 607 608 608 609 609 == 2.4 Uplink Payload == ... ... @@ -634,11 +634,11 @@ 634 634 [[image:1675215946738-635.png]] 635 635 636 636 637 -**Sensor Model**: For SDI-12-LB, this value is 0x17 636 +**(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17 638 638 639 -**Firmware Version**: 0x0100, Means: v1.0.0 version 638 +**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version 640 640 641 -**Frequency Band**: 640 +**(% style="color:#037691" %)Frequency Band**: 642 642 643 643 *0x01: EU868 644 644 ... ... @@ -669,7 +669,7 @@ 669 669 *0x0e: MA869 670 670 671 671 672 -**Sub-Band**: 671 +**(% style="color:#037691" %)Sub-Band**: 673 673 674 674 AU915 and US915:value 0x00 ~~ 0x08 675 675 ... ... @@ -678,7 +678,7 @@ 678 678 Other Bands: Always 0x00 679 679 680 680 681 -**Battery Info**: 680 +**(% style="color:#037691" %)Battery Info**: 682 682 683 683 Check the battery voltage. 684 684 ... ... @@ -704,7 +704,7 @@ 704 704 Battery(mV) 705 705 & 706 706 Interrupt_Flag 707 -)))|(% style="width:70px" %)[[PAYLOAD_VER>> path:#Probe_Model]]|(% style="width:234px" %)(((706 +)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)((( 708 708 If the valid payload is too long and exceed the maximum support. 709 709 Payload length in server,server will show payload not provided in the LoRaWAN server. 710 710 ))) ... ... @@ -725,7 +725,7 @@ 725 725 === 2.4.4 Interrupt Pin === 726 726 727 727 728 -This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>> path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>path:#pins]].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"]]. 729 729 730 730 **Example:** 731 731 ... ... @@ -751,45 +751,41 @@ 751 751 SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]] 752 752 753 753 753 +== 2.5 Uplink Interval == 754 754 755 -1. 756 -11. Uplink Interval 757 757 758 758 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: 759 759 760 -[[http:~~/~~/wiki.dragino.com/in dex.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]]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]] 761 761 762 762 763 763 764 -1. 765 -11. Frequency Plans 766 766 767 - TheSDI12-LB uses OTAA mode and below frequency plans by default.If userwant to useit with different frequencyplan, pleaserefer the AT command sets.763 +== 2.6 Frequency Plans == 768 768 769 769 770 - [[https:~~/~~/wiki.dragino.com/index.php?title=End_Device_Frequency_Band>>url:https://wiki.dragino.com/index.php?title=End_Device_Frequency_Band]]766 +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. 771 771 768 +[[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/]] 772 772 773 773 774 -1. 775 -11. Firmware Change Log 776 776 772 +== 2.7 Firmware Change Log == 773 + 774 + 777 777 **Firmware download link:** 778 778 779 779 [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]] 780 780 781 781 780 += 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = 782 782 783 -1. Configure SDI-12-LB via AT Command or LoRaWAN Downlink 784 784 785 785 Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. 786 786 787 787 * AT Command Connection: See [[FAQ>>path:#AT_COMMAND]]. 788 -* LoRaWAN Downlink instruction for different platforms: 786 +* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 789 789 790 -[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server>>url:http://wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server]] 791 - 792 - 793 793 There are two kinds of commands to configure SDI-12-LB, they are: 794 794 795 795 * **General Commands**. ... ... @@ -809,247 +809,223 @@ 809 809 These commands only valid for SDI-12-LB, as below: 810 810 811 811 807 +== 3.1 Set Transmit Interval Time == 812 812 813 -1. 814 -11. Set Transmit Interval Time 815 815 816 816 Feature: Change LoRaWAN End Node Transmit Interval. 817 817 818 -**AT Command: AT+TDC** 812 +(% style="color:blue" %)**AT Command: AT+TDC** 819 819 820 -|**Command Example**|**Function**|**Response** 821 -|AT+TDC=?|Show current transmit Interval|((( 814 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 815 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response** 816 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 822 822 30000 823 - 824 824 OK 825 - 826 826 the interval is 30000ms = 30s 827 827 ))) 828 -|AT+TDC=60000|Set Transmit Interval|((( 821 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 829 829 OK 830 - 831 831 Set transmit interval to 60000ms = 60 seconds 832 832 ))) 833 833 834 -**Downlink Command: 0x01** 826 +(% style="color:blue" %)**Downlink Command: 0x01** 835 835 828 + 836 836 Format: Command Code (0x01) followed by 3 bytes time value. 837 837 838 -If the downlink payload=0100003C, it means set the END Node ’s Transmit Interval to 0x00003C=60(S), while type code is 01.831 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 839 839 840 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 841 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 833 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 834 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 842 842 843 -1. 844 -11. Set Interrupt Mode 836 +== 3.2 Set Interrupt Mode == 845 845 838 + 846 846 Feature, Set Interrupt mode for GPIO_EXIT. 847 847 848 -**AT Command: AT+INTMOD** 841 +(% style="color:blue" %)**AT Command: AT+INTMOD** 849 849 850 -|**Command Example**|**Function**|**Response** 851 -|AT+INTMOD=?|Show current interrupt mode|((( 843 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 844 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 187px;" %)**Function**|=(% style="width: 165px;" %)**Response** 845 +|(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)((( 852 852 0 853 - 854 854 OK 855 - 856 856 the mode is 0 = No interruption 857 857 ))) 858 -|AT+INTMOD=2|((( 850 +|(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)((( 859 859 Set Transmit Interval 852 +~1. (Disable Interrupt), 853 +2. (Trigger by rising and falling edge) 854 +3. (Trigger by falling edge) 855 +4. (Trigger by rising edge) 856 +)))|(% style="width:165px" %)OK 860 860 861 -1. (Disable Interrupt), 862 -1. (Trigger by rising and falling edge), 863 -1. (Trigger by falling edge) 864 -1. (Trigger by rising edge) 865 -)))|OK 858 +(% style="color:blue" %)**Downlink Command: 0x06** 866 866 867 -**Downlink Command: 0x06** 868 - 869 869 Format: Command Code (0x06) followed by 3 bytes. 870 870 871 871 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 872 872 873 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 874 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 864 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 865 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 875 875 876 -1. 877 -11. Set the output time 867 +== 3.3 Set the output time == 878 878 869 + 879 879 Feature, Control the output 3V3 , 5V or 12V. 880 880 881 -**AT Command: AT+3V3T** 872 +(% style="color:blue" %)**AT Command: AT+3V3T** 882 882 883 -|**Command Example**|**Function**|**Response** 884 -|AT+3V3T=?|Show 3V3 open time.|((( 874 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %) 875 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response** 876 +|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)((( 885 885 0 886 - 887 887 OK 888 888 ))) 889 -|AT+3V3T=0|Normally open 3V3 power supply.|((( 880 +|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)((( 890 890 OK 891 - 892 892 default setting 893 893 ))) 894 -|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|((( 884 +|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)((( 895 895 OK 896 - 897 - 898 898 ))) 899 -|AT+3V3T=65535|Normally closed 3V3 power supply.|((( 887 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)((( 900 900 OK 901 - 902 - 903 903 ))) 904 904 905 -**AT Command: AT+5VT** 891 +(% style="color:blue" %)**AT Command: AT+5VT** 906 906 907 -|**Command Example**|**Function**|**Response** 908 -|AT+5VT=?|Show 5V open time.|((( 893 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %) 894 +|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response** 895 +|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)((( 909 909 0 910 - 911 911 OK 912 912 ))) 913 -|AT+5VT=0|Normally closed 5V power supply.|((( 899 +|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)((( 914 914 OK 915 - 916 916 default setting 917 917 ))) 918 -|AT+5VT=1000|Close after a delay of 1000 milliseconds.|((( 903 +|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)((( 919 919 OK 920 - 921 - 922 922 ))) 923 -|AT+5VT=65535|Normally open 5V power supply.|((( 906 +|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)((( 924 924 OK 925 - 926 - 927 927 ))) 928 928 929 -**AT Command: AT+12VT** 910 +(% style="color:blue" %)**AT Command: AT+12VT** 930 930 931 -|**Command Example**|**Function**|**Response** 932 -|AT+12VT=?|Show 12V open time.|((( 912 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %) 913 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response** 914 +|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)((( 933 933 0 934 - 935 935 OK 936 936 ))) 937 -|AT+12VT=0|Normally closed 12V power supply.|OK 938 -|AT+12VT=500|Close after a delay of 500 milliseconds.|((( 918 +|(% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK 919 +|(% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)((( 939 939 OK 940 - 941 - 942 942 ))) 943 943 944 -**Downlink Command: 0x07** 923 +(% style="color:blue" %)**Downlink Command: 0x07** 945 945 946 946 Format: Command Code (0x07) followed by 3 bytes. 947 947 948 948 The first byte is which power, the second and third bytes are the time to turn on. 949 949 950 -* Example 1: Downlink Payload: 070101F4 -> AT+3V3T=500 951 -* Example 2: Downlink Payload: 0701FFFF -> AT+3V3T=65535 952 -* Example 3: Downlink Payload: 070203E8 -> AT+5VT=1000 953 -* Example 4: Downlink Payload: 07020000 -> AT+5VT=0 954 -* Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 955 -* Example 6: Downlink Payload: 07030000 -> AT+12VT=0 929 +* Example 1: Downlink Payload: 070101F4 **~-~-->** AT+3V3T=500 930 +* Example 2: Downlink Payload: 0701FFFF **~-~-->** AT+3V3T=65535 931 +* Example 3: Downlink Payload: 070203E8 **~-~-->** AT+5VT=1000 932 +* Example 4: Downlink Payload: 07020000 **~-~-->** AT+5VT=0 933 +* Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 934 +* Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 956 956 957 -1. 958 -11. Set the all data mode 936 +== 3.4 Set the all data mode == 959 959 938 + 960 960 Feature, Set the all data mode. 961 961 962 -**AT Command: AT+ALLDATAMOD** 941 +(% style="color:blue" %)**AT Command: AT+ALLDATAMOD** 963 963 964 -|**Command Example**|**Function**|**Response** 943 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %) 944 +|=**Command Example**|=**Function**|=**Response** 965 965 |AT+ALLDATAMOD=?|Show current all data mode|((( 966 966 0 967 - 968 - 969 969 OK 970 970 ))) 971 971 |AT+ALLDATAMOD=1|Set all data mode is 1.|OK 972 972 973 -**Downlink Command: 0xAB** 951 +(% style="color:blue" %)**Downlink Command: 0xAB** 974 974 975 975 Format: Command Code (0xAB) followed by 1 bytes. 976 976 977 -* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 978 -* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 955 +* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 956 +* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 979 979 980 -1. 981 -11. Set the splicing payload for uplink 958 +== 3.5 Set the splicing payload for uplink == 982 982 960 + 983 983 Feature, splicing payload for uplink. 984 984 985 -**AT Command: AT+DATAUP** 963 +(% style="color:blue" %)**AT Command: AT+DATAUP** 986 986 987 -|**Command Example**|**Function**|**Response** 988 -|AT+DATAUP =?|Show current splicing payload for uplink mode|((( 965 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 966 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 266px;" %)**Function**|=**Response** 967 +|(% style="width:154px" %)AT+DATAUP =?|(% style="width:266px" %)Show current splicing payload for uplink mode|((( 989 989 0 990 - 991 - 992 992 OK 993 993 ))) 994 -|AT+DATAUP =0|((( 971 +|(% style="width:154px" %)AT+DATAUP =0|(% style="width:266px" %)((( 995 995 Set splicing payload for uplink mode is 0. 996 - 997 - 998 998 )))|((( 999 999 OK 1000 - 1001 - 1002 1002 ))) 1003 -|AT+DATAUP =1|Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK 1004 -|AT+DATAUP =1,20000|((( 1005 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. 1006 - 1007 - 976 +|(% style="width:154px" %)AT+DATAUP =1|(% style="width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK 977 +|(% style="width:154px" %)AT+DATAUP =1,20000|(% style="width:266px" %)((( 978 +Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. 1008 1008 )))|OK 1009 1009 1010 -**Downlink Command: 0xAD** 981 +(% style="color:blue" %)**Downlink Command: 0xAD** 1011 1011 1012 1012 Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. 1013 1013 1014 -* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0 1015 -* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1 1016 -* Example 3: Downlink Payload: AD 01 00 00 14~/~/ AT+DATAUP =1,20000 985 +* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0 986 +* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1 987 +* Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000 1017 1017 1018 1018 This means that the interval is set to 0x000014=20S 1019 1019 1020 1020 1021 -1. 1022 -11. Set the payload version 992 +== 3.6 Set the payload version == 1023 1023 1024 1024 Feature, Set the payload version. 1025 1025 1026 -**AT Command: AT+PAYVER** 996 +(% style="color:blue" %)**AT Command: AT+PAYVER** 1027 1027 1028 -|**Command Example**|**Function**|**Response** 1029 -|AT+PAYVER=?|Show current payload version|((( 998 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %) 999 +|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=**Response** 1000 +|(% style="width:158px" %)AT+PAYVER=?|(% style="width:192px" %)Show current payload version|((( 1030 1030 1 1031 - 1032 - 1033 1033 OK 1034 1034 ))) 1035 -|AT+PAYVER=5|Set payload version is 5.|OK 1004 +|(% style="width:158px" %)AT+PAYVER=5|(% style="width:192px" %)Set payload version is 5.|OK 1036 1036 1037 -**Downlink Command: 0xAE** 1006 +(% style="color:blue" %)**Downlink Command: 0xAE** 1038 1038 1039 1039 Format: Command Code (0xAE) followed by 1 bytes. 1040 1040 1041 -* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1042 -* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1010 +* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1011 +* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1043 1043 1044 -1. Battery & how to replace 1045 -11. Battery Type 1013 += 4. Battery & how to replace = 1046 1046 1047 - SDI-12-LBis equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]].The batteryis un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This typeof battery is commonly used in IoT target for long-term running, such as water meter.1015 +== 4.1 Battery Type == 1048 1048 1049 1049 1018 +SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter. 1019 + 1020 + 1050 1050 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1051 1051 1052 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]]1023 +[[image:1675146710956-626.png]] 1053 1053 1054 1054 1055 1055 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1057,31 +1057,25 @@ 1057 1057 SDI-12-LB: 2.45v ~~ 3.6v 1058 1058 1059 1059 1060 -1. 1061 -11. Replace Battery 1031 +== 4.2 Replace Battery == 1062 1062 1033 + 1063 1063 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery. 1064 1064 1065 1065 And make sure the positive and negative pins match. 1066 1066 1067 1067 1039 +== 4.3 Power Consumption Analyze == 1068 1068 1069 -1. 1070 -11. Power Consumption Analyze 1071 1071 1072 1072 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. 1073 1073 1074 - 1075 1075 Instruction to use as below: 1076 1076 1046 +(% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]] 1077 1077 1078 - Step 1: Downlink theup-to-dateDRAGINO_Battery_Life_Prediction_Table.xlsxfrom:1048 +(% style="color:blue" %)**Step 2:**(%%) Open it and choose 1079 1079 1080 -[[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 1081 - 1082 - 1083 -Step 2: Open it and choose 1084 - 1085 1085 * Product Model 1086 1086 * Uplink Interval 1087 1087 * Working Mode ... ... @@ -1088,57 +1088,48 @@ 1088 1088 1089 1089 And the Life expectation in difference case will be shown on the right. 1090 1090 1091 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image037.png]]1056 +[[image:1675146895108-304.png]] 1092 1092 1093 1093 1094 1094 The battery related documents as below: 1095 1095 1096 -* [[Battery Dimension>> url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],1097 -* [[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]]1098 -* [[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]]1061 +* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]], 1062 +* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1063 +* [[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]] 1099 1099 1100 -|((( 1101 -JST-XH-2P connector 1102 -))) 1065 +[[image:image-20230131145708-3.png]] 1103 1103 1104 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image038.png]] 1105 1105 1068 +=== 4.3.1 Battery Note === 1106 1106 1107 1107 1108 -1. 1109 -11. 1110 -111. Battery Note 1111 - 1112 1112 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 1113 1113 1114 1114 1115 -1. 1116 -11. 1117 -111. Replace the battery 1074 +=== 4.3.2 Replace the battery === 1118 1118 1119 -You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board. 1120 1120 1077 +You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board. 1121 1121 1122 -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)1079 +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) 1123 1123 1124 1124 1125 1125 1083 += 5. Remote Configure device = 1126 1126 1085 +== 5.1 Connect via BLE == 1127 1127 1128 1128 1129 -1. Remote Configure device 1130 -11. Connect via BLE 1088 +Please see this instruction for how to configure via BLE: [[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/]] 1131 1131 1132 -Please see this instruction for how to configure via BLE: 1133 1133 1134 - [[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/]]1091 +== 5.2 AT Command Set == 1135 1135 1136 1136 1137 -1. 1138 -11. AT Command Set 1139 1139 1140 - 1. OTA firmware update1095 += 6. OTA firmware update = 1141 1141 1097 + 1142 1142 Please see this link for how to do OTA firmware update. 1143 1143 1144 1144 [[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/]] ... ... @@ -1145,19 +1145,33 @@ 1145 1145 1146 1146 1147 1147 1104 += 7. Order Info = 1148 1148 1149 1149 1107 +Part Number: SDI-12-LB-XXX 1108 +XXX: The default frequency band 1150 1150 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 1151 1151 1152 1152 1153 1153 1154 1154 1155 1155 1156 -1. Order Info 1157 1157 1124 + 1125 += 8. Packing Info = 1126 + 1127 + 1158 1158 **Package Includes**: 1159 1159 1160 -* SDI-12-LB SDI-12 to LoRaWAN Converter 1130 +* SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1161 1161 1162 1162 **Dimension and weight**: 1163 1163 ... ... @@ -1166,12 +1166,11 @@ 1166 1166 * Package Size / pcs : cm 1167 1167 * Weight / pcs : g 1168 1168 1139 += 9. Support = 1169 1169 1170 -1. Support 1171 1171 1172 1172 * 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. 1173 -* 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 1174 1174 1175 -[[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]] 1144 +* 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]] 1176 1176 1177 1177
- 1675234124233-857.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +75.8 KB - Content