Nachdem der Aufbau der Entwicklungsumgebung beschrieben wurde, muss natürlich auch ein eigenes Binding programmiert werden 🙂

Hier gibt es auch schon eine kurze Einführung dazu:

Ich habe neben dem Video noch folgende Anpassungen durchführen müssen:

• Maven herunterladen und den PATH um das BIN-Verzeichnis erweitern
• Systemvariable JAVA_HOME auf das aktuelle Java-Verzeichnis erstellen (ansonsten kann man den Befehl „mvn“ nicht ausführen)
• Das Binding (Code-Gerüst) wie folgt erstellen:
  • create_openhab_binding_skeleton.cmd CoolStuff coolstuff
  • Danach den Author eingeben und die restlichen Vorgaben mit „Yes“ akzeptieren
• Damit wird das Projekt „org.openhab.binding.coolstuff“ erzeugt

Das Projekt kann jetzt direkt in Eclipse ausgeführt und erweitert werden.

Folgende wichtige Dateien habe ich mir aus dem Video noch notiert:

• \org.openhab.binding.coolstuff\pom.xm (Build-File für Maven)
• \org.openhab.binding.coolstuff\ESH-INF\binding\binding.xml (Binding-File für openHAB)
• \org.openhab.binding.coolstuff\ESH-INF\thing\thing-types.xml (Thing-File für openHAB)
• \org.openhab.binding.coolstuff\src\main\java\org\openhab\binding\coolstuff\handler\CoolStuffHandler.java (Ablageort für die Logik des Bindings)

Die Erstellung eines eigenen Bindings war damit doch recht einfach. Jetzt muss ich mal schauen, wie man ein UPnP-Radio in ein Binding integriert.

Happy Coding 🙂

Auf unserem Fire TV Stick von Amazon läuft das Media-Center Kodi. Es macht dann natürlich auch Sinn die Mediensteuerung in die Hausautomatisierung zu integrieren.

Hier in dem Beispiel möchte ich die Informationen von Kodi in openHAB darstellen und Kodi damit fernsteuern. Es sollen auch bestimmte Aktionen ausgeführt werden z.B. wenn ich Pause drücke, soll das Licht automatisch gedimmt werden.

Vorbereitung Kodi

Im ersten Schritt sollte man kontrollieren, ob man im Fire TV Stick eine feste IP-Adresse hinterlegt hat (das kann man im WLAN-Dialog unter erweitert etwas versteckt einstellen).

