Shelly Wave i4
Note: The product line known as "Shelly Qubino Wave" will now be referred to as "Shelly Wave". This name change will not impact the functionality of any devices. The only modification will be the use of the new name in all future documentation.
Device: Wave i4
- AUS Part number / Ordering Code: QNSN-0A24XAU
- Z-Wave Product type ID: 0x0009
- Z-Wave Product ID: 0x0081
- Z-Wave Manufacturer: Shelly Europe Ltd.
- Z-Wave Manufacturer ID: 0x0460
Terminology
- Device – In this document, the term “Device” refers to the Shelly Qubino device that is the subject of this guide.
- Gateway – 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.
- S button – The Z-Wave® Service button, located on Z-Wave® devices and used for various functions such as adding (inclusion), removing (exclusion), and resetting the device to its factory default settings. The term "S button" is used in this document.
- Adding/Inclusion – The process of adding a Z-Wave device to a Z-Wave network – gateway. Words like included, added, etc., are used in this regard.
- Removing/Exclusion – The process of removing a Z-Wave device from a Z-Wave network – gateway. Words like excluded, removed, etc., are used in this regard.
- 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.
Short Description
The Device is a 4-digital inputs module (110–240 V AC) that controls other devices within the Z-Wave network. It enables manual activation or deactivation of scenes through a switch/push-button.
Switch/Push-Button Connected to Input Terminal SW1
The device supports Central Scene Command Class. When a button is:
- Single pressed → sends scene notification with scene number
0x01 - Double pressed → sends scene notification with scene number
0x01again - Pressed and held → sends "Key held down = 0x02"
- Released → sends "Key released = 0x01"
NOTE: Switch type is not supported for triggering central scene notifications.
Push-Button Connected to SW1
If SW1 is configured as a push-button:
- Scene number:
0x01
Actions:
- Short press: Sends "Key pressed 1 time=0x00" with scene number
0x01. Also sends command to associated devices in Group 4 (see Z-Wave Association). - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down = 0x02" and sends command to associated devices in Group 5.
- Release: Sends "Key released = 0x01" and sends command to associated devices in Group 5.
Switch Connected to SW1
If SW1 is configured as a switch:
- Change switch position once: Sends command to associated devices in Groups 4 and 5.
Switch-Memory Connected to SW1
If SW1 is configured as a switch-memory:
- Switching to Close contact: Sends command to associated devices in Groups 4 and 5 based on current state.
- Switching to Open contact: Sends command to associated devices in Groups 4 and 5 based on current state.
Switch/Push-Button Connected to Input Terminal SW2
If SW2 is configured as a push-button:
- Scene number:
0x02
Actions:
- Short press: Sends "Key pressed 1 time=0x00" with scene number
0x02. Also sends command to devices in Group 6. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down = 0x02" and sends command to devices in Group 7.
- Release: Sends "Key released = 0x01" and sends command to devices in Group 7.
Switch Connected to SW2
If SW2 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 6 and 7.
Switch-Memory Connected to SW2
If SW2 is configured as a switch-memory:
- Switching to Close contact: Sends command to devices in Groups 6 and 7 based on state.
- Switching to Open contact: Sends command to devices in Groups 6 and 7 based on state.
Switch/Push-Button Connected to Input Terminal SW3
If SW3 is configured as a push-button:
- Scene number:
0x03
Actions:
- Short press: Sends "Key pressed 1 time=0x00" with scene number
0x03. Also sends command to devices in Group 8. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down = 0x02" and sends command to devices in Group 9.
- Release: Sends "Key released = 0x01" and sends command to devices in Group 9.
Switch Connected to SW3
If SW3 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 8 and 9.
Switch-Memory Connected to SW3
If SW3 is configured as a switch-memory:
- Switching to Close contact: Sends command to devices in Groups 8 and 9 based on state.
- Switching to Open contact: Sends command to devices in Groups 8 and 9 based on state.
Switch/Push-Button Connected to Input Terminal SW4
If SW4 is configured as a push-button:
- Scene number:
0x04
Actions:
- Short press: Sends "Key pressed 1 time=0x00" with scene number
0x04. Also sends command to devices in Group 10. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down = 0x02" and sends command to devices in Group 11.
- Release: Sends "Key released = 0x01" and sends command to devices in Group 11.
Switch Connected to SW4
If SW4 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 10 and 11.
Switch-Memory Connected to SW4
If SW4 is configured as a switch-memory:
- Switching to Close contact: Sends command to devices in Groups 10 and 11 based on state.
- Switching to Open contact: Sends command to devices in Groups 10 and 11 based on state.
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 Qubino Wave devices are developed on the world's leading technology for smart homes – Z-Wave.
This means Shelly Qubino Wave works with all certified gateways supporting Z-Wave communication protocol.
To ensure full functionality, compatibility tests are regularly performed with different Z-Wave gateways. For detailed compatibility status, refer to the Compatibility with Gateways section.
Simplified Internal Schematics
N/A
Device Electrical Interfaces
Inputs
- 1 switch/button input on screw terminal
- 2 switch/button inputs on screw terminal
- 3 switch/button inputs on screw terminal
- 4 switch/button inputs on screw terminal
- 3 power supply inputs on screw terminals: N, L
Outputs
N/A
Connectivity
Z-Wave – Unsecure, S0 Security, S2 Unauthenticated Security, S2 Authenticated Security
Safety Features
Overheat Protection
- Automatically switches off its own relay
- Sends Notification Report to the Gateway ("Overheat detected")
- LED reacts as specified (check blinking mode for Overheat detected)
Any of the following activities reset this alarm:
- Power cycle
- Short press on S button
- Press any switch/push-button connected to SW (SW1, SW2, etc.)
Note: The Overheat protection is always active and cannot be disabled.
Additional description available under Z-Wave Notifications Command Class.
Supported Load Types
N/A
User Interface
S Button and Operating Modes
- Normal mode
- Setting in progress mode
- Setting mode (with S button)
- Required to start procedures like adding (inclusion), removing (exclusion), factory reset.
- Limited operation time; automatically returns to Normal mode after completion.
- Entering Setting mode:
- Quickly press and hold the S button until the LED turns solid blue.
- An additional quick press changes menu (infinite loop).
- Menu LED status has a 10-second timeout before returning to Normal state.
S Button Functions
- Manually add the device to a Z-Wave network
- Manually remove the device from a Z-Wave network
- Factory reset the device
LED Signalisation
Normal Mode
- Removed/Excluded: LED blinks blue (Mode 1) for 10 minutes after power cycle or S button press.
- Added/Included: LED blinks green (Mode 1) for 10 minutes after power cycle or S button press.
Settings in Progress
- Factory reset and reboot: LED turns solid green (~1 sec), then blue and red blink rapidly (0.1s On / 0.1s Off) for ~2 seconds.
- Adding/Removing: LED blinks blue (Mode 2).
- Firmware updating OTA: LED blinks blue and red (Mode 2).
- Checking power supply (230V AC / 24V DC): LED blinks blue and red (Mode 5).
Settings Mode with S Button
- Menu selected (Add/Remove): LED stays solid blue for up to 10 seconds.
- During Add/Remove process: LED blinks blue (Mode 3).
- Menu selected (Factory Reset): LED stays solid red for up to 10 seconds.
- During Factory Reset process: LED blinks red (Mode 3).
Alarm Mode
- Overheat detected: LED blinks red (Mode 4):
(1x to 6x - 0.2s On / 0.2s Off) + 2s Off, repeating.
LED Blinking Modes
| Mode | Description |
|---|---|
| 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
Error rendering macro 'excerpt-include': User does not have permission to view the page 'DEV:Technical Specifications'.
Basic Wiring Diagram
Error rendering macro 'excerpt-include': User does not have permission to view the page 'DEV:Wiring diagrams'.
Legend
| Terminals | Description | Wires | Description |
|---|---|---|---|
| N | Neutral terminal | N | Neutral wire |
| L | Live terminal (110–240 V AC) | L | Live 110 V AC wire |
| SW 1 | Switch/push-button input terminal | ||
| SW 2 | Switch/push-button input terminal | ||
| SW 3 | Switch/push-button input terminal | ||
| SW 4 | Switch/push-button input terminal |
About Z-Wave
Adding the Device to a Z-Wave® Network (Inclusion)
Note! The blind connected to the device will move 2s up/down if the device is successfully added/removed.
Note! For Security 2 (S2) inclusion, a dialog will appear asking for the 5-digit PIN code printed on the Z-Wave® DSK label on the device and in packaging.
IMPORTANT: The PIN must not be lost.
SmartStart Inclusion
SmartStart-enabled products can be added by scanning the QR code on the device label using a gateway that supports SmartStart.
- Scan the QR code on the device label and add the DSK to the gateway’s provisioning list.
- Connect the device to power.
- Check if the blue LED is blinking slowly — if yes, it’s not yet added.
- Adding starts automatically within seconds of powering on.
- LED blinks faster during addition.
- If successful, the green LED blinks slowly.
Adding with S Button
- Connect device to power.
- Confirm blue LED is blinking slowly.
- Enable add/remove mode on gateway.
- Press and hold S button until LED turns solid blue.
- Release, then press and hold (>2s) until LED blinks slowly — releasing starts Learn mode.
- LED blinks faster during addition.
- Successful addition: green LED blinks slowly.
Note: Setting mode has a 10-second timeout before returning to Normal mode.
Adding with Switch/Push-Button
- Connect device to power.
- Confirm blue LED is blinking slowly.
- Enable add/remove mode on gateway.
- Toggle switch/push-button on any SW terminal 3 times within 3 seconds (3 on/off signals).
- LED blinks faster during addition.
- Successful addition: green LED blinks slowly.
Learn mode: State allowing device to receive network info from the gateway.
Removing the Device from a Z-Wave® Network (Exclusion)
Note: The device will be removed, but custom configurations remain unchanged.
Note: Blind moves 2s up/down upon removal.
Removing with S Button
- Connect device to power.
- Confirm green LED is blinking slowly.
- Enable add/remove mode on gateway.
- Press and hold S button until LED turns solid blue.
- Release, then press and hold (>2s) until LED blinks slowly — releasing starts Learn mode.
- LED blinks faster during removal.
- Successful removal: blue LED blinks slower.
Note: Setting mode has a 10-second timeout.
Removing with Switch/Push-Button
- Connect device to power.
- Confirm green LED is blinking slowly.
- Enable add/remove mode on gateway.
- Toggle switch/push-button on any SW terminal 3 times within 3 seconds.
- LED blinks faster during removal.
- Successful removal: blue LED blinks slower.
Factory Reset
General
After reset, all custom parameters (kWh, associations, routing, etc.) revert to defaults. HOME ID and NODE ID are deleted. Use only when the gateway is missing or inoperable.
With S Button
- Press and hold S button until LED turns solid blue.
- Press S button repeatedly until LED turns solid red.
- Press and hold (>2s) until LED blinks fast — releasing starts reset.
- During reset: LED turns solid green (~1s), then blue and red blink rapidly (~2s).
- Successful reset: blue LED blinks slowly.
With Switch/Push-Button
Only possible within first minute after power-up.
- Connect device to power.
- Toggle switch/push-button on any SW terminal 5 times within 3 seconds.
- During reset: LED turns solid green (~1s), then blue and red blink rapidly (~2s).
- Successful reset: blue LED blinks slowly.
Z-Wave Security and Device Specific Key (DSK)
The device supports Security 2 (S2) via Strong AES 128 Encryption — making Z-Wave® one of the most secure IoT platforms.
- Authenticated Control:
- Out-of-band DSK for inclusion
- Compatible with most implementations
Supports:
- S2 Authenticated
- S2 Unauthenticated
- Unsecure inclusion
Note: When adding via S2-enabled gateway, the DSK PIN is required. The 5-digit PIN is highlighted/underlined on the DSK label (on side of device and in packaging). Do not remove the label.
DSK Label & QR Code (Example): Joining node obfuscates public key by setting bytes 1–2 to zero before RF transfer. DSK may be used for out-of-band authentication.
Z-Wave Parameters
Parameter No. 1 – SW (SW1) Switch Type
- Size: 1 Byte
- Default: 0
- Values:
- 0: Momentary switch (push button)
- 1: Toggle switch (contact closed = ON, open = OFF)
- 2: Toggle switch (device changes status when switch changes)
Parameter No. 2 – SW2 Switch Type
- Same as above.
Parameter No. 3 – SW3 Switch Type
- Same as above.
Parameter No. 4 – SW4 Switch Type
- Same as above.
Parameter No. 105 – LED Signalisation Intensity
- Controls LED brightness (0–100%).
- Size: 1 Byte
- Default: 100
- Values: 0–100 (every 1%)
Available in Wave 1, Wave 1PM, Wave 2PM, Plug US, Plug UK in 2024.
Parameter No. 120 – Factory Reset
- Advanced, may be hidden under "Advanced" tag.
- Size: 1 Byte
- Default: 0
- Values:
- 0: No action
- 1: Factory reset
After reset, value auto-resets to 0.
Parameters 201–203 – Serial Number Parts
- Read-only, cannot be changed.
- Size: 4 Bytes each
- Values: 0x00000000 to 0x7FFFFFFF
Z-Wave Command Classes
Endpoint 1 (Root)
- ASSOCIATION_V2 [S0, S2]
- ASSOCIATION_GRP_INFO_V3 [S0, S2]
- BASIC_V2 [S0, S2]
- SWITCH_BINARY_V2 [S0, S2]
- CENTRAL_SCENE_V3 [S0, S2]
- CONFIGURATION_V4 [S0, S2]
- DEVICE_RESET_LOCALLY_V1 [S0, S2]
- FIRMWARE_UPDATE_MD_V5 [S0, S2]
- INDICATOR_V3 [S0, S2]
- MANUFACTURER_SPECIFIC_V2 [S0, S2]
- MULTI_CHANNEL_V4 [S0, S2]
- MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
- SWITCH_MULTILEVEL_V4 [S0, S2]
- NOTIFICATION_V8 [S0, S2]
- POWERLEVEL_V1 [S0, S2]
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- VERSION_V3 [S0, S2]
- ZWAVEPLUS_INFO_V2
Endpoints 2–5
Each supports:
- ASSOCIATION_V2 [S0, S2]
- ASSOCIATION_GRP_INFO_V3 [S0, S2]
- SWITCH_BINARY_V2 [S0, S2]
- MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
- SECURITY_V1
- SECURITY_2_V1
- SUPERVISION_V1
- ZWAVEPLUS_INFO_V2
Z-Wave Notifications Command Class
Overheat Detected
| Field | Value |
|---|---|
| Comment | Overheat detected |
| Notification Type Name | Heat Alarm |
| Notification Type (Value) | 0x04 |
| Notification Event | State |
| Notification Name | Overheat detected |
| Notification Name (Value) | 0x02 |
| Version | V2 |
| Device Specific | Yes |
| LED Signalisation | Refer to LED table |
| Device Reaction | Switches off outputs, sends notification |
| Restore Action | Power cycle, short press S button, or press any SW terminal |
Z-Wave Associations
Associations enable direct communication between devices without the gateway.
- Max 9 devices per group (recommended ≤5).
- "Lifeline Group" reserved for gateway only (1 node).
Root Device – Association Group 1 (Lifeline)
- Reports device status
- Supports:
- INDICATOR_REPORT (LED status)
- DEVICE_RESET_LOCALLY_NOTIFICATION
- SWITCH_BINARY_REPORT (SW1–SW4)
Group 4 (SW1 – Basic Command)
- Triggered by SW1 (switch or push-button)
- Sends
BASIC_SET ON/OFFto associated devices
Group 5 (SW1 – Multilevel Command)
- Recommended for push-buttons
- Sends
SWITCH_MULTILEVEL_START_LEVEL_CHANGEandSTOP_LEVEL_CHANGE
Groups 6–11 (SW2–SW4)
Same logic as above with respective terminals.
Endpoints 2–5
Each mirrors SW1–SW4 behavior with similar association groups.
Z-Wave Important Disclaimer
Z-Wave® wireless communication may not be 100% reliable. Do not use this device in life-critical or high-value situations. If unrecognized by your gateway, manually change device type and ensure gateway supports Z-Wave Plus™ multi-level devices.
Troubleshooting
For help, visit: https://support.shelly.cloud/
Compatibility with Gateways
| Gateway | D Control 1 | D Control 2 | D Control 3 | D Control 4 | D Binary 1 | D Binary 2 | D Binary 3 | D Binary 4 | Notes |
|---|---|---|---|---|---|---|---|---|---|
| Home Assistant | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Fibaro HC 3 / Z-Wave engine 3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | *H |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ | *1 |
| Smart Things | ✅ | ✅ | ✅ | ✅ | With Shelly Wave edge driver | ||||
| Vera Ezlo | ⚪ | ⚪ | ⚪ | ⚪ | ✅ | ✅ | ✅ | ✅ | *2 |
| Cozify | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Notes:
- *1: Cannot use Central Scene or Associations.
- *2: Missing CC Scene feature.
- *H: Fix reports via this solution
Function Meaning
| Function | Meaning / Tested |
|---|---|
| On/Off | Responds to app UI On/Off command |
| SW On/Off | Reports On/Off changes via SW input |
| Dimming | Responds to app UI dimming command |
| SW Dimming | Reports dimming state via SW input |
| Watts | Reports Watts unsolicited |
| kWh | Reports kWh unsolicited |
| Up/Down | Responds to app UI Up/Down command |
| SW Up/Down | Reports Up/Down via SW input |
| Slats | Responds to app UI slats command |
| SW Slats | Reports slats changes via SW |
| D control | Detects scene commands (single/double press, etc.) |
| D Binary | Reports binary On/Off via SW input |
| Sensor # | Sensor visible in gateway; type noted |
Legend
| Symbol | State |
|---|---|
| ✅ | Working / Possible |
| ⚪ | Not Working / Not Possible |
| P | Partially |
| N/T | Not Tested |
| TBD | To Be Done |
Gateway Guides
Useful guides available in the Shelly Knowledge Base.
Compliance
- Shelly Qubino Wave i4 multilingual EU Declaration of Conformity
- Wave i4 UK PSTI ACT Statement of Compliance