image-20240907162913-1.png

Table of Contents:

1. Introduction

1.1 What is LWL04 LoRaWAN Water Leak Sensor

The Dragino LWL04 is a LoRaWAN Water Leak Sensor. When there is water between the bottom 3 metal posts, the LWL04 indicates a water leak event and uplink to IoT server via LoRaWAN network.

The Dragino LWL04 does not need to be fixed, only placed on the ground. The bottom three metal columns can adjust the height. Only when there is water between the three metal columns, it will cause a short circuit alarm.

LWL04 can be activated from the bottom of the housing with a magnet, and the light will indicate when the magnet is close. Its main unit has a sealing ring, which can achieve IP65 waterproof.

LWL04 is powered by CR123A non-rechargeable battery and target for long time use, these batteries can provide about 16,000 ~ 70,000 uplink packets, which result in 2 ~ 10 years battery life. After battery running out, user can easily open the enclosure and replace with CR123A batteries.

The LWL04 will send periodically data every day as well as for each water leak event. It also counts the water leak times and calculate last water leak duration. User can also disable the uplink for each water leak event, instead, device can count each event and uplink periodically.

Each LWL04 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.

1.2 Features

  • LoRaWAN Class A v1.0.3
  • Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
  • Water Leak detect
  • Support wireless OTA update firmware
  • Downlink to change configure
  • Uplink on periodically and water leak event
  • CR123A 1500mAh Battery
  • IP65 waterproof

1.3 Storage & Operation Temperature

Support operating temperature -40℃~+85℃, but the extreme temperature will have a certain impact on the battery discharge life.

Note: Storage and operation temperature depends on the battery type, this manual LWL04 shipped original battery as an example, see CR123A RAMWAY BATTERY.

1.4 Applications

  • Smart Factory
  • Smart Buildings & Home Automation

1.5 Sleep mode and working mode

Deep Sleep Mode: Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.

Working Mode: In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.

1.6. Power ON LWL04

The LWL04 is shipped in a battery-mounted condition and the user can activate the LWL04 by simply placing the magnet at the bottom center of the LWL04 for more than 3 seconds.

When the user uses the magnet to get close to the bottom center of the LWL04, the green light is on to indicate successful sensing. Keeping the magnet position still for 3 seconds, the green light is always on for 3 seconds, then the green light blinks rapidly for 5 times, the node activation is successful. Please refer to Magnet action & LEDs for specific LED indication status.

Example diagram of LWL04 activation operation ( Soft magnet operation on the bottom of the node & LED status on the front of the node):

image-20240914175018-1.png

1.7 Magnet action & LEDs

When the magnet is near the bottom center position of LWL04, the green light indicates that the magnet is successfully induced.

Magnet actionFunctionAction
Hold magnet induction  between 1s < time < 3sSend an uplink

If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, blue led will blink once.

Hold magnet induction for more than 3sActive Device

Green led will fast blink 5 times, device will enter OTA mode for 3 seconds. And then start to JOIN LoRaWAN network.
Green led will solidly turn on for 5 seconds after joined in network.

Quickly activate magnet induction 5 timesDeactivate DeviceRed led will solid on for 5 seconds. Means device is in Deep Sleep Mode.

1.8 Pin Definitions

image-20240909154408-3.jpeg   

1.9 Mechanical

image-20240911113233-10.png

image-20240911105106-6.png

2. Configure LWL04 to connect to LoRaWAN network

2.1 How it works?

The LWL04 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the LWL04. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.

2.2 Quick guide to connect to LoRaWAN server (OTAA)

Here shows an example for how to join the TTN V3 Network. Below is the network structure, we use LG308N as LoRaWAN gateway here.  

image-20240907163020-2.png

 

The LG308 is already set to connect to TTN V3 network . What we need to now is only configure the TTN V3:

Step 1: Create a device in TTN V3 with the OTAA keys from LWL04.

Each LWL04 is shipped with a sticker with unique device EUI:

image-20230426084834-1.png

User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:

Create the application.

image-20240907111048-1.png

image-20240907111305-2.png

Add devices to the created Application.

image-20240907111659-3.png

image-20240907111820-5.png

