HomeMatic HMLan-Adapter an FHEM-Server anbinden

Nachdem meine Frau vor einer Woche darauf bestanden hat, dass ich die Weihnachtsbeleuchtung anbringe, musste ich leider feststellen, dass unsere Zeitschaltuhr nicht mehr funktioniert. Damit war der perfekte Zeitpunkt gekommen einen Fu in die Home-Automation zu bekommen. Ich habe mich also auf dem Markt umgesehen und bin recht schnell bei den Produkten von HomeMatic hngen geblieben (scheinen zumindest mal an Sicherheit gedacht zu haben und die knnen AES schreiben ;-)). Um das Projekt nicht zu einfach werden zu lassen, habe ich mich zur Steuerung fr das Open Source Projekt FHEM entschieden und mir daher folgende Komponenten zugelegt (Affiliate Links):

FHEM auf dem Raspberry PI installieren

Die Installation von FHEM auf einem Debian basierten System ist denkbar einfach, da es dafr ein fertiges Paket gibt. Die Einleitung und auch ein paar Hinweise zu mglichen Problemen findet man im FHEM Wiki.

HomeMatic Lan Adapter

Hat man das Betriebssystem am laufen geht es daran die Hardware mit der Software zu verbinden. Das notwendige Bindeglied zwischen den Steuerelementen (Aktoren) und unserer Zentrale bildet der HomeMatic HMLan Adapter. Er wird entweder via USB oder via LAN angeschlossen und wandelt unsere Signale in Funksignale um die die Aktoren verstehen und sendet deren Antworten an unsere Zentrale zurck. Um dieses Setup zum fliegen zu bekommen sind einige Schritte notwendig, die ich nachfolgend beschreibe.

Seriennummer und AES Schlssel des HMLan-Adapters

Den AES-Schlssel sowie die Seriennummer des HMLan Adapters findet ihr auf der Rckseite des HMLan Adapters. Ich wrde euch empfehlen diesen abzuschreiben und in einem Texteditor zu speichern. Wir werden beide noch fter bentigen. Wer auf nummer Sicher gehen mchte erfhrt spter auch noch wie man den AES Schlssel auf einen eigenen Wert ndern kann. (Wrde diesen Schritt sehr empfehlen!)

HomeMatic Software

Dem HMLan Adapter ist eine CD beigelegt mit Hilfe des darauf befindlichen Installers erhlt man zwei kleine Hilfsprogramme installiert, die wir im folgenden bentigen werden. Daher bitte jetzt die CD einlegen und die Installation starten.

HMLan Adapter unter Windows mit der HomeMatic Software vorkonfigurieren

Es ist empfehlenswert den HMLan-Adapter mit einer festen IP Adresse zu versorgen um eine zuverlssige Kommunikation sicherstellen zu knnen. Um diese Aufgabe auszufhren ffnet man das Tool HomeMatic Lan-Interface Configurator und whlt darin den Menpunkt Change IP Settings. In dieser Maske kann man auch die Firmware seines HMLan Adapters updaten dies ist insbesondere empfehlenswert, wenn die initiale Suche des HMLan Adapters lnger gedauert hat.

SNAGHTMLbd72014

In dem sich ffnenden Fenster gibt man eine freie feste IP Adresse aus seinem LAN ein. Ja, ich habe zuhause ein Class B Netz die meisten werden hier eine IP in der Form 192.168.1.xxx und eine Subnetz Maske von 255.255.255.0 eingeben mssen. Der Haken bezglich der AES Verschlsselung sollte vorerst gesetzt bleiben. Nach einem klick auf OK muss nun der AES Schlssel eingegeben werden.

SNAGHTMLbd9fa8c

Nach dem ndern der IP sollte man das Gert vom Strom trennen und damit neu starten um zu prfen ob alles wie gewnscht funktioniert hat.

Als nchstes starten wir die ebenfalls mitgelieferte Software HomeMatic-Komponenten Konfigurieren. Um die Verbindung der Software mit dem HMLan Adapter herzustellen whlt man Datei und dann Konfigurieren und in der nchsten Maske HomeMatic-Lan-Interface.

SNAGHTMLbee61b1

In der nchsten Maske gibt man nun erneut die Seriennummer sowie den Zugriffscode (AES Schlssel) ein:

SNAGHTMLbf00ce0

Die nchste Seite sollte nun besttigen, dass ein HMLan gefunden und verbunden wurde. Gleichzeitig taucht rechts unten im Eck der Anwendung der Hinweis auf Verbunden mit [Seriennummer]@LAN. Wenn diese Meldung nicht auftaucht hilft es ggf. den Adapter ein mal neu zu starten. Wichtig ist, dass die AES Signierung der LAN Kommunikation zu diesem Zeitpunkt noch eingeschaltet ist (siehe oben).

Sicherheitsschlssel bzw. AES Schlssel ndern

