Shelly Beta with Plus/Pro and BLU Support

[markus7017 (Markus Michels)]

Shelly Binding for Allterco Shelly devices

The Shelly Binding integrates the Allterco Shelly Devices. It supports

• Generation 1 (Shelly 1 etc.)
• Shelly Plus series (Gen 2+3)
• Shelly Plus Mini series (Gen 2+3)
• Shelly Pro series (Gen 2+3)
• Shelly BLU series

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
• Range Extender Mode with Plus/Pro
• Support for Shelly Sensor Aden

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 is now longer supported, 4.1 and 4.2 are outdated

Check here for known issues.

---

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

DEV Builds

---

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

---

Make sure to read the READMEbeta before installting DEV builds.

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

1. open OH console and run “feature:install openhab-transport-coap”
2. 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.

• 4.3.0-DEV Gen1/Plus/Pro
• 4.2.0-DEV Gen1/Plus/Pro (outdated)
• 4.1.0-DEV Gen1/Plus/Pro (outdated)
• 3.4.5-DEV Gen1/Plus/Pro (outdated)

Resources

https://github.com/markus7017/openhab-addons/releases/download/v4.3.0b1/org.openhab.binding.shelly-4.3.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]

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 (Markus Michels)]

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 (Marcus)]

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 (Hans-Jörg Merk)]

What errors ? Shall we guess ?

[derschlucke (Karsten)]

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 (Marcus)]

@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 (Marcus)]

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

[hmerk (Hans-Jörg Merk)]

@Moikus

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

This is not supposed to work.

[hmerk (Hans-Jörg Merk)]

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 (Marcus)]

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 (Hans-Jörg Merk)]

@Moikus

And is it necessary to uninstall standard shelly binding? (I think so^^)

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

[Mark_VG (Mark)]

@Moikus

And where can I find the ‘correct steps’?

Shelly Binding

so, install the DEV build remove binding from UI run „feature:install openhab-transport-coap“ from OH console copy the M3 jar from my myfiles repo into the addons folder The PR is created, I expect the fix to go into M5

[Moikus (Marcus)]

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 (Hans-Jörg Merk)]

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 (Jürgen)]

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 (Marcus)]

how shall I install the .jar from addons folder?

[hmerk (Hans-Jörg Merk)]

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

[ThomasP (Thomas)]

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]

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.