Original Plugin for Shelly devices - Intro / Config / Screenshots [No MQTT]

[alexbk66]

My plugins:

AK IKEA AKSquare AKBond AKSonoff AKShelly AKRemootio AKEnphaseEnvoy AKGoogleCast AKGoogleCalendar AKSmartDevice AKHeatmiserNeo AKTracdown

.
.

Shelly 1/Shelly 1PM	Shelly Dimmer	Shelly 2.5	Shelly RGBW2
1 relay switch Power Monitor relay switch	Smallest WiFi-operated immer in the world	2 relay switch and roller shutter controller	12v or 24v RGBW strips up to 288W power
Shelly Gas	Shelly EM	SHELLY 3EM	Shelly Button1
A smart gas sensor that can detect Natural Gas or Liquefied petroleum gas, monitoring your household’s safety	WiFi-operated Energy Meter and Contactor Control	The professional 3-phase energy meter. 2-way consumption: produced and used energy for each phase
Shelly Bulb Duo	Shelly Bulb RGB	Shelly Bulb Vintage	Shelly HT
			Humidity and temperature sensor
Shelly UNI Implant	Shelly i3	Shelly Flood	Shelly Plug/PlugS
Two digital inputs, two relay outputs, 1 ADC input (up to 30V). One Wire sensors.	Sensor with 3 inputs	Leakage detector with built-in temperature sensor

.

Plugin for Shelly automation devices. HS4: https://shop.homeseer.com/products/a...plugin-for-hs4 HS3: https://shop.homeseer.com/products/a...lug-in-for-hs3	Australian official distributor: Oz Smart Things
Shelly is a line of home automation products, very well engineered with very flexible rich configuration options. Every device has: * Embedded Web server, * Wi-Fi control and connectivity, * Commands through HTTP and/or UDP protocol.

Official Shelly Support Resources:

Official Shelly Support Forum:	https://www.shelly-support.eu/lexiko...cBXhqqouPjD14w
Shelly support group (English Version):	https://www.facebook.com/groups/Shel...c_location=ufi
Open a New Ticket:	https://shelly.cloud/support/?fbclid...EegUovZBoQJ2kw

.
Screenshots:
.

...

[alexbk66]

Installation / Configuration

After usual plugin installation procedure the plugin will start scanning for Shelly devices on the WiFi network. Note 1: you must use Shelly mobile app to connect devices to the network first. Note 2: currently Shelly discovery is slow, so you might have to wait for a while for the device to be discovered and corresponding HS devices created. Also I noticed that discovering new device works better if only one device is connected at the time. I'm working with Shelly on fixing these issues. If device discovery doesn't work - the Shelly device can be added and configured IP address manually (Green "+" button).

All Shelly devices are listed at Plugins => AKShelly => MyDevices. Then to go to device config page click on device Name link. Also same can be achieved directly by clicking on Root device link on HS deviceutility page (i.e. BA8F94.SwitchRoot in screenshot in previous post). Note: Main Device configuration webpage is accessible via the "Webpage" link. Note: Shelly2.5 (SHSW-25) device can be used in two modes: 1. "relay" - two independent relay outputs. In this mode the relays are controlled by using Relay.0 and Relay.1 HS devices. The Roller.0 HS device is not used. 2. "roller" - as a roller/shutter controller. In this mode you should use Roller.0 HS device to control Open/Close/Stop states. The Relay.0 and Relay.1 HS devices are not used. Please read Shelly25 user manual about calibrating the device in "roller" mode.

Each device has some device specific settings. Most of Shelly devices have (screenshot above): * Update - how often the plugin polls Shelly state (in seconds) * User/Password - device access credentials if authentication is enabled via mobile app (requires pugin restart) * Default State - after power restart, and * Button Type - how the button input controls the output state

Implemented btn_off_url and btn_on_url (etc.) setting for Shelly switches to trigger immediate plugin status update when switch status changes. This allows to reduce the polling frequency. The URL is generated automatically to use HS JSON interface to force the above Shelly.Control device initiate immediate status polling. Which has some requirements/limitations, i.e. This require HS JSON interface to be enabled in settings (however should be automatically enabled by the plugin) If Password for Local network is enabled - username/password should be also set on the device config page Currently the "Action URLs" are read-only for information only, but may be changed to editable if required

[alexbk66]

Note on Shelly devices with digital inputs (Gen1)

