Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Last modified by Mengting Qiu on 2025/01/10 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -2,7 +2,7 @@ 2 2 [[image:image-20230516085523-1.jpeg||height="491" width="491"]] 3 3 4 4 5 -**Table of Contents :**5 +**Table of Contents:** 6 6 7 7 {{toc/}} 8 8 ... ... @@ -79,11 +79,6 @@ 79 79 * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v 80 80 * Operating Temperature: -40 ~~ 85°C 81 81 82 -(% style="color:#037691" %)**Sensor Detect Distance:** 83 - 84 -* Wood Door: 10mm ~~ 30mm 85 -* Iron Door: 30 ~~ 45mm 86 - 87 87 (% style="color:#037691" %)**LoRa Spec:** 88 88 89 89 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz ... ... @@ -156,6 +156,7 @@ 156 156 157 157 [[image:image-20230630160843-7.png]] 158 158 154 + 159 159 == 1.9 Mechanical == 160 160 161 161 ... ... @@ -171,6 +171,13 @@ 171 171 [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]] 172 172 173 173 170 +== 1.10 Magnet Distance == 171 + 172 + 173 +* Wood Door: 10mm ~~ 30mm 174 +* Iron Door: 30 ~~ 45mm 175 + 176 + 174 174 = 2. Configure DS03A-LB to connect to LoRaWAN network = 175 175 176 176 == 2.1 How it works == ... ... @@ -236,11 +236,13 @@ 236 236 === 2.3.1 Device Status, FPORT~=5 === 237 237 238 238 239 - Users cansethedownlinkcommand(**0x2601**)toaskDS03A-LBtosenddeviceconfiguredetail,includedeviceconfigurestatus.DS03A-LB will uplinka payloadviaFPort=5toserver.242 +Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours. 240 240 241 - ThePayloadformat is asbelow.244 +Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time. 242 242 243 243 247 +The Payload format is as below. 248 + 244 244 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 245 245 |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** 246 246 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** ... ... @@ -307,7 +307,7 @@ 307 307 === 2.3.2 Sensor Configuration, FPORT~=4 === 308 308 309 309 310 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 315 +DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server. 311 311 312 312 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 313 313 |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4** ... ... @@ -322,6 +322,11 @@ 322 322 Alarm interval(unit: min) 323 323 ))) 324 324 330 +Example parse in TTNv3 331 + 332 +[[image:image-20230630155527-3.png||height="146" width="902"]] 333 + 334 + 325 325 * ((( 326 326 (% style="color:blue" %)**TDC: (default: 0x001C20)** 327 327 ))) ... ... @@ -347,7 +347,6 @@ 347 347 348 348 Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 349 349 350 -[[image:image-20230630155527-3.png||height="146" width="902"]] 351 351 352 352 353 353 * ((( ... ... @@ -380,7 +380,7 @@ 380 380 381 381 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 382 382 |(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0** 383 -|(% style="width:76px" %) **Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((392 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)((( 384 384 Count mod 385 385 )))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)((( 386 386 Alarm 0: No Alarm; 1: Alarm ... ... @@ -395,9 +395,9 @@ 395 395 (% style="color:blue" %)**Count mod:Default=0** 396 396 ))) 397 397 398 - MOD=0~-~->Uplink total open door times since factory407 +0: Uplink total open door times since factory 399 399 400 - MOD=1~-~->Uplink total open door times since last FPORT=2 uplink.409 +1: Uplink total open door times since last FPORT=2 uplink. 401 401 402 402 403 403 * (% style="color:blue" %)**TDC flag** ... ... @@ -462,7 +462,7 @@ 462 462 463 463 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %) 464 464 |(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit0** 465 -|(% style="width:76px" %) **Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((474 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)((( 466 466 Count mod 467 467 )))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)((( 468 468 Alarm1 0: No Alarm; 1: Alarm (PA8 of pin) ... ... @@ -474,7 +474,7 @@ 474 474 475 475 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 476 476 |(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit0** 477 -|(% style="width:76px" %) **Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((486 +|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)((( 478 478 Alarm2 0: No Alarm; 1: Alarm (PA4 of pin) 479 479 )))|(% style="width:181px" %)((( 480 480 Status2 0: Close; 1: Open (PA4 of pin) ... ... @@ -484,12 +484,12 @@ 484 484 485 485 486 486 * ((( 487 - **(% style="color:blue" %)**Count mod:Default=0**496 +(% style="color:blue" %)**Count mod:Default=0** 488 488 ))) 489 489 490 - MOD=0~-~->Uplink total open door times since factory499 +0: Uplink total open door times since factory 491 491 492 - MOD=1~-~->Uplink total open door times since last FPORT=2 uplink.501 +1: Uplink total open door times since last FPORT=2 uplink. 493 493 494 494 495 495 * (% style="color:blue" %)**TDC flag** ... ... @@ -544,7 +544,7 @@ 544 544 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3** 545 545 |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4** 546 546 |(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 547 -Status & [[Alarm>>||anchor="H3.3. 4A0AlarmBaseonTimeout"]]556 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 548 548 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 549 549 The last door open duration (unit: sec) 550 550 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] ... ... @@ -564,7 +564,7 @@ 564 564 ))) 565 565 566 566 * ((( 567 -Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3. 2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands.576 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands. 568 568 ))) 569 569 570 570 For example, in the US915 band, the max payload for different DR is: ... ... @@ -792,9 +792,39 @@ 792 792 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 793 793 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 794 794 795 -=== 3.3.2 Enable/DisableAlarm===804 +=== 3.3.2 Set Power Output Duration === 796 796 797 797 807 +Control the output duration 5V . Before each sampling, device will 808 + 809 +~1. first enable the power output to external sensor, 810 + 811 +2. keep it on as per duration, read sensor value and construct uplink payload 812 + 813 +3. final, close the power output. 814 + 815 +(% style="color:blue" %)**AT Command: AT+5VT** 816 + 817 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 818 +|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 204px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 149px;" %)**Response** 819 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default) 820 +OK 821 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)((( 822 +OK 823 + 824 +))) 825 + 826 +(% style="color:blue" %)**Downlink Command: 0x07**(%%) 827 +Format: Command Code (0x07) followed by 2 bytes. 828 + 829 +The first and second bytes are the time to turn on. 830 + 831 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 832 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 833 + 834 +=== 3.3.3 Enable / Disable Alarm === 835 + 836 + 798 798 Feature: Enable/Disable Alarm for open/close event. Default value 0. 799 799 800 800 (% style="color:blue" %)**AT Command: ** ... ... @@ -811,12 +811,11 @@ 811 811 0xA7 00 ~/~/ Same As AT+DISALARM=0 812 812 813 813 814 -=== 3.3. 3Alarm Base on Timeout ===853 +=== 3.3.4 Alarm Base on Timeout === 815 815 816 816 817 817 DS03A-LB 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: 818 818 819 - 820 820 * ((( 821 821 (% style="color:blue" %)**Keep Status: Status to be monitor** 822 822 ))) ... ... @@ -852,7 +852,7 @@ 852 852 **cc dd:** timeout. 853 853 854 854 855 - 1)**AT+TTRIG1**:(PA8 of pin)893 +**1) AT+TTRIG1 : (PA8 of pin)** 856 856 857 857 (% style="color:blue" %)**AT Command to configure:** 858 858 ... ... @@ -871,13 +871,11 @@ 871 871 872 872 (% style="color:blue" %)**Downlink Command to configure:** 873 873 874 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or 912 +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. 875 875 876 - 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0. 877 877 915 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)** 878 878 879 -2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2) 880 - 881 881 (% style="color:blue" %)**AT Command to configure:** 882 882 883 883 * ((( ... ... @@ -895,14 +895,12 @@ 895 895 896 896 (% style="color:blue" %)**Downlink Command to configure:** 897 897 898 -If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 934 +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. 899 899 900 - 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0. 901 901 937 +=== 3.3.5 TTRIG1 & TTRIG2 timeout status alarm === 902 902 903 -=== 3.3.4 TTRIG1 & TTRIG2 timeout status alarm === 904 904 905 - 906 906 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. 907 907 908 908 (% style="color:blue" %)**AT Command:** ... ... @@ -929,7 +929,7 @@ 929 929 Example: 0C aa => AT+TTRALARM= aa 930 930 931 931 932 -=== 3.3. 5Count Mod ===966 +=== 3.3.6 Count Mod === 933 933 934 934 935 935 Feature: Manually set the count mode. ... ... @@ -958,7 +958,7 @@ 958 958 Example: 0B aa => AT+COUNTMOD = second byte 959 959 960 960 961 -=== 3.3. 6Number of channel of door sensors ===995 +=== 3.3.7 Number of channel of door sensors === 962 962 963 963 964 964 Feature: Set the number of door sensor channels. ... ... @@ -987,7 +987,7 @@ 987 987 Example: 0D aa => AT+TTRCHANNEL = second byte 988 988 989 989 990 -=== 3.3. 7Set Time Sync Mode ===1024 +=== 3.3.8 Set Time Sync Mode === 991 991 992 992 993 993 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command. ... ... @@ -1025,13 +1025,13 @@ 1025 1025 0x28 00 ~/~/ Same As AT+SYNCMOD=0 1026 1026 1027 1027 1028 -=== 3.3. 8Clear the open door times and the duration of the last open door ===1062 +=== 3.3.9 Clear the open door times and the duration of the last open door === 1029 1029 1030 1030 1031 1031 (% style="color:blue" %)**AT Command:** 1032 1032 1033 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:50 0px" %)1034 -|=(% style="width: 1 55px;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**1067 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1068 +|=(% 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** 1035 1035 |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)((( 1036 1036 OK 1037 1037 ))) ... ... @@ -1041,7 +1041,7 @@ 1041 1041 The sensor will clear the open door times and the duration of the last open door. 1042 1042 1043 1043 1044 -=== 3.3. 9Set the count value of the number of open door ===1078 +=== 3.3.10 Set the count value of the number of open door === 1045 1045 1046 1046 1047 1047 (% style="color:blue" %)**AT Command:** ... ... @@ -1092,9 +1092,8 @@ 1092 1092 1093 1093 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 1094 1094 1129 +Methods to Update Firmware: 1095 1095 1096 -**Methods to Update Firmware:** 1097 - 1098 1098 * (Recommanded way) OTA firmware update via wireless:** [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 1099 1099 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**. 1100 1100