Milesight WS136 Lora Wan Smart Scene Panel

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 device the 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 while. Otherwise, the battery will leak and damage the device.
• Make sure both batteries are newest when install, or battery life will be reduced.
• The device must never be subjected to shocks or impacts.

Declaration of Conformity

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

Copyright © 2011-2024 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	Doc Version	Description
Oct. 19, 2021	V 1.0	Initial version
Aug. 1, 2022	V 1.1	Change insulating sheet place Change RX2 setting place
Jan. 16, 2023	V 1.2	Add Single-Channel Mode; Add Milesight D2D LoRa Uplink feature; Add reboot downlink command.
Jan.16, 2024	V 1.3	Add button active mode; Update button uplink content; Add downlink command for confirmed mode.

Product Introduction

Overview

WS136 & WS156 is a LoRa WAN® based smart panel for wireless controls, triggers and alarms.
Without any additional cable, WS136 & WS156 can be easily installed anywhere and control devices via LoRa WAN or Milesight D2D communication protocol. Besides, it’s equipped a user-definable E-ink screen to suit different scenes. WS136 & WS156 can be widely used in smart home, smart office, hotel, school, etc.

Features

• Equipped with a programmable E-ink screen for flexible display
• Up to 6 scenes settable, each scene can consist of multiple devices
• Easy configuration via NFC
• Standard LoRa WAN® support
• Milesight IoT Cloud compliant
• Milesight D2D control without gateway
• Compact design, easy to install

Hardware Introduction

Packing List

• 1 × WS136 or WS156 Device
  
• 1 × 3M Tape
  
• 2 × Mounting Screws
  
• 1 × Warranty Card
  
• 1 × Quick Guide
  

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

Hardware Overview

Note: For WS136, the E-ink screen is replaced by PVC sticker and the icons on the sticker supports customization.

Dimensions (mm)

LED Patterns

Indicator	Action	Indication
Button Light	Press the button	Always on until the button is being released
Status Indicator	Send join network requests	Blinks as requests
	Joined the network successfully	Blinks twice
	Receive ACK packages from NS	Blinks once

Operation Guide

NFC Configuration

WS136 & WS156 can be configured via NFC-enabled smartphone.

1. Pull out the battery insulating sheet to power on the device.
   
2. Download and install “Milesight Tool Box” App from Google Play or App Store.
3. Enable NFC on the smartphone and open Milesight Tool Box.
4. Attach the smartphone with NFC area to the device to read device information.
   
5. Basic information and settings of the device will be shown on Tool Box 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 position 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. WS136 & WS156 can also be configured by Tool Box software via dedicated NFC reader provided by Milesight IoT.

LoRa WAN Settings

Go to Device > Setting > LoRa WAN Settings of Tool Box App to configure 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	Default App EUI is 24E124C0002A0001.
Application Port	The port is used for sending and receiving data, the default port is 85.
Join Type	OTAA and ABP modes are available.
LoRa WAN Version	V1.0.2, V1.0.3 are available.
Work Mode	It’s fixed as Class A.
Application Key	Appkey for OTAA mode, default is 5572404C696E6B4C6F52613230313823.
Device Address	Dev Addr 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	Appskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
RX2 Data Rate	RX2 data rate to receive downlinks or send D2D commands.
RX2 Frequency/MHz	RX2 frequency to receive downlinks or send D2D commands.
Channel Mode	Select Standard-Channel mode or Single-Channel mode. When Single-Channel mode is enabled, only one channel can be selected to send uplinks. Please enable Single-Channel mode if you connect device to DS7610.
Channel	Enable or disable the frequency to send uplinks.
	If 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 ACK packet from network server, it will resend data once.
Rejoin Mode	The device will send a specific number of Link Check Req MAC packets to the network server every 30 mins to validate connectivity; If there is no response, the device will re-join the network.
Set the number of packets sent	When rejoin mode is enabled, set the number of Link Check Req packets sent.
ADR Mode	Allow network server to adjust data rate of the device. This only works with Standard-Channel Mode.
Tx Power	Transmit power of the device.

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.

General Settings

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

Parameters	Description
Reporting Interval	Reporting interval of battery level to network server. Default: 1080 min
Active Mode	Select the active mode of buttons. Short press: press once (≤1.5 seconds). Double press: press twice (press interval is within 1.5 seconds). Long press: press once (>1.5 seconds). Supported options:
Change Password	Change the password for Tool Box App to write this device.

Milesight D2D Settings

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

1. Configure RX2 data rate and RX2 frequency in LoRa WAN® settings, it is suggested to change the default value if there are many LoRa WAN® devices around.
   Go to Device > Settings > D2D Settings to enable Milesight D2D feature, and define an unique Milesight D2D key that is the same as Milesight D2D agent devices.
   (Default Milesight D2D Key: 5572404C696E6B4C6F52613230313823)
   
2. Enable one of WS136 & WS156 button mode and configure a 2-byte hexadecimal command (This command is pre-defined in Milesight D2D agent device). When you press this button, WS136 & WS156 will send the control command to corresponding Milesight D2D agent devices.
   Note: If you enable LoRa Uplink feature, LoRa WAN® uplink packet that contains the button status will be sent to gateway after the Milesight D2D control command is sent.
   

