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
-
... ... @@ -22,24 +22,34 @@ 22 22 == 1.1 What is SDI-12 to LoRaWAN Converter == 23 23 24 24 25 +((( 25 25 The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. 27 +))) 26 26 29 +((( 27 27 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. 31 +))) 28 28 33 +((( 29 29 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. 35 +))) 30 30 37 +((( 31 31 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. 39 +))) 32 32 41 +((( 33 33 SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 43 +))) 34 34 45 +((( 35 35 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. 47 +))) 36 36 37 37 38 38 [[image:image-20230201084414-1.png||height="464" width="1108"]] 39 39 40 40 41 - 42 - 43 43 == 1.2 Features == 44 44 45 45 ... ... @@ -124,17 +124,17 @@ 124 124 125 125 126 126 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 127 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 1 17px;" %)**Function**|=(% style="width: 225px;" %)**Action**128 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:1 17px" %)Send an uplink|(% style="width:225px" %)(((137 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action** 138 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)((( 129 129 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 130 130 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 131 131 ))) 132 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:1 17px" %)Active Device|(% style="width:225px" %)(((142 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)((( 133 133 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. 134 134 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 135 135 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network. 136 136 ))) 137 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:1 17px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.147 +|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:109px" %)Deactivate Device|(% style="width:231px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode. 138 138 139 139 == 1.7 Pin Mapping == 140 140 ... ... @@ -224,7 +224,6 @@ 224 224 225 225 Press the button for 5 seconds to activate the SDI-12-LB. 226 226 227 - 228 228 (% 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. 229 229 230 230 ... ... @@ -247,7 +247,6 @@ 247 247 The following is the display information on the serial port and the server. 248 248 249 249 250 - 251 251 [[image:image-20230201091027-6.png]] 252 252 253 253 ... ... @@ -254,6 +254,7 @@ 254 254 [[image:image-20230201091027-7.png||height="261" width="1179"]] 255 255 256 256 265 + 257 257 ==== (% style="color:blue" %)**al! ~-~- Get SDI-12 sensor Identification**(%%) ==== 258 258 259 259 ... ... @@ -262,7 +262,7 @@ 262 262 263 263 (% style="color:#037691" %)**Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 264 264 265 -(% style="color:blue" %)**Example : **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 274 +(% style="color:blue" %)**Example : **(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 266 266 267 267 268 268 The following is the display information on the serial port and the server. ... ... @@ -298,7 +298,7 @@ 298 298 299 299 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 300 300 301 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 310 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. 302 302 303 303 304 304 The following is the display information on the serial port and the server. ... ... @@ -335,7 +335,7 @@ 335 335 336 336 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 337 337 338 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 347 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)__ __to get return. 339 339 340 340 341 341 The following is the display information on the serial port and the server. ... ... @@ -368,13 +368,12 @@ 368 368 369 369 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 370 370 371 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 380 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. 372 372 373 373 374 374 The following is the display information on the serial port and the server. 375 375 376 376 377 - 378 378 [[image:image-20230201092208-14.png]] 379 379 380 380 ... ... @@ -460,7 +460,7 @@ 460 460 461 461 (% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 462 462 463 -(% style="color: #red" %)**2**(%%) Check if there is return from SDI-12 sensor471 +(% style="color:red" %)**2**(%%) Check if there is return from SDI-12 sensor 464 464 465 465 (% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 466 466 ... ... @@ -485,10 +485,10 @@ 485 485 486 486 487 487 (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 488 -|(% style="width:1 70px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**489 -|(% style="width:1 70px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33490 -|(% style="width:1 70px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32491 -|(% style="width:1 70px" %)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 0A496 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload** 497 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33 498 +|(% style="width:164px" %)34,2,1~~8+12~~16|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 499 +|(% style="width:164px" %)34,2,1~~34|(% style="width:344px" %)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 492 492 493 493 * (% style="color:blue" %)** Downlink Payload:** 494 494 ... ... @@ -513,6 +513,7 @@ 513 513 [[image:image-20230201094129-18.png]] 514 514 515 515 524 + 516 516 (% style="color:blue" %)**Clear SDI12 Command** 517 517 518 518 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. ... ... @@ -544,7 +544,7 @@ 544 544 (% 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. 545 545 546 546 547 -(% style="color:#4f81bd" %)**For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result. 556 +(% 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. 548 548 549 549 550 550 [[image:1675215782925-448.png]] ... ... @@ -556,12 +556,11 @@ 556 556 557 557 (% style="color:blue" %)**Compose Uplink** 558 558 559 - 560 560 (% style="color:#4f81bd" %)**AT+DATAUP=0** 561 561 562 -Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 570 +Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**. 563 563 564 -Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx 572 +Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__** 565 565 566 566 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 567 567 ... ... @@ -571,12 +571,10 @@ 571 571 572 572 (% style="color:#4f81bd" %)**AT+DATAUP=1** 573 573 574 -Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 582 +Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**. 575 575 576 -Final Payload is 584 +Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ 577 577 578 -__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ 579 - 580 580 1. Battery Info (2 bytes): Battery voltage 581 581 1. PAYVER (1 byte): Defined by AT+PAYVER 582 582 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. ... ... @@ -616,10 +616,10 @@ 616 616 617 617 Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink. 618 618 619 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:4 37px" %)625 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %) 620 620 |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)** 621 -|(% style="width:1 02px" %)**Size67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**622 -|(% style="width:1 02px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT627 +|(% style="width:114px" %)**Size(bytes)**|(% style="width:39px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:59px" %)**1**|(% style="width:37px" %)**2** 628 +|(% style="width:114px" %)**Value**|(% style="width:39px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:59px" %)Sub-band|(% style="width:37px" %)BAT 623 623 624 624 Example parse in TTNv3 625 625 ... ... @@ -751,8 +751,6 @@ 751 751 [[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]]]] 752 752 753 753 754 - 755 - 756 756 == 2.6 Frequency Plans == 757 757 758 758 ... ... @@ -766,8 +766,9 @@ 766 766 767 767 **Firmware download link:** 768 768 769 -[[https:~~/~~/www.dropbox.com/sh/g f1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]773 +[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]] 770 770 775 + 771 771 772 772 = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = 773 773 ... ... @@ -825,7 +825,6 @@ 825 825 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 826 826 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 827 827 828 - 829 829 == 3.2 Set Interrupt Mode == 830 830 831 831 ... ... @@ -857,7 +857,6 @@ 857 857 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 858 858 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 859 859 860 - 861 861 == 3.3 Set the output time == 862 862 863 863 ... ... @@ -927,7 +927,6 @@ 927 927 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 928 928 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 929 929 930 - 931 931 == 3.4 Set the all data mode == 932 932 933 933 ... ... @@ -950,7 +950,6 @@ 950 950 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 951 951 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 952 952 953 - 954 954 == 3.5 Set the splicing payload for uplink == 955 955 956 956 ... ... @@ -1006,7 +1006,6 @@ 1006 1006 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1007 1007 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1008 1008 1009 - 1010 1010 = 4. Battery & how to replace = 1011 1011 1012 1012 == 4.1 Battery Type == ... ... @@ -1135,11 +1135,6 @@ 1135 1135 (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1136 1136 1137 1137 1138 - 1139 - 1140 - 1141 - 1142 - 1143 1143 = 9. Packing Info = 1144 1144 1145 1145 ... ... @@ -1154,7 +1154,6 @@ 1154 1154 * Package Size / pcs : cm 1155 1155 * Weight / pcs : g 1156 1156 1157 - 1158 1158 = 10. Support = 1159 1159 1160 1160