Milesight WS101 Smart Button

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 modified 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 where the temperature is below/above the operating range.
• When installing the battery, please install it accurately, and do not install the reverse or wrong model.
• Remove the battery if the device will not be used for a period of time. Otherwise, the battery will leak and damage the device.
• The device must never be subjected to shocks or impacts.

Declaration of Conformity

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

[CE Logo] [FCC Logo] [Crossed-out Wheelie Bin Logo] [RoHS Logo]

Copyright

Copyright © 2011-2022 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.

Contact Information

For assistance, please contact Milesight technical support:

Email: iot.support@milesight.com

Tel: 86-592-5085280

Fax: 86-592-5023065

Address: Building C09, Software Park III, Xiamen 361024, China

Revision History

1. Product Introduction

1.1 Overview

WS101 is a LoRaWAN® based smart button for wireless controls, triggers and alarms. WS101 supports multiple press actions, all of which can be defined by the user to control devices or trigger scenes. Besides, Milesight also provides a red button version that is primarily used for emergency situation. Compact and battery-powered, WS101 is easy to install and carry everywhere. WS101 can be widely used in smart homes, smart offices, hotels, schools, etc.

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 get alarm through Milesight IoT Cloud or through the user's own Application Server.

1.2 Features

• Up to 15 km communication range
• Easy configuration via NFC
• Standard LoRaWAN® support
• Milesight IoT Cloud compliant
• Support multiple press actions to control devices, trigger a scene or send emergency alarms
• Compact design, easy to install or carry
• Built-in LED indicator and buzzer for press actions, network status, and low battery indication

2. Hardware Introduction

2.1 Packing List

Diagram showing the contents of the packing list.

• 1 x WS101 Sensor
• 2 x Wall Mounting Kits
• 1 x 3M Tape
• 1 x Quick Guide

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

2.2 Hardware Overview

Diagram showing the hardware components of the WS101 Smart Button.

• NFC Area
• Indicator Button
• Lanyard Hole
• Mounting Holes
• Reset Button
• Battery

2.3 Dimensions (mm)

Diagram showing the dimensions of the WS101 Smart Button: 50mm x 50mm x 18mm.

2.4 LED Patterns

WS101 equips with a LED indicator to indicate the network status and reset button features. Besides, when button is pressed, the indicator will light up at the same time. Red indicator means network is unregistered, while green indicator means device has registered on network.

3. Operation Guide

3.1 Button Mode

WS101 provides 3 kinds of pressing actions allowing users to define different alarms. Please refer to chapter 5.1 for detailed message of every action.

3.2 NFC Configuration

WS101 can be configured via NFC-enabled smartphone.

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 App 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. Diagram showing a smartphone with NFC symbol near the device.
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, move the phone away and back to try again.
3) WS101 can also be configured by ToolBox software via dedicated NFC reader provided by Milesight IoT, you can also configure it via TTL interface inside the device.

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

Note:
1) Please contact sales representative for device EUI list if there are many units.
2) Please contact sales representative 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 device 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.

3.4 General Settings

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

3.5 LoRa D2D Settings

LoRa D2D protocol is developed by Milesight and used for setting up transmission among Milesight devices without gateway. When the LoRa D2D setting is enabled, WS101 can work as a LoRa D2D controller to send control commands to trigger LoRa D2D agent devices.

1. Enable LoRa D2D feature.
2. Define a unique LoRa D2D key which is the same as LoRa D2D agent devices, then select the frequency and spreading factor. (Default LoRa D2D Key: 5572404C696E6B4C6F52613230313823)
3. Enable one of WS101 button mode and configure a 2-byte hexadecimal command (This command is pre-defined in LoRa D2D agent device). When you press as this button mode, WS101 will send the control command to corresponding LoRa D2D agent devices.

Note: When this feature is enabled, the device will not send uplinks to LoRaWAN® network server.

Button Mode Configuration for LoRa D2D:

3.6 Maintenance

3.6.1 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 upgrade.
2) Only Android version ToolBox supports the upgrade feature.

3.5.2 Backup

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

Screenshot showing template management in the app, including options to create new templates, edit, and delete existing ones.

3.5.3 Reset to Factory Default

Please select one of the following methods to reset device:

• Via Hardware: Hold on the reset button for more than 10s. After reset complete, the indicator will blink in green twice and device will reboot.
• Via ToolBox App: Go to Device -> Maintenance to tap “Reset”, then attach smartphone with NFC area to device to complete reset.

4. Installation

3M Tapes Fix:

Paste 3M tape to the back of the button, then tear the other side and place it on a flat surface. Diagram showing application of 3M tape to the device and mounting it.

Screw Fix:

Remove the back cover of the button, screw the wall plugs into the wall and fix the cover with screws on it, then install back the device. Diagram showing wall plugs being screwed in and the device cover being attached with screws.

Lanyard:

Pass the lanyard through the aperture near the edge of the button, then you can hang the button onto keychains and the like. Diagram showing a lanyard being attached to the device.

5. Device Payload

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

For decoder examples you can find at https://github.com/Milesight-IoT/SensorDecoders.

5.1 Basic Information

WS101 reports basic information of button whenever joining the network.

Example: ff0bff ff0101 ff086538b2232131 ff090100 ff0a0102 ff0f00

5.2 Button Message

WS101 reports battery level according to reporting interval (1080 mins by default) and button message when button is pressed. Besides, when battery level is lower than 10%, it will upload battery package once.

Example: 01 75 64

Example: ff 2e 01

5.3 Downlink Commands

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

Example: Set reporting interval as 20 minutes.

-END-