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

From version 4.1
edited by Xiaoling
on 2023/05/16 08:55
Change comment: Uploaded new attachment "image-20230516085523-1.jpeg", version {1}
To version 33.1
edited by Saxer Lin
on 2023/07/01 10:43
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
... ... @@ -68,6 +68,7 @@
68 68  
69 69  == 1.3 Specification ==
70 70  
76 +
71 71  (% style="color:#037691" %)**Common DC Characteristics:**
72 72  
73 73  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
... ... @@ -100,6 +100,7 @@
100 100  
101 101  == 1.4 Applications ==
102 102  
109 +
103 103  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
104 104  
105 105  
... ... @@ -133,7 +133,7 @@
133 133  == 1.7 BLE connection ==
134 134  
135 135  
136 -D2x-LB support BLE remote configure.
143 +DS03A-LB support BLE remote configure.
137 137  
138 138  
139 139  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:
... ... @@ -145,9 +145,13 @@
145 145  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
146 146  
147 147  
148 -== 1.8 Mechanical ==
155 +== 1.8 Pin Definitions ==
149 149  
157 +[[image:image-20230630160843-7.png]]
150 150  
159 +== 1.9 Mechanical ==
160 +
161 +
151 151  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
152 152  
153 153  
... ... @@ -165,48 +165,51 @@
165 165  == 2.1 How it works ==
166 166  
167 167  
168 -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.
169 169  
170 170  
171 171  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
172 172  
173 173  
174 -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" %)
175 175  
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.
176 176  
177 -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"]]
178 178  
179 179  
180 -(% 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.
181 181  
182 182  Each DS03A-LB is shipped with a sticker with the default device EUI as below:
183 183  
184 -[[image:image-20230426085205-1.png]]
196 +[[image:image-20230426085205-1.png||height="238" width="512"]]
185 185  
186 186  
187 187  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
188 188  
201 +(% style="display:none" %) (%%)
189 189  
190 190  (% style="color:blue" %)**Register the device**
191 191  
192 -[[image:1675144099263-405.png]]
193 193  
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" %)
194 194  
208 +
195 195  (% style="color:blue" %)**Add APP EUI and DEV EUI**
196 196  
197 -[[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"]]
198 198  
199 199  
200 200  (% style="color:blue" %)**Add APP EUI in the application**
201 201  
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"]]
202 202  
203 -[[image:1675144143021-195.png]]
204 204  
205 -
206 206  (% style="color:blue" %)**Add APP KEY**
207 207  
208 -[[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"]]
209 209  
223 +
210 210  (% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
211 211  
212 212  
... ... @@ -221,6 +221,7 @@
221 221  
222 222  === 2.3.1 Device Status, FPORT~=5 ===
223 223  
238 +
224 224  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.
225 225  
226 226  The Payload format is as below.
... ... @@ -233,42 +233,42 @@
233 233  
234 234  Example parse in TTNv3
235 235  
236 -[[image:image-20230415153147-2.png||height="220" width="1120"]]
251 +[[image:image-20230630155406-1.png||height="190" width="873"]]
237 237  
238 238  
239 -(% 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
240 240  
241 241  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
242 242  
243 243  (% style="color:#037691" %)**Frequency Band**:
244 244  
245 -*0x01: EU868
260 +0x01: EU868
246 246  
247 -*0x02: US915
262 +0x02: US915
248 248  
249 -*0x03: IN865
264 +0x03: IN865
250 250  
251 -*0x04: AU915
266 +0x04: AU915
252 252  
253 -*0x05: KZ865
268 +0x05: KZ865
254 254  
255 -*0x06: RU864
270 +0x06: RU864
256 256  
257 -*0x07: AS923
272 +0x07: AS923
258 258  
259 -*0x08: AS923-1
274 +0x08: AS923-1
260 260  
261 -*0x09: AS923-2
276 +0x09: AS923-2
262 262  
263 -*0x0a: AS923-3
278 +0x0a: AS923-3
264 264  
265 -*0x0b: CN470
280 +0x0b: CN470
266 266  
267 -*0x0c: EU433
282 +0x0c: EU433
268 268  
269 -*0x0d: KR920
284 +0x0d: KR920
270 270  
271 -*0x0e: MA869
286 +0x0e: MA869
272 272  
273 273  
274 274  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -289,131 +289,360 @@
289 289  Ex2: 0x0B49 = 2889mV
290 290  
291 291  
292 -=== 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(%%) ===
293 293  
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 +
294 294  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
295 295  
296 -* 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"]].
297 297  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
298 298  
299 -Uplink Payload totals 11 bytes.
300 300  
301 -|=(% colspan="5" %)**Real-Time Open/Close Status, FPORT=2**
302 -|**Size(bytes)**|**1**|**3**|**3**|**4**
303 -|**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|(((
304 -The last door open
305 -duration (unit: min)
306 -)))|[[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]]
377 +1)When **AT+TTRCHANNEL=1**, Uplink Payload totals **11 bytes**. (**Default mode**)
307 307  
308 -|=(% colspan="4" %)**Status & Alarm field**
309 -|**Size(bit)**|**6**|**1**|**1**
310 -|**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]]
311 -0: No Alarm; 1: Alarm|Status
312 -0: Close, 1: Open
379 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
380 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
381 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
382 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
383 +Status
313 313  
314 -[[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"]]
385 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
386 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
387 +The last door open duration (unit: sec)
388 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
315 315  
390 +**Status & Alarm:**
316 316  
317 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
392 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:668px" %)
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:148px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:131px" %)**bit0**
394 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
395 +Count mod
396 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
397 +Alarm 0: No Alarm;
318 318  
319 -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]].
399 +1: Alarm
400 +)))|(% style="width:131px" %)(((
401 +Status 0: Close;
320 320  
321 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
403 +1: Open
404 +)))
322 322  
406 +[[image:image-20230630155451-2.png||height="246" width="928"]]
407 +
408 +
323 323  * (((
324 -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.
410 +(% style="color:blue" %)**Count mod:Default=0**
325 325  )))
326 326  
327 -For example, in the US915 band, the max payload for different DR is:
413 +MOD=0 ~-~-> Uplink total open door times since factory
328 328  
329 -1. (((
330 -**DR0**: max is 11 bytes so one entry of data
415 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
416 +
417 +
418 +* (% style="color:blue" %)**TDC flag**
419 +
420 +When the flag is 1, it means sending packets at normal time intervals.
421 +
422 +Otherwise, it is a packet sent at non-TDC time.
423 +
424 +
425 +* (((
426 +(% style="color:#0000ff" %)**Alarm**
331 331  )))
332 -1. (((
333 -**DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
428 +
429 +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]]
430 +
431 +
432 +* (((
433 +(% style="color:blue" %)**Status**
334 334  )))
335 -1. (((
336 -**DR2**: total payload includes 11 entries of data
435 +
436 +This bit is 1 when the door sensor is open and 0 when it is close.
437 +
438 +
439 +* (((
440 +(% style="color:blue" %)**Total open door events**
337 337  )))
338 -1. (((
339 -**DR3**: total payload includes 22 entries of data.
442 +
443 +Total pulse/counting base on open door.
444 +
445 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
446 +
447 +
448 +* (((
449 +(% style="color:blue" %)**The last door open duration**
340 340  )))
341 341  
342 -If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
452 +Door sensor last open duration.
343 343  
344 -[[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"]]
454 +Unit: sec.
345 345  
346 -**Downlink:**
456 +[[image:image-20230701094042-1.png||height="154" width="763"]]
347 347  
348 -0x31 61 8E 57 40 61 8E 81 70 05
349 349  
459 +2)When **AT+TTRCHANNEL=2**, Uplink Payload totals **18 bytes**.
350 350  
351 -**Uplink:**
461 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
352 352  
353 -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
463 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used due to the byte limit.**
354 354  
465 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:819px" %)
466 +|=(% colspan="8" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 817px;" %)**Real-Time Open/Close Status, FPORT=2**
467 +|(% 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**
468 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
469 +Status1
355 355  
356 -**Parsed Value:**
471 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
472 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
473 +The last door open duration1 (unit: sec)
474 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
475 +Status2
357 357  
358 -[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
477 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
478 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
359 359  
480 +**Status1 & Alarm1:**
360 360  
361 -[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
482 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:775px" %)
483 +|(% 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**
484 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
485 +Count mod
486 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
487 +Alarm1 0: No Alarm; 1: Alarm
362 362  
363 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
489 +(PA8 of pin)
490 +)))|(% style="width:181px" %)(((
491 +Status1 0: Close; 1:Open
364 364  
365 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
493 +(PA8 of pin)
494 +)))
366 366  
367 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
496 +**Status2 & Alarm2:**
368 368  
369 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
498 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:591px" %)
499 +|(% 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**
500 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
501 +Alarm2 0: No Alarm; 1: Alarm
370 370  
371 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
503 +(PA4 of pin)
504 +)))|(% style="width:181px" %)(((
505 +Status2 0: Close,;1:Open
372 372  
373 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
507 +(PA4 of pin)
508 +)))
374 374  
375 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
510 +[[image:image-20230630155908-6.png||height="295" width="927"]]
376 376  
377 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
378 378  
379 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
513 +* (((
514 +(% id="cke_bm_695345S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Count mod:Default=0**
515 +)))
380 380  
517 +MOD=0 ~-~-> Uplink total open door times since factory
381 381  
382 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
519 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
383 383  
384 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
385 385  
386 -[[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"]]
522 +* (% style="color:blue" %)**TDC flag**
387 387  
524 +When the flag is 1, it means sending packets at normal time intervals.
388 388  
526 +Otherwise, it is a packet sent at non-TDC time.
527 +
528 +
389 389  * (((
390 -**TDC: (default: 0x001C20)**
530 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
391 391  )))
392 392  
393 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
533 +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]]
394 394  
395 395  
396 396  * (((
397 -**Disalarm: (default: 0)**
537 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
398 398  )))
399 399  
400 - **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.
540 +This bit is 1 when the door sensor is open and 0 when it is close.
401 401  
402 - **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.
403 403  
543 +* (((
544 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
545 +)))
404 404  
405 -**~ Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
547 +Total pulse/counting base on open door.
406 406  
549 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
407 407  
551 +
408 408  * (((
409 -**Keep Status & Keep Time**
553 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
410 410  )))
411 411  
412 -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]]
556 +Door sensor last open duration.
413 413  
414 -[[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"]]
558 +Unit: sec.
415 415  
560 +[[image:image-20230701094042-1.png||height="154" width="763"]]
416 416  
562 +
563 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
564 +
565 +
566 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
567 +
568 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
569 +
570 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
571 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
572 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
573 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
574 +Status
575 +
576 +&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
577 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
578 +The last door open duration (unit: sec)
579 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
580 +
581 +**Status & Alarm:**
582 +
583 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:755px" %)
584 +|(% 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**
585 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
586 +Count mod
587 +)))|(% style="width:95px" %)(((
588 +TDC flag 0:No;
589 +
590 +1:Yes
591 +)))|(% style="width:116px" %)(((
592 +Alarm
593 +
594 +0: No Alarm;
595 +
596 +1: Alarm
597 +)))|(% style="width:112px" %)(((
598 +Status 0:Close;
599 +
600 +1: Open
601 +)))
602 +
603 +* (((
604 +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.
605 +)))
606 +
607 +For example, in the US915 band, the max payload for different DR is:
608 +
609 +(((
610 +**~1. DR0**: max is 11 bytes so one entry of data
611 +)))
612 +
613 +(((
614 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
615 +)))
616 +
617 +(((
618 +**3. DR2**: total payload includes 11 entries of data
619 +)))
620 +
621 +(((
622 +**4. DR3**: total payload includes 22 entries of data.
623 +)))
624 +
625 +If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
626 +
627 +[[image:image-20230630155556-4.png||height="146" width="938"]]
628 +
629 +**Downlink:**
630 +
631 +0x31 64 9E 7D 34 64 9E 7E 9C 05
632 +
633 +
634 +**Uplink:**
635 +
636 +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
637 +
638 +
639 +**Parsed Value:**
640 +
641 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
642 +
643 +
644 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
645 +
646 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
647 +
648 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
649 +
650 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
651 +
652 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
653 +
654 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
655 +
656 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
657 +
658 +[[image:image-20230630172740-1.png||height="199" width="868"]]
659 +
660 +
417 417  == 2.4 Payload Decoder file ==
418 418  
419 419  
... ... @@ -429,13 +429,15 @@
429 429  == 2.5 Datalog Feature ==
430 430  
431 431  
432 -**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.
676 +(% 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.
433 433  
678 +(% 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.**
434 434  
680 +
435 435  === 2.5.1 Ways to get datalog via LoRaWAN ===
436 436  
437 437  
438 -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.
684 +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.
439 439  
440 440  * a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
441 441  * 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.
... ... @@ -444,6 +444,7 @@
444 444  
445 445  [[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"]]
446 446  
693 +
447 447  === 2.5.2 Unix TimeStamp ===
448 448  
449 449  
... ... @@ -472,31 +472,41 @@
472 472  
473 473  == 2.6 ​Show Data in DataCake IoT Server ==
474 474  
722 +
475 475  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:
476 476  
477 477  
478 -**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]]
726 +(% 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]]
479 479  
480 -**Step 2: Configure DS03A-LB in Datacake.**
728 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
481 481  
482 482  [[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"]]
483 483  
732 +
484 484  [[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"]]
485 485  
735 +
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/1654746405400-203.png?rev=1.1||alt="1654746405400-203.png"]]
487 487  
738 +
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/1654746763908-732.png?rev=1.1||alt="1654746763908-732.png"]]
489 489  
741 +
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/1654746716087-684.png?rev=1.1||alt="1654746716087-684.png"]]
491 491  
744 +
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/1654746693868-718.png?rev=1.1||alt="1654746693868-718.png"]]
493 493  
747 +
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/1654746674738-826.png?rev=1.1||alt="1654746674738-826.png"]]
495 495  
750 +
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/1654746646379-591.png?rev=1.1||alt="1654746646379-591.png"]]
497 497  
753 +
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/1654746549277-209.png?rev=1.1||alt="1654746549277-209.png"]]
499 499  
756 +
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/1654746593411-887.png?rev=1.1||alt="1654746593411-887.png"]]
501 501  
502 502  
... ... @@ -511,11 +511,9 @@
511 511  == 2.8 ​Firmware Change Log ==
512 512  
513 513  
514 -**Firmware download link:**
771 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
515 515  
516 -[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
517 517  
518 -
519 519  = 3. Configure DS03A-LB =
520 520  
521 521  == 3.1 Configure Methods: ==
... ... @@ -529,6 +529,7 @@
529 529  
530 530  == 3.2 General Commands ==
531 531  
787 +
532 532  These commands are to configure:
533 533  
534 534  * General system settings like: uplink interval.
... ... @@ -545,7 +545,7 @@
545 545  These commands only valid for DS03A-LB, as below:
546 546  
547 547  
548 -=== 3.3.1 Set Transmit Interval Time ===
804 +=== 3.3.1  Set Transmit Interval Time ===
549 549  
550 550  
551 551  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -553,7 +553,7 @@
553 553  (% style="color:blue" %)**AT Command: AT+TDC**
554 554  
555 555  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
556 -|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
812 +|=(% 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**
557 557  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
558 558  30000
559 559  OK
... ... @@ -573,25 +573,19 @@
573 573  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
574 574  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
575 575  
576 -=== 3.3.2 Get Device Status ===
832 +=== 3.3.2  Enable / Disable Alarm ===
577 577  
578 578  
579 -Send a LoRaWAN downlink to ask device send Alarm settings.
580 -
581 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
582 -
583 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
584 -
585 -
586 -=== 3.3.3  Enable / Disable Alarm ===
587 -
588 588  Feature: Enable/Disable Alarm for open/close event. Default value 0.
589 589  
590 -**AT Command:**
837 +(% style="color:blue" %)**AT Command: **
591 591  
592 -[[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"]]
839 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
840 +|(% 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**
841 +|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
842 +|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
593 593  
594 -**Downlink Command:**
844 +(% style="color:blue" %)**Downlink Command: **
595 595  
596 596  0xA7 01  ~/~/ Same As AT+DISALARM=1
597 597  
... ... @@ -598,182 +598,268 @@
598 598  0xA7 00  ~/~/ Same As AT+DISALARM=0
599 599  
600 600  
601 -=== 3.3.4  Alarm Base on Timeout ===
851 +=== 3.3.3  Alarm Base on Timeout ===
602 602  
853 +
603 603  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:
604 604  
605 605  
606 606  * (((
607 -**Keep Status: Status to be monitor**
858 +(% style="color:blue" %)**Keep Status: Status to be monitor**
608 608  )))
609 609  
610 -Keep Status = 1: Monitor Close to Open event
861 +(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
611 611  
612 -Keep Status = 0: Monitor Open to Close event
863 +(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
613 613  
614 614  
615 615  * (((
616 -**Keep Time: Timeout to send an Alarm**
867 +(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
617 617  )))
618 618  
619 619  Range 0 ~~ 65535(0xFFFF) seconds.
620 620  
621 -If keep time = 0, Disable Alarm Base on Timeout feature.
872 +If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
622 622  
623 -If keep time > 0, device will monitor the keep status event and send an alarm when status doesn't change after timeout.
874 +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.
624 624  
625 625  
626 -**AT Command to configure:**
877 +* (((
878 +(% style="color:blue" %)**Downlink Command**
879 +)))
627 627  
881 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
882 +
883 +**A9:** Command Type Code
884 +
885 +**aa: **01:TTRIG1; 02:TTRIG2
886 +
887 +**bb:** status to be monitored
888 +
889 +**cc dd:** timeout.
890 +
891 +
892 +1)**AT+TTRIG1**:(PA8 of pin)
893 +
894 +(% style="color:blue" %)**AT Command to configure:**
895 +
628 628  * (((
629 -**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.
897 +(% 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.
898 +
899 +(% 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.
630 630  )))
631 631  
632 632  * (((
633 -**AT+TTRIG=0,0**   **~-~-> ** Default Value, disable timeout Alarm.
903 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
904 +
905 +
906 +
634 634  )))
635 635  
636 -**Downlink Command to configure:**
909 +(% style="color:blue" %)**Downlink Command to configure:**
637 637  
638 -**Command: 0xA9 aa bb cc**
911 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
639 639  
640 -**A9:** Command Type Code
913 + 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
641 641  
642 -**aa:** status to be monitored
643 643  
644 -**bb cc:** timeout.
916 +2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
645 645  
918 +(% style="color:blue" %)**AT Command to configure:**
646 646  
647 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
920 +* (((
921 +(% 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.
648 648  
649 -Or
923 +(% 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.
924 +)))
650 650  
651 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
926 +* (((
927 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
652 652  
653 653  
930 +
931 +)))
932 +
933 +(% style="color:blue" %)**Downlink Command to configure:**
934 +
935 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
936 +
937 + 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
938 +
939 +
940 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
941 +
942 +
943 +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.
944 +
945 +(% style="color:blue" %)**AT Command:**
946 +
947 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
948 +|=(% 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**
949 +|(% style="width:155px" %)(((
950 +AT+TTRALARM=0
951 +)))|(% style="width:279px" %)(((
952 +disable continuous alarm
953 +)))|(% style="width:84px" %)(((
954 +OK
955 +)))
956 +|(% style="width:155px" %)(((
957 +AT+TTRALARM=60
958 +)))|(% style="width:279px" %)(((
959 +The alarm interval is 60 minutes (unit: minutes)
960 +)))|(% style="width:84px" %)(((
961 +OK
962 +)))
963 +
964 +(% style="color:blue" %)**Downlink Command:**
965 +
966 +Example:  0C aa  => AT+TTRALARM= aa
967 +
968 +
654 654  === 3.3.5  Count Mod ===
655 655  
656 -**AT Command:**
657 657  
658 -|=**Command Example**|=**Function**|=**Response**
659 -|(((
972 +Feature: Manually set the count mode.
973 +
974 +(% style="color:blue" %)**AT Command:**
975 +
976 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
977 +|=(% 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**
978 +|(% style="width:155px" %)(((
660 660  AT+COUNTMOD=0
661 -)))|(((
980 +)))|(% style="width:277px" %)(((
662 662  the count value keeps accumulating mode
663 -)))|(((
664 -
665 -
982 +)))|(% style="width:86px" %)(((
666 666  OK
667 667  )))
668 -|(((
985 +|(% style="width:155px" %)(((
669 669  AT+COUNTMOD=1
670 -)))|(((
987 +)))|(% style="width:277px" %)(((
671 671  the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
672 -)))|(((
989 +)))|(% style="width:86px" %)(((
673 673  OK
674 674  )))
675 675  
676 -**Downlink Command:**
993 +(% style="color:blue" %)**Downlink Command:**
677 677  
678 678  Example:  0B aa  => AT+COUNTMOD = second byte
679 679  
680 680  
681 -=== 3.3.6  Interrupt Pin Channel Mod ===
998 +=== 3.3.6  Number of channel of door sensors ===
682 682  
683 -**AT Command:**
684 684  
685 -|=**Command Example**|=**Function**|=**Response**
686 -|(((
687 -AT+TTRCHANNEL=1
688 -)))|(((
689 -set as single channel, only use PB14 pin as interrupt pin.
690 -)))|(((
691 -
1001 +Feature: Set the number of door sensor channels.
692 692  
1003 +(% style="color:blue" %)**AT Command:**
1004 +
1005 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1006 +|=(% 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**
1007 +|(% style="width:155px" %)(((
1008 +AT+TTRCHANNEL=1
1009 +)))|(% style="width:259px" %)(((
1010 +Set as single channel, only use PA8 pin as interrupt pin.
1011 +)))|(% style="width:44px" %)(((
693 693  OK
694 694  )))
695 -|(((
1014 +|(% style="width:155px" %)(((
696 696  AT+TTRCHANNEL=2
697 -)))|(((
698 -is set as dual channel, use PB14 pin and PB15 pin as interrupt pin.
699 -)))|(((
1016 +)))|(% style="width:259px" %)(((
1017 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1018 +)))|(% style="width:44px" %)(((
700 700  OK
701 701  )))
702 702  
703 -**Downlink Command:**
1022 +(% style="color:blue" %)**Downlink Command:**
704 704  
705 705  Example:  0D aa => AT+TTRCHANNEL = second byte
706 706  
707 707  
708 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1027 +=== 3.3.7  Set Time Sync Mode ===
709 709  
710 -**Downlink Command:**
711 711  
712 -Example A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1030 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
713 713  
1032 +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.
714 714  
715 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1034 +(% style="color:blue" %)**AT Command:**
716 716  
717 -**Downlink Command:**
1036 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1037 +|=(% 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**
1038 +|(% style="width:155px" %)(((
1039 +AT+SYNCMOD=1
1040 +)))|(% style="width:259px" %)(((
1041 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1042 +)))|(% style="width:44px" %)(((
1043 +OK
1044 +)))
1045 +|(% style="width:155px" %)(((
1046 +AT+SYNCMOD=1,8
1047 +)))|(% style="width:259px" %)(((
1048 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1049 +)))|(% style="width:44px" %)(((
1050 +OK
1051 +)))
1052 +|(% 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
718 718  
719 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1054 +(% style="color:blue" %)**Downlink Command:**
720 720  
1056 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
721 721  
722 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1058 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
723 723  
724 -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.
1060 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
725 725  
726 -**AT Command:**
1062 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
727 727  
728 -|=**Command Example**|=**Function**|=**Response**
729 -|(((
730 -AT+TTRALARM=0
731 -)))|(((
732 -disable continuous alarm
733 -)))|(((
734 -
735 735  
736 -OK
737 -)))
738 -|(((
739 -AT+TTRALARM=60
740 -)))|(((
741 - The alarm interval is 60 minutes (unit: minutes)
742 -)))|(((
743 -OK
744 -)))
1065 +=== 3.3.8  Clear the open door times and the duration of the last open door ===
745 745  
746 -**Downlink Command:**
747 747  
748 -Example:  0C aa  => AT+TTRALARM= aa
1068 +(% style="color:blue" %)**AT Command:**
749 749  
1070 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1071 +|=(% 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**
1072 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1073 +OK
1074 +)))
750 750  
751 -=== 3.3.9  Select counting mode ===
1076 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
752 752  
753 -**AT+TTRMODx=a,b**
1078 +The sensor will clear the open door times and the duration of the last open door.
754 754  
755 -When **a=0**, the door is opened to count, and when **a=1**,the closed door is counted.
756 756  
757 -When **b=0**, it is the last door open duration, and when **b=1**,the last door close duration.
1081 +=== 3.3.9  Set the count value of the number of open door ===
758 758  
759 -**AT Command:**
760 760  
761 -|=**Command Example**|=**Function**|=**Response**
762 -|(((
763 -AT+TTRMODx=1,0
764 -)))|Door closed count and record the last door opened duration|(((
765 -
1084 +(% style="color:blue" %)**AT Command:**
766 766  
1086 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1087 +|=(% 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**
1088 +|(% style="width:155px" %)(((
1089 +AT+SETCNT=1,100
1090 +)))|(% style="width:259px" %)(((
1091 +Set the open door times of PA8 pin to 100 times.
1092 +)))|(% style="width:44px" %)(((
767 767  OK
768 768  )))
769 -|(((
770 -AT+TTRMODx=0,1
771 -)))|(((
772 -Door opened count and record the last door Door Door open closed duration
773 -)))|(((
1095 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1096 +|(% style="width:155px" %)(((
1097 +AT+SETCNT=2,50
1098 +)))|(% style="width:259px" %)(((
1099 +Set the open door times of PA4 pin to 100 times.
1100 +)))|(% style="width:44px" %)(((
774 774  OK
775 775  )))
776 776  
1104 +(% style="color:blue" %)**Downlink Command:**
1105 +
1106 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1107 +
1108 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1109 +
1110 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1111 +
1112 +
777 777  = 4. Battery & Power Consumption =
778 778  
779 779  
... ... @@ -794,10 +794,10 @@
794 794  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
795 795  
796 796  
797 -Methods to Update Firmware:
1133 +**Methods to Update Firmware:**
798 798  
799 -* (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/]]
800 -* 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]]**.
1135 +* (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/]]**
1136 +* 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]]**.
801 801  
802 802  = 6. FAQ =
803 803  
... ... @@ -848,4 +848,4 @@
848 848  
849 849  * 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.
850 850  
851 -* 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]]
1187 +* 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-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