E-ink Screen Display Settings

WS156 supports e-ink screen display content programming according to user requirements.

1. Every button shows 1 to 6 numbers by default. Users can modify these numbers to any characters or click Custom to import pictures. When importing pictures, the recommended resolution is 128*270.
2. After modifying or importing, click Preview to check the display result on the upper picture.
3. Click Write, then attach the smartphone with NFC area to the device to complete the screen programming.
4. Click Save to save the current display as a template in Tool Box App. You can import this template to another device by clicking Import Template.
   

Note:

1. WS156 e-ink screen will show below fixed icons:
   

   Icon	Description
   	Battery level
   	The device joins the network.
   	The device fails to join the network.

2. WS156 do a full-screen refresh once a week in order to remove ghosting.

Maintenance

Upgrade

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

Note:

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

Backup

WS136 & WS156 supports configuration backup for easy and quick device configuration in bulk.

Backup is allowed only for devices with the same model and LoRa WAN® 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.
   Milesight

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

Reboot and Reset

Via Hardware: Hold on the button inside the device for 3s to reboot, 10s to reset.
Via Tool Box App: Go to Device > Maintenance to tap Restart or Reset, then attach smartphone with NFC area to the device to complete reboot or reset.

Installation

WS136 & WS156 can be placed on the desktop directly. If it needs to be fixed, please try below installation methods.

Fixed by 3M Tapes:

Paste 3M tape to the back of the panel, then tear the other side and place it on a flat surface.
Please note the screen direction when installing.

Fixed by 86 Box:

Remove the back cover of the panel, screw the back cover to the 86 box with two M4 mounting screws, then install back the panel. Please note the screen direction when installing.

Device Payload

All data are based on the following format(HEX), the Data field should follow little -endian:

Channel 1	Type 1	Data1	Channel 2	Type 2	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

WS136 & WS156 report basic information of panel whenever joining 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

Example:

ff0bff ff0101 ff166592b32851010013 ff090100 ff0a0102
Channel	Type	Value	Channel	Type	Value
ff	0b (Power On)	ff (Reserved)	ff	01 (Protocol Version)	01 (V1)
Channel	Type	Value	Channel	Type	Value
ff	16(Device	6592b328510	ff	09	0100
	SN)	10013		(Hardware version)	(V1.0)
Channel	Type	Value
ff	0a (Software version)	0102 (V1.2)

Button Message

Item	Channel	Type	Description
Battery Level	01	75	UINT8, Unit: %
Button Message	ff	34	Byte 1: Button Number Byte 2: Active Mode 00=Short press 01=Short press, Double press 02=Short press, Long press 03=Short press, Long press, Double press Byte 3: Trigger event, 00=Short press, 01=Double press, 02=Long press

Example:

1. Battery Level: Report according to reporting interval or report once when the battery level is lower than 10%.
   

   01 75 64
   Channel	Type	Value
   01	75	64 => 100%

2. Button Uplink: Active mode is set as Short press, Double press. When short press button 4 once:
   

   ff 34 04 01 00
   Channel	Type	Value
   ff	34	04 => Button 4 01=Short press, Double press 00=Short press trigger

Note: if you press one button more than 6 times in a row, the 7th and follow-up messages will delay delivery.

Downlink Commands

WS136 & WS156 supports downlink commands to configure the device. Application port is 85 by default.

Note: Since the device type is class A, it only receives downlinks when the device upload battery level or button message to network server.

Item	Channel	Type	Description
Reporting Interval	ff	03	2 Bytes, unit: s
Reboot		10	ff
Milesight D2D Key		35	First 16 digits, last 16 digits are fixed as 0
Milesight D2D Spreading Factor and Frequency		36	Byte 1: Spreading factor Byte 2-3: Frequency, unit: Hz
Confirmed Mode		c6	Byte 1: 00=disable, 01=enable Byte 2: ACK times, range: 1~5 Note: this only takes effect after the device reboots or rejoins the network.

Example:

1. Set reporting interval as 20 minutes.
   

   ff03b004
   Channel	Type	Value
   ff	03	b0 04=>04 b0=1200s =20 minutes

2. Set Milesight D2D key as 12345678123456780000000000000000.
   

   ff351234567812345678
   Channel	Type	Value
   ff	35	12 34 56 78 12 34 56 78

3. Set Milesight D2D spreading factor as DR5(SF7) and frequency as 505.7 MHz.
   

   ff3605a05e241e
   Channel	Type	Value
   ff	36	Byte 1: 05 (DR5) Byte 2: a0 5e 24 1e => 1e 24 5e a0=505700000 Hz (505.7 MHz)

4. Reboot the device.
   

   ff10ff
   Channel	Type	Value
   ff	10 (Reboot)	ff (Reserved)

CUSTOMER SUPPORT

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

Documents / Resources

Milesight WS136 Lora Wan Smart Scene Panel [pdf] User Guide WS136, WS156, WS136 Lora Wan Smart Scene Panel, WS136, Lora Wan Smart Scene Panel, Smart Scene Panel, Scene Panel, Panel

References

• User Manual