shelly  

Developer: Karl's Plugins     Like this plugin? Show your appreciation!
Category: Digital/Analog I/O Modules
Github: Github Repo
Assistance: Get help!   
Plugin ID: com.karlwachs.shelly
Latest release: v7.11.25 released on Aug. 19, 2020
Release downloaded: 0 times
Requires: Indigo v7.3.0 or higher
(Check the Releases tab below for older releases that may have different requirements)
  Download latest release

========== This plugin integrates Shelly wifi devices into Indigo. ======================

++ No other software is needed, no special setup on Shellly devices ++

The plugin can read the device status and can send commands to them,
like relay on/off, light on, red=50% ..
As soon as the shelly devices are setup (wifi, pi#) the plugin will be able
to recognize them and add appropriate indigo devices, ready to be used.

== Here the steps for setup

(0)IN THE PLUGIN:
Setup indigo config.. set
- indigoIP#, port used on shelly device to send actions to indigo
- shelly device userid/passwd if enabled
- some other parameter if needed .. use curl or python connect for some older OSX versions use curl

(1) ON THE SHELLY DEVICE
Setup shelly device as defned by the shelly manual:
Using your phone, connect wifi to shellyxxx AP wifi SSID in phone setup
- use browser to connect to 192.168.33.1 (that is a fixed ip#)
- setup your home wifi network parameter (SSID, PWD, IP). I prefer using a fixed IP#
- Restart.
Optional: On regular browser, connect to http://ip# you just set with the phone
upgrade device if available, set device parameters as needed, etc

(2) IN THE PLUGIN:
To add devices or do a refresh
enter IP# / range in menu
"Start Shelly device discovery Process for ONE device" or .. "an IP RANGE"
It will query the IP# (or range) and check for a propper shelly response
When a proper resonse is received, the plugin will add a new Shelly device
if does not already exist

(3) OPTIONAL if needed:
Edit indigo Shelly device to tune parameters eg:
expiration time: after what time w/o message the device goes to "EXPIRED"
polling time: how often should the plugiquerry the device
status column: what to show in the status column (only for sensors)
set relay and input settings eg default at power on, input button behavior etc
IP number: here you can change the IP number of the device if / when it was changed

== How it works:

The plugin is:
(A) listening to any messages from the devices on a tcp port (set in config, default 7987)
the plugin will push action url settings to each shelly device
that causes the shelly device to SEND info to the plugin when anything changes
(B) polling the devices on a regular schedule (1/s .. min., set in dev edit)
- http://ip#/settings gets basic config parameters (dev type, rssi, etc)
- http://ip#/status gets live info eg temp, on/off, RGB, Power ...
(C) switching shelly devices, on/off set light using eg:
- http://ip#/relay/0?turn=on/off sets relay 0 on/off
- http://ip#/color/0?red=200&green=50&blue=30 sets RGB values
etc.
(D) can set parameters on shelly devices (set in indigo device edit), with:
- http://ip#/settings/relay/0?btn_type=toggle set input button to toggle/momentary/.. - http://ip#/settings/light/0?default_state=last set the power-on state to last/on/off
and many other parameters like night mode ... (E) Menu option to get and print shelly-EM(3) emeter time series data to logfile
== REMARKS:
(A) The plugin will detect IP# changes for relay or temp devices automatically,
but not for light bulbs, as they do not send out any updates
you can change the IP# of the device in indigo device edit
(B) You can set a shelly IP# to be ignored, then the plugin will not be updating anything for that device
(C) There are a few utilities: print device info, push config to the shelly devices, mostly used for debugging

== Currently supported devices:
fully tested:
Shelly-1: 12V 110-220V one basic relay
Shelly-1PM: 12V 110-220Vrelay with internal temp sensor ...
Shelly-25 2-Relays: like two Shelly-1PM in one - the plugin creates 2 devices: R1, R2
the second relay will be added as device: hostName-shellyswitch25-child-1
1-ROLLER: it can also be configured as ONE ROLLER device in device edit
during discovery it will inherit the current mode (relay/roller)
but it can also be re-defined to relay-roller-relay in device edit
Shelly-EM Power 2 Ch. - 1 Relay: 110-220V measures Power, volt, has 1 relay - the plugin creates 3 devices: R + EM1 + EM2
the EM devices will be added as device: hostName-shellyem-child-1/2
Shelly Duo 110-220V LED light bulb w color temperature
Shelly-RGBW Light Bulb: 110-220V LED light bulb with 4 led (RGBW)
Shelly-RGBW dimmer: 110-220V 4 led dimmer (PWM) for RGBW
Shelly-Dimmer: 110-220V dimmer
Shelly-1 Temp-Hum: battery / usb powered Temp. and Hum. sensor
Shelly-Flood-Temp: Flood alarm and Temperature sensor
Shelly- ext. oneWire Temp sensor: External addon for Shelly-1 -1PM for up to 3 oneWire Temp sensors
the sensors will be added as devices: hostName-ext_temperature-# (1,2,3)
Shelly- ext. DHT22 sensor: External addon for Shelly-1 -1PM for 1 DHT22 T&H sensor
the sensor will be added as devices: hostName-ext_temperature-1 and hostName-ext_humidity-1
Shelly Door Window Door/window open(when dark or light) / close alarm. Lux and vibration measuremnt
Shelly Plug power outlets w relay and power measurement
Shelly PlugS power outlets w relay and power and energy measurement
programmed, but not tested:
Shelly-EM3 Power 3 Ch. - 1 Relay: 110-220V measures Power, volt, has 1 relay - the plugin creates 4 devices: R + EM1 + EM2 + EM3
the 3 EM will be added as device: hostName-sheleeyEM3-child-1/2
Shelly-PRO4, 4 relay: 220V measures Power, volt, the plugin creates 4 relay devices
the 2-4 relays will be added as device: hostName-shellypro-child-# (1/2/3)
Shelly-Vintage Bulb: 110-220V LED light bulb vintage style

=========================================================================================

Release details
Released on: Aug. 19, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. reconfigured RBG devices to allow for rgbw rgb .. white +T modus
  2. now supports change brightness from iphone screen, only SetColorLevels was supported now also SetBrightness is that is used buy iphone interface
Release details
Released on: Aug. 18, 2020
Requires: Indigo v7.3.0+
Downloaded: 1 times 
Changes in this release

fixed error Line 1514 has error=‘key rgbSetup n...

Release details
Released on: Aug. 16, 2020
Requires: Indigo v7.3.0+
Downloaded: 1 times 
Changes in this release
  1. reconfigured RBG devices to allow for rgbw rgb .. white +T modus
  2. now supports change brightness from iphone screen, only SetColorLevels was supported now also SetBrightness is that is used buy ophone interface
Release details
Released on: Aug. 6, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added shelly i3 device
  2. added dev states cloud = connetced / local ipv4_method = dhcp / static
  3. for button1 and i3: event type in status field: lastEv#:n-Type: s / ss / sss / L/ SL / LS (short .. long press)
Release details
Released on: Aug. 5, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

added shelly GAS button1 device

Release details
Released on: Aug. 4, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added shelly GAS device final fully supported (volume, alarm triggers, mute ..) has option to set alarm levels, polls the device every 15 secs, if gas concentraion > 0 start sensor caliobration of not calibrated
  2. added event_count to shelly -1, pm1, 2.5
  3. added state ipv4_mode (static/dhcp..)
  4. added state cloud_enabled
Release details
Released on: July 30, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

added shelly GAS device, beta version

Release details
Released on: July 29, 2020
Requires: Indigo v7.3.0+
Downloaded: 3 times 
Changes in this release

added shelly GAS device, beta version

Release details
Released on: July 29, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

added shelly GAS device, beta version

Release details
Released on: May 29, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

fixed XML tag error ( had a space after id name)

Release details
Released on: May 23, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

fixed toggle always send off

Release details
Released on: May 13, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

tested shelld DW and plug and plugs, added all states and action for these devices

Release details
Released on: April 21, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added device edit option to set shelly-2.5 as 2 relay devices or one roller device w open/ close functions as an indigo dimmer
Release details
Released on: April 18, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added option for RGBW2 device setup as
    • RGB and White CHannle
    • RGB only
    • White only channel
Release details
Released on: April 4, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

various small fixes and improvements

Release details
Released on: April 2, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

Added features / changes in v7.5.10 @ 2020-04-01

  1. added input_short state in addition to input_long (press) to all devices with a button(s) that offer this feature eg shelly-1 -pm1 -25 -...
  2. added check if name of to be created device exist if already exists: and add a random number to the name to be able to create dev
  3. added state energy_counter (watt minutes for the last minutes) for relay and dimmers
  4. added option to print shelly device emeter time series data to logfile, looks like: Date/time UTC,Active energy Wh,Returned energy Wh,Min V,Max V 2020-03-18 00:00,0.0,0.9,119.5,121.0 2020-03-18 00:05,0.0,0.9,119.5,121.0 ...
Release details
Released on: April 2, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added input_short state in addition to input_long (press) to all devices with a button(s) that offer this feature eg shelly-1 -pm1 -25 -...
  2. added check if name of to be created device exist if already exists: and add a random number to the name to be able to create dev
  3. added state energy_counter (watt minutes for the last minutes) for relay and dimmers
  4. added option to print shelly device emeter time series data to logfile, looks like: Date/time UTC,Active energy Wh,Returned energy Wh,Min V,Max V 2020-03-18 00:00,0.0,0.9,119.5,121.0 2020-03-18 00:05,0.0,0.9,119.5,121.0 ...
Release details
Released on: March 30, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

changed name of pluginID to shellyDirect

Release details
Released on: March 30, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

added logging in deviceStartComm for error in dev type

Release details
Released on: March 30, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release

added last and previous flood time states for shelly-WT sensor

Release details
Released on: March 30, 2020
Requires: Indigo v7.3.0+
Changes in this release
  1. displays DHT22 external attachment sensors properly now, as 2 indigo devuices T & H
  2. supports SHELLY-PRO4 now, programmed, not tested
  3. various little device state display improvemnts
  4. temp and humidity from the shell-TH device are now 2 indigo devcies
Release details
Released on: March 21, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added several device types - see help
  2. EM device is now 3 indigo devices relay, EM1 EM2
  3. added various utilities: reports, settings
  4. some bug fixes
  5. adoption of the Shelly devices into indigo is now fully automatic,
    only ip# (userid&passwd if set) are needed no action setting on the Shelly device need, the plugin does that
  6. Shelly devices with inputs and relays now can be configured in device edit
    like button behaviour (toggel, edge ..), power on option (off/on/last/..) etc
  7. print of Shelly dev info is expanded and can be select from 1 or all devices
  8. added state input_long = date-stamp for long presses, send only by action state input (_1/2) are now on/off
  9. added support for door-window, should work but not tested
  10. added option to igore devices (un) ignore ip# in menu
Release details
Released on: March 9, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. added support for shelly lightbulb DUO
  2. several smaller issues fixed (menus ...)
  3. changed Temerature schema:
  4. internal now Temperature_internal
  5. external temp: Temperature / Temperature_1 / Temperature_2
  6. reload time now ~ 2secs, down from ~12secs
  7. when devices expire = no message for time > x:( set in device edit ) image in status column goes to grey
  8. added self test for HTTP listener (send message to 127.0.0.1:port#/test)
  9. the plugin now automatically recognizes the temp unit from each shelly device
  10. fixed the device states should NOT be logged
  11. added print help to logfile
Release details
Released on: March 5, 2020
Requires: Indigo v7.3.0+
Downloaded: 0 times 
Changes in this release
  1. fixed some spelling and menu texts
  2. fixed min/max temp states for external temperatures
Release details
Released on: March 5, 2020
Requires: Indigo v7.3.0+
Downloaded: 1 times 
Changes in this release

initial release