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
- US Part number / Ordering Code: QNSN-0A24XUS
- 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 called a Z-Wave® controller, Z-Wave® main controller, Z-Wave® primary controller, or Z-Wave® hub, etc., is a central hub for a Z-Wave® smart home network. The term “gateway” is used here.
- S button – The Z-Wave® Service button, located on Z-Wave® devices, used for functions like adding (inclusion), removing (exclusion), and resetting to factory defaults. The term "S button" is used throughout.
- Adding/Inclusion – The process of adding a Z-Wave device to a Z-Wave network (gateway). Words such as included, added, etc., are used interchangeably.
- Removing/Exclusion – The process of removing a Z-Wave device from a Z-Wave network (gateway). Words such as excluded, removed, etc., are used interchangeably.
- Blind – Refers to any window treatment including venetian blinds, roller blinds/screens, roller shutters, vertical blinds, curtains, integral venetian blinds, pleated blinds, awnings, etc. Additionally, Wave Shutter can control window motors, projector screens, or any bi-directional AC motor.
Short Description
The device is a 4-digital input module (110–240 V AC) that controls other devices within the Z-Wave network. It enables manual activation or deactivation of scenes via a switch/push-button.
Switch/Push-Button Connected to Input Terminal SW1
The device supports the Central Scene Command Class. When a button is single-pressed, double-pressed, held and released, it sends a scene notification with the corresponding scene number (1, 2, 3, or 4).
NOTE: Switch type is not supported for triggering central scene notifications.
Push-Button Connected to Input Terminal 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 devices in Group 5.
- Release: Sends "Key released =0x01" and sends command to devices in Group 5.
If SW1 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 4 and 5.
If SW1 is configured as a switch-memory:
- Switching to Close contact: Sends command to devices in Groups 4 and 5 based on current state.
- Switching to Open contact: Sends command to 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, then sends command to devices in Group 6. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down =0x02", then sends command to devices in Group 7.
- Release: Sends "Key released =0x01", then sends command to devices in Group 7.
If SW2 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 6 and 7.
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, then sends command to devices in Group 8. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down =0x02", then sends command to devices in Group 9.
- Release: Sends "Key released =0x01", then sends command to devices in Group 9.
If SW3 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 8 and 9.
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, then sends command to devices in Group 10. - 2x Short press: Sends "Key pressed 2 times=0x00".
- Press and hold: Sends "Key held down =0x02", then sends command to devices in Group 11.
- Release: Sends "Key released =0x01", then sends command to devices in Group 11.
If SW4 is configured as a switch:
- Change switch position once: Sends command to devices in Groups 10 and 11.
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, condos, hotels, etc.)
- Light Commercial (small offices, retail stores, restaurants, gas stations, etc.)
- Government/Municipal
- University/College
Integrations
Shelly Qubino Wave devices are built on Z-Wave, the world’s leading smart home technology.
This means they work with all certified gateways supporting the Z-Wave protocol.
For compatibility details, 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 resets the alarm:
- Power cycle
- Short press on S button
- Press any switch/push-button connected to SW (SW1, SW2, etc.)
Note: Overheat protection is always active and cannot be disabled.
Additional info under Notification for Overheat Detected
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 perform actions like inclusion, exclusion, or 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.
- Additional quick press → menu change (infinite loop)
- Menu LED status has a 10s 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
| Status | LED Behavior |
|---|---|
| Normal Mode – Removed/Excluded | Blinking blue in Mode 1 for 10 min after power cycle or S button press |
| Normal Mode – Added/Included | Blinking green in Mode 1 for 10 min after power cycle or S button press |
| Factory Reset & Reboot | Solid green (~1 sec), then blinking blue/red (0.1s On/Off) for ~2 sec |
| Adding/Removing | Blinking blue in Mode 2 |
| Firmware OTA Update | Blinking blue and red in Mode 2 |
| Power Supply Check (230V AC / 24V DC) | Blinking blue and red in Mode 5 |
| Settings Mode – Add/Remove Selected | Solid blue (max 10s) |
| Settings Mode – Add/Remove in Progress | Blinking blue in Mode 3 |
| Settings Mode – Factory Reset Selected | Solid red (max 10s) |
| Settings Mode – Factory Reset in Progress | Blinking red in Mode 3 |
| Alarm Mode – Overheat Detected | Blinking red in Mode 4: (2x 0.2s On/Off) + 2s Off |
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 | (1–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 successfully added/removed.
Note! For Security 2 (S2) inclusion, a dialog appears asking for the 5-digit PIN code printed on the Z-Wave DSK label (on device and packaging). Do not lose this label.
SmartStart Inclusion
- Scan the QR code on the device using a gateway with SmartStart support.
- Connect the device to power.
- If the blue LED blinks slowly, the device is not yet added.
- Adding starts automatically within seconds of power-up.
- Blue LED blinks faster during addition.
- Green LED blinks slowly if successful.
Inclusion with S Button
- Connect device to power.
- Confirm blue LED blinks slowly.
- Enable add/remove mode on gateway.
- Press and hold S button until LED turns solid blue.
- Release quickly, then press and hold (>2s) until LED blinks slowly — release to start Learn mode.
- Blue LED blinks faster during addition.
- Green LED blinks slowly upon success.
Note: Settings mode times out after 10s.
Inclusion with Switch/Push-Button
- Connect device to power.
- Confirm blue LED blinks slowly.
- Enable add/remove mode on gateway.
- Toggle the switch/push-button on any SW terminal 3 times within 3 seconds (must receive 3 on/off signals).
- Blue LED blinks faster during addition.
- Green LED blinks slowly if successful.
Learn Mode: State allowing device to receive network info from gateway.
Removing the Device from a Z-Wave Network (Exclusion)
Note: Device will be removed, but custom configurations remain.
Note: Blind moves 2s up/down on success.
Removal with S Button
- Connect device to power.
- Confirm green LED blinks 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 — release to start Learn mode.
- Blue LED blinks faster during removal.
- Blue LED blinks slower if successful.
Note: Settings mode times out after 10s.
Removal with Switch/Push-Button
- Connect device to power.
- Confirm green LED blinks slowly.
- Enable add/remove mode on gateway.
- Toggle switch/push-button on any SW terminal 3 times within 3 seconds.
- Blue LED blinks faster during removal.
- Blue LED blinks slower if successful.
Factory Reset
General
After reset, all custom parameters (kWh, associations, routing, etc.) revert to default. HOME ID and NODE ID are deleted. Use only when gateway is missing or inoperable.
With S Button
- Press and hold S button until LED turns solid blue.
- Press S button multiple times until LED turns solid red.
- Hold S button (>2s) until red LED blinks fast — release to start reset.
- During reset: LED turns solid green (~1s), then blue/red blinks fast (~2s).
- Blue LED blinks slowly if successful.
With Switch/Push-Button
Note: 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/red blinks fast (~2s).
- Blue LED blinks slowly if successful.
Z-Wave Security and Device Specific Key (DSK)
The device supports Security 2 (S2) using Strong AES 128 Encryption — making Z-Wave the most secure IoT platform.
- Authenticated Control: Out-of-band DSK inclusion
- Supports S2 Authenticated, Unauthenticated, and Unsecure inclusion
Note: When adding via S2-enabled gateway, you must enter the 5-digit PIN from the DSK label (on device and packaging). Do not remove the label.
The first five digits are highlighted/underlined. The DSK is also represented via QR code.
DSK Obfuscation: Joining node sets bytes 1–2 to zero before transferring public key via RF.
The DSK may be used for out-of-band (OOB) authentication. The gateway can scan the QR code to match the obfuscated public key received over RF.
Z-Wave Parameters
| Parameter No. | Name | Description | Value Size | Default | Values & Descriptions |
|---|---|---|---|---|---|
| 1 | SW (SW1) Switch Type | Defines behavior of switch on SW1 terminal | 1 Byte | 0 | 0: momentary switch (push button) 1: toggle switch (contact closed = ON) 2: toggle switch (device changes status when switch changes) |
| 2 | SW2 Switch Type | Same as above for SW2 | 1 Byte | 0 | Same values |
| 3 | SW3 Switch Type | Same as above for SW3 | 1 Byte | 0 | Same values |
| 4 | SW4 Switch Type | Same as above for SW4 | 1 Byte | 0 | Same values |
| 105 | LED Signalisation Intensity | Controls LED brightness (0–100%) | 1 Byte | 100 | 0–100 (every 1%) |
| 120 | Factory Reset | Triggers factory reset and removes from network | 1 Byte | 0 | 0: no action 1: factory reset |
| 201 | Serial Number 1 | Part of device serial number | 4 Byte | Device-specific | 0x00000000 – 0x7FFFFFFF |
| 202 | Serial Number 2 | Part of device serial number | 4 Byte | Device-specific | 0x00000000 – 0x7FFFFFFF |
| 203 | Serial Number 3 | Part of device serial number | 4 Byte | Device-specific | 0x00000000 – 0x7FFFFFFF |
After reset, parameter value auto-sets to 0.
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
Endpoint 2
- 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
Endpoints 3–5
Same as Endpoint 2
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 | See 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 max: 5 per group
- “Lifeline Group” reserved for gateway only (1 node)
Root Device – Association Group 1 (Lifeline)
- Reports device status
- Supports:
- INDICATOR_REPORT
- DEVICE_RESET_LOCALLY_NOTIFICATION
- SWITCH_BINARY_REPORT (SW1–SW4)
Association Group 4 (SW1 – Basic Command)
- Triggered by SW1
- Sends BASIC_SET ON/OFF to associated devices
- Uses Basic command class
Association Group 5 (SW1 – Multilevel)
- Triggered by SW1
- Sends SWITCH_MULTILEVEL_START_LEVEL_CHANGE / STOP_LEVEL_CHANGE
- Recommended for push-buttons
Association Group 6 (SW2 – Basic)
- Triggered by SW2
- Sends BASIC_SET ON/OFF
Association Group 7 (SW2 – Multilevel)
- Triggered by SW2
- Sends multilevel commands
- Recommended for push-buttons
Association Groups 8–11 (SW3/SW4)
- Same structure as above
Endpoints 2–5
Each has similar association groups (Group 1 Lifeline, Group 2 Basic, Group 3 Multilevel)
Z-Wave Important Disclaimer
Z-Wave wireless communication may not be 100% reliable. Do not rely solely on this device for life-or-value-critical applications. If device isn’t recognized or behaves incorrectly, manually adjust device type and confirm gateway supports Z-Wave Plus™ multi-level devices.
Troubleshooting
Visit our support portal: 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 HC3/Z-Wave Engine 3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homey | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | *H |
| Homee Cube Gen 7 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Homee Cube Gen 5 | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | *1 |
| SmartThings | ✅ | ✅ | ✅ | ✅ | With Shelly Wave edge driver | ||||
| Vera Ezlo | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ | ✅ | ✅ | *2 |
Notes:
- *1: Cannot use Central Scene or Association features
- *2: Missing CC Control Scene capability
- *H: Issues with reports can be resolved via this solution
Functionality Legend
| 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 changes via SW input |
| Slats | Slats respond to app UI command |
| SW Slats | Slats report changes via SW input |
| D Control | Detached mode: reports scene commands (single/double press, etc.) |
| D Binary | Detached mode: reports binary On/Off via SW input |
| Sensor # | Sensor report visible? 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