Shelly Gen1 (Not Shelly Plus) devices which have digital inputs (Shelly Button, Shelly IX3, Shelly Uni, Shelly Dimmer, Shelly 1/2.5) require to have controls in HS to receive real time notifications when input state changes.

These controls don't do anything if you click on them, but they are only needed for the Shelly device to report the state change.

To verify if it works - see the end of this post.



You can check the URLs created for these controls for Shelly devices to trigger the state change.

If you click on the link in the device settings - it will display the list of URLs:





To verify if real time notifications work, I suggest to set "Update Rate" in HS device settings to something long, i.e. 60 sec, and toggle the input (i.e. press the button on Shelly Button1). Then you should see the HS device state change.

Without the real time notifications the HS device state will still be updated from the regular status poll (i.e. 5 sec default) - but then you may miss the short status change events, i.e. pressing the button briefly.

[alexbk66]

Version 1.0.0.1 - Added Shelly RGBW2

I added support for Shelly RGBW2 - WiFi-enabled 4-channel 12V/24V LED driver, with up to 288W combined power.

It can control 4 PWM output channels for LED lighting in two modes:

* as a single RGB+W installation; or
* as 4 independently controlled output channels (not implemented, let me know if needed)
.

Version 1.0.0.3 - Added Shelly Humidity & Temperature sensor
Added support for Shelly H&T - Humidity & Temperature sensor with battery life up to 16 months, optional micro UBS power connector. Configuration. Since the Shelly H&T is battery powered - it's normally sleeping. So to connect the device to HS and for configuration it's important to wake the device by pressing the Wake button. Once the device is discovered by HS - you can configure some parameters (see screenshot below) (remember to keep the device awake):
1. Temperature units C/F 2. Temperature threshold - change in temperature which will cause the device to wake up and report to HS (1 - 5 °C) 3. Humidity threshold - change in humidity which will cause the device to wake up and report to HS (0.5 - 50%) 4. Sleep period - time interval to wake up the device and report to HS even if temperature/humidity doesn't change (1-24 hrs, on USB power 10 minutes) Note: the above settings affect balance between battery life and the data availability, i.e. the less the device wakes up - the longer the battery will last, but the data in HS will be less up-to-date. .

[alexbk66]

Ver 3.0.0.57 Added Shelly Button 1

It receives events from the button (Short Push, Double Push, Triple Push, Long Push):



When the event received - after configurable time the state automatically resets - i.e. after 3500 ms in this config:

[Tbinder]

I have just installed your Shelly plugin, but stucked by the plugin won't start. I have tried to reinstall, etc. but nothing seems to work.
am I missing anything?
please see attached screenshot.

[alexbk66]

I have just installed your Shelly plugin, but stucked by the plugin won't start. I have tried to reinstall, etc. but nothing seems to work.
am I missing anything?

I see you have "Developer Mode" already enabled - can you please check if you get any errors in the DOS window. Often it's mostly .NET version mismatch.

[Tbinder]

alexbk66 Absolutely correct - that was it. Thanks.

[alexbk66]

alexbk66 Absolutely correct - that was it. Thanks.

Cool.

[ehinkle27]

I just installed the plugin and running the trial to test before purchasing. How do I manually add a shelly device by IP address if it does not discover it. I have my homeseer controller on a different network than my shelly switches so it will not find anything doing a local discovery. When I click on the config page, I do not see any options to manually add and nothing is shown.

[alexbk66]

How do I manually add a shelly device by IP address if it does not discover it. I have my homeseer controller on a different network than my shelly switches so it will not find anything doing a local discovery.

I have this in my feature request list, nobody asked for it so far.

I will add this feature - like I did in my GooleCast plugin:

[alexbk66]

How do I manually add a shelly device by IP address if it does not discover it.

I implemented the "Add" button, but need more testing - it's 2:00 AM and need to sleep, so will publish new BETA version tomorrow.

[ehinkle27]

okay, I can test if you need, I currently have two different shelly types the older shelly 1 and the shelly 1 with power meter. I also have the shelly 2 but have not installed any yet.

[alexbk66]

okay, I can test if you need, I currently have two different shelly types the older shelly 1 and the shelly 1 with power meter. I also have the shelly 2 but have not installed any yet.

Version 3.0.0.10 (in Beta section) has the ability to add Shelly devices manually. Please see Adding Shelly devices manually (if mDNS discovery fails) for more details.

Let me know how it goes.

[ehinkle27]

Okay, the beta seems to be working was able to manually add a shelly 1 and a shelly1 pm.