Shelly Wave Door/Window

Device identification

Device: Shelly Wave Door/Window (EU)
EU Part number/Ordering Code: QNDW-002CEU
Z-Wave Product type ID: 0x0100
Z-Wave Product ID: 0x0081
Z-Wave Manufacturer: Shelly Europe
Z-Wave Manufacturer ID: 0x0460

Terminology

Click here to unhide/hide

OTA - Over-The-Air firmware update.
FW - Firmware
ZAF - Z-Wave® protocol
NIF - Node Information Frame; the frame that is sent at every adding (inclusion) to present/advertise the Device’s capability to the gateway, so that it may adjust its operating ability.
CC - Command Class (ZAF centerpiece of interoperability). The files/processes that determine how data is sent and handled/received. Command Classes include their signatures while sending data to allow recognition of which process is sending data for the destination device.
Switch - A toggle switch or a bi-stable switch.
Push-button - A momentary switch or a monostable switch.
Switch/push-button - It can be a switch or a push-button.
Double press - If the delay between the first and the second press on the switch/push-button is less than 500 ms, this is interpreted as a double press.
Gateway (GW) - A Z-Wave® gateway, also referred to as a Z-Wave® controller, Z-Wave® main controller, Z-Wave® primary controller, or Z-Wave® hub, etc., is a device that serves as a central hub for a Z-Wave® smart home network. The term “gateway” is used in this document.
Mesh network - devices can communicate with each other in addition to the gateway. Devices (only mains powered) can act as repeaters to extend network.
Long range network - devices can communicate only with gateway (no repeater function).
S button - The Z-Wave® Service button, located on Z-Wave® devices and is used for various functions such as adding (inclusion), removing (exclusion), resetting the device to its factory default settings and to switch power output on/off (valid only for Wave Plugs). The term "S button" is used in this document.
Device - In this document, the term “Device” is used to refer to the Shelly Wave device that is a subject of this guide.
End device - Z-Wave end devices are nodes in a Z-Wave network that are not gateways, such as switches, door locks, sensors, etc.
Node ID - The Z-Wave Node ID is a unique identifier assigned at the adding (inclusion) to each device in a Z-Wave network, allowing the network to identify and communicate with this device.
HOME ID - The Z-Wave Home ID is a unique identifier assigned to each Z-Wave network and each device in that network. It distinguishes your Z-Wave network from other networks and ensures that your Z-Wave devices only communicate with devices in your own network.
Adding/Inclusion - The process of adding Z-Wave device to a Z-Wave network - gateway. The words included, added, etc. are used in this regard.
Removing/Exclusion - The process of removing Z-Wave device from a Z-Wave network - gateway. The words excluded, removed, etc. are used in this regard.
Factory reset - After Factory reset, all custom parameters and stored values (kWh, associations, routings, etc.) will return to their default state. The HOME ID and NODE ID assigned to the Device will be deleted. Use this reset procedure only when the gateway is missing or otherwise inoperable.
Normal mode - Is the state of the device which refers to the operational state of a device when it is functioning under regular conditions (switching on/off, dimming, etc.) either during active usage or while in standby mode but still powered.
SmartStart - SmartStart enabled devices can be added (included) to a Z-Wave network by scanning the Z-Wave QR code on the device with a Gateway that supports SmartStart inclusion. The SmartStart enabled device will be automatically added within 10 minutes of being switched on in the vicinity of the Z-Wave network.
MUST - MUST be implemented
OPTIONAL - implement it if time/budget allows
Associations - Associations are used for direct communication between the Device and other devices within your Z-Wave network without the need of the Z-Wave gateway.
Power cycle - Reboot the Device/power supply On/Off of the Device
Blind - Refers to any kind of window treatment, such as venetian blinds, roller blinds (screens), roller shutters, vertical window blinds, curtains, integral venetian blinds, pleated blinds, awnings, etc. Additionally, Wave Shutter can also control window motors, projector screens, or any type of bi-directional AC motor.
Power consumption (W) - refers to the rate at which energy is consumed or used by an electrical device or system. It is measured in watts (W).
Energy consumption (kWh) - refers to the total amount of electrical energy consumed by a device or system over a specific period of time. It is measured in kilowatt-hours (kWh).
Ordering code - The ordering code is the same as the Part number (PN). Where there is not enough space to write the Ordering code, abbreviation PN is used. The PN is written on the DSK label on each device.

