Shelly Wave 1

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

Switch/push-button connected to input terminal SW (SW1)

If the SW (SW1) is configured as a switch (default), each toggle of the switch will change the output O (O1) state to the opposite state - on, off, on, etc. If the SW (SW1) is configured as a push-button in the Device settings, each press of the push-button will change the output O (O1) state to the opposite state - on, off, on, etc.

Switch connected to input terminal SW (SW1)

If the SW (SW1) is configured as a switch (default), each toggle of the switch will change the output O (O1) state to the opposite state - on, off, on, etc.

• Change switch position once: Change the state of the output O (O1) state to the opposite state and send the command to the associated devices in associated groups 2 and 3 (check chapter Z-Wave Association).

Switch-memory connected to input terminal SW (SW1)

If the SW (SW1) is configured as a switch-memory, than:

• Switching to Close switch-memory contact: Change the state of the output state O (O1) to the On state and send command to the associated devices in associated groups 2 and 3 (check chapter Z-Wave Association)

• Switching to Open switch-memory contact: Change the state of the output state O (O1) to the Off state and send command to the associated devices in associated groups 2 and 3 (check chapter Z-Wave Association)

Push-button connected to input terminal SW (SW1)

If the SW (SW1) is configured as a push-button in the Device settings, each press of the push-button changes the output state O (O1) to opposite - ON, OFF, ON, etc.

• Single press: Change the state of the output state O (O1) to the opposite one and send command to the associated devices in associated groups 2 and 3 (check chapter Z-Wave Association)

• Double press: If the delay between first in second press is less then 500ms, this is interpreted as double press. Send command to the associated devices (dimmers, shutters,….) in associated groups 2 and 3 (check chapter Z-Wave Association)

• Press and hold: Send command to the associated devices in associated group 3 (check chapter Z-Wave Association)

• Release: Send command to the associated devices in associated group 3 (check chapter Z-Wave Association)

Switching On/Off load connected to O (O1)

Load connected to O (O1) is possible to switch On/Off by:

• by Z-Wave command

• Automatically switching can be enabled by proper Parameters No. 19 and 20 settings.

• pressing the switch/push-button SW (SW1): Change the state of the connected load to the opposite one

• pressing the S button: Change the state of the connected load to the opposite one

Overheat Protection

Device has internal Overheat protection. If the temperature exceeds predefined values 80°C for more than 5s, the Device will:

• switch off its own output

• send the Notification Report to the gateway (Overheat detected)

• the LED lights react as specified above (check LED blinking mode for Overheat detected)

NOTE: The Overheat protection is always active and cannot be disabled.

Additional description above under chapter Notification for Overheat detected.

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 (this is not valid for Plugs). Once in settings mode, switch to normal mode goes automatically after 10s.

• If the LED is not in Alarm mode, it will turn off after a timeout of 30min. Pressing the S button or power cycling the Device will wake the LED for 30min.

• 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/Excluded

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

Added/Included

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

Factory reset and reboot

During factory reset, the LED will turn solid green for approx. 1sec, then the blue and red LED will be blinking 0,1s On / 0,1s Off for about 2sec.

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.

Checking AC or DC voltage power supply

During checking the power supply, the LED will be blinking blue and red in Mode 5.

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

Overheat detected

The LED will be blinking red in Mode 4

The Z-Wave® protocol is an interoperable, wireless, RF-based communications technology designed specifically for control, monitoring, and status reading applications in residential and light commercial environments. Mature, proven, and broadly deployed, Z-Wave® is by far the world market leader in wireless control, bringing affordable, reliable, and easy-to-use 'smart' products to millions of people in every aspect of daily life.

Interoperability has always been at the core of the Z-Wave® protocol, alongside the features like backward compatibility, security, and reliability. All Z-Wave® devices can be operated in any Z-Wave® network with other Z-Wave® certified devices, regardless of brand or manufacturer. All mains operated nodes within the network will act as repeaters regardless of vendor to increase the reliability of the network. There are 4000+ Z-Wave® certified products that are backwards- and forwards-compatible in the Z-Wave® ecosystem and well over 100 million devices currently in the market.

With over 20 years in the marketplace, Z-Wave® technology has best-in-class security measures to keep your home network smarter and safer.

Source: www.z-wavealliance.org, http://www.z-wave.com

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 within 10 minutes of being switched on in the network vicinity.

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

