Version 54.2 by Xiaoling on 2022/12/26 16:36
Show last authors
1 (% style="text-align:center" %)
2 [[image:1654679359875-169.png]]
3
4
5
6
7
8
9
10
11
12
13 **Table of Contents:**
14
15 {{toc/}}
16
17
18
19
20
21
22
23
24 = 1. Introduction =
25
26 == 1.1 What is LDS02 LoRaWAN Door Sensor ==
27
28
29 (((
30 (((
31 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.
32 )))
33
34 (((
35 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.
36 )))
37
38 (((
39 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.
40 )))
41
42 (((
43 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.
44 )))
45
46 (((
47 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.
48
49
50 )))
51 )))
52
53 [[image:image-20220608171947-2.png]]
54
55
56 == 1.2 Features ==
57
58
59 * LoRaWAN Class A v1.0.3
60 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
61 * SX1262 LoRa Core
62 * Water Leak detect
63 * 2 x AAA LR03 Batteries
64 * AT Commands to change parameters
65 * Uplink on periodically and open/close action
66 * Remote configure parameters via LoRa Downlink
67 * Firmware upgradable via program port
68
69
70
71 == 1.3 Applications ==
72
73
74 * Smart Buildings & Home Automation
75 * Logistics and Supply Chain Management
76 * Smart Metering
77 * Smart Agriculture
78 * Smart Cities
79 * Smart Factory
80
81
82
83 == 1.4 Dimension ==
84
85
86 Unit: mm
87
88 [[image:1654680563545-120.png]]
89
90
91 [[image:1654680510816-654.png]]
92
93
94 == 1.5 Firmware Change log ==
95
96
97 (((
98 (((
99 LDS02 use the same firmware as LDS01：[[LDS02 Image files – Download link>>https://www.dropbox.com/sh/9j35mnsxnz0y3ye/AACj5gHGOURGEHCpj-E861Mua?dl=0]]
100 )))
101 )))
102
103
104 = 2. Power ON LDS02 =
105
106
107 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.
108
109
110 = 3. How to install LDS02 =
111
112
113 (((
114 (((
115 When install the LDS02 on wall. Please make sure install as below so the marks will close to each other when close the door.
116 )))
117
118 (((
119 Open/Close threshold range: ~~ 10mm
120
121
122 )))
123 )))
124
125 [[image:1654680716522-793.png]]
126
127
128
129 = 4. Operation Mode =
130
131 == 4.1 How it works? ==
132
133
134 (((
135 The LDS02 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.PowerONLDS02"]] the LDS02. It will auto join the network via OTAA.
136 )))
137
138 (((
139 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.
140 )))
141
142
143 == 4.2 Example to join LoRaWAN network ==
144
145
146 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. 
147
148 [[image:1654680810108-149.png]]
149
150
151 (((
152 The LDS02 in installed on the door edge to detect the open / close event. And send the status to LoRaWAN server. The LDS02 will uplink two type of messages to the server.
153 )))
154
155 * (((
156 A keep-alive message which send once per day.
157 )))
158 * (((
159 A door event message when there is a door open/close. ([[Alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]])
160 )))
161
162 (((
163
164
165 (((
166 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:
167
168
169 )))
170 )))
171
172 (((
173 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from LDS02.
174 )))
175
176 (((
177 Each LDS02 is shipped with a sticker with unique device EUI:
178 )))
179
180 [[image:1654671040430-368.png]]
181
182
183 User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
184
185
186 **Add APP EUI in the application**
187
188 [[image:1654671794691-956.png]]
189
190
191 [[image:1654671809850-574.png]]
192
193 [[image:1654671820156-640.png]]
194
195
196 [[image:1654681258096-500.png]]
197
198
199
200 **Add APP KEY and DEV EUI**
201
202 [[image:1654671889112-678.png]]
203
204
205
206 (((
207 (% style="color:blue" %)**Step 2**(%%):  **[[Power on>>||anchor="H2.PowerONLDS02"]]** LDS02 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.
208 )))
209
210
211 [[image:1654681390551-993.png]]
212
213
214 == 4.3 Uplink Payload ==
215
216
217 Uplink Payload total 10 bytes.
218
219 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:480px" %)
220 |=(% style="width: 80px;" %)**Size(bytes)**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %)**3**|=(% style="width: 80px;" %)**3**|=(% style="width: 80px;" %)**1**
221 |**value**|Status&BAT|(((
222 MOD
223 Always:0x01
224 )))|Total open door events|(((
225 Last door open
226 duration (unit: min)
227 )))|[[Alarm>>||anchor="H4.6AlarmBaseonTimeout"]]
228
229 **Example:**
230
231 [[image:1654681706301-731.png]]
232
233 [[image:1654681714641-440.png]]
234
235
236 (((
237 Example Payload Decoder in TTN V3: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
238
239
240 )))
241
242 == 4.4 Downlink Payload ==
243
244
245 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:505px" %)
246 |=(% style="width: 180px;" %)**Downlink Control Type**|=(% style="width: 94px;" %)**Type Code**|=(% style="width: 226px;" %)**Downlink payload size(bytes)**
247 |(% style="width:180px" %)TDC (Transmit Time Interval—Keep Alive Interval)|(% style="width:94px" %)0x01|(% style="width:226px" %)4
248 |(% style="width:180px" %)RESET|(% style="width:94px" %)0x04|(% style="width:226px" %)2
249 |(% style="width:180px" %)[[Set confirmed mode>>||anchor="HTypeCode0x05"]]|(% style="width:94px" %)0x05|(% style="width:226px" %)2
250 |(% style="width:180px" %)[[Clear Counting>>||anchor="HTypeCode0xA6"]]|(% style="width:94px" %)0xA6|(% style="width:226px" %)2
251 |(% style="width:180px" %)[[Enable/Disable Alarm>>||anchor="HTypeCode0xA7"]]|(% style="width:94px" %)0xA7|(% style="width:226px" %)2
252 |(% style="width:180px" %)[[Control ADR/DR>>||anchor="HTypeCode0xA8"]]|(% style="width:94px" %)0xA8|(% style="width:226px" %)3
253 |(% style="width:180px" %)[[Set Alarm Timeout>>||anchor="HTypeCode0xA9"]]|(% style="width:94px" %)0xA9|(% style="width:226px" %)4
254
255 Example Downlink payload setting in TTN V3:
256
257 [[image:1654673412319-976.png]]
258
259
260 === (% style="color:#037691" %)**Type Code 0x01**(%%) ===
261
262 If the payload=0100003C, means to control the LDS02’s Keep Alive interval to 0x00003C=60(S)
263
264
265 === (% style="color:#037691" %)**Type Code 0x04**(%%) ===
266
267 If payload = 0x04FF, it will reset the LDS02.
268
269
270 === (% style="color:#037691" %)**Type Code 0x05**(%%) ===
271
272 (((
273 0x05 00: Set uplink to LoRaWAN unconfirmed mode
274 )))
275
276 (((
277 0x05 01: Set uplink to LoRaWAN confirmed mode
278 )))
279
280
281 === (% style="color:#037691" %)**Type Code 0xA6**(%%) ===
282
283 (((
284 Example: 0xA601: Clear Counting
285 For LDS02: reset both count number and time.
286 )))
287
288
289 === (% style="color:#037691" %)**Type Code 0xA7**(%%) ===
290
291 (((
292 0xA7 01 : Equal to AT+DISALARM=1
293 )))
294
295 (((
296 0xA7 00 : Equal to AT+DISALARM=0
297 )))
298
299
300 === (% style="color:#037691" %)**Type Code 0xA8**(%%) ===
301
302 (((
303 Format: 0xA8 aa bb
304 )))
305
306 (((
307 aa: 1: Enable ADR; 0: Disable ADR (Same as AT+CADR command)
308 )))
309
310 (((
311 bb: set DR (Same as AT+CDATARATE ,only valid after ADR=0)
312 )))
313
314 (((
315 Example: 0x A8 00 02 : Set ADR=0 and DR=1
316 )))
317
318
319 === (% style="color:#037691" %)**Type Code 0xA9**(%%) ===
320
321 See [[Alarm Base Timeout>>||anchor="H4.6AlarmBaseonTimeout"]] for detail.
322
323
324 == 4.5 Integrate with Datacake ==
325
326
327 (((
328 (((
329 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:
330 )))
331 )))
332
333 (((
334
335 )))
336
337 (((
338 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
339 )))
340
341 (((
342 (% 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:
343 )))
344
345
346 [[image:1654674520913-519.png]]
347
348
349 [[image:1654674530910-914.png]]
350
351
352 [[image:1654674543078-401.png]]
353
354
355 (% style="color:blue" %)**Step 3**(%%): Create an account or log in Datacake.
356
357 (% style="color:blue" %)**Step 4**(%%): Search LDS02 and add DevEUI.
358
359 [[image:1654674556510-911.png]]
360
361
362 == 4.6 Alarm Base on Timeout ==
363
364
365 (((
366 (((
367 LDS02 can monitor the timeout for a status change, this feature can be used to monitor some event such as open fridge too long etc.
368 )))
369
370 (((
371 User configure this feature by using:
372 )))
373 )))
374
375 (((
376 (((
377
378 )))
379 )))
380
381 (((
382 (((
383 (% style="color:blue" %)**AT Command**(%%) **to configure:**
384 )))
385 )))
386
387 * (((
388 (((
389 (% style="color:red" %)**AT+TTRIG=1,30 ** (%%) **~-~->** When status change from close to open, and device keep in open
390 )))
391 )))
392
393 (((
394 (((
395 status for more than 30 seconds. LDS02 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.
396 )))
397 )))
398
399 * (((
400 (((
401 (% style="color:red" %)**AT+TTRIG=0,0** (%%) **~-~->**  Default Value, disable timeout Alarm.
402 )))
403 )))
404
405 (((
406 (((
407
408
409 (% style="color:blue" %)**Downlink Command**(%%) **to configure:**
410 )))
411 )))
412
413 (((
414 (((
415 **Command: (% style="color:red" %)0xA9 aa bb cc(%%)**
416 )))
417 )))
418
419 (((
420 (((
421 A9: Command Type Code
422 )))
423 )))
424
425 (((
426 (((
427 aa: status to be monitor
428 )))
429 )))
430
431 (((
432 (((
433 bb cc: timeout.
434 )))
435 )))
436
437 (((
438 (((
439
440 )))
441 )))
442
443 (((
444 (((
445 If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
446 )))
447 )))
448
449 (((
450 (((
451 Or
452 )))
453 )))
454
455 (((
456 (((
457 0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
458 )))
459 )))
460
461
462 == 4.7 LEDs ==
463
464
465 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:463px" %)
466 |=(% style="width: 184px;" %)**Action**|=(% style="width: 275px;" %)**LED behavior**
467 |(% 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(%%)**
468 |(% style="width:184px" %)Joined successful|(% style="width:275px" %)(% style="color:green" %)**GRENN LED **(%%)on 5s
469 |(% style="width:184px" %)Send an uplink message|(% style="width:275px" %)(% style="color:green" %)**GREEN LED**(%%) blinks once
470 |(% style="width:184px" %)Got a downlink message|(% style="width:275px" %)(% style="color:blue" %)**BLUE LED**(%%) blinks once
471
472
473
474 = 5. Battery & How to replace =
475
476 == 5.1 Battery Type and replace ==
477
478
479 (((
480 LDS02 is equipped with 2 x AAA LR03 batteries. If the batteries running low (shows 2.1v in the platform). User can buy generic AAA battery and replace it.
481
482
483 (% style="color:red" %)**Note:**
484
485 1. The LDS02 doesn't have any screw, use can use nail to open it by the middle.
486 1. Make sure the direction is correct when install the AAA batteries.
487 )))
488
489 (((
490 (% style="color:red" %)**Important Notice: Make sure use new AAA LR03 battery and the battery doesn't have broken surface.**
491 )))
492
493 (((
494
495 )))
496
497 (((
498 Example of AAA LR03 batter:
499 )))
500
501 [[image:1654675278044-307.png]]
502
503
504 == 5.2 Power Consumption Analyze ==
505
506
507 (((
508 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:
509 )))
510
511 (((
512 [[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]]
513 )))
514
515
516 = 6. Use AT Command =
517
518 == 6.1 Access AT Command ==
519
520
521 LDS02 supports AT Command set. User can use a USB to TTL adapter to configure LDS02 via use AT command, as below.
522
523
524 [[image:image-20221226104705-1.png||height="572" width="872"]]
525
526
527 (((
528 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 LDS02. Below is the output for reference:
529 )))
530
531 (((
532 The AT Access password is (% style="color:red" %)**123456**.
533 )))
534
535 [[image:1654675618022-630.png]]
536
537
538 (((
539 Each AT Command need to (% style="color:red" %)**add an ENTER**(%%) at the end before send.
540 )))
541
542 (((
543 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.
544 )))
545
546 (((
547 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/]]
548 )))
549
550
551 = 7. FAQ =
552
553 == 7.1 How to upgrade the image? ==
554
555
556 User can upgrade the of LDS02 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]]
557
558
559 == 7.2 How to change the LoRa Frequency Bands/Region? ==
560
561
562 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.
563
564
565 == 7.3 Can I disable uplink for each event to save battery life? ==
566
567
568 Yes, User can use below method to disable this:
569
570
571 (% style="color:blue" %)**via AT Command**:
572
573 (% style="color:red" %)**AT+DISALARM=1**(%%), End node will only send packet in TDC time.
574
575 (% style="color:red" %)**AT+DISALARM=0**(%%), End node will send packet in TDC time or status change for door sensor. 
576
577
578 (% style="color:blue" %)**via LoRaWAN downlink Command**:
579
580 (% style="color:red" %)**0xA701**(%%) : Equal to AT+DISALARM=1
581
582 (% style="color:red" %)**0xA700**(%%) : Equal to AT+DISALARM=0
583
584
585 == 7.4 How to change Sub-Band for LDS02? ==
586
587
588 (% style="color:blue" %)**Before v1.6 firmware**(%%): LDS02 works in Subband 2 by default in AU915 / US915 band. So if the LoRaWAN server works in other subband, there will be issue for LWL02 to Join the server. In this case, User can use AT COmmand to change the subband. See AT Command chapther for the hardware connection. Below are the steps to change sub-band:
589
590 * Press rest button.
591 * Send (% style="color:blue" %)**123456**(%%) password
592 * Send command (% style="color:blue" %)**AT+CFREQBANDMASK=0001 **(%%)( 0001 for subband 1, 0002 for subband 2, etc..)
593 * Press rest button to restart to new subband
594 * Example output:
595
596 (% class="mark small" %)[3369]DRAGINO LWL01 Device
597 [3370]Frequency Band: US915 v1.5
598 [3373]OTAA
599 [3374]DevEui= 7896785455246354
600 [3377]class type A
601 [3379]freq mode intra
602 [3381]**scan chn mask 0x0002   ~-~-> use subband 2**
603
604 (% class="mark small" %)LM502:~~# [10793]txDone
605 123456       ~-~-> ENTER PASSWORD
606 Correct Password
607
608 (% class="mark small" %)[105115]rxTimeOut
609 **AT+CFREQBANDMASK=0001   ~-~-> Change to Subband1**
610 OK
611
612 (% class="mark small" %)[3371]DRAGINO LWL01 Device
613 [3373]Frequency Band: US915 v1.5
614 [3376]OTAA
615 [3377]DevEui= 7896785455246354
616 [3380]class type A
617 [3382]freq mode intra
618 [3384]**scan chn mask 0x0001  ~-~-> reboot and works on Subband1 now**
619
620
621 (% style="color:blue" %)**Since firmware v1.6: **(%%)LWL02 works in chn mask 0x0000. where cover all subbands. so no need to use AT Commands to change subband and it can works for every subband
622
623
624 == 7.5 My sensor works for Helium AU915 before but not it doesn't work, Why? ==
625
626
627 It is sub-band issue, See chapter 7.4.Helium Change the Subband for AU915 from subband2 to Subband1 which cause the sensor doesn't work.
628
629
630 = 8. Order Info =
631
632
633 **Part Number: (% style="color:blue" %)LDS02-XXX(%%)**
634
635 (% style="color:blue" %)**XXX:**
636
637 * (% style="color:red" %)**EU433**(%%): frequency  bands EU433
638 * (% style="color:red" %)**EU868**(%%): frequency  bands EU868
639 * (% style="color:red" %)**KR920**(%%): frequency  bands KR920
640 * (% style="color:red" %)**CN470**(%%): frequency bands CN470
641 * (% style="color:red" %)**AS923**(%%): frequency  bands AS923
642 * (% style="color:red" %)**AU915**(%%): frequency bands AU915
643 * (% style="color:red" %)**US915**(%%): frequency bands  US915
644 * (% style="color:red" %)**IN865**(%%):  frequency bands  IN865
645 * (% style="color:red" %)**CN779**(%%): frequency bands CN779
646
647
648
649 = 9. Packing Info =
650
651
652 (((
653 **Package Includes**:
654 )))
655
656 * (((
657 LDS02 x 1
658 )))
659
660 (((
661 **Dimension and weight**:
662 )))
663
664 * (((
665 Device Size: 69.2 x 29.2 x 14.8 mm
666
667
668
669 )))
670
671 = 10. Support =
672
673
674 * 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.
675 * 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]].
676
677
678
679

Applications

Navigation

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