<
From version < 102.1 >
edited by Mengting Qiu
on 2025/01/16 15:28
To version < 117.1 >
edited by Mengting Qiu
on 2025/01/20 16:09
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -626,32 +626,139 @@
626 626  
627 627  === 2.6.3 Poll sensor value ===
628 628  
629 -
630 630  Users can poll sensor values based on timestamps. Below is the downlink command.
631 631  
632 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
633 -|=(% colspan="4" style="width: 154px;background-color:#4F81BD;color:white" %)**Downlink Command to poll Open/Close status (0x31)**
634 -|(% style="background-color:#f2f2f2; width:70px" %)**1byte**|(% style="background-color:#f2f2f2; width:140px" %)**4bytes**|(% style="background-color:#f2f2f2; width:140px" %)(((
631 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:470px" %)
632 +|=(% colspan="4" style="width: 160px; background-color:#4F81BD;color:white" %)**Downlink Command to poll Open/Close status (0x31)**
633 +|(% style="background-color:#f2f2f2; width:67px" %)**1byte**|(% style="background-color:#f2f2f2; width:145px" %)**4bytes**|(% style="background-color:#f2f2f2; width:133px" %)**4bytes**|(% style="background-color:#f2f2f2; width:163px" %)**1byte**
634 +|(% style="background-color:#f2f2f2; width:67px" %)31|(% style="background-color:#f2f2f2; width:145px" %)Timestamp start|(% style="background-color:#f2f2f2; width:133px" %)(((
635 +Timestamp end
636 +)))|(% style="background-color:#f2f2f2; width:163px" %)Uplink Interval
637 +
638 +Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
639 +
640 +For example, downlink command[[image:image-20250117104812-1.png]]
641 +
642 +Is to check 2024/12/20 09:34:59 to 2024/12/20 14:34:59's data
643 +
644 +Uplink Internal =5s,means PS-LB will send one packet every 5s. range 5~~255s.
645 +
646 +
647 +=== 2.6.4 Datalog Uplink payload (FPORT~=3) ===
648 +
649 +
650 +The Datalog uplinks will use below payload format.
651 +
652 +**Retrieval data payload:**
653 +
654 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
655 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
656 +**Size(bytes)**
657 +)))|=(% style="width: 40px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 55px; background-color:#4F81BD;color:white" %)**2**|=(% style="width: 83px; background-color: rgb(79, 129, 189); color: white;" %)**2**|=(% style="width: 201px; background-color: rgb(79, 129, 189); color: white;" %)**1**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**4**
658 +|(% style="width:103px" %)Value|(% style="width:68px" %)(((
659 +Probe
660 +
661 +_mod
662 +)))|(% style="width:104px" %)(((
663 +VDC
664 +
665 +_intput_V
666 +)))|(% style="width:83px" %)(((
667 +IDC
668 +
669 +_intput_mA
670 +)))|(% style="width:201px" %)(((
671 +IN1_pin_level& IN2_pin_level& Exti_pin_level&Exti_status
672 +)))|(% style="width:86px" %)Unix Time Stamp
673 +
674 +**IN1_pin_level & IN2_pin_level & Exti_pin_level & Exti_status:**
675 +
676 +[[image:image-20250117104847-4.png]]
677 +
678 +
679 +**No ACK Message**:  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
680 +
681 +**Poll Message Flag**: 1: This message is a poll message reply.
682 +
683 +* Poll Message Flag is set to 1.
684 +
685 +* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
686 +
687 +For example, in US915 band, the max payload for different DR is:
688 +
689 +**a) DR0:** max is 11 bytes so one entry of data
690 +
691 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
692 +
693 +**c) DR2:** total payload includes 11 entries of data
694 +
695 +**d) DR3: **total payload includes 22 entries of data.
696 +
697 +If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
698 +
699 +**Example:**
700 +
701 +If PS-LB-NA has below data inside Flash:
702 +
703 +[[image:image-20250117104837-3.png]]
704 +
705 +
706 +If user sends below downlink command: 316788D9BF6788DB6305
707 +
708 +Where : Start time: 6788D9BF = time 25/1/16 10:04:47
709 +
710 + Stop time: 6788DB63 = time 25/1/16 10:11:47
711 +
712 +
713 +**PA-LB-NA will uplink this payload.**
714 +
715 +[[image:image-20250117104827-2.png]]
716 +
635 635  (((
636 -**4bytes**
718 +00001B620000406788D9BF  00000D130000406788D9FB  00000D120000406788DA37  00000D110000406788DA73  00000D100000406788DAAF  00000D100000406788DAEB  00000D0F0000406788DB27  00000D100000406788DB63
637 637  )))
638 638  
721 +(((
722 +Where the first 11 bytes is for the first entry :
723 +)))
639 639  
640 -
641 -)))|(% style="background-color:#f2f2f2; width:150px" %)**1byte**
642 -|(% style="background-color:#f2f2f2; width:70px" %)31|(% style="background-color:#f2f2f2; width:140px" %)Timestamp start|(% style="background-color:#f2f2f2; width:140px" %)Timestamp end|(% style="background-color:#f2f2f2; width:150px" %)Uplink Interval
725 +(((
726 +0000  0D10  0000  40  6788DB63
727 +)))
643 643  
644 -Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
729 +(((
730 +**Probe_mod **= 0x0000 = 0000
731 +)))
645 645  
646 -For example, downlink command[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]
733 +(((
734 +**VDC_intput_V **= 0x0D10/1000=3.344V
647 647  
648 -Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
736 +**IDC_intput_mA **= 0x0000/1000=0mA
737 +)))
649 649  
650 -Uplink Internal =5s,means PS-LB will send one packet every 5s. range 5~~255s.
739 +(((
740 +**IN1_pin_level **= (0x40& 0x08)? "High":"Low" = 0(Low)
651 651  
742 +**IN2_pin_level = (**0x40& 0x04)? "High":"Low" = 0(Low)
652 652  
653 -=== 2.6.4 Decoder in TTN V3 ===
744 +**Exti_pin_level = (**0x40& 0x02)? "High":"Low" = 0(Low)
654 654  
746 +**Exti_status = (**0x40& 0x01)? "True":"False" = 0(False)
747 +)))
748 +
749 +(((
750 +**Unix time** is 0x6788DB63 = 1737022307s = 2025/1/16 10:11:47
751 +)))
752 +
753 +**Its data format is:**
754 +
755 +[Probe_mod, VDC_intput_V, IDC_intput_mA, IN1_pin_level**, **IN2_pin_level, Exti_pin_level, water_deep, Data_time],[Probe_mod, VDC_intput_V, IDC_intput_mA, IN1_pin_level**, **IN2_pin_level, Exti_pin_level, water_deep, Data_time],...
756 +
757 +(% style="color:red" %)**Note: water_deep in the data needs to be converted using decoding to get it.**
758 +
759 +
760 +=== 2.6.5 Decoder in TTN V3 ===
761 +
655 655  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652862574387-195.png?width=722&height=359&rev=1.1||alt="1652862574387-195.png" height="359" width="722"]]
656 656  
657 657  Please check the decoder from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
... ... @@ -739,14 +739,22 @@
739 739  === 2.8.2 Set the Report on Change ===
740 740  
741 741  
742 -Feature: Set the detection interval and threshold to monitor whether the IDC/VDC variable exceeds the threshold. If the threshold is exceeded, an ROC uplink is sent.
849 +Feature: Get or Set the Report on Change.
850 +
851 +
852 +==== 2.8.2.1 Wave alarm mode ====
853 +
854 +Feature: By setting the detection period and a change value, the IDC/VDC variable is monitored whether it exceeds the set change value. If this change value is exceeded, the ROC uplink is sent and the comparison value is flushed.
855 +
856 +* (% style="color:#037691" %)**Change value: **(%%)The amount by which the next detection value increases/decreases relative to the previous detection value.
857 +* (% style="color:#037691" %)**Comparison value:**(%%) A parameter to compare with the latest ROC test.
858 +
743 743  (% style="color:blue" %)**AT Command: AT+ROC**
744 744  
745 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
746 -|=(% style="width: 143px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 197px; background-color: rgb(79, 129, 189); color: white;" %)**Parameters**|=(% style="width: 170px; background-color: rgb(79, 129, 189); color: white;" %)**Response/Explanation**
747 -|(% style="width:143px" %)AT+ROC=?|(% style="width:197px" %)Show current ROC setting|(% style="width:168px" %)(((
861 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
862 +|=(% style="width: 163px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 154px; background-color: rgb(79, 129, 189); color: white;" %)**Parameters**|=(% style="width: 197px; background-color: rgb(79, 129, 189); color: white;" %)**Response/Explanation**
863 +|(% style="width:143px" %)AT+ROC=?|(% style="width:154px" %)Show current ROC setting|(% style="width:197px" %)(((
748 748  0,0,0,0(default)
749 -
750 750  OK
751 751  )))
752 752  |(% colspan="1" rowspan="4" style="width:143px" %)(((
... ... @@ -755,36 +755,50 @@
755 755  
756 756  
757 757  AT+ROC=a,b,c,d
758 -)))|(% style="width:197px" %)**a**: Enable or disable the ROC|(% style="width:168px" %)(((
759 -0: off
873 +)))|(% style="width:154px" %)(((
874 +
760 760  
761 -1: on
876 +
877 +
878 +
879 +
880 +**a**: Enable or disable the ROC
881 +)))|(% style="width:197px" %)(((
882 +**0:** off
883 +**1:** Turn on the wave alarm mode, send the ROC uplink when the increment exceeds the set parameter and refresh the comparison value.
884 +
885 +**2: **Turn on the wave alarm mode, send the ROC uplink when the increment exceeds the set parameter and refresh the comparison value. In addition, the comparison value is refreshed when the device sends packets ([[TDC>>||anchor="H3.3.1SetTransmitIntervalTime"]] or [[ACT>>||anchor="H1.7Button26LEDs"]]).
762 762  )))
763 -|(% style="width:197px" %)**b**: Set the detection interval|(% style="width:168px" %)Unit: second
764 -|(% style="width:197px" %)**c**: Setting the IDC change threshold|(% style="width:168px" %)Unit: uA
765 -|(% style="width:197px" %)**d**: Setting the VDC change threshold|(% style="width:168px" %)Unit: mV
887 +|(% style="width:154px" %)**b**: Set the detection interval|(% style="width:197px" %)(((
888 +Range:  0~~65535s
889 +)))
890 +|(% style="width:154px" %)**c**: Setting the IDC change value|(% style="width:197px" %)Unit: uA
891 +|(% style="width:154px" %)**d**: Setting the VDC change value|(% style="width:197px" %)Unit: mV
766 766  
767 767  **Example:**
768 768  
769 -* AT+ROC=1,60,3000, 500  ~/~/ Check value every 60 seconds. lf there is change in IDC (>3mA) or VDC (>500mV), sends an ROC uplink.
770 -* AT+ROC=1,60,3000,0  ~/~/ Check value every 60 seconds. lf there is change in IDC (>3mA), send an ROC uplink. 0 Means doesn't monitor Voltage.
895 +* AT+ROC=0,0,0,0  ~/~/The ROC function is not used.
896 +* AT+ROC=1,60,3000, 500  ~/~/ Check value every 60 seconds. lf there is change in IDC (>3mA) or VDC (>500mV), sends an ROC uplink, and the comparison value is refreshed.
897 +* AT+ROC=1,60,3000,0  ~/~/ Check value every 60 seconds. lf there is change in IDC (>3mA), send an ROC uplink and the comparison value of IDC is refreshed. dd=0 Means doesn't monitor Voltage.
898 +* AT+ROC=2,60,3000,0  ~/~/ Check value every 60 seconds. lf there is change in IDC (>3mA), send an ROC uplink and the comparison value of IDC is refreshed. dd=0 Means doesn't monitor Voltage. In addition, if the change in the IDC does not exceed 3mA, then the ROC uplink is not sent, and the comparison value is not refreshed by the ROC uplink packet. However, if the device TDC time arrives, or if the user manually sends packets, then the IDC comparison value is also refreshed.
771 771  
772 772  (% style="color:blue" %)**Downlink Command: 0x09 aa bb cc dd**
773 773  
774 774  Format: Function code (0x09) followed by 4 bytes.
775 775  
776 -(% style="color:blue" %)**aa: **(%%)Enable/Disable the ROC.
904 +(% style="color:blue" %)**aa: **(% style="color:#037691" %)**1 byte;**(%%) Set the wave alarm mode.
777 777  
778 -(% style="color:blue" %)**bb: **(%%)Set the detection interval. (second)
906 +(% style="color:blue" %)**bb: **(% style="color:#037691" %)**2 bytes;**(%%) Set the detection interval. (second)
779 779  
780 -(% style="color:blue" %)**cc: **(%%)Setting the IDC change threshold. (uA)
908 +(% style="color:blue" %)**cc: **(% style="color:#037691" %)**2 bytes;**(%%) Setting the IDC change threshold. (uA)
781 781  
782 -(% style="color:blue" %)**dd: **(%%)Setting the VDC change threshold. (mV)
910 +(% style="color:blue" %)**dd: **(% style="color:#037691" %)**2 bytes;**(%%) Setting the VDC change threshold. (mV)
783 783  
784 784  **Example:**
785 785  
786 -* Downlink Payload: **09 01 00 3C 0B B8 01 F4 ** ~/~/ Equal to AT+ROC=1,60,3000, 500
787 -* Downlink Payload: **09 01 00 3C 0B B8 00 00 ** ~/~/ AT+ROC=1,60,3000,0
914 +* Downlink Payload: **09 01 00 3C 0B B8 01 F4 ** ~/~/Equal to AT+ROC=1,60,3000, 500
915 +* Downlink Payload: **09 01 00 3C 0B B8 00 00 ** ~/~/Equal to AT+ROC=1,60,3000,0
916 +* Downlink Payload: **09 02 00 3C 0B B8 00 00 ** ~/~/Equal to AT+ROC=2,60,3000,0
788 788  
789 789  (% style="color:blue" %)**Screenshot of parsing example in TTN:**
790 790  
... ... @@ -793,6 +793,80 @@
793 793  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-LB-NA--LoRaWAN_Analog_Sensor_User_Manual/WebHome/image-20241019170902-1.png?width=1454&height=450&rev=1.1||alt="image-20241019170902-1.png"]]
794 794  
795 795  
925 +==== 2.8.2.2 Over-threshold alarm mode ====
926 +
927 +Feature: Monitors whether the IDC/VDC exceeds the threshold by setting the detection period and threshold. Alarm if the threshold is exceeded.
928 +
929 +(% style="color:blue" %)**AT Command: AT+ROC=3,a,b,c,d,e**
930 +
931 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
932 +|=(% style="width: 163px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 160px; background-color: rgb(79, 129, 189); color: white;" %)**Parameters**|=(% style="width: 185px; background-color: rgb(79, 129, 189); color: white;" %)**Response/Explanation**
933 +|(% style="width:143px" %)AT+ROC=?|(% style="width:160px" %)Show current ROC setting|(% style="width:185px" %)(((
934 +0,0,0,0(default)
935 +OK
936 +)))
937 +|(% colspan="1" rowspan="5" style="width:143px" %)(((
938 +
939 +
940 +
941 +
942 +AT+ROC=(% style="color:blue" %)**3**(%%),a,b,c,d,e
943 +)))|(% style="width:160px" %)(((
944 +**a: **Set the detection interval
945 +)))|(% style="width:185px" %)(((
946 +Range:  0~~65535s
947 +)))
948 +|(% style="width:160px" %)**b**: Set the IDC alarm trigger condition|(% style="width:185px" %)(((
949 +**0:** Less than the set IDC threshold, Alarm
950 +
951 +**1:** Greater than the set IDC threshold, Alarm
952 +)))
953 +|(% style="width:160px" %)(((
954 +**c**:  IDC alarm threshold
955 +)))|(% style="width:185px" %)(((
956 +Unit: uA
957 +)))
958 +|(% style="width:160px" %)**d**: Set the VDC alarm trigger condition|(% style="width:185px" %)(((
959 +**0:** Less than the set VDC threshold, Alarm
960 +
961 +**1:** Greater than the set VDC threshold, Alarm
962 +)))
963 +|(% style="width:160px" %)**e:** VDC alarm threshold|(% style="width:185px" %)Unit: mV
964 +
965 +**Example:**
966 +
967 +* AT+ROC=3,60,0,3000,0,5000  ~/~/The data is checked every 60 seconds. If the IDC is less than 3mA or the VDC is less than 5000mV, an alarm is generated.
968 +* AT+ROC=3,180,1,3000,1,5000  ~/~/The data is checked every 180 seconds. If the IDC is greater than 3mA or the VDC is greater than 5000mV, an alarm is generated.
969 +* AT+ROC=3,300,0,3000,1,5000  ~/~/The data is checked every 300 seconds. If the IDC is less than 3mA or the VDC is greater than 5000mV, an alarm is generated.
970 +
971 +(% style="color:blue" %)**Downlink Command: 0x09 03 aa bb cc dd ee**
972 +
973 +Format: Function code (0x09) followed by 03 and the remaining 5 bytes.
974 +
975 +(% style="color:blue" %)**aa: **(% style="color:#037691" %)**2 bytes;**(%%) Set the detection interval.(second)
976 +
977 +(% style="color:blue" %)**bb: **(% style="color:#037691" %)**1 byte; **(%%)Set the IDC alarm trigger condition.
978 +
979 +(% style="color:blue" %)**cc: **(% style="color:#037691" %)**2 bytes;**(%%) IDC alarm threshold.(uA)
980 +
981 +
982 +(% style="color:blue" %)**dd: **(% style="color:#037691" %)**1 byte;**(%%) Set the VDC alarm trigger condition.
983 +
984 +(% style="color:blue" %)**ee: **(% style="color:#037691" %)**2 bytes; **(%%)VDC alarm threshold.(mV)
985 +
986 +**Example:**
987 +
988 +* Downlink Payload: **09 03 00 3C 00 0B B8 00 13 38** ~/~/Equal to AT+ROC=3,60,0,3000,0,5000
989 +* Downlink Payload: **09 03 00 b4 01 0B B8 01 13 38**  ~/~/Equal to AT+ROC=3,60,1,3000,1,5000
990 +* Downlink Payload: **09 03 01 2C 00 0B B8 01 13 38**  ~/~/Equal to AT+ROC=3,60,0,3000,1,5000
991 +
992 +(% style="color:blue" %)**Screenshot of parsing example in TTN:**
993 +
994 +* AT+ROC=3,60,0,3000,0,5000
995 +
996 +[[image:image-20250116180030-2.png]]
997 +
998 +
796 796  == 2.9 ​Firmware Change Log ==
797 797  
798 798  
image-20250116175954-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +68.6 KB
Content
image-20250116180030-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +69.2 KB
Content
image-20250117104812-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +1.7 KB
Content
image-20250117104827-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +74.6 KB
Content
image-20250117104837-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +38.7 KB
Content
image-20250117104847-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +4.2 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0