Plugwise binding

wborn · February 17, 2017, 10:33pm

Today I’ve submitted PR #1907 which adds a native openHAB 2 Plugwise binding (see also issue #1835).

Almost all of the original OH1 behavior is still there, as well as the following new OH2 specific functionality:

Device discovery
Device configuration parameters
Configurable channel update intervals using channel configurations
Proper online, offline Thing status behavior
The Stick is implemented as a Bridge, which allows for using multiple Sticks at the same time
i18n support with English and Dutch translations
Properties that include device hardware and firmware versions

If you want to help testing it, proceed as follows:

Stop any installed OH1 Plugwise binding (e.g. by uninstalling it, or stopping it at the openHAB console)
Install the “Serial Binding” when it is not installed (via Paper UI, Addons, Bindings)
Download the new OH2 Plugwise binding: org.openhab.binding.plugwise-2.1.0-SNAPSHOT.jar
Add this binding JAR file to your openHAB addons directory
Open Paper UI and navigate to the “Inbox” page
Click on the “+” button to add a new Thing
Choose to add a “Plugwise Binding” Thing
Choose to add a “Plugwise Stick” Thing
Update the “Serial port” configuration parameter (if necessary)
Finally click the “Add” check mark to add the Stick

This should start the automatic Thing discovery and your Plugwise devices should now automatically appear in the “Inbox”.

For more information, see also the updated binding documentation.

wborn · February 17, 2017, 10:38pm

@gert_konemann, @j.hoekstra, @frederic, @Awacs2000
Perhaps you may also be interested in testing the new native openHAB 2 Plugwise binding?

gert_konemann · February 17, 2017, 11:21pm

Yes, I am interested, but have not much time. So it can take some time
before you gey my feedback.

Gert Könemann.

Op 17 feb. 2017 11:43 p.m. schreef “Wouter Born” <bot@community.openhab.org

wborn · February 17, 2017, 11:24pm

Thanks Gert! Any feedback at any moment in time is welcome.

Max1968 · February 18, 2017, 7:56am

i’ll give it a try too… I have about 25 of those plugs, but were having issues in the past, so replaced them with Fibaro plugs… And just recently i was thinking to buy more Fibaros and finally sell those plugwise ones which I have lying here for abut a year now, but perhaps your binding works better for me than the OH1 one I’m not sure yet i will stick with them even if it works, as meanwhile i have a huge zwave network and also plenty of hue stuff, and it might be more reasonable to extend these then add yet another network. Too sad plugwise cant be convinced to make their devices “real” zigbee with a firmware update…

In your original collection of ideas i read you also want to be able to retrieve historic data, is that working already ?

wborn · February 18, 2017, 9:42am

I once also thought about replacing all the Plugwise hardware for an easy fix. The Fibaro plugs are a good alternative and they are a bit more compact too. However, I took up the software challenge and it now works pretty well for me.

With a good stable OH2 binding they will be worth more.

It seems they are busy with targeting regular consumers and not the Home Automation community. Product diversification with air conditioning and smart thermostats seems also on top of their list. Their older portfolio seems to suffer from this. IIRC the Circles were introduced in a time where Zigbee was all the hype and only a handful of ZWave products existed. I can imagine a lot of their code needs to be rewritten would they ever switch protocols.

Only the last hour energy value is currently retrieved from the historic data entries (like in the OH1 binding). It’s an easy code change to retrieve all available log entries and dump them to something like a CSV file. I use it this way myself for validation and retrieving entries I’ve missed when my openHAB instance was down for some reason.

Using a CSV file or creating a mechanism to retrieve the data via channels is not the most elegant solution. So I’ll be looking into if it can be done by implementing a persistence service.

j.hoekstra · February 18, 2017, 9:46pm

Surely interested!
I was planning how to move to the OH2 style of defining things, this will certainly help.
I really like to thank you for the plugin, it makes these plugs really worthwhile (they’ve been super reliable and been doing their job for years).

I’ll report back in the next week or so.

wborn · February 19, 2017, 8:56am

That would be great!

Perhaps @bryeng and @frederic also want to help testing the new openHAB 2 native Plugwise binding?

Max1968 · February 25, 2017, 4:07pm

I just tried to install the binding, but stuck it seems.

