openHAB2 #2: HomeMatic Komponenten einrichten

openHAB2 Homematic einrichten

Im zweiten Teil der Serie werden wir die HomeMatic Komponenten mit unserer openHAB Installation verbinden. Dazu werden wir Homegear auf unserem Raspberry Pi installieren und unsere Homematic Komponenten damit verknüpfen.

Falls Ihr euren Raspberry mit Rasbian versorgt habt, könnt ihr hier nachlesen wie: openHAB2 #1: Einrichtung von OpenHAB2 auf Raspberry Pi

Homegear für HomeMatic installieren

Damit unser openHAB Raspberry nun mit den HomeMatic kommunizieren kann, benötigen wir neben dem Gateway ein Programm das sozusagen die Steuerzentrale von HomeMatic (CCU bzw. CCU2) emuliert.

Dafür gibt es Homegear, ein kostenloses Open-Source Programm, dass die Verbindung zwischen openHAB und den HomeMatic-Komponenten herstellt. Dazu kann es einfach über den Paket-Manager installiert werden.

# Signatur der Paketquelle installieren
wget https://homegear.eu/packages/Release.key && apt-key add Release.key && rm Release.key

# Paketquelle der Paketliste hinzufügen
echo 'deb https://homegear.eu/packages/Raspbian/ jessie/' >> /etc/apt/sources.list.d/homegear.list 

# Paketquellen updaten und Homegear installieren
apt update
apt install homegear homegear-homematicbidcos homegear-homematicwired homegear-insteon homegear-max homegear-philipshue homegear-sonos homegear-kodi homegear-ipcam homegear-beckhoff homegear-knx homegear-enocean homegear-intertechno

Hinweis: Die Codezeilen mit # am Anfang sind nur Kommentare und müssen nicht kopiert werden.

 

Homegear mit Gateway verbinden

Hier beschreiben wir zwei Möglichkeiten zu Verbindung, je nachdem welchen Gateway man besitzt:

Option 1: Homematic für HM-LAN konfigurieren

Habt ihr einen LAN Gateway oder eine CCU2 für die HomeMatic müssen wir zuerst den AES-Code-Schlüssel auf der Unterseite des Gerätes notieren.

HomeMatic Funk LAN Gateway*
eQ-3 AG - Werkzeug
74,90 EUR

Nun schließen wir den Adapter an Strom und Netzwerk an und versuchen die IP-Adresse herauszufinden – Diese kann am einfachsten im Admin-Interface Eures Routers abgefragt werden. Alternativ können Netzwerkscanner verwendet werden.

Haben wir diese ausfindig gemacht, müssen wir Homegear noch mitteilen, was für einen Adapter zur Verfügung steht.

Hierzu öffnen wir die Datei /ect/homegear/families/homegearbidcos.conf und suchen nach folgendem Bereich, wo wir jeweils die #-Zeichen am Zeilenbeginn entfernen, damit es so aussieht:

[HM-CFG-LAN]
id = My-HM-CFG-LAN
# Uncomment this if you want this HM-CFG-LAN to be your default communication module.
#default = true
deviceType = hmcfglan
# IP address of your HM-CFG-LAN
host = 192.168.1.100 <- Hier die IP-Adresse des Adapters
port = 1000
# Put the AES key printed on your HM-CFG-LAN here
lanKey = 00112233445566778899AABBCCDDEEFF <- Hier den AES-Key eintragen
responseDelay = 60

Mit dem Befehl sudo systemctl restart homegear.service starten wir Homegear neu.

 

Option 2: Homematic für Raspberry Pi Interface konfigurieren

Um das Homematic Pi Modul zum Laufen zu bringen, müssen wir zuerst die serielle Schnittstelle (/ttyAMA0) des Raspberrys freimachen und dem Adapter zuordnen. Standardmäßig nutzt der Bluetooth bzw WLAN Chip des Raspberrys diese Schnittstelle.

In der Datei /boot/config.txt fügen wir am Ende folgenden Befehl hinzu:

dtoverlay=pi3-miniuart-bt
enable_uart=1
dtparam=spi=on
dtparam=i2c_arm=on

Das bewirkt, dass der Bluetooth bzw. WLAN-Chip die Mini-UART-Schnittstelle nutzt und die serielle Schnittstelle freigemacht wird.

Anschließend deaktivieren wir die Serielle Konsole mit den Befehlen

systemctl disable serial-getty@ttyAMA0.service
systemctl disable serial-getty@serial0.service
systemctl disable serial-getty@ttyS0.service

