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

From version 40.11
edited by Xiaoling
on 2024/01/08 16:55
Change comment: There is no comment for this version
To version 20.1
edited by Saxer Lin
on 2023/06/30 16:08
Change comment: Uploaded new attachment "image-20230630160843-7.png", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
1 +DS03A-LB Outdoor LoRaWAN Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -1,18 +3,9 @@
1 -(% style="display:none" %) (%%)
2 -
3 3  (% style="text-align:center" %)
4 -[[image:image-20240108161155-2.png]]
2 +[[image:image-20230516085523-1.jpeg||height="491" width="491"]]
5 5  
6 6  
5 +**Table of Contents:**
7 7  
8 -
9 -
10 -
11 -
12 -
13 -
14 -**Table of Contents:**
15 -
16 16  {{toc/}}
17 17  
18 18  
... ... @@ -22,41 +22,41 @@
22 22  
23 23  = 1. Introduction =
24 24  
25 -== 1.1 What is LoRaWAN Door Sensor ==
16 +== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
26 26  
27 27  
28 28  (((
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.
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.
30 30  )))
31 31  
32 32  (((
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.
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.
34 34  )))
35 35  
36 36  (((
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.
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.
38 38  )))
39 39  
40 40  (((
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.
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.
42 42  )))
43 43  
44 44  (((
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.
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.
46 46  
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
38 +DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
48 48  )))
49 49  
50 50  (((
51 -DS03A-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
42 +DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
52 52  )))
53 53  
54 54  (((
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.
46 +DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
56 56  )))
57 57  
58 58  (((
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.
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.
60 60  )))
61 61  
62 62  
... ... @@ -76,19 +76,24 @@
76 76  * Support wireless OTA update firmware
77 77  * Uplink on periodically
78 78  * Downlink to change configure
70 +* 8500mAh Battery for long term use
79 79  * Wall Mountable
80 80  * Outdoor Use
81 -* 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 -* Solar panel + 3000mAh Li-on battery (DS03A-LS)
83 83  
74 +
84 84  == 1.3 Specification ==
85 85  
86 86  
87 87  (% style="color:#037691" %)**Common DC Characteristics:**
88 88  
89 -* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
80 +* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
90 90  * Operating Temperature: -40 ~~ 85°C
91 91  
83 +(% style="color:#037691" %)**Sensor Detect Distance:**
84 +
85 +* Wood Door: 10mm ~~ 30mm
86 +* Iron Door: 30 ~~ 45mm
87 +
92 92  (% style="color:#037691" %)**LoRa Spec:**
93 93  
94 94  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -109,6 +109,7 @@
109 109  * Sleep Mode: 5uA @ 3.3v
110 110  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
111 111  
108 +
112 112  == 1.4 Applications ==
113 113  
114 114  
... ... @@ -126,10 +126,11 @@
126 126  == 1.6 Button & LEDs ==
127 127  
128 128  
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"]]
126 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
130 130  
128 +
131 131  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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**
130 +|=(% 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**
133 133  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
134 134  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
135 135  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
... ... @@ -141,10 +141,11 @@
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  
142 +
144 144  == 1.7 BLE connection ==
145 145  
146 146  
147 -DS03A-LB/LS support BLE remote configure.
146 +DS03A-LB support BLE remote configure.
148 148  
149 149  
150 150  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,44 +156,27 @@
156 156  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
157 157  
158 158  
159 -== 1.8 Pin Definitions ==
158 +== 1.8 Mechanical ==
160 160  
161 -[[image:image-20230630160843-7.png]]
162 162  
163 -
164 -== 1.9 Mechanical ==
165 -
166 -=== 1.9.1 for LB version ===
167 -
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 -**Probe Mechanical:**
172 -
173 173  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
174 174  
175 175  
164 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
176 176  
177 -=== 1.9.2 for LS version ===
178 178  
167 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
179 179  
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"]]
181 181  
170 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
182 182  
183 183  
173 += 2. Configure DS03A-LB to connect to LoRaWAN network =
184 184  
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 -
193 193  == 2.1 How it works ==
194 194  
195 195  
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.
178 +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.
197 197  
198 198  
199 199  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -206,9 +206,9 @@
206 206  [[image:image-20230522092858-1.png||height="391" width="874"]]
207 207  
208 208  
209 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB/LS.
191 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
210 210  
211 -Each DS03A-LB/LS is shipped with a sticker with the default device EUI as below:
193 +Each DS03A-LB is shipped with a sticker with the default device EUI as below:
212 212  
213 213  [[image:image-20230426085205-1.png||height="238" width="512"]]
214 214  
... ... @@ -238,10 +238,10 @@
238 238  [[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"]]
239 239  
240 240  
241 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB/LS
223 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
242 242  
243 243  
244 -Press the button for 5 seconds to activate the DS03A-LB/LS.
226 +Press the button for 5 seconds to activate the DS03A-LB.
245 245  
246 246  (% 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.
247 247  
... ... @@ -253,13 +253,11 @@
253 253  === 2.3.1 Device Status, FPORT~=5 ===
254 254  
255 255  
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.
238 +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.
257 257  
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.
259 -
260 -
261 261  The Payload format is as below.
262 262  
242 +
263 263  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
264 264  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
265 265  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -270,7 +270,7 @@
270 270  [[image:image-20230630155406-1.png||height="190" width="873"]]
271 271  
272 272  
273 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB/LS, this value is 0x1B
253 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
274 274  
275 275  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
276 276  
... ... @@ -323,271 +323,48 @@
323 323  Ex2: 0x0B49 = 2889mV
324 324  
325 325  
326 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
306 +=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
327 327  
328 328  
329 -DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server.
309 +DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
330 330  
331 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
332 -|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; 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 -)))
343 -
344 -Example parse in TTNv3
345 -
346 -[[image:image-20230630155527-3.png||height="146" width="902"]]
347 -
348 -
349 -* (((
350 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
351 -)))
352 -
353 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
354 -
355 -
356 -* (((
357 -(% style="color:blue" %)**Disalarm: (default: 0)**
358 -)))
359 -
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.
361 -
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.
363 -
364 -
365 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
366 -
367 -
368 -* (((
369 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
370 -)))
371 -
372 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
373 -
374 -
375 -
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 -
383 -=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
384 -
385 -
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:
387 -
388 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
311 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
389 389  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
390 390  
391 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
314 +Uplink Payload totals 11 bytes.
392 392  
393 393  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
394 394  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
395 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
396 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
397 -Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
398 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
399 -The last door open duration (unit: sec)
318 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4**
319 +|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
320 +The last door open duration (unit: min)
400 400  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
401 401  
402 402  **Status & Alarm:**
403 403  
404 404  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
405 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0**
406 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
407 -Count mod
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 -)))
326 +|(% 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**
327 +|(% style="width:76px" %)**Value**|(% style="width:79px" %)(((
328 +No ACK Message
329 +)))|(% style="width:84px" %)(((
330 +Poll Message Flag
331 +)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
332 +0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open
413 413  
414 414  [[image:image-20230630155451-2.png||height="246" width="928"]]
415 415  
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:#D9E2F3;color:#0070C0; 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:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit0**
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:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit0**
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 -
506 506  [[image:image-20230630155908-6.png||height="295" width="927"]]
507 507  
508 508  
509 -* (((
510 -(% style="color:blue" %)**Count mod:Default=0**
511 -)))
339 +=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
512 512  
513 -0: Uplink total open door times since factory
514 514  
515 -1: Uplink total open door times since last FPORT=2 uplink.
342 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
516 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 -
559 -=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
560 -
561 -
562 -DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
563 -
564 564  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
565 565  
566 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
567 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;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:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:65px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit0**
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 -
589 589  * (((
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.
347 +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.
591 591  )))
592 592  
593 593  For example, in the US915 band, the max payload for different DR is:
... ... @@ -624,7 +624,7 @@
624 624  
625 625  **Parsed Value:**
626 626  
627 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
384 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
628 628  
629 629  
630 630  [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
... ... @@ -641,9 +641,46 @@
641 641  
642 642  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
643 643  
644 -[[image:image-20230630172740-1.png||height="199" width="868"]]
401 +[[image:image-20230630155751-5.png||height="188" width="809"]]
645 645  
403 +=== 2.3.4  Sensor Configuration, FPORT~=4 ===
646 646  
405 +
406 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
407 +
408 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
409 +|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
410 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
411 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
412 +
413 +* (((
414 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
415 +)))
416 +
417 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
418 +
419 +
420 +* (((
421 +(% style="color:blue" %)**Disalarm: (default: 0)**
422 +)))
423 +
424 + **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.
425 +
426 + **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.
427 +
428 +
429 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
430 +
431 +
432 +* (((
433 +(% style="color:blue" %)**Keep Status & Keep Time**
434 +)))
435 +
436 +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]]
437 +
438 +[[image:image-20230630155527-3.png||height="146" width="902"]]
439 +
440 +
647 647  == 2.4 Payload Decoder file ==
648 648  
649 649  
... ... @@ -659,25 +659,26 @@
659 659  == 2.5 Datalog Feature ==
660 660  
661 661  
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.
456 +(% 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.
663 663  
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.**
665 665  
666 -
667 667  === 2.5.1 Ways to get datalog via LoRaWAN ===
668 668  
669 669  
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.
462 +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.
671 671  
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.
464 +* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
465 +* 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.
674 674  
467 +Below is the typical case for the Datalog Feature (Set PNACKMD=1)
675 675  
469 +[[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"]]
676 676  
471 +
677 677  === 2.5.2 Unix TimeStamp ===
678 678  
679 679  
680 -DS03A-LB/LS uses Unix TimeStamp format based on
475 +DS03A-LB uses Unix TimeStamp format based on
681 681  
682 682  [[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"]]
683 683  
... ... @@ -695,7 +695,7 @@
695 695  
696 696  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
697 697  
698 -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).
493 +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).
699 699  
700 700  (% 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.**
701 701  
... ... @@ -708,7 +708,7 @@
708 708  
709 709  (% 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]]
710 710  
711 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB/LS in Datacake.**
506 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
712 712  
713 713  [[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"]]
714 714  
... ... @@ -743,7 +743,7 @@
743 743  == 2.7 Frequency Plans ==
744 744  
745 745  
746 -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.
541 +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.
747 747  
748 748  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
749 749  
... ... @@ -754,17 +754,18 @@
754 754  **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
755 755  
756 756  
757 -= 3. Configure DS03A-LB/LS =
552 += 3. Configure DS03A-LB =
758 758  
759 759  == 3.1 Configure Methods: ==
760 760  
761 761  
762 -DS03A-LB/LS supports below configure method:
557 +DS03A-LB supports below configure method:
763 763  
764 764  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
765 765  * 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]].
766 766  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
767 767  
563 +
768 768  == 3.2 General Commands ==
769 769  
770 770  
... ... @@ -778,13 +778,13 @@
778 778  [[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/]]
779 779  
780 780  
781 -== 3.3 Commands special design for DS03A-LB/LS ==
577 +== 3.3 Commands special design for DS03A-LB ==
782 782  
783 783  
784 -These commands only valid for DS03A-LB/LS, as below:
580 +These commands only valid for DS03A-LB, as below:
785 785  
786 786  
787 -=== 3.3.1  Set Transmit Interval Time ===
583 +=== 3.3.1 Set Transmit Interval Time ===
788 788  
789 789  
790 790  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -812,36 +812,17 @@
812 812  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
813 813  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
814 814  
815 -=== 3.3.2  Set Power Output Duration ===
816 816  
612 +=== 3.3.2 Get Device Status ===
817 817  
818 -Control the output duration 5V . Before each sampling, device will
819 819  
820 -~1. first enable the power output to external sensor,
615 +Send a LoRaWAN downlink to ask device send Alarm settings.
821 821  
822 -2. keep it on as per duration, read sensor value and construct uplink payload
617 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
823 823  
824 -3. final, close the power output.
619 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
825 825  
826 -(% style="color:blue" %)**AT Command: AT+5VT**
827 827  
828 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
829 -|=(% 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**
830 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
831 -OK
832 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
833 -OK
834 -
835 -)))
836 -
837 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
838 -Format: Command Code (0x07) followed by 2 bytes.
839 -
840 -The first and second bytes are the time to turn on.
841 -
842 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
843 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
844 -
845 845  === 3.3.3  Enable / Disable Alarm ===
846 846  
847 847  
... ... @@ -849,8 +849,8 @@
849 849  
850 850  (% style="color:blue" %)**AT Command: **
851 851  
852 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
853 -|(% style="background-color:#d9e2f3; color:#0070c0; width:153px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:276px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:86px" %)**Response**
629 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
630 +|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response**
854 854  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
855 855  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
856 856  
... ... @@ -864,8 +864,9 @@
864 864  === 3.3.4  Alarm Base on Timeout ===
865 865  
866 866  
867 -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:
644 +DS03A-LB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
868 868  
646 +
869 869  * (((
870 870  (% style="color:blue" %)**Keep Status: Status to be monitor**
871 871  )))
... ... @@ -886,104 +886,42 @@
886 886  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.
887 887  
888 888  
889 -* (((
890 -(% style="color:blue" %)**Downlink Command**
891 -)))
892 -
893 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
894 -
895 -**A9:** Command Type Code
896 -
897 -**aa: **01:TTRIG1; 02:TTRIG2
898 -
899 -**bb:** status to be monitored
900 -
901 -**cc dd:** timeout.
902 -
903 -
904 -**1) AT+TTRIG1 : (PA8 of pin)**
905 -
906 906  (% style="color:blue" %)**AT Command to configure:**
907 907  
908 908  * (((
909 -(% 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.
910 -
911 -(% 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.
670 +(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
912 912  )))
913 913  
914 914  * (((
915 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
916 -
917 -
918 -
674 +(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
919 919  )))
920 920  
921 921  (% style="color:blue" %)**Downlink Command to configure:**
922 922  
923 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
679 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
924 924  
681 +**A9:** Command Type Code
925 925  
926 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
683 +**aa:** status to be monitored
927 927  
928 -(% style="color:blue" %)**AT Command to configure:**
685 +**bb cc:** timeout.
929 929  
930 -* (((
931 -(% 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.
932 932  
933 -(% 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.
934 -)))
688 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
935 935  
936 -* (((
937 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
690 +Or
938 938  
692 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
939 939  
940 -
941 -)))
942 942  
943 -(% style="color:blue" %)**Downlink Command to configure:**
695 +=== 3.3.5  Count Mod ===
944 944  
945 -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.
946 946  
947 -
948 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
949 -
950 -
951 -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.
952 -
953 953  (% style="color:blue" %)**AT Command:**
954 954  
955 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
956 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 279px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 76px;background-color:#D9E2F3;color:#0070C0" %)**Response**
700 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
701 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 277px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)**Response**
957 957  |(% style="width:155px" %)(((
958 -AT+TTRALARM=0
959 -)))|(% style="width:279px" %)(((
960 -disable continuous alarm
961 -)))|(% style="width:84px" %)(((
962 -OK
963 -)))
964 -|(% style="width:155px" %)(((
965 -AT+TTRALARM=60
966 -)))|(% style="width:279px" %)(((
967 -The alarm interval is 60 minutes (unit: minutes)
968 -)))|(% style="width:84px" %)(((
969 -OK
970 -)))
971 -
972 -(% style="color:blue" %)**Downlink Command:**
973 -
974 -Example:  0C aa  => AT+TTRALARM= aa
975 -
976 -
977 -=== 3.3.6  Count Mod ===
978 -
979 -
980 -Feature: Manually set the count mode.
981 -
982 -(% style="color:blue" %)**AT Command:**
983 -
984 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
985 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 275px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)**Response**
986 -|(% style="width:155px" %)(((
987 987  AT+COUNTMOD=0
988 988  )))|(% style="width:277px" %)(((
989 989  the count value keeps accumulating mode
... ... @@ -993,7 +993,7 @@
993 993  |(% style="width:155px" %)(((
994 994  AT+COUNTMOD=1
995 995  )))|(% style="width:277px" %)(((
996 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
712 +the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
997 997  )))|(% style="width:86px" %)(((
998 998  OK
999 999  )))
... ... @@ -1003,26 +1003,24 @@
1003 1003  Example:  0B aa  => AT+COUNTMOD = second byte
1004 1004  
1005 1005  
1006 -=== 3.3.7  Number of channel of door sensors ===
722 +=== 3.3.6  Interrupt Pin Channel Mod ===
1007 1007  
1008 1008  
1009 -Feature: Set the number of door sensor channels.
1010 -
1011 1011  (% style="color:blue" %)**AT Command:**
1012 1012  
1013 1013  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1014 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
728 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1015 1015  |(% style="width:155px" %)(((
1016 1016  AT+TTRCHANNEL=1
1017 -)))|(% style="width:259px" %)(((
1018 -Set as single channel, only use PA8 pin as interrupt pin.
731 +)))|(% style="width:288px" %)(((
732 +set as single channel, only use PA8 pin as interrupt pin.
1019 1019  )))|(% style="width:44px" %)(((
1020 1020  OK
1021 1021  )))
1022 1022  |(% style="width:155px" %)(((
1023 1023  AT+TTRCHANNEL=2
1024 -)))|(% style="width:259px" %)(((
1025 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
738 +)))|(% style="width:288px" %)(((
739 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1026 1026  )))|(% style="width:44px" %)(((
1027 1027  OK
1028 1028  )))
... ... @@ -1032,96 +1032,55 @@
1032 1032  Example:  0D aa => AT+TTRCHANNEL = second byte
1033 1033  
1034 1034  
1035 -=== 3.3.8  Set Time Sync Mode ===
749 +=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1036 1036  
1037 1037  
1038 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1039 -
1040 -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.
1041 -
1042 -(% style="color:blue" %)**AT Command:**
1043 -
1044 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1045 -|=(% 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**
1046 -|(% style="width:155px" %)(((
1047 -AT+SYNCMOD=1
1048 -)))|(% style="width:259px" %)(((
1049 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1050 -)))|(% style="width:44px" %)(((
1051 -OK
1052 -)))
1053 -|(% style="width:155px" %)(((
1054 -AT+SYNCMOD=1,8
1055 -)))|(% style="width:259px" %)(((
1056 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1057 -)))|(% style="width:44px" %)(((
1058 -OK
1059 -)))
1060 -|(% 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
1061 -
1062 1062  (% style="color:blue" %)**Downlink Command:**
1063 1063  
1064 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
754 +Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1065 1065  
1066 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1067 1067  
1068 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
757 +=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1069 1069  
1070 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1071 1071  
760 +(% style="color:blue" %)**Downlink Command:**
1072 1072  
1073 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
762 +Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1074 1074  
1075 1075  
1076 -(% style="color:blue" %)**AT Command:**
765 +=== 3.3.9  TTRIG1/2 timeout status alarm ===
1077 1077  
1078 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1079 -|=(% 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**
1080 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1081 -OK
1082 -)))
1083 1083  
1084 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
768 +It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval.
1085 1085  
1086 -The sensor will clear the open door times and the duration of the last open door.
1087 -
1088 -
1089 -=== 3.3.10  Set the count value of the number of open door ===
1090 -
1091 -
1092 1092  (% style="color:blue" %)**AT Command:**
1093 1093  
1094 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1095 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
772 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
773 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 279px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 76px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1096 1096  |(% style="width:155px" %)(((
1097 -AT+SETCNT=1,100
1098 -)))|(% style="width:259px" %)(((
1099 -Set the open door times of PA8 pin to 100 times.
1100 -)))|(% style="width:44px" %)(((
775 +AT+TTRALARM=0
776 +)))|(% style="width:279px" %)(((
777 +disable continuous alarm
778 +)))|(% style="width:84px" %)(((
1101 1101  OK
1102 1102  )))
1103 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1104 1104  |(% style="width:155px" %)(((
1105 -AT+SETCNT=2,50
1106 -)))|(% style="width:259px" %)(((
1107 -Set the open door times of PA4 pin to 100 times.
1108 -)))|(% style="width:44px" %)(((
782 +AT+TTRALARM=60
783 +)))|(% style="width:279px" %)(((
784 +The alarm interval is 60 minutes (unit: minutes)
785 +)))|(% style="width:84px" %)(((
1109 1109  OK
1110 1110  )))
1111 1111  
1112 1112  (% style="color:blue" %)**Downlink Command:**
1113 1113  
1114 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
791 +Example:  0C aa  => AT+TTRALARM= aa
1115 1115  
1116 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1117 1117  
1118 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1119 -
1120 -
1121 1121  = 4. Battery & Power Consumption =
1122 1122  
1123 1123  
1124 -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.
797 +DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1125 1125  
1126 1126  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1127 1127  
... ... @@ -1129,7 +1129,7 @@
1129 1129  = 5. OTA firmware update =
1130 1130  
1131 1131  
1132 -User can change firmware DS03A-LB/LS to:
805 +User can change firmware DS03A-LB to:
1133 1133  
1134 1134  * Change Frequency band/ region.
1135 1135  * Update with new features.
... ... @@ -1137,11 +1137,13 @@
1137 1137  
1138 1138  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1139 1139  
1140 -Methods to Update Firmware:
1141 1141  
814 +**Methods to Update Firmware:**
815 +
1142 1142  * (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/]]**
1143 1143  * 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]]**.
1144 1144  
819 +
1145 1145  = 6. FAQ =
1146 1146  
1147 1147  
... ... @@ -1149,7 +1149,7 @@
1149 1149  = 7. Order Info =
1150 1150  
1151 1151  
1152 -**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
827 +Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1153 1153  
1154 1154  (% style="color:red" %)**XX**(%%): The default frequency band
1155 1155  
... ... @@ -1169,12 +1169,13 @@
1169 1169  
1170 1170  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1171 1171  
847 +
1172 1172  = 8. ​Packing Info =
1173 1173  
1174 1174  
1175 1175  (% style="color:#037691" %)**Package Includes**:
1176 1176  
1177 -* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
853 +* DS03A-LB LoRaWAN Temperature Sensor
1178 1178  
1179 1179  (% style="color:#037691" %)**Dimension and weight**:
1180 1180  
... ... @@ -1186,6 +1186,7 @@
1186 1186  
1187 1187  * Weight / pcs : g
1188 1188  
865 +
1189 1189  = 9. Support =
1190 1190  
1191 1191  
image-20230630172740-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -34.5 KB
Content
image-20240108160443-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -500.2 KB
Content
image-20240108161155-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -265.7 KB
Content