Milesight WS301 Magnet Contact Switch User Guide

Magnet Contact Switch
Featuring LoRaWAN®
WS301
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 remodeled in any way.
• Do not place the device close to objects with naked flames.
• Do not place the device 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 reverse or wrong model.
• The device must never be subjected to shocks or impacts.

Declaration of Conformity

WS301 is in conformity with the essential requirements and other relevant provisions of the CE, FCC, and RoHS.

FCC Warning
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions

1. this device may not cause harmful interference, and
2. this device must accept any interference received, including interference that may cause undesired operation. Changes or modifications not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment.

Note 1: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause  harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try  to correct the interference by one or more of the following measures:

• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
• Consult the dealer or an experienced radio/TV technician for help.
  Note 2:

1. Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment.
2. The minimum separation generally be used is at least 20 cm.

Copyright © 2011-2021 Mitesight. 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 loT Co., Ltd.

For assistance, please contact
Milesight technical support:
Email: iot-support@milesight.com
Tel: 86-592-5085280
Fax: 86-592-5023065
Address: 4/F, No.63-2 Wanghai Road,
2″! Software Park, Xiamen, China

Revision History

OPERATING FREQUENCY:
863.1MHzZ ~ 869.9MHz for LORA 13.56MHz for NFC

EIRP (MAX.):
9.31dBm for LORA (Maximum) -37.52dBuA/m at 10m,or 16.31dBuV/m at 3m for NFC (Maximum)

Product Introduction

Overview

WS301 simply enables you to know when someone enters the office/building through a door /window or something has been moved. The minimal magnet is placed inside the portable part, while the sensor is inside the fixed part that can be attached to door/window or other objects. W $301 can be easily mounted on the doors, panes, or cabinets, greatly providing real applications for smart homes, smart offices, or smart factories.

Sensor data are transmitted in real-time using the standard LoRaWAN® protocol. LoRaWAN® enables encrypted radio transmissions over long distances while consuming very little power. The user can obtain sensor data and view the trend of data change through Milesight loT Cloud or through the user’s own Application Server.

Features

• Up to 15 km communication range
• Easy configuration via NFC
• Standard LoRaWAN® support
• Milesight loT Cloud compliant
• Low power consumption with 1200mAh replaceable battery

Hardware Introduction

Packing List

If any of the above items is missing or damaged, please contact your sales representative.

Hardware Overview

Sensor:

LED Patterns

once
The device is installed| Green, blink once
Reboot| Press and hold the reset button (internal) for
more than 3 seconds| Slowly Blinks
Reset to Factory
Default| Press and hold the reset button (internal) for more than 10 seconds| Quickly Blinks

Dimensions (mm)

Operation Guide

NFC Configuration

WS301 can be configured via a NFC-supported mobile phone.

1. Pull out the battery insulating sheet to power on the device. The indicator will light up in green for 3 seconds when device turns on.

2. Download and install “Milesight ToolBox” App from Google Play or Apple Store.

3. Enable NFC on the smartphone and open Milesight ToolBox.

4. Attach the smartphone with NFC area to the device to read device information.

5. Basic information and settings of devices will be shown on ToolBox if it’s recognized successfully. You can read and configure the device by tapping the Read/Write button on the App. In order to protect the security of devices, password validation is required when first configuration. The default password is 123456.

Note:

1. Ensure the location of smartphone NFC area and it’s recommended to take off phone case.
2. If the smartphone fails to read/write configurations via NFC, keep the phone away and back to try again.
3. WS301 can also be configured by ToolBox software via following ways:

• via dedicated NFC reader, which can be purchased from Milesight lo T.

• Via TTL UART interface inside the device. Please select General type to log in ToolBox and configure the device. (Default password: 123456)

LoRaWAN Settings

LoRaWAN settings are used for configuring the transmission parameters in LoRaWAN ® network.

Basic 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.

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 5 th to 12 th digits of SN.
Network Session Key| Nwkskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
Application
Session Key| Appskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
Spread Factor| If ADR is disabled, the device will send data via this spread factor.
Confirmed Mode| If the device does not receive ACK packet from network server, it will resend
data 3 times at most.
Rejoin Mode| Reporting interval ≤ 30 mins: device will send specific mounts of LoRaMAC
packets to check connection status every 30 mins; If no reply after specific
packets, the device will re-join.
Reporting interval > 30 mins: device will send specific mounts of LoRaMAC
packets every to check connection status every reporting interval; If no reply
after specific packets, the device will re-join.
ADR Mode| Allow network server to adjust data rate of the device.
Tx Power| Transmit power of device.

