Shelly Wave Door/Window

• 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.

• *Learn mode - a state that allows the Device to receive network information from the gateway.

• 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.

General rulesSwitching 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.During module boot up LED will blink in mode 5 (0,2s On blue/0,2s On red) for 4-5 s.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/ExcludedThe LED will be blinking blue in Mode 1 for 30s after every power cycle and 30s after S button pressed.
Added/IncludedThe 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 / RemovingDuring adding or removing, the LED will be blinking blue in Mode 2.
OTA firmware updatingDuring the OTA update, the LED will be blinking blue and red in Mode 2.

Settings mode with S button

Adding / Removing menu selected (*adding not available for Long Range inclusion)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 (*adding not available for Long Range inclusion)When the menu is executing the LED will be blinking blue in Mode 3.
Factory reset menu selectedWhen 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

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

Adding (inclusion) with the S button (*not available for Long Range inclusion)

1. Single press and check if the blue LED blinks once. If so, the Device is not added to a Z-Wave® network.

2. Enable add/remove mode on the gateway.

3. To enter the Setting mode, press the S button (>0,5s) on the Device until the LED turns solid blue.

4. 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.

5. The blue LED will be blinking in Mode 2 during the adding process.

6. 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.

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

Factory reset

Factory reset generalAfter 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

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).

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.

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 ResetReset 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: 1 ByteDefault value: 0Values & descriptions:0 - No action1 - Factory reset

Parameter No. 201 - Serial Number 1This 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 ByteDefault value: Device specificValues & descriptions:· 0x00000000 - 0x7FFFFFFF
Parameter No. 202 - Serial Number 2This 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 ByteDefault value: Device specificValues & descriptions:· 0x00000000 - 0x7FFFFFFF
Parameter No. 203 - Serial Number 3This 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 ByteDefault value: Device specificValues & descriptions:· 0x00000000 - 0x7FFFFFFF

1. ASSOCIATION_V2 [S0, S2]*

2. ASSOCIATION_GRP_INFO_V3 [S0, S2]*

3. BATTERY_V3 [S0, S2]*

4. CONFIGURATION_V4 [S0, S2]*

5. DEVICE_RESET_LOCALLY_V1 [S0, S2]*

6. FIRMWARE_UPDATE_MD_V5 [S0, S2]*

7. INDICATOR_V3 [S0, S2]*

8. MANUFACTURER_SPECIFIC_V2 [S0, S2]*

9. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]*

10. NOTIFICATION_V8 [S0, S2]*

11. POWERLEVEL_V1 [S0, S2]*

12. SECURITY_V1

13. SECURITY_2_V1

14. SENSOR_MULTILEVEL_V11 [S0, S2]*

15. SUPERVISION_V1

16. TRANSPORT_SERVICE_V2

17. VERSION_V3 [S0, S2]*

18. WAKE_UP_V2 [S0, S2]*

19. ZWAVEPLUS_INFO_V2

Battery Command ClassThe Device use Battery Command Class to manage the reporting of the battery’s power level.With the use of a Battery Get command we can get a report, in percentage, of the battery’s power level. These values are from 0x00 to 0x64 in hexadecimal or in decimal, from 0 to 100.Low-Battery warningWhen the battery level is close to 0, the device will send an unsolicited / automatic report to the controller with a value 0xFF representing a low-battery warning.

Door/Window is open

• Alarm type - 0x00

• Alarm level - 0x00

• Reserved - 0x00

• Notification Status - 0xFF

• Event - 0x16 (Door/Window is open)

• Properties - 0x01

• Event Parameters - 0x00 (Door/Window is NOT tilt and turn position)

Door/Window is tilt and turn open

• Alarm type - 0x00

• Alarm level - 0x00

• Reserved - 0x00

• Notification Status - 0xFF

• Event - 0x16 (Door/Window is open)

• Properties - 0x01

• Event Parameters - 0x01 (Door/Window is in tilt and turn position)

Door/Window is closed

• Alarm type - 0x00

• Alarm level - 0x00

• Reserved - 0x00

• Notification Status - 0xFF

• Event - 0x17 (Door / Window is closed)

• Properties - 0x01

• Event Parameters - 0x00

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.
Max. number of associated devices per group is 9. This value is fixed and cannot be configured.
Each association group supports the association of up to 9 devices (nodes). To avoid network delays, we recommend limiting the number of associated devices to no more than 5 per group. "Lifeline group" is reserved for controlling devices, such as Gateways and remote controllers, or devices who can interpret the reports sent.Association group 1 – "Lifeline group" sends to the controlling device it's command class notifications and or command class reports when said command classes are triggered. Max. 9 nodes are allowed:

Root device
Root device - Association Group 1 - Lifeline

1. INDICATOR_REPORT : LED status

2. DEVICE_RESET_LOCALLY_NOTIFICATION : triggered upon request

3. BATTERY_REPORT : This command MUST be issued periodically to report the current battery level. The frequency is up to the implementation

4. BATTERY_REPORT : "This command MUST be issued by a node when its battery becomes low and the end user needs to reload or replace the battery. The Battery Level field MUST be set to 0xFF to indicate a low battery warning."

5. SENSOR_MULTILEVEL_REPORT : angle

6. SENSOR_MULTILEVEL_REPORT : Illumination

7. NOTIFICATION_REPORT : Triggered when Reed Switch is opened or closed

Root device - Association Group 2 (*not available for Long Range inclusion)

Association Group 2
Allowed nodes: 9
It is assigned to Reed Switch (uses Basic command class).
Triggered by Reed Switch. Supports the following command classes:

1. BASIC_SET : set On / Off state to associated devices

Wave Door-Window multilingual EU declaration of conformity 61 2024-11-20.pdf