Short description

The Device is a Z-Wave® sensor designed to detect the opening and closing of doors or windows. Beyond simple detection, it can also measure the angle of inclination for doors or windows that tilt or turn. Additionally, the sensor is equipped with a built-in light sensor, offering enhanced functionality for smart home automation.

Basic Functions

Click here to unhide/hide

Door/window opening and closing detection

If a conventional door or window is opened or closed, the Device will by default immediately broadcast information about (open/close) event, the illumination and battery status (if changed).

Door/window inclination angle measurement

If a door or window, which tilts and turns is opened, the Device will immediately broadcast information about the event, the illumination, and the battery status at the time of the opening detection and 2 seconds later will broadcast information containing the inclination angle (if enabled by parameters 155) and the battery status at the moment. If the door or the window is closed the Device will broadcast information about the event, the inclination angle (zero), the illumination, and the battery status at the time of the closing detection.

Illumination measurement

Whenever Device is triggered or wakes up, it will broadcast information about the illumination (if enabled by parameters 155).

OTA - Over-The-Air firmware update

OTA stands for Over-The-Air, and it refers to the wireless firmware update to end devices

Z-Wave Security communication protocols supported

Unsecure, S0 Security, S2 Unauthenticated Security, S2 Authenticated Security

Main applications

Residential
MDU (Multi Dwelling Units - apartments, condominiums, hotels, etc.)
Light commercial (small office buildings, small retail/restaurant/gas station, etc.)
Government/municipal
University college

Integrations

Shelly Wave devices are developed on the world's leading technology for smart homes – Z-Wave.

This means Shelly Wave works with all certified gateways supporting Z-Wave communication protocol.

To make sure the functions of Shelly Wave products are supported on your gateway, we are regularly executing compatibility tests of our devices with different Z-Wave gateways.

Connectivity

Z-Wave - Unsecure, S0 Security, S2 Unauthenticated Security, S2 Authenticated Security

User interface

S button and operating modes

Single press (<0,5s):

Device wake up
Device not included, Blue led blink once
Device included, Green led blink once if GW respond with "Wake Up No More Information"
Device included, Green led blinks for 10s if GW doesn’t respond with "Wake Up No More Information"

Settings mode:

Is required to start the desired procedure, for example: adding (inclusion), removing (exclusion), factory reset, etc. It has a limited operating time. After completing the procedure in Setting mode, the Device automatically switches to Normal mode.

Entering Setting mode:

Press the S button (>0,5s)
Device NOT included: LED is solid blue.
Device included: LED is solid green for 0,5s then blue
An additional quick press on the S button changes the menu in an infinite loop.
The Settings mode has a timeout of 10s before entering again into Normal mode.

S button’s functions

Manually adding the Device to a Z-Wave network
Manually removing the Device from a Z-Wave network
Factory Reset the Device
Wake-up

LED Signalisation

Click here to unhide/hide

General rules

Switching between Normal and Settings mode is done by press and hold the S button.
Solid LED means that you are in the Settings mode. Once in settings mode, switch to normal mode goes automatically after 10s.
Press on the S button wake up LED for 1s, and device power cycle wakes up LED for 10s.

Normal mode LED status: Normal mode is defined by stable device function that can remain for an infinite time.

LED type: RGB dimmable
Normal mode

Removed/Excluded

The LED will be blinking blue in Mode 1 for 30s after every power cycle and 30s after S button pressed.

Added/Included

The LED will be blinking green in Mode 1 for 10sec after every power cycle and 1sec after S button pressed.

Settings in progress

Factory reset and reboot

During factory reset, the LED will turn solid green for approx. 500ms, then the blue LED will be blinking in Mode 1.

