Last modified by Xiaoling on 2025/04/25 08:58
<
From version < 43.1 >
edited by Bei Jinggeng
on 2023/02/22 14:42
To version < 41.12 >
edited by Xiaoling
on 2023/02/01 16:36
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Bei
1 +XWiki.Xiaoling
Content
... ... @@ -22,29 +22,17 @@
22 22  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
23 23  
24 24  
25 -(((
26 26  The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
27 -)))
28 28  
29 -(((
30 30  SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors.
31 -)))
32 32  
33 -(((
34 34  SDI-12-LB has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol.
35 -)))
36 36  
37 -(((
38 38  The LoRa wireless technology used in SDI-12-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
39 -)))
40 40  
41 -(((
42 42  SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
43 -)))
44 44  
45 -(((
46 46  Each SDI-12-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
47 -)))
48 48  
49 49  
50 50  [[image:image-20230201084414-1.png||height="464" width="1108"]]
... ... @@ -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
46 +* 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
... ... @@ -65,7 +65,6 @@
65 65  * Downlink to change configure
66 66  * 8500mAh Battery for long term use
67 67  
68 -
69 69  == 1.3 Specification ==
70 70  
71 71  
... ... @@ -112,7 +112,6 @@
112 112  * Sleep Mode: 5uA @ 3.3v
113 113  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
114 114  
115 -
116 116  == 1.4 Connect to SDI-12 Sensor ==
117 117  
118 118  
... ... @@ -134,20 +134,20 @@
134 134  [[image:1675212633011-651.png]]
135 135  
136 136  
123 +
137 137  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
138 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
139 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
125 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
126 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
140 140  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
141 141  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
142 142  )))
143 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
130 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
144 144  (% 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.
145 145  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
146 146  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.
147 147  )))
148 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:109px" %)Deactivate Device|(% style="width:231px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means SDI-12-LB is in Deep Sleep Mode.
135 +|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
149 149  
150 -
151 151  == 1.7 Pin Mapping ==
152 152  
153 153  
... ... @@ -464,7 +464,7 @@
464 464  
465 465  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
466 466  
467 -(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 4 retries.
453 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
468 468  
469 469  (% style="color:red" %)**0 **(%%) No validation check;
470 470  
... ... @@ -491,14 +491,14 @@
491 491  **c**:  define the position for valid value. 
492 492  )))
493 493  
494 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
480 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
495 495  
496 496  
497 497  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
498 -|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
499 -|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
500 -|(% 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
501 -|(% 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
484 +|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
485 +|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
486 +|(% style="width:170px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
487 +|(% style="width:170px" %)34,2,1~~34|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A
502 502  
503 503  * (% style="color:blue" %)** Downlink Payload:**
504 504  
... ... @@ -513,10 +513,10 @@
513 513  Where:
514 514  
515 515  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
516 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
502 +* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
517 517  * (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
518 518  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
519 -* (% 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. 
505 +* (% style="color:#037691" %)**YY **(%%):  If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 
520 520  
521 521  (% style="color:blue" %)**Example:**
522 522  
... ... @@ -523,7 +523,6 @@
523 523  [[image:image-20230201094129-18.png]]
524 524  
525 525  
526 -
527 527  (% style="color:blue" %)**Clear SDI12 Command**
528 528  
529 529  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -567,6 +567,7 @@
567 567  
568 568  (% style="color:blue" %)**Compose Uplink**
569 569  
555 +
570 570  (% style="color:#4f81bd" %)**AT+DATAUP=0**
571 571  
572 572  Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
... ... @@ -608,6 +608,15 @@
608 608  
609 609  == 2.4 Uplink Payload ==
610 610  
597 +
598 +Uplink payloads have two types:
599 +
600 +* Distance Value: Use FPORT=2
601 +* Other control commands: Use other FPORT fields.
602 +
603 +The application server should parse the correct value based on FPORT settings.
604 +
605 +
611 611  === 2.4.1 Device Payload, FPORT~=5 ===
612 612  
613 613  
... ... @@ -615,10 +615,10 @@
615 615  
616 616  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
617 617  
618 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
613 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
619 619  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
620 -|(% 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**
621 -|(% 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
615 +|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**
616 +|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT
622 622  
623 623  Example parse in TTNv3
624 624  
... ... @@ -687,15 +687,15 @@
687 687  
688 688  * Periodically Uplink: FPORT=2
689 689  
690 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
691 -|=(% style="width: 90px;" %)(((
685 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
686 +|(% style="width:93px" %)(((
692 692  **Size(bytes)**
693 -)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
688 +)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
694 694  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
695 695  Battery(mV)
696 696  &
697 697  Interrupt_Flag
698 -)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
693 +)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
699 699  If the valid payload is too long and exceed the maximum support.
700 700  Payload length in server,server will show payload not provided in the LoRaWAN server.
701 701  )))
... ... @@ -727,7 +727,6 @@
727 727  
728 728  === 2.4.5 Payload version ===
729 729  
730 -The version number of the payload, mainly used for decoding. The default is 01.
731 731  
732 732  
733 733  === 2.4.6 ​Decode payload in The Things Network ===
... ... @@ -751,83 +751,15 @@
751 751  [[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]]]]
752 752  
753 753  
754 -== 2.6 Examples To Set SDI commands. ==
748 +== 2.6 Frequency Plans ==
755 755  
756 -=== 2.6.1 Examples 1 ===
757 757  
758 -COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
759 -
760 -[[image:image-20230222143809-1.png||height="564" width="729"]]
761 -
762 -1)The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:
763 -
764 -a.Send the first command and get the first reply：
765 -
766 -AT+COMMANDx=1I!,0,0,1
767 -
768 -b.Send the second command and get the second reply：
769 -
770 -AT+COMMANDx=2I!,0,0,1
771 -
772 -c.Send the third command and get the third reply：
773 -
774 -AT+COMMANDx=3I!,0,0,1
775 -
776 -d.Send the fourth command and get the fourth reply：
777 -
778 -AT+COMMANDx=4I!,0,0,1
779 -
780 -e.Send the fifth command plus the sixth command, get the sixth reply：
781 -
782 -AT+COMMANDx=1M!,2,1,1
783 -
784 -f.Send the seventh command plus the eighth command, get the eighth reply：
785 -
786 -AT+COMMANDx=2M!,2,1,1
787 -
788 -g.Send the ninth command plus the tenth command, get the tenth reply：
789 -
790 -AT+COMMANDx=3M!,1,1,1
791 -
792 -h.Send the eleventh command plus the twelfth command, get the twelfth reply：
793 -
794 -AT+COMMANDx=4M!,1,1,1
795 -
796 -
797 -2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor：
798 -
799 -a.The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
800 -
801 -Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34;
802 -
803 -b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
804 -
805 -Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31;
806 -
807 -c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
808 -
809 -Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31;
810 -
811 -d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
812 -
813 -Cut out all characters: AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15;
814 -
815 -e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
816 -
817 -Partial cut, the cut sensor address and the first two parameters：AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”.
818 -
819 -(% class="wikigeneratedid" %)
820 -== ==
821 -
822 -== 2.7 Frequency Plans ==
823 -
824 -
825 825  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.
826 826  
827 827  [[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/]]
828 828  
829 829  
830 -== 2.8 Firmware Change Log ==
756 +== 2.7 Firmware Change Log ==
831 831  
832 832  
833 833  **Firmware download link:**
... ... @@ -834,6 +834,7 @@
834 834  
835 835  [[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
836 836  
763 +
837 837  
838 838  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
839 839  
... ... @@ -862,7 +862,7 @@
862 862  These commands only valid for SDI-12-LB, as below:
863 863  
864 864  
865 -== 3.1 Set Transmit Interval Time ==
792 +== ​​​​​​​3.1 Set Transmit Interval Time ==
866 866  
867 867  
868 868  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -891,7 +891,6 @@
891 891  * Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
892 892  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
893 893  
894 -
895 895  == 3.2 Set Interrupt Mode ==
896 896  
897 897  
... ... @@ -904,14 +904,14 @@
904 904  |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
905 905  0
906 906  OK
907 -the mode is 0 = Disable Interrupt
833 +the mode is 0 = No interruption
908 908  )))
909 909  |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
910 910  Set Transmit Interval
911 -0. (Disable Interrupt),
912 -~1. (Trigger by rising and falling edge)
913 -2. (Trigger by falling edge)
914 -3. (Trigger by rising edge)
837 +~1. (Disable Interrupt),
838 +2. (Trigger by rising and falling edge)
839 +3. (Trigger by falling edge)
840 +4. (Trigger by rising edge)
915 915  )))|(% style="width:165px" %)OK
916 916  
917 917  (% style="color:blue" %)**Downlink Command: 0x06**
... ... @@ -923,7 +923,6 @@
923 923  * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
924 924  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
925 925  
926 -
927 927  == 3.3 Set the output time ==
928 928  
929 929  
... ... @@ -993,7 +993,6 @@
993 993  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
994 994  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
995 995  
996 -
997 997  == 3.4 Set the all data mode ==
998 998  
999 999  
... ... @@ -1016,7 +1016,6 @@
1016 1016  * Example 1: Downlink Payload: AB 00  ~/~/  AT+ALLDATAMOD=0
1017 1017  * Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
1018 1018  
1019 -
1020 1020  == 3.5 Set the splicing payload for uplink ==
1021 1021  
1022 1022  
... ... @@ -1053,7 +1053,6 @@
1053 1053  
1054 1054  == 3.6 Set the payload version ==
1055 1055  
1056 -
1057 1057  Feature, Set the payload version.
1058 1058  
1059 1059  (% style="color:blue" %)**AT Command: AT+PAYVER**
... ... @@ -1073,7 +1073,6 @@
1073 1073  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1074 1074  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1075 1075  
1076 -
1077 1077  = 4. Battery & how to replace =
1078 1078  
1079 1079  == 4.1 Battery Type ==
... ... @@ -1188,15 +1188,10 @@
1188 1188  = 8. ​Order Info =
1189 1189  
1190 1190  
1191 -(((
1192 1192  (% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1193 -)))
1194 1194  
1195 -(((
1196 1196  XXX: The default frequency band
1197 -)))
1198 1198  
1199 -(((
1200 1200  (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1201 1201  (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1202 1202  (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
... ... @@ -1205,7 +1205,6 @@
1205 1205  (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1206 1206  (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1207 1207  (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1208 -)))
1209 1209  
1210 1210  
1211 1211  = 9. Packing Info =
... ... @@ -1222,7 +1222,6 @@
1222 1222  * Package Size / pcs : cm
1223 1223  * Weight / pcs : g
1224 1224  
1225 -
1226 1226  = 10. ​Support =
1227 1227  
1228 1228  
image-20230222143809-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -322.1 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0