View source for OpenHAB Tutorial

<!-- Links zu den wichtigen Seiten und Anleitungen
 - Openhab KNX Binding: https://docs.openhab.org/addons/bindings/knx1/readme.html
 - Openhab Logging: https://docs.openhab.org/administration/logging.html
 - Openhab Karaf Konsole: https://docs.openhab.org/administration/console.html
-->
=Einleitung=

OpenHAB ist eine Software, die die unterschiedlichsten Systeme und Technologien aus dem Bereich "Home Automation" auf einer Platform zusammenbringt und die eine bequeme Steuerung sowie die Erstellung von Automatisierungsregeln für solche Systeme ermöglicht.

Weitere Vorteile von OpenHAB:
* Open Source Lösung
* Unterstützt eine Vielfalt an Hardware und Protokollen
* Läuft auf allen gängigen Plattformen (Windows, Mac, Linux)
* Installation auf Raspberry Pi ist möglich

OpenHAB Webseite [https://www.openhab.org/]

=Voraussetzungen=

In diesem Tutorial behandeln wir die Installation von OpenHAB auf Raspberry Pi, die Integration mit einem KNX-System und anschließend die Verwendung von OpenHAB zur Steuerung von KNX-Komponenten.

Für die Installation benötigen Sie mindestens:
* Ein Raspberry Pi (hier Model 3)
* Ein Ethernet-Kabel 
* Eine Micro SD Karte 

Um OpenHAB richtig zu testen, brauchen Sie zusätzliche Hardware aus dem Bereich "Home Automation". Wir verwenden ein KNX-System und verweisen auf die Seite [[KNX und ETS5 Tutorial]], falls Sie ein ähnliches System aufbauen wollen.

=OpenHAB auf Raspberry Pi installieren=

Wir fangen gleich mit einer guten Nachricht an: Seit kurzer Zeit wurde OpenHAB 2.2 präsentiert. Es enthält eine Menge neuer Features, die Sie sich hier [http://www.kaikreuzer.de/2017/12/18/openhab22/] anschauen können. Das wichtigste für uns jetzt ist openHABian, was eine einfache voll automatisierte Installation und Konfiguration von Raspberry Pi ermöglicht. Die Anleitung dazu finden Sie hier [https://docs.openhab.org/installation/openhabian.html#raspberry-pi].

Im Prinzip lädt man openHABian-Bild herunter, schreibt es auf Micro SD Karte und steckt in Raspberry Pi. Dann schließt man Internet, Strom an und lässt Raspberry Pi selbst alles installieren.

Nach der Installation können Sie einen Bildschirm und eine Tastatur zu Raspberry Pi anschließen und mit dem Benutzername "openhabian" and dem Passwort "openhabian" anmelden. Somit ist openHAB eingerichtet!

=Steuerung von KNX-Komponenten in OpenHAB=

Nachdem wir OpenHAB installiert haben, können wir es endlich ausprobieren. Hier werden die Schritte beschrieben, die speziell für unseren Fall (OpenHAB + KNX-Komponenten) geeignet sind. Sie finden aber nebenbei die Verweise auf allgemeinere Anleitungen aus dem Netz.

Als Erstes müssen wir Raspberry Pi an das KNX-System anschließen. Es gibt dazu zwei Möglichkeiten: entweder man benutzt ein Ethernet-Kabel und schleißt es an KNX IP Gateway an (siehe [[KNX und ETS5 Tutorial]]) oder man verwendet die Schaltung Pigator und schließt sich direkt an den KNX-Bus an (siehe [[KNXD Tutorial]]). 

Bereits angeschlossen können wir im Browser http://IP-of-your-machine:8080 eintippen (IP-Adresse des Raspberry Pi sehen Sie gleich bei der Anmeldung, siehe vorheriges Kapitel). Danach gelangen wir auf die Seite, wo einige UI zur Auswahl stehen. Jetzt sind für uns zwei davon interessant Paper und Basic UI. Die erste Schnittstelle ist dafür da, neue add-ons zu installieren und neue unterstützte Geräte im Netz zu entdecken und zu konfigurieren. Die zweite Schnittstelle ermöglicht die Steuerung und Übersicht der konfigurierten Geräte. (mehr Details finden Sie hier [https://docs.openhab.org/tutorials/beginner/uis.html])

Weiter wählen wir Paper UI und installieren Add-ons für KNX (siehe Menü-Punkt Add-ons [https://docs.openhab.org/tutorials/beginner/configuration.html]). Das brauchen wir später, wenn wir die Geräte aus dem KNX-System für OpenHAB definieren. Jetzt schauen wir bei Basic UI vorbei. Hier ist momentan leer, da wir noch keine Geräte hinzugefügt haben. Um das zu ändern, müssen wir die sogenannten .items und .sitemap-Dateien erstellen und dort die Geräte beschreiben. (siehe [https://docs.openhab.org/tutorials/beginner/sitemap.html]) In der .items-Datei definieren wir die Geräte im Format 
 ItemType ItemName "ItemDescription" <ItemIcon> { ItemToThingChannelLink }
und in der .sitemap-Datei beschreiben wir, was in Basic UI nachher zu sehen ist.

In unserem Fall erstellen wir eine Datei namens <code>default.items</code> und definieren dort einen KNX-Schalter (AktorA), der eine Lampe ein- und wieder ausmacht.
 Switch AktorA "Lampe" <Light> { knx="0/0/1" }
Dabei steuern wir den Schalter über seine Gruppenadresse 0/0/1.

Jetzt erzeugen wir noch entsprechend ein Sitemap <code>default.sitemap</code> und tragen dort unseren Schalter ein, damit er in Basic UI abgebildet wird.
 sitemap default label="KNX-Sitemap"
 {
     Switch item=AktorA label="Lampe"
 }

Schließlich müssen wir nur noch Paper UI öffnen und dort unter "Configuration -> Services” Basic UI konfigurieren, in dem wir bei Default Sitemap den Name unseres Sitemaps eingeben. Am Ende sieht Basic UI folgendermaßen aus:
[[File:BasicUI.jpg|thumb|center|Basic UI]]
Wenn Sie dem [[KNX und ETS5 Tutorial]] gefolgt haben, dann können Sie OpenHAB gleich testen, also den Schalter betätigen.

=Interface: MDT IP000.01 als IP Gateway=
Unsere Konfiguration in <code>/etc/openhab2/services/knx.cfg</code> mit einem MDT IP000.01 als IP Gateway ist:

 ip=192.168.4.114
 busaddr=0.0.2
 ignorelocalevents=true
 type=TUNNEL
 port=3671
 localIp=192.168.4.101


 
=Interface: KNXD als IP Gateway=