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
-
... ... @@ -71,7 +71,6 @@ 71 71 * Wall Mountable 72 72 * Outdoor Use 73 73 74 - 75 75 == 1.3 Specification == 76 76 77 77 ... ... @@ -105,7 +105,6 @@ 105 105 * Sleep Mode: 5uA @ 3.3v 106 106 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 107 107 108 - 109 109 == 1.4 Applications == 110 110 111 111 ... ... @@ -139,7 +139,6 @@ 139 139 ))) 140 140 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means Device is in Deep Sleep Mode. 141 141 142 - 143 143 == 1.7 BLE connection == 144 144 145 145 ... ... @@ -155,9 +155,13 @@ 155 155 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 156 156 157 157 158 -== 1.8 Mechanical==155 +== 1.8 Pin Definitions == 159 159 157 +[[image:image-20230630160843-7.png]] 160 160 159 +== 1.9 Mechanical == 160 + 161 + 161 161 [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]] 162 162 163 163 ... ... @@ -303,40 +303,159 @@ 303 303 Ex2: 0x0B49 = 2889mV 304 304 305 305 306 -=== 2.3.2Real-TimeOpen/Close Status,UplinkFPORT~=2===307 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2 Sensor Configuration, FPORT~=4(%%) === 307 307 308 308 310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 311 + 312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:723px" %) 313 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:721px" %)**Sensor Configuration FPORT=4** 314 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:99px" %)**2**|(% style="width:87px" %)**1**|(% style="width:97px" %)**2**|(% style="width:98px" %)**1** 315 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)((( 316 +Keep status1 317 + 318 + 319 +)))|(% style="width:99px" %)((( 320 +Keep time1 321 + 322 +(unit: sec) 323 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)((( 324 +Keep time2 325 + 326 +(unit: sec) 327 +)))|(% style="width:98px" %)((( 328 +Alarm interval 329 + 330 +(unit: min) 331 +))) 332 + 333 +* ((( 334 +(% style="color:blue" %)**TDC: (default: 0x001C20)** 335 +))) 336 + 337 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 338 + 339 + 340 +* ((( 341 +(% style="color:blue" %)**Disalarm: (default: 0)** 342 +))) 343 + 344 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 345 + 346 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 347 + 348 + 349 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 350 + 351 + 352 +* ((( 353 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2** 354 +))) 355 + 356 +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]] 357 + 358 +[[image:image-20230630155527-3.png||height="146" width="902"]] 359 + 360 + 361 +* ((( 362 +(% style="color:blue" %)**Alarm interval(default: 0)** 363 +))) 364 + 365 +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. 366 + 367 + 368 +=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 369 + 370 + 309 309 DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 310 310 311 311 * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 312 312 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) 313 313 314 -Uplink Payload totals 11 bytes. 315 315 377 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**) 378 + 316 316 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 317 317 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2** 318 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4** 319 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)((( 320 -The last door open duration (unit: min) 381 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4** 382 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 383 +Status 384 + 385 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]] 386 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 387 +The last door open duration (unit: sec) 321 321 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 322 322 323 323 **Status & Alarm:** 324 324 325 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 326 -|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**[bit5:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit0** 327 -|(% style="width:76px" %)**Value**|(% style="width:79px" %)((( 328 -No ACK Message 329 -)))|(% style="width:84px" %)((( 330 -Poll Message Flag 331 -)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 332 -0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open 392 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:645px" %) 393 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:125px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit0** 394 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)((( 395 +Count mod 396 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:125px" %)((( 397 +0: No Alarm; 333 333 399 +1: Alarm 400 +)))|(% style="width:129px" %)((( 401 +Status 0: Close; 402 + 403 +1: Open 404 +))) 405 + 334 334 [[image:image-20230630155451-2.png||height="246" width="928"]] 335 335 408 + 409 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes. 410 + 411 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %) 412 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2** 413 +|(% style="width:94px" %)**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** 414 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 415 +Status1 416 + 417 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1 418 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)((( 419 +The last door open duration1 (unit: sec) 420 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)((( 421 +Status2 422 + 423 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2 424 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec) 425 + 426 +**Status1 & Alarm1:** 427 + 428 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:730px" %) 429 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:167px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:171px" %)**bit0** 430 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)((( 431 +Count mod 432 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)((( 433 +0: No Alarm; 1: Alarm 434 + 435 +(PA8) 436 +)))|(% style="width:171px" %)((( 437 +Status 0: Close; 1:Open 438 + 439 +(PA8) 440 +))) 441 + 442 +**Status2 & Alarm2:** 443 + 444 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:550px" %) 445 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:113px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:176px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:175px" %)**bit0** 446 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:176px" %)((( 447 +0: No Alarm; 1: Alarm 448 + 449 +(PA4) 450 +)))|(% style="width:175px" %)((( 451 +Status 0: Close,;1:Open 452 + 453 +(PA4) 454 +))) 455 + 336 336 [[image:image-20230630155908-6.png||height="295" width="927"]] 337 337 338 338 339 -=== 2.3. 3Historical Door Open/Close Event, FPORT~=3 ===459 +=== 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 340 340 341 341 342 342 DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. ... ... @@ -343,6 +343,33 @@ 343 343 344 344 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 345 345 466 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 467 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3** 468 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4** 469 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 470 +Status 471 + 472 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]] 473 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 474 +The last door open duration (unit: sec) 475 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 476 + 477 +**Status & Alarm:** 478 + 479 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %) 480 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:92px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:89px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:90px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:116px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:112px" %)**bit0** 481 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)((( 482 +Count mod 483 +)))|(% style="width:95px" %)TDC flag 0:No;1:Yes|(% style="width:116px" %)((( 484 +0: No Alarm; 485 + 486 +1: Alarm 487 +)))|(% style="width:112px" %)((( 488 +Status 0:Close; 489 + 490 +1: Open 491 +))) 492 + 346 346 * ((( 347 347 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. 348 348 ))) ... ... @@ -400,44 +400,7 @@ 400 400 401 401 [[image:image-20230630155751-5.png||height="188" width="809"]] 402 402 403 -=== 2.3.4 Sensor Configuration, FPORT~=4 === 404 404 405 - 406 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 407 - 408 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 409 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 410 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2** 411 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min) 412 - 413 -* ((( 414 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 415 -))) 416 - 417 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 418 - 419 - 420 -* ((( 421 -(% style="color:blue" %)**Disalarm: (default: 0)** 422 -))) 423 - 424 - **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 425 - 426 - **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 427 - 428 - 429 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 430 - 431 - 432 -* ((( 433 -(% style="color:blue" %)**Keep Status & Keep Time** 434 -))) 435 - 436 -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]] 437 - 438 -[[image:image-20230630155527-3.png||height="146" width="902"]] 439 - 440 - 441 441 == 2.4 Payload Decoder file == 442 442 443 443 ... ... @@ -455,7 +455,9 @@ 455 455 456 456 (% style="color:blue" %)**Datalog Feature** (%%)is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS03A-LB will store the reading for future retrieving purposes. 457 457 568 +(% style="color:red" %)**Note:After the device is reset,in cumulative counting mode,the last stored count value will be read as the initial value.** 458 458 570 + 459 459 === 2.5.1 Ways to get datalog via LoRaWAN === 460 460 461 461 ... ... @@ -560,7 +560,6 @@ 560 560 * AT Command via UART Connection : See [[Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]. 561 561 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 562 562 563 - 564 564 == 3.2 General Commands == 565 565 566 566 ... ... @@ -608,7 +608,6 @@ 608 608 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 609 609 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 610 610 611 - 612 612 === 3.3.2 Get Device Status === 613 613 614 614 ... ... @@ -816,7 +816,6 @@ 816 816 * (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/]]** 817 817 * 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]]**. 818 818 819 - 820 820 = 6. FAQ = 821 821 822 822 ... ... @@ -844,7 +844,6 @@ 844 844 845 845 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 846 846 847 - 848 848 = 8. Packing Info = 849 849 850 850 ... ... @@ -862,7 +862,6 @@ 862 862 863 863 * Weight / pcs : g 864 864 865 - 866 866 = 9. Support = 867 867 868 868