Note:

1. Please contact sales for 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.
4. Only OTAA mode supports rejoin mode.

LoRaWAN Frequency Settings:
Go to Setting- >LoRaWAN Settings of ToolBox App to select supported frequency and select channels to send uplinks. Make sure the channels match the LoRaWAN ® gateway.

If frequency is one of CN470/AU915/US915, you can enter the index of the channel that you want to enable in the input box, making 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
Null: Indicates that all channels are disabled

Note:
For -868M model, default frequency is EU868;
For -915M model, default frequency is AU915.

General Settings

Go to Device- >Setting->General Settings of ToolBox App to change the reporting interval, etc.

network server.
Default: 1080mins, Range: 1 – 1080 mins
Note: WS301 will also transmit alarm when magnet status is changed or tamper button is activated.
LED Indicator| Enable or disable the light indicating in chapter 2.3.
Note: The indicator of reset button is not allowed to disable.
Low Power Alarm| The sensor will report low power alarms according to this interval when the battery is lower than 10
Change Password| Change the password for ToolBox App to write this device.

Maintenance

Upgrade

1. Download firmware from Milesight website to your smartphone.
2. Open Toolbox App and click “Browse” to import firmware and upgrade the device.

Note:

1. Operation on ToolBox is not supported during an upgrade.
2. Only Android version ToolBox supports the upgrade feature.

Backup

WS301 supports configuration backup for easy and quick device configuration in bulk. Backup is allowed only for devices with the same model and LoRa frequency band.

1. Go to “Template” page on the App and save current settings as a template. You can also edit the template file.
2. Select one template file that saved in the smartphone and click “Write”, then attach it to another device to write configuration.

Note: Slide the template item left to edit or delete the template. Click the template to edit the configurations.

Reset to Factory Default

Please select one of the following methods to reset device:
Via Hardware: Hold on the reset button inside the device for more than 10s. After reset complete, the indicator will blink in green twice and device will reboot.
Via ToolBox App: Go to Device->Reset to click “Reset”, then attach smartphone with NFC area to device to complete reset.

Installation

3M Tapes Fix:
Tear the 3M tapes of both parts, then make sure the magnet part is placed inside the door (portable part) and sensor is inside the door frame (fixed part). For double doors, put every part on each door.

Screw Fix:
Remove the cover of both parts, screw the covers on the mounting positions, then install back the devices.

Note:

1. The notch side of magnet should face the notch side of sensor, otherwise, it may affect the sensitivity of on/off detection.
2. The plane distance between sensor and magnet should not be more than 15mm, and the height difference should be less than 7.5 mm.

Device Payload

All data are based on the following format(HEX):

For decoder examples please find files on https://github.com/Milesight- IoT/SensorDecoders.

Basic Information

WS301 reports basic information of sensor whenever joining the network.

6127a2174132
09 (Hardware Version)| | 140| | | V1.4
0a(Software Version)| | 114| | | V1.14
Of(Device Type)| | 0| | | Class A

Example:

ff 09 01 00 ff Oa 01 02 ff Of 00

Channel| Type| Value| Channel| Type| Value
ff| 09
(Hardware
version)| 0100 (V1.0)| ff| Oa
(Software version| 0102
(V1.2)
Channel| Type| Value| | |
ff| Of
(Device
Type)| 00
(Class A)| | |

Sensor Data

WS301 reports open/close status and tamper status as follows:

• According to reporting interval;
• When magnet or tamper status has changed.

01=>Switch open
4| 00(Tamper Status)| 00=>Device is installed
01=>Device is un-installed

Example:

01 75 64 03 00 00 04 00 01

Channel| Type| Value| Channel| Type| Value
1| 75
(Battery)| 64 => 100%| 3| 00
Magnet Status)| 00
(Close)
Channel| Type| Value| | |
4| 00
(Tamper
Status)| 01
(Un-installed)| | |

Downlink Commands

WS301 supports downlink commands to configure the device. The application port is 85 by default.

www.milesight-iot.com

References

• Support : IoT Support
• GitHub - Milesight-IoT/SensorDecoders

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>