openHAB 3.0 - install and setup of Z-Wave devices

I am not an openHAB expert, far from it; the objective of this tutorial is to share with you my experiments. If it can be of use to other people, so much the better!

A few months ago I had already carried out several tests to integrate Z-Wave devices into openHAB. At that time it was openHAB 2.x. With the arrival of openHAB 3.0, rather than doing a migration, I decided to start from scratch and take the opportunity to write a step-by-step configuration procedure.

For information, here is my configuration for this tutorial. Using BerryBoot doesn’t change anything; it just allows me to have multiple OS on my Raspberry.

  • Raspberry Pi 3 B+ running openHABian 1.6.1
  • BerryBoot 2.0 to boot different OS installed on an external USB hard drive
  • openHAB 3.0 installed via openhabian-config
  • USB Z-Wave controller → Aeotec Z-Wave Z-Stick, Gen5 Z-Wave Plus - ZW090
  • Z-Wave sensor → FIBARO System FGMS001-ZW5 Motion Sensor+

All steps were carried out via the openHAB3 graphical interface.


Z-Wave controller setup

We must first connect under openHAB as administrator to have access to the configuration menus.

  • install the Z-Wave binding in openHAB3: SettingsBindingsBlue « + »Z-Wave BindingInstall
  • create a thing representing the Z-Wave controller: SettingsBindingsBlue « + »Z-Wave BindingZ-Wave Serial Controller
    • Label = Aeotec Z-Stick, Gen5 Z-Wave
    • Port Configuration → Serial Port /dev/ttyACM0
    • click Create Thing to commit
    • the Bridge Thing will appear in your list of Things; after a couple of seconds, it will appear as ONLINE.

New Z-Wave Serial Controller
New Z-Wave Serial Controller

Aeotec Z-Stick, Gen5 Z-Wave
Aeotec Z-Stick, Gen5 Z-Wave


Z-Wave sensor setup

After waking up the Fibaro Motion Sensor, there is a notification (red button) in the Inbox of the Thing that we have just created for the controller. Click on it to see the Motion Sensor appear. Click on it and add it as Thing.

Motion Sensor
Motion Sensor

Motion Sensor, Add as Thing
Motion Sensor, Add as Thing

Motion Sensor, Add as Thing 2
Motion Sensor, Add as Thing 2

The Motion Sensor appears in your list of Things.

Motion Sensor, Thing
Motion Sensor, Thing

You can then access all of its configuration parameters as well as its Channels.

Motion Sensor, Setup
Motion Sensor, Setup

Motion Sensor, Channels
Motion Sensor, Channels


Create an item for a specific channel

Select a Channel, for example Sensor (temperature), then Add Link to Item. We choose to create a new Item (Create a new Item) that we will call Fibaro Motion Sensor (temperature). We validate by clicking on Link.

Motion Sensor temperature 1
Motion Sensor temperature 1

This new Item appears in the list of Channels of the Thing corresponding to the Motion Sensor.

Motion Sensor temperature 2
Motion Sensor temperature 2

After a few moments the value of this Item is updated.

Motion Sensor temperature 3
Motion Sensor temperature 3

Motion Sensor temperature 4
Motion Sensor temperature 4

The Motion Sensor temperature item then appears in the Items list.

Motion Sensor, item temperature 1
Motion Sensor, item temperature 1

Motion Sensor, item temperature 1
Motion Sensor, item temperature 1

We can do the same for the other Channels.

Motion Sensor, items
Motion Sensor, items

And There you go !


Conclusion

Here is the summary of my first experiments with openHAB 3.0 and Z-Wave devices. If it can be of use to other people, it will be with pleasure. I’m not an openHAB expert, but this new version 3.0 seems more intuitive to me and … I managed to get MQTT to work ;-) If you have any comments or suggestions, don’t hesitate to contact me on manuel.munier@univ-pau.fr.

Next step:

Previous
Next