Skip to content

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.

Wave_I4_DC-320x300.jpg

Device: Wave i4 DC

  • US Part number/Ordering Code: QNSN-0D24XUS
  • Z-Wave Product type ID: 0x0009
  • Z-Wave Product ID: 0x0082
  • 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. The words included, added, etc., are used in this regard.
  • Removing/Exclusion – The process of removing a Z-Wave device from a Z-Wave network – gateway. The words 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 (5–24 V DC) 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, double-pressed, held and released, it transmits a scene notification with 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: Central scene notification “Key pressed 1 time=0x00” with scene number 0x01 is sent, and sends command to associated devices in group 4 (see Z-Wave Association).
  • 2x Short press: Central scene notification “Key pressed 2 times=0x00” is sent.
  • Press and hold: Central scene notification “Key held down = 0x02” is sent, and sends command to associated devices in group 5.
  • Release: Central scene notification “Key released = 0x01” is sent, and sends command to associated devices in group 5.

If SW1 is configured as a switch:

  • Change switch position once: Sends command to associated devices in groups 4 and 5.

If SW1 is configured as a switch-memory:

  • Switching to Close contact: Sends command to associated devices in groups 4 and 5 based on switch state.
  • Switching to Open contact: Sends command to associated devices in groups 4 and 5 based on switch state.

Switch/Push-button Connected to Input Terminal SW2

If SW2 is configured as a push-button:

  • Scene number = 0x02

Actions:

  • Short press: Central scene notification “Key pressed 1 time=0x00” with scene number 0x02 is sent, and sends command to associated devices in group 6.
  • 2x Short press: Central scene notification “Key pressed 2 times=0x00” is sent.
  • Press and hold: Central scene notification “Key held down = 0x02” is sent, and sends command to associated devices in group 7.
  • Release: Central scene notification “Key released = 0x01” is sent, and sends command to associated devices in group 7.

If SW2 is configured as a switch:

  • Change switch position once: Sends command to associated devices in groups 6 and 7.

If SW2 is configured as a switch-memory:

  • Switching to Close contact: Sends command to associated devices in groups 6 and 7 based on switch state.
  • Switching to Open contact: Sends command to associated devices in groups 6 and 7 based on switch state.

Switch/Push-button Connected to Input Terminal SW3

If SW3 is configured as a push-button:

  • Scene number = 0x03

Actions:

  • Short press: Central scene notification “Key pressed 1 time=0x00” with scene number 0x03 is sent, and sends command to associated devices in group 8.
  • 2x Short press: Central scene notification “Key pressed 2 times=0x00” is sent.
  • Press and hold: Central scene notification “Key held down = 0x02” is sent, and sends command to associated devices in group 9.
  • Release: Central scene notification “Key released = 0x01” is sent, and sends command to associated devices in group 9.

If SW3 is configured as a switch:

  • Change switch position once: Sends command to associated devices in groups 8 and 9.

If SW3 is configured as a switch-memory:

  • Switching to Close contact: Sends command to associated devices in groups 8 and 9 based on switch state.
  • Switching to Open contact: Sends command to associated devices in groups 8 and 9 based on switch state.

Switch/Push-button Connected to Input Terminal SW4

If SW4 is configured as a push-button:

  • Scene number = 0x04

Actions:

  • Short press: Central scene notification “Key pressed 1 time=0x00” with scene number 0x04 is sent, and sends command to associated devices in group 10.
  • 2x Short press: Central scene notification “Key pressed 2 times=0x00” is sent.
  • Press and hold: Central scene notification “Key held down = 0x02” is sent, and sends command to associated devices in group 11.
  • Release: Central scene notification “Key released = 0x01” is sent, and sends command to associated devices in group 11.

If SW4 is configured as a switch:

  • Change switch position once: Sends command to associated devices in groups 8 and 9.

If SW4 is configured as a switch-memory:

  • Switching to Close contact: Sends command to associated devices in groups 10 and 11 based on switch state.
  • Switching to Open contact: Sends command to associated devices in groups 10 and 11 based on switch 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 the Z-Wave communication protocol.

To ensure full functionality on your gateway, we regularly test compatibility with different Z-Wave gateways. Refer to the Compatibility with Gateways section for detailed compatibility reports.


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

  • Switches off its own relay
  • Sends Notification Report to the Gateway (Overheat detected)
  • LED lights react as specified (check blinking mode for Overheat detected)

Any of the following actions reset this alarm:

  • Power cycle
  • Short press on S button
  • Press any switch/push-button connected to SW (SW1, SW2, …) terminal

NOTE: Overheat protection is always active and cannot be disabled.
Additional details under Notification for Overheat Detected


Supported Load Types

N/A


User Interface

