Milesight WS203 Motion and TH Sensor User Guide

Check On/Off Status: Quickly press the power button once.
Reset to Factory Default PIR Status: Press and hold the power button for more than 10 seconds

LED Indicator:

Power On: Off / On

Power Off: On / Off
Light On: Device is on / Light Off: Device is off

Blink quickly: Blinks twice

NFC Configuration

Note:

Ensure the location of the NFC area of the smartphone and remove the phone case.

If the NFC configuration fails, remove the phone and try again.
Use a dedicated NFC reader provided by Milesight IoT for configuration.

FAQ

Q: How can I reset the WS203 sensor to factory default PIR status?
A: Press and hold the power button for more than 10 seconds to reset to factory default PIR status.

Q: What should I do if the NFC configuration fails?
A: Remove the phone, ensure proper positioning, and try again. If it still fails, use a dedicated NFC reader provided by Milesight IoT for configuration.

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 disassembled or remodeled in any way.
Do not expose the PIR lens to direct sunlight.

Do not paint or clean the PIR lens, or it will affect the detection of the device.
Ensure that you install the battery properly. Choose the right model and make it connect to the positive and negative terminals correctly.

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 sources (such as an oven), or exposure to sunlight, cold sources, liquid, and extreme temperature changes.
Remove the battery from the device if it is not to be used for an extended period. Otherwise, the battery might leak and damage the device.
The device must never be subjected to shocks or impacts.

Declaration of Conformity
WS203 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 Phase III, Xiamen 361024, China.

Revision History

Date	Doc Version	Description
Aug. 3, 2023	V 1.0	Initial version

Product Introduction

Overview

WS203 is an environmental monitoring device that combines motion and temperature/humidity (TH) sensors. By detecting motion within a 6-meter range based on passive infrared (PIR) technology, the WS203 can trigger TH detection and periodically report environmental status over the LoRaWAN® network.

With easy configuration and wireless detection, the WS203 offers a reliable and convenient solution for space and TH optimization. Compatible with the Milesight LoRaWAN® gateway and Milesight IoT Cloud platform, it enables real-time monitoring of occupant status for effective remote management. The WS203 can find applications in various settings including smart offices, buildings, hospitals, and more.

Key Features

Equipped with passive infrared and Fresnel Lens for motion or occupancy detection

Built-in high-accurate TH sensor along with PIR sensor enabling communicative triggers
Provide different types of PIR covers for adjustable and flexible field angles and different detecting ranges.
Store locally 1000 historical records and support retransmission to prevent data loss.

Equipped with NFC for one-touch configuration and support card emulation mode
Function well with standard LoRaWAN® gateways and network servers
Compatible with Milesight IoT Cloud

Support Milesight D2D protocol to enable ultra-low latency and direct control without a gateway.

Hardware Introduction

Packing List

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

Hardware Overview

Power Button and LED Indicator

Function	Action	LED Indicator
Power On/Off	Press and hold the power button for more than 3 seconds	Power On: Off → On
Power On/Off	Press and hold the power button for more than 3 seconds	Power Off: On → Off
Check On/Off Status	Quickly press the power button once.	Light On: Device is on
Check On/Off Status	Quickly press the power button once.	Light Off: The device is off.
Reset to Factory Default	Press and hold the power button for more than 10 seconds	Blink quickly
PIR Status	Vacant → Occupied	Blinks twice
PIR Status	Occupied → Vacant	Blinks twice

Dimensions (mm)

Operation Guide

NFC Configuration
WS203 sensor can be monitored and configured via NFC. Please refer to the following configuration steps.

Download and install the Milesight ToolBox App from Google Play or Apple App Store.
Enable NFC on the smartphone and launch Milesight ToolBox.

Attach the NFC area of a smartphone to the device, and click NFC Read to read device information. The 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, please change the password when first configuring. The default password is 123456.

Note:

Ensure the location of the NFC area of the smartphone and it’s recommended to take off the phone case.

If the smartphone fails to read/write configurations via NFC, remove the phone and try again.
WS203 sensor can also be configured by a dedicated NFC reader provided by Milesight IoT.

