Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 5.1
edited by Xiaoling
on 2023/05/22 09:28
Change comment: Uploaded new attachment "image-20230522092858-1.png", version {1}
To version 40.7
edited by Xiaoling
on 2024/01/08 16:23
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  
... ... @@ -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 **solar powered + li-on battery**, it is designed for long term use up to 5 years.
47 47  )))
48 48  
49 49  (((
... ... @@ -51,6 +51,9 @@
51 51  )))
52 52  
53 53  
63 +[[image:image-20230522092934-2.png||height="346" width="774"]]
64 +
65 +
54 54  == 1.2 ​Features ==
55 55  
56 56  
... ... @@ -64,25 +64,19 @@
64 64  * Support wireless OTA update firmware
65 65  * Uplink on periodically
66 66  * Downlink to change configure
67 -* 8500mAh Battery for long term use
68 68  * Wall Mountable
69 69  * Outdoor Use
81 +* 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 +* Solar panel + 3000mAh Li-on battery (DS03A-LS)
70 70  
71 -
72 -
73 73  == 1.3 Specification ==
74 74  
75 75  
76 76  (% style="color:#037691" %)**Common DC Characteristics:**
77 77  
78 -* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
89 +* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
79 79  * Operating Temperature: -40 ~~ 85°C
80 80  
81 -(% style="color:#037691" %)**Sensor Detect Distance:**
82 -
83 -* Wood Door: 10mm ~~ 30mm
84 -* Iron Door: 30 ~~ 45mm
85 -
86 86  (% style="color:#037691" %)**LoRa Spec:**
87 87  
88 88  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -103,8 +103,6 @@
103 103  * Sleep Mode: 5uA @ 3.3v
104 104  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
105 105  
106 -
107 -
108 108  == 1.4 Applications ==
109 109  
110 110  
... ... @@ -122,9 +122,8 @@
122 122  == 1.6 Button & LEDs ==
123 123  
124 124  
125 -[[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"]]
126 126  
127 -
128 128  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
129 129  |=(% 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**
130 130  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
... ... @@ -138,12 +138,10 @@
138 138  )))
139 139  |(% 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.
140 140  
141 -
142 -
143 143  == 1.7 BLE connection ==
144 144  
145 145  
146 -D2x-LB support BLE remote configure.
147 +DS03A-LB support BLE remote configure.
147 147  
148 148  
149 149  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:
... ... @@ -155,27 +155,44 @@
155 155  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
156 156  
157 157  
158 -== 1.8 Mechanical ==
159 +== 1.8 Pin Definitions ==
159 159  
161 +[[image:image-20230630160843-7.png]]
160 160  
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 +
161 161  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
162 162  
163 163  
164 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
165 165  
177 +=== 1.9.2 for LS version ===
166 166  
167 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
168 168  
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"]]
169 169  
170 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
171 171  
172 172  
184 +
185 +== 1.10 Magnet Distance ==
186 +
187 +
188 +* Wood Door: 10mm ~~ 30mm
189 +* Iron Door: 30 ~~ 45mm
190 +
173 173  = 2. Configure DS03A-LB to connect to LoRaWAN network =
174 174  
175 175  == 2.1 How it works ==
176 176  
177 177  
178 -The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 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.
179 179  
180 180  
181 181  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -183,9 +183,11 @@
183 183  
184 184  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" %)
185 185  
186 -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.
204 +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.
187 187  
206 +[[image:image-20230522092858-1.png||height="391" width="874"]]
188 188  
208 +
189 189  (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
190 190  
191 191  Each DS03A-LB is shipped with a sticker with the default device EUI as below:
... ... @@ -232,11 +232,14 @@
232 232  
233 233  === 2.3.1 Device Status, FPORT~=5 ===
234 234  
235 -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.
236 236  
237 -The Payload format is as below.
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.
238 238  
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.
239 239  
260 +
261 +The Payload format is as below.
262 +
240 240  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
241 241  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
242 242  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -244,42 +244,42 @@
244 244  
245 245  Example parse in TTNv3
246 246  
247 -[[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/image-20230415153147-2.png?rev=1.1||alt="图片-20230415153147-2.png" height="209" width="1063"]]
270 +[[image:image-20230630155406-1.png||height="190" width="873"]]
248 248  
249 249  
250 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x0B
273 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
251 251  
252 252  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
253 253  
254 254  (% style="color:#037691" %)**Frequency Band**:
255 255  
256 -*0x01: EU868
279 +0x01: EU868
257 257  
258 -*0x02: US915
281 +0x02: US915
259 259  
260 -*0x03: IN865
283 +0x03: IN865
261 261  
262 -*0x04: AU915
285 +0x04: AU915
263 263  
264 -*0x05: KZ865
287 +0x05: KZ865
265 265  
266 -*0x06: RU864
289 +0x06: RU864
267 267  
268 -*0x07: AS923
291 +0x07: AS923
269 269  
270 -*0x08: AS923-1
293 +0x08: AS923-1
271 271  
272 -*0x09: AS923-2
295 +0x09: AS923-2
273 273  
274 -*0x0a: AS923-3
297 +0x0a: AS923-3
275 275  
276 -*0x0b: CN470
299 +0x0b: CN470
277 277  
278 -*0x0c: EU433
301 +0x0c: EU433
279 279  
280 -*0x0d: KR920
303 +0x0d: KR920
281 281  
282 -*0x0e: MA869
305 +0x0e: MA869
283 283  
284 284  
285 285  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -300,138 +300,327 @@
300 300  Ex2: 0x0B49 = 2889mV
301 301  
302 302  
303 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
326 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
304 304  
305 305  
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 +
306 306  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
307 307  
308 -* 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"]].
309 309  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
310 310  
311 -Uplink Payload totals 11 bytes.
391 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
312 312  
313 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
314 -|=(% colspan="5" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 522px;" %)**Real-Time Open/Close Status, FPORT=2**
315 -|(% style="width:95px" %)**Size(bytes)**|(% style="width:78px" %)**1**|(% style="width:98px" %)**3**|(% style="width:144px" %)**3**|(% style="width:108px" %)**4**
316 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
317 -The last door open duration (unit: min)
393 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
394 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
395 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
396 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
397 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
398 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
399 +The last door open duration (unit: sec)
318 318  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
319 319  
402 +**Status & Alarm:**
320 320  
321 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:518.818px" %)
322 -|=(% colspan="4" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 516px;" %)**Status & Alarm field**
323 -|(% style="width:76px" %)**Size(bit)**|(% style="width:70px" %)**6**|(% style="width:240px" %)**1**|(% style="width:130px" %)**1**
324 -|(% style="width:76px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:240px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
325 -0: No Alarm; 1: Alarm|(% style="width:130px" %)Status
326 -0: Close, 1: Open
404 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
405 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0**
406 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
407 +Count mod
408 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
409 +Alarm 0: No Alarm; 1: Alarm
410 +)))|(% style="width:131px" %)(((
411 +Status 0: Close; 1: Open
412 +)))
327 327  
328 -[[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"]]
329 329  
330 330  
331 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
417 +* (((
418 +(% style="color:blue" %)**Count mod:Default=0**
419 +)))
332 332  
421 +0: Uplink total open door times since factory
333 333  
334 -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.
335 335  
336 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
337 337  
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 +
338 338  * (((
339 -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**
340 340  )))
341 341  
342 -For example, in the US915 band, the max payload for different DR is:
437 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
343 343  
344 -1. (((
345 -**DR0**: max is 11 bytes so one entry of data
439 +
440 +* (((
441 +(% style="color:blue" %)**Status**
346 346  )))
347 -1. (((
348 -**DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
443 +
444 +This bit is 1 when the door sensor is open and 0 when it is close.
445 +
446 +
447 +* (((
448 +(% style="color:blue" %)**Total open door events**
349 349  )))
350 -1. (((
351 -**DR2**: total payload includes 11 entries of data
450 +
451 +Total pulse/counting base on open door.
452 +
453 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
454 +
455 +
456 +* (((
457 +(% style="color:blue" %)**The last door open duration**
352 352  )))
353 -1. (((
354 -**DR3**: total payload includes 22 entries of data.
355 -)))
356 356  
357 -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.
358 358  
359 -[[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.
360 360  
361 -**Downlink:**
464 +[[image:image-20230701094042-1.png||height="154" width="763"]]
362 362  
363 -0x31 61 8E 57 40 61 8E 81 70 05
364 364  
467 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
365 365  
366 -**Uplink:**
469 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
367 367  
368 -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.**
369 369  
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)
370 370  
371 -**Parsed Value:**
484 +**Status1 & Alarm1:**
372 372  
373 -[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 +)))
374 374  
496 +**Status2 & Alarm2:**
375 375  
376 -[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 +)))
377 377  
378 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
506 +[[image:image-20230630155908-6.png||height="295" width="927"]]
379 379  
380 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
381 381  
382 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
509 +* (((
510 +(% style="color:blue" %)**Count mod:Default=0**
511 +)))
383 383  
384 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
513 +0: Uplink total open door times since factory
385 385  
386 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
515 +1: Uplink total open door times since last FPORT=2 uplink.
387 387  
388 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
389 389  
390 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
518 +* (% style="color:blue" %)**TDC flag**
391 391  
392 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
520 +When the flag is 1, it means sending packets at normal time intervals.
393 393  
394 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
522 +Otherwise, it is a packet sent at non-TDC time.
395 395  
396 396  
397 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
525 +* (((
526 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
527 +)))
398 398  
529 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
399 399  
400 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
401 401  
402 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
403 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
404 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
405 -|**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 +)))
406 406  
536 +This bit is 1 when the door sensor is open and 0 when it is close.
537 +
538 +
407 407  * (((
408 -(% 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**
409 409  )))
410 410  
411 -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.
412 412  
545 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
413 413  
547 +
414 414  * (((
415 -(% 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**
416 416  )))
417 417  
418 - **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.
419 419  
420 - **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.
421 421  
556 +[[image:image-20230701094042-1.png||height="154" width="763"]]
422 422  
423 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
424 424  
559 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
425 425  
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 +
426 426  * (((
427 -(% 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.
428 428  )))
429 429  
430 -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:
431 431  
432 -[[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 +)))
433 433  
599 +(((
600 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
601 +)))
434 434  
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 +
435 435  == 2.4 Payload Decoder file ==
436 436  
437 437  
... ... @@ -449,7 +449,9 @@
449 449  
450 450  (% 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.
451 451  
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.**
452 452  
666 +
453 453  === 2.5.1 Ways to get datalog via LoRaWAN ===
454 454  
455 455  
... ... @@ -540,11 +540,9 @@
540 540  == 2.8 ​Firmware Change Log ==
541 541  
542 542  
543 -**Firmware download link:**
757 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
544 544  
545 -[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
546 546  
547 -
548 548  = 3. Configure DS03A-LB =
549 549  
550 550  == 3.1 Configure Methods: ==
... ... @@ -556,10 +556,9 @@
556 556  * 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]].
557 557  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
558 558  
559 -
560 -
561 561  == 3.2 General Commands ==
562 562  
773 +
563 563  These commands are to configure:
564 564  
565 565  * General system settings like: uplink interval.
... ... @@ -576,7 +576,7 @@
576 576  These commands only valid for DS03A-LB, as below:
577 577  
578 578  
579 -=== 3.3.1 Set Transmit Interval Time ===
790 +=== 3.3.1  Set Transmit Interval Time ===
580 580  
581 581  
582 582  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -584,7 +584,7 @@
584 584  (% style="color:blue" %)**AT Command: AT+TDC**
585 585  
586 586  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
587 -|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
798 +|=(% 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**
588 588  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
589 589  30000
590 590  OK
... ... @@ -604,18 +604,36 @@
604 604  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
605 605  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
606 606  
818 +=== 3.3.2  Set Power Output Duration ===
607 607  
608 608  
609 -=== 3.3.2 Get Device Status ===
821 +Control the output duration 5V . Before each sampling, device will
610 610  
823 +~1. first enable the power output to external sensor,
611 611  
612 -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
613 613  
614 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
827 +3. final, close the power output.
615 615  
616 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
829 +(% style="color:blue" %)**AT Command: AT+5VT**
617 617  
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 +)))
618 618  
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 +
619 619  === 3.3.3  Enable / Disable Alarm ===
620 620  
621 621  
... ... @@ -623,8 +623,8 @@
623 623  
624 624  (% style="color:blue" %)**AT Command: **
625 625  
626 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
627 -|(% 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**
628 628  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
629 629  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
630 630  
... ... @@ -640,7 +640,6 @@
640 640  
641 641  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:
642 642  
643 -
644 644  * (((
645 645  (% style="color:blue" %)**Keep Status: Status to be monitor**
646 646  )))
... ... @@ -661,42 +661,104 @@
661 661  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.
662 662  
663 663  
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 +
664 664  (% style="color:blue" %)**AT Command to configure:**
665 665  
666 666  * (((
667 -(% 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.
668 668  )))
669 669  
670 670  * (((
671 -(% 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 +
672 672  )))
673 673  
674 674  (% style="color:blue" %)**Downlink Command to configure:**
675 675  
676 -(% 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.
677 677  
678 -**A9:** Command Type Code
679 679  
680 -**aa:** status to be monitored
929 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
681 681  
682 -**bb cc:** timeout.
931 +(% style="color:blue" %)**AT Command to configure:**
683 683  
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.
684 684  
685 -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 +)))
686 686  
687 -Or
939 +* (((
940 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
688 688  
689 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
690 690  
943 +
944 +)))
691 691  
692 -=== 3.3.5  Count Mod ===
946 +(% style="color:blue" %)**Downlink Command to configure:**
693 693  
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.
694 694  
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 +
695 695  (% style="color:blue" %)**AT Command:**
696 696  
697 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
698 -|=(% 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**
699 699  |(% 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" %)(((
700 700  AT+COUNTMOD=0
701 701  )))|(% style="width:277px" %)(((
702 702  the count value keeps accumulating mode
... ... @@ -706,7 +706,7 @@
706 706  |(% style="width:155px" %)(((
707 707  AT+COUNTMOD=1
708 708  )))|(% style="width:277px" %)(((
709 -the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
999 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
710 710  )))|(% style="width:86px" %)(((
711 711  OK
712 712  )))
... ... @@ -716,24 +716,26 @@
716 716  Example:  0B aa  => AT+COUNTMOD = second byte
717 717  
718 718  
719 -=== 3.3.6  Interrupt Pin Channel Mod ===
1009 +=== 3.3.7  Number of channel of door sensors ===
720 720  
721 721  
1012 +Feature: Set the number of door sensor channels.
1013 +
722 722  (% style="color:blue" %)**AT Command:**
723 723  
724 724  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
725 -|=(% 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**
726 726  |(% style="width:155px" %)(((
727 727  AT+TTRCHANNEL=1
728 -)))|(% style="width:288px" %)(((
729 -set as single channel, only use PB14 pin as interrupt pin.
1020 +)))|(% style="width:259px" %)(((
1021 +Set as single channel, only use PA8 pin as interrupt pin.
730 730  )))|(% style="width:44px" %)(((
731 731  OK
732 732  )))
733 733  |(% style="width:155px" %)(((
734 734  AT+TTRCHANNEL=2
735 -)))|(% style="width:288px" %)(((
736 -is set as dual channel, use PB14 pin and PB15 pin as interrupt pin.
1027 +)))|(% style="width:259px" %)(((
1028 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
737 737  )))|(% style="width:44px" %)(((
738 738  OK
739 739  )))
... ... @@ -743,83 +743,96 @@
743 743  Example:  0D aa => AT+TTRCHANNEL = second byte
744 744  
745 745  
746 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1038 +=== 3.3.8  Set Time Sync Mode ===
747 747  
748 748  
749 -(% 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.
750 750  
751 -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.
752 752  
1045 +(% style="color:blue" %)**AT Command:**
753 753  
754 -=== 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
755 755  
756 -
757 757  (% style="color:blue" %)**Downlink Command:**
758 758  
759 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1067 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
760 760  
1069 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
761 761  
762 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1071 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
763 763  
1073 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
764 764  
765 -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.
766 766  
1076 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1077 +
1078 +
767 767  (% style="color:blue" %)**AT Command:**
768 768  
769 769  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
770 -|=(% 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**
771 -|(% style="width:155px" %)(((
772 -AT+TTRALARM=0
773 -)))|(% style="width:279px" %)(((
774 -disable continuous alarm
775 -)))|(% style="width:84px" %)(((
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" %)(((
776 776  OK
777 777  )))
778 -|(% style="width:155px" %)(((
779 -AT+TTRALARM=60
780 -)))|(% style="width:279px" %)(((
781 -The alarm interval is 60 minutes (unit: minutes)
782 -)))|(% style="width:84px" %)(((
783 -OK
784 -)))
785 785  
786 -(% style="color:blue" %)**Downlink Command:**
1087 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
787 787  
788 -Example:  0C aa  => AT+TTRALARM= aa
1089 +The sensor will clear the open door times and the duration of the last open door.
789 789  
790 790  
791 -=== 3.3.10  Select counting mode ===
1092 +=== 3.3.10  Set the count value of the number of open door ===
792 792  
793 793  
794 -(% style="color:blue" %)**AT+TTRMODx=a,b**
795 -
796 -When (% style="color:#037691" %)**a=0**(%%), the door is opened to count, and when (% style="color:#037691" %)**a=1**(%%),the closed door is counted.
797 -
798 -When (% style="color:#037691" %)**b=0**(%%), it is the last door open duration, and when (% style="color:#037691" %)**b=1**(%%),the last door close duration.
799 -
800 800  (% style="color:blue" %)**AT Command:**
801 801  
802 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
803 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 278px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 77px;background-color:#D9E2F3;color:#0070C0" %)**Response**
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**
804 804  |(% style="width:155px" %)(((
805 -AT+TTRMODx=1,0
806 -)))|(% style="width:278px" %)Door closed count and record the last door opened duration|(% style="width:85px" %)(((
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" %)(((
807 807  OK
808 808  )))
1106 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
809 809  |(% style="width:155px" %)(((
810 -AT+TTRMODx=0,1
811 -)))|(% style="width:278px" %)(((
812 -Door opened count and record the last door Door Door open closed duration
813 -)))|(% style="width:85px" %)(((
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" %)(((
814 814  OK
815 815  )))
816 816  
1115 +(% style="color:blue" %)**Downlink Command:**
817 817  
1117 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
818 818  
1119 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1120 +
1121 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1122 +
1123 +
819 819  = 4. Battery & Power Consumption =
820 820  
821 821  
822 -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.
823 823  
824 824  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
825 825  
... ... @@ -835,14 +835,11 @@
835 835  
836 836  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
837 837  
838 -
839 839  Methods to Update Firmware:
840 840  
841 -* (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/]]
842 -* 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]]**.
1145 +* (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/]]**
1146 +* 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]]**.
843 843  
844 -
845 -
846 846  = 6. FAQ =
847 847  
848 848  
... ... @@ -850,7 +850,7 @@
850 850  = 7. Order Info =
851 851  
852 852  
853 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1155 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
854 854  
855 855  (% style="color:red" %)**XX**(%%): The default frequency band
856 856  
... ... @@ -870,14 +870,12 @@
870 870  
871 871  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
872 872  
873 -
874 -
875 875  = 8. ​Packing Info =
876 876  
877 877  
878 878  (% style="color:#037691" %)**Package Includes**:
879 879  
880 -* DS03A-LB LoRaWAN Temperature Sensor
1180 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
881 881  
882 882  (% style="color:#037691" %)**Dimension and weight**:
883 883  
... ... @@ -889,8 +889,6 @@
889 889  
890 890  * Weight / pcs : g
891 891  
892 -
893 -
894 894  = 9. Support =
895 895  
896 896  
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
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