S Button and Operating Modes

  1. Normal mode
  2. Setting in progress mode
  3. Setting mode (with S button)
    • Required to start procedures like adding (inclusion), removing (exclusion), factory reset, etc.
    • Has a 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 in infinite loop.
      • Menu LED status has a 10-second timeout before returning to Normal state.

S Button’s 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

Click to see LED signalisation:

Normal Mode

  • Removed/Excluded: LED blinks blue in Mode 1 for 10 minutes after power cycle or S button press.
    Mode1-Blue
  • Added/Included: LED blinks green in Mode 1 for 10 minutes after power cycle or S button press.
    Mode1-Green

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 sec.
  • Adding / Removing: LED blinks blue in Mode 2.
    Mode2Blue
  • Firmware updating OTA: LED blinks blue and red in Mode 2.
    Mode2BlueRed
  • Checking power supply (230V AC or 24V DC): LED blinks blue and red in Mode 5.
    Mode5BlueRed

Settings Mode with S Button

  • Adding/Removing menu selected: LED stays solid blue for up to 10 seconds.
  • During Add/Remove process: LED blinks blue in Mode 3.
    Mode3Blue
  • Factory reset menu selected: LED stays solid red for up to 10 seconds.
  • During Factory Reset: LED blinks red in Mode 3.
    Mode3Red

Alarm Mode

  • Overheat detected: LED blinks red in Mode 4 – 2x (0.2s On / 0.2s Off) + 2s Off, repeating.
    AlarmMode2

LED Blinking Modes

ModeBlink Pattern
Mode 10.5s On / 2s Off
Mode 20.5s On / 0.5s Off
Mode 30.1s On / 0.1s Off
Mode 4(1–6 x) 0.2s On / 0.2s Off + 2s Off
Mode 50.2s On (blue) / 0.2s On (red)

Specifications

Error rendering macro 'excerpt-include': User '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' does not have permission to view the page 'DEV:Technical Specifications'.


Basic Wiring Diagram

Error rendering macro 'excerpt-include': User '712020:515aa595-e304-41f3-886a-d9b6b0b7f5a3' does not have permission to view the page 'DEV:Wiring diagrams'.


Legend

TerminalsDescriptionWiresDescription
5–24 V DC ground terminalGND5–24 V DC ground wire
+5–24 V DC positive terminal+5–24 V DC positive wire
SW 1Switch/push-button input terminal
SW 2Switch/push-button input terminal
SW 3Switch/push-button input terminal
SW 4Switch/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 from a Z-Wave® network.

Note! For Security 2 (S2) inclusion, a dialog will appear asking you to enter the 5-digit PIN code written on the Z-Wave® DSK label on the side of the device and in the packaging.
IMPORTANT: The PIN code must not be lost.

SmartStart Inclusion

SmartStart-enabled products can be added by scanning the Z-Wave® QR code on the device with a gateway supporting SmartStart. No further action required — the device adds automatically within 10 minutes of being powered on in range.

  1. Scan the QR code on the device label using the gateway app.
  2. Add the Security 2 (S2) Device Specific Key (DSK) to the provisioning list.
  3. Connect the device to power.
  4. Check if the blue LED is blinking slowly — if yes, the device is not yet added.
  5. Adding starts automatically within seconds after power-up.
  6. Blue LED blinks faster during addition.
  7. Green LED blinks slowly if successful.

Adding with the S Button

  1. Connect device to power.
  2. Confirm blue LED is blinking slowly (not added).
  3. Enable add/remove mode on the gateway.
  4. Press and hold S button until LED turns solid blue.
  5. Release quickly, then press and hold (>2s) until blue LED blinks slowly — release to start Learn mode.
  6. Blue LED blinks faster during addition.
  7. Green LED blinks slowly upon success.

Note: In Setting mode, the device times out after 10 seconds and returns to Normal mode.

Adding with a Switch/Push-button

  1. Connect device to power.
  2. Confirm blue LED is blinking slowly.
  3. Enable add/remove mode on the gateway.
  4. Toggle the switch/push-button connected to any SW terminal (SW1–SW4) 3 times within 3 seconds (puts device in Learn mode).
  5. Blue LED blinks faster during addition.
  6. Green LED blinks slowly upon success.

Learn mode – a state allowing 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 custom configurations remain intact.

Note! The blind will move 2s up/down upon successful removal.

Removing with the S Button

  1. Connect device to power.
  2. Confirm green LED is blinking slowly (device is added).
  3. Enable add/remove mode on the gateway.
  4. Press and hold S button until LED turns solid blue.
  5. Release quickly, then press and hold (>2s) until blue LED blinks slowly — release to start Learn mode.
  6. Blue LED blinks faster during removal.
  7. Blue LED blinks slower upon success.

