Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 107.13
edited by Xiaoling
on 2023/10/11 14:05
Change comment: There is no comment for this version
To version 107.10
edited by Xiaoling
on 2023/10/11 11:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -376,7 +376,7 @@
376 376  
377 377  == 2.3  ​Uplink Payload ==
378 378  
379 -=== 2.3.1  Sensor Configuration, FPORT~=4 ===
379 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
380 380  
381 381  
382 382  DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
... ... @@ -433,7 +433,7 @@
433 433  When the state of the door sensor has not been changed after the timeout alarm, the device will send a uplink every alarm interval. It will stop the alarm until the state of the door sensor is changed after the timeout alarm.
434 434  
435 435  
436 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
436 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
437 437  
438 438  
439 439  DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
... ... @@ -609,7 +609,7 @@
609 609  [[image:image-20230701094042-1.png||height="154" width="763"]]
610 610  
611 611  
612 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
612 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
613 613  
614 614  
615 615  DS03A-NB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
... ... @@ -741,327 +741,161 @@
741 741  
742 742  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
743 743  
744 +== 2.7 Alarm for continuously water flow ==
744 744  
745 745  
746 -== 2.7 Set Transmit Interval Time ==
747 +(((
748 +This feature is to monitor and send Alarm for continuously water flow.
749 +)))
747 747  
751 +(((
752 +Example case is for Toilet water monitoring, if some one push toilet button, the toilet will have water flow. If the toilet button has broken and can't returned to original state, the water flow will keep for hours or days which cause huge waste for water.
753 +)))
748 748  
749 749  (((
750 -Feature: Change NB-IoT End Node Transmit Interval.
756 +To monitor this faulty and send alarm, there are two settings:
751 751  )))
752 752  
759 +* (((
760 +(% style="color:blue" %)**Stop Duration: Unit: Second**
761 +)))
762 +
753 753  (((
754 -(% style="color:blue" %)**AT Command: AT+TDC**
764 +Default: 15s, If DS03A-NB didn't see any water flow in 15s, DS03A-NB will consider stop of water flow event.
755 755  )))
756 756  
757 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
758 -|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
759 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
760 -30000
761 -OK
762 -the interval is 30000ms = 30s
767 +* (((
768 +(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
763 763  )))
764 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
765 -OK
766 -Set transmit interval to 60000ms = 60 seconds
770 +
771 +(((
772 +**Example:** 3 minutes, if DS03A-NB detect a start of water flow event and didn't detect a stop event within Alarm timer, DS03A-NB will send an Alarm to indicate a water flow abnormal alarm.
767 767  )))
768 768  
769 769  (((
770 -(% style="color:blue" %)**Downlink Command: 0x01**
776 +So for example, If we set stop duration=15s and Alarm Timer=3minutes. If the toilet water flow continuously for more than 3 minutes, Sensor will send an alarm (in Confirmed MODE) to platform.
771 771  )))
772 772  
773 773  (((
774 -Format: Command Code (0x01) followed by 3 bytes time value.
780 +(% style="color:red" %)**Note:** **After this alarm is send, sensor will consider a stop of water flow and count for another new event. So if water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.**
775 775  )))
776 776  
777 777  (((
778 -If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
784 +(% style="color:blue" %)**AT Command to configure:**
779 779  )))
780 780  
781 781  * (((
782 -Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
788 +AT+PTRIG=15,3  ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
783 783  )))
784 -* (((
785 -Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
786 -)))
787 787  
788 -
789 -== 2.8 Enable / Disable Alarm ==
790 -
791 -
792 -Feature: Enable/Disable Alarm for open/close event. Default value 0.
793 -
794 -(% style="color:blue" %)**AT Command: **
795 -
796 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
797 -|(% style="background-color:#4F81BD;color:white; width:153px" %)**Command Example**|(% style="background-color:#4F81BD;color:white; width:276px" %)**Function**|(% style="background-color:#4F81BD;color:white; width:86px" %)**Response**
798 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
799 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
800 -
801 -(% style="color:blue" %)**Downlink Command: **
802 -
803 -0xA7 01  ~/~/ Same As AT+DISALARM=1
804 -
805 -0xA7 00  ~/~/ Same As AT+DISALARM=0
806 -
807 -
808 -== 2.9  Alarm Base on Timeout ==
809 -
810 -
811 -DS03A-NB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
812 -
813 813  * (((
814 -(% style="color:blue" %)**Keep Status: Status to be monitor**
792 +AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
815 815  )))
816 816  
817 -(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
818 -
819 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
820 -
821 -
822 -* (((
823 -(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
795 +(((
796 +(% style="color:blue" %)**Downlink Command to configure:** 
824 824  )))
825 825  
826 -Range 0 ~~ 65535(0xFFFF) seconds.
827 -
828 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
829 -
830 -If (% style="color:#037691" %)**keep time > 0**(%%), device will monitor the keep status event and send an alarm when status doesn't change after timeout.
831 -
832 -
833 -* (((
834 -(% style="color:blue" %)**Downlink Command**
799 +(((
800 +Command: **0xAA aa bb cc**
835 835  )))
836 836  
837 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
838 -
839 -**A9:** Command Type Code
840 -
841 -**aa: **01:TTRIG1; 02:TTRIG2
842 -
843 -**bb:** status to be monitored
844 -
845 -**cc dd:** timeout.
846 -
847 -
848 -**1) AT+TTRIG1 : (PA8 of pin)**
849 -
850 -(% style="color:blue" %)**AT Command to configure:**
851 -
852 -* (((
853 -(% style="color:#037691" %)**AT+TTRIG1=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-NB will send an uplink packet, the Alarm1 bit(the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
854 -
855 -(% style="color:#037691" %)**AT+TTRIG1=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-NB will send an uplink packet, the Alarm1 bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
803 +(((
804 +AA: Command Type Code
856 856  )))
857 857  
858 -* (((
859 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
860 -
861 -
862 -
807 +(((
808 +aa: Stop duration
863 863  )))
864 864  
865 -(% style="color:blue" %)**Downlink Command to configure:**
866 -
867 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
868 -
869 -
870 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
871 -
872 -(% style="color:blue" %)**AT Command to configure:**
873 -
874 -* (((
875 -(% style="color:#037691" %)**AT+TTRIG2=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-NB will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
876 -
877 -(% style="color:#037691" %)**AT+TTRIG2=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-NB will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
811 +(((
812 +bb cc: Alarm Timer
878 878  )))
879 879  
880 -* (((
881 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
882 -
883 -
884 -
815 +(((
816 +If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
885 885  )))
886 886  
887 -(% style="color:blue" %)**Downlink Command to configure:**
888 888  
889 -If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30  **or**  0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
820 +== 2.8 Set the calculate flag ==
890 890  
891 891  
892 -== 2.10 TTRIG1 & TTRIG2 timeout status alarm ==
823 +Feature: Set the calculate flag
893 893  
825 +(% style="color:blue" %)**AT Command: AT+CALCFLAG**
894 894  
895 -It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval.
827 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
828 +|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 110px;background-color:#4F81BD;color:white" %)**Response**
829 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK
830 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK
896 896  
897 -(% style="color:blue" %)**AT Command:**
898 -
899 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
900 -|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 279px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 76px;background-color:#4F81BD;color:white" %)**Response**
901 -|(% style="width:155px" %)(((
902 -AT+TTRALARM=0
903 -)))|(% style="width:279px" %)(((
904 -disable continuous alarm
905 -)))|(% style="width:84px" %)(((
906 -OK
907 -)))
908 -|(% style="width:155px" %)(((
909 -AT+TTRALARM=60
910 -)))|(% style="width:279px" %)(((
911 -The alarm interval is 60 minutes (unit: minutes)
912 -)))|(% style="width:84px" %)(((
913 -OK
914 -)))
915 -
916 916  (% style="color:blue" %)**Downlink Command:**
917 917  
918 -Example:  0C aa  => AT+TTRALARM= aa
834 +* **Example**: 0XA501  ~/~/  Same as AT+CALCFLAG =1
919 919  
836 +== 2.9 Set count number ==
920 920  
921 -== 2.11 Count Mod ==
922 922  
839 +Feature: Manually set the count number
923 923  
924 -Feature: Manually set the count mode.
841 +(% style="color:blue" %)**AT Command: AT+SETCNT**
925 925  
926 -(% style="color:blue" %)**AT Command:**
843 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
844 +|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 223px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 96px;background-color:#4F81BD;color:white" %)**Response**
845 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK
846 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK
927 927  
928 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
929 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 275px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)**Response**
930 -|(% style="width:155px" %)(((
931 -AT+COUNTMOD=0
932 -)))|(% style="width:277px" %)(((
933 -the count value keeps accumulating mode
934 -)))|(% style="width:86px" %)(((
935 -OK
936 -)))
937 -|(% style="width:155px" %)(((
938 -AT+COUNTMOD=1
939 -)))|(% style="width:277px" %)(((
940 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
941 -)))|(% style="width:86px" %)(((
942 -OK
943 -)))
944 -
945 945  (% style="color:blue" %)**Downlink Command:**
946 946  
947 -Example:  0B aa  => AT+COUNTMOD = second byte
850 +* **Example**: 0xA6000001  ~/~/  Same as AT+ SETCNT =1
948 948  
852 +* **Example**: 0xA6000064  ~/~/  Same as AT+ SETCNT =100
949 949  
950 -== 2.12  Number of channel of door sensors ==
854 +== 2.10 Set Transmit Interval Time ==
951 951  
952 952  
953 -Feature: Set the number of door sensor channels.
857 +(((
858 +Feature: Change NB-IoT End Node Transmit Interval.
859 +)))
954 954  
955 -(% style="color:blue" %)**AT Command:**
861 +(((
862 +(% style="color:blue" %)**AT Command: AT+TDC**
863 +)))
956 956  
957 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
958 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
959 -|(% style="width:155px" %)(((
960 -AT+TTRCHANNEL=1
961 -)))|(% style="width:259px" %)(((
962 -Set as single channel, only use PA8 pin as interrupt pin.
963 -)))|(% style="width:44px" %)(((
865 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
866 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
867 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
868 +30000
964 964  OK
870 +the interval is 30000ms = 30s
965 965  )))
966 -|(% style="width:155px" %)(((
967 -AT+TTRCHANNEL=2
968 -)))|(% style="width:259px" %)(((
969 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
970 -)))|(% style="width:44px" %)(((
872 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
971 971  OK
874 +Set transmit interval to 60000ms = 60 seconds
972 972  )))
973 973  
974 -(% style="color:blue" %)**Downlink Command:**
877 +(((
878 +(% style="color:blue" %)**Downlink Command: 0x01**
879 +)))
975 975  
976 -Example:  0D aa => AT+TTRCHANNEL = second byte
881 +(((
882 +Format: Command Code (0x01) followed by 3 bytes time value.
883 +)))
977 977  
978 -
979 -== 2.13 Set Time Sync Mode ==
980 -
981 -
982 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
983 -
984 -SYNCMOD is set to 1 by default. If user wants to set a different time from the LoRaWAN server, the user needs to set this to 0.
985 -
986 -(% style="color:blue" %)**AT Command:**
987 -
988 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
989 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
990 -|(% style="width:155px" %)(((
991 -AT+SYNCMOD=1
992 -)))|(% style="width:259px" %)(((
993 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
994 -)))|(% style="width:44px" %)(((
995 -OK
885 +(((
886 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
996 996  )))
997 -|(% style="width:155px" %)(((
998 -AT+SYNCMOD=1,8
999 -)))|(% style="width:259px" %)(((
1000 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1001 -)))|(% style="width:44px" %)(((
1002 -OK
1003 -)))
1004 -|(% style="width:155px" %)AT+SYNCMOD=1,-12|(% style="width:259px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.|(% style="width:44px" %)OK
1005 1005  
1006 -(% style="color:blue" %)**Downlink Command:**
1007 -
1008 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
1009 -
1010 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1011 -
1012 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
1013 -
1014 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1015 -
1016 -
1017 -== 2.14  Clear the open door times and the duration of the last open door ==
1018 -
1019 -
1020 -(% style="color:blue" %)**AT Command:**
1021 -
1022 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1023 -|=(% style="width: 163px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 290px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1024 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1025 -OK
889 +* (((
890 +Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
1026 1026  )))
892 +* (((
893 +Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
1027 1027  
1028 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1029 1029  
1030 -The sensor will clear the open door times and the duration of the last open door.
1031 -
1032 -
1033 -== 2.15  Set the count value of the number of open door ==
1034 -
1035 -
1036 -(% style="color:blue" %)**AT Command:**
1037 -
1038 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1039 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1040 -|(% style="width:155px" %)(((
1041 -AT+SETCNT=1,100
1042 -)))|(% style="width:259px" %)(((
1043 -Set the open door times of PA8 pin to 100 times.
1044 -)))|(% style="width:44px" %)(((
1045 -OK
896 +
1046 1046  )))
1047 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1048 -|(% style="width:155px" %)(((
1049 -AT+SETCNT=2,50
1050 -)))|(% style="width:259px" %)(((
1051 -Set the open door times of PA4 pin to 100 times.
1052 -)))|(% style="width:44px" %)(((
1053 -OK
1054 -)))
1055 1055  
1056 -(% style="color:blue" %)**Downlink Command:**
1057 -
1058 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1059 -
1060 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1061 -
1062 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1063 -
1064 -
1065 1065  = 3. Configure DS03A-NB =
1066 1066  
1067 1067  == 3.1 Configure Methods ==