Shelly Beta with Plus/Pro and BLU Support

markus7017 · October 2, 2022, 12:39pm

shellylogo

Shelly Binding for Allterco Shelly devices

The Shelly Binding integrates the Allterco Shelly Devices. It supports

Generation 1 (Shelly 1 etc.)
Shelly Plus series
Shelly Plus Mini series
Shelly Pro series
Shelly BLU series

openHAB 3 users can’t use the Marketplace for installation, see below for instructions

Features

Auto Discovery of connected Shelly devices (Gen 1, Plus/Pro, Plus Mini and BLU series)
Provide a lot of status data (relay status, power meter, sensor values)
Some internal device information like wifi strength or internal device temp
Event trigger, e.g. for pushed buttons
Control functions like relay output on/off
Shelly Manager for device configuration and firmware upgrades
Using a Shelly Plus/Pro as gateway for Shelly BLU devices
Support for Shelly Sensor Adonis

Shelly Manager

The binding has a build in device management - nothing fancy, but helpful. For example it includes a OTA proxy, which allows you to use your openHAB system as proxy between the Internet and the Shelly device when downloading firmware updates. This allows to separate the device completely from the Internet. Support is currently limited to Gen1 devices, because the is currently no Plus/Pro firmware archive.

Click here for an overview.

Open Shelly Manager in the browser, use http://<openHAB IP>/shelly/manager

Documentation

Check the README to get all information how to setup and discover your Shelly devices. It also has detailed information on supported channels.

Also check out additional use cases for Avdanced Users. Happy to receive more feedback and examples you would like to share with the community.

Releases

Click on the link to get release notes.

You need to remove an installed Shelly binding, before installing the beta

openHAB 3 users can’t use the Marketplace for installation, see below for instructions

Release v4.1.0.beta1 · markus7017/openhab-addons · GitHub / 12.08.2023

Contributions

Bugs and Feature Requests can be created here, or post them in the Community Thread.

Feedback is always welcome (do not hesitate to tell if it works !) Share your experiences, creative work or problems in the). Also ideas and contributions are welcome. There is so much you could help with:

Testing with all devices and all setup types
Description of more use cases so others benefit from your work
Maybe some nice widgets for Main UI

openHAB 3, DEV Builds

You need to remove an installed Shelly binding, before installing the beta

OH3 users: You can’t install the binding from within the marketplace

Make sure to read the READMEbeta before installting DEV builds.

Manual installation (CurrentDevelopment Builds - for advanced users only):

open OH console and run “feature:install openhab-transport-coap”
and then copy the binding jar to the adding folder

Downloads

Click on the Install button if you want to get the regular 4.x beta version.

Resources

https://github.com/markus7017/openhab-addons/releases/download/v4.1.0.b1/org.openhab.binding.shelly-4.1.0-SNAPSHOT.jar

Additional Resources

Markus’ myfiles repo
Pending issues (bugs / feature requests)
Shelly Technical Documentation (incl. APIs)
Gen 1Firmware Index | Gen1 Firmware Archive

Pedro_Liberal · October 2, 2022, 12:45pm

Awesome! I don’t have pro/plus devices but I just got 4 Shelly 2.5s for my shutters and your binding will come in handy!
Thank you!

markus7017 · October 2, 2022, 12:47pm

The version included with the official distro already includes full support for Shelly 2.5, this version here mainly has in addition support for Plus/Pro devices, but also bugfixes for Gen 1 devices.
Thanks for using the binding

Moikus · November 21, 2022, 1:56am

Sorry, but I get errors trying to install the binding.
“Installation of add-on marketplace:139554 failed”.
I update/upgraded Openhab and Java to latest version. But the problem remains. After googling a lot, I could not find a solution.

hmerk · November 21, 2022, 6:42am

What errors ? Shall we guess ?

derschlucke · November 21, 2022, 8:12pm

Hi,

same here …

Did install Californium Soap and copied org.openhab.binding.shelly-3.4.0M3-SNAPSHOT.jar to the admins-folder …

But the binding did not appear UI->Things>“+” (no entry to scan for new shelly).

Did I miss something?

Thanks,
Karsten

Moikus · November 22, 2022, 9:55am

@hmerk Thanks for prompt reply.
I wrote the error message in the 2nd line. → “Installation of add-on marketplace:139554 failed”

Sorry but I’m not an advanced user. So give me a hint where I can get more useful information.

BR, Moikus

Moikus · November 22, 2022, 9:56am

And also trying to execute from local memory via terminal is not working.

hmerk · November 22, 2022, 10:24am

This is not supposed to work.

hmerk · November 22, 2022, 10:31am

Did you follow the correct steps ?

First:

open OH console and run “feature:install openhab-transport-coap”

Then download the correct binding .jar to your addons folder.
I guess automatic installation fails cause there are two versions listed.

Moikus · November 22, 2022, 11:03am

Thanks for quick reply. I followed your steps.
Automatic installation failed again. What to do next?
And is it necessary to uninstall standard shelly binding? (I think so^^)
And where can I find the ‘correct steps’?

hmerk · November 22, 2022, 11:20am

Of course, you first need to uninstall the old binding version.

Mark_VG · November 22, 2022, 11:29am

Moikus · November 22, 2022, 11:38am

Dear Mark, thanks also for prompt reply.
I added the following to /addons:

And tried to install via Openhab web frontend
http://openhabian:8080/settings/addons/marketplace:139554

I just saw, I need to upgrade to Milestone3.4.0.M4

hmerk · November 22, 2022, 11:56am

No, you don‘t, there is a version shown working with openHAB 3.3 !

And please, don‘t try to install from marketplace after adding the .jar file to your addons folder. This is not necessary and will produce errors.

You can check if the correct binding is running by entering

bundle:list

on openHAB console.

Jay1401 · November 22, 2022, 4:03pm

Hello everyone, unfortunately I also get an error message when starting the binding.
I think you need to update the Californium packages. After much googling, I can’t find a way to do it.
Is there a guide on how to install the binding?

Moikus · November 22, 2022, 5:03pm

how shall I install the .jar from addons folder?

hmerk · November 22, 2022, 5:15pm

Just drop it there, openHAB will get it automatically. Please keep in mind, those bindings never show up as installed in the UI.

ThomasP · November 27, 2022, 9:46pm

I do experience the same issue “Installation of add-on marketplace:139554 failed” unfortunately In not very experienced and I can’t solve the issue. I am also not able to download the binding https://github.com/markus7017/myfiles/blob/master/marketplace/shelly/org.openhab.binding.shelly-3.4.0M2-SNAPSHOT.jar?raw=true

I hope to get some hints
Thank you in advanced

DivineJimmi · November 29, 2022, 9:05pm

How to install in December 2022:

Connect via PuTTy (or something similar) via SSH to your system. Type in

sudo openhabian-config

Navigate to “40 | openHAB Related” select then " | openHAB Milestone" and let the install finish. After upgrading to your Milestone (currently 3.4.0 M5) type following:

ssh -p 8101 openhab@localhost

“habopen” should be the standard password. Type in:

feature:install openhab-transport-coap

Download the add-on using this link:

https://github.com/markus7017/myfiles/raw/master/shelly/org.openhab.binding.shelly-3.4.0M3-SNAPSHOT.jar

Place it in the add-ons folder.
Typp

sudo systemctl restart openhab.service

wait for the openhab service to restart and start a scan using the Shelly Binding.
Note: You have to uninstall your Shelly-binding beforehand.