Version 37.4 by Xiaoling on 2022/06/08 17:31
Show last authors
1 (% style="text-align:center" %)
2 [[image:1654679359875-169.png]]
3
4
5 **Contents:**
6
7 {{toc/}}
8
9
10
11
12
13 = 1. Introduction =
14
15 == 1.1 What is LDS02 LoRaWAN Door Sensor ==
16
17
18 (((
19 The Dragino LDS02 is a (% style="color:#037691" %)**LoRaWAN Door Sensor**(%%). It detects door open/close status and uplink to IoT server via LoRaWAN network. user can see the door status, open time, open counts in the IoT Server.
20
21 LDS02 is powered by (% style="color:#037691" %)**2 x AAA batteries**(%%) and target for long time use, these two batteries can provide about 16,000 ~~ 70,000 uplink packets. After battery running out, user can easily open the enclosure and replace with 2 common AAA batteries.
22
23 The LDS02 will send periodically data every day as well as for each door open/close action. It also (% style="color:#037691" %)**counts the door open times**(%%) and (% style="color:#037691" %)**calculate last door open duration**(%%). User can also disable the uplink for each open/close event, instead, device can count each open event and uplink periodically.
24
25 LDS02 has the (% style="color:#037691" %)**open alarm feature**(%%), user can set this feature so device will send Alarm if the door has been open for a certain time.
26
27 Each LDS02 is (% style="color:#037691" %)**pre-load with a set of unique keys**(%%) for LoRaWAN registration, register these keys to LoRaWAN server and it will auto connect after power on.
28 )))
29
30 [[image:image-20220608171947-2.png]]
31
32
33
34 == 1.2 Features ==
35
36 * LoRaWAN Class A v1.0.3
37 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
38 * SX1262 LoRa Core
39 * Water Leak detect
40 * 2 x AAA LR03 Batteries
41 * AT Commands to change parameters
42 * Uplink on periodically and open/close action
43 * Remote configure parameters via LoRa Downlink
44 * Firmware upgradable via program port
45
46
47 == 1.3 Applications ==
48
49 * Smart Buildings & Home Automation
50 * Logistics and Supply Chain Management
51 * Smart Metering
52 * Smart Agriculture
53 * Smart Cities
54 * Smart Factory
55
56
57 == 1.4 Dimension ==
58
59 Unit: mm
60
61 [[image:1654680563545-120.png]]
62
63
64 [[image:1654680510816-654.png]]
65
66
67 == 1.5 Firmware Change log ==
68
69 (((
70 (((
71 LDS02 use the same firmware as LDS01.
72 )))
73
74 (((
75 [[LDS02 Image files – Download link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Firmware/]]
76 )))
77 )))
78
79
80 = 2. Power ON LDS02 =
81
82 When receive the LDS02, please open the enclosure and add 2 x AAA batteries to power it. The [[LED>>||anchor="H4.7LEDs"]] will blink when device is powered.
83
84
85 = 3. How to install LDS02 =
86
87 (((
88 (((
89 When install the LDS02 on wall. Please make sure install as below so the marks will close to each other when close the door.
90 )))
91
92 (((
93 Open/Close threshold range: ~~ 25mm
94 )))
95 )))
96
97
98
99
100 = 4. Operation Mode =
101
102 == 4.1 How it works? ==
103
104 (((
105 The LWL02 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join network. To connect a local LoRaWAN network, user just need to input the OTAA keys in the network server and [[power on>>||anchor="H2.PowerONLWL02"]] the LWL02. It will auto join the network via OTAA.
106 )))
107
108 (((
109 In case user can’t set the OTAA keys in the network server and has to use the existing keys from server. User can [[use AT Command>>||anchor="H6.UseATCommand"]] to set the keys in the devices.
110 )))
111
112
113 == 4.2 Example to join LoRaWAN network ==
114
115 Here shows an example for how to join the [[TTN V3 Network>>url:https://eu1.cloud.thethings.network/]]. Below is the network structure, we use [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]] as LoRaWAN gateway here. 
116
117 [[image:1654671007127-335.png]]
118
119
120 (((
121 The LWL02 has water leak detect probe as above. When there is water between these two detect probe, they will be short and generate the water leak event. and send the status to LoRaWAN server. The LWL02 will uplink two type of messages to the server.
122 )))
123
124 * (((
125 A keep-alive message which send once per day.
126 )))
127 * (((
128 An emergency event message when detect a water leak. ([[Alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]])
129 )))
130 * (((
131 A periodically update at every 10 minutes when in water leak.
132 )))
133 * (((
134 A message when switch from water leak to none water leak. ([[Alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]])
135 )))
136
137 (((
138
139
140 The LG308 is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. What we need to now is only configure the TTN V3:
141 )))
142
143 (((
144 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from LWL02.
145 )))
146
147 (((
148 Each LWL02 is shipped with a sticker with unique device EUI:
149 )))
150
151 [[image:1654671040430-368.png]]
152
153
154 User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
155
156 **Add APP EUI in the application**
157
158 [[image:1654671794691-956.png]]
159
160
161 [[image:1654671809850-574.png]]
162
163 [[image:1654671820156-640.png]]
164
165
166 [[image:1654671832011-696.png]]
167
168
169 **Add APP KEY and DEV EUI**
170
171
172 (% style="color:blue" %)**Step 2**(%%): **[[Power on>>||anchor="H2.PowerONLWL02"]]** LWL02 and it will auto join to the TTN V3 network. After join success, it will start to upload message to TTN V3 and user can see in the panel.
173
174 [[image:1654671889112-678.png]]
175
176
177 == 4.3 Uplink Payload ==
178
179
180 Uplink Payload total 9 bytes.
181
182 [[image:image-20220608150921-5.png]]
183
184
185 **Example:**
186
187 [[image:1654672186477-234.png]]
188
189
190 (((
191 Example Payload Decoder in TTN V3: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Payload/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Payload/]]
192 )))
193
194
195 == 4.4 Downlink Payload ==
196
197
198 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:410px" %)
199 |=(% style="width: 180px;" %)**Downlink Control Type**|=(% style="width: 80px;" %)**Type Code**|=(% style="width: 150px;" %)**Downlink payload size(bytes)**
200 |(% style="width:180px" %)TDC (Transmit Time Interval—Keep Alive Interval)|(% style="width:80px" %)0x01|(% style="width:150px" %)4
201 |(% style="width:180px" %)RESET|(% style="width:80px" %)0x04|(% style="width:224px" %)2
202 |(% style="width:180px" %)[[Set confirmed mode>>||anchor="HTypeCode0x05"]]|(% style="width:80px" %)0x05|(% style="width:150px" %)2
203 |(% style="width:180px" %)[[Clear Counting>>||anchor="HTypeCode0xA6"]]|(% style="width:80px" %)0xA6|(% style="width:150px" %)2
204 |(% style="width:180px" %)[[Enable/Disable Alarm>>||anchor="HTypeCode0xA7"]]|(% style="width:80px" %)0xA7|(% style="width:150px" %)2
205 |(% style="width:180px" %)[[Control ADR/DR>>||anchor="HTypeCode0xA8"]]|(% style="width:80px" %)0xA8|(% style="width:150px" %)3
206 |(% style="width:180px" %)[[Set Alarm Timeout>>||anchor="HTypeCode0xA9"]]|(% style="width:80px" %)0xA9|(% style="width:150px" %)4
207
208 Example Downlink payload setting in TTN V3:
209
210 [[image:1654673412319-976.png]]
211
212
213 === (% style="color:#037691" %)**Type Code 0x01**(%%) ===
214
215 If the payload=0100003C, means to control the LWL02’s Keep Alive interval to 0x00003C=60(S)
216
217
218 === (% style="color:#037691" %)**Type Code 0x04**(%%) ===
219
220 If payload = 0x04FF, it will reset the LWL02.
221
222
223 === (% style="color:#037691" %)**Type Code 0x05**(%%) ===
224
225 0x05 00: Set uplink to LoRaWAN unconfirmed mode
226
227 0x05 01: Set uplink to LoRaWAN confirmed mode
228
229
230 === (% style="color:#037691" %)**Type Code 0xA6**(%%) ===
231
232 Example: 0xA601: Clear Counting
233 For LWL02: reset both count number and time.
234
235
236 === (% style="color:#037691" %)**Type Code 0xA7**(%%) ===
237
238 0xA7 01 : Equal to AT+DISALARM=1
239
240 0xA7 00 : Equal to AT+DISALARM=0
241
242
243 === (% style="color:#037691" %)**Type Code 0xA8**(%%) ===
244
245 Format: 0xA8 aa bb
246
247 aa: 1: Enable ADR; 0: Disable ADR (Same as AT+CADR command)
248
249 bb: set DR (Same as AT+CDATARATE ,only valid after ADR=0)
250
251 Example: 0x A8 00 02 : Set ADR=0 and DR=1
252
253
254 === (% style="color:#037691" %)**Type Code 0xA9**(%%) ===
255
256 See [[Alarm Base Timeout>>||anchor="H4.6AlarmBaseonTimeout"]] for detail.
257
258
259 == 4.5 Integrate with Datacake ==
260
261 (((
262 Datacake provides a human friendly interface to show the sensor data, once we have data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
263 )))
264
265
266 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
267
268 (% style="color:blue" %)**Step 2**(%%): To configure the Application to forward data to Datacake you will need to add integration. To add the Datacake integration, perform the following steps:
269
270
271 [[image:1654674520913-519.png]]
272
273
274 [[image:1654674530910-914.png]]
275
276
277 [[image:1654674543078-401.png]]
278
279
280 (% style="color:blue" %)**Step 3**(%%): Create an account or log in Datacake.
281
282 (% style="color:blue" %)**Step 4**(%%): Search LWL02 and add DevEUI.
283
284 [[image:1654674556510-911.png]]
285
286
287 == 4.6 Alarm Base on Timeout ==
288
289 (((
290 LWL02 can monitor the timeout for a status change, this feature can be used to monitor some event such as open fridge too long etc.
291 )))
292
293 (((
294 User configure this feature by using:
295 )))
296
297 (((
298
299 )))
300
301 (((
302 (% style="color:blue" %)**AT Command**(%%) to configure:
303 )))
304
305 * (((
306 **AT+TTRIG=1,30 ** **~-~->** When status change from close to open, and device keep in open
307 )))
308
309 (((
310 status for more than 30 seconds. LWL02 will send an uplink packet, the Alarm bit (the lowest bit of 10^^th^^ byte of payload) on this uplink packet is set to 1.
311 )))
312
313 * (((
314 **AT+TTIG=0,0**  **~-~->**  Default Value, disable timeout Alarm.
315 )))
316
317 (((
318 (% style="color:blue" %)**Downlink Command**(%%) to configure:
319 )))
320
321 (((
322 **Command: 0xA9 aa bb cc**
323 )))
324
325 (((
326 A9: Command Type Code
327 )))
328
329 (((
330 aa: status to be monitor
331 )))
332
333 (((
334 bb cc: timeout.
335 )))
336
337 (((
338
339 )))
340
341 (((
342 If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
343 )))
344
345 (((
346 Or
347 )))
348
349 (((
350 0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
351 )))
352
353
354
355 == 4.7 LEDs ==
356
357
358 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:463px" %)
359 |=(% style="width: 184px;" %)**Action**|=(% style="width: 275px;" %)**LED behavior**
360 |(% style="width:184px" %)Power On|(% style="width:275px" %)(% style="color:green" %)**GREEN on 1s, **(% style="color:red" %)**RED on 1s,**(%%)** (% style="color:blue" %)BLUE on 1s(%%)**
361 |(% style="width:184px" %)Joined successful|(% style="width:275px" %)(% style="color:green" %)**GRENN LED **(%%)on 5s
362 |(% style="width:184px" %)Send an uplink message|(% style="width:275px" %)(% style="color:green" %)**GREEN LED**(%%) blinks once
363 |(% style="width:184px" %)Got a downlink message|(% style="width:275px" %)(% style="color:blue" %)**BLUE LED**(%%) blinks once
364
365 = 5. Battery & How to replace =
366
367 == 5.1 Battery Type and replace ==
368
369 (((
370 LWL02 is equipped with 2 x AAA LR03 batteries. If the batteries running low(see 2.1v in the platform). User can buy generic AAA battery and replace it. Note:
371 )))
372
373 1. (((
374 The LWL02 doesn’t have any screw, use can use nail to open it by the middle.
375 )))
376 1. (((
377 Make sure the direction is correct when install the AAA batteries.
378 )))
379
380 (((
381 (% style="color:red" %)**Important Notice: Make sure use new AAA LR03 battery and the battery doesn’t have broken surface.**
382 )))
383
384 (((
385
386 )))
387
388 (((
389 Example of AAA LR03 batter:
390 )))
391
392 [[image:1654675278044-307.png]]
393
394
395 == 5.2 Power Consumption Analyze ==
396
397 (((
398 Dragino battery powered products are all run in Low Power mode. User can check the guideline from this link to calculate the estimate battery life:
399 )))
400
401 (((
402 [[https:~~/~~/www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf]]
403 )))
404
405
406 = 6. Use AT Command =
407
408 == 6.1 Access AT Command ==
409
410 LWL02 supports AT Command set. User can use a USB to TTL adapter to configure LWL02 via use AT command, as below.
411
412 [[image:image-20220608160336-1.png]]
413
414
415 (% style="background-color:yellow" %)**USB to TTL <- -> LWL02**
416
417 (% style="background-color:yellow" %)**RX <- -> TX**
418
419 (% style="background-color:yellow" %)**TX <- -> RX**
420
421 (% style="background-color:yellow" %)**GND <- -> GND**
422
423
424 (((
425 In PC, User needs to set (% style="color:#037691" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**115200**(%%) to access to access serial console of LWL02. Below is the output for reference:
426 )))
427
428 (((
429 The AT Access password is (% style="color:red" %)**123456**.
430 )))
431
432 [[image:1654675618022-630.png]]
433
434 (((
435 Each AT Command need to (% style="color:red" %)**add an ENTER**(%%) at the end before send.
436 )))
437
438 (((
439 When entering the first command, the (% style="color:red" %)**RED LED**(%%) will on and user can now input AT Commands. After input all needed AT Commands, please input AT+CLPM=1 to set the device to work in Low Power mode and (% style="color:red" %)**RED LED**(%%) will be off.
440 )))
441
442 (((
443 More detail AT Command manual can be found at [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/]]
444 )))
445
446
447 = 7. FAQ =
448
449 == 7.1 How to upgrade the image? ==
450
451 User can upgrade the of LWL02 for bug fix, new features, or change working region. The upgrade instruction is here: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
452
453
454 == 7.2 How to change the LoRa Frequency Bands/Region? ==
455
456 If user has for example US915 frequency and want to change it to AS923 frequency. User can follow the introduction for [[how to upgrade image>>||anchor="H7.1Howtoupgradetheimage3F"]]. When download the images, choose the required image file for download.
457
458
459 == 7.3 Can I disable uplink for each event to save battery life? ==
460
461 Yes, User can use below method to disable this:
462
463 (% style="color:#4f81bd" %)**via AT Command**:
464
465 AT+DISALARM=1, End node will only send packet in TDC time.
466
467 AT+DISALARM=0, End node will send packet in TDC time or status change for door sensor. 
468
469 (% style="color:#4f81bd" %)**via LoRaWAN downlink Command**:
470
471 0xA701 : Equal to AT+DISALARM=1
472
473 0xA700 : Equal to AT+DISALARM=0
474
475
476 = 8. Order Info =
477
478 **Part Number: (% style="color:blue" %)LWL02-XXX(%%)**
479
480 (% style="color:blue" %)**XXX:**
481
482 * (% style="color:red" %)**EU433**(%%): frequency  bands EU433
483 * (% style="color:red" %)**EU868**(%%): frequency  bands EU868
484 * (% style="color:red" %)**KR920**(%%): frequency  bands KR920
485 * (% style="color:red" %)**CN470**(%%): frequency bands CN470
486 * (% style="color:red" %)**AS923**(%%): frequency  bands AS923
487 * (% style="color:red" %)**AU915**(%%): frequency bands AU915
488 * (% style="color:red" %)**US915**(%%): frequency bands  US915
489 * (% style="color:red" %)**IN865**(%%):  frequency bands  IN865
490 * (% style="color:red" %)**CN779**(%%): frequency bands CN779
491
492 = 9. Packing Info =
493
494 **Package Includes**:
495
496 * LWL02 x 1
497
498 = 10. Support =
499
500 * 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.
501 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0