89 lines
3.4 KiB
Markdown
89 lines
3.4 KiB
Markdown
# Getting Started
|
|
|
|
# Prepare Z-Way Server
|
|
|
|
1. [Download](https://razberry.z-wave.me/z-way-server/) Z-Way v2.2.3 or newer (further information about installing Z-Way you can find [here](http://razberry.z-wave.me/index.php?id=24))
|
|
2. Install openHAB Connector
|
|
- via "ZWave.Me App Store"
|
|
- via Git
|
|
|
|
```shell
|
|
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](http://www.openhab.org/getting-started/downloads.html) openHAB 2 (further information about installing openHAB you can find [here](http://docs.openhab.org/installation/index.html))
|
|
2. Install Z-Way Binding
|
|
- via Extension Manager
|
|
- via Download
|
|
|
|
```shell
|
|
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*
|
|
|
|
|
|
|
|
|