TABLE OF CONTENTS
- 1. Input settings
- 2. Output and relay settings
- 3. Power and energy report settings
- 4. Shutter and venetian blind settings
- 5. Dimmer settings
- 6. Sensor settings
- 7. Common device settings
- 8. Alarm action settings - deprecated
- 9. Serial number parameters
- Troubleshooting parameter problems
- Important notes
- Summary
Overview
Shelly Wave devices use Z-Wave parameters, that can also be referred as device settings, to change how the device works.
These parameters can control different functions, such as:
Switch input type
Output behavior
Auto ON and Auto OFF timers
Power reports
Shutter calibration
Dimming behavior
Sensor reports
Device reset and reboot options
Important: Not all parameters are available on all devices. Some parameters are only used for specific device types, such as shutter devices, dimmers, sensors, or Wave i4 devices.
If a parameter is not shown in the gateway, this usually means that the connected device does not support it, or the gateway does not display it.
1. Input settings
Input parameters define how the device reads the connected wall switch or push button.
These settings are used on devices with SW inputs, such as relay modules, dimmers, shutter devices, and input modules.
Switch type parameters
| Parameter | Name | Default | Function |
|---|---|---|---|
| 1 | SW1 Switch Type | 2 | Defines the switch type connected to SW1. |
| 2 | SW2 Switch Type | 2 | Defines the switch type connected to SW2. |
| 3 | SW3 Switch Type | 2 | Defines the switch type connected to SW3. |
| 4 | SW4 Switch Type | 2 | Defines the switch type connected to SW4. |
| 5 | SW1 & SW2 Switch Type | 0 | Defines the switch type for SW1 and SW2 together. |
Available values:
| Value | Function |
|---|---|
| 0 | Momentary switch or push button |
| 1 | Toggle switch, contact closed means ON and contact opened means OFF |
| 2 | Toggle switch, device changes state when the switch changes state |
Use these parameters when the wall switch does not control the device as expected.
Example:
Use 0 for a push button.
Use 1 for a classic ON/OFF wall switch.
Use 2 if you want the output to change state every time the switch position changes.
Input and output swap
| Parameter | Name | Default | Function |
|---|---|---|---|
| 6 | Inputs SW1 & SW2 Swap | 0 | Swaps the function of SW1 and SW2 without changing the wiring. |
Available values:
| Value | Function |
|---|---|
| 0 | Default: SW1 controls O1, SW2 controls O2 |
| 1 | Swapped: SW1 controls O2, SW2 controls O1 |
Use this parameter when the input wires are reversed and it is easier to correct the logic by parameter instead of rewiring.
Detached input mode
| Parameter | Name | Default | Function |
|---|---|---|---|
| 7 | Detach O1 Output | 0 | Separates SW1 from output O1. |
| 8 | Detach O2 Output | 0 | Separates SW2 from output O2. |
| 9 | Detach O3 Output | 0 | Separates SW3 from output O3. |
| 10 | Detach O4 Output | 0 | Separates SW4 from output O4. |
Available values:
| Value | Function |
|---|---|
| 0 | Not detached |
| 1 | Detached |
When detached mode is active, the switch input does not directly change the relay output. Use detached mode when the switch should only send commands to the gateway or automation, but should not directly control the local output.
2. Output and relay settings
Output parameters control how relay outputs behave.
These settings are used on devices with relay outputs, such as Wave 1, Wave 2PM, Wave Pro devices, and other relay-based devices.
Output swap
| Parameter | Name | Default | Function |
|---|---|---|---|
| 16 | Outputs O1 & O2 Swap | 0 | Swaps O1 and O2 output logic without rewiring. |
Available values:
| Value | Function |
|---|---|
| 0 | Default: O1 = OPEN, O2 = CLOSE |
| 1 | Reversed: O1 = CLOSE, O2 = OPEN |
This parameter is mainly useful for motor or shutter wiring when the open and close outputs are reversed.
Restore state after power failure
| Parameter | Name | Default | Function |
|---|---|---|---|
| 17 | Restore State of O1 After Power Failure | 0 | Restores the O1 state after power is returned. |
| 18 | Restore State of O2 After Power Failure | 0 | Restores the O2 state after power is returned. |
| 27 | Restore State of O3 After Power Failure | 0 | Restores the O3 state after power is returned. |
| 28 | Restore State of O4 After Power Failure | 0 | Restores the O4 state after power is returned. |
These parameters define how outputs behave after a power loss.
Use them when the output must return to the previous state after the power comes back.
Auto OFF and Auto ON timers
Auto timer parameters are used to automatically change the output after a set time.
Output O1
| Parameter | Name | Default | Function |
|---|---|---|---|
| 19 | O1 Auto OFF With Timer | 0 | Turns O1 OFF automatically after the set time. |
| 20 | O1 Auto ON With Timer | 0 | Turns O1 ON automatically after the set time. |
| 25 | Set Timer Units for O1 | 0 | Selects seconds or milliseconds for parameters 19 and 20. |
Output O2
| Parameter | Name | Default | Function |
|---|---|---|---|
| 21 | O2 Auto OFF With Timer | 0 | Turns O2 OFF automatically after the set time. |
| 22 | O2 Auto ON With Timer | 0 | Turns O2 ON automatically after the set time. |
| 26 | Set Timer Units for O2 | 0 | Selects seconds or milliseconds for parameters 21 and 22. |
Output O3 and O4
| Parameter | Name | Default | Function |
|---|---|---|---|
| 29 | O3 Auto OFF With Timer | 0 | Turns O3 OFF automatically after the set time. |
| 30 | O3 Auto ON With Timer | 0 | Turns O3 ON automatically after the set time. |
| 31 | O4 Auto OFF With Timer | 0 | Turns O4 OFF automatically after the set time. |
| 32 | O4 Auto ON With Timer | 0 | Turns O4 ON automatically after the set time. |
| 33 | Set Timer Units for O3 | 0 | Selects seconds or milliseconds for O3 timers. |
| 34 | Set Timer Units for O4 | 0 | Selects seconds or milliseconds for O4 timers. |
Timer values:
| Value | Function |
|---|---|
| 0 | Timer disabled |
| 1–32535 | Timer value in seconds or milliseconds, depending on the timer unit parameter |
Timer unit values:
| Value | Function |
|---|---|
| 0 | Timer is set in seconds |
| 1 | Timer is set in milliseconds |
Use Auto OFF when a load should turn off automatically, for example lights, fans, pumps, or valves.
Use Auto ON when a load should turn on automatically after it was turned off.
Output contact type
| Parameter | Name | Default | Function |
|---|---|---|---|
| 23 | O1 Contact Type - NO/NC | 0 | Sets the relay logic for O1. |
| 24 | O2 Contact Type - NO/NC | 0 | Sets the relay logic for O2. |
| 106 | O3 Contact Type - NO/NC | 0 | Sets the relay logic for O3. |
| 107 | O4 Contact Type - NO/NC | Not defined | Sets the relay logic for O4, if supported. |
Use these parameters when the relay output must work as normally open or normally closed.
Available values:
| Value | Function |
|---|---|
| 0 | Output is inactive when the device is OFF |
| 1 | Output is active when the device is OFF |
3. Power and energy report settings
Report parameters define when the device sends power reports to the gateway. These settings are used on devices with power measurement.
Power report on change
| Parameter | Name | Default | Function |
|---|---|---|---|
| 36 | O1 Power Report on Change | 50 | Sends a report when O1 power changes by the set percentage. |
| 37 | O2 Power Report on Change | 50 | Sends a report when O2 power changes by the set percentage. |
| 38 | O3 Power Report on Change | 50 | Sends a report when O3 power changes by the set percentage. |
| 43 | O4 Power Report on Change | 50 | Sends a report when O4 power changes by the set percentage. |
Available values:
| Value | Function |
|---|---|
| 0 | Reports disabled |
| 1–100 | Report when power changes by 1–100% |
Lower values send more reports. This can improve live monitoring but may increase Z-Wave traffic.
Minimal time between reports
| Parameter | Name | Default | Function |
|---|---|---|---|
| 39 | Minimal Time Between Reports O1 | 10 | Minimum time between O1 reports. |
| 40 | Minimal Time Between Reports O2 | 10 | Minimum time between O2 reports. |
| 41 | Minimal Time Between Reports O3 | 10 | Minimum time between O3 reports. |
| 42 | Minimal Time Between Reports O4 | 10 | Minimum time between O4 reports. |
Available values:
| Value | Function |
|---|---|
| 0 | Reports disabled |
| 1–120 | Report interval in seconds |
Use these parameters to reduce report frequency and keep the Z-Wave network stable.
4. Shutter and venetian blind settings
Shutter parameters are used only for devices that support shutter or blind control.
These parameters are important for:
Roller shutters
Blinds
Venetian blinds
Curtains
Motors with open and close direction
Shutter operating mode
| Parameter | Name | Default | Function |
|---|---|---|---|
| 71 | Operating Modes | 0 | Selects the shutter operating mode. |
Available values:
| Value | Function |
|---|---|
| 0 | Shutter with positioning |
| 1 | Venetian blind with positioning |
| 2 | Manual time set, no end switches |
Use 0 for standard roller shutters.
Use 1 for venetian blinds with slat control.
Use 2 when the motor has no end switches and the time must be set manually.
Venetian blind settings
| Parameter | Name | Default | Function |
|---|---|---|---|
| 72 | Venetian Blind - Time of Full Turn of the Slats | 150 | Sets the time for a full slat turn. |
| 73 | Set Slats Back to Previous Position | 1 | Returns slats to the previous position after some actions. |
| 77 | Slats Turning Time Offset | 5 | Sets delay or offset related to slat movement. |
Parameter 72 value range:
| Value | Function |
|---|---|
| 0–65535 | 0–655.35 seconds, in 0.01 second steps |
Parameter 73 values:
| Value | Function |
|---|---|
| 0 | Disabled |
| 1 | Slats return to the previous position |
Use these settings only when Parameter 71 is set to 1 - Venetian blind with positioning.
Shutter movement time
| Parameter | Name | Default | Function |
|---|---|---|---|
| 74 | Time of Up Movement | 6000 | Stores the time needed to move up. |
| 75 | Time of Down Movement | 6000 | Stores the time needed to move down. |
| 81 | Motor Max Moving Time | 120 | Maximum allowed motor movement time. |
Parameter 74 and 75 values: (not yet availible)
| Value | Function |
|---|---|
| 1–65535 | 0.01–655.35 seconds, in 0.01 second steps |
Parameter 81 values:
| Value | Function |
|---|---|
| 1–32000 | Maximum motor movement time in seconds |
| 65000 | Unlimited time |
These parameters are used by the device to calculate shutter position.
Motor end position and calibration
| Parameter | Name | Default | Function |
|---|---|---|---|
| 76 | Motor Operation Detection | 1 | Detects when the motor reaches the end limit. |
| 78 | Forced Shutter Calibration | 0 | Starts or reports shutter calibration status. |
| 79 | Power Consumption Max Delay Time | 3 | Maximum time to detect motor power after relay ON. |
| 80 | Motor Stop Delay After Limit Switch Detection | 10 | Delay before motor stop after limit switch detection. |
Parameter 76 values:
| Value | Function |
|---|---|
| 0 | Disabled, limit switch will not be detected |
| 1 | Auto power calibration |
| 2–255 | Manual power threshold in watts |
Parameter 78 values:
| Value | Function |
|---|---|
| 1 | Start calibration |
| 2 | Device is calibrated, read only |
| 3 | Device is not calibrated, read only |
| 4 | Calibration error, read only |
Parameter 79 values:
| Value | Function |
|---|---|
| 0 | Time is set automatically |
| 3–50 | 0.3–5 seconds, in 100 ms steps |
Parameter 80 values:
| Value | Function |
|---|---|
| 0–255 | 0–25.5 seconds |
Use these parameters when the shutter does not calibrate correctly, does not stop at the end position, or does not report position correctly.
5. Dimmer settings
Dimmer parameters are used only for devices with dimming outputs. These settings control brightness limits, soft ON/OFF behavior, and dimming speed.
Brightness limits
| Parameter | Name | Default | Function |
|---|---|---|---|
| 121 | MAX Dimming Value O1 | 99 | Sets maximum brightness for O1. |
| 122 | MAX Dimming Value O2 | 99 | Sets maximum brightness for O2, if supported. |
| 123 | MIN Dimming Value O1 | 99 | Sets minimum brightness for O1. |
| 124 | MIN Dimming Value O2 | 99 | Sets minimum brightness for O2, if supported. |
Use these settings when the light flickers, does not dim low enough, or should not reach full brightness.
Soft ON/OFF dimming time
| Parameter | Name | Default | Function |
|---|---|---|---|
| 125 | Dimming Time O1 | 3 | Time for soft ON/OFF on O1. |
| 126 | Dimming Time O2 | 3 | Time for soft ON/OFF on O2. |
Available values:
| Value | Function |
|---|---|
| 1–10 | 1–10 seconds |
Fade rate when holding the switch
| Parameter | Name | Default | Function |
|---|---|---|---|
| 127 | Fade Rate O1 | 3 | Dimming speed when the switch is held for O1. |
| 128 | Fade Rate O2 | 3 | Dimming speed when the switch is held for O2. |
Available values:
| Value | Function |
|---|---|
| 0 | Non-dimmable load |
| 1 | 5% per second |
| 2 | 7% per second |
| 3 | 10% per second |
| 4 | 15% per second |
| 5 | 20% per second |
Minimum brightness on toggle
| Parameter | Name | Default | Function |
|---|---|---|---|
| 129 | Minimum Brightness on Toggle O1 | 15 | Minimum brightness used when O1 is turned ON. |
| 130 | Minimum Brightness on Toggle O2 | 15 | Minimum brightness used when O2 is turned ON. |
Available values:
| Value | Function |
|---|---|
| 1–99 | 1–99% brightness |
Use this when the light turns on at too low brightness and does not start correctly.
Dual button mode
| Parameter | Name | Default | Function |
|---|---|---|---|
| 131 | SW1 & SW2 Dual Button Mode | 0 | Enables dual button control for dimming. |
Available values:
| Value | Function |
|---|---|
| 0 | Inactive |
| 1 | Active |
6. Sensor settings
Sensor parameters are used for battery or sensor-based Shelly Wave devices. These settings control motion, illumination, tilt, temperature, humidity, and LED indication.
Measurement functions
| Parameter | Name | Default | Function |
|---|---|---|---|
| 155 | Illumination Measurement | 0 | Enables ambient light measurement. |
| 156 | Tilting Measurement | 0 | Enables tilt measurement. |
Available values:
| Value | Function |
|---|---|
| 0 | Inactive |
| 1 | Active |
Note: Enabling extra measurements can reduce battery life.
LED indication
| Parameter | Name | Default | Function |
|---|---|---|---|
| 157 | LED Detection Indicator | Not defined | Enables LED indication when an event is detected. |
Available values:
| Value | Function |
|---|---|
| 0 | LED indicator disabled |
| 1 | LED indicator enabled |
Motion settings
| Parameter | Name | Default | Function |
|---|---|---|---|
| 158 | Motion Sensitivity | Not defined | Sets motion detection sensitivity. |
| 159 | Motion Blind Time | Not defined | Time after detected motion when new motion is ignored. |
| 160 | Motion Not Detected Report Time | Not defined | Time after last motion before motion-not-detected report is sent. |
| 166 | Motion Lux Threshold | Not defined | Defines light level limit for motion detection. |
Parameter 158 values:
| Value | Function |
|---|---|
| 0 | Low sensitivity |
| 1 | Moderate sensitivity |
| 2 | High sensitivity |
Parameter 159 values:
| Value | Function |
|---|---|
| 2–8 | Blind time in seconds |
Parameter 160 values:
| Value | Function |
|---|---|
| 1–32767 | Time in seconds before motion-not-detected report |
Parameter 166 function:
This parameter defines the lux threshold for motion detection. When set to the default value, the sensor detects motion in all light conditions. When a threshold is set, the sensor detects motion only when the ambient light is below the selected lux level.
Temperature settings
| Parameter | Name | Default | Function |
|---|---|---|---|
| 161 | Temperature Threshold | 5 | Defines temperature change needed before a report is sent. |
| 162 | Temperature Offset | 0 | Adds or subtracts value from measured temperature. |
| 165 | Temperature Units | 0 | Selects Celsius or Fahrenheit. |
Parameter 161 values:
| Value | Function |
|---|---|
| 1–50 | 0.1°C to 5.0°C report threshold |
Parameter 162 values:
| Value | Function |
|---|---|
| -500 to +500 | Temperature correction, where 1 = 0.1° |
Parameter 165 values:
| Value | Function |
|---|---|
| 0 | Celsius |
| 1 | Fahrenheit |
Use the offset only when the measured temperature is different from a trusted reference thermometer.
Humidity settings
| Parameter | Name | Default | Function |
|---|---|---|---|
| 163 | Humidity Threshold | 5 | Defines humidity change needed before a report is sent. |
| 164 | Humidity Offset | 0 | Adds or subtracts value from measured humidity. |
Parameter 163 values:
| Value | Function |
|---|---|
| 1–50 | 1–50% RH report threshold |
Parameter 164 values:
| Value | Function |
|---|---|
| -50 to +50 | Humidity correction, where 1 = 1% RH |
Use the offset only when the measured humidity is different from a trusted reference meter.
7. Common device settings
Common parameters are used for general device behavior.
LED intensity
| Parameter | Name | Default | Function |
|---|---|---|---|
| 105 | LED Signalization Intensity | 100 | Sets the device LED brightness. |
Available values:
| Value | Function |
|---|---|
| 0–100 | LED brightness in percent |
Use this parameter when the device LED is too bright or must be reduced.
Remote reboot
| Parameter | Name | Default | Function |
|---|---|---|---|
| 117 | Remote Device Reboot | 0 | Reboots the device remotely. |
Available values:
| Value | Function |
|---|---|
| 0 | Function inactive |
| 1 | Reboot device |
Use this only when the device must be restarted from the gateway.
Power source selection
| Parameter | Name | Default | Function |
|---|---|---|---|
| 119 | Power Source Selection | 0 | Selects battery or external power source. |
Available values:
| Value | Function |
|---|---|
| 0 | Battery |
| 1 | External power |
Use this only on devices that support more than one power source.
Factory reset
| Parameter | Name | Default | Function |
|---|---|---|---|
| 120 | Factory Reset | 0 | Resets the device to factory settings. |
Available values:
| Value | Function |
|---|---|
| 0 | No action |
| 1 | Factory reset |
Warning: Factory reset removes device settings and should be used only when needed.
8. Alarm action settings - deprecated
These parameters are listed as alarm action parameters and may be removed or not used in newer firmware versions.
Use them only if they are shown and supported by the device firmware.
| Parameter | Name | Default | Function |
|---|---|---|---|
| 91 | Water Alarm | 0 | Defines relay action when a water alarm is received. |
| 92 | Smoke Alarm | 0 | Defines relay action when a smoke alarm is received. |
| 93 | CO Alarm | 0 | Defines relay action when a carbon monoxide alarm is received. |
| 94 | Heat Alarm | 0 | Defines relay action when a heat alarm is received. |
| 99 | General Alarm | Not defined | Defines relay action when a general alarm is received. |
Available values:
| Value | Function |
|---|---|
| 0 | No action |
| 1 | Open relay |
| 2 | Close relay |
Note: These parameters may not be available in newer firmware versions.
9. Serial number parameters
Serial number parameters are read-only. They contain parts of the device serial number and cannot be changed.
| Parameter | Name | Function |
|---|---|---|
| 201 | Serial Number 1 | Read-only serial number data |
| 202 | Serial Number 2 | Read-only serial number data |
| 203 | Serial Number 3 | Read-only serial number data |
These parameters may be hidden under advanced settings in some gateways.
Troubleshooting parameter problems
If a parameter is not visible or does not work, check the following:
Make sure the device supports the parameter.
Make sure the device firmware is up to date.
Check if the gateway supports all Z-Wave configuration parameters.
Re-interview the device from the gateway, if this option is available and the parameters are missing.
Wake up battery-powered devices right after changing parameters.
For battery devices, wait until the device wakes up and receives the new setting.
Exclude and include the device again only if needed.
Important notes
Some parameters are device-specific.
Some parameters are only shown on devices with the needed hardware function.
Shutter parameters are used only for Wave Shutter devices.
Dimmer parameters are used only for Wave Dimmer devices.
Sensor parameters are used only for sensor devices.
Alarm parameters may be removed in newer firmware versions.
Read-only parameters cannot be changed.
Summary
Z-Wave parameters allow the user to change how a Shelly Wave device works.
The most common parameter groups are:
Input settings for wall switches and push buttons
Output settings for relay behavior
Report settings for power and energy reports
Shutter settings for blinds, shutters, and calibration
Dimmer settings for brightness and fade control
Sensor settings for motion, temperature, humidity, and illumination
Common settings for LED brightness, reboot, power source, and factory reset
Only use parameters that are supported by the specific Shelly Wave device and shown by the gateway.