Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Xiaoling on 2025/04/25 08:58
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,5 +1,5 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-20230131183542-1.jpeg|| _mstalt="470678"height="694" width="694"]]2 +[[image:image-20230131183542-1.jpeg||height="694" width="694"]] 3 3 4 4 **Table of Contents:** 5 5 ... ... @@ -47,7 +47,7 @@ 47 47 ))) 48 48 49 49 50 -[[image:image-20230201084414-1.png|| _mstalt="427765"height="464" width="1108"]]50 +[[image:image-20230201084414-1.png||height="464" width="1108"]] 51 51 52 52 53 53 == 1.2 Features == ... ... @@ -65,7 +65,6 @@ 65 65 * Downlink to change configure 66 66 * 8500mAh Battery for long term use 67 67 68 - 69 69 == 1.3 Specification == 70 70 71 71 ... ... @@ -78,8 +78,6 @@ 78 78 (% style="color:#037691" %)**Common DC Characteristics:** 79 79 80 80 * Supply Voltage: 2.5v ~~ 3.6v 81 -* Support current: 5V 300mA 82 - 12V 100mA 83 83 * Operating Temperature: -40 ~~ 85°C 84 84 85 85 (% style="color:#037691" %)**LoRa Spec:** ... ... @@ -114,12 +114,11 @@ 114 114 * Sleep Mode: 5uA @ 3.3v 115 115 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 116 116 117 - 118 118 == 1.4 Connect to SDI-12 Sensor == 119 119 120 120 121 121 122 -[[image:1675212538524-889.png ||_mstalt="298272"]]118 +[[image:1675212538524-889.png]] 123 123 124 124 125 125 == 1.5 Sleep mode and working mode == ... ... @@ -133,7 +133,7 @@ 133 133 == 1.6 Button & LEDs == 134 134 135 135 136 -[[image:1675212633011-651.png ||_mstalt="291538"]]132 +[[image:1675212633011-651.png]] 137 137 138 138 139 139 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) ... ... @@ -149,11 +149,10 @@ 149 149 ))) 150 150 |(% 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 SDI-12-LB is in Deep Sleep Mode. 151 151 152 - 153 153 == 1.7 Pin Mapping == 154 154 155 155 156 -[[image:1675213198663-754.png ||_mstalt="297167"]]151 +[[image:1675213198663-754.png]] 157 157 158 158 159 159 == 1.8 BLE connection == ... ... @@ -173,11 +173,11 @@ 173 173 == 1.9 Mechanical == 174 174 175 175 176 -[[image:image-20230201090139-2.png ||_mstalt="428623"]]171 +[[image:image-20230201090139-2.png]] 177 177 178 -[[image:image-20230201090139-3.png ||_mstalt="428987"]]173 +[[image:image-20230201090139-3.png]] 179 179 180 -[[image:image-20230201090139-4.png ||_mstalt="429351"]]175 +[[image:image-20230201090139-4.png]] 181 181 182 182 183 183 = 2. Configure SDI-12 to connect to LoRaWAN network = ... ... @@ -194,7 +194,7 @@ 194 194 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example. 195 195 196 196 197 -[[image:image-20230201090528-5.png|| _mstalt="430300"height="465" width="1111"]]192 +[[image:image-20230201090528-5.png||height="465" width="1111"]] 198 198 199 199 200 200 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. ... ... @@ -205,7 +205,7 @@ 205 205 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 206 206 207 207 208 -[[image:image-20230201152430-20.jpeg ||_mstalt="492245"]]203 +[[image:image-20230201152430-20.jpeg]] 209 209 210 210 211 211 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: ... ... @@ -213,24 +213,24 @@ 213 213 214 214 (% style="color:blue" %)**Register the device** 215 215 216 -[[image:1675213652444-622.png ||_mstalt="293657"]]211 +[[image:1675213652444-622.png]] 217 217 218 218 219 219 (% style="color:blue" %)**Add APP EUI and DEV EUI** 220 220 221 221 222 -[[image:1675213661769-223.png ||_mstalt="295217"]]217 +[[image:1675213661769-223.png]] 223 223 224 224 225 225 (% style="color:blue" %)**Add APP EUI in the application** 226 226 227 227 228 -[[image:1675213675852-577.png ||_mstalt="297947"]]223 +[[image:1675213675852-577.png]] 229 229 230 230 231 231 (% style="color:blue" %)**Add APP KEY** 232 232 233 -[[image:1675213686734-883.png ||_mstalt="298064"]]228 +[[image:1675213686734-883.png]] 234 234 235 235 236 236 (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB ... ... @@ -241,7 +241,7 @@ 241 241 (% 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. 242 242 243 243 244 -[[image:1675213704414-644.png ||_mstalt="293748"]]239 +[[image:1675213704414-644.png]] 245 245 246 246 247 247 == 2.3 SDI-12 Related Commands == ... ... @@ -260,10 +260,10 @@ 260 260 The following is the display information on the serial port and the server. 261 261 262 262 263 -[[image:image-20230201091027-6.png ||_mstalt="429065"]]258 +[[image:image-20230201091027-6.png]] 264 264 265 265 266 -[[image:image-20230201091027-7.png|| _mstalt="429429"height="261" width="1179"]]261 +[[image:image-20230201091027-7.png||height="261" width="1179"]] 267 267 268 268 269 269 ... ... @@ -281,10 +281,10 @@ 281 281 The following is the display information on the serial port and the server. 282 282 283 283 284 -[[image:image-20230201091257-8.png ||_mstalt="431392"]]279 +[[image:image-20230201091257-8.png]] 285 285 286 286 287 -[[image:image-20230201091257-9.png|| _mstalt="431756"height="225" width="1242"]]282 +[[image:image-20230201091257-9.png||height="225" width="1242"]] 288 288 289 289 290 290 ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ==== ... ... @@ -317,10 +317,10 @@ 317 317 The following is the display information on the serial port and the server. 318 318 319 319 320 -[[image:image-20230201091630-10.png ||_mstalt="449995"]]315 +[[image:image-20230201091630-10.png]] 321 321 322 322 323 -[[image:image-20230201091630-11.png|| _mstalt="450372"height="247" width="1165"]]318 +[[image:image-20230201091630-11.png||height="247" width="1165"]] 324 324 325 325 326 326 ... ... @@ -354,10 +354,10 @@ 354 354 The following is the display information on the serial port and the server. 355 355 356 356 357 -[[image:image-20230201091954-12.png ||_mstalt="453687"]]352 +[[image:image-20230201091954-12.png]] 358 358 359 359 360 -[[image:image-20230201091954-13.png|| _mstalt="454064"height="203" width="1117"]]355 +[[image:image-20230201091954-13.png||height="203" width="1117"]] 361 361 362 362 363 363 ... ... @@ -387,10 +387,10 @@ 387 387 The following is the display information on the serial port and the server. 388 388 389 389 390 -[[image:image-20230201092208-14.png ||_mstalt="452283"]]385 +[[image:image-20230201092208-14.png]] 391 391 392 392 393 -[[image:image-20230201092208-15.png|| _mstalt="452660"height="214" width="1140"]]388 +[[image:image-20230201092208-15.png||height="214" width="1140"]] 394 394 395 395 396 396 === 2.3.2 Advance SDI-12 Debug command === ... ... @@ -422,10 +422,10 @@ 422 422 The following is the display information on the serial port and the server. 423 423 424 424 425 -[[image:image-20230201092355-16.png ||_mstalt="453960"]]420 +[[image:image-20230201092355-16.png]] 426 426 427 427 428 -[[image:image-20230201092355-17.png|| _mstalt="454337"height="426" width="1135"]]423 +[[image:image-20230201092355-17.png||height="426" width="1135"]] 429 429 430 430 431 431 === 2.3.3 Convert ASCII to String === ... ... @@ -440,12 +440,12 @@ 440 440 441 441 1) AT+CONVFORM=0, string Convert String from String to ASCII 442 442 443 -[[image:1675214845056-885.png ||_mstalt="297622"]]438 +[[image:1675214845056-885.png]] 444 444 445 445 446 446 2) AT+CONVFORM=1, ASCII Convert ASCII to String. 447 447 448 -[[image:1675214856590-846.png ||_mstalt="297739"]]443 +[[image:1675214856590-846.png]] 449 449 450 450 451 451 === 2.3.4 Define periodically SDI-12 commands and uplink. === ... ... @@ -522,7 +522,7 @@ 522 522 523 523 (% style="color:blue" %)**Example:** 524 524 525 -[[image:image-20230201094129-18.png ||_mstalt="455065"]]520 +[[image:image-20230201094129-18.png]] 526 526 527 527 528 528 ... ... @@ -549,7 +549,7 @@ 549 549 550 550 Below shows a screen shot how the results combines together to a uplink payload. 551 551 552 -[[image:1675215745275-920.png ||_mstalt="295334"]]547 +[[image:1675215745275-920.png]] 553 553 554 554 555 555 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. ... ... @@ -560,7 +560,7 @@ 560 560 (% 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. 561 561 562 562 563 -[[image:1675215782925-448.png ||_mstalt="297466"]]558 +[[image:1675215782925-448.png]] 564 564 565 565 566 566 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. ... ... @@ -578,7 +578,7 @@ 578 578 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 579 579 580 580 581 -[[image:1675215828102-844.png ||_mstalt="294645"]]576 +[[image:1675215828102-844.png]] 582 582 583 583 584 584 (% style="color:#4f81bd" %)**AT+DATAUP=1** ... ... @@ -593,7 +593,7 @@ 593 593 1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT) 594 594 1. DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes 595 595 596 -[[image:1675215848113-696.png ||_mstalt="296998"]]591 +[[image:1675215848113-696.png]] 597 597 598 598 599 599 (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** ... ... @@ -624,7 +624,7 @@ 624 624 625 625 Example parse in TTNv3 626 626 627 -[[image:1675215946738-635.png ||_mstalt="297778"]]622 +[[image:1675215946738-635.png]] 628 628 629 629 630 630 (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17 ... ... @@ -702,7 +702,7 @@ 702 702 Payload length in server,server will show payload not provided in the LoRaWAN server. 703 703 ))) 704 704 705 -[[image:1675216282284-923.png ||_mstalt="295633"]]700 +[[image:1675216282284-923.png]] 706 706 707 707 708 708 === 2.4.3 Battery Info === ... ... @@ -737,7 +737,7 @@ 737 737 738 738 While using TTN network, you can add the payload format to decode the payload. 739 739 740 -[[image:1675216779406-595.png ||_mstalt="298376"]]735 +[[image:1675216779406-595.png]] 741 741 742 742 743 743 There is no fix payload decoder in LoRaWAN server because the SDI-12 sensors returns are different. User need to write the decoder themselves for their case. ... ... @@ -750,7 +750,7 @@ 750 750 751 751 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: 752 752 753 -[[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]] 748 +[[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]]]] 754 754 755 755 756 756 == 2.6 Examples To Set SDI commands. == ... ... @@ -757,69 +757,68 @@ 757 757 758 758 === 2.6.1 Examples 1 === 759 759 760 - 761 761 COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication. 762 762 763 -[[image:image-20230222143809-1.png|| _mstalt="429962"height="564" width="729"]]757 +[[image:image-20230222143809-1.png||height="564" width="729"]] 764 764 759 +1)The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor: 765 765 766 - (% style="color:blue" %)**1) The AT+COMMANDx commandis appliedto the red arrow part, andsendstheSDI12command totheSDI12sensor:**761 +a.Send the first command and get the first reply: 767 767 768 - a. Send the first command and get the first reply:763 +AT+COMMANDx=1I!,0,0,1 769 769 770 - (%style="color:#037691"%)**AT+COMMANDx=1I!,0,0,1**765 +b.Send the second command and get the second reply: 771 771 772 - b. Send the second command and get the second reply:767 +AT+COMMANDx=2I!,0,0,1 773 773 774 - (%style="color:#037691"%)**AT+COMMANDx=2I!,0,0,1**769 +c.Send the third command and get the third reply: 775 775 776 - c. Send the third command and get the third reply:771 +AT+COMMANDx=3I!,0,0,1 777 777 778 - (%style="color:#037691"%)**AT+COMMANDx=3I!,0,0,1**773 +d.Send the fourth command and get the fourth reply: 779 779 780 - d. Send the fourth command and get the fourth reply:775 +AT+COMMANDx=4I!,0,0,1 781 781 782 - (%style="color:#037691"%)**AT+COMMANDx=4I!,0,0,1**777 +e.Send the fifth command plus the sixth command, get the sixth reply: 783 783 784 - e. Send the fifth command plus the sixth command,get the sixth reply:779 +AT+COMMANDx=1M!,2,1,1 785 785 786 - (%style="color:#037691"%)**AT+COMMANDx=1M!,2,1,1**781 +f.Send the seventh command plus the eighth command, get the eighth reply: 787 787 788 - f. Send the seventh command plus the eighth command,get the eighth reply:783 +AT+COMMANDx=2M!,2,1,1 789 789 790 - (%style="color:#037691"%)**AT+COMMANDx=2M!,2,1,1**785 +g.Send the ninth command plus the tenth command, get the tenth reply: 791 791 792 - g. Send the ninth command plus the tenth command,get the tenth reply:787 +AT+COMMANDx=3M!,1,1,1 793 793 794 - (%style="color:#037691"%)**AT+COMMANDx=3M!,1,1,1**789 +h.Send the eleventh command plus the twelfth command, get the twelfth reply: 795 795 796 - h. Send the eleventh command plus the twelfth command,get the twelfth reply:791 +AT+COMMANDx=4M!,1,1,1 797 797 798 -(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1** 799 799 794 +2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor: 800 800 801 - (% style="color:blue" %)**2)TheAT+DATACUTx commandisappliedtothe green arrowpart,receivingandcutout data fromtheDI12sensor:**796 +a.The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>” 802 802 803 - a.The firstreply,all34characters:”113TRUEBNERSMT100038220303182331<CR><LF>”798 +Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34; 804 804 805 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %); 806 - 807 807 b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>” 808 808 809 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);802 +Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31; 810 810 811 811 c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>” 812 812 813 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);806 +Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31; 814 814 815 815 d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>” 816 816 817 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);810 +Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15; 818 818 819 819 e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>” 820 820 821 -Partial cut, the cut sensor address and the first two parameters: (% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”**.814 +Partial cut, the cut sensor address and the first two parameters:AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”. 822 822 816 +== == 823 823 824 824 == 2.7 Frequency Plans == 825 825 ... ... @@ -893,7 +893,6 @@ 893 893 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 894 894 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 895 895 896 - 897 897 == 3.2 Set Interrupt Mode == 898 898 899 899 ... ... @@ -925,7 +925,6 @@ 925 925 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 926 926 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 927 927 928 - 929 929 == 3.3 Set the output time == 930 930 931 931 ... ... @@ -995,7 +995,6 @@ 995 995 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 996 996 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 997 997 998 - 999 999 == 3.4 Set the all data mode == 1000 1000 1001 1001 ... ... @@ -1018,7 +1018,6 @@ 1018 1018 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1019 1019 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 1020 1020 1021 - 1022 1022 == 3.5 Set the splicing payload for uplink == 1023 1023 1024 1024 ... ... @@ -1075,7 +1075,6 @@ 1075 1075 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1076 1076 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1077 1077 1078 - 1079 1079 = 4. Battery & how to replace = 1080 1080 1081 1081 == 4.1 Battery Type == ... ... @@ -1086,7 +1086,7 @@ 1086 1086 1087 1087 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1088 1088 1089 -[[image:1675234124233-857.png ||_mstalt="295035"]]1078 +[[image:1675234124233-857.png]] 1090 1090 1091 1091 1092 1092 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1120,7 +1120,7 @@ 1120 1120 And the Life expectation in difference case will be shown on the right. 1121 1121 1122 1122 1123 -[[image:1675234155374-163.png ||_mstalt="294411"]]1112 +[[image:1675234155374-163.png]] 1124 1124 1125 1125 1126 1126 The battery related documents as below: ... ... @@ -1129,7 +1129,7 @@ 1129 1129 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1130 1130 * [[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]] 1131 1131 1132 -[[image:image-20230201145019-19.png ||_mstalt="453947"]]1121 +[[image:image-20230201145019-19.png]] 1133 1133 1134 1134 1135 1135 === 4.3.1 Battery Note === ... ... @@ -1168,7 +1168,7 @@ 1168 1168 1169 1169 = 7. FAQ = 1170 1170 1171 -== 7.1 How to use AT Command viaUARTto access device? ==1160 +== 7.1 How to use AT Command to access device? == 1172 1172 1173 1173 1174 1174 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]] ... ... @@ -1210,7 +1210,6 @@ 1210 1210 ))) 1211 1211 1212 1212 1213 - 1214 1214 = 9. Packing Info = 1215 1215 1216 1216 ... ... @@ -1225,7 +1225,6 @@ 1225 1225 * Package Size / pcs : cm 1226 1226 * Weight / pcs : g 1227 1227 1228 - 1229 1229 = 10. Support = 1230 1230 1231 1231