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
-
... ... @@ -304,40 +304,159 @@ 304 304 Ex2: 0x0B49 = 2889mV 305 305 306 306 307 -=== 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(%%) === 308 308 309 309 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 + 310 310 DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 311 311 312 312 * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 313 313 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) 314 314 315 -Uplink Payload totals 11 bytes. 316 316 377 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**) 378 + 317 317 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 318 318 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2** 319 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4** 320 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)((( 321 -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) 322 322 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 323 323 324 324 **Status & Alarm:** 325 325 326 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 327 -|(% 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** 328 -|(% style="width:76px" %)**Value**|(% style="width:79px" %)((( 329 -No ACK Message 330 -)))|(% style="width:84px" %)((( 331 -Poll Message Flag 332 -)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 333 -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; 334 334 399 +1: Alarm 400 +)))|(% style="width:129px" %)((( 401 +Status 0: Close; 402 + 403 +1: Open 404 +))) 405 + 335 335 [[image:image-20230630155451-2.png||height="246" width="928"]] 336 336 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 + 337 337 [[image:image-20230630155908-6.png||height="295" width="927"]] 338 338 339 339 340 -=== 2.3. 3Historical Door Open/Close Event, FPORT~=3 ===459 +=== 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 341 341 342 342 343 343 DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. ... ... @@ -344,6 +344,33 @@ 344 344 345 345 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 346 346 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 + 347 347 * ((( 348 348 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. 349 349 ))) ... ... @@ -402,44 +402,6 @@ 402 402 [[image:image-20230630155751-5.png||height="188" width="809"]] 403 403 404 404 405 -=== 2.3.4 Sensor Configuration, FPORT~=4 === 406 - 407 - 408 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 409 - 410 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 411 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 412 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2** 413 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min) 414 - 415 -* ((( 416 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 417 -))) 418 - 419 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 420 - 421 - 422 -* ((( 423 -(% style="color:blue" %)**Disalarm: (default: 0)** 424 -))) 425 - 426 - **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. 427 - 428 - **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. 429 - 430 - 431 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 432 - 433 - 434 -* ((( 435 -(% style="color:blue" %)**Keep Status & Keep Time** 436 -))) 437 - 438 -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]] 439 - 440 -[[image:image-20230630155527-3.png||height="146" width="902"]] 441 - 442 - 443 443 == 2.4 Payload Decoder file == 444 444 445 445 ... ... @@ -457,7 +457,9 @@ 457 457 458 458 (% 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. 459 459 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.** 460 460 570 + 461 461 === 2.5.1 Ways to get datalog via LoRaWAN === 462 462 463 463