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

From version 41.2
edited by Xiaoling
on 2024/01/15 09:40
Change comment: There is no comment for this version
To version 26.1
edited by Saxer Lin
on 2023/06/30 17:27
Change comment: Uploaded new attachment "image-20230630172740-1.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,10 +76,9 @@
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  
84 84  == 1.3 Specification ==
85 85  
... ... @@ -86,9 +86,14 @@
86 86  
87 87  (% style="color:#037691" %)**Common DC Characteristics:**
88 88  
89 -* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
79 +* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
90 90  * Operating Temperature: -40 ~~ 85°C
91 91  
82 +(% style="color:#037691" %)**Sensor Detect Distance:**
83 +
84 +* Wood Door: 10mm ~~ 30mm
85 +* Iron Door: 30 ~~ 45mm
86 +
92 92  (% style="color:#037691" %)**LoRa Spec:**
93 93  
94 94  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -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"]]
124 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
130 130  
126 +
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**
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**
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.
... ... @@ -144,7 +144,7 @@
144 144  == 1.7 BLE connection ==
145 145  
146 146  
147 -DS03A-LB/LS support BLE remote configure.
143 +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:
... ... @@ -160,40 +160,27 @@
160 160  
161 161  [[image:image-20230630160843-7.png]]
162 162  
163 -
164 164  == 1.9 Mechanical ==
165 165  
166 -=== 1.9.1 for LB version ===
167 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 -(% style="color:blue" %)**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  
165 +[[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  
168 +[[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  
171 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
182 182  
183 183  
174 += 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.
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.
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.
192 +(% 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:
194 +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
224 +(% 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.
227 +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,17 +253,15 @@
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.
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.
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  
243 +
263 263  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
264 -|(% colspan="6" style="background-color:#4f81bd; color:white" %)**Device Status (FPORT=5)**
245 +|(% 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**
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
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
267 267  
268 268  Example parse in TTNv3
269 269  
... ... @@ -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
254 +(% 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,29 +323,32 @@
323 323  Ex2: 0x0B49 = 2889mV
324 324  
325 325  
326 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
307 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
327 327  
328 328  
329 -DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server.
310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
330 330  
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" %)(((
312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:723px" %)
313 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:721px" %)**Sensor Configuration FPORT=4**
314 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:99px" %)**2**|(% style="width:87px" %)**1**|(% style="width:97px" %)**2**|(% style="width:98px" %)**1**
315 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
335 335  Keep status1
317 +
318 +
336 336  )))|(% style="width:99px" %)(((
337 -Keep time1(unit: sec)
320 +Keep time1
321 +
322 +(unit: sec)
338 338  )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
339 -Keep time2(unit: sec)
324 +Keep time2
325 +
326 +(unit: sec)
340 340  )))|(% style="width:98px" %)(((
341 -Alarm interval(unit: min)
328 +Alarm interval
329 +
330 +(unit: min)
342 342  )))
343 343  
344 -Example parse in TTNv3
345 -
346 -[[image:image-20230630155527-3.png||height="146" width="902"]]
347 -
348 -
349 349  * (((
350 350  (% style="color:blue" %)**TDC: (default: 0x001C20)**
351 351  )))
... ... @@ -357,9 +357,9 @@
357 357  (% style="color:blue" %)**Disalarm: (default: 0)**
358 358  )))
359 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.
344 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
361 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.
346 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
363 363  
364 364  
365 365  (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
... ... @@ -369,8 +369,9 @@
369 369  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
370 370  )))
371 371  
372 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
373 373  
358 +[[image:image-20230630155527-3.png||height="146" width="902"]]
374 374  
375 375  
376 376  * (((
... ... @@ -383,18 +383,21 @@
383 383  === 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
384 384  
385 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:
371 +DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
387 387  
388 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
373 +* 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)(%%)**
392 392  
377 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**)
378 +
393 393  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
394 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
380 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
395 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"]]
382 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
383 +Status
384 +
385 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
398 398  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
399 399  The last door open duration (unit: sec)
400 400  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -401,173 +401,87 @@
401 401  
402 402  **Status & Alarm:**
403 403  
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" %)(((
392 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:645px" %)
393 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:125px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit0**
394 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
407 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 -)))
396 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:125px" %)(((
397 +0: No Alarm;
413 413  
414 -[[image:image-20230630155451-2.png||height="246" width="928"]]
399 +1: Alarm
400 +)))|(% style="width:129px" %)(((
401 +Status 0: Close;
415 415  
416 -
417 -* (((
418 -(% style="color:blue" %)**Count mod:Default=0**
403 +1: Open
419 419  )))
420 420  
421 -0: Uplink total open door times since factory
406 +[[image:image-20230630155451-2.png||height="246" width="928"]]
422 422  
423 -1: Uplink total open door times since last FPORT=2 uplink.
424 424  
409 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes.
425 425  
426 -* (% style="color:blue" %)**TDC flag**
411 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %)
412 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2**
413 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:125px" %)**3**|(% style="width:100px" %)**4**|(% style="width:86px" %)**1**|(% style="width:96px" %)**3**|(% style="width:126px" %)**3**
414 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
415 +Status1
427 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
417 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
478 478  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
479 479  The last door open duration1 (unit: sec)
480 480  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
481 -Status2 & Alarm2
421 +Status2
422 +
423 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
482 482  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
483 483  
484 484  **Status1 & Alarm1:**
485 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" %)(((
428 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:730px" %)
429 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:167px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:171px" %)**bit0**
430 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
489 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 -)))
432 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)(((
433 +0: No Alarm; 1: Alarm
495 495  
496 -**Status2 & Alarm2:**
435 +(PA8)
436 +)))|(% style="width:171px" %)(((
437 +Status 0: Close; 1:Open
497 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)
439 +(PA8)
504 504  )))
505 505  
506 -[[image:image-20230630155908-6.png||height="295" width="927"]]
442 +**Status2 & Alarm2:**
507 507  
444 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:550px" %)
445 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:113px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:176px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:175px" %)**bit0**
446 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:176px" %)(((
447 +0: No Alarm; 1: Alarm
508 508  
509 -* (((
510 -(% style="color:blue" %)**Count mod:Default=0**
511 -)))
449 +(PA4)
450 +)))|(% style="width:175px" %)(((
451 +Status 0: Close,;1:Open
512 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**
453 +(PA4)
527 527  )))
528 528  
529 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
456 +[[image:image-20230630155908-6.png||height="295" width="927"]]
530 530  
531 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 559  === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
560 560  
561 561  
562 -DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
462 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
563 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:#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"]]
466 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
467 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
468 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
469 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
470 +Status
471 +
472 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
571 571  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
572 572  The last door open duration (unit: sec)
573 573  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -574,20 +574,22 @@
574 574  
575 575  **Status & Alarm:**
576 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" %)(((
479 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %)
480 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:92px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:89px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:90px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:116px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:112px" %)**bit0**
481 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
580 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
483 +)))|(% style="width:95px" %)TDC flag 0:No;1:Yes|(% style="width:116px" %)(((
484 +0: No Alarm;
485 +
486 +1: Alarm
585 585  )))|(% style="width:112px" %)(((
586 -Status 0:Close; 1: Open
488 +Status 0:Close;
489 +
490 +1: Open
587 587  )))
588 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.
494 +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]
531 +[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,7 +641,7 @@
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"]]
548 +[[image:image-20230630155751-5.png||height="188" width="809"]]
645 645  
646 646  
647 647  == 2.4 Payload Decoder file ==
... ... @@ -659,7 +659,7 @@
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.
566 +(% 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 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  
... ... @@ -667,15 +667,20 @@
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.
574 +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.
576 +* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
577 +* 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  
579 +Below is the typical case for the Datalog Feature (Set PNACKMD=1)
580 +
581 +[[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"]]
582 +
583 +
675 675  === 2.5.2 Unix TimeStamp ===
676 676  
677 677  
678 -DS03A-LB/LS uses Unix TimeStamp format based on
587 +DS03A-LB uses Unix TimeStamp format based on
679 679  
680 680  [[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"]]
681 681  
... ... @@ -693,7 +693,7 @@
693 693  
694 694  User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
695 695  
696 -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).
605 +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 697  
698 698  (% 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.**
699 699  
... ... @@ -706,7 +706,7 @@
706 706  
707 707  (% 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]]
708 708  
709 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB/LS in Datacake.**
618 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
710 710  
711 711  [[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"]]
712 712  
... ... @@ -741,7 +741,7 @@
741 741  == 2.7 Frequency Plans ==
742 742  
743 743  
744 -The DS03A-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
653 +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 745  
746 746  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
747 747  
... ... @@ -752,12 +752,12 @@
752 752  **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
753 753  
754 754  
755 -= 3. Configure DS03A-LB/LS =
664 += 3. Configure DS03A-LB =
756 756  
757 757  == 3.1 Configure Methods: ==
758 758  
759 759  
760 -DS03A-LB/LS supports below configure method:
669 +DS03A-LB supports below configure method:
761 761  
762 762  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
763 763  * 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]].
... ... @@ -776,13 +776,13 @@
776 776  [[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/]]
777 777  
778 778  
779 -== 3.3 Commands special design for DS03A-LB/LS ==
688 +== 3.3 Commands special design for DS03A-LB ==
780 780  
781 781  
782 -These commands only valid for DS03A-LB/LS, as below:
691 +These commands only valid for DS03A-LB, as below:
783 783  
784 784  
785 -=== 3.3.1  Set Transmit Interval Time ===
694 +=== 3.3.1 Set Transmit Interval Time ===
786 786  
787 787  
788 788  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -790,7 +790,7 @@
790 790  (% style="color:blue" %)**AT Command: AT+TDC**
791 791  
792 792  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
793 -|=(% 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**
702 +|=(% 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 794  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
795 795  30000
796 796  OK
... ... @@ -810,36 +810,16 @@
810 810  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
811 811  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
812 812  
813 -=== 3.3.2  Set Power Output Duration ===
722 +=== 3.3.2 Get Device Status ===
814 814  
815 815  
816 -Control the output duration 5V . Before each sampling, device will
725 +Send a LoRaWAN downlink to ask device send Alarm settings.
817 817  
818 -~1. first enable the power output to external sensor,
727 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
819 819  
820 -2. keep it on as per duration, read sensor value and construct uplink payload
729 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
821 821  
822 -3. final, close the power output.
823 823  
824 -(% style="color:blue" %)**AT Command: AT+5VT**
825 -
826 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
827 -|=(% 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**
828 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
829 -OK
830 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
831 -OK
832 -
833 -)))
834 -
835 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
836 -Format: Command Code (0x07) followed by 2 bytes.
837 -
838 -The first and second bytes are the time to turn on.
839 -
840 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
841 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
842 -
843 843  === 3.3.3  Enable / Disable Alarm ===
844 844  
845 845  
... ... @@ -847,8 +847,8 @@
847 847  
848 848  (% style="color:blue" %)**AT Command: **
849 849  
850 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
851 -|(% 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**
739 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
740 +|(% 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**
852 852  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
853 853  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
854 854  
... ... @@ -862,8 +862,9 @@
862 862  === 3.3.4  Alarm Base on Timeout ===
863 863  
864 864  
865 -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:
754 +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 866  
756 +
867 867  * (((
868 868  (% style="color:blue" %)**Keep Status: Status to be monitor**
869 869  )))
... ... @@ -884,104 +884,42 @@
884 884  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.
885 885  
886 886  
887 -* (((
888 -(% style="color:blue" %)**Downlink Command**
889 -)))
890 -
891 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
892 -
893 -**A9:** Command Type Code
894 -
895 -**aa: **01:TTRIG1; 02:TTRIG2
896 -
897 -**bb:** status to be monitored
898 -
899 -**cc dd:** timeout.
900 -
901 -
902 -**1) AT+TTRIG1 : (PA8 of pin)**
903 -
904 904  (% style="color:blue" %)**AT Command to configure:**
905 905  
906 906  * (((
907 -(% 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.
908 -
909 -(% 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.
780 +(% 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.
910 910  )))
911 911  
912 912  * (((
913 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
914 -
915 -
916 -
784 +(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
917 917  )))
918 918  
919 919  (% style="color:blue" %)**Downlink Command to configure:**
920 920  
921 -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.
789 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
922 922  
791 +**A9:** Command Type Code
923 923  
924 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
793 +**aa:** status to be monitored
925 925  
926 -(% style="color:blue" %)**AT Command to configure:**
795 +**bb cc:** timeout.
927 927  
928 -* (((
929 -(% 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.
930 930  
931 -(% 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.
932 -)))
798 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
933 933  
934 -* (((
935 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
800 +Or
936 936  
802 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
937 937  
938 -
939 -)))
940 940  
941 -(% style="color:blue" %)**Downlink Command to configure:**
805 +=== 3.3.5  Count Mod ===
942 942  
943 -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.
944 944  
945 -
946 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
947 -
948 -
949 -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.
950 -
951 951  (% style="color:blue" %)**AT Command:**
952 952  
953 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
954 -|=(% 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**
810 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
811 +|=(% 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**
955 955  |(% style="width:155px" %)(((
956 -AT+TTRALARM=0
957 -)))|(% style="width:279px" %)(((
958 -disable continuous alarm
959 -)))|(% style="width:84px" %)(((
960 -OK
961 -)))
962 -|(% style="width:155px" %)(((
963 -AT+TTRALARM=60
964 -)))|(% style="width:279px" %)(((
965 -The alarm interval is 60 minutes (unit: minutes)
966 -)))|(% style="width:84px" %)(((
967 -OK
968 -)))
969 -
970 -(% style="color:blue" %)**Downlink Command:**
971 -
972 -Example:  0C aa  => AT+TTRALARM= aa
973 -
974 -
975 -=== 3.3.6  Count Mod ===
976 -
977 -
978 -Feature: Manually set the count mode.
979 -
980 -(% style="color:blue" %)**AT Command:**
981 -
982 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
983 -|=(% 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**
984 -|(% style="width:155px" %)(((
985 985  AT+COUNTMOD=0
986 986  )))|(% style="width:277px" %)(((
987 987  the count value keeps accumulating mode
... ... @@ -991,7 +991,7 @@
991 991  |(% style="width:155px" %)(((
992 992  AT+COUNTMOD=1
993 993  )))|(% style="width:277px" %)(((
994 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
822 +the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
995 995  )))|(% style="width:86px" %)(((
996 996  OK
997 997  )))
... ... @@ -1001,26 +1001,24 @@
1001 1001  Example:  0B aa  => AT+COUNTMOD = second byte
1002 1002  
1003 1003  
1004 -=== 3.3.7  Number of channel of door sensors ===
832 +=== 3.3.6  Interrupt Pin Channel Mod ===
1005 1005  
1006 1006  
1007 -Feature: Set the number of door sensor channels.
1008 -
1009 1009  (% style="color:blue" %)**AT Command:**
1010 1010  
1011 1011  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1012 -|=(% 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**
838 +|=(% 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 1013  |(% style="width:155px" %)(((
1014 1014  AT+TTRCHANNEL=1
1015 -)))|(% style="width:259px" %)(((
1016 -Set as single channel, only use PA8 pin as interrupt pin.
841 +)))|(% style="width:288px" %)(((
842 +set as single channel, only use PA8 pin as interrupt pin.
1017 1017  )))|(% style="width:44px" %)(((
1018 1018  OK
1019 1019  )))
1020 1020  |(% style="width:155px" %)(((
1021 1021  AT+TTRCHANNEL=2
1022 -)))|(% style="width:259px" %)(((
1023 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
848 +)))|(% style="width:288px" %)(((
849 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1024 1024  )))|(% style="width:44px" %)(((
1025 1025  OK
1026 1026  )))
... ... @@ -1030,96 +1030,55 @@
1030 1030  Example:  0D aa => AT+TTRCHANNEL = second byte
1031 1031  
1032 1032  
1033 -=== 3.3.8  Set Time Sync Mode ===
859 +=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1034 1034  
1035 1035  
1036 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1037 -
1038 -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.
1039 -
1040 -(% style="color:blue" %)**AT Command:**
1041 -
1042 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1043 -|=(% 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**
1044 -|(% style="width:155px" %)(((
1045 -AT+SYNCMOD=1
1046 -)))|(% style="width:259px" %)(((
1047 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1048 -)))|(% style="width:44px" %)(((
1049 -OK
1050 -)))
1051 -|(% style="width:155px" %)(((
1052 -AT+SYNCMOD=1,8
1053 -)))|(% style="width:259px" %)(((
1054 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1055 -)))|(% style="width:44px" %)(((
1056 -OK
1057 -)))
1058 -|(% 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
1059 -
1060 1060  (% style="color:blue" %)**Downlink Command:**
1061 1061  
1062 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
864 +Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1063 1063  
1064 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1065 1065  
1066 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
867 +=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1067 1067  
1068 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1069 1069  
870 +(% style="color:blue" %)**Downlink Command:**
1070 1070  
1071 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
872 +Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1072 1072  
1073 1073  
1074 -(% style="color:blue" %)**AT Command:**
875 +=== 3.3.9  TTRIG1/2 timeout status alarm ===
1075 1075  
1076 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1077 -|=(% 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**
1078 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1079 -OK
1080 -)))
1081 1081  
1082 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
878 +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.
1083 1083  
1084 -The sensor will clear the open door times and the duration of the last open door.
1085 -
1086 -
1087 -=== 3.3.10  Set the count value of the number of open door ===
1088 -
1089 -
1090 1090  (% style="color:blue" %)**AT Command:**
1091 1091  
1092 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1093 -|=(% 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**
882 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
883 +|=(% 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**
1094 1094  |(% style="width:155px" %)(((
1095 -AT+SETCNT=1,100
1096 -)))|(% style="width:259px" %)(((
1097 -Set the open door times of PA8 pin to 100 times.
1098 -)))|(% style="width:44px" %)(((
885 +AT+TTRALARM=0
886 +)))|(% style="width:279px" %)(((
887 +disable continuous alarm
888 +)))|(% style="width:84px" %)(((
1099 1099  OK
1100 1100  )))
1101 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1102 1102  |(% style="width:155px" %)(((
1103 -AT+SETCNT=2,50
1104 -)))|(% style="width:259px" %)(((
1105 -Set the open door times of PA4 pin to 100 times.
1106 -)))|(% style="width:44px" %)(((
892 +AT+TTRALARM=60
893 +)))|(% style="width:279px" %)(((
894 +The alarm interval is 60 minutes (unit: minutes)
895 +)))|(% style="width:84px" %)(((
1107 1107  OK
1108 1108  )))
1109 1109  
1110 1110  (% style="color:blue" %)**Downlink Command:**
1111 1111  
1112 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
901 +Example:  0C aa  => AT+TTRALARM= aa
1113 1113  
1114 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1115 1115  
1116 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1117 -
1118 -
1119 1119  = 4. Battery & Power Consumption =
1120 1120  
1121 1121  
1122 -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.
907 +DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1123 1123  
1124 1124  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1125 1125  
... ... @@ -1127,7 +1127,7 @@
1127 1127  = 5. OTA firmware update =
1128 1128  
1129 1129  
1130 -User can change firmware DS03A-LB/LS to:
915 +User can change firmware DS03A-LB to:
1131 1131  
1132 1132  * Change Frequency band/ region.
1133 1133  * Update with new features.
... ... @@ -1135,8 +1135,9 @@
1135 1135  
1136 1136  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1137 1137  
1138 -Methods to Update Firmware:
1139 1139  
924 +**Methods to Update Firmware:**
925 +
1140 1140  * (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/]]**
1141 1141  * 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]]**.
1142 1142  
... ... @@ -1147,7 +1147,7 @@
1147 1147  = 7. Order Info =
1148 1148  
1149 1149  
1150 -**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
936 +Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1151 1151  
1152 1152  (% style="color:red" %)**XX**(%%): The default frequency band
1153 1153  
... ... @@ -1172,7 +1172,7 @@
1172 1172  
1173 1173  (% style="color:#037691" %)**Package Includes**:
1174 1174  
1175 -* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
961 +* DS03A-LB LoRaWAN Temperature Sensor
1176 1176  
1177 1177  (% style="color:#037691" %)**Dimension and weight**:
1178 1178  
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
image-20240115094003-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -12.7 KB
Content