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

From version 24.1
edited by Saxer Lin
on 2023/06/30 16:18
Change comment: There is no comment for this version
To version 40.19
edited by Xiaoling
on 2024/01/08 17:57
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/LS -- Outdoor LoRaWAN Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -1,9 +1,18 @@
1 +(% style="display:none" %) (%%)
2 +
1 1  (% style="text-align:center" %)
2 -[[image:image-20230516085523-1.jpeg||height="491" width="491"]]
4 +[[image:image-20240108161155-2.png]]
3 3  
4 4  
5 -**Table of Contents:**
6 6  
8 +
9 +
10 +
11 +
12 +
13 +
14 +**Table of Contents:**
15 +
7 7  {{toc/}}
8 8  
9 9  
... ... @@ -13,41 +13,41 @@
13 13  
14 14  = 1. Introduction =
15 15  
16 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
25 +== 1.1 What is LoRaWAN Door Sensor ==
17 17  
18 18  
19 19  (((
20 -The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
29 +The Dragino DS03A-LB/LS is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
21 21  )))
22 22  
23 23  (((
24 -The LoRa wireless technology used in DS03A-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
33 +The LoRa wireless technology used in DS03A-LB/LS allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
25 25  )))
26 26  
27 27  (((
28 -The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically.
37 +The DS03A-LB/LS will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB/LS can count each open event and uplink periodically.
29 29  )))
30 30  
31 31  (((
32 -DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
41 +DS03A-LB/LS supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
33 33  )))
34 34  
35 35  (((
36 -DS03A-LB has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.
45 +DS03A-LB/LS has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.
37 37  
38 -DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
47 +DS03A-LB/LS is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
39 39  )))
40 40  
41 41  (((
42 -DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
51 +DS03A-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
43 43  )))
44 44  
45 45  (((
46 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
55 +DS03A-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + li-on battery**(%%), it is designed for long term use up to 5 years.
47 47  )))
48 48  
49 49  (((
50 -Each DS03A-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
59 +Each DS03A-LB/LS is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
51 51  )))
52 52  
53 53  
... ... @@ -67,9 +67,10 @@
67 67  * Support wireless OTA update firmware
68 68  * Uplink on periodically
69 69  * Downlink to change configure
70 -* 8500mAh Battery for long term use
71 71  * Wall Mountable
72 72  * Outdoor Use
81 +* 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 +* Solar panel + 3000mAh Li-on battery (DS03A-LS)
73 73  
74 74  == 1.3 Specification ==
75 75  
... ... @@ -76,14 +76,9 @@
76 76  
77 77  (% style="color:#037691" %)**Common DC Characteristics:**
78 78  
79 -* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
89 +* Supply Voltage: Built-in 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
... ... @@ -121,11 +121,10 @@
121 121  == 1.6 Button & LEDs ==
122 122  
123 123  
124 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
129 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]]
125 125  
126 -
127 127  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
128 -|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
132 +|=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 226px;background-color:#4F81BD;color:white" %)**Action**
129 129  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
130 130  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
131 131  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
... ... @@ -140,7 +140,7 @@
140 140  == 1.7 BLE connection ==
141 141  
142 142  
143 -DS03A-LB support BLE remote configure.
147 +DS03A-LB/LS support BLE remote configure.
144 144  
145 145  
146 146  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:
... ... @@ -156,27 +156,40 @@
156 156  
157 157  [[image:image-20230630160843-7.png]]
158 158  
163 +
159 159  == 1.9 Mechanical ==
160 160  
166 +=== 1.9.1 for LB version ===
161 161  
168 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-LB_LoRaWAN_Distance_Detection_Sensor_User_Manual/WebHome/image-20240105152536-3.png?rev=1.1||alt="image-20240105152536-3.png"]]
169 +
170 +
171 +(% style="color:blue" %)**Probe Mechanical:**
172 +
162 162  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
163 163  
164 164  
165 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
166 166  
177 +=== 1.9.2 for LS version ===
167 167  
168 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
169 169  
180 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20231231203439-3.png?width=886&height=385&rev=1.1||alt="image-20231231203439-3.png"]]
170 170  
171 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
172 172  
173 173  
174 -= 2. Configure DS03A-LB to connect to LoRaWAN network =
175 175  
185 +== 1.10 Magnet Distance ==
186 +
187 +
188 +* Wood Door: 10mm ~~ 30mm
189 +* Iron Door: 30 ~~ 45mm
190 +
191 += 2. Configure DS03A-LB/LS to connect to LoRaWAN network =
192 +
176 176  == 2.1 How it works ==
177 177  
178 178  
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.
196 +The DS03A-LB/LS 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/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.
180 180  
181 181  
182 182  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -189,9 +189,9 @@
189 189  [[image:image-20230522092858-1.png||height="391" width="874"]]
190 190  
191 191  
192 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
209 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB/LS.
193 193  
194 -Each DS03A-LB is shipped with a sticker with the default device EUI as below:
211 +Each DS03A-LB/LS is shipped with a sticker with the default device EUI as below:
195 195  
196 196  [[image:image-20230426085205-1.png||height="238" width="512"]]
197 197  
... ... @@ -221,10 +221,10 @@
221 221  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144157838-392.png?rev=1.1||alt="1675144157838-392.png"]]
222 222  
223 223  
224 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
241 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB/LS
225 225  
226 226  
227 -Press the button for 5 seconds to activate the DS03A-LB.
244 +Press the button for 5 seconds to activate the DS03A-LB/LS.
228 228  
229 229  (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to Join LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
230 230  
... ... @@ -236,15 +236,17 @@
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.
256 +Include device configure status. Once DS03A-LB/LS Joined the network, it will uplink this message to the server. After that, DS03A-LB/LS will uplink Device Status every 12 hours.
240 240  
241 -The Payload format is as below.
258 +Users can also use the downlink command**(0x26 01)** to ask DS03A-LB/LS to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
242 242  
243 243  
261 +The Payload format is as below.
262 +
244 244  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
245 -|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
264 +|(% colspan="6" style="background-color:#4f81bd; color:white" %)**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**
247 -|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
266 +|(% style="width:103px" %)Value|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
248 248  
249 249  Example parse in TTNv3
250 250  
... ... @@ -251,7 +251,7 @@
251 251  [[image:image-20230630155406-1.png||height="190" width="873"]]
252 252  
253 253  
254 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
273 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB/LS, this value is 0x1B
255 255  
256 256  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
257 257  
... ... @@ -304,16 +304,29 @@
304 304  Ex2: 0x0B49 = 2889mV
305 305  
306 306  
307 -=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
326 +=== 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.
329 +DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server.
311 311  
312 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
313 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
314 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
315 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
331 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
332 +|(% colspan="8" style="background-color:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4**
333 +|**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**
334 +|Value|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
335 +Keep status1
336 +)))|(% style="width:99px" %)(((
337 +Keep time1(unit: sec)
338 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
339 +Keep time2(unit: sec)
340 +)))|(% style="width:98px" %)(((
341 +Alarm interval(unit: min)
342 +)))
316 316  
344 +Example parse in TTNv3
345 +
346 +[[image:image-20230630155527-3.png||height="146" width="902"]]
347 +
348 +
317 317  * (((
318 318  (% style="color:blue" %)**TDC: (default: 0x001C20)**
319 319  )))
... ... @@ -325,9 +325,9 @@
325 325  (% style="color:blue" %)**Disalarm: (default: 0)**
326 326  )))
327 327  
328 - **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.
360 + **If Disalarm = 1**, DS03A-LB/LS 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.
329 329  
330 - **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.
362 + **If Disalarm = 0**, DS03A-LB/LS 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.
331 331  
332 332  
333 333  (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
... ... @@ -334,31 +334,35 @@
334 334  
335 335  
336 336  * (((
337 -(% style="color:blue" %)**Keep Status & Keep Time**
369 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
338 338  )))
339 339  
340 -Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
372 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
341 341  
342 -[[image:image-20230630155527-3.png||height="146" width="902"]]
343 343  
344 344  
376 +* (((
377 +(% style="color:blue" %)**Alarm interval(default: 0)**
378 +)))
379 +
380 +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.
381 +
382 +
345 345  === 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
346 346  
347 347  
348 -DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
386 +DS03A-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB/LS will send uplinks when:
349 349  
350 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
388 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
351 351  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
352 352  
353 -Uplink Payload totals 11 bytes.
391 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
354 354  
355 355  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
356 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
394 +|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
357 357  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
358 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
359 -Status
360 -
361 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
396 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
397 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
362 362  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
363 363  The last door open duration (unit: sec)
364 364  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -365,27 +365,193 @@
365 365  
366 366  **Status & Alarm:**
367 367  
368 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
369 -|(% 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:122px" %)**bit0**
370 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
404 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
405 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:105px" %)**bit0**
406 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
371 371  Count mod
372 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
373 -0: No Alarm; 1: Alarm|(% style="width:122px" %)Status 0: Close, 1: Open
408 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
409 +Alarm 0: No Alarm; 1: Alarm
410 +)))|(% style="width:131px" %)(((
411 +Status 0: Close; 1: Open
412 +)))
374 374  
375 375  [[image:image-20230630155451-2.png||height="246" width="928"]]
376 376  
416 +
417 +* (((
418 +(% style="color:blue" %)**Count mod:Default=0**
419 +)))
420 +
421 +0: Uplink total open door times since factory
422 +
423 +1: Uplink total open door times since last FPORT=2 uplink.
424 +
425 +
426 +* (% style="color:blue" %)**TDC flag**
427 +
428 +When the flag is 1, it means sending packets at normal time intervals.
429 +
430 +Otherwise, it is a packet sent at non-TDC time.
431 +
432 +
433 +* (((
434 +(% style="color:#0000ff" %)**Alarm**
435 +)))
436 +
437 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
438 +
439 +
440 +* (((
441 +(% style="color:blue" %)**Status**
442 +)))
443 +
444 +This bit is 1 when the door sensor is open and 0 when it is close.
445 +
446 +
447 +* (((
448 +(% style="color:blue" %)**Total open door events**
449 +)))
450 +
451 +Total pulse/counting base on open door.
452 +
453 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
454 +
455 +
456 +* (((
457 +(% style="color:blue" %)**The last door open duration**
458 +)))
459 +
460 +Door sensor last open duration.
461 +
462 +Unit: sec.
463 +
464 +[[image:image-20230701094042-1.png||height="154" width="763"]]
465 +
466 +
467 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
468 +
469 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
470 +
471 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
472 +
473 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
474 +|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
475 +|(% 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**
476 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
477 +Status1 & Alarm1
478 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
479 +The last door open duration1 (unit: sec)
480 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
481 +Status2 & Alarm2
482 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
483 +
484 +**Status1 & Alarm1:**
485 +
486 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
487 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit0**
488 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
489 +Count mod
490 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
491 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
492 +)))|(% style="width:181px" %)(((
493 +Status1 0: Close; 1: Open (PA8 of pin)
494 +)))
495 +
496 +**Status2 & Alarm2:**
497 +
498 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
499 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit2]**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit0**
500 +|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
501 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
502 +)))|(% style="width:181px" %)(((
503 +Status2 0: Close; 1: Open (PA4 of pin)
504 +)))
505 +
377 377  [[image:image-20230630155908-6.png||height="295" width="927"]]
378 378  
379 379  
509 +* (((
510 +(% style="color:blue" %)**Count mod:Default=0**
511 +)))
512 +
513 +0: Uplink total open door times since factory
514 +
515 +1: Uplink total open door times since last FPORT=2 uplink.
516 +
517 +
518 +* (% style="color:blue" %)**TDC flag**
519 +
520 +When the flag is 1, it means sending packets at normal time intervals.
521 +
522 +Otherwise, it is a packet sent at non-TDC time.
523 +
524 +
525 +* (((
526 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
527 +)))
528 +
529 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
530 +
531 +
532 +* (((
533 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
534 +)))
535 +
536 +This bit is 1 when the door sensor is open and 0 when it is close.
537 +
538 +
539 +* (((
540 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
541 +)))
542 +
543 +Total pulse/counting base on open door.
544 +
545 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
546 +
547 +
548 +* (((
549 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
550 +)))
551 +
552 +Door sensor last open duration.
553 +
554 +Unit: sec.
555 +
556 +[[image:image-20230701094042-1.png||height="154" width="763"]]
557 +
558 +
380 380  === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
381 381  
382 382  
383 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
562 +DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
384 384  
385 385  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
386 386  
566 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
567 +|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
568 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
569 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
570 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
571 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
572 +The last door open duration (unit: sec)
573 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
574 +
575 +**Status & Alarm:**
576 +
577 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
578 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:75px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:65px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:50px" %)**[bit5:bit4]**|(% style="background-color:#4f81bd; color:white; width:50px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:75px" %)**bit0**
579 +|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
580 +Count mod
581 +)))|(% style="width:95px" %)(((
582 +TDC flag 0:No; 1:Yes
583 +)))|(% style="width:116px" %)(((
584 +Alarm 0: No Alarm; 1: Alarm
585 +)))|(% style="width:112px" %)(((
586 +Status 0:Close; 1: Open
587 +)))
588 +
387 387  * (((
388 -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.
590 +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/LS will send max bytes according to the current DR and Frequency bands.
389 389  )))
390 390  
391 391  For example, in the US915 band, the max payload for different DR is:
... ... @@ -422,7 +422,7 @@
422 422  
423 423  **Parsed Value:**
424 424  
425 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
627 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
426 426  
427 427  
428 428  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -439,7 +439,7 @@
439 439  
440 440  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
441 441  
442 -[[image:image-20230630155751-5.png||height="188" width="809"]]
644 +[[image:image-20230630172740-1.png||height="199" width="868"]]
443 443  
444 444  
445 445  == 2.4 Payload Decoder file ==
... ... @@ -457,26 +457,24 @@
457 457  == 2.5 Datalog Feature ==
458 458  
459 459  
460 -(% 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.
662 +(% 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/LS will store the reading for future retrieving purposes.
461 461  
664 +(% 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.**
462 462  
666 +
463 463  === 2.5.1 Ways to get datalog via LoRaWAN ===
464 464  
465 465  
466 -Set PNACKMD=1, DS03A-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DS03A-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
670 +Set PNACKMD=1, DS03A-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, DS03A-LB/LS will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
467 467  
468 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
469 -* b) DS03A-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS03A-LB gets a ACK, DS03A-LB will consider there is a network connection and resend all NONE-ACK Message.
672 +* a) DS03A-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
673 +* b) DS03A-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS03A-LB/LS gets a ACK, DS03A-LB/LS will consider there is a network connection and resend all NONE-ACK Message.
470 470  
471 -Below is the typical case for the Datalog Feature (Set PNACKMD=1)
472 472  
473 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="image-20220703111700-2.png" height="381" width="1119"]]
474 -
475 -
476 476  === 2.5.2 Unix TimeStamp ===
477 477  
478 478  
479 -DS03A-LB uses Unix TimeStamp format based on
679 +DS03A-LB/LS uses Unix TimeStamp format based on
480 480  
481 481  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="image-20220523001219-11.png" height="97" width="627"]]
482 482  
... ... @@ -494,7 +494,7 @@
494 494  
495 495  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
496 496  
497 -Once DS03A-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB. If DS03A-LB fails to get the time from the server, DS03A-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
697 +Once DS03A-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB/LS. If DS03A-LB/LS fails to get the time from the server, DS03A-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
498 498  
499 499  (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN v3 and loriot support but TTN v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN v2 if SYNCMOD=1.**
500 500  
... ... @@ -507,7 +507,7 @@
507 507  
508 508  (% style="color:blue" %)**Step 1:**(%%)** Link TTNv3 to Datacake.**[[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]
509 509  
510 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
710 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB/LS in Datacake.**
511 511  
512 512  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746350207-427.png?rev=1.1||alt="1654746350207-427.png"]]
513 513  
... ... @@ -542,7 +542,7 @@
542 542  == 2.7 Frequency Plans ==
543 543  
544 544  
545 -The DS03A-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
745 +The DS03A-LB/LS uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
546 546  
547 547  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
548 548  
... ... @@ -553,12 +553,12 @@
553 553  **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
554 554  
555 555  
556 -= 3. Configure DS03A-LB =
756 += 3. Configure DS03A-LB/LS =
557 557  
558 558  == 3.1 Configure Methods: ==
559 559  
560 560  
561 -DS03A-LB supports below configure method:
761 +DS03A-LB/LS supports below configure method:
562 562  
563 563  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
564 564  * 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]].
... ... @@ -577,13 +577,13 @@
577 577  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
578 578  
579 579  
580 -== 3.3 Commands special design for DS03A-LB ==
780 +== 3.3 Commands special design for DS03A-LB/LS ==
581 581  
582 582  
583 -These commands only valid for DS03A-LB, as below:
783 +These commands only valid for DS03A-LB/LS, as below:
584 584  
585 585  
586 -=== 3.3.1 Set Transmit Interval Time ===
786 +=== 3.3.1  Set Transmit Interval Time ===
587 587  
588 588  
589 589  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -591,7 +591,7 @@
591 591  (% style="color:blue" %)**AT Command: AT+TDC**
592 592  
593 593  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
594 -|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)**Function**|=(% style="background-color:#D9E2F3; color:#0070c0" %)**Response**
794 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
595 595  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
596 596  30000
597 597  OK
... ... @@ -611,16 +611,36 @@
611 611  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
612 612  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
613 613  
614 -=== 3.3.2 Get Device Status ===
814 +=== 3.3.2  Set Power Output Duration ===
615 615  
616 616  
617 -Send a LoRaWAN downlink to ask device send Alarm settings.
817 +Control the output duration 5V . Before each sampling, device will
618 618  
619 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
819 +~1. first enable the power output to external sensor,
620 620  
621 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
821 +2. keep it on as per duration, read sensor value and construct uplink payload
622 622  
823 +3. final, close the power output.
623 623  
825 +(% style="color:blue" %)**AT Command: AT+5VT**
826 +
827 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
828 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 204px; background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color: #4F81BD;color:white; width: 149px;" %)**Response**
829 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
830 +OK
831 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
832 +OK
833 +
834 +)))
835 +
836 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
837 +Format: Command Code (0x07) followed by 2 bytes.
838 +
839 +The first and second bytes are the time to turn on.
840 +
841 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
842 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
843 +
624 624  === 3.3.3  Enable / Disable Alarm ===
625 625  
626 626  
... ... @@ -628,8 +628,8 @@
628 628  
629 629  (% style="color:blue" %)**AT Command: **
630 630  
631 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
632 -|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response**
851 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
852 +|(% style="background-color:#4f81bd; color:white; width:153px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:276px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:86px" %)**Response**
633 633  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
634 634  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
635 635  
... ... @@ -643,9 +643,8 @@
643 643  === 3.3.4  Alarm Base on Timeout ===
644 644  
645 645  
646 -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:
866 +DS03A-LB/LS 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:
647 647  
648 -
649 649  * (((
650 650  (% style="color:blue" %)**Keep Status: Status to be monitor**
651 651  )))
... ... @@ -666,42 +666,104 @@
666 666  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.
667 667  
668 668  
888 +* (((
889 +(% style="color:blue" %)**Downlink Command**
890 +)))
891 +
892 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
893 +
894 +**A9:** Command Type Code
895 +
896 +**aa: **01:TTRIG1; 02:TTRIG2
897 +
898 +**bb:** status to be monitored
899 +
900 +**cc dd:** timeout.
901 +
902 +
903 +**1) AT+TTRIG1 : (PA8 of pin)**
904 +
669 669  (% style="color:blue" %)**AT Command to configure:**
670 670  
671 671  * (((
672 -(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
908 +(% style="color:#037691" %)**AT+TTRIG1=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm1 bit(the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
909 +
910 +(% style="color:#037691" %)**AT+TTRIG1=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB/LS 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.
673 673  )))
674 674  
675 675  * (((
676 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
914 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
915 +
916 +
917 +
677 677  )))
678 678  
679 679  (% style="color:blue" %)**Downlink Command to configure:**
680 680  
681 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
922 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
682 682  
683 -**A9:** Command Type Code
684 684  
685 -**aa:** status to be monitored
925 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
686 686  
687 -**bb cc:** timeout.
927 +(% style="color:blue" %)**AT Command to configure:**
688 688  
929 +* (((
930 +(% style="color:#037691" %)**AT+TTRIG2=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS 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.
689 689  
690 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
932 +(% style="color:#037691" %)**AT+TTRIG2=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
933 +)))
691 691  
692 -Or
935 +* (((
936 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
693 693  
694 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
695 695  
939 +
940 +)))
696 696  
697 -=== 3.3.5  Count Mod ===
942 +(% style="color:blue" %)**Downlink Command to configure:**
698 698  
944 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30  **or**  0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
699 699  
946 +
947 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
948 +
949 +
950 +It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval.
951 +
700 700  (% style="color:blue" %)**AT Command:**
701 701  
702 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
703 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 277px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)**Response**
954 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
955 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 279px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 76px;background-color:#4F81BD;color:white" %)**Response**
704 704  |(% style="width:155px" %)(((
957 +AT+TTRALARM=0
958 +)))|(% style="width:279px" %)(((
959 +disable continuous alarm
960 +)))|(% style="width:84px" %)(((
961 +OK
962 +)))
963 +|(% style="width:155px" %)(((
964 +AT+TTRALARM=60
965 +)))|(% style="width:279px" %)(((
966 +The alarm interval is 60 minutes (unit: minutes)
967 +)))|(% style="width:84px" %)(((
968 +OK
969 +)))
970 +
971 +(% style="color:blue" %)**Downlink Command:**
972 +
973 +Example:  0C aa  => AT+TTRALARM= aa
974 +
975 +
976 +=== 3.3.6  Count Mod ===
977 +
978 +
979 +Feature: Manually set the count mode.
980 +
981 +(% style="color:blue" %)**AT Command:**
982 +
983 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
984 +|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 275px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 86px;background-color:#4F81BD;color:white" %)**Response**
985 +|(% style="width:155px" %)(((
705 705  AT+COUNTMOD=0
706 706  )))|(% style="width:277px" %)(((
707 707  the count value keeps accumulating mode
... ... @@ -711,7 +711,7 @@
711 711  |(% style="width:155px" %)(((
712 712  AT+COUNTMOD=1
713 713  )))|(% style="width:277px" %)(((
714 -the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
995 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
715 715  )))|(% style="width:86px" %)(((
716 716  OK
717 717  )))
... ... @@ -721,24 +721,26 @@
721 721  Example:  0B aa  => AT+COUNTMOD = second byte
722 722  
723 723  
724 -=== 3.3.6  Interrupt Pin Channel Mod ===
1005 +=== 3.3.7  Number of channel of door sensors ===
725 725  
726 726  
1008 +Feature: Set the number of door sensor channels.
1009 +
727 727  (% style="color:blue" %)**AT Command:**
728 728  
729 729  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
730 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1013 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
731 731  |(% style="width:155px" %)(((
732 732  AT+TTRCHANNEL=1
733 -)))|(% style="width:288px" %)(((
734 -set as single channel, only use PA8 pin as interrupt pin.
1016 +)))|(% style="width:259px" %)(((
1017 +Set as single channel, only use PA8 pin as interrupt pin.
735 735  )))|(% style="width:44px" %)(((
736 736  OK
737 737  )))
738 738  |(% style="width:155px" %)(((
739 739  AT+TTRCHANNEL=2
740 -)))|(% style="width:288px" %)(((
741 -is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1023 +)))|(% style="width:259px" %)(((
1024 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
742 742  )))|(% style="width:44px" %)(((
743 743  OK
744 744  )))
... ... @@ -748,55 +748,96 @@
748 748  Example:  0D aa => AT+TTRCHANNEL = second byte
749 749  
750 750  
751 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1034 +=== 3.3.8  Set Time Sync Mode ===
752 752  
753 753  
754 -(% style="color:blue" %)**Downlink Command:**
1037 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
755 755  
756 -Example A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1039 +SYNCMOD is set to 1 by default. If user wants to set a different time from the LoRaWAN server, the user needs to set this to 0.
757 757  
1041 +(% style="color:blue" %)**AT Command:**
758 758  
759 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1043 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1044 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
1045 +|(% style="width:155px" %)(((
1046 +AT+SYNCMOD=1
1047 +)))|(% style="width:259px" %)(((
1048 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1049 +)))|(% style="width:44px" %)(((
1050 +OK
1051 +)))
1052 +|(% style="width:155px" %)(((
1053 +AT+SYNCMOD=1,8
1054 +)))|(% style="width:259px" %)(((
1055 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1056 +)))|(% style="width:44px" %)(((
1057 +OK
1058 +)))
1059 +|(% style="width:155px" %)AT+SYNCMOD=1,-12|(% style="width:259px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.|(% style="width:44px" %)OK
760 760  
761 -
762 762  (% style="color:blue" %)**Downlink Command:**
763 763  
764 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1063 +0x28 0 ~/~/ Same As AT+SYNCMOD=1
765 765  
1065 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
766 766  
767 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1067 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
768 768  
1069 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
769 769  
770 -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.
771 771  
1072 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1073 +
1074 +
772 772  (% style="color:blue" %)**AT Command:**
773 773  
774 774  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
775 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 279px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 76px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1078 +|=(% style="width: 163px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 290px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
1079 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1080 +OK
1081 +)))
1082 +
1083 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1084 +
1085 +The sensor will clear the open door times and the duration of the last open door.
1086 +
1087 +
1088 +=== 3.3.10  Set the count value of the number of open door ===
1089 +
1090 +
1091 +(% style="color:blue" %)**AT Command:**
1092 +
1093 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1094 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
776 776  |(% style="width:155px" %)(((
777 -AT+TTRALARM=0
778 -)))|(% style="width:279px" %)(((
779 -disable continuous alarm
780 -)))|(% style="width:84px" %)(((
1096 +AT+SETCNT=1,100
1097 +)))|(% style="width:259px" %)(((
1098 +Set the open door times of PA8 pin to 100 times.
1099 +)))|(% style="width:44px" %)(((
781 781  OK
782 782  )))
1102 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
783 783  |(% style="width:155px" %)(((
784 -AT+TTRALARM=60
785 -)))|(% style="width:279px" %)(((
786 -The alarm interval is 60 minutes (unit: minutes)
787 -)))|(% style="width:84px" %)(((
1104 +AT+SETCNT=2,50
1105 +)))|(% style="width:259px" %)(((
1106 +Set the open door times of PA4 pin to 100 times.
1107 +)))|(% style="width:44px" %)(((
788 788  OK
789 789  )))
790 790  
791 791  (% style="color:blue" %)**Downlink Command:**
792 792  
793 -Example:  0C aa  => AT+TTRALARM= aa
1113 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
794 794  
1115 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
795 795  
1117 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1118 +
1119 +
796 796  = 4. Battery & Power Consumption =
797 797  
798 798  
799 -DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1123 +DS03A-LB use ER26500 + SPC1520 battery pack and DS03A-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
800 800  
801 801  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
802 802  
... ... @@ -804,7 +804,7 @@
804 804  = 5. OTA firmware update =
805 805  
806 806  
807 -User can change firmware DS03A-LB to:
1131 +User can change firmware DS03A-LB/LS to:
808 808  
809 809  * Change Frequency band/ region.
810 810  * Update with new features.
... ... @@ -812,9 +812,8 @@
812 812  
813 813  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
814 814  
1139 +Methods to Update Firmware:
815 815  
816 -**Methods to Update Firmware:**
817 -
818 818  * (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/]]**
819 819  * 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]]**.
820 820  
... ... @@ -825,7 +825,7 @@
825 825  = 7. Order Info =
826 826  
827 827  
828 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1151 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
829 829  
830 830  (% style="color:red" %)**XX**(%%): The default frequency band
831 831  
... ... @@ -850,7 +850,7 @@
850 850  
851 851  (% style="color:#037691" %)**Package Includes**:
852 852  
853 -* DS03A-LB LoRaWAN Temperature Sensor
1176 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
854 854  
855 855  (% style="color:#037691" %)**Dimension and weight**:
856 856  
image-20230630172740-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content
image-20240108160443-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +500.2 KB
Content
image-20240108161155-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +265.7 KB
Content