Last modified by Mengting Qiu on 2025/01/10 09:53
<
From version < 34.41 >
edited by Xiaoling
on 2023/07/01 15:07
To version < 38.3 >
edited by Xiaoling
on 2023/07/19 17:06
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -71,6 +71,7 @@
71 71  * Wall Mountable
72 72  * Outdoor Use
73 73  
74 +
74 74  == 1.3 Specification ==
75 75  
76 76  
... ... @@ -79,11 +79,6 @@
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 -
87 87  (% style="color:#037691" %)**LoRa Spec:**
88 88  
89 89  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -104,6 +104,7 @@
104 104  * Sleep Mode: 5uA @ 3.3v
105 105  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
106 106  
103 +
107 107  == 1.4 Applications ==
108 108  
109 109  
... ... @@ -137,6 +137,7 @@
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  
137 +
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  
157 +
159 159  == 1.9 Mechanical ==
160 160  
161 161  
... ... @@ -171,6 +171,14 @@
171 171  [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
172 172  
173 173  
173 +== 1.10 Magnet Distance ==
174 +
175 +
176 +* Wood Door: 10mm ~~ 30mm
177 +* Iron Door: 30 ~~ 45mm
178 +
179 +
180 +
174 174  = 2. Configure DS03A-LB to connect to LoRaWAN network =
175 175  
176 176  == 2.1 How it works ==
... ... @@ -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,17 @@
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 312  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
313 313  |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
314 314  |**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:50px" %)**1**|(% style="width:100px" %)**1**|(% style="width:90px" %)**2**|(% style="width:100px" %)**1**|(% style="width:100px" %)**2**|(% style="width:98px" %)**1**
315 315  |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
316 -Keep status1)))|(% style="width:99px" %)(((
325 +Keep status1
326 +)))|(% style="width:99px" %)(((
317 317  Keep time1(unit: sec)
318 318  )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
319 319  Keep time2(unit: sec)
... ... @@ -321,6 +321,11 @@
321 321  Alarm interval(unit: min)
322 322  )))
323 323  
334 +Example parse in TTNv3
335 +
336 +[[image:image-20230630155527-3.png||height="146" width="902"]]
337 +
338 +
324 324  * (((
325 325  (% style="color:blue" %)**TDC: (default: 0x001C20)**
326 326  )))
... ... @@ -344,9 +344,8 @@
344 344  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
345 345  )))
346 346  
347 -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"]]
348 348  
349 -[[image:image-20230630155527-3.png||height="146" width="902"]]
350 350  
351 351  
352 352  * (((
... ... @@ -361,16 +361,16 @@
361 361  
362 362  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
363 363  
364 -* 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"]].
365 365  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
366 366  
367 -1) When **AT+TTRCHANNEL=1**, Uplink Payload totals **11 bytes**. (**Default mode**)
381 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
368 368  
369 369  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
370 370  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
371 371  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
372 372  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
373 -Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
387 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
374 374  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
375 375  The last door open duration (unit: sec)
376 376  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -394,9 +394,9 @@
394 394  (% style="color:blue" %)**Count mod:Default=0**
395 395  )))
396 396  
397 -MOD=0 ~-~-> Uplink total open door times since factory
411 +0: Uplink total open door times since factory
398 398  
399 -MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
413 +1: Uplink total open door times since last FPORT=2 uplink.
400 400  
401 401  
402 402  * (% style="color:blue" %)**TDC flag**
... ... @@ -410,7 +410,7 @@
410 410  (% style="color:#0000ff" %)**Alarm**
411 411  )))
412 412  
413 -See [[Alarm Base on Timeout>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]
427 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
414 414  
415 415  
416 416  * (((
... ... @@ -440,7 +440,7 @@
440 440  [[image:image-20230701094042-1.png||height="154" width="763"]]
441 441  
442 442  
443 -2) When **AT+TTRCHANNEL=2**, Uplink Payload totals **18 bytes**.
457 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
444 444  
445 445  (When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
446 446  
... ... @@ -450,11 +450,11 @@
450 450  |=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
451 451  |(% 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**
452 452  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
453 -Status1 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
467 +Status1 & Alarm1
454 454  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
455 455  The last door open duration1 (unit: sec)
456 456  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
457 -Status2 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
471 +Status2 & Alarm2
458 458  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
459 459  
460 460  **Status1 & Alarm1:**
... ... @@ -483,12 +483,12 @@
483 483  
484 484  
485 485  * (((
486 -(% id="cke_bm_695345S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Count mod:Default=0**
500 +(% style="color:blue" %)**Count mod:Default=0**
487 487  )))
488 488  
489 -MOD=0 ~-~-> Uplink total open door times since factory
503 +0: Uplink total open door times since factory
490 490  
491 -MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
505 +1: Uplink total open door times since last FPORT=2 uplink.
492 492  
493 493  
494 494  * (% style="color:blue" %)**TDC flag**
... ... @@ -502,7 +502,7 @@
502 502  (% style="color:#0000ff" %)**Alarm1 or Alarm2**
503 503  )))
504 504  
505 -See [[Alarm Base on Timeout>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]
519 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
506 506  
507 507  
508 508  * (((
... ... @@ -543,7 +543,7 @@
543 543  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
544 544  |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
545 545  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
546 -Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
560 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
547 547  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
548 548  The last door open duration (unit: sec)
549 549  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -563,7 +563,7 @@
563 563  )))
564 564  
565 565  * (((
566 -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.
567 567  )))
568 568  
569 569  For example, in the US915 band, the max payload for different DR is:
... ... @@ -744,6 +744,7 @@
744 744  * 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]].
745 745  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
746 746  
761 +
747 747  == 3.2 General Commands ==
748 748  
749 749  
... ... @@ -791,9 +791,41 @@
791 791  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
792 792  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
793 793  
794 -=== 3.3.2  Enable / Disable Alarm ===
795 795  
810 +=== 3.3.2  Set Power Output Duration ===
796 796  
812 +
813 +Control the output duration 5V . Before each sampling, device will
814 +
815 +~1. first enable the power output to external sensor,
816 +
817 +2. keep it on as per duration, read sensor value and construct uplink payload
818 +
819 +3. final, close the power output.
820 +
821 +(% style="color:blue" %)**AT Command: AT+5VT**
822 +
823 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
824 +|=(% 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**
825 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
826 +OK
827 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
828 +OK
829 +
830 +)))
831 +
832 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
833 +Format: Command Code (0x07) followed by 2 bytes.
834 +
835 +The first and second bytes are the time to turn on.
836 +
837 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
838 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
839 +
840 +
841 +=== 3.3.3  Enable / Disable Alarm ===
842 +
843 +
797 797  Feature: Enable/Disable Alarm for open/close event. Default value 0.
798 798  
799 799  (% style="color:blue" %)**AT Command: **
... ... @@ -810,12 +810,11 @@
810 810  0xA7 00  ~/~/ Same As AT+DISALARM=0
811 811  
812 812  
813 -=== 3.3.3  Alarm Base on Timeout ===
860 +=== 3.3.4  Alarm Base on Timeout ===
814 814  
815 815  
816 816  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:
817 817  
818 -
819 819  * (((
820 820  (% style="color:blue" %)**Keep Status: Status to be monitor**
821 821  )))
... ... @@ -851,7 +851,7 @@
851 851  **cc dd:** timeout.
852 852  
853 853  
854 -1)**AT+TTRIG1**:(PA8 of pin)
900 +**1) AT+TTRIG1 : (PA8 of pin)**
855 855  
856 856  (% style="color:blue" %)**AT Command to configure:**
857 857  
... ... @@ -870,13 +870,11 @@
870 870  
871 871  (% style="color:blue" %)**Downlink Command to configure:**
872 872  
873 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
919 +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.
874 874  
875 - 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
876 876  
922 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
877 877  
878 -2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
879 -
880 880  (% style="color:blue" %)**AT Command to configure:**
881 881  
882 882  * (((
... ... @@ -894,14 +894,12 @@
894 894  
895 895  (% style="color:blue" %)**Downlink Command to configure:**
896 896  
897 -If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
941 +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.
898 898  
899 - 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
900 900  
944 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
901 901  
902 -=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
903 903  
904 -
905 905  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.
906 906  
907 907  (% style="color:blue" %)**AT Command:**
... ... @@ -928,7 +928,7 @@
928 928  Example:  0C aa  => AT+TTRALARM= aa
929 929  
930 930  
931 -=== 3.3.5  Count Mod ===
973 +=== 3.3.6  Count Mod ===
932 932  
933 933  
934 934  Feature: Manually set the count mode.
... ... @@ -957,7 +957,7 @@
957 957  Example:  0B aa  => AT+COUNTMOD = second byte
958 958  
959 959  
960 -=== 3.3.6  Number of channel of door sensors ===
1002 +=== 3.3.7  Number of channel of door sensors ===
961 961  
962 962  
963 963  Feature: Set the number of door sensor channels.
... ... @@ -986,7 +986,7 @@
986 986  Example:  0D aa => AT+TTRCHANNEL = second byte
987 987  
988 988  
989 -=== 3.3.7  Set Time Sync Mode ===
1031 +=== 3.3.8  Set Time Sync Mode ===
990 990  
991 991  
992 992  Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
... ... @@ -1024,13 +1024,13 @@
1024 1024  0x28 00  ~/~/ Same As AT+SYNCMOD=0
1025 1025  
1026 1026  
1027 -=== 3.3.8  Clear the open door times and the duration of the last open door ===
1069 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1028 1028  
1029 1029  
1030 1030  (% style="color:blue" %)**AT Command:**
1031 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**
1074 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1075 +|=(% 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**
1034 1034  |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1035 1035  OK
1036 1036  )))
... ... @@ -1040,7 +1040,7 @@
1040 1040  The sensor will clear the open door times and the duration of the last open door.
1041 1041  
1042 1042  
1043 -=== 3.3.9  Set the count value of the number of open door ===
1085 +=== 3.3.10  Set the count value of the number of open door ===
1044 1044  
1045 1045  
1046 1046  (% style="color:blue" %)**AT Command:**
... ... @@ -1091,12 +1091,12 @@
1091 1091  
1092 1092  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1093 1093  
1136 +Methods to Update Firmware:
1094 1094  
1095 -**Methods to Update Firmware:**
1096 -
1097 1097  * (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/]]**
1098 1098  * 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]]**.
1099 1099  
1141 +
1100 1100  = 6. FAQ =
1101 1101  
1102 1102  
... ... @@ -1124,6 +1124,7 @@
1124 1124  
1125 1125  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1126 1126  
1169 +
1127 1127  = 8. ​Packing Info =
1128 1128  
1129 1129  
... ... @@ -1141,6 +1141,7 @@
1141 1141  
1142 1142  * Weight / pcs : g
1143 1143  
1187 +
1144 1144  = 9. Support =
1145 1145  
1146 1146  

Applications

Navigation

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