Shelly

Shelly | IP Only | Version 1.20

Introduction & Manufacturer Profile

Shelly is dedicated to providing innovative products and solutions. Award-winning Shelly brand products offer intelligent, flexible and powerful IoT applications for virtually any electrical system or circuit. Shelly combines open APIs and compatibility with virtually any SCADA, building management, hub, or open platform.

Version History

Version 1.0: Initial Beta Release

Version 1.01:

– Support Added for Gen1 Shelly Plug: Gen1 Shelly Plug devices are now fully supported.

– On/Off Variable Fixes for Gen1 Devices: Resolved issues with On/Off variables that were incorrect due to updates affecting commands for generations beyond Gen2.

– Configured Device Names: Devices now display names configured in the web GUI. Note that this name is set only through the web interface, not the Shelly app. Due to API limitations, only this web-configured name is retrievable. Gen1 devices cannot be named via the web GUI, while Gen2/3 devices may have naming options depending on the model. For devices without a configured name, or if no name is set, the device name is automatically generated in the format: MODEL - MAC (last 2 pairs) for easier identification.

Version 1.10:

– Support for I4/I4DC event notifications. I4 Devices now processed separately, and instances of the Input component can send notifications for the following events: single_push, double_push, triple_push, long_push.

Version 1.11:

– Increased heartbeat count for detecting device disconnection, enhancing overall stability.

Version 1.12:

– Included additional model numbers for ShellyPlus1, ShellyPlusPM, I4DC.

Version 1.13:

– Added event handling logic for distinct inputs on I4 Devices, rather than the only device itself.

– Modified how mac addresses are handled when a command is sent from the Shelly app to support feedback.

Version 1.14:

– Added support for Gen 3 H&T.

– Added variables/functions for RGBW2 switch white level. (Color mode only supported).

– Added variables/functions for RGBW2 lighting effects.

Version 1.20: Official Release

Driver Features

This driver allows for control over Lighting, Switches, Inputs, and other peripherals found in the product list below. It utilizes mDNS to easily pull the connected devices into Integration Designer, giving the programmer easy access to add whatever devices are needed to be controlled via RTI. This driver includes commands to set levels and turn switches/lights/inputs and other devices on and off.

The Driver Sync button runs the routines that are called as new sources are added to the project. You should not need to use this button but occasionally ID may not refresh the listed commands or variables. In this case pressing this button causes those routines to be run again.

Supported Devices

Switches - Shelly 1, ShellyPM, ShellyPlus1, ShellyPlusPM, ShellyPlug/ShellyPlusPlugUS, ShellyPro1, ShellyPro1PM, ShellyPro2, ShellyPro2PM, ShellyPro3, ShellyPro4pm, ShellyEM, Shelly 2.5, Shelly RGBW2, Shelly 1 Mini, Shelly 1PM Mini, Shelly PM Mini

Lighting - Shelly Vintage, Shelly Duo, Shelly DUO RGBW, Shelly DUO RGBW (Mini)

Inputs - ShellyPlusi4, ShellyPlusi4DC, ShellyDimmer2

Meters - Shelly H&T, Shelly Plus H&T, Shelly Gen 3 H&T

Other - ShellyGas, ShellyButton1

After mDNS discovery in ID, the following devices will show up under the following names:

Shelly 1 - SHSW-1

ShellyPM - SHSW-PM

ShellyPlus1 - SNSW-001X15UL OR SNSW-001X16EU

ShellyPlusPM - SNSW-001P15UL OR SNSW-001P16EU

ShellyPlug - SHPLG-U1

ShellyPlusPlugUS - SNPL-00116US

Shelly Vintage - SHVIN-1

Shelly Duo - SHBDUO-1

Shelly DUO RGBW - SHCB-1

ShellyPlusi4 - SNSN-0024X

ShellyPlusi4DC - SNSN-0D24X

ShellyDimmer2 - SHDM-2

ShellyPro1 - SPSW-001XE16EU

ShellyPro1PM - SPSW-201PE16EU

ShellyPro2 - SPSW-202XE16EU

ShellyPro2PM - SPSW-202PE16EU

ShellyPro3 - SPSW-003XE16EU

ShellyPro4PM - SPSW-004PE16EU

ShellyButton1 - SHBTN-2

Shelly H&T - SHHT-1

Shelly Plus H&T - SNSN-0013A

Shelly H&T Gen 3 - S3SN-0U12A

