added migrated 2.x add-ons

Signed-off-by: Kai Kreuzer <kai@openhab.org>

bundles/org.openhab.binding.zway/doc/GETTING_STARTED.md

@@ -0,0 +1,72 @@
+# 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))
+
+# Prepare openHAB
+
+1. [Download](https://www.openhab.org/download/) openHAB 2 (further information about installing openHAB you can find [here](https://www.openhab.org/docs/installation/))
+2. Install Z-Way Binding
+    - via Extension Manager
+    - via Download
+
+    ```shell
+    cd /opt/openhab2/addons
+    sudo wget https://github.com/openhab/openhab-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 *Paper UI*
+
+![openHAB Home](images/getting-started/01-openHAB-Home.png)
+
+Open the *Inbox* and create a Z-Way Server
+
+![openHAB Inbox](images/getting-started/02-Inbox.png)
+
+![openHAB Inbox](images/getting-started/03-Create-bridge.png)
+
+Open the *Configuration* - *Things* and select Z-Way Server
+
+![openHAB Thing details](images/getting-started/05-Bridge-details.png)
+
+Change configuration: In order for the Observer mechanism works, the IP address, port and protocol of both systems are required.
+
+- **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
+
+**The following picture is no longer up to date!**
+![openHAB Thing settings](images/getting-started/06-Bridge-settings.png)
+
+## 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](images/getting-started/07-Device-discovery.png)
+
+![openHAB Discovery](images/getting-started/08-Device-discovery.png)
+
+Create *Things* from the *Discovery Results*
+
+![openHAB Inbox](images/getting-started/09-Create-device.png)
+
+Example: openHAB *Thing* compared to the equivalent Z-Way *Devices*
+
+![openHAB Thing](images/getting-started/10-Z-Way-device.png)
+
+![Z-Way Devices](images/getting-started/11-Z-Way-device.png)