Milesight WS50x Smart LoRaWAN Wall Switch User Guide
- June 5, 2024
- Milesight
Table of Contents
WS50x Smart LoRaWAN Wall Switch
WS50x
User Guide
Safety Precautions
Milesight will not shoulder responsibility for any losses or damages resulting from not following the instructions of this operating guide.
- The installation and maintenance must be conducted by a qualified service person and should strictly comply with the electrical safety regulations of the local region.
- Ensure the breaker is powered out during the installation.
- Do not leave any object inside the switch box when installation.
- 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 configuring. The default password is 123456.
- In order to realize the best data transmission, ensure the device is within the signal range of the LoRaWAN® gateway and keep it away from metal objects and obstacles.
- Do not overload the maximum capacity to avoid damaging the device.
- The device is intended for indoor use only.
- Do not place the device where the temperature is below/above the operating range.
- Do not place the device close to naked flames, heat source (such as oven or sunlight), cold source, liquid, and objects with extreme temperature changes.
- Use the device in a clean environment only. Dusty or dirty environments may prevent the proper operation of this device.
- The device must never be subjected to physical shocks or strong vibration.
Declaration of Conformity
WS50x is in conformity with the essential requirements and other relevant
provisions of the CE, FCC, and RoHS.
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.
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
Date | Doc Version | Description |
---|---|---|
June 24, 2022 | V 1.0 | Initial version |
Product Introduction
1.1 Overview
WS50x is a smart LoRaWAN® wall switch for the local and remote control of
lights and electrical appliances. It adopts two standard sizes for most of
international wall switch types, which can replace the traditional wall
switches directly. Compliant with the Milesight LoRaWAN® gateway and Milesight
IoT Cloud solution, WS50x can be monitored and controlled via a web page or
mobile App remotely and triggered by other Milesight sensors. Besides
LoRaWAN®, WS50x supports Milesight LoRa D2D communication protocol, which can
set up a connection quickly and be controlled without a gateway. WS50x can be
widely used for wireless control of indoor lights, fans, heaters, machines,
etc.
1.2 Features
- Support local or remote control via a relay with high-reliability
- Support surge protection, and overload protection to prevent the device from being damaged
- Collect data of current, voltage, power, and electrical consumption
- Built-in switch indicator for easy use in dark environment
- Up to 15 km communication range
- Easy configuration via NFC
- Standard LoRaWAN® technology
- Compatible with Milesight IoT Cloud
- Support Milesight LoRa D2D protocol to enable ultra-low latency control without gateway
- Support multicast for control in bulk
Hardware Introduction
2.1 Packing List
If any of the above items is missing or damaged, please contact your sales representative.
2.2 Hardware Overview
**2.3 Dimensions (mm)
2.4 Wiring Diagram
**
Installation
-
Ensure the circuit has been shut off and the old switch has been taken off.
-
Open the front panel of the WS50x switch.
-
Connect corresponding wires to the WS50x switch.
-
Fix the WS50x switch to the switch box with mounting screws, then fix the front panel back to the device.
Operation Guide
4.1 NFC Configuration
WS50x can be configured via an NFC-supported mobile phone.
-
Download and install the “Milesight ToolBox” App from Google Play or Apple App Store.
-
Enable NFC on the smartphone and open Milesight ToolBox.
-
Attach the smartphone to the NFC area of the switch to read device information.
-
Basic information and settings of the WS50x switch will be shown on the 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 configuring. The default password is 123456.
Note:
- Ensure where is the NFC area on your smartphone, and it’s recommended to take off the phone case.
- If the smartphone fails to read/write configurations via NFC, keep the phone away and back to try again.
- WS50x can also be configured by ToolBox software via a dedicated NFC reader provided by Milesight IoT.
4.2 LoRaWAN Settings
LoRaWAN settings are used to configure the data transmission parameters in the
LoRaWAN® network.
4.2.1 Basic Settings
WS50x supports basic configurations like join type, App EUI, App Key and other
information. You can also keep all settings unchanged by default.
Parameters|
Description
---|---
Device EUI| The unique ID of the device can also be found on the label.
App EUI| 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 both available.
Application Key| Apply for OTAA mode is default as
5572404C696E6B4C6F52613230313823.
Device Address| Devendra for ABP mode is default as the 5th to 12th digits of
SN.
Network Session Key| Whiskey for ABP mode is default as
5572404C696E6B4C6F52613230313823.
Application Session Key| Appskey for ABP mode is default as
5572404C696E6B4C6F52613230313823.
---|---
LoRaWAN Version| V1.0.2 and V1.1.0 are available.
Work Mode| This device supports Class C only.
RX2 Data Rate| RX2 data rate to receive downlinks or LoRa D2D commands.
RX2 Frequency/MHz| RX2 frequency to receive downlinks or LoRa D2D commands.
Confirmed Mode| If the device does not receive an ACK packet from a network
server, it will resend data once.
Rejoin Mode| 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 re-join the network.
ADR Mode| Allow the network server to adjust the data transmission rate of the
device.
Spread Factor| If ADR is disabled, the device will send data via this spread
factor.
Tx Power| Transmit power of the device.
Note:
- Please contact the sales representative for the device EUI list if there are many units.
- Please contact the sales representative if you need random App keys before purchase.
- Select OTAA mode if you use Milesight IoT Cloud to manage devices.
- Only OTAA mode supports rejoin mode.
4.2.2 Frequency Settings
Select supported frequency and channels to send uplinks. Make sure the
channels match the LoRaWAN® gateway.
If the 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 the -868M model, the
default frequency is EU868; For the -915M model, the default frequency is
AU915.
4.2.3 Multicast Settings
WS50x supports setting up several multicast groups to receive multicast
commands from the network server, then users can use this feature to control
devices in bulks. 1. Enable Multicast Group on WS50x, and set a unique
multicast address and keys to distinguish other groups. You can also keep
these settings by default.
Parameters | Description |
---|---|
Multicast Address | Unique 8-digit address to distinguish different multicast |
groups.
| 32-digit key. Default values:
Multicast McNetSkey
| Multicast Group 1: 5572404C696E6B4C6F52613230313823 Multicast Group 2: 5572404C696E6B4C6F52613230313824
Multicast Group 3: 5572404C696E6B4C6F52613230313825
| Multicast Group 4: 5572404C696E6B4C6F52613230313826
| 32-digit key. Default values:
Multicast McAppSkey| Multicast Group 1: 5572404C696E6B4C6F52613230313823
Multicast Group 2: 5572404C696E6B4C6F52613230313824
Multicast Group 3: 5572404C696E6B4C6F52613230313825
| Multicast Group 4: 5572404C696E6B4C6F52613230313826
32. Add a multicast group on the network server. Take Milesight UG6x gateway
as an example, go to “Network Server -> Multicast Groups”, and click “Add” to
add a multicast group.
Fill in the multicast group information the same as WS50x settings, and select
the devices which you need to control, then click “Save”.
3. Go to “Network Server -> Packets”, select the multicast group and fill in
the downlink command, click “Send”. The network server will broadcast the
command to devices that belong to this multicast group.|
Note: ensure all devices’ application ports are the same.
4.3 General Settings
Parameters | Description |
---|---|
**** Reporting Interval | The interval of reporting switch status and |
electrical parameters. Default: 20 mins, Range: 1 – 1080 mins
LED Indicator| Enable or disable the light of switch button. This will
not affect the blinks when you hold on switch buttons to reset the device.
Power Consumption| Record the power consumption. If disabled, the device will
stop recording and the power consumption value will stop updating.
When Power is Restored| If the device is powered off and restored, the device
will change according to this parameter.
Button Lock| If enabled, all switch buttons will not be allowed to turn
on/off or reset to factory default.
Change Password| Change the password for ToolBox App to write this device.
4.4 LoRa D2D Settings
Lora D2D protocol is developed by Milesight and used for connection among
Milesight devices without a gateway. When Lora D2D setting is enabled, WS50x
can work as the LoRa D2D agent device to receive commands from LoRa D2D
controller devices.
-
Ensure the RX2 datarate and RX2 frequency in LoRaWAN settings are the same as the LoRa D2D controller device.
-
Enable the LoRa D2D feature, and define a unique LoRa D2D key to be the same as the setting in the LoRa D2D controller device. (Default LoRa D2D Key: 5572404C696E6B4C6F52613230313823)
-
Define a 2-byte hexadecimal control command (0x0000 to 0xffff) and command action. For example, you can configure a control command 12ff to turn on any button as below. WS50x supports at most 16 control commands.
-
These control commands can be configured in the LoRa D2D controller device. When LoRa D2D controller device is triggered, it will send the pre-defined control commands to control the switches of WS50x to on, off or inverse status.
4.5 Maintenance
4.5.1 Upgrade
- Download firmware from www.milesight-iot.com to your smartphone.
- Open ToolBox App and click “Browse” to import firmware and upgrade the device.
Note
- Operation on ToolBox is not supported during the upgrade.
- Only the Android version of ToolBox supports the upgrade feature.
4.5.2 Backup
WS50x 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.
- Go to the “Template” page on the App and save current settings as a template. You can also edit the template file.
- Select one template file that is saved in the smartphone and click “Write”, then attach it to another device to write the configuration.
Note: Slide the template item to the left to edit or delete it. Click the
template to edit the configurations.
4.5.3 Reset to Factory Default
Please select one of the following methods to reset the device:
Via Hardware: Hold on the button for more than 10s until the button light
blinks, this should ensure the button lock is disabled.
Via Toolbox App: Go to Device - > Maintenance to tap “Reset”, then attach
a smartphone with an NFC area to the device to complete the reset.
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, you can find at https://github.com/Milesight-
IoT/SensorDecoders.
5.1 Basic Information
WS50x reports basic information of the device whenever it joins the network.
Channel
| Type|
Description
---|---|---
ff| 01(Protocol Version)| 11=>V1.1
09 (Hardware Version)| 01 40 => V1.4
0a (Software Version)| 01 14 => V1.14
0b (Power On)| Device is on
16 (Serial Number)| Serial number of this device, 16 digits
Example:
ff0bff ff0101 ff090100 ff0a0101 ff166771c21070911328
Channel| Type| Value| Channel| Type|
Value
ff| 0b(Power On)| ff (Reserved)| ff| 01(Protocol Version)| 01(V1.0)
Channel| Type| Value| Channel| Type| Value
ff| 09(Hardware Version)| 0100 (V1.0)| ** ff| 0a (Software
Version)| 0101 (V1.1)
Channel| Type| Value**| | |
ff| 16 (Serial Number)| 6771c21070 911328| | |
5.2 Sensor Data
WS50x reports switch status and electrical data according to reporting
interval (20 mins by default). Besides, when any switch status changes, the
device will upload the switch status immediately.
Channel | Type | Description |
---|---|---|
03 | 74 (Voltage) | UINT16, Unit: V |
Resolution: 0.1 V
04| 80 (Active Power)| UINT32, Unit: W
05| 81 (Power Factor)| UINT8, Unit: %
06| 83 (Power Consumption)| UINT32, Unit: Wh
---|---|---
07| c9 (Total Current)| UINT16, Unit: mA
08| 29 (Switch Status)| Bit 0: status of switch 1
Bit 1: status of switch 2
Bit 2: status of switch 3
Bit 3: reserved
Bit 4: the changing status of switch 1 Bit 5: the changing status of switch 2
Bit 6: the changing status of switch 3 Bit 7: reserved
E xample:
082913 058164 07c90200 0374b208 068301000000 048001000000
Channel| Type| Value| Channel| Type|
Value
08| ** 29 (Switch Status)| 13= 00010011
=> switch 1 changed to open, and switch 2 remained opened| 05| 81 (Power
Factor)| 64=> 100%
Channel| Type| Value| Channel| Type| Value
** 07| c9 (Current)|
02 00=>00
02=2mA
| ****
03
| * 74(Voltage)| b2 08=>08 b2=2226
Voltage=2226
0.1=222.6V
Channel| Type| Value| Channel| Type| Value**
06
| 83(Power Consumption)| 01 00 00 00=>00
00 00 01=1
Wh=0.001 kWh| **** 04| 80 (Active Power)| 01 00 00
00=>00 00 00
01=1 W
5.3 Downlink Commands
WS50x supports downlink commands to configure the device. The application port
is 85 by default.
Channel| Type|
Description
---|---|---
08| –| Byte 1:
Bit 0~3: every switch control status, 0 for close, 1 for open.
Bit 4~7: every switch change status, 0 = not
| | allow control, 1 = allow control Byte 2: ff
---|---|---
ff| 03 (Set Reporting Interval)| 2 Bytes, unit: s
10 (Reboot Device)| ff
22 (Add Delay Task)| Byte 1: 00
Byte 2-3: delay time, unit: s
Byte 4:
Bit 0~3: desired status for each switch. Bit 4~7: mask of switches to
change, only masked switch will be changed to the desired status.
Note: WS50x supports adding only one task.
The later command will cover the previous command.
23 (Delete Delay Task)| 00 ff
25 (Set Button On/Off Lock)| 0080-disable to turn on/off via button,
0000-enable to turn on/off via a button
26 (Power Consumption)| 00-disable, 01-enable
27 (Reset Power Consumption)| ff
28 (Enquire Electrical Status)| ff
2f (Set Button Light Mode)| 00-disable
01- enable (Button light indicator on when switch button is off)
02- enable (Button light indicator on when the switch button is on)
5e (Set Button Reset Lock)| 00-enable to reset via button, 01-disable to reset
via button
Example:
1. Close Switch 1 of WS501, WS502, WS503.
0810ff
Channel| Type|
Command
08
|
–
| Byte 1: 10 => 0001 0000 (Bit 4 = 1 => Allow switch 1 control, Bit0 = 0 => Switch 1 close) Byte 2: ff is reserved
2. Set reporting interval as 20 minutes.
ff03b004
Channel
| Type|
Value
ff| 03 (Set Reporting Interval)| b0 04 => 04 b0 = 1200 s = 20 minutes
3. Add a delay task: open switch 1 after 1 minute.
ff32003c002000
Channel| Type| Value
ff| 22 (Add Delay Task)| Byte 1:00
Byte 2-3: 3c 00 => 00 3c = 60 s = 1 min
Byte 4: 11 = 0001 0001 => Open switch 1
4. Delete the delay task
ff2300ff
Channel| Type| Value
ff| 23 (Delete Delay Task)| 00ff
5. Disable the collection and upload of power consumption.
ff2600
Channel| Type| Value
ff| 26 (Power Consumption)| 00 = disable
6. Reboot the device.
ff10ff
Channel| Type| Value
ff| 10 (Reboot Device)| ff (Reserved)
7. Disable the button light.
ff2f00
Channel| Type| Value
ff| 2f (Set LED Indicator Mode)| 00 for disable LED indicator
-END-
Documents / Resources
|
Milesight WS50x Smart LoRaWAN Wall
Switch
[pdf] User Guide
WS50x, Smart LoRaWAN Wall Switch, WS50x Smart LoRaWAN Wall Switch
---|---