openhab-docs/v2.1/addons/bindings/zway/doc/GETTING_STARTED.md

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 https://github.com/pathec/ZWay-OpenHABConnector.git 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 https://github.com/openhab/openhab2-addons/files/636686/org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
   sudo unzip org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
   sudo rm org.openhab.binding.zway-2.0.0-SNAPSHOT.zip
   

3. Start openHAB by running start.bat or start.sh

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

Open the Inbox and create a Z-Way Server

Open the Configuration - Things and select Z-Way Server

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

• openHAB
  • openHAB Alias by default, the alias is generated
  • IP address (default: localhost)
  • port (default: 8080)
  • protocol (default: http)
• Z-Way Server
  • IP address (default: localhost)
  • port (default: 8083)
  • protocol (default: http)
  • username (default: admin)
  • password must be set (no default value)
• options
  • polling interval (default: 3600) in seconds
  • Observer mechanism (default: active)

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.

Create Things from the Discovery Results

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