Last modified by Mengting Qiu on 2025/01/10 09:53
<
From version < 12.3 >
edited by Xiaoling
on 2023/06/26 16:10
To version < 28.1 >
edited by Saxer Lin
on 2023/07/01 09:13
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -71,8 +71,6 @@
71 71  * Wall Mountable
72 72  * Outdoor Use
73 73  
74 -
75 -
76 76  == 1.3 Specification ==
77 77  
78 78  
... ... @@ -106,8 +106,6 @@
106 106  * Sleep Mode: 5uA @ 3.3v
107 107  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
108 108  
109 -
110 -
111 111  == 1.4 Applications ==
112 112  
113 113  
... ... @@ -141,12 +141,10 @@
141 141  )))
142 142  |(% 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.
143 143  
144 -
145 -
146 146  == 1.7 BLE connection ==
147 147  
148 148  
149 -D2x-LB support BLE remote configure.
143 +DS03A-LB support BLE remote configure.
150 150  
151 151  
152 152  BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
... ... @@ -158,9 +158,13 @@
158 158  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
159 159  
160 160  
161 -== 1.8 Mechanical ==
155 +== 1.8 Pin Definitions ==
162 162  
157 +[[image:image-20230630160843-7.png]]
163 163  
159 +== 1.9 Mechanical ==
160 +
161 +
164 164  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
165 165  
166 166  
... ... @@ -178,7 +178,7 @@
178 178  == 2.1 How it works ==
179 179  
180 180  
181 -The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
179 +The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.
182 182  
183 183  
184 184  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -186,7 +186,7 @@
186 186  
187 187  Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example. (% style="display:none" %)
188 188  
189 -The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
187 +The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
190 190  
191 191  [[image:image-20230522092858-1.png||height="391" width="874"]]
192 192  
... ... @@ -250,7 +250,7 @@
250 250  
251 251  Example parse in TTNv3
252 252  
253 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609104802-1.png?rev=1.1||alt="image-20220609104802-1.png" height="393" width="1195"]]
251 +[[image:image-20230630155406-1.png||height="190" width="873"]]
254 254  
255 255  
256 256  (% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
... ... @@ -306,44 +306,191 @@
306 306  Ex2: 0x0B49 = 2889mV
307 307  
308 308  
309 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
307 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
310 310  
311 311  
310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
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 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
316 +Keep status1
317 +
318 +
319 +)))|(% style="width:99px" %)(((
320 +Keep time1
321 +
322 +(unit: sec)
323 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
324 +Keep time2
325 +
326 +(unit: sec)
327 +)))|(% style="width:98px" %)(((
328 +Alarm interval
329 +
330 +(unit: min)
331 +)))
332 +
333 +* (((
334 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
335 +)))
336 +
337 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
338 +
339 +
340 +* (((
341 +(% style="color:blue" %)**Disalarm: (default: 0)**
342 +)))
343 +
344 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
345 +
346 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
347 +
348 +
349 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
350 +
351 +
352 +* (((
353 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
354 +)))
355 +
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>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]]
357 +
358 +[[image:image-20230630155527-3.png||height="146" width="902"]]
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 +
312 312  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
313 313  
314 314  * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
315 315  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
316 316  
317 -Uplink Payload totals 11 bytes.
376 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**)
318 318  
319 -(% border="1" cellspacing="4" style="background-color:#f2f2f2;width:515px" %)
378 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
320 320  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
321 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4**
322 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
323 -The last door open duration (unit: min)
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
383 +
384 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
385 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
386 +The last door open duration (unit: sec)
324 324  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
325 325  
326 326  **Status & Alarm:**
327 327  
328 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
329 -|(% 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**
330 -|(% style="width:76px" %)**Value**|(% style="width:79px" %)(((
331 -No ACK Message
332 -)))|(% style="width:84px" %)(((
333 -Poll Message Flag
334 -)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
335 -0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open
391 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:645px" %)
392 +|(% 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**
393 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
394 +Count mod
395 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:125px" %)(((
396 +0: No Alarm;
336 336  
337 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110547-6.png?width=1191&height=337&rev=1.1||alt="image-20220609110547-6.png" height="337" width="1191"]]
398 +1: Alarm
399 +)))|(% style="width:129px" %)(((
400 +Status 0: Close;
338 338  
402 +1: Open
403 +)))
339 339  
340 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
405 +[[image:image-20230630155451-2.png||height="246" width="928"]]
341 341  
342 342  
408 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes.
409 +
410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %)
411 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2**
412 +|(% 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**
413 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
414 +Status1
415 +
416 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
417 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
418 +The last door open duration1 (unit: sec)
419 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
420 +Status2
421 +
422 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
423 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
424 +
425 +**Status1 & Alarm1:**
426 +
427 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:730px" %)
428 +|(% 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**
429 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
430 +Count mod
431 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)(((
432 +0: No Alarm; 1: Alarm
433 +
434 +(PA8)
435 +)))|(% style="width:171px" %)(((
436 +Status 0: Close; 1:Open
437 +
438 +(PA8)
439 +)))
440 +
441 +**Status2 & Alarm2:**
442 +
443 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:550px" %)
444 +|(% 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**
445 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:176px" %)(((
446 +0: No Alarm; 1: Alarm
447 +
448 +(PA4)
449 +)))|(% style="width:175px" %)(((
450 +Status 0: Close,;1:Open
451 +
452 +(PA4)
453 +)))
454 +
455 +[[image:image-20230630155908-6.png||height="295" width="927"]]
456 +
457 +
458 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
459 +
460 +
343 343  DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
344 344  
345 345  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
346 346  
465 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
466 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
467 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
468 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
469 +Status
470 +
471 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
472 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
473 +The last door open duration (unit: sec)
474 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
475 +
476 +**Status & Alarm:**
477 +
478 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %)
479 +|(% 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**
480 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
481 +Count mod
482 +)))|(% style="width:95px" %)TDC flag 0:No;1:Yes|(% style="width:116px" %)(((
483 +0: No Alarm;
484 +
485 +1: Alarm
486 +)))|(% style="width:112px" %)(((
487 +Status 0:Close;
488 +
489 +1: Open
490 +)))
491 +
347 347  * (((
348 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.
349 349  )))
... ... @@ -368,82 +368,40 @@
368 368  
369 369  If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
370 370  
371 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609112215-7.png?width=1250&height=277&rev=1.1||alt="image-20220609112215-7.png" height="277" width="1250"]]
516 +[[image:image-20230630155556-4.png||height="146" width="938"]]
372 372  
373 373  **Downlink:**
374 374  
375 -0x31 61 8E 57 40 61 8E 81 70 05
520 +0x31 64 9E 7D 34 64 9E 7E 9C 05
376 376  
377 377  
378 378  **Uplink:**
379 379  
380 -00 00 00 00 00 00 00 61 8E 5F 8F 01 00 00 01 00 00 00 61 8E 5F D2 00 00 00 01 00 00 02 61 8E 60 64 01 00 00 02 00 00 02 61 8E 60 75 00 00 00 02 00 00 01 61 8E 60 C6 00 00 00 02 00 00 01 61 8E 7B A7 01 00 00 03 00 00 01 61 8E 7F 38 00 00 00 03 00 00 02 61 8E 7F CE 01 00 00 04 00 00 02 61 8E 81 1B 00 00 00 04 00 00 00 61 8E 81 50
525 +45 00 00 00 00 00 00 64 9E 7D 48 40 00 00 00 00 00 63 64 9E 7D 9C 41 00 00 01 00 00 63 64 9E 7D A4 40 00 00 01 00 00 8D 64 9E 7E 31 43 00 00 02 00 00 8D 64 9E 7E 44 48 00 00 02 00 00 1F 64 9E 7E 59 4B 00 00 03 00 00 1F 64 9E 7E 6B
381 381  
382 382  
383 383  **Parsed Value:**
384 384  
385 -[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
530 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
386 386  
387 387  
388 -[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
533 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
389 389  
390 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
535 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
391 391  
392 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
537 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
393 393  
394 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
539 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
395 395  
396 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
541 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
397 397  
398 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
543 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
399 399  
400 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
545 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
401 401  
402 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
547 +[[image:image-20230630172740-1.png||height="199" width="868"]]
403 403  
404 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
405 405  
406 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
407 -
408 -
409 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
410 -
411 -
412 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
413 -
414 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
415 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
416 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
417 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
418 -
419 -* (((
420 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
421 -)))
422 -
423 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
424 -
425 -
426 -* (((
427 -(% style="color:blue" %)**Disalarm: (default: 0)**
428 -)))
429 -
430 - **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.
431 -
432 - **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.
433 -
434 -
435 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
436 -
437 -
438 -* (((
439 -(% style="color:blue" %)**Keep Status & Keep Time**
440 -)))
441 -
442 -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]]
443 -
444 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110018-4.png?width=1159&height=291&rev=1.1||alt="image-20220609110018-4.png" height="291" width="1159"]]
445 -
446 -
447 447  == 2.4 Payload Decoder file ==
448 448  
449 449  
... ... @@ -461,7 +461,9 @@
461 461  
462 462  (% 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.
463 463  
567 +(% 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.**
464 464  
569 +
465 465  === 2.5.1 Ways to get datalog via LoRaWAN ===
466 466  
467 467  
... ... @@ -613,19 +613,9 @@
613 613  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
614 614  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
615 615  
616 -=== 3.3.2 Get Device Status ===
721 +=== 3.3.2  Enable / Disable Alarm ===
617 617  
618 618  
619 -Send a LoRaWAN downlink to ask device send Alarm settings.
620 -
621 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
622 -
623 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
624 -
625 -
626 -=== 3.3.3  Enable / Disable Alarm ===
627 -
628 -
629 629  Feature: Enable/Disable Alarm for open/close event. Default value 0.
630 630  
631 631  (% style="color:blue" %)**AT Command: **
... ... @@ -642,7 +642,7 @@
642 642  0xA7 00  ~/~/ Same As AT+DISALARM=0
643 643  
644 644  
645 -=== 3.3.4  Alarm Base on Timeout ===
740 +=== 3.3.3  Alarm Base on Timeout ===
646 646  
647 647  
648 648  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:
... ... @@ -668,37 +668,103 @@
668 668  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.
669 669  
670 670  
766 +* (((
767 +(% style="color:blue" %)**Downlink Command**
768 +)))
769 +
770 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
771 +
772 +**A9:** Command Type Code
773 +
774 +**aa: **01:TTRIG1; 02:TTRIG2
775 +
776 +**bb:** status to be monitored
777 +
778 +**cc dd:** timeout.
779 +
780 +
781 +1)**AT+TTRIG1**:(PA8 of pin)
782 +
671 671  (% style="color:blue" %)**AT Command to configure:**
672 672  
673 673  * (((
674 -(% 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.
786 +(% 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.
787 +
788 +(% 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.
675 675  )))
676 676  
677 677  * (((
678 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
792 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
793 +
794 +
795 +
679 679  )))
680 680  
681 681  (% style="color:blue" %)**Downlink Command to configure:**
682 682  
683 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
800 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
684 684  
685 -**A9:** Command Type Code
802 + 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
686 686  
687 -**aa:** status to be monitored
688 688  
689 -**bb cc:** timeout.
805 +2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
690 690  
807 +(% style="color:blue" %)**AT Command to configure:**
691 691  
692 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
809 +* (((
810 +(% 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.
693 693  
694 -Or
812 +(% 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.
813 +)))
695 695  
696 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
815 +* (((
816 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
697 697  
698 698  
819 +
820 +)))
821 +
822 +(% style="color:blue" %)**Downlink Command to configure:**
823 +
824 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
825 +
826 + 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
827 +
828 +
829 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
830 +
831 +
832 +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.
833 +
834 +(% style="color:blue" %)**AT Command:**
835 +
836 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
837 +|=(% 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**
838 +|(% style="width:155px" %)(((
839 +AT+TTRALARM=0
840 +)))|(% style="width:279px" %)(((
841 +disable continuous alarm
842 +)))|(% style="width:84px" %)(((
843 +OK
844 +)))
845 +|(% style="width:155px" %)(((
846 +AT+TTRALARM=60
847 +)))|(% style="width:279px" %)(((
848 +The alarm interval is 60 minutes (unit: minutes)
849 +)))|(% style="width:84px" %)(((
850 +OK
851 +)))
852 +
853 +(% style="color:blue" %)**Downlink Command:**
854 +
855 +Example:  0C aa  => AT+TTRALARM= aa
856 +
857 +
699 699  === 3.3.5  Count Mod ===
700 700  
701 701  
861 +Feature: Manually set the count mode.
862 +
702 702  (% style="color:blue" %)**AT Command:**
703 703  
704 704  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
... ... @@ -723,24 +723,26 @@
723 723  Example:  0B aa  => AT+COUNTMOD = second byte
724 724  
725 725  
726 -=== 3.3.6  Interrupt Pin Channel Mod ===
887 +=== 3.3.6 Number of channel of door sensors ===
727 727  
728 728  
890 +Feature: Set the number of door sensor channels.
891 +
729 729  (% style="color:blue" %)**AT Command:**
730 730  
731 731  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
732 -|=(% 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**
895 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
733 733  |(% style="width:155px" %)(((
734 734  AT+TTRCHANNEL=1
735 -)))|(% style="width:288px" %)(((
736 -set as single channel, only use PA8 pin as interrupt pin.
898 +)))|(% style="width:259px" %)(((
899 +Set as single channel, only use PA8 pin as interrupt pin.
737 737  )))|(% style="width:44px" %)(((
738 738  OK
739 739  )))
740 740  |(% style="width:155px" %)(((
741 741  AT+TTRCHANNEL=2
742 -)))|(% style="width:288px" %)(((
743 -is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
905 +)))|(% style="width:259px" %)(((
906 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
744 744  )))|(% style="width:44px" %)(((
745 745  OK
746 746  )))
... ... @@ -750,52 +750,92 @@
750 750  Example:  0D aa => AT+TTRCHANNEL = second byte
751 751  
752 752  
753 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
916 +=== 3.3.7 Set Time Sync Mode ===
754 754  
755 755  
919 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
920 +
921 +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.
922 +
923 +(% style="color:blue" %)**AT Command:**
924 +
925 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
926 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
927 +|(% style="width:155px" %)(((
928 +AT+SYNCMOD=1
929 +)))|(% style="width:259px" %)(((
930 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
931 +)))|(% style="width:44px" %)(((
932 +OK
933 +)))
934 +|(% style="width:155px" %)(((
935 +AT+SYNCMOD=1,8
936 +)))|(% style="width:259px" %)(((
937 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
938 +)))|(% style="width:44px" %)(((
939 +OK
940 +)))
941 +|(% 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
942 +
756 756  (% style="color:blue" %)**Downlink Command:**
757 757  
758 -Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
945 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
759 759  
947 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
760 760  
761 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
949 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
762 762  
951 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
763 763  
764 -(% style="color:blue" %)**Downlink Command:**
765 765  
766 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
954 +=== 3.3.8 Clear the door open count and the duration of the last door open ===
767 767  
768 768  
769 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
957 +(% style="color:blue" %)**AT Command:**
770 770  
959 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
960 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
961 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the leak count and the duration of the last leak.|(% style="width:44px" %)(((
962 +OK
963 +)))
771 771  
772 -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.
965 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
773 773  
967 +The sensor will clear the door open count and the duration of the last door open.
968 +
969 +
970 +=== 3.3.9 Set the count value of the number of door open ===
971 +
972 +
774 774  (% style="color:blue" %)**AT Command:**
775 775  
776 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
777 -|=(% 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**
975 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
976 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
778 778  |(% style="width:155px" %)(((
779 -AT+TTRALARM=0
780 -)))|(% style="width:279px" %)(((
781 -disable continuous alarm
782 -)))|(% style="width:84px" %)(((
978 +AT+SETCNT=1,100
979 +)))|(% style="width:259px" %)(((
980 +Set the door open times of PA8 pin to 100 times.
981 +)))|(% style="width:44px" %)(((
783 783  OK
784 784  )))
984 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the door open times of PA8 pin.|(% style="width:44px" %)OK
785 785  |(% style="width:155px" %)(((
786 -AT+TTRALARM=60
787 -)))|(% style="width:279px" %)(((
788 -The alarm interval is 60 minutes (unit: minutes)
789 -)))|(% style="width:84px" %)(((
986 +AT+SETCNT=2,50
987 +)))|(% style="width:259px" %)(((
988 +Set the door open times of PA4 pin to 100 times.
989 +)))|(% style="width:44px" %)(((
790 790  OK
791 791  )))
792 792  
793 793  (% style="color:blue" %)**Downlink Command:**
794 794  
795 -Example:  0C aa  => AT+TTRALARM= aa
995 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
796 796  
997 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
797 797  
999 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
798 798  
1001 +
799 799  = 4. Battery & Power Consumption =
800 800  
801 801  
... ... @@ -818,8 +818,8 @@
818 818  
819 819  **Methods to Update Firmware:**
820 820  
821 -* (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/]]
822 -* 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]]**.
1024 +* (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/]]**
1025 +* 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]]**.
823 823  
824 824  = 6. FAQ =
825 825  
image-20230630155406-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +41.8 KB
Content
image-20230630155451-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +77.2 KB
Content
image-20230630155527-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +39.2 KB
Content
image-20230630155556-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +38.4 KB
Content
image-20230630155751-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230630155908-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +90.8 KB
Content
image-20230630160843-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +511.7 KB
Content
image-20230630172740-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0