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

From version 23.1
edited by Saxer Lin
on 2023/06/30 16:12
Change comment: There is no comment for this version
To version 38.2
edited by Xiaoling
on 2023/07/12 14:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -71,6 +71,8 @@
71 71  * Wall Mountable
72 72  * Outdoor Use
73 73  
74 +
75 +
74 74  == 1.3 Specification ==
75 75  
76 76  
... ... @@ -104,6 +104,8 @@
104 104  * Sleep Mode: 5uA @ 3.3v
105 105  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
106 106  
109 +
110 +
107 107  == 1.4 Applications ==
108 108  
109 109  
... ... @@ -137,6 +137,8 @@
137 137  )))
138 138  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means Device is in Deep Sleep Mode.
139 139  
144 +
145 +
140 140  == 1.7 BLE connection ==
141 141  
142 142  
... ... @@ -156,6 +156,7 @@
156 156  
157 157  [[image:image-20230630160843-7.png]]
158 158  
165 +
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.
246 +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.
248 +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  
251 +The Payload format is as below.
252 +
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,16 +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
316 +=== 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.
319 +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:510px" %)
313 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
314 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
315 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
321 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
322 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
323 +|**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**
324 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
325 +Keep status1
326 +)))|(% style="width:99px" %)(((
327 +Keep time1(unit: sec)
328 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
329 +Keep time2(unit: sec)
330 +)))|(% style="width:98px" %)(((
331 +Alarm interval(unit: min)
332 +)))
316 316  
334 +Example parse in TTNv3
335 +
336 +[[image:image-20230630155527-3.png||height="146" width="902"]]
337 +
338 +
317 317  * (((
318 318  (% style="color:blue" %)**TDC: (default: 0x001C20)**
319 319  )))
... ... @@ -334,47 +334,196 @@
334 334  
335 335  
336 336  * (((
337 -(% style="color:blue" %)**Keep Status & Keep Time**
359 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
338 338  )))
339 339  
340 -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]]
362 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
341 341  
342 -[[image:image-20230630155527-3.png||height="146" width="902"]]
343 343  
344 344  
366 +* (((
367 +(% style="color:blue" %)**Alarm interval(default: 0)**
368 +)))
369 +
370 +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.
371 +
372 +
345 345  === 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
346 346  
347 347  
348 348  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
349 349  
350 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
378 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
351 351  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
352 352  
353 -Uplink Payload totals 11 bytes.
381 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
354 354  
355 355  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
356 356  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
357 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4**
358 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
359 -The last door open duration (unit: min)
385 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
386 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
387 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
388 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
389 +The last door open duration (unit: sec)
360 360  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
361 361  
362 362  **Status & Alarm:**
363 363  
364 364  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
365 -|(% 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**
366 -|(% style="width:76px" %)**Value**|(% style="width:79px" %)(((
367 -No ACK Message
368 -)))|(% style="width:84px" %)(((
369 -Poll Message Flag
370 -)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
371 -0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open
395 +|(% 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**
396 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
397 +Count mod
398 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
399 +Alarm 0: No Alarm; 1: Alarm
400 +)))|(% style="width:131px" %)(((
401 +Status 0: Close; 1: Open
402 +)))
372 372  
373 373  [[image:image-20230630155451-2.png||height="246" width="928"]]
374 374  
406 +
407 +* (((
408 +(% style="color:blue" %)**Count mod:Default=0**
409 +)))
410 +
411 +0: Uplink total open door times since factory
412 +
413 +1: Uplink total open door times since last FPORT=2 uplink.
414 +
415 +
416 +* (% style="color:blue" %)**TDC flag**
417 +
418 +When the flag is 1, it means sending packets at normal time intervals.
419 +
420 +Otherwise, it is a packet sent at non-TDC time.
421 +
422 +
423 +* (((
424 +(% style="color:#0000ff" %)**Alarm**
425 +)))
426 +
427 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
428 +
429 +
430 +* (((
431 +(% style="color:blue" %)**Status**
432 +)))
433 +
434 +This bit is 1 when the door sensor is open and 0 when it is close.
435 +
436 +
437 +* (((
438 +(% style="color:blue" %)**Total open door events**
439 +)))
440 +
441 +Total pulse/counting base on open door.
442 +
443 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
444 +
445 +
446 +* (((
447 +(% style="color:blue" %)**The last door open duration**
448 +)))
449 +
450 +Door sensor last open duration.
451 +
452 +Unit: sec.
453 +
454 +[[image:image-20230701094042-1.png||height="154" width="763"]]
455 +
456 +
457 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
458 +
459 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
460 +
461 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
462 +
463 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
464 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
465 +|(% 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**
466 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
467 +Status1 & Alarm1
468 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
469 +The last door open duration1 (unit: sec)
470 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
471 +Status2 & Alarm2
472 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
473 +
474 +**Status1 & Alarm1:**
475 +
476 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
477 +|(% 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**
478 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
479 +Count mod
480 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
481 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
482 +)))|(% style="width:181px" %)(((
483 +Status1 0: Close; 1: Open (PA8 of pin)
484 +)))
485 +
486 +**Status2 & Alarm2:**
487 +
488 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
489 +|(% 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**
490 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
491 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
492 +)))|(% style="width:181px" %)(((
493 +Status2 0: Close; 1: Open (PA4 of pin)
494 +)))
495 +
375 375  [[image:image-20230630155908-6.png||height="295" width="927"]]
376 376  
377 377  
499 +* (((
500 +(% style="color:blue" %)**Count mod:Default=0**
501 +)))
502 +
503 +0: Uplink total open door times since factory
504 +
505 +1: Uplink total open door times since last FPORT=2 uplink.
506 +
507 +
508 +* (% style="color:blue" %)**TDC flag**
509 +
510 +When the flag is 1, it means sending packets at normal time intervals.
511 +
512 +Otherwise, it is a packet sent at non-TDC time.
513 +
514 +
515 +* (((
516 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
517 +)))
518 +
519 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
520 +
521 +
522 +* (((
523 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
524 +)))
525 +
526 +This bit is 1 when the door sensor is open and 0 when it is close.
527 +
528 +
529 +* (((
530 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
531 +)))
532 +
533 +Total pulse/counting base on open door.
534 +
535 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
536 +
537 +
538 +* (((
539 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
540 +)))
541 +
542 +Door sensor last open duration.
543 +
544 +Unit: sec.
545 +
546 +[[image:image-20230701094042-1.png||height="154" width="763"]]
547 +
548 +
378 378  === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
379 379  
380 380  
... ... @@ -382,8 +382,31 @@
382 382  
383 383  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
384 384  
556 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
557 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
558 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
559 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
560 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
561 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
562 +The last door open duration (unit: sec)
563 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
564 +
565 +**Status & Alarm:**
566 +
567 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
568 +|(% 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**
569 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
570 +Count mod
571 +)))|(% style="width:95px" %)(((
572 +TDC flag 0:No; 1:Yes
573 +)))|(% style="width:116px" %)(((
574 +Alarm 0: No Alarm; 1: Alarm
575 +)))|(% style="width:112px" %)(((
576 +Status 0:Close; 1: Open
577 +)))
578 +
385 385  * (((
386 -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.
580 +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.
387 387  )))
388 388  
389 389  For example, in the US915 band, the max payload for different DR is:
... ... @@ -420,7 +420,7 @@
420 420  
421 421  **Parsed Value:**
422 422  
423 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
617 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
424 424  
425 425  
426 426  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -437,7 +437,7 @@
437 437  
438 438  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
439 439  
440 -[[image:image-20230630155751-5.png||height="188" width="809"]]
634 +[[image:image-20230630172740-1.png||height="199" width="868"]]
441 441  
442 442  
443 443  == 2.4 Payload Decoder file ==
... ... @@ -457,7 +457,9 @@
457 457  
458 458  (% 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.
459 459  
654 +(% 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.**
460 460  
656 +
461 461  === 2.5.1 Ways to get datalog via LoRaWAN ===
462 462  
463 463  
... ... @@ -562,6 +562,8 @@
562 562  * AT Command via UART Connection : See [[Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
563 563  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
564 564  
761 +
762 +
565 565  == 3.2 General Commands ==
566 566  
567 567  
... ... @@ -581,7 +581,7 @@
581 581  These commands only valid for DS03A-LB, as below:
582 582  
583 583  
584 -=== 3.3.1 Set Transmit Interval Time ===
782 +=== 3.3.1  Set Transmit Interval Time ===
585 585  
586 586  
587 587  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -609,16 +609,40 @@
609 609  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
610 610  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
611 611  
612 -=== 3.3.2 Get Device Status ===
613 613  
614 614  
615 -Send a LoRaWAN downlink to ask device send Alarm settings.
812 +=== 3.3.2  Set Power Output Duration ===
616 616  
617 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
618 618  
619 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
815 +Control the output duration 5V . Before each sampling, device will
620 620  
817 +~1. first enable the power output to external sensor,
621 621  
819 +2. keep it on as per duration, read sensor value and construct uplink payload
820 +
821 +3. final, close the power output.
822 +
823 +(% style="color:blue" %)**AT Command: AT+5VT**
824 +
825 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
826 +|=(% 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**
827 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
828 +OK
829 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
830 +OK
831 +
832 +)))
833 +
834 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
835 +Format: Command Code (0x07) followed by 2 bytes.
836 +
837 +The first and second bytes are the time to turn on.
838 +
839 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
840 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
841 +
842 +
843 +
622 622  === 3.3.3  Enable / Disable Alarm ===
623 623  
624 624  
... ... @@ -626,8 +626,8 @@
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**
851 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
852 +|(% 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  
... ... @@ -643,7 +643,6 @@
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,42 +664,104 @@
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  
888 +* (((
889 +(% style="color:blue" %)**Downlink Command**
890 +)))
891 +
892 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
893 +
894 +**A9:** Command Type Code
895 +
896 +**aa: **01:TTRIG1; 02:TTRIG2
897 +
898 +**bb:** status to be monitored
899 +
900 +**cc dd:** timeout.
901 +
902 +
903 +**1) AT+TTRIG1 : (PA8 of pin)**
904 +
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.
908 +(% 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.
909 +
910 +(% 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.
914 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
915 +
916 +
917 +
675 675  )))
676 676  
677 677  (% style="color:blue" %)**Downlink Command to configure:**
678 678  
679 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
922 +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
925 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
684 684  
685 -**bb cc:** timeout.
927 +(% style="color:blue" %)**AT Command to configure:**
686 686  
929 +* (((
930 +(% 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
932 +(% 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.
933 +)))
689 689  
690 -Or
935 +* (((
936 +(% 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  
939 +
940 +)))
694 694  
695 -=== 3.3.5  Count Mod ===
942 +(% style="color:blue" %)**Downlink Command to configure:**
696 696  
944 +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.
697 697  
946 +
947 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
948 +
949 +
950 +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.
951 +
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**
954 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
955 +|=(% 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**
702 702  |(% style="width:155px" %)(((
957 +AT+TTRALARM=0
958 +)))|(% style="width:279px" %)(((
959 +disable continuous alarm
960 +)))|(% style="width:84px" %)(((
961 +OK
962 +)))
963 +|(% style="width:155px" %)(((
964 +AT+TTRALARM=60
965 +)))|(% style="width:279px" %)(((
966 +The alarm interval is 60 minutes (unit: minutes)
967 +)))|(% style="width:84px" %)(((
968 +OK
969 +)))
970 +
971 +(% style="color:blue" %)**Downlink Command:**
972 +
973 +Example:  0C aa  => AT+TTRALARM= aa
974 +
975 +
976 +=== 3.3.6  Count Mod ===
977 +
978 +
979 +Feature: Manually set the count mode.
980 +
981 +(% style="color:blue" %)**AT Command:**
982 +
983 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
984 +|=(% 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**
985 +|(% style="width:155px" %)(((
703 703  AT+COUNTMOD=0
704 704  )))|(% style="width:277px" %)(((
705 705  the count value keeps accumulating mode
... ... @@ -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 timeLast Close Duration Reset after each uplink
995 +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 ===
1005 +=== 3.3.7  Number of channel of door sensors ===
723 723  
724 724  
1008 +Feature: Set the number of door sensor channels.
1009 +
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**
1013 +|=(% 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.
1016 +)))|(% style="width:259px" %)(((
1017 +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.
1023 +)))|(% style="width:259px" %)(((
1024 +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 ===
1034 +=== 3.3.8  Set Time Sync Mode ===
750 750  
751 751  
752 -(% style="color:blue" %)**Downlink Command:**
1037 +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
1039 +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  
1041 +(% style="color:blue" %)**AT Command:**
756 756  
757 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1043 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1044 +|=(% 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**
1045 +|(% style="width:155px" %)(((
1046 +AT+SYNCMOD=1
1047 +)))|(% style="width:259px" %)(((
1048 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1049 +)))|(% style="width:44px" %)(((
1050 +OK
1051 +)))
1052 +|(% style="width:155px" %)(((
1053 +AT+SYNCMOD=1,8
1054 +)))|(% style="width:259px" %)(((
1055 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1056 +)))|(% style="width:44px" %)(((
1057 +OK
1058 +)))
1059 +|(% 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
1063 +0x28 0 ~/~/ Same As AT+SYNCMOD=1
763 763  
1065 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
764 764  
765 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1067 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
766 766  
1069 +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  
1072 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1073 +
1074 +
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**
1078 +|=(% 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**
1079 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1080 +OK
1081 +)))
1082 +
1083 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1084 +
1085 +The sensor will clear the open door times and the duration of the last open door.
1086 +
1087 +
1088 +=== 3.3.10  Set the count value of the number of open door ===
1089 +
1090 +
1091 +(% style="color:blue" %)**AT Command:**
1092 +
1093 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1094 +|=(% 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" %)(((
1096 +AT+SETCNT=1,100
1097 +)))|(% style="width:259px" %)(((
1098 +Set the open door times of PA8 pin to 100 times.
1099 +)))|(% style="width:44px" %)(((
779 779  OK
780 780  )))
1102 +|(% 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" %)(((
1104 +AT+SETCNT=2,50
1105 +)))|(% style="width:259px" %)(((
1106 +Set the open door times of PA4 pin to 100 times.
1107 +)))|(% 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
1113 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
792 792  
1115 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
793 793  
1117 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1118 +
1119 +
794 794  = 4. Battery & Power Consumption =
795 795  
796 796  
... ... @@ -810,12 +810,13 @@
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  
1139 +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  
1144 +
1145 +
819 819  = 6. FAQ =
820 820  
821 821  
... ... @@ -843,6 +843,8 @@
843 843  
844 844  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
845 845  
1173 +
1174 +
846 846  = 8. ​Packing Info =
847 847  
848 848  
... ... @@ -860,6 +860,8 @@
860 860  
861 861  * Weight / pcs : g
862 862  
1192 +
1193 +
863 863  = 9. Support =
864 864  
865 865  
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