Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Mengting Qiu on 2025/07/03 15:42
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 3 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -3,6 +3,7 @@ 3 3 4 4 **Table of Contents:** 5 5 6 +{{toc/}} 6 6 7 7 8 8 ... ... @@ -16,22 +16,23 @@ 16 16 17 17 18 18 20 + 19 19 = 1. Introduction = 20 20 21 21 == 1.1 What is SDI-12 to LoRaWAN Converter == 22 22 23 23 24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution. 26 +The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. 25 25 26 26 SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors. 27 27 28 - **SDI-12-LB**has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol.30 +SDI-12-LB has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol. 29 29 30 -The LoRa wireless technology used in **SDI-12-LB**allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.32 +The LoRa wireless technology used in SDI-12-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. 31 31 32 - **SDI-12-LB**is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.34 +SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 33 33 34 -Each **SDI-12-LB**is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.36 +Each SDI-12-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 35 35 36 36 37 37 [[image:image-20230201084414-1.png||height="464" width="1108"]] ... ... @@ -39,8 +39,6 @@ 39 39 40 40 41 41 42 - 43 - 44 44 == 1.2 Features == 45 45 46 46 ... ... @@ -59,18 +59,18 @@ 59 59 == 1.3 Specification == 60 60 61 61 62 -**Micro Controller:** 62 +(% style="color:#037691" %)**Micro Controller:** 63 63 64 64 * MCU: 48Mhz ARM 65 65 * Flash: 256KB 66 66 * RAM: 64KB 67 67 68 -**Common DC Characteristics:** 68 +(% style="color:#037691" %)**Common DC Characteristics:** 69 69 70 70 * Supply Voltage: 2.5v ~~ 3.6v 71 71 * Operating Temperature: -40 ~~ 85°C 72 72 73 -**LoRa Spec:** 73 +(% style="color:#037691" %)**LoRa Spec:** 74 74 75 75 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 76 76 * Max +22 dBm constant RF output vs. ... ... @@ -77,19 +77,19 @@ 77 77 * RX sensitivity: down to -139 dBm. 78 78 * Excellent blocking immunity 79 79 80 -**Current Input Measuring :** 80 +(% style="color:#037691" %)**Current Input Measuring :** 81 81 82 82 * Range: 0 ~~ 20mA 83 83 * Accuracy: 0.02mA 84 84 * Resolution: 0.001mA 85 85 86 -**Voltage Input Measuring:** 86 +(% style="color:#037691" %)**Voltage Input Measuring:** 87 87 88 88 * Range: 0 ~~ 30v 89 89 * Accuracy: 0.02v 90 90 * Resolution: 0.001v 91 91 92 -**Battery:** 92 +(% style="color:#037691" %)**Battery:** 93 93 94 94 * Li/SOCI2 un-chargeable battery 95 95 * Capacity: 8500mAh ... ... @@ -97,7 +97,7 @@ 97 97 * Max continuously current: 130mA 98 98 * Max boost current: 2A, 1 second 99 99 100 -**Power Consumption** 100 +(% style="color:#037691" %)**Power Consumption** 101 101 102 102 * Sleep Mode: 5uA @ 3.3v 103 103 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm ... ... @@ -112,9 +112,9 @@ 112 112 == 1.5 Sleep mode and working mode == 113 113 114 114 115 -**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life. 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. 116 116 117 -**Working Mode: **In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 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. 118 118 119 119 120 120 == 1.6 Button & LEDs == ... ... @@ -160,9 +160,6 @@ 160 160 == 1.9 Mechanical == 161 161 162 162 163 - 164 - 165 - 166 166 [[image:image-20230201090139-2.png]] 167 167 168 168 [[image:image-20230201090139-3.png]] ... ... @@ -175,7 +175,7 @@ 175 175 == 2.1 How it works == 176 176 177 177 178 -The SDI-12-LB is configured as **LoRaWAN OTAA Class A** mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes. 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 -**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 -**Register the device** 204 +(% style="color:blue" %)**Register the device** 208 208 209 209 [[image:1675213652444-622.png]] 210 210 211 211 212 -**Add APP EUI and DEV EUI** 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 -**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 -**Add APP KEY** 221 +(% style="color:blue" %)**Add APP KEY** 225 225 226 226 [[image:1675213686734-883.png]] 227 227 228 228 229 -**Step 2**: Activate on SDI-12-LB 226 +(% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB 230 230 231 231 232 232 Press the button for 5 seconds to activate the SDI-12-LB. 233 233 234 234 235 -**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network. 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 -==== **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 -**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 -**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,30 +281,31 @@ 281 281 [[image:image-20230201091257-9.png||height="225" width="1242"]] 282 282 283 283 284 -==== **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ==== 281 +==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ==== 285 285 286 286 287 -**aM! **: Start Non-Concurrent Measurement 284 +(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement 288 288 289 -**aMC! **: Start Non-Concurrent Measurement – Request CRC 286 +(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC 290 290 291 -**aM1!- aM9! **: Additional Measurements 288 +(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements 292 292 293 -**aMC1!- aMC9!** : Additional Measurements – Request CRC 290 +(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 294 294 295 295 296 296 * AT Command : AT+ADDRM=0,1,0,1 294 + 297 297 * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 298 298 299 299 Downlink:AA 01 aa bb cc dd 300 300 301 -**aa**: SDI-12 sensor address. 299 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 302 302 303 -**bb**: 0: no CRC, 1: request CRC 301 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 304 304 305 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 303 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 306 306 307 -**dd**: delay (in second) to send **aD0!** to get return. 305 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 308 308 309 309 310 310 The following is the display information on the serial port and the server. ... ... @@ -317,16 +317,16 @@ 317 317 318 318 319 319 320 -==== **aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! ** ==== 318 +==== (% style="color:blue" %)**aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! **(%%) ==== 321 321 322 322 323 -**aC!** : Start Concurrent Measurement 321 +(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement 324 324 325 -**aCC!** : Start Concurrent Measurement – Request CRC 323 +(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC 326 326 327 -**aC1!- aC9!** : Start Additional Concurrent Measurements 325 +(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 328 328 329 -**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC 327 +(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 330 330 331 331 332 332 * AT Command : AT+ADDRC=0,1,0,1 ... ... @@ -335,13 +335,13 @@ 335 335 336 336 Downlink: AA 02 aa bb cc dd 337 337 338 -**aa**: SDI-12 sensor address. 336 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 339 339 340 -**bb**: 0: no CRC, 1: request CRC 338 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 341 341 342 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 340 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 343 343 344 -**dd**: delay (in second) to send **aD0!** to get return. 342 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 345 345 346 346 347 347 The following is the display information on the serial port and the server. ... ... @@ -353,11 +353,11 @@ 353 353 [[image:image-20230201091954-13.png||height="203" width="1117"]] 354 354 355 355 356 -(% style="display:none" %) (%%) 357 357 358 -==== **aR0!- aR9!, aRC0!- aRC9!** ==== 359 359 356 +==== (% style="color:blue" %)**aR0!- aR9!, aRC0!- aRC9!**(%%) ==== 360 360 358 + 361 361 Start Continuous Measurement 362 362 363 363 Start Continuous Measurement – Request CRC ... ... @@ -368,13 +368,13 @@ 368 368 369 369 Downlink: AA 03 aa bb cc dd 370 370 371 -**aa**: SDI-12 sensor address. 369 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. 372 372 373 -**bb**: 0: no CRC, 1: request CRC 371 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC 374 374 375 -**cc**: 1-9: Additional Measurement, 0: no additional measurement 373 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 376 376 377 -**dd**: delay (in second) to send **aD0!** to get return. 375 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 378 378 379 379 380 380 The following is the display information on the serial port and the server. ... ... @@ -395,20 +395,20 @@ 395 395 396 396 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 397 397 398 -**aa **: total SDI-12 command length 396 +(% style="color:#037691" %)**aa **(%%): total SDI-12 command length 399 399 400 -**xx **: SDI-12 command 398 +(% style="color:#037691" %)**xx **(%%): SDI-12 command 401 401 402 -**bb **: Delay to wait for return 400 +(% style="color:#037691" %)**bb **(%%): Delay to wait for return 403 403 404 -**cc **: 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 402 +(% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 405 405 406 406 407 -**Example: **AT+CFGDEV =0RC0!,1 405 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1 408 408 409 -**0RC0! **: SDI-12 Command, 407 +(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command, 410 410 411 -**1 **: Delay 1 second. ( 0: 810 mini-second) 409 +(% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second) 412 412 413 413 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 414 414 ... ... @@ -430,7 +430,7 @@ 430 430 AT+CONVFORM ( Max length: 80 bytes) 431 431 432 432 433 -**Example:** 431 +(% style="color:blue" %)**Example:** 434 434 435 435 1) AT+CONVFORM=0, string Convert String from String to ASCII 436 436 ... ... @@ -450,31 +450,31 @@ 450 450 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. 451 451 452 452 453 -* ** 451 +* (% style="color:blue" %)**AT Command:** 454 454 455 -**AT+COMMANDx=var1,var2,var3,var4.** 453 +(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.** 456 456 457 -**var1**: SDI-12 command , for example: 0RC0! 455 +(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0! 458 458 459 -**var2**: Wait timeout for return. (unit: second) 457 +(% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second) 460 460 461 -**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!//. 462 462 463 -**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. 464 464 465 -**0 ** No validation check; 463 +(% style="color:red" %)**0 **(%%) No validation check; 466 466 467 -**1** 465 +(% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 468 468 469 -**2** Check if there is return from SDI-12 sensor 467 +(% style="color:#red" %)**2**(%%) Check if there is return from SDI-12 sensor 470 470 471 -**3** 469 +(% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 472 472 473 473 474 -Each AT+COMMANDx is followed by a **AT+DATACUT** command. AT+DATACUT command is used to take the useful string from the SDI-12 sensor so the final payload will have the minimum length to uplink. 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 475 476 476 477 -**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. 478 478 479 479 (% border="1" style="background-color:#f7faff; width:436px" %) 480 480 |(% style="width:433px" %)((( ... ... @@ -482,7 +482,7 @@ 482 482 483 483 **a**: length for the return of AT+COMMAND 484 484 485 -**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 483 +**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 486 486 487 487 **c**: define the position for valid value. 488 488 ))) ... ... @@ -496,49 +496,49 @@ 496 496 |(% 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 497 497 |(% 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 498 498 499 -* ** Downlink Payload:** 497 +* (% style="color:blue" %)** Downlink Payload:** 500 500 501 -**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. 502 502 503 503 504 -**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.** 505 505 506 506 507 -Format: ** AF MM NN LL XX XX XX XX YY** 505 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)** 508 508 509 509 Where: 510 510 511 -* **MM **: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 512 -* **NN **: 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value. 513 -* **LL **: The length of AT+COMMAND or AT+DATACUT command 514 -* **XX XX XX XX **: AT+COMMAND or AT+DATACUT command 515 -* **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. 516 516 517 -**Example:** 515 +(% style="color:blue" %)**Example:** 518 518 519 519 [[image:image-20230201094129-18.png]] 520 520 521 521 522 -**Clear SDI12 Command** 520 +(% style="color:blue" %)**Clear SDI12 Command** 523 523 524 524 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 525 525 526 526 527 -* ** 525 +* (% style="color:#037691" %)**AT Command:** 528 528 529 -** ~AT+CMDEAR=mm,nn**527 +(% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase 530 530 531 531 532 532 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 533 533 534 534 535 -* ** Downlink Payload:** 533 +* (% style="color:#037691" %)** Downlink Payload:** 536 536 537 -** ~0x09 aa bb** same as AT+CMDEAR=aa,bb535 +(% style="color:#4f81bd" %)**0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb 538 538 539 539 540 540 541 -**command combination** 539 +(% style="color:blue" %)**command combination** 542 542 543 543 Below shows a screen shot how the results combines together to a uplink payload. 544 544 ... ... @@ -547,23 +547,23 @@ 547 547 548 548 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. 549 549 550 -**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. 551 551 552 552 553 -**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. 554 554 555 555 556 556 [[image:1675215782925-448.png]] 557 557 558 558 559 -If AT+ALLDATAMOD=1, **FX,X** will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes. 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. 560 560 561 561 562 562 563 -**Compose Uplink** 561 +(% style="color:blue" %)**Compose Uplink** 564 564 565 565 566 -**AT+DATAUP=0** 564 +(% style="color:#4f81bd" %)**AT+DATAUP=0** 567 567 568 568 Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 569 569 ... ... @@ -575,7 +575,7 @@ 575 575 [[image:1675215828102-844.png]] 576 576 577 577 578 -**AT+DATAUP=1** 576 +(% style="color:#4f81bd" %)**AT+DATAUP=1** 579 579 580 580 Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 581 581 ... ... @@ -592,7 +592,7 @@ 592 592 [[image:1675215848113-696.png]] 593 593 594 594 595 -**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:** 596 596 597 597 * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 598 598 * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). ... ... @@ -599,9 +599,9 @@ 599 599 * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 600 600 * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 601 601 602 -** ~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;** 603 603 604 -** ~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.** 605 605 606 606 607 607 == 2.4 Uplink Payload == ... ... @@ -632,11 +632,11 @@ 632 632 [[image:1675215946738-635.png]] 633 633 634 634 635 -**Sensor Model**: For SDI-12-LB, this value is 0x17 633 +(% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17 636 636 637 -**Firmware Version**: 0x0100, Means: v1.0.0 version 635 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 638 638 639 -**Frequency Band**: 637 +(% style="color:#037691" %)**Frequency Band**: 640 640 641 641 *0x01: EU868 642 642 ... ... @@ -667,7 +667,7 @@ 667 667 *0x0e: MA869 668 668 669 669 670 -**Sub-Band**: 668 +(% style="color:#037691" %)**Sub-Band**: 671 671 672 672 AU915 and US915:value 0x00 ~~ 0x08 673 673 ... ... @@ -676,7 +676,7 @@ 676 676 Other Bands: Always 0x00 677 677 678 678 679 -**Battery Info**: 677 +(% style="color:#037691" %)**Battery Info**: 680 680 681 681 Check the battery voltage. 682 682 ... ... @@ -702,7 +702,7 @@ 702 702 Battery(mV) 703 703 & 704 704 Interrupt_Flag 705 -)))|(% style="width:70px" %)[[PAYLOAD_VER>> path:#Probe_Model]]|(% style="width:234px" %)(((703 +)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)((( 706 706 If the valid payload is too long and exceed the maximum support. 707 707 Payload length in server,server will show payload not provided in the LoRaWAN server. 708 708 ))) ... ... @@ -723,7 +723,7 @@ 723 723 === 2.4.4 Interrupt Pin === 724 724 725 725 726 -This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>> path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>path:#pins]].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 727 728 728 **Example:** 729 729 ... ... @@ -754,7 +754,7 @@ 754 754 755 755 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: 756 756 757 -[[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]]]] 758 758 759 759 760 760 ... ... @@ -767,7 +767,6 @@ 767 767 [[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/]] 768 768 769 769 770 - 771 771 == 2.7 Firmware Change Log == 772 772 773 773 ... ... @@ -795,7 +795,7 @@ 795 795 796 796 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 797 797 798 -[[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/]] 799 799 800 800 801 801 * **Commands special design for SDI-12-LB** ... ... @@ -1019,7 +1019,7 @@ 1019 1019 1020 1020 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1021 1021 1022 -[[image:1675 146710956-626.png]]1019 +[[image:1675234124233-857.png]] 1023 1023 1024 1024 1025 1025 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1052,9 +1052,10 @@ 1052 1052 1053 1053 And the Life expectation in difference case will be shown on the right. 1054 1054 1055 -[[image:1675146895108-304.png]] 1056 1056 1053 +[[image:1675234155374-163.png]] 1057 1057 1055 + 1058 1058 The battery related documents as below: 1059 1059 1060 1060 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]], ... ... @@ -1061,9 +1061,10 @@ 1061 1061 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1062 1062 * [[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]] 1063 1063 1064 -[[image:image-20230131145708-3.png]] 1065 1065 1063 +[[image:image-20230201145019-19.png]] 1066 1066 1065 + 1067 1067 === 4.3.1 Battery Note === 1068 1068 1069 1069 ... ... @@ -1078,7 +1078,6 @@ 1078 1078 The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes) 1079 1079 1080 1080 1081 - 1082 1082 = 5. Remote Configure device = 1083 1083 1084 1084 == 5.1 Connect via BLE == ... ... @@ -1099,10 +1099,30 @@ 1099 1099 [[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/]] 1100 1100 1101 1101 1100 += 7. FAQ = 1102 1102 1103 -= 7. OrderInfo =1102 +== 7.1 How to use AT Command to access device? == 1104 1104 1105 1105 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 + 1106 1106 Part Number: SDI-12-LB-XXX 1107 1107 XXX: The default frequency band 1108 1108 ... ... @@ -1121,7 +1121,7 @@ 1121 1121 1122 1122 1123 1123 1124 -= 8. Packing Info =1142 += 9. Packing Info = 1125 1125 1126 1126 1127 1127 **Package Includes**: ... ... @@ -1135,7 +1135,7 @@ 1135 1135 * Package Size / pcs : cm 1136 1136 * Weight / pcs : g 1137 1137 1138 -= 9. Support =1156 += 10. Support = 1139 1139 1140 1140 1141 1141 * 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.
- 1675234124233-857.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +75.8 KB - Content
- 1675234155374-163.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +138.2 KB - Content
- image-20230201145019-19.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +82.2 KB - Content