Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 21.1
edited by Saxer Lin
on 2023/06/30 16:09
Change comment: There is no comment for this version
To version 34.52
edited by Xiaoling
on 2023/07/01 15:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -304,48 +304,267 @@
304 304  Ex2: 0x0B49 = 2889mV
305 305  
306 306  
307 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
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.
311 +
312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
313 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
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 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
316 +Keep status1
317 +)))|(% style="width:99px" %)(((
318 +Keep time1(unit: sec)
319 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
320 +Keep time2(unit: sec)
321 +)))|(% style="width:98px" %)(((
322 +Alarm interval(unit: min)
323 +)))
324 +
325 +* (((
326 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
327 +)))
328 +
329 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
330 +
331 +
332 +* (((
333 +(% style="color:blue" %)**Disalarm: (default: 0)**
334 +)))
335 +
336 + **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.
337 +
338 + **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.
339 +
340 +
341 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
342 +
343 +
344 +* (((
345 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
346 +)))
347 +
348 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
349 +
350 +[[image:image-20230630155527-3.png||height="146" width="902"]]
351 +
352 +
353 +* (((
354 +(% style="color:blue" %)**Alarm interval(default: 0)**
355 +)))
356 +
357 +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.
358 +
359 +
360 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
361 +
362 +
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 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
365 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
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.
368 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
316 316  
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)
372 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
373 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
374 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
375 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
376 +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 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
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" %)(((
384 +Count mod
385 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
386 +Alarm 0: No Alarm; 1: Alarm
387 +)))|(% style="width:131px" %)(((
388 +Status 0: Close; 1: Open
389 +)))
334 334  
335 335  [[image:image-20230630155451-2.png||height="246" width="928"]]
336 336  
393 +
394 +* (((
395 +(% style="color:blue" %)**Count mod:Default=0**
396 +)))
397 +
398 +MOD=0 ~-~-> Uplink total open door times since factory
399 +
400 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
401 +
402 +
403 +* (% style="color:blue" %)**TDC flag**
404 +
405 +When the flag is 1, it means sending packets at normal time intervals.
406 +
407 +Otherwise, it is a packet sent at non-TDC time.
408 +
409 +
410 +* (((
411 +(% style="color:#0000ff" %)**Alarm**
412 +)))
413 +
414 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
415 +
416 +
417 +* (((
418 +(% style="color:blue" %)**Status**
419 +)))
420 +
421 +This bit is 1 when the door sensor is open and 0 when it is close.
422 +
423 +
424 +* (((
425 +(% style="color:blue" %)**Total open door events**
426 +)))
427 +
428 +Total pulse/counting base on open door.
429 +
430 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
431 +
432 +
433 +* (((
434 +(% style="color:blue" %)**The last door open duration**
435 +)))
436 +
437 +Door sensor last open duration.
438 +
439 +Unit: sec.
440 +
441 +[[image:image-20230701094042-1.png||height="154" width="763"]]
442 +
443 +
444 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
445 +
446 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
447 +
448 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
449 +
450 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
451 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
452 +|(% 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**
453 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
454 +Status1 & Alarm1
455 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
456 +The last door open duration1 (unit: sec)
457 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
458 +Status2 & Alarm2
459 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
460 +
461 +**Status1 & Alarm1:**
462 +
463 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
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" %)(((
466 +Count mod
467 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
468 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
469 +)))|(% style="width:181px" %)(((
470 +Status1 0: Close; 1: Open (PA8 of pin)
471 +)))
472 +
473 +**Status2 & Alarm2:**
474 +
475 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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" %)(((
478 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
479 +)))|(% style="width:181px" %)(((
480 +Status2 0: Close; 1: Open (PA4 of pin)
481 +)))
482 +
337 337  [[image:image-20230630155908-6.png||height="295" width="927"]]
338 338  
339 339  
340 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
486 +* (((
487 +(% style="color:blue" %)Count mod:Default=0
488 +)))
341 341  
490 +MOD=0 ~-~-> Uplink total open door times since factory
342 342  
492 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
493 +
494 +
495 +* (% style="color:blue" %)**TDC flag**
496 +
497 +When the flag is 1, it means sending packets at normal time intervals.
498 +
499 +Otherwise, it is a packet sent at non-TDC time.
500 +
501 +
502 +* (((
503 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
504 +)))
505 +
506 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
507 +
508 +
509 +* (((
510 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
511 +)))
512 +
513 +This bit is 1 when the door sensor is open and 0 when it is close.
514 +
515 +
516 +* (((
517 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
518 +)))
519 +
520 +Total pulse/counting base on open door.
521 +
522 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
523 +
524 +
525 +* (((
526 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
527 +)))
528 +
529 +Door sensor last open duration.
530 +
531 +Unit: sec.
532 +
533 +[[image:image-20230701094042-1.png||height="154" width="763"]]
534 +
535 +
536 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
537 +
538 +
343 343  DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
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  
543 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
544 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
545 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
546 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
547 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
548 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
549 +The last door open duration (unit: sec)
550 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
551 +
552 +**Status & Alarm:**
553 +
554 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
555 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:65px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit0**
556 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
557 +Count mod
558 +)))|(% style="width:95px" %)(((
559 +TDC flag 0:No; 1:Yes
560 +)))|(% style="width:116px" %)(((
561 +Alarm 0: No Alarm; 1: Alarm
562 +)))|(% style="width:112px" %)(((
563 +Status 0:Close; 1: Open
564 +)))
565 +
347 347  * (((
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.
567 +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.
349 349  )))
350 350  
351 351  For example, in the US915 band, the max payload for different DR is:
... ... @@ -382,7 +382,7 @@
382 382  
383 383  **Parsed Value:**
384 384  
385 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
604 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
386 386  
387 387  
388 388  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -399,47 +399,9 @@
399 399  
400 400  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
401 401  
402 -[[image:image-20230630155751-5.png||height="188" width="809"]]
621 +[[image:image-20230630172740-1.png||height="199" width="868"]]
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  
641 +(% 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  
643 +
461 461  === 2.5.1 Ways to get datalog via LoRaWAN ===
462 462  
463 463  
... ... @@ -581,7 +581,7 @@
581 581  These commands only valid for DS03A-LB, as below:
582 582  
583 583  
584 -=== 3.3.1 Set Transmit Interval Time ===
767 +=== 3.3.1  Set Transmit Interval Time ===
585 585  
586 586  
587 587  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -609,25 +609,15 @@
609 609  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
610 610  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
611 611  
612 -=== 3.3.2 Get Device Status ===
795 +=== 3.3.2  Enable / Disable Alarm ===
613 613  
614 614  
615 -Send a LoRaWAN downlink to ask device send Alarm settings.
616 -
617 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
618 -
619 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
620 -
621 -
622 -=== 3.3.3  Enable / Disable Alarm ===
623 -
624 -
625 625  Feature: Enable/Disable Alarm for open/close event. Default value 0.
626 626  
627 627  (% style="color:blue" %)**AT Command: **
628 628  
629 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
630 -|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response**
802 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
803 +|(% style="background-color:#d9e2f3; color:#0070c0; width:153px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:276px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:86px" %)**Response**
631 631  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
632 632  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
633 633  
... ... @@ -638,7 +638,7 @@
638 638  0xA7 00  ~/~/ Same As AT+DISALARM=0
639 639  
640 640  
641 -=== 3.3.4  Alarm Base on Timeout ===
814 +=== 3.3.3  Alarm Base on Timeout ===
642 642  
643 643  
644 644  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:
... ... @@ -664,41 +664,107 @@
664 664  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.
665 665  
666 666  
840 +* (((
841 +(% style="color:blue" %)**Downlink Command**
842 +)))
843 +
844 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
845 +
846 +**A9:** Command Type Code
847 +
848 +**aa: **01:TTRIG1; 02:TTRIG2
849 +
850 +**bb:** status to be monitored
851 +
852 +**cc dd:** timeout.
853 +
854 +
855 +**1) AT+TTRIG1:(PA8 of pin)**
856 +
667 667  (% style="color:blue" %)**AT Command to configure:**
668 668  
669 669  * (((
670 -(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
860 +(% 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-LB 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.
861 +
862 +(% 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-LB 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.
671 671  )))
672 672  
673 673  * (((
674 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
866 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
867 +
868 +
869 +
675 675  )))
676 676  
677 677  (% style="color:blue" %)**Downlink Command to configure:**
678 678  
679 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
874 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
680 680  
681 -**A9:** Command Type Code
876 + 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
682 682  
683 -**aa:** status to be monitored
684 684  
685 -**bb cc:** timeout.
879 +**2) AT+TTRIG2:(PA4 of pin,need to use AT+TTRCHANNEL=2)**
686 686  
881 +(% style="color:blue" %)**AT Command to configure:**
687 687  
688 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
883 +* (((
884 +(% 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-LB 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.
689 689  
690 -Or
886 +(% 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-LB 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.
887 +)))
691 691  
692 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
889 +* (((
890 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
693 693  
694 694  
893 +
894 +)))
895 +
896 +(% style="color:blue" %)**Downlink Command to configure:**
897 +
898 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
899 +
900 + 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
901 +
902 +
903 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
904 +
905 +
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 +
908 +(% style="color:blue" %)**AT Command:**
909 +
910 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
911 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 279px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 76px;background-color:#D9E2F3;color:#0070C0" %)**Response**
912 +|(% style="width:155px" %)(((
913 +AT+TTRALARM=0
914 +)))|(% style="width:279px" %)(((
915 +disable continuous alarm
916 +)))|(% style="width:84px" %)(((
917 +OK
918 +)))
919 +|(% style="width:155px" %)(((
920 +AT+TTRALARM=60
921 +)))|(% style="width:279px" %)(((
922 +The alarm interval is 60 minutes (unit: minutes)
923 +)))|(% style="width:84px" %)(((
924 +OK
925 +)))
926 +
927 +(% style="color:blue" %)**Downlink Command:**
928 +
929 +Example:  0C aa  => AT+TTRALARM= aa
930 +
931 +
695 695  === 3.3.5  Count Mod ===
696 696  
697 697  
935 +Feature: Manually set the count mode.
936 +
698 698  (% style="color:blue" %)**AT Command:**
699 699  
700 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
701 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 277px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)**Response**
939 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
940 +|=(% 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**
702 702  |(% style="width:155px" %)(((
703 703  AT+COUNTMOD=0
704 704  )))|(% style="width:277px" %)(((
... ... @@ -709,7 +709,7 @@
709 709  |(% style="width:155px" %)(((
710 710  AT+COUNTMOD=1
711 711  )))|(% style="width:277px" %)(((
712 -the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
951 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
713 713  )))|(% style="width:86px" %)(((
714 714  OK
715 715  )))
... ... @@ -719,24 +719,26 @@
719 719  Example:  0B aa  => AT+COUNTMOD = second byte
720 720  
721 721  
722 -=== 3.3.6  Interrupt Pin Channel Mod ===
961 +=== 3.3.6  Number of channel of door sensors ===
723 723  
724 724  
964 +Feature: Set the number of door sensor channels.
965 +
725 725  (% style="color:blue" %)**AT Command:**
726 726  
727 727  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
728 -|=(% 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 +|=(% 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**
729 729  |(% style="width:155px" %)(((
730 730  AT+TTRCHANNEL=1
731 -)))|(% style="width:288px" %)(((
732 -set as single channel, only use PA8 pin as interrupt pin.
972 +)))|(% style="width:259px" %)(((
973 +Set as single channel, only use PA8 pin as interrupt pin.
733 733  )))|(% style="width:44px" %)(((
734 734  OK
735 735  )))
736 736  |(% style="width:155px" %)(((
737 737  AT+TTRCHANNEL=2
738 -)))|(% style="width:288px" %)(((
739 -is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
979 +)))|(% style="width:259px" %)(((
980 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
740 740  )))|(% style="width:44px" %)(((
741 741  OK
742 742  )))
... ... @@ -746,51 +746,92 @@
746 746  Example:  0D aa => AT+TTRCHANNEL = second byte
747 747  
748 748  
749 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
990 +=== 3.3.7  Set Time Sync Mode ===
750 750  
751 751  
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.
994 +
995 +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.
996 +
997 +(% style="color:blue" %)**AT Command:**
998 +
999 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
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**
1001 +|(% style="width:155px" %)(((
1002 +AT+SYNCMOD=1
1003 +)))|(% style="width:259px" %)(((
1004 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1005 +)))|(% style="width:44px" %)(((
1006 +OK
1007 +)))
1008 +|(% style="width:155px" %)(((
1009 +AT+SYNCMOD=1,8
1010 +)))|(% style="width:259px" %)(((
1011 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1012 +)))|(% style="width:44px" %)(((
1013 +OK
1014 +)))
1015 +|(% 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
1016 +
752 752  (% style="color:blue" %)**Downlink Command:**
753 753  
754 -Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1019 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
755 755  
1021 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
756 756  
757 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1023 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
758 758  
1025 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
759 759  
760 -(% style="color:blue" %)**Downlink Command:**
761 761  
762 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1028 +=== 3.3.8  Clear the open door times and the duration of the last open door ===
763 763  
764 764  
765 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1031 +(% style="color:blue" %)**AT Command:**
766 766  
1033 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1034 +|=(% 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**
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 +OK
1037 +)))
767 767  
768 -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.
1039 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
769 769  
1041 +The sensor will clear the open door times and the duration of the last open door.
1042 +
1043 +
1044 +=== 3.3.9  Set the count value of the number of open door ===
1045 +
1046 +
770 770  (% style="color:blue" %)**AT Command:**
771 771  
772 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
773 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 279px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 76px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1049 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1050 +|=(% 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**
774 774  |(% style="width:155px" %)(((
775 -AT+TTRALARM=0
776 -)))|(% style="width:279px" %)(((
777 -disable continuous alarm
778 -)))|(% style="width:84px" %)(((
1052 +AT+SETCNT=1,100
1053 +)))|(% style="width:259px" %)(((
1054 +Set the open door times of PA8 pin to 100 times.
1055 +)))|(% style="width:44px" %)(((
779 779  OK
780 780  )))
1058 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
781 781  |(% style="width:155px" %)(((
782 -AT+TTRALARM=60
783 -)))|(% style="width:279px" %)(((
784 -The alarm interval is 60 minutes (unit: minutes)
785 -)))|(% style="width:84px" %)(((
1060 +AT+SETCNT=2,50
1061 +)))|(% style="width:259px" %)(((
1062 +Set the open door times of PA4 pin to 100 times.
1063 +)))|(% style="width:44px" %)(((
786 786  OK
787 787  )))
788 788  
789 789  (% style="color:blue" %)**Downlink Command:**
790 790  
791 -Example:  0C aa  => AT+TTRALARM= aa
1069 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
792 792  
1071 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
793 793  
1073 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1074 +
1075 +
794 794  = 4. Battery & Power Consumption =
795 795  
796 796  
... ... @@ -810,9 +810,8 @@
810 810  
811 811  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
812 812  
1095 +Methods to Update Firmware:
813 813  
814 -**Methods to Update Firmware:**
815 -
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  
image-20230630172740-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content