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 ... ... @@ -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]]796 +[[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]]1020 +[[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 1054 +[[image:1675234155374-163.png]] 1058 1058 1056 + 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 1064 +[[image:image-20230201145019-19.png]] 1067 1067 1066 + 1068 1068 === 4.3.1 Battery Note === 1069 1069 1070 1070 ... ... @@ -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 1102 += 7. FAQ = 1103 1103 1104 -= 7. OrderInfo =1104 +== 7.1 How to use AT Command to access device? == 1105 1105 1106 1106 1107 +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]] 1108 + 1109 + 1110 +== 7.2 How to update firmware via UART port? == 1111 + 1112 + 1113 +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]] 1114 + 1115 + 1116 +== 7.3 How to change the LoRa Frequency Bands/Region? == 1117 + 1118 + 1119 +You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1120 +When downloading the images, choose the required image file for download. 1121 + 1122 + 1123 += 8. Order Info = 1124 + 1125 + 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 =1144 += 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 =1158 += 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.