I downloaded the jar file, moved it to the addons folder, changed ownership to openhab:openhab and permissions to 644. After a restart of openhab (before I didnt see anything in the logs i think) I get the following:

2017-02-25 17:05:05.766 [ERROR] [org.openhab.binding.plugwise        ] - FrameworkEvent ERROR - org.openhab.binding.plugwise
org.osgi.framework.BundleException: Could not resolve module: org.openhab.binding.plugwise [215]
  Unresolved requirement: Import-Package: gnu.io

        at org.eclipse.osgi.container.Module.start(Module.java:434)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1582)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1561)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.doContainerStartLevel(ModuleContainer.java:1533)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1476)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:230)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]
        at org.eclipse.osgi.framework.eventmgr.EventManager$EventThread.run(EventManager.java:340)[org.eclipse.osgi-3.10.101.v20150820-1432.jar:]

Max1968 · February 25, 2017, 5:46pm

added the zwave binding as well, this solved this dependency… so far the binding is working fine, but i’m not sure yet if and how i will continue to use my plugwise devices…

Max1968 · February 25, 2017, 5:54pm

@wborn from the binding description, what exactly does this mean:

Furthermore the following openHAB 2 functionality has been added:

The Stick is implemented as a Bridge, which allows for using multiple Sticks at the same time

wborn · February 25, 2017, 6:12pm

Thanks for helping out with testing @Max1968.

The Plugwise Binding also needs to have the Serial Binding installed which provides ‘gnu.io’. So that is what caused the exception. The Z-Wave Binding probably also depends on it, so that is why it got fixed. I’ll add it to the opening post.

In the OH1 binding you could only use one Plugwise Stick (and Plugwise ZigBee network). You could also configure only one serial port. Because in the OH2 binding the Stick is implemented as a Bridge Thing, you can connect multiple Plugwise Sticks to your computer and use them all at the same time. I don’t think there will be many users of this functionality though.

Nixo76 · February 26, 2017, 10:01am

hey,

great work with the add-on. I’ve a still a problem to get it running.
I use openhab on a raspberry pi 2 with the zwavemee adapter at the io pins. when i add the plugwise stick as a thing the system told me that /dev/ttyUSB0 is not available, but /dev/ttyAMA0 (which is the zwave adapter): Serial port ‘/dev/ttyUSB0’ could not be found. Available ports are: /dev/ttyAMA0

i’ve installed the serial binding but without success. Do you have any idea what i can test now?

wborn · February 26, 2017, 10:18am

@Nixo76
Did you also follow the Linux specific instructions in the binding documentation?

Does lsusb show the Stick? The following device in the command output shows that the Stick is detected:

Bus 001 Device 004: ID 0403:6001 Future Technology Devices International, Ltd FT232 USB-Serial (UART) IC

Does the standard (OH1) Plugwise Binding work for you? You might need to uninstall it when it is already activated. This is part of Step 1. of the opening post.

When I first started using a Raspberry Pi it only detected the Stick after a restart.

Nixo76 · February 26, 2017, 10:53am

Thanks for the fast response!
I’ve found a solution!

i had to extend the java_opts. there was only the AMA0 so i have to add the USB0 as well:

edit nano /usr/share/openhab2/start.sh
export EXTRA_JAVA_OPTS=-Dgnu.io.rxtx.SerialPorts=/dev/ttyAMA0:/dev/ttyUSB0

edit:
everything seems to work now! great work!

Ruben · February 26, 2017, 6:26pm

I am loving this, i had a few of these.
Never used them until now, i installed like the description. working perfectly so far!

wborn · February 26, 2017, 7:39pm

Thanks for the positive feedback @Nixo76, @Ruben! It’s nice to know things also work well with others.

Ruben · February 26, 2017, 9:01pm

I have 2 starter kits, one seems to work fine, but when i take a circle from the second kit and add it to the network it does not seem to be detected. If i enter it manually it does not show online either, any ideas? i did notice when i added the MAC manually it shows only the last few digits in the overview, maybe its a bug or maybe it does not mean anything i dont know.

wborn · February 26, 2017, 11:05pm

When Circles were already part of a network (the starterkit) you might need to be reset them before you can add them to another network (the other starterkit).