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 155.3
edited by Mengting Qiu
on 2025/05/16 15:14
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 ===
... ... @@ -1626,29 +1626,85 @@
1626 1626  
1627 1627  (% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1628 1628  
1688 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
1689 +|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px;background-color:#4F81BD;color:white" %)**Function**
1690 +|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,0|(% style="background-color:#f2f2f2; width:192px" %)Printing the last ten data in hex format
1691 +|(% style="background-color:#f2f2f2; width:158px" %)AT+PLDTA=10,1|(% style="background-color:#f2f2f2; width:192px" %)Print the last ten data in string format
1692 +
1693 +* Prints in hex format:
1694 +
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
1698 +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
1703 +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
1705 +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
1707 +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
1709 +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
1711 +0005-0005 2025/5/16 06:56:04 7 0c 7e 01 00 5f 01 07
1646 1646  
1713 +0006-0006 2025/5/16 06:58:04 7 0c 8a 01 00 60 01 07
1714 +
1715 +0007-0007 2025/5/16 07:00:04 7 0c 84 01 00 61 01 07
1716 +
1717 +0008-0008 2025/5/16 07:02:04 7 0c 72 01 00 61 01 07
1718 +
1719 +0009-0009 2025/5/16 07:04:04 7 0c 78 01 00 61 01 07
1720 +
1721 +0010-0010 2025/5/16 07:06:04 7 0c 78 01 00 61 01 07
1722 +
1647 1647  Start Tx events
1648 1648  
1649 1649  OK
1650 1650  )))
1651 1651  
1728 +* **Printing in String Format:**
1729 +
1730 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1731 +|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1732 +|(% style="width:156px" %)(((
1733 +AT+PLDTA=10,1
1734 +Print last 10 entries
1735 +
1736 +(((
1737 +(Printing in String Format)
1738 +)))
1739 +)))|(% style="width:311px" %)(((
1740 +Stop Tx events when read sensor data
1741 +
1742 +0001-0001 2025/5/16 06:48:04 7 ~~_
1743 +
1744 +0002-0002 2025/5/16 06:50:04 7 r_
1745 +
1746 +0003-0003 2025/5/16 06:52:04 7 r_
1747 +
1748 +0004-0004 2025/5/16 06:54:04 7 ~~_
1749 +
1750 +0005-0005 2025/5/16 06:56:04 7 ~~_
1751 +
1752 +0006-0006 2025/5/16 06:58:04 7 `
1753 +
1754 +0007-0007 2025/5/16 07:00:04 7 a
1755 +
1756 +0008-0008 2025/5/16 07:02:04 7 ra
1757 +
1758 +0009-0009 2025/5/16 07:04:04 7 xa
1759 +
1760 +0010-0010 2025/5/16 07:06:04 7 xa
1761 +
1762 +Start Tx events
1763 +
1764 +OK
1765 +)))
1766 +
1652 1652  (% style="color:#4f81bd" %)**Downlink Command:**
1653 1653  
1654 1654  No downlink commands for feature
... ... @@ -1674,8 +1674,6 @@
1674 1674  * Example: 0xA301  ~/~/  Same as AT+CLRDTA
1675 1675  
1676 1676  
1677 -
1678 -
1679 1679  == 3.10 SDI12 timing(Since v1.3.0) ==
1680 1680  
1681 1681  
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