Quelltext der Seite HomeMatic Wired RS485 LAN Gateway

== Vorbemerkungen ==
Das [http://www.eq-3.de/produkt-detail-wired/items/homematic-wired-rs485-lan-gateway.html HomeMatic Wired RS485 LAN Gateway], kurz HMW-LAN-GW, stellt eine Alternative zu den [[Serial/Netzwerk-RS485-Adapter]] dar. Laut Hersteller arbeitet das HMW-LAN-GW zwar nur mit der CCU2 als HomeMatic Wired Interface zusammen. Das stimmt so aber nicht. Daher kann das Modul ohne Probleme zusammen mit FHEM zur Kommunikation mit HomeMatic Wired Geräten benutzt werden.


=== HMW-LAN-GW versus Serial/Netzwerk-RS485-Adapter ===

Auf dem freien Markt gibt es jede Menge Serial / USB / Netzwerk zu RS485 Adapter. Diese Adapter gibt es teilweise bereits für wenige Euro und können zumeist als HMW Interface eingesetzt werden. Eine Liste dieser Adapter gibt es hier: [[HMW-LAN|Serial/Netzwerk-RS485-Adaptern]]
Da diese Adapter keine eigene "Intelligenz" besitzen, ist hier zum Betrieb zusätzlich ein Daemon (hm485d.pl) erforderlich. Dieser wird aber, wenn entsprechend konfiguriert, automatisch gestartet und läuft in der Regel unbemerkt im Hintergrund.

== Vorbereitung ==
Bevor man das HMW-LAN-GW mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die Software [http://www.eq-3.de/Downloads/eq3/downloads/HM-Cen-O-TW-x-x-2_Usersoftware_V1_1_eQ-3_130816.zip NetFinder]. Diese Java-Anwendung sollte plattformübergreifend funktionieren. Mit diesem Programm muss die netzwerkseitige AES-Verschlüsselung am HMW-LAN-GW abgeschaltet werden. Ansonsten kann FHEM derzeit nicht mit dem Gateway kommunizieren.
Mit dieser Software lässt sich auch die IP-Adresse des Gateways ändern, falls kein DHCP benutzt werden soll.


== Einbindung in FHEM ==
Zum Einbinden des HMW-LAN-GW müssen folgende Zeilen in die ''fhem.cfg'' eintragen werde:

 define HM485_LAN HM485_LAN &lt;IP Adresse&gt;:1000
 attr HM485_LAN hmwId 00000001
 attr HM485_LAN room HM485

Der Name HM485_LAN kann frei vergeben werden.

HM485_LAN kennt mehrere Attribute, wichtig ist vor allem, für das HMW-LAN-GW eine Adresse festzulegen. Die HMW-ID muss eine 8-stellige Hexadezimalzahl sein.
Theoretisch könnten bis zu 256 HMW-LAN-GW angelegt werden. Diese Annahme ist aktuell aber nur Theorie und noch nicht getestet und ggf. mit einigen Problemen verbunden. Die HMW-ID's für die HMW-Interfaces könnten dafür im Bereich von 00000001 - 000000FF gewählt werden.
Da in den HMW-Geräten die HMW-ID der Zentrale aber mit 00000001 vordefiniert, sollte hier aktuell nur diese ID verwendet werden.

Zu beachten ist auch, dass das HMW-LAN-GW '''gleichzeitig''' nur <ins>eine Netzwerkverbindung</ins> erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* hmwId: Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* do_not_notify: FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.

Die folgenden Attribute sind für das HMW-LAN-GW irrelevant:
* HM485d_bind
* HM485d_startTimeout
* HM485d_device
* HM485d_serialNumber
* HM485d_logfile
* HM485d_detatch
* HM485d_logVerbose
* HM485d_gpioTxenInit
* HM485d_gpioTxenCmd0
* HM485d_gpioTxenCmd1


== Pairen von Geräten ==
Jedes HM Geräte muss vor Verwendung mit der Zentrale, hier also FHEM, gepairt werden. Anders als bei den HomeMatic-Funk-Geräten erfolgt das Pairing bei HMW automatisch, sobald ein Gerät das erste Mal eine Nachricht über den Bus versendet. Alternativ kann das Pairing auch durch das Absetzen eines Discovery-Befehls ausgelöst werden.
Beim Pairen werden die Geräteadressen FHEM bekannt gemacht. Die Adresse der HMW Geräte ist nicht frei wählbar, sondern fest in den Geräten eingestellt. Alle HMW-Geräte haben standardtmäßig die Adresse 00000001 als Zentralen-Adresse gespeichert.

=== Discovery ===
Mit dem Discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
 set HM485_LAN discovery start

Nachdem neue Geräte gefunden worden, werden diese automatisch mit FHEM gepairt.


== RAW-Befehle ==
Über das HMW-LAN-GW können so genannte RAW-Befehle an die am Bus angeschlossenen Geräte gesendet werden. Mit diesen RAW-Befehlen können z.B. Funktionen ausgelöst werden, welche aktuell für ein Gerät noch nicht in FHEM implementiert sind.

'''Beispiel:'''
 set HM485_LAN RAW 01234567 98 00000001 DDDDDD

* 01234567 - entspricht hier der Adresse des Gerätes an das der Befehl gesendet werden soll
* 98 - das so genannte Steuerzeichen (Siehe HMW-Protokoll-Dokumentation)
* 00000001 - die HMW-ID der Zentrale (FHEM)
* DDDDDD - das sind die zu sendenden Daten.

Da zum Senden von RAW-Befehlen Kenntnisse über das HMW-Protokoll vorhanden sein sollten, lohnt sich ein Blick in die [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]


'''Funktionale Beispiele:'''
 # Rollladenaktor öffnen
 set HM485_LAN RAW 01234567 98 00000001 7802C8
 
 # Rollladenaktor stoppen
 set HM485_LAN RAW 01234567 98 00000001 7802C9
 
 # Rollladenaktor schließen
 set HM485_LAN RAW 01234567 98 00000001 780200
 
 # erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
 set HM485_LAN RAW 01234567 98 00000001 730003FF
 
 # erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
 set HM485_LAN RAW 01234567 98 00000001 73000000


== Wechsel von HMW-LAN-GW zu Serial/Netzwerk-RS485-Adaptern ==
Der Wechsel zwischen den verschiedenen Interface-Typen geht einfach und bedarf kein neues Pairing.
Ggf. müssen einige interfacespezifische Attribute in der fhem.cfg hinzugefügt bzw. gelöscht werden. 

== Links ==

* [http://www.eq-3.de/produkt-detail-wired/items/homematic-wired-rs485-lan-gateway.html HomeMatic Wired RS485 LAN Gateway (Hersteller Homepage)]
* [http://www.eq-3.de/Downloads/eq3/downloads/HM-Cen-O-TW-x-x-2_Usersoftware_V1_1_eQ-3_130816.zip NetFinder Software]
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Dokumentation]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interface]]