Version 49.4 by Xiaoling on 2022/06/30 15:30
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
57 == 1.2 Features ==
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 * Smart Buildings & Home Automation
74 * Logistics and Supply Chain Management
75 * Smart Metering
76 * Smart Agriculture
77 * Smart Cities
78 * Smart Factory
79
80
81
82 == 1.4 Dimension ==
83
84 Unit: mm
85
86 [[image:1654680563545-120.png]]
87
88
89 [[image:1654680510816-654.png]]
90
91
92 == 1.5 Firmware Change log ==
93
94 (((
95 (((
96 LDS02 use the same firmware as LDS01.
97 )))
98
99 (((
100 [[LDS02 Image files – Download link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Firmware/]]
101 )))
102 )))
103
104
105 = 2. Power ON LDS02 =
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 When install the LDS02 on wall. Please make sure install as below so the marks will close to each other when close the door.
115 )))
116
117 (((
118 Open/Close threshold range: ~~ 25mm
119 )))
120 )))
121
122 [[image:1654680716522-793.png]]
123
124
125
126 = 4. Operation Mode =
127
128 == 4.1 How it works? ==
129
130 (((
131 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.
132 )))
133
134 (((
135 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.
136 )))
137
138
139 == 4.2 Example to join LoRaWAN network ==
140
141 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. 
142
143 [[image:1654680810108-149.png]]
144
145
146 (((
147 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.
148 )))
149
150 * (((
151 A keep-alive message which send once per day.
152 )))
153 * (((
154 A door event message when there is a door open/close. ([[Alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]])
155 )))
156
157 (((
158
159
160 (((
161 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:
162 )))
163 )))
164
165 (((
166 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from LDS02.
167 )))
168
169 (((
170 Each LDS02 is shipped with a sticker with unique device EUI:
171 )))
172
173 [[image:1654671040430-368.png]]
174
175
176 User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
177
178
179 **Add APP EUI in the application**
180
181 [[image:1654671794691-956.png]]
182
183
184 [[image:1654671809850-574.png]]
185
186 [[image:1654671820156-640.png]]
187
188
189 [[image:1654681258096-500.png]]
190
191
192
193 **Add APP KEY and DEV EUI**
194
195 [[image:1654671889112-678.png]]
196
197
198 (((
199 (% 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.
200 )))
201
202
203 [[image:1654681390551-993.png]]
204
205
206
207 == 4.3 Uplink Payload ==
208
209
210 Uplink Payload total 10 bytes.
211
212 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:480px" %)
213 |=(% 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**
214 |value|Status&BAT|(((
215 MOD
216
217 Always:0x01
218 )))|Total open door events|(((
219 Last door open
220
221 duration (unit: min)
222 )))|[[Alarm>>||anchor="H4.6AlarmBaseonTimeout"]]
223
224 **Example:**
225
226 [[image:1654681706301-731.png]]
227
228 [[image:1654681714641-440.png]]
229
230
231 (((
232 Example Payload Decoder in TTN V3: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS02/Payload/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Payload/]]
233 )))
234
235
236 == 4.4 Downlink Payload ==
237
238
239 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:410px" %)
240 |=(% style="width: 180px;" %)**Downlink Control Type**|=(% style="width: 80px;" %)**Type Code**|=(% style="width: 150px;" %)**Downlink payload size(bytes)**
241 |(% style="width:180px" %)TDC (Transmit Time Interval—Keep Alive Interval)|(% style="width:80px" %)0x01|(% style="width:150px" %)4
242 |(% style="width:180px" %)RESET|(% style="width:80px" %)0x04|(% style="width:224px" %)2
243 |(% style="width:180px" %)[[Set confirmed mode>>||anchor="HTypeCode0x05"]]|(% style="width:80px" %)0x05|(% style="width:150px" %)2
244 |(% style="width:180px" %)[[Clear Counting>>||anchor="HTypeCode0xA6"]]|(% style="width:80px" %)0xA6|(% style="width:150px" %)2
245 |(% style="width:180px" %)[[Enable/Disable Alarm>>||anchor="HTypeCode0xA7"]]|(% style="width:80px" %)0xA7|(% style="width:150px" %)2
246 |(% style="width:180px" %)[[Control ADR/DR>>||anchor="HTypeCode0xA8"]]|(% style="width:80px" %)0xA8|(% style="width:150px" %)3
247 |(% style="width:180px" %)[[Set Alarm Timeout>>||anchor="HTypeCode0xA9"]]|(% style="width:80px" %)0xA9|(% style="width:150px" %)4
248
249 Example Downlink payload setting in TTN V3:
250
251 [[image:1654673412319-976.png]]
252
253
254 === (% style="color:#037691" %)**Type Code 0x01**(%%) ===
255
256 If the payload=0100003C, means to control the LDS02’s Keep Alive interval to 0x00003C=60(S)
257
258
259 === (% style="color:#037691" %)**Type Code 0x04**(%%) ===
260
261 If payload = 0x04FF, it will reset the LDS02.
262
263
264 === (% style="color:#037691" %)**Type Code 0x05**(%%) ===
265
266 (((
267 0x05 00: Set uplink to LoRaWAN unconfirmed mode
268 )))
269
270 (((
271 0x05 01: Set uplink to LoRaWAN confirmed mode
272 )))
273
274
275 === (% style="color:#037691" %)**Type Code 0xA6**(%%) ===
276
277 (((
278 Example: 0xA601: Clear Counting
279 For LDS02: reset both count number and time.
280 )))
281
282
283 === (% style="color:#037691" %)**Type Code 0xA7**(%%) ===
284
285 (((
286 0xA7 01 : Equal to AT+DISALARM=1
287 )))
288
289 (((
290 0xA7 00 : Equal to AT+DISALARM=0
291 )))
292
293
294 === (% style="color:#037691" %)**Type Code 0xA8**(%%) ===
295
296 (((
297 Format: 0xA8 aa bb
298 )))
299
300 (((
301 aa: 1: Enable ADR; 0: Disable ADR (Same as AT+CADR command)
302 )))
303
304 (((
305 bb: set DR (Same as AT+CDATARATE ,only valid after ADR=0)
306 )))
307
308 (((
309 Example: 0x A8 00 02 : Set ADR=0 and DR=1
310 )))
311
312
313 === (% style="color:#037691" %)**Type Code 0xA9**(%%) ===
314
315 See [[Alarm Base Timeout>>||anchor="H4.6AlarmBaseonTimeout"]] for detail.
316
317
318 == 4.5 Integrate with Datacake ==
319
320 (((
321 (((
322 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:
323 )))
324 )))
325
326 (((
327
328 )))
329
330 (((
331 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
332 )))
333
334 (((
335 (% 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:
336 )))
337
338
339 [[image:1654674520913-519.png]]
340
341
342 [[image:1654674530910-914.png]]
343
344
345 [[image:1654674543078-401.png]]
346
347
348 (% style="color:blue" %)**Step 3**(%%): Create an account or log in Datacake.
349
350 (% style="color:blue" %)**Step 4**(%%): Search LDS02 and add DevEUI.
351
352 [[image:1654674556510-911.png]]
353
354
355 == 4.6 Alarm Base on Timeout ==
356
357 (((
358 (((
359 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.
360 )))
361
362 (((
363 User configure this feature by using:
364 )))
365 )))
366
367 (((
368 (((
369
370 )))
371 )))
372
373 (((
374 (((
375 (% style="color:blue" %)**AT Command**(%%) to configure:
376 )))
377 )))
378
379 * (((
380 (((
381 **AT+TTRIG=1,30 ** **~-~->** When status change from close to open, and device keep in open
382 )))
383 )))
384
385 (((
386 (((
387 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.
388 )))
389 )))
390
391 * (((
392 (((
393 **AT+TTIG=0,0**  **~-~->**  Default Value, disable timeout Alarm.
394 )))
395 )))
396
397 (((
398 (((
399
400
401 (% style="color:blue" %)**Downlink Command**(%%) to configure:
402 )))
403 )))
404
405 (((
406 (((
407 **Command: 0xA9 aa bb cc**
408 )))
409 )))
410
411 (((
412 (((
413 A9: Command Type Code
414 )))
415 )))
416
417 (((
418 (((
419 aa: status to be monitor
420 )))
421 )))
422
423 (((
424 (((
425 bb cc: timeout.
426 )))
427 )))
428
429 (((
430 (((
431
432 )))
433 )))
434
435 (((
436 (((
437 If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
438 )))
439 )))
440
441 (((
442 (((
443 Or
444 )))
445 )))
446
447 (((
448 (((
449 0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
450 )))
451 )))
452
453
454
455 == 4.7 LEDs ==
456
457
458 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:463px" %)
459 |=(% style="width: 184px;" %)**Action**|=(% style="width: 275px;" %)**LED behavior**
460 |(% 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(%%)**
461 |(% style="width:184px" %)Joined successful|(% style="width:275px" %)(% style="color:green" %)**GRENN LED **(%%)on 5s
462 |(% style="width:184px" %)Send an uplink message|(% style="width:275px" %)(% style="color:green" %)**GREEN LED**(%%) blinks once
463 |(% style="width:184px" %)Got a downlink message|(% style="width:275px" %)(% style="color:blue" %)**BLUE LED**(%%) blinks once
464
465
466
467 = 5. Battery & How to replace =
468
469 == 5.1 Battery Type and replace ==
470
471 (((
472 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.
473
474 (% style="color:red" %)**Note:**
475
476 1. The LDS02 doesn't have any screw, use can use nail to open it by the middle.
477 1. Make sure the direction is correct when install the AAA batteries.
478 )))
479
480 (((
481 (% style="color:red" %)**Important Notice: Make sure use new AAA LR03 battery and the battery doesn't have broken surface.**
482 )))
483
484 (((
485
486 )))
487
488 (((
489 Example of AAA LR03 batter:
490 )))
491
492 [[image:1654675278044-307.png]]
493
494
495 == 5.2 Power Consumption Analyze ==
496
497 (((
498 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:
499 )))
500
501 (((
502 [[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]]
503 )))
504
505
506 = 6. Use AT Command =
507
508 == 6.1 Access AT Command ==
509
510 LDS02 supports AT Command set. User can use a USB to TTL adapter to configure LDS02 via use AT command, as below.
511
512 [[image:image-20220609085453-1.png]]
513
514
515 (% style="background-color:yellow" %)**USB to TTL <- -> LDS02**
516
517 (% style="background-color:yellow" %)**RX <- -> TXD**
518
519 (% style="background-color:yellow" %)**TX <- -> RXD**
520
521 (% style="background-color:yellow" %)**GND <- -> GND**
522
523
524 (((
525 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:
526 )))
527
528 (((
529 The AT Access password is (% style="color:red" %)**123456**.
530 )))
531
532 [[image:1654675618022-630.png]]
533
534
535 (((
536 Each AT Command need to (% style="color:red" %)**add an ENTER**(%%) at the end before send.
537 )))
538
539 (((
540 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.
541 )))
542
543 (((
544 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/]]
545 )))
546
547
548 = 7. FAQ =
549
550 == 7.1 How to upgrade the image? ==
551
552 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]]
553
554
555 == 7.2 How to change the LoRa Frequency Bands/Region? ==
556
557 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.
558
559
560 == 7.3 Can I disable uplink for each event to save battery life? ==
561
562 Yes, User can use below method to disable this:
563
564
565 (% style="color:#4f81bd" %)**via AT Command**:
566
567 AT+DISALARM=1, End node will only send packet in TDC time.
568
569 AT+DISALARM=0, End node will send packet in TDC time or status change for door sensor. 
570
571
572 (% style="color:#4f81bd" %)**via LoRaWAN downlink Command**:
573
574 0xA701 : Equal to AT+DISALARM=1
575
576 0xA700 : Equal to AT+DISALARM=0
577
578
579 = 8. Order Info =
580
581 **Part Number: (% style="color:blue" %)LDS02-XXX(%%)**
582
583 (% style="color:blue" %)**XXX:**
584
585 * (% style="color:red" %)**EU433**(%%): frequency  bands EU433
586 * (% style="color:red" %)**EU868**(%%): frequency  bands EU868
587 * (% style="color:red" %)**KR920**(%%): frequency  bands KR920
588 * (% style="color:red" %)**CN470**(%%): frequency bands CN470
589 * (% style="color:red" %)**AS923**(%%): frequency  bands AS923
590 * (% style="color:red" %)**AU915**(%%): frequency bands AU915
591 * (% style="color:red" %)**US915**(%%): frequency bands  US915
592 * (% style="color:red" %)**IN865**(%%):  frequency bands  IN865
593 * (% style="color:red" %)**CN779**(%%): frequency bands CN779
594
595
596
597 = 9. Packing Info =
598
599 (((
600 **Package Includes**:
601 )))
602
603 * (((
604 LDS02 x 1
605 )))
606
607 (((
608 **Dimension and weight**:
609 )))
610
611 * (((
612 Device Size: 69.2 x 29.2 x 14.8 mm
613
614
615
616 )))
617
618 = 10. Support =
619
620 * 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.
621 * 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]].
622
623

Applications

Navigation

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