LoRaWAN® Settings
Go to Device > Settings > LoRaWAN® Settings of ToolBox App to configure AppEUI, Join Type, Application 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 is 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, the default is 5572404C696E6B4C6F52613230313823.
Network Session Key	Nwkskey for ABP mode, the default is 5572404C696E6B4C6F52613230313823.
Application Session Key	Appskey for ABP mode, the default is 5572404C696E6B4C6F52613230313823.
Device Address	DevAddr for ABP mode, the default is the 5th to 12th digits of the SN.
LoRaWAN® Version	V1.0.2 and V1.0.3 are available.
Work Mode	It’s fixed as Class A.
RX2 Data Rate	RX2 data rate to receive downlinks.
RX2 Frequency	RX2 frequency to receive downlinks. Unit: Hz

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 connecting to the DS7610.
Channel	Enable or disable the frequency to send uplinks. 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: Indicate that all channels are disabled
Confirmed Mode	If the device does not receive an ACK packet from the network server, it will resend data once.
Rejoin Mode	Reporting interval ≤ 35 mins: the device will send a specific number of LinkCheckReq MAC packets to the network server every reporting interval or every double reporting interval to validate connectivity; If there is no response, the device will re-join the network. Reporting interval > 35 mins: the device will send a specific number of LinkCheckReq MAC packets to the network server every reporting interval to validate connectivity; If there is no response, the device will re-join the network.
Set the number of packets sent.	When the rejoin mode is enabled, set the number of LinkCheckReq packets to send. Note: the actual sending number is Set the number of packet sent + 1.

ADR Mode	Allow the network server to adjust the data 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 sales for the device EUI list if there are many units.

Please contact sales if you need random App keys before purchase.
Select OTAA mode if you use the Milesight IoT cloud to manage devices.
Only OTAA mode supports rejoin mode.

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

Parameters	Description
Temperature Unit	Set the unit of temperature displayed on the status page.
Reporting Interval	The interval of reporting PIR status, temperature, humidity, and battery level to a network server. Default: 30 min, Range: 1 – 1440 min Note: WS203 will report the PIR “Occupied” status trigger packet immediately when it detects motions and the reporting interval will be re-calculated.
Time to Report Vacancy/min	A “Vacant” status trigger packet will be reported if the device does not detect motion within a certain period and the reporting interval will be re-calculated. Default: 5 min, Range: 1 – 60 min

LED Indicator	Enable or disable the LED to indicate PIR status.
Data Storage	Disable or enable data storage locally.
Data Retransmission	Disable or enable data retransmission.
Change Password	Change the password for the ToolBox App to write this device.

Advanced Settings

Calibration Settings
WS203 supports numerical calibration of the temperature and humidity values. Go to Device > Settings > Calibration Settings of ToolBox App to set the calibration value, the device will add calibration value to the current value and upload the final value.

Threshold Settings
Go to Device > Settings > Threshold Settings of ToolBox App to enable the threshold settings and input the temperature threshold. If the temperature threshold is triggered, the device will upload the alarm packet once instantly and collect the temperature & humidity data at the collected intervals until the alarm is released.

Data Storage
WS203 supports storing 1000 data records locally and exports data via the ToolBox App. The device will record the data according to the reporting interval even not joining the network.

Go to Device > Status of ToolBox App to sync the device time.

Go to Device > Setting > General Settings to enable the data storage feature.
Go to Device > Maintenance of ToolBox App, click Export, then select the data time range and click Confirm to export data. The maximum export data period on the ToolBox App is 14 days.
Click Export Record to find the export file records. Note: Slide the file record to the left to delete the record.

Click Data Cleaning to clear all stored data inside the device if necessary.

Data Retransmission
WS203 supports data retransmission to ensure the network server can get all data even if the network is down for some time. There are two ways to get the lost data:

The network server sends downlink commands to enquire about the historical data for specifying the time range.

When the network is down and no response from LinkCheckReq MAC packets for a period of time, the device will record the time of disconnection from the network and retransmit the lost data after the device is reconnected to the network.

Here are the steps of data retransmission:

Go to Device > Setting > General Settings to enable the data storage feature and data retransmission feature.

