The 2.5 release version of the binding does no longer include the Californium libs. Those libraries are required to implement the CoIoT / Coap protocol. Those need to be installed on pre-2.5 final installations. openHAB 2.4 is still supported (at the moment), but 2.4 and 2.5 pre-releases require the installation of Gson 2.8.5 and the Californium libs.
At the moment I have 3 build locations
- The official openHAB 2.5 install package providing the released version when installing with PaperUI
- The official 2.5 SNAPSHOT build. Please be aware of limited stability.
- My private 2.5 DEV build. This is the latest build, could be instable. Once initial testing has been done I checkin to the SNAPSHOT repo.
I’m waiting on the information how the official path going forward will be. At the moment it looks like having
- one repo/branch for openHAB 3.0 and
- one branch for 2.5 updates (backports from 3.0)
This will allow to provide fixes and enhancements for the time given until openHAB 3.0 becomes available (at least stable milestone builds).
I will cleanup the interims status once the path forward has been clarified.
If you want to use the version released with openHAB 2.5 final
- The final release could be installed as usual using PaperUI:Addons:Bindings:Shelly
- This version works fine. However, in between some bugs (e.g. LOW_BATTERY alarm for sensor devices, input channels for Dimmers) has been fixed and new features are implemented (e.g. German translation). If you want to get access to these you need to switch to the dev/snapshot build - see below:
If you want to use the SNAPSHOT/DEV build you can NOT install this using PaperUI. Make sure that the release version is not installed. You can NOT run the SNAPSHOT on top of the version you install with PaperUI.
Beta users, which want to use the latest 2.5 DEV/SNAPSHOT builds:
you need to remove the old installation. Some of the channels have been renamed etc.
To be on the safe side
- delete all Shelly Things from your system
- stop openHAB, wait a minute
- delete the binding jar from the addons folder
- run “openhab-cli clean-cache”
- cleanout the JSON DB so that there are NO remaining shelly entries
DEV/SNAPSHOT users, which want to use the latest 2.5 DEV/SNAPSHOT builds:
- Stop openHAB and wait a minute
- Run “bundle:list | grep Gson” on the openHAB console and check if Gson 2.8.5 (or newer) is installed (sometimes version 2.7 is installed, which doesn’t solve the dependencies).
If not: Download the gson from http://central.maven.org/maven2/com/google/code/gson/gson/2.8.5/gson-2.8.5.jar
and copy the jar to the OH addons folder - Now install the Californium libs
Run “bundle:list | grep Californium” and check if the libs are already installed (e.g. when the Tradfi binding 2.5 is also installed), otherwise
Download https://repo1.maven.org/maven2/org/eclipse/californium/californium-core/2.0.0/californium-core-2.0.0.jar and copy to addons folder
Download https://repo1.maven.org/maven2/org/eclipse/californium/element-connector/2.0.0/element-connector-2.0.0.jar and copy to addons folder
Install DEV/SNAPSHOT build of the binding
- Perform the above mentioned installation steps.
- If you want to use the official SNAPSHOT release
download https://openhab.jfrog.io/openhab/libs-pullrequest-local/org/openhab/addons/bundles/org.openhab.binding.shelly/2.5.0-SNAPSHOT/org.openhab.binding.shelly-2.5.0-SNAPSHOT.jar
OR
If you want to use the latest DEV version download https://github.com/markus7017/myfiles/blob/master/org.openhab.binding.shelly-2.5.0-SNAPSHOT.jar?raw=true
Usually the DEV version is newer than the SNAPSHOT release from the above link. - Copy the downloaded jar into openHAB’s addons folder.
- Start openHAB and wait until it is fully initialized
If everything was install correct a “bundle:list” output show be similar to this:
245 │ Installed │ 80 │ 2.8.5 │ Gson
246 │ Installed │ 80 │ 2.0.0 │ Californium (Cf) Core
247 │ Installed │ 80 │ 2.0.0 │ Californium (Cf) Element Connector
248 │ Installed │ 80 │ 2.5.0.201912112158 │ openHAB Add-ons :: Bundles :: Shelly Binding
Please let me know if you have problems installing the new build or this doc can be improved.
This information could also be found in READMEbeta.md