Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Xiaoling on 2025/04/25 08:58
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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 : 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 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. 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 UplinkInterval==772 +function Decoder(bytes, port) { 755 755 774 + if(port==5) 756 756 757 - TheSDI-12-LBby 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.6FrequencyPlans==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.7FirmwareChange 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 Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 833 833 834 -* Example 1: Downlink Payload: 0100001E 835 -* Example 2: Downlink Payload: 0100003C 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 866 -* Example 2: Downlink Payload: 06000003 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" %)OK920 -| (% 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 **~-~-->**931 -* Example 2: Downlink Payload: 0701FFFF **~-~-->**AT+3V3T=65535932 -* Example 3: Downlink Payload: 070203E8 **~-~-->**AT+5VT=1000933 -* Example 4: Downlink Payload: 07020000 **~-~-->**AT+5VT=0934 -* Example 5: Downlink Payload: 070301F4 **~-~-->**AT+12VT=500935 -* Example 6: Downlink Payload: 07030000 **~-~-->**AT+12VT=01140 +* 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 957 -* Example 2: Downlink Payload: AB 01 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 987 -* Example 2: Downlink Payload: AD 01 988 -* Example 3: Downlink Payload: AD 01 00 00 14 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.|OK1225 +|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 1012 -* Example 2: Downlink Payload: AE 05 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" %)**Step2:**(%%)Openand choose1268 +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>>http s://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],1063 -* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>http s://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]1064 -* [[Lithium-ion Battery-Capacitor datasheet>>http s://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 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) 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.2ATCommand 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 11350 +* 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