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, 1 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -17,30 +17,39 @@ 17 17 18 18 19 19 20 - 21 21 = 1. Introduction = 22 22 23 23 == 1.1 What is SDI-12 to LoRaWAN Converter == 24 24 25 25 25 +((( 26 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 27 29 +((( 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. 31 +))) 29 29 33 +((( 30 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. 35 +))) 31 31 37 +((( 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. 39 +))) 33 33 41 +((( 34 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. 43 +))) 35 35 45 +((( 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. 47 +))) 37 37 38 38 39 39 [[image:image-20230201084414-1.png||height="464" width="1108"]] 40 40 41 41 42 - 43 - 44 44 == 1.2 Features == 45 45 46 46 ... ... @@ -125,17 +125,17 @@ 125 125 126 126 127 127 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 128 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 1 17px;" %)**Function**|=(% style="width: 225px;" %)**Action**129 -|(% 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" %)((( 130 130 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 131 131 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 132 132 ))) 133 -|(% 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" %)((( 134 134 (% 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. 135 135 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 136 136 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. 137 137 ))) 138 -|(% 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. 139 139 140 140 == 1.7 Pin Mapping == 141 141 ... ... @@ -192,12 +192,9 @@ 192 192 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 193 193 194 194 195 -[[image:image-202301 31134744-2.jpeg]]204 +[[image:image-20230201152430-20.jpeg]] 196 196 197 197 198 - 199 - 200 - 201 201 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 202 202 203 203 ... ... @@ -228,7 +228,6 @@ 228 228 229 229 Press the button for 5 seconds to activate the SDI-12-LB. 230 230 231 - 232 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. 233 233 234 234 ... ... @@ -251,7 +251,6 @@ 251 251 The following is the display information on the serial port and the server. 252 252 253 253 254 - 255 255 [[image:image-20230201091027-6.png]] 256 256 257 257 ... ... @@ -258,6 +258,7 @@ 258 258 [[image:image-20230201091027-7.png||height="261" width="1179"]] 259 259 260 260 265 + 261 261 ==== (% style="color:blue" %)**al! ~-~- Get SDI-12 sensor Identification**(%%) ==== 262 262 263 263 ... ... @@ -266,7 +266,7 @@ 266 266 267 267 (% style="color:#037691" %)**Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 268 268 269 -(% style="color:blue" %)**Example : **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 274 +(% style="color:blue" %)**Example : **(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 270 270 271 271 272 272 The following is the display information on the serial port and the server. ... ... @@ -302,7 +302,7 @@ 302 302 303 303 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 304 304 305 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 310 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. 306 306 307 307 308 308 The following is the display information on the serial port and the server. ... ... @@ -339,7 +339,7 @@ 339 339 340 340 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 341 341 342 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 347 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)__ __to get return. 343 343 344 344 345 345 The following is the display information on the serial port and the server. ... ... @@ -372,13 +372,12 @@ 372 372 373 373 (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement 374 374 375 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return. 380 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. 376 376 377 377 378 378 The following is the display information on the serial port and the server. 379 379 380 380 381 - 382 382 [[image:image-20230201092208-14.png]] 383 383 384 384 ... ... @@ -464,7 +464,7 @@ 464 464 465 465 (% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); 466 466 467 -(% style="color: #red" %)**2**(%%) Check if there is return from SDI-12 sensor471 +(% style="color:red" %)**2**(%%) Check if there is return from SDI-12 sensor 468 468 469 469 (% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 470 470 ... ... @@ -489,10 +489,10 @@ 489 489 490 490 491 491 (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 492 -|(% style="width:1 70px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**493 -|(% style="width:1 70px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33494 -|(% 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 32495 -|(% 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 496 496 497 497 * (% style="color:blue" %)** Downlink Payload:** 498 498 ... ... @@ -548,7 +548,7 @@ 548 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. 549 549 550 550 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 +(% style="color:#4f81bd" %)**For example: **(%%) as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result. 552 552 553 553 554 554 [[image:1675215782925-448.png]] ... ... @@ -563,9 +563,9 @@ 563 563 564 564 (% style="color:#4f81bd" %)**AT+DATAUP=0** 565 565 566 -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__**. 567 567 568 -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__** 569 569 570 570 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 571 571 ... ... @@ -575,12 +575,10 @@ 575 575 576 576 (% style="color:#4f81bd" %)**AT+DATAUP=1** 577 577 578 -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__**. 579 579 580 -Final Payload is 584 +Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ 581 581 582 -__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ 583 - 584 584 1. Battery Info (2 bytes): Battery voltage 585 585 1. PAYVER (1 byte): Defined by AT+PAYVER 586 586 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. ... ... @@ -602,7 +602,7 @@ 602 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.** 603 603 604 604 605 -== 2.4 Uplink Payload ==607 +== 2.4 Uplink Payload == 606 606 607 607 608 608 Uplink payloads have two types: ... ... @@ -755,8 +755,6 @@ 755 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]]]] 756 756 757 757 758 - 759 - 760 760 == 2.6 Frequency Plans == 761 761 762 762 ... ... @@ -770,8 +770,9 @@ 770 770 771 771 **Firmware download link:** 772 772 773 -[[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]] 774 774 775 + 775 775 776 776 = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = 777 777 ... ... @@ -778,12 +778,12 @@ 778 778 779 779 Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. 780 780 781 -* AT Command Connection: See [[FAQ>> path:#AT_COMMAND]].782 +* AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]]. 782 782 * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 783 783 784 784 There are two kinds of commands to configure SDI-12-LB, they are: 785 785 786 -* **(% style="color:blue" %)General Commands**.787 +* (% style="color:blue" %)**General Commands**. 787 787 788 788 These commands are to configure: 789 789 ... ... @@ -795,7 +795,7 @@ 795 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/]] 796 796 797 797 798 -* **(% style="color:blue" %)Commands special design for SDI-12-LB**799 +* (% style="color:blue" %)**Commands special design for SDI-12-LB** 799 799 800 800 These commands only valid for SDI-12-LB, as below: 801 801 ... ... @@ -829,9 +829,6 @@ 829 829 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 830 830 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 831 831 832 - 833 - 834 - 835 835 == 3.2 Set Interrupt Mode == 836 836 837 837 ... ... @@ -863,9 +863,6 @@ 863 863 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 864 864 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 865 865 866 - 867 - 868 - 869 869 == 3.3 Set the output time == 870 870 871 871 ... ... @@ -935,9 +935,6 @@ 935 935 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 936 936 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 937 937 938 - 939 - 940 - 941 941 == 3.4 Set the all data mode == 942 942 943 943 ... ... @@ -960,9 +960,6 @@ 960 960 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 961 961 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 962 962 963 - 964 - 965 - 966 966 == 3.5 Set the splicing payload for uplink == 967 967 968 968 ... ... @@ -1018,9 +1018,6 @@ 1018 1018 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1019 1019 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1020 1020 1021 - 1022 - 1023 - 1024 1024 = 4. Battery & how to replace = 1025 1025 1026 1026 == 4.1 Battery Type == ... ... @@ -1074,7 +1074,6 @@ 1074 1074 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1075 1075 * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]] 1076 1076 1077 - 1078 1078 [[image:image-20230201145019-19.png]] 1079 1079 1080 1080 ... ... @@ -1136,33 +1136,28 @@ 1136 1136 = 8. Order Info = 1137 1137 1138 1138 1139 - **(% style="color:blue" %)Part Number: SDI-12-LB-XXX**1124 +(% style="color:blue" %)**Part Number: SDI-12-LB-XXX** 1140 1140 1141 1141 XXX: The default frequency band 1142 1142 1143 - **(% style="color:red" %)AS923**(%%): LoRaWAN AS923 band1144 - **(% style="color:red" %)AU915**(%%): LoRaWAN AU915 band1145 - **(% style="color:red" %)EU433**(%%): LoRaWAN EU433 band1146 - **(% style="color:red" %)EU868**(%%): LoRaWAN EU868 band1147 - **(% style="color:red" %)KR920**(%%): LoRaWAN KR920 band1148 - **(% style="color:red" %)US915**(%%): LoRaWAN US915 band1149 - **(% style="color:red" %)IN865**(%%): LoRaWAN IN865 band1150 - **(% style="color:red" %)CN470**(%%): LoRaWAN CN470 band1128 +(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 1129 +(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 1130 +(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 1131 +(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 1132 +(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 1133 +(% style="color:red" %)**US915**(%%): LoRaWAN US915 band 1134 +(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1135 +(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1151 1151 1152 1152 1153 - 1154 - 1155 - 1156 - 1157 - 1158 1158 = 9. Packing Info = 1159 1159 1160 1160 1161 - **(% style="color:#037691" %)Package Includes**:1141 +(% style="color:#037691" %)**Package Includes**: 1162 1162 1163 1163 * SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1164 1164 1165 - **(% style="color:#037691" %)Dimension and weight**:1145 +(% style="color:#037691" %)**Dimension and weight**: 1166 1166 1167 1167 * Device Size: cm 1168 1168 * Device Weight: g ... ... @@ -1169,9 +1169,6 @@ 1169 1169 * Package Size / pcs : cm 1170 1170 * Weight / pcs : g 1171 1171 1172 - 1173 - 1174 - 1175 1175 = 10. Support = 1176 1176 1177 1177
- image-20230201152430-20.jpeg
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +16.5 KB - Content