Last modified by Mengting Qiu on 2025/07/03 15:42

From version 41.12
edited by Xiaoling
on 2023/02/01 16:36
Change comment: There is no comment for this version
To version 48.3
edited by Xiaoling
on 2023/04/03 11:00
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,20 +22,32 @@
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 41  == ​1.2 Features ==
... ... @@ -43,7 +43,7 @@
43 43  
44 44  * LoRaWAN 1.0.3 Class A
45 45  * Ultra-low power consumption
46 -* Controllable 5v and 12v output to power external sensor
58 +* Controllable 3.3v, 5v and 12v output to power external sensor
47 47  * SDI-12 Protocol to connect to SDI-12 Sensor
48 48  * Monitor Battery Level
49 49  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
... ... @@ -53,6 +53,7 @@
53 53  * Downlink to change configure
54 54  * 8500mAh Battery for long term use
55 55  
68 +
56 56  == 1.3 Specification ==
57 57  
58 58  
... ... @@ -65,6 +65,8 @@
65 65  (% style="color:#037691" %)**Common DC Characteristics:**
66 66  
67 67  * Supply Voltage: 2.5v ~~ 3.6v
81 +* Support current: 5V 300mA
82 + 12V 100mA
68 68  * Operating Temperature: -40 ~~ 85°C
69 69  
70 70  (% style="color:#037691" %)**LoRa Spec:**
... ... @@ -99,11 +99,12 @@
99 99  * Sleep Mode: 5uA @ 3.3v
100 100  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
101 101  
117 +
102 102  == 1.4 Connect to SDI-12 Sensor ==
103 103  
104 104  
105 105  
106 -[[image:1675212538524-889.png]]
122 +[[image:1675212538524-889.png||_mstalt="298272"]]
107 107  
108 108  
109 109  == 1.5 Sleep mode and working mode ==
... ... @@ -117,27 +117,27 @@
117 117  == 1.6 Button & LEDs ==
118 118  
119 119  
120 -[[image:1675212633011-651.png]]
136 +[[image:1675212633011-651.png||_mstalt="291538"]]
121 121  
122 122  
123 -
124 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
125 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
126 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
139 +(% border="1" cellspacing="4" style="width:510px" %)
140 +|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
141 +|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT between 1s < time < 3s|(% style="background-color:#f2f2f2; width:117px" %)Send an uplink|(% style="background-color:#f2f2f2; width:225px" %)(((
127 127  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
128 128  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
129 129  )))
130 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
131 -(% 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.
132 -(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
145 +|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT for more than 3s|(% style="background-color:#f2f2f2; width:117px" %)Active Device|(% style="background-color:#f2f2f2; width:225px" %)(((
146 +(% style="background-color:#f2f2f2; 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.
147 +(% style="background-color:#f2f2f2; color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
133 133  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.
134 134  )))
135 -|(% 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.
150 +|(% style="background-color:#f2f2f2; width:167px" %)Fast press ACT 5 times.|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device|(% style="background-color:#f2f2f2; width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB-NA is in Deep Sleep Mode.
136 136  
152 +
137 137  == 1.7 Pin Mapping ==
138 138  
139 139  
140 -[[image:1675213198663-754.png]]
156 +[[image:1675213198663-754.png||_mstalt="297167"]]
141 141  
142 142  
143 143  == 1.8 BLE connection ==
... ... @@ -157,11 +157,11 @@
157 157  == 1.9 Mechanical ==
158 158  
159 159  
160 -[[image:image-20230201090139-2.png]]
176 +[[image:image-20230201090139-2.png||_mstalt="428623"]]
161 161  
162 -[[image:image-20230201090139-3.png]]
178 +[[image:image-20230201090139-3.png||_mstalt="428987"]]
163 163  
164 -[[image:image-20230201090139-4.png]]
180 +[[image:image-20230201090139-4.png||_mstalt="429351"]]
165 165  
166 166  
167 167  = 2. Configure SDI-12 to connect to LoRaWAN network =
... ... @@ -178,7 +178,7 @@
178 178  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.
179 179  
180 180  
181 -[[image:image-20230201090528-5.png||height="465" width="1111"]]
197 +[[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]
182 182  
183 183  
184 184  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.
... ... @@ -189,7 +189,7 @@
189 189  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
190 190  
191 191  
192 -[[image:image-20230201152430-20.jpeg]]
208 +[[image:image-20230201152430-20.jpeg||_mstalt="492245"]]
193 193  
194 194  
195 195  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
... ... @@ -197,24 +197,24 @@
197 197  
198 198  (% style="color:blue" %)**Register the device**
199 199  
200 -[[image:1675213652444-622.png]]
216 +[[image:1675213652444-622.png||_mstalt="293657"]]
201 201  
202 202  
203 203  (% style="color:blue" %)**Add APP EUI and DEV EUI**
204 204  
205 205  
206 -[[image:1675213661769-223.png]]
222 +[[image:1675213661769-223.png||_mstalt="295217"]]
207 207  
208 208  
209 209  (% style="color:blue" %)**Add APP EUI in the application**
210 210  
211 211  
212 -[[image:1675213675852-577.png]]
228 +[[image:1675213675852-577.png||_mstalt="297947"]]
213 213  
214 214  
215 215  (% style="color:blue" %)**Add APP KEY**
216 216  
217 -[[image:1675213686734-883.png]]
233 +[[image:1675213686734-883.png||_mstalt="298064"]]
218 218  
219 219  
220 220  (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
... ... @@ -225,7 +225,7 @@
225 225  (% 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.
226 226  
227 227  
228 -[[image:1675213704414-644.png]]
244 +[[image:1675213704414-644.png||_mstalt="293748"]]
229 229  
230 230  
231 231  == ​2.3 SDI-12 Related Commands ==
... ... @@ -244,10 +244,10 @@
244 244  The following is the display information on the serial port and the server.
245 245  
246 246  
247 -[[image:image-20230201091027-6.png]]
263 +[[image:image-20230201091027-6.png||_mstalt="429065"]]
248 248  
249 249  
250 -[[image:image-20230201091027-7.png||height="261" width="1179"]]
266 +[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
251 251  
252 252  
253 253  
... ... @@ -265,10 +265,10 @@
265 265  The following is the display information on the serial port and the server.
266 266  
267 267  
268 -[[image:image-20230201091257-8.png]]
284 +[[image:image-20230201091257-8.png||_mstalt="431392"]]
269 269  
270 270  
271 -[[image:image-20230201091257-9.png||height="225" width="1242"]]
287 +[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
272 272  
273 273  
274 274  ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
... ... @@ -301,10 +301,10 @@
301 301  The following is the display information on the serial port and the server.
302 302  
303 303  
304 -[[image:image-20230201091630-10.png]]
320 +[[image:image-20230201091630-10.png||_mstalt="449995"]]
305 305  
306 306  
307 -[[image:image-20230201091630-11.png||height="247" width="1165"]]
323 +[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
308 308  
309 309  
310 310  
... ... @@ -338,10 +338,10 @@
338 338  The following is the display information on the serial port and the server.
339 339  
340 340  
341 -[[image:image-20230201091954-12.png]]
357 +[[image:image-20230201091954-12.png||_mstalt="453687"]]
342 342  
343 343  
344 -[[image:image-20230201091954-13.png||height="203" width="1117"]]
360 +[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
345 345  
346 346  
347 347  
... ... @@ -371,10 +371,10 @@
371 371  The following is the display information on the serial port and the server.
372 372  
373 373  
374 -[[image:image-20230201092208-14.png]]
390 +[[image:image-20230201092208-14.png||_mstalt="452283"]]
375 375  
376 376  
377 -[[image:image-20230201092208-15.png||height="214" width="1140"]]
393 +[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
378 378  
379 379  
380 380  === 2.3.2 Advance SDI-12 Debug command ===
... ... @@ -406,10 +406,10 @@
406 406  The following is the display information on the serial port and the server.
407 407  
408 408  
409 -[[image:image-20230201092355-16.png]]
425 +[[image:image-20230201092355-16.png||_mstalt="453960"]]
410 410  
411 411  
412 -[[image:image-20230201092355-17.png||height="426" width="1135"]]
428 +[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
413 413  
414 414  
415 415  === 2.3.3 Convert ASCII to String ===
... ... @@ -424,12 +424,12 @@
424 424  
425 425  1) AT+CONVFORM=0, string Convert String from String to ASCII
426 426  
427 -[[image:1675214845056-885.png]]
443 +[[image:1675214845056-885.png||_mstalt="297622"]]
428 428  
429 429  
430 430  2) AT+CONVFORM=1, ASCII Convert ASCII to String.
431 431  
432 -[[image:1675214856590-846.png]]
448 +[[image:1675214856590-846.png||_mstalt="297739"]]
433 433  
434 434  
435 435  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -450,7 +450,7 @@
450 450  
451 451  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
452 452  
453 -(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
469 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
454 454  
455 455  (% style="color:red" %)**0 **(%%) No validation check;
456 456  
... ... @@ -477,14 +477,14 @@
477 477  **c**:  define the position for valid value. 
478 478  )))
479 479  
480 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
496 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
481 481  
482 482  
483 483  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
484 -|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
485 -|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
486 -|(% 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
487 -|(% 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
500 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
501 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
502 +|(% 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
503 +|(% 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
488 488  
489 489  * (% style="color:blue" %)** Downlink Payload:**
490 490  
... ... @@ -499,16 +499,17 @@
499 499  Where:
500 500  
501 501  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
502 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
518 +* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
503 503  * (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
504 504  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
505 -* (% 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. 
521 +* (% 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. 
506 506  
507 507  (% style="color:blue" %)**Example:**
508 508  
509 -[[image:image-20230201094129-18.png]]
525 +[[image:image-20230201094129-18.png||_mstalt="455065"]]
510 510  
511 511  
528 +
512 512  (% style="color:blue" %)**Clear SDI12 Command**
513 513  
514 514  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -532,7 +532,7 @@
532 532  
533 533  Below shows a screen shot how the results combines together to a uplink payload.
534 534  
535 -[[image:1675215745275-920.png]]
552 +[[image:1675215745275-920.png||_mstalt="295334"]]
536 536  
537 537  
538 538  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.
... ... @@ -543,7 +543,7 @@
543 543  (% 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.
544 544  
545 545  
546 -[[image:1675215782925-448.png]]
563 +[[image:1675215782925-448.png||_mstalt="297466"]]
547 547  
548 548  
549 549  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.
... ... @@ -552,7 +552,6 @@
552 552  
553 553  (% style="color:blue" %)**Compose Uplink**
554 554  
555 -
556 556  (% style="color:#4f81bd" %)**AT+DATAUP=0**
557 557  
558 558  Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
... ... @@ -562,7 +562,7 @@
562 562  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
563 563  
564 564  
565 -[[image:1675215828102-844.png]]
581 +[[image:1675215828102-844.png||_mstalt="294645"]]
566 566  
567 567  
568 568  (% style="color:#4f81bd" %)**AT+DATAUP=1**
... ... @@ -577,7 +577,7 @@
577 577  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
578 578  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
579 579  
580 -[[image:1675215848113-696.png]]
596 +[[image:1675215848113-696.png||_mstalt="296998"]]
581 581  
582 582  
583 583  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
... ... @@ -594,15 +594,6 @@
594 594  
595 595  == 2.4 Uplink Payload ==
596 596  
597 -
598 -Uplink payloads have two types:
599 -
600 -* Distance Value: Use FPORT=2
601 -* Other control commands: Use other FPORT fields.
602 -
603 -The application server should parse the correct value based on FPORT settings.
604 -
605 -
606 606  === 2.4.1 Device Payload, FPORT~=5 ===
607 607  
608 608  
... ... @@ -610,14 +610,14 @@
610 610  
611 611  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
612 612  
613 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
620 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
614 614  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
615 -|(% 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**
616 -|(% 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
622 +|(% 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**
623 +|(% 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
617 617  
618 618  Example parse in TTNv3
619 619  
620 -[[image:1675215946738-635.png]]
627 +[[image:1675215946738-635.png||_mstalt="297778"]]
621 621  
622 622  
623 623  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
... ... @@ -682,20 +682,20 @@
682 682  
683 683  * Periodically Uplink: FPORT=2
684 684  
685 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
686 -|(% style="width:93px" %)(((
692 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
693 +|=(% style="width: 90px;" %)(((
687 687  **Size(bytes)**
688 -)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
695 +)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
689 689  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
690 690  Battery(mV)
691 691  &
692 692  Interrupt_Flag
693 -)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
700 +)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
694 694  If the valid payload is too long and exceed the maximum support.
695 695  Payload length in server,server will show payload not provided in the LoRaWAN server.
696 696  )))
697 697  
698 -[[image:1675216282284-923.png]]
705 +[[image:1675216282284-923.png||_mstalt="295633"]]
699 699  
700 700  
701 701  === 2.4.3 Battery Info ===
... ... @@ -722,6 +722,7 @@
722 722  
723 723  === 2.4.5 Payload version ===
724 724  
732 +The version number of the payload, mainly used for decoding. The default is 01.
725 725  
726 726  
727 727  === 2.4.6 ​Decode payload in The Things Network ===
... ... @@ -729,7 +729,7 @@
729 729  
730 730  While using TTN network, you can add the payload format to decode the payload.
731 731  
732 -[[image:1675216779406-595.png]]
740 +[[image:1675216779406-595.png||_mstalt="298376"]]
733 733  
734 734  
735 735  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.
... ... @@ -742,18 +742,86 @@
742 742  
743 743  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:
744 744  
745 -[[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]]]]
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]]
746 746  
747 747  
748 -== 2.6 Frequency Plans ==
756 +== 2.6 Examples To Set SDI commands. ==
749 749  
758 +=== 2.6.1 Examples 1 ===
750 750  
760 +
761 +COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
762 +
763 +[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]]
764 +
765 +
766 +(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:**
767 +
768 +a. Send the first command and get the first reply:
769 +
770 +(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
771 +
772 +b. Send the second command and get the second reply:
773 +
774 +(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
775 +
776 +c. Send the third command and get the third reply:
777 +
778 +(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
779 +
780 +d. Send the fourth command and get the fourth reply:
781 +
782 +(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
783 +
784 +e. Send the fifth command plus the sixth command, get the sixth reply:
785 +
786 +(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
787 +
788 +f. Send the seventh command plus the eighth command, get the eighth reply:
789 +
790 +(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
791 +
792 +g. Send the ninth command plus the tenth command, get the tenth reply:
793 +
794 +(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
795 +
796 +h. Send the eleventh command plus the twelfth command, get the twelfth reply:
797 +
798 +(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
799 +
800 +
801 +(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:**
802 +
803 +a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
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 +b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
808 +
809 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
810 +
811 +c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
812 +
813 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
814 +
815 +d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>”
816 +
817 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
818 +
819 +e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>”
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”**.
822 +
823 +
824 +== 2.7 Frequency Plans ==
825 +
826 +
751 751  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.
752 752  
753 753  [[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/]]
754 754  
755 755  
756 -== 2.7 Firmware Change Log ==
832 +== 2.8 Firmware Change Log ==
757 757  
758 758  
759 759  **Firmware download link:**
... ... @@ -760,7 +760,6 @@
760 760  
761 761  [[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
762 762  
763 -
764 764  
765 765  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
766 766  
... ... @@ -789,7 +789,7 @@
789 789  These commands only valid for SDI-12-LB, as below:
790 790  
791 791  
792 -== ​​​​​​​3.1 Set Transmit Interval Time ==
867 +== 3.1 Set Transmit Interval Time ==
793 793  
794 794  
795 795  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -818,6 +818,7 @@
818 818  * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
819 819  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
820 820  
896 +
821 821  == 3.2 Set Interrupt Mode ==
822 822  
823 823  
... ... @@ -830,14 +830,14 @@
830 830  |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
831 831  0
832 832  OK
833 -the mode is 0 = No interruption
909 +the mode is 0 = Disable Interrupt
834 834  )))
835 835  |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
836 836  Set Transmit Interval
837 -~1. (Disable Interrupt),
838 -2. (Trigger by rising and falling edge)
839 -3. (Trigger by falling edge)
840 -4. (Trigger by rising edge)
913 +0. (Disable Interrupt),
914 +~1. (Trigger by rising and falling edge)
915 +2. (Trigger by falling edge)
916 +3. (Trigger by rising edge)
841 841  )))|(% style="width:165px" %)OK
842 842  
843 843  (% style="color:blue" %)**Downlink Command: 0x06**
... ... @@ -849,6 +849,7 @@
849 849  * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
850 850  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
851 851  
928 +
852 852  == 3.3 Set the output time ==
853 853  
854 854  
... ... @@ -918,6 +918,7 @@
918 918  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
919 919  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
920 920  
998 +
921 921  == 3.4 Set the all data mode ==
922 922  
923 923  
... ... @@ -940,6 +940,7 @@
940 940  * Example 1: Downlink Payload: AB 00  ~/~/  AT+ALLDATAMOD=0
941 941  * Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
942 942  
1021 +
943 943  == 3.5 Set the splicing payload for uplink ==
944 944  
945 945  
... ... @@ -976,6 +976,7 @@
976 976  
977 977  == 3.6 Set the payload version ==
978 978  
1058 +
979 979  Feature, Set the payload version.
980 980  
981 981  (% style="color:blue" %)**AT Command: AT+PAYVER**
... ... @@ -995,6 +995,7 @@
995 995  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
996 996  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
997 997  
1078 +
998 998  = 4. Battery & how to replace =
999 999  
1000 1000  == 4.1 Battery Type ==
... ... @@ -1005,7 +1005,7 @@
1005 1005  
1006 1006  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1007 1007  
1008 -[[image:1675234124233-857.png]]
1089 +[[image:1675234124233-857.png||_mstalt="295035"]]
1009 1009  
1010 1010  
1011 1011  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1039,7 +1039,7 @@
1039 1039  And the Life expectation in difference case will be shown on the right.
1040 1040  
1041 1041  
1042 -[[image:1675234155374-163.png]]
1123 +[[image:1675234155374-163.png||_mstalt="294411"]]
1043 1043  
1044 1044  
1045 1045  The battery related documents as below:
... ... @@ -1048,7 +1048,7 @@
1048 1048  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1049 1049  * [[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]]
1050 1050  
1051 -[[image:image-20230201145019-19.png]]
1132 +[[image:image-20230201145019-19.png||_mstalt="453947"]]
1052 1052  
1053 1053  
1054 1054  === 4.3.1 ​Battery Note ===
... ... @@ -1087,7 +1087,7 @@
1087 1087  
1088 1088  = 7. FAQ =
1089 1089  
1090 -== 7.1 How to use AT Command to access device? ==
1171 +== 7.1 How to use AT Command  via UART to access device? ==
1091 1091  
1092 1092  
1093 1093  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]]
... ... @@ -1109,10 +1109,15 @@
1109 1109  = 8. ​Order Info =
1110 1110  
1111 1111  
1193 +(((
1112 1112  (% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1195 +)))
1113 1113  
1197 +(((
1114 1114  XXX: The default frequency band
1199 +)))
1115 1115  
1201 +(((
1116 1116  (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1117 1117  (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1118 1118  (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
... ... @@ -1121,8 +1121,10 @@
1121 1121  (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1122 1122  (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1123 1123  (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1210 +)))
1124 1124  
1125 1125  
1213 +
1126 1126  = 9. Packing Info =
1127 1127  
1128 1128  
... ... @@ -1137,6 +1137,7 @@
1137 1137  * Package Size / pcs : cm
1138 1138  * Weight / pcs : g
1139 1139  
1228 +
1140 1140  = 10. ​Support =
1141 1141  
1142 1142  
image-20230222143809-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +322.1 KB
Content