Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 149.2
edited by Mengting Qiu
on 2025/05/15 15:39
Change comment: There is no comment for this version
To version 159.2
edited by Mengting Qiu
on 2025/05/19 11:07
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
501 +AT+COMMANDx & AT+DATACUTx**&AT+DATACONVx**
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,7 +511,7 @@
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!//.
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)**
515 515  
516 516  (% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB/LS will resend this command. Max 3 retries.
517 517  
... ... @@ -654,6 +654,65 @@
654 654  (% 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.**
655 655  
656 656  
657 +
658 +(% style="color:blue" %)**Automatically converts polled data to hex format for uplinking(Since v1.3.0)**
659 +
660 +
661 +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.
662 +
663 +
664 +* (% style="color:blue" %)**AT Command:**
665 +
666 +The maximum number can be set to 5 groups and the format of the command is as follows：
667 +
668 +(% style="color:#037691" %)**Example 1:AT+DATACONVx=var1, var2**
669 +
670 +(% style="color:#037691" %)**Example 2:AT+DATACONVx=var1, var2+ var3, var4**
671 +
672 +(% style="color:#037691" %)**Example 3:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6**
673 +
674 +(% style="color:#037691" %)**Example 4:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8**
675 +
676 +(% style="color:#037691" %)**Example 5:AT+DATACONVx=var1, var2+ var3, var4+ var5, var6+ var7, var8+ var9, var10**
677 +
678 +(% 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.**
679 +
680 +
681 +**For example:**
682 +
683 +This is my configuration:
684 +
685 +[[image:image-20250516103205-2.png]]
686 +
687 +
688 +* 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.
689 +* 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)
690 +* AT+COMMAND3=0D0!,0,0,0  Query the data measured by device 0
691 +
692 +This is the data obtained:
693 +
694 +[[image:image-20250516145402-2.png]]
695 +
696 +
697 +When using the AT+DATACONVx command,
698 +
699 +The data of RETURN3 will be converted into 2 data, the first data is +95, and the second data is +260.
700 +
701 +* 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:
702 +
703 +[[image:image-20250516144559-1.png]]
704 +
705 +0C90 01 005F 0104
706 +
707 +(% style="color:#037691" %)**BAT**(%%): 0x0c90 = 3216mV = 3.216V
708 +
709 +(% style="color:#037691" %)**Payload Version**(%%): 0x01, Means: v1.0 version
710 +
711 +(% style="color:#037691" %)**Data 1: **(%%)0x005F(H) = 95(D) / 100 = 0.95
712 +
713 +(% style="color:#037691" %)**Data 2: **(%%)0x0104(H) = 260(D) / 10 = 26.0
714 +
715 +
657 657  == 2.4 Uplink Payload ==
658 658  
659 659  === 2.4.1 Device Payload, FPORT~=5 ===
... ... @@ -1575,9 +1575,10 @@
1575 1575  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1576 1576  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1577 1577  
1578 -=== 3.7 Print data entries base on page(Since v1.3.0) ===
1579 1579  
1638 +== 3.7 Print data entries base on page(Since v1.3.0) ==
1580 1580  
1640 +
1581 1581  Feature: Print the sector data from start page to stop page (max is 416 pages).
1582 1582  
1583 1583  (% style="color:#4f81bd" %)**AT Command: AT+PDTA**
... ... @@ -1619,7 +1619,7 @@
1619 1619  No downlink commands for feature
1620 1620  
1621 1621  
1622 -=== 3.8 Print last few data entries(Since v1.3.0) ===
1682 +== 3.8 Print last few data entries(Since v1.3.0) ==
1623 1623  
1624 1624  
1625 1625  Feature: Print the last few data entries
... ... @@ -1626,29 +1626,85 @@
1626 1626  
1627 1627  (% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1628 1628  
1689 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
1690 +|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px;background-color:#4F81BD;color:white" %)**Function**
1691 +|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,0|(% style="background-color:#f2f2f2; width:192px" %)Printing the last ten data in hex format
1692 +|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,1|(% style="background-color:#f2f2f2; width:192px" %)Print the last ten data in string format
1693 +
1694 +* **Prints in hex format:**
1695 +
1629 1629  (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1630 1630  |(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1631 1631  |(% style="width:156px" %)(((
1632 -AT+PLDTA=10
1699 +AT+PLDTA=10,0
1633 1633  Print last 10 entries
1634 1634  )))|(% style="width:311px" %)(((
1635 1635  Stop Tx events when read sensor data
1636 1636  
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
1704 +0001-0001 2025/5/16 06:48:04 7 0c 7e 01 00 5f 01 05
1638 1638  
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
1706 +0002-0002 2025/5/16 06:50:04 7 0c 72 01 00 5f 01 05
1640 1640  
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
1708 +0003-0003 2025/5/16 06:52:04 7 0c 72 01 00 5f 01 05
1642 1642  
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
1710 +0004-0004 2025/5/16 06:54:04 7 0c 7e 01 00 5f 01 05
1644 1644  
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
1712 +0005-0005 2025/5/16 06:56:04 7 0c 7e 01 00 5f 01 07
1646 1646  
1714 +0006-0006 2025/5/16 06:58:04 7 0c 8a 01 00 60 01 07
1715 +
1716 +0007-0007 2025/5/16 07:00:04 7 0c 84 01 00 61 01 07
1717 +
1718 +0008-0008 2025/5/16 07:02:04 7 0c 72 01 00 61 01 07
1719 +
1720 +0009-0009 2025/5/16 07:04:04 7 0c 78 01 00 61 01 07
1721 +
1722 +0010-0010 2025/5/16 07:06:04 7 0c 78 01 00 61 01 07
1723 +
1647 1647  Start Tx events
1648 1648  
1649 1649  OK
1650 1650  )))
1651 1651  
1729 +* **Printing in String Format:**
1730 +
1731 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1732 +|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1733 +|(% style="width:156px" %)(((
1734 +AT+PLDTA=10,1
1735 +Print last 10 entries
1736 +
1737 +(((
1738 +(Printing in String Format)
1739 +)))
1740 +)))|(% style="width:311px" %)(((
1741 +Stop Tx events when read sensor data
1742 +
1743 +0001-0001 2025/5/16 06:48:04 7 ~~_
1744 +
1745 +0002-0002 2025/5/16 06:50:04 7 r_
1746 +
1747 +0003-0003 2025/5/16 06:52:04 7 r_
1748 +
1749 +0004-0004 2025/5/16 06:54:04 7 ~~_
1750 +
1751 +0005-0005 2025/5/16 06:56:04 7 ~~_
1752 +
1753 +0006-0006 2025/5/16 06:58:04 7 `
1754 +
1755 +0007-0007 2025/5/16 07:00:04 7 a
1756 +
1757 +0008-0008 2025/5/16 07:02:04 7 ra
1758 +
1759 +0009-0009 2025/5/16 07:04:04 7 xa
1760 +
1761 +0010-0010 2025/5/16 07:06:04 7 xa
1762 +
1763 +Start Tx events
1764 +
1765 +OK
1766 +)))
1767 +
1652 1652  (% style="color:#4f81bd" %)**Downlink Command:**
1653 1653  
1654 1654  No downlink commands for feature
... ... @@ -1673,9 +1673,6 @@
1673 1673  
1674 1674  * Example: 0xA301  ~/~/  Same as AT+CLRDTA
1675 1675  
1676 -
1677 -
1678 -
1679 1679  == 3.10 SDI12 timing(Since v1.3.0) ==
1680 1680  
1681 1681  
... ... @@ -1683,6 +1683,7 @@
1683 1683  
1684 1684  [[image:1747289896656-580.png||height="414" width="566"]]
1685 1685  
1799 +
1686 1686  (% style="color:#4f81bd" %)**AT Command: AT+SDITIMING**
1687 1687  
1688 1688  (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
... ... @@ -1701,6 +1701,102 @@
1701 1701  
1702 1702  * Example: 0xA90D09  ~/~/  Same as AT+SDITIMING=13,9
1703 1703  
1818 +== 3.11 add Pulse_count, VDC_input, IDC_input(Since firmware V1.3.0) ==
1819 +
1820 +
1821 +(% style="color:blue" %)**Setting up external sensors:**
1822 +
1823 +* (% style="color:#037691" %)**AT Command:**
1824 +
1825 +(% style="color:#4472c4" %)**AT+EXT=a,b,c**(%%)
1826 +
1827 +(% style="color:#4472c4" %)**a:**(%%)  **0:** Disable Counting function ( doesn't effect interrupt ).  **1:** Enable Counting function(4 bytes).
1828 +(% style="color:#4472c4" %)**b: **(%%) **0:** Disable voltage acquisition function.  **1:** Enable voltage acquisition function(2 bytes)
1829 +(% style="color:#4472c4" %)**c:**(%%)  **0:** Disable current acquisition  function.  **1:** Enable current acquisition function(2 bytes).
1830 +
1831 +**Example:**
1832 +
1833 +(% style="color:#4472c4" %)**AT+EXT=1,1,1**
1834 +
1835 +Device will add counting, voltage and current acquisition function.
1836 +
1837 +The payload will be:
1838 +Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting + ** ***VDC_INPUT**  + ***IDC_INPUT**  + Length depends on the return from the commands
1839 +
1840 +(% style="color:#4472c4" %)**AT+EXT=1,0,0**
1841 +
1842 +Device will add counting support.
1843 +
1844 +The payload will be:
1845 +Battery(mV) & Interrupt _Flag + PAYLOAD_VER + ***counting** + Length depends on the return from the commands
1846 +
1847 +* (% style="color:#037691" %)**Downlink Command: 0x0B aa bb cc**
1848 +
1849 +Format: Command Code (0x0B) followed by 3 bytes.
1850 +
1851 +(% style="color:#037691" %)**aa:**(%%) Set Disable or Enable Counting Support.   **00**: Disable, **01**: Enable.
1852 +
1853 +(% style="color:#037691" %)**bb:**(%%) Set Disable or Enable voltage acquisition.  **00**: Disable, **01**: Enable.
1854 +
1855 +(% style="color:#037691" %)**cc:**(%%) Set Disable or Enable current acquisition.  **00**: Disable, **01**: Enable.
1856 +
1857 +**Example:**
1858 +
1859 +Downlink payload:  0B 00 00 01  ~/~/AT+EXT=0,0,1  Enable current acquisition
1860 +
1861 +Downlink payload:  0B 01 00 01  ~/~/AT+EXT=1,0,1  Enable Counting Support and Current acquisition                        
1862 +
1863 +
1864 +(% style="color:blue" %)**Set the pulse count value:**
1865 +
1866 +* (% style="color:#037691" %)**AT Command:**
1867 +
1868 +(% style="color:#4472c4" %)**AT+SETCNT=aa     **(%%)~/~/ Set the pulse count value.
1869 +
1870 +**Example:**
1871 +
1872 +AT+SETCNT=100  (% style="display:none" %) (%%)~/~/ Set the pulse count to 100.(% style="display:none" %)
1873 +
1874 +* (% style="color:#037691" %)**Downlink Command: 0x0C**
1875 +
1876 +Format: Command Code (0x0C) followed by 4 bytes.
1877 +
1878 +**Example:**
1879 +
1880 +Downlink Payload: 0C 00 00 00 64  ~/~/ AT+SETCNT=100
1881 +
1882 +
1883 +(% style="color:blue" %)**Connect counting sensor:**
1884 +
1885 +The counting sensor cables are connected to the **3V3 pin** and **GPIO_EXTI** pin of the **SIB v1.3** motherboard.
1886 +
1887 +[[image:image-20250519110640-1.jpeg||height="318" width="708"]]
1888 +
1889 +
1890 +(% id="cke_bm_1699404S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Connect Voltage output sensor:**
1891 +
1892 +Example:
1893 +
1894 +**RED <~-~-~-~-> VDC_INPUT**
1895 +
1896 +**BLACK <~-~-~-~-~-~-> GND**
1897 +
1898 +[[image:image-20241223101841-3.jpeg||height="417" width="666"]]
1899 +
1900 +
1901 +(% style="color:blue" %)**Connect Current output sensor:**
1902 +
1903 +Example:
1904 +
1905 +**RED <~-~-~-~-~-~-~-~--> IDC_INPUT**
1906 +
1907 +**BLACK <~-~-~-~-~-~-> GND**
1908 +
1909 +[[image:image-20241223100438-2.jpeg||height="440" width="672"]]
1910 +
1911 +
1912 +
1913 +
1704 1704  = 4. Battery & Power Consumption =
1705 1705  
1706 1706  
image-20250516100849-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +37.2 KB
Content
image-20250516103205-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +37.3 KB
Content
image-20250516103652-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +14.5 KB
Content
image-20250516144559-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +55.1 KB
Content
image-20250516145402-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +9.6 KB
Content
image-20250519110640-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +230.2 KB
Content