Shelly Wave Pro 1 – Device Documentation
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 Identification
- Device: Wave Pro 1
- AUS Part number / Ordering Code: QPSW-0A1X16AU
- Z-Wave Product type ID:
0x0002 - Z-Wave Product ID:
0x008A - 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 being discussed.
- Gateway: A Z-Wave® gateway (also called a Z-Wave® controller, hub, or primary controller) that serves as the 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 inclusion, exclusion, and factory reset. The term “S button” is used throughout.
Short Description
The Shelly Wave Pro 1 is a DIN rail-mountable smart switch with potential-free contacts. It controls the on/off function for one electrical device with a load up to 16 A. Compatible with switches (default) and push-buttons.
Switch Connected to Input Terminal SW (SW1)
If SW (SW1) is configured as a switch (default):
- Single toggle: Changes output O (O1) state to opposite — on → off, off → on — and sends command to associated devices in groups 2 and 3 (see Z-Wave Association).
- Double toggle (within 500ms): Interpreted as a double press; sends command to dimmers, shutters, etc., in groups 2 and 3.
Switch-Memory Connected to Input Terminal SW (SW1)
When SW (SW1) is configured as a switch-memory:
- Closing contact: Output O (O1) turns ON; sends command to devices in groups 2 and 3.
- Opening contact: Output O (O1) turns OFF; sends command to devices in groups 2 and 3.
Push-Button Connected to Input Terminal SW (SW1)
If SW (SW1) is configured as a push-button:
- Short press: Toggles output O (O1) state (ON ↔ OFF), sends command to devices in groups 2 and 3.
- Hold: Sends command to devices in group 3.
- Release: Sends command to devices in group 3.
Switch / Push-Button Connected to Input Terminal SW2
If SW2 is configured as a switch (default), each change in switch status sends an association command to:
- Group 4 (on/off), or
- Group 5 (SSLC - root single channel device only)
Based on current switch position (see Z-Wave Association).
Switch-Memory Connected to Input Terminal SW2
When SW2 is configured as memory switch, any state change sends an association command to:
- Group 4 (on/off), or
- Group 5 (SSLC - root single-channel only)
Based on the last memorized state after power loss.
Push-Button Connected to Input Terminal SW2
- Short press: Toggles ON/OFF commands sent to group 4 (on/off) or group 5 (SSLC — root single-channel only).
- Hold: Initiates level adjustment (e.g., dimming) for devices in group 5 (SSLC — root single-channel only).
- Release: Stops level adjustment for devices in group 5 (SSLC — root single-channel only).
Switching On/Off Load Connected to O (O1)
The load connected to O (O1) can be switched ON/OFF by:
- A Z-Wave command
- Automatic switching via Parameters No. 19 and 20
- Pressing the switch/push-button SW (SW1)
Each action toggles the output state.
Main Applications
- Residential
- MDU (Multi Dwelling Units – apartments, condos, hotels, etc.)
- Light commercial (small offices, retail, restaurants, gas stations, etc.)
- Government / Municipal
- University / College
- Farming
Integrations
Shelly Wave devices are built on Z-Wave, the world’s leading smart home technology.
They work with all certified gateways supporting the Z-Wave protocol. Regular compatibility testing ensures full support across various gateways.
Simplified Internal Schematics
Device Electrical Interfaces
Inputs
- 2 switch/button inputs on screw terminals
- 1 potential-free contact relay input on screw terminal
- 2 power supply inputs on screw terminals: N, L
Outputs
- 1 potential-free contact relay output on screw terminal
Connectivity
- Z-Wave: Unsecure, S0 Security, S2 Unauthenticated Security, S2 Authenticated Security
Safety Features
Overheat Protection
- Automatically switches off the relay
- Sends "Overheat Detected" notification to the gateway
- LED reacts accordingly (see blinking modes below)
Note: Overheat protection is always active and cannot be disabled.
Reset actions include:
- Power cycle
- Short press on S button
- Press any switch/push-button on SW (SW1, SW2, etc.)
🔗 See more: Notification for Overheat Detected
Supported Load Types
- Resistive (incandescent bulbs, heaters)
- Capacitive (capacitor banks, electronic equipment, motor start capacitors)
- Inductive with RC Snubber (LED drivers, transformers, fans, refrigerators, air conditioners)
User Interface
S Button and Operating Modes
- Normal mode
- "Setting in progress" mode
- Setting mode (with S button)
Setting mode is required for inclusion, exclusion, or factory reset. After completion, the device returns automatically to Normal mode.
Entering Setting Mode:
- Quickly press and hold the S button until the LED turns solid blue
- An additional quick press cycles through menu options
- Menu timeout: 10 seconds before returning to Normal mode
S Button Functions
- Manually add device to Z-Wave network
- Manually remove device from Z-Wave network
- Factory reset device
LED Signalisation
| Status | LED Behavior |
|---|---|
| Removed/Excluded | Blinking blue (Mode 1) for 10 min after power-up or S button press |
| Added/Included | Blinking green (Mode 1) for 10 min after power-up or S button press |
| Factory Reset & Reboot | Solid green (~1 sec), then blue + red blinking (0.1s on/off, ~2 sec) |
| Adding/Removing | Blinking blue (Mode 2) |
| OTA Firmware Update | Blue + red blinking (Mode 2) |
| Power Supply Check | Blue + red blinking (Mode 5) |
| Menu Selected (Add/Remove) | Solid blue (max 10 sec) |
| Menu Executing (Add/Remove) | Blinking blue (Mode 3) |
| Menu Selected (Factory Reset) | Solid red (max 10 sec) |
| Menu Executing (Factory Reset) | Blinking red (Mode 3) |
| Overheat Detected (Alarm Mode) | Red blinking (0.2s on, 0.2s off) repeated every 2 seconds |
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–6 flashes of 0.2s on/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 page 'DEV:Technical Specifications'.
Basic Wiring Diagram
Legend
| Terminal | Function | Wire | Purpose |
|---|---|---|---|
| N | Neutral terminal | N | Neutral wire |
| L | Live terminal (110–240 V AC) | L1(A) | Load circuit live wire |
| SW | Switch/push-button input (controls O) | L2(B) | Device power supply live wire |
| SW2 | Switch/push-button input terminal | — | — |
| I | Load circuit input terminal | — | — |
| O | Load circuit output terminal | — | — |
About Z-Wave®
Adding the Device to a Z-Wave® Network (Inclusion)
✅ Note: All outputs (O, O1, etc.) blink 1s ON / 1s OFF upon successful addition/removal.
🔐 Important (S2 Security): When adding with S2, enter the 5-digit PIN from the DSK label on the device or packaging. Do not lose it.
SmartStart Inclusion
- Scan the QR code on the device using a SmartStart-capable gateway.
- Connect the device to power.
- Confirm blue LED blinks in Mode 1 → device not yet added.
- Auto-inclusion begins within seconds.
- Blue LED blinks in Mode 2 during inclusion.
- Green LED blinks in Mode 1 if successful.
Inclusion with S Button
- Power on the device.
- Confirm blue LED blinks in Mode 1.
- Enable add/remove mode on the gateway.
- Press and hold S button until LED turns solid blue.
- Release, then press and hold (>2s) until blue LED blinks in Mode 3 → starts Learn mode.
- Blue LED blinks in Mode 2 during inclusion.
- Green LED blinks in Mode 1 if successful.
⏱️ Setting mode timeout: 10 seconds before returning to normal.
Inclusion with Switch/Push-Button
- Power on device.
- Confirm blue LED blinks in Mode 1.
- 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 in Mode 2 during inclusion.
- Green LED blinks in Mode 1 if successful.
📌 Learn mode: State allowing device to receive network info from gateway.
Removing the Device from a Z-Wave® Network (Exclusion)
❗ Note: Custom settings are preserved; only network membership is removed.
Removal with S Button
- Power on device.
- Confirm green LED blinks in Mode 1 → device is included.
- Enable add/remove mode on gateway.
- Press and hold S button until LED turns solid blue.
- Release, then press and hold (>2s) until blue LED blinks in Mode 3 → starts Learn mode.
- Blue LED blinks in Mode 2 during removal.
- Blue LED blinks in Mode 1 if successful.
⏱️ Timeout: 10 seconds in setting mode.
Removal with Switch/Push-Button
- Power on device.
- Confirm green LED blinks in Mode 1.
- Enable add/remove mode on gateway.
- Toggle switch/push-button on any SW terminal 3 times within 3 seconds.
- Blue LED blinks in Mode 2 during removal.
- Blue LED blinks in Mode 1 if successful.
Factory Reset
General Notes
After reset:
- All custom parameters, associations, routing, kWh data reset to default
- HOME ID and NODE ID deleted
- Use only when gateway is unavailable
With S Button
- Press and hold S button until LED turns solid blue.
- Press S button repeatedly until LED turns solid red.
- Hold S button (>2s) until red LED starts blinking in Mode 3 → reset begins.
- During reset: solid green (~1s), then blue + red blink in Mode 3 (~2s).
- Blue LED blinks in Mode 1 → success.
With Switch/Push-Button
⚠️ Only possible within first minute after power-up.
- Power on device.
- Toggle switch/push-button on any SW terminal 5 times within 3 seconds.
- During reset: solid green (~1s), then blue + red blink in Mode 3 (~2s).
- Blue LED blinks in Mode 1 → success.
Remote Factory Reset via Parameter
Set Parameter No. 120 = 1 to trigger remote factory reset.
Z-Wave® Security and Device Specific Key (DSK)
- Supports Security 2 (S2) with AES-128 encryption — the most secure IoT platform available.
- S2 supports:
- Unsecured
- S2 Unauthenticated
- S2 Authenticated
- Requires S2-enabled gateway for full security.
DSK Label & QR Code
- Unique 12-digit DSK printed on side label and in packaging.
- First five digits highlighted/underlined = PIN code.
- QR code also present for scanning.
🔒 Out-of-band (OOB) authentication: Gateway scans QR code to match obfuscated public key received via RF.
Z-Wave® Parameters
| Parameter | Description | Size | Default | Values |
|---|---|---|---|---|
| No. 1 – SW (SW1) Switch Type | Defines how SW1 is interpreted | 1 Byte | 2 | 0=momentary, 1=toggle (closed=ON), 2=toggle (state change) |
| No. 2 – SW2 Switch Type | Defines how SW2 is interpreted | 1 Byte | 2 | 0=push-button, 1=toggle (closed=ON), 2=toggle (state change) |
| No. 17 – Restore O (O1) after Power Failure | Whether to restore previous state | 1 Byte | 0 | 0=restore, 1=remain OFF |
| No. 19 – O (O1) Auto OFF Timer | Auto-off after set time (in s/ms) | 2 Bytes | 0 | 0=disabled, 1–32535 = seconds or milliseconds (see Param 25) |
| No. 20 – O (O1) Auto ON Timer | Auto-on after set time (in s/ms) | 2 Bytes | 0 | 0=disabled, 1–32535 = seconds or milliseconds (see Param 25) |
| No. 23 – O (O1) Contact Type (NO/NC) | Relay contact type | 1 Byte | 0 | 0=NO, 1=NC |
| No. 25 – Timer Units (s or ms) | Set resolution for Params 19 & 20 | 1 Byte | 0 | 0=seconds, 1=milliseconds |
| No. 91 – Water Alarm Response | Reacts to water alarm frames | 4 Bytes | 0 | 0=no action, 1=open relay, 2=close relay |
| No. 92 – Smoke Alarm Response | Reacts to smoke alarm frames | 4 Bytes | 0 | 0=no action, 1=open relay, 2=close relay |
| No. 93 – CO Alarm Response | Reacts to CO alarm frames | 4 Bytes | 0 | 0=no action, 1=open relay, 2=close relay |
| No. 94 – Heat Alarm Response | Reacts to heat alarm frames | 4 Bytes | 0 | 0=no action, 1=open relay, 2=close relay |
| No. 120 – Factory Reset (Remote) | Trigger remote factory reset | 1 Byte | 0 | 0=don’t reset, 1=reset |
| No. 201–203 – Serial Number Parts | Read-only serial number segments | 4 Bytes each | Device-specific | 0x00000000 – 0x7FFFFFFF |
💡 Parameters 201–203 are advanced and may be hidden under "Advanced" tab.
Z-Wave® Command Classes
ASSOCIATION_V2[S0, S2]ASSOCIATION_GRP_INFO_V3[S0, S2]BASIC_V2[S0, S2]SWITCH_BINARY_V2[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_ASSOCIATION_V3[S0, S2]NOTIFICATION_V8[S0, S2]POWERLEVEL_V1[S0, S2]SECURITY_V1SECURITY_2_V1SUPERVISION_V1TRANSPORT_SERVICE_V2VERSION_V3[S0, S2]ZWAVEPLUS_INFO_V2
[S2]* = Security 2 supported
Z-Wave® Notifications Command Class
Overheat Detected
| Field | Value |
|---|---|
| Notification Type Name | Heat Alarm |
| Type (Value) | 0x04 |
| Event | State |
| Notification Name | Overheat Detected |
| Name (Value) | 0x02 |
| Version | V2 |
| LED Signalisation | See blinking table (Mode 4) |
| Device Reaction | Switches off output, sends notification |
| Restore Actions | Power cycle, S button press, switch press |
Z-Wave® Associations
| Group | Purpose | Max Nodes | Trigger | Supported Command Classes |
|---|---|---|---|---|
| Group 1 (Lifeline) | Status reporting, gateway-only | 1 | Always | INDICATOR_REPORT, DEVICE_RESET_LOCALLY_NOTIFICATION, SWITCH_BINARY_REPORT, NOTIFICATION_REPORT |
| Group 2 | SW1 control (Basic) | 9 | SW1 state change | BASIC_SET |
| Group 3 | SW1 control (Multilevel) | 9 | SW1 state change | SWITCH_MULTILEVEL_START_LEVEL_CHANGE, STOP_LEVEL_CHANGE |
| Group 4 | SW2 control (Basic) | 9 | SW2 state change | BASIC_SET |
| Group 5 | SW2 control (Multilevel) | 9 | SW2 state change | SWITCH_MULTILEVEL_START_LEVEL_CHANGE, STOP_LEVEL_CHANGE |
⚠️ Recommend ≤5 devices per group to avoid delays.
Z-Wave® Important Disclaimer
Z-Wave® communication is not 100% reliable. Do not rely solely on this device for life-critical applications. If device isn’t recognized or misbehaves, manually verify device type and ensure gateway supports Z-Wave Plus™ multi-level devices.
Troubleshooting
For help, visit: Shelly Support Portal
Compatibility
| Gateway | On/Off | SW On/Off | Notes |
|---|---|---|---|
| Home Assistant | ✅ | ✅ | |
| Fibaro HC3 / Z-Wave Engine 3 | ✅ | ✅ | |
| Homey | ✅ | ✅ | |
| Homee Cube Gen 7 | ✅ | ✅ | |
| Homee Cube Gen 5 | ✅ | ⚪ | Output updates but UI doesn’t reflect |
| SmartThings | ✅ | ✅ | With Shelly Wave Edge Driver |
| Jeedom | TBD | TBD | |
| Hubitat | TBD | TBD |
⚪ = Partially working
TBD = To be done
Legend
| Symbol | Meaning |
|---|---|
| ✅ | Working / Possible |
| ⚪ | Partially |
| ❌ | Not Working / Not Possible |
| TBD | To Be Done |
Function Meaning
| Function | Meaning |
|---|---|
| On/Off | Responds to app UI On/Off command |
| SW On/Off | Reports state changes 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 |
| Slats | Responds to app UI slats command |
| SW Slats | Reports slats changes via SW |
Gateway Guides
Useful guides: Shelly Knowledge Base – Z-Wave