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,22 +56,21 @@ 56 56 * Downlink to change configure 57 57 * 8500mAh Battery for long term use 58 58 59 - 60 60 == 1.3 Specification == 61 61 62 62 63 - **(% style="color:#037691" %)Micro Controller:**62 +(% style="color:#037691" %)**Micro Controller:** 64 64 65 65 * MCU: 48Mhz ARM 66 66 * Flash: 256KB 67 67 * RAM: 64KB 68 68 69 - **(% style="color:#037691" %)Common DC Characteristics:**68 +(% style="color:#037691" %)**Common DC Characteristics:** 70 70 71 71 * Supply Voltage: 2.5v ~~ 3.6v 72 72 * Operating Temperature: -40 ~~ 85°C 73 73 74 - **(% style="color:#037691" %)LoRa Spec:**73 +(% style="color:#037691" %)**LoRa Spec:** 75 75 76 76 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 77 77 * Max +22 dBm constant RF output vs. ... ... @@ -78,19 +78,19 @@ 78 78 * RX sensitivity: down to -139 dBm. 79 79 * Excellent blocking immunity 80 80 81 - **(% style="color:#037691" %)Current Input Measuring :**80 +(% style="color:#037691" %)**Current Input Measuring :** 82 82 83 83 * Range: 0 ~~ 20mA 84 84 * Accuracy: 0.02mA 85 85 * Resolution: 0.001mA 86 86 87 - **(% style="color:#037691" %)Voltage Input Measuring:**86 +(% style="color:#037691" %)**Voltage Input Measuring:** 88 88 89 89 * Range: 0 ~~ 30v 90 90 * Accuracy: 0.02v 91 91 * Resolution: 0.001v 92 92 93 - **(% style="color:#037691" %)Battery:**92 +(% style="color:#037691" %)**Battery:** 94 94 95 95 * Li/SOCI2 un-chargeable battery 96 96 * Capacity: 8500mAh ... ... @@ -98,12 +98,11 @@ 98 98 * Max continuously current: 130mA 99 99 * Max boost current: 2A, 1 second 100 100 101 - **(% style="color:#037691" %)Power Consumption**100 +(% style="color:#037691" %)**Power Consumption** 102 102 103 103 * Sleep Mode: 5uA @ 3.3v 104 104 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 105 105 106 - 107 107 == 1.4 Connect to SDI-12 Sensor == 108 108 109 109 ... ... @@ -114,9 +114,9 @@ 114 114 == 1.5 Sleep mode and working mode == 115 115 116 116 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.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. 118 118 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.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. 120 120 121 121 122 122 == 1.6 Button & LEDs == ... ... @@ -139,7 +139,6 @@ 139 139 ))) 140 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. 141 141 142 - 143 143 == 1.7 Pin Mapping == 144 144 145 145 ... ... @@ -175,7 +175,7 @@ 175 175 == 2.1 How it works == 176 176 177 177 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.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. 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 - **(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.190 +(% 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 - **(% style="color:blue" %)Register the device**204 +(% style="color:blue" %)**Register the device** 208 208 209 209 [[image:1675213652444-622.png]] 210 210 211 211 212 - **(% style="color:blue" %)Add APP EUI and DEV EUI**209 +(% style="color:blue" %)**Add APP EUI and DEV EUI** 213 213 214 214 215 215 [[image:1675213661769-223.png]] 216 216 217 217 218 - **(% style="color:blue" %)Add APP EUI in the application**215 +(% style="color:blue" %)**Add APP EUI in the application** 219 219 220 220 221 221 [[image:1675213675852-577.png]] 222 222 223 223 224 - **(% style="color:blue" %)Add APP KEY**221 +(% style="color:blue" %)**Add APP KEY** 225 225 226 226 [[image:1675213686734-883.png]] 227 227 228 228 229 - **(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB226 +(% 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 - **(% 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.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. 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 -==== **(% style="color:blue" %)al! ~-~- Get SDI-12 sensor Identification** ====261 +==== (% 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 - **(% style="color:#037691" %)Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)267 +(% style="color:#037691" %)**Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 271 271 272 - **(% style="color:blue" %)Example : **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)269 +(% 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,16 +281,16 @@ 281 281 [[image:image-20230201091257-9.png||height="225" width="1242"]] 282 282 283 283 284 -==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====281 +==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ==== 285 285 286 286 287 - **(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement284 +(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement 288 288 289 - **(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC286 +(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC 290 290 291 - **(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements288 +(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements 292 292 293 - **(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC290 +(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 294 294 295 295 296 296 * AT Command : AT+ADDRM=0,1,0,1 ... ... @@ -299,13 +299,13 @@ 299 299 300 300 Downlink:AA 01 aa bb cc dd 301 301 302 - **(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.299 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 303 303 304 - **(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC301 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 305 305 306 - **(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement303 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 307 307 308 - **(% style="color:#037691" %)dd**(%%): delay (in second) to send**(% style="color:#037691" %)aD0!**(%%) to get return.305 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 309 309 310 310 311 311 The following is the display information on the serial port and the server. ... ... @@ -318,16 +318,16 @@ 318 318 319 319 320 320 321 -==== **(% style="color:blue" %)aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ====318 +==== (% style="color:blue" %)**aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! **(%%) ==== 322 322 323 323 324 - **(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement321 +(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement 325 325 326 - **(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC323 +(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC 327 327 328 - **(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements325 +(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 329 329 330 - **(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC327 +(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 331 331 332 332 333 333 * AT Command : AT+ADDRC=0,1,0,1 ... ... @@ -336,13 +336,13 @@ 336 336 337 337 Downlink: AA 02 aa bb cc dd 338 338 339 - **(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.336 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 340 340 341 - **(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC338 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 342 342 343 - **(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement340 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 344 344 345 - **(% style="color:#037691" %)dd**(%%): delay (in second) to send**(% style="color:#037691" %)aD0!**(%%) to get return.342 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 346 346 347 347 348 348 The following is the display information on the serial port and the server. ... ... @@ -356,7 +356,7 @@ 356 356 357 357 358 358 359 -==== **(% style="color:blue" %)aR0!- aR9!, aRC0!- aRC9!** ====356 +==== (% style="color:blue" %)**aR0!- aR9!, aRC0!- aRC9!**(%%) ==== 360 360 361 361 362 362 Start Continuous Measurement ... ... @@ -369,13 +369,13 @@ 369 369 370 370 Downlink: AA 03 aa bb cc dd 371 371 372 - **(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.369 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 373 373 374 - **(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC371 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 375 375 376 - **(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement373 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 377 377 378 - **(% style="color:#037691" %)dd**(%%): delay (in second) to send**(% style="color:#037691" %)aD0!**(%%) to get return.375 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 379 379 380 380 381 381 The following is the display information on the serial port and the server. ... ... @@ -396,20 +396,20 @@ 396 396 397 397 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 398 398 399 - **(% style="color:#037691" %)aa **(%%): total SDI-12 command length396 +(% style="color:#037691" %)**aa **(%%): total SDI-12 command length 400 400 401 - **(% style="color:#037691" %)xx **(%%): SDI-12 command398 +(% style="color:#037691" %)**xx **(%%): SDI-12 command 402 402 403 - **(% style="color:#037691" %)bb **(%%): Delay to wait for return400 +(% style="color:#037691" %)**bb **(%%): Delay to wait for return 404 404 405 - **(% style="color:#037691" %)cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100402 +(% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 406 406 407 407 408 - **(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1405 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1 409 409 410 - **(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,407 +(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command, 411 411 412 - **(% style="color:#037691" %)1 **(%%): Delay 1 second. ( 0: 810 mini-second)409 +(% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second) 413 413 414 414 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 415 415 ... ... @@ -431,7 +431,7 @@ 431 431 AT+CONVFORM ( Max length: 80 bytes) 432 432 433 433 434 - **(% style="color:blue" %)Example:**431 +(% style="color:blue" %)**Example:** 435 435 436 436 1) AT+CONVFORM=0, string Convert String from String to ASCII 437 437 ... ... @@ -451,31 +451,31 @@ 451 451 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. 452 452 453 453 454 -* **(% style="color:blue" %)AT Command:**451 +* (% style="color:blue" %)**AT Command:** 455 455 456 - **(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**453 +(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.** 457 457 458 - **(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!455 +(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0! 459 459 460 - **(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)457 +(% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second) 461 461 462 - **(% style="color:red" %)var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.459 +(% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//. 463 463 464 - **(% style="color:red" %)var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.461 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 465 465 466 - **(% style="color:red" %)0 **(%%) No validation check;463 +(% style="color:red" %)**0 **(%%) No validation check; 467 467 468 - **(% style="color:red" %)1**465 +(% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 469 469 470 - **(% style="color:#red" %)2**(%%) Check if there is return from SDI-12 sensor467 +(% style="color:#red" %)**2**(%%) Check if there is return from SDI-12 sensor 471 471 472 - **(% style="color:red" %)3**469 +(% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 473 473 474 474 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.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. 476 476 477 477 478 - **(% style="color:blue" %)AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.475 +(% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes. 479 479 480 480 (% border="1" style="background-color:#f7faff; width:436px" %) 481 481 |(% style="width:433px" %)((( ... ... @@ -497,49 +497,49 @@ 497 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 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 499 499 500 -* **(% style="color:blue" %) Downlink Payload:**497 +* (% style="color:blue" %)** Downlink Payload:** 501 501 502 - **(% style="color:blue" %)0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.499 +(% style="color:blue" %)**0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 503 503 504 504 505 - **(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**502 +(% style="color:red" %)**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.** 506 506 507 507 508 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY** 505 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)** 509 509 510 510 Where: 511 511 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 command515 -* **(% style="color:#037691" %)XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command516 -* **(% 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.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 command 512 +* (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command 513 +* (% 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. 517 517 518 - **(% style="color:blue" %)Example:**515 +(% style="color:blue" %)**Example:** 519 519 520 520 [[image:image-20230201094129-18.png]] 521 521 522 522 523 - **(% style="color:blue" %)Clear SDI12 Command**520 +(% style="color:blue" %)**Clear SDI12 Command** 524 524 525 525 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 526 526 527 527 528 -* **(% style="color:#037691" %)AT Command:**525 +* (% style="color:#037691" %)**AT Command:** 529 529 530 - **(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn**527 +(% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase 531 531 532 532 533 533 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 534 534 535 535 536 -* **(% style="color:#037691" %) Downlink Payload:**533 +* (% style="color:#037691" %)** Downlink Payload:** 537 537 538 - **(% style="color:#4F81BD" %)0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb535 +(% style="color:#4f81bd" %)**0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb 539 539 540 540 541 541 542 - **(% style="color:blue" %)command combination**539 +(% style="color:blue" %)**command combination** 543 543 544 544 Below shows a screen shot how the results combines together to a uplink payload. 545 545 ... ... @@ -548,23 +548,23 @@ 548 548 549 549 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. 550 550 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.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. 552 552 553 553 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.551 +(% 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. 555 555 556 556 557 557 [[image:1675215782925-448.png]] 558 558 559 559 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.557 +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. 561 561 562 562 563 563 564 - **(% style="color:blue" %)Compose Uplink**561 +(% style="color:blue" %)**Compose Uplink** 565 565 566 566 567 - **(% style="color:#4F81BD" %)AT+DATAUP=0**564 +(% style="color:#4f81bd" %)**AT+DATAUP=0** 568 568 569 569 Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 570 570 ... ... @@ -576,7 +576,7 @@ 576 576 [[image:1675215828102-844.png]] 577 577 578 578 579 - **(% style="color:#4F81BD" %)AT+DATAUP=1**576 +(% style="color:#4f81bd" %)**AT+DATAUP=1** 580 580 581 581 Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 582 582 ... ... @@ -593,7 +593,7 @@ 593 593 [[image:1675215848113-696.png]] 594 594 595 595 596 - **(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**593 +(% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** 597 597 598 598 * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 599 599 * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). ... ... @@ -600,9 +600,9 @@ 600 600 * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 601 601 * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 602 602 603 - **(% style="color:red" %)When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**600 +(% style="color:red" %)**When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;** 604 604 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.**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.** 606 606 607 607 608 608 == 2.4 Uplink Payload == ... ... @@ -633,11 +633,11 @@ 633 633 [[image:1675215946738-635.png]] 634 634 635 635 636 - **(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17633 +(% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17 637 637 638 - **(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version635 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 639 639 640 - **(% style="color:#037691" %)Frequency Band**:637 +(% style="color:#037691" %)**Frequency Band**: 641 641 642 642 *0x01: EU868 643 643 ... ... @@ -668,7 +668,7 @@ 668 668 *0x0e: MA869 669 669 670 670 671 - **(% style="color:#037691" %)Sub-Band**:668 +(% style="color:#037691" %)**Sub-Band**: 672 672 673 673 AU915 and US915:value 0x00 ~~ 0x08 674 674 ... ... @@ -677,7 +677,7 @@ 677 677 Other Bands: Always 0x00 678 678 679 679 680 - **(% style="color:#037691" %)Battery Info**:677 +(% style="color:#037691" %)**Battery Info**: 681 681 682 682 Check the battery voltage. 683 683 ... ... @@ -724,7 +724,7 @@ 724 724 === 2.4.4 Interrupt Pin === 725 725 726 726 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"]].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"]]. 728 728 729 729 **Example:** 730 730 ... ... @@ -755,7 +755,7 @@ 755 755 756 756 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: 757 757 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 +[[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]]]] 759 759 760 760 761 761 ... ... @@ -768,7 +768,6 @@ 768 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/]] 769 769 770 770 771 - 772 772 == 2.7 Firmware Change Log == 773 773 774 774 ... ... @@ -796,7 +796,7 @@ 796 796 797 797 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 798 798 799 -[[http:~~/~~/wiki.dragino.com/in dex.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]]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/]] 800 800 801 801 802 802 * **Commands special design for SDI-12-LB** ... ... @@ -1020,7 +1020,7 @@ 1020 1020 1021 1021 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1022 1022 1023 -[[image:1675 146710956-626.png]]1019 +[[image:1675234124233-857.png]] 1024 1024 1025 1025 1026 1026 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1053,9 +1053,10 @@ 1053 1053 1054 1054 And the Life expectation in difference case will be shown on the right. 1055 1055 1056 -[[image:1675146895108-304.png]] 1057 1057 1053 +[[image:1675234155374-163.png]] 1058 1058 1055 + 1059 1059 The battery related documents as below: 1060 1060 1061 1061 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]], ... ... @@ -1062,9 +1062,10 @@ 1062 1062 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1063 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]] 1064 1064 1065 -[[image:image-20230131145708-3.png]] 1066 1066 1063 +[[image:image-20230201145019-19.png]] 1067 1067 1065 + 1068 1068 === 4.3.1 Battery Note === 1069 1069 1070 1070 ... ... @@ -1079,7 +1079,6 @@ 1079 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) 1080 1080 1081 1081 1082 - 1083 1083 = 5. Remote Configure device = 1084 1084 1085 1085 == 5.1 Connect via BLE == ... ... @@ -1100,10 +1100,30 @@ 1100 1100 [[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/]] 1101 1101 1102 1102 1100 += 7. FAQ = 1103 1103 1104 -= 7. OrderInfo =1102 +== 7.1 How to use AT Command to access device? == 1105 1105 1106 1106 1105 +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]] 1106 + 1107 + 1108 +== 7.2 How to update firmware via UART port? == 1109 + 1110 + 1111 +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]] 1112 + 1113 + 1114 +== 7.3 How to change the LoRa Frequency Bands/Region? == 1115 + 1116 + 1117 +You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1118 +When downloading the images, choose the required image file for download. 1119 + 1120 + 1121 += 8. Order Info = 1122 + 1123 + 1107 1107 Part Number: SDI-12-LB-XXX 1108 1108 XXX: The default frequency band 1109 1109 ... ... @@ -1122,7 +1122,7 @@ 1122 1122 1123 1123 1124 1124 1125 -= 8. Packing Info =1142 += 9. Packing Info = 1126 1126 1127 1127 1128 1128 **Package Includes**: ... ... @@ -1136,7 +1136,7 @@ 1136 1136 * Package Size / pcs : cm 1137 1137 * Weight / pcs : g 1138 1138 1139 -= 9. Support =1156 += 10. Support = 1140 1140 1141 1141 1142 1142 * 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.