2. Connect the Device to a power supply.

3. Check if the blue LED is blinking in Mode 1. If so, the Device is not added to a Z-Wave® network.

4. Adding will be initiated automatically within a few seconds after connecting the Device to a power supply, and the Device will be added to a Z-Wave® network automatically.

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

6. 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 (*not available for Long Range inclusion)

1. Connect the Device to a power supply.

2. Check if the blue LED is blinking in Mode 1. If so, the Device is not added to a Z-Wave® network.

3. Enable add/remove mode on the gateway.

4. To enter the Setting mode, press and hold the S button on the Device until the LED turns solid blue.

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

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

7. The green LED will be blinking in Mode 1 if the Device is successfully added to a Z-Wave® network.

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

Adding (inclusion) with a switch/push-button (*not available for Long Range inclusion)

1. Connect the Device to a power supply.

2. Check if the blue LED is blinking in Mode 1. If so, the Device is not added to a Z-Wave® network.

3. Enable add/remove mode on the gateway.

4. Toggle the switch/push-button connected to any of the SW terminals (SW, SW1, SW2, etc.) 3 times within 3 seconds (this procedure puts the Device in Learn mode*). The Device must receive on/off signal 3 times, which means pressing the momentary switch 3 times, or toggling the switch on and off 3 times.

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

6. The green LED will be blinking in Mode 1 if the Device is successfully added to a Z-Wave® network.

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

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

1. Connect the Device to a power supply.

2. Check if the green LED is blinking in Mode 1. If so, the Device is added to a Z-Wave® network.

3. Enable add/remove mode on the gateway.

4. To enter the Setting mode, press and hold the S button on the Device until the LED turns solid blue.

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

6. The blue LED will be blinking in Mode 2 during the removing process.

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

Removing (exclusion) with a switch/push-button

1. Connect the Device to a power supply.

2. Check if the green LED is blinking in Mode 1. If so, the Device is added to a Z-Wave® network.

3. Enable add/remove mode on the gateway.

4. Toggle the switch/push-button connected to any of the SW terminals (SW, SW1, SW2,…) 3 times within 3 seconds (this procedure puts the Device in Learn mode). The Device must receive on/off signal 3 times, which means pressing the momentary switch 3 times, or toggling the switch on and off 3 times.

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

6. The blue LED will be blinking in Mode 1 if the Device is successfully removed from a Z-Wave® network.

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.

1. To enter the Setting mode, press and hold the S button on the Device until the LED turns solid blue.

2. Press the S button multiple times until the LED turns solid red.

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

4. During factory reset, the LED will turn solid green for about 1s, then the blue and red LED will start blinking in Mode 3 for approx. 2s.

5. The blue LED will be blinking in Mode 1 if the Factory reset is successful.

Factory reset with a switch/push-button

Note! Factory reset with a switch/push-button is only possible within the first minute after the Device is connected to a power supply.

1. Connect the Device to a power supply.

2. Toggle the switch/push-button connected to any of the SW terminals (SW, SW1, SW2,…) 5 times within 3 seconds. The Device must receive on/off signal 5 times, which means pressing the push-button 5 times, or toggling the switch on and off 5 times.

3. During factory reset, the LED will turn solid green for about 1s, then the blue and red LED will start blinking in Mode 3 for approx. 2s.

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

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.

Parameter No. 1 - SW (SW1) Switch type

This parameter defines how the Device should treat the switch (which type) connected to the SW (SW1) terminal.

Value size: 1 Byte

Default value: 2

Values & descriptions:

• 0 - momentary switch (push button),

• 1 - toggle switch (contact closed - ON / contact opened - OFF),

• 2 - toggle switch (Device changes status when switch changes status)

Parameter No. 17 - Restore the O (O1) state after a power failure

This parameter determines if the on/off status is saved and restored for the load connected to O (O1) after a power failure.

Values size: 1 Byte

Default value: 0

Values & descriptions:

• 0 - Device saves last on/off status and restores it after a power failure

• 1 - Device does not save on/off status and does not restore it after a power failure, it remains off

Parameter No. 19 - O (O1) Auto OFF with timer

If the load O (O1) is ON, you can schedule it to turn OFF automatically after the period of time defined in this parameter. The timer resets to zero each time the Device receives an ON command, either remotely (from the gateway or associated device) or locally from the switch.

