Milesight WS523 Featuring LoRaWAN Portable Socket
Safety Precautions
Milesight will not shoulder responsibility for any losses or damages resulting from not following the instructions of this operating guide.
- The device must not be modified in any way.
- To protect the security of the device, please change device the password when first configured. The default password is 123456.
- To get best data transmission, ensure the device is within the signal range of the LoRaWAN® gateway and avoid the metal obstacles.
- Do not overload the maximum capacity to avoid damage of the device.
- The device is intended only for indoor use. Do not place the device where the temperature is below/above the operating range.
- Do not place the device close to objects with naked flames, heat source (oven or sunlight), cold source, liquid and extreme temperature changes.
- Use the device only in a clean environment. Dusty or dirty environments may prevent the proper operation of this device.
- The device must never be subjected to shocks or impacts.
- Use a dry, clean cloth to clean the device. Do not use strong chemicals or detergents which may damage the device.
Declaration of Conformity
WS523 conforms 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.
- 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
Revision History
| Date | Doc Version | Description |
| August 11, 2021 | V 1.0 | Initial version |
|
October 25, 2021 |
V 1.1 |
1. Add multicast feature
2. Support RX2 configuration |
| January 10, 2022 | V 1.2 | Support power outage alert |
|
January 9, 2023 |
V 1.3 |
1. Add Milesight D2D Agent feature
2. Add Single Channel mode 3. Add reboot downlink command 4. Add an overcurrent protection feature |
Product Introduction
Overview
WS523 is a LoRaWAN® smart portable socket for the monitoring and control of electronic appliances. Supporting a variety of international socket types, WS523 can be used to turn on or off electronic devices locally or remotely, to measure power consumption data, and even to send alarms in case of overcurrent events. Due to its intelligence, WS523 is suitable for wireless control of indoor lights, fans, heaters, machines, etc.
Power data is transmitted via LoRaWAN® protocol, and LoRaWAN® technology enables encrypted radio transmissions over long distances while consuming very little power. Also, users can check visualized data through Milesight IoT Cloud or the user’s own Application Server.
Features
- Plug & play experience
- Support a variety of international socket types
- Turn on/off devices and create timing switch-on/off schedules remotely
- Collect data of current, voltage, electrical consumption
- Support overload protection
- Up to 15 km communication range
- Easy configuration via NFC
- Standard LoRaWAN® technology
- Compatible with Milesight IoT Cloud and Milesight ToolBox
Hardware Introduction
Packing List
- If any of the above items is missing or damaged, please contact your sales representative.
Hardware Overview
Note: The outlook will differ according to socket types.
Dimensions (mm)
Note: The plug size will a little differ according to socket types.
Power Button and LED Patterns
| Function | Action | LED Indicator |
| Open the Socket |
Press the power button. |
Off → Static On |
| Close the Socket | Static On → Off | |
| Network Status | Send join network requests. | Blinks once |
| Join the network successfully. | Blinks twice | |
| Reset to Factory
Default |
Press and hold the power button for more than 10s. | Quickly blinks |
Note
- Network status will only display when LED is enabled and the socket powers on.
- If WS523 still fails to join the network after 32 join requests, the LED will stop blinking.
- Reset operation is not affected even button lock is enabled or LED indicator is disabled.
Operation Guide
NFC Configuration
WS523 can be configured via smartphone with NFC function.
- Plug WS523 into a wall socket, and then WS523 will switch on automatically.
- Download and install the “Milesight ToolBox” App from Google Play or the App Store.
- Enable NFC on the smartphone and launch Milesight ToolBox.
- Attach the smartphone with NFC area to the device to read device information. Basic information and settings of the device will be shown on the ToolBox App if it’s recognized successfully. You can read and configure the device by tapping the Read/Write device on the App. To protect the security of the device, password validation is required when configuring via smartphone. The default password is 123456.
- Press the power button, WS523 portable socket will supply electric power to other electronic appliances.
Note
- Check the NFC area of your smartphone and it’s recommended to remove the phone case.
- If the smartphone fails to read/write configurations via NFC, move the phone away and back to try again.
- WS523 can also be configured on ToolBox via a dedicated NFC reader provided by Milesight IoT.
LoRaWAN Settings
LoRaWAN settings are used to configure the data transmission parameters in the LoRaWAN® network.
Basic Settings
WS523 supports basic configurations like join type, App EUI, App Key, and other information. You can also keep all settings by default.
| 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 | App key for OTAA mode, default is 5572404C696E6B4C6F52613230313823. |
| Device Address | DevAddr for ABP mode, default is the 5th to 12th digits of SN. |
| Network Session
Key |
Nwkskey for ABP mode, default is 5572404C696E6B4C6F52613230313823. |
| Application
Session Key |
The 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 C. |
| RX2 Data Rate | RX2 data rate to receive downlinks or Milesight D2D commands. |
| RX2 Frequency | RX2 frequency to receive downlinks or Milesight D2D commands. Unit: Hz |
| Channel Mode | Select Standard-Channel mode or Single-Channel mode. When Single-Channel
mode is enabled, and only one channel can be selected to send uplinks. Please enable Single-Channel mode if you connect the device to DS7610. |
| Channel |  Enable or disable the frequency to send uplinks.
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 Null: Indicates that all channels are disabled
|
| Spread Factor | If ADR is disabled, the device will send data via this spread factor. |
| Confirmed Mode | If the device does not receive an ACK packet from a network server, it will resend
data once. |
| Rejoin Mode | Reporting interval ≤ 30 mins: the device will send specific numbers of LoRaMAC packets to check connection status every 30 mins; If no replies after specific packets are being sent, the device will re-join.
Reporting interval > 30 mins: the device will send specific numbers of LoRaMAC packets to check connection status at every reporting interval; If no replies after specific packets are sent, the device will re-join. |
| Set the number of packets sent | When rejoin mode is enabled, set the number of LinkCheckReq packets sent. |
| ADR Mode | Allow the network server to adjust the data rate of the device. |
| 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.
- For the -868M model, the default frequency is EU868; for the -915M model, the default frequency is AU915.
Multicast Settings
WS523 supports setting up several multicast groups to receive multicast commands from network servers and users can use this feature to control devices in bulk.
- Enable Multicast Group on WS523, 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. |
| McNetSkey | 32-digit key. Default values:
Multicast Group 1: 5572404C696E6B4C6F52613230313823 Multicast Group 2: 5572404C696E6B4C6F52613230313824 Multicast Group 3: 5572404C696E6B4C6F52613230313825 Multicast Group 4: 5572404C696E6B4C6F52613230313826 |
| McAppSkey | 32-digit key. Default values:
Multicast Group 1: 5572404C696E6B4C6F52613230313823 Multicast Group 2: 5572404C696E6B4C6F52613230313824 Multicast Group 3: 5572404C696E6B4C6F52613230313825 Multicast Group 4: 5572404C696E6B4C6F52613230313826 |
- 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 WS523 settings, and select the devices that you need to control, then click Save.
- 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 belongs to this multicast group.
- Note: ensure all devices’ application ports are the same.
General Settings
- Go to Device > Settings > General Settings of ToolBox App to change the reporting interval, etc.
| Parameters | Description |
|
Reporting Interval |
The interval of reporting socket status and electrical parameters. Default:
20 mins, Range: 1-1080 mins |
| LED Indicator | Enable or disable the light indicated in Chapter 2.4. |
| 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, the Socket | If the device loses power and returns to the power supply, the device will switch the socket on or off according to this parameter. |
| Button Lock | If enabled, the power button status will freeze except when reset. |
| Overcurrent Alarm | When the current reaches the threshold, the device will send the socket status and
device electrical parameters. |
| Overcurrent Protection | When the current reaches the threshold, the device will stop supplying power. |
| Change Password | Change the password for the ToolBox App to write this device. |
Note: even overcurrent alarm or overcurrent protection is disabled, the device will also stop supplying power when the current is overrated by 30%, then send out an alarm packet.
Milesight D2D Settings
Milesight D2D protocol is developed by Milesight and used for connection among Milesight devices without a gateway. When the Milesight D2D setting is enabled, WS523 can work as the Milesight D2D Agent device to receive commands from Milesight D2D controller devices.
- Ensure the RX2 datarate and RX2 frequency in LoRaWAN settings are the same as the controller device.
- Enable D2D Settings, and define a unique D2D key to be the same as the settings in the Milesight D2D controller device.(Default D2D Key: 5572404C696E6B4C6F52613230313823)
- Define a 2-byte hexadecimal control command (0x0000 to 0xffff) and command action. For example, you can configure a control command 1510 to turn on the button as below. WS523 supports at most 16 control commands.
Maintenance
Upgrade
- Download firmware from www.milesight-iot.com to your smartphone.
- Open the 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.
Backup
WS523 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 the 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 the template. Click the template to edit the configurations.
Reset to Factory Default
- Please select one of the following methods to reset the device:
- Via Hardware: Hold on the power button for more than 10s until the LED quickly blinks.
- Via ToolBox App: Go to Device > Maintenance to tap Reset, then attach the smartphone with NFC area to a device to complete the resetting.
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 them at https://github.com/Milesight-IoT/SensorDecoders.
Basic Information
- WS523 reports basic information about the device whenever it joins the network.
| Channel | Type | Description |
| ff | 01(Protocol Version) | 01=>V1 |
| 09 (Hardware Version) | 01 40 => V1.4 | |
| 0a (Software Version) | 01 14 => V1.14 | |
| 0b (Power On) | Device is on | |
| 16 (Device SN) | 16 digits | |
| 24 (Overcurrent Alarm) | Byte 1: 00-disabled, 01-enabled Byte 2: current threshold | |
| 25 (Button Lock) | 00 00-disabled, 00 80-enabled | |
| 26 (Power Consumption) | 00-disabled, 01-enabled | |
| 30 (Overcurrent Protection) | Byte 1: 00-disabled, 01-enabled Byte 2: current threshold |
Example
| ff0101 ff166148b13783621055 ff090100 ff0a0103 ff24010a ff30010a ff250080 ff2601 | |||||
| Channel | Type | Value | Channel | Type | Value |
|
ff |
01
(Protocol Version) |
01(V1) |
ff |
16(Device SN) |
6148b13783
621055 |
| Channel | Type | Value | Channel | Type | Value |
|
ff |
09
(Hardware Version) |
0100 (V1.0) |
ff |
0a
(Software Version) |
0103 (V1.3) |
| Channel | Type | Value | Channel | Type | Value |
|
ff |
24
(Overcurrent Alarm) |
01=>Enabled 0a=10A |
ff |
30
(Overcurrent Protection) |
01=>Enabled 0a=10A |
| Channel | Type | Value | Channel | Type | Value |
| ff | 25(Button
Lock) |
00
80=>Enabled |
ff | 26 (Power
Consumption) |
01=>Enabled |
Sensor Data
WS523 reports electrical data according to the reporting interval (20 minutes by default) or when the current reaches the overcurrent threshold.
| Channel | Type | Description |
| 03 | 74 (Voltage) | UINT16, Unit: V
Resolution: 0.1V |
| 04 | 80 (Active Power) | UINT32, Unit: W |
| 05 | 81 (Power Factor) | UINT8, Unit: % |
| 06 | 83 (Power Consumption) | UINT32, Unit: Wh |
| 07 | c9 (Current) | UINT16, Unit: mA |
| 08 | 70 (Socket Status) | 00: Close, 01: Open |
Example
| 087001 058129 07c91200 0374f508 068305000000 048001000000 | |||||
| Channel | Type | Value | Channel | Type | Value |
| 08 | 70 (Socket
Status) |
01 => Open | 05 | 81 (Power
Factor) |
29=> 41% |
| Channel | Type | Value | Channel | Type | Value |
|
07 |
C9 (Current) |
12 00=>00 12=18mA |
03 |
74(Voltage) |
f5 08=>08 f5=2293
Voltage=2293 *0.1=229.3V |
| Channel | Type | Value | Channel | Type | Value |
|
06 |
83(Power Consumption) | 05 00 00 00=>00
00 00 05=5 Wh=0.005kWh |
04 |
80 (Active Power) | 01 00 00
00=>00 00 00 01=1 W |
Power Outage Alert
WS523 will report an alert message when the power supply of WS523 is disconnected. This feature only works with hardware version 1.2 and later.
| ff3fff | ||
| Channel | Type | Value |
| ff | 3f (Power Outage) | ff(Reversed) |
Downlink Commands
WS523 supports downlink commands to configure the device. The application port is 85 by default.
| Channel | Type | Description |
| 08 | / | 00 00 ff-close, 01 00 ff-open |
| ff | 03 (Set Reporting Interval) | 2 Bytes, unit: s |
| 10 (Reboot) | ff | |
| 22 (Add Delay Task) | Byte 1: 00
Byte 2-3: delay time, unit: s Byte 4: 10-close, 11-open Note: WS523 supports adding only one task. The later command will cover the previous command. |
|
| 23 (Delete Delay Task) | 00 ff | |
| 24 (Overcurrent Alarm) | Byte 1: 00-disable, 01-enable Byte 2: current threshold | |
| 25 (Button Lock) | 00 00-disable, 00 80-enable | |
| 26 (Power Consumption) | 00-disable, 01-enable | |
| 27 (Reset Power Consumption) | ff | |
| 28 (Enquire Electrical Status) | ff | |
| 2f (LED Mode) | 00-disable, 01-enable | |
| 30 (Overcurrent Protection) | Byte 1: 00-disable, 01-enable
Byte 2: current threshold |
Example
- Open the supply of the socket.
080100ff Channel Command 08 01 00 ff=>Open - Set the reporting interval as 20 minutes.
ff03b004 Channel Type Value ff 03 (Set Reporting Interval)
b0 04=>04 b0=1200s =20 minutes
- Add a delay task: open the socket after 1minute
ff22003c0011 Channel Type Value ff
22 (Add Delay Task)
Byte 1:00 Byte 2-3: 3c 00=>00 3c=60s=1min
Byte 4: 11=>open
- Delete the delay task
ff2300ff Channel Type Value ff 23(Delete Delay Task)
00ff - Enable overcurrent alarm and protection and set the current threshold as 10A.
ff24010a ff30010a Channel Type Value Channel Type Value ff
24 (Overcurrent Alarm)
Byte 1: 01=> Enable Byte 2:0a=>10A
ff
30 (Overcurrent Protection)
Byte 1: 01=> Enable Byte 2:0a=>10A
- Reset power consumption
ff27ff Channel Type Value ff 27(Reset Power Consumption)
ff (Reserved) - Reboot the device.
| ff10ff | ||
| Channel | Type | Value |
| ff | 10(Reboot the
device) |
ff (Reserved) |
Service & Advies
- Telefoon: 0345 785 611 E-mail: support@AirTeq.eu. www.AirTeq.eu
- Pascalweg 2a 4104 BG Culemborg Netherlands
Documents / Resources
 |
Milesight WS523 Featuring LoRaWAN Portable Socket [pdf] User Guide WS523, WS523 Featuring LoRaWAN Portable Socket, Featuring LoRaWAN Portable Socket, LoRaWAN Portable Socket, Portable Socket, Socket |