Version 48.4 by Xiaoling on 2022/06/25 17:39
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 == 1.3 Applications ==
71
72 * Smart Buildings & Home Automation
73 * Logistics and Supply Chain Management
74 * Smart Metering
75 * Smart Agriculture
76 * Smart Cities
77 * Smart Factory
78
79
80 == 1.4 Dimension ==
81
82 Unit: mm
83
84 [[image:1654680563545-120.png]]
85
86
87 [[image:1654680510816-654.png]]
88
89
90 == 1.5 Firmware Change log ==
91
92 (((
93 (((
94 LDS02 use the same firmware as LDS01.
95 )))
96
97 (((
98 [[LDS02 Image files – Download link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/Firmware/]]
99 )))
100 )))
101
102
103 = 2. Power ON LDS02 =
104
105 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.
106
107
108 = 3. How to install LDS02 =
109
110 (((
111 (((
112 When install the LDS02 on wall. Please make sure install as below so the marks will close to each other when close the door.
113 )))
114
115 (((
116 Open/Close threshold range: ~~ 25mm
117 )))
118 )))
119
120 [[image:1654680716522-793.png]]
121
122
123
124 = 4. Operation Mode =
125
126 == 4.1 How it works? ==
127
128 (((
129 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.
130 )))
131
132 (((
133 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.
134 )))
135
136
137 == 4.2 Example to join LoRaWAN network ==
138
139 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. 
140
141 [[image:1654680810108-149.png]]
142
143
144 (((
145 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.
146 )))
147
148 * (((
149 A keep-alive message which send once per day.
150 )))
151 * (((
152 A door event message when there is a door open/close. ([[Alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]])
153 )))
154
155 (((
156
157
158 (((
159 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:
160 )))
161 )))
162
163 (((
164 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from LDS02.
165 )))
166
167 (((
168 Each LDS02 is shipped with a sticker with unique device EUI:
169 )))
170
171 [[image:1654671040430-368.png]]
172
173
174 User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
175
176
177 **Add APP EUI in the application**
178
179 [[image:1654671794691-956.png]]
180
181
182 [[image:1654671809850-574.png]]
183
184 [[image:1654671820156-640.png]]
185
186
187 [[image:1654681258096-500.png]]
188
189
190
191 **Add APP KEY and DEV EUI**
192
193 [[image:1654671889112-678.png]]
194
195
196 (((
197 (% 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.
198 )))
199
200
201 [[image:1654681390551-993.png]]
202
203
204
205 == 4.3 Uplink Payload ==
206
207
208 Uplink Payload total 10 bytes.
209
210 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:480px" %)
211 |=(% 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**
212 |value|Status&BAT|(((
213 MOD
214
215 Always:0x01
216 )))|Total open door events|(((
217 Last door open
218
219 duration (unit: min)
220 )))|[[Alarm>>||anchor="H4.6AlarmBaseonTimeout"]]
221
222 **Example:**
223
224 [[image:1654681706301-731.png]]
225
226 [[image:1654681714641-440.png]]
227
228
229 (((
230 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/]]
231 )))
232
233
234 == 4.4 Downlink Payload ==
235
236
237 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:410px" %)
238 |=(% style="width: 180px;" %)**Downlink Control Type**|=(% style="width: 80px;" %)**Type Code**|=(% style="width: 150px;" %)**Downlink payload size(bytes)**
239 |(% style="width:180px" %)TDC (Transmit Time Interval—Keep Alive Interval)|(% style="width:80px" %)0x01|(% style="width:150px" %)4
240 |(% style="width:180px" %)RESET|(% style="width:80px" %)0x04|(% style="width:224px" %)2
241 |(% style="width:180px" %)[[Set confirmed mode>>||anchor="HTypeCode0x05"]]|(% style="width:80px" %)0x05|(% style="width:150px" %)2
242 |(% style="width:180px" %)[[Clear Counting>>||anchor="HTypeCode0xA6"]]|(% style="width:80px" %)0xA6|(% style="width:150px" %)2
243 |(% style="width:180px" %)[[Enable/Disable Alarm>>||anchor="HTypeCode0xA7"]]|(% style="width:80px" %)0xA7|(% style="width:150px" %)2
244 |(% style="width:180px" %)[[Control ADR/DR>>||anchor="HTypeCode0xA8"]]|(% style="width:80px" %)0xA8|(% style="width:150px" %)3
245 |(% style="width:180px" %)[[Set Alarm Timeout>>||anchor="HTypeCode0xA9"]]|(% style="width:80px" %)0xA9|(% style="width:150px" %)4
246
247 Example Downlink payload setting in TTN V3:
248
249 [[image:1654673412319-976.png]]
250
251
252 === (% style="color:#037691" %)**Type Code 0x01**(%%) ===
253
254 If the payload=0100003C, means to control the LDS02’s Keep Alive interval to 0x00003C=60(S)
255
256
257 === (% style="color:#037691" %)**Type Code 0x04**(%%) ===
258
259 If payload = 0x04FF, it will reset the LDS02.
260
261
262 === (% style="color:#037691" %)**Type Code 0x05**(%%) ===
263
264 (((
265 0x05 00: Set uplink to LoRaWAN unconfirmed mode
266 )))
267
268 (((
269 0x05 01: Set uplink to LoRaWAN confirmed mode
270 )))
271
272
273 === (% style="color:#037691" %)**Type Code 0xA6**(%%) ===
274
275 (((
276 Example: 0xA601: Clear Counting
277 For LDS02: reset both count number and time.
278 )))
279
280
281 === (% style="color:#037691" %)**Type Code 0xA7**(%%) ===
282
283 (((
284 0xA7 01 : Equal to AT+DISALARM=1
285 )))
286
287 (((
288 0xA7 00 : Equal to AT+DISALARM=0
289 )))
290
291
292 === (% style="color:#037691" %)**Type Code 0xA8**(%%) ===
293
294 (((
295 Format: 0xA8 aa bb
296 )))
297
298 (((
299 aa: 1: Enable ADR; 0: Disable ADR (Same as AT+CADR command)
300 )))
301
302 (((
303 bb: set DR (Same as AT+CDATARATE ,only valid after ADR=0)
304 )))
305
306 (((
307 Example: 0x A8 00 02 : Set ADR=0 and DR=1
308 )))
309
310
311 === (% style="color:#037691" %)**Type Code 0xA9**(%%) ===
312
313 See [[Alarm Base Timeout>>||anchor="H4.6AlarmBaseonTimeout"]] for detail.
314
315
316 == 4.5 Integrate with Datacake ==
317
318 (((
319 (((
320 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:
321 )))
322 )))
323
324 (((
325
326 )))
327
328 (((
329 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
330 )))
331
332 (((
333 (% 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:
334 )))
335
336
337 [[image:1654674520913-519.png]]
338
339
340 [[image:1654674530910-914.png]]
341
342
343 [[image:1654674543078-401.png]]
344
345
346 (% style="color:blue" %)**Step 3**(%%): Create an account or log in Datacake.
347
348 (% style="color:blue" %)**Step 4**(%%): Search LDS02 and add DevEUI.
349
350 [[image:1654674556510-911.png]]
351
352
353 == 4.6 Alarm Base on Timeout ==
354
355 (((
356 (((
357 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.
358 )))
359
360 (((
361 User configure this feature by using:
362 )))
363 )))
364
365 (((
366 (((
367
368 )))
369 )))
370
371 (((
372 (((
373 (% style="color:blue" %)**AT Command**(%%) to configure:
374 )))
375 )))
376
377 * (((
378 (((
379 **AT+TTRIG=1,30 ** **~-~->** When status change from close to open, and device keep in open
380 )))
381 )))
382
383 (((
384 (((
385 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.
386 )))
387 )))
388
389 * (((
390 (((
391 **AT+TTIG=0,0**  **~-~->**  Default Value, disable timeout Alarm.
392 )))
393 )))
394
395 (((
396 (((
397
398
399 (% style="color:blue" %)**Downlink Command**(%%) to configure:
400 )))
401 )))
402
403 (((
404 (((
405 **Command: 0xA9 aa bb cc**
406 )))
407 )))
408
409 (((
410 (((
411 A9: Command Type Code
412 )))
413 )))
414
415 (((
416 (((
417 aa: status to be monitor
418 )))
419 )))
420
421 (((
422 (((
423 bb cc: timeout.
424 )))
425 )))
426
427 (((
428 (((
429
430 )))
431 )))
432
433 (((
434 (((
435 If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
436 )))
437 )))
438
439 (((
440 (((
441 Or
442 )))
443 )))
444
445 (((
446 (((
447 0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
448 )))
449 )))
450
451
452
453 == 4.7 LEDs ==
454
455
456 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:463px" %)
457 |=(% style="width: 184px;" %)**Action**|=(% style="width: 275px;" %)**LED behavior**
458 |(% 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(%%)**
459 |(% style="width:184px" %)Joined successful|(% style="width:275px" %)(% style="color:green" %)**GRENN LED **(%%)on 5s
460 |(% style="width:184px" %)Send an uplink message|(% style="width:275px" %)(% style="color:green" %)**GREEN LED**(%%) blinks once
461 |(% style="width:184px" %)Got a downlink message|(% style="width:275px" %)(% style="color:blue" %)**BLUE LED**(%%) blinks once
462
463
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 = 9. Packing Info =
597
598 (((
599 **Package Includes**:
600 )))
601
602 * (((
603 LDS02 x 1
604 )))
605
606 (((
607 **Dimension and weight**:
608 )))
609
610 * (((
611 Device Size: 69.2 x 29.2 x 14.8 mm
612
613
614
615 )))
616
617 = 10. Support =
618
619 * 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.
620 * 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]].
621
622

Applications

Navigation

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