Note: Timeout of 10 seconds in Setting mode.

Removing with a Switch/Push-button

  1. Connect device to power.
  2. Confirm green LED is blinking slowly.
  3. Enable add/remove mode on the gateway.
  4. Toggle the switch/push-button on any SW terminal 3 times within 3 seconds.
  5. Blue LED blinks faster during removal.
  6. Blue LED blinks slower upon success.

Factory Reset

General

After factory reset, all custom parameters (kWh, associations, routing, etc.) return to defaults. HOME ID and NODE ID are deleted. Use only when gateway is missing or inoperable.

With S Button

  1. Press and hold S button until LED turns solid blue.
  2. Press S button multiple times until LED turns solid red.
  3. Press and hold (>2s) S button until red LED blinks faster — release to start reset.
  4. During reset: LED turns solid green (~1s), then blue and red blink fast (~2s).
  5. Blue LED blinks slower upon success.

With Switch/Push-button

Note: Only possible within first minute after power-up.

  1. Connect device to power.
  2. Toggle switch/push-button on any SW terminal 5 times within 3 seconds.
  3. During reset: LED turns solid green (~1s), then blue and red blink fast (~2s).
  4. Blue LED blinks slower upon success.

Z-Wave Security and Device Specific Key (DSK)

The device supports the latest Security 2 (S2) feature, using Strong AES-128 encryption — making Z-Wave® the most secure IoT platform.

  • Authenticated Control
    • Out-of-band DSK for inclusion
    • Compatible with most implementations

The device also supports S2 Authenticated, Unauthenticated, and Unsecure inclusion.

Note: When adding via S2-enabled gateway, the DSK PIN code is required. It is printed on the DSK label on the device and included in packaging. Do not remove the label.

DSK Example

The first five digits are highlighted/underlined — these form the PIN code. The DSK is also represented via QR code.

DSK Label & QR Code (Example):

  • Joining node obfuscates public key (bytes 1–2 set to zero) before RF transmission.
  • DSK may be used for out-of-band (OOB) authentication.
  • Gateway can scan QR code to match obfuscated key received via RF.

Z-Wave Parameters

Parameter No. 1 – SW (SW1) Switch Type

  • Defines how device treats switch connected to SW (SW1) terminal.
  • Value size: 1 Byte
  • Default: 0
  • Values:
    • 0: Momentary switch (push button)
    • 1: Toggle switch (closed = ON, open = OFF)
    • 2: Toggle switch (device changes status when switch changes)

Parameter No. 2 – SW2 Switch Type

  • Same as above for SW2 terminal.
  • Default: 0

Parameter No. 3 – SW3 Switch Type

  • Same as above for SW3 terminal.
  • Default: 0

Parameter No. 4 – SW4 Switch Type

  • Same as above for SW4 terminal.
  • Default: 0

Parameter No. 105 – LED Signalisation Intensity

  • Controls LED brightness (dimming).
  • Applies to Wave 1, Wave 1PM, Wave 2PM, Plug US, Plug UK.
  • Value size: 1 Byte
  • Default: 100
  • Range: 0–100 (0%–100%)

Parameter No. 120 – Factory Reset

  • Advanced parameter.
  • Value size: 1 Byte
  • Default: 0
  • Values:
    • 0: No action
    • 1: Factory reset (automatically resets to 0 after execution)

Parameter No. 201 – Serial Number 1

  • Read-only. Contains part of device serial number.
  • Size: 4 Byte
  • Range: 0x00000000 – 0x7FFFFFFF

Parameter No. 202 – Serial Number 2

  • Read-only. Contains part of device serial number.
  • Size: 4 Byte
  • Range: 0x00000000 – 0x7FFFFFFF

Parameter No. 203 – Serial Number 3

  • Read-only. Contains part of device serial number.
  • Size: 4 Byte
  • Range: 0x00000000 – 0x7FFFFFFF

Z-Wave Command Class

Root Device

  1. ASSOCIATION_V2 [S0, S2]
  2. ASSOCIATION_GRP_INFO_V3 [S0, S2]
  3. BASIC_V2 [S0, S2]
  4. SWITCH_BINARY_V2 [S0, S2]
  5. CENTRAL_SCENE_V3 [S0, S2]
  6. CONFIGURATION_V4 [S0, S2]
  7. DEVICE_RESET_LOCALLY_V1 [S0, S2]
  8. FIRMWARE_UPDATE_MD_V5 [S0, S2]
  9. INDICATOR_V3 [S0, S2]
  10. MANUFACTURER_SPECIFIC_V2 [S0, S2]
  11. MULTI_CHANNEL_V4 [S0, S2]
  12. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
  13. SWITCH_MULTILEVEL_V4 [S0, S2]
  14. NOTIFICATION_V8 [S0, S2]
  15. POWERLEVEL_V1 [S0, S2]
  16. SECURITY_V1
  17. SECURITY_2_V1
  18. SUPERVISION_V1
  19. VERSION_V3 [S0, S2]
  20. ZWAVEPLUS_INFO_V2

