HM-CFG-LAN LAN Konfigurations-Adapter

Aus FHEMWiki
HomeMatic LAN Konfigurations-Adapter

Vorbemerkungen

Der HomeMatic Konfigurations-Adapter LAN (HM-CFG-LAN), kurz HMLAN, stellt eine Alternative zum CUNO im HomeMatic Modus dar. Er ist eigentlich als Konfigurationstool gedacht, kann aber von der HomeMatic CCU zur Verbesserung der Funksituation genutzt werden. Deshalb kann er auch von FHEM als Funkadapter verwendet werden.

HMLAN versus CUL / CUNO / COC

Anmerkung: Stand Dezember 2013 ist wohl davon abzuraten, HomeMatic-Geräte mittels CUNO in Fhem einbinden zu wollen. Zu näheren Details (Timing-Probleme) gibt es einen Thread im Fhem-Forum.

AES

Aufgrund der fehlenden AES Encryption (Stand 12.03.2013) im CUL / CUNO / COC können Homematic-Geräte, bei denen sich der AES Modus nicht deaktivieren lässt, nur mit einem HMLAN am FHEM betrieben werden.

Burst-Modus

Homematic Komponenten, die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) V1.55 ab Mai 2013 genutzt werden.

Betroffen hiervon sind beispielsweise folgende Komponenten:

Achtung: Diese Listen erheben keinen Anspruch auf Vollständigkeit und die Angaben sind ohne Gewähr.

Vorbereitung

HomeMatic Lan-Interface Configurator
HomeMatic Konfigurator

Bevor man den HMLAN mit Fhem nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei HomeMatic in der Version 1.512 (Stand 19. Dezember 2013) herunter zu laden ist und nach der Installation mit der Verknüpfung "HomeMatic-Lan-Interface konfigurieren" oder "HomeMatic-Komponenten konfigurieren" gestartet wird und unter Windows läuft. Für andere Betriebssystem (Anleitung für OS X) braucht man eine Windows-Emulation. Dem HMLAN liegen zwei Konfigurationsprogramme bei, bitte darauf achten, das richtige zu verwenden. Wenn das Konfigurationsprogramm den HMLAN-Konfigurator nicht findet, sollten alle nicht benutzten Netzwerkinterfaces vorübergehend deaktiviert werden, siehe Beitrag im Fhem Forum und bekannte Probleme

Firmware

Die aktuelle Firmware Version des HMLAN ist 0.961 (Stand September 2013). Ein Update ist unter "Update Firmware" mit der "HomeMatic Lan-Interface Configurator" Software möglich.

IP Adresse

Der HMLAN Konfigurator ist ähnlich wie der CUN(O) ein Netzwerkgerät. Er beherrscht DHCP und bezieht bei einem im Netzwerk erreichbaren DHCP Servers von diesem eine IP-Adresse. Da Fhem zwecks Kommunikation die IP-Adresse wissen muss, ist es sinnvoll, dem HMLAN eine statische Adresse zuzuweisen.

  • mit der auf der CD mitgelieferten "HomeMatic Lan-Interface Configurator" Software unter "Change IP Settings" oder
  • im DHCP-Server eine feste IP-Adresse zuzuweisen (sofern dies vom gegeben DHCP Server als Konfigurationsoption unterstützt wird).

AES Encryptet LAN Communication

Wichtig ist aber vor allem, dass vor Verwendung die "AES Encryptet LAN Communication" abgeschaltet wird, da diese von FHEM nicht beherrscht wird. Dies ist unter "Change IP Settings" der "HomeMatic Lan-Interface Configurator" Software möglich. Dies hat nichts mit der HM "AES Encryption" zu tun, die mit dem HMLAN Konfigurator genutzt werden könnte, mit CUL oder CUN(O) aber nicht.

AES System-Sicherheitsschlüssel

Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetzt werden. Da damit aber auch Risiken einhergehen, sollte man vorher den Artikel "AES Encryption" lesen. Der Schlüssel wird mit der Software HomeMatic Konfigurator unter Einstellungen geändert. Nachdem zuvor die "AES Encryptet LAN Communication" deaktiviert wurde, darf bei der "Einstellung für Lan-Interface" nur noch die 10stellige Sereinnummer eingegeben werden, aber nicht mehr der 32stellige Zugriffscode.

Einbindung in FHEM

Dann muss der HMLAN-Konfigurator in FHEM definiert werden. Dazu in die fhem.cfg eintragen:

define HMLAN1 HMLAN <IP Adresse>:1000 
attr HMLAN1 hmId 123ABC

Der Name HMLAN1 kann frei vergeben werden. Der Standard IP-Port des HMLAN-Konfigurators ist 1000.