Enter end device specifics manually.

image-20240907112136-6.png

image-20240907112427-7.png

Step 2: Add decoder

In TTN, user can add a custom payload so it shows friendly reading.

Click this link to get the decoder: LWL04 decoder.

Below is TTN screen shot:

image-20240909162501-5.png

image-20240909162647-6.png

Step 3: Power on LWL04 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.

image-20240909163132-8.png

2.3 Uplink Payload

2.3.1 Device Status, FPORT=5

Include device configure status. Once LWL04 Joined the network, it will uplink this message to the server. After that, LWL04 will uplink Device Status every 12 hours.

Users can also use the downlink command(0x26 01) to ask LWL04 to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.

The Payload format is as below.

Device Status (FPORT=5)
Size (bytes)12112
ValueSensor ModelFirmware VersionFrequency BandSub-bandBAT

Example parse in TTN:

image-20240909175405-10.png

Sensor Model: For LWL04, this value is 0x36

Firmware Version: 0x0100, Means: v1.0.0 version

Frequency Band:

0x01: EU868

0x02: US915

0x03: IN865

0x04: AU915

0x05: KZ865

0x06: RU864

0x07: AS923

0x08: AS923-1

0x09: AS923-2

0x0a: AS923-3

0x0b: CN470

0x0c: EU433

0x0d: KR920

0x0e: MA869

Sub-Band:

AU915 and US915:value 0x00 ~ 0x08

CN470: value 0x0B ~ 0x0C

Other Bands: Always 0x00

Battery Info:

Check the battery voltage.

Ex1: 0x0BE3 = 3043mV

Ex2: 0x0B49 = 2889mV

2.3.2  Sensor Configuration, FPORT=4

LWL04 will only send this command after getting the downlink command (0x26 02) from the server.

 Size(bytes)31121
ValueTDC (unit: sec)DisalarmKeep statusKeep time (unit: sec)Leak alarm time

Example parse in TTNv3

image-20240909175910-11.png

  • TDC: (default: 0x001C20)

Uplink interval for the Leak/No leak Event, default value is 0x001C20 which is 7200 seconds = 2 hours.

  • Disalarm: (default: 0)

 If Disalarm = 1, LWL04 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.

 If Disalarm = 0, LWL04 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.

 Note: When Disalarm=0, a high frequently Leak/No leak event will cause lots of uplink and drain battery very fast. 

  • Keep Status & Keep Time

Shows the configure value of Alarm Base on Timeout Feature

  • Leak alarm time

Regularly update a confirm uplink when water leaks, default value is 0x0A which is 10 minutes. 

2.3.3  Real-Time Open/Close Status, Uplink FPORT=2

LWL04 will send this uplink after Device Status once join the LoRaWAN network successfully. AndL WL04 will:

1. periodically send this uplink every 2 hours, this interval can be changed.

2. There is an Leak/No leak event. 

Uplink Payload totals 11 bytes.

Real-Time Open/Close Status, FPORT=2
Size(bytes)1334
ValueStatus & AlarmTotal leak events

Last leak
duration (unit: sec)

Unix TimeStamp

Status & Alarm:

Size(bit)[bit5:bit4]bit3bit2bit1bit0
ValueReserve

Count mod

TDC flag 0:No;1:Yes

Alarm 0: No Alarm;1: Alarm

Status 0: No leak, 1: leak

Example parse in TTNv3

image-20240909180324-12.png

  • Count mod:Default=0

0 : Uplink total leak times since factory

1:  Uplink total leak times since last FPORT=2 uplink. 

  • TDC flag

When the flag is 1, it means sending packets at normal time intervals.

Otherwise, it is a packet sent at non-TDC time. 

  • Alarm

See Alarm Base on Timeout

  • Status

This bit is 1 when the leak sensor is leak and 0 when it is no leak. 

  • Total leak events

Total pulse/counting base on leak.

Range (3 Bytes) : 0x000000 ~ 0xFFFFFF . Max: 16777215

  • Last leak duration

Leak sensor last leak duration.

Unit: sec.

image-20230701102155-1.png

2.3.4  Historical Water Leak/No leak Event, FPORT=3