Shelly Gas - SHGS-1

ShellyEM - SHEM

Shelly 2.5 - SHSW-25

Shelly RGBW2 - SHRGBW2

Shelly 1 Mini - S3SW-001X8EU

Shelly 1 PM Mini - S3SW-001P8EU

Shelly PM Mini - S3PM-001PCEU16

Limitations

Does not currently support any devices not listed.

The Shelly H&T - Functions similarily to the H&T Plus. Can wake it up manually and get it to connect/reconnect. When the user button is pressed, the device switches to a setup mode - it will remain turned on for 3 minutes, allowing configuration over the web interface. Another short button press will put it back to sleep. These devices will only be connected when it has been woken up and will not constantly stay connected.

The Shelly Button - Experiences the same issues as the H&T series regarding sleep functionality, although this device can be plugged in via usb-c to keep it connected to the network.

The SHEM - Status/Relay commands will not send unless the device is in switch mode rather than roller mode. Sending these commands in the wrong mode will result in a 404 response;

The SHRGBW2 RGBW adjustments are only supported in color mode.

System Requirements & Prerequisites

RTI System Requirements

Integration Designer: 11.5

XP FW: 23.5.11

Driver Configuration

Shelly devices tend to ship with an array of different software/firmware versions. Not all of these software versions will allow the device to broadcast a signal to mDNS for discovery. Devices must all be upgraded to the most recent firmware version before proper connection will work. Firmware updates are not currently completable from the default device web interface (192.168.33.1) when the device is powered on and it is broadcasting a network.

The Shelly mobile application will need to be downloaded, and the device will have to be hooked to an existing test network with a user assigned static IP via your browser at 192.168.33.1 for each device broadcast network. Each device will have to be connected and linked to the app in order to update the firmware. Getting the device to properly appear on the network when trying to upgrade can take some time, but when all devices are added to the app and updated, proper connection with the driver should be possible provided all devices are on the correct network and broadcasting as expected.

Connect To The Shelly System

As previously noted, it is necessary to connect to each device using the mobile app and update each unit's firmware in order to have the devices broadcast an appropriate signal for mDNS. When each device has been updated and assigned an appropriate static IP on the test network, they can be detected via mDNS when loading the driver into ID. The scan can take up to two full minutes, during which time other functions in Integration Designer will be inaccessible.

These devices can be tricky and not every scan pulls all devices 100% of the time. Sometimes multiple mDNS scans may be needed, or a restart of your PC to reset the mDNS broadcasts being seen. This is a limitation of mDNS and the broadcasting capability of the Shelly devices themselves.

After mDNS detection, returning to the Drivers tab of the Add Workspace Item, the driver should now be listed under the 'Add To Existing Driver', and should contain each of the devices you have discovered via mDNS. These devices will be removed from this list as they are added to the file. As you add sources to the workspace functions, variables, and events for the sources will show up within Integration Designer.

Limitations

Does not currently support any devices not listed.

The Shelly H&T - Functions similarily to the H&T Plus. Can wake it up manually and get it to connect/reconnect. When the user button is pressed, the device switches to a setup mode - it will remain turned on for 3 minutes, allowing configuration over the web interface. Another short button press will put it back to sleep. These devices will only be connected when it has been woken up and will not constantly stay connected.

The Shelly Button - Experiences the same issues as the H&T series regarding sleep functionality, although this device can be plugged in via usb-c to keep it connected to the network.

System Testing

Integration Designer: 11.5

XP Processor Model: XP-6s

XP Processor Firmware: 23.5.11

Device Model(s): Switches - Shelly 1, ShellyPM, ShellyPlus1, ShellyPlusPM, ShellyPlug/ShellyPlugUS, ShellyPro1, ShellyPro1PM, ShellyPro2, ShellyPro2PM, ShellyPro3, ShellyPro4pm, ShellyEM, Shelly 2.5, Shelly RGBW2 Lighting - Shelly Vintage, Shelly Duo, Shelly DUO RGBW, Shelly DUO RGBW (Mini) Inputs - ShellyPlusi4, ShellyPlusi4DC, ShellyDimmer2 Meters - Shelly H&T, Shelly Plus H&T Other - ShellyGas, ShellyButton1

Device FW: Varies by device - most recent releases.

Support Contact

Remote Technologies Inc

Phone Number: +1 952-253-3100

Email: support@rticontrol.com