Endpoint 2

  1. ASSOCIATION_V2 [S0, S2]
  2. ASSOCIATION_GRP_INFO_V3 [S0, S2]
  3. SWITCH_BINARY_V2 [S0, S2]
  4. MULTI_CHANNEL_ASSOCIATION_V3 [S0, S2]
  5. SECURITY_V1
  6. SECURITY_2_V1
  7. SUPERVISION_V1
  8. ZWAVEPLUS_INFO_V2

(Endpoints 3–5 follow same pattern)


Z-Wave Notifications Command Class

Overheat Detected

CommentOverheat Detected
Z-Wave Notification Type NameHeat Alarm
Notification Type – Value0x04
Notification Type – EventState
Notification NameOverheat detected
Notification Name – Value0x02
Notification Name – VersionV2
Device SpecificYes
LED SignalisationCheck LED table
Device ReactionSwitch OFF all outputs + send notification
Action to RestorePower cycle, short press S button, or press any SW terminal

Z-Wave Associations

Associations enable direct communication between devices without gateway intervention.

  • Max 9 devices per group (fixed). Recommend ≤5 per group.
  • “Lifeline Group” reserved for gateway (only 1 node allowed).

Root Device – Association Group 1 (Lifeline)

  • Supports:
    • INDICATOR_REPORT (LED status)
    • DEVICE_RESET_LOCALLY_NOTIFICATION
    • SWITCH_BINARY_REPORT (SW1–SW4 status changes)

Association Group 4

  • Assigned to SW1 (Basic command class)
  • Triggered by SW1
  • Sends BASIC_SET ON/OFF to associated devices

Association Group 5

  • Assigned to SW1 (Switch Multilevel command class)
  • Recommended for push buttons
  • Supports:
    • SWITCH_MULTILEVEL_START_LEVEL_CHANGE
    • SWITCH_MULTILEVEL_STOP_LEVEL_CHANGE

Association Groups 6–11

  • Similar structure for SW2 (Groups 6 & 7), SW3 (Groups 8 & 9), SW4 (Groups 10 & 11)

(Details follow same pattern as above)


Endpoint 1 (Root mirror)

  • Association Group 1: Lifeline (same as root)
  • Groups 2 & 3: Mirror of SW1 associations

Endpoint 2

  • Group 1: Lifeline (SW1 status report)
  • Group 2: Basic command (SW1)
  • Group 3: Multilevel command (SW1)

Endpoint 3

  • Group 1: Lifeline (SW2 status)
  • Group 2: Basic command (SW2)
  • Group 3: Multilevel command (SW2)

Endpoint 4

  • Group 1: Lifeline (SW3 status)
  • Group 2: Basic command (SW3)
  • Group 3: Multilevel command (SW3)

Endpoint 5

  • Group 1: Lifeline (SW4 status)
  • Group 2: Basic command (SW4)
  • Group 3: Multilevel command (SW4)

Z-Wave Important Disclaimer

Z-Wave wireless communication may not always be 100% reliable. This device should not be used in life-critical or high-value situations. If the device isn’t recognized or appears incorrectly, manually change the device type and ensure your gateway supports Z-Wave Plus™ multi-level devices.


Troubleshooting

For troubleshooting, visit our support portal:
👉 Support


Compatibility with Gateways

GatewayOn/Off 1On/Off 2On/Off 3On/Off 4Notes
Home Assistant
Fibaro HC3 / Z-Wave engine 3
HomeySolution
Homee Cube Gen 7
Homee Cube Gen 5Not possible to use Central Scene or association
Smart ThingsWith Shelly Wave edge driver
JeedomTBDTBDTBDTBD
HubitatTBDTBDTBDTBD

Legend:

  • ✅ = Working / Possible
  • ⚪ = Partially
  • ❌ = Not Working / Not Possible
  • TBD = To be done
  • N/T = Not Tested

Function Meaning

FunctionMeaning
On/OffTested if device responds to app UI On/Off command
SW On/OffTested if device reports On/Off changes via SW input
WattsTested if Watts are reported unsolicited
kWhTested if kWh are reported unsolicited
Up/DownTested if device responds to app UI Up/Down command
SW Up/DownTested if device reports Up/Down changes via SW input
SlatsTested if slats respond to app UI command
SW SlatsTested if slats report changes via SW input

Gateway Guides

Useful guides available in the Shelly Knowledge Base


Compliance


Printed User Guide

Wave_i4DC_V1_US_print.pdf