Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 155.2
edited by Mengting Qiu
on 2025/05/16 14:58
Change comment: There is no comment for this version
To version 144.1
edited by Mengting Qiu
on 2025/05/14 20:00
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,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!//. (% 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 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,65 +654,6 @@
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 -
716 716  == 2.4 Uplink Payload ==
717 717  
718 718  === 2.4.1 Device Payload, FPORT~=5 ===
... ... @@ -1306,9 +1306,9 @@
1306 1306  
1307 1307  Timestamp start and Timestamp end use Unix TimeStamp format as mentioned above. Devices will reply with all data log during this time period, use the uplink interval.
1308 1308  
1309 -For example, downlink command (% _mstmutation="1" %)**31 68253B6E 68253E23 05**(%%)
1250 +For example, downlink command (% _mstmutation="1" %)**31 67E24660 67E26280 05**(%%)
1310 1310  
1311 -Is to check 2025/05/15 00:55:10 to 2025/05/15 01:06:43's data
1252 +Is to check 2025/03/25 06:00:00 to 2025/03/25 08:00:00's data
1312 1312  
1313 1313  Uplink Internal =5s, means SDI-12-LB will send one packet every 5s.
1314 1314  
... ... @@ -1371,31 +1371,31 @@
1371 1371  2025/3/25 08:16:30
1372 1372  )))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
1373 1373  
1374 -If user sends below downlink command: (% style="background-color:yellow" %)3168253B6E68253E2305
1315 +If user sends below downlink command: (% style="background-color:yellow" %)3167E264BA67E2665E05
1375 1375  
1376 -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
1377 1377  
1378 - Stop time: (% _mstmutation="1" %)68253E23 (%%)= time 2025/05/15 01:06:43
1319 + Stop time: 67E2665E= time 2025/3/25 08:16:30
1379 1379  
1380 1380  
1381 1381  **SDI-12-LB will uplink this payload.**
1382 1382  
1383 -**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A **68253C5D120C7801F10D302B312E31372B32372E340D0A68253D33120C7201F10D302B312E31352B32382E390D0A68253DAB120C7201F10D302B312E31342B32392E340D0A68253E23120C7201F10D302B312E31332B33302E300D0A
1324 +**67E264BA 05 0CA8 01 0821** 67E264F6050CAE01082267E26532050CAE01082267E2656E050CAE01082267E265AA050CB401082367E265E6050CAE01082267E26622050CB401082367E2665E050CAE010822
1384 1384  
1385 1385  
1386 -Where the first 23 bytes is for the first entry:
1327 +Where the first 10 bytes is for the first entry:
1387 1387  
1388 -**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A**
1329 +67E264BA050CA8010821
1389 1389  
1390 -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
1391 1391  
1392 -Payload Length: 0x12(H)=18 bytes
1333 +Payload Length: 0x05(H)=5 bytes
1393 1393  
1394 -Battery voltage: 0x0C78(H)=3192 mV
1335 +Battery voltage: 0x0CA8(H)=3240 mV
1395 1395  
1396 1396  Payload Version:  01
1397 1397  
1398 -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.
1399 1399  
1400 1400  
1401 1401  
... ... @@ -1634,130 +1634,6 @@
1634 1634  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1635 1635  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1636 1636  
1637 -=== 3.7 Print data entries base on page(Since v1.3.0) ===
1638 -
1639 -
1640 -Feature: Print the sector data from start page to stop page (max is 416 pages).
1641 -
1642 -(% style="color:#4f81bd" %)**AT Command: AT+PDTA**
1643 -
1644 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1645 -|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1646 -|(% style="width:156px" %)(((
1647 -AT+PDTA=1,2
1648 -Print page 1 to 2
1649 -)))|(% style="width:311px" %)(((
1650 -Stop Tx and RTP events when read sensor data
1651 -
1652 -8033330 2025/5/14 12:27:32 18 0c 84 01 f1 0d 30 2b 31 2e 30
1653 -
1654 -8033340 38 2b 32 34 2e 36 0d 0a
1655 -
1656 -8033350 2025/5/14 12:29:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1657 -
1658 -8033360 38 2b 32 34 2e 36 0d 0a
1659 -
1660 -8033370 2025/5/14 12:31:32 18 0c 78 01 f1 0d 30 2b 31 2e 30
1661 -
1662 -8033380 38 2b 32 34 2e 36 0d 0a
1663 -
1664 -8033390 2025/5/14 12:33:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1665 -
1666 -80333A0 38 2b 32 34 2e 36 0d 0a
1667 -
1668 -80333B0 2025/5/14 12:35:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1669 -
1670 -80333C0 38 2b 32 34 2e 36 0d 0a
1671 -
1672 -
1673 -OK
1674 -)))
1675 -
1676 -(% style="color:#4f81bd" %)**Downlink Command:**
1677 -
1678 -No downlink commands for feature
1679 -
1680 -
1681 -=== 3.8 Print last few data entries(Since v1.3.0) ===
1682 -
1683 -
1684 -Feature: Print the last few data entries
1685 -
1686 -(% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1687 -
1688 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1689 -|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1690 -|(% style="width:156px" %)(((
1691 -AT+PLDTA=10
1692 -Print last 10 entries
1693 -)))|(% style="width:311px" %)(((
1694 -Stop Tx events when read sensor data
1695 -
1696 -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
1697 -
1698 -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
1699 -
1700 -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
1701 -
1702 -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
1703 -
1704 -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
1705 -
1706 -Start Tx events
1707 -
1708 -OK
1709 -)))
1710 -
1711 -(% style="color:#4f81bd" %)**Downlink Command:**
1712 -
1713 -No downlink commands for feature
1714 -
1715 -
1716 -=== 3.9 Clear Flash Record(Since v1.3.0) ===
1717 -
1718 -
1719 -Feature: Clear flash storage for data log feature.
1720 -
1721 -(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**
1722 -
1723 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1724 -|(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:137px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:209px" %)**Response**
1725 -|(% style="width:155px" %)AT+CLRDTA |(% style="width:134px" %)Clear date record|(% style="width:209px" %)(((
1726 -Clear all stored sensor data…
1727 -
1728 -OK
1729 -)))
1730 -
1731 -(% style="color:#4f81bd" %)**Downlink Command: 0xA3**
1732 -
1733 -* Example: 0xA301  ~/~/  Same as AT+CLRDTA
1734 -
1735 -
1736 -== 3.10 SDI12 timing(Since v1.3.0) ==
1737 -
1738 -
1739 -Feature: Get or set the time of SDI12 timing.
1740 -
1741 -[[image:1747289896656-580.png||height="414" width="566"]]
1742 -
1743 -(% style="color:#4f81bd" %)**AT Command: AT+SDITIMING**
1744 -
1745 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1746 -|(% 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**
1747 -|(% style="width:155px" %)(((
1748 -AT+SDITIMING=13,9
1749 -
1750 -
1751 -)))|(% style="width:167px" %)Get or set the time of SDI12 timing|(% style="width:177px" %)(((
1752 -OK
1753 -
1754 -Default: 13,9
1755 -)))
1756 -
1757 -(% style="color:#4f81bd" %)**Downlink Command: 0xA9**
1758 -
1759 -* Example: 0xA90D09  ~/~/  Same as AT+SDITIMING=13,9
1760 -
1761 1761  = 4. Battery & Power Consumption =
1762 1762  
1763 1763  
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