Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 39.1
edited by Xiaoling
on 2024/01/08 16:04
Change comment: Uploaded new attachment "image-20240108160443-1.png", version {1}
To version 21.1
edited by Saxer Lin
on 2023/06/30 16:09
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,271 +308,48 @@
308 308  Ex2: 0x0B49 = 2889mV
309 309  
310 310  
311 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
307 +=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
312 312  
313 313  
314 -DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
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**
319 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
320 -Keep status1
321 -)))|(% style="width:99px" %)(((
322 -Keep time1(unit: sec)
323 -)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
324 -Keep time2(unit: sec)
325 -)))|(% style="width:98px" %)(((
326 -Alarm interval(unit: min)
327 -)))
328 -
329 -Example parse in TTNv3
330 -
331 -[[image:image-20230630155527-3.png||height="146" width="902"]]
332 -
333 -
334 -* (((
335 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
336 -)))
337 -
338 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
339 -
340 -
341 -* (((
342 -(% style="color:blue" %)**Disalarm: (default: 0)**
343 -)))
344 -
345 - **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
346 -
347 - **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
348 -
349 -
350 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
351 -
352 -
353 -* (((
354 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
355 -)))
356 -
357 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
358 -
359 -
360 -
361 -* (((
362 -(% style="color:blue" %)**Alarm interval(default: 0)**
363 -)))
364 -
365 -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.
366 -
367 -
368 -=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
369 -
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"]].
312 +* 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)(%%)**
315 +Uplink Payload totals 11 bytes.
377 377  
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 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
381 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
382 -Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
383 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
384 -The last door open duration (unit: sec)
319 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4**
320 +|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
321 +The last door open duration (unit: min)
385 385  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
386 386  
387 387  **Status & Alarm:**
388 388  
389 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 -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 -)))
327 +|(% 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**
328 +|(% style="width:76px" %)**Value**|(% style="width:79px" %)(((
329 +No ACK Message
330 +)))|(% style="width:84px" %)(((
331 +Poll Message Flag
332 +)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
333 +0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open
398 398  
399 399  [[image:image-20230630155451-2.png||height="246" width="928"]]
400 400  
401 -
402 -* (((
403 -(% style="color:blue" %)**Count mod:Default=0**
404 -)))
405 -
406 -0: Uplink total open door times since factory
407 -
408 -1: Uplink total open door times since last FPORT=2 uplink.
409 -
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**
461 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
462 -Status1 & Alarm1
463 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
464 -The last door open duration1 (unit: sec)
465 -)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
466 -Status2 & Alarm2
467 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
468 -
469 -**Status1 & Alarm1:**
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" %)(((
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 -)))
480 -
481 -**Status2 & Alarm2:**
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)
489 -)))
490 -
491 491  [[image:image-20230630155908-6.png||height="295" width="927"]]
492 492  
493 493  
494 -* (((
495 -(% style="color:blue" %)**Count mod:Default=0**
496 -)))
340 +=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
497 497  
498 -0: Uplink total open door times since factory
499 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**
512 -)))
513 -
514 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
515 -
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 -=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
545 -
546 -
547 547  DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
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" %)
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**
554 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
555 -Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
556 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
557 -The last door open duration (unit: sec)
558 -)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
559 -
560 -**Status & Alarm:**
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" %)(((
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
570 -)))|(% style="width:112px" %)(((
571 -Status 0:Close; 1: Open
572 -)))
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.
348 +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]
385 +[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,9 +626,47 @@
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"]]
402 +[[image:image-20230630155751-5.png||height="188" width="809"]]
630 630  
631 631  
405 +=== 2.3.4  Sensor Configuration, FPORT~=4 ===
406 +
407 +
408 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
409 +
410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
411 +|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
412 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
413 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
414 +
415 +* (((
416 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
417 +)))
418 +
419 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
420 +
421 +
422 +* (((
423 +(% style="color:blue" %)**Disalarm: (default: 0)**
424 +)))
425 +
426 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
427 +
428 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
429 +
430 +
431 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
432 +
433 +
434 +* (((
435 +(% style="color:blue" %)**Keep Status & Keep Time**
436 +)))
437 +
438 +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]]
439 +
440 +[[image:image-20230630155527-3.png||height="146" width="902"]]
441 +
442 +
632 632  == 2.4 Payload Decoder file ==
633 633  
634 634  
... ... @@ -646,9 +646,7 @@
646 646  
647 647  (% 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.
648 648  
649 -(% 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.**
650 650  
651 -
652 652  === 2.5.1 Ways to get datalog via LoRaWAN ===
653 653  
654 654  
... ... @@ -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 ===
584 +=== 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 ===
612 +=== 3.3.2 Get Device Status ===
804 804  
805 805  
806 -Control the output duration 5V . Before each sampling, device will
615 +Send a LoRaWAN downlink to ask device send Alarm settings.
807 807  
808 -~1. first enable the power output to external sensor,
617 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
809 809  
810 -2. keep it on as per duration, read sensor value and construct uplink payload
619 +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**
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**
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  
646 +
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.
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.
900 900  )))
901 901  
902 902  * (((
903 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
904 -
905 -
906 -
674 +(% 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.
679 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
912 912  
681 +**A9:** Command Type Code
913 913  
914 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
683 +**aa:** status to be monitored
915 915  
916 -(% style="color:blue" %)**AT Command to configure:**
685 +**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 -)))
688 +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.
690 +Or
926 926  
692 +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:**
695 +=== 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**
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**
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)
712 +the count value will be reset after each TDC time（Last 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 ===
722 +=== 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**
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**
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.
731 +)))|(% style="width:288px" %)(((
732 +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.
738 +)))|(% style="width:288px" %)(((
739 +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 ===
749 +=== 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
754 +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
757 +=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1057 1057  
1058 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1059 1059  
760 +(% style="color:blue" %)**Downlink Command:**
1060 1060  
1061 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
762 +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:**
765 +=== 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
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.
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**
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**
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" %)(((
775 +AT+TTRALARM=0
776 +)))|(% style="width:279px" %)(((
777 +disable continuous alarm
778 +)))|(% 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" %)(((
782 +AT+TTRALARM=60
783 +)))|(% style="width:279px" %)(((
784 +The alarm interval is 60 minutes (unit: minutes)
785 +)))|(% 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
791 +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  
814 +**Methods to Update Firmware:**
815 +
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
image-20240108160443-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -500.2 KB
Content