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 (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Saxer - Content
-
... ... @@ -156,6 +156,7 @@ 156 156 157 157 [[image:image-20230630160843-7.png]] 158 158 159 + 159 159 == 1.9 Mechanical == 160 160 161 161 ... ... @@ -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.240 +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.242 +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 245 +The Payload format is as below. 246 + 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** ... ... @@ -304,16 +304,17 @@ 304 304 Ex2: 0x0B49 = 2889mV 305 305 306 306 307 -=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2 Sensor Configuration, FPORT~=4(%%)===310 +=== 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. 313 +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** 314 314 |**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:50px" %)**1**|(% style="width:100px" %)**1**|(% style="width:90px" %)**2**|(% style="width:100px" %)**1**|(% style="width:100px" %)**2**|(% style="width:98px" %)**1** 315 315 |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)((( 316 -Keep status1)))|(% style="width:99px" %)((( 319 +Keep status1 320 +)))|(% style="width:99px" %)((( 317 317 Keep time1(unit: sec) 318 318 )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)((( 319 319 Keep time2(unit: sec) ... ... @@ -321,6 +321,11 @@ 321 321 Alarm interval(unit: min) 322 322 ))) 323 323 328 +Example parse in TTNv3 329 + 330 +[[image:image-20230630155527-3.png||height="146" width="902"]] 331 + 332 + 324 324 * ((( 325 325 (% style="color:blue" %)**TDC: (default: 0x001C20)** 326 326 ))) ... ... @@ -344,9 +344,8 @@ 344 344 (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2** 345 345 ))) 346 346 347 -Shows the configure value of [[Alarm Base on Timeout Feature>> url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]356 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 348 348 349 -[[image:image-20230630155527-3.png||height="146" width="902"]] 350 350 351 351 352 352 * ((( ... ... @@ -361,16 +361,16 @@ 361 361 362 362 DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 363 363 364 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 372 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]]. 365 365 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) 366 366 367 -1) When **AT+TTRCHANNEL=1**, Uplink Payload totals**11 bytes**. (**Default mode**)375 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)** 368 368 369 369 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 370 370 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2** 371 371 |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4** 372 372 |(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 373 -Status & [[Alarm>>||anchor="H3.3.4A0 AlarmBaseonTimeout"]]381 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]] 374 374 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 375 375 The last door open duration (unit: sec) 376 376 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] ... ... @@ -394,9 +394,9 @@ 394 394 (% style="color:blue" %)**Count mod:Default=0** 395 395 ))) 396 396 397 - MOD=0~-~->Uplink total open door times since factory405 +0: Uplink total open door times since factory 398 398 399 - MOD=1~-~->Uplink total open door times since last FPORT=2 uplink.407 +1: Uplink total open door times since last FPORT=2 uplink. 400 400 401 401 402 402 * (% style="color:blue" %)**TDC flag** ... ... @@ -410,7 +410,7 @@ 410 410 (% style="color:#0000ff" %)**Alarm** 411 411 ))) 412 412 413 -See [[Alarm Base on Timeout>> http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]421 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 414 414 415 415 416 416 * ((( ... ... @@ -440,7 +440,7 @@ 440 440 [[image:image-20230701094042-1.png||height="154" width="763"]] 441 441 442 442 443 -2) When **AT+TTRCHANNEL=2**, Uplink Payload totals**18 bytes**.451 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %). 444 444 445 445 (When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets) 446 446 ... ... @@ -450,11 +450,11 @@ 450 450 |=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2** 451 451 |(% style="width:50px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:125px" %)**3**|(% style="width:100px" %)**4**|(% style="width:86px" %)**1**|(% style="width:96px" %)**3**|(% style="width:126px" %)**3** 452 452 |(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 453 -Status1 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1461 +Status1 & Alarm1 454 454 )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)((( 455 455 The last door open duration1 (unit: sec) 456 456 )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)((( 457 -Status2 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2465 +Status2 & Alarm2 458 458 )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec) 459 459 460 460 **Status1 & Alarm1:** ... ... @@ -483,12 +483,12 @@ 483 483 484 484 485 485 * ((( 486 -(% id="cke_bm_695345S"style="color:blue; display:none" %)****(% style="color:blue" %)**Count mod:Default=0**494 +(% style="color:blue" %)**Count mod:Default=0** 487 487 ))) 488 488 489 - MOD=0~-~->Uplink total open door times since factory497 +0: Uplink total open door times since factory 490 490 491 - MOD=1~-~->Uplink total open door times since last FPORT=2 uplink.499 +1: Uplink total open door times since last FPORT=2 uplink. 492 492 493 493 494 494 * (% style="color:blue" %)**TDC flag** ... ... @@ -502,7 +502,7 @@ 502 502 (% style="color:#0000ff" %)**Alarm1 or Alarm2** 503 503 ))) 504 504 505 -See [[Alarm Base on Timeout>> http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]513 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 506 506 507 507 508 508 * ((( ... ... @@ -543,7 +543,7 @@ 543 543 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3** 544 544 |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4** 545 545 |(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 546 -Status & [[Alarm>>||anchor="H3.3. 4A0AlarmBaseonTimeout"]]554 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 547 547 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 548 548 The last door open duration (unit: sec) 549 549 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] ... ... @@ -563,7 +563,7 @@ 563 563 ))) 564 564 565 565 * ((( 566 -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.574 +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. 567 567 ))) 568 568 569 569 For example, in the US915 band, the max payload for different DR is: ... ... @@ -791,9 +791,38 @@ 791 791 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 792 792 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 793 793 794 -=== 3.3.2 Enable/DisableAlarm===802 +=== 3.3.2 Set Power Output Duration === 795 795 804 +Control the output duration 5V . Before each sampling, device will 796 796 806 +~1. first enable the power output to external sensor, 807 + 808 +2. keep it on as per duration, read sensor value and construct uplink payload 809 + 810 +3. final, close the power output. 811 + 812 +(% style="color:blue" %)**AT Command: AT+5VT** 813 + 814 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 815 +|=(% 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** 816 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default) 817 +OK 818 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)((( 819 +OK 820 + 821 +))) 822 + 823 +(% style="color:blue" %)**Downlink Command: 0x07**(%%) 824 +Format: Command Code (0x07) followed by 2 bytes. 825 + 826 +The first and second bytes are the time to turn on. 827 + 828 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 829 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 830 + 831 +=== 3.3.3 Enable / Disable Alarm === 832 + 833 + 797 797 Feature: Enable/Disable Alarm for open/close event. Default value 0. 798 798 799 799 (% style="color:blue" %)**AT Command: ** ... ... @@ -810,12 +810,11 @@ 810 810 0xA7 00 ~/~/ Same As AT+DISALARM=0 811 811 812 812 813 -=== 3.3. 3Alarm Base on Timeout ===850 +=== 3.3.4 Alarm Base on Timeout === 814 814 815 815 816 816 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: 817 817 818 - 819 819 * ((( 820 820 (% style="color:blue" %)**Keep Status: Status to be monitor** 821 821 ))) ... ... @@ -851,7 +851,7 @@ 851 851 **cc dd:** timeout. 852 852 853 853 854 - 1)**AT+TTRIG1**:(PA8 of pin)890 +**1) AT+TTRIG1 : (PA8 of pin)** 855 855 856 856 (% style="color:blue" %)**AT Command to configure:** 857 857 ... ... @@ -870,13 +870,11 @@ 870 870 871 871 (% style="color:blue" %)**Downlink Command to configure:** 872 872 873 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or 909 +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. 874 874 875 - 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0. 876 876 912 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)** 877 877 878 -2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2) 879 - 880 880 (% style="color:blue" %)**AT Command to configure:** 881 881 882 882 * ((( ... ... @@ -894,14 +894,12 @@ 894 894 895 895 (% style="color:blue" %)**Downlink Command to configure:** 896 896 897 -If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 931 +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. 898 898 899 - 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0. 900 900 934 +=== 3.3.5 TTRIG1 & TTRIG2 timeout status alarm === 901 901 902 -=== 3.3.4 TTRIG1 & TTRIG2 timeout status alarm === 903 903 904 - 905 905 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. 906 906 907 907 (% style="color:blue" %)**AT Command:** ... ... @@ -928,7 +928,7 @@ 928 928 Example: 0C aa => AT+TTRALARM= aa 929 929 930 930 931 -=== 3.3. 5Count Mod ===963 +=== 3.3.6 Count Mod === 932 932 933 933 934 934 Feature: Manually set the count mode. ... ... @@ -947,7 +947,7 @@ 947 947 |(% style="width:155px" %)((( 948 948 AT+COUNTMOD=1 949 949 )))|(% style="width:277px" %)((( 950 -the count value will be reset after each TDC time (Last Close Duration Reset after each uplink)982 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink) 951 951 )))|(% style="width:86px" %)((( 952 952 OK 953 953 ))) ... ... @@ -957,7 +957,7 @@ 957 957 Example: 0B aa => AT+COUNTMOD = second byte 958 958 959 959 960 -=== 3.3. 6Number of channel of door sensors ===992 +=== 3.3.7 Number of channel of door sensors === 961 961 962 962 963 963 Feature: Set the number of door sensor channels. ... ... @@ -965,7 +965,7 @@ 965 965 (% style="color:blue" %)**AT Command:** 966 966 967 967 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 968 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 2 59px; background-color:rgb(217, 226, 243);rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**1000 +|=(% 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** 969 969 |(% style="width:155px" %)((( 970 970 AT+TTRCHANNEL=1 971 971 )))|(% style="width:259px" %)((( ... ... @@ -986,7 +986,7 @@ 986 986 Example: 0D aa => AT+TTRCHANNEL = second byte 987 987 988 988 989 -=== 3.3. 7Set Time Sync Mode ===1021 +=== 3.3.8 Set Time Sync Mode === 990 990 991 991 992 992 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command. ... ... @@ -996,7 +996,7 @@ 996 996 (% style="color:blue" %)**AT Command:** 997 997 998 998 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 999 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 2 59px; background-color:rgb(217, 226, 243);rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**1031 +|=(% 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** 1000 1000 |(% style="width:155px" %)((( 1001 1001 AT+SYNCMOD=1 1002 1002 )))|(% style="width:259px" %)((( ... ... @@ -1024,13 +1024,13 @@ 1024 1024 0x28 00 ~/~/ Same As AT+SYNCMOD=0 1025 1025 1026 1026 1027 -=== 3.3. 8Clear the open door times and the duration of the last open door ===1059 +=== 3.3.9 Clear the open door times and the duration of the last open door === 1028 1028 1029 1029 1030 1030 (% style="color:blue" %)**AT Command:** 1031 1031 1032 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:50 0px" %)1033 -|=(% style="width: 1 55px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color:rgb(217, 226, 243);rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**1064 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1065 +|=(% 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** 1034 1034 |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)((( 1035 1035 OK 1036 1036 ))) ... ... @@ -1040,13 +1040,13 @@ 1040 1040 The sensor will clear the open door times and the duration of the last open door. 1041 1041 1042 1042 1043 -=== 3.3. 9Set the count value of the number of open door ===1075 +=== 3.3.10 Set the count value of the number of open door === 1044 1044 1045 1045 1046 1046 (% style="color:blue" %)**AT Command:** 1047 1047 1048 1048 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1049 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 2 59px; background-color:rgb(217, 226, 243);rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**1081 +|=(% 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** 1050 1050 |(% style="width:155px" %)((( 1051 1051 AT+SETCNT=1,100 1052 1052 )))|(% style="width:259px" %)((( ... ... @@ -1091,9 +1091,8 @@ 1091 1091 1092 1092 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 1093 1093 1126 +Methods to Update Firmware: 1094 1094 1095 -**Methods to Update Firmware:** 1096 - 1097 1097 * (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/]]** 1098 1098 * 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]]**. 1099 1099