Go to Device > Setting > LoRaWAN Settings to enable the rejoin mode feature and set the number of packets sent. Take below as an example, the device will send LinkCheckReq MAC packets to the network server regularly to check if the network is disconnected; if there is no response 8+1 times, the join status will change to de-active and the device will record a data loss time point (the time to join the network).
After the network is connected back, the device will send the lost data from the point in time when the data was lost according to the data re-transmission reporting interval.

Note:

If the device is rebooted or re-powered when data retransmission is not completed, the device will re-send interrupted retransmission data again after the device is reconnected back to the network.
If the network is disconnected again during data retransmission, the device will only send the latest disconnection data.
The retransmission data format is started with “20ce”, please refer to section 5.4.

Data retransmission will increase the uplinks and shorten the battery life.

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

Configure RX2 data rate and RX2 frequency in LoRaWAN® settings, it is suggested to change the default value if there are many LoRaWAN® devices around.

Go to Device > Settings > D2D Settings to enable the D2D function and configure the D2D settings.

Parameters	Description
Enable	Enable or disable the Milesight D2D feature.
D2D Key	Define a unique D2D key which is the same as the setting in D2D agent devices. Default value: 5572404C696E6B4C6F52613230313823
Status Condition	When WS203 detects one or more of the below statuses, it will send the control command to the corresponding Milesight D2D agent devices: Occupied & Temperature threshold triggered Occupied (PIR) Vacant (PIR) Temperature threshold triggered The temperature threshold is lifted Note: for temperature threshold conditions, please enable and configure the temperature threshold feature under Threshold Settings.

Control command	Define a 2-byte hexadecimal control command (0x0000 to 0xffff).
LoRa Uplink	If enabled, a LoRaWAN® uplink packet that contains the PIR status or temperature alarm will be sent to the gateway after the Milesight D2D control the command is sent.
Control Time/min1	After receiving commands from WS203, Milesight D2D agent devices will take corresponding actions for this duration. Default: 5 mins, Range: 1 – 1440 mins

Maintenance

Backup
WS203 supports backup templates for easy and quick configuring devices in bulk. The backup feature is 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. The saved templates are also editable.
Select one saved template and click Write, then attach the smartphone to another device via NFC to reuse the template.

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

This feature is under development on Milesight D2D agent devices.

Upgrade

Download firmware from the Milesight website to your smartphone.
Go to Device > Maintenance of ToolBox App, tap 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.

Reset to Factory Default
WS203 supports two methods to reset the device which are as follows:

Via Hardware: Press and hold the power button for more than 10 until the LED indicator blinks quickly.
Via ToolBox App: Go to Device > Maintenance to tap Reset, then attach the smartphone to the device via NFC to complete the reset.

Installation

Installation Note:

Adjust the installation direction according to the detection area requirement.
Ensure the detection area does not have moving objects like waving trees and fans.

Ensure the detection area is not blocked by curtains or barriers.
Do not expose the device to direct infrared (including sunlight, light, etc.), or the PIR detection will be affected.
The recommended installation location is 2 m in height on the wall with the half PIR cover to avoid room light inference.

Avoid the device facing a transparent plate (like glass) within 5m since the PIR will detect through it.

PIR Cover Installation:
Take off the front cover of the device, then select the PIR cover as required and put it on the PIR sensor with groove alignment. The adjustable angle of every groove is 30°.

PIR cover reference guidance(wall mount and installation height=2m):

Fixed by 3M Tape:
Attach 3M tape to the back of the sensor, then tear the other side and place it on a flat surface. Please adjust the installation direction according to the detection area.

Note:

Since the default 3M tape has a high viscosity, please tear the device down via a screwdriver.
If it is necessary to tear the device down easily, please divide the 3M tape into several parts and only tear one part to the device.

Fixed by Mounting Kits:

Take off the front cover of the device, then fix the wall plugs to a flat surface according to the device mounting holes. Finally, secure the device to the wall plugs using screws. Please adjust the installation direction according to the detection area.
Restore the front cover of the device.

Device Payload

All the data is based on the following format (HEX), the Data field should follow the 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 please find the files on
https://github.com/Milesight-IoT/SensorDecoders.

Basic Information
WS203 sensor reports basic information whenever joining the network.

Channel	Type	Description
ff	0b (Power On)	Device is on
	01(Protocol Version)	01=>V1
	16 (Device SN)	16 digits
	09 (Hardware Version)	01 40 => V1.4
	0a (Software Version)	01 14 => V1.14

