openHAB 2

Getting Started

Prepare Z-Way Server

  1. Download Z-Way v2.2.3 or newer (further information about installing Z-Way you can find here)
  2. Install openHAB Connector
    • via “ZWave.Me App Store”
    • via Git
     cd /opt/z-way-server/automation/userModules
     git clone OpenHABConnector
     service z-way-server restart
  3. Instantiate the app once (under Configuration - Apps - Local Apps). Important: Change the selection from “Featured Apps” to “All Apps” to make the app visible. It is not necessary to make the configuration manually.

Prepare openHAB

  1. Download openHAB 2 (further information about installing openHAB you can find here)
  2. Install Z-Way Binding
    • via Extension Manager
    • via Download
     cd /opt/openhab2/addons
     sudo wget
     sudo unzip
     sudo rm
  3. Start openHAB by running start.bat or
  4. The first start may take up to 5 minutes. You should reach openHAB2 at http://localhost:8080

Configure Z-Way in openHAB

Create and configure a Z-Way Bridge

Open the PaperUI

openHAB Home

Open the Inbox and create a Z-Way Server

openHAB Inbox

openHAB Inbox

Open the Configuration - Things and select Z-Way Server

openHAB Thing details

Change configuration: In order for the Observer mechanism works, the IP address, port and protocol of both systems are required.

openHAB Thing settings

Create and configure Z-Way Devices

Open the Inbox and start manually the Discovery for the Z-Way Binding. The Discovery must be started manually at this point, because the Discovery is running only every 4 minutes. The start time of the interval is the creation of Z-Way Server, even if the configuration is not yet complete. After the Z-Way Server is fully configured, the interval must be awaited or started manually.

openHAB Discovery

openHAB Discovery

Create Things from the Discovery Results

openHAB Inbox

Example: openHAB Thing compared to the equivalent Z-Way Devices

openHAB Thing

Z-Way Devices