Last modified by Xiaoling on 2025/04/25 08:58
<
From version < 34.1 >
edited by Xiaoling
on 2023/02/01 09:44
To version < 37.3 >
edited by Xiaoling
on 2023/02/01 10:25
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -269,7 +269,7 @@
269 269  
270 270  **Parameter:  **aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
271 271  
272 -**Example :  **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
272 +**Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
273 273  
274 274  
275 275  The following is the display information on the serial port and the server.
... ... @@ -387,7 +387,7 @@
387 387  [[image:image-20230201092208-15.png||height="214" width="1140"]]
388 388  
389 389  
390 -=== ​​​​​​​2.3.2 Advance SDI-12 Debug command ===
390 +=== 2.3.2 Advance SDI-12 Debug command ===
391 391  
392 392  
393 393  This command can be used to debug all SDI-12 command.
... ... @@ -419,9 +419,8 @@
419 419  [[image:image-20230201092355-16.png]]
420 420  
421 421  
422 -​​​​​​​[[image:image-20230201092355-17.png||height="426" width="1135"]]
422 +[[image:image-20230201092355-17.png||height="426" width="1135"]]
423 423  
424 -
425 425  ​​​​​​​
426 426  
427 427  === 2.3.3 Convert ASCII to String ===
... ... @@ -443,9 +443,6 @@
443 443  
444 444  [[image:1675214856590-846.png]]
445 445  
446 -
447 -
448 -
449 449  ​​​​​​​
450 450  
451 451  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -484,7 +484,7 @@
484 484  
485 485  (% border="1" style="background-color:#f7faff; width:436px" %)
486 486  |(% style="width:433px" %)(((
487 -AT+DATACUTx=a,b,c
483 +**AT+DATACUTx=a,b,c**
488 488  
489 489  **a**:  length for the return of AT+COMMAND
490 490  
... ... @@ -493,13 +493,14 @@
493 493  **c**:  define the position for valid value. 
494 494  )))
495 495  
496 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload:
492 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
497 497  
498 498  
499 -|AT+DATACUT1 value|Final Result to combine Payload
500 -|34,1,1+2+3|0D 00 01 30 31 33
501 -|34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
502 -|34,2,1~~34|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
495 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
496 +|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
497 +|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
498 +|(% 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
499 +|(% 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
503 503  
504 504  * ** Downlink Payload:**
505 505  
... ... @@ -513,21 +513,17 @@
513 513  
514 514  Where:
515 515  
516 -* MM: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
517 -* NN:  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
518 -* LL:  The length of AT+COMMAND or AT+DATACUT command
519 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
520 -* 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. 
513 +* **MM **: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
514 +* **NN **:  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
515 +* **LL **:  The length of AT+COMMAND or AT+DATACUT command
516 +* **XX XX XX XX **: AT+COMMAND or AT+DATACUT command
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. 
521 521  
522 -Example:
519 +**Example:**
523 523  
524 -**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1**
521 +[[image:image-20230201094129-18.png]]
525 525  
526 -**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
527 527  
528 -**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
529 -
530 -
531 531  **Clear SDI12 Command**
532 532  
533 533  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -547,23 +547,22 @@
547 547  
548 548  
549 549  
550 -
551 551  **command combination**
552 552  
553 553  Below shows a screen shot how the results combines together to a uplink payload.
554 554  
555 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
547 +[[image:1675215745275-920.png]]
556 556  
557 557  
558 -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.
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.
559 559  
560 -**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.
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.
561 561  
562 562  
563 -For example: as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
555 +**For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
564 564  
565 565  
566 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
558 +[[image:1675215782925-448.png]]
567 567  
568 568  
569 569  If AT+ALLDATAMOD=1, **FX,X** will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes.
... ... @@ -572,6 +572,7 @@
572 572  
573 573  **Compose Uplink**
574 574  
567 +
575 575  **AT+DATAUP=0**
576 576  
577 577  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
... ... @@ -581,7 +581,7 @@
581 581  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
582 582  
583 583  
584 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
577 +[[image:1675215828102-844.png]]
585 585  
586 586  
587 587  **AT+DATAUP=1**
... ... @@ -590,7 +590,7 @@
590 590  
591 591  Final Payload is
592 592  
593 -**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
586 +__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
594 594  
595 595  1. Battery Info (2 bytes): Battery voltage
596 596  1. PAYVER (1 byte): Defined by AT+PAYVER
... ... @@ -598,26 +598,24 @@
598 598  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
599 599  1. DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
600 600  
601 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
594 +[[image:1675215848113-696.png]]
602 602  
603 603  
604 604  **Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
605 605  
606 - ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
599 +* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
600 +* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
601 +* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
602 +* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
607 607  
608 - * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
604 +**~ When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
609 609  
610 - * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
606 +**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
611 611  
612 - ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
613 613  
614 - *** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
609 +== ​​​​​​​2.4 Uplink Payload ==
615 615  
616 -**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
617 617  
618 -1.
619 -11. Uplink Payload
620 -
621 621  Uplink payloads have two types:
622 622  
623 623  * Distance Value: Use FPORT=2
... ... @@ -626,24 +626,23 @@
626 626  The application server should parse the correct value based on FPORT settings.
627 627  
628 628  
629 -1.
630 -11.
631 -111. Device Payload, FPORT=5
620 +=== 2.4.1 Device Payload, FPORT~=5 ===
632 632  
622 +
633 633  Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
634 634  
635 -
636 636  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
637 637  
627 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
628 +|(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
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**
630 +|(% 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
638 638  
639 -|(% colspan="6" %)**Device Status (FPORT=5)**
640 -|**Size (bytes)**|**1**|**2**|**1**|**1**|**2**
641 -|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
642 -
643 643  Example parse in TTNv3
644 644  
645 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]]
634 +[[image:1675215946738-635.png]]
646 646  
636 +
647 647  **Sensor Model**: For SDI-12-LB, this value is 0x17
648 648  
649 649  **Firmware Version**: 0x0100, Means: v1.0.0 version
... ... @@ -697,10 +697,9 @@
697 697  Ex2: 0x0B49 = 2889mV
698 698  
699 699  
700 -1.
701 -11.
702 -111. Uplink Payload, FPORT=2
690 +=== 2.4.2 Uplink Payload, FPORT~=2 ===
703 703  
692 +
704 704  There are different cases for uplink. See below
705 705  
706 706  * SDI-12 Debug Command return: FPORT=100
... ... @@ -707,30 +707,24 @@
707 707  
708 708  * Periodically Uplink: FPORT=2
709 709  
710 -|(((
711 -**Size**
712 -
713 -**(bytes)**
714 -)))|**2**|**1**|**Length depends on the return from the commands**
715 -|**Value**|(((
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" %)(((
716 716  Battery(mV)
717 -
718 718  &
719 -
720 720  Interrupt_Flag
721 -)))|[[PAYLOAD_VER>>path:#Probe_Model]]|(((
722 -If the valid payload is too long and exceed the maximum support
723 -
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.
724 724  Payload length in server,server will show payload not provided in the LoRaWAN server.
725 725  )))
726 726  
727 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
712 +[[image:1675216282284-923.png]]
728 728  
729 729  
715 +=== 2.4.3 Battery Info ===
730 730  
731 -1.
732 -11.
733 -111. Battery Info
734 734  
735 735  Check the battery voltage for SDI-12-LB.
736 736  
... ... @@ -739,253 +739,71 @@
739 739  Ex2: 0x0B49 = 2889mV
740 740  
741 741  
742 -1.
743 -11.
744 -111. Interrupt Pin
725 +=== 2.4.4 Interrupt Pin ===
745 745  
727 +
746 746  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]].
747 747  
730 +**Example:**
748 748  
749 -Example:
750 -
751 751  Ex1: 0x0B45:0x0B&0x80= 0x00    Normal uplink packet.
752 752  
753 753  Ex2: 0x8B49:0x8B&0x80= 0x80    Interrupt Uplink Packet.
754 754  
755 755  
756 -1.
757 -11.
758 -111. Payload version
737 +=== 2.4.5 Payload version ===
759 759  
760 760  
761 761  
741 +=== 2.4.6 ​Decode payload in The Things Network ===
762 762  
763 763  
764 -1.
765 -11.
766 -111. ​Decode payload in The Things Network
767 -
768 768  While using TTN network, you can add the payload format to decode the payload.
769 769  
770 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]]
746 +[[image:1675216779406-595.png]]
771 771  
772 772  
773 773  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.
774 774  
751 +SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
775 775  
776 -下面的解码生成超链接放进去.
777 777  
778 -function Decoder(bytes, port) {
754 +== 2.5 Uplink Interval ==
779 779  
780 - if(port==5)
781 781  
782 - {
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:
783 783  
784 - var freq_band;
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]]
785 785  
786 - var sub_band;
787 787  
788 - var sensor;
789 789  
790 790  
791 - if(bytes[0]==0x17)
764 +== 2.6 Frequency Plans ==
792 792  
793 - sensor= "SDI12-LB";
794 794  
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.
795 795  
796 - var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f);
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/]]
797 797  
798 798  
799 - if(bytes[3]==0x01)
800 800  
801 - freq_band="EU868";
773 +== 2.7 Firmware Change Log ==
802 802  
803 - else if(bytes[3]==0x02)
804 804  
805 - freq_band="US915";
806 -
807 - else if(bytes[3]==0x03)
808 -
809 - freq_band="IN865";
810 -
811 - else if(bytes[3]==0x04)
812 -
813 - freq_band="AU915";
814 -
815 - else if(bytes[3]==0x05)
816 -
817 - freq_band="KZ865";
818 -
819 - else if(bytes[3]==0x06)
820 -
821 - freq_band="RU864";
822 -
823 - else if(bytes[3]==0x07)
824 -
825 - freq_band="AS923";
826 -
827 - else if(bytes[3]==0x08)
828 -
829 - freq_band="AS923_1";
830 -
831 - else if(bytes[3]==0x09)
832 -
833 - freq_band="AS923_2";
834 -
835 - else if(bytes[3]==0x0A)
836 -
837 - freq_band="AS923_3";
838 -
839 - else if(bytes[3]==0x0F)
840 -
841 - freq_band="AS923_4";
842 -
843 - else if(bytes[3]==0x0B)
844 -
845 - freq_band="CN470";
846 -
847 - else if(bytes[3]==0x0C)
848 -
849 - freq_band="EU433";
850 -
851 - else if(bytes[3]==0x0D)
852 -
853 - freq_band="KR920";
854 -
855 - else if(bytes[3]==0x0E)
856 -
857 - freq_band="MA869";
858 -
859 -
860 - if(bytes[4]==0xff)
861 -
862 - sub_band="NULL";
863 -
864 - else
865 -
866 - sub_band=bytes[4];
867 -
868 -
869 - var bat= (bytes[5]<<8 | bytes[6])/1000;
870 -
871 -
872 - return {
873 -
874 - SENSOR_MODEL:sensor,
875 -
876 - FIRMWARE_VERSION:firm_ver,
877 -
878 - FREQUENCY_BAND:freq_band,
879 -
880 - SUB_BAND:sub_band,
881 -
882 - BAT:bat,
883 -
884 - }
885 -
886 - }
887 -
888 - else if(port==100)
889 -
890 - {
891 -
892 - var datas_sum={};
893 -
894 - for(var j=0;j<bytes.length;j++)
895 -
896 - {
897 -
898 - var datas= String.fromCharCode(bytes[j]);
899 -
900 - if(j=='0')
901 -
902 - datas_sum.datas_sum=datas;
903 -
904 - else
905 -
906 - datas_sum.datas_sum+=datas;
907 -
908 - }
909 -
910 -
911 - return datas_sum;
912 -
913 - }
914 -
915 - else
916 -
917 - {
918 -
919 - var decode={};
920 -
921 - decode.EXTI_Trigger= (bytes[0] & 0x80)? "TRUE":"FALSE";  
922 -
923 - decode.BatV= ((bytes[0]<<8 | bytes[1])&0x7FFF)/1000;
924 -
925 - decode.Payver= bytes[2];
926 -
927 - for(var i=3;i<bytes.length;i++)
928 -
929 - {
930 -
931 - var data= String.fromCharCode(bytes[i]);
932 -
933 - if(i=='3')
934 -
935 - decode.data_sum=data;
936 -
937 - else
938 -
939 - decode.data_sum+=data;
940 -
941 - }
942 -
943 - return decode; 
944 -
945 - }
946 -
947 -
948 -}
949 -
950 -
951 -1.
952 -11. Uplink Interval
953 -
954 -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:
955 -
956 -[[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]]
957 -
958 -
959 -
960 -1.
961 -11. Frequency Plans
962 -
963 -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.
964 -
965 -
966 -[[https:~~/~~/wiki.dragino.com/index.php?title=End_Device_Frequency_Band>>url:https://wiki.dragino.com/index.php?title=End_Device_Frequency_Band]]
967 -
968 -
969 -
970 -1.
971 -11. Firmware Change Log
972 -
973 973  **Firmware download link:**
974 974  
975 975  [[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
976 976  
977 977  
781 += 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
978 978  
979 -1. Configure SDI-12-LB via AT Command or LoRaWAN Downlink
980 980  
981 981  Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
982 982  
983 983  * AT Command Connection: See [[FAQ>>path:#AT_COMMAND]].
984 -* LoRaWAN Downlink instruction for different platforms:
787 +* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
985 985  
986 -[[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]]
987 987  
988 -
989 989  There are two kinds of commands to configure SDI-12-LB, they are:
990 990  
991 991  * **General Commands**.
... ... @@ -1005,30 +1005,28 @@
1005 1005  These commands only valid for SDI-12-LB, as below:
1006 1006  
1007 1007  
809 +== ​​​​​​​3.1 Set Transmit Interval Time ==
1008 1008  
1009 -1.
1010 -11. Set Transmit Interval Time
1011 1011  
1012 1012  Feature: Change LoRaWAN End Node Transmit Interval.
1013 1013  
1014 -**AT Command: AT+TDC**
814 +(% style="color:blue" %)**AT Command: AT+TDC**
1015 1015  
1016 -|**Command Example**|**Function**|**Response**
1017 -|AT+TDC=?|Show current transmit Interval|(((
816 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
817 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response**
818 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
1018 1018  30000
1019 -
1020 1020  OK
1021 -
1022 1022  the interval is 30000ms = 30s
1023 1023  )))
1024 -|AT+TDC=60000|Set Transmit Interval|(((
823 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1025 1025  OK
1026 -
1027 1027  Set transmit interval to 60000ms = 60 seconds
1028 1028  )))
1029 1029  
1030 -**Downlink Command: 0x01**
828 +(% style="color:blue" %)**Downlink Command: 0x01**
1031 1031  
830 +
1032 1032  Format: Command Code (0x01) followed by 3 bytes time value.
1033 1033  
1034 1034  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
... ... @@ -1036,31 +1036,28 @@
1036 1036  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1037 1037  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1038 1038  
1039 -1.
1040 -11. Set Interrupt Mode
838 +== 3.2 Set Interrupt Mode ==
1041 1041  
1042 1042  Feature, Set Interrupt mode for GPIO_EXIT.
1043 1043  
1044 -**AT Command: AT+INTMOD**
842 +(% style="color:blue" %)**AT Command: AT+INTMOD**
1045 1045  
1046 -|**Command Example**|**Function**|**Response**
844 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
845 +|=**Command Example**|=**Function**|=**Response**
1047 1047  |AT+INTMOD=?|Show current interrupt mode|(((
1048 1048  0
1049 -
1050 1050  OK
1051 -
1052 1052  the mode is 0 = No interruption
1053 1053  )))
1054 1054  |AT+INTMOD=2|(((
1055 1055  Set Transmit Interval
1056 -
1057 -1. (Disable Interrupt),
1058 -1. (Trigger by rising and falling edge),
1059 -1. (Trigger by falling edge)
1060 -1. (Trigger by rising edge)
853 +~1. (Disable Interrupt),
854 +2. (Trigger by rising and falling edge)
855 +3. (Trigger by falling edge)
856 +4. (Trigger by rising edge)
1061 1061  )))|OK
1062 1062  
1063 -**Downlink Command: 0x06**
859 +(% style="color:blue" %)**Downlink Command: 0x06**
1064 1064  
1065 1065  Format: Command Code (0x06) followed by 3 bytes.
1066 1066  
... ... @@ -1069,90 +1069,79 @@
1069 1069  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1070 1070  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1071 1071  
1072 -1.
1073 -11. Set the output time
1074 1074  
869 +== 3.3 Set the output time ==
870 +
871 +
1075 1075  Feature, Control the output 3V3 , 5V or 12V.
1076 1076  
1077 -**AT Command: AT+3V3T**
874 +(% style="color:blue" %)**AT Command: AT+3V3T**
1078 1078  
1079 -|**Command Example**|**Function**|**Response**
1080 -|AT+3V3T=?|Show 3V3 open time.|(((
876 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %)
877 +|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response**
878 +|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)(((
1081 1081  0
1082 -
1083 1083  OK
1084 1084  )))
1085 -|AT+3V3T=0|Normally open 3V3 power supply.|(((
882 +|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)(((
1086 1086  OK
1087 -
1088 1088  default setting
1089 1089  )))
1090 -|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|(((
886 +|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)(((
1091 1091  OK
1092 -
1093 -
1094 1094  )))
1095 -|AT+3V3T=65535|Normally closed 3V3 power supply.|(((
889 +|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)(((
1096 1096  OK
1097 -
1098 -
1099 1099  )))
1100 1100  
1101 -**AT Command: AT+5VT**
893 +(% style="color:blue" %)**AT Command: AT+5VT**
1102 1102  
1103 -|**Command Example**|**Function**|**Response**
1104 -|AT+5VT=?|Show 5V open time.|(((
895 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %)
896 +|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response**
897 +|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)(((
1105 1105  0
1106 -
1107 1107  OK
1108 1108  )))
1109 -|AT+5VT=0|Normally closed 5V power supply.|(((
901 +|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)(((
1110 1110  OK
1111 -
1112 1112  default setting
1113 1113  )))
1114 -|AT+5VT=1000|Close after a delay of 1000 milliseconds.|(((
905 +|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)(((
1115 1115  OK
1116 -
1117 -
1118 1118  )))
1119 -|AT+5VT=65535|Normally open 5V power supply.|(((
908 +|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)(((
1120 1120  OK
1121 -
1122 -
1123 1123  )))
1124 1124  
1125 -**AT Command: AT+12VT**
912 +(% style="color:blue" %)**AT Command: AT+12VT**
1126 1126  
1127 -|**Command Example**|**Function**|**Response**
1128 -|AT+12VT=?|Show 12V open time.|(((
914 +(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %)
915 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response**
916 +|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)(((
1129 1129  0
1130 -
1131 1131  OK
1132 1132  )))
1133 -|AT+12VT=0|Normally closed 12V power supply.|OK
1134 -|AT+12VT=500|Close after a delay of 500 milliseconds.|(((
920 +|(% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK
921 +|(% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)(((
1135 1135  OK
1136 -
1137 -
1138 1138  )))
1139 1139  
1140 -**Downlink Command: 0x07**
925 +(% style="color:blue" %)**Downlink Command: 0x07**
1141 1141  
1142 1142  Format: Command Code (0x07) followed by 3 bytes.
1143 1143  
1144 1144  The first byte is which power, the second and third bytes are the time to turn on.
1145 1145  
1146 -* Example 1: Downlink Payload: 070101F4  -> AT+3V3T=500
1147 -* Example 2: Downlink Payload: 0701FFFF   -> AT+3V3T=65535
1148 -* Example 3: Downlink Payload: 070203E8  -> AT+5VT=1000
1149 -* Example 4: Downlink Payload: 07020000  -> AT+5VT=0
1150 -* Example 5: Downlink Payload: 070301F4  -> AT+12VT=500
1151 -* Example 6: Downlink Payload: 07030000  -> AT+12VT=0
931 +* Example 1: Downlink Payload: 070101F4  **~-~-->**  AT+3V3T=500
932 +* Example 2: Downlink Payload: 0701FFFF   **~-~-->**  AT+3V3T=65535
933 +* Example 3: Downlink Payload: 070203E8  **~-~-->**  AT+5VT=1000
934 +* Example 4: Downlink Payload: 07020000  **~-~-->**  AT+5VT=0
935 +* Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
936 +* Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
1152 1152  
1153 -1.
1154 -11. Set the all data mode
1155 1155  
939 +== 3.4 Set the all data mode ==
940 +
1156 1156  Feature, Set the all data mode.
1157 1157  
1158 1158  **AT Command: AT+ALLDATAMOD**
... ... @@ -1173,9 +1173,9 @@
1173 1173  * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
1174 1174  * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
1175 1175  
1176 -1.
1177 -11. Set the splicing payload for uplink
1178 1178  
962 +== 3.5 Set the splicing payload for uplink ==
963 +
1179 1179  Feature, splicing payload for uplink.
1180 1180  
1181 1181  **AT Command: AT+DATAUP**
... ... @@ -1183,24 +1183,16 @@
1183 1183  |**Command Example**|**Function**|**Response**
1184 1184  |AT+DATAUP =?|Show current splicing payload for uplink mode|(((
1185 1185  0
1186 -
1187 -
1188 1188  OK
1189 1189  )))
1190 1190  |AT+DATAUP =0|(((
1191 1191  Set splicing payload for uplink mode is 0.
1192 -
1193 -
1194 1194  )))|(((
1195 1195  OK
1196 -
1197 -
1198 1198  )))
1199 1199  |AT+DATAUP =1|Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK
1200 1200  |AT+DATAUP =1,20000|(((
1201 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1202 -
1203 -
980 +Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1204 1204  )))|OK
1205 1205  
1206 1206  **Downlink Command: 0xAD**
... ... @@ -1214,8 +1214,7 @@
1214 1214  This means that the interval is set to 0x000014=20S
1215 1215  
1216 1216  
1217 -1.
1218 -11. Set the payload version
994 +== 3.6 Set the payload version ==
1219 1219  
1220 1220  Feature, Set the payload version.
1221 1221  
... ... @@ -1224,8 +1224,6 @@
1224 1224  |**Command Example**|**Function**|**Response**
1225 1225  |AT+PAYVER=?|Show current payload version|(((
1226 1226  1
1227 -
1228 -
1229 1229  OK
1230 1230  )))
1231 1231  |AT+PAYVER=5|Set payload version is 5.|OK
... ... @@ -1237,47 +1237,43 @@
1237 1237  * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
1238 1238  * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
1239 1239  
1240 -1. Battery & how to replace
1241 -11. Battery Type
1014 += 4. Battery & how to replace =
1242 1242  
1243 -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.
1016 +== 4.1 Battery Type ==
1244 1244  
1245 1245  
1019 +PS-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 +
1246 1246  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1247 1247  
1248 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]]
1024 +[[image:1675146710956-626.png]]
1249 1249  
1250 1250  
1251 -Minimum Working Voltage for the SDI-12-LB:
1027 +Minimum Working Voltage for the PS-LB:
1252 1252  
1253 -SDI-12-LB:  2.45v ~~ 3.6v
1029 +PS-LB:  2.45v ~~ 3.6v
1254 1254  
1255 1255  
1256 -1.
1257 -11. Replace Battery
1032 +== 4.2 Replace Battery ==
1258 1258  
1034 +
1259 1259  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1260 1260  
1261 1261  And make sure the positive and negative pins match.
1262 1262  
1263 1263  
1040 +== 4.3 Power Consumption Analyze ==
1264 1264  
1265 -1.
1266 -11. Power Consumption Analyze
1267 1267  
1268 1268  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.
1269 1269  
1270 -
1271 1271  Instruction to use as below:
1272 1272  
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]]
1273 1273  
1274 -Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1049 +(% style="color:blue" %)**Step 2:**(%%) Open it and choose
1275 1275  
1276 -[[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/]]
1277 -
1278 -
1279 -Step 2: Open it and choose
1280 -
1281 1281  * Product Model
1282 1282  * Uplink Interval
1283 1283  * Working Mode
... ... @@ -1284,57 +1284,49 @@
1284 1284  
1285 1285  And the Life expectation in difference case will be shown on the right.
1286 1286  
1287 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image037.png]]
1057 +[[image:1675146895108-304.png]]
1288 1288  
1289 1289  
1290 1290  The battery related documents as below:
1291 1291  
1292 -* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
1293 -* [[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]]
1294 -* [[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]]
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]]
1295 1295  
1296 -|(((
1297 -JST-XH-2P connector
1298 -)))
1066 +[[image:image-20230131145708-3.png]]
1299 1299  
1300 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image038.png]]
1301 1301  
1069 +=== 4.3.1 ​Battery Note ===
1302 1302  
1303 1303  
1304 -1.
1305 -11.
1306 -111. ​Battery Note
1307 -
1308 1308  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.
1309 1309  
1310 1310  
1311 -1.
1312 -11.
1313 -111. ​Replace the battery
1075 +=== 4.3.2 Replace the battery ===
1314 1314  
1315 -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.
1316 1316  
1078 +You can change the battery in the PS-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.
1317 1317  
1318 -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)
1080 +The default battery pack of PS-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)
1319 1319  
1320 1320  
1321 1321  
1084 += 5. Remote Configure device =
1322 1322  
1086 +== 5.1 Connect via BLE ==
1323 1323  
1324 1324  
1325 -1. Remote Configure device
1326 -11. Connect via BLE
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/]]
1327 1327  
1328 -Please see this instruction for how to configure via BLE:
1329 1329  
1330 -[[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/]]
1092 +== 5.2 AT Command Set ==
1331 1331  
1332 1332  
1333 -1.
1334 -11. AT Command Set
1335 1335  
1336 -1. OTA firmware update
1337 1337  
1097 += 6. OTA firmware update =
1098 +
1099 +
1338 1338  Please see this link for how to do OTA firmware update.
1339 1339  
1340 1340  [[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/]]
... ... @@ -1341,8 +1341,21 @@
1341 1341  
1342 1342  
1343 1343  
1106 += 7. ​Order Info =
1344 1344  
1345 1345  
1109 +Part Number: SDI-12-LB-XXX
1110 +XXX:
1111 +EU433: frequency bands EU433
1112 +EU868: frequency bands EU868
1113 +KR920: frequency bands KR920
1114 +CN470: frequency bands CN470
1115 +AS923: frequency bands AS923
1116 +AU915: frequency bands AU915
1117 +US915: frequency bands US915
1118 +IN865: frequency bands IN865
1119 +RU864: frequency bands RU864
1120 +KZ865: frequency bands KZ865
1346 1346  
1347 1347  
1348 1348  
... ... @@ -1349,11 +1349,13 @@
1349 1349  
1350 1350  
1351 1351  
1352 -1. ​Order Info
1353 1353  
1128 += 8. Packing Info =
1129 +
1130 +
1354 1354  **Package Includes**:
1355 1355  
1356 -* SDI-12-LB SDI-12 to LoRaWAN Converter
1133 +* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
1357 1357  
1358 1358  **Dimension and weight**:
1359 1359  
... ... @@ -1364,11 +1364,11 @@
1364 1364  
1365 1365  
1366 1366  
1367 -1. ​Support
1144 += 9. ​Support =
1368 1368  
1146 +
1369 1369  * 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.
1370 -* 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
1371 1371  
1372 -[[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]]
1149 +* 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]]
1373 1373  
1374 1374  
1675215946738-635.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +38.4 KB
Content
1675216282284-923.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +47.0 KB
Content
1675216779406-595.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +59.2 KB
Content

Applications

Navigation

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