LWL04 stores sensor values and users can retrieve these history values via the downlink command.

The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time leak/no leak status.

Real-Time Open/Close Status, FPORT=3
Size(bytes)1334
ValueStatus & AlarmTotal leak events

Last leak
duration (unit: sec)

Unix TimeStamp

Status & Alarm:

Size(bit)bit7bit6[bit5:bit4]bit3bit2bit1bit0
ValueReservePoll Message FlagReserve

Count mod

TDC flag 0:No;1:Yes

Alarm 0: No Alarm;1: Alarm

Status 0: No leak, 1: leak
  • Each data entry is 11 bytes and has the same structure as Real-Time open/close status, to save airtime and battery, LWL04 will send max bytes according to the current DR and Frequency bands.

For example, in the US915 band, the max payload for different DR is:

1. DR0: max is 11 bytes so one entry of data

2. DR1: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)

3. DR2: total payload includes 11 entries of data

4. DR3: total payload includes 22 entries of data.

LWL04 doesn't have any data in the polling time. It will uplink 11 bytes of 0

image-20240911095614-4.png

Access via serial port:

image-20240911095534-3.png

Downlink: 0x31+Start time +End time +Uplink interval(Unit: seconds)

0x31 66 E0 F2 98 66 E0 F4 F0 05

Uplink:

44 00 00 00 00 00 00 66 E0 F2 B2 44 00 00 00 00 00 00 66 E0 F3 22 44 00 00 00 00 00 00 66 E0 F3 9A 44 00 00 00 00 00 00 66 E0 F4 12 44 00 00 00 00 00 00 66 E0 F4 8A

Parsed Value: 

[COUNTMOD,TDC_FLAG,ALARM, WATER_LEAK_STATUS, WATER_LEAK_TIMES, LAST_WATER_LEAK_DURATION, TIME]

[SUM,YES,FALSE,NO LEAK,0,0,2024-09-11 01:30:26],

[SUM,YES,FALSE,NO LEAK,0,0,2024-09-11 01:32:18],

[SUM,YES,FALSE,NO LEAK,0,0,2024-09-11 01:34:18],

[SUM,YES,FALSE,NO LEAK,0,0,2024-09-11 01:36:18],

[SUM,YES,FALSE,NO LEAK,0,0,2024-09-11 01:38:18],

2.4 Datalog Feature

Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LWL04 will store the reading for future retrieving purposes.

Note:After the device is reset, in cumulative counting mode, the last stored leak count value will be read as the initial value.

2.4.1  Unix TimeStamp

LWL04 use Unix TimeStamp format based on

image-20220609113256-8.png

Users can get this time from the link:  https://www.epochconverter.com/ :

Below is the converter example

image-20220609113256-9.png

So, we can use AT+TIMESTAMP=1726018200 or downlink 3066E0F29800 to set the current time 2021 – Jan -- 29 Friday 03:03:25    2024 - September --11 Wednesday 01:30:00

2.4.2  Set Device Time

There are two ways to set the device's time:

1.  Through LoRaWAN MAC Command (Default settings)

Users need to set SYNCMOD=1 to enable sync time via the MAC command.

Once LWL04 Joined the LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LWL04. If LWL04 fails to get the time from the server, LWL04 will use the internal time and wait for the next time request [via Device Status (FPORT=5)].

Note: LoRaWAN Server needs to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature.

2.  Manually Set Time

Users need to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server.

2.5 ​Show Data in DataCake IoT Server

 

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:

Step 2: Add LWL04 to Datacake.

image-20240910150951-1.png

image-20240910151058-2.png

image-20240910151137-3.png

image-20240911094353-2.png

Step 3: Configure LWL04 in Datacake.

image-20240911094104-1.png

image-20240910151829-6.png

image-20221102092921-5.png

image-20221102092921-6.png

image-20240910153234-8.png

image-20221102092921-8.png

image-20221102092921-9.png

image-20240910153801-9.png

2.6 Frequency Plans

The LWL04 uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.

End Device Frequency Band

3. Configure LWL04

3.1 Configure Methods

LWL04 supports below configure method:

