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

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -71,6 +71,7 @@
71 71  * Wall Mountable
72 72  * Outdoor Use
73 73  
74 +
74 74  == 1.3 Specification ==
75 75  
76 76  
... ... @@ -104,6 +104,7 @@
104 104  * Sleep Mode: 5uA @ 3.3v
105 105  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
106 106  
108 +
107 107  == 1.4 Applications ==
108 108  
109 109  
... ... @@ -137,6 +137,7 @@
137 137  )))
138 138  |(% 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.
139 139  
142 +
140 140  == 1.7 BLE connection ==
141 141  
142 142  
... ... @@ -152,13 +152,9 @@
152 152  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
153 153  
154 154  
155 -== 1.8 Pin Definitions ==
158 +== 1.8 Mechanical ==
156 156  
157 -[[image:image-20230630160843-7.png]]
158 158  
159 -== 1.9 Mechanical ==
160 -
161 -
162 162  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
163 163  
164 164  
... ... @@ -304,267 +304,48 @@
304 304  Ex2: 0x0B49 = 2889mV
305 305  
306 306  
307 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
306 +=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
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 -
363 363  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
364 364  
365 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
311 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
366 366  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
367 367  
368 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
314 +Uplink Payload totals 11 bytes.
369 369  
370 370  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
371 371  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
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)
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)
377 377  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
378 378  
379 379  **Status & Alarm:**
380 380  
381 381  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
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 -)))
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
390 390  
391 391  [[image:image-20230630155451-2.png||height="246" width="928"]]
392 392  
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 -
483 483  [[image:image-20230630155908-6.png||height="295" width="927"]]
484 484  
485 485  
486 -* (((
487 -(% style="color:blue" %)Count mod:Default=0
488 -)))
339 +=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
489 489  
490 -MOD=0 ~-~-> Uplink total open door times since factory
491 491  
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 -
539 539  DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
540 540  
541 541  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
542 542  
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 -
566 566  * (((
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.
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.
568 568  )))
569 569  
570 570  For example, in the US915 band, the max payload for different DR is:
... ... @@ -601,7 +601,7 @@
601 601  
602 602  **Parsed Value:**
603 603  
604 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
384 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
605 605  
606 606  
607 607  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -618,9 +618,46 @@
618 618  
619 619  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
620 620  
621 -[[image:image-20230630172740-1.png||height="199" width="868"]]
401 +[[image:image-20230630155751-5.png||height="188" width="809"]]
622 622  
403 +=== 2.3.4  Sensor Configuration, FPORT~=4 ===
623 623  
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 +
624 624  == 2.4 Payload Decoder file ==
625 625  
626 626  
... ... @@ -638,9 +638,7 @@
638 638  
639 639  (% 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.
640 640  
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.**
642 642  
643 -
644 644  === 2.5.1 Ways to get datalog via LoRaWAN ===
645 645  
646 646  
... ... @@ -745,6 +745,7 @@
745 745  * 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]].
746 746  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
747 747  
563 +
748 748  == 3.2 General Commands ==
749 749  
750 750  
... ... @@ -764,7 +764,7 @@
764 764  These commands only valid for DS03A-LB, as below:
765 765  
766 766  
767 -=== 3.3.1  Set Transmit Interval Time ===
583 +=== 3.3.1 Set Transmit Interval Time ===
768 768  
769 769  
770 770  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -792,15 +792,26 @@
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 / Disable Alarm ===
796 796  
612 +=== 3.3.2 Get Device Status ===
797 797  
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 +
798 798  Feature: Enable/Disable Alarm for open/close event. Default value 0.
799 799  
800 800  (% style="color:blue" %)**AT Command: **
801 801  
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**
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**
804 804  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
805 805  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
806 806  
... ... @@ -811,11 +811,12 @@
811 811  0xA7 00  ~/~/ Same As AT+DISALARM=0
812 812  
813 813  
814 -=== 3.3.3  Alarm Base on Timeout ===
641 +=== 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  
646 +
819 819  * (((
820 820  (% style="color:blue" %)**Keep Status: Status to be monitor**
821 821  )))
... ... @@ -836,103 +836,41 @@
836 836  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.
837 837  
838 838  
839 -* (((
840 -(% style="color:blue" %)**Downlink Command**
841 -)))
842 -
843 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
844 -
845 -**A9:** Command Type Code
846 -
847 -**aa: **01:TTRIG1; 02:TTRIG2
848 -
849 -**bb:** status to be monitored
850 -
851 -**cc dd:** timeout.
852 -
853 -
854 -**1) AT+TTRIG1:(PA8 of pin)**
855 -
856 856  (% style="color:blue" %)**AT Command to configure:**
857 857  
858 858  * (((
859 -(% 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.
860 -
861 -(% 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.
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.
862 862  )))
863 863  
864 864  * (((
865 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
866 -
867 -
868 -
674 +(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
869 869  )))
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** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
679 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
874 874  
681 +**A9:** Command Type Code
875 875  
876 -**2) AT+TTRIG2:(PA4 of pin,need to use AT+TTRCHANNEL=2)**
683 +**aa:** status to be monitored
877 877  
878 -(% style="color:blue" %)**AT Command to configure:**
685 +**bb cc:** timeout.
879 879  
880 -* (((
881 -(% 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.
882 882  
883 -(% 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.
884 -)))
688 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
885 885  
886 -* (((
887 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
690 +Or
888 888  
692 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
889 889  
890 -
891 -)))
892 892  
893 -(% style="color:blue" %)**Downlink Command to configure:**
894 -
895 -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.
896 -
897 -
898 -=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
899 -
900 -
901 -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.
902 -
903 -(% style="color:blue" %)**AT Command:**
904 -
905 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
906 -|=(% 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**
907 -|(% style="width:155px" %)(((
908 -AT+TTRALARM=0
909 -)))|(% style="width:279px" %)(((
910 -disable continuous alarm
911 -)))|(% style="width:84px" %)(((
912 -OK
913 -)))
914 -|(% style="width:155px" %)(((
915 -AT+TTRALARM=60
916 -)))|(% style="width:279px" %)(((
917 -The alarm interval is 60 minutes (unit: minutes)
918 -)))|(% style="width:84px" %)(((
919 -OK
920 -)))
921 -
922 -(% style="color:blue" %)**Downlink Command:**
923 -
924 -Example:  0C aa  => AT+TTRALARM= aa
925 -
926 -
927 927  === 3.3.5  Count Mod ===
928 928  
929 929  
930 -Feature: Manually set the count mode.
931 -
932 932  (% style="color:blue" %)**AT Command:**
933 933  
934 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
935 -|=(% 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**
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**
936 936  |(% style="width:155px" %)(((
937 937  AT+COUNTMOD=0
938 938  )))|(% style="width:277px" %)(((
... ... @@ -943,7 +943,7 @@
943 943  |(% style="width:155px" %)(((
944 944  AT+COUNTMOD=1
945 945  )))|(% style="width:277px" %)(((
946 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
712 +the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
947 947  )))|(% style="width:86px" %)(((
948 948  OK
949 949  )))
... ... @@ -953,26 +953,24 @@
953 953  Example:  0B aa  => AT+COUNTMOD = second byte
954 954  
955 955  
956 -=== 3.3.6  Number of channel of door sensors ===
722 +=== 3.3.6  Interrupt Pin Channel Mod ===
957 957  
958 958  
959 -Feature: Set the number of door sensor channels.
960 -
961 961  (% style="color:blue" %)**AT Command:**
962 962  
963 963  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
964 -|=(% 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**
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**
965 965  |(% style="width:155px" %)(((
966 966  AT+TTRCHANNEL=1
967 -)))|(% style="width:259px" %)(((
968 -Set as single channel, only use PA8 pin as interrupt pin.
731 +)))|(% style="width:288px" %)(((
732 +set as single channel, only use PA8 pin as interrupt pin.
969 969  )))|(% style="width:44px" %)(((
970 970  OK
971 971  )))
972 972  |(% style="width:155px" %)(((
973 973  AT+TTRCHANNEL=2
974 -)))|(% style="width:259px" %)(((
975 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
738 +)))|(% style="width:288px" %)(((
739 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
976 976  )))|(% style="width:44px" %)(((
977 977  OK
978 978  )))
... ... @@ -982,92 +982,51 @@
982 982  Example:  0D aa => AT+TTRCHANNEL = second byte
983 983  
984 984  
985 -=== 3.3.7  Set Time Sync Mode ===
749 +=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
986 986  
987 987  
988 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
989 -
990 -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.
991 -
992 -(% style="color:blue" %)**AT Command:**
993 -
994 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
995 -|=(% 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**
996 -|(% style="width:155px" %)(((
997 -AT+SYNCMOD=1
998 -)))|(% style="width:259px" %)(((
999 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1000 -)))|(% style="width:44px" %)(((
1001 -OK
1002 -)))
1003 -|(% style="width:155px" %)(((
1004 -AT+SYNCMOD=1,8
1005 -)))|(% style="width:259px" %)(((
1006 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1007 -)))|(% style="width:44px" %)(((
1008 -OK
1009 -)))
1010 -|(% 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
1011 -
1012 1012  (% style="color:blue" %)**Downlink Command:**
1013 1013  
1014 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
754 +Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1015 1015  
1016 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1017 1017  
1018 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
757 +=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1019 1019  
1020 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1021 1021  
760 +(% style="color:blue" %)**Downlink Command:**
1022 1022  
1023 -=== 3.3.8  Clear the open door times and the duration of the last open door ===
762 +Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1024 1024  
1025 1025  
1026 -(% style="color:blue" %)**AT Command:**
765 +=== 3.3.9  TTRIG1/2 timeout status alarm ===
1027 1027  
1028 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1029 -|=(% 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**
1030 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1031 -OK
1032 -)))
1033 1033  
1034 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
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.
1035 1035  
1036 -The sensor will clear the open door times and the duration of the last open door.
1037 -
1038 -
1039 -=== 3.3.9  Set the count value of the number of open door ===
1040 -
1041 -
1042 1042  (% style="color:blue" %)**AT Command:**
1043 1043  
1044 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1045 -|=(% 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**
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**
1046 1046  |(% style="width:155px" %)(((
1047 -AT+SETCNT=1,100
1048 -)))|(% style="width:259px" %)(((
1049 -Set the open door times of PA8 pin to 100 times.
1050 -)))|(% style="width:44px" %)(((
775 +AT+TTRALARM=0
776 +)))|(% style="width:279px" %)(((
777 +disable continuous alarm
778 +)))|(% style="width:84px" %)(((
1051 1051  OK
1052 1052  )))
1053 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1054 1054  |(% style="width:155px" %)(((
1055 -AT+SETCNT=2,50
1056 -)))|(% style="width:259px" %)(((
1057 -Set the open door times of PA4 pin to 100 times.
1058 -)))|(% style="width:44px" %)(((
782 +AT+TTRALARM=60
783 +)))|(% style="width:279px" %)(((
784 +The alarm interval is 60 minutes (unit: minutes)
785 +)))|(% style="width:84px" %)(((
1059 1059  OK
1060 1060  )))
1061 1061  
1062 1062  (% style="color:blue" %)**Downlink Command:**
1063 1063  
1064 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
791 +Example:  0C aa  => AT+TTRALARM= aa
1065 1065  
1066 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1067 1067  
1068 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1069 -
1070 -
1071 1071  = 4. Battery & Power Consumption =
1072 1072  
1073 1073  
... ... @@ -1087,11 +1087,13 @@
1087 1087  
1088 1088  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1089 1089  
1090 -Methods to Update Firmware:
1091 1091  
814 +**Methods to Update Firmware:**
815 +
1092 1092  * (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/]]**
1093 1093  * 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]]**.
1094 1094  
819 +
1095 1095  = 6. FAQ =
1096 1096  
1097 1097  
... ... @@ -1119,6 +1119,7 @@
1119 1119  
1120 1120  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1121 1121  
847 +
1122 1122  = 8. ​Packing Info =
1123 1123  
1124 1124  
... ... @@ -1136,6 +1136,7 @@
1136 1136  
1137 1137  * Weight / pcs : g
1138 1138  
865 +
1139 1139  = 9. Support =
1140 1140  
1141 1141  
image-20230630160843-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -511.7 KB
Content
image-20230630172740-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -34.5 KB
Content