Nachdem der HomeMatic Konfigurator mit dem HMLan Adapter verbunden ist, ist ein guter Zeitpunkt um den voreingestellten Sicherheitsschlssel zu ndern. Dieser scheint bei den meisten Gerten identisch zu sein und ist damit nicht wirklich schwer zu erraten. Insbesondere wenn man mit seiner Installation auch kritische Dinge wie z. B. Tren und Fenster steuern mchte, so ist dieser Schritt absolut zwingend. Ich wrde empfehlen einen Schlssel (~ 32 Zeichen) vorab zu erstellen und an einem sicheren Ort aufzubewahren (z. B. Passwortcontainer + Ausdruck).

Um den Schlssel zu ndern startet klicken wir im HomeMatic Konfigurator und klicken auf Einstellungen:

SNAGHTMLc77b4a9

und geben den neuen Schlssel in das dafr vorgesehene Feld ein:

image

Bereits verbundene Gerte werden bei diesem Vorgang direkt auch mit dem neuen Schlssel versorgt. Man muss somit evtl. bereits angelernte Gerte nicht erneut einbinden bzw. vorher entfernen und neu einbinden.

HMLan HMID fr die Verbindung mit FHEM auslesen

Fr die Verbindung mit FHEM bentigen wir die HMID des HMLan Adapters. Unter Windows 8 und Windows 10 befindet sich dieser in folgendem Pfad C:\ProgramData\Bidcos-Service und dort in der Datei ids. ffnet man diese mit einem Texteditor steht dort nur eine Zeile mit

BidCoS-Address = 1234567

Findet ihr diesen Ordner nicht oder wird dort die Datei nicht angezeigt, dann helfen zwei Schritte. Erstens sollten versteckte Dateien und Ordner angezeigt werden und zweitens kann man einfach nach dem Ordner Bidcos-Service suchen (in einigen Foren konnte man lesen, dass dieser z. T. auch in den Benutzerprofilen zu finden war).

Nun mssen wir diese ID noch von ihrer dezimalen Schreibweise in eine Hexadezimale Schreibweise umwandeln. Das geht am einfachsten mit dem Windows Taschenrechner. Man ffnet diesen einfach und wechselt unter Ansicht auf die Programmierer-Ansicht. Dort gibt man die ID von oben ein:

image

und klickt dann auf der linken Seite auf Hex um den Wert umzuwandeln:

SNAGHTMLc05eece

Der gesuchte Wert ist also 12D687 (notieren den haben wir nicht nur zum Spa gesucht ;-)).

FHEM mit dem HMLan-Adapter verbinden

Um den HMLan-Adapter in FHEM einbinden zu knnen ist es notwendig die Netzwerkseitige Verschlsselung der Kommunikation von FHEM zum HMLan-Adapter zu deaktivieren. Da die Verbindung selbst entweder ber ein hoffentlich verschlsseltes WLan oder ber das private LAN luft, ist das zwar unschn aber kein sonderlich groes Sicherheitsproblem. Um die Verschlsselung zu deaktivieren starten wir die bereits oben erwhnte Software HomeMatic Lan-Interface Configurator und deaktivieren unter den Netzwerkeinstellung die Option AES Encrypt Lan-Communication. Die Verbindung das HMLan-Adapters zu den Aktoren wird weiterhin mit unserem AES Schlssel signiert (nicht verschlsselt) und kann somit nicht durch jeden bernommen werden.

SNAGHTMLc7c63d1

An diesem Punkt sollten die Windows basierten HomeMatic Anwendungen geschlossen werden damit FHEM exklusiven Zugriff auf den HMLan bekommen kann. Wir wechseln nun auf die WebGUI von FHEM und whlen dort im Men Edit files fhem.cfg aus und fgen nachfolgende Zeilen am Ende ein (die IP Adresse sowie die HMID muss natrlich durch die eigene ersetzt werden):

define HMLAN01 HMLAN 10.11.1.4:1000
attr HMLAN01 hmId 12D687

Den selbst gewhlten AES Schlssel gibt man am besten direkt ber die Befehlzeile (nicht in der fhem.cfg) ein (ist einfacher).

attr HMLAN01 hmKey [Ihr_KEY]

Nach einem Klick auf Save them.cfg sind auch schon alle notwendigen Schritte erledigt um den HMLan Adapter anzubinden.

Update: Seit kurzem kann man die fhem.cfg nicht mehr einfach so ber den Befehl oben bearbeiten. Man muss zuerst folgenden Befehl in die Kommandozeile eingeben, die Konfiguration speichern und den fhem Server neu starten:

attr WEB editConfig 1
shutdown restart

Prfen kann man dies durch einen Klick auf den Menpunkt Everything hier sollte unser HMLAN01 nun mit dem Status open auftauchen:

image

5 Gedanken zu „HomeMatic HMLan-Adapter an FHEM-Server anbinden

  1. Johannes Schmidt Beitragsautor

    Hi,
    die Datei msste am gleichen Ort wie unter Win8 liegen. Bei mir ist es auf jeden Fall so (ich habe allerdings auch ein inplace upgrade gemacht).

  2. Andreas

    Da der HMLAN Adapter und der CCU2 mittlerweile fast genauso viel kosten, nmlich um die 80 Euro, stellt sich mir die Frage, ob ich nicht anstelle des HMLAN Adapters gleich den CCU2 nehme. Kann ich den CCU2 ggf. auch in FHEM genauso einbinden, oder verhlt der sich da anders?

Kommentare sind geschlossen.