3.2 General Commands

These commands are to configure:

  • General system settings like: uplink interval.
  • LoRaWAN protocol & radio related command.

They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:

End Device AT Commands and Downlink Command

3.3 Commands special design for LWL04

These commands only valid for LWL04, as below:

3.3.1 Set Transmit Interval Time

Feature: Change LoRaWAN End Node Transmit Interval.

AT Command: AT+TDC

Command ExampleFunctionResponse
AT+TDC=?Show current transmit Interval

7200000
OK
the interval is 7200000ms = 7200s

AT+TDC=1200000Set Transmit Interval

OK
Set transmit interval to 1200000ms = 1200s

Downlink Command: 0x01

Format: Command Code (0x01) followed by 3 bytes time value.

If the downlink payload=01001C20, it means set the END Node's Transmit Interval to 0x001C20(H)=7200(D) seconds, while type code is 01.

  • Example 1: Downlink Payload: 01001C20       //  Set Transmit Interval (TDC) = 7200 seconds
  • Example 2: Downlink Payload: 010004B0       //  Set Transmit Interval (TDC) = 1200 seconds

3.3.2 Set Power Output Duration

Control the output duration 5V . Before each sampling, device will

1. first enable the power output to external sensor,

2. keep it on as per duration, read sensor value and construct uplink payload

3. final, close the power output.

AT Command: AT+5VT

Command ExampleFunctionResponse
AT+5VT=?Show 5V open time.0 (default)
OK
AT+5VT=1000Close after a delay of 1000 milliseconds.OK

Downlink Command:  0x07

Format: Command Code (0x07) followed by 2 bytes.

The two bytes following the function code 0x07 set the opening time of 5V.

  • Example 1: Downlink Payload: 070000     --->   AT+5VT=0
  • Example 2: Downlink Payload: 0701F4      --->  AT+5VT=500

3.3.3 Enable / Disable Alarm

Feature: Enable/Disable Alarm for open/close event. Default value 0.

AT Command:  AT+DISALARM

Command ExampleFunctionResponse
AT+DISALARM=1End node will only send packet in TDC time.OK
AT+DISALARM=0End node will send packet in TDC time or status change for water leak sensorOK

Downlink Command:  0xA7

  • Downlink payload: 0xA7 01     // Same as AT+DISALARM=1
  • Downlink payload: 0xA7 00     // Same as AT+DISALARM=0

3.3.4 Set system time

Feature: Set system time, Unix format. See here for format detail.

AT Command:  AT+TIMESTAMP

Command ExampleFunctionResponse
AT+TIMESTAMP=1725957832Set System time to 2024-09-10 08:43:52OK

Downlink Command:  0x30

0x3066E006C800      // Set timestamp to 0x(66E006C800),Same as AT+TIMESTAMP=1725957832

3.3.5 Set Time Sync Mode

Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.

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.

AT Command:  AT+SYNCMOD

Command ExampleFunctionResponse
AT+SYNCMOD=1Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.OK
AT+SYNCMOD=1,8Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.OK
AT+SYNCMOD=1,-12Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.OK

Downlink Command:  0X28

0x28 01           // Same as AT+SYNCMOD=1

0x28 01 08      // Same as AT+SYNCMOD=1,8

0x28 01 F4      // Same as AT+SYNCMOD=1,-12

0x28 00           // Same as AT+SYNCMOD=0

3.3.6 Alarm Base on Timeout

LWL04 can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc.

User configure this feature by using:

AT Command:  AT+TTRIG=AA,BB

AA: When AA=0, the monitoring state: changes from leakage to no leakage.

       When AA=1, the monitoring state: changes from no leakage to leakage.

BB: Holding time after state change.

Example:

AT+TTRIG=1,30   --> When status change from no leak to leak, and device keep in leak status for more than 30 seconds. LWL04 will send an uplink packet, the Alarm bit (the second bit of 1st byte of payload) on this uplink packet is set to 1.

AT+TTRIG=0,30   --> When status change from leak to no leak, and device keep in no leak status for more than 30 seconds. LWL04 will send an uplink packet, the Alarm bit (the second bit of 1st byte of payload) on this uplink packet is set to 

