Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 144.1
edited by Mengting Qiu
on 2025/05/14 20:00
Change comment: There is no comment for this version
To version 149.3
edited by Mengting Qiu
on 2025/05/16 09:55
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,31 @@
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 +
657 657  == 2.4 Uplink Payload ==
658 658  
659 659  === 2.4.1 Device Payload, FPORT~=5 ===
... ... @@ -1247,9 +1247,9 @@
1247 1247  
1248 1248  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.
1249 1249  
1250 -For example, downlink command (% _mstmutation="1" %)**31 67E24660 67E26280 05**(%%)
1275 +For example, downlink command (% _mstmutation="1" %)**31 68253B6E 68253E23 05**(%%)
1251 1251  
1252 -Is to check 2025/03/25 06:00:00 to 2025/03/25 08:00:00's data
1277 +Is to check 2025/05/15 00:55:10 to 2025/05/15 01:06:43's data
1253 1253  
1254 1254  Uplink Internal =5s, means SDI-12-LB will send one packet every 5s.
1255 1255  
... ... @@ -1312,31 +1312,31 @@
1312 1312  2025/3/25 08:16:30
1313 1313  )))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
1314 1314  
1315 -If user sends below downlink command: (% style="background-color:yellow" %)3167E264BA67E2665E05
1340 +If user sends below downlink command: (% style="background-color:yellow" %)3168253B6E68253E2305
1316 1316  
1317 -Where : Start time: 67E264BA = time 2025/3/25 08:09:30
1342 +Where : Start time: (% _mstmutation="1" %)68253B6E (%%)= time 2025/05/15 00:55:10
1318 1318  
1319 - Stop time: 67E2665E= time 2025/3/25 08:16:30
1344 + Stop time: (% _mstmutation="1" %)68253E23 (%%)= time 2025/05/15 01:06:43
1320 1320  
1321 1321  
1322 1322  **SDI-12-LB will uplink this payload.**
1323 1323  
1324 -**67E264BA 05 0CA8 01 0821** 67E264F6050CAE01082267E26532050CAE01082267E2656E050CAE01082267E265AA050CB401082367E265E6050CAE01082267E26622050CB401082367E2665E050CAE010822
1349 +**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A **68253C5D120C7801F10D302B312E31372B32372E340D0A68253D33120C7201F10D302B312E31352B32382E390D0A68253DAB120C7201F10D302B312E31342B32392E340D0A68253E23120C7201F10D302B312E31332B33302E300D0A
1325 1325  
1326 1326  
1327 -Where the first 10 bytes is for the first entry:
1352 +Where the first 23 bytes is for the first entry:
1328 1328  
1329 -67E264BA050CA8010821
1354 +**68253B6E 12 0C7801F10D302B312E31372B32362E390D0A**
1330 1330  
1331 -Unix Time Stamp: 67E264BA(H)=1742890170(D)  ~-~->  time=2025-03-25 8:09:30
1356 +Unix Time Stamp: 68253B6E(H)=1747270510(D)  ~-~->  time=2025-05-15 8:55:00
1332 1332  
1333 -Payload Length: 0x05(H)=5 bytes
1358 +Payload Length: 0x12(H)=18 bytes
1334 1334  
1335 -Battery voltage: 0x0CA8(H)=3240 mV
1360 +Battery voltage: 0x0C78(H)=3192 mV
1336 1336  
1337 1337  Payload Version:  01
1338 1338  
1339 -Value: For the distance sensor used for testing, this value is the mm distance value, 0x0821(H)=2081mm.
1364 +Value: For the distance sensor used for testing, this value is the mm distance value, 0xF10D302B312E31372B32362E390D0A(H)
1340 1340  
1341 1341  
1342 1342  
... ... @@ -1575,6 +1575,131 @@
1575 1575  * Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1576 1576  * Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1577 1577  
1603 +=== 3.7 Print data entries base on page(Since v1.3.0) ===
1604 +
1605 +
1606 +Feature: Print the sector data from start page to stop page (max is 416 pages).
1607 +
1608 +(% style="color:#4f81bd" %)**AT Command: AT+PDTA**
1609 +
1610 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1611 +|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1612 +|(% style="width:156px" %)(((
1613 +AT+PDTA=1,2
1614 +Print page 1 to 2
1615 +)))|(% style="width:311px" %)(((
1616 +Stop Tx and RTP events when read sensor data
1617 +
1618 +8033330 2025/5/14 12:27:32 18 0c 84 01 f1 0d 30 2b 31 2e 30
1619 +
1620 +8033340 38 2b 32 34 2e 36 0d 0a
1621 +
1622 +8033350 2025/5/14 12:29:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1623 +
1624 +8033360 38 2b 32 34 2e 36 0d 0a
1625 +
1626 +8033370 2025/5/14 12:31:32 18 0c 78 01 f1 0d 30 2b 31 2e 30
1627 +
1628 +8033380 38 2b 32 34 2e 36 0d 0a
1629 +
1630 +8033390 2025/5/14 12:33:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1631 +
1632 +80333A0 38 2b 32 34 2e 36 0d 0a
1633 +
1634 +80333B0 2025/5/14 12:35:32 18 0c 72 01 f1 0d 30 2b 31 2e 30
1635 +
1636 +80333C0 38 2b 32 34 2e 36 0d 0a
1637 +
1638 +
1639 +OK
1640 +)))
1641 +
1642 +(% style="color:#4f81bd" %)**Downlink Command:**
1643 +
1644 +No downlink commands for feature
1645 +
1646 +
1647 +=== 3.8 Print last few data entries(Since v1.3.0) ===
1648 +
1649 +
1650 +Feature: Print the last few data entries
1651 +
1652 +(% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
1653 +
1654 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1655 +|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**
1656 +|(% style="width:156px" %)(((
1657 +AT+PLDTA=10
1658 +Print last 10 entries
1659 +)))|(% style="width:311px" %)(((
1660 +Stop Tx events when read sensor data
1661 +
1662 +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
1663 +
1664 +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
1665 +
1666 +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
1667 +
1668 +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
1669 +
1670 +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
1671 +
1672 +Start Tx events
1673 +
1674 +OK
1675 +)))
1676 +
1677 +(% style="color:#4f81bd" %)**Downlink Command:**
1678 +
1679 +No downlink commands for feature
1680 +
1681 +
1682 +=== 3.9 Clear Flash Record(Since v1.3.0) ===
1683 +
1684 +
1685 +Feature: Clear flash storage for data log feature.
1686 +
1687 +(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**
1688 +
1689 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1690 +|(% 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**
1691 +|(% style="width:155px" %)AT+CLRDTA |(% style="width:134px" %)Clear date record|(% style="width:209px" %)(((
1692 +Clear all stored sensor data…
1693 +
1694 +OK
1695 +)))
1696 +
1697 +(% style="color:#4f81bd" %)**Downlink Command: 0xA3**
1698 +
1699 +* Example: 0xA301  ~/~/  Same as AT+CLRDTA
1700 +
1701 +
1702 +
1703 +== 3.10 SDI12 timing(Since v1.3.0) ==
1704 +
1705 +
1706 +Feature: Get or set the time of SDI12 timing.
1707 +
1708 +[[image:1747289896656-580.png||height="414" width="566"]]
1709 +
1710 +(% style="color:#4f81bd" %)**AT Command: AT+SDITIMING**
1711 +
1712 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:503px" %)
1713 +|(% 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**
1714 +|(% style="width:155px" %)(((
1715 +AT+SDITIMING=13,9
1716 +
1717 +
1718 +)))|(% style="width:167px" %)Get or set the time of SDI12 timing|(% style="width:177px" %)(((
1719 +OK
1720 +
1721 +Default: 13,9
1722 +)))
1723 +
1724 +(% style="color:#4f81bd" %)**Downlink Command: 0xA9**
1725 +
1726 +* Example: 0xA90D09  ~/~/  Same as AT+SDITIMING=13,9
1727 +
1578 1578  = 4. Battery & Power Consumption =
1579 1579  
1580 1580  
1747289896656-580.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +37.0 KB
Content