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

From version 12.6
edited by Xiaoling
on 2023/06/26 16:22
Change comment: There is no comment for this version
To version 40.9
edited by Xiaoling
on 2024/01/08 16:24
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DS03A-LB Outdoor LoRaWAN Door Sensor User Manual
1 +DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Content
... ... @@ -1,9 +1,18 @@
1 +(% style="display:none" %) (%%)
2 +
1 1  (% style="text-align:center" %)
2 -[[image:image-20230516085523-1.jpeg||height="491" width="491"]]
4 +[[image:image-20240108161155-2.png]]
3 3  
4 4  
5 -**Table of Contents:**
6 6  
8 +
9 +
10 +
11 +
12 +
13 +
14 +**Table of Contents:**
15 +
7 7  {{toc/}}
8 8  
9 9  
... ... @@ -13,11 +13,11 @@
13 13  
14 14  = 1. Introduction =
15 15  
16 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
25 +== 1.1 What is LoRaWAN Door Sensor ==
17 17  
18 18  
19 19  (((
20 -The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
29 +The Dragino DS03A-LB/LS is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
21 21  )))
22 22  
23 23  (((
... ... @@ -43,7 +43,7 @@
43 43  )))
44 44  
45 45  (((
46 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
55 +DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + li-on battery**(%%), it is designed for long term use up to 5 years.
47 47  )))
48 48  
49 49  (((
... ... @@ -67,25 +67,19 @@
67 67  * Support wireless OTA update firmware
68 68  * Uplink on periodically
69 69  * Downlink to change configure
70 -* 8500mAh Battery for long term use
71 71  * Wall Mountable
72 72  * Outdoor Use
81 +* 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 +* Solar panel + 3000mAh Li-on battery (DS03A-LS)
73 73  
74 -
75 -
76 76  == 1.3 Specification ==
77 77  
78 78  
79 79  (% style="color:#037691" %)**Common DC Characteristics:**
80 80  
81 -* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
89 +* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
82 82  * Operating Temperature: -40 ~~ 85°C
83 83  
84 -(% style="color:#037691" %)**Sensor Detect Distance:**
85 -
86 -* Wood Door: 10mm ~~ 30mm
87 -* Iron Door: 30 ~~ 45mm
88 -
89 89  (% style="color:#037691" %)**LoRa Spec:**
90 90  
91 91  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -106,8 +106,6 @@
106 106  * Sleep Mode: 5uA @ 3.3v
107 107  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
108 108  
109 -
110 -
111 111  == 1.4 Applications ==
112 112  
113 113  
... ... @@ -125,9 +125,8 @@
125 125  == 1.6 Button & LEDs ==
126 126  
127 127  
128 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
129 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]]
129 129  
130 -
131 131  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
132 132  |=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
133 133  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
... ... @@ -141,8 +141,6 @@
141 141  )))
142 142  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means Device is in Deep Sleep Mode.
143 143  
144 -
145 -
146 146  == 1.7 BLE connection ==
147 147  
148 148  
... ... @@ -158,27 +158,44 @@
158 158  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
159 159  
160 160  
161 -== 1.8 Mechanical ==
159 +== 1.8 Pin Definitions ==
162 162  
161 +[[image:image-20230630160843-7.png]]
163 163  
163 +
164 +== 1.9 Mechanical ==
165 +
166 +=== 1.9.1 for LB version ===
167 +
168 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-LB_LoRaWAN_Distance_Detection_Sensor_User_Manual/WebHome/image-20240105152536-3.png?rev=1.1||alt="image-20240105152536-3.png"]]
169 +
170 +
171 +**Probe Mechanical:**
172 +
164 164  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
165 165  
166 166  
167 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
168 168  
177 +=== 1.9.2 for LS version ===
169 169  
170 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
171 171  
180 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20231231203439-3.png?width=886&height=385&rev=1.1||alt="image-20231231203439-3.png"]]
172 172  
173 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
174 174  
175 175  
184 +
185 +== 1.10 Magnet Distance ==
186 +
187 +
188 +* Wood Door: 10mm ~~ 30mm
189 +* Iron Door: 30 ~~ 45mm
190 +
176 176  = 2. Configure DS03A-LB to connect to LoRaWAN network =
177 177  
178 178  == 2.1 How it works ==
179 179  
180 180  
181 -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.
196 +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.
182 182  
183 183  
184 184  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -238,11 +238,13 @@
238 238  === 2.3.1 Device Status, FPORT~=5 ===
239 239  
240 240  
241 -Users can use the downlink command(**0x26 01**) to ask DS03A-LB to send device configure detail, include device configure status. DS03A-LB will uplink a payload via FPort=5 to server.
256 +Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours.
242 242  
243 -The Payload format is as below.
258 +Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
244 244  
245 245  
261 +The Payload format is as below.
262 +
246 246  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
247 247  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
248 248  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -250,7 +250,7 @@
250 250  
251 251  Example parse in TTNv3
252 252  
253 -[[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-20220609104802-1.png?rev=1.1||alt="image-20220609104802-1.png" height="393" width="1195"]]
270 +[[image:image-20230630155406-1.png||height="190" width="873"]]
254 254  
255 255  
256 256  (% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
... ... @@ -306,144 +306,327 @@
306 306  Ex2: 0x0B49 = 2889mV
307 307  
308 308  
309 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
326 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
310 310  
311 311  
329 +DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
330 +
331 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
332 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
333 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:50px" %)**1**|(% style="width:100px" %)**1**|(% style="width:90px" %)**2**|(% style="width:100px" %)**1**|(% style="width:100px" %)**2**|(% style="width:98px" %)**1**
334 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
335 +Keep status1
336 +)))|(% style="width:99px" %)(((
337 +Keep time1(unit: sec)
338 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
339 +Keep time2(unit: sec)
340 +)))|(% style="width:98px" %)(((
341 +Alarm interval(unit: min)
342 +)))
343 +
344 +Example parse in TTNv3
345 +
346 +[[image:image-20230630155527-3.png||height="146" width="902"]]
347 +
348 +
349 +* (((
350 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
351 +)))
352 +
353 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
354 +
355 +
356 +* (((
357 +(% style="color:blue" %)**Disalarm: (default: 0)**
358 +)))
359 +
360 + **If Disalarm = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
361 +
362 + **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
363 +
364 +
365 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
366 +
367 +
368 +* (((
369 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
370 +)))
371 +
372 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
373 +
374 +
375 +
376 +* (((
377 +(% style="color:blue" %)**Alarm interval(default: 0)**
378 +)))
379 +
380 +When the state of the door sensor has not been changed after the timeout alarm, the device will send a uplink every alarm interval. It will stop the alarm until the state of the door sensor is changed after the timeout alarm.
381 +
382 +
383 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
384 +
385 +
312 312  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
313 313  
314 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
388 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
315 315  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
316 316  
317 -Uplink Payload totals 11 bytes.
391 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
318 318  
319 319  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
320 320  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
321 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4**
322 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
323 -The last door open duration (unit: min)
395 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
396 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
397 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
398 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
399 +The last door open duration (unit: sec)
324 324  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
325 325  
326 326  **Status & Alarm:**
327 327  
328 328  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
329 -|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**[bit5:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit0**
330 -|(% style="width:76px" %)**Value**|(% style="width:79px" %)(((
331 -No ACK Message
332 -)))|(% style="width:84px" %)(((
333 -Poll Message Flag
334 -)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
335 -0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open
405 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0**
406 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
407 +Count mod
408 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
409 +Alarm 0: No Alarm; 1: Alarm
410 +)))|(% style="width:131px" %)(((
411 +Status 0: Close; 1: Open
412 +)))
336 336  
337 -[[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"]]
414 +[[image:image-20230630155451-2.png||height="246" width="928"]]
338 338  
339 339  
340 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
417 +* (((
418 +(% style="color:blue" %)**Count mod:Default=0**
419 +)))
341 341  
421 +0: Uplink total open door times since factory
342 342  
343 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
423 +1: Uplink total open door times since last FPORT=2 uplink.
344 344  
345 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
346 346  
426 +* (% style="color:blue" %)**TDC flag**
427 +
428 +When the flag is 1, it means sending packets at normal time intervals.
429 +
430 +Otherwise, it is a packet sent at non-TDC time.
431 +
432 +
347 347  * (((
348 -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.
434 +(% style="color:#0000ff" %)**Alarm**
349 349  )))
350 350  
351 -For example, in the US915 band, the max payload for different DR is:
437 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
352 352  
353 -(((
354 -**~1. DR0**: max is 11 bytes so one entry of data
355 -)))
356 356  
357 -(((
358 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
440 +* (((
441 +(% style="color:blue" %)**Status**
359 359  )))
360 360  
361 -(((
362 -**3. DR2**: total payload includes 11 entries of data
444 +This bit is 1 when the door sensor is open and 0 when it is close.
445 +
446 +
447 +* (((
448 +(% style="color:blue" %)**Total open door events**
363 363  )))
364 364  
365 -(((
366 -**4. DR3**: total payload includes 22 entries of data.
451 +Total pulse/counting base on open door.
452 +
453 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
454 +
455 +
456 +* (((
457 +(% style="color:blue" %)**The last door open duration**
367 367  )))
368 368  
369 -If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
460 +Door sensor last open duration.
370 370  
371 -[[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"]]
462 +Unit: sec.
372 372  
373 -**Downlink:**
464 +[[image:image-20230701094042-1.png||height="154" width="763"]]
374 374  
375 -0x31 61 8E 57 40 61 8E 81 70 05
376 376  
467 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
377 377  
378 -**Uplink:**
469 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
379 379  
380 -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
471 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
381 381  
473 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
474 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
475 +|(% style="width:50px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:125px" %)**3**|(% style="width:100px" %)**4**|(% style="width:86px" %)**1**|(% style="width:96px" %)**3**|(% style="width:126px" %)**3**
476 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
477 +Status1 & Alarm1
478 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
479 +The last door open duration1 (unit: sec)
480 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
481 +Status2 & Alarm2
482 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
382 382  
383 -**Parsed Value:**
484 +**Status1 & Alarm1:**
384 384  
385 -[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
486 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
487 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit0**
488 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
489 +Count mod
490 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
491 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
492 +)))|(% style="width:181px" %)(((
493 +Status1 0: Close; 1: Open (PA8 of pin)
494 +)))
386 386  
496 +**Status2 & Alarm2:**
387 387  
388 -[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
498 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
499 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit0**
500 +|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
501 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
502 +)))|(% style="width:181px" %)(((
503 +Status2 0: Close; 1: Open (PA4 of pin)
504 +)))
389 389  
390 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
506 +[[image:image-20230630155908-6.png||height="295" width="927"]]
391 391  
392 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
393 393  
394 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
509 +* (((
510 +(% style="color:blue" %)**Count mod:Default=0**
511 +)))
395 395  
396 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
513 +0: Uplink total open door times since factory
397 397  
398 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
515 +1: Uplink total open door times since last FPORT=2 uplink.
399 399  
400 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
401 401  
402 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
518 +* (% style="color:blue" %)**TDC flag**
403 403  
404 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
520 +When the flag is 1, it means sending packets at normal time intervals.
405 405  
406 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
522 +Otherwise, it is a packet sent at non-TDC time.
407 407  
408 408  
409 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
525 +* (((
526 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
527 +)))
410 410  
529 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
411 411  
412 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
413 413  
414 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
415 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
416 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
417 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
532 +* (((
533 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
534 +)))
418 418  
536 +This bit is 1 when the door sensor is open and 0 when it is close.
537 +
538 +
419 419  * (((
420 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
540 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
421 421  )))
422 422  
423 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
543 +Total pulse/counting base on open door.
424 424  
545 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
425 425  
547 +
426 426  * (((
427 -(% style="color:blue" %)**Disalarm: (default: 0)**
549 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
428 428  )))
429 429  
430 - **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.
552 +Door sensor last open duration.
431 431  
432 - **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.
554 +Unit: sec.
433 433  
556 +[[image:image-20230701094042-1.png||height="154" width="763"]]
434 434  
435 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
436 436  
559 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
437 437  
561 +
562 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
563 +
564 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
565 +
566 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
567 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
568 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
569 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
570 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
571 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
572 +The last door open duration (unit: sec)
573 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
574 +
575 +**Status & Alarm:**
576 +
577 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
578 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:65px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit0**
579 +|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
580 +Count mod
581 +)))|(% style="width:95px" %)(((
582 +TDC flag 0:No; 1:Yes
583 +)))|(% style="width:116px" %)(((
584 +Alarm 0: No Alarm; 1: Alarm
585 +)))|(% style="width:112px" %)(((
586 +Status 0:Close; 1: Open
587 +)))
588 +
438 438  * (((
439 -(% style="color:blue" %)**Keep Status & Keep Time**
590 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands.
440 440  )))
441 441  
442 -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]]
593 +For example, in the US915 band, the max payload for different DR is:
443 443  
444 -[[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"]]
595 +(((
596 +**~1. DR0**: max is 11 bytes so one entry of data
597 +)))
445 445  
599 +(((
600 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
601 +)))
446 446  
603 +(((
604 +**3. DR2**: total payload includes 11 entries of data
605 +)))
606 +
607 +(((
608 +**4. DR3**: total payload includes 22 entries of data.
609 +)))
610 +
611 +If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
612 +
613 +[[image:image-20230630155556-4.png||height="146" width="938"]]
614 +
615 +**Downlink:**
616 +
617 +0x31 64 9E 7D 34 64 9E 7E 9C 05
618 +
619 +
620 +**Uplink:**
621 +
622 +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
623 +
624 +
625 +**Parsed Value:**
626 +
627 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
628 +
629 +
630 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
631 +
632 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
633 +
634 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
635 +
636 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
637 +
638 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
639 +
640 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
641 +
642 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
643 +
644 +[[image:image-20230630172740-1.png||height="199" width="868"]]
645 +
646 +
447 447  == 2.4 Payload Decoder file ==
448 448  
449 449  
... ... @@ -461,7 +461,9 @@
461 461  
462 462  (% 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.
463 463  
664 +(% style="color:red" %)**Note:After the device is reset,in cumulative counting mode,the last stored count value will be read as the initial value.**
464 464  
666 +
465 465  === 2.5.1 Ways to get datalog via LoRaWAN ===
466 466  
467 467  
... ... @@ -566,8 +566,6 @@
566 566  * 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]].
567 567  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
568 568  
569 -
570 -
571 571  == 3.2 General Commands ==
572 572  
573 573  
... ... @@ -587,7 +587,7 @@
587 587  These commands only valid for DS03A-LB, as below:
588 588  
589 589  
590 -=== 3.3.1 Set Transmit Interval Time ===
790 +=== 3.3.1  Set Transmit Interval Time ===
591 591  
592 592  
593 593  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -615,18 +615,36 @@
615 615  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
616 616  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
617 617  
818 +=== 3.3.2  Set Power Output Duration ===
618 618  
619 619  
620 -=== 3.3.2 Get Device Status ===
821 +Control the output duration 5V . Before each sampling, device will
621 621  
823 +~1. first enable the power output to external sensor,
622 622  
623 -Send a LoRaWAN downlink to ask device send Alarm settings.
825 +2. keep it on as per duration, read sensor value and construct uplink payload
624 624  
625 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
827 +3. final, close the power output.
626 626  
627 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
829 +(% style="color:blue" %)**AT Command: AT+5VT**
628 628  
831 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
832 +|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 204px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 149px;" %)**Response**
833 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
834 +OK
835 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
836 +OK
837 +
838 +)))
629 629  
840 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
841 +Format: Command Code (0x07) followed by 2 bytes.
842 +
843 +The first and second bytes are the time to turn on.
844 +
845 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
846 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
847 +
630 630  === 3.3.3  Enable / Disable Alarm ===
631 631  
632 632  
... ... @@ -634,8 +634,8 @@
634 634  
635 635  (% style="color:blue" %)**AT Command: **
636 636  
637 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
638 -|(% 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**
855 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
856 +|(% style="background-color:#d9e2f3; color:#0070c0; width:153px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:276px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:86px" %)**Response**
639 639  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
640 640  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
641 641  
... ... @@ -651,7 +651,6 @@
651 651  
652 652  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:
653 653  
654 -
655 655  * (((
656 656  (% style="color:blue" %)**Keep Status: Status to be monitor**
657 657  )))
... ... @@ -672,42 +672,104 @@
672 672  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.
673 673  
674 674  
892 +* (((
893 +(% style="color:blue" %)**Downlink Command**
894 +)))
895 +
896 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
897 +
898 +**A9:** Command Type Code
899 +
900 +**aa: **01:TTRIG1; 02:TTRIG2
901 +
902 +**bb:** status to be monitored
903 +
904 +**cc dd:** timeout.
905 +
906 +
907 +**1) AT+TTRIG1 : (PA8 of pin)**
908 +
675 675  (% style="color:blue" %)**AT Command to configure:**
676 676  
677 677  * (((
678 -(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
912 +(% 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.
913 +
914 +(% 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.
679 679  )))
680 680  
681 681  * (((
682 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
918 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
919 +
920 +
921 +
683 683  )))
684 684  
685 685  (% style="color:blue" %)**Downlink Command to configure:**
686 686  
687 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
926 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
688 688  
689 -**A9:** Command Type Code
690 690  
691 -**aa:** status to be monitored
929 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
692 692  
693 -**bb cc:** timeout.
931 +(% style="color:blue" %)**AT Command to configure:**
694 694  
933 +* (((
934 +(% 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.
695 695  
696 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
936 +(% 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.
937 +)))
697 697  
698 -Or
939 +* (((
940 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
699 699  
700 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
701 701  
943 +
944 +)))
702 702  
703 -=== 3.3.5  Count Mod ===
946 +(% style="color:blue" %)**Downlink Command to configure:**
704 704  
948 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30  **or**  0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
705 705  
950 +
951 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
952 +
953 +
954 +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.
955 +
706 706  (% style="color:blue" %)**AT Command:**
707 707  
708 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
709 -|=(% 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**
958 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
959 +|=(% 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**
710 710  |(% style="width:155px" %)(((
961 +AT+TTRALARM=0
962 +)))|(% style="width:279px" %)(((
963 +disable continuous alarm
964 +)))|(% style="width:84px" %)(((
965 +OK
966 +)))
967 +|(% style="width:155px" %)(((
968 +AT+TTRALARM=60
969 +)))|(% style="width:279px" %)(((
970 +The alarm interval is 60 minutes (unit: minutes)
971 +)))|(% style="width:84px" %)(((
972 +OK
973 +)))
974 +
975 +(% style="color:blue" %)**Downlink Command:**
976 +
977 +Example:  0C aa  => AT+TTRALARM= aa
978 +
979 +
980 +=== 3.3.6  Count Mod ===
981 +
982 +
983 +Feature: Manually set the count mode.
984 +
985 +(% style="color:blue" %)**AT Command:**
986 +
987 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
988 +|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 275px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)**Response**
989 +|(% style="width:155px" %)(((
711 711  AT+COUNTMOD=0
712 712  )))|(% style="width:277px" %)(((
713 713  the count value keeps accumulating mode
... ... @@ -717,7 +717,7 @@
717 717  |(% style="width:155px" %)(((
718 718  AT+COUNTMOD=1
719 719  )))|(% style="width:277px" %)(((
720 -the count value will be reset after each TDC timeLast Close Duration Reset after each uplink
999 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
721 721  )))|(% style="width:86px" %)(((
722 722  OK
723 723  )))
... ... @@ -727,24 +727,26 @@
727 727  Example:  0B aa  => AT+COUNTMOD = second byte
728 728  
729 729  
730 -=== 3.3.6  Interrupt Pin Channel Mod ===
1009 +=== 3.3.7  Number of channel of door sensors ===
731 731  
732 732  
1012 +Feature: Set the number of door sensor channels.
1013 +
733 733  (% style="color:blue" %)**AT Command:**
734 734  
735 735  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
736 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1017 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
737 737  |(% style="width:155px" %)(((
738 738  AT+TTRCHANNEL=1
739 -)))|(% style="width:288px" %)(((
740 -set as single channel, only use PA8 pin as interrupt pin.
1020 +)))|(% style="width:259px" %)(((
1021 +Set as single channel, only use PA8 pin as interrupt pin.
741 741  )))|(% style="width:44px" %)(((
742 742  OK
743 743  )))
744 744  |(% style="width:155px" %)(((
745 745  AT+TTRCHANNEL=2
746 -)))|(% style="width:288px" %)(((
747 -is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1027 +)))|(% style="width:259px" %)(((
1028 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
748 748  )))|(% style="width:44px" %)(((
749 749  OK
750 750  )))
... ... @@ -754,55 +754,96 @@
754 754  Example:  0D aa => AT+TTRCHANNEL = second byte
755 755  
756 756  
757 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1038 +=== 3.3.8  Set Time Sync Mode ===
758 758  
759 759  
760 -(% style="color:blue" %)**Downlink Command:**
1041 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
761 761  
762 -Example A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1043 +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.
763 763  
1045 +(% style="color:blue" %)**AT Command:**
764 764  
765 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1047 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1048 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1049 +|(% style="width:155px" %)(((
1050 +AT+SYNCMOD=1
1051 +)))|(% style="width:259px" %)(((
1052 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1053 +)))|(% style="width:44px" %)(((
1054 +OK
1055 +)))
1056 +|(% style="width:155px" %)(((
1057 +AT+SYNCMOD=1,8
1058 +)))|(% style="width:259px" %)(((
1059 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1060 +)))|(% style="width:44px" %)(((
1061 +OK
1062 +)))
1063 +|(% 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
766 766  
767 -
768 768  (% style="color:blue" %)**Downlink Command:**
769 769  
770 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1067 +0x28 0 ~/~/ Same As AT+SYNCMOD=1
771 771  
1069 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
772 772  
773 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1071 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
774 774  
1073 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
775 775  
776 -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.
777 777  
1076 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1077 +
1078 +
778 778  (% style="color:blue" %)**AT Command:**
779 779  
780 780  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
781 -|=(% 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**
1082 +|=(% style="width: 163px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 290px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1083 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1084 +OK
1085 +)))
1086 +
1087 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1088 +
1089 +The sensor will clear the open door times and the duration of the last open door.
1090 +
1091 +
1092 +=== 3.3.10  Set the count value of the number of open door ===
1093 +
1094 +
1095 +(% style="color:blue" %)**AT Command:**
1096 +
1097 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1098 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
782 782  |(% style="width:155px" %)(((
783 -AT+TTRALARM=0
784 -)))|(% style="width:279px" %)(((
785 -disable continuous alarm
786 -)))|(% style="width:84px" %)(((
1100 +AT+SETCNT=1,100
1101 +)))|(% style="width:259px" %)(((
1102 +Set the open door times of PA8 pin to 100 times.
1103 +)))|(% style="width:44px" %)(((
787 787  OK
788 788  )))
1106 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
789 789  |(% style="width:155px" %)(((
790 -AT+TTRALARM=60
791 -)))|(% style="width:279px" %)(((
792 -The alarm interval is 60 minutes (unit: minutes)
793 -)))|(% style="width:84px" %)(((
1108 +AT+SETCNT=2,50
1109 +)))|(% style="width:259px" %)(((
1110 +Set the open door times of PA4 pin to 100 times.
1111 +)))|(% style="width:44px" %)(((
794 794  OK
795 795  )))
796 796  
797 797  (% style="color:blue" %)**Downlink Command:**
798 798  
799 -Example:  0C aa  => AT+TTRALARM= aa
1117 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
800 800  
1119 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
801 801  
1121 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1122 +
1123 +
802 802  = 4. Battery & Power Consumption =
803 803  
804 804  
805 -DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1127 +DS03A-LB use ER26500 + SPC1520 battery pack and DS03A-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
806 806  
807 807  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
808 808  
... ... @@ -818,14 +818,11 @@
818 818  
819 819  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
820 820  
1143 +Methods to Update Firmware:
821 821  
822 -**Methods to Update Firmware:**
823 -
824 824  * (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/]]**
825 825  * 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]]**.
826 826  
827 -
828 -
829 829  = 6. FAQ =
830 830  
831 831  
... ... @@ -833,7 +833,7 @@
833 833  = 7. Order Info =
834 834  
835 835  
836 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1155 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
837 837  
838 838  (% style="color:red" %)**XX**(%%): The default frequency band
839 839  
... ... @@ -853,14 +853,12 @@
853 853  
854 854  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
855 855  
856 -
857 -
858 858  = 8. ​Packing Info =
859 859  
860 860  
861 861  (% style="color:#037691" %)**Package Includes**:
862 862  
863 -* DS03A-LB LoRaWAN Temperature Sensor
1180 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
864 864  
865 865  (% style="color:#037691" %)**Dimension and weight**:
866 866  
... ... @@ -872,8 +872,6 @@
872 872  
873 873  * Weight / pcs : g
874 874  
875 -
876 -
877 877  = 9. Support =
878 878  
879 879  
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
image-20240108160443-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +500.2 KB
Content
image-20240108161155-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +265.7 KB
Content