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

Version 1.30:

Added support for additional Gen 2 devices: Shelly Plus RGBW PM, Shelly Pro RGBWW PM, Shelly Pro1PM Dimmer, Shelly Pro2PM Dimmer, and Shelly Pro Dimmer 0/1.

Added support for Gen 3 devices: Shelly 1, Shelly 1PM, Shelly 1 Mini, Shelly 1PM Mini, Shelly 2PM, Shelly DALI Dimmer, Shelly Dimmer, Shelly 0/1 Dimmer, Shelly H&T.

Added support for Gen 4 devices: Shelly 1, Shelly 1 Mini, Shelly 1PM, Shelly 1PM Mini, Shelly 2PM, Shelly Dimmer, Shelly Plug US.

Improved status polling and synchronization for multi-instance devices.

Enhanced variable naming consistency across device generations.

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

Devices are organized by generation. Each generation uses different API protocols and communication methods.

Generation 1 Devices

Switches:

Shelly 1 (SHSW-1)

ShellyPM (SHSW-PM)

ShellyPlug (SHPLG-U1)

ShellyEM (SHEM)

Shelly 2.5 (SHSW-25)

Lighting:

Shelly Vintage (SHVIN-1)

Shelly Duo (SHBDUO-1)

Shelly DUO RGBW (SHCB-1)

Shelly RGBW2 (SHRGBW2)

Inputs:

ShellyDimmer2 (SHDM-2)

Meters:

Shelly H&T (SHHT-1)

Other:

ShellyGas (SHGS-1)

ShellyButton1 (SHBTN-2)

Generation 2 Devices

Switches:

ShellyPlus1 (SNSW-001X15UL, SNSW-001X16EU)

ShellyPlusPM (SNSW-001P15UL, SNSW-001P16EU)

ShellyPlusPlugUS (SNPL-00116US)

ShellyPro1 (SPSW-001XE16EU)

ShellyPro1PM (SPSW-201PE16EU)

ShellyPro2 (SPSW-202XE16EU)

ShellyPro2PM (SPSW-202PE16EU)

ShellyPro3 (SPSW-003XE16EU)

ShellyPro4PM (SPSW-004PE16EU)

Lighting:

Shelly Plus RGBW PM (SNDC-0D4P10WW)

Shelly Pro RGBWW PM (SPDC-0D5PE16EU)

Shelly Pro1PM Dimmer (SPDM-001PE01EU)

Shelly Pro2PM Dimmer (SPDM-002PE01EU)

Shelly Pro Dimmer 0/1 (SPCC-001PE10EU)

Inputs:

ShellyPlusi4 (SNSN-0024X)

ShellyPlusi4DC (SNSN-0D24X)

Meters:

Shelly Plus H&T (SNSN-0013A)

Generation 3 Devices

Switches:

Shelly 1 (S3SW-001X16EU)

Shelly 1 Mini (S3SW-001X8EU)

Shelly 1PM (S3SW-001P16EU)

Shelly 1PM Mini (S3SW-001P8EU)

Shelly 2PM (S3SW-002P16EU)

Lighting:

Shelly Dimmer (S3DM-0A101WWL)

Shelly DALI Dimmer (S3DM-0A1WW)

Shelly 0/1 Dimmer (S3DM-0010WW)

Meters:

Shelly H&T (S3SN-0U12A)

Generation 4 Devices

Switches:

Shelly 1 (S4SW-001X16EU)

Shelly 1 Mini (S4SW-001X8EU)

Shelly 1PM (S4SW-001P16EU)

Shelly 1PM Mini (S4SW-001P8EU)

Shelly 2PM (S4SW-002P16EU)

Shelly Plug US (S4PL-00116US)

Lighting:

Shelly Dimmer (S4DM-0A101WWL)

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):

Generation 1: Shelly 1, ShellyPM, ShellyPlug, ShellyEM, Shelly 2.5, Shelly Vintage, Shelly Duo, Shelly DUO RGBW, Shelly RGBW2, ShellyDimmer2, Shelly H&T, ShellyGas, ShellyButton1

Generation 2: ShellyPlus1, ShellyPlusPM, ShellyPlusPlugUS, ShellyPro1, ShellyPro1PM, ShellyPro2, ShellyPro2PM, ShellyPro3, ShellyPro4PM, Shelly Plus RGBW PM, Shelly Pro RGBWW PM, Shelly Pro1PM Dimmer, Shelly Pro2PM Dimmer, Shelly Pro Dimmer 0/1, ShellyPlusi4, ShellyPlusi4DC, Shelly Plus H&T

Generation 3: Shelly 1, Shelly 1 Mini, Shelly 1PM, Shelly 1PM Mini, Shelly 2PM, Shelly Dimmer, Shelly DALI Dimmer, Shelly 0/1 Dimmer, Shelly H&T

Generation 4: Shelly 1, Shelly 1 Mini, Shelly 1PM, Shelly 1PM Mini

Device FW: Varies by device - most recent releases.

Support Contact

Remote Technologies Inc

Phone Number: +1 952-253-3100

Email: support@rticontrol.com