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

From version 73.3
edited by Xiaoling
on 2023/06/27 10:28
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.Xiaoling
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
... ... @@ -79,8 +79,6 @@
79 79  (% style="color:#037691" %)**Common DC Characteristics:**
80 80  
81 81  * Supply Voltage: 2.5v ~~ 3.6v
82 -* Support current: 5V 300mA
83 - 12V 100mA
84 84  * Operating Temperature: -40 ~~ 85°C
85 85  
86 86  (% style="color:#037691" %)**LoRa Spec:**
... ... @@ -120,9 +120,10 @@
120 120  == 1.4 Connect to SDI-12 Sensor ==
121 121  
122 122  
123 -[[image:1675212538524-889.png||_mstalt="298272"]]
124 124  
122 +[[image:1675212538524-889.png]]
125 125  
124 +
126 126  == 1.5 Sleep mode and working mode ==
127 127  
128 128  
... ... @@ -134,21 +134,21 @@
134 134  == 1.6 Button & LEDs ==
135 135  
136 136  
137 -[[image:1675212633011-651.png||_mstalt="291538"]]
136 +[[image:1675212633011-651.png]]
138 138  
139 139  
140 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
141 -|=(% 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**
142 -|(% 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" %)(((
143 143  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
144 144  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
145 145  )))
146 -|(% 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" %)(((
147 -(% 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.
148 -(% 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.
149 149  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.
150 150  )))
151 -|(% 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.
152 152  
153 153  
154 154  
... ... @@ -155,7 +155,7 @@
155 155  == 1.7 Pin Mapping ==
156 156  
157 157  
158 -[[image:1675213198663-754.png||_mstalt="297167"]]
157 +[[image:1675213198663-754.png]]
159 159  
160 160  
161 161  == 1.8 BLE connection ==
... ... @@ -175,11 +175,11 @@
175 175  == 1.9 Mechanical ==
176 176  
177 177  
178 -[[image:image-20230201090139-2.png||_mstalt="428623"]]
177 +[[image:image-20230201090139-2.png]]
179 179  
180 -[[image:image-20230201090139-3.png||_mstalt="428987"]]
179 +[[image:image-20230201090139-3.png]]
181 181  
182 -[[image:image-20230201090139-4.png||_mstalt="429351"]]
181 +[[image:image-20230201090139-4.png]]
183 183  
184 184  
185 185  = 2. Configure SDI-12 to connect to LoRaWAN network =
... ... @@ -196,7 +196,7 @@
196 196  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.
197 197  
198 198  
199 -[[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]
198 +[[image:image-20230201090528-5.png||height="465" width="1111"]]
200 200  
201 201  
202 202  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.
... ... @@ -206,32 +206,33 @@
206 206  
207 207  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
208 208  
209 -[[image:image-20230426084456-1.png||height="241" width="519"]]
210 210  
209 +[[image:image-20230201152430-20.jpeg]]
211 211  
211 +
212 212  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
213 213  
214 214  
215 215  (% style="color:blue" %)**Register the device**
216 216  
217 -[[image:1675213652444-622.png||_mstalt="293657"]]
217 +[[image:1675213652444-622.png]]
218 218  
219 219  
220 220  (% style="color:blue" %)**Add APP EUI and DEV EUI**
221 221  
222 222  
223 -[[image:1675213661769-223.png||_mstalt="295217"]]
223 +[[image:1675213661769-223.png]]
224 224  
225 225  
226 226  (% style="color:blue" %)**Add APP EUI in the application**
227 227  
228 228  
229 -[[image:1675213675852-577.png||_mstalt="297947"]]
229 +[[image:1675213675852-577.png]]
230 230  
231 231  
232 232  (% style="color:blue" %)**Add APP KEY**
233 233  
234 -[[image:1675213686734-883.png||_mstalt="298064"]]
234 +[[image:1675213686734-883.png]]
235 235  
236 236  
237 237  (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
... ... @@ -242,7 +242,7 @@
242 242  (% 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.
243 243  
244 244  
245 -[[image:1675213704414-644.png||_mstalt="293748"]]
245 +[[image:1675213704414-644.png]]
246 246  
247 247  
248 248  == ​2.3 SDI-12 Related Commands ==
... ... @@ -261,10 +261,10 @@
261 261  The following is the display information on the serial port and the server.
262 262  
263 263  
264 -[[image:image-20230201091027-6.png||_mstalt="429065"]]
264 +[[image:image-20230201091027-6.png]]
265 265  
266 266  
267 -[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
267 +[[image:image-20230201091027-7.png||height="261" width="1179"]]
268 268  
269 269  
270 270  
... ... @@ -282,10 +282,10 @@
282 282  The following is the display information on the serial port and the server.
283 283  
284 284  
285 -[[image:image-20230201091257-8.png||_mstalt="431392"]]
285 +[[image:image-20230201091257-8.png]]
286 286  
287 287  
288 -[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
288 +[[image:image-20230201091257-9.png||height="225" width="1242"]]
289 289  
290 290  
291 291  ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
... ... @@ -318,10 +318,10 @@
318 318  The following is the display information on the serial port and the server.
319 319  
320 320  
321 -[[image:image-20230201091630-10.png||_mstalt="449995"]]
321 +[[image:image-20230201091630-10.png]]
322 322  
323 323  
324 -[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
324 +[[image:image-20230201091630-11.png||height="247" width="1165"]]
325 325  
326 326  
327 327  
... ... @@ -355,10 +355,10 @@
355 355  The following is the display information on the serial port and the server.
356 356  
357 357  
358 -[[image:image-20230201091954-12.png||_mstalt="453687"]]
358 +[[image:image-20230201091954-12.png]]
359 359  
360 360  
361 -[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
361 +[[image:image-20230201091954-13.png||height="203" width="1117"]]
362 362  
363 363  
364 364  
... ... @@ -388,10 +388,10 @@
388 388  The following is the display information on the serial port and the server.
389 389  
390 390  
391 -[[image:image-20230201092208-14.png||_mstalt="452283"]]
391 +[[image:image-20230201092208-14.png]]
392 392  
393 393  
394 -[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
394 +[[image:image-20230201092208-15.png||height="214" width="1140"]]
395 395  
396 396  
397 397  === 2.3.2 Advance SDI-12 Debug command ===
... ... @@ -400,7 +400,7 @@
400 400  This command can be used to debug all SDI-12 command.
401 401  
402 402  
403 -LoRaWAN Downlink: A8 aa xx xx xx xx bb cc dd
403 +LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
404 404  
405 405  (% style="color:#037691" %)**aa **(%%): total SDI-12 command length
406 406  
... ... @@ -410,11 +410,9 @@
410 410  
411 411  (% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
412 412  
413 -(% style="color:#037691" %)**dd: **(%%) 0: Do not use aD0! command access, 1: use aD0! command access.
414 414  
414 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
415 415  
416 -(% style="color:blue" %)**Example1: **(%%) AT+CFGDEV =0RC0!,1
417 -
418 418  (% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
419 419  
420 420  (% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
... ... @@ -425,23 +425,12 @@
425 425  The following is the display information on the serial port and the server.
426 426  
427 427  
428 -[[image:image-20230201092355-16.png||_mstalt="453960"]]
426 +[[image:image-20230201092355-16.png]]
429 429  
430 430  
431 -[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
429 +[[image:image-20230201092355-17.png||height="426" width="1135"]]
432 432  
433 433  
434 -(% style="color:blue" %)**Example2: **(%%) AT+CFGDEV =0M!,1,1  or  AT+CFGDEV =0C!,1,1
435 -
436 -(% style="color:#037691" %)**0M! **(%%): SDI-12 Command,
437 -
438 -(% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
439 -
440 -(% style="color:#037691" %)**1 **(%%):Use aD0! command access.
441 -
442 -Equal Downlink: 0xA8 03 30  4D 21 01 01 01
443 -
444 -
445 445  === 2.3.3 Convert ASCII to String ===
446 446  
447 447  
... ... @@ -454,12 +454,12 @@
454 454  
455 455  1) AT+CONVFORM=0, string Convert String from String to ASCII
456 456  
457 -[[image:1675214845056-885.png||_mstalt="297622"]]
444 +[[image:1675214845056-885.png]]
458 458  
459 459  
460 460  2) AT+CONVFORM=1, ASCII Convert ASCII to String.
461 461  
462 -[[image:1675214856590-846.png||_mstalt="297739"]]
449 +[[image:1675214856590-846.png]]
463 463  
464 464  
465 465  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -480,7 +480,7 @@
480 480  
481 481  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
482 482  
483 -(% 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.
484 484  
485 485  (% style="color:red" %)**0 **(%%) No validation check;
486 486  
... ... @@ -496,9 +496,9 @@
496 496  
497 497  (% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
498 498  
499 -(% border="1" style="width:436px" %)
500 -|(% style="background-color:#f2f2f2; width:433px" %)(((
501 -(% 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**
502 502  
503 503  **a**:  length for the return of AT+COMMAND
504 504  
... ... @@ -507,14 +507,14 @@
507 507  **c**:  define the position for valid value. 
508 508  )))
509 509  
510 -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:
511 511  
512 512  
513 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
514 -|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**AT+DATACUT1 value**|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)**Final Result to combine Payload**
515 -|(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33
516 -|(% 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
517 -|(% 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
518 518  
519 519  * (% style="color:blue" %)** Downlink Payload:**
520 520  
... ... @@ -529,14 +529,14 @@
529 529  Where:
530 530  
531 531  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
532 -* (% 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.
533 533  * (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
534 534  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
535 -* (% 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. 
536 536  
537 537  (% style="color:blue" %)**Example:**
538 538  
539 -[[image:image-20230201094129-18.png||_mstalt="455065"]]
526 +[[image:image-20230201094129-18.png]]
540 540  
541 541  
542 542  
... ... @@ -563,7 +563,7 @@
563 563  
564 564  Below shows a screen shot how the results combines together to a uplink payload.
565 565  
566 -[[image:1675215745275-920.png||_mstalt="295334"]]
553 +[[image:1675215745275-920.png]]
567 567  
568 568  
569 569  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.
... ... @@ -574,7 +574,7 @@
574 574  (% 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.
575 575  
576 576  
577 -[[image:1675215782925-448.png||_mstalt="297466"]]
564 +[[image:1675215782925-448.png]]
578 578  
579 579  
580 580  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.
... ... @@ -592,7 +592,7 @@
592 592  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
593 593  
594 594  
595 -[[image:1675215828102-844.png||_mstalt="294645"]]
582 +[[image:1675215828102-844.png]]
596 596  
597 597  
598 598  (% style="color:#4f81bd" %)**AT+DATAUP=1**
... ... @@ -607,7 +607,7 @@
607 607  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
608 608  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
609 609  
610 -[[image:1675215848113-696.png||_mstalt="296998"]]
597 +[[image:1675215848113-696.png]]
611 611  
612 612  
613 613  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
... ... @@ -624,6 +624,15 @@
624 624  
625 625  == 2.4 Uplink Payload ==
626 626  
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 +
627 627  === 2.4.1 Device Payload, FPORT~=5 ===
628 628  
629 629  
... ... @@ -631,14 +631,14 @@
631 631  
632 632  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
633 633  
634 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
635 -|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
636 -|(% 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**
637 -|(% 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
638 638  
639 639  Example parse in TTNv3
640 640  
641 -[[image:1675215946738-635.png||_mstalt="297778"]]
637 +[[image:1675215946738-635.png]]
642 642  
643 643  
644 644  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
... ... @@ -647,33 +647,33 @@
647 647  
648 648  (% style="color:#037691" %)**Frequency Band**:
649 649  
650 -0x01: EU868
646 +*0x01: EU868
651 651  
652 -0x02: US915
648 +*0x02: US915
653 653  
654 -0x03: IN865
650 +*0x03: IN865
655 655  
656 -0x04: AU915
652 +*0x04: AU915
657 657  
658 -0x05: KZ865
654 +*0x05: KZ865
659 659  
660 -0x06: RU864
656 +*0x06: RU864
661 661  
662 -0x07: AS923
658 +*0x07: AS923
663 663  
664 -0x08: AS923-1
660 +*0x08: AS923-1
665 665  
666 -0x09: AS923-2
662 +*0x09: AS923-2
667 667  
668 -0x0a: AS923-3
664 +*0x0a: AS923-3
669 669  
670 -0x0b: CN470
666 +*0x0b: CN470
671 671  
672 -0x0c: EU433
668 +*0x0c: EU433
673 673  
674 -0x0d: KR920
670 +*0x0d: KR920
675 675  
676 -0x0e: MA869
672 +*0x0e: MA869
677 677  
678 678  
679 679  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -703,10 +703,10 @@
703 703  
704 704  * Periodically Uplink: FPORT=2
705 705  
706 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
707 -|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)(((
702 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
703 +|=(% style="width: 90px;" %)(((
708 708  **Size(bytes)**
709 -)))|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 240px;background-color:#D9E2F3;color:#0070C0" %)**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**
710 710  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
711 711  Battery(mV)
712 712  &
... ... @@ -716,7 +716,7 @@
716 716  Payload length in server,server will show payload not provided in the LoRaWAN server.
717 717  )))
718 718  
719 -[[image:1675216282284-923.png||_mstalt="295633"]]
715 +[[image:1675216282284-923.png]]
720 720  
721 721  
722 722  === 2.4.3 Battery Info ===
... ... @@ -744,15 +744,13 @@
744 744  === 2.4.5 Payload version ===
745 745  
746 746  
747 -The version number of the payload, mainly used for decoding. The default is 01.
748 748  
749 -
750 750  === 2.4.6 ​Decode payload in The Things Network ===
751 751  
752 752  
753 753  While using TTN network, you can add the payload format to decode the payload.
754 754  
755 -[[image:1675216779406-595.png||_mstalt="298376"]]
749 +[[image:1675216779406-595.png]]
756 756  
757 757  
758 758  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.
... ... @@ -765,240 +765,18 @@
765 765  
766 766  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:
767 767  
768 -[[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]]]]
769 769  
770 770  
771 -== 2.6 Examples To Set SDI commands ==
765 +== 2.6 Frequency Plans ==
772 772  
773 -=== 2.6.1 Examples 1 ~-~- General Example ===
774 774  
775 -
776 -COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
777 -
778 -[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]]
779 -
780 -
781 -(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:**
782 -
783 -a. Send the first command and get the first reply:
784 -
785 -(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
786 -
787 -b. Send the second command and get the second reply:
788 -
789 -(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
790 -
791 -c. Send the third command and get the third reply:
792 -
793 -(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
794 -
795 -d. Send the fourth command and get the fourth reply:
796 -
797 -(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
798 -
799 -e. Send the fifth command plus the sixth command, get the sixth reply:
800 -
801 -(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
802 -
803 -f. Send the seventh command plus the eighth command, get the eighth reply:
804 -
805 -(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
806 -
807 -g. Send the ninth command plus the tenth command, get the tenth reply:
808 -
809 -(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
810 -
811 -h. Send the eleventh command plus the twelfth command, get the twelfth reply:
812 -
813 -(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
814 -
815 -
816 -(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:**
817 -
818 -a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
819 -
820 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);
821 -
822 -b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
823 -
824 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
825 -
826 -c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
827 -
828 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
829 -
830 -d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>”
831 -
832 -Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
833 -
834 -e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>”
835 -
836 -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”**.
837 -
838 -
839 -=== 2.6.2 Example 2 ~-~- Connect to Hygrovue10 ===
840 -
841 -==== 2.6.2.1 Reference Manual and Command ====
842 -
843 -
844 -* [[Hygrovue10 Product Page>>https://www.campbellsci.com/hygrovue10]]
845 -
846 -* Commands to be used in PC and output.
847 -
848 -~1. check device address
849 -
850 -2. change device address
851 -
852 -3. check device ID
853 -
854 -4. start measure
855 -
856 -5. Get Meausre result
857 -
858 -[[image:image-20230603120209-2.png||height="281" width="267"]]
859 -
860 -
861 -==== 2.6.2.2 Hardware Connection to SDI-12-LB ====
862 -
863 -
864 -[[image:image-20230603120515-3.png]]
865 -
866 -
867 -==== 2.6.2.3 Commands set in SDI-12-LB and uplink payload ====
868 -
869 -
870 -[[image:image-20230603120648-4.png]]
871 -
872 -[[image:image-20230603120726-5.png]]
873 -
874 -
875 -**Data in TTN:**
876 -
877 -[[image:image-20230603120859-6.png||height="118" width="1285"]]
878 -
879 -
880 -=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.3 Example 3 ~-~- Connect to SIL-400 ===
881 -
882 -==== 2.6.3.1 Reference Manual and Command ====
883 -
884 -
885 -* [[SIL-400 Product Page>>https://www.apogeeinstruments.com/sil-411-commercial-grade-sdi-12-digital-output-standard-field-of-view-infrared-radiometer-sensor/]]
886 -
887 -* Commands to be used in PC and output.
888 -
889 -~1. check device address
890 -
891 -2. change device address
892 -
893 -3. check device ID
894 -
895 -4. start measure
896 -
897 -5. Get Meausre result
898 -
899 -[[image:image-20230603121606-7.png||height="242" width="307"]]
900 -
901 -
902 -==== 2.6.3.2 Hardware Connection to SDI-12-LB ====
903 -
904 -
905 -[[image:image-20230603121643-8.png||height="442" width="656"]]
906 -
907 -
908 -==== 2.6.3.3 Commands set in SDI-12-LB and uplink payload ====
909 -
910 -
911 -[[image:image-20230603121721-9.png]]
912 -
913 -[[image:image-20230603121752-10.png]]
914 -
915 -Data in TTN:
916 -
917 -[[image:image-20230603121826-11.png||height="155" width="1104"]]
918 -
919 -
920 -
921 -=== (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.4 Example 4 ~-~- Connect to TEROS-12 ===
922 -
923 -==== 2.6.4.1 Reference Manual and Command ====
924 -
925 -
926 -* [[TEROS-12 Product Page>>https://www.metergroup.com/en/meter-environment/products/teros-12-soil-moisture-sensor]]
927 -
928 -* Commands to be used in PC and output.
929 -
930 -1.check device address
931 -
932 -2.change device address
933 -
934 -3.check device ID
935 -
936 -4.start measure
937 -
938 -5.Get Meausre result
939 -
940 -[[image:image-20230603122248-16.png||height="196" width="198"]]
941 -
942 -
943 -==== 2.6.4.2 Hardware Connection to SDI-12-LB ====
944 -
945 -
946 -[[image:image-20230603122212-15.png||height="502" width="667"]]
947 -
948 -
949 -==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ====
950 -
951 -[[image:image-20230603122040-12.png]]
952 -
953 -[[image:image-20230603122109-13.png||height="469" width="762"]]
954 -
955 -
956 -**Data in TTN:**
957 -
958 -[[image:image-20230603122139-14.png||height="148" width="1128"]]
959 -
960 -
961 -=== (% 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 ===
962 -
963 -==== 2.6.5.1 Important Notice! ====
964 -
965 -
966 -* The product page and reference command see above example 2,3,4
967 -
968 -* 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.
969 -
970 -* 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.
971 -
972 -* If these SDI-12 sensors are powered by external power source. It will add 300uA in the total current in SDI-12-LB.
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  )))
... ... @@ -1062,6 +1062,8 @@
1062 1062  * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
1063 1063  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
1064 1064  
837 +
838 +
1065 1065  == 3.2 Set Interrupt Mode ==
1066 1066  
1067 1067  
... ... @@ -1069,20 +1069,20 @@
1069 1069  
1070 1070  (% style="color:blue" %)**AT Command: AT+INTMOD**
1071 1071  
1072 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1073 -|=(% 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**
1074 -|(% 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" %)(((
1075 1075  0
1076 1076  OK
1077 -the mode is 0 =Disable Interrupt
851 +the mode is 0 = No interruption
1078 1078  )))
1079 -|(% 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" %)(((
1080 1080  Set Transmit Interval
1081 -0. (Disable Interrupt),
1082 -~1. (Trigger by rising and falling edge)
1083 -2. (Trigger by falling edge)
1084 -3. (Trigger by rising edge)
1085 -)))|(% 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
1086 1086  
1087 1087  (% style="color:blue" %)**Downlink Command: 0x06**
1088 1088  
... ... @@ -1093,6 +1093,8 @@
1093 1093  * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
1094 1094  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1095 1095  
870 +
871 +
1096 1096  == 3.3 Set the output time ==
1097 1097  
1098 1098  
... ... @@ -1100,54 +1100,52 @@
1100 1100  
1101 1101  (% style="color:blue" %)**AT Command: AT+3V3T**
1102 1102  
1103 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %)
1104 -|=(% 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**
1105 -|(% 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" %)(((
1106 1106  0
1107 1107  OK
1108 1108  )))
1109 -|(% 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" %)(((
1110 1110  OK
1111 1111  default setting
1112 1112  )))
1113 -|(% 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" %)(((
1114 1114  OK
1115 1115  )))
1116 -|(% 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" %)(((
1117 1117  OK
1118 1118  )))
1119 1119  
1120 1120  (% style="color:blue" %)**AT Command: AT+5VT**
1121 1121  
1122 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
1123 -|=(% 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**
1124 -|(% 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" %)(((
1125 1125  0
1126 1126  OK
1127 1127  )))
1128 -|(% 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" %)(((
1129 1129  OK
1130 1130  default setting
1131 1131  )))
1132 -|(% 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" %)(((
1133 1133  OK
1134 1134  )))
1135 -|(% 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" %)(((
1136 1136  OK
1137 1137  )))
1138 1138  
1139 -(% style="color:blue" %)**AT Command: AT+12VT **
915 +(% style="color:blue" %)**AT Command: AT+12VT**
1140 1140  
1141 -(% style="color:blue" %)**(The v1.2 version is enabled for 1 second by default, and the version below v1.2 is disabled by default)**
1142 -
1143 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %)
1144 -|=(% 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**
1145 -|(% 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" %)(((
1146 1146  0
1147 1147  OK
1148 1148  )))
1149 -|(% 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
1150 -|(% 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" %)(((
1151 1151  OK
1152 1152  )))
1153 1153  
... ... @@ -1164,6 +1164,8 @@
1164 1164  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
1165 1165  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
1166 1166  
941 +
942 +
1167 1167  == 3.4 Set the all data mode ==
1168 1168  
1169 1169  
... ... @@ -1171,13 +1171,13 @@
1171 1171  
1172 1172  (% style="color:blue" %)**AT Command: AT+ALLDATAMOD**
1173 1173  
1174 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
1175 -|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
1176 -|(% 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|(((
1177 1177  0
1178 1178  OK
1179 1179  )))
1180 -|(% 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
1181 1181  
1182 1182  (% style="color:blue" %)**Downlink Command: 0xAB**
1183 1183  
... ... @@ -1186,6 +1186,8 @@
1186 1186  * Example 1: Downlink Payload: AB 00  ~/~/  AT+ALLDATAMOD=0
1187 1187  * Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
1188 1188  
965 +
966 +
1189 1189  == 3.5 Set the splicing payload for uplink ==
1190 1190  
1191 1191  
... ... @@ -1193,21 +1193,21 @@
1193 1193  
1194 1194  (% style="color:blue" %)**AT Command: AT+DATAUP**
1195 1195  
1196 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1197 -|=(% 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**
1198 -|(% 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|(((
1199 1199  0
1200 1200  OK
1201 1201  )))
1202 -|(% 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" %)(((
1203 1203  Set splicing payload for uplink mode is 0.
1204 -)))|(% style="background-color:#f2f2f2" %)(((
982 +)))|(((
1205 1205  OK
1206 1206  )))
1207 -|(% 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
1208 -|(% 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" %)(((
1209 1209  Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1210 -)))|(% style="background-color:#f2f2f2" %)OK
988 +)))|OK
1211 1211  
1212 1212  (% style="color:blue" %)**Downlink Command: 0xAD**
1213 1213  
... ... @@ -1227,13 +1227,13 @@
1227 1227  
1228 1228  (% style="color:blue" %)**AT Command: AT+PAYVER**
1229 1229  
1230 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
1231 -|=(% 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**
1232 -|(% 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|(((
1233 1233  1
1234 1234  OK
1235 1235  )))
1236 -|(% 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
1237 1237  
1238 1238  (% style="color:blue" %)**Downlink Command: 0xAE**
1239 1239  
... ... @@ -1242,14 +1242,78 @@
1242 1242  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1243 1243  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1244 1244  
1245 -= 4. Battery & Power Consumption =
1246 1246  
1247 1247  
1248 -SDI-12-LB uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1025 += 4. Battery & how to replace =
1249 1249  
1250 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1027 +== 4.1 Battery Type ==
1251 1251  
1252 1252  
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.
1031 +
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 +
1253 1253  = 5. Remote Configure device =
1254 1254  
1255 1255  == 5.1 Connect via BLE ==
... ... @@ -1272,7 +1272,7 @@
1272 1272  
1273 1273  = 7. FAQ =
1274 1274  
1275 -== 7.1 How to use AT Command  via UART to access device? ==
1117 +== 7.1 How to use AT Command to access device? ==
1276 1276  
1277 1277  
1278 1278  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]]
... ... @@ -1328,6 +1328,8 @@
1328 1328  * Package Size / pcs : cm
1329 1329  * Weight / pcs : g
1330 1330  
1173 +
1174 +
1331 1331  = 10. ​Support =
1332 1332  
1333 1333  
... ... @@ -1334,3 +1334,5 @@
1334 1334  * 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.
1335 1335  
1336 1336  * 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