Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 41.10
edited by Xiaoling
on 2023/02/01 16:26
Change comment: There is no comment for this version
To version 47.2
edited by Xiaoling
on 2023/03/21 09:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20230131183542-1.jpeg||height="694" width="694"]]
2 +[[image:image-20230131183542-1.jpeg||_mstalt="470678" height="694" width="694"]]
3 3  
4 4  **Table of Contents：**
5 5  
... ... @@ -22,30 +22,40 @@
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 -[[image:image-20230201084414-1.png||height="464" width="1108"]]
50 +[[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]]
39 39  
40 40  
41 -
42 -
43 43  == ​1.2 Features ==
44 44  
45 45  
46 46  * LoRaWAN 1.0.3 Class A
47 47  * Ultra-low power consumption
48 -* Controllable 5v and 12v output to power external sensor
58 +* Controllable 3.3v, 5v and 12v output to power external sensor
49 49  * SDI-12 Protocol to connect to SDI-12 Sensor
50 50  * Monitor Battery Level
51 51  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
... ... @@ -55,6 +55,8 @@
55 55  * Downlink to change configure
56 56  * 8500mAh Battery for long term use
57 57  
68 +
69 +
58 58  == 1.3 Specification ==
59 59  
60 60  
... ... @@ -67,6 +67,8 @@
67 67  (% style="color:#037691" %)**Common DC Characteristics:**
68 68  
69 69  * Supply Voltage: 2.5v ~~ 3.6v
82 +* Support current: 5V 300mA
83 + 12V 100mA
70 70  * Operating Temperature: -40 ~~ 85°C
71 71  
72 72  (% style="color:#037691" %)**LoRa Spec:**
... ... @@ -101,11 +101,13 @@
101 101  * Sleep Mode: 5uA @ 3.3v
102 102  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
103 103  
118 +
119 +
104 104  == 1.4 Connect to SDI-12 Sensor ==
105 105  
106 106  
107 107  
108 -[[image:1675212538524-889.png]]
124 +[[image:1675212538524-889.png||_mstalt="298272"]]
109 109  
110 110  
111 111  == 1.5 Sleep mode and working mode ==
... ... @@ -119,27 +119,28 @@
119 119  == 1.6 Button & LEDs ==
120 120  
121 121  
122 -[[image:1675212633011-651.png]]
138 +[[image:1675212633011-651.png||_mstalt="291538"]]
123 123  
124 124  
125 -
126 126  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
127 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
128 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
142 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
143 +|(% 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:117px" %)Active Device|(% style="width:225px" %)(((
147 +|(% 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:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
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.
138 138  
154 +
155 +
139 139  == 1.7 Pin Mapping ==
140 140  
141 141  
142 -[[image:1675213198663-754.png]]
159 +[[image:1675213198663-754.png||_mstalt="297167"]]
143 143  
144 144  
145 145  == 1.8 BLE connection ==
... ... @@ -159,11 +159,11 @@
159 159  == 1.9 Mechanical ==
160 160  
161 161  
162 -[[image:image-20230201090139-2.png]]
179 +[[image:image-20230201090139-2.png||_mstalt="428623"]]
163 163  
164 -[[image:image-20230201090139-3.png]]
181 +[[image:image-20230201090139-3.png||_mstalt="428987"]]
165 165  
166 -[[image:image-20230201090139-4.png]]
183 +[[image:image-20230201090139-4.png||_mstalt="429351"]]
167 167  
168 168  
169 169  = 2. Configure SDI-12 to connect to LoRaWAN network =
... ... @@ -180,7 +180,7 @@
180 180  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.
181 181  
182 182  
183 -[[image:image-20230201090528-5.png||height="465" width="1111"]]
200 +[[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]
184 184  
185 185  
186 186  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,7 +191,7 @@
191 191  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
192 192  
193 193  
194 -[[image:image-20230201152430-20.jpeg]]
211 +[[image:image-20230201152430-20.jpeg||_mstalt="492245"]]
195 195  
196 196  
197 197  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
... ... @@ -199,24 +199,24 @@
199 199  
200 200  (% style="color:blue" %)**Register the device**
201 201  
202 -[[image:1675213652444-622.png]]
219 +[[image:1675213652444-622.png||_mstalt="293657"]]
203 203  
204 204  
205 205  (% style="color:blue" %)**Add APP EUI and DEV EUI**
206 206  
207 207  
208 -[[image:1675213661769-223.png]]
225 +[[image:1675213661769-223.png||_mstalt="295217"]]
209 209  
210 210  
211 211  (% style="color:blue" %)**Add APP EUI in the application**
212 212  
213 213  
214 -[[image:1675213675852-577.png]]
231 +[[image:1675213675852-577.png||_mstalt="297947"]]
215 215  
216 216  
217 217  (% style="color:blue" %)**Add APP KEY**
218 218  
219 -[[image:1675213686734-883.png]]
236 +[[image:1675213686734-883.png||_mstalt="298064"]]
220 220  
221 221  
222 222  (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
... ... @@ -227,7 +227,7 @@
227 227  (% 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.
228 228  
229 229  
230 -[[image:1675213704414-644.png]]
247 +[[image:1675213704414-644.png||_mstalt="293748"]]
231 231  
232 232  
233 233  == ​2.3 SDI-12 Related Commands ==
... ... @@ -246,10 +246,10 @@
246 246  The following is the display information on the serial port and the server.
247 247  
248 248  
249 -[[image:image-20230201091027-6.png]]
266 +[[image:image-20230201091027-6.png||_mstalt="429065"]]
250 250  
251 251  
252 -[[image:image-20230201091027-7.png||height="261" width="1179"]]
269 +[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
253 253  
254 254  
255 255  
... ... @@ -267,10 +267,10 @@
267 267  The following is the display information on the serial port and the server.
268 268  
269 269  
270 -[[image:image-20230201091257-8.png]]
287 +[[image:image-20230201091257-8.png||_mstalt="431392"]]
271 271  
272 272  
273 -[[image:image-20230201091257-9.png||height="225" width="1242"]]
290 +[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
274 274  
275 275  
276 276  ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
... ... @@ -303,10 +303,10 @@
303 303  The following is the display information on the serial port and the server.
304 304  
305 305  
306 -[[image:image-20230201091630-10.png]]
323 +[[image:image-20230201091630-10.png||_mstalt="449995"]]
307 307  
308 308  
309 -[[image:image-20230201091630-11.png||height="247" width="1165"]]
326 +[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
310 310  
311 311  
312 312  
... ... @@ -340,10 +340,10 @@
340 340  The following is the display information on the serial port and the server.
341 341  
342 342  
343 -[[image:image-20230201091954-12.png]]
360 +[[image:image-20230201091954-12.png||_mstalt="453687"]]
344 344  
345 345  
346 -[[image:image-20230201091954-13.png||height="203" width="1117"]]
363 +[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
347 347  
348 348  
349 349  
... ... @@ -373,10 +373,10 @@
373 373  The following is the display information on the serial port and the server.
374 374  
375 375  
376 -[[image:image-20230201092208-14.png]]
393 +[[image:image-20230201092208-14.png||_mstalt="452283"]]
377 377  
378 378  
379 -[[image:image-20230201092208-15.png||height="214" width="1140"]]
396 +[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
380 380  
381 381  
382 382  === 2.3.2 Advance SDI-12 Debug command ===
... ... @@ -408,10 +408,10 @@
408 408  The following is the display information on the serial port and the server.
409 409  
410 410  
411 -[[image:image-20230201092355-16.png]]
428 +[[image:image-20230201092355-16.png||_mstalt="453960"]]
412 412  
413 413  
414 -[[image:image-20230201092355-17.png||height="426" width="1135"]]
431 +[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
415 415  
416 416  
417 417  === 2.3.3 Convert ASCII to String ===
... ... @@ -426,12 +426,12 @@
426 426  
427 427  1) AT+CONVFORM=0, string Convert String from String to ASCII
428 428  
429 -[[image:1675214845056-885.png]]
446 +[[image:1675214845056-885.png||_mstalt="297622"]]
430 430  
431 431  
432 432  2) AT+CONVFORM=1, ASCII Convert ASCII to String.
433 433  
434 -[[image:1675214856590-846.png]]
451 +[[image:1675214856590-846.png||_mstalt="297739"]]
435 435  
436 436  
437 437  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -452,7 +452,7 @@
452 452  
453 453  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
454 454  
455 -(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
472 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
456 456  
457 457  (% style="color:red" %)**0 **(%%) No validation check;
458 458  
... ... @@ -479,14 +479,14 @@
479 479  **c**:  define the position for valid value. 
480 480  )))
481 481  
482 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
499 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
483 483  
484 484  
485 485  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
486 -|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
487 -|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
488 -|(% 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
489 -|(% 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
503 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
504 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
505 +|(% 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
506 +|(% 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
490 490  
491 491  * (% style="color:blue" %)** Downlink Payload:**
492 492  
... ... @@ -501,16 +501,17 @@
501 501  Where:
502 502  
503 503  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
504 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
521 +* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
505 505  * (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
506 506  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
507 -* (% 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. 
524 +* (% style="color:#037691" %)**YY **(%%):  If YY=0, SDI-12-LB will execute the downlink command without uplink; if YY=1, SDI-12-LB will execute an uplink after got this command. 
508 508  
509 509  (% style="color:blue" %)**Example:**
510 510  
511 -[[image:image-20230201094129-18.png]]
528 +[[image:image-20230201094129-18.png||_mstalt="455065"]]
512 512  
513 513  
531 +
514 514  (% style="color:blue" %)**Clear SDI12 Command**
515 515  
516 516  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -534,7 +534,7 @@
534 534  
535 535  Below shows a screen shot how the results combines together to a uplink payload.
536 536  
537 -[[image:1675215745275-920.png]]
555 +[[image:1675215745275-920.png||_mstalt="295334"]]
538 538  
539 539  
540 540  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.
... ... @@ -545,7 +545,7 @@
545 545  (% 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.
546 546  
547 547  
548 -[[image:1675215782925-448.png]]
566 +[[image:1675215782925-448.png||_mstalt="297466"]]
549 549  
550 550  
551 551  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.
... ... @@ -554,7 +554,6 @@
554 554  
555 555  (% style="color:blue" %)**Compose Uplink**
556 556  
557 -
558 558  (% style="color:#4f81bd" %)**AT+DATAUP=0**
559 559  
560 560  Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
... ... @@ -564,7 +564,7 @@
564 564  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
565 565  
566 566  
567 -[[image:1675215828102-844.png]]
584 +[[image:1675215828102-844.png||_mstalt="294645"]]
568 568  
569 569  
570 570  (% style="color:#4f81bd" %)**AT+DATAUP=1**
... ... @@ -579,7 +579,7 @@
579 579  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
580 580  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
581 581  
582 -[[image:1675215848113-696.png]]
599 +[[image:1675215848113-696.png||_mstalt="296998"]]
583 583  
584 584  
585 585  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
... ... @@ -596,15 +596,6 @@
596 596  
597 597  == 2.4 Uplink Payload ==
598 598  
599 -
600 -Uplink payloads have two types:
601 -
602 -* Distance Value: Use FPORT=2
603 -* Other control commands: Use other FPORT fields.
604 -
605 -The application server should parse the correct value based on FPORT settings.
606 -
607 -
608 608  === 2.4.1 Device Payload, FPORT~=5 ===
609 609  
610 610  
... ... @@ -612,14 +612,14 @@
612 612  
613 613  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
614 614  
615 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
623 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
616 616  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
617 -|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**
618 -|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT
625 +|(% 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**
626 +|(% 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
619 619  
620 620  Example parse in TTNv3
621 621  
622 -[[image:1675215946738-635.png]]
630 +[[image:1675215946738-635.png||_mstalt="297778"]]
623 623  
624 624  
625 625  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
... ... @@ -684,20 +684,20 @@
684 684  
685 685  * Periodically Uplink: FPORT=2
686 686  
687 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
688 -|(% style="width:93px" %)(((
695 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
696 +|=(% style="width: 90px;" %)(((
689 689  **Size(bytes)**
690 -)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
698 +)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
691 691  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
692 692  Battery(mV)
693 693  &
694 694  Interrupt_Flag
695 -)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
703 +)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
696 696  If the valid payload is too long and exceed the maximum support.
697 697  Payload length in server,server will show payload not provided in the LoRaWAN server.
698 698  )))
699 699  
700 -[[image:1675216282284-923.png]]
708 +[[image:1675216282284-923.png||_mstalt="295633"]]
701 701  
702 702  
703 703  === 2.4.3 Battery Info ===
... ... @@ -724,6 +724,7 @@
724 724  
725 725  === 2.4.5 Payload version ===
726 726  
735 +The version number of the payload, mainly used for decoding. The default is 01.
727 727  
728 728  
729 729  === 2.4.6 ​Decode payload in The Things Network ===
... ... @@ -731,7 +731,7 @@
731 731  
732 732  While using TTN network, you can add the payload format to decode the payload.
733 733  
734 -[[image:1675216779406-595.png]]
743 +[[image:1675216779406-595.png||_mstalt="298376"]]
735 735  
736 736  
737 737  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.
... ... @@ -744,18 +744,86 @@
744 744  
745 745  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:
746 746  
747 -[[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 +[[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 748  
749 749  
750 -== 2.6 Frequency Plans ==
759 +== 2.6 Examples To Set SDI commands. ==
751 751  
761 +=== 2.6.1 Examples 1 ===
752 752  
763 +
764 +COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
765 +
766 +[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]]
767 +
768 +
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:**
770 +
771 +a. Send the first command and get the first reply：
772 +
773 +(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
774 +
775 +b. Send the second command and get the second reply：
776 +
777 +(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
778 +
779 +c. Send the third command and get the third reply：
780 +
781 +(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
782 +
783 +d. Send the fourth command and get the fourth reply：
784 +
785 +(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
786 +
787 +e. Send the fifth command plus the sixth command, get the sixth reply：
788 +
789 +(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
790 +
791 +f. Send the seventh command plus the eighth command, get the eighth reply：
792 +
793 +(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
794 +
795 +g. Send the ninth command plus the tenth command, get the tenth reply：
796 +
797 +(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
798 +
799 +h. Send the eleventh command plus the twelfth command, get the twelfth reply：
800 +
801 +(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
802 +
803 +
804 +(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor：**
805 +
806 +a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
807 +
808 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);
809 +
810 +b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
811 +
812 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
813 +
814 +c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
815 +
816 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
817 +
818 +d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
819 +
820 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
821 +
822 +e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
823 +
824 +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”**.
825 +
826 +
827 +== 2.7 Frequency Plans ==
828 +
829 +
753 753  The SDI-12-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
754 754  
755 755  [[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/]]
756 756  
757 757  
758 -== 2.7 Firmware Change Log ==
835 +== 2.8 Firmware Change Log ==
759 759  
760 760  
761 761  **Firmware download link:**
... ... @@ -762,7 +762,6 @@
762 762  
763 763  [[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
764 764  
765 -
766 766  
767 767  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
768 768  
... ... @@ -791,7 +791,7 @@
791 791  These commands only valid for SDI-12-LB, as below:
792 792  
793 793  
794 -== ​​​​​​​3.1 Set Transmit Interval Time ==
870 +== 3.1 Set Transmit Interval Time ==
795 795  
796 796  
797 797  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -820,6 +820,8 @@
820 820  * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
821 821  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
822 822  
899 +
900 +
823 823  == 3.2 Set Interrupt Mode ==
824 824  
825 825  
... ... @@ -832,14 +832,14 @@
832 832  |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
833 833  0
834 834  OK
835 -the mode is 0 = No interruption
913 +the mode is 0 = Disable Interrupt
836 836  )))
837 837  |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
838 838  Set Transmit Interval
839 -~1. (Disable Interrupt),
840 -2. (Trigger by rising and falling edge)
841 -3. (Trigger by falling edge)
842 -4. (Trigger by rising edge)
917 +0. (Disable Interrupt),
918 +~1. (Trigger by rising and falling edge)
919 +2. (Trigger by falling edge)
920 +3. (Trigger by rising edge)
843 843  )))|(% style="width:165px" %)OK
844 844  
845 845  (% style="color:blue" %)**Downlink Command: 0x06**
... ... @@ -851,6 +851,8 @@
851 851  * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
852 852  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
853 853  
932 +
933 +
854 854  == 3.3 Set the output time ==
855 855  
856 856  
... ... @@ -920,6 +920,8 @@
920 920  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
921 921  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
922 922  
1003 +
1004 +
923 923  == 3.4 Set the all data mode ==
924 924  
925 925  
... ... @@ -942,6 +942,8 @@
942 942  * Example 1: Downlink Payload: AB 00  ~/~/  AT+ALLDATAMOD=0
943 943  * Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
944 944  
1027 +
1028 +
945 945  == 3.5 Set the splicing payload for uplink ==
946 946  
947 947  
... ... @@ -978,6 +978,7 @@
978 978  
979 979  == 3.6 Set the payload version ==
980 980  
1065 +
981 981  Feature, Set the payload version.
982 982  
983 983  (% style="color:blue" %)**AT Command: AT+PAYVER**
... ... @@ -997,6 +997,8 @@
997 997  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
998 998  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
999 999  
1085 +
1086 +
1000 1000  = 4. Battery & how to replace =
1001 1001  
1002 1002  == 4.1 Battery Type ==
... ... @@ -1007,7 +1007,7 @@
1007 1007  
1008 1008  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1009 1009  
1010 -[[image:1675234124233-857.png]]
1097 +[[image:1675234124233-857.png||_mstalt="295035"]]
1011 1011  
1012 1012  
1013 1013  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1041,7 +1041,7 @@
1041 1041  And the Life expectation in difference case will be shown on the right.
1042 1042  
1043 1043  
1044 -[[image:1675234155374-163.png]]
1131 +[[image:1675234155374-163.png||_mstalt="294411"]]
1045 1045  
1046 1046  
1047 1047  The battery related documents as below:
... ... @@ -1050,7 +1050,7 @@
1050 1050  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1051 1051  * [[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]]
1052 1052  
1053 -[[image:image-20230201145019-19.png]]
1140 +[[image:image-20230201145019-19.png||_mstalt="453947"]]
1054 1054  
1055 1055  
1056 1056  === 4.3.1 ​Battery Note ===
... ... @@ -1111,10 +1111,15 @@
1111 1111  = 8. ​Order Info =
1112 1112  
1113 1113  
1201 +(((
1114 1114  (% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1203 +)))
1115 1115  
1205 +(((
1116 1116  XXX: The default frequency band
1207 +)))
1117 1117  
1209 +(((
1118 1118  (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1119 1119  (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1120 1120  (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
... ... @@ -1123,13 +1123,10 @@
1123 1123  (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1124 1124  (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1125 1125  (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1218 +)))
1126 1126  
1127 1127  
1128 1128  
1129 -
1130 -
1131 -
1132 -
1133 1133  = 9. Packing Info =
1134 1134  
1135 1135  
... ... @@ -1144,6 +1144,8 @@
1144 1144  * Package Size / pcs : cm
1145 1145  * Weight / pcs : g
1146 1146  
1236 +
1237 +
1147 1147  = 10. ​Support =
1148 1148  
1149 1149  
image-20230222143809-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +322.1 KB
Content