Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 166.2
edited by Mengting Qiu
on 2025/06/07 09:44
Change comment: There is no comment for this version
To version 145.1
edited by Mengting Qiu
on 2025/05/15 09:36
Change comment: There is no comment for this version

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: The returned data will not be clipped.(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" %)**(When set to 2, AT+ALDATAMOD=1 does not intercept data returned by the current COMMAND command.)**
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,99 +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 -
715 -
716 -
717 -**For example:**
718 -
719 -This is my configuration:
720 -
721 -[[image:image-20250605091006-1.png]]
722 -
723 -
724 -* AT+COMMAND1=0C!,0,2,0  After sending the concurrent command of device 0, the data will not be cut, and the next command will be sent immediately.
725 -* AT+COMMAND2=0M!,1,2,0  After sending the concurrent command of device 0, do not cut the data and wait for one second. (The last concurrent command needs to wait for the measurement time of all sensors)
726 -* AT+COMMAND3=0D0!,0,0,0  Query the data measured by device 0
727 -
728 -This is the data obtained:
729 -
730 -[[image:image-20250516145402-2.png]]
731 -
732 -
733 -When using the AT+DATACONVx command,
734 -
735 -The data of RETURN3 will be converted into 2 data, the first data is +95, and the second data is +260.
736 -
737 -* 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:
738 -
739 -[[image:image-20250516144559-1.png]]
740 -
741 -0C90 01 005F 0104
742 -
743 -(% style="color:#037691" %)**BAT**(%%): 0x0c90 = 3216mV = 3.216V
744 -
745 -(% style="color:#037691" %)**Payload Version**(%%): 0x01, Means: v1.0 version
746 -
747 -(% style="color:#037691" %)**Data 1: **(%%)0x005F(H) = 95(D) / 100 = 0.95
748 -
749 -(% style="color:#037691" %)**Data 2: **(%%)0x0104(H) = 260(D) / 10 = 26.0
750 -
751 -
752 752  == 2.4 Uplink Payload ==
753 753  
754 754  === 2.4.1 Device Payload, FPORT~=5 ===
... ... @@ -1407,35 +1407,31 @@
1407 1407  2025/3/25 08:16:30
1408 1408  )))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
1409 1409  
1410 -If user sends below downlink command: (% style="background-color:yellow" %)3168253B6E68253E2305
1315 +If user sends below downlink command: (% style="background-color:yellow" %)3167E264BA67E2665E05
1411 1411  
1412 -Where : Start time: (% _mstmutation="1" %)68253B6E (%%)= time 2025/05/15 00:55:10
1317 +Where : Start time: 67E264BA = time 2025/3/25 08:09:30
1413 1413  
1414 - Stop time: (% _mstmutation="1" %)68253E23 (%%)= time 2025/05/15 01:06:43
1319 + Stop time: 67E2665E= time 2025/3/25 08:16:30
1415 1415  
1416 1416  
1417 1417  **SDI-12-LB will uplink this payload.**
1418 1418  
1419 -**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A **
1420 -68253C5D 12 0C7801F10D302B312E31372B32372E340D0A
1421 -68253D33 12 0C7201F10D302B312E31352B32382E390D0A
1422 -68253DAB 12 0C7201F10D302B312E31342B32392E340D0A
1423 -68253E23 12 0C7201F10D302B312E31332B33302E300D0A
1324 +**67E264BA 05 0CA8 01 0821** 67E264F6050CAE01082267E26532050CAE01082267E2656E050CAE01082267E265AA050CB401082367E265E6050CAE01082267E26622050CB401082367E2665E050CAE010822
1424 1424  
1425 1425  
1426 -Where the first 23 bytes is for the first entry:
1327 +Where the first 10 bytes is for the first entry:
1427 1427  
1428 -**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A**
1329 +67E264BA050CA8010821
1429 1429  
1430 -Unix Time Stamp: 68253B6E(H)=1747270510(D)  ~-~->  time=2025-05-15 8:55:00
1331 +Unix Time Stamp: 67E264BA(H)=1742890170(D)  ~-~->  time=2025-03-25 8:09:30
1431 1431  
1432 -Payload Length: 0x12(H)=18 bytes
1333 +Payload Length: 0x05(H)=5 bytes
1433 1433  
1434 -Battery voltage: 0x0C78(H)=3192 mV
1335 +Battery voltage: 0x0CA8(H)=3240 mV
1435 1435  
1436 1436  Payload Version:  01
1437 1437  
1438 -Value: For the distance sensor used for testing, this value is the mm distance value, 0xF10D302B312E31372B32362E390D0A(H)
1339 +Value: For the distance sensor used for testing, this value is the mm distance value, 0x0821(H)=2081mm.
1439 1439  
1440 1440  
1441 1441  
... ... @@ -1674,9 +1674,10 @@
1674 1674  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1675 1675  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1676 1676  
1677 -== 3.7 Print data entries base on page(Since v1.3.0) ==
1678 1678  
1579 +=== 3.7 Print data entries base on page ===
1679 1679  
1581 +
1680 1680  Feature: Print the sector data from start page to stop page (max is 416 pages).
1681 1681  
1682 1682  (% style="color:#4f81bd" %)**AT Command: AT+PDTA**
... ... @@ -1718,7 +1718,7 @@
1718 1718  No downlink commands for feature
1719 1719  
1720 1720  
1721 -== 3.8 Print last few data entries(Since v1.3.0) ==
1623 +=== 3.8 Print last few data entries ===
1722 1722  
1723 1723  
1724 1724  Feature: Print the last few data entries
... ... @@ -1725,91 +1725,35 @@
1725 1725  
1726 1726  (% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1727 1727  
1728 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
1729 -|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px;background-color:#4F81BD;color:white" %)**Function**
1730 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,0|(% style="background-color:#f2f2f2; width:192px" %)Printing the last ten data in hex format
1731 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,1|(% style="background-color:#f2f2f2; width:192px" %)Print the last ten data in string format
1732 -
1733 -* **Prints in hex format:**
1734 -
1735 1735  (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1736 1736  |(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1737 1737  |(% style="width:156px" %)(((
1738 -AT+PLDTA=10,0
1633 +AT+PLDTA=10
1739 1739  Print last 10 entries
1740 1740  )))|(% style="width:311px" %)(((
1741 1741  Stop Tx events when read sensor data
1742 1742  
1743 -0001-0001 2025/5/16 06:48:04 7 0c 7e 01 00 5f 01 05
1638 +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
1744 1744  
1745 -0002-0002 2025/5/16 06:50:04 7 0c 72 01 00 5f 01 05
1640 +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
1746 1746  
1747 -0003-0003 2025/5/16 06:52:04 7 0c 72 01 00 5f 01 05
1642 +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
1748 1748  
1749 -0004-0004 2025/5/16 06:54:04 7 0c 7e 01 00 5f 01 05
1644 +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
1750 1750  
1751 -0005-0005 2025/5/16 06:56:04 7 0c 7e 01 00 5f 01 07
1646 +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
1752 1752  
1753 -0006-0006 2025/5/16 06:58:04 7 0c 8a 01 00 60 01 07
1754 -
1755 -0007-0007 2025/5/16 07:00:04 7 0c 84 01 00 61 01 07
1756 -
1757 -0008-0008 2025/5/16 07:02:04 7 0c 72 01 00 61 01 07
1758 -
1759 -0009-0009 2025/5/16 07:04:04 7 0c 78 01 00 61 01 07
1760 -
1761 -0010-0010 2025/5/16 07:06:04 7 0c 78 01 00 61 01 07
1762 -
1763 1763  Start Tx events
1764 1764  
1765 1765  OK
1766 1766  )))
1767 1767  
1768 -* **Printing in String Format:**
1769 -
1770 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1771 -|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1772 -|(% style="width:156px" %)(((
1773 -AT+PLDTA=10,1
1774 -Print last 10 entries
1775 -
1776 -(((
1777 -(Printing in String Format)
1778 -)))
1779 -)))|(% style="width:311px" %)(((
1780 -Stop Tx events when read sensor data
1781 -
1782 -0001-0001 2025/5/16 06:48:04 7 ~~_
1783 -
1784 -0002-0002 2025/5/16 06:50:04 7 r_
1785 -
1786 -0003-0003 2025/5/16 06:52:04 7 r_
1787 -
1788 -0004-0004 2025/5/16 06:54:04 7 ~~_
1789 -
1790 -0005-0005 2025/5/16 06:56:04 7 ~~_
1791 -
1792 -0006-0006 2025/5/16 06:58:04 7 `
1793 -
1794 -0007-0007 2025/5/16 07:00:04 7 a
1795 -
1796 -0008-0008 2025/5/16 07:02:04 7 ra
1797 -
1798 -0009-0009 2025/5/16 07:04:04 7 xa
1799 -
1800 -0010-0010 2025/5/16 07:06:04 7 xa
1801 -
1802 -Start Tx events
1803 -
1804 -OK
1805 -)))
1806 -
1807 1807  (% style="color:#4f81bd" %)**Downlink Command:**
1808 1808  
1809 1809  No downlink commands for feature
1810 1810  
1811 1811  
1812 -=== 3.9 Clear Flash Record(Since v1.3.0) ===
1658 +=== 3.9 Clear Flash Record ===
1813 1813  
1814 1814  
1815 1815  Feature: Clear flash storage for data log feature.
... ... @@ -1828,127 +1828,7 @@
1828 1828  
1829 1829  * Example: 0xA301  ~/~/  Same as AT+CLRDTA
1830 1830  
1831 -== 3.10 SDI12 timing(Since v1.3.0) ==
1832 1832  
1833 -
1834 -Feature: Get or set the time of SDI12 timing.
1835 -
1836 -[[image:1747289896656-580.png||height="414" width="566"]]
1837 -
1838 -
1839 -(% style="color:#4f81bd" %)**AT Command: AT+SDITIMING**
1840 -
1841 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1842 -|(% 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**
1843 -|(% style="width:155px" %)(((
1844 -AT+SDITIMING=13,9
1845 -
1846 -
1847 -)))|(% style="width:167px" %)Get or set the time of SDI12 timing|(% style="width:177px" %)(((
1848 -OK
1849 -
1850 -Default: 13,9
1851 -)))
1852 -
1853 -(% style="color:#4f81bd" %)**Downlink Command: 0xA9**
1854 -
1855 -* Example: 0xA90D09  ~/~/  Same as AT+SDITIMING=13,9
1856 -
1857 -== 3.11 add Pulse_count, VDC_input, IDC_input(Since firmware V1.3.0) ==
1858 -
1859 -
1860 -(% style="color:blue" %)**Setting up external sensors:**
1861 -
1862 -* (% style="color:#037691" %)**AT Command:**
1863 -
1864 -(% style="color:#4472c4" %)**AT+EXT=a,b,c**(%%)
1865 -
1866 -(% style="color:#4472c4" %)**a:**(%%)  **0:** Disable Counting function ( doesn't effect interrupt ).  **1:** Enable Counting function(4 bytes).
1867 -(% style="color:#4472c4" %)**b: **(%%) **0:** Disable voltage acquisition function.  **1:** Enable voltage acquisition function(2 bytes)
1868 -(% style="color:#4472c4" %)**c:**(%%)  **0:** Disable current acquisition  function.  **1:** Enable current acquisition function(2 bytes).
1869 -
1870 -**Example:**
1871 -
1872 -(% style="color:#4472c4" %)**AT+EXT=1,1,1**
1873 -
1874 -Device will add counting, voltage and current acquisition function.
1875 -
1876 -The payload will be:
1877 -Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting + ** ***VDC_INPUT**  + ***IDC_INPUT**  + Length depends on the return from the commands
1878 -
1879 -(% style="color:#4472c4" %)**AT+EXT=1,0,0**
1880 -
1881 -Device will add counting support.
1882 -
1883 -The payload will be:
1884 -Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting** + Length depends on the return from the commands
1885 -
1886 -* (% style="color:#037691" %)**Downlink Command: 0x0B aa bb cc**
1887 -
1888 -Format: Command Code (0x0B) followed by 3 bytes.
1889 -
1890 -(% style="color:#037691" %)**aa:**(%%) Set Disable or Enable Counting Support.   **00**: Disable, **01**: Enable.
1891 -
1892 -(% style="color:#037691" %)**bb:**(%%) Set Disable or Enable voltage acquisition.  **00**: Disable, **01**: Enable.
1893 -
1894 -(% style="color:#037691" %)**cc:**(%%) Set Disable or Enable current acquisition.  **00**: Disable, **01**: Enable.
1895 -
1896 -**Example:**
1897 -
1898 -Downlink payload:  0B 00 00 01  ~/~/AT+EXT=0,0,1  Enable current acquisition
1899 -
1900 -Downlink payload:  0B 01 00 01  ~/~/AT+EXT=1,0,1  Enable Counting Support and Current acquisition                        
1901 -
1902 -
1903 -(% style="color:blue" %)**Set the pulse count value:**
1904 -
1905 -* (% style="color:#037691" %)**AT Command:**
1906 -
1907 -(% style="color:#4472c4" %)**AT+SETCNT=aa     **(%%)~/~/ Set the pulse count value.
1908 -
1909 -**Example:**
1910 -
1911 -AT+SETCNT=100  (% style="display:none" %) (%%)~/~/ Set the pulse count to 100.(% style="display:none" %)
1912 -
1913 -* (% style="color:#037691" %)**Downlink Command: 0x0C**
1914 -
1915 -Format: Command Code (0x0C) followed by 4 bytes.
1916 -
1917 -**Example:**
1918 -
1919 -Downlink Payload: 0C 00 00 00 64  ~/~/ AT+SETCNT=100
1920 -
1921 -
1922 -(% style="color:blue" %)**Connect counting sensor:**
1923 -
1924 -The counting sensor cables are connected to the **3V3 pin** and **GPIO_EXTI** pin of the **SIB v1.3** motherboard.
1925 -
1926 -[[image:image-20250519110640-1.jpeg||height="318" width="708"]]
1927 -
1928 -
1929 -(% id="cke_bm_1699404S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Connect Voltage output sensor:**
1930 -
1931 -Example:
1932 -
1933 -**RED <~-~-~-~-> VDC_INPUT**
1934 -
1935 -**BLACK <~-~-~-~-~-~-> GND**
1936 -
1937 -[[image:image-20250519111415-3.jpeg||height="338" width="710"]]
1938 -
1939 -
1940 -(% style="color:blue" %)**Connect Current output sensor:**
1941 -
1942 -Example:
1943 -
1944 -**RED <~-~-~-~-~-~-~-~--> IDC_INPUT**
1945 -
1946 -**BLACK <~-~-~-~-~-~-> GND**
1947 -
1948 -[[image:image-20250519111732-4.jpeg||height="373" width="708"]]
1949 -
1950 -
1951 -
1952 1952  = 4. Battery & Power Consumption =
1953 1953  
1954 1954  
1747289896656-580.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -37.0 KB
Content
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