Version 81.1 by Dilisi S on 2025/01/30 02:31
Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:image-20220927133941-2.png]]
5
6
7
8
9
10
11
12
13 **Table of Contents:**
14
15 {{toc/}}
16
17
18
19
20
21
22
23
24
25 = 1. Introduction =
26
27 == 1.1 What is the LWL02 LoRaWAN Water Leak Sensor ==
28
29
30 The Dragino LWL02 is a (% style="color:#4f81bd" %)**LoRaWAN Water Leak Sensor**(%%) equipped with two external metal probes. When water is detected between the two metal probes, the LWL02 identifies a water leak and sends an uplink to the registered LoRaWAN network server.
31
32 The LWL02 is powered by (% style="color:#4f81bd" %)**2 x AAA batteries**(%%) and is designed for long-term use. These two batteries can support approximately 16,000 to 70,000 uplink packets, resulting in a battery life of 2 to 10 years. Once the batteries are depleted, users can easily open the enclosure and replace them with standard AAA batteries.
33
34 The LWL02 sends data periodically every day and also for each water leak event. It records the number of water leak occurrences and calculates the duration of the most recent leak. Users can disable uplinks for each individual water leak event if desired. In this case, the device will count each event and send the data periodically.
35
36 Each LWL02 comes preloaded with a unique set of key/EUIs for LoRaWAN registration. By registering these keys to the LoRaWAN network server, the device will automatically connect upon powering on.
37
38 (((
39
40 )))
41
42 [[image:image-20220927113420-3.png]]
43
44
45 == 1.2 Features ==
46
47
48 * **LoRaWAN Class A v1.0.3**
49 * **Frequency Bands:** CN470, EU433, KR920, US915, EU868, AS923, AU915, IN865, RU864
50 * **SX1262 LoRa Core**
51 * **Water Leak Detection**
52 * **2 x AAA LR03 Batteries**
53 * **AT Commands** to change parameters
54 * **Periodic Uplink** and uplink triggered by open/close actions
55 * **Remote Configuration** of parameters via LoRa Downlink
56 * **Firmware Upgradable** via programming port
57
58 == 1.3 Storage & Operation Temperature ==
59
60
61 -10 ~~ 50 °C  or -40 ~~ 60 °C (depending on the battery type; see [[FAQ>>||anchor="H7.6Whyiseedifferentworkingtemperatureforthedevice3F"]])
62
63
64 == 1.4 Applications ==
65
66
67 * Smart Buildings & Home Automation
68 * Logistics and Supply Chain Management
69 * Smart Metering
70 * Smart Agriculture
71 * Smart Cities
72 * Smart Factory
73
74 == 1.5 Dimensions ==
75
76
77 [[image:image-20220608143952-2.png]]
78
79
80 [[image:1654670405145-346.png]]
81
82
83 == 1.6 Firmware Change log ==
84
85
86 (((
87 The LWL02 uses the same firmware as the LDS01:  [[https:~~/~~/www.dropbox.com/sh/6ls5i0zsvujvbc8/AABe3V5aQXdy7zSxEdEA3DHOa?dl=0>>https://www.dropbox.com/sh/6ls5i0zsvujvbc8/AABe3V5aQXdy7zSxEdEA3DHOa?dl=0]]
88 )))
89
90
91 = 2. Power ON LWL02 =
92
93
94 When you receive the LWL02, open the enclosure and insert 2 AAA batteries to power it on. The [[LED>>||anchor="H4.7LEDs"]] will blink when the device is powered.
95
96
97 = 3. How to install LWL02 =
98
99
100 **Fixing with screws:**
101
102 * Detach the bottom lid of the enclosure. You will notice two holes on the bottom lid for inserting screws. First, attach the bottom lid to the surface using screws. Then snap the top part of the enclosure onto the bottom. You will hear a clicking sound once they are securely fitted together.
103
104 [[image:image-20231222114059-1.jpeg||height="412" width="624"]]
105
106
107 **Fixing with double-sided adhesive pads:**
108
109 * A double-sided adhesive pad is included with the LWL02. First remove the protective backing of one side only. Then affix it on the bottom of the sensor enclosure. Once the tape is in place, remove the remaining protective backing and secure the enclosure to the surface.
110
111 [[image:image-20231222114211-2.jpeg||height="409" width="613"]]
112
113
114 (((
115 When installing the LWL02 on a wall, please follow the instructions as shown in the image below to ensure the water leak probe is submerged in water for detection purposes. The LWL02 main body is not waterproof, so please avoid allowing water to enter the main body.
116
117
118 )))
119
120 [[image:image-20220608144447-4.png]]
121
122
123 = 4. Operation Mode =
124
125 == 4.1 How It works? ==
126
127
128 (((
129 The LDS02 is configured as a LoRaWAN Class A device by default. It contains a DevEUI, AppEUI, and AppKey, which allow it to join a LoRaWAN network using OTAA (Over-The-Air Activation). To connect the LWL02 to a LoRaWAN network, you need to configure these keys and identifiers with the LoRaWAN network server first, and then [[power on>>||anchor="H2.PowerONLWL02"]] the LWL02. The device will automatically join the network using OTAA. This device information can be found in your package, printed on a sticker.
130
131
132 [[image:image-20230426084834-1.png||height="239" width="515"]]
133
134
135 )))
136
137 (((
138 If you cannot set the device registration information, such as the DevEUI, AppEUI, and AppKey, in the network server, you must use the information generated by the network server, which differs from the information already stored on the device. In this case, you can use [[AT Command>>||anchor="H6.UseATCommand"]] to write the new information to the device.
139 )))
140
141
142 == 4.2 Example to joining a LoRaWAN network ==
143
144
145
146 The following figure shows how the LWL02 connects to [[The Things Stack>>url:https://eu1.cloud.thethings.network/]]. The LWL02 sends messages (uplinks) to The Things Stack via a LoRaWAN gateway (e.g., Dragino LPS8N) and can also receive messages (downlinks) from The Things Stack. The Things Stack can be integrated with ThingsEye, allowing it to forward uplinks to ThingsEye. ThingsEye is an IoT platform used for visualizing and analyzing sensor data. You can also send downlinks from ThingsEye (via The Things Stack) to the LWL02.
147
148 [[image:image-20220927113401-2.png]]
149
150
151 (((
152 The LWL02 has a water leak detection probe, as shown above. When water is present between the two probes, they will short-circuit and generate a water leak event, sending the status to the LoRaWAN server. The LWL02 uplinks the following types of messages to the server:
153
154 * A keep-alive message, sent once per day.
155 * An emergency event message when a water leak is detected ([[this alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]]).
156 * A periodic update every 10 minutes while in a water leak state.
157 * A message when switching from a water leak state to no water leak ([[this alarm event can be disabled>>||anchor="H7.3CanIdisableuplinkforeacheventtosavebatterylife3F"]]).
158
159 === 4.2.1 Setting up ===
160
161 * Sign up for a free account with [[The Things Stack Sandbox>>url:https://eu1.cloud.thethings.network]] if you do not have one yet.
162 * Log in to your **The Things Stack** account.
163 * Create an **application** with The Things Stack if you do not have one yet.
164 ** On the left navigation, click **Applications**.
165 ** Then click **+ Add Application** button.
166
167 [[image:lwl02-4.png]]
168
169 * On the **Create Application **page, configure the following:
170 ** **Application ID**: Provide a unique identification for your application within The Things Stack.
171 ** **Application name**: (optional) Provide a descriptive name.
172 ** **Description**: (optional) Provide a description.
173 * Click on **Create application **button.
174 )))
175
176
177 [[image:lwl02-5.png]]
178
179
180 * Go to the newly created application and click on the **End devices** in the left menu.
181 * On the End devices page, click on **+ Register end device**.
182
183 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS02%20-%20LoRaWAN%20Door%20Sensor%20User%20Manual/WebHome/lds02-step-5.png?rev=1.1||alt="lds02-step-5.png"]]
184
185
186 * Two registration options are available:
187 ** Using the LoRaWAN Device Repositoty
188 ** Manual registration
189
190 === 4.2.2 Using the LoRaWAN Device Repository ===
191
192 * On the **Register end device** page:
193 ** Select the option **Select the end device in the LoRaWAN Device Repository **under **Input method**.
194 ** Select the **End device brand**, **Model**, **Hardware version**, **Firmware version**, and **Profile (Region)** from the respective dropdown lists.
195 *** **End device brand**: Dragino Technology Co., Limited
196 *** **Model**: LWL02 - Water Leak Sensor
197 *** **Hardware ver**: Unknown
198 *** **Firmware ver**: 1.6
199 *** **Profile (Region)**: Select the region that matches your device.
200 ** Select the **Frequency plan** that matches your device from the **Frequency plan** dropdown list.
201 ** Enter the **AppEUI** in the **JoinEUI** field and click the **Confirm** button. If The Things Stack accepts the JoinEUI you provided, it will display the message 'This end device can be registered on the network.
202
203 [[image:lwl02-1.png]]
204
205
206
207
208 * In the **DevEUI** field, enter the **DevEUI**.
209 * In the **AppKey** field, enter the **AppKey.**
210 * In the **End device ID** field, enter a unique name for your LDS02 within this application.
211 * Under **After registration**, select the **View registered end device** option.
212 * Click **Register end device** button.
213
214
215 [[image:lwl02-2.png]]
216
217
218
219 * You will be navigated to the Device overview page.
220
221 [[image:lwl02-3.png]]
222
223
224 * Click on the Live Data tab and then **Power on** the LWL02. It will first join The Things Stack network server. You can confirm this by looking for the Join-request and Join-accept messages. After successfully joining the network, the LWL02 will start sending uplink messages to The Things Stack, and you can see them in the **Live Data** panel.
225
226 [[image:1654681465260-713.png]]
227
228
229 == 4.3 Uplink Payload ==
230
231
232 The uplink payload is a total of 10 bytes.
233
234 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:732px" %)
235 |(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**2**|(% style="background-color:#4f81bd; color:white; width:60px" %)**1**|(% style="background-color:#4f81bd; color:white; width:100px" %)**3**|(% style="background-color:#4f81bd; color:white; width:110px" %)**3**|(% style="background-color:#4f81bd; color:white; width:153px" %)**1**
236 |value|Status&BAT|(((
237 MOD
238 Always:0x02
239 )))|(% style="width:126px" %)Total_water_leak_events|(% style="width:140px" %)(((
240 Last  water leak duration (unit:min)
241 )))|(% style="width:153px" %)(((
242 Alarm status (Only used in
243 LWL02) Always:0x00
244 )))
245
246 **Example:**
247
248 [[image:1654672186477-234.png]]
249
250
251 (((
252 The **payload decoder** for The Things Stack can be downloaded from:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder/tree/main/LWL02]]
253 )))
254
255
256 == 4.4 Downlink Payload ==
257
258
259 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:505px" %)
260 |=(% style="width: 182px;background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 96px;background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 227px;background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)**
261 |(% style="width:180px" %)TDC (Transmit Time Interval—Keep Alive Interval)|(% style="width:80px" %)0x01|(% style="width:150px" %)4
262 |(% style="width:180px" %)RESET|(% style="width:80px" %)0x04|(% style="width:224px" %)2
263 |(% style="width:180px" %)[[Set confirmed mode>>||anchor="HTypeCode0x05"]]|(% style="width:80px" %)0x05|(% style="width:150px" %)2
264 |(% style="width:180px" %)[[Clear Counting>>||anchor="HTypeCode0xA6"]]|(% style="width:80px" %)0xA6|(% style="width:150px" %)2
265 |(% style="width:180px" %)[[Enable/Disable Alarm>>||anchor="HTypeCode0xA7"]]|(% style="width:80px" %)0xA7|(% style="width:150px" %)2
266 |(% style="width:180px" %)[[Control ADR/DR>>||anchor="HTypeCode0xA8"]]|(% style="width:80px" %)0xA8|(% style="width:150px" %)3
267 |(% style="width:180px" %)[[Set Alarm Timeout>>||anchor="HTypeCode0xA9"]]|(% style="width:80px" %)0xA9|(% style="width:150px" %)4
268
269 The following image illustrates how to send a downlink payload from The Things Stack.
270
271 [[image:1654673412319-976.png]]
272
273
274 === (% style="color:#037691" %)**Type Code 0x01**(%%) ===
275
276 For example, if the payload is **0100003C**, the LWL02's Keep Alive interval is set to **0x00003C (60 seconds)**.
277
278
279 === (% style="color:#037691" %)**Type Code 0x04**(%%) ===
280
281 For example, if the payload is **0x04FF**, it **resets** the LWL02.
282
283
284 === (% style="color:#037691" %)**Type Code 0x05**(%%) ===
285
286 * The payload **0x05 00** sets the uplink to LoRaWAN **unconfirmed** mode.
287 * The payload **0x05 01** sets the uplink to LoRaWAN **confirmed** mode
288
289 === (% style="color:#037691" %)**Type Code 0xA6**(%%) ===
290
291 The payload **0xA601** is used to "**clear the counting**." For the LWL02, it resets both the count numbers and the time.
292
293
294 === (% style="color:#037691" %)**Type Code 0xA7**(%%) ===
295
296 * The payload **0xA7 01** is equivalent to **AT+DISALARM=1**.
297 * The payload **0xA7 00** is Equivalent to **AT+DISALARM=0**.
298
299 === (% style="color:#037691" %)**Type Code 0xA8**(%%) ===
300
301 **Downlink Payload Format**: 0xA8 AA BB
302
303 * **0xA8**: Type code
304 * **AA**:
305 ** **1**: Enable ADR
306 ** **0**: Disable ADR (same as the **AT+CADR** command)
307 * **BB**: Set DR (same as **AT+CDATARATE**; only valid after ADR = 0)
308
309 **Example**: 0xA8 00 02: Set ADR = 0 and DR = 2
310
311
312 === (% style="color:#037691" %)**Type Code 0xA9**(%%) ===
313
314 For more information, see [[Alarm Base Timeout>>||anchor="H4.6AlarmBaseonTimeout"]].
315
316
317 == 4.5 Integrate with IoT Platforms ==
318
319 The Things Stack can be integrated with many IoT platforms, including ThingsEye and Datacake, for visualizing and analyzing data coming from the LWL02. Most of these IoT platforms also support sending downlinks to the LWL02.
320
321 === 4.5.1 Integrate with ThingsEye ===
322
323 The Things Stack application supports integration with ThingsEye.io. Once integrated, ThingsEye.io acts as an MQTT client for The Things Stack MQTT broker, allowing it to subscribe to upstream traffic and publish downlink traffic.
324
325 ==== 4.5.1.1 Configuring The Things Stack ====
326
327 We use The Things Stack Sandbox in this example:
328
329 * In **The Things Stack Sandbox**, go to the **Application **for the LWL02 you added.
330 * Select **MQTT** under **Integrations** in the left menu.
331 * In the **Connection information **section, under **Connection credentials**, The Things Stack displays an auto-generated **username**. You can use it or provide a new one.
332 * Click the **Generate new API key** button to generate a password. You can view it by clicking on the **visibility toggle/eye** icon. The API key works as the password.
333
334 {{info}}
335 The username and  password (API key) you created here are required in the next section.
336 {{/info}}
337
338 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/tts-mqtt-integration.png?rev=1.1||alt="tts-mqtt-integration.png"]]
339
340
341 ==== 4.5.1.2 Configuring ThingsEye.io ====
342
343 The ThingsEye.io IoT platform is not open for self-registration at the moment. If you are interested in testing the platform, please send your project information to [[admin@thingseye.io>>mailto:admin@thingseye.io]], and we will create an account for you.
344
345 * Login to your [[ThingsEye.io >>url:https://thingseye.io]]account.
346 * Under the **Integrations center**, click **Integrations**.
347 * Click the **Add integration** button (the button with the **+** symbol)
348
349
350 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-1.png?rev=1.2||alt="thingseye-io-step-1.png"]]
351
352
353 On the **Add integration** window, configure the following:
354
355 **Basic settings:**
356
357 * Select **The Things Stack Community** from the **Integration type** list.
358 * Enter a suitable name for your integration in the **Name **text** **box or keep the default name.
359 * Ensure the following options are turned on.
360 ** Enable integration
361 ** Debug mode
362 ** Allow creating devices or assets
363 * Click the **Next** button. you will be navigated to the **Uplink data converter** tab.
364
365
366 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-2.png?rev=1.1||alt="thingseye-io-step-2.png"]]
367
368
369 **Uplink data converter:**
370
371 * Click the **Create new** button if it is not selected by default.
372 * Enter a suitable name for the uplink data converter in the **Name **text** **box or keep the default name.
373 * Click the **JavaScript** button.
374 * Paste the uplink decoder function into the text area (first, delete the default code). The demo uplink decoder function can be found [[here>>url:https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js]].
375 * Click the **Next** button. You will be navigated to the **Downlink data converter **tab.
376
377
378 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-3.png?rev=1.1||alt="thingseye-io-step-3.png"]]
379
380
381 **Downlink data converter (this is an optional step):**
382
383 * Click the **Create new** button if it is not selected by default.
384 * Enter a suitable name for the downlink data converter in the **Name **text** **box or keep the default name.
385 * Click the **JavaScript** button.
386 * Paste the downlink decoder function into the text area (first, delete the default code). The demo downlink decoder function can be found [[here>>url:https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js]].
387 * Click the **Next** button. You will be navigated to the **Connection** tab.
388
389
390
391 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-4.png?rev=1.1||alt="thingseye-io-step-4.png"]]
392
393
394 **Connection:**
395
396 * Choose **Region** from the **Host type**.
397 * Enter the **cluster** of your **The Things Stack** in the **Region** textbox. You can find the cluster in the url (e.g., https:~/~/**eu1**.cloud.thethings.network/...).
398 * Enter the **Username** and **Password** of the MQTT integration in the **Credentials** section. The **username **and **password **can be found on the MQTT integration page of your The Things Stack account (see **4.5.1.1 Configuring The Things Stack**).
399 * Click the **Check connection** button to test the connection. If the connection is successful, you will see the message saying **Connected**.
400
401
402 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/message-1.png?rev=1.1||alt="message-1.png"]]
403
404
405
406 * Click the **Add** button.
407
408
409 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-io-step-5.png?rev=1.1||alt="thingseye-io-step-5.png"]]
410
411
412 Your integration has been added to the** Integrations** list and will be displayed on the **Integrations** page. Check whether the status is shown as **Active**. If not, review your configuration settings and correct any errors.
413
414
415 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye.io_integrationsCenter_integrations.png?rev=1.2||alt="thingseye.io_integrationsCenter_integrations.png"]]
416
417
418 ==== 4.5.1.3 Viewing integration details ====
419
420 Click on your integration from the list. The **Integration details** window will appear with the **Details **tab selected. The **Details **tab shows all the settings you have provided for this integration.
421
422
423 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/integration-details.png?rev=1.1||alt="integration-details.png"]]
424
425
426 If you want to edit the settings you have provided, click on the **Toggle edit mode** button. Once you have done click on the **Apply changes **button.
427
428 {{info}}
429 See also [[ThingsEye documentation>>url:https://wiki.thingseye.io/xwiki/bin/view/Main/]].
430 {{/info}}
431
432
433 ==== 4.5.1.4 Viewing events ====
434
435 The **Events **tab displays all the uplink messages from the LWL02.
436
437 * Select **Debug **from the **Event type** dropdown.
438 * Select the** time frame** from the **time window**.
439
440
441
442 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LT-22222-L/WebHome/thingseye-events.png?rev=1.1||alt="thingseye-events.png"]]
443
444
445 * To view the **JSON payload** of a message, click on the **three dots (...)** in the **Message** column of the desired message.
446
447
448 [image coming soon]
449
450
451 ==== 4.5.1.5 Deleting an integration ====
452
453 If you want to delete an integration, click the **Delete integration** button on the Integrations page.
454
455
456 ==== 4.5.1.6 Viewing sensor data on a dashboard ====
457
458 You can create a dashboard with ThingsEye to visualize the sensor data coming from the LWL02. The following image shows a dashboard created for the LWL02. See **Creating a dashboard** in ThingsEye documentation for more information.
459
460
461
462 [[image:Screenshot 2025-01-28 at 20.40.24.png]]
463
464
465 == 4.5.2 Integrate with Datacake ==
466
467
468 (((
469 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:
470 )))
471
472
473 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the network at this time.
474
475 (% 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:
476
477
478 [[image:1654674520913-519.png]]
479
480
481 [[image:1654674530910-914.png]]
482
483
484 [[image:1654674543078-401.png]]
485
486
487 (% style="color:blue" %)**Step 3**(%%): Create an account or log in Datacake.
488
489 (% style="color:blue" %)**Step 4**(%%): Search LWL02 and add DevEUI.
490
491 [[image:1654674556510-911.png]]
492
493
494 == 4.6 Alarm Based on Timeout ==
495
496
497 (((
498 The LWL02 can monitor the timeout for a status change. This feature can be used to monitor events, such as the duration of water leakage, and more.
499
500 (% style="color:red" %)**(This command is specifically applicable to LDS02. For the LWL02, this command can only enable the alarm, but the alarm time is fixed at 10 minutes）**
501 )))
502
503 (((
504 You can configure this feature using the following:
505 )))
506
507 (((
508
509 )))
510
511 (((
512 **AT Command Configuration:**
513
514 * (% style="color:red" %)**AT+TTRIG=1,30**(%%) ~-~-> When the status changes from "**close**" to "**open**," the LWL02 remains in the "**open**" status for more than 30 seconds. Then it will send an uplink packet. The alarm bit (the lowest bit of the 10th byte of the payload) in this uplink packet is set to 1.
515 * (% style="color:red" %)**AT+TTRIG=0,0**(%%) ~-~-> Default value, disables the timeout alarm.
516
517
518 )))
519
520 (((
521 **Downlink Command Configuration:**
522
523 **Command**: 0xA9 AA BB CC
524
525 * **0xA9**: Type Code
526 * **AA**: Status to be monitored
527 * **BB CC**: Timeout
528
529 If you send **0xA9 01 00 1E**, it is equivalent to **AT+TTRIG=1,30**.
530
531 Or, if you send** 0xA9 00 00 00**, it is equivalent to **AT+TTRIG=0,0** (disables the timeout alarm).
532 )))
533
534 (((
535
536 )))
537
538 == 4.7 LED Indicators ==
539
540
541 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:463px" %)
542 |=(% style="width: 186px;background-color:#4F81BD;color:white" %)**Action**|=(% style="width: 277px;background-color:#4F81BD;color:white" %)**LED behavior**
543 |(% style="width:184px" %)Power On|(% style="width:275px" %)(% style="color:green" %)**GREEN LED on for 1s, **(% style="color:red" %)**RED LED on for 1s,**(%%)** (% style="color:blue" %)BLUE LED on for 1s(%%)**
544 |(% style="width:184px" %)Joined successfully|(% style="width:275px" %)(% style="color:green" %)**GREEN LED **(%%)on for 5s
545 |(% style="width:184px" %)Send an uplink message|(% style="width:275px" %)(% style="color:green" %)**GREEN LED**(%%) blinks once
546 |(% style="width:184px" %)Receive a downlink message|(% style="width:275px" %)(% style="color:blue" %)**BLUE LED**(%%) blinks once
547
548 = 5. Battery =
549
550
551 The LWL02 is equipped with 2 AAA LR03 batteries.
552
553
554 == 5.1 Replacing Batteries ==
555
556
557 (((
558 The LDS02 is equipped with 2 x AAA LR03 batteries. If the batteries are running low (showing 2.1V on the platform), the user can buy generic AAA batteries and replace them.
559
560 **Note:**
561
562 1. The LDS02 doesn’t have any screws; you can use a nail to open it from the middle.
563 1. Make sure the direction is correct when installing the AAA batteries.
564
565 **Important Note: **Ensure you use new AAA LR03 batteries, and that the battery surfaces are not damaged.
566
567
568 Example of AAA LR03 battery:
569 )))
570
571 [[image:1654675278044-307.png]]
572
573
574 == 5.2 Power Consumption Analysis ==
575
576
577 (((
578
579
580 Dragino battery-powered products all run in Low Power mode. You can refer to the guidelines from this [[**link**>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf]] to estimate battery life.
581 )))
582
583 = 6. Use AT Commands =
584
585 == 6.1 Access AT Commands ==
586
587
588 The LWL02 supports an AT command set. You can use a USB to TTL adapter to configure the LWL02 via AT commands, as shown below.
589
590 [[image:image-20221226104917-1.png||height="557" width="850"]]
591
592
593 (((
594 On the PC, the user needs to set the **serial tool** (such as [[PuTTY>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]] or SecureCRT) baud rate to **115200** to access the serial console of the LWL02. Below is the output for reference:
595 )))
596
597 (((
598 The AT command access password is (% style="color:red" %)**123456**.
599 )))
600
601 [[image:1654675618022-630.png]]
602
603
604 (((
605 Each AT command needs to have an **ENTER** key pressed at the end before sending.
606
607 When entering the first command, the **RED LED** will turn on, and the user can now input AT commands. After entering all the required AT commands, input **AT+CLPM=1** to set the device to Low Power mode, and the **RED LED** will turn off.
608
609 More details can be found in the [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/]].
610 )))
611
612 (((
613 [[url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS01/]]
614 )))
615
616
617 = 7. FAQ =
618
619 == 7.1 How to upgrade the image? ==
620
621
622 You can upgrade the LWL02 for bug fixes, new features, or to change the working region. The upgrade instructions are here: [[LDS02/LWL02 Update method>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS02%20-%20LoRaWAN%20Door%20Sensor%20User%20Manual/#H7.1Howtoupgradetheimage3F]].
623
624
625 == 7.2 How to change the LoRa Frequency Bands/Region? ==
626
627
628 If you have the US915 frequency and want to change it to the AS923 frequency, you can follow the instructions for upgrading the image in [[how to upgrade image>>||anchor="H7.1Howtoupgradetheimage3F"]] section. When downloading the image, select the required file.
629
630
631
632 == 7.3 Can I disable uplinks for each event to save battery life? ==
633
634
635 Yes, you can use one of the method below:
636
637
638 **Via AT Command**:
639
640 **AT+DISALARM=1** : The end node will only send packets during the TDC time.
641
642 **AT+DISALARM=0** : The end node will send packets either during the TDC time or when there is a status change in the door sensor.
643
644
645 **Via LoRaWAN downlink Command**:
646
647 **0xA701** : Equivalent to AT+DISALARM=1
648
649 **0xA700** : Equivalent to AT+DISALARM=0
650
651
652
653 == 7.4 How can I change the Subband for LWL02? ==
654
655
656 **Before v1.6 firmware:**
657 LDS02 operates in Subband 2 by default in the AU915/US915 band. If the LoRaWAN server operates on another subband, LDS02 may have trouble joining the server. In this case, the user can use the AT command to change the subband. See the AT Command chapter for hardware connection details. Below are the steps to change the subband:
658
659 1. Press the reset button.
660 1. Send the password **123456**.
661 1. Send the command: **AT+CFREQBANDMASK=0006** (use 0001 for Subband 1, 0002 for Subband 2, etc.).
662 1. Press the reset button to restart and switch to the new subband.
663
664 Example output:
665
666 (% class="mark small" %)[3369]DRAGINO LWL01 Device
667 [3370]Frequency Band: US915 v1.5
668 [3373]OTAA
669 [3374]DevEui= 7896785455246354
670 [3377]class type A
671 [3379]freq mode intra(%%)
672 (% class="mark mark small small" %)[3381]**scan chn mask 0x0002   ~-~-> use subband 2**
673
674 (% class="mark small" %)LM502:~~# [10793]txDone
675 123456       ~-~-> ENTER PASSWORD
676 Correct Password
677
678 (% class="mark small" %)[105115]rxTimeOut
679 **AT+CFREQBANDMASK=0001   ~-~-> Change to Subband1**
680 OK
681
682 (% class="mark small" %)[3371]DRAGINO LWL01 Device
683 [3373]Frequency Band: US915 v1.5
684 [3376]OTAA
685 [3377]DevEui= 7896785455246354
686 [3380]class type A
687 [3382]freq mode intra
688 [3384]**scan chn mask 0x0001  ~-~-> reboot and works on Subband1 now**
689
690
691 **Since firmware v1.6:**
692
693 LDS02 works with the channel mask 0x0000, which covers all subbands. Therefore, there is no need to use AT commands to change the subband, and it will work for every subband.
694
695
696
697 == 7.5 My sensor worked for Helium AU915 before, but now it doesn't work. Why? ==
698
699
700
701 This is a sub-band issue. See chapter 7.4. Helium changed the sub-band for AU915 from subband 2 to subband 6, which caused the sensor to stop working.
702
703
704 == 7.6 Why do I see different working temperatures for the device? ==
705
706
707 The working temperature range of the device depends on the battery the user chooses.
708
709 * A standard AAA battery can support a working range of -10°C to 50°C.
710 * A special AAA battery can support a working range of -40°C to 60°C. For example, [[Energizer L92>>url:https://data.energizer.com/pdfs/l92.pdf]][[url:https://data.energizer.com/pdfs/l92.pdf]]
711
712 = 8. Ordering Information =
713
714
715 **Part Number: (% style="color:blue" %)LWL02-XXX(%%)**
716
717 (% style="color:blue" %)**XXX:**
718
719 * (% style="color:red" %)**EU433**(%%): frequency  bands EU433
720 * (% style="color:red" %)**EU868**(%%): frequency  bands EU868
721 * (% style="color:red" %)**KR920**(%%): frequency  bands KR920
722 * (% style="color:red" %)**CN470**(%%): frequency bands CN470
723 * (% style="color:red" %)**AS923**(%%): frequency  bands AS923
724 * (% style="color:red" %)**AU915**(%%): frequency bands AU915
725 * (% style="color:red" %)**US915**(%%): frequency bands  US915
726 * (% style="color:red" %)**IN865**(%%):  frequency bands  IN865
727
728 = 9. Packaging Information =
729
730
731 **Package Includes**:
732
733 * LWL02 x 1
734
735 = 10. Support =
736
737
738 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different time zones, we cannot offer live support. However, your questions will be answered as soon as possible during the aforementioned hours.
739 * Please provide as much information as possible regarding your inquiry (e.g., product models, a detailed description of the problem, and steps to replicate it), and send an email to  [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].
740
741

Applications

Navigation

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