HMLAN kennt mehrere Attribute (commandref), wichtig ist vor allem, für den HMLAN eine Adresse festzulegen, die HM-ID. Diese muss hexadezimal und 6 stellig sein. 000000 und FFFFFF sind nicht gültig. Jedes Wechseln dieser Adresse erfordert neues pairen aller HM Geräte!

Die Adresse sollte in fhem.cfg in Grossbuchstaben eingegeben werden, siehe "Bekannte Probleme".

Ein gleichzeitiger Zugriff von Fhem und der HomeMatic-Software auf den HMLAN-Konfigurator ist nicht möglich, da letzterer nur eine Verbindung zulässt. Müssen oder wollen Sie temporär also z.B. mit der Windows-Software von HomeMatic zugreifen, ist Fhem zu deaktivieren.

Pairen von Geräten

Jedes HM Geräte muss vor Verwendung mit der HM-Zentrale, hier also dem HMLAN Konfigurator, gepairt werden. Die Adresse der HM Geräte ist nicht frei wählbar, sondern fest in den Geräten eingestellt. Details zum Pairen auf der Seite HomeMatic Devices pairen.

Bekannte Probleme

Die hexadezimale Adresse sollte in der fhem.cfg in Großbuchstaben eingegeben werden, da der HMLAN-Konfigurator seine eigene Adresse ebenfalls in Großbuchstaben zurückgibt. HMLAN.pm überprüft alle 30 Sekunden, ob die Adresse des HMLAN-Konfigurators von der in Fhem eingestellten abweicht und setzt sie ggf. neu. HMLAN.pm in Versionen vor Februar 2012 unterscheidet zwischen Groß- und Kleinschreibung, sodass z.B. 123abc für HMLAN.pm eine andere Adresse als 123ABC ist. Dies führt zum Neusetzen der an sich gleichen Adresse alle 30 Sekunden.

Selten lehnt der HMLAN-Konfigurator ohne erkennbaren Grund nach monatelangem störungsfreiem Betrieb die Verbindung ab:

Opening HMLAN1 device 192.168.168.60:1000
192.168.168.60:1000 connection refused

Der HMLAN-Konfigurator kann aber über die mitgelieferte Konfigurationssoftware problemlos erreicht werden. Der Zustand lässt sich auch durch einen Reboot des HMLAN-Konfigurators (oder Fhem) nicht beheben, wohl aber durch eine Aktualisierung der Firmware des HMLAN-Konfigurators, selbst wenn die installierte Version aktuell ist.

Wenn das Konfigurationsprogramm den HM-CFG-LAN LAN Konfigurations-Adapter zu finden, sollten alle nicht benutzten Netzwerkinterfaces vorübergehend deaktiviert werden. Vereinzelt gibt es Hinweise darauf, dass es unter Windows 7 eventuell nicht reicht, die Netzwerkverbindungen im "Netzwerk- und Freigabecenter" zu deaktivieren, sondern ein Deaktivierung der Netzwerkadapter im Gerätemanager erforderlich ist.

Wechsel von CUL zu HMLAN

Sollten Sie bisher ein CUL für Ihre Homematic-Geräte eingesetzt haben und jetzt einen Wechsel auf den HMLAN Konfigurator planen, hält sich der Umstiegsaufwand in Grenzen:

  • deaktivieren Sie das CUL in der fhem.cfg.
  • konfigurieren Sie den HMLAN Konfigurator von Hand direkt unterhalb der alten CUL-Definition in der fhem.cfg und zwar vor allen referenzierten HM Geräten ("save" nicht vergessen). Falls Sie den HMLAN von FHEM automatisch erkennen und anlegen lassen, dann wird dieser in der fhem.cfg nach den HM-Geräten angelegt und es kann keine Zuweisung der Geräte vorgenommen werden.
    • der HMLAN muss die gleiche hmID wie das bisherige CUL erhalten (ansonsten müssen alle Geräte neu gepairt / angelernt werden).
    • AES muss im HMLAN abgeschaltet werden (das CUL arbeitet auch ohne).
  • verbinden Sie den HMLAN Konfigurator mit ihrem Netzwerk und ziehen das CUL aus der USB-Buchse.
  • geben Sie in der FHEM-Befehlszeile shutdown restart gefolgt von <Enter> (nicht "save") ein (evtl. reicht auch ein rereadcfg).
  • kontrollieren Sie im Event-Monitor und in den HM-Device-Logs von Fhem die Kommunikation.

Bitte beachten: Falls dem CUL keine explizite hmID per Attribut zugewiesen wurde, wird diese ID aus "F1<FHT-ID>" zusammengebaut. Die hmID muss auf dem HMLAN explizit gesetzt werden.

Links

  • Software für den Konfigurationsadapter von der eQ-3 Site