Da wir die offizielle Raspbian Version nutzen, müssen wir die Datei /etc/udev/rules.d/99-com.rules löschen, damit Homegear Zugriff auf die GPIO-Pins bekommt.

Anschließend schadet ein Reboot nicht.

Nachdem wir die systemseitigen Vorbereitungen getroffen haben, müssen wir Homegear noch mitteilen, was für einen Adapter zur Verfügung steht.

Hierzu öffnen wir die Datei /ect/homegear/families/homegearbidcos.conf und suchen nach folgendem Bereich, wo wir jeweils die #-Zeichen am Zeilenbeginn entfernen, damit es so aussieht:

[HomeMatic Wireless Module for Raspberry Pi]
id = My-HM-MOD-RPI-PCB
# Uncomment this if you want the HM-MOD-RPI-PCB to be your default communication module.
#default = true
deviceType = hm-mod-rpi-pcb
device = /dev/ttyAMA0
responseDelay = 95
gpio1 = 18

Mit dem Befehl sudo systemctl restart homegear.service starten wir Homegear neu.

 

Homematic Komponenten mit Homegear koppeln

 

Für die Kopplung der Komponenten gibt es auch mehrere Wege – zum einen kann man über die Konsole die Gerätschaften verbinden. Bequemer geht es jedoch mit der Konfigurationssoftware, die der Homematic-Hersteller zur Verfügung stellt. Diese kann man hier downloaden (Hersteller-Link).

HomeMatic Konfigurator mit Homegear verbinden

Nach dem Start der Software müssen wir uns mit Homegear verbinden. Dazu wählen wir im Menü Datei den Punkt Einstellungen aus.

HomeMatic Konfigurator

Im Dialogfeld wählen wir “Entfernter BidCOS-Service” aus und klicken auf “Weiter” .

Anschließend geben wir die IP-Adresse unseres Raspberrys und den Port 2001 ein. Ein anschließendes Fertigstellen sollte die Verbindung zum Homegear-Raspberry herstellen.

 

HomeMatic Thermostat mit Konfigurator koppeln

Mit einem Klick auf “Geräte anlernen” wird der Anlernmodus für 60 sek gestartet.

HomeMatic Konfigurator - Anlernmodus

HomeMatic Konfigurator – Anlernmodus

Nun muss am HomeMatic Gerät der Pairing Modus aktiviert werden – Dies geschieht bei den meisten Geräten indem man die mittlere Taste lang gedrückt hält, bis ein Countdown auf dem Display erscheint.

HomeMatic Thermostat

HomeMatic Thermostat

Hat alles funktioniert, bestätigt das Gerät die Kopplung mit “AC” im Display und in der HomeMatic Konfigurationssoftware steht das ein neues Gerät gefunden wurde, dass dann auch in der Übersicht auftaucht und von dort weiter konfiguriert werden kann.

[adinserter block=”2″]

Alternativ: HomeMatic Komponenten mit Homegear-Konsole konfigurieren

Es besteht auch die Möglichkeit, über die in Homegear integrierte Konsole die Komponenten zu koppeln

Dazu geben wir am Raspberry Pi (oder über die SSH-Konsole) folgenden Befehl ein

sudo homegear -r

Mit fs 0 wählen wir die Produktfamilie aus und starten mit pairing on den Kopplungsmodus für 60 Sek.

Abschließend kann man mit peers list die gekoppelten Komponenten auflisten lassen.

Weitere HomeMatic Komponente koppeln

Eine Vielzahl von weiteren HomeMatic Komponenten lassen sich auf die selbe Weise mit Homegear koppeln. Eine Liste mit allen unterstützen Komponenten findet Ihr hier:

Device Support List

Speziell die HomeMatic BidCos Komponenten:

HomeMatic BidCoS Device Support List

 

Patrick

Gründer und Autor von frombeyond.de – Seit 25 Jahren im Bereich IT unterwegs, leidenschaftlicher Computerspieler, Technik-Freak und begeistert von allem was einen Motor (Auto/Motorrad/Flugzeug) hat.

Nutzt Zuhause openHAB2 zusammen mit HomeMatic Komponenten sowie netatmo als Wetterstation. InfluxDB und Grafana zur Auswertung.

*Diese Links führen zu Amazon- oder anderen Online-Angeboten, keine Verfügbarkeitsgarantie, keine Garantie auf günstigsten Preis, Preise können variieren, Preise inkl. MwSt. / evtl. zzgl. Versandkosten, alle Angaben ohne Gewähr. Letzte Aktualisierung am 16.12.2017