Danach Kodi starten und kontrollieren, ob das Einstellungslevel mindestends „Standard“ ist (oder wie bei mir „Fortgeschritten“.

Dann kann man unter „System – Einstellungen – Dienste – Webserver“ die „Steuerung über HTTP zulassen“ aktivieren.

Außerdem muss man noch unter „System – Einstellungen – Dienste – Fernsteuerung“ die „Steuerung über lokale Programme zulassen“ und „Steuerung über entferne Programme zulassen“ einschalten.

Das Ergebnis kann man mit dem Aufruf http://IP-ADRESSE:8080 kontrollieren.

Binding

Nun wird das Binding in openHAB 2.x aktiviert – „Paper UI – Add-ons – BINDINGS – XBMC Binding“ – dazu INSTALL auswählen.

Nun kann man das Binding über den Eclipse SmartHome Desinger unter „Services – xbmc.cfg“ parametrieren:

# Hostname / IP address of your XBMC host (required). Example:
livingRoom.host=IP-ADRESSE

# Port number for the json rpc service (optional, defaults to 8080). Example:
livingRoom.rsPort=8080

# Port number for the web socket service (optional, defaults to 9090). Example:
livingRoom.wsPort=9090

# Username to connect to XBMC. (optional, defaults to xbmc). Example:
livingRoom.username=xbmc

# Password to connect to XBMC. (optional, defaults to xbmc). Example:
livingRoom.password=xbmc

#Refresh interval in ms (optional, defaults to 60000ms [1 minute])
refreshInterval=60000

In diesem Beispiel muss die IP-ADRESSE noch getauscht und optional Benutzer und Passwort gesetzt werden.

Items

Danach kann man beginnen seine gewünschten Items einzufügen. Eine Übersicht der Möglichkeiten findet Ihr hier.

Meine erste Test-Konfiguration sieht wie folgt aus:

Switch XBMC_System_State "XBMC - System.State [%s]" {xbmc="<[#livingRoom|System.State]"}
Switch XBMC_System_Shutdown "XBMC - System.Shutdown" {xbmc=">[#livingRoom|System.Shutdown]", autoupdate="false"}

String XBMC_Player_State "XBMC - Player.State [%s]" {xbmc="<[#livingRoom|Player.State]"}
String XBMC_Player_Title "XBMC - Player.Title [%s]" {xbmc="<[#livingRoom|Player.Title]"}
Switch XBMC_Player_PlayPause "XBMC - Player.PlayPause" {xbmc=">[#livingRoom|Player.PlayPause]", autoupdate="false"}
Switch XBMC_Player_Stop "XBMC - Player.Stop" {xbmc=">[#livingRoom|Player.Stop]", autoupdate="false"}

String XBMC_GUI_ShowNotification "XBMC - GUI.ShowNotification [%s]" {xbmc="<[#livingRoom|GUI.ShowNotification]", autoupdate="false"}

String XBMC_Label_Player_FinishTime "XBMC - Label.Player.FinishTime [%s]" {xbmc="<[#livingRoom|Label.Player.FinishTime]"}
String XBMC_Label_Player_Time "XBMC - Label.Player.Time [%s]" {xbmc="<[#livingRoom|Label.Player.Time]"}
String XBMC_Label_System_Uptime "XBMC - Label.System.Uptime [%s]" {xbmc="<[#livingRoom|Label.System.Uptime]"}
String XBMC_Label_VideoPlayer_VideoCodec "XBMC - Label.VideoPlayer.VideoCodec [%s]" {xbmc="<[#livingRoom|Label.VideoPlayer.VideoCodec]"}

Sitemap

Die Visualisierung in der Sitemap habe ich mir wie folgt aufgeteilt:

 Text label="Kodi (Fire TV Stick)" icon="video" {
 Frame label="System" { 
 Text item=XBMC_System_State label="Systemstatus [%s]"
 Text item=XBMC_Label_System_Uptime label="Systemlaufzeit [%s]"
 //Switch item=XBMC_System_Shutdown label="Herunterfahen" mappings=[OFF="OK"] visibility=[XBMC_System_State==ON]
 }
 Frame label="Mediensteuerung" {
 Switch item=XBMC_Player_PlayPause label="Wiedergabe starten" mappings=[ON="Play"] visibility=[XBMC_Player_State==Pause]
 Switch item=XBMC_Player_PlayPause label="Wiedergabe pausieren" mappings=[ON="Pause"] visibility=[XBMC_Player_State==Play]
 Switch item=XBMC_Player_Stop label="Wiedergabe beenden" mappings=[ON="Stop"] visibility=[XBMC_Player_State==Play, XBMC_Player_State==Pause] 
 }
 Frame label="Medieninformationen" {
 Text item=XBMC_Player_State label="Medienstatus [%s]"
 Text item=XBMC_Player_Title label="Gerade läuft [%s]"
 Text item=XBMC_Label_Player_Time label="Aktuelle Laufzeit [%s]"
 Text item=XBMC_Label_Player_FinishTime label="Ende um [%s]"
 Text item=XBMC_Label_VideoPlayer_VideoCodec label="Video-Codec [%s]"
 } 
 }

Rules

Um das Zusammenspiel etwas besser darzustellen wird mit dieser Regel sobald man Pause drückt per KNX das Licht gedimmt (und bei Play wieder ausgeschalten):

var Number brightnessBeforePause

rule "Licht an bei Pause"
 when
 Item XBMC_Player_State changed from Play to Pause 
 then
 brightnessBeforePause = Dimmen_EG_Wohnen.state as DecimalType
 logInfo("TEST","Licht vor Pause: " + brightnessBeforePause)

if (brightnessBeforePause < 50){
 sendCommand(Dimmen_EG_Wohnen,50)
 }
end

rule "Licht aus bei Pauseende"
 when
 Item XBMC_Player_State changed from Pause to Play 
 then
 if (Dimmen_EG_Wohnen.state == 50){ 
 sendCommand(Dimmen_EG_Wohnen,OFF)
 }
 
end

Fazit

Mit dem XBMC / Kodi Binding ist es recht einfach das Media-Center in openHAB zu integrieren. Damit kann ich zukünftig wieder auf eine Fernbedienung verzichten.

Leider habe ich keine Möglichkeit gefunden Kodi auf dem Fire TV Stick automatisch zu starten (das geht scheinbar nur, wenn es auf eigenständiger Hardware läuft). Auch funktioniert in meiner Kodi-Version 15.1 der Befehl „System.Shudown“ nicht um Kodi abzuschalten.

Welche Anwendungsfälle fallen euch im Zusammenspiel mit Kodi ein?

Ich habe gerade noch gesehen, dass es auch ein Binding für Onkyo-Receiver für openHAB 2.x gibt. Mein Receiver Onkyo TX-NR515 wird dort zwar nicht offiziell unterstützt, aber funktioniert trotzdem einwandfrei. 🙂

Things

Als erstes wieder die „Dinge“ erkennen lassen. Bei der manuellen Erkennung hat leider die Steuerung bei mir nicht funktioniert:

onkyo:onkyoAVR:myOnkyo [ipAddress="xxx.xxx.xxx.xxx", port=60128]

Es muss im Binding noch die richtige IP-Adresse angegeben werden.

Ich habe also über Paper UI das Gerät automatisch erkennen lassen. Damit läuft es dann einwandfrei.

Items

Ich nutze an dem Receiver nur die Zone 1 und auch keine NET-Funktionen. Für einen ersten Test kann man die Funktionen wie folgt in seine Item-Datei aufnehmen:

Switch Onkyo_Power "Onkyo - Power" {channel="onkyo:onkyoAVR:xxxIDxxx:zone1#power"}
Number Onkyo_Input "Onkyo - Eingang" {channel="onkyo:onkyoAVR:xxxIDxxx:zone1#input"}
Dimmer Onkyo_Volume "Onkyo - Lautstärke" {channel="onkyo:onkyoAVR:xxxIDxxx:zone1#volume"}
Switch Onkyo_Mute "Onkyo - Stumm" {channel="onkyo:onkyoAVR:xxxIDxxx:zone1#mute"}

Die xxxIDxxx muss noch gegen den richtigen Unique Device Name getauscht werden.

Sitemap

Dann kann man den AVR wie folgt im Web / App visualisieren:

 Text label="Onkyo AVR" icon="video" {
 Switch item=Onkyo_Power label="Ausschalten"
 Setpoint item=Onkyo_Volume label="Lautstärke ändern" minValue=0 maxValue=50 step=1 visibility=[Onkyo_Power==ON]
 Switch item=Onkyo_Mute label="Stumm" visibility=[Onkyo_Power==ON]
 Selection item=Onkyo_Input label="Eingang wechseln" mappings=[01="CBL/SAT", 02="GAME", 03="AUX", 05="PC", 16="BD/DVD", 34="PHONO", 35="TV/CD", 36="FM", 37="AM", 39="NETWORK", 41="USB", 46="BLUETOOTH"] visibility=[Onkyo_Power==ON]
 }

Fazit

Mittlerweile bin ich bei der Einbindung von neuen Geräten in openHAB recht schnell geworden. Man muss aber immer schauen, ob man aus einer Einbindung eines Geräts den entsprechenden Nutzen hat.

Beim Onkyo-Receiver ist mir aufgefallen, dass das entfernte Einschalten nicht funktioniert (aber das Ausschalten). Da ich dafür scheinbar ein Firmeware-Update benötige, werde ich das jetzt erst einmal so belassen (bis ich ein vernünftiges Szenario dafür habe). Leider gab es im Internet einige Beiträge, bei denen nach einem Firmeware-Update der Receiver nicht mehr bedienbar war.

Ich habe zufällig auch bemerkt, dass der Receiver über vTuner auch als Internetradio verwendet werden kann. Das macht natürlich nur Sinn, wenn ich den Radio über openHAB auch einschalten kann 😉

Schritt für Schritt wird die Hausautomatisierung ausgebaut. Da ich gerade an der Integration der Rauchmelder bin, möchte ich natürlich eine externe Benachrichtigung auf mein SmartPhone haben, wenn ein Rauchmelder im Haus auslöst.

Normalerweise verwende ich für Nachrichten WhatsApp, aber das ist leider direkt an die Telefonnummer gebunden. Bei onesmarthome habe ich die Integration von Telegram in openHAB gesehen. Damit kann ich alle Nachrichten des SmartHome direkt auf das Telefon „pushen“. Die genaue Einrichtung wird in dem oben genannten Link erklärt.

Hier einmal die Kurzfassung:

• Binding über „PaperUI – Extensions – Actions – Telegram“ installieren
• Auf dem SmartPhone z.B. Google Play Store die Telegram-App installieren
• Einen neuen Bot wie folgt anlegen:
  • /newbot
  • [name]
  • [name_bot]
• Wenn das erfolgreich war, kann man über eine Nachricht an den Bot schicken
• Diese Nachricht muss noch hier ausgelesen werden: https://api.telegram.org/botAPI/getUpdates (API gegen euren oben generierten Token tauschen)
• Danach bekommt man eine Message-ID (diese ist für das Binding in openHAB wichtig)
• Jetzt wird in der telegram.cfg der Bot erstellt und die chatId und der token eingetragen

Jetzt kann man wie folgt per Script oder automatisiert an seinen neuen Bot Textnachrichten senden:

sendTelegram("reinhard", "Licht wurde eingeschalten")

In Kombination mit der Hausautomatisierung und den Rauchmeldern fallen mir da einige Einsatzszenarien ein. Welche Szenarien seht Ihr für Push-Nachrichten direkt auf ein mobiles Endgerät?