OH2 Z-Wave refactoring and testing... and SECURITY

I’ve created a test version of the binding here.

You should uninstall the existing Z-Wave binding and manually install this file into the addons folder. It seems that OH comes with the serial bundle installed now so hopefully you shouldn’t need to manage that…

Points to note -:

  • Firstly - use at own risk :wink:
  • You MUST delete your existing things and add them back. Current definitions are not compatible due to a number of breaking changes. You don’t need to re-initialise the network or re-include devices - just delete the things and add back again.
  • If you have included secure devices you need to copy the network key over to the controller (don’t loose the key like I did tonight in all my messing around with deleting things to test the new version - tomorrows job will be to re-include my door lock!).

Any problems, please report here or raise an issue. Database definitions will need to be updated for locks to work as the additional classes will need to be added. My lock is here so you can see the door_lock channel. This will likely need to be added to other locks.

Happy testing ;).


link doesn’t seem to go anywhere

Agreed, link is dead for me too. :frowning:

Link is working (or at least working for me).


Hi, so I’m running a fresh OpenHAB2 2.1.0-SNAPSHOT Build 771 and still can’t figure out how to activate this test Z-Wave binding. I have not installed any Z-Wave Bindings specifically and this is as a said, a brand new install. I add the test z-wave jar to the \addons folder, I can run list from the console and I see the line “9 | Installed | 80 | | ZWave Binding” Now how in the world do I make this Addon Active so it works?!?


On a completely clean installation of OH2 Snapshot (#771), you will get the following error when you try to start the new Z-Wave binding:

openhab> bundle:start org.openhab.binding.zwave
Error executing command: Error executing command on bundles:
	Error starting bundle 208: Could not resolve module: org.openhab.binding.zwave [208]
  Unresolved requirement: Import-Package: gnu.io

To fix this: feature:install openhab-transport-serial and then Z-Wave will start


Sorry - I missed the http off the front of the link - I’ve now updated this.

Maybe it needs to be started? In the past at least, when you dropped bundles into the addons folder they would automatically start so long as all dependencies resolved. So, there’s two options - either you just need to start the bundle (with the start command in Karaf) or you might need to manage the dependencies (ie add the serial library). When I tested this yesterday, the serial library seems to be installed by default, but this might not be correct…

Thanks a ton! Thats exactly what my problem was with all of the versions I think I’ve been trying the last few days. Once I added that feature the Zwave package shows as Active! This is all brand new to me, but I’m highly enjoying the learning experience. Thanks again for all of the quick replies!


1 Like

One point to note - the binding is very ‘chatty’ - ie there’s a LOT of debug information. I will reduce this shortly if the initial testing shows no major issues - for now I’d recommend people are running with debug logging enabled…

1 Like

I can confirm this works with my lock now!!! 914TRL Touchpad Electronic Deadbolt is what it shows up as, but it’s really a Kwikset SmartCode 910. Awesomeness, thanks so much!

1 Like

Cool - thanks for the feedback.

One point to note - I would strongly suggest to use HABmin and not PaperUI when doing a secure inclusion. HABmin will be able to provide information about the success (or not!) of a secure inclusion. It will pop up a box in the top right corner saying if secure inclusion was successful or not…

If you want to use PaperUI, then you probably need to check the logfile, or there should be an attribute that also shows if it was securely included -:

(note that the above isn’t a secure device but it shows the “Using Security” attribute)

1 Like

I’ve done everything I can remotely here from my office, installing the new test binding, removing all devices and then re-adding them. I’m just can’t wake up my lock not being at home yet to test it.

But my lock seems to still show not using security. And this my lock that I previously secure included with OZCP and can control the lock from OZCP. I did also copy my network security key over to the Controller in Habmin.

We only include the security key as XX XX XX, correct? and not as 0xAB, 0xCD, etc? Just the 2 digit numbers separated by a space?

And why on earth would my Kwikset lock show as “Black and Decker” ???

I’d need to check - I think I wrote it to allow both options, but for sure it will work with the 2 digit numbers.

Presumably because that’s who makes it. The manufacturer names come from the ZWave standard.

can anyone walk me through moving the file to a headless linux install from the bash? I have a pine 64 headless openhab.

I operate headless as well. I have Network Sharing enabled on my Unbuntu box to easily access and move files across as needed. And normally log into my Ubuntu OH2 headless from a Windows machine using Bitvise SSH tunnelier. I can do thing from both command line and copy things over.


You should be able to do something like -:

cwd /usr/share/openhab2/addons
wget http://www.cd-jackson.com/downloads/openhab2/org.openhab.binding.zwave-2.1.0-SNAPSHOT.jar

do I delete the jar in the add on folder? how do I make it active?

You need to uninstall the existing zwave binding (as above) - if there was already a JAR in the addon folder, then yes, you need to delete it, but there probably isn’t?

It will install once in the addons folder - assuming the serial driver is installed - see the comments about about that -:

1 Like

there is a KAR file