Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 3.1
edited by Xiaoling
on 2023/04/26 08:52
Change comment: Uploaded new attachment "image-20230426085205-1.png", version {1}
To version 32.1
edited by Saxer Lin
on 2023/07/01 09:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Saxer
Content
... ... @@ -1,4 +1,5 @@
1 -
1 +(% style="text-align:center" %)
2 +[[image:image-20230516085523-1.jpeg||height="491" width="491"]]
2 2  
3 3  
4 4  **Table of Contents：**
... ... @@ -50,8 +50,12 @@
50 50  )))
51 51  
52 52  
54 +[[image:image-20230522092934-2.png||height="346" width="774"]]
55 +
56 +
53 53  == 1.2 ​Features ==
54 54  
59 +
55 55  * LoRaWAN 1.0.3 Class A
56 56  * Ultra-low power consumption
57 57  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
... ... @@ -66,9 +66,9 @@
66 66  * Wall Mountable
67 67  * Outdoor Use
68 68  
69 -
70 70  == 1.3 Specification ==
71 71  
76 +
72 72  (% style="color:#037691" %)**Common DC Characteristics:**
73 73  
74 74  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
... ... @@ -99,9 +99,9 @@
99 99  * Sleep Mode: 5uA @ 3.3v
100 100  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
101 101  
102 -
103 103  == 1.4 Applications ==
104 104  
109 +
105 105  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
106 106  
107 107  
... ... @@ -135,7 +135,7 @@
135 135  == 1.7 BLE connection ==
136 136  
137 137  
138 -D2x-LB support BLE remote configure.
143 +DS03A-LB support BLE remote configure.
139 139  
140 140  
141 141  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:
... ... @@ -147,9 +147,13 @@
147 147  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
148 148  
149 149  
150 -== 1.8 Mechanical ==
155 +== 1.8 Pin Definitions ==
151 151  
157 +[[image:image-20230630160843-7.png]]
152 152  
159 +== 1.9 Mechanical ==
160 +
161 +
153 153  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
154 154  
155 155  
... ... @@ -167,49 +167,51 @@
167 167  == 2.1 How it works ==
168 168  
169 169  
170 -The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
179 +The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.
171 171  
172 172  
173 173  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
174 174  
175 175  
176 -Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
185 +Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example. (% style="display:none" %)
177 177  
187 +The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
178 178  
179 -The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
189 +[[image:image-20230522092858-1.png||height="391" width="874"]]
180 180  
181 181  
182 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB.
192 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
183 183  
184 184  Each DS03A-LB is shipped with a sticker with the default device EUI as below:
185 185  
186 -[[image:image-20230131134744-2.jpeg]]
196 +[[image:image-20230426085205-1.png||height="238" width="512"]]
187 187  
188 188  
189 -
190 190  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
191 191  
201 +(% style="display:none" %) (%%)
192 192  
193 193  (% style="color:blue" %)**Register the device**
194 194  
195 -[[image:1675144099263-405.png]]
196 196  
206 +[[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/1675144099263-405.png?rev=1.1||alt="1675144099263-405.png"]](% style="display:none" %)
197 197  
208 +
198 198  (% style="color:blue" %)**Add APP EUI and DEV EUI**
199 199  
200 -[[image:1675144117571-832.png]]
211 +[[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/1675144117571-832.png?rev=1.1||alt="1675144117571-832.png"]]
201 201  
202 202  
203 203  (% style="color:blue" %)**Add APP EUI in the application**
204 204  
216 +[[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/1675144143021-195.png?rev=1.1||alt="1675144143021-195.png"]]
205 205  
206 -[[image:1675144143021-195.png]]
207 207  
208 -
209 209  (% style="color:blue" %)**Add APP KEY**
210 210  
211 -[[image:1675144157838-392.png]]
221 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144157838-392.png?rev=1.1||alt="1675144157838-392.png"]]
212 212  
223 +
213 213  (% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
214 214  
215 215  
... ... @@ -224,6 +224,7 @@
224 224  
225 225  === 2.3.1 Device Status, FPORT~=5 ===
226 226  
238 +
227 227  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.
228 228  
229 229  The Payload format is as below.
... ... @@ -236,42 +236,42 @@
236 236  
237 237  Example parse in TTNv3
238 238  
239 -[[image:image-20230415153147-2.png||height="220" width="1120"]]
251 +[[image:image-20230630155406-1.png||height="190" width="873"]]
240 240  
241 241  
242 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x0B
254 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
243 243  
244 244  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
245 245  
246 246  (% style="color:#037691" %)**Frequency Band**:
247 247  
248 -*0x01: EU868
260 +0x01: EU868
249 249  
250 -*0x02: US915
262 +0x02: US915
251 251  
252 -*0x03: IN865
264 +0x03: IN865
253 253  
254 -*0x04: AU915
266 +0x04: AU915
255 255  
256 -*0x05: KZ865
268 +0x05: KZ865
257 257  
258 -*0x06: RU864
270 +0x06: RU864
259 259  
260 -*0x07: AS923
272 +0x07: AS923
261 261  
262 -*0x08: AS923-1
274 +0x08: AS923-1
263 263  
264 -*0x09: AS923-2
276 +0x09: AS923-2
265 265  
266 -*0x0a: AS923-3
278 +0x0a: AS923-3
267 267  
268 -*0x0b: CN470
280 +0x0b: CN470
269 269  
270 -*0x0c: EU433
282 +0x0c: EU433
271 271  
272 -*0x0d: KR920
284 +0x0d: KR920
273 273  
274 -*0x0e: MA869
286 +0x0e: MA869
275 275  
276 276  
277 277  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -292,132 +292,355 @@
292 292  Ex2: 0x0B49 = 2889mV
293 293  
294 294  
295 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
307 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2  Sensor Configuration, FPORT~=4(%%) ===
296 296  
309 +
310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
311 +
312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:723px" %)
313 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:721px" %)**Sensor Configuration FPORT=4**
314 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:99px" %)**2**|(% style="width:87px" %)**1**|(% style="width:97px" %)**2**|(% style="width:98px" %)**1**
315 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
316 +Keep status1
317 +
318 +
319 +)))|(% style="width:99px" %)(((
320 +Keep time1
321 +
322 +(unit: sec)
323 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
324 +Keep time2
325 +
326 +(unit: sec)
327 +)))|(% style="width:98px" %)(((
328 +Alarm interval
329 +
330 +(unit: min)
331 +)))
332 +
333 +* (((
334 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
335 +)))
336 +
337 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
338 +
339 +
340 +* (((
341 +(% style="color:blue" %)**Disalarm: (default: 0)**
342 +)))
343 +
344 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
345 +
346 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
347 +
348 +
349 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
350 +
351 +
352 +* (((
353 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
354 +)))
355 +
356 +Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
357 +
358 +[[image:image-20230630155527-3.png||height="146" width="902"]]
359 +
360 +
361 +* (((
362 +(% style="color:blue" %)**Alarm interval(default: 0)**
363 +)))
364 +
365 +When the state of the door sensor has not been changed after the timeout alarm, the device will send a uplink every alarm interval. It will stop the alarm until the state of the door sensor is changed after the timeout alarm.
366 +
367 +
368 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
369 +
370 +
297 297  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
298 298  
299 -* Every 2 hours, this interval [[can be changed>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.1A0SetTransmitIntervalTime]].
373 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
300 300  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
301 301  
302 -Uplink Payload totals 11 bytes.
376 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals 11 bytes. (**Default mode**)
303 303  
304 -|=(% colspan="5" %)**Real-Time Open/Close Status, FPORT=2**
305 -|**Size(bytes)**|**1**|**3**|**3**|**4**
306 -|**Value**|Status & [[Alarm>>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]]|Total open door events|(((
307 -The last door open
308 -duration (unit: min)
309 -)))|[[Unix TimeStamp>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.4.1A0UnixTimeStamp]]
378 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
379 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
380 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
381 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
382 +Status
310 310  
311 -|=(% colspan="4" %)**Status & Alarm field**
312 -|**Size(bit)**|**6**|**1**|**1**
313 -|**Value**|Reserve|[[Enable/disable Timeout Alarm>>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]]
314 -0: No Alarm; 1: Alarm|Status
315 -0: Close, 1: Open
384 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
385 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
386 +The last door open duration (unit: sec)
387 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
316 316  
317 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110547-6.png?width=1191&height=337&rev=1.1||alt="image-20220609110547-6.png" height="337" width="1191"]]
389 +**Status & Alarm:**
318 318  
391 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:668px" %)
392 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:148px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:131px" %)**bit0**
393 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
394 +Count mod
395 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
396 +Alarm 0: No Alarm;
319 319  
320 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
398 +1: Alarm
399 +)))|(% style="width:131px" %)(((
400 +Status 0: Close;
321 321  
322 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.4A0DatalogFeature]].
402 +1: Open
403 +)))
323 323  
324 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
405 +[[image:image-20230630155451-2.png||height="246" width="928"]]
325 325  
407 +
326 326  * (((
327 -Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands.
409 +(% style="color:blue" %)**Count mod:Default=0**
328 328  )))
329 329  
330 -For example, in the US915 band, the max payload for different DR is:
412 +MOD=0 ~-~-> Uplink total door open times since factory
331 331  
332 -1. (((
333 -**DR0**: max is 11 bytes so one entry of data
414 +MOD=1 ~-~-> Uplink total door open times since last FPORT=2 uplink.
415 +
416 +
417 +* (% style="color:blue" %)**TDC flag**
418 +
419 +When the flag is 1, it means sending packets at normal time intervals.
420 +
421 +Otherwise, it is a packet sent at non-TDC time.
422 +
423 +
424 +* (((
425 +(% style="color:#0000ff" %)**Alarm**
334 334  )))
335 -1. (((
336 -**DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
427 +
428 +See [[Alarm Base on Timeout>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]
429 +
430 +
431 +* (((
432 +(% style="color:blue" %)**Status**
337 337  )))
338 -1. (((
339 -**DR2**: total payload includes 11 entries of data
434 +
435 +This bit is 1 when the door sensor is open and 0 when it is close.
436 +
437 +
438 +* (((
439 +(% style="color:blue" %)**Total open door events**
340 340  )))
341 -1. (((
342 -**DR3**: total payload includes 22 entries of data.
441 +
442 +Total pulse/counting base on open door.
443 +
444 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
445 +
446 +
447 +* (((
448 +(% style="color:blue" %)**The last door open duration**
343 343  )))
344 344  
451 +Door sensor last open duration.
345 345  
346 -If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
453 +Unit: sec.
347 347  
348 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609112215-7.png?width=1250&height=277&rev=1.1||alt="image-20220609112215-7.png" height="277" width="1250"]]
455 +[[image:image-20230701094042-1.png||height="154" width="763"]]
349 349  
350 -**Downlink:**
351 351  
352 -0x31 61 8E 57 40 61 8E 81 70 05
458 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals 18 bytes.
353 353  
460 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %)
461 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2**
462 +|(% 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**
463 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
464 +Status1
354 354  
355 -**Uplink:**
466 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
467 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
468 +The last door open duration1 (unit: sec)
469 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
470 +Status2
356 356  
357 -00 00 00 00 00 00 00 61 8E 5F 8F 01 00 00 01 00 00 00 61 8E 5F D2 00 00 00 01 00 00 02 61 8E 60 64 01 00 00 02 00 00 02 61 8E 60 75 00 00 00 02 00 00 01 61 8E 60 C6 00 00 00 02 00 00 01 61 8E 7B A7 01 00 00 03 00 00 01 61 8E 7F 38 00 00 00 03 00 00 02 61 8E 7F CE 01 00 00 04 00 00 02 61 8E 81 1B 00 00 00 04 00 00 00 61 8E 81 50
472 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
473 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
358 358  
475 +**Status1 & Alarm1:**
359 359  
360 -**Parsed Value:**
477 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:775px" %)
478 +|(% 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:99px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:103px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:216px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:181px" %)**bit0**
479 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
480 +Count mod
481 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
482 +Alarm1 0: No Alarm; 1: Alarm
361 361  
362 -[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
484 +(PA8 of pin)
485 +)))|(% style="width:181px" %)(((
486 +Status1 0: Close; 1:Open
363 363  
488 +(PA8 of pin)
489 +)))
364 364  
365 -[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
491 +**Status2 & Alarm2:**
366 366  
367 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
493 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:591px" %)
494 +|(% 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:219px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:181px" %)**bit0**
495 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
496 +Alarm2 0: No Alarm; 1: Alarm
368 368  
369 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
498 +(PA4 of pin)
499 +)))|(% style="width:181px" %)(((
500 +Status2 0: Close,;1:Open
370 370  
371 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
502 +(PA4 of pin)
503 +)))
372 372  
373 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
505 +[[image:image-20230630155908-6.png||height="295" width="927"]]
374 374  
375 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
376 376  
377 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
508 +* (((
509 +(% id="cke_bm_695345S" style="color: blue; display: none" %)** **(% style="color:blue" %)**Count mod:Default=0**
510 +)))
378 378  
379 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
512 +MOD=0 ~-~-> Uplink total door open times since factory
380 380  
381 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
514 +MOD=1 ~-~-> Uplink total door open times since last FPORT=2 uplink.
382 382  
383 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
384 384  
517 +* (% style="color:blue" %)**TDC flag**
385 385  
386 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
519 +When the flag is 1, it means sending packets at normal time intervals.
387 387  
388 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
521 +Otherwise, it is a packet sent at non-TDC time.
389 389  
390 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110123-5.png?rev=1.1||alt="image-20220609110123-5.png"]]
391 391  
524 +* (((
525 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
526 +)))
392 392  
528 +See [[Alarm Base on Timeout>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]
529 +
530 +
393 393  * (((
394 -**TDC: (default: 0x001C20)**
532 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
395 395  )))
396 396  
397 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
535 +This bit is 1 when the door sensor is open and 0 when it is close.
398 398  
399 399  
400 400  * (((
401 -**Disalarm: (default: 0)**
539 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
402 402  )))
403 403  
404 - **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.
542 +Total pulse/counting base on open door.
405 405  
406 - **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.
544 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
407 407  
408 408  
409 -**~ Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
547 +* (((
548 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
549 +)))
410 410  
551 +Door sensor last open duration.
411 411  
553 +Unit: sec.
554 +
555 +[[image:image-20230701094042-1.png||height="154" width="763"]]
556 +
557 +
558 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
559 +
560 +
561 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
562 +
563 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
564 +
565 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
566 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
567 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
568 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
569 +Status
570 +
571 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
572 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
573 +The last door open duration (unit: sec)
574 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
575 +
576 +**Status & Alarm:**
577 +
578 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %)
579 +|(% 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**
580 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
581 +Count mod
582 +)))|(% style="width:95px" %)(((
583 +TDC flag 0:No;
584 +
585 +1:Yes
586 +)))|(% style="width:116px" %)(((
587 +Alarm
588 +
589 +0: No Alarm;
590 +
591 +1: Alarm
592 +)))|(% style="width:112px" %)(((
593 +Status 0:Close;
594 +
595 +1: Open
596 +)))
597 +
412 412  * (((
413 -**Keep Status & Keep Time**
599 +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.
414 414  )))
415 415  
416 -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]]
602 +For example, in the US915 band, the max payload for different DR is:
417 417  
418 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110018-4.png?width=1159&height=291&rev=1.1||alt="image-20220609110018-4.png" height="291" width="1159"]]
604 +(((
605 +**~1. DR0**: max is 11 bytes so one entry of data
606 +)))
419 419  
608 +(((
609 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
610 +)))
420 420  
612 +(((
613 +**3. DR2**: total payload includes 11 entries of data
614 +)))
615 +
616 +(((
617 +**4. DR3**: total payload includes 22 entries of data.
618 +)))
619 +
620 +If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
621 +
622 +[[image:image-20230630155556-4.png||height="146" width="938"]]
623 +
624 +**Downlink:**
625 +
626 +0x31 64 9E 7D 34 64 9E 7E 9C 05
627 +
628 +
629 +**Uplink:**
630 +
631 +45 00 00 00 00 00 00 64 9E 7D 48 40 00 00 00 00 00 63 64 9E 7D 9C 41 00 00 01 00 00 63 64 9E 7D A4 40 00 00 01 00 00 8D 64 9E 7E 31 43 00 00 02 00 00 8D 64 9E 7E 44 48 00 00 02 00 00 1F 64 9E 7E 59 4B 00 00 03 00 00 1F 64 9E 7E 6B
632 +
633 +
634 +**Parsed Value:**
635 +
636 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
637 +
638 +
639 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
640 +
641 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
642 +
643 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
644 +
645 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
646 +
647 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
648 +
649 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
650 +
651 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
652 +
653 +[[image:image-20230630172740-1.png||height="199" width="868"]]
654 +
655 +
421 421  == 2.4 Payload Decoder file ==
422 422  
423 423  
... ... @@ -433,13 +433,15 @@
433 433  == 2.5 Datalog Feature ==
434 434  
435 435  
436 -**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.
671 +(% 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.
437 437  
673 +(% 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.**
438 438  
675 +
439 439  === 2.5.1 Ways to get datalog via LoRaWAN ===
440 440  
441 441  
442 -Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], 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.
679 +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.
443 443  
444 444  * a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
445 445  * 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.
... ... @@ -448,6 +448,7 @@
448 448  
449 449  [[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"]]
450 450  
688 +
451 451  === 2.5.2 Unix TimeStamp ===
452 452  
453 453  
... ... @@ -476,31 +476,41 @@
476 476  
477 477  == 2.6 ​Show Data in DataCake IoT Server ==
478 478  
717 +
479 479  Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
480 480  
481 481  
482 -**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]]
721 +(% 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]]
483 483  
484 -**Step 2: Configure DS03A-LB in Datacake.**
723 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
485 485  
486 486  [[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"]]
487 487  
727 +
488 488  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654747162439-840.png?rev=1.1||alt="1654747162439-840.png"]]
489 489  
730 +
490 490  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746405400-203.png?rev=1.1||alt="1654746405400-203.png"]]
491 491  
733 +
492 492  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746763908-732.png?rev=1.1||alt="1654746763908-732.png"]]
493 493  
736 +
494 494  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746716087-684.png?rev=1.1||alt="1654746716087-684.png"]]
495 495  
739 +
496 496  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746693868-718.png?rev=1.1||alt="1654746693868-718.png"]]
497 497  
742 +
498 498  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746674738-826.png?rev=1.1||alt="1654746674738-826.png"]]
499 499  
745 +
500 500  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746646379-591.png?rev=1.1||alt="1654746646379-591.png"]]
501 501  
748 +
502 502  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746549277-209.png?rev=1.1||alt="1654746549277-209.png"]]
503 503  
751 +
504 504  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746593411-887.png?rev=1.1||alt="1654746593411-887.png"]]
505 505  
506 506  
... ... @@ -515,11 +515,9 @@
515 515  == 2.8 ​Firmware Change Log ==
516 516  
517 517  
518 -**Firmware download link:**
766 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
519 519  
520 -[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
521 521  
522 -
523 523  = 3. Configure DS03A-LB =
524 524  
525 525  == 3.1 Configure Methods: ==
... ... @@ -531,9 +531,9 @@
531 531  * 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]].
532 532  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
533 533  
534 -
535 535  == 3.2 General Commands ==
536 536  
782 +
537 537  These commands are to configure:
538 538  
539 539  * General system settings like: uplink interval.
... ... @@ -550,7 +550,7 @@
550 550  These commands only valid for DS03A-LB, as below:
551 551  
552 552  
553 -=== 3.3.1 Set Transmit Interval Time ===
799 +=== 3.3.1  Set Transmit Interval Time ===
554 554  
555 555  
556 556  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -558,7 +558,7 @@
558 558  (% style="color:blue" %)**AT Command: AT+TDC**
559 559  
560 560  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
561 -|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
807 +|=(% 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**
562 562  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
563 563  30000
564 564  OK
... ... @@ -578,25 +578,19 @@
578 578  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
579 579  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
580 580  
581 -=== 3.3.2 Get Device Status ===
827 +=== 3.3.2  Enable / Disable Alarm ===
582 582  
583 583  
584 -Send a LoRaWAN downlink to ask device send Alarm settings.
585 -
586 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
587 -
588 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
589 -
590 -
591 -=== 3.3.3  Enable / Disable Alarm ===
592 -
593 593  Feature: Enable/Disable Alarm for open/close event. Default value 0.
594 594  
595 -**AT Command:**
832 +(% style="color:blue" %)**AT Command: **
596 596  
597 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609140712-1.png?rev=1.1||alt="image-20220609140712-1.png"]]
834 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
835 +|(% 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**
836 +|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
837 +|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
598 598  
599 -**Downlink Command:**
839 +(% style="color:blue" %)**Downlink Command: **
600 600  
601 601  0xA7 01  ~/~/ Same As AT+DISALARM=1
602 602  
... ... @@ -603,184 +603,268 @@
603 603  0xA7 00  ~/~/ Same As AT+DISALARM=0
604 604  
605 605  
606 -=== 3.3.4  Alarm Base on Timeout ===
846 +=== 3.3.3  Alarm Base on Timeout ===
607 607  
848 +
608 608  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:
609 609  
610 610  
611 611  * (((
612 -**Keep Status: Status to be monitor**
853 +(% style="color:blue" %)**Keep Status: Status to be monitor**
613 613  )))
614 614  
615 -Keep Status = 1: Monitor Close to Open event
856 +(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
616 616  
617 -Keep Status = 0: Monitor Open to Close event
858 +(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
618 618  
619 619  
620 620  * (((
621 -**Keep Time: Timeout to send an Alarm**
862 +(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
622 622  )))
623 623  
624 624  Range 0 ~~ 65535(0xFFFF) seconds.
625 625  
626 -If keep time = 0, Disable Alarm Base on Timeout feature.
867 +If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
627 627  
628 -If keep time > 0, device will monitor the keep status event and send an alarm when status doesn't change after timeout.
869 +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.
629 629  
630 630  
631 -**AT Command to configure:**
872 +* (((
873 +(% style="color:blue" %)**Downlink Command**
874 +)))
632 632  
876 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
877 +
878 +**A9:** Command Type Code
879 +
880 +**aa: **01:TTRIG1; 02:TTRIG2
881 +
882 +**bb:** status to be monitored
883 +
884 +**cc dd:** timeout.
885 +
886 +
887 +1)**AT+TTRIG1**:(PA8 of pin)
888 +
889 +(% style="color:blue" %)**AT Command to configure:**
890 +
633 633  * (((
634 -**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>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
892 +(% style="color:#037691" %)**AT+TTRIG1=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB will send an uplink packet, the Alarm1 bit(the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
893 +
894 +(% style="color:#037691" %)**AT+TTRIG1=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB will send an uplink packet, the Alarm1 bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
635 635  )))
636 636  
637 637  * (((
638 -**AT+TTRIG=0,0**   **~-~-> ** Default Value, disable timeout Alarm.
898 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
899 +
900 +
901 +
639 639  )))
640 640  
904 +(% style="color:blue" %)**Downlink Command to configure:**
641 641  
642 -**Downlink Command to configure:**
906 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
643 643  
644 -**Command: 0xA9 aa bb cc**
908 + 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
645 645  
646 -**A9:** Command Type Code
647 647  
648 -**aa:** status to be monitored
911 +2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
649 649  
650 -**bb cc:** timeout.
913 +(% style="color:blue" %)**AT Command to configure:**
651 651  
915 +* (((
916 +(% style="color:#037691" %)**AT+TTRIG2=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
652 652  
653 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
918 +(% style="color:#037691" %)**AT+TTRIG2=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
919 +)))
654 654  
655 -Or
921 +* (((
922 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
656 656  
657 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
658 658  
925 +
926 +)))
659 659  
928 +(% style="color:blue" %)**Downlink Command to configure:**
929 +
930 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
931 +
932 + 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
933 +
934 +
935 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
936 +
937 +
938 +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.
939 +
940 +(% style="color:blue" %)**AT Command:**
941 +
942 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
943 +|=(% 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**
944 +|(% style="width:155px" %)(((
945 +AT+TTRALARM=0
946 +)))|(% style="width:279px" %)(((
947 +disable continuous alarm
948 +)))|(% style="width:84px" %)(((
949 +OK
950 +)))
951 +|(% style="width:155px" %)(((
952 +AT+TTRALARM=60
953 +)))|(% style="width:279px" %)(((
954 +The alarm interval is 60 minutes (unit: minutes)
955 +)))|(% style="width:84px" %)(((
956 +OK
957 +)))
958 +
959 +(% style="color:blue" %)**Downlink Command:**
960 +
961 +Example:  0C aa  => AT+TTRALARM= aa
962 +
963 +
660 660  === 3.3.5  Count Mod ===
661 661  
662 -**AT Command:**
663 663  
664 -|=**Command Example**|=**Function**|=**Response**
665 -|(((
967 +Feature: Manually set the count mode.
968 +
969 +(% style="color:blue" %)**AT Command:**
970 +
971 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
972 +|=(% 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**
973 +|(% style="width:155px" %)(((
666 666  AT+COUNTMOD=0
667 -)))|(((
975 +)))|(% style="width:277px" %)(((
668 668  the count value keeps accumulating mode
669 -)))|(((
670 -
671 -
977 +)))|(% style="width:86px" %)(((
672 672  OK
673 673  )))
674 -|(((
980 +|(% style="width:155px" %)(((
675 675  AT+COUNTMOD=1
676 -)))|(((
982 +)))|(% style="width:277px" %)(((
677 677  the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
678 -)))|(((
984 +)))|(% style="width:86px" %)(((
679 679  OK
680 680  )))
681 681  
682 -**Downlink Command:**
988 +(% style="color:blue" %)**Downlink Command:**
683 683  
684 684  Example:  0B aa  => AT+COUNTMOD = second byte
685 685  
686 686  
687 -=== 3.3.6  Interrupt Pin Channel Mod ===
993 +=== 3.3.6  Number of channel of door sensors ===
688 688  
689 -**AT Command:**
690 690  
691 -|=**Command Example**|=**Function**|=**Response**
692 -|(((
693 -AT+TTRCHANNEL=1
694 -)))|(((
695 -set as single channel, only use PB14 pin as interrupt pin.
696 -)))|(((
697 -
996 +Feature: Set the number of door sensor channels.
698 698  
998 +(% style="color:blue" %)**AT Command:**
999 +
1000 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1001 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1002 +|(% style="width:155px" %)(((
1003 +AT+TTRCHANNEL=1
1004 +)))|(% style="width:259px" %)(((
1005 +Set as single channel, only use PA8 pin as interrupt pin.
1006 +)))|(% style="width:44px" %)(((
699 699  OK
700 700  )))
701 -|(((
1009 +|(% style="width:155px" %)(((
702 702  AT+TTRCHANNEL=2
703 -)))|(((
704 -is set as dual channel, use PB14 pin and PB15 pin as interrupt pin.
705 -)))|(((
1011 +)))|(% style="width:259px" %)(((
1012 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1013 +)))|(% style="width:44px" %)(((
706 706  OK
707 707  )))
708 708  
709 -**Downlink Command:**
1017 +(% style="color:blue" %)**Downlink Command:**
710 710  
711 711  Example:  0D aa => AT+TTRCHANNEL = second byte
712 712  
713 713  
714 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1022 +=== 3.3.7  Set Time Sync Mode ===
715 715  
716 -**Downlink Command:**
717 717  
718 -Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1025 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
719 719  
1027 +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.
720 720  
721 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1029 +(% style="color:blue" %)**AT Command:**
722 722  
723 -**Downlink Command:**
1031 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1032 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1033 +|(% style="width:155px" %)(((
1034 +AT+SYNCMOD=1
1035 +)))|(% style="width:259px" %)(((
1036 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1037 +)))|(% style="width:44px" %)(((
1038 +OK
1039 +)))
1040 +|(% style="width:155px" %)(((
1041 +AT+SYNCMOD=1,8
1042 +)))|(% style="width:259px" %)(((
1043 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1044 +)))|(% style="width:44px" %)(((
1045 +OK
1046 +)))
1047 +|(% 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
724 724  
725 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1049 +(% style="color:blue" %)**Downlink Command:**
726 726  
1051 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
727 727  
728 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1053 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
729 729  
730 -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.
1055 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
731 731  
732 -**AT Command:**
1057 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
733 733  
734 -|=**Command Example**|=**Function**|=**Response**
735 -|(((
736 -AT+TTRALARM=0
737 -)))|(((
738 -disable continuous alarm
739 -)))|(((
740 -
741 741  
742 -OK
743 -)))
744 -|(((
745 -AT+TTRALARM=60
746 -)))|(((
747 - The alarm interval is 60 minutes (unit: minutes)
748 -)))|(((
749 -OK
750 -)))
1060 +=== 3.3.8  Clear the open door times and the duration of the last open door ===
751 751  
752 -**Downlink Command:**
753 753  
754 -Example:  0C aa  => AT+TTRALARM= aa
1063 +(% style="color:blue" %)**AT Command:**
755 755  
1065 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1066 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1067 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1068 +OK
1069 +)))
756 756  
757 -=== 3.3.9  Select counting mode ===
1071 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
758 758  
759 -**AT+TTRMODx=a,b**
1073 +The sensor will clear the open door times and the duration of the last open door.
760 760  
761 -When **a=0**, the door is opened to count, and when **a=1**,the closed door is counted.
762 762  
763 -When **b=0**, it is the last door open duration, and when **b=1**,the last door close duration.
1076 +=== 3.3.9  Set the count value of the number of open door ===
764 764  
765 -**AT Command:**
766 766  
767 -|=**Command Example**|=**Function**|=**Response**
768 -|(((
769 -AT+TTRMODx=1,0
770 -)))|Door closed count and record the last door opened duration|(((
771 -
1079 +(% style="color:blue" %)**AT Command:**
772 772  
1081 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1082 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 259px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1083 +|(% style="width:155px" %)(((
1084 +AT+SETCNT=1,100
1085 +)))|(% style="width:259px" %)(((
1086 +Set the open door times of PA8 pin to 100 times.
1087 +)))|(% style="width:44px" %)(((
773 773  OK
774 774  )))
775 -|(((
776 -AT+TTRMODx=0,1
777 -)))|(((
778 -Door opened count and record the last door Door Door open closed duration
779 -)))|(((
1090 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1091 +|(% style="width:155px" %)(((
1092 +AT+SETCNT=2,50
1093 +)))|(% style="width:259px" %)(((
1094 +Set the open door times of PA4 pin to 100 times.
1095 +)))|(% style="width:44px" %)(((
780 780  OK
781 781  )))
782 782  
1099 +(% style="color:blue" %)**Downlink Command:**
783 783  
1101 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1102 +
1103 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1104 +
1105 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1106 +
1107 +
784 784  = 4. Battery & Power Consumption =
785 785  
786 786  
... ... @@ -801,12 +801,11 @@
801 801  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
802 802  
803 803  
804 -Methods to Update Firmware:
1128 +**Methods to Update Firmware:**
805 805  
806 -* (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/]]
807 -* 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]]**.
1130 +* (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/]]**
1131 +* 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]]**.
808 808  
809 -
810 810  = 6. FAQ =
811 811  
812 812  
... ... @@ -856,4 +856,4 @@
856 856  
857 857  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
858 858  
859 -* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
1182 +* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
image-20230516085523-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +1.3 MB
Content
image-20230522092858-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +156.5 KB
Content
image-20230522092934-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +156.5 KB
Content
image-20230522093256-3.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content
image-20230630155406-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +41.8 KB
Content
image-20230630155451-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +77.2 KB
Content
image-20230630155527-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +39.2 KB
Content
image-20230630155556-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +38.4 KB
Content
image-20230630155751-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230630155908-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +90.8 KB
Content
image-20230630160843-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +511.7 KB
Content
image-20230630172740-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content