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

From version 26.1
edited by Saxer Lin
on 2023/06/30 17:27
Change comment: Uploaded new attachment "image-20230630172740-1.png", version {1}
To version 38.1
edited by Saxer Lin
on 2023/07/12 11:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -156,6 +156,7 @@
156 156  
157 157  [[image:image-20230630160843-7.png]]
158 158  
159 +
159 159  == 1.9 Mechanical ==
160 160  
161 161  
... ... @@ -236,11 +236,13 @@
236 236  === 2.3.1 Device Status, FPORT~=5 ===
237 237  
238 238  
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.
240 +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.
240 240  
241 -The Payload format is as below.
242 +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.
242 242  
243 243  
245 +The Payload format is as below.
246 +
244 244  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
245 245  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
246 246  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -304,32 +304,29 @@
304 304  Ex2: 0x0B49 = 2889mV
305 305  
306 306  
307 -=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
310 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
308 308  
309 309  
310 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
313 +DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
311 311  
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**
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**
315 315  |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
316 316  Keep status1
317 -
318 -
319 319  )))|(% style="width:99px" %)(((
320 -Keep time1
321 -
322 -(unit: sec)
321 +Keep time1(unit: sec)
323 323  )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
324 -Keep time2
325 -
326 -(unit: sec)
323 +Keep time2(unit: sec)
327 327  )))|(% style="width:98px" %)(((
328 -Alarm interval
329 -
330 -(unit: min)
325 +Alarm interval(unit: min)
331 331  )))
332 332  
328 +Example parse in TTNv3
329 +
330 +[[image:image-20230630155527-3.png||height="146" width="902"]]
331 +
332 +
333 333  * (((
334 334  (% style="color:blue" %)**TDC: (default: 0x001C20)**
335 335  )))
... ... @@ -353,9 +353,8 @@
353 353  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
354 354  )))
355 355  
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]]
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
357 357  
358 -[[image:image-20230630155527-3.png||height="146" width="902"]]
359 359  
360 360  
361 361  * (((
... ... @@ -370,19 +370,16 @@
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.1SetTransmitIntervalTime"]].
372 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
374 374  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
375 375  
375 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
376 376  
377 -1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**)
378 -
379 379  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
380 380  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
381 381  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
382 382  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
383 -Status
384 -
385 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
381 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
386 386  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
387 387  The last door open duration (unit: sec)
388 388  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -389,73 +389,161 @@
389 389  
390 390  **Status & Alarm:**
391 391  
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**
388 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
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**
394 394  |(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
395 395  Count mod
396 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:125px" %)(((
397 -0: No Alarm;
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 +)))
398 398  
399 -1: Alarm
400 -)))|(% style="width:129px" %)(((
401 -Status 0: Close;
398 +[[image:image-20230630155451-2.png||height="246" width="928"]]
402 402  
403 -1: Open
400 +
401 +* (((
402 +(% style="color:blue" %)**Count mod:Default=0**
404 404  )))
405 405  
406 -[[image:image-20230630155451-2.png||height="246" width="928"]]
405 +0: Uplink total open door times since factory
407 407  
407 +1: Uplink total open door times since last FPORT=2 uplink.
408 408  
409 -2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes.
410 410  
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**
414 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
415 -Status1
410 +* (% style="color:blue" %)**TDC flag**
416 416  
417 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
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
418 418  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
419 419  The last door open duration1 (unit: sec)
420 420  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
421 -Status2
422 -
423 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
465 +Status2 & Alarm2
424 424  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
425 425  
426 426  **Status1 & Alarm1:**
427 427  
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" %)(((
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" %)(((
431 431  Count mod
432 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)(((
433 -0: No Alarm; 1: Alarm
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 +)))
434 434  
435 -(PA8)
436 -)))|(% style="width:171px" %)(((
437 -Status 0: Close; 1:Open
480 +**Status2 & Alarm2:**
438 438  
439 -(PA8)
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)
440 440  )))
441 441  
442 -**Status2 & Alarm2:**
490 +[[image:image-20230630155908-6.png||height="295" width="927"]]
443 443  
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
448 448  
449 -(PA4)
450 -)))|(% style="width:175px" %)(((
451 -Status 0: Close,;1:Open
493 +* (((
494 +(% style="color:blue" %)**Count mod:Default=0**
495 +)))
452 452  
453 -(PA4)
497 +0: Uplink total open door times since factory
498 +
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**
454 454  )))
455 455  
456 -[[image:image-20230630155908-6.png||height="295" width="927"]]
513 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
457 457  
458 458  
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 +
459 459  === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
460 460  
461 461  
... ... @@ -463,13 +463,11 @@
463 463  
464 464  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
465 465  
466 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
550 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
467 467  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
468 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
552 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
469 469  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
470 -Status
471 -
472 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
554 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
473 473  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
474 474  The last door open duration (unit: sec)
475 475  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -476,22 +476,20 @@
476 476  
477 477  **Status & Alarm:**
478 478  
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**
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**
481 481  |(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
482 482  Count mod
483 -)))|(% style="width:95px" %)TDC flag 0:No;1:Yes|(% style="width:116px" %)(((
484 -0: No Alarm;
485 -
486 -1: Alarm
565 +)))|(% style="width:95px" %)(((
566 +TDC flag 0:No; 1:Yes
567 +)))|(% style="width:116px" %)(((
568 +Alarm 0: No Alarm; 1: Alarm
487 487  )))|(% style="width:112px" %)(((
488 -Status 0:Close;
489 -
490 -1: Open
570 +Status 0:Close; 1: Open
491 491  )))
492 492  
493 493  * (((
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.
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.
495 495  )))
496 496  
497 497  For example, in the US915 band, the max payload for different DR is:
... ... @@ -528,7 +528,7 @@
528 528  
529 529  **Parsed Value:**
530 530  
531 -[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]
532 532  
533 533  
534 534  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -545,7 +545,7 @@
545 545  
546 546  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
547 547  
548 -[[image:image-20230630155751-5.png||height="188" width="809"]]
628 +[[image:image-20230630172740-1.png||height="199" width="868"]]
549 549  
550 550  
551 551  == 2.4 Payload Decoder file ==
... ... @@ -691,7 +691,7 @@
691 691  These commands only valid for DS03A-LB, as below:
692 692  
693 693  
694 -=== 3.3.1 Set Transmit Interval Time ===
774 +=== 3.3.1  Set Transmit Interval Time ===
695 695  
696 696  
697 697  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -719,16 +719,35 @@
719 719  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
720 720  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
721 721  
722 -=== 3.3.2 Get Device Status ===
802 +=== 3.3.2  Set Power Output Duration ===
723 723  
804 +Control the output duration 5V . Before each sampling, device will
724 724  
725 -Send a LoRaWAN downlink to ask device send Alarm settings.
806 +~1. first enable the power output to external sensor,
726 726  
727 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
808 +2. keep it on as per duration, read sensor value and construct uplink payload
728 728  
729 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
810 +3. final, close the power output.
730 730  
812 +(% style="color:blue" %)**AT Command: AT+5VT**
731 731  
814 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
815 +|=(% 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**
816 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
817 +OK
818 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
819 +OK
820 +
821 +)))
822 +
823 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
824 +Format: Command Code (0x07) followed by 2 bytes.
825 +
826 +The first and second bytes are the time to turn on.
827 +
828 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
829 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
830 +
732 732  === 3.3.3  Enable / Disable Alarm ===
733 733  
734 734  
... ... @@ -736,8 +736,8 @@
736 736  
737 737  (% style="color:blue" %)**AT Command: **
738 738  
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**
838 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
839 +|(% 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**
741 741  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
742 742  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
743 743  
... ... @@ -753,7 +753,6 @@
753 753  
754 754  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:
755 755  
756 -
757 757  * (((
758 758  (% style="color:blue" %)**Keep Status: Status to be monitor**
759 759  )))
... ... @@ -774,42 +774,104 @@
774 774  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.
775 775  
776 776  
875 +* (((
876 +(% style="color:blue" %)**Downlink Command**
877 +)))
878 +
879 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
880 +
881 +**A9:** Command Type Code
882 +
883 +**aa: **01:TTRIG1; 02:TTRIG2
884 +
885 +**bb:** status to be monitored
886 +
887 +**cc dd:** timeout.
888 +
889 +
890 +**1) AT+TTRIG1 : (PA8 of pin)**
891 +
777 777  (% style="color:blue" %)**AT Command to configure:**
778 778  
779 779  * (((
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.
895 +(% 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.
896 +
897 +(% 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.
781 781  )))
782 782  
783 783  * (((
784 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
901 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
902 +
903 +
904 +
785 785  )))
786 786  
787 787  (% style="color:blue" %)**Downlink Command to configure:**
788 788  
789 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
909 +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.
790 790  
791 -**A9:** Command Type Code
792 792  
793 -**aa:** status to be monitored
912 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
794 794  
795 -**bb cc:** timeout.
914 +(% style="color:blue" %)**AT Command to configure:**
796 796  
916 +* (((
917 +(% 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.
797 797  
798 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
919 +(% 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.
920 +)))
799 799  
800 -Or
922 +* (((
923 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
801 801  
802 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
803 803  
926 +
927 +)))
804 804  
805 -=== 3.3.5  Count Mod ===
929 +(% style="color:blue" %)**Downlink Command to configure:**
806 806  
931 +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.
807 807  
933 +
934 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
935 +
936 +
937 +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.
938 +
808 808  (% style="color:blue" %)**AT Command:**
809 809  
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**
941 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
942 +|=(% 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**
812 812  |(% style="width:155px" %)(((
944 +AT+TTRALARM=0
945 +)))|(% style="width:279px" %)(((
946 +disable continuous alarm
947 +)))|(% style="width:84px" %)(((
948 +OK
949 +)))
950 +|(% style="width:155px" %)(((
951 +AT+TTRALARM=60
952 +)))|(% style="width:279px" %)(((
953 +The alarm interval is 60 minutes (unit: minutes)
954 +)))|(% style="width:84px" %)(((
955 +OK
956 +)))
957 +
958 +(% style="color:blue" %)**Downlink Command:**
959 +
960 +Example:  0C aa  => AT+TTRALARM= aa
961 +
962 +
963 +=== 3.3.6  Count Mod ===
964 +
965 +
966 +Feature: Manually set the count mode.
967 +
968 +(% style="color:blue" %)**AT Command:**
969 +
970 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
971 +|=(% 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**
972 +|(% style="width:155px" %)(((
813 813  AT+COUNTMOD=0
814 814  )))|(% style="width:277px" %)(((
815 815  the count value keeps accumulating mode
... ... @@ -819,7 +819,7 @@
819 819  |(% style="width:155px" %)(((
820 820  AT+COUNTMOD=1
821 821  )))|(% style="width:277px" %)(((
822 -the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
982 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
823 823  )))|(% style="width:86px" %)(((
824 824  OK
825 825  )))
... ... @@ -829,24 +829,26 @@
829 829  Example:  0B aa  => AT+COUNTMOD = second byte
830 830  
831 831  
832 -=== 3.3.6  Interrupt Pin Channel Mod ===
992 +=== 3.3.7  Number of channel of door sensors ===
833 833  
834 834  
995 +Feature: Set the number of door sensor channels.
996 +
835 835  (% style="color:blue" %)**AT Command:**
836 836  
837 837  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
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**
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**
839 839  |(% style="width:155px" %)(((
840 840  AT+TTRCHANNEL=1
841 -)))|(% style="width:288px" %)(((
842 -set as single channel, only use PA8 pin as interrupt pin.
1003 +)))|(% style="width:259px" %)(((
1004 +Set as single channel, only use PA8 pin as interrupt pin.
843 843  )))|(% style="width:44px" %)(((
844 844  OK
845 845  )))
846 846  |(% style="width:155px" %)(((
847 847  AT+TTRCHANNEL=2
848 -)))|(% style="width:288px" %)(((
849 -is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1010 +)))|(% style="width:259px" %)(((
1011 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
850 850  )))|(% style="width:44px" %)(((
851 851  OK
852 852  )))
... ... @@ -856,51 +856,92 @@
856 856  Example:  0D aa => AT+TTRCHANNEL = second byte
857 857  
858 858  
859 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1021 +=== 3.3.8  Set Time Sync Mode ===
860 860  
861 861  
862 -(% style="color:blue" %)**Downlink Command:**
1024 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
863 863  
864 -Example A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1026 +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.
865 865  
1028 +(% style="color:blue" %)**AT Command:**
866 866  
867 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1030 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1031 +|=(% 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**
1032 +|(% style="width:155px" %)(((
1033 +AT+SYNCMOD=1
1034 +)))|(% style="width:259px" %)(((
1035 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1036 +)))|(% style="width:44px" %)(((
1037 +OK
1038 +)))
1039 +|(% style="width:155px" %)(((
1040 +AT+SYNCMOD=1,8
1041 +)))|(% style="width:259px" %)(((
1042 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1043 +)))|(% style="width:44px" %)(((
1044 +OK
1045 +)))
1046 +|(% 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
868 868  
869 -
870 870  (% style="color:blue" %)**Downlink Command:**
871 871  
872 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1050 +0x28 0 ~/~/ Same As AT+SYNCMOD=1
873 873  
1052 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
874 874  
875 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1054 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
876 876  
1056 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
877 877  
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.
879 879  
1059 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1060 +
1061 +
880 880  (% style="color:blue" %)**AT Command:**
881 881  
882 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**
1065 +|=(% 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**
1066 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1067 +OK
1068 +)))
1069 +
1070 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1071 +
1072 +The sensor will clear the open door times and the duration of the last open door.
1073 +
1074 +
1075 +=== 3.3.10  Set the count value of the number of open door ===
1076 +
1077 +
1078 +(% style="color:blue" %)**AT Command:**
1079 +
1080 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1081 +|=(% 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**
884 884  |(% style="width:155px" %)(((
885 -AT+TTRALARM=0
886 -)))|(% style="width:279px" %)(((
887 -disable continuous alarm
888 -)))|(% style="width:84px" %)(((
1083 +AT+SETCNT=1,100
1084 +)))|(% style="width:259px" %)(((
1085 +Set the open door times of PA8 pin to 100 times.
1086 +)))|(% style="width:44px" %)(((
889 889  OK
890 890  )))
1089 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
891 891  |(% style="width:155px" %)(((
892 -AT+TTRALARM=60
893 -)))|(% style="width:279px" %)(((
894 -The alarm interval is 60 minutes (unit: minutes)
895 -)))|(% style="width:84px" %)(((
1091 +AT+SETCNT=2,50
1092 +)))|(% style="width:259px" %)(((
1093 +Set the open door times of PA4 pin to 100 times.
1094 +)))|(% style="width:44px" %)(((
896 896  OK
897 897  )))
898 898  
899 899  (% style="color:blue" %)**Downlink Command:**
900 900  
901 -Example:  0C aa  => AT+TTRALARM= aa
1100 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
902 902  
1102 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
903 903  
1104 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1105 +
1106 +
904 904  = 4. Battery & Power Consumption =
905 905  
906 906  
... ... @@ -920,9 +920,8 @@
920 920  
921 921  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
922 922  
1126 +Methods to Update Firmware:
923 923  
924 -**Methods to Update Firmware:**
925 -
926 926  * (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/]]**
927 927  * 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]]**.
928 928  
image-20230701094042-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content