HM-CFG-LAN LAN Konfigurations-Adapter

2013-08-11T21:45:28Z

Coverh: Hinweis auf Unterstützung des Burst-Modus in neuen Versionen der culfw eingearbeitet

== Vorbemerkungen ==
Der HomeMatic LAN Konfigurations-Adapter (HMLAN) stellt eine Alternative zum [[CUN]]O 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]]O / COC) <ins>umfassend</ins> mit FHEM betrieben werden:

* KeyMatic, Funk-Türschlossantrieb - (HM-Sec-Key, HM-Sec-Key-S, HM-Sec-Key-O, HM-Sec-Key-Generic)
* WinMatic, Funk-Fensterantrieb - (HM-Sec-Win)
* Funk-Rauchmelder - (HM-Sec-SD, HM-Sec-SD-Generic)
* [[HM-Sec-SFA-SM]]
* ...

Grund ist die im CUL / CUNO / COC fehlende AES-Übertragung (KeyMatic).
<br />
<br />
Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab Stand Mai 2013 genutzt werden. In früheren Firmware-Versionen wird der Burst-Modus nicht unterstützt (siehe [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0 hier]).

Betroffen hiervon sind beispielsweise folgende Komponenten:

* Statusanzeige "im Retro-Design" - (HM-Dis-TD-T)
* Schaltaktor für Batteriebetrieb - [[HM-LC-SW1-BA-PCB]]
* Bausatz, Schaltaktor für Batteriebetrieb - (HM-LC-Sw1-Ba-PCB)
* HM-LC-SW4-WM
* HM-RC-19
* HM-RC-19-B
* HM-RC-19-SW
* ...

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

== 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 [http://forum.fhem.de/index.php?t=msg&th=10933&goto=62960&rid=42#msg_62960 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:
[http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 Anleitung für OS X].

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

<nowiki>define HMLAN1 HMLAN <IP Adresse>:1000
attr HMLAN1 hmId 123ABC</nowiki>
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 [[HMLAN_Konfigurator#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:

<nowiki>Opening HMLAN1 device 192.168.168.60:1000
192.168.168.60:1000 connection refused</nowiki>
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]]"

[[Kategorie:HomeMatic Components]]

HM-LC-Sw1-Ba-PCB 1-Kanal-Funk-Schaltaktor für Batteriebetrieb

2013-08-11T21:30:49Z

Coverh: Hinweis auf aktuelle culfw mit Unterstützung des Burst-Modus eingepflegt

'''HM-LC-SW1-BA-PCB'''

HomeMatic Funk-Schaltaktor für Batteriebetrieb 1-Kanal HM-LC-Sw1-BA-PCB

= Features =

Batteriebetriebener Schaltaktor zum Schalten von batterie- oder akkubetriebenen Geräten (max. 20 V bei max. 3 A). Ein Schalten ist über passende Fernbedienungen, HM-Schalter oder per Software (hier FHEM) möglich.

'''Technische Daten:'''
* Spannungsversorgung: 5 - 15 V -
* Stromverbrauch im Burst-Modus: 100 μA
* Schaltausgänge: 1 Open-Drain-Ausgang 3 A max. 20 VDC
* Maße(BxHxT): 45 x 24 x 45 mm

= Hinweise zu Inbetriebnahme und Installation =

Nach der Erstinbetriefnahme sollte die Warnschwelle für zu niedrige Versorgungsspannung eingestellt werden, ansonsten gibt es im Logfile laufend Warnungen. Einstellung auf beispielsweise 6 V mit dem folgenden Befehl:

<nowiki>set CUL_HM_HM_LC_SW1_BA_PCB_xxxxxx regSet lowBatLimitBA 6</nowiki>

<Bitte ergänzen>

= Hinweise zum Betrieb mit FHEM =

Der HM-LC-SW1-BA-PCB kann mit einem [[CUL]] erst mit einer Firmware (culfw) ab Stand Mai 2013 betrieben werden. Grund hierfür ist der Burst-Modus, der in früheren Versionen der culfw nicht unterstützt wird (siehe [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0 hier]).

Alternativ kann zur Ansteuerung des Aktors ein [[HMLAN Konfigurator|HM-LAN]] verwendet werden.
== FHEM Config-Auszug ==
< Bitte ergänzen>
== Mögliche Schaltoperationen ==
< Bitte ergänzen>
== Log-Auszug ==
< Bitte ergänzen>

= Links =

Anleitung: [http://www.elv-downloads.de/Assets/Produkte/10/1048/104895/Downloads/104895_Funk_Schaltaktor_um.pdf PDF]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Empfänger)]]

FHEMWiki - Benutzerbeiträge [de]

HM-CFG-LAN LAN Konfigurations-Adapter

HM-LC-Sw1-Ba-PCB 1-Kanal-Funk-Schaltaktor für Batteriebetrieb