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 (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Bei - 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,8 +65,6 @@ 65 65 * Downlink to change configure 66 66 * 8500mAh Battery for long term use 67 67 68 - 69 - 70 70 == 1.3 Specification == 71 71 72 72 ... ... @@ -115,13 +115,11 @@ 115 115 * Sleep Mode: 5uA @ 3.3v 116 116 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 117 117 118 - 119 - 120 120 == 1.4 Connect to SDI-12 Sensor == 121 121 122 122 123 123 124 -[[image:1675212538524-889.png ||_mstalt="298272"]]120 +[[image:1675212538524-889.png]] 125 125 126 126 127 127 == 1.5 Sleep mode and working mode == ... ... @@ -135,7 +135,7 @@ 135 135 == 1.6 Button & LEDs == 136 136 137 137 138 -[[image:1675212633011-651.png ||_mstalt="291538"]]134 +[[image:1675212633011-651.png]] 139 139 140 140 141 141 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) ... ... @@ -151,12 +151,10 @@ 151 151 ))) 152 152 |(% 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. 153 153 154 - 155 - 156 156 == 1.7 Pin Mapping == 157 157 158 158 159 -[[image:1675213198663-754.png ||_mstalt="297167"]]153 +[[image:1675213198663-754.png]] 160 160 161 161 162 162 == 1.8 BLE connection == ... ... @@ -176,11 +176,11 @@ 176 176 == 1.9 Mechanical == 177 177 178 178 179 -[[image:image-20230201090139-2.png ||_mstalt="428623"]]173 +[[image:image-20230201090139-2.png]] 180 180 181 -[[image:image-20230201090139-3.png ||_mstalt="428987"]]175 +[[image:image-20230201090139-3.png]] 182 182 183 -[[image:image-20230201090139-4.png ||_mstalt="429351"]]177 +[[image:image-20230201090139-4.png]] 184 184 185 185 186 186 = 2. Configure SDI-12 to connect to LoRaWAN network = ... ... @@ -197,7 +197,7 @@ 197 197 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. 198 198 199 199 200 -[[image:image-20230201090528-5.png|| _mstalt="430300"height="465" width="1111"]]194 +[[image:image-20230201090528-5.png||height="465" width="1111"]] 201 201 202 202 203 203 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. ... ... @@ -208,7 +208,7 @@ 208 208 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 209 209 210 210 211 -[[image:image-20230201152430-20.jpeg ||_mstalt="492245"]]205 +[[image:image-20230201152430-20.jpeg]] 212 212 213 213 214 214 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: ... ... @@ -216,24 +216,24 @@ 216 216 217 217 (% style="color:blue" %)**Register the device** 218 218 219 -[[image:1675213652444-622.png ||_mstalt="293657"]]213 +[[image:1675213652444-622.png]] 220 220 221 221 222 222 (% style="color:blue" %)**Add APP EUI and DEV EUI** 223 223 224 224 225 -[[image:1675213661769-223.png ||_mstalt="295217"]]219 +[[image:1675213661769-223.png]] 226 226 227 227 228 228 (% style="color:blue" %)**Add APP EUI in the application** 229 229 230 230 231 -[[image:1675213675852-577.png ||_mstalt="297947"]]225 +[[image:1675213675852-577.png]] 232 232 233 233 234 234 (% style="color:blue" %)**Add APP KEY** 235 235 236 -[[image:1675213686734-883.png ||_mstalt="298064"]]230 +[[image:1675213686734-883.png]] 237 237 238 238 239 239 (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB ... ... @@ -244,7 +244,7 @@ 244 244 (% 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. 245 245 246 246 247 -[[image:1675213704414-644.png ||_mstalt="293748"]]241 +[[image:1675213704414-644.png]] 248 248 249 249 250 250 == 2.3 SDI-12 Related Commands == ... ... @@ -263,10 +263,10 @@ 263 263 The following is the display information on the serial port and the server. 264 264 265 265 266 -[[image:image-20230201091027-6.png ||_mstalt="429065"]]260 +[[image:image-20230201091027-6.png]] 267 267 268 268 269 -[[image:image-20230201091027-7.png|| _mstalt="429429"height="261" width="1179"]]263 +[[image:image-20230201091027-7.png||height="261" width="1179"]] 270 270 271 271 272 272 ... ... @@ -284,10 +284,10 @@ 284 284 The following is the display information on the serial port and the server. 285 285 286 286 287 -[[image:image-20230201091257-8.png ||_mstalt="431392"]]281 +[[image:image-20230201091257-8.png]] 288 288 289 289 290 -[[image:image-20230201091257-9.png|| _mstalt="431756"height="225" width="1242"]]284 +[[image:image-20230201091257-9.png||height="225" width="1242"]] 291 291 292 292 293 293 ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ==== ... ... @@ -320,10 +320,10 @@ 320 320 The following is the display information on the serial port and the server. 321 321 322 322 323 -[[image:image-20230201091630-10.png ||_mstalt="449995"]]317 +[[image:image-20230201091630-10.png]] 324 324 325 325 326 -[[image:image-20230201091630-11.png|| _mstalt="450372"height="247" width="1165"]]320 +[[image:image-20230201091630-11.png||height="247" width="1165"]] 327 327 328 328 329 329 ... ... @@ -357,10 +357,10 @@ 357 357 The following is the display information on the serial port and the server. 358 358 359 359 360 -[[image:image-20230201091954-12.png ||_mstalt="453687"]]354 +[[image:image-20230201091954-12.png]] 361 361 362 362 363 -[[image:image-20230201091954-13.png|| _mstalt="454064"height="203" width="1117"]]357 +[[image:image-20230201091954-13.png||height="203" width="1117"]] 364 364 365 365 366 366 ... ... @@ -390,10 +390,10 @@ 390 390 The following is the display information on the serial port and the server. 391 391 392 392 393 -[[image:image-20230201092208-14.png ||_mstalt="452283"]]387 +[[image:image-20230201092208-14.png]] 394 394 395 395 396 -[[image:image-20230201092208-15.png|| _mstalt="452660"height="214" width="1140"]]390 +[[image:image-20230201092208-15.png||height="214" width="1140"]] 397 397 398 398 399 399 === 2.3.2 Advance SDI-12 Debug command === ... ... @@ -425,10 +425,10 @@ 425 425 The following is the display information on the serial port and the server. 426 426 427 427 428 -[[image:image-20230201092355-16.png ||_mstalt="453960"]]422 +[[image:image-20230201092355-16.png]] 429 429 430 430 431 -[[image:image-20230201092355-17.png|| _mstalt="454337"height="426" width="1135"]]425 +[[image:image-20230201092355-17.png||height="426" width="1135"]] 432 432 433 433 434 434 === 2.3.3 Convert ASCII to String === ... ... @@ -443,12 +443,12 @@ 443 443 444 444 1) AT+CONVFORM=0, string Convert String from String to ASCII 445 445 446 -[[image:1675214845056-885.png ||_mstalt="297622"]]440 +[[image:1675214845056-885.png]] 447 447 448 448 449 449 2) AT+CONVFORM=1, ASCII Convert ASCII to String. 450 450 451 -[[image:1675214856590-846.png ||_mstalt="297739"]]445 +[[image:1675214856590-846.png]] 452 452 453 453 454 454 === 2.3.4 Define periodically SDI-12 commands and uplink. === ... ... @@ -525,7 +525,7 @@ 525 525 526 526 (% style="color:blue" %)**Example:** 527 527 528 -[[image:image-20230201094129-18.png ||_mstalt="455065"]]522 +[[image:image-20230201094129-18.png]] 529 529 530 530 531 531 ... ... @@ -552,7 +552,7 @@ 552 552 553 553 Below shows a screen shot how the results combines together to a uplink payload. 554 554 555 -[[image:1675215745275-920.png ||_mstalt="295334"]]549 +[[image:1675215745275-920.png]] 556 556 557 557 558 558 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. ... ... @@ -563,7 +563,7 @@ 563 563 (% 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. 564 564 565 565 566 -[[image:1675215782925-448.png ||_mstalt="297466"]]560 +[[image:1675215782925-448.png]] 567 567 568 568 569 569 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. ... ... @@ -581,7 +581,7 @@ 581 581 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 582 582 583 583 584 -[[image:1675215828102-844.png ||_mstalt="294645"]]578 +[[image:1675215828102-844.png]] 585 585 586 586 587 587 (% style="color:#4f81bd" %)**AT+DATAUP=1** ... ... @@ -596,7 +596,7 @@ 596 596 1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT) 597 597 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 598 598 599 -[[image:1675215848113-696.png ||_mstalt="296998"]]593 +[[image:1675215848113-696.png]] 600 600 601 601 602 602 (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** ... ... @@ -627,7 +627,7 @@ 627 627 628 628 Example parse in TTNv3 629 629 630 -[[image:1675215946738-635.png ||_mstalt="297778"]]624 +[[image:1675215946738-635.png]] 631 631 632 632 633 633 (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17 ... ... @@ -705,7 +705,7 @@ 705 705 Payload length in server,server will show payload not provided in the LoRaWAN server. 706 706 ))) 707 707 708 -[[image:1675216282284-923.png ||_mstalt="295633"]]702 +[[image:1675216282284-923.png]] 709 709 710 710 711 711 === 2.4.3 Battery Info === ... ... @@ -740,7 +740,7 @@ 740 740 741 741 While using TTN network, you can add the payload format to decode the payload. 742 742 743 -[[image:1675216779406-595.png ||_mstalt="298376"]]737 +[[image:1675216779406-595.png]] 744 744 745 745 746 746 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. ... ... @@ -763,7 +763,7 @@ 763 763 764 764 COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication. 765 765 766 -[[image:image-20230222143809-1.png|| _mstalt="429962"height="564" width="729"]]760 +[[image:image-20230222143809-1.png||height="564" width="729"]] 767 767 768 768 769 769 (% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:** ... ... @@ -805,19 +805,19 @@ 805 805 806 806 a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>” 807 807 808 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);802 +Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**; 809 809 810 810 b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>” 811 811 812 -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: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**; 813 813 814 814 c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>” 815 815 816 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);810 +Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**; 817 817 818 818 d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>” 819 819 820 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);814 +Cut out all characters: (% style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**; 821 821 822 822 e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>” 823 823 ... ... @@ -896,8 +896,6 @@ 896 896 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 897 897 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 898 898 899 - 900 - 901 901 == 3.2 Set Interrupt Mode == 902 902 903 903 ... ... @@ -929,8 +929,6 @@ 929 929 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 930 930 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 931 931 932 - 933 - 934 934 == 3.3 Set the output time == 935 935 936 936 ... ... @@ -1000,8 +1000,6 @@ 1000 1000 * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 1001 1001 * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 1002 1002 1003 - 1004 - 1005 1005 == 3.4 Set the all data mode == 1006 1006 1007 1007 ... ... @@ -1024,8 +1024,6 @@ 1024 1024 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1025 1025 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 1026 1026 1027 - 1028 - 1029 1029 == 3.5 Set the splicing payload for uplink == 1030 1030 1031 1031 ... ... @@ -1082,8 +1082,6 @@ 1082 1082 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1083 1083 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1084 1084 1085 - 1086 - 1087 1087 = 4. Battery & how to replace = 1088 1088 1089 1089 == 4.1 Battery Type == ... ... @@ -1094,7 +1094,7 @@ 1094 1094 1095 1095 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1096 1096 1097 -[[image:1675234124233-857.png ||_mstalt="295035"]]1081 +[[image:1675234124233-857.png]] 1098 1098 1099 1099 1100 1100 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1128,7 +1128,7 @@ 1128 1128 And the Life expectation in difference case will be shown on the right. 1129 1129 1130 1130 1131 -[[image:1675234155374-163.png ||_mstalt="294411"]]1115 +[[image:1675234155374-163.png]] 1132 1132 1133 1133 1134 1134 The battery related documents as below: ... ... @@ -1137,7 +1137,7 @@ 1137 1137 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]] 1138 1138 * [[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]] 1139 1139 1140 -[[image:image-20230201145019-19.png ||_mstalt="453947"]]1124 +[[image:image-20230201145019-19.png]] 1141 1141 1142 1142 1143 1143 === 4.3.1 Battery Note === ... ... @@ -1218,7 +1218,6 @@ 1218 1218 ))) 1219 1219 1220 1220 1221 - 1222 1222 = 9. Packing Info = 1223 1223 1224 1224 ... ... @@ -1233,8 +1233,6 @@ 1233 1233 * Package Size / pcs : cm 1234 1234 * Weight / pcs : g 1235 1235 1236 - 1237 - 1238 1238 = 10. Support = 1239 1239 1240 1240