Adding / Removing

During adding or removing, the LED will be blinking blue in Mode 2.

OTA firmware updating

During the OTA update, the LED will be blinking blue and red in Mode 2.

Settings mode with S button

Adding / Removing menu selected

When the menu is selected the LED will be on blue, for maximum of 10 seconds.

Adding / Removing menu - while pressing S- button - Add/Remove process selected

When the menu is executing the LED will be blinking blue in Mode 3.

Factory reset menu selected

When the menu is selected the LED will be on red, for maximum of 10 seconds.

Factory reset - while pressing S - button - Factory reset process selected

When the menu is executing the LED will be blinking red in Mode 3.

Alarm Mode

NA

LED blinking modes

Click here to unhide/hide

LED blinking modes
Mode 1	0,5s On/2s Off
Mode 2	0,5s On/0,5s Off
Mode 3	0,1s On/0,1s Off
Mode 4	(1x to 6x - 0,2s On/0,2s Off) + 2s Off
Mode 5	0,2s On blue/0,2s On red

Specifications

Power supply	1x 3 V CR2032 battery (included)
Battery life	Up to 2 years
Reed switch	Yes
G-sensor	Yes
Light sensor	Yes
Distance	Up to 40 m indoors (131 ft.) (depends on local condition)
Z-Wave® repeater	No
CPU	Z-Wave® S800
Z-Wave® frequency bands	868.4 MHz
Maximum radio frequency power transmitted in frequency band(s)	< 25 mW
Size (H x W x D)	35x35x7 mm ±0.5 mm / 1.38х1.38х0.27 in ±0.02 in (Sensor unit) 35x12x7 ±0.5 mm / 1.44х0.47х0.27 in ±0.02 in (Magnet)
Weight	10 g ±1 g / 0.35 ±0.05 oz (Device with the battery) 8 g ±1 g / 0.28 ±0.05 oz (Magnet)
Shell material	Plastic
Color	White, black, brown
Ambient temperature	-20°C to 40°C / -5°F to 105°F
Humidity	30% to 70% RH
Max. altitude	N/A

Wave Door/Window description

Legend

A: Light sensor

B: Control button

C: Magnet

D: Sensor unit

E: LED indication

F: Battery protective foil

Screenshot 2024-10-08 143233-20241008-123356.png — Fig.2

First steps

The Device comes ready to use with the battery installed. Before usage of the Device, remove the protective foil from the battery compartment to activate the battery. However, if pressing its button does not make the Device start emitting signals, you might need to insert a battery. See the Replacing the battery section.

Mounting

You can place the magnet left, right, above, or below the sensor unit. If you want to monitor a door or window that tilts and turns, mount the sensor unit (D) on the door or the window (G) and the magnet (C) on the frame (H) as shown in Fig. 3. Use the supplied double-sided foam stickers to affix the sensor unit and the magnet to the door or the window and the frame. Depending on the door or window frame, you may need to align the magnet and sensor unit by raising one of them using shims (I). If you want to monitor a conventional door or window, we suggest, if possible, mounting the sensor unit on the frame and the magnet on the door or the window.

Replacing the battery

Open the back cover as shown in Fig. 4.
Extract the exhausted battery by first pushing it through the battery holder cutout and then pulling it out as shown in Fig. 5.
Slide in a new battery as shown in Fig. 6
Replace the back cover by pressing it to the sensor unit at the four angles until you hear a clicking sound as shown in Fig. 7.

About Z-Wave®

Adding and removing the Device to a Z-Wave® network

Click here to unhide/hide

Adding the Device to a Z-Wave® network (inclusion)

Note! In case of Security 2 (S2) adding (inclusion), a dialog will appear asking you to enter the corresponding PIN Code (5 underlined digits) that are written on the Z-Wave® DSK label on the side of the Device and on the Z-Wave® DSK label inserted in the packaging.
IMPORTANT: The PIN Code must not be lost.

SmartStart adding (inclusion)

