HM-CFG-LAN LAN Konfigurations-Adapter
Vorbemerkungen
Der HomeMatic LAN Konfigurations-Adapter (HMLAN) stellt eine Alternative zum CUN" class="mw-redirectO 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 CUN" class="mw-redirectO / 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
- ...
- HM-LC-SW1-BA-PCB
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. 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 allerHM Geräte!
Die Adresse sollte in fhem.cfg in Grossbuchstaben eingegeben werden, siehe HMLAN Konfigurator.
Ein gleichzeitigerZugriff 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.cfgin 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.pmin Versionen vor Februar 2012 unterscheidet zwischen Upper- und Lowercase, sodass z.b. 123abc für HMLAN.pmeine 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).
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"