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)
Details
- Page properties
-
- Content
-
... ... @@ -23,7 +23,7 @@ 23 23 == 1.1 What is SDI-12 to LoRaWAN Converter == 24 24 25 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.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 27 28 28 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. 29 29 ... ... @@ -31,7 +31,7 @@ 31 31 32 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. 33 33 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.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. 35 35 36 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. 37 37 ... ... @@ -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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% style="color:#037691" %) **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 -(% 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. 116 116 117 -(% 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. 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 ... ... @@ -172,7 +172,7 @@ 172 172 == 2.1 How it works == 173 173 174 174 175 -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. 176 176 177 177 178 178 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -187,7 +187,7 @@ 187 187 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. 188 188 189 189 190 -(% 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. 191 191 192 192 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 193 193 ... ... @@ -201,35 +201,35 @@ 201 201 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 202 202 203 203 204 -(% style="color:blue" %) **Register the device**207 +**(% style="color:blue" %)Register the device** 205 205 206 206 [[image:1675213652444-622.png]] 207 207 208 208 209 -(% style="color:blue" %) **Add APP EUI and DEV EUI**212 +**(% style="color:blue" %)Add APP EUI and DEV EUI** 210 210 211 211 212 212 [[image:1675213661769-223.png]] 213 213 214 214 215 -(% style="color:blue" %) **Add APP EUI in the application**218 +**(% style="color:blue" %)Add APP EUI in the application** 216 216 217 217 218 218 [[image:1675213675852-577.png]] 219 219 220 220 221 -(% style="color:blue" %) **Add APP KEY**224 +**(% style="color:blue" %)Add APP KEY** 222 222 223 223 [[image:1675213686734-883.png]] 224 224 225 225 226 -(% style="color:blue" %) **Step 2**(%%): Activate on SDI-12-LB229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB 227 227 228 228 229 229 Press the button for 5 seconds to activate the SDI-12-LB. 230 230 231 231 232 -(% 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.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. 233 233 234 234 235 235 [[image:1675213704414-644.png]] ... ... @@ -258,15 +258,15 @@ 258 258 [[image:image-20230201091027-7.png||height="261" width="1179"]] 259 259 260 260 261 -==== (% style="color:blue" %) **al! ~-~- Get SDI-12 sensor Identification**(%%)====264 +==== **(% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification** ==== 262 262 263 263 264 264 * AT Command: AT+ADDRI=aa 265 265 * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa 266 266 267 -(% 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) 268 268 269 -(% 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) 270 270 271 271 272 272 The following is the display information on the serial port and the server. ... ... @@ -278,16 +278,16 @@ 278 278 [[image:image-20230201091257-9.png||height="225" width="1242"]] 279 279 280 280 281 -==== (% style="color:blue" %) **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%)====284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ==== 282 282 283 283 284 -(% style="color:red" %) **aM! **(%%): Start Non-Concurrent Measurement287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement 285 285 286 -(% style="color:red" %) **aMC! **(%%): Start Non-Concurrent Measurement – Request CRC289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC 287 287 288 -(% style="color:red" %) **aM1!- aM9! **(%%): Additional Measurements291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements 289 289 290 -(% style="color:red" %) **aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 291 291 292 292 293 293 * AT Command : AT+ADDRM=0,1,0,1 ... ... @@ -296,13 +296,13 @@ 296 296 297 297 Downlink:AA 01 aa bb cc dd 298 298 299 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 300 300 301 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 302 302 303 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement306 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 304 304 305 -(% 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. 306 306 307 307 308 308 The following is the display information on the serial port and the server. ... ... @@ -315,16 +315,16 @@ 315 315 316 316 317 317 318 -==== (% style="color:blue" %) **aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! **(%%)====321 +==== **(% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ==== 319 319 320 320 321 -(% style="color:red" %) **aC!**(%%) : Start Concurrent Measurement324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement 322 322 323 -(% style="color:red" %) **aCC!** (%%): Start Concurrent Measurement – Request CRC326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC 324 324 325 -(% style="color:red" %) **aC1!- aC9!**(%%) : Start Additional Concurrent Measurements328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 326 326 327 -(% style="color:red" %) **aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 328 328 329 329 330 330 * AT Command : AT+ADDRC=0,1,0,1 ... ... @@ -333,13 +333,13 @@ 333 333 334 334 Downlink: AA 02 aa bb cc dd 335 335 336 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 337 337 338 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 339 339 340 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement343 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 341 341 342 -(% 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. 343 343 344 344 345 345 The following is the display information on the serial port and the server. ... ... @@ -353,7 +353,7 @@ 353 353 354 354 355 355 356 -==== (% style="color:blue" %) **aR0!- aR9!, aRC0!- aRC9!**(%%)====359 +==== **(% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!** ==== 357 357 358 358 359 359 Start Continuous Measurement ... ... @@ -366,13 +366,13 @@ 366 366 367 367 Downlink: AA 03 aa bb cc dd 368 368 369 -(% style="color:#037691" %) **aa**(%%): SDI-12 sensor address.372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address. 370 370 371 -(% style="color:#037691" %) **bb**(%%): 0: no CRC, 1: request CRC374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC 372 372 373 -(% style="color:#037691" %) **cc**(%%): 1-9: Additional Measurement, 0: no additional measurement376 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 374 374 375 -(% 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. 376 376 377 377 378 378 The following is the display information on the serial port and the server. ... ... @@ -393,20 +393,20 @@ 393 393 394 394 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 395 395 396 -(% style="color:#037691" %) **aa **(%%): total SDI-12 command length399 +**(% style="color:#037691" %)aa **(%%): total SDI-12 command length 397 397 398 -(% style="color:#037691" %) **xx **(%%): SDI-12 command401 +**(% style="color:#037691" %)xx **(%%): SDI-12 command 399 399 400 -(% style="color:#037691" %) **bb **(%%): Delay to wait for return403 +**(% style="color:#037691" %)bb **(%%): Delay to wait for return 401 401 402 -(% 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 403 403 404 404 405 -(% style="color:blue" %) **Example: **(%%) AT+CFGDEV =0RC0!,1408 +**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1 406 406 407 -(% style="color:#037691" %) **0RC0! **(%%): SDI-12 Command,410 +**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command, 408 408 409 -(% style="color:#037691" %) **1 **(%%): Delay 1 second. ( 0: 810 mini-second)412 +**(% style="color:#037691" %)1 **(%%): Delay 1 second. ( 0: 810 mini-second) 410 410 411 411 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 412 412 ... ... @@ -428,7 +428,7 @@ 428 428 AT+CONVFORM ( Max length: 80 bytes) 429 429 430 430 431 -(% style="color:blue" %) **Example:**434 +**(% style="color:blue" %)Example:** 432 432 433 433 1) AT+CONVFORM=0, string Convert String from String to ASCII 434 434 ... ... @@ -448,31 +448,31 @@ 448 448 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. 449 449 450 450 451 -* (% style="color:blue" %) **AT Command:**454 +* ** (% style="color:blue" %)AT Command:** 452 452 453 -(% style="color:#037691" %) **AT+COMMANDx=var1,var2,var3,var4.**456 +**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.** 454 454 455 -(% style="color:red" %) **var1**(%%): SDI-12 command , for example: 0RC0!458 +**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0! 456 456 457 -(% style="color:red" %) **var2**(%%): Wait timeout for return. (unit: second)460 +**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second) 458 458 459 -(% 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!//. 460 460 461 -(% style="color:red" %) **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. 462 462 463 -(% style="color:red" %) **0 **(%%) No validation check;466 +**(% style="color:red" %)0 **(%%) No validation check; 464 464 465 -(% style="color:red" %) **1**468 +**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 466 466 467 -(% 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 468 468 469 -(% style="color:red" %) **3**472 +**(% style="color:red" %)3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 470 470 471 471 472 -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. 473 473 474 474 475 -(% 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. 476 476 477 477 (% border="1" style="background-color:#f7faff; width:436px" %) 478 478 |(% style="width:433px" %)((( ... ... @@ -494,49 +494,49 @@ 494 494 |(% 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 495 495 |(% 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 496 496 497 -* (% style="color:blue" %) **Downlink Payload:**500 +* **(% style="color:blue" %) Downlink Payload:** 498 498 499 -(% 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. 500 500 501 501 502 -(% 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.** 503 503 504 504 505 -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** 506 506 507 507 Where: 508 508 509 -* (% style="color:#037691" %) **MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,510 -* (% style="color:#037691" %) **NN **(%%): 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.511 -* (% style="color:#037691" %) **LL **(%%): The length of AT+COMMAND or AT+DATACUT command512 -* (% style="color:#037691" %) **XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command513 -* (% 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.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. 514 514 515 -(% style="color:blue" %) **Example:**518 +**(% style="color:blue" %)Example:** 516 516 517 517 [[image:image-20230201094129-18.png]] 518 518 519 519 520 -(% style="color:blue" %) **Clear SDI12 Command**523 +**(% style="color:blue" %)Clear SDI12 Command** 521 521 522 522 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 523 523 524 524 525 -* (% style="color:#037691" %) **AT Command:**528 +* ** (% style="color:#037691" %)AT Command:** 526 526 527 -(% 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 528 528 529 529 530 530 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 531 531 532 532 533 -* (% style="color:#037691" %) **Downlink Payload:**536 +* **(% style="color:#037691" %) Downlink Payload:** 534 534 535 -(% 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 536 536 537 537 538 538 539 -(% style="color:blue" %) **command combination**542 +**(% style="color:blue" %)command combination** 540 540 541 541 Below shows a screen shot how the results combines together to a uplink payload. 542 542 ... ... @@ -545,23 +545,23 @@ 545 545 546 546 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. 547 547 548 -(% 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. 549 549 550 550 551 -(% 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. 552 552 553 553 554 554 [[image:1675215782925-448.png]] 555 555 556 556 557 -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. 558 558 559 559 560 560 561 -(% style="color:blue" %) **Compose Uplink**564 +**(% style="color:blue" %)Compose Uplink** 562 562 563 563 564 -(% style="color:#4 f81bd" %)**AT+DATAUP=0**567 +**(% style="color:#4F81BD" %)AT+DATAUP=0** 565 565 566 566 Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 567 567 ... ... @@ -573,7 +573,7 @@ 573 573 [[image:1675215828102-844.png]] 574 574 575 575 576 -(% style="color:#4 f81bd" %)**AT+DATAUP=1**579 +**(% style="color:#4F81BD" %)AT+DATAUP=1** 577 577 578 578 Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 579 579 ... ... @@ -590,7 +590,7 @@ 590 590 [[image:1675215848113-696.png]] 591 591 592 592 593 -(% 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:** 594 594 595 595 * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 596 596 * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). ... ... @@ -597,9 +597,9 @@ 597 597 * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 598 598 * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 599 599 600 -(% 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;** 601 601 602 -(% 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.** 603 603 604 604 605 605 == 2.4 Uplink Payload == ... ... @@ -630,11 +630,11 @@ 630 630 [[image:1675215946738-635.png]] 631 631 632 632 633 -(% 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 634 634 635 -(% style="color:#037691" %) **Firmware Version**(%%): 0x0100, Means: v1.0.0 version638 +**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version 636 636 637 -(% style="color:#037691" %) **Frequency Band**:640 +**(% style="color:#037691" %)Frequency Band**: 638 638 639 639 *0x01: EU868 640 640 ... ... @@ -665,7 +665,7 @@ 665 665 *0x0e: MA869 666 666 667 667 668 -(% style="color:#037691" %) **Sub-Band**:671 +**(% style="color:#037691" %)Sub-Band**: 669 669 670 670 AU915 and US915:value 0x00 ~~ 0x08 671 671 ... ... @@ -674,7 +674,7 @@ 674 674 Other Bands: Always 0x00 675 675 676 676 677 -(% style="color:#037691" %) **Battery Info**:680 +**(% style="color:#037691" %)Battery Info**: 678 678 679 679 Check the battery voltage. 680 680 ... ... @@ -721,7 +721,7 @@ 721 721 === 2.4.4 Interrupt Pin === 722 722 723 723 724 -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"]]. 725 725 726 726 **Example:** 727 727 ... ... @@ -752,7 +752,7 @@ 752 752 753 753 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: 754 754 755 -[[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]] 756 756 757 757 758 758 ... ... @@ -765,6 +765,7 @@ 765 765 [[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/]] 766 766 767 767 771 + 768 768 == 2.7 Firmware Change Log == 769 769 770 770 ... ... @@ -783,7 +783,7 @@ 783 783 784 784 There are two kinds of commands to configure SDI-12-LB, they are: 785 785 786 -* ** (% style="color:blue" %)General Commands**.790 +* **General Commands**. 787 787 788 788 These commands are to configure: 789 789 ... ... @@ -792,10 +792,10 @@ 792 792 793 793 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 794 794 795 -[[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]] 796 796 797 797 798 -* ** (% style="color:blue" %)Commands special design for SDI-12-LB**802 +* **Commands special design for SDI-12-LB** 799 799 800 800 These commands only valid for SDI-12-LB, as below: 801 801 ... ... @@ -829,9 +829,6 @@ 829 829 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 830 830 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 831 831 832 - 833 - 834 - 835 835 == 3.2 Set Interrupt Mode == 836 836 837 837 ... ... @@ -863,9 +863,6 @@ 863 863 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 864 864 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 865 865 866 - 867 - 868 - 869 869 == 3.3 Set the output time == 870 870 871 871 ... ... @@ -935,9 +935,6 @@ 935 935 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 936 936 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 937 937 938 - 939 - 940 - 941 941 == 3.4 Set the all data mode == 942 942 943 943 ... ... @@ -960,9 +960,6 @@ 960 960 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 961 961 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 962 962 963 - 964 - 965 - 966 966 == 3.5 Set the splicing payload for uplink == 967 967 968 968 ... ... @@ -1018,9 +1018,6 @@ 1018 1018 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1019 1019 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1020 1020 1021 - 1022 - 1023 - 1024 1024 = 4. Battery & how to replace = 1025 1025 1026 1026 == 4.1 Battery Type == ... ... @@ -1031,7 +1031,7 @@ 1031 1031 1032 1032 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1033 1033 1034 -[[image:1675 234124233-857.png]]1023 +[[image:1675146710956-626.png]] 1035 1035 1036 1036 1037 1037 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1064,10 +1064,9 @@ 1064 1064 1065 1065 And the Life expectation in difference case will be shown on the right. 1066 1066 1056 +[[image:1675146895108-304.png]] 1067 1067 1068 -[[image:1675234155374-163.png]] 1069 1069 1070 - 1071 1071 The battery related documents as below: 1072 1072 1073 1073 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]], ... ... @@ -1074,10 +1074,9 @@ 1074 1074 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1075 1075 * [[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]] 1076 1076 1065 +[[image:image-20230131145708-3.png]] 1077 1077 1078 -[[image:image-20230201145019-19.png]] 1079 1079 1080 - 1081 1081 === 4.3.1 Battery Note === 1082 1082 1083 1083 ... ... @@ -1092,6 +1092,7 @@ 1092 1092 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) 1093 1093 1094 1094 1082 + 1095 1095 = 5. Remote Configure device = 1096 1096 1097 1097 == 5.1 Connect via BLE == ... ... @@ -1112,42 +1112,21 @@ 1112 1112 [[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/]] 1113 1113 1114 1114 1115 -= 7. FAQ = 1116 1116 1117 -= =7.1How to useAT Command toaccess device?==1104 += 7. Order Info = 1118 1118 1119 1119 1120 -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]] 1121 - 1122 - 1123 -== 7.2 How to update firmware via UART port? == 1124 - 1125 - 1126 -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]] 1127 - 1128 - 1129 -== 7.3 How to change the LoRa Frequency Bands/Region? == 1130 - 1131 - 1132 -You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1133 -When downloading the images, choose the required image file for download. 1134 - 1135 - 1136 -= 8. Order Info = 1137 - 1138 - 1139 -**(% style="color:blue" %)Part Number: SDI-12-LB-XXX** 1140 - 1107 +Part Number: SDI-12-LB-XXX 1141 1141 XXX: The default frequency band 1142 1142 1143 - **(% style="color:red" %)AS923**(%%): LoRaWAN AS923 band1144 - **(% style="color:red" %)AU915**(%%): LoRaWAN AU915 band1145 - **(% style="color:red" %)EU433**(%%): LoRaWAN EU433 band1146 - **(% style="color:red" %)EU868**(%%): LoRaWAN EU868 band1147 - **(% style="color:red" %)KR920**(%%): LoRaWAN KR920 band1148 - **(% style="color:red" %)US915**(%%): LoRaWAN US915 band1149 - **(% style="color:red" %)IN865**(%%): LoRaWAN IN865 band1150 - **(% style="color:red" %)CN470**(%%): LoRaWAN CN470 band1110 +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 ... ... @@ -1155,14 +1155,14 @@ 1155 1155 1156 1156 1157 1157 1158 -= 9. Packing Info =1125 += 8. Packing Info = 1159 1159 1160 1160 1161 -** (% style="color:#037691" %)Package Includes**:1128 +**Package Includes**: 1162 1162 1163 1163 * SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1164 1164 1165 -** (% style="color:#037691" %)Dimension and weight**:1132 +**Dimension and weight**: 1166 1166 1167 1167 * Device Size: cm 1168 1168 * Device Weight: g ... ... @@ -1169,12 +1169,9 @@ 1169 1169 * Package Size / pcs : cm 1170 1170 * Weight / pcs : g 1171 1171 1139 += 9. Support = 1172 1172 1173 1173 1174 - 1175 -= 10. Support = 1176 - 1177 - 1178 1178 * 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. 1179 1179 1180 1180 * 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]]