Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 19.1
edited by Saxer Lin
on 2023/06/30 15:59
Change comment: There is no comment for this version
To version 34.47
edited by Xiaoling
on 2023/07/01 15:24
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
... ... @@ -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,46 +303,265 @@
303 303  Ex2: 0x0B49 = 2889mV
304 304  
305 305  
306 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
307 +=== 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: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 +
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 -* 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"]].
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.
368 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)**
315 315  
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)
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)
321 321  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
322 322  
323 323  **Status & Alarm:**
324 324  
325 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
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 +)))
333 333  
334 334  [[image:image-20230630155451-2.png||height="246" width="928"]]
335 335  
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**.
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 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
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 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
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 +
336 336  [[image:image-20230630155908-6.png||height="295" width="927"]]
337 337  
338 338  
339 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
486 +* (((
487 +(% id="cke_bm_695345S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Count mod:Default=0**
488 +)))
340 340  
490 +MOD=0 ~-~-> Uplink total open door times since factory
341 341  
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>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#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 +
342 342  DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
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  
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.4A0AlarmBaseonTimeout"]]
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 +
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  )))
... ... @@ -381,7 +381,7 @@
381 381  
382 382  **Parsed Value:**
383 383  
384 -[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]
385 385  
386 386  
387 387  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -398,46 +398,9 @@
398 398  
399 399  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
400 400  
401 -[[image:image-20230630155751-5.png||height="188" width="809"]]
621 +[[image:image-20230630172740-1.png||height="199" width="868"]]
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  
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.**
458 458  
643 +
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  
... ... @@ -580,7 +580,7 @@
580 580  These commands only valid for DS03A-LB, as below:
581 581  
582 582  
583 -=== 3.3.1 Set Transmit Interval Time ===
767 +=== 3.3.1  Set Transmit Interval Time ===
584 584  
585 585  
586 586  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -608,26 +608,15 @@
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  
795 +=== 3.3.2  Enable / Disable Alarm ===
611 611  
612 -=== 3.3.2 Get Device Status ===
613 613  
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  
... ... @@ -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  
image-20230630160843-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +511.7 KB
Content
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