Use of the Shelly Wave i4 and i4 DC

Modified on Thu, 20 Mar at 12:47 PM


Shelly Wave i4 and i4 DC devices support various button actions depending on the type of switch connected. While momentary switches (push buttons) are fully compatible, standard toggle switches can be used for binary sensors. Be sure to update your device’s firmware to ensure optimal performance, particularly for toggle switch reactions. This article explains button actions, how they work with momentary switches, and best practices for achieving smooth operation.


Button Actions and Compatibility

Momentary Switch (Push Button) – Recommended

The Wave i4 devices are designed to recognize different button actions when using a momentary switch:

  • Single Press – Send the Command Class Central Scene single press to the gateway. 
  • Double PressSend the Command Class Central Double single press to the gateway. 
  • Long PressSend the Command Class Central Scene Hold to the gateway.
  • ReleaseSend the Command Class Central Scene Release to the gateway .


Toggle Switch setting – used for Binary sensors

While a toggle switch can be physically connected, it does not support advanced actions like long press or release detection. You may get the most of this setting using a binary sensor such as a reed switch.


Firmware Updates for Improved Functionality

If you are using a toggle switch, ensure your device runs the latest firmware. Recent updates improve reaction times and compatibility, making toggle switches more reliable when used for binary sensors.


How the 'Release' Action Works

The 'release' action is triggered specifically with a momentary switch:

  1. Press and hold the button → The device sends a Start_Level_Change command (used for dimming, shutter control, etc.).
  2. Release the button → The device sends a Stop_Level_Change command, stopping the action at the desired level.

This function is essential for applications that require gradual adjustments, such as:

  • Dimming lights
  • Adjusting blinds or shutters
  • Controlling devices with variable intensity

Minimum Press Time Requirement

  • There is no maximum press duration, meaning you can hold the button indefinitely.
  • The minimum press duration is 500 ms, which ensures the system correctly identifies whether the action is a short press or a long press.

Conclusion

For optimal performance, always use momentary switches with Z-Wave devices, as they support advanced button actions like long press and release. While toggle switches can be used, they may not work efficiently. Keeping your firmware updated ensures better responsiveness and improved toggle switch performance.

Best Practice: If you need dimming or shutter control, use a momentary switch to take full advantage of the Start_Level_Change and Stop_Level_Change commands.


Additional Tips:

  • Check your firmware version and update it if necessary.
  • Use momentary switches for applications requiring precise button control.
  • If experiencing issues with a toggle switch, consider replacing it with a compatible momentary switch.