HM-CFG-LAN LAN Konfigurations-Adapter

Vorbemerkungen

Der HomeMatic LAN Konfigurations-Adapter (HMLAN) stellt eine Alternative zum CUL oder 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

Stand 17.01./12.03.2013 können folgende Homematic-Geräte nur mit einem HMLAN (aber nicht mit CUL / CUNO / COC) umfassend mit FHEM betrieben werden:

• KeyMatic, Funk-Türschlossantrieb - (HM-Sec-Key, HM-Sec-Key-S, HM-Sec-Key-O, HM-Sec-Key-Generic)
• Bausatz, Schaltaktor für Batteriebetrieb - (HM-LC-Sw1-Ba-PCB)
• WinMatic, Funk-Fensterantrieb - (HM-Sec-Win)
• Funk-Rauchmelder - (HM-Sec-SD, HM-Sec-SD-Generic)
• Statusanzeige "im Retro-Design" - (HM-Dis-TD-T)
• HM-LC-SW1-BA-PCB
• HM-Sec-SFA-SM
• HM-RC-19
• HM-RC-19-B
• HM-RC-19-SW
• ...

Grund ist die im CUL / CUNO / COC fehlende AES-Übertragung (KeyMatic) und / oder ein fehlender (sogenannter) Burst-Modus (z.B. HM-Dis-TD-T).

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

Siehe z.B. Beiträge im FHEM-Forum, diesen Foren-Eintrag und diesen.

Vorbereitung

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, kann es sinnvoll sein, dem HMLAN Konfigurator zunächst eine statische Adresse zuzuweisen, da bei einer per DHCP vergebenen Adresse nicht sicher ist, dass diese sich nie ändert. Dies ist mit der auf der CD mitgelieferten "HM Lan-Interface Konfigurator" Software möglich. Eleganter ist es natürlich, dem HMLAN im DHCP-Server eine feste Adresse zuzuweisen - sofern dies vom gegeben DHCP Server als Konfigurationsoption unterstützt wird.

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 "HM Lan-Interface Konfigurator" Software möglich (Achtung: Dem HMLAN Konfigurator liegen zwei Konfigurationsprogramme bei, bitte darauf achten, das Richtige zu verwenden).

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. Wenn das Konfigurationsprogramm Probleme hat das HMLAN zu finden, sollten alle nicht benutzten Netzwerkinterfaces vorübergehend deaktiviert werden, siehe FHEM-Foren-Beitrag.

Da die Konfigrationssoftware nur unter Windows läuft, braucht man z.B. für OS X eine Windows Emulation. Damit ist die Konfiguration jedoch problemlos möglich, sieh z.b. hier: Anleitung für OS X.

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. Das Standard IP Port des HMLAN-Konfigurator ist 1000. HMLAN kennt mehrere Attribute (siehe 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 hier: 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ück gibt. 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 Upper- und Lowercase, 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örungsfreien 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-Konfigurator, selbst wenn die installierte Version aktuell 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 man dem CUL keine explizite hmID per Attribut zugewiesen hat, wird diese ID aus "F1<housecode>" zusammengebaut. Die hmID muss man auf dem HMLAN explizit setzen.

Links

Details zu HMs "AES Encryption"