Last modified by Mengting Qiu on 2025/07/03 16:36

From version 38.9
edited by Xiaoling
on 2023/12/14 14:45
Change comment: There is no comment for this version
To version 25.1
edited by Saxer Lin
on 2023/06/30 17:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DS03A-LB -- Outdoor LoRaWAN Door Sensor User Manual
1 +DS03A-LB Outdoor LoRaWAN Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -2,7 +2,7 @@
2 2  [[image:image-20230516085523-1.jpeg||height="491" width="491"]]
3 3  
4 4  
5 -**Table of Contents:**
5 +**Table of Contents**
6 6  
7 7  {{toc/}}
8 8  
... ... @@ -79,6 +79,11 @@
79 79  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
80 80  * Operating Temperature: -40 ~~ 85°C
81 81  
82 +(% style="color:#037691" %)**Sensor Detect Distance:**
83 +
84 +* Wood Door: 10mm ~~ 30mm
85 +* Iron Door: 30 ~~ 45mm
86 +
82 82  (% style="color:#037691" %)**LoRa Spec:**
83 83  
84 84  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -151,7 +151,6 @@
151 151  
152 152  [[image:image-20230630160843-7.png]]
153 153  
154 -
155 155  == 1.9 Mechanical ==
156 156  
157 157  
... ... @@ -167,12 +167,6 @@
167 167  [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
168 168  
169 169  
170 -== 1.10 Magnet Distance ==
171 -
172 -
173 -* Wood Door: 10mm ~~ 30mm
174 -* Iron Door: 30 ~~ 45mm
175 -
176 176  = 2. Configure DS03A-LB to connect to LoRaWAN network =
177 177  
178 178  == 2.1 How it works ==
... ... @@ -238,13 +238,11 @@
238 238  === 2.3.1 Device Status, FPORT~=5 ===
239 239  
240 240  
241 -Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours.
239 +Users can use the downlink command(**0x26 01**) to ask DS03A-LB to send device configure detail, include device configure status. DS03A-LB will uplink a payload via FPort=5 to server.
242 242  
243 -Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
244 -
245 -
246 246  The Payload format is as below.
247 247  
243 +
248 248  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
249 249  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
250 250  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -308,29 +308,32 @@
308 308  Ex2: 0x0B49 = 2889mV
309 309  
310 310  
311 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
307 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
312 312  
313 313  
314 -DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
315 315  
316 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
317 -|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
318 -|**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**
312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:723px" %)
313 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:721px" %)**Sensor Configuration FPORT=4**
314 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:99px" %)**2**|(% style="width:87px" %)**1**|(% style="width:97px" %)**2**|(% style="width:98px" %)**1**
319 319  |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
320 320  Keep status1
317 +
318 +
321 321  )))|(% style="width:99px" %)(((
322 -Keep time1(unit: sec)
320 +Keep time1
321 +
322 +(unit: sec)
323 323  )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
324 -Keep time2(unit: sec)
324 +Keep time2
325 +
326 +(unit: sec)
325 325  )))|(% style="width:98px" %)(((
326 -Alarm interval(unit: min)
328 +Alarm interval
329 +
330 +(unit: min)
327 327  )))
328 328  
329 -Example parse in TTNv3
330 -
331 -[[image:image-20230630155527-3.png||height="146" width="902"]]
332 -
333 -
334 334  * (((
335 335  (% style="color:blue" %)**TDC: (default: 0x001C20)**
336 336  )))
... ... @@ -354,8 +354,9 @@
354 354  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
355 355  )))
356 356  
357 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
358 358  
358 +[[image:image-20230630155527-3.png||height="146" width="902"]]
359 359  
360 360  
361 361  * (((
... ... @@ -370,16 +370,19 @@
370 370  
371 371  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
372 372  
373 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
373 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
374 374  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
375 375  
376 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
377 377  
377 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**)
378 +
378 378  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
379 379  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
380 380  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
381 381  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
382 -Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
383 +Status
384 +
385 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
383 383  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
384 384  The last door open duration (unit: sec)
385 385  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -386,161 +386,73 @@
386 386  
387 387  **Status & Alarm:**
388 388  
389 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
390 -|(% 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**
391 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
392 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:645px" %)
393 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:125px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit0**
394 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
392 392  Count mod
393 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
394 -Alarm 0: No Alarm; 1: Alarm
395 -)))|(% style="width:131px" %)(((
396 -Status 0: Close; 1: Open
397 -)))
396 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:125px" %)(((
397 +0: No Alarm;
398 398  
399 -[[image:image-20230630155451-2.png||height="246" width="928"]]
399 +1: Alarm
400 +)))|(% style="width:129px" %)(((
401 +Status 0: Close;
400 400  
401 -
402 -* (((
403 -(% style="color:blue" %)**Count mod:Default=0**
403 +1: Open
404 404  )))
405 405  
406 -0: Uplink total open door times since factory
406 +[[image:image-20230630155451-2.png||height="246" width="928"]]
407 407  
408 -1: Uplink total open door times since last FPORT=2 uplink.
409 409  
409 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes.
410 410  
411 -* (% style="color:blue" %)**TDC flag**
412 -
413 -When the flag is 1, it means sending packets at normal time intervals.
414 -
415 -Otherwise, it is a packet sent at non-TDC time.
416 -
417 -
418 -* (((
419 -(% style="color:#0000ff" %)**Alarm**
420 -)))
421 -
422 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
423 -
424 -
425 -* (((
426 -(% style="color:blue" %)**Status**
427 -)))
428 -
429 -This bit is 1 when the door sensor is open and 0 when it is close.
430 -
431 -
432 -* (((
433 -(% style="color:blue" %)**Total open door events**
434 -)))
435 -
436 -Total pulse/counting base on open door.
437 -
438 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
439 -
440 -
441 -* (((
442 -(% style="color:blue" %)**The last door open duration**
443 -)))
444 -
445 -Door sensor last open duration.
446 -
447 -Unit: sec.
448 -
449 -[[image:image-20230701094042-1.png||height="154" width="763"]]
450 -
451 -
452 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
453 -
454 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
455 -
456 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
457 -
458 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
459 -|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
460 -|(% 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**
411 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %)
412 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2**
413 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:125px" %)**3**|(% style="width:100px" %)**4**|(% style="width:86px" %)**1**|(% style="width:96px" %)**3**|(% style="width:126px" %)**3**
461 461  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
462 -Status1 & Alarm1
415 +Status1
416 +
417 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
463 463  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
464 464  The last door open duration1 (unit: sec)
465 465  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
466 -Status2 & Alarm2
421 +Status2
422 +
423 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
467 467  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
468 468  
469 469  **Status1 & Alarm1:**
470 470  
471 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
472 -|(% 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**
473 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
428 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:730px" %)
429 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:167px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:171px" %)**bit0**
430 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
474 474  Count mod
475 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
476 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
477 -)))|(% style="width:181px" %)(((
478 -Status1 0: Close; 1: Open (PA8 of pin)
479 -)))
432 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)(((
433 +0: No Alarm; 1: Alarm
480 480  
481 -**Status2 & Alarm2:**
435 +(PA8)
436 +)))|(% style="width:171px" %)(((
437 +Status 0: Close; 1:Open
482 482  
483 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
484 -|(% 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**
485 -|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
486 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
487 -)))|(% style="width:181px" %)(((
488 -Status2 0: Close; 1: Open (PA4 of pin)
439 +(PA8)
489 489  )))
490 490  
491 -[[image:image-20230630155908-6.png||height="295" width="927"]]
442 +**Status2 & Alarm2:**
492 492  
444 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:550px" %)
445 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:113px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:176px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:175px" %)**bit0**
446 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:176px" %)(((
447 +0: No Alarm; 1: Alarm
493 493  
494 -* (((
495 -(% style="color:blue" %)**Count mod:Default=0**
496 -)))
449 +(PA4)
450 +)))|(% style="width:175px" %)(((
451 +Status 0: Close,;1:Open
497 497  
498 -0: Uplink total open door times since factory
499 -
500 -1: Uplink total open door times since last FPORT=2 uplink.
501 -
502 -
503 -* (% style="color:blue" %)**TDC flag**
504 -
505 -When the flag is 1, it means sending packets at normal time intervals.
506 -
507 -Otherwise, it is a packet sent at non-TDC time.
508 -
509 -
510 -* (((
511 -(% style="color:#0000ff" %)**Alarm1 or Alarm2**
453 +(PA4)
512 512  )))
513 513  
514 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
456 +[[image:image-20230630155908-6.png||height="295" width="927"]]
515 515  
516 516  
517 -* (((
518 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
519 -)))
520 -
521 -This bit is 1 when the door sensor is open and 0 when it is close.
522 -
523 -
524 -* (((
525 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
526 -)))
527 -
528 -Total pulse/counting base on open door.
529 -
530 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
531 -
532 -
533 -* (((
534 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
535 -)))
536 -
537 -Door sensor last open duration.
538 -
539 -Unit: sec.
540 -
541 -[[image:image-20230701094042-1.png||height="154" width="763"]]
542 -
543 -
544 544  === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
545 545  
546 546  
... ... @@ -548,11 +548,13 @@
548 548  
549 549  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
550 550  
551 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
466 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
552 552  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
553 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
468 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
554 554  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
555 -Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
470 +Status
471 +
472 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
556 556  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
557 557  The last door open duration (unit: sec)
558 558  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -559,20 +559,22 @@
559 559  
560 560  **Status & Alarm:**
561 561  
562 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
563 -|(% 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**
564 -|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
479 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %)
480 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:92px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:89px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:90px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:116px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:112px" %)**bit0**
481 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
565 565  Count mod
566 -)))|(% style="width:95px" %)(((
567 -TDC flag 0:No; 1:Yes
568 -)))|(% style="width:116px" %)(((
569 -Alarm 0: No Alarm; 1: Alarm
483 +)))|(% style="width:95px" %)TDC flag 0:No;1:Yes|(% style="width:116px" %)(((
484 +0: No Alarm;
485 +
486 +1: Alarm
570 570  )))|(% style="width:112px" %)(((
571 -Status 0:Close; 1: Open
488 +Status 0:Close;
489 +
490 +1: Open
572 572  )))
573 573  
574 574  * (((
575 -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.
494 +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.
576 576  )))
577 577  
578 578  For example, in the US915 band, the max payload for different DR is:
... ... @@ -609,7 +609,7 @@
609 609  
610 610  **Parsed Value:**
611 611  
612 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
531 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
613 613  
614 614  
615 615  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -626,7 +626,7 @@
626 626  
627 627  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
628 628  
629 -[[image:image-20230630172740-1.png||height="199" width="868"]]
548 +[[image:image-20230630155751-5.png||height="188" width="809"]]
630 630  
631 631  
632 632  == 2.4 Payload Decoder file ==
... ... @@ -772,7 +772,7 @@
772 772  These commands only valid for DS03A-LB, as below:
773 773  
774 774  
775 -=== 3.3.1  Set Transmit Interval Time ===
694 +=== 3.3.1 Set Transmit Interval Time ===
776 776  
777 777  
778 778  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -800,36 +800,16 @@
800 800  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
801 801  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
802 802  
803 -=== 3.3.2  Set Power Output Duration ===
722 +=== 3.3.2 Get Device Status ===
804 804  
805 805  
806 -Control the output duration 5V . Before each sampling, device will
725 +Send a LoRaWAN downlink to ask device send Alarm settings.
807 807  
808 -~1. first enable the power output to external sensor,
727 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
809 809  
810 -2. keep it on as per duration, read sensor value and construct uplink payload
729 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
811 811  
812 -3. final, close the power output.
813 813  
814 -(% style="color:blue" %)**AT Command: AT+5VT**
815 -
816 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
817 -|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 204px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 149px;" %)**Response**
818 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
819 -OK
820 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
821 -OK
822 -
823 -)))
824 -
825 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
826 -Format: Command Code (0x07) followed by 2 bytes.
827 -
828 -The first and second bytes are the time to turn on.
829 -
830 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
831 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
832 -
833 833  === 3.3.3  Enable / Disable Alarm ===
834 834  
835 835  
... ... @@ -837,8 +837,8 @@
837 837  
838 838  (% style="color:blue" %)**AT Command: **
839 839  
840 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
841 -|(% 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**
739 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
740 +|(% 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**
842 842  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
843 843  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
844 844  
... ... @@ -854,6 +854,7 @@
854 854  
855 855  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:
856 856  
756 +
857 857  * (((
858 858  (% style="color:blue" %)**Keep Status: Status to be monitor**
859 859  )))
... ... @@ -874,104 +874,42 @@
874 874  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.
875 875  
876 876  
877 -* (((
878 -(% style="color:blue" %)**Downlink Command**
879 -)))
880 -
881 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
882 -
883 -**A9:** Command Type Code
884 -
885 -**aa: **01:TTRIG1; 02:TTRIG2
886 -
887 -**bb:** status to be monitored
888 -
889 -**cc dd:** timeout.
890 -
891 -
892 -**1) AT+TTRIG1 : (PA8 of pin)**
893 -
894 894  (% style="color:blue" %)**AT Command to configure:**
895 895  
896 896  * (((
897 -(% 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.
898 -
899 -(% 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.
780 +(% 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.
900 900  )))
901 901  
902 902  * (((
903 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
904 -
905 -
906 -
784 +(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
907 907  )))
908 908  
909 909  (% style="color:blue" %)**Downlink Command to configure:**
910 910  
911 -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.
789 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
912 912  
791 +**A9:** Command Type Code
913 913  
914 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
793 +**aa:** status to be monitored
915 915  
916 -(% style="color:blue" %)**AT Command to configure:**
795 +**bb cc:** timeout.
917 917  
918 -* (((
919 -(% 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.
920 920  
921 -(% 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.
922 -)))
798 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
923 923  
924 -* (((
925 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
800 +Or
926 926  
802 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
927 927  
928 -
929 -)))
930 930  
931 -(% style="color:blue" %)**Downlink Command to configure:**
805 +=== 3.3.5  Count Mod ===
932 932  
933 -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.
934 934  
935 -
936 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
937 -
938 -
939 -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.
940 -
941 941  (% style="color:blue" %)**AT Command:**
942 942  
943 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
944 -|=(% 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**
810 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
811 +|=(% 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**
945 945  |(% style="width:155px" %)(((
946 -AT+TTRALARM=0
947 -)))|(% style="width:279px" %)(((
948 -disable continuous alarm
949 -)))|(% style="width:84px" %)(((
950 -OK
951 -)))
952 -|(% style="width:155px" %)(((
953 -AT+TTRALARM=60
954 -)))|(% style="width:279px" %)(((
955 -The alarm interval is 60 minutes (unit: minutes)
956 -)))|(% style="width:84px" %)(((
957 -OK
958 -)))
959 -
960 -(% style="color:blue" %)**Downlink Command:**
961 -
962 -Example:  0C aa  => AT+TTRALARM= aa
963 -
964 -
965 -=== 3.3.6  Count Mod ===
966 -
967 -
968 -Feature: Manually set the count mode.
969 -
970 -(% style="color:blue" %)**AT Command:**
971 -
972 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
973 -|=(% 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**
974 -|(% style="width:155px" %)(((
975 975  AT+COUNTMOD=0
976 976  )))|(% style="width:277px" %)(((
977 977  the count value keeps accumulating mode
... ... @@ -981,7 +981,7 @@
981 981  |(% style="width:155px" %)(((
982 982  AT+COUNTMOD=1
983 983  )))|(% style="width:277px" %)(((
984 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
822 +the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
985 985  )))|(% style="width:86px" %)(((
986 986  OK
987 987  )))
... ... @@ -991,26 +991,24 @@
991 991  Example:  0B aa  => AT+COUNTMOD = second byte
992 992  
993 993  
994 -=== 3.3.7  Number of channel of door sensors ===
832 +=== 3.3.6  Interrupt Pin Channel Mod ===
995 995  
996 996  
997 -Feature: Set the number of door sensor channels.
998 -
999 999  (% style="color:blue" %)**AT Command:**
1000 1000  
1001 1001  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1002 -|=(% 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**
838 +|=(% 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**
1003 1003  |(% style="width:155px" %)(((
1004 1004  AT+TTRCHANNEL=1
1005 -)))|(% style="width:259px" %)(((
1006 -Set as single channel, only use PA8 pin as interrupt pin.
841 +)))|(% style="width:288px" %)(((
842 +set as single channel, only use PA8 pin as interrupt pin.
1007 1007  )))|(% style="width:44px" %)(((
1008 1008  OK
1009 1009  )))
1010 1010  |(% style="width:155px" %)(((
1011 1011  AT+TTRCHANNEL=2
1012 -)))|(% style="width:259px" %)(((
1013 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
848 +)))|(% style="width:288px" %)(((
849 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1014 1014  )))|(% style="width:44px" %)(((
1015 1015  OK
1016 1016  )))
... ... @@ -1020,92 +1020,51 @@
1020 1020  Example:  0D aa => AT+TTRCHANNEL = second byte
1021 1021  
1022 1022  
1023 -=== 3.3.8  Set Time Sync Mode ===
859 +=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1024 1024  
1025 1025  
1026 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1027 -
1028 -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.
1029 -
1030 -(% style="color:blue" %)**AT Command:**
1031 -
1032 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1033 -|=(% 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**
1034 -|(% style="width:155px" %)(((
1035 -AT+SYNCMOD=1
1036 -)))|(% style="width:259px" %)(((
1037 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1038 -)))|(% style="width:44px" %)(((
1039 -OK
1040 -)))
1041 -|(% style="width:155px" %)(((
1042 -AT+SYNCMOD=1,8
1043 -)))|(% style="width:259px" %)(((
1044 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1045 -)))|(% style="width:44px" %)(((
1046 -OK
1047 -)))
1048 -|(% 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
1049 -
1050 1050  (% style="color:blue" %)**Downlink Command:**
1051 1051  
1052 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
864 +Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1053 1053  
1054 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1055 1055  
1056 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
867 +=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1057 1057  
1058 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1059 1059  
870 +(% style="color:blue" %)**Downlink Command:**
1060 1060  
1061 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
872 +Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1062 1062  
1063 1063  
1064 -(% style="color:blue" %)**AT Command:**
875 +=== 3.3.9  TTRIG1/2 timeout status alarm ===
1065 1065  
1066 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1067 -|=(% 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**
1068 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1069 -OK
1070 -)))
1071 1071  
1072 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
878 +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.
1073 1073  
1074 -The sensor will clear the open door times and the duration of the last open door.
1075 -
1076 -
1077 -=== 3.3.10  Set the count value of the number of open door ===
1078 -
1079 -
1080 1080  (% style="color:blue" %)**AT Command:**
1081 1081  
1082 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1083 -|=(% 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**
882 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
883 +|=(% 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**
1084 1084  |(% style="width:155px" %)(((
1085 -AT+SETCNT=1,100
1086 -)))|(% style="width:259px" %)(((
1087 -Set the open door times of PA8 pin to 100 times.
1088 -)))|(% style="width:44px" %)(((
885 +AT+TTRALARM=0
886 +)))|(% style="width:279px" %)(((
887 +disable continuous alarm
888 +)))|(% style="width:84px" %)(((
1089 1089  OK
1090 1090  )))
1091 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1092 1092  |(% style="width:155px" %)(((
1093 -AT+SETCNT=2,50
1094 -)))|(% style="width:259px" %)(((
1095 -Set the open door times of PA4 pin to 100 times.
1096 -)))|(% style="width:44px" %)(((
892 +AT+TTRALARM=60
893 +)))|(% style="width:279px" %)(((
894 +The alarm interval is 60 minutes (unit: minutes)
895 +)))|(% style="width:84px" %)(((
1097 1097  OK
1098 1098  )))
1099 1099  
1100 1100  (% style="color:blue" %)**Downlink Command:**
1101 1101  
1102 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
901 +Example:  0C aa  => AT+TTRALARM= aa
1103 1103  
1104 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1105 1105  
1106 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1107 -
1108 -
1109 1109  = 4. Battery & Power Consumption =
1110 1110  
1111 1111  
... ... @@ -1125,8 +1125,9 @@
1125 1125  
1126 1126  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1127 1127  
1128 -Methods to Update Firmware:
1129 1129  
924 +**Methods to Update Firmware:**
925 +
1130 1130  * (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/]]**
1131 1131  * 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]]**.
1132 1132  
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