Last modified by Xiaoling on 2025/04/25 08:58
<
From version < 37.3 >
edited by Xiaoling
on 2023/02/01 10:25
To version < 34.1 >
edited by Xiaoling
on 2023/02/01 09:44
>
Change comment: Uploaded new attachment "1675215848113-696.png", version {1}

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,8 +419,9 @@
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 +
424 424  ​​​​​​​
425 425  
426 426  === 2.3.3 Convert ASCII to String ===
... ... @@ -442,6 +442,9 @@
442 442  
443 443  [[image:1675214856590-846.png]]
444 444  
446 +
447 +
448 +
445 445  ​​​​​​​
446 446  
447 447  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -480,7 +480,7 @@
480 480  
481 481  (% border="1" style="background-color:#f7faff; width:436px" %)
482 482  |(% style="width:433px" %)(((
483 -**AT+DATACUTx=a,b,c**
487 +AT+DATACUTx=a,b,c
484 484  
485 485  **a**:  length for the return of AT+COMMAND
486 486  
... ... @@ -489,14 +489,13 @@
489 489  **c**:  define the position for valid value. 
490 490  )))
491 491  
492 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
496 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload:
493 493  
494 494  
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
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
500 500  
501 501  * ** Downlink Payload:**
502 502  
... ... @@ -510,17 +510,21 @@
510 510  
511 511  Where:
512 512  
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. 
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. 
518 518  
519 -**Example:**
522 +Example:
520 520  
521 -[[image:image-20230201094129-18.png]]
524 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1**
522 522  
526 +**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
523 523  
528 +**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
529 +
530 +
524 524  **Clear SDI12 Command**
525 525  
526 526  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -540,22 +540,23 @@
540 540  
541 541  
542 542  
550 +
543 543  **command combination**
544 544  
545 545  Below shows a screen shot how the results combines together to a uplink payload.
546 546  
547 -[[image:1675215745275-920.png]]
555 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
548 548  
549 549  
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.
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.
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.
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.
553 553  
554 554  
555 -**For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
563 +For example: as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
556 556  
557 557  
558 -[[image:1675215782925-448.png]]
566 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
559 559  
560 560  
561 561  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.
... ... @@ -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.
... ... @@ -574,7 +574,7 @@
574 574  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
575 575  
576 576  
577 -[[image:1675215828102-844.png]]
584 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
578 578  
579 579  
580 580  **AT+DATAUP=1**
... ... @@ -583,7 +583,7 @@
583 583  
584 584  Final Payload is
585 585  
586 -__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
593 +**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
587 587  
588 588  1. Battery Info (2 bytes): Battery voltage
589 589  1. PAYVER (1 byte): Defined by AT+PAYVER
... ... @@ -591,24 +591,26 @@
591 591  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
592 592  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
593 593  
594 -[[image:1675215848113-696.png]]
601 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
595 595  
596 596  
597 597  **Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
598 598  
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).
606 + ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
603 603  
604 -**~ When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
608 + * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
605 605  
606 -**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
610 + * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
607 607  
612 + ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
608 608  
609 -== ​​​​​​​2.4 Uplink Payload ==
614 + *** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
610 610  
616 +**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
611 611  
618 +1.
619 +11. Uplink Payload
620 +
612 612  Uplink payloads have two types:
613 613  
614 614  * Distance Value: Use FPORT=2
... ... @@ -617,23 +617,24 @@
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 ===
629 +1.
630 +11.
631 +111. 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  
635 +
625 625  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
626 626  
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
631 631  
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 +
632 632  Example parse in TTNv3
633 633  
634 -[[image:1675215946738-635.png]]
645 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.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 ===
700 +1.
701 +11.
702 +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" %)(((
710 +|(((
711 +**Size**
712 +
713 +**(bytes)**
714 +)))|**2**|**1**|**Length depends on the return from the commands**
715 +|**Value**|(((
704 704  Battery(mV)
717 +
705 705  &
719 +
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.
721 +)))|[[PAYLOAD_VER>>path:#Probe_Model]]|(((
722 +If the valid payload is too long and exceed the maximum support
723 +
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]]
727 +[[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  
731 +1.
732 +11.
733 +111. Battery Info
717 717  
718 718  Check the battery voltage for SDI-12-LB.
719 719  
... ... @@ -722,71 +722,253 @@
722 722  Ex2: 0x0B49 = 2889mV
723 723  
724 724  
725 -=== 2.4.4 Interrupt Pin ===
742 +1.
743 +11.
744 +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  
749 +Example:
750 +
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 ===
756 +1.
757 +11.
758 +111. Payload version
738 738  
739 739  
740 740  
741 -=== 2.4.6 ​Decode payload in The Things Network ===
742 742  
743 743  
764 +1.
765 +11.
766 +111. ​Decode payload in The Things Network
767 +
744 744  While using TTN network, you can add the payload format to decode the payload.
745 745  
746 -[[image:1675216779406-595.png]]
770 +[[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  
776 +下面的解码生成超链接放进去.
753 753  
754 -== 2.5 Uplink Interval ==
778 +function Decoder(bytes, port) {
755 755  
780 + 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:
782 + {
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]]
784 + var freq_band;
760 760  
786 + var sub_band;
761 761  
788 + var sensor;
762 762  
763 763  
764 -== 2.6 Frequency Plans ==
791 + if(bytes[0]==0x17)
765 765  
793 + 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/]]
796 + var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f);
770 770  
771 771  
799 + if(bytes[3]==0x01)
772 772  
773 -== 2.7 Firmware Change Log ==
801 + freq_band="EU868";
774 774  
803 + else if(bytes[3]==0x02)
775 775  
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 +
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  
979 +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.
984 +* LoRaWAN Downlink instruction for different platforms:
788 788  
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]]
789 789  
988 +
790 790  There are two kinds of commands to configure SDI-12-LB, they are:
791 791  
792 792  * **General Commands**.
... ... @@ -806,28 +806,30 @@
806 806  These commands only valid for SDI-12-LB, as below:
807 807  
808 808  
809 -== ​​​​​​​3.1 Set Transmit Interval Time ==
810 810  
1009 +1.
1010 +11. Set Transmit Interval Time
811 811  
812 812  Feature: Change LoRaWAN End Node Transmit Interval.
813 813  
814 -(% style="color:blue" %)**AT Command: AT+TDC**
1014 +**AT Command: AT+TDC**
815 815  
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|(((
1016 +|**Command Example**|**Function**|**Response**
1017 +|AT+TDC=?|Show current transmit Interval|(((
819 819  30000
1019 +
820 820  OK
1021 +
821 821  the interval is 30000ms = 30s
822 822  )))
823 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1024 +|AT+TDC=60000|Set Transmit Interval|(((
824 824  OK
1026 +
825 825  Set transmit interval to 60000ms = 60 seconds
826 826  )))
827 827  
828 -(% style="color:blue" %)**Downlink Command: 0x01**
1030 +**Downlink Command: 0x01**
829 829  
830 -
831 831  Format: Command Code (0x01) followed by 3 bytes time value.
832 832  
833 833  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
... ... @@ -835,28 +835,31 @@
835 835  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
836 836  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
837 837  
838 -== 3.2 Set Interrupt Mode ==
1039 +1.
1040 +11. Set Interrupt Mode
839 839  
840 840  Feature, Set Interrupt mode for GPIO_EXIT.
841 841  
842 -(% style="color:blue" %)**AT Command: AT+INTMOD**
1044 +**AT Command: AT+INTMOD**
843 843  
844 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
845 -|=**Command Example**|=**Function**|=**Response**
1046 +|**Command Example**|**Function**|**Response**
846 846  |AT+INTMOD=?|Show current interrupt mode|(((
847 847  0
1049 +
848 848  OK
1051 +
849 849  the mode is 0 = No interruption
850 850  )))
851 851  |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)
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)
857 857  )))|OK
858 858  
859 -(% style="color:blue" %)**Downlink Command: 0x06**
1063 +**Downlink Command: 0x06**
860 860  
861 861  Format: Command Code (0x06) followed by 3 bytes.
862 862  
... ... @@ -865,79 +865,90 @@
865 865  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
866 866  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
867 867  
1072 +1.
1073 +11. Set the output time
868 868  
869 -== 3.3 Set the output time ==
870 -
871 -
872 872  Feature, Control the output 3V3 , 5V or 12V.
873 873  
874 -(% style="color:blue" %)**AT Command: AT+3V3T**
1077 +**AT Command: AT+3V3T**
875 875  
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" %)(((
1079 +|**Command Example**|**Function**|**Response**
1080 +|AT+3V3T=?|Show 3V3 open time.|(((
879 879  0
1082 +
880 880  OK
881 881  )))
882 -|(% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)(((
1085 +|AT+3V3T=0|Normally open 3V3 power supply.|(((
883 883  OK
1087 +
884 884  default setting
885 885  )))
886 -|(% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)(((
1090 +|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|(((
887 887  OK
1092 +
1093 +
888 888  )))
889 -|(% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)(((
1095 +|AT+3V3T=65535|Normally closed 3V3 power supply.|(((
890 890  OK
1097 +
1098 +
891 891  )))
892 892  
893 -(% style="color:blue" %)**AT Command: AT+5VT**
1101 +**AT Command: AT+5VT**
894 894  
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" %)(((
1103 +|**Command Example**|**Function**|**Response**
1104 +|AT+5VT=?|Show 5V open time.|(((
898 898  0
1106 +
899 899  OK
900 900  )))
901 -|(% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)(((
1109 +|AT+5VT=0|Normally closed 5V power supply.|(((
902 902  OK
1111 +
903 903  default setting
904 904  )))
905 -|(% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)(((
1114 +|AT+5VT=1000|Close after a delay of 1000 milliseconds.|(((
906 906  OK
1116 +
1117 +
907 907  )))
908 -|(% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)(((
1119 +|AT+5VT=65535|Normally open 5V power supply.|(((
909 909  OK
1121 +
1122 +
910 910  )))
911 911  
912 -(% style="color:blue" %)**AT Command: AT+12VT**
1125 +**AT Command: AT+12VT**
913 913  
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" %)(((
1127 +|**Command Example**|**Function**|**Response**
1128 +|AT+12VT=?|Show 12V open time.|(((
917 917  0
1130 +
918 918  OK
919 919  )))
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" %)(((
1133 +|AT+12VT=0|Normally closed 12V power supply.|OK
1134 +|AT+12VT=500|Close after a delay of 500 milliseconds.|(((
922 922  OK
1136 +
1137 +
923 923  )))
924 924  
925 -(% style="color:blue" %)**Downlink Command: 0x07**
1140 +**Downlink Command: 0x07**
926 926  
927 927  Format: Command Code (0x07) followed by 3 bytes.
928 928  
929 929  The first byte is which power, the second and third bytes are the time to turn on.
930 930  
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
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
937 937  
1153 +1.
1154 +11. Set the all data mode
938 938  
939 -== 3.4 Set the all data mode ==
940 -
941 941  Feature, Set the all data mode.
942 942  
943 943  **AT Command: AT+ALLDATAMOD**
... ... @@ -958,9 +958,9 @@
958 958  * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
959 959  * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
960 960  
1176 +1.
1177 +11. Set the splicing payload for uplink
961 961  
962 -== 3.5 Set the splicing payload for uplink ==
963 -
964 964  Feature, splicing payload for uplink.
965 965  
966 966  **AT Command: AT+DATAUP**
... ... @@ -968,16 +968,24 @@
968 968  |**Command Example**|**Function**|**Response**
969 969  |AT+DATAUP =?|Show current splicing payload for uplink mode|(((
970 970  0
1186 +
1187 +
971 971  OK
972 972  )))
973 973  |AT+DATAUP =0|(((
974 974  Set splicing payload for uplink mode is 0.
1192 +
1193 +
975 975  )))|(((
976 976  OK
1196 +
1197 +
977 977  )))
978 978  |AT+DATAUP =1|Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK
979 979  |AT+DATAUP =1,20000|(((
980 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1201 +Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds.
1202 +
1203 +
981 981  )))|OK
982 982  
983 983  **Downlink Command: 0xAD**
... ... @@ -991,7 +991,8 @@
991 991  This means that the interval is set to 0x000014=20S
992 992  
993 993  
994 -== 3.6 Set the payload version ==
1217 +1.
1218 +11. Set the payload version
995 995  
996 996  Feature, Set the payload version.
997 997  
... ... @@ -1000,6 +1000,8 @@
1000 1000  |**Command Example**|**Function**|**Response**
1001 1001  |AT+PAYVER=?|Show current payload version|(((
1002 1002  1
1227 +
1228 +
1003 1003  OK
1004 1004  )))
1005 1005  |AT+PAYVER=5|Set payload version is 5.|OK
... ... @@ -1011,43 +1011,47 @@
1011 1011  * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
1012 1012  * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
1013 1013  
1014 -= 4. Battery & how to replace =
1240 +1. Battery & how to replace
1241 +11. Battery Type
1015 1015  
1016 -== 4.1 Battery Type ==
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.
1017 1017  
1018 1018  
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 -
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]]
1248 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]]
1025 1025  
1026 1026  
1027 -Minimum Working Voltage for the PS-LB:
1251 +Minimum Working Voltage for the SDI-12-LB:
1028 1028  
1029 -PS-LB:  2.45v ~~ 3.6v
1253 +SDI-12-LB:  2.45v ~~ 3.6v
1030 1030  
1031 1031  
1032 -== 4.2 Replace Battery ==
1256 +1.
1257 +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  
1265 +1.
1266 +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  
1270 +
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
1274 +Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1050 1050  
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 +
1051 1051  * Product Model
1052 1052  * Uplink Interval
1053 1053  * Working Mode
... ... @@ -1054,49 +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]]
1287 +[[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]]
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]]
1065 1065  
1066 -[[image:image-20230131145708-3.png]]
1296 +|(((
1297 +JST-XH-2P connector
1298 +)))
1067 1067  
1300 +[[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  
1304 +1.
1305 +11.
1306 +111. ​Battery Note
1307 +
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 ===
1311 +1.
1312 +11.
1313 +111. ​Replace the battery
1076 1076  
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.
1077 1077  
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.
1079 1079  
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)
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)
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/]]
1325 +1. Remote Configure device
1326 +11. Connect via BLE
1090 1090  
1328 +Please see this instruction for how to configure via BLE:
1091 1091  
1092 -== 5.2 AT Command Set ==
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/]]
1093 1093  
1094 1094  
1333 +1.
1334 +11. AT Command Set
1095 1095  
1336 +1. OTA firmware update
1096 1096  
1097 -= 6. OTA firmware update =
1098 -
1099 -
1100 1100  Please see this link for how to do OTA firmware update.
1101 1101  
1102 1102  [[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/]]
... ... @@ -1103,21 +1103,8 @@
1103 1103  
1104 1104  
1105 1105  
1106 -= 7. ​Order Info =
1107 1107  
1108 1108  
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
1121 1121  
1122 1122  
1123 1123  
... ... @@ -1124,13 +1124,11 @@
1124 1124  
1125 1125  
1126 1126  
1352 +1. ​Order Info
1127 1127  
1128 -= 8. Packing Info =
1129 -
1130 -
1131 1131  **Package Includes**:
1132 1132  
1133 -* SDI-12-LB SDI-12 to LoRaWAN Converter x 1
1356 +* SDI-12-LB SDI-12 to LoRaWAN Converter
1134 1134  
1135 1135  **Dimension and weight**:
1136 1136  
... ... @@ -1141,11 +1141,11 @@
1141 1141  
1142 1142  
1143 1143  
1144 -= 9. ​Support =
1367 +1. ​Support
1145 1145  
1146 -
1147 1147  * 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
1148 1148  
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]]
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]]
1150 1150  
1151 1151  
1675215946738-635.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -38.4 KB
Content
1675216282284-923.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -47.0 KB
Content
1675216779406-595.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.2 KB
Content

Applications

Navigation

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