<
From version < 37.7 >
edited by Xiaoling
on 2023/02/01 11:50
To version < 37.1 >
edited by Xiaoling
on 2023/02/01 09:59
>
Change comment: Uploaded new attachment "1675216779406-595.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -3,7 +3,6 @@
3 3  
4 4  **Table of Contents:**
5 5  
6 -{{toc/}}
7 7  
8 8  
9 9  
... ... @@ -17,23 +17,22 @@
17 17  
18 18  
19 19  
20 -
21 21  = 1. Introduction =
22 22  
23 23  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
24 24  
25 25  
26 -The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
24 +The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution.
27 27  
28 28  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.
29 29  
30 -**(% style="color:blue" %)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.
28 +**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.
31 31  
32 -The LoRa wireless technology used in **(% style="color:blue" %)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.
30 +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.
33 33  
34 -**(% style="color:blue" %)SDI-12-LB** is powered by **(% style="color:blue" %)8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.
32 +**SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.
35 35  
36 -Each **(% style="color:blue" %)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.
34 +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.
37 37  
38 38  
39 39  [[image:image-20230201084414-1.png||height="464" width="1108"]]
... ... @@ -271,7 +271,7 @@
271 271  
272 272  **Parameter:  **aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
273 273  
274 -**Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
272 +**Example :  **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
275 275  
276 276  
277 277  The following is the display information on the serial port and the server.
... ... @@ -389,7 +389,7 @@
389 389  [[image:image-20230201092208-15.png||height="214" width="1140"]]
390 390  
391 391  
392 -=== 2.3.2 Advance SDI-12 Debug command ===
390 +=== ​​​​​​​2.3.2 Advance SDI-12 Debug command ===
393 393  
394 394  
395 395  This command can be used to debug all SDI-12 command.
... ... @@ -421,9 +421,11 @@
421 421  [[image:image-20230201092355-16.png]]
422 422  
423 423  
424 -[[image:image-20230201092355-17.png||height="426" width="1135"]]
422 +​​​​​​​[[image:image-20230201092355-17.png||height="426" width="1135"]]
425 425  
426 426  
425 +​​​​​​​
426 +
427 427  === 2.3.3 Convert ASCII to String ===
428 428  
429 429  
... ... @@ -444,6 +444,10 @@
444 444  [[image:1675214856590-846.png]]
445 445  
446 446  
447 +
448 +
449 +​​​​​​​
450 +
447 447  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
448 448  
449 449  
... ... @@ -516,6 +516,7 @@
516 516  * **XX XX XX XX **: AT+COMMAND or AT+DATACUT command
517 517  * **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. 
518 518  
523 +
519 519  **Example:**
520 520  
521 521  [[image:image-20230201094129-18.png]]
... ... @@ -549,7 +549,7 @@
549 549  
550 550  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.
551 551  
552 -**AT+ALLDATAMOD** will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
557 +**AT+ALLDATAMOD** will simply get all return and dont do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
553 553  
554 554  
555 555  **For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
... ... @@ -564,7 +564,6 @@
564 564  
565 565  **Compose Uplink**
566 566  
567 -
568 568  **AT+DATAUP=0**
569 569  
570 570  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
... ... @@ -617,13 +617,14 @@
617 617  The application server should parse the correct value based on FPORT settings.
618 618  
619 619  
620 -=== 2.4.1 Device Payload, FPORT~=5 ===
624 +2.4.1 Device Payload, FPORT=5
621 621  
622 -
623 623  Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
624 624  
628 +
625 625  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
626 626  
631 +
627 627  (% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
628 628  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
629 629  |(% 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**
... ... @@ -633,7 +633,6 @@
633 633  
634 634  [[image:1675215946738-635.png]]
635 635  
636 -
637 637  **Sensor Model**: For SDI-12-LB, this value is 0x17
638 638  
639 639  **Firmware Version**: 0x0100, Means: v1.0.0 version
... ... @@ -687,9 +687,10 @@
687 687  Ex2: 0x0B49 = 2889mV
688 688  
689 689  
690 -=== 2.4.2 Uplink Payload, FPORT~=2 ===
694 +1.
695 +11.
696 +111. Uplink Payload, FPORT=2
691 691  
692 -
693 693  There are different cases for uplink. See below
694 694  
695 695  * SDI-12 Debug Command return: FPORT=100
... ... @@ -696,24 +696,30 @@
696 696  
697 697  * Periodically Uplink: FPORT=2
698 698  
699 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
700 -|(% style="width:93px" %)(((
701 -**Size(bytes)**
702 -)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
703 -|(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
704 +|(((
705 +**Size**
706 +
707 +**(bytes)**
708 +)))|**2**|**1**|**Length depends on the return from the commands**
709 +|**Value**|(((
704 704  Battery(mV)
711 +
705 705  &
713 +
706 706  Interrupt_Flag
707 -)))|(% style="width:70px" %)[[PAYLOAD_VER>>path:#Probe_Model]]|(% style="width:234px" %)(((
708 -If the valid payload is too long and exceed the maximum support.
715 +)))|[[PAYLOAD_VER>>path:#Probe_Model]]|(((
716 +If the valid payload is too long and exceed the maximum support
717 +
709 709  Payload length in server,server will show payload not provided in the LoRaWAN server.
710 710  )))
711 711  
712 -[[image:1675216282284-923.png]]
721 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
713 713  
714 714  
715 -=== 2.4.3 Battery Info ===
716 716  
725 +1.
726 +11.
727 +111. Battery Info
717 717  
718 718  Check the battery voltage for SDI-12-LB.
719 719  
... ... @@ -722,70 +722,253 @@
722 722  Ex2: 0x0B49 = 2889mV
723 723  
724 724  
725 -=== 2.4.4 Interrupt Pin ===
736 +1.
737 +11.
738 +111. Interrupt Pin
726 726  
727 -
728 728  This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>>path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>path:#pins]].
729 729  
730 -**Example:**
731 731  
743 +Example:
744 +
732 732  Ex1: 0x0B45:0x0B&0x80= 0x00    Normal uplink packet.
733 733  
734 734  Ex2: 0x8B49:0x8B&0x80= 0x80    Interrupt Uplink Packet.
735 735  
736 736  
737 -=== 2.4.5 Payload version ===
750 +1.
751 +11.
752 +111. Payload version
738 738  
739 739  
740 740  
741 -=== 2.4.6 ​Decode payload in The Things Network ===
742 742  
743 743  
758 +1.
759 +11.
760 +111. ​Decode payload in The Things Network
761 +
744 744  While using TTN network, you can add the payload format to decode the payload.
745 745  
746 -[[image:1675216779406-595.png]]
764 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]]
747 747  
748 748  
749 749  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.
750 750  
751 -SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
752 752  
770 +下面的解码生成超链接放进去.
753 753  
754 -== 2.5 Uplink Interval ==
772 +function Decoder(bytes, port) {
755 755  
774 + if(port==5)
756 756  
757 -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:
776 + {
758 758  
759 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]
778 + var freq_band;
760 760  
780 + var sub_band;
761 761  
782 + var sensor;
762 762  
763 763  
764 -== 2.6 Frequency Plans ==
785 + if(bytes[0]==0x17)
765 765  
787 + sensor= "SDI12-LB";
766 766  
767 -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.
768 768  
769 -[[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/]]
790 + var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f);
770 770  
771 771  
793 + if(bytes[3]==0x01)
772 772  
773 -== 2.7 Firmware Change Log ==
795 + freq_band="EU868";
774 774  
797 + else if(bytes[3]==0x02)
775 775  
799 + freq_band="US915";
800 +
801 + else if(bytes[3]==0x03)
802 +
803 + freq_band="IN865";
804 +
805 + else if(bytes[3]==0x04)
806 +
807 + freq_band="AU915";
808 +
809 + else if(bytes[3]==0x05)
810 +
811 + freq_band="KZ865";
812 +
813 + else if(bytes[3]==0x06)
814 +
815 + freq_band="RU864";
816 +
817 + else if(bytes[3]==0x07)
818 +
819 + freq_band="AS923";
820 +
821 + else if(bytes[3]==0x08)
822 +
823 + freq_band="AS923_1";
824 +
825 + else if(bytes[3]==0x09)
826 +
827 + freq_band="AS923_2";
828 +
829 + else if(bytes[3]==0x0A)
830 +
831 + freq_band="AS923_3";
832 +
833 + else if(bytes[3]==0x0F)
834 +
835 + freq_band="AS923_4";
836 +
837 + else if(bytes[3]==0x0B)
838 +
839 + freq_band="CN470";
840 +
841 + else if(bytes[3]==0x0C)
842 +
843 + freq_band="EU433";
844 +
845 + else if(bytes[3]==0x0D)
846 +
847 + freq_band="KR920";
848 +
849 + else if(bytes[3]==0x0E)
850 +
851 + freq_band="MA869";
852 +
853 +
854 + if(bytes[4]==0xff)
855 +
856 + sub_band="NULL";
857 +
858 + else
859 +
860 + sub_band=bytes[4];
861 +
862 +
863 + var bat= (bytes[5]<<8 | bytes[6])/1000;
864 +
865 +
866 + return {
867 +
868 + SENSOR_MODEL:sensor,
869 +
870 + FIRMWARE_VERSION:firm_ver,
871 +
872 + FREQUENCY_BAND:freq_band,
873 +
874 + SUB_BAND:sub_band,
875 +
876 + BAT:bat,
877 +
878 + }
879 +
880 + }
881 +
882 + else if(port==100)
883 +
884 + {
885 +
886 + var datas_sum={};
887 +
888 + for(var j=0;j<bytes.length;j++)
889 +
890 + {
891 +
892 + var datas= String.fromCharCode(bytes[j]);
893 +
894 + if(j=='0')
895 +
896 + datas_sum.datas_sum=datas;
897 +
898 + else
899 +
900 + datas_sum.datas_sum+=datas;
901 +
902 + }
903 +
904 +
905 + return datas_sum;
906 +
907 + }
908 +
909 + else
910 +
911 + {
912 +
913 + var decode={};
914 +
915 + decode.EXTI_Trigger= (bytes[0] & 0x80)? "TRUE":"FALSE";  
916 +
917 + decode.BatV= ((bytes[0]<<8 | bytes[1])&0x7FFF)/1000;
918 +
919 + decode.Payver= bytes[2];
920 +
921 + for(var i=3;i<bytes.length;i++)
922 +
923 + {
924 +
925 + var data= String.fromCharCode(bytes[i]);
926 +
927 + if(i=='3')
928 +
929 + decode.data_sum=data;
930 +
931 + else
932 +
933 + decode.data_sum+=data;
934 +
935 + }
936 +
937 + return decode; 
938 +
939 + }
940 +
941 +
942 +}
943 +
944 +
945 +1.
946 +11. Uplink Interval
947 +
948 +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:
949 +
950 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]]
951 +
952 +
953 +
954 +1.
955 +11. Frequency Plans
956 +
957 +The SDI12-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.
958 +
959 +
960 +[[https:~~/~~/wiki.dragino.com/index.php?title=End_Device_Frequency_Band>>url:https://wiki.dragino.com/index.php?title=End_Device_Frequency_Band]]
961 +
962 +
963 +
964 +1.
965 +11. Firmware Change Log
966 +
776 776  **Firmware download link:**
777 777  
778 778  [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
779 779  
780 780  
781 -= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
782 782  
973 +1. Configure SDI-12-LB via AT Command or LoRaWAN Downlink
783 783  
784 784  Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
785 785  
786 786  * AT Command Connection: See [[FAQ>>path:#AT_COMMAND]].
787 -* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
978 +* LoRaWAN Downlink instruction for different platforms:
788 788  
980 +[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server>>url:http://wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server]]
981 +
982 +
789 789  There are two kinds of commands to configure SDI-12-LB, they are:
790 790  
791 791  * **General Commands**.
... ... @@ -805,223 +805,247 @@
805 805  These commands only valid for SDI-12-LB, as below:
806 806  
807 807  
808 -== ​​​​​​​3.1 Set Transmit Interval Time ==
809 809  
1003 +1.
1004 +11. Set Transmit Interval Time
810 810  
811 811  Feature: Change LoRaWAN End Node Transmit Interval.
812 812  
813 -(% style="color:blue" %)**AT Command: AT+TDC**
1008 +**AT Command: AT+TDC**
814 814  
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|(((
1010 +|**Command Example**|**Function**|**Response**
1011 +|AT+TDC=?|Show current transmit Interval|(((
818 818  30000
1013 +
819 819  OK
1015 +
820 820  the interval is 30000ms = 30s
821 821  )))
822 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1018 +|AT+TDC=60000|Set Transmit Interval|(((
823 823  OK
1020 +
824 824  Set transmit interval to 60000ms = 60 seconds
825 825  )))
826 826  
827 -(% style="color:blue" %)**Downlink Command: 0x01**
1024 +**Downlink Command: 0x01**
828 828  
829 -
830 830  Format: Command Code (0x01) followed by 3 bytes time value.
831 831  
832 -If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
1028 +If the downlink payload=0100003C, it means set the END Nodes Transmit Interval to 0x00003C=60(S), while type code is 01.
833 833  
834 -* Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
835 -* Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
1030 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1031 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
836 836  
837 -== 3.2 Set Interrupt Mode ==
1033 +1.
1034 +11. Set Interrupt Mode
838 838  
839 -
840 840  Feature, Set Interrupt mode for GPIO_EXIT.
841 841  
842 -(% style="color:blue" %)**AT Command: AT+INTMOD**
1038 +**AT Command: AT+INTMOD**
843 843  
844 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
845 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 187px;" %)**Function**|=(% style="width: 165px;" %)**Response**
846 -|(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
1040 +|**Command Example**|**Function**|**Response**
1041 +|AT+INTMOD=?|Show current interrupt mode|(((
847 847  0
1043 +
848 848  OK
1045 +
849 849  the mode is 0 = No interruption
850 850  )))
851 -|(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
1048 +|AT+INTMOD=2|(((
852 852  Set Transmit Interval
853 -~1. (Disable Interrupt),
854 -2. (Trigger by rising and falling edge)
855 -3. (Trigger by falling edge)
856 -4. (Trigger by rising edge)
857 -)))|(% style="width:165px" %)OK
858 858  
859 -(% style="color:blue" %)**Downlink Command: 0x06**
1051 +1. (Disable Interrupt),
1052 +1. (Trigger by rising and falling edge),
1053 +1. (Trigger by falling edge)
1054 +1. (Trigger by rising edge)
1055 +)))|OK
860 860  
1057 +**Downlink Command: 0x06**
1058 +
861 861  Format: Command Code (0x06) followed by 3 bytes.
862 862  
863 863  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
864 864  
865 -* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
866 -* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1063 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1064 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
867 867  
868 -== 3.3 Set the output time ==
1066 +1.
1067 +11. Set the output time
869 869  
870 -
871 871  Feature, Control the output 3V3 , 5V or 12V.
872 872  
873 -(% style="color:blue" %)**AT Command: AT+3V3T**
1071 +**AT Command: AT+3V3T**
874 874  
875 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %)
876 -|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response**
877 -|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)(((
1073 +|**Command Example**|**Function**|**Response**
1074 +|AT+3V3T=?|Show 3V3 open time.|(((
878 878  0
1076 +
879 879  OK
880 880  )))
881 -|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)(((
1079 +|AT+3V3T=0|Normally open 3V3 power supply.|(((
882 882  OK
1081 +
883 883  default setting
884 884  )))
885 -|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)(((
1084 +|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|(((
886 886  OK
1086 +
1087 +
887 887  )))
888 -|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)(((
1089 +|AT+3V3T=65535|Normally closed 3V3 power supply.|(((
889 889  OK
1091 +
1092 +
890 890  )))
891 891  
892 -(% style="color:blue" %)**AT Command: AT+5VT**
1095 +**AT Command: AT+5VT**
893 893  
894 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %)
895 -|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response**
896 -|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)(((
1097 +|**Command Example**|**Function**|**Response**
1098 +|AT+5VT=?|Show 5V open time.|(((
897 897  0
1100 +
898 898  OK
899 899  )))
900 -|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)(((
1103 +|AT+5VT=0|Normally closed 5V power supply.|(((
901 901  OK
1105 +
902 902  default setting
903 903  )))
904 -|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)(((
1108 +|AT+5VT=1000|Close after a delay of 1000 milliseconds.|(((
905 905  OK
1110 +
1111 +
906 906  )))
907 -|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)(((
1113 +|AT+5VT=65535|Normally open 5V power supply.|(((
908 908  OK
1115 +
1116 +
909 909  )))
910 910  
911 -(% style="color:blue" %)**AT Command: AT+12VT**
1119 +**AT Command: AT+12VT**
912 912  
913 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %)
914 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response**
915 -|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)(((
1121 +|**Command Example**|**Function**|**Response**
1122 +|AT+12VT=?|Show 12V open time.|(((
916 916  0
1124 +
917 917  OK
918 918  )))
919 -|(% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK
920 -|(% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)(((
1127 +|AT+12VT=0|Normally closed 12V power supply.|OK
1128 +|AT+12VT=500|Close after a delay of 500 milliseconds.|(((
921 921  OK
1130 +
1131 +
922 922  )))
923 923  
924 -(% style="color:blue" %)**Downlink Command: 0x07**
1134 +**Downlink Command: 0x07**
925 925  
926 926  Format: Command Code (0x07) followed by 3 bytes.
927 927  
928 928  The first byte is which power, the second and third bytes are the time to turn on.
929 929  
930 -* Example 1: Downlink Payload: 070101F4  **~-~-->**  AT+3V3T=500
931 -* Example 2: Downlink Payload: 0701FFFF   **~-~-->**  AT+3V3T=65535
932 -* Example 3: Downlink Payload: 070203E8  **~-~-->**  AT+5VT=1000
933 -* Example 4: Downlink Payload: 07020000  **~-~-->**  AT+5VT=0
934 -* Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
935 -* Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
1140 +* Example 1: Downlink Payload: 070101F4  -> AT+3V3T=500
1141 +* Example 2: Downlink Payload: 0701FFFF   -> AT+3V3T=65535
1142 +* Example 3: Downlink Payload: 070203E8  -> AT+5VT=1000
1143 +* Example 4: Downlink Payload: 07020000  -> AT+5VT=0
1144 +* Example 5: Downlink Payload: 070301F4  -> AT+12VT=500
1145 +* Example 6: Downlink Payload: 07030000  -> AT+12VT=0
936 936  
937 -== 3.4 Set the all data mode ==
1147 +1.
1148 +11. Set the all data mode
938 938  
939 -
940 940  Feature, Set the all data mode.
941 941  
942 -(% style="color:blue" %)**AT Command: AT+ALLDATAMOD**
1152 +**AT Command: AT+ALLDATAMOD**
943 943  
944 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
945 -|=**Command Example**|=**Function**|=**Response**
1154 +|**Command Example**|**Function**|**Response**
946 946  |AT+ALLDATAMOD=?|Show current all data mode|(((
947 947  0
1157 +
1158 +
948 948  OK
949 949  )))
950 950  |AT+ALLDATAMOD=1|Set all data mode is 1.|OK
951 951  
952 -(% style="color:blue" %)**Downlink Command: 0xAB**
1163 +**Downlink Command: 0xAB**
953 953  
954 954  Format: Command Code (0xAB) followed by 1 bytes.
955 955  
956 -* Example 1: Downlink Payload: AB 00  ~/~/  AT+ALLDATAMOD=0
957 -* Example 2: Downlink Payload: AB 01  ~/~/  AT+ALLDATAMOD=1
1167 +* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
1168 +* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
958 958  
959 -== 3.5 Set the splicing payload for uplink ==
1170 +1.
1171 +11. Set the splicing payload for uplink
960 960  
961 -
962 962  Feature, splicing payload for uplink.
963 963  
964 -(% style="color:blue" %)**AT Command: AT+DATAUP**
1175 +**AT Command: AT+DATAUP**
965 965  
966 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
967 -|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 266px;" %)**Function**|=**Response**
968 -|(% style="width:154px" %)AT+DATAUP =?|(% style="width:266px" %)Show current splicing payload for uplink mode|(((
1177 +|**Command Example**|**Function**|**Response**
1178 +|AT+DATAUP =?|Show current splicing payload for uplink mode|(((
969 969  0
1180 +
1181 +
970 970  OK
971 971  )))
972 -|(% style="width:154px" %)AT+DATAUP =0|(% style="width:266px" %)(((
1184 +|AT+DATAUP =0|(((
973 973  Set splicing payload for uplink mode is 0.
1186 +
1187 +
974 974  )))|(((
975 975  OK
1190 +
1191 +
976 976  )))
977 -|(% 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
978 -|(% style="width:154px" %)AT+DATAUP =1,20000|(% style="width:266px" %)(((
979 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1193 +|AT+DATAUP =1|Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK
1194 +|AT+DATAUP =1,20000|(((
1195 +Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1196 +
1197 +
980 980  )))|OK
981 981  
982 -(% style="color:blue" %)**Downlink Command: 0xAD**
1200 +**Downlink Command: 0xAD**
983 983  
984 984  Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
985 985  
986 -* Example 1: Downlink Payload: AD 00  ~/~/  AT+DATAUP=0
987 -* Example 2: Downlink Payload: AD 01  ~/~/  AT+DATAUP =1
988 -* Example 3: Downlink Payload: AD 01 00 00 14  ~/~/  AT+DATAUP =1,20000
1204 +* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
1205 +* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
1206 +* Example 3: Downlink Payload: AD 01 00 00 14~/~/ AT+DATAUP =1,20000
989 989  
990 990  This means that the interval is set to 0x000014=20S
991 991  
992 992  
993 -== 3.6 Set the payload version ==
1211 +1.
1212 +11. Set the payload version
994 994  
995 995  Feature, Set the payload version.
996 996  
997 -(% style="color:blue" %)**AT Command: AT+PAYVER**
1216 +**AT Command: AT+PAYVER**
998 998  
999 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
1000 -|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=**Response**
1001 -|(% style="width:158px" %)AT+PAYVER=?|(% style="width:192px" %)Show current payload version|(((
1218 +|**Command Example**|**Function**|**Response**
1219 +|AT+PAYVER=?|Show current payload version|(((
1002 1002  1
1221 +
1222 +
1003 1003  OK
1004 1004  )))
1005 -|(% style="width:158px" %)AT+PAYVER=5|(% style="width:192px" %)Set payload version is 5.|OK
1225 +|AT+PAYVER=5|Set payload version is 5.|OK
1006 1006  
1007 -(% style="color:blue" %)**Downlink Command: 0xAE**
1227 +**Downlink Command: 0xAE**
1008 1008  
1009 1009  Format: Command Code (0xAE) followed by 1 bytes.
1010 1010  
1011 -* Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1012 -* Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1231 +* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
1232 +* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
1013 1013  
1014 -= 4. Battery & how to replace =
1234 +1. Battery & how to replace
1235 +11. Battery Type
1015 1015  
1016 -== 4.1 Battery Type ==
1237 +SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. 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.
1017 1017  
1018 1018  
1019 -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.
1020 -
1021 -
1022 1022  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1023 1023  
1024 -[[image:1675146710956-626.png]]
1242 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]]
1025 1025  
1026 1026  
1027 1027  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1029,25 +1029,31 @@
1029 1029  SDI-12-LB:  2.45v ~~ 3.6v
1030 1030  
1031 1031  
1032 -== 4.2 Replace Battery ==
1250 +1.
1251 +11. Replace Battery
1033 1033  
1034 -
1035 1035  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1036 1036  
1037 1037  And make sure the positive and negative pins match.
1038 1038  
1039 1039  
1040 -== 4.3 Power Consumption Analyze ==
1041 1041  
1259 +1.
1260 +11. Power Consumption Analyze
1042 1042  
1043 1043  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.
1044 1044  
1264 +
1045 1045  Instruction to use as below:
1046 1046  
1047 -(% 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]]
1048 1048  
1049 -(% style="color:blue" %)**Step 2:**(%%) Open it and choose
1268 +Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1050 1050  
1270 +[[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
1271 +
1272 +
1273 +Step 2: Open it and choose
1274 +
1051 1051  * Product Model
1052 1052  * Uplink Interval
1053 1053  * Working Mode
... ... @@ -1054,48 +1054,57 @@
1054 1054  
1055 1055  And the Life expectation in difference case will be shown on the right.
1056 1056  
1057 -[[image:1675146895108-304.png]]
1281 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image037.png]]
1058 1058  
1059 1059  
1060 1060  The battery related documents as below:
1061 1061  
1062 -* [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
1063 -* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1064 -* [[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]]
1286 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
1287 +* [[Lithium-Thionyl Chloride Battery>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet-EN.pdf]] datasheet, [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet_PM-ER18505-S-02-LF_EN.pdf]]
1288 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
1065 1065  
1066 -[[image:image-20230131145708-3.png]]
1290 +|(((
1291 +JST-XH-2P connector
1292 +)))
1067 1067  
1294 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image038.png]]
1068 1068  
1069 -=== 4.3.1 ​Battery Note ===
1070 1070  
1071 1071  
1298 +1.
1299 +11.
1300 +111. ​Battery Note
1301 +
1072 1072  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.
1073 1073  
1074 1074  
1075 -=== 4.3.2 Replace the battery ===
1305 +1.
1306 +11.
1307 +111. ​Replace the battery
1076 1076  
1309 +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.
1077 1077  
1078 -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.
1079 1079  
1080 -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)
1312 +The default battery pack of SDI-12-LB includes a ER26500 plus super capacitor. If user cant 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)
1081 1081  
1082 1082  
1083 1083  
1084 -= 5. Remote Configure device =
1085 1085  
1086 -== 5.1 Connect via BLE ==
1087 1087  
1088 1088  
1089 -Please see this instruction for how to configure via BLE: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
1319 +1. Remote Configure device
1320 +11. Connect via BLE
1090 1090  
1322 +Please see this instruction for how to configure via BLE:
1091 1091  
1092 -== 5.2 AT Command Set ==
1324 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
1093 1093  
1094 1094  
1327 +1.
1328 +11. AT Command Set
1095 1095  
1096 -= 6. OTA firmware update =
1330 +1. OTA firmware update
1097 1097  
1098 -
1099 1099  Please see this link for how to do OTA firmware update.
1100 1100  
1101 1101  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
... ... @@ -1102,33 +1102,19 @@
1102 1102  
1103 1103  
1104 1104  
1105 -= 7. ​Order Info =
1106 1106  
1107 1107  
1108 -Part Number: SDI-12-LB-XXX
1109 -XXX: The default frequency band
1110 1110  
1111 -AS923: LoRaWAN AS923 band
1112 -AU915: LoRaWAN AU915 band
1113 -EU433: LoRaWAN EU433 band
1114 -EU868: LoRaWAN EU868 band
1115 -KR920: LoRaWAN KR920 band
1116 -US915: LoRaWAN US915 band
1117 -IN865: LoRaWAN IN865 band
1118 -CN470: LoRaWAN CN470 band
1119 1119  
1120 1120  
1121 1121  
1122 1122  
1123 1123  
1346 +1. ​Order Info
1124 1124  
1125 -
1126 -= 8. Packing Info =
1127 -
1128 -
1129 1129  **Package Includes**:
1130 1130  
1131 -* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
1350 +* SDI-12-LB SDI-12 to LoRaWAN Converter
1132 1132  
1133 1133  **Dimension and weight**:
1134 1134  
... ... @@ -1137,11 +1137,13 @@
1137 1137  * Package Size / pcs : cm
1138 1138  * Weight / pcs : g
1139 1139  
1140 -= 9. ​Support =
1141 1141  
1142 1142  
1361 +1. ​Support
1362 +
1143 1143  * 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.
1364 +* 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
1144 1144  
1145 -* 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]]
1366 +[[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]]
1146 1146  
1147 1147  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0