Version 171.4 by Xiaoling on 2023/04/04 10:25
Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:image-20221031143350-3.png]]
5
6 (% style="display:none" %) (%%)
7
8
9
10 **Table of Contents:**
11
12 {{toc/}}
13
14
15
16
17
18
19
20
21
22 = 1.  Introduction =
23
24 == 1.1  ​What is LWL03A LoRaWAN Water Leak ==
25
26
27 (((
28 The Dragino LWL03A is a (% style="color:blue" %)**LoRaWAN None-Position Rope Type Water Leak Controller**(%%). User can lay the (% style="color:blue" %)**LWL03A + Water Leak Cable**(%%) on the ground to detect water leakage. The water leak cable is sensitivity, when there is water over the leak cable. LWL03A will indicates a (% style="color:blue" %)**water leak event**(%%) and uplink to IoT server via LoRaWAN network.
29 )))
30
31 (((
32 LWL03A is powered by (% style="color:blue" %)**8500mAh battery**(%%) and target for long time use up to 10 years.
33 )))
34
35 (((
36 The LWL03A will send periodically data every 2 hours as well as for each water leak event. It also counts the water leak times and calculate last water leak duration.
37 )))
38
39 (((
40 Each LWL03A is 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.
41 )))
42
43
44 == ​1.2  Features ==
45
46
47 * LoRaWAN v1.0.3 Class A protocol.
48 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
49 * Water Leak detect
50 * 8500mAh Li-SoCI2 battery
51 * AT Commands to change parameters
52 * Uplink on periodically and leakage event
53 * Remote configure parameters via LoRa Downlink
54 * Firmware upgradable via program port
55
56
57
58 == 1.3  Cable Specification ==
59
60
61
62
63 == 1.4  ​Applications ==
64
65
66 * Smart Buildings & Home Automation
67 * Smart Cities
68 * Smart Factory
69
70
71
72 == 1.5  Mechanical ==
73
74
75 [[image:1667211179108-212.png]]
76
77
78 [[image:1667211192189-120.png]]
79
80
81 == 1.6  Installation ==
82
83
84 [[image:image-20221101180548-1.png||height="684" width="679"]]
85
86
87 [[image:image-20221031145604-4.png]]
88
89
90 == 1.7  Firmware Change log ==
91
92
93 [[LWL03A Image files – Download link & Changelog>>url:https://www.dropbox.com/sh/23v29gi61jq9mp6/AABgwJQ_xuybFivgbDZwTyNGa?dl=0]]
94
95
96 == 1.8  Pin Definitions and Switch ==
97
98
99 [[image:1654741572060-177.png]]
100
101 **LWL03A is based on LSN50v2**
102
103
104 === 1.8.1  Pin Definition ===
105
106
107 (((
108 The device is pre-configured to connect to a door sensor. The other pins are not used. If user wants to know more about other pins, please refer to the user manual of LSN50v2 at:  [[https:~~/~~/www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]]
109 )))
110
111
112 === 1.8.2  Jumper JP2(Power ON/OFF) ===
113
114
115 Power on Device when putting this jumper.
116
117
118 === 1.8.3  BOOT MODE / SW1 ===
119
120
121 (((
122 1)  ISP: upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
123 )))
124
125 (((
126 2)  Flash: work mode, the device starts to work and send out console output for further debug
127 )))
128
129
130 === 1.8.4  Reset Button ===
131
132
133 Press to reboot the device.
134
135
136 === 1.8.5  LED ===
137
138
139 It will flash:
140
141 ~1. Boot the device in flash mode
142
143 2. Send an uplink packet
144
145
146 = 2.  Operation Mode =
147
148 == 2.1  How it works ==
149
150
151 (((
152 The LWL03A 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="H1.8.2A0JumperJP228PowerON2FOFF29"]] the LWL03A. It will auto join the network via OTAA.
153 )))
154
155 (((
156 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>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/]] to set the keys in the devices.
157 )))
158
159
160 == 2.2  Example to use for LoRaWAN network ==
161
162
163 (((
164 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.
165
166
167 )))
168
169 (((
170 [[image:image-20221031151740-5.png]]
171
172
173 )))
174
175 (((
176 The LWL03A 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 LWL03A will uplink two type of messages to the server.
177
178 * A keep-alive message which send every 2 hours. (Interval can be changed)
179
180 * An emergency event message when detect a water leak/water no leak. (leak/no [[leak event can be disabled>>||anchor="H3.4A0Enable2FDisableAlarm"]])
181
182 * A periodically update at every 10 minutes when in water leak.(Interval can be changed)
183
184 * A message when switch from water leak to none water leak. ([[Alarm event can be disabled>>||anchor="H3.8A0AlarmBaseonTimeout"]])
185
186 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:
187
188
189 (((
190 (% style="color:blue" %)**Step 1**(%%):  Create a device in TTN V3 with the OTAA keys from LWL03A.
191 )))
192
193 (((
194 Each LWL03A is shipped with a sticker with the default device EUI as below:
195 )))
196 )))
197
198 [[image:image-20220607170145-1.jpeg]]
199
200
201 Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
202
203
204 **Add APP EUI in the application:**
205
206 [[image:1654742558691-332.png]]
207
208
209 [[image:1654742595660-519.png]]
210
211
212 [[image:1654742610413-498.png]]
213
214
215
216 [[image:1654742630064-347.png]]
217
218 **Add APP KEY and DEV EUI**
219
220
221
222 (% style="color:blue" %)**Step 2**(%%): Power on LWL03A
223
224
225 [[image:1654742860601-778.png]]
226
227
228
229 Put the jumper to power on LWL03A and it will auto-join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and the user can see it in the panel.
230
231 [[image:image-20221031161420-7.png||height="289" width="1322"]]
232
233
234 == 2.3  ​Uplink Payload ==
235
236
237 (((
238 Uplink payloads have two types:
239 )))
240
241 * (((
242 Leak/No leak Status: Use FPORT=2
243 )))
244 * (((
245 Other control commands: Use other FPORT fields.
246 )))
247
248 (((
249 The application server should parse the correct value based on FPORT settings.
250 )))
251
252
253 === 2.3.1  Device Status, FPORT~=5 ===
254
255
256 (((
257 Include device configure status. Once LWL03A Joined the network, it will uplink this message to the server. After that, LWL03A will uplink Device Status every 12 hours.
258 )))
259
260 (((
261 Users can also use the downlink command(% style="color:blue" %)**(0x26 01)**(%%) to ask LWL03A to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
262 )))
263
264 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
265 |=(% scope="row" %)**Size(bytes)**|**11**|**2**|**1**|**1**|**2**
266 |=**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
267
268 **Example parse in TTNv3:**
269
270 [[image:image-20221031161732-8.png||height="432" width="1339"]]
271
272
273 * (% style="color:#4f81bd" %)**Sensor Model**(%%): For LWL03A, this value is 0x14
274
275 * (% style="color:#4f81bd" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
276
277 * (% style="color:#4f81bd" %)**Frequency Band**:
278
279 *0x01: EU868
280
281 *0x02: US915
282
283 *0x03: IN865
284
285 *0x04: AU915
286
287 *0x05: KZ865
288
289 *0x06: RU864
290
291 *0x07: AS923
292
293 *0x08: AS923-1
294
295 *0x09: AS923-2
296
297 *0x0a: AS923-3
298
299 *0x0b: CN470
300
301 *0x0c: EU433
302
303 *0x0d: KR920
304
305 *0x0e: MA869
306
307
308 * (% style="color:#4f81bd" %)**Sub-Band**:
309
310 AU915 and US915: value 0x00 ~~ 0x08
311
312 CN470: value 0x0B ~~ 0x0C
313
314 Other Bands: Always 0x00
315
316
317 * (% style="color:#4f81bd" %)**Battery Info:**
318
319 Check the battery voltage.
320
321 Ex1: 0x0B45 = 2885mV
322
323 Ex2: 0x0B49 = 2889mV
324
325
326 === 2.3.2  Sensor Configuration, FPORT~=4 ===
327
328
329 (((
330 LWL03A will only send this command after getting the downlink command (0x26 02) from the server.
331 )))
332
333 (((
334 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
335 |=(% scope="row" %)**Size(bytes)**|**3**|**1**|**1**|**2**|**1**
336 |=**Value**|TDC (unit: sec)|Disalarm|Keep status|Keep time (unit: sec)|Leak alarm time
337 )))
338
339
340 * (((
341 (% style="color:#4f81bd" %)**TDC: (default: 0x001C20)**
342 )))
343
344 (((
345 Uplink interval for the Leak/No leak Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
346 )))
347
348
349 * (((
350 (% style="color:#4f81bd" %)**Disalarm: (default: 0)**
351 )))
352
353 (((
354 (% style="color:#037691" %) **If Disalarm = 1**(%%), LWL03A will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many Leak/No leak event, and platform only care about the total number of pulse.
355 )))
356
357 (((
358 (% style="color:#037691" %) **If Disalarm = 0**(%%), LWL03A will send uplink at every TDC periodically and send data on each Leak/No leak event. This is useful for the application user need to monitor the Leak/No leak event in real-time.
359 )))
360
361 (((
362 (% style="color:red; font-weight:bold" %)** Note: When Disalarm=0, a high frequently Leak**(% style="color:red" %)**/No leak event will cause lots of uplink and drain battery very fast. **
363 )))
364
365
366 * (((
367 (% style="color:#4f81bd" %)**Keep Status & Keep Time**
368 )))
369
370 (((
371 Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.8A0AlarmBaseonTimeout"]]
372 )))
373
374
375 * (% style="color:#4f81bd" %)**Leak alarm time**
376
377 Regularly update a confirm uplink when water leaks, default value is 0x0A which is 10 minutes.
378
379
380 === 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
381
382
383 LWL03A will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LWL03A will:
384
385 ~1. periodically send this uplink every 2 hours, this interval [[can be changed>>||anchor="H3.1A0SetTransmitIntervalTime"]].
386
387 2. There is an Leak/No leak event.
388
389
390 Uplink Payload totals 11 bytes.
391
392 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
393 |=(% colspan="5" style="width: 492px;" %)**Real-Time Open/Close Status, FPORT=2**
394 |(% style="width:60px" %)**Size(bytes)**|(% style="width:70px" %)**1**|(% style="width:90px" %)**3**|(% style="width:120px" %)**3**|(% style="width:80px" %)**4**
395 |(% style="width:101px" %)**Value**|(% style="width:77px" %)Status & [[Alarm>>||anchor="H3.8A0AlarmBaseonTimeout"]](((
396 &TDC flag
397 )))|(% style="width:99px" %)Total leak events|(% style="width:88px" %)(((
398 last leak
399 duration (unit: sec)
400 )))|(% style="width:126px" %)[[Unix TimeStamp>>||anchor="H2.4.1A0UnixTimeStamp"]]
401
402 **Status & Alarm:**
403
404 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:490px" %)
405 |=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)**6**|(% style="width:100px" %)**1**|(% style="width:140px" %)**1**|(% style="width:140px" %)**1**
406 |=(% style="width: 82px;" %)**Value**|(% style="width:71px" %)Reserve|(% style="width:176px" %)(((
407 TDC flag
408 0:No;1:Yes
409 )))|(% style="width:176px" %)(((
410 Alarm
411 0: No Alarm;
412 1: Alarm
413 )))|(% style="width:131px" %)Status
414 0: No leak, 1: leak
415
416 [[image:1667205498482-181.png]]
417
418
419 **Please check the decoder from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/LWL03A>>https://github.com/dragino/dragino-end-node-decoder/tree/main/LWL03A]]**
420
421
422 === 2.3.4  Historical Water Leak/No leak Event, FPORT~=3 ===
423
424
425 (((
426 LWL03A stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.4A0DatalogFeature"]].
427 )))
428
429 (((
430 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time leak/no leak status.
431 )))
432
433 (((
434
435 )))
436
437 * (((
438 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, LWL03A will send max bytes according to the current DR and Frequency bands.
439 )))
440
441 (((
442 For example, in the US915 band, the max payload for different DR is:
443 )))
444
445 (% style="color:blue" %)**1. DR0**(%%): max is 11 bytes so one entry of data
446
447 (% style="color:blue" %)**2. DR1**(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
448
449 (% style="color:blue" %)**3. DR2**(%%): total payload includes 11 entries of data
450
451 (% style="color:blue" %)**4. DR3**(%%): total payload includes 22 entries of data.
452
453
454 If LWL03A doesn't have any data in the polling time. It will uplink 11 bytes of 0
455
456
457
458 [[image:1667205726581-981.png]]
459
460
461
462 (((
463 (% style="color:#037691" %)**Access via serial port:**
464 )))
465
466 [[image:image-20221031164229-9.png]]
467
468
469 (((
470 (% style="color:#037691" %)**Downlink:**
471 )))
472
473 (((
474 0x31 63 5C D2 B8 63 5C D8 1C 05
475 )))
476
477
478 (((
479 (% style="color:#037691" %)**Uplink:**
480 )))
481
482 (((
483 01 00 00 0A 00 00 0A 63 5C D2 F2 00 00 00 0A 00 00 15 63 5C D3 07 03 00 00 0F 00 00 00 63 5C D4 99 00 00 00 0F 00 00 28 63 5C D4 B7 02 00 00 11 00 00 E3 63 5C D6 52 00 00 00 00 00 00 00 63 5C D7 11 02 00 00 10 00 00 01 63 5C D7 51 00 00 00 10 00 00 01 63 5C D7 81 01 00 00 00 00 00 01 63 5C D7 8F 00 00 00 0D 00 00 0D 63 5C D7 F9
484 )))
485
486
487 (((
488 (% style="color:#037691" %)**Parsed Value:**
489
490
491 [ALARM, WATER_LEAK_STATUS, WATER_LEAK_TIMES, LAST_WATER_LEAK_DURATION, TIME]
492
493
494 [FALSE,LEAK,10,10,2022-10-29 07:14:58],
495
496 [FALSE,NO LEAK,10,21,2022-10-29 07:15:19],
497
498 [TRUE,LEAK,15,0,2022-10-29 07:22:01],
499
500 [FALSE,NO LEAK,15,40,2022-10-29 07:22:31],
501
502 [TRUE,NO LEAK,17,227,2022-10-29 07:29:22],
503
504 [FALSE,NO LEAK,0,0,2022-10-29 07:32:33],
505
506 [TRUE,NO LEAK,16,1,2022-10-29 07:33:37],
507
508 [FALSE,NO LEAK,16,1,2022-10-29 07:34:25],
509
510 [FALSE,LEAK,0,1,2022-10-29 07:34:39],
511
512 [FALSE,NO LEAK,13,13,2022-10-29 07:36:25],
513 )))
514
515
516 == 2.4  Datalog Feature ==
517
518
519 When a user wants to retrieve sensor value, he can send a poll command from the IoT platform to ask the sensor to send value in the required time slot.
520
521
522 === 2.4.1  Unix TimeStamp ===
523
524
525 LWL03A use Unix TimeStamp format based on
526
527 [[image:image-20220609113256-8.png]]
528
529
530 (((
531 Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
532 )))
533
534 (((
535 Below is the converter example
536 )))
537
538 [[image:image-20220609113256-9.png||height="467" width="1127"]]
539
540
541 (((
542 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
543 )))
544
545
546 === 2.4.2  Set Device Time ===
547
548
549 (((
550 There are two ways to set the device's time:
551 )))
552
553 (((
554 (% style="color:blue" %)**1.  Through LoRaWAN MAC Command (Default settings)**
555 )))
556
557 (((
558 Users need to set **SYNCMOD=1** to enable sync time via the MAC command.
559 )))
560
561 (((
562 Once LWL03A Joined the LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LWL03A. If LWL03A fails to get the time from the server, LWL03A will use the internal time and wait for the next time request ~[[[via Device Status (FPORT=5)>>||anchor="H2.3.1A0DeviceStatus2CFPORT3D5"]]].
563 )))
564
565
566 (((
567 (% style="color:red" %)**Note**: **LoRaWAN Server needs to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature.**
568 )))
569
570
571 (((
572 (% style="color:blue" %)**2.  Manually Set Time**
573 )))
574
575 (((
576 Users need to set **SYNCMOD=0** to manual time, otherwise, the user set time will be overwritten by the time set by the server.
577 )))
578
579
580 == 2.5 ​Show Data in DataCake IoT Server ==
581
582 (((
583
584
585 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:
586 )))
587
588 (((
589 (% 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]]
590 )))
591
592 (((
593 (% style="color:blue" %)**Step 2**(%%)**: Configure LWL03A in Datacake.**
594 )))
595
596
597
598
599 [[image:image-20221102092921-1.png]]
600
601
602 [[image:image-20221102092921-2.png]]
603
604
605 [[image:image-20221102092921-3.png]]
606
607
608 [[image:image-20221102092921-4.png||height="444" width="1168"]]
609
610
611 [[image:image-20221102092921-5.png]]
612
613
614 [[image:image-20221102092921-6.png||height="439" width="1180"]]
615
616
617 [[image:image-20221102092921-7.png||height="339" width="1174"]]
618
619
620 [[image:image-20221102092921-8.png]]
621
622
623 [[image:image-20221102092921-9.png]]
624
625
626
627 [[image:1667352851343-365.png]]
628
629
630 = 3.  Configure LWL03A via AT Command or LoRaWAN Downlink =
631
632
633 (((
634 Use can configure LWL03A via AT Command or LoRaWAN Downlink.
635 )))
636
637 * (((
638 AT Command Connection: See [[FAQ>>||anchor="H5.A0FAQ"]].
639 )))
640 * (((
641 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
642 )))
643
644 (((
645 There are two kinds of commands to configure LWL03A, they are:
646 )))
647
648 * (((
649 (% style="color:#4f81bd" %)** General Commands**.
650 )))
651
652 (((
653 These commands are to configure:
654 )))
655
656 * (((
657 General system settings like: uplink interval.
658 )))
659 * (((
660 LoRaWAN protocol & radio related command.
661 )))
662
663 (((
664 They are same for all Dragino Device which support DLWS-007 LoRaWAN Stack. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
665 )))
666
667 (((
668
669 )))
670
671 * (((
672 (% style="color:#4f81bd" %)** Commands special design for LWL03A**
673 )))
674
675 (((
676 These commands only valid for LWL03A, as below:
677 )))
678
679
680 == 3.1  Set Transmit Interval Time ==
681
682
683 Feature: Change LoRaWAN End Node Transmit Interval.
684
685 (% style="color:#4472c4" %)**AT Command: AT+TDC**
686
687 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
688 |=(% style="width: 156px;" %)**Command Example**|=(% style="width: 133px;" %)**Function**|=(% style="width: 220px;" %)**Response**
689 |(% style="width:156px" %)AT+TDC?|(% style="width:133px" %)Show current transmit Interval|(% style="width:220px" %)(((
690 30000
691
692 OK
693
694 the interval is 30000ms = 30s
695 )))
696 |(% style="width:156px" %)AT+TDC=60000|(% style="width:133px" %)Set Transmit Interval|(% style="width:220px" %)(((
697 OK
698
699 Set transmit interval to 60000ms = 60 seconds
700 )))
701
702 (((
703 (% style="color:#4472c4" %)**Downlink Command: 0x01**
704 )))
705
706 (((
707 Format: Command Code (0x01) followed by 3 bytes time value.
708 )))
709
710 (((
711 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
712 )))
713
714 * (((
715 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
716 )))
717 * (((
718 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
719
720
721
722 )))
723
724 == 3.2  Set Password ==
725
726
727 Feature: Set device password, max 9 digits.
728
729 (% style="color:#4472c4" %)**AT Command: AT+PWORD**
730
731 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:404.989px" %)
732 |=(% style="width: 170px;" %)**Command Example**|=(% style="width: 123px;" %)**Function**|=(% style="width: 109px;" %)**Response**
733 |(% style="width:170px" %)(((
734 AT+PWORD=?
735 )))|(% style="width:123px" %)(((
736 Show password
737 )))|(% style="width:109px" %)(((
738 (((
739 123456
740 )))
741
742 (((
743 OK
744 )))
745 )))
746 |(% style="width:170px" %)(((
747 AT+PWORD=999999
748 )))|(% style="width:123px" %)(((
749 Set password
750 )))|(% style="width:109px" %)(((
751 OK
752 )))
753
754 (% style="color:#4472c4" %)**Downlink Command:**
755
756 No downlink command for this feature.
757
758
759 == 3.3  Quit AT Command ==
760
761
762 Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands.
763
764 (% style="color:#4472c4" %)**AT Command: AT+DISAT**
765
766 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:451.989px" %)
767 |=(% style="width: 155px;" %)**Command Example**|=(% style="width: 198px;" %)**Function**|=(% style="width: 96px;" %)**Response**
768 |(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK
769
770 (% style="color:#4472c4" %)**Downlink Command:**
771
772 No downlink command for this feature.
773
774
775 == 3.4  Enable / Disable Alarm ==
776
777
778 Feature: Enable/Disable Alarm for open/close event. Default value 0.
779
780 (% style="color:#4472c4" %)**AT Command:**
781
782 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
783 |=(% style="width: 157px;" %)**Command Example**|=(% style="width: 257px;" %)**Function**|=**Response**
784 |(% style="width:157px" %)AT+DISALARM=1|(% style="width:257px" %)End node will only send packet in TDC time.|OK
785 |(% style="width:157px" %)AT+DISALARM=0|(% style="width:257px" %)End node will send packet in TDC time or status change for water leak sensor|OK
786
787 (% style="color:#4472c4" %)**Downlink Command:**
788
789 0xA7 01  ~/~/ Same As AT+DISALARM=1
790
791 0xA7 00  ~/~/ Same As AT+DISALARM=0
792
793
794 == 3.5  Clear count ==
795
796
797 Feature: Clear current door open.
798
799 (% style="color:#4472c4" %)**AT Command:**
800
801 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510.222px" %)
802 |=(% style="width: 155px;" %)**Command Example**|=(% style="width: 266px;" %)**Function**|=(% style="width: 85px;" %)**Response**
803 |(% style="width:155px" %)AT+CLRC|(% style="width:266px" %)Clear the count of door open events.|(% style="width:85px" %)OK
804
805 (% style="color:#4472c4" %)**Downlink Command:**
806
807 0xA6 01  ~/~/ Same As AT+ CLRC
808
809
810 == 3.6  Set system time ==
811
812
813 Feature: Set system time, Unix format. [[See here for format detail.>>||anchor="H2.4.1A0UnixTimeStamp"]]
814
815 (% style="color:#4472c4" %)**AT Command:**
816
817
818 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
819 |=**Command Example**|=**Function**|=**Response**
820 |AT+TIMESTAMP=1611104352|Set System time to 2021-01-20 00:59:12|OK
821
822 (% style="color:#4472c4" %)**Downlink Command:**
823
824 0x306007806000  ~/~/ Set timestamp to 0x(6007806000),Same as AT+TIMESTAMP=1611104352
825
826
827 == 3.7  Set Time Sync Mode ==
828
829
830 (((
831 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
832 )))
833
834 (((
835 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.
836 )))
837
838
839 (% style="color:#4472c4" %)**AT Command:**
840
841 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
842 |=**Command Example**|=**Function**|=**Response**
843 |AT+SYNCMOD=1|Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.|OK
844 |AT+SYNCMOD=1,8|Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.|OK
845 |AT+SYNCMOD=1,-12|Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.|OK
846
847 (% style="color:#4472c4" %)**Downlink Command:**
848
849 0x28 01  ~/~/ Same As AT+SYNCMOD=1
850
851 0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
852
853 0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
854
855 0x28 00  ~/~/ Same As AT+SYNCMOD=0
856
857
858 == 3.8  Alarm Base on Timeout ==
859
860
861 LWL03A can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc.
862
863 User configure this feature by using:
864
865 (% style="color:#4472c4" %)**AT Command to configure:**
866
867 * (% style="color:red" %)**AT+TTRIG=1,30** (%%) **~-~->** When status change from no leak to leak, and device keep in leak status for more than 30 seconds. LWL03A will send an uplink packet, the Alarm bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
868
869 * (% style="color:red" %)**AT+TTRIG=0,30**(%%)  **~-~->** When status change from leak to no leak, and device keep in no leak status for more than 30 seconds. LWL03A will send an uplink packet, the Alarm bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
870
871 * (((
872 (% style="color:red" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
873 )))
874
875 (((
876 (% style="color:#4472c4" %)**Downlink Command to configure:**
877 )))
878
879 (((
880 **Command: (% style="color:red" %)0xA9 aa bb cc(%%)**
881 )))
882
883 (((
884 **A9:** Command Type Code
885 )))
886
887 (((
888 **aa:** status to be monitored
889 )))
890
891 (((
892 **bb cc:** timeout.
893 )))
894
895
896 (((
897 If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
898 )))
899
900 (((
901 Or
902 )))
903
904 (((
905 0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
906 )))
907
908
909 == 3.9 The working mode of the total water leakage event ==
910
911
912 (% style="color:#4472c4" %)**AT Command to configure:**
913
914 * (% style="color:red" %)**AT+COUNTMOD=0** (%%)**~-~->** Default Value, Total leak events since factory.
915
916 * (% style="color:red" %)**AT+COUNTMOD=1** (%%)**~-~->** Total leak events since last TDC uplink.
917
918 (% style="color:#4472c4" %)**Downlink Command to configure:**
919
920 Command: (% style="color:red" %)**0x0B aa**
921
922 **0B:** Command Type Code
923
924 **aa:** mod
925
926
927 If user send 0x0B 01: equal to AT+COUNTMOD=1
928
929 Or
930
931 0x0B 00: Equal to AT+COUNTMOD=0
932
933
934 == 3.10 Regularly update a confirm uplink when water leaks ==
935
936
937 (% style="color:#4472c4" %)**AT Command to configure:**
938
939 * (% style="color:red" %)**AT+LEAKALARM=10** (%%)**~-~->** Default Value, A periodically update at every 10 minutes when in water leak.
940
941 * (% style="color:red" %)**AT+LEAKALARM=0**   (%%)**~-~->** Disable a periodically update when in water leak.
942
943 (% style="color:#4472c4" %)**Downlink Command to configure:**
944
945 Command: (% style="color:red" %)**0x0C aa**
946
947 **0C:** Command Type Code
948
949 **aa:** uplink interval
950
951
952 If user send 0x0C 0A: equal to AT+LEAKALARM=10
953
954 Or
955
956 0x0C 00: Equal to AT+LEAKALARM=0.
957
958
959 == 3.11 Delay time for state changes to take effect ==
960
961
962 (% style="color:#4472c4" %)**AT Command to configure:**
963
964 * (% style="color:red" %)**AT+DETEDELAY=50** (%%)**~-~->** Default Value, Set state change, valid signal is 50ms.
965
966 * (% style="color:red" %)**AT+DETEDELAY=0**  (%%) **~-~->** Disable valid signal detection..
967
968 (% style="color:#4472c4" %)**Downlink Command to configure:**
969
970 Command: (% style="color:red" %)**0x0D aa bb**
971
972 **0D:** Command Type Code
973
974 **aa bb:** timeout
975
976
977 If user send 0x0D 00 32: equal to AT+DETEDELAY=50
978
979 Or
980
981 0x0D 00 00: Equal to AT+DETEDELAY=0.
982
983
984 == 3.12 Print data entries base on page ==
985
986
987 Feature: Print the sector data from start page to stop page (max is 400 pages).
988
989 (% style="color:#4472c4" %)**AT Command: AT+PDTA**
990
991 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
992 |=**Command Example**|=**Response**
993 |AT+PDTA=1,1|(((
994 Stop Tx events when read sensor data
995
996 8016000 22/10/28 00:39:05 bat:3627 status:leak    leak_times:0 last_leak_duration:0 alarm:false
997
998 8016010 22/10/28 00:48:57 bat:3633 status:leak    leak_times:0 last_leak_duration:0 alarm:false
999
1000 8016020 22/10/28 00:58:57 bat:3633 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1001
1002 8016030 22/10/28 01:08:57 bat:3635 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1003
1004 8016040 22/10/28 01:11:40 bat:3635 status:no_leak leak_times:0 last_leak_duration:32 alarm:false
1005
1006 8016050 22/10/28 01:12:12 bat:3633 status:leak    leak_times:1 last_leak_duration:32 alarm:false
1007
1008 8016060 22/10/28 01:12:22 bat:3633 status:no_leak leak_times:1 last_leak_duration:0 alarm:false
1009
1010 8016070 22/10/28 02:31:54 bat:3630 status:no_leak leak_times:0 last_leak_duration:0 alarm:false
1011
1012 Start Tx events
1013
1014 OK
1015 )))
1016
1017 (% style="color:#4472c4" %)**Downlink Command:**
1018
1019 No downlink command for this feature.
1020
1021
1022 == 3.13 Print last few data entries ==
1023
1024
1025 Feature: Print the last few data entries
1026
1027 (% style="color:#4472c4" %)**AT Command: AT+PLDTA**
1028
1029 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
1030 |=**Command Example**|=**Response**
1031 |AT+PLDTA=10|(((
1032 Stop Tx events when read sensor data
1033
1034 1 22/10/29 09:58:45 bat:3620 status:no_leak leak_times:0 last_leak_duration:7 alarm:false
1035
1036 2 22/10/31 00:51:04 bat:3641 status:no_leak leak_times:0 last_leak_duration:0 alarm:false
1037
1038 3 22/10/31 00:56:52 bat:3643 status:leak    leak_times:1 last_leak_duration:0 alarm:false
1039
1040 4 22/10/31 00:58:40 bat:3641 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1041
1042 5 22/10/31 00:59:22 bat:3641 status:no_leak leak_times:0 last_leak_duration:0 alarm:false
1043
1044 6 22/10/31 01:01:50 bat:3641 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1045
1046 7 22/10/31 01:02:22 bat:3641 status:leak    leak_times:1 last_leak_duration:0 alarm:false
1047
1048 8 22/10/31 02:20:40 bat:3627 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1049
1050 9 22/10/31 02:34:59 bat:3627 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1051
1052 10 22/10/31 02:45:55 bat:3625 status:leak    leak_times:0 last_leak_duration:0 alarm:false
1053
1054 Start Tx events
1055
1056 OK
1057 )))
1058
1059 (% style="color:#4472c4" %)**Downlink Command:**
1060
1061 No downlink command for this feature.
1062
1063
1064 == 3.14  Clear Flash Record ==
1065
1066
1067 (((
1068 Feature: Clear flash storage for data log feature.
1069 )))
1070
1071 (((
1072 (% style="color:#4472c4" %)**AT Command: AT+CLRDTA**
1073
1074
1075 (% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:500px" %)
1076 |=(% style="width: 157px;" %)**Command Example**|=(% style="width: 169px;" %)**Function**|=**Response**
1077 |(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK
1078 )))
1079
1080
1081 (((
1082 (% style="color:#4472c4" %)**Downlink Command:**
1083 )))
1084
1085 (((
1086 Example: 0xA301  ~/~/  Same as AT+CLRDTA
1087 )))
1088
1089
1090 = 4. Battery & Power Consumption =
1091
1092
1093 LWL03A uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1094
1095 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1096
1097
1098 = 5.  FAQ =
1099
1100 == 5.1  How to use AT Command to configure LWL03A ==
1101
1102
1103 LWL03A UART connection photo
1104
1105
1106 [[image:1654757007713-791.png]]
1107
1108
1109 (((
1110 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LWL03A. LWL03A will output system info once power on as below:
1111 )))
1112
1113
1114 [[image:image-20220609144231-3.png||height="644" width="922"]]
1115
1116
1117 == 5.2  How to upgrade the firmware? ==
1118
1119
1120 A new firmware might be available for:
1121
1122 * Support new features
1123
1124 * For bug fix
1125
1126 * Change LoRaWAN bands.
1127
1128 Instruction for how to upgrade: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome||anchor="H2.HardwareUpgradeMethodSupportList"]]
1129
1130 Firmware location: [[https:~~/~~/www.dropbox.com/sh/23v29gi61jq9mp6/AABgwJQ_xuybFivgbDZwTyNGa?dl=0>>url:https://www.dropbox.com/sh/23v29gi61jq9mp6/AABgwJQ_xuybFivgbDZwTyNGa?dl=0]]
1131
1132
1133 == 5.3  How to change the LoRa Frequency Bands/Region? ==
1134
1135
1136 (((
1137 Users can follow the introduction for how to upgrade image. When downloading the images, choose the required image file for download.
1138 )))
1139
1140
1141 = 6.  Order Info =
1142
1143
1144 (% style="color:red" %)**Notice: LWL03A includes a one meter water leak cable, If user want to extend the lenght, please choose Water Leak Cable DR-WLN-XXX.**
1145
1146 **Water Leak Controller Part Number: (% style="color:blue" %)LWL03A-XXX(%%)**
1147
1148 (% style="color:blue" %)**XXX**:
1149
1150 * (% style="color:red" %)**EU433**(%%): frequency bands EU433
1151 * (% style="color:red" %)**EU868**(%%): frequency bands EU868
1152 * (% style="color:red" %)**KR920**(%%): frequency bands KR920
1153 * (% style="color:red" %)**CN470**(%%): frequency bands CN470
1154 * (% style="color:red" %)**AS923**(%%): frequency bands AS923
1155 * (% style="color:red" %)**AU915**(%%): frequency bands AU915
1156 * (% style="color:red" %)**US915**(%%): frequency bands US915
1157 * (% style="color:red" %)**IN865**(%%): frequency  bands IN865
1158 * (% style="color:red" %)**CN779**(%%): frequency bands CN779
1159
1160 **Water Leak Cable Part Number: (% style="color:blue" %)DR-WLN-XXX(%%)**
1161
1162 (% style="color:blue" %)**XXX:**
1163
1164 * (% style="color:red" %)**1M : **(%%)1 meter water leak cable
1165 * (% style="color:red" %)**5M : **(%%)5 meters water leak cable
1166 * (% style="color:red" %)**10M: **(%%)10 meters water leak cable
1167
1168
1169
1170 = 7.  ​Packing Info =
1171
1172
1173 **LWL03A Package Includes**:
1174
1175 * LWL03A x 1
1176 * 1 x 1m water lead cable
1177 * 1 x termination end
1178
1179
1180
1181 = 8.  ​Support =
1182
1183
1184 * 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.
1185
1186 * 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:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]].
1187
1188
1189

Applications

Navigation

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