0f (Device Type)

00: Class A, 01: Class B, 02: Class C

Example:

ff0bff ff0101 ff166791d19604050005 ff090100 ff0a0101 ff0f00
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 SN)	6791d19604050 005	ff	09 (Hardware Version)	0100 (V1.0)
Channel	Type	Value	Channel	Type	Value
ff	0a (Software Version)	0101 (V1.1)	ff	0f (Device Type)	00 (Class A)

Sensor Data

Item	Channel	Type	Description
Battery Level	01	75	UINT8, Unit: %
Temperature	03	67	INT16, Unit: °C, Resolution: 0.1 °C
Humidity	04	68	UINT8, Unit: %, Resolution: 0.5 %RH
PIR Status	05	00	00: Vacant; 01: Occupied
			Temperature (2 Bytes) + Alarm Status(1
			Byte)
Temperature Alarm	83	67	Temperature: unit — °C Alarm Status:
			00 -Alarm release
			01 -Alarm

Examples:

Periodic packet: report as reporting interval (30 minutes by default).

017562 0367d500 04687f 050001
Channel	Type	Value	Channel	Type	Value
01	75 (Battery Level)	62=>98%	03	67 (Temperature)	d5 00=>00 d5=213 Temp=213*0.1 =21.3°C
Channel	Type	Value	Channel	Type	Value
04	68 (Humidity)	7f=>127 Hum=127*	05	00 (PIR Status)	01=>Occupied

0.5=63.5%

PIR trigger packet: report when PIR status changes.

0367d500 04687f 050001
Channel	Type	Value	Channel	Type	Value
03	67 (Temperature)	d5 00=>00 d5=213 Temp=213*0.1= 21.3°C	04	68 (Humidity)	7f=>127 Hum=127*0.5= 63.5%
Channel	Type	Value
05	00 (PIR Status)	01=>Occupied

Temperature alarm packet: report when the temperature reaches the threshold or returns to normal value.

83670e0101 04687a

Channel Type Value Channel Type Value

83

67

(Temperature)
Temperature: 0e 01 =>01 0e = 270
* 0.1 = 27 °C

01= Alarm

04

68

(Humidity)
7a=>122 Hum=122*0.5= 61%

Downlink Commands
WS203 supports downlink commands to configure the device. The application port is 85 by default.

Channel	Type	Description
ff	10 (Reboot)	ff
	2f (LED Indicator)	00: disable; 01: enable
	8e (Reporting Interval)	3 Bytes, Byte 1: 00 Byte 2-3: interval time, unit: min
	95 (Time to report vacancy)	2 Bytes, unit: s
	68 (Data Storage)	00: disable, 01: enable
	69 (Data Retransmission)	00: disable, 01: enable
	6a (Data Retransmission Interval)	3 Bytes Byte 1: 00 Byte 2-3: interval time, unit: s

		range: 30~1200s (600s by default)
	84 (D2D Feature)	1 Byte, 00: disable; 01: enable
	96 (D2D Settings)	8 Bytes, Byte 1: 00- All threshold conditions; 01- Occupancy&Temperature threshold triggered; 02- Occupied; 03-Vacant; 04-Temperature threshold triggered; 05-Temperature threshold is lifted Byte 2: 00-disable, 01-enable Byte 3: 00-disable LoRa Uplink, 01-enable LoRa Uplink Byte 4-5: D2D control command Byte 6-7: control time, unit: min Byte 8: 00-disable control time, 01-enable control time
	06 (Threshold Alarm)	9 Bytes, CTRL(1B)+Min(2B)+Max(2B)+ 00000000(4B) CTRL: Bit0~Bit2: 00- disable 01- below (minimum threshold) 010-above (maximum threshold) 011-within 100-below or above Bit3~Bit7: 11001

Example:

Reboot the device.

ff10ff

Channel Type Value

ff 10 (Reboot) ff (Reserved)

Set the reporting interval as 2 minutes.

ff8e 00 0200

Channel Type Value

ff 8e (Reporting Interval) 02 00=>00 02=>2 mins
Set the time to report vacancy as 2 minutes.

ff957800

Channel Type Value

ff 95 (Time to report vacancy) 78 00=>00 78=>120 s=2 mins
Set LED indicator.

