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

From version 73.1
edited by Saxer Lin
on 2023/06/26 15:19
Change comment: There is no comment for this version
To version 42.1
edited by Bei Jinggeng
on 2023/02/22 14:38
Change comment: Uploaded new attachment "image-20230222143809-1.png", version {1}

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +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 ==
... ... @@ -55,7 +55,7 @@
55 55  
56 56  * LoRaWAN 1.0.3 Class A
57 57  * Ultra-low power consumption
58 -* Controllable 3.3v, 5v and 12v output to power external sensor
58 +* Controllable 5v and 12v output to power external sensor
59 59  * SDI-12 Protocol to connect to SDI-12 Sensor
60 60  * Monitor Battery Level
61 61  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
... ... @@ -66,6 +66,7 @@
66 66  * 8500mAh Battery for long term use
67 67  
68 68  
69 +
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:**
... ... @@ -115,11 +115,12 @@
115 115  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
116 116  
117 117  
117 +
118 118  == 1.4 Connect to SDI-12 Sensor ==
119 119  
120 120  
121 121  
122 -[[image:1675212538524-889.png||_mstalt="298272"]]
122 +[[image:1675212538524-889.png]]
123 123  
124 124  
125 125  == 1.5 Sleep mode and working mode ==
... ... @@ -133,27 +133,28 @@
133 133  == 1.6 Button & LEDs ==
134 134  
135 135  
136 -[[image:1675212633011-651.png||_mstalt="291538"]]
136 +[[image:1675212633011-651.png]]
137 137  
138 138  
139 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; 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" %)(((
139 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
140 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
141 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
142 142  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
143 143  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
144 144  )))
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.
145 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
146 +(% 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.
147 +(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
148 148  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.
149 149  )))
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.
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 PS-LB is in Deep Sleep Mode.
151 151  
152 152  
153 +
153 153  == 1.7 Pin Mapping ==
154 154  
155 155  
156 -[[image:1675213198663-754.png||_mstalt="297167"]]
157 +[[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"]]
177 +[[image:image-20230201090139-2.png]]
177 177  
178 -[[image:image-20230201090139-3.png||_mstalt="428987"]]
179 +[[image:image-20230201090139-3.png]]
179 179  
180 -[[image:image-20230201090139-4.png||_mstalt="429351"]]
181 +[[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"]]
198 +[[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-20230426084456-1.png||height="241" width="519"]]
209 +[[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"]]
217 +[[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"]]
223 +[[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"]]
229 +[[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"]]
234 +[[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"]]
245 +[[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"]]
264 +[[image:image-20230201091027-6.png]]
264 264  
265 265  
266 -[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
267 +[[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"]]
285 +[[image:image-20230201091257-8.png]]
285 285  
286 286  
287 -[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
288 +[[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"]]
321 +[[image:image-20230201091630-10.png]]
321 321  
322 322  
323 -[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
324 +[[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"]]
358 +[[image:image-20230201091954-12.png]]
358 358  
359 359  
360 -[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
361 +[[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"]]
391 +[[image:image-20230201092208-14.png]]
391 391  
392 392  
393 -[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
394 +[[image:image-20230201092208-15.png||height="214" width="1140"]]
394 394  
395 395  
396 396  === 2.3.2 Advance SDI-12 Debug command ===
... ... @@ -399,7 +399,7 @@
399 399  This command can be used to debug all SDI-12 command.
400 400  
401 401  
402 -LoRaWAN Downlink: A8 aa xx xx xx xx bb cc dd
403 +LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
403 403  
404 404  (% style="color:#037691" %)**aa **(%%): total SDI-12 command length
405 405  
... ... @@ -409,11 +409,9 @@
409 409  
410 410  (% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
411 411  
412 -(% style="color:#037691" %)**dd: **(%%) 0: Do not use aD0! command access, 1: use aD0! command access.
413 413  
414 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
414 414  
415 -(% style="color:blue" %)**Example1: **(%%) AT+CFGDEV =0RC0!,1
416 -
417 417  (% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
418 418  
419 419  (% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
... ... @@ -424,23 +424,12 @@
424 424  The following is the display information on the serial port and the server.
425 425  
426 426  
427 -[[image:image-20230201092355-16.png||_mstalt="453960"]]
426 +[[image:image-20230201092355-16.png]]
428 428  
429 429  
430 -[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
429 +[[image:image-20230201092355-17.png||height="426" width="1135"]]
431 431  
432 432  
433 -(% style="color:blue" %)**Example2: **(%%) AT+CFGDEV =0M!,1,1  or  AT+CFGDEV =0C!,1,1
434 -
435 -(% style="color:#037691" %)**0M! **(%%): SDI-12 Command,
436 -
437 -(% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
438 -
439 -(% style="color:#037691" %)**1 **(%%):Use aD0! command access.
440 -
441 -Equal Downlink: 0xA8 03 30  4D 21 01 01 01
442 -
443 -
444 444  === 2.3.3 Convert ASCII to String ===
445 445  
446 446  
... ... @@ -453,12 +453,12 @@
453 453  
454 454  1) AT+CONVFORM=0, string Convert String from String to ASCII
455 455  
456 -[[image:1675214845056-885.png||_mstalt="297622"]]
444 +[[image:1675214845056-885.png]]
457 457  
458 458  
459 459  2) AT+CONVFORM=1, ASCII Convert ASCII to String.
460 460  
461 -[[image:1675214856590-846.png||_mstalt="297739"]]
449 +[[image:1675214856590-846.png]]
462 462  
463 463  
464 464  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -479,7 +479,7 @@
479 479  
480 480  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
481 481  
482 -(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
470 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
483 483  
484 484  (% style="color:red" %)**0 **(%%) No validation check;
485 485  
... ... @@ -495,9 +495,9 @@
495 495  
496 496  (% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
497 497  
498 -(% border="1" style="width:436px" %)
499 -|(% style="background-color:#f2f2f2; width:433px" %)(((
500 -(% style="color:#0070c0" %)**AT+DATACUTx=a,b,c**
486 +(% border="1" style="background-color:#f7faff; width:436px" %)
487 +|(% style="width:433px" %)(((
488 +**AT+DATACUTx=a,b,c**
501 501  
502 502  **a**:  length for the return of AT+COMMAND
503 503  
... ... @@ -506,14 +506,14 @@
506 506  **c**:  define the position for valid value. 
507 507  )))
508 508  
509 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
497 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
510 510  
511 511  
512 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
513 -|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**AT+DATACUT1 value**|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)**Final Result to combine Payload**
514 -|(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33
515 -|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~8+12~~16|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
516 -|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~34|(% style="background-color:#f2f2f2; 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
500 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
501 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
502 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
503 +|(% 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
504 +|(% 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
517 517  
518 518  * (% style="color:blue" %)** Downlink Payload:**
519 519  
... ... @@ -528,14 +528,14 @@
528 528  Where:
529 529  
530 530  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
531 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
519 +* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
532 532  * (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
533 533  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
534 -* (% 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. 
522 +* (% 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. 
535 535  
536 536  (% style="color:blue" %)**Example:**
537 537  
538 -[[image:image-20230201094129-18.png||_mstalt="455065"]]
526 +[[image:image-20230201094129-18.png]]
539 539  
540 540  
541 541  
... ... @@ -562,7 +562,7 @@
562 562  
563 563  Below shows a screen shot how the results combines together to a uplink payload.
564 564  
565 -[[image:1675215745275-920.png||_mstalt="295334"]]
553 +[[image:1675215745275-920.png]]
566 566  
567 567  
568 568  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.
... ... @@ -573,7 +573,7 @@
573 573  (% 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.
574 574  
575 575  
576 -[[image:1675215782925-448.png||_mstalt="297466"]]
564 +[[image:1675215782925-448.png]]
577 577  
578 578  
579 579  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.
... ... @@ -591,7 +591,7 @@
591 591  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
592 592  
593 593  
594 -[[image:1675215828102-844.png||_mstalt="294645"]]
582 +[[image:1675215828102-844.png]]
595 595  
596 596  
597 597  (% style="color:#4f81bd" %)**AT+DATAUP=1**
... ... @@ -606,7 +606,7 @@
606 606  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
607 607  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
608 608  
609 -[[image:1675215848113-696.png||_mstalt="296998"]]
597 +[[image:1675215848113-696.png]]
610 610  
611 611  
612 612  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
... ... @@ -623,6 +623,15 @@
623 623  
624 624  == 2.4 Uplink Payload ==
625 625  
614 +
615 +Uplink payloads have two types:
616 +
617 +* Distance Value: Use FPORT=2
618 +* Other control commands: Use other FPORT fields.
619 +
620 +The application server should parse the correct value based on FPORT settings.
621 +
622 +
626 626  === 2.4.1 Device Payload, FPORT~=5 ===
627 627  
628 628  
... ... @@ -630,14 +630,14 @@
630 630  
631 631  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
632 632  
633 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
634 -|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
635 -|(% style="background-color:#f2f2f2; width:103px" %)**Size (bytes)**|(% style="background-color:#f2f2f2; width:72px" %)**1**|(% style="background-color:#f2f2f2" %)**2**|(% style="background-color:#f2f2f2; width:91px" %)**1**|(% style="background-color:#f2f2f2; width:86px" %)**1**|(% style="background-color:#f2f2f2; width:44px" %)**2**
636 -|(% style="background-color:#f2f2f2; width:103px" %)**Value**|(% style="background-color:#f2f2f2; width:72px" %)Sensor Model|(% style="background-color:#f2f2f2" %)Firmware Version|(% style="background-color:#f2f2f2; width:91px" %)Frequency Band|(% style="background-color:#f2f2f2; width:86px" %)Sub-band|(% style="background-color:#f2f2f2; width:44px" %)BAT
630 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
631 +|(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
632 +|(% 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**
633 +|(% 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
637 637  
638 638  Example parse in TTNv3
639 639  
640 -[[image:1675215946738-635.png||_mstalt="297778"]]
637 +[[image:1675215946738-635.png]]
641 641  
642 642  
643 643  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
... ... @@ -702,10 +702,10 @@
702 702  
703 703  * Periodically Uplink: FPORT=2
704 704  
705 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
706 -|=(% style="width: 90px;background-color:#D9E2F3" %)(((
702 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
703 +|=(% style="width: 90px;" %)(((
707 707  **Size(bytes)**
708 -)))|=(% style="width: 80px;background-color:#D9E2F3" %)**2**|=(% style="width: 90px;background-color:#D9E2F3" %)**1**|=(% style="width: 240px;background-color:#D9E2F3" %)**Length depends on the return from the commands**
705 +)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
709 709  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
710 710  Battery(mV)
711 711  &
... ... @@ -715,7 +715,7 @@
715 715  Payload length in server,server will show payload not provided in the LoRaWAN server.
716 716  )))
717 717  
718 -[[image:1675216282284-923.png||_mstalt="295633"]]
715 +[[image:1675216282284-923.png]]
719 719  
720 720  
721 721  === 2.4.3 Battery Info ===
... ... @@ -743,15 +743,13 @@
743 743  === 2.4.5 Payload version ===
744 744  
745 745  
746 -The version number of the payload, mainly used for decoding. The default is 01.
747 747  
748 -
749 749  === 2.4.6 ​Decode payload in The Things Network ===
750 750  
751 751  
752 752  While using TTN network, you can add the payload format to decode the payload.
753 753  
754 -[[image:1675216779406-595.png||_mstalt="298376"]]
749 +[[image:1675216779406-595.png]]
755 755  
756 756  
757 757  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.
... ... @@ -764,241 +764,18 @@
764 764  
765 765  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:
766 766  
767 -[[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]]
762 +[[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]]]]
768 768  
769 769  
770 -== 2.6 Examples To Set SDI commands ==
765 +== 2.6 Frequency Plans ==
771 771  
772 -=== 2.6.1 Examples 1 ~-~- General Example ===
773 773  
774 -
775 -COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
776 -
777 -[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]]
778 -
779 -
780 -(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:**
781 -
782 -a. Send the first command and get the first reply:
783 -
784 -(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
785 -
786 -b. Send the second command and get the second reply:
787 -
788 -(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
789 -
790 -c. Send the third command and get the third reply:
791 -
792 -(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
793 -
794 -d. Send the fourth command and get the fourth reply:
795 -
796 -(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
797 -
798 -e. Send the fifth command plus the sixth command, get the sixth reply:
799 -
800 -(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
801 -
802 -f. Send the seventh command plus the eighth command, get the eighth reply:
803 -
804 -(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
805 -
806 -g. Send the ninth command plus the tenth command, get the tenth reply:
807 -
808 -(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
809 -
810 -h. Send the eleventh command plus the twelfth command, get the twelfth reply:
811 -
812 -(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
813 -
814 -
815 -(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:**
816 -
817 -a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
818 -
819 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);
820 -
821 -b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
822 -
823 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
824 -
825 -c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
826 -
827 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
828 -
829 -d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>”
830 -
831 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
832 -
833 -e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>”
834 -
835 -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”**.
836 -
837 -
838 -=== 2.6.2 Example 2 ~-~- Connect to Hygrovue10 ===
839 -
840 -==== 2.6.2.1 Reference Manual and Command ====
841 -
842 -
843 -* [[Hygrovue10 Product Page>>https://www.campbellsci.com/hygrovue10]]
844 -
845 -* Commands to be used in PC and output.
846 -
847 -~1. check device address
848 -
849 -2. change device address
850 -
851 -3. check device ID
852 -
853 -4. start measure
854 -
855 -5. Get Meausre result
856 -
857 -[[image:image-20230603120209-2.png||height="281" width="267"]]
858 -
859 -
860 -==== 2.6.2.2 Hardware Connection to SDI-12-LB ====
861 -
862 -
863 -[[image:image-20230603120515-3.png]]
864 -
865 -
866 -==== 2.6.2.3 Commands set in SDI-12-LB and uplink payload ====
867 -
868 -
869 -[[image:image-20230603120648-4.png]]
870 -
871 -[[image:image-20230603120726-5.png]]
872 -
873 -
874 -**Data in TTN:**
875 -
876 -[[image:image-20230603120859-6.png||height="118" width="1285"]]
877 -
878 -
879 -=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.3 Example 3 ~-~- Connect to SIL-400 ===
880 -
881 -==== 2.6.3.1 Reference Manual and Command ====
882 -
883 -
884 -* [[SIL-400 Product Page>>https://www.apogeeinstruments.com/sil-411-commercial-grade-sdi-12-digital-output-standard-field-of-view-infrared-radiometer-sensor/]]
885 -
886 -* Commands to be used in PC and output.
887 -
888 -~1. check device address
889 -
890 -2. change device address
891 -
892 -3. check device ID
893 -
894 -4. start measure
895 -
896 -5. Get Meausre result
897 -
898 -[[image:image-20230603121606-7.png||height="242" width="307"]]
899 -
900 -
901 -==== 2.6.3.2 Hardware Connection to SDI-12-LB ====
902 -
903 -
904 -[[image:image-20230603121643-8.png||height="442" width="656"]]
905 -
906 -
907 -==== 2.6.3.3 Commands set in SDI-12-LB and uplink payload ====
908 -
909 -
910 -[[image:image-20230603121721-9.png]]
911 -
912 -[[image:image-20230603121752-10.png]]
913 -
914 -Data in TTN:
915 -
916 -[[image:image-20230603121826-11.png||height="155" width="1104"]]
917 -
918 -
919 -
920 -=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.4 Example 4 ~-~- Connect to TEROS-12 ===
921 -
922 -==== 2.6.4.1 Reference Manual and Command ====
923 -
924 -
925 -* [[TEROS-12 Product Page>>https://www.metergroup.com/en/meter-environment/products/teros-12-soil-moisture-sensor]]
926 -
927 -* Commands to be used in PC and output.
928 -
929 -1.check device address
930 -
931 -2.change device address
932 -
933 -3.check device ID
934 -
935 -4.start measure
936 -
937 -5.Get Meausre result
938 -
939 -[[image:image-20230603122248-16.png||height="196" width="198"]]
940 -
941 -
942 -==== 2.6.4.2 Hardware Connection to SDI-12-LB ====
943 -
944 -
945 -[[image:image-20230603122212-15.png||height="502" width="667"]]
946 -
947 -
948 -==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ====
949 -
950 -[[image:image-20230603122040-12.png]]
951 -
952 -[[image:image-20230603122109-13.png||height="469" width="762"]]
953 -
954 -
955 -**Data in TTN:**
956 -
957 -[[image:image-20230603122139-14.png||height="148" width="1128"]]
958 -
959 -
960 -=== (% id="cke_bm_1489640S" style="display:none" %) (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.5 Example 5 ~-~- Connect to SIL-400/TEROS-12 & Hygrovue10 ===
961 -
962 -==== 2.6.5.1 Important Notice! ====
963 -
964 -
965 -* The product page and reference command see above example 2,3,4
966 -
967 -* All of these SDI-12 sensors use the same address (address 0) by default. So we need to change their address to different address, by using **aAb!** command. See above example.
968 -
969 -* The sensor needs to be powered to a steady statue. So the 12VT time need to be set to the maximum stable time for the sensors. in this example, it is 13 seconds.
970 -
971 -* If these SDI-12 sensors are powered by external power source. It will add 300uA in the total current in SDI-12-LB.
972 -
973 -
974 -==== 2.6.5.2 Hardware Connection to SDI-12-LB ====
975 -
976 -
977 -[[image:image-20230603122508-17.png||height="526" width="742"]]
978 -
979 -
980 -==== 2.6.5.3 Commands set in SDI-12-LB and uplink payload ====
981 -
982 -
983 -[[image:image-20230603122549-18.png]]
984 -
985 -[[image:image-20230603122623-19.png||height="483" width="1121"]]
986 -
987 -
988 -**Data in TTN:**
989 -
990 -[[image:image-20230603122719-20.png||height="151" width="1179"]]
991 -
992 -
993 -== 2.7 Frequency Plans ==
994 -
995 -
996 996  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.
997 997  
998 998  [[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/]]
999 999  
1000 1000  
1001 -== 2.8 Firmware Change Log ==
773 +== 2.7 Firmware Change Log ==
1002 1002  
1003 1003  
1004 1004  **Firmware download link:**
... ... @@ -1033,7 +1033,7 @@
1033 1033  These commands only valid for SDI-12-LB, as below:
1034 1034  
1035 1035  
1036 -== 3.1 Set Transmit Interval Time ==
808 +== ​​​​​​​3.1 Set Transmit Interval Time ==
1037 1037  
1038 1038  
1039 1039  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -1040,14 +1040,14 @@
1040 1040  
1041 1041  (% style="color:blue" %)**AT Command: AT+TDC**
1042 1042  
1043 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1044 -|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Command Example**|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1045 -|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval|(% style="background-color:#f2f2f2" %)(((
815 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
816 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response**
817 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
1046 1046  30000
1047 1047  OK
1048 1048  the interval is 30000ms = 30s
1049 1049  )))
1050 -|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval|(% style="background-color:#f2f2f2" %)(((
822 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1051 1051  OK
1052 1052  Set transmit interval to 60000ms = 60 seconds
1053 1053  )))
... ... @@ -1063,6 +1063,7 @@
1063 1063  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
1064 1064  
1065 1065  
838 +
1066 1066  == 3.2 Set Interrupt Mode ==
1067 1067  
1068 1068  
... ... @@ -1070,20 +1070,20 @@
1070 1070  
1071 1071  (% style="color:blue" %)**AT Command: AT+INTMOD**
1072 1072  
1073 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1074 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1075 -|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=?|(% style="background-color:#f2f2f2; width:196px" %)Show current interrupt mode|(% style="background-color:#f2f2f2; width:157px" %)(((
846 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
847 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 187px;" %)**Function**|=(% style="width: 165px;" %)**Response**
848 +|(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
1076 1076  0
1077 1077  OK
1078 -the mode is 0 =Disable Interrupt
851 +the mode is 0 = No interruption
1079 1079  )))
1080 -|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2|(% style="background-color:#f2f2f2; width:196px" %)(((
853 +|(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
1081 1081  Set Transmit Interval
1082 -0. (Disable Interrupt),
1083 -~1. (Trigger by rising and falling edge)
1084 -2. (Trigger by falling edge)
1085 -3. (Trigger by rising edge)
1086 -)))|(% style="background-color:#f2f2f2; width:157px" %)OK
855 +~1. (Disable Interrupt),
856 +2. (Trigger by rising and falling edge)
857 +3. (Trigger by falling edge)
858 +4. (Trigger by rising edge)
859 +)))|(% style="width:165px" %)OK
1087 1087  
1088 1088  (% style="color:blue" %)**Downlink Command: 0x06**
1089 1089  
... ... @@ -1095,6 +1095,7 @@
1095 1095  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1096 1096  
1097 1097  
871 +
1098 1098  == 3.3 Set the output time ==
1099 1099  
1100 1100  
... ... @@ -1102,54 +1102,52 @@
1102 1102  
1103 1103  (% style="color:blue" %)**AT Command: AT+3V3T**
1104 1104  
1105 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %)
1106 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 201px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 116px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1107 -|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=?|(% style="background-color:#f2f2f2; width:201px" %)Show 3V3 open time.|(% style="background-color:#f2f2f2; width:116px" %)(((
879 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %)
880 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response**
881 +|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)(((
1108 1108  0
1109 1109  OK
1110 1110  )))
1111 -|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=0|(% style="background-color:#f2f2f2; width:201px" %)Normally open 3V3 power supply.|(% style="background-color:#f2f2f2; width:116px" %)(((
885 +|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)(((
1112 1112  OK
1113 1113  default setting
1114 1114  )))
1115 -|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=1000|(% style="background-color:#f2f2f2; width:201px" %)Close after a delay of 1000 milliseconds.|(% style="background-color:#f2f2f2; width:116px" %)(((
889 +|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)(((
1116 1116  OK
1117 1117  )))
1118 -|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=65535|(% style="background-color:#f2f2f2; width:201px" %)Normally closed 3V3 power supply.|(% style="background-color:#f2f2f2; width:116px" %)(((
892 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)(((
1119 1119  OK
1120 1120  )))
1121 1121  
1122 1122  (% style="color:blue" %)**AT Command: AT+5VT**
1123 1123  
1124 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
1125 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 114px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1126 -|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=?|(% style="background-color:#f2f2f2; width:196px" %)Show 5V open time.|(% style="background-color:#f2f2f2; width:114px" %)(((
898 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %)
899 +|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response**
900 +|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)(((
1127 1127  0
1128 1128  OK
1129 1129  )))
1130 -|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=0|(% style="background-color:#f2f2f2; width:196px" %)Normally closed 5V power supply.|(% style="background-color:#f2f2f2; width:114px" %)(((
904 +|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)(((
1131 1131  OK
1132 1132  default setting
1133 1133  )))
1134 -|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=1000|(% style="background-color:#f2f2f2; width:196px" %)Close after a delay of 1000 milliseconds.|(% style="background-color:#f2f2f2; width:114px" %)(((
908 +|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)(((
1135 1135  OK
1136 1136  )))
1137 -|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=65535|(% style="background-color:#f2f2f2; width:196px" %)Normally open 5V power supply.|(% style="background-color:#f2f2f2; width:114px" %)(((
911 +|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)(((
1138 1138  OK
1139 1139  )))
1140 1140  
1141 -(% style="color:blue" %)**AT Command: AT+12VT **
915 +(% style="color:blue" %)**AT Command: AT+12VT**
1142 1142  
1143 -(% style="color:blue" %)**(The v1.2 version is enabled for 1 second by default, and the version below v1.2 is disabled by default)**
1144 -
1145 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %)
1146 -|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 199px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 83px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1147 -|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=?|(% style="background-color:#f2f2f2; width:199px" %)Show 12V open time.|(% style="background-color:#f2f2f2; width:83px" %)(((
917 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %)
918 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response**
919 +|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)(((
1148 1148  0
1149 1149  OK
1150 1150  )))
1151 -|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=0|(% style="background-color:#f2f2f2; width:199px" %)Normally closed 12V power supply.|(% style="background-color:#f2f2f2; width:83px" %)OK
1152 -|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=500|(% style="background-color:#f2f2f2; width:199px" %)Close after a delay of 500 milliseconds.|(% style="background-color:#f2f2f2; width:83px" %)(((
923 +|(% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK
924 +|(% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)(((
1153 1153  OK
1154 1154  )))
1155 1155  
... ... @@ -1167,6 +1167,7 @@
1167 1167  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
1168 1168  
1169 1169  
942 +
1170 1170  == 3.4 Set the all data mode ==
1171 1171  
1172 1172  
... ... @@ -1174,13 +1174,13 @@
1174 1174  
1175 1175  (% style="color:blue" %)**AT Command: AT+ALLDATAMOD**
1176 1176  
1177 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
1178 -|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
1179 -|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?|(% style="background-color:#f2f2f2" %)Show current all data mode|(% style="background-color:#f2f2f2" %)(((
950 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
951 +|=**Command Example**|=**Function**|=**Response**
952 +|AT+ALLDATAMOD=?|Show current all data mode|(((
1180 1180  0
1181 1181  OK
1182 1182  )))
1183 -|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=1|(% style="background-color:#f2f2f2" %)Set all data mode is 1.|(% style="background-color:#f2f2f2" %)OK
956 +|AT+ALLDATAMOD=1|Set all data mode is 1.|OK
1184 1184  
1185 1185  (% style="color:blue" %)**Downlink Command: 0xAB**
1186 1186  
... ... @@ -1190,6 +1190,7 @@
1190 1190  * Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
1191 1191  
1192 1192  
966 +
1193 1193  == 3.5 Set the splicing payload for uplink ==
1194 1194  
1195 1195  
... ... @@ -1197,21 +1197,21 @@
1197 1197  
1198 1198  (% style="color:blue" %)**AT Command: AT+DATAUP**
1199 1199  
1200 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1201 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 266px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
1202 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =?|(% style="background-color:#f2f2f2; width:266px" %)Show current splicing payload for uplink mode|(% style="background-color:#f2f2f2" %)(((
974 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
975 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 266px;" %)**Function**|=**Response**
976 +|(% style="width:154px" %)AT+DATAUP =?|(% style="width:266px" %)Show current splicing payload for uplink mode|(((
1203 1203  0
1204 1204  OK
1205 1205  )))
1206 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =0|(% style="background-color:#f2f2f2; width:266px" %)(((
980 +|(% style="width:154px" %)AT+DATAUP =0|(% style="width:266px" %)(((
1207 1207  Set splicing payload for uplink mode is 0.
1208 -)))|(% style="background-color:#f2f2f2" %)(((
982 +)))|(((
1209 1209  OK
1210 1210  )))
1211 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1|(% style="background-color:#f2f2f2; width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|(% style="background-color:#f2f2f2" %)OK
1212 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1,20000|(% style="background-color:#f2f2f2; width:266px" %)(((
985 +|(% style="width:154px" %)AT+DATAUP =1|(% style="width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK
986 +|(% style="width:154px" %)AT+DATAUP =1,20000|(% style="width:266px" %)(((
1213 1213  Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1214 -)))|(% style="background-color:#f2f2f2" %)OK
988 +)))|OK
1215 1215  
1216 1216  (% style="color:blue" %)**Downlink Command: 0xAD**
1217 1217  
... ... @@ -1231,13 +1231,13 @@
1231 1231  
1232 1232  (% style="color:blue" %)**AT Command: AT+PAYVER**
1233 1233  
1234 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
1235 -|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 192px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
1236 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=?|(% style="background-color:#f2f2f2; width:192px" %)Show current payload version|(% style="background-color:#f2f2f2" %)(((
1008 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
1009 +|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=**Response**
1010 +|(% style="width:158px" %)AT+PAYVER=?|(% style="width:192px" %)Show current payload version|(((
1237 1237  1
1238 1238  OK
1239 1239  )))
1240 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=5|(% style="background-color:#f2f2f2; width:192px" %)Set payload version is 5.|(% style="background-color:#f2f2f2" %)OK
1014 +|(% style="width:158px" %)AT+PAYVER=5|(% style="width:192px" %)Set payload version is 5.|OK
1241 1241  
1242 1242  (% style="color:blue" %)**Downlink Command: 0xAE**
1243 1243  
... ... @@ -1247,14 +1247,77 @@
1247 1247  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1248 1248  
1249 1249  
1250 -= 4. Battery & Power Consumption =
1251 1251  
1025 += 4. Battery & how to replace =
1252 1252  
1253 -SDI-12-LB uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1027 +== 4.1 Battery Type ==
1254 1254  
1255 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1256 1256  
1030 +SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter.
1257 1257  
1032 +
1033 +The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1034 +
1035 +[[image:1675234124233-857.png]]
1036 +
1037 +
1038 +Minimum Working Voltage for the SDI-12-LB:
1039 +
1040 +SDI-12-LB:  2.45v ~~ 3.6v
1041 +
1042 +
1043 +== 4.2 Replace Battery ==
1044 +
1045 +
1046 +Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1047 +
1048 +And make sure the positive and negative pins match.
1049 +
1050 +
1051 +== 4.3 Power Consumption Analyze ==
1052 +
1053 +
1054 +Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
1055 +
1056 +Instruction to use as below:
1057 +
1058 +(% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]]
1059 +
1060 +(% style="color:blue" %)**Step 2:**(%%) Open it and choose
1061 +
1062 +* Product Model
1063 +* Uplink Interval
1064 +* Working Mode
1065 +
1066 +And the Life expectation in difference case will be shown on the right.
1067 +
1068 +
1069 +[[image:1675234155374-163.png]]
1070 +
1071 +
1072 +The battery related documents as below:
1073 +
1074 +* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
1075 +* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1076 +* [[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]]
1077 +
1078 +[[image:image-20230201145019-19.png]]
1079 +
1080 +
1081 +=== 4.3.1 ​Battery Note ===
1082 +
1083 +
1084 +The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
1085 +
1086 +
1087 +=== 4.3.2 Replace the battery ===
1088 +
1089 +
1090 +You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board.
1091 +
1092 +The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes)
1093 +
1094 +
1258 1258  = 5. Remote Configure device =
1259 1259  
1260 1260  == 5.1 Connect via BLE ==
... ... @@ -1277,7 +1277,7 @@
1277 1277  
1278 1278  = 7. FAQ =
1279 1279  
1280 -== 7.1 How to use AT Command  via UART to access device? ==
1117 +== 7.1 How to use AT Command to access device? ==
1281 1281  
1282 1282  
1283 1283  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]]
... ... @@ -1334,6 +1334,7 @@
1334 1334  * Weight / pcs : g
1335 1335  
1336 1336  
1174 +
1337 1337  = 10. ​Support =
1338 1338  
1339 1339  
... ... @@ -1340,3 +1340,5 @@
1340 1340  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1341 1341  
1342 1342  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
1181 +
1182 +
image-20230426084456-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -190.0 KB
Content
image-20230603120127-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -5.7 KB
Content
image-20230603120209-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -22.8 KB
Content
image-20230603120515-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -489.3 KB
Content
image-20230603120648-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -100.8 KB
Content
image-20230603120726-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -133.2 KB
Content
image-20230603120859-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -55.9 KB
Content
image-20230603121606-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -24.4 KB
Content
image-20230603121643-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -889.7 KB
Content
image-20230603121721-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -105.4 KB
Content
image-20230603121752-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -160.0 KB
Content
image-20230603121826-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -52.8 KB
Content
image-20230603122040-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -128.1 KB
Content
image-20230603122109-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -271.1 KB
Content
image-20230603122139-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -70.4 KB
Content
image-20230603122212-15.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -818.3 KB
Content
image-20230603122248-16.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -12.7 KB
Content
image-20230603122508-17.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -980.2 KB
Content
image-20230603122549-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -90.9 KB
Content
image-20230603122623-19.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -139.5 KB
Content
image-20230603122719-20.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -83.8 KB
Content