Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 172.1
edited by Mengting Qiu
on 2025/06/09 14:22
Change comment: There is no comment for this version
To version 147.1
edited by Mengting Qiu
on 2025/05/15 14:18
Change comment: Uploaded new attachment "1747289896656-580.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -498,7 +498,7 @@
498 498  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
499 499  
500 500  
501 -AT+COMMANDx & AT+DATACUTx**&AT+DATACONVx**
501 +AT+COMMANDx & AT+DATACUTx
502 502  
503 503  User can define max 15 SDI-12 Commands (AT+COMMAND1 ~~ AT+COMMANDF). On each uplink period (TDC time, default 20 minutes), SDI-12-LB/LS will send these SDI-12 commands and wait for return from SDI-12 sensors. SDI-12-LB/LS will then combine these returns and uplink via LoRaWAN.
504 504  
... ... @@ -511,10 +511,8 @@
511 511  
512 512  (% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)
513 513  
514 -(% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//. (% style="color:red" %)**2: When set to 2, AT+ALDATAMOD=1 does not intercept data returned by the current COMMAND command.(since v1.3.0)**
514 +(% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
515 515  
516 -(% style="color:red" %)**(Function set to 2: When the device is connected to more than two sensors with different sampling addresses, concurrent measurement can be used to reduce data acquisition time and save battery power; for example, when a device is connected to two sensors with different addresses, and both sensors are to use concurrent measurements, then both sensors can be measured at the same time without the second one having to wait until after the first one.)**
517 -
518 518  (% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB/LS will resend this command. Max 3 retries.
519 519  
520 520  (% style="color:red" %)**0 **(%%) No validation check;
... ... @@ -656,108 +656,6 @@
656 656  (% style="color:red" %)**When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
657 657  
658 658  
659 -
660 -(% style="color:blue" %)**Automatically converts polled data to hex format for uplinking(Since v1.3.0)**
661 -
662 -
663 -This command can retrieve the returned data, convert the number after the positive or negative sign into a data, and then set the number of bytes to upload the data.
664 -
665 -
666 -* (% style="color:blue" %)**AT Command:**
667 -
668 -The maximum number can be set to 5 groups and the format of the command is as follows：
669 -
670 -(% style="color:#037691" %)**Example 1:AT+DATACONVx=var1, var2**
671 -
672 -(% style="color:#037691" %)**Example 2:AT+DATACONVx=var1, var2+ var3, var4**
673 -
674 -(% style="color:#037691" %)**Example 3:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6**
675 -
676 -(% style="color:#037691" %)**Example 4:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8**
677 -
678 -(% style="color:#037691" %)**Example 5:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8+ var9, var10**
679 -
680 -(% style="color:red" %)**Notice: Among them, var1, var3, var5, var7, and var9 are the data to be selected for conversion, and var2, var4, var6, var8, and var10 are the number of bytes to be uploaded. The values of var2, var4, var6, var8, and var10 range from 1 to 4.**
681 -
682 -* (% style="color:blue" %)**Downlink Command:**
683 -
684 -Format: Command code (0xAC) followed by up to 20 bytes.
685 -
686 -
687 -Example 1 1:AT+DATACONVx=var1, var2   
688 -
689 -Downlink Command：AC x var1  var2
690 -
691 -Example 1 2:AT+DATACONVx=var1, var2+ var3, var4 
692 -
693 -Downlink Command：AC x var1  var2  var3 var4
694 -
695 -Example 1 3:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6
696 -
697 -Downlink Command：AC x var1  var2  var3 var4 var5 var6
698 -
699 -Example 1 4:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8
700 -
701 -Downlink Command：AC x var1  var2  var3 var4 var5 var6 var7 var8
702 -
703 -Example 1 5:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8+ var9, var10
704 -
705 -Downlink Command：AC x var1  var2  var3 var4 var5 var6 var7 var8 var9 var10
706 -
707 -
708 -Example:
709 -
710 -* Example 1: Downlink Payload: AC 01 01 02 02 02  ~/~/  AT+DATACONV1=1,2+2,2 
711 -* Example 2: Downlink Payload: AC 02 01 02 02 02 03 02  ~/~/  AT+DATACONV2=1,2+2,2+3,2
712 -
713 -
714 -**For example:**
715 -
716 -This is my configuration:
717 -
718 -[[image:image-20250609134137-1.png]]
719 -
720 -
721 -* AT+COMMAND1=0C!,0,2,0  Use concurrent measurement commands without intercepting the returned data.
722 -* AT+COMMAND2=1C!,1,2,0  Use concurrent measurement commands without intercepting the returned data, with a second parameter to be set at the last concurrent command (the second parameter takes the maximum transition time between the two sensors)
723 -* AT+COMMAND3=0D0!,0,0,0  Query the data measured by device 0
724 -* AT+COMMAND4=1D0!,0,0,0  Query the data measured by device 1
725 -
726 -This is the data obtained:
727 -
728 -[[image:image-20250609134901-2.png]]
729 -
730 -
731 -When using the AT+DATACONVx command,
732 -
733 -The data of RETURN3 will be converted into 2 data, the first data is +95, and the second data is +260.
734 -
735 -* AT+DATACONV3=1,2+2,2  The first data is uploaded as 2 bytes and the second data is uploaded as 2 bytes. The form converted to hexadecimal is as shown above,as below:
736 -* (((
737 -AT+DATACONV4=1,3+2,2+3,2  The first data uploads 3 bytes, the second data also uploads 2 bytes, and the third data also uploads 2 bytes. The hexadecimal form is shown above and as shown in the following figure:
738 -)))
739 -
740 -[[image:image-20250609141343-1.png]]
741 -
742 -**For example,the uplink payload as below:**
743 -
744 -0CE4 01 00C6 0103 02DB99 00FD 0001
745 -
746 -(% style="color:#037691" %)**BAT**(%%): 0x0CE4 = 3300mV = 3.300V
747 -
748 -(% style="color:#037691" %)**Payload Version**(%%): 0x01, Means: v1.0 version
749 -
750 -(% style="color:#037691" %)**Data 1: **(%%)0x00C6(H) = 198(D) / 100 = 19.8
751 -
752 -(% style="color:#037691" %)**Data 2: **(%%)0x0103(H) = 259(D) / 10 = 25.9
753 -
754 -(% style="color:#037691" %)**Data 3: **(%%)0x02DB99(H) = 187289(D) / 100 = 1872.89
755 -
756 -(% style="color:#037691" %)**Data 4: **(%%)0x00FD(H) = 253(D) / 10 = 25.3
757 -
758 -(% style="color:#037691" %)**Data 5: **(%%)0x0001(H) = 1(D) = 1
759 -
760 -
761 761  == 2.4 Uplink Payload ==
762 762  
763 763  === 2.4.1 Device Payload, FPORT~=5 ===
... ... @@ -1425,11 +1425,7 @@
1425 1425  
1426 1426  **SDI-12-LB will uplink this payload.**
1427 1427  
1428 -**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A **
1429 -68253C5D 12 0C7801F10D302B312E31372B32372E340D0A
1430 -68253D33 12 0C7201F10D302B312E31352B32382E390D0A
1431 -68253DAB 12 0C7201F10D302B312E31342B32392E340D0A
1432 -68253E23 12 0C7201F10D302B312E31332B33302E300D0A
1324 +**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A **68253C5D120C7801F10D302B312E31372B32372E340D0A68253D33120C7201F10D302B312E31352B32382E390D0A68253DAB120C7201F10D302B312E31342B32392E340D0A68253E23120C7201F10D302B312E31332B33302E300D0A
1433 1433  
1434 1434  
1435 1435  Where the first 23 bytes is for the first entry:
... ... @@ -1683,7 +1683,7 @@
1683 1683  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1684 1684  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1685 1685  
1686 -== 3.7 Print data entries base on page(Since v1.3.0) ==
1578 +=== 3.7 Print data entries base on page ===
1687 1687  
1688 1688  
1689 1689  Feature: Print the sector data from start page to stop page (max is 416 pages).
... ... @@ -1727,7 +1727,7 @@
1727 1727  No downlink commands for feature
1728 1728  
1729 1729  
1730 -== 3.8 Print last few data entries(Since v1.3.0) ==
1622 +=== 3.8 Print last few data entries ===
1731 1731  
1732 1732  
1733 1733  Feature: Print the last few data entries
... ... @@ -1734,91 +1734,35 @@
1734 1734  
1735 1735  (% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1736 1736  
1737 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
1738 -|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px;background-color:#4F81BD;color:white" %)**Function**
1739 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,0|(% style="background-color:#f2f2f2; width:192px" %)Printing the last ten data in hex format
1740 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,1|(% style="background-color:#f2f2f2; width:192px" %)Print the last ten data in string format
1741 -
1742 -* **Prints in hex format:**
1743 -
1744 1744  (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1745 1745  |(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1746 1746  |(% style="width:156px" %)(((
1747 -AT+PLDTA=10,0
1632 +AT+PLDTA=10
1748 1748  Print last 10 entries
1749 1749  )))|(% style="width:311px" %)(((
1750 1750  Stop Tx events when read sensor data
1751 1751  
1752 -0001-0001 2025/5/16 06:48:04 7 0c 7e 01 00 5f 01 05
1637 +0001-0002 2025/5/15 01:04:43 18 0c 72 01 f1 0d 30 2b 31 2e 31 34 2b 32 39 2e 34 0d 0a
1753 1753  
1754 -0002-0002 2025/5/16 06:50:04 7 0c 72 01 00 5f 01 05
1639 +0003-0004 2025/5/15 01:06:43 18 0c 72 01 f1 0d 30 2b 31 2e 31 33 2b 33 30 2e 30 0d 0a
1755 1755  
1756 -0003-0003 2025/5/16 06:52:04 7 0c 72 01 00 5f 01 05
1641 +0005-0006 2025/5/15 01:08:43 18 0c 7e 01 f1 0d 30 2b 31 2e 33 30 2b 33 30 2e 35 0d 0a
1757 1757  
1758 -0004-0004 2025/5/16 06:54:04 7 0c 7e 01 00 5f 01 05
1643 +0007-0008 2025/5/15 01:10:43 18 0c 72 01 f1 0d 30 2b 31 2e 33 30 2b 33 31 2e 30 0d 0a
1759 1759  
1760 -0005-0005 2025/5/16 06:56:04 7 0c 7e 01 00 5f 01 07
1645 +0009-0010 2025/5/15 01:12:43 18 0c 72 01 f1 0d 30 2b 31 2e 33 30 2b 33 31 2e 31 0d 0a
1761 1761  
1762 -0006-0006 2025/5/16 06:58:04 7 0c 8a 01 00 60 01 07
1763 -
1764 -0007-0007 2025/5/16 07:00:04 7 0c 84 01 00 61 01 07
1765 -
1766 -0008-0008 2025/5/16 07:02:04 7 0c 72 01 00 61 01 07
1767 -
1768 -0009-0009 2025/5/16 07:04:04 7 0c 78 01 00 61 01 07
1769 -
1770 -0010-0010 2025/5/16 07:06:04 7 0c 78 01 00 61 01 07
1771 -
1772 1772  Start Tx events
1773 1773  
1774 1774  OK
1775 1775  )))
1776 1776  
1777 -* **Printing in String Format:**
1778 -
1779 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1780 -|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1781 -|(% style="width:156px" %)(((
1782 -AT+PLDTA=10,1
1783 -Print last 10 entries
1784 -
1785 -(((
1786 -(Printing in String Format)
1787 -)))
1788 -)))|(% style="width:311px" %)(((
1789 -Stop Tx events when read sensor data
1790 -
1791 -0001-0001 2025/5/16 06:48:04 7 ~~_
1792 -
1793 -0002-0002 2025/5/16 06:50:04 7 r_
1794 -
1795 -0003-0003 2025/5/16 06:52:04 7 r_
1796 -
1797 -0004-0004 2025/5/16 06:54:04 7 ~~_
1798 -
1799 -0005-0005 2025/5/16 06:56:04 7 ~~_
1800 -
1801 -0006-0006 2025/5/16 06:58:04 7 `
1802 -
1803 -0007-0007 2025/5/16 07:00:04 7 a
1804 -
1805 -0008-0008 2025/5/16 07:02:04 7 ra
1806 -
1807 -0009-0009 2025/5/16 07:04:04 7 xa
1808 -
1809 -0010-0010 2025/5/16 07:06:04 7 xa
1810 -
1811 -Start Tx events
1812 -
1813 -OK
1814 -)))
1815 -
1816 1816  (% style="color:#4f81bd" %)**Downlink Command:**
1817 1817  
1818 1818  No downlink commands for feature
1819 1819  
1820 1820  
1821 -== 3.9 Clear Flash Record(Since v1.3.0) ==
1657 +=== 3.9 Clear Flash Record ===
1822 1822  
1823 1823  
1824 1824  Feature: Clear flash storage for data log feature.
... ... @@ -1837,127 +1837,6 @@
1837 1837  
1838 1838  * Example: 0xA301  ~/~/  Same as AT+CLRDTA
1839 1839  
1840 -== 3.10 SDI12 timing(Since v1.3.0) ==
1841 -
1842 -
1843 -Feature: Get or set the time of SDI12 timing.
1844 -
1845 -[[image:1747289896656-580.png||height="414" width="566"]]
1846 -
1847 -
1848 -(% style="color:#4f81bd" %)**AT Command: AT+SDITIMING**
1849 -
1850 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1851 -|(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:167px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:177px" %)**Response**
1852 -|(% style="width:155px" %)(((
1853 -AT+SDITIMING=13,9
1854 -
1855 -
1856 -)))|(% style="width:167px" %)Get or set the time of SDI12 timing|(% style="width:177px" %)(((
1857 -OK
1858 -
1859 -Default: 13,9
1860 -)))
1861 -
1862 -(% style="color:#4f81bd" %)**Downlink Command: 0xA9**
1863 -
1864 -* Example: 0xA90D09  ~/~/  Same as AT+SDITIMING=13,9
1865 -
1866 -== 3.11 add Pulse_count, VDC_input, IDC_input(Since firmware V1.3.0) ==
1867 -
1868 -
1869 -(% style="color:blue" %)**Setting up external sensors:**
1870 -
1871 -* (% style="color:#037691" %)**AT Command:**
1872 -
1873 -(% style="color:#4472c4" %)**AT+EXT=a,b,c**(%%)
1874 -
1875 -(% style="color:#4472c4" %)**a:**(%%)  **0:** Disable Counting function ( doesn't effect interrupt ).  **1:** Enable Counting function(4 bytes).
1876 -(% style="color:#4472c4" %)**b: **(%%) **0:** Disable voltage acquisition function.  **1:** Enable voltage acquisition function(2 bytes)
1877 -(% style="color:#4472c4" %)**c:**(%%)  **0:** Disable current acquisition  function.  **1:** Enable current acquisition function(2 bytes).
1878 -
1879 -**Example:**
1880 -
1881 -(% style="color:#4472c4" %)**AT+EXT=1,1,1**
1882 -
1883 -Device will add counting, voltage and current acquisition function.
1884 -
1885 -The payload will be:
1886 -Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting + ** ***VDC_INPUT**  + ***IDC_INPUT**  + Length depends on the return from the commands
1887 -
1888 -(% style="color:#4472c4" %)**AT+EXT=1,0,0**
1889 -
1890 -Device will add counting support.
1891 -
1892 -The payload will be:
1893 -Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting** + Length depends on the return from the commands
1894 -
1895 -* (% style="color:#037691" %)**Downlink Command: 0x0B aa bb cc**
1896 -
1897 -Format: Command Code (0x0B) followed by 3 bytes.
1898 -
1899 -(% style="color:#037691" %)**aa:**(%%) Set Disable or Enable Counting Support.   **00**: Disable, **01**: Enable.
1900 -
1901 -(% style="color:#037691" %)**bb:**(%%) Set Disable or Enable voltage acquisition.  **00**: Disable, **01**: Enable.
1902 -
1903 -(% style="color:#037691" %)**cc:**(%%) Set Disable or Enable current acquisition.  **00**: Disable, **01**: Enable.
1904 -
1905 -**Example:**
1906 -
1907 -Downlink payload:  0B 00 00 01  ~/~/AT+EXT=0,0,1  Enable current acquisition
1908 -
1909 -Downlink payload:  0B 01 00 01  ~/~/AT+EXT=1,0,1  Enable Counting Support and Current acquisition                        
1910 -
1911 -
1912 -(% style="color:blue" %)**Set the pulse count value:**
1913 -
1914 -* (% style="color:#037691" %)**AT Command:**
1915 -
1916 -(% style="color:#4472c4" %)**AT+SETCNT=aa     **(%%)~/~/ Set the pulse count value.
1917 -
1918 -**Example:**
1919 -
1920 -AT+SETCNT=100  (% style="display:none" %) (%%)~/~/ Set the pulse count to 100.(% style="display:none" %)
1921 -
1922 -* (% style="color:#037691" %)**Downlink Command: 0x0C**
1923 -
1924 -Format: Command Code (0x0C) followed by 4 bytes.
1925 -
1926 -**Example:**
1927 -
1928 -Downlink Payload: 0C 00 00 00 64  ~/~/ AT+SETCNT=100
1929 -
1930 -
1931 -(% style="color:blue" %)**Connect counting sensor:**
1932 -
1933 -The counting sensor cables are connected to the **3V3 pin** and **GPIO_EXTI** pin of the **SIB v1.3** motherboard.
1934 -
1935 -[[image:image-20250519110640-1.jpeg||height="318" width="708"]]
1936 -
1937 -
1938 -(% id="cke_bm_1699404S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Connect Voltage output sensor:**
1939 -
1940 -Example:
1941 -
1942 -**RED <~-~-~-~-> VDC_INPUT**
1943 -
1944 -**BLACK <~-~-~-~-~-~-> GND**
1945 -
1946 -[[image:image-20250519111415-3.jpeg||height="338" width="710"]]
1947 -
1948 -
1949 -(% style="color:blue" %)**Connect Current output sensor:**
1950 -
1951 -Example:
1952 -
1953 -**RED <~-~-~-~-~-~-~-~--> IDC_INPUT**
1954 -
1955 -**BLACK <~-~-~-~-~-~-> GND**
1956 -
1957 -[[image:image-20250519111732-4.jpeg||height="373" width="708"]]
1958 -
1959 -
1960 -
1961 1961  = 4. Battery & Power Consumption =
1962 1962  
1963 1963  
image-20250516100849-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -37.2 KB
Content
image-20250516103205-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -37.3 KB
Content
image-20250516103652-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -14.5 KB
Content
image-20250516144559-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -55.1 KB
Content
image-20250516145402-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -9.6 KB
Content
image-20250519110640-1.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -230.2 KB
Content
image-20250519111322-2.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -228.0 KB
Content
image-20250519111415-3.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -192.7 KB
Content
image-20250519111732-4.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -193.7 KB
Content
image-20250605091006-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -37.1 KB
Content
image-20250609134137-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -48.0 KB
Content
image-20250609134901-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -16.6 KB
Content
image-20250609141343-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -76.1 KB
Content