Skip to Content
Version 40.4 by Xiaoling on 2024/01/08 16:20
Show last authors
1 (% style="display:none" %) (%%)
2
3 (% style="text-align:center" %)
4 [[image:image-20240108161155-2.png]]
5
6
7
8
9
10
11
12
13
14 **Table of Contents:**
15
16 {{toc/}}
17
18
19
20
21
22
23 = 1. Introduction =
24
25 == 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
26
27
28 (((
29 The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
30 )))
31
32 (((
33 The LoRa wireless technology used in DS03A-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
34 )))
35
36 (((
37 The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically.
38 )))
39
40 (((
41 DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
42 )))
43
44 (((
45 DS03A-LB has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.
46
47 DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
48 )))
49
50 (((
51 DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
52 )))
53
54 (((
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.
56 )))
57
58 (((
59 Each DS03A-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
60 )))
61
62
63 [[image:image-20230522092934-2.png||height="346" width="774"]]
64
65
66 == 1.2 ​Features ==
67
68
69 * LoRaWAN 1.0.3 Class A
70 * Ultra-low power consumption
71 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
72 * Door Open/Close detect
73 * Door open/close statistics
74 * Datalog Feature, Open Alarm Feature
75 * Support Bluetooth v5.1 and LoRaWAN remote configure
76 * Support wireless OTA update firmware
77 * Uplink on periodically
78 * Downlink to change configure
79 * Wall Mountable
80 * Outdoor Use
81 * 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 * Solar panel + 3000mAh Li-on battery (DS03A-LS)
83
84 == 1.3 Specification ==
85
86
87 (% style="color:#037691" %)**Common DC Characteristics:**
88
89 * Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
90 * Operating Temperature: -40 ~~ 85°C
91
92 (% style="color:#037691" %)**LoRa Spec:**
93
94 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
95 * Max +22 dBm constant RF output vs.
96 * RX sensitivity: down to -139 dBm.
97 * Excellent blocking immunity
98
99 (% style="color:#037691" %)**Battery:**
100
101 * Li/SOCI2 un-chargeable battery
102 * Capacity: 8500mAh
103 * Self-Discharge: <1% / Year @ 25°C
104 * Max continuously current: 130mA
105 * Max boost current: 2A, 1 second
106
107 (% style="color:#037691" %)**Power Consumption**
108
109 * Sleep Mode: 5uA @ 3.3v
110 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
111
112 == 1.4 Applications ==
113
114
115 [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
116
117
118 == 1.5 Sleep mode and working mode ==
119
120
121 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
122
123 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
124
125
126 == 1.6 Button & LEDs ==
127
128
129 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]]
130
131 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
134 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
135 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
136 )))
137 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
138 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
139 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
140 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
141 )))
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
144 == 1.7 BLE connection ==
145
146
147 DS03A-LB support BLE remote configure.
148
149
150 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
151
152 * Press button to send an uplink
153 * Press button to active device.
154 * Device Power on or reset.
155
156 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
157
158
159 == 1.8 Pin Definitions ==
160
161 [[image:image-20230630160843-7.png]]
162
163
164 == 1.9 Mechanical ==
165
166
167 [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
168
169
170 [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
171
172
173 [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
174
175
176 [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
177
178
179 == 1.10 Magnet Distance ==
180
181
182 * Wood Door: 10mm ~~ 30mm
183 * Iron Door: 30 ~~ 45mm
184
185 = 2. Configure DS03A-LB to connect to LoRaWAN network =
186
187 == 2.1 How it works ==
188
189
190 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.
191
192
193 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
194
195
196 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" %)
197
198 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.
199
200 [[image:image-20230522092858-1.png||height="391" width="874"]]
201
202
203 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
204
205 Each DS03A-LB is shipped with a sticker with the default device EUI as below:
206
207 [[image:image-20230426085205-1.png||height="238" width="512"]]
208
209
210 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
211
212 (% style="display:none" %) (%%)
213
214 (% style="color:blue" %)**Register the device**
215
216
217 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144099263-405.png?rev=1.1||alt="1675144099263-405.png"]](% style="display:none" %)
218
219
220 (% style="color:blue" %)**Add APP EUI and DEV EUI**
221
222 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144117571-832.png?rev=1.1||alt="1675144117571-832.png"]]
223
224
225 (% style="color:blue" %)**Add APP EUI in the application**
226
227 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144143021-195.png?rev=1.1||alt="1675144143021-195.png"]]
228
229
230 (% style="color:blue" %)**Add APP KEY**
231
232 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144157838-392.png?rev=1.1||alt="1675144157838-392.png"]]
233
234
235 (% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
236
237
238 Press the button for 5 seconds to activate the DS03A-LB.
239
240 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to Join LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
241
242 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
243
244
245 == 2.3 ​Uplink Payload ==
246
247 === 2.3.1 Device Status, FPORT~=5 ===
248
249
250 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.
251
252 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.
253
254
255 The Payload format is as below.
256
257 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
258 |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
259 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
260 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
261
262 Example parse in TTNv3
263
264 [[image:image-20230630155406-1.png||height="190" width="873"]]
265
266
267 (% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
268
269 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
270
271 (% style="color:#037691" %)**Frequency Band**:
272
273 0x01: EU868
274
275 0x02: US915
276
277 0x03: IN865
278
279 0x04: AU915
280
281 0x05: KZ865
282
283 0x06: RU864
284
285 0x07: AS923
286
287 0x08: AS923-1
288
289 0x09: AS923-2
290
291 0x0a: AS923-3
292
293 0x0b: CN470
294
295 0x0c: EU433
296
297 0x0d: KR920
298
299 0x0e: MA869
300
301
302 (% style="color:#037691" %)**Sub-Band**:
303
304 AU915 and US915:value 0x00 ~~ 0x08
305
306 CN470: value 0x0B ~~ 0x0C
307
308 Other Bands: Always 0x00
309
310
311 (% style="color:#037691" %)**Battery Info**:
312
313 Check the battery voltage.
314
315 Ex1: 0x0B45 = 2885mV
316
317 Ex2: 0x0B49 = 2889mV
318
319
320 === 2.3.2  Sensor Configuration, FPORT~=4 ===
321
322
323 DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
324
325 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
326 |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
327 |**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**
328 |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
329 Keep status1
330 )))|(% style="width:99px" %)(((
331 Keep time1(unit: sec)
332 )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
333 Keep time2(unit: sec)
334 )))|(% style="width:98px" %)(((
335 Alarm interval(unit: min)
336 )))
337
338 Example parse in TTNv3
339
340 [[image:image-20230630155527-3.png||height="146" width="902"]]
341
342
343 * (((
344 (% style="color:blue" %)**TDC: (default: 0x001C20)**
345 )))
346
347 Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
348
349
350 * (((
351 (% style="color:blue" %)**Disalarm: (default: 0)**
352 )))
353
354 **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.
355
356 **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.
357
358
359 (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
360
361
362 * (((
363 (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
364 )))
365
366 Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
367
368
369
370 * (((
371 (% style="color:blue" %)**Alarm interval(default: 0)**
372 )))
373
374 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.
375
376
377 === 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
378
379
380 DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
381
382 * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
383 * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
384
385 **1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
386
387 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
388 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
389 |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
390 |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
391 Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
392 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
393 The last door open duration (unit: sec)
394 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
395
396 **Status & Alarm:**
397
398 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
399 |(% 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**
400 |(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
401 Count mod
402 )))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
403 Alarm 0: No Alarm; 1: Alarm
404 )))|(% style="width:131px" %)(((
405 Status 0: Close; 1: Open
406 )))
407
408 [[image:image-20230630155451-2.png||height="246" width="928"]]
409
410
411 * (((
412 (% style="color:blue" %)**Count mod:Default=0**
413 )))
414
415 0: Uplink total open door times since factory
416
417 1: Uplink total open door times since last FPORT=2 uplink.
418
419
420 * (% style="color:blue" %)**TDC flag**
421
422 When the flag is 1, it means sending packets at normal time intervals.
423
424 Otherwise, it is a packet sent at non-TDC time.
425
426
427 * (((
428 (% style="color:#0000ff" %)**Alarm**
429 )))
430
431 See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
432
433
434 * (((
435 (% style="color:blue" %)**Status**
436 )))
437
438 This bit is 1 when the door sensor is open and 0 when it is close.
439
440
441 * (((
442 (% style="color:blue" %)**Total open door events**
443 )))
444
445 Total pulse/counting base on open door.
446
447 Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
448
449
450 * (((
451 (% style="color:blue" %)**The last door open duration**
452 )))
453
454 Door sensor last open duration.
455
456 Unit: sec.
457
458 [[image:image-20230701094042-1.png||height="154" width="763"]]
459
460
461 **2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
462
463 (When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
464
465 (% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
466
467 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
468 |=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
469 |(% 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**
470 |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
471 Status1 & Alarm1
472 )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
473 The last door open duration1 (unit: sec)
474 )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
475 Status2 & Alarm2
476 )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
477
478 **Status1 & Alarm1:**
479
480 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
481 |(% 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**
482 |(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
483 Count mod
484 )))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
485 Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
486 )))|(% style="width:181px" %)(((
487 Status1 0: Close; 1: Open (PA8 of pin)
488 )))
489
490 **Status2 & Alarm2:**
491
492 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
493 |(% 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**
494 |(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
495 Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
496 )))|(% style="width:181px" %)(((
497 Status2 0: Close; 1: Open (PA4 of pin)
498 )))
499
500 [[image:image-20230630155908-6.png||height="295" width="927"]]
501
502
503 * (((
504 (% style="color:blue" %)**Count mod:Default=0**
505 )))
506
507 0: Uplink total open door times since factory
508
509 1: Uplink total open door times since last FPORT=2 uplink.
510
511
512 * (% style="color:blue" %)**TDC flag**
513
514 When the flag is 1, it means sending packets at normal time intervals.
515
516 Otherwise, it is a packet sent at non-TDC time.
517
518
519 * (((
520 (% style="color:#0000ff" %)**Alarm1 or Alarm2**
521 )))
522
523 See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
524
525
526 * (((
527 (% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
528 )))
529
530 This bit is 1 when the door sensor is open and 0 when it is close.
531
532
533 * (((
534 (% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
535 )))
536
537 Total pulse/counting base on open door.
538
539 Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
540
541
542 * (((
543 (% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
544 )))
545
546 Door sensor last open duration.
547
548 Unit: sec.
549
550 [[image:image-20230701094042-1.png||height="154" width="763"]]
551
552
553 === 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
554
555
556 DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
557
558 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
559
560 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
561 |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
562 |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
563 |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
564 Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
565 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
566 The last door open duration (unit: sec)
567 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
568
569 **Status & Alarm:**
570
571 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
572 |(% 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**
573 |(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
574 Count mod
575 )))|(% style="width:95px" %)(((
576 TDC flag 0:No; 1:Yes
577 )))|(% style="width:116px" %)(((
578 Alarm 0: No Alarm; 1: Alarm
579 )))|(% style="width:112px" %)(((
580 Status 0:Close; 1: Open
581 )))
582
583 * (((
584 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.
585 )))
586
587 For example, in the US915 band, the max payload for different DR is:
588
589 (((
590 **~1. DR0**: max is 11 bytes so one entry of data
591 )))
592
593 (((
594 **2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
595 )))
596
597 (((
598 **3. DR2**: total payload includes 11 entries of data
599 )))
600
601 (((
602 **4. DR3**: total payload includes 22 entries of data.
603 )))
604
605 If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
606
607 [[image:image-20230630155556-4.png||height="146" width="938"]]
608
609 **Downlink:**
610
611 0x31 64 9E 7D 34 64 9E 7E 9C 05
612
613
614 **Uplink:**
615
616 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
617
618
619 **Parsed Value:**
620
621 [COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
622
623
624 [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
625
626 [SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
627
628 [SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
629
630 [SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
631
632 [SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
633
634 [PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
635
636 [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
637
638 [[image:image-20230630172740-1.png||height="199" width="868"]]
639
640
641 == 2.4 Payload Decoder file ==
642
643
644 (((
645 In TTN, use can add a custom payload so it shows friendly. 
646 )))
647
648 (((
649 In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
650 )))
651
652
653 == 2.5 Datalog Feature ==
654
655
656 (% 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.
657
658 (% 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.**
659
660
661 === 2.5.1 Ways to get datalog via LoRaWAN ===
662
663
664 Set PNACKMD=1, DS03A-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DS03A-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
665
666 * a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
667 * b) DS03A-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS03A-LB gets a ACK, DS03A-LB will consider there is a network connection and resend all NONE-ACK Message.
668
669 Below is the typical case for the Datalog Feature (Set PNACKMD=1)
670
671 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="image-20220703111700-2.png" height="381" width="1119"]]
672
673
674 === 2.5.2 Unix TimeStamp ===
675
676
677 DS03A-LB uses Unix TimeStamp format based on
678
679 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="image-20220523001219-11.png" height="97" width="627"]]
680
681 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
682
683 Below is the converter example
684
685 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="image-20220523001219-12.png" height="298" width="720"]]
686
687 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
688
689
690 === 2.5.3 Set Device Time ===
691
692
693 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
694
695 Once DS03A-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB. If DS03A-LB fails to get the time from the server, DS03A-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
696
697 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN v3 and loriot support but TTN v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN v2 if SYNCMOD=1.**
698
699
700 == 2.6 ​Show Data in DataCake IoT Server ==
701
702
703 Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
704
705
706 (% style="color:blue" %)**Step 1:**(%%)** Link TTNv3 to Datacake.**[[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]
707
708 (% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
709
710 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746350207-427.png?rev=1.1||alt="1654746350207-427.png"]]
711
712
713 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654747162439-840.png?rev=1.1||alt="1654747162439-840.png"]]
714
715
716 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746405400-203.png?rev=1.1||alt="1654746405400-203.png"]]
717
718
719 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746763908-732.png?rev=1.1||alt="1654746763908-732.png"]]
720
721
722 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746716087-684.png?rev=1.1||alt="1654746716087-684.png"]]
723
724
725 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746693868-718.png?rev=1.1||alt="1654746693868-718.png"]]
726
727
728 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746674738-826.png?rev=1.1||alt="1654746674738-826.png"]]
729
730
731 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746646379-591.png?rev=1.1||alt="1654746646379-591.png"]]
732
733
734 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746549277-209.png?rev=1.1||alt="1654746549277-209.png"]]
735
736
737 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746593411-887.png?rev=1.1||alt="1654746593411-887.png"]]
738
739
740 == 2.7 Frequency Plans ==
741
742
743 The DS03A-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
744
745 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
746
747
748 == 2.8 ​Firmware Change Log ==
749
750
751 **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
752
753
754 = 3. Configure DS03A-LB =
755
756 == 3.1 Configure Methods: ==
757
758
759 DS03A-LB supports below configure method:
760
761 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
762 * 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]].
763 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
764
765 == 3.2 General Commands ==
766
767
768 These commands are to configure:
769
770 * General system settings like: uplink interval.
771 * LoRaWAN protocol & radio related command.
772
773 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
774
775 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
776
777
778 == 3.3 Commands special design for DS03A-LB ==
779
780
781 These commands only valid for DS03A-LB, as below:
782
783
784 === 3.3.1  Set Transmit Interval Time ===
785
786
787 Feature: Change LoRaWAN End Node Transmit Interval.
788
789 (% style="color:blue" %)**AT Command: AT+TDC**
790
791 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
792 |=(% 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**
793 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
794 30000
795 OK
796 the interval is 30000ms = 30s
797 )))
798 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
799 OK
800 Set transmit interval to 60000ms = 60 seconds
801 )))
802
803 (% style="color:blue" %)**Downlink Command: 0x01**
804
805 Format: Command Code (0x01) followed by 3 bytes time value.
806
807 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
808
809 * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
810 * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
811
812 === 3.3.2  Set Power Output Duration ===
813
814
815 Control the output duration 5V . Before each sampling, device will
816
817 ~1. first enable the power output to external sensor,
818
819 2. keep it on as per duration, read sensor value and construct uplink payload
820
821 3. final, close the power output.
822
823 (% style="color:blue" %)**AT Command: AT+5VT**
824
825 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
826 |=(% 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**
827 |(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
828 OK
829 |(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
830 OK
831
832 )))
833
834 (% style="color:blue" %)**Downlink Command: 0x07**(%%)
835 Format: Command Code (0x07) followed by 2 bytes.
836
837 The first and second bytes are the time to turn on.
838
839 * Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
840 * Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
841
842 === 3.3.3  Enable / Disable Alarm ===
843
844
845 Feature: Enable/Disable Alarm for open/close event. Default value 0.
846
847 (% style="color:blue" %)**AT Command: **
848
849 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
850 |(% 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**
851 |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
852 |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
853
854 (% style="color:blue" %)**Downlink Command: **
855
856 0xA7 01  ~/~/ Same As AT+DISALARM=1
857
858 0xA7 00  ~/~/ Same As AT+DISALARM=0
859
860
861 === 3.3.4  Alarm Base on Timeout ===
862
863
864 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:
865
866 * (((
867 (% style="color:blue" %)**Keep Status: Status to be monitor**
868 )))
869
870 (% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
871
872 (% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
873
874
875 * (((
876 (% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
877 )))
878
879 Range 0 ~~ 65535(0xFFFF) seconds.
880
881 If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
882
883 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.
884
885
886 * (((
887 (% style="color:blue" %)**Downlink Command**
888 )))
889
890 (% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
891
892 **A9:** Command Type Code
893
894 **aa: **01:TTRIG1; 02:TTRIG2
895
896 **bb:** status to be monitored
897
898 **cc dd:** timeout.
899
900
901 **1) AT+TTRIG1 : (PA8 of pin)**
902
903 (% style="color:blue" %)**AT Command to configure:**
904
905 * (((
906 (% 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.
907
908 (% 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.
909 )))
910
911 * (((
912 (% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
913
914
915
916 )))
917
918 (% style="color:blue" %)**Downlink Command to configure:**
919
920 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.
921
922
923 **2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
924
925 (% style="color:blue" %)**AT Command to configure:**
926
927 * (((
928 (% 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.
929
930 (% 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.
931 )))
932
933 * (((
934 (% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
935
936
937
938 )))
939
940 (% style="color:blue" %)**Downlink Command to configure:**
941
942 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.
943
944
945 === 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
946
947
948 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.
949
950 (% style="color:blue" %)**AT Command:**
951
952 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
953 |=(% 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**
954 |(% style="width:155px" %)(((
955 AT+TTRALARM=0
956 )))|(% style="width:279px" %)(((
957 disable continuous alarm
958 )))|(% style="width:84px" %)(((
959 OK
960 )))
961 |(% style="width:155px" %)(((
962 AT+TTRALARM=60
963 )))|(% style="width:279px" %)(((
964 The alarm interval is 60 minutes (unit: minutes)
965 )))|(% style="width:84px" %)(((
966 OK
967 )))
968
969 (% style="color:blue" %)**Downlink Command:**
970
971 Example:  0C aa  => AT+TTRALARM= aa
972
973
974 === 3.3.6  Count Mod ===
975
976
977 Feature: Manually set the count mode.
978
979 (% style="color:blue" %)**AT Command:**
980
981 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
982 |=(% 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**
983 |(% style="width:155px" %)(((
984 AT+COUNTMOD=0
985 )))|(% style="width:277px" %)(((
986 the count value keeps accumulating mode
987 )))|(% style="width:86px" %)(((
988 OK
989 )))
990 |(% style="width:155px" %)(((
991 AT+COUNTMOD=1
992 )))|(% style="width:277px" %)(((
993 the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
994 )))|(% style="width:86px" %)(((
995 OK
996 )))
997
998 (% style="color:blue" %)**Downlink Command:**
999
1000 Example:  0B aa  => AT+COUNTMOD = second byte
1001
1002
1003 === 3.3.7  Number of channel of door sensors ===
1004
1005
1006 Feature: Set the number of door sensor channels.
1007
1008 (% style="color:blue" %)**AT Command:**
1009
1010 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1011 |=(% 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**
1012 |(% style="width:155px" %)(((
1013 AT+TTRCHANNEL=1
1014 )))|(% style="width:259px" %)(((
1015 Set as single channel, only use PA8 pin as interrupt pin.
1016 )))|(% style="width:44px" %)(((
1017 OK
1018 )))
1019 |(% style="width:155px" %)(((
1020 AT+TTRCHANNEL=2
1021 )))|(% style="width:259px" %)(((
1022 Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1023 )))|(% style="width:44px" %)(((
1024 OK
1025 )))
1026
1027 (% style="color:blue" %)**Downlink Command:**
1028
1029 Example:  0D aa => AT+TTRCHANNEL = second byte
1030
1031
1032 === 3.3.8  Set Time Sync Mode ===
1033
1034
1035 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1036
1037 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.
1038
1039 (% style="color:blue" %)**AT Command:**
1040
1041 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1042 |=(% 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**
1043 |(% style="width:155px" %)(((
1044 AT+SYNCMOD=1
1045 )))|(% style="width:259px" %)(((
1046 Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1047 )))|(% style="width:44px" %)(((
1048 OK
1049 )))
1050 |(% style="width:155px" %)(((
1051 AT+SYNCMOD=1,8
1052 )))|(% style="width:259px" %)(((
1053 Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1054 )))|(% style="width:44px" %)(((
1055 OK
1056 )))
1057 |(% 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
1058
1059 (% style="color:blue" %)**Downlink Command:**
1060
1061 0x28 01  ~/~/ Same As AT+SYNCMOD=1
1062
1063 0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1064
1065 0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
1066
1067 0x28 00  ~/~/ Same As AT+SYNCMOD=0
1068
1069
1070 === 3.3.9  Clear the open door times and the duration of the last open door ===
1071
1072
1073 (% style="color:blue" %)**AT Command:**
1074
1075 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1076 |=(% 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**
1077 |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1078 OK
1079 )))
1080
1081 (% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1082
1083 The sensor will clear the open door times and the duration of the last open door.
1084
1085
1086 === 3.3.10  Set the count value of the number of open door ===
1087
1088
1089 (% style="color:blue" %)**AT Command:**
1090
1091 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1092 |=(% 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**
1093 |(% style="width:155px" %)(((
1094 AT+SETCNT=1,100
1095 )))|(% style="width:259px" %)(((
1096 Set the open door times of PA8 pin to 100 times.
1097 )))|(% style="width:44px" %)(((
1098 OK
1099 )))
1100 |(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1101 |(% style="width:155px" %)(((
1102 AT+SETCNT=2,50
1103 )))|(% style="width:259px" %)(((
1104 Set the open door times of PA4 pin to 100 times.
1105 )))|(% style="width:44px" %)(((
1106 OK
1107 )))
1108
1109 (% style="color:blue" %)**Downlink Command:**
1110
1111 0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1112
1113 0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1114
1115 0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1116
1117
1118 = 4. Battery & Power Consumption =
1119
1120
1121 DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1122
1123 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1124
1125
1126 = 5. OTA firmware update =
1127
1128
1129 User can change firmware DS03A-LB to:
1130
1131 * Change Frequency band/ region.
1132 * Update with new features.
1133 * Fix bugs.
1134
1135 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1136
1137 Methods to Update Firmware:
1138
1139 * (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/]]**
1140 * 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]]**.
1141
1142 = 6. FAQ =
1143
1144
1145
1146 = 7. Order Info =
1147
1148
1149 Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1150
1151 (% style="color:red" %)**XX**(%%): The default frequency band
1152
1153 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1154
1155 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1156
1157 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
1158
1159 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
1160
1161 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
1162
1163 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1164
1165 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1166
1167 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1168
1169 = 8. ​Packing Info =
1170
1171
1172 (% style="color:#037691" %)**Package Includes**:
1173
1174 * DS03A-LB LoRaWAN Temperature Sensor
1175
1176 (% style="color:#037691" %)**Dimension and weight**:
1177
1178 * Device Size: cm
1179
1180 * Device Weight: g
1181
1182 * Package Size / pcs : cm
1183
1184 * Weight / pcs : g
1185
1186 = 9. Support =
1187
1188
1189 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1190
1191 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].