Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 20.1
edited by Saxer Lin
on 2023/06/30 16:08
Change comment: Uploaded new attachment "image-20230630160843-7.png", version {1}
To version 35.1
edited by Saxer Lin
on 2023/07/10 13:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -155,9 +155,14 @@
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 ==
158 +== 1.8 Pin Definitions ==
159 159  
160 +[[image:image-20230630160843-7.png]]
160 160  
162 +
163 +== 1.9 Mechanical ==
164 +
165 +
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  
... ... @@ -239,7 +239,6 @@
239 239  
240 240  The Payload format is as below.
241 241  
242 -
243 243  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
244 244  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
245 245  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -303,48 +303,271 @@
303 303  Ex2: 0x0B49 = 2889mV
304 304  
305 305  
306 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
310 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
307 307  
308 308  
313 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
314 +
315 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
316 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
317 +|**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**
318 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
319 +Keep status1
320 +)))|(% style="width:99px" %)(((
321 +Keep time1(unit: sec)
322 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
323 +Keep time2(unit: sec)
324 +)))|(% style="width:98px" %)(((
325 +Alarm interval(unit: min)
326 +)))
327 +
328 +Example parse in TTNv3
329 +
330 +[[image:image-20230630155527-3.png||height="146" width="902"]]
331 +
332 +
333 +* (((
334 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
335 +)))
336 +
337 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
338 +
339 +
340 +* (((
341 +(% style="color:blue" %)**Disalarm: (default: 0)**
342 +)))
343 +
344 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
345 +
346 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
347 +
348 +
349 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
350 +
351 +
352 +* (((
353 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
354 +)))
355 +
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
357 +
358 +
359 +
360 +* (((
361 +(% style="color:blue" %)**Alarm interval(default: 0)**
362 +)))
363 +
364 +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.
365 +
366 +
367 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
368 +
369 +
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"]].
372 +* 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.
375 +**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)
379 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
380 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
381 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
382 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
383 +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
389 +|(% 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**
390 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
391 +Count mod
392 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
393 +Alarm 0: No Alarm; 1: Alarm
394 +)))|(% style="width:131px" %)(((
395 +Status 0: Close; 1: Open
396 +)))
333 333  
334 334  [[image:image-20230630155451-2.png||height="246" width="928"]]
335 335  
400 +
401 +* (((
402 +(% style="color:blue" %)**Count mod:Default=0**
403 +)))
404 +
405 +0: Uplink total open door times since factory
406 +
407 +1: Uplink total open door times since last FPORT=2 uplink.
408 +
409 +
410 +* (% style="color:blue" %)**TDC flag**
411 +
412 +When the flag is 1, it means sending packets at normal time intervals.
413 +
414 +Otherwise, it is a packet sent at non-TDC time.
415 +
416 +
417 +* (((
418 +(% style="color:#0000ff" %)**Alarm**
419 +)))
420 +
421 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
422 +
423 +
424 +* (((
425 +(% style="color:blue" %)**Status**
426 +)))
427 +
428 +This bit is 1 when the door sensor is open and 0 when it is close.
429 +
430 +
431 +* (((
432 +(% style="color:blue" %)**Total open door events**
433 +)))
434 +
435 +Total pulse/counting base on open door.
436 +
437 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
438 +
439 +
440 +* (((
441 +(% style="color:blue" %)**The last door open duration**
442 +)))
443 +
444 +Door sensor last open duration.
445 +
446 +Unit: sec.
447 +
448 +[[image:image-20230701094042-1.png||height="154" width="763"]]
449 +
450 +
451 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
452 +
453 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
454 +
455 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
456 +
457 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
458 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
459 +|(% 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**
460 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
461 +Status1 & Alarm1
462 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
463 +The last door open duration1 (unit: sec)
464 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
465 +Status2 & Alarm2
466 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
467 +
468 +**Status1 & Alarm1:**
469 +
470 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
471 +|(% 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**
472 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
473 +Count mod
474 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
475 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
476 +)))|(% style="width:181px" %)(((
477 +Status1 0: Close; 1: Open (PA8 of pin)
478 +)))
479 +
480 +**Status2 & Alarm2:**
481 +
482 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
483 +|(% 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**
484 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
485 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
486 +)))|(% style="width:181px" %)(((
487 +Status2 0: Close; 1: Open (PA4 of pin)
488 +)))
489 +
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 ===
493 +* (((
494 +(% style="color:blue" %)**Count mod:Default=0**
495 +)))
340 340  
497 +0: Uplink total open door times since factory
341 341  
499 +1: Uplink total open door times since last FPORT=2 uplink.
500 +
501 +
502 +* (% style="color:blue" %)**TDC flag**
503 +
504 +When the flag is 1, it means sending packets at normal time intervals.
505 +
506 +Otherwise, it is a packet sent at non-TDC time.
507 +
508 +
509 +* (((
510 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
511 +)))
512 +
513 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
514 +
515 +
516 +* (((
517 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
518 +)))
519 +
520 +This bit is 1 when the door sensor is open and 0 when it is close.
521 +
522 +
523 +* (((
524 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
525 +)))
526 +
527 +Total pulse/counting base on open door.
528 +
529 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
530 +
531 +
532 +* (((
533 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
534 +)))
535 +
536 +Door sensor last open duration.
537 +
538 +Unit: sec.
539 +
540 +[[image:image-20230701094042-1.png||height="154" width="763"]]
541 +
542 +
543 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
544 +
545 +
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  
550 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
551 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
552 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
553 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
554 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
555 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
556 +The last door open duration (unit: sec)
557 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
558 +
559 +**Status & Alarm:**
560 +
561 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
562 +|(% 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**
563 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
564 +Count mod
565 +)))|(% style="width:95px" %)(((
566 +TDC flag 0:No; 1:Yes
567 +)))|(% style="width:116px" %)(((
568 +Alarm 0: No Alarm; 1: Alarm
569 +)))|(% style="width:112px" %)(((
570 +Status 0:Close; 1: Open
571 +)))
572 +
346 346  * (((
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.
574 +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.
348 348  )))
349 349  
350 350  For example, in the US915 band, the max payload for different DR is:
... ... @@ -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]
611 +[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"]]
628 +[[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  
648 +(% 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  
650 +
459 459  === 2.5.1 Ways to get datalog via LoRaWAN ===
460 460  
461 461  
... ... @@ -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 ===
775 +=== 3.3.1  Set Transmit Interval Time ===
584 584  
585 585  
586 586  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -609,25 +609,15 @@
609 609  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
610 610  
611 611  
612 -=== 3.3.2 Get Device Status ===
804 +=== 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**
811 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
812 +|(% 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,12 +638,11 @@
638 638  0xA7 00  ~/~/ Same As AT+DISALARM=0
639 639  
640 640  
641 -=== 3.3.4  Alarm Base on Timeout ===
823 +=== 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:
645 645  
646 -
647 647  * (((
648 648  (% style="color:blue" %)**Keep Status: Status to be monitor**
649 649  )))
... ... @@ -664,41 +664,103 @@
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  
848 +* (((
849 +(% style="color:blue" %)**Downlink Command**
850 +)))
851 +
852 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
853 +
854 +**A9:** Command Type Code
855 +
856 +**aa: **01:TTRIG1; 02:TTRIG2
857 +
858 +**bb:** status to be monitored
859 +
860 +**cc dd:** timeout.
861 +
862 +
863 +**1) AT+TTRIG1 : (PA8 of pin)**
864 +
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.
868 +(% 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.
869 +
870 +(% 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.
874 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
875 +
876 +
877 +
675 675  )))
676 676  
677 677  (% style="color:blue" %)**Downlink Command to configure:**
678 678  
679 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
882 +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.
680 680  
681 -**A9:** Command Type Code
682 682  
683 -**aa:** status to be monitored
885 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
684 684  
685 -**bb cc:** timeout.
887 +(% style="color:blue" %)**AT Command to configure:**
686 686  
889 +* (((
890 +(% 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.
687 687  
688 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
892 +(% 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.
893 +)))
689 689  
690 -Or
895 +* (((
896 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
691 691  
692 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
693 693  
899 +
900 +)))
694 694  
902 +(% style="color:blue" %)**Downlink Command to configure:**
903 +
904 +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.
905 +
906 +
907 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
908 +
909 +
910 +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.
911 +
912 +(% style="color:blue" %)**AT Command:**
913 +
914 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
915 +|=(% 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**
916 +|(% style="width:155px" %)(((
917 +AT+TTRALARM=0
918 +)))|(% style="width:279px" %)(((
919 +disable continuous alarm
920 +)))|(% style="width:84px" %)(((
921 +OK
922 +)))
923 +|(% style="width:155px" %)(((
924 +AT+TTRALARM=60
925 +)))|(% style="width:279px" %)(((
926 +The alarm interval is 60 minutes (unit: minutes)
927 +)))|(% style="width:84px" %)(((
928 +OK
929 +)))
930 +
931 +(% style="color:blue" %)**Downlink Command:**
932 +
933 +Example:  0C aa  => AT+TTRALARM= aa
934 +
935 +
695 695  === 3.3.5  Count Mod ===
696 696  
697 697  
939 +Feature: Manually set the count mode.
940 +
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**
943 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
944 +|=(% 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）
955 +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 ===
965 +=== 3.3.6  Number of channel of door sensors ===
723 723  
724 724  
968 +Feature: Set the number of door sensor channels.
969 +
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**
973 +|=(% 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.
976 +)))|(% style="width:259px" %)(((
977 +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.
983 +)))|(% style="width:259px" %)(((
984 +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 ===
994 +=== 3.3.7  Set Time Sync Mode ===
750 750  
751 751  
752 -(% style="color:blue" %)**Downlink Command:**
997 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
753 753  
754 -Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
999 +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.
755 755  
1001 +(% style="color:blue" %)**AT Command:**
756 756  
757 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1003 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1004 +|=(% 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**
1005 +|(% style="width:155px" %)(((
1006 +AT+SYNCMOD=1
1007 +)))|(% style="width:259px" %)(((
1008 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1009 +)))|(% style="width:44px" %)(((
1010 +OK
1011 +)))
1012 +|(% style="width:155px" %)(((
1013 +AT+SYNCMOD=1,8
1014 +)))|(% style="width:259px" %)(((
1015 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1016 +)))|(% style="width:44px" %)(((
1017 +OK
1018 +)))
1019 +|(% 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
758 758  
759 -
760 760  (% style="color:blue" %)**Downlink Command:**
761 761  
762 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1023 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
763 763  
1025 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
764 764  
765 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1027 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
766 766  
1029 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
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.
769 769  
1032 +=== 3.3.8  Clear the open door times and the duration of the last open door ===
1033 +
1034 +
770 770  (% style="color:blue" %)**AT Command:**
771 771  
772 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**
1038 +|=(% style="width: 163px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 290px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1039 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1040 +OK
1041 +)))
1042 +
1043 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1044 +
1045 +The sensor will clear the open door times and the duration of the last open door.
1046 +
1047 +
1048 +=== 3.3.9  Set the count value of the number of open door ===
1049 +
1050 +
1051 +(% style="color:blue" %)**AT Command:**
1052 +
1053 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1054 +|=(% 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" %)(((
1056 +AT+SETCNT=1,100
1057 +)))|(% style="width:259px" %)(((
1058 +Set the open door times of PA8 pin to 100 times.
1059 +)))|(% style="width:44px" %)(((
779 779  OK
780 780  )))
1062 +|(% 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" %)(((
1064 +AT+SETCNT=2,50
1065 +)))|(% style="width:259px" %)(((
1066 +Set the open door times of PA4 pin to 100 times.
1067 +)))|(% 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
1073 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
792 792  
1075 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
793 793  
1077 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1078 +
1079 +
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  
1099 +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