SmartStart enabled products can be added into a Z-Wave® network by scanning the Z-Wave® QR Code present on the Device with a gateway providing SmartStart inclusion. No further action is required, and the SmartStart device will be added automatically once the battery device wakes up in the network vicinity.

With the gateway application scan the QR code on the Device label and add the Security 2 (S2) Device Specific Key (DSK) to the provisioning list in the gateway.
Wake up the device
Check if the blue LED is blinks once. If so, the Device is not added to a Z-Wave® network.
Adding will be initiated automatically within a few seconds after device wake’s up and the Device will be added to a Z-Wave® network automatically.
The blue LED will be blinking in Mode 2 during the adding process.
The green LED will be blinking in Mode 1 if the Device is successfully added to a Z-Wave® network.

Adding (inclusion) with the S button

Single press and check if the blue LED blinks once. If so, the Device is not added to a Z-Wave® network.
Enable add/remove mode on the gateway.
To enter the Setting mode, press the S button (>0,5s) on the Device until the LED turns solid blue.
Release and then press and hold (> 2s) the S button on the Device until the blue LED starts blinking in Mode 3. Releasing the S button will start the Learn mode.
The blue LED will be blinking in Mode 2 during the adding process.
Once the device has been successfully added into a Z-Wave® network, the LED will remain off. To confirm the inclusion of the device, press the S-button again; the green LED will blink once as a signal of successful inclusion.

Note! In Setting mode, the Device has a timeout of 10s before entering again into Normal mode.

Removing the Device from a Z-Wave® network (exclusion)

Note! The Device will be removed from your Z-Wave® network, but any custom configuration parameters will not be erased.

Removing (exclusion) with the S button

Single press and check if the green LED blinks once. If so, the Device is added to a Z-Wave® network.
Enable add/remove mode on the gateway.
To enter the Setting mode, press the S button (>0,5s) on the Device until the LED turns solid blue.
Release and then press and hold (> 2s) the S button on the Device until the blue LED starts blinking in Mode 3. Releasing the S button will start the Learn mode.
The blue LED will be blinking in Mode 2 during the removing process.
The blue LED will be blinking in Mode 1 if the Device is successfully removed from a Z-Wave® network.

Note! In Setting mode, the Device has a timeout of 10s before entering again into Normal mode.

Factory reset

Factory reset general

After Factory reset, all custom parameters and stored values (kWh, associations, routings, etc.) will return to their default state. HOME ID and NODE ID assigned to the Device will be deleted. Use this reset procedure only when the gateway is missing or otherwise inoperable.

Factory reset with the S button

Note! Factory reset with the S button is possible anytime.

To enter the Setting mode, press the S button (>0,5s) on the Device until the LED turns solid blue.
Press the S button multiple times until the LED turns solid red.
Press and hold (> 2s) S button on the Device until the red LED starts blinking in Mode 3. Releasing the S button will start the factory reset.
During factory reset, the LED will turn solid green for about 1s.
The blue LED will be blinking in Mode 1 if the Factory reset is successful.

Remote factory reset with parameter with a gateway

Factory reset can be done remotely with the settings in Parameter No. 120.

Z-Wave® Security and Device Specific Key (DSK)

Click here to unhide/hide

Z-Wave® Security 2 and Device Specific Key (DSK)

The Device supports the latest Security 2 (S2) feature. S2 is handled by the strong AES 128 Encryption protocol, which means that the S2 makes Z-Wave® the most secure IoT (Internet of Things) security platform out there. To fully utilize the product and its Security 2 feature, a Security 2-enabled Z-Wave® gateway must be used.

Authenticated Control

Out-Of-Band DSK for adding (inclusion)
May be used by most implementations

The Device also supports Security 2 Authenticated, Unauthenticated, and Unsecure adding (inclusion).

Note! When adding the Device to a Z-Wave® network with a gateway supporting Security 2 (S2), the PIN Code of the Z-Wave® Device Specific Key (DSK) is required. You can find it on the label on the side of the Device and a copy is inserted in the packaging, which must not be lost. Do not remove the Z-Wave® DSK label from the Device. As a backup measure, use the label in the packaging.