Values size: 2 Byte

Default value: 0

Values & their descriptions:

• 0 - Auto OFF Disabled

• 1 - 32535 = 1 - 32535 seconds or milliseconds – see Parameter no. 25. Set timer units to s or ms for O (O1) resolution 100ms

Parameter No. 20 - O (O1) Auto ON with timer

If the load O (O1) is OFF, you can schedule it to turn ON automatically after the period of time defined in this parameter. The timer resets to zero each time the Device receives an OFF command, either remotely (from the gateway or associated device) or locally from the switch.

Values size: 2 Byte

Default value: 0

Values & their descriptions:

• 0 - Auto ON Disabled

• 1 - 32535 = 1 - 32535 seconds or milliseconds – see Parameter no. 25. Set timer units to s or ms for O (O1) resolution 100ms

Parameter No. 23 - O (O1) contact type - NO/NC

The set value determines the relay contact type for output O (O1). The relay contact type can be normally open (NO) or normally closed (NC).

Values size: 1 Byte

Default value: 0

Values & descriptions:

• 0 - NO

• 1 - NC

Relay logic:

Parameter No. 25 - Set timer units to s or ms for O (O1)

Set the timer units to seconds or milliseconds. Choose if you want to set the timer in seconds or milliseconds in Parameters No. 19, 20.

Values size: 1 Byte

Default value: 0

Values & descriptions:

• 0 – timer set in seconds

• 1 – timer set in milliseconds

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. 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 Advanced tag.

Values size: 4 Byte

Default value: Device specific

Values & descriptions:

· 0x00000000 - 0x7FFFFFFF

1. ASSOCIATION_V2 [S0, S2]*

2. ASSOCIATION_GRP_INFO_V3 [S0, S2]*

3. BASIC_V2 [S0, S2]*

4. SWITCH_BINARY_V2 [S0, S2]*

5. CONFIGURATION_V4 [S0, S2]*

6. DEVICE_RESET_LOCALLY_V1 [S0, S2]*

7. FIRMWARE_UPDATE_MD_V5 [S0, S2]*

8. INDICATOR_V3 [S0, S2]*

9. MANUFACTURER_SPECIFIC_V2 [S0, S2]*

10. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]*

11. NOTIFICATION_V8 [S0, S2]*

12. POWERLEVEL_V1 [S0, S2]*

13. SECURITY_V1

14. SECURITY_2_V1

15. SUPERVISION_V1

16. TRANSPORT_SERVICE_V2

17. VERSION_V3 [S0, S2]*

18. ZWAVEPLUS_INFO_V2

[S2]* Security S2 Command Class

NOTE: MAPPING OF COMMAND_CLASS_BASIC

Supporting Command Class Basic

COMMAND_CLASS_BASIC is mapped into COMMAND_CLASS_SWITCH_BINARY, for enabling Switch (O) control:

Switch (O) will be turned ON or OFF, after receiving the BASIC_SET command:

Supporting Command Class Indicator

The Device supports the Command Class Indicator V3 (ID 0x50). When the Device receives an indicator set, the LED blinks according to the received indicator set.

Refer to LED Signalization chapter.

Overheat detected

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. SWITCH_BINARY_REPORT : status change report for output O (O1)

4. NOTIFICATION_REPORT : triggered on Overheat

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

Association Group 2
Allowed nodes: 9
It is assigned to switch connected to the SW (SW1) terminal (uses Basic command class).
Triggered by SW (SW1). The device sends according to the state of SW (SW1) (switch or push-button) the command BASIC_SET ON or BASIC_SET OFF to the associated device. This command is reflected to the output of associated device. Supports the following command classes:

• BASIC_SET : set On / Off state at the associated device

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

Association Group 3
Allowed nodes: 9
It is assigned to switch connected to the SW (SW1) terminal (uses Switch Multilevel command class). Triggered by SW (SW1).

It is recommended to use push buttons for this association. Supports the following command classes:

• SWITCH_MULTILEVEL_START_LEVEL_CHANGE : initiate a transition to a new level (increase or decrease light intensity in case of dimmer, or move shutter up or down, …)

• SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE : stop an ongoing transition (stop increase or decrease light intensity in case of dimmer, or stop moving shutter up or down, …)