WS303 Airteq Mini Leak Detection Sensor
“
Specifications:
- Product: Mini Leak Detection Sensor WS303
- Power Supply: Built-in 590mAh battery
- Waterproof Rating: IP67
- Features: Conductive liquid detection, real-time alarming,
support for Milesight D2D protocol
Product Usage Instructions:
1. Safety Precautions:
Ensure to follow these safety precautions to prevent any damage
or loss:
- Do not disassemble or remodel the device.
- Change the default password (123456) for security.
- Avoid placing the device near naked flames or outside the
operating temperature range. - Handle electronic components carefully to prevent damage while
opening. - Install the battery correctly and avoid installing the wrong
model. - Avoid subjecting the device to shocks or impacts.
2. Power Supply:
The WS303 sensor comes with a built-in 590mAh battery that
provides up to 5 years of wire-free power supply.
3. Operation Guide:
The device is equipped with a reset button that allows for
emergency reset or reboot even if the battery is removed. Use NFC
for completing all steps efficiently.
FAQ:
Q: What should I do if the device does not detect leakage?
A: If the device does not detect leakage, check the battery
installation and ensure the device is placed correctly in the
detection area.
Q: How can I reset the device to factory default settings?
A: To reset the device to factory default settings, press and
hold the reset button for more than 10 seconds until it buzzes and
resets.
“`
Mini Leak Detection Sensor
Featuring LoRaWAN®
WS303
User Guide
Safety Precautions
Milesight will not shoulder responsibility for any loss or damage resulting from not following the instructions of this operating guide. The device must not be disassembled or remodeled in any way. In order to protect the security of the device, please change the device password when first
configuration. The default password is 123456. Do not place the device close to objects with naked flames. Do not place the device in where the temperature is below/above the operating range. Make sure electronic components do not drop out of the enclosure while opening. When installing the battery, please install it accurately, and do not install the inverse or
wrong model. The device must never be subjected to shocks or impacts.
Declaration of Conformity
WS303 is in conformity with the essential requirements and other relevant provisions of the CE, FCC, and RoHS.
Copyright © 2011-2023 Milesight. All rights reserved. All information in this guide is protected by copyright law. Whereby, no organization or individual shall copy or reproduce the whole or part of this user guide by any means without written authorization from Xiamen Milesight IoT Co., Ltd.
Revision History
Date March 29, 2023
For assistance, please contact Milesight technical support: Email: iot.support@milesight.com Support Portal: support.milesight-iot.com Tel: 86-592-5085280 Fax: 86-592-5023065 Address: Building C09, Software Park III,
Xiamen 361024, China
Doc Version Description
V 1.0
Initial version
2
Contents
1. Product Introduction …………………………………………………………………………………………………………. 4 1.1 Overview …………………………………………………………………………………………………………………..4 1.2 Features ………………………………………………………………………………………………………………….. 4
2. Hardware Introduction ………………………………………………………………………………………………………. 4 2.1 Packing List ………………………………………………………………………………………………………………4 2.2 Hardware Overview ………………………………………………………………………………………………….. 5 2.3 Dimensions (mm) …………………………………………………………………………………………………….. 5 2.4 Reset Button & Buzzer Patterns ………………………………………………………………………………… 5
3. Power Supply ……………………………………………………………………………………………………………………. 6 4. Operation Guide …………………………………………………………………………………………………………………6
4.1 NFC Configuration ……………………………………………………………………………………………………. 6 4.2 LoRaWAN Settings …………………………………………………………………………………………………… 7 4.3 Basic Settings ………………………………………………………………………………………………………… 10 4.4 Advanced Settings …………………………………………………………………………………………………. 10
4.4.1 Alarm Settings ……………………………………………………………………………………………… 10 4.4.2 Milesight D2D Settings …………………………………………………………………………………..11 4.5 Maintenance ………………………………………………………………………………………………………….. 11 4.5.1 Upgrade ……………………………………………………………………………………………………….. 11 4.5.2 Backup ………………………………………………………………………………………………………….12 4.5.3 Reset to Factory Default …………………………………………………………………………………13 5. Installation ……………………………………………………………………………………………………………………… 14 6. Device Payload ……………………………………………………………………………………………………………….. 14 6.1 Basic Information …………………………………………………………………………………………………… 14 6.2 Sensor Data …………………………………………………………………………………………………………… 15 6.3 Downlink Commands ……………………………………………………………………………………………… 15
3
1. Product Introduction
1.1 Overview
WS303 is a tiny and mighty leakage detection sensor for detecting the presence of water leaks and transmitting an alarm using LoRaWAN® technology. With this low power consumption technology, WS303 can work up to 5 years with a 590mAh battery. Compliant with Milesight D2D protocol, it can directly link with other Milesight devices to realize danger prevention and effectively prevent unnecessary loss.
The wire-free WS303 can be easily used in smart offices, buildings, and houses. Users can receive real-time alarms via a built-in buzzer locally and a mobile App remotely. Combining with Milesight LoRaWAN® gateway and Milesight IoT Cloud, users can manage all sensor data remotely and visually.
1.2 Features
Detect the presence of conductive liquids using a small water probe A replaceable built-in 590mAh battery with up to 5 years of life for wire-free power supply IP67 waterproof enclosure for harsh environment applications Embedded with a buzzer for real-time alarming Support Milesight D2D protocol to enable ultra-low latency and direct control without
gateways Equipped with NFC for easy configuration Compliant with standard LoRaWAN® gateways and network servers Quick and easy management with Milesight IoT Cloud solution
2. Hardware Introduction 2.1 Packing List
1 × WS303 Device
1 × CR2450 Battery
2 × 3M Tapes
1× Quick Start Guide
If any of the above items are missing or damaged, please contact your sales representative.
4
2.2 Hardware Overview 2.3 Dimensions (mm)
2.4 Reset Button & Buzzer Patterns
WS303 sensor equips with a reset button inside the device for emergency reset or reboot even if the battery is removed. Usually, users can use NFC to complete all steps.
Function
Action
Buzzer
Turn On
Insert the battery.
Buzzes for one time
Reboot
Press and hold the button for more than 3 Buzzes for every second
seconds.
Reset to Factory Press and hold the button for more than
Buzzes for every 0.5 second
Default
10 seconds.
After buzzing five times, the device will buzz for 5 minutes
Alarm
Detect the leakage
or until the leakage status has been released. (The buzzer can also be stopped via ToolBox App or downlink command)
5
3. Power Supply
1. Put the coin (or any other tool with a suitable size) into the groove of the battery back cover, turn the battery back cover and remove it. 2. Insert the battery into the sensor with the positive facing up. After inserting, the device will power on automatically. 3. Put the battery cover back onto the device and tighten it.
4. Operation Guide 4.1 NFC Configuration
WS303 can be configured via NFC. 1. Download and install “Milesight ToolBox” App from Google Play or App Store. 2. Enable NFC on the smartphone and open”Milesight ToolBox” App. 3. Attach the smartphone with NFC area to the device to read the basic information.
4. Basic information and settings of devices will be shown on ToolBox if it’s recognized successfully. You can switch on/off, read and write the device by tapping the button on the App. In order to protect the security of devices, password validation is required when configuring via an unused phone. The default password is 123456.
6
Note: 1) Ensure the location of the smartphone NFC area and it’s recommended to take off the phone case. 2) If the smartphone fails to read/write configurations via NFC, keep the phone away and back to try again. 3) WS303 can also be configured by a dedicated NFC reader provided by Milesight IoT.
4.2 LoRaWAN Settings
Go to Device > Setting > LoRaWAN Settings of ToolBox App to configure join type, App EUI, App Key and other information. You can also keep all settings by default.
7
Parameters
Description
Device EUI
Unique ID of the device which can also be found on the label.
App EUI
The default App EUI is 24E124C0002A0001.
Application Port The port used for sending and receiving data, the default port is 85.
Join Type
OTAA and ABP modes are available.
Application Key Appkey for OTAA mode, default is 5572404C696E6B4C6F52613230313823.
Device Address DevAddr for ABP mode, default is the 5th to 12th digits of SN.
Network Session Nwkskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
Key
Application Session Key
Appskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
LoRaWAN Version V1.0.2 and V1.0.3 are available.
Work Mode
It’s fixed as Class A.
RX2 Data Rate RX2 data rate to receive downlinks or send D2D commands.
RX2 Frequency RX2 frequency to receive downlinks or send D2D commands. Unit: Hz
Select Standard-Channel mode or Single-Channel mode. When Single-Channel
Channel Mode mode is enabled, only one channel can be selected to send uplinks. Please
enable Single-Channel mode if you connect the device to DS7610.
Enable or disable the frequency to send uplinks.
Channel
If the frequency is one of CN470/AU915/US915, enter the index of the channel that you want to enable and make them separated by commas. Examples: 1, 40: Enabling Channel 1 and Channel 40 1-40: Enabling Channel 1 to Channel 40 1-40, 60: Enabling Channel 1 to Channel 40 and Channel 60 All: Enabling all channels
8
Null: Indicates that all channels are disabled
Spread Factor If ADR is disabled, the device will send data via this spread factor.
If the device does not receive an ACK packet from the network server, it will Confirmed Mode
resend data once.
Reporting interval 30 mins: the device will send a specific number of
LinkCheckReq MAC packets to the network server every 30 mins to validate
connectivity; if there is no response, the device will rejoin the network.
Rejoin Mode Reporting interval > 30 mins: the device will send a specific number of
LinkCheckReq MAC packets to the network server every reporting interval to
validate connectivity; if there is no response, the device will rejoin the
network.
Set the number of When rejoin mode is enabled, set the number of LinkCheckReq packets sent.
packets sent
ADR Mode
Allow the network server to adjust datarate of the device. This only works with Standard Channel Mode.
Tx Power
Transmit power of the device.
Note:
1) Please contact sales for the device EUI list if there are many units.
2) Please contact sales if you need random App keys before purchase.
3) Select OTAA mode if you use Milesight IoT Cloud to manage devices.
9
4) Only OTAA mode supports rejoin mode.
4.3 Basic Settings
Go to Device > Setting > General Settings to change the reporting interval, etc.
Parameters
Description
Reporting interval of transmitting data to the network server. Range: Reporting Interval
1~1080mins; Default: 1080mins
Enable or disable the buzzer for alarming when the sensor detects
Buzzer
leakage. The buzzer will automatically stop after 5 minutes or the status
returns to “No Leak”.
Change the password for ToolBox App or software to read/write this Change Password
device.
4.4 Advanced Settings
4.4.1 Alarm Settings
Go to Device > Settings > Alarm Settings to enable the alarm settings. When WS303 detects water leakage, it will report the alarm according to reporting interval and reporting times settings.
Parameters Alarm Reporting Interval Alarm Reporting Times
Description Reporting interval of sending alarm packet. Default: 1min The times of reporting alarm packet. Range: 2~1000; Default: 2
10
4.4.2 Milesight D2D Settings
Milesight D2D protocol is developed by Milesight and used for setting up transmission among Milesight devices without gateway. When the Milesight D2D setting is enabled, WS303 can work as a Milesight D2D controller to send control commands to trigger Milesight D2D agent devices. 1. Configure RX2 datarate and RX2 frequency in LoRaWAN® settings, it is suggested to change the default value if there are many LoRaWAN® devices around. 2. Go to Device >Settings > D2D Settings to enable D2D function, and define a unique Milesight D2D key which is the same as Milesight D2D agent devices, then select the frequency and spreading factor. (Default Milesight D2D Key: 5572404C696E6B4C6F52613230313823)
3. Enable one of WS303 statuses and configure a 2-byte hexadecimal command (This command is pre-defined in Milesight D2D agent device). When WS303 detects this status, it will send the control command to the corresponding Milesight D2D agent devices.
Note: If you enabled LoRa Uplink feature, LoRaWAN® uplink that contains the Leakage status will be sent to the gateway after Milesight D2D control command is sent.
4.5 Maintenance
4.5.1 Upgrade
1. Download firmware from Milesight website to your smartphone. 2. Open Toolbox App, go to Device > Maintenance and click Browse to import firmware and upgrade the device. Note: 1) Operation on ToolBox is not supported during a firmware upgrade. 2) Only the Android version of ToolBox supports the upgrade feature.
11
4.5.2 Backup
WS303 supports configuration backup for easy and quick device configuration in bulk. Backup is allowed only for devices with the same model and LoRaWAN® frequency band. 1. Go to Template page on the App and save the current settings as a template. You can also edit the template file. 2. Select one template file which saved in the smartphone and click Write, then attach the smartphone to another device to write the configuration.
Note: Slide the template item left to edit or delete the template. Click the template to edit the configurations.
12
4.5.3 Reset to Factory Default
Please select one of the following methods to reset the device: Via Hardware: Hold on the power button (internal) for more than 10s. Via ToolBox App: Go to Device > Maintenance to click Reset, then attach the smartphone with NFC area to the device to complete reset.
13
5. Installation
Fixed by 3M Tape: Paste 3M tape to the back cover, then tear off the other side and place it on the wall near the detection area (please make sure the two leak detection probe is straight down).
Placement Installation: Place the sensor facing up and horizontally in the detection area.
6. Device Payload
All data are based on the following format (HEX), the Data field should follow little-endian:
Channel1 Type1 Data1 Channel2 Type2 Data2 Channel 3 …
1 Byte 1 Byte N Bytes 1 Byte 1 Byte M Bytes 1 Byte
…
For decoder examples please find files on https://github.com/Milesight-IoT/SensorDecoders.
6.1 Basic Information
WS303 reports basic information about the sensor every time it joins the network.
Channel
Type
Description
01(Protocol Version)
01=>V1
09 (Hardware Version) 01 40 => V1.4
0a (Software Version) 01 14 => V1.14 ff
0b (Power On)
Device is on
0f (Device Type) 16 (Device SN)
00: Class A, 01: Class B, 02: Class C 16 digits
Example:
14
Channel ff
Channel ff
Channel
ff
ff0bff ff0101 ff166993c52763220003 ff090100 ff0a0101 ff0f00
Type 0b
(Power On) Type 16
(Device SN) Type 0a
(Software version)
Value ff
(Reserved) Value
6993c52763 220003 Value
Channel ff
Channel ff
Channel
Type 01
(Protocol Version) Type 09
(Hardware version) Type
0101
ff
0f
(V1.1)
(Device Type)
Value
01 (V1)
Value 0100 (V1.0) Value
00 (Class A)
6.2 Sensor Data
WS303 reports sensor data according to reporting interval (1080mins by default) or leakage status changes.
Channel
Type
Description
01
75(Battery Level) UINT8, Unit: %
00: No leak
03
00 (Leakage Status)
01: Leaking detected
Example: 1. Periodic Packet
Channel 01
Type 75
(Battery)
017563 030001
Value 63 => 99%
Channel 03
Type 00
(Leakage Status)
Value 01=>Leaking
detected
2. Alarm Packet:
Channel 03
030001
Type 00
(Leakage Status)
Value 01=> Leaking detected
6.3 Downlink Commands
WS303 supports downlink commands to configure the device. The application port is 85 by default.
Channel ff
Type 10 (Reboot)
ff (Reserved)
Description
15
03 (Set Reporting Interval) 3e (Set Buzzer)
3d (Stop Buzzing)
7e (Set Alarming Reporting)
2 Bytes, unit: s 00 = Disable; 01 = Enable ff (Reserved) 5 Bytes, Alarm Reporting(1 Byte)+Interval(2 Bytes)+ Times(2 Bytes) Alarm Reporting: 00 = Disable; 01 = Enable Alarm Reporting Interval: unit –s Alarm Reporting Times: range –2~1000 00 = Not Search; 01 = Search
7f (Set Searching Device)
80 (Set Buzzing Time when Searching)
84 (Set D2D Function)
Note: 1. The device will buzz for a specific time after receiving this downlink command. 2. You can stop the buzzer on ToolBox or by sending the not search downlink command. 3. Disabling the buzzer on Toolbox will not stop the buzzing under searching device feature. 2 Bytes, unit:s Range: 60~64800; Default: 300s 00=Disable; 01=Enable 2 Bytes, Status(1 Byte)+Function(1 Byte)
81 (Set LoRa Uplink) 83 (Set D2D Command)
Status: 00=No Leak; 01=Leak Function: 00 -Only Use LoRaWAN 01 -Only Use D2D 03 -Use D2D&LoRaWAN Uplink 3 Bytes, Status(1 Byte)+Command(2 Bytes) Status: 00=No Leak; 01=Leak
16
Example: 1. Set reporting interval as 20 minutes.
Channel ff
ff03b004
Type 03 (Set Reporting Interval)
Value b0 04 => 04 b0 = 1200s = 20 minutes
2. Reboot the device.
Channel ff
Type 10 (Reboot)
3. Enable buzzer for leakage alarming.
ff10ff
Value ff (Reserved)
Channel ff
Type 3e (Set Buzzer)
ff3e01
4. Stop buzzing when WS303 detects water leakage.
Value 01=>Enable
Channel ff
Type 3d (Stop Buzzing)
ff3dff
Value ff (Reserved)
5. Enable alarming reporting, set the interval as 10 minutes and set the reporting times as 3.
Channel ff
ff7e 01 5802 0300
Type 7e (Set Alarm Reporting)
Value 01=> Enable Alarm Reporting 58 02 => 02 58 = 600s = 10 minutes
03 00 => 00 03 =3
6. Enable D2D function.
Channel ff
ff8401 Type 84 (Set D2D Function)
7. Set leak status using both D2D&LoRa uplink.
Value 01 => Enable
Channel ff
ff81 01 03
Type 81 (Set LoRa Uplink)
Value Status: 01=> Leak Function: 03=> Use D2D & LoRa
17
8. Set the D2D command of leak as 0101.
Channel ff
Type
ff83 01 0101
83 (Set D2D Command)
Value Status: 01=> Leak Command: 0101
-END-
18
Service & Advies
Heeft u vragen of opmerkingen over een sensor? Of zoekt u ondersteuning bij het instellen van de sensor? Onze medewerkers van de afdeling Service staan elke werkdag voor u klaar. U kunt contact opnemen door te bellen of te mailen.
Telefoon: 0345 785 611 E-mail: support@AirTeq.eu www.AirTeq.eu
Pascalweg 2a 4104 BG Culemborg Netherlands
Documents / Resources
 | Milesight WS303 Airteq Mini Leak Detection Sensor [pdf] User Guide WS303, WS303 Airteq Mini Leak Detection Sensor, Airteq Mini Leak Detection Sensor, Mini Leak Detection Sensor, Leak Detection Sensor, Detection Sensor, Sensor |