The first five digits of the key are highlighted or underlined to help the user identify the PIN Code part of the DSK text. The DSK is additionally represented with a QR Code as shown on the image.

Z-Wave® DSK label and QR code (example)

A joining node requesting to join the S2 Access Control Class or the S2 Authenticated Class will obfuscate its Public Key by setting the bytes 1..2 to zeros (0x00) before transferring its key via RF.

The DSK may be used for out-of-band (OOB) authentication.

The including gateway may use a QR code scanning device to read the entire DSK of the joining device and match it with the obfuscated public key received via RF from the joining device.

ⓘ NOTE: This Device must be used in conjunction with a Security Enabled Z-Wave® gateway to fully utilize all implemented functions.

ⓘ NOTE: This Device is a security enabled Z-Wave Plus® product that can use encrypted Z-Wave Plus® messages to communicate to other security enabled Z-Wave Plus® products.

ⓘ NOTE: DSK access via UI gateways, which implement the S2 and SmartStart security feature, display an input dialog box, with a full or partial DSK key. Most of them display a partial DSK (they do not show the PIN code) when the Device is added with the S2-Authenticated security scheme. When added with the S2-Unauthenticated, some gateways show the complete DSK while others perform the complete adding (inclusion) process without prompting the user with the dialogue.

Z-Wave® Parameters

Click here to unhide/hide

Parameter No. 117 - Remote Device reboot

This parameter enable restarting or rebooting the Device without physical intervention. Use this parameter only for troubleshooting scope. After device reboot the parameter value will be set to default.

Values size: 1 Byte

Default value: 0

Values & descriptions:

0 - function inactive
1 - Remote device reboot

Parameter No. 120 - Factory Reset

Reset to factory default settings and removed from the Z-Wave network.

The parameter is Advanced and may be hidden under the Advanced tag.

Values size: 4 Byte

Default value: 0

Values & descriptions:

0 - No action
1 - Factory reset

After reset is performed, the parameter value is automatically set to 0.

Parameter No. 155 - Illumination measurement

This parameter enables the ambient illumination measurement by the sensor.

Value size: 1 Byte

Default value: 0

Values & descriptions:

0 - illumination measurement disabled
1 - illumination measurement enabled

NOTE: The battery life may be significantly reduced when illumination measurement is enabled!

Parameter No. 156 - Tilting measurement

This parameter enables the tilting measurement by the sensor.

Value size: 1 Byte

Default value: 0

Values & descriptions:

0 - Tilting measurement disabled
1 - Tilting measurement enabled

NOTE: The battery life may be significantly reduced when illumination measurement is enabled!

Parameter No. 157 - Enable/Disable LED indicator

This parameter enables/disables visualisation of LED indicator.

Value size: 1 Byte

Default value: 0

Values & descriptions:

0 - LED indicator disabled
1 - LED indicator enabled (The LED flashes with each state change)

NOTE: The battery life may be significantly reduced when illumination measurement is enabled!

NOTE: This parameter only affects LED indication when device is woken up by reed switch, motion sensor etc…. If S-button is pressed LED should light normally.

Parameter No. 201 - Serial Number 1

This parameter contains a part of device’s serial number.

The parameter is Read-Only and cannot be changed.
The parameter is Advanced and may be hidden under the Advanced tag.

Values size: 4 Byte

Default value: Device specific

Values & descriptions:

· 0x00000000 - 0x7FFFFFFF

Parameter No. 202 - Serial Number 2

This parameter contains a part of device’s serial number.

The parameter is Read-Only and cannot be changed.
The parameter is Advanced and may be hidden under the Advanced tag.

Values size: 4 Byte

Default value: Device specific

Values & descriptions:

· 0x00000000 - 0x7FFFFFFF

Parameter No. 203 - Serial Number 3

This parameter contains a part of device’s serial number.

The parameter is Read-Only and cannot be changed.
The parameter is Advanced and may be hidden under the Ad