AT+TTRIG=0,0     -->  Default Value, disable timeout Alarm.

Downlink Command:  0xA9 aa bb cc

A9: Command Type Code

aa: status to be monitored

bb cc: timeout

Example:

  • Downlink payload: 0xA9 01 00 1E      --> Equal to AT+TTRIG=1,30
  • Downlink payload: 0xA9 00 00 00      --> Equal to AT+TTRIG=0,0     //Disable timeout Alarm.

3.3.7 The working mode of the total water leakage event

AT Command:  AT+COUNTMOD 

  • AT+COUNTMOD=0       //Default Value, Total leak events since factory.
  • AT+COUNTMOD=1       //Total leak events since last TDC uplink.

Downlink Command: 0x0B

  • Downlink payload: 0x0B00    // Same as AT+COUNTMOD=0
  • Downlink payload: 0x0B01    // Same as AT+COUNTMOD=1

3.3.8 Regularly update a confirm uplink when water leaks

AT Command:  AT+LEAKALARM

  • AT+LEAKALARM=10 --> Default Value, A periodically update at every 10 minutes when in water leak.
  • AT+LEAKALARM=0   --> Disable a periodically update when in water leak.

Downlink Command: 0x0C

Format: Command Code (0x0C) followed by 1 byte.

  • Downlink payload: 0xAC 0A     // Same as AT+LEAKALARM=10
  • Downlink payload: 0xAC 00     // Same as AT+LEAKALARM=0

3.3.9 Delay time for state changes to take effectEdit

AT Command: AT+DETEDELAY

AT+DETEDELAY=50 --> Default Value, Set state change, valid signal is 50ms.

AT+DETEDELAY=0  --> Disable valid signal detection..

Downlink Command: 0x0D aa bb

0D: Command Type Code

aa bb: timeout

Example:

  • Downlink payload: 0x0D 00 32     // Same as AT+DETEDELAY=50
  • Downlink payload: 0x0D 00 00     // Same as AT+DETEDELAY=0

3.3.10 Clear the leak count and the duration of the last leak

AT Command: AT+CLRC

Command ExampleFunctionResponse
AT+CLRCclear the leak count and the duration of the last leak.OK

Downlink Payload:  0xA601

The sensor will clear the leak count and the duration of the last leak.

3.3.11 Set the count value of the number of leaks

AT Command: AT+SETCNT

Command ExampleFunctionResponse
AT+SETCNT=100Set the leak count value to 100OK

Downlink Payload: 0xA5

Format: Command Code (0xA5) followed by 3 bytes.

  • 0xA5 00 00 64    //Same as AT+SETCNT=100

4. Battery & How to replace

4.1 Battery Type and replace

LWL04 is equipped with 1 x CR123A battery. If the batterys running low(see 2.3~2.5v in the platform). User can buy generic CR123A battery and replace it.

Note: Make sure the direction is correct when install the CR123A battery.

Important Notice: Make sure use new CR123A battery and the battery doesn't have broken surface.

Example of CR123A battery:

image-20240911104508-5.png

4.2 Power Consumption Analyze

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:

Battery Info & Power Consumption Analyze .

5. OTA Firmware update

User can change firmware LWL04 to:

  • Change Frequency band/ region.
  • Update with new features.
  • Fix bugs. 

Firmware and changelog can be downloaded from : Firmware download link

Methods to Update Firmware:

6. FAQ

7. Order Info

Part Number: LWL04-XXX

XXX

  • EU433: frequency  bands EU433
  • EU868: frequency  bands EU868
  • KR920: frequency  bands KR920
  • CN470: frequency bands CN470
  • AS923: frequency  bands AS923
  • AU915: frequency bands AU915
  • US915: frequency bands  US915
  • IN865:  frequency bands  IN865
  • CN779: frequency bands CN779

8. ​Packing Info

Package Includes:

  • LWL04 x 1

image-20240913135810-1.jpeg

Dimension and weight:

  • Device Size: cm
  • Device Weight: g
  • Package Size / pcs : cm
  • Weight / pcs : g

9. Support

  • 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.
  • 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.cc.

 

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