ff2f01

Channel Type Value

ff 2f (LED Indicator) 01=>Enable
Enable the D2D feature.

ff8401

Channel Type Value

ff 84 (D2D Feature) 01=Enable

Set D2D settings.

ff96 01 01 01 04e0 0500 01

Channel

Type

Value

96 (D2D Settings)

01=>Occupied&Temperature threshold triggered;

01=>Enable; 01=>Enable LoRa Uplink;

04 e0=>e0 04, Control Command is e0 04;

05 00=>00 05, Control time is 5 mins; 01=>Enable Control Time

Set threshold alarm.

ff06 cc 9600 2c01 00000000

Channel Type Value

ff

06 (Threshold Alarm)
Ctrl: cc=>11001100
100=below or above Min_value: 96 00=>00 96=15°C Max_value: 2c 01=>01 2c=30°C

Historical Data Enquiry
WS203 supports sending downlink commands to enquire about historical data for specified time points or time ranges. Before that, ensure the device time is correct and the data storage feature is enabled to store the data.

Command format:

Channel	Type	Description
fd	6b (Enquire data in time point)	4 Bytes, Unix timestamp
fd	6c (Enquire data in time range)	Start time (4 bytes) + End time (4 bytes), Unix timestamp
fd	6d (Stop query data report)	ff
ff	6a (Report Interval)	3 Bytes, Byte 1: 01 Byte 2: interval time, unit: s, range: 30~1200s (60s by default)

Reply format:

Channel

Type

Description

6b/6c

1 Byte,

00: data inquiry success

01: time point or time range invalid 02: no data in this time or time range

ce (Historical Data)

9 Bytes,

Data time stamp (4 Bytes) + Trigger Status (1 Byte) + PIR Status (1 Byte) + Temperature (2 Bytes) + Humidity (1 Byte)

Trigger_status:

00 – temperature threshold alarm is released 01 – temperature threshold alarm triggered 02 – PIR vacant trigger

03 – PIR occupied trigger

04 – periodic report

Note:

The device only uploads no more than 300 data records per range inquiry.
When inquiring about the data in time point, it will upload the data that is the closest to the search point within the reporting interval range. For example, if the device’s reporting interval is 10 minutes and users send a command to search for 17:00’s data if the device finds there is data stored in 17:00, it will upload these data. If not, it will search for data between 16:50 to 17:10 and upload the data which is the closest to 17:00.

Example:

Enquire historical data between 2023/8/4 17:00:00 to 2023/8/4 17:15:00.

fd6c10becc6494c1cc64

Channel

Type

Value

6c (Enquire data in time range)

Start time: 10becc64=> 64ccbe10 = 1691139600s = 2023-08-04 17:00:00

End time: 94c1cc64 => 64ccc194 =

1691140500s = 2023-08-04 17:15:00

Reply:

fc6c00
Channel	Type	Value
FC	6c (Enquire data in time range)	00: data inquiry success

20ce 7ac1cc64 04 01 0e01 7b

Channel

Type

Time Stamp

Value

ce (Historical Data)

7ac1cc64 => 64ccc17a => 1691140474s

= 2023-08-04 17:14:34

04=>Periodic report PIR: 01=>Occupied;

Temperature: 0e01=>010e = 27°C

Humidity: 7b => 123 = 61.5%

Contact Information

14 rue Edouard Petit 42000 St-Etienne
Tel: +33 477 92 03 56
Email: contact@rg2i.com
www.rg2i.com.

Documents / Resources

Milesight WS203 Motion and TH Sensor [pdf] User Guide
WS203 Motion and TH Sensor, WS203, Motion and TH Sensor, and TH Sensor, TH Sensor, Sensor

References

User Manual

Milesight WS203 Motion and TH Sensor

Product Usage Instructions

Safety Precautions

Product Introduction

Hardware Introduction

Operation Guide

Installation

Device Payload

Documents / Resources

References

Leave a comment

Cancel reply

ff8e 00 0200
Channel	Type	Value
ff	8e (Reporting Interval)	02 00=>00 02=>2 mins

ff957800
Channel	Type	Value
ff	95 (Time to report vacancy)	78 00=>00 78=>120 s=2 mins