FHEMWiki - Benutzerbeiträge [de]

HM-CC-RT-DN Funk-Heizkörperthermostat

2013-10-28T15:52:34Z

Stefan Sordon: /* Betrieb mit FHEM */

= Allgemeines =

Beim HM-CC-RT-DN handelt es sich um einen Funk-Heizkörperthermostaten, der als Nachfolger den [[HM-CC-VD]] ablöst und seit Mitte September 2013 verfügbar ist.

Im Gegensatz zum Vorgänger misst der HM-CC-RT-DN selbst die Temperatur und verfügt über eine Boost-Funktion. Er braucht zur Steuerung kein separates Raumregelungsgerät mehr und verfügt über eine eigene Fenster-Offen-Erkennung. Laut Aussagen auf der ELV-Produktseite soll ein passender Wandthermostat "im Laufe des Jahres 2014" erscheinen.

Die Unterstützung durch Fhem funktioniert [http://forum.fhem.de/index.php/topic,14738.0.html seit] anfang Oktober 2013:

= Technische Daten =
Aktuelle Firmware: 1.0

= Betrieb mit FHEM =

== Log-Daten ==

Das Funk-Heizkörperthermostat muss zuerst mit Fhem [[HomeMatic_Devices_pairen|gepairt]] werden.
=Fhem-Log=
== Device-Log ==
2013.10.10 20:03:24 3: CUL_HM Unknown device CUL_HM_HM_CC_RT_DN_2212BC, please define it
2013.10.10 20:03:24 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC CUL_HM 2212BC A1A0184002212BC0000001000954B4551303531303031375900FFFF
2013.10.10 20:03:24 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: CUL_HM_HM_CC_RT_DN_2212BC thermostat, model HM-CC-RT-DN serialNr KEQ0510017
2013.10.10 20:03:24 3: LANCUL pairing (hmPairForSec) not enabled
2013.10.10 20:03:24 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC-%Y.log CUL_HM_HM_CC_RT_DN_2212BC
2013.10.10 20:03:24 3: Device Heizung_Wohnzimmer added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: Heizung_Wohnzimmer thermostat, model HM-CC-TC serialNr JEQ0044286
2013.10.10 20:03:24 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: CUL_HM_HM_CC_RT_DN_2212BC thermostat, model HM-CC-RT-DN serialNr KEQ0510017
2013.10.10 20:03:25 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_Weather CUL_HM 2212BC01
2013.10.10 20:03:25 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Weather FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Weather-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Weather
2013.10.10 20:03:25 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Weather FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Weather-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Weather
2013.10.10 20:03:26 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_Climate CUL_HM 2212BC02
2013.10.10 20:03:26 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Climate FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Climate-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Climate
2013.10.10 20:03:26 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Climate FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Climate-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Climate
2013.10.10 20:03:27 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_WindowRec CUL_HM 2212BC03
2013.10.10 20:03:27 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_WindowRec FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_WindowRec-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_WindowRec
2013.10.10 20:03:27 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_WindowRec FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_WindowRec-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_WindowRec
2013.10.10 20:03:28 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr CUL_HM 2212BC04
2013.10.10 20:03:28 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr
2013.10.10 20:03:28 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr
2013.10.10 20:03:29 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam CUL_HM 2212BC05
2013.10.10 20:03:29 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam
2013.10.10 20:03:29 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam
2013.10.10 20:03:30 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_remote CUL_HM 2212BC06
2013.10.10 20:03:30 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_remote FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_remote-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_remote
2013.10.10 20:03:30 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_remote FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_remote-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_remote
2013.10.10 20:03:35 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:40 2: CUL_HM set CUL_HM_HM_CC_RT_DN_2212BC getSerial
2013.10.10 20:03:40 2: CUL_HM set CUL_HM_HM_CC_RT_DN_2212BC getConfig
2013.10.10 20:03:54 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time

== Event monitor ==
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr motorErr: ok
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr measured-temp: 18.4
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr desired-temp: 18
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr ValvePosition: 3 %
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr mode: manu
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr unknown0: 24
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr T: 18.4 desired: 18 valve: 3 %
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC battery: ok
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC batteryLevel: 3.1 V
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC measured-temp: 18.4
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC desired-temp: 18
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC actuator: 3 %

== Probleme ==

= Links =

* [http://www.elv.de/homematic-heizkoerperthermostat-1.html Produktinfo]
* [http://www.elv-downloads.de/Assets/Produkte/10/1051/105155/Downloads/105155_thermostat_um.pdf Bedienungsanleitung (PDF)]
* [http://www.elv-downloads.de/Assets/Produkte/10/1051/105155/Downloads/105155_thermostat_data.pdf Datenblatt (PDF)]
* [http://www.elv-downloads.de/service/manuals/ventilkompatibilitaet.pdf Ventil-Kompatibilitätsliste (PDF)]
[[Kategorie:HomeMatic Components]]
[[Kategorie:Heizungsventile]]

HM-CC-RT-DN Funk-Heizkörperthermostat

2013-10-28T15:35:49Z

Stefan Sordon: /* Allgemeines */

= Allgemeines =

Beim HM-CC-RT-DN handelt es sich um einen Funk-Heizkörperthermostaten, der als Nachfolger den [[HM-CC-VD]] ablöst und seit Mitte September 2013 verfügbar ist.

Im Gegensatz zum Vorgänger misst der HM-CC-RT-DN selbst die Temperatur und verfügt über eine Boost-Funktion. Er braucht zur Steuerung kein separates Raumregelungsgerät mehr und verfügt über eine eigene Fenster-Offen-Erkennung. Laut Aussagen auf der ELV-Produktseite soll ein passender Wandthermostat "im Laufe des Jahres 2014" erscheinen.

Die Unterstützung durch Fhem funktioniert [http://forum.fhem.de/index.php/topic,14738.0.html seit] anfang Oktober 2013:

= Technische Daten =
Aktuelle Firmware: 1.0

= Betrieb mit FHEM =

== Log-Daten ==

=== Device-Log ===
2013.10.10 20:03:24 3: CUL_HM Unknown device CUL_HM_HM_CC_RT_DN_2212BC, please define it
2013.10.10 20:03:24 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC CUL_HM 2212BC A1A0184002212BC0000001000954B4551303531303031375900FFFF
2013.10.10 20:03:24 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: CUL_HM_HM_CC_RT_DN_2212BC thermostat, model HM-CC-RT-DN serialNr KEQ0510017
2013.10.10 20:03:24 3: LANCUL pairing (hmPairForSec) not enabled
2013.10.10 20:03:24 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC-%Y.log CUL_HM_HM_CC_RT_DN_2212BC
2013.10.10 20:03:24 3: Device Heizung_Wohnzimmer added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: Heizung_Wohnzimmer thermostat, model HM-CC-TC serialNr JEQ0044286
2013.10.10 20:03:24 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:24 3: CUL_HM pair: CUL_HM_HM_CC_RT_DN_2212BC thermostat, model HM-CC-RT-DN serialNr KEQ0510017
2013.10.10 20:03:25 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_Weather CUL_HM 2212BC01
2013.10.10 20:03:25 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Weather FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Weather-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Weather
2013.10.10 20:03:25 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Weather FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Weather-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Weather
2013.10.10 20:03:26 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_Climate CUL_HM 2212BC02
2013.10.10 20:03:26 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Climate FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Climate-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Climate
2013.10.10 20:03:26 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_Climate FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_Climate-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_Climate
2013.10.10 20:03:27 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_WindowRec CUL_HM 2212BC03
2013.10.10 20:03:27 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_WindowRec FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_WindowRec-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_WindowRec
2013.10.10 20:03:27 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_WindowRec FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_WindowRec-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_WindowRec
2013.10.10 20:03:28 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr CUL_HM 2212BC04
2013.10.10 20:03:28 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr
2013.10.10 20:03:28 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr
2013.10.10 20:03:29 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam CUL_HM 2212BC05
2013.10.10 20:03:29 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam
2013.10.10 20:03:29 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_ClimaTeam
2013.10.10 20:03:30 2: autocreate: define CUL_HM_HM_CC_RT_DN_2212BC_remote CUL_HM 2212BC06
2013.10.10 20:03:30 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_remote FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_remote-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_remote
2013.10.10 20:03:30 2: autocreate: define FileLog_CUL_HM_HM_CC_RT_DN_2212BC_remote FileLog /usr/local/FHEM/var/log/CUL_HM_HM_CC_RT_DN_2212BC_remote-%Y.log CUL_HM_HM_CC_RT_DN_2212BC_remote
2013.10.10 20:03:35 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time
2013.10.10 20:03:40 2: CUL_HM set CUL_HM_HM_CC_RT_DN_2212BC getSerial
2013.10.10 20:03:40 2: CUL_HM set CUL_HM_HM_CC_RT_DN_2212BC getConfig
2013.10.10 20:03:54 3: Device CUL_HM_HM_CC_RT_DN_2212BC added to ActionDetector with 000:10 time

=== Event monitor ===
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr motorErr: ok
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr measured-temp: 18.4
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr desired-temp: 18
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr ValvePosition: 3 %
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr mode: manu
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr unknown0: 24
2013-10-12 12:05:35.610 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC_ClimRT_tr T: 18.4 desired: 18 valve: 3 %
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC battery: ok
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC batteryLevel: 3.1 V
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC measured-temp: 18.4
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC desired-temp: 18
2013-10-12 12:05:35.646 CUL_HM CUL_HM_HM_CC_RT_DN_2212BC actuator: 3 %

== Probleme ==

= Links =

* [http://www.elv.de/homematic-heizkoerperthermostat-1.html Produktinfo]
* [http://www.elv-downloads.de/Assets/Produkte/10/1051/105155/Downloads/105155_thermostat_um.pdf Bedienungsanleitung (PDF)]
* [http://www.elv-downloads.de/Assets/Produkte/10/1051/105155/Downloads/105155_thermostat_data.pdf Datenblatt (PDF)]
* [http://www.elv-downloads.de/service/manuals/ventilkompatibilitaet.pdf Ventil-Kompatibilitätsliste (PDF)]
[[Kategorie:HomeMatic Components]]
[[Kategorie:Heizungsventile]]

HomeMatic Devices pairen

2013-10-28T14:53:17Z

Stefan Sordon: /* FHEM Einstellungen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM (bzw. dem CUL/CUN/HMLAN Konfigurator) gepairt werden, damit sie angesprochen werden können. Das Pairing funktioniert anders als bei FHT Devices, da die ID der HomeMatic Geräte nicht frei vergeben (am Gerät eingestellt) werden kann, sondern im Gerät fest vergeben ist. Daher empfiehlt es sich, die Geräte per Autocreate anlegen zu lassen, und den "Define"- Befehl nicht manuell in die fhem.cg einzutragen.
=Schnittstellen Einstellungen=

Folgende Schritte sind durchzuführen:

==CUL==
* CUL anschließen, bzw. CUN(O) oder HMLAN Konfigurator im Netzwerk anmelden
* CUL dem System bekannt machen und in den HomeMatic-Modus versetzen, z.B.:

define CULx CUL /dev/ttyACM0@38400 1234
attr CULx rfmode HomeMatic

x = numerischer Wert

==CUNO==
Beim CUNO ist die Vorgehensweise identisch

define CUNO CULx 192.168.xxx.xxx:2323 1234 (zutreffende IP Adresse eintragen)
attr CULx rfmode HomeMatic

x = numerischer Wert

==HMLAN Konfiguartor==
Beim HMLAN Konfigurator zuerst unbedingt [[HMLAN Konfigurator#3. AES Encryptet LAN Communication|AES Encryption]] mittels der mitgelieferten Software abschalten

define HMLAN1 HMLAN 192.168.xxx.xxx:1000 (zutreffende IP Adresse eintragen)
attr HMLAN1 hmId 123ABC (123ABC steht für eine beliebige 6stellige hex Adresse)

=FHEM Einstellungen=
Sicherstellen, das Autocreate aktiv ist, z.b. durch einfügen folgender Zeilen in die fhem.cfg

define autocreate autocreate
attr autocreate autosave

Achtung: Da autocreate u.U. einem bei vorheriger manueller Verfassung der fhem.cfg diese gehörig umstellt, unbedingt vorher eine Sicherheitskopie erstellen.

* fhem.cfg speichern (telnet oder im Webinterface "save" eingeben)

* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu per Telnet oder in der Commandzeile des Webinterfaces (oder in der Weboberfläche das passende set-Kommando beim CUL/CUNO/HMLAN eintragen)

set CUL1 hmPairForSec 600
oder
set CUNO1 hmPairForSec 600
oder
set HMLAN1 hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist.

Alternativ kann bei bereits bekanntem FHEM Device <name> mit:

set <name> pair

ein gezieltes Pairing veranlasst werden.

== Devices pairen ==

Dazu ist meistens ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden.
Bei Fernbedienungen muss auch oft ein spezieller Pairingknopf betätigt werden und anschliessend eine Kanaltaste. (Handbuch des Gerätes beachten)

Jetzt werden die Devices von autocreate erkannt und alle notwendigen Eintragungen werden in fhem.cfg eingetragen. Diese Einträge haben das Format

define <name> CUL_HM <6-digit-hex-code>"

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired, dann das Gerät in den Auslieferungszustand bringen (Knopf mindestens 5 Sekunden drücken, bis es blinkt, dann loslassen und nochmals 5 Sekunden drücken, bis es schneller blinkt) und danach erneut pairen.

Wenn das zu pairende Geräte ein Empfänger ist, kann mit FHEM per Telnet oder in der Kommandzeile des Webinterfaces folgendes Kommando abgesetzt werden:

hmPairSerial <10-stellige Seriennummer>

Die 10-stellige Seriennummer ist beim Empfängern idR. auf der Rückseite des Geräte aufgedruckt. Die Seriennummer fängt normalerweise mit Buchstaben an und endet mit Zahlen.

Es gilt auch sicherzustellen, dass das zu pairende Gerät nicht bereits zuvor mit der Homematic Config Software gepairt wurde. Ist dies der Fall, so sollte das Pairing in der Homematic Config Software gelöscht und das Pairing in FHEM erneut durchgeführt werden.

[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2013-10-28T13:46:44Z

Stefan Sordon: /* Vorgehen Allgemein */ Neu Gliederung

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM (bzw. dem CUL/CUN/HMLAN Konfigurator) gepairt werden, damit sie angesprochen werden können. Das Pairing funktioniert anders als bei FHT Devices, da die ID der HomeMatic Geräte nicht frei vergeben (am Gerät eingestellt) werden kann, sondern im Gerät fest vergeben ist. Daher empfiehlt es sich, die Geräte per Autocreate anlegen zu lassen, und den "Define"- Befehl nicht manuell in die fhem.cg einzutragen.
=Schnittstellen Einstellungen=

Folgende Schritte sind durchzuführen:

==CUL==
* CUL anschließen, bzw. CUN(O) oder HMLAN Konfigurator im Netzwerk anmelden
* CUL dem System bekannt machen und in den HomeMatic-Modus versetzen, z.B.:

define CULx CUL /dev/ttyACM0@38400 1234
attr CULx rfmode HomeMatic

x = numerischer Wert

==CUNO==
Beim CUNO ist die Vorgehensweise identisch

define CUNO CULx 192.168.xxx.xxx:2323 1234 (zutreffende IP Adresse eintragen)
attr CULx rfmode HomeMatic

x = numerischer Wert

==HMLAN Konfiguartor==
Beim HMLAN Konfigurator zuerst unbedingt [[HMLAN Konfigurator#3. AES Encryptet LAN Communication|AES Encryption]] mittels der mitgelieferten Software abschalten

define HMLAN1 HMLAN 192.168.xxx.xxx:1000 (zutreffende IP Adresse eintragen)
attr HMLAN1 hmId 123ABC (123ABC steht für eine beliebige 6stellige hex Adresse)

=FHEM Einstellungen=
Sicherstellen, das Autocreate aktiv ist, z.b. durch einfügen folgender Zeilen in die fhem.cfg

define autocreate autocreate
attr autocreate autosave

Achtung: Da autocreate u.U. einem bei vorheriger manueller Verfassung der fhem.cfg diese gehörig umstellt, unbedingt vorher eine Sicherheitskopie erstellen.

* fhem.cfg speichern (telnet oder im Webinterface "save" eingeben)

* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu per Telnet oder in der Commandzeile des Webinterfaces (oder in der Weboberfläche das passende set-Kommando beim CUL/CUNO/HMLAN eintragen)

set CUL hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist.

Alternativ kann bei bereits bekanntem FHEM Device <name> mit:

set <name> pair

ein gezieltes Pairing veranlasst werden.

== Devices pairen ==

Dazu ist meistens ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden.
Bei Fernbedienungen muss auch oft ein spezieller Pairingknopf betätigt werden und anschliessend eine Kanaltaste. (Handbuch des Gerätes beachten)

Jetzt werden die Devices von autocreate erkannt und alle notwendigen Eintragungen werden in fhem.cfg eingetragen. Diese Einträge haben das Format

define <name> CUL_HM <6-digit-hex-code>"

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired, dann das Gerät in den Auslieferungszustand bringen (Knopf mindestens 5 Sekunden drücken, bis es blinkt, dann loslassen und nochmals 5 Sekunden drücken, bis es schneller blinkt) und danach erneut pairen.

Wenn das zu pairende Geräte ein Empfänger ist, kann mit FHEM per Telnet oder in der Kommandzeile des Webinterfaces folgendes Kommando abgesetzt werden:

hmPairSerial <10-stellige Seriennummer>

Die 10-stellige Seriennummer ist beim Empfängern idR. auf der Rückseite des Geräte aufgedruckt. Die Seriennummer fängt normalerweise mit Buchstaben an und endet mit Zahlen.

Es gilt auch sicherzustellen, dass das zu pairende Gerät nicht bereits zuvor mit der Homematic Config Software gepairt wurde. Ist dies der Fall, so sollte das Pairing in der Homematic Config Software gelöscht und das Pairing in FHEM erneut durchgeführt werden.

[[Kategorie:HOWTOS]]

HM-CFG-LAN LAN Konfigurations-Adapter

2013-10-28T13:31:29Z

Stefan Sordon: /* Vorbereitung */ Neue Version

[[Datei:HM-CFG-LAN.jpg|thumb|right|HomeMatic LAN Konfigurations-Adapter]]
== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php/topic,12902.0.html| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]][[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.511 (Stand 28. Oktober 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 ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===1. 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.
===2. 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).
===3. 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.
===4. AES System-Sicherheitsschlüssel===
Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetz werden. Da damit aber auch Risiken mit einhergehen, sollte man vorher den Artikel "[[AES Encryption]]" lesen. Der Schlüssel wird mit der Software ''HomeMatic Konfigurator'' unter ''Einstellungen'' geändert. Nach der unter Punkt 3 deaktivierten "AES Encryptet LAN Communication" 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:

<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 ([http://fhem.de/commandref.html#HMLAN 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]]
[[Kategorie:Interface]]

HM-CFG-LAN LAN Konfigurations-Adapter

2013-10-02T19:21:13Z

Stefan Sordon: /* Vorbereitung */ Typo

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]][[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.509 (Stand September 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 ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===1. 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.
===2. 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).
===3. 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.
===4. AES System-Sicherheitsschlüssel===
Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetz werden. Da damit aber auch Risiken mit einhergehen, sollte man vorher den Artikel "[[AES Encryption]]" lesen. Der Schlüssel wird mit der Software ''HomeMatic Konfigurator'' unter ''Einstellungen'' geändert. Nach der unter Punkt 3 deaktivierten "AES Encryptet LAN Communication" 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:

<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 ([http://fhem.de/commandref.html#HMLAN 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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T12:16:54Z

Stefan Sordon: /* Einbindung in FHEM */ link zur commandref

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-[[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]
3.de/software.html HomeMatic] in der Version 1.509 (Stand September 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 ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===1. 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.
===2. 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).
===3. 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.
===4. AES System-Sicherheitsschlüssel===
Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetz werden. Da damit aber auch Risiken mit einhergehen, sollte man vorher den Artikel "[[AES Encryption]]" lesen. Der Schlüssel wird mit der Software ''HomeMatic Konfigurator'' unter ''Einstellungen'' geändert. Nach der unter Punkt 3 deaktivierten "AES Encryptet LAN Communication" 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:

<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 ([http://fhem.de/commandref.html#HMLAN 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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T12:03:07Z

Stefan Sordon: /* Vorbereitung */

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-[[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]
3.de/software.html HomeMatic] in der Version 1.509 (Stand September 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 ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===1. 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.
===2. 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).
===3. 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.
===4. AES System-Sicherheitsschlüssel===
Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetz werden. Da damit aber auch Risiken mit einhergehen, sollte man vorher den Artikel "[[AES Encryption]]" lesen. Der Schlüssel wird mit der Software ''HomeMatic Konfigurator'' unter ''Einstellungen'' geändert. Nach der unter Punkt 3 deaktivierten "AES Encryptet LAN Communication" 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:

<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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T12:02:10Z

Stefan Sordon: /* Vorbereitung */ AES Schlüssel

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.509 (Stand September 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 ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===1. 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.
===2. 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).
===3. 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.
[[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]
===4. AES System-Sicherheitsschlüssel===
Um die Sicherheit zu steigern kann der AES Schlüssel auf einen eigenen Wert gesetz werden. Da damit aber auch Risiken mit einhergehen, sollte man vorher den Artikel "[[AES Encryption]]" lesen. Der Schlüssel wird mit der Software ''HomeMatic Konfigurator'' unter ''Einstellungen'' geändert. Nach der unter Punkt 3 deaktivierten "AES Encryptet LAN Communication" 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:

<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]]

Datei:HMLAN CONFIG AES.png

2013-09-30T11:50:36Z

Stefan Sordon:

HM-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T11:29:43Z

Stefan Sordon: /* Firmware */

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|400px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die Software '''''"HomeMatic Lan-Interface Configurator"''''' die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.509 (Stand September 2013) herunter zu laden ist und nach der Installation mit der Verknüpfung "HomeMatic-Lan-Interface konfigurieren" gestartet wird und unter Windows läuft. Für andere Betriebssystem ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===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.
===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.

== 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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T11:27:23Z

Stefan Sordon: /* Vorbereitung */

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|400px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die Software '''''"HomeMatic Lan-Interface Configurator"''''' die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.509 (Stand September 2013) herunter zu laden ist und nach der Installation mit der Verknüpfung "HomeMatic-Lan-Interface konfigurieren" gestartet wird und unter Windows läuft. Für andere Betriebssystem ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===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.
===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. Dazu muss der AES Schlüssel (Standart Schlüssel FC57F61DAF9C72741D3CD6B40719CA46), der auf der Rückseite des Gerätes notiert ist, eingegeben werden.

== 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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T11:02:17Z

Stefan Sordon: /* Vorbereitung */ Typo

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|400px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die auf der CD mitgelieferte Software '''''"HomeMatic Lan-Interface Configurator"''''' die mit der Verknüpfung "HomeMatic-Lan-Interface konfigurieren" gestartet wird und unter Windows läuft. Für andere Betriebssystem ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===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.
===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. Dazu muss der AES Schlüssel (Standart Schlüssel FC57F61DAF9C72741D3CD6B40719CA46), der auf der Rückseite des Gerätes notiert ist, eingegeben werden.

== 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]]

Datei:HMLAN CONFIG IP AES.png

2013-09-30T10:52:53Z

Stefan Sordon: Stefan Sordon lud eine neue Version von „Datei:HMLAN CONFIG IP AES.png“ hoch

HomeMatic Lan-Interface Configurator

HM-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T10:48:28Z

Stefan Sordon: /* Vorbereitung */ Verbesserung

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|400px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die auf der CD mitgelieferte Software '''''"HomeMatic Lan-Interface Configurator"''''' die mit der Verknüpfung "Find and Setup Lan Interfaces" gestartet wird und unter Windows läuft. Für andere Betriebssystem ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===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.
===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. Dazu muss der AES Schlüssel (Standart Schlüssel FC57F61DAF9C72741D3CD6B40719CA46), der auf der Rückseite des Gerätes notiert ist, eingegeben werden.

== 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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T10:47:09Z

Stefan Sordon: /* Vorbereitung */ Neue Gliederung

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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 ==
[[Datei:HMLAN_CONFIG_IP_AES.png|400px|thumb|right|HomeMatic Lan-Interface Configurator]]Bevor man den HMLAN mit FHEM nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man die auf der CD mitgelieferte Software '''''"HomeMatic Lan-Interface Configurator"''''' die mit der Verknüpfung "Find and Setup Lan Interfaces" nur unter Windows läuft. Für andere Betriebssystem ([http://forum.fhem.de/index.php?t=msg&th=11506&goto=67417&rid=417#msg_67417 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 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].

===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.
===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. Dazu muss der AES Schlüssel (Standart Schlüssel FC57F61DAF9C72741D3CD6B40719CA46), der auf der Rückseite des Gerätes notiert ist, eingegeben werden.

== 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]]

Datei:HMLAN CONFIG IP AES.png

2013-09-30T10:45:29Z

Stefan Sordon: HomeMatic Lan-Interface Configurator

HomeMatic Lan-Interface Configurator

HM-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T09:54:55Z

Stefan Sordon: /* Vorbemerkungen */ Geräete Namen ergänzt

== Vorbemerkungen ==
Der HomeMatic Konfigurations-Adapter LAN ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T09:45:33Z

Stefan Sordon: /* HMLAN versus CUL / CUNO / COC */ Neue Gliederung

== 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 ===

====AES====
Auf Grund der fehlende [[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.

* 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]])
* Funk-Sirenensteuerung [[HM-Sec-SFA-SM]])
* ...
====Burst-Modus====
Homematic Komponenten die den Burst-Modus zur Übertragung nutzen, können nur mit einer CUL-Firmware (culfw) ab [http://forum.fhem.de/index.php?t=msg&th=12902&start=0&rid=0| Mai 2013] genutzt werden.

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]])
* Funk-Schaltaktor 4-fach ([[HM-LC-SW4-WM]])
* Funk-Fernbedienung 19 Tasten ([[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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T09:18:35Z

Stefan Sordon: /* HMLAN versus CUL / CUNO / COC */ Typo

== 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 ===

Auf Grund der fehlende [[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.

* 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]]
* ...
<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-CFG-LAN LAN Konfigurations-Adapter

2013-09-30T09:17:18Z

Stefan Sordon: /* HMLAN versus CUL / CUNO / COC */ Satzumbau

== 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 ===

Auf Grund der fehlende [[AES Encryption]] (Stand 12.03.2013) im CUL / CUNO / COC können Homematic-Geräte, bei denen Sie der AES Modus nicht deaktivieren lässt, nur mit einem HMLAN am 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]]
* ...
<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]]

AES Encryption

2013-09-30T09:14:12Z

Stefan Sordon: /* Erhöhung der Sicherheit durch Vergabe eines eigenen Schlüssels */ Typo

Anders als der Name vermuteten lässt, handelt es sich beim HM-AES-Encryption Modus ("BidCos") nicht um tatsächlich encrypteten Funkverkehr, sondern um das Einschalten eines Signingrequest-Modus (AES-Challenge-Response (CR)). Hierdurch soll sichergestellt werden, dass der Funkbefehl auch tatsächlich von der Zentrale kommt, die ihn vorgeblich gesendet hat.

== Details ==
Wenn die AES-Signierung an einem HomeMatic-Gerät eingeschaltet wird, führt ein Aktor einen empfangenen Befehl nicht sofort aus, sondern fragt beim Absender zurück. Dieser muss dann mit einer Bestätigung antworten. Erst dann wird der Befehl tatsächlich ausgeführt. Die AES Challenge-Response Antwort wird dabei mit dem Systemschlüssel erzeugt. Der Systemschlüssel wird von der Zentrale bzw. dem [[HMLAN Konfigurator]] auf alle gepairten HomeMatic Geräte verteilt. Standardmäßig ist hier ab Werk ein einheitlicher Standardschlüssel hinterlegt. Dieser ist in '''allen''' HM-Geräten gleich.
Der Standardschlüssel kann vom Nutzer geändert werden, jedoch bringt dies ggf. einige Nachteile mit sich. Es wird daher verschiedentlich empfohlen, den Schlüssel zumindest solange der werksseitig voreingestellte Schlüssel noch nicht bekannt ist, nicht zu verändern (Details siehe weiter unten).

Der Funkverkehr selbst ist nicht verschlüsselt.

Diese Methode soll die Sicherheit erhöhen, indem der Aktor selber nachfragen kann, ob der Funkbefehl auch tatsächlich von einem autorisierten Absender gekommen ist. Da aber alle HM-Geräte bei der Auslieferung den selben Standardschlüssel besitzen, könnte prinzipiell jede Zentrale (CCU) bzw. jeder HMLAN-Konfigurator mit der entsprechenden eingestellten HM-ID fremde Geräte mit Standardschlüssel steuern.

Es ist daher möglich, mit einem HMLAN-Konfigurator, der per FHEM die richtige HM-ID eingestellt hat, alle Aktoren einer fremden Installation zu schalten (die 3-Byte grosse HM-ID ist Bestandteil der Signingantwort), sofern der werksseitig voreingestellte Schlüssel nicht verändert wurde.

Um hier also einen echten Sicherheitsgewinn zu erzielen, muss daher '''zwingend''' ein eigener Systemschlüssel vergeben werden.

== Nachteile der AES-Signierung Methode ==
* Bis der Aktor schaltet, ist mehr Funkverkehr erforderlich. Anstatt 2 werden 4 Messages versendet (anstatt nach einer wird nach drei Messages geschaltet), die Verzögerung ist deutlich merkbar. Die Batteriebelastung ist ebenfalls höher.
* Jedes Kommando und seine Bestätigung wird unverschlüsselt versendet, so dass Beobachter von außen den Zustand jedes Aktors durch Mitlesen des Funkverkehrs kennen können. Dies trifft auch bei selbst gesetztem Schlüssel zu.
* Durch Fehler in der Firmware verschiedener Aktoren werden Toggle-Kommandos zumindest bei einigen Schaltern (HM-LC-Sw1-Pl und HM-LC-SW2-PB-FM) vor Eintreffen des Signingpaketes geschaltet. Bei einem Test einem HM-LC-SW1-PL mit Firmware Version 1.9 konnte dieses Verhalten allerdings nicht reproduziert werden. In dieser Version scheint der Bug nicht mehr existent zu sein.
* durch Nutzung des HMLAN-Konfigurators ggf. umgehen des Singnings bei der Nutzung des Standardschlüssels möglich (siehe oben).
* CUL und CUN(O) unterstützen die AES-Signierung nicht. Werden HM-Aktoren mit eingeschalteter AES-Signierung an eine CCU oder einem HMLAN-Konfigurator angelernt (gepairt), so können sie von einem CUL trotz gleicher HMID nicht gesteuert werden. Bei einem Wechsel der Zentrale bzw. des HMLAN-Konfigurators müssen alle Geräte an der neuen Zentrale bzw. dem HMLAN-Konfigurator wieder angelernt werden.
* Ein faktischer Sicherheitsgewinn ist nur gegeben, wenn ein eigener System-Sicherheitsschlüssel genutzt wird.
== Erhöhung der Sicherheit durch Vergabe eines eigenen Schlüssels ==
Eine Steigerung der Sicherheit ergibt sich nur, wenn man den werksseitig vorgegeben Schlüssel ändert.

Solange Angreifern dieser unbekannt bleibt, ist ein Fremdschalten nicht mehr möglich (wohl aber ein Ermitteln des aktuellen Schaltzustandes durch Mitschneiden des Funkverkehrs, da der Funkverkehr selbst nicht verschlüsselt ist).

Das gesamte System ist in der Handhabung dann aber etwas aufwändiger. So ist es dann z.B. nicht möglich den Sicherheitsschlüssel in einzelnen Aktoren selbst zurückzusetzen. Nur die Zentrale bzw. der HMLAN-Konfigurator kann einen Schlüssel an alle angelernten Komponenten verteilen bzw. angelernte Module in den Werkszustand setzen (Schlüssel wird auf Werksschlüssel zurückgesetzt).

Wenn also ein eigener Schlüssel vergeben wurde und dieser später nicht mehr bekannt ist, dann die Zentrale zurückgesetzt wird (oder eine defekte gegen eine neue mit Werksschlüssel ausgetauscht wird) ohne dass die Komponenten vorher auf Werkseinstellung zurückgesetzt wurden, dann sind die entsprechenden Komponenten (Sensoren, Aktoren und Sender) erst einmal nicht mehr verwendbar.
Wenn man also den selbst gesetzten Schlüssel vergessen / verloren hat, hilft nur noch ein Zurücksetzen beim Hersteller. Dabei fallen dann natürlich entsprechende Kosten an.

'''WICHTIG''': den eigenen Sicherheitsschlüssel gut und sicher aufbewahren.

Wenn man ein Gerät mit gesetztem eigenem Sicherheitsschlüssel an eine andere/neue Zentrale anlernen möchte, so wird man während des Anlernvorgangs nach dem eigenen Sicherheitsschlüssel gefragt.

Da die Schlüsselimplementation der CCU in älteren Firmwareversionen (vor 1.504) z.T. mit Bugs behaftet ist, ergeben sich Risiken selbst dann, wenn der Schlüssel bekannt ist. So darf der Schlüssel z.b. keinesfalls ein "&" enthalten. Gelegentlich wird auch berichtet, dass garantiert richtig eingegebene Schlüssel bei Systemwechseln nicht akzeptiert wurden.

'''WICHTIG''': Sicherheitshalber keine Sonderzeichen im eigenen Sicherheitsschlüssel verwenden.

Der AES-Signier-Schlüssel kann derzeit nicht von FHEM gesetzt werden, sondern muss im [[HMLAN Konfigurator]] per mitgelieferter HomeMatic-Software gesetzt werden.

Die AES-Signierung kann mit einigen Ausnahmen in jedem HM-Gerät separat aktiviert/deaktiviert werden.
In einigen Geräte wie z.B. dem KeyMatic kann die AES-Signierung nicht abgeschaltet werden. Diese Geräte kommunizieren '''immer''' AES-Signiert mit der Zentrale bzw. dem HMLAN-Konfigurator.

[[Kategorie:HomeMatic Components]]

AES Encryption

2013-09-30T09:10:34Z

Stefan Sordon: /* Details */ Typo

Anders als der Name vermuteten lässt, handelt es sich beim HM-AES-Encryption Modus ("BidCos") nicht um tatsächlich encrypteten Funkverkehr, sondern um das Einschalten eines Signingrequest-Modus (AES-Challenge-Response (CR)). Hierdurch soll sichergestellt werden, dass der Funkbefehl auch tatsächlich von der Zentrale kommt, die ihn vorgeblich gesendet hat.

== Details ==
Wenn die AES-Signierung an einem HomeMatic-Gerät eingeschaltet wird, führt ein Aktor einen empfangenen Befehl nicht sofort aus, sondern fragt beim Absender zurück. Dieser muss dann mit einer Bestätigung antworten. Erst dann wird der Befehl tatsächlich ausgeführt. Die AES Challenge-Response Antwort wird dabei mit dem Systemschlüssel erzeugt. Der Systemschlüssel wird von der Zentrale bzw. dem [[HMLAN Konfigurator]] auf alle gepairten HomeMatic Geräte verteilt. Standardmäßig ist hier ab Werk ein einheitlicher Standardschlüssel hinterlegt. Dieser ist in '''allen''' HM-Geräten gleich.
Der Standardschlüssel kann vom Nutzer geändert werden, jedoch bringt dies ggf. einige Nachteile mit sich. Es wird daher verschiedentlich empfohlen, den Schlüssel zumindest solange der werksseitig voreingestellte Schlüssel noch nicht bekannt ist, nicht zu verändern (Details siehe weiter unten).

Der Funkverkehr selbst ist nicht verschlüsselt.

Diese Methode soll die Sicherheit erhöhen, indem der Aktor selber nachfragen kann, ob der Funkbefehl auch tatsächlich von einem autorisierten Absender gekommen ist. Da aber alle HM-Geräte bei der Auslieferung den selben Standardschlüssel besitzen, könnte prinzipiell jede Zentrale (CCU) bzw. jeder HMLAN-Konfigurator mit der entsprechenden eingestellten HM-ID fremde Geräte mit Standardschlüssel steuern.

Es ist daher möglich, mit einem HMLAN-Konfigurator, der per FHEM die richtige HM-ID eingestellt hat, alle Aktoren einer fremden Installation zu schalten (die 3-Byte grosse HM-ID ist Bestandteil der Signingantwort), sofern der werksseitig voreingestellte Schlüssel nicht verändert wurde.

Um hier also einen echten Sicherheitsgewinn zu erzielen, muss daher '''zwingend''' ein eigener Systemschlüssel vergeben werden.

== Nachteile der AES-Signierung Methode ==
* Bis der Aktor schaltet, ist mehr Funkverkehr erforderlich. Anstatt 2 werden 4 Messages versendet (anstatt nach einer wird nach drei Messages geschaltet), die Verzögerung ist deutlich merkbar. Die Batteriebelastung ist ebenfalls höher.
* Jedes Kommando und seine Bestätigung wird unverschlüsselt versendet, so dass Beobachter von außen den Zustand jedes Aktors durch Mitlesen des Funkverkehrs kennen können. Dies trifft auch bei selbst gesetztem Schlüssel zu.
* Durch Fehler in der Firmware verschiedener Aktoren werden Toggle-Kommandos zumindest bei einigen Schaltern (HM-LC-Sw1-Pl und HM-LC-SW2-PB-FM) vor Eintreffen des Signingpaketes geschaltet. Bei einem Test einem HM-LC-SW1-PL mit Firmware Version 1.9 konnte dieses Verhalten allerdings nicht reproduziert werden. In dieser Version scheint der Bug nicht mehr existent zu sein.
* durch Nutzung des HMLAN-Konfigurators ggf. umgehen des Singnings bei der Nutzung des Standardschlüssels möglich (siehe oben).
* CUL und CUN(O) unterstützen die AES-Signierung nicht. Werden HM-Aktoren mit eingeschalteter AES-Signierung an eine CCU oder einem HMLAN-Konfigurator angelernt (gepairt), so können sie von einem CUL trotz gleicher HMID nicht gesteuert werden. Bei einem Wechsel der Zentrale bzw. des HMLAN-Konfigurators müssen alle Geräte an der neuen Zentrale bzw. dem HMLAN-Konfigurator wieder angelernt werden.
* Ein faktischer Sicherheitsgewinn ist nur gegeben, wenn ein eigener System-Sicherheitsschlüssel genutzt wird.
== Erhöhung der Sicherheit durch Vergabe eines eigenen Schlüssels ==
Eine Steigerung der Sicherheit ergibt sich nur, wenn man den werksseitig vorgegeben Schlüssel ändert.

Solange Angreifern dieser unbekannt bleibt, ist ein Fremdschalten nicht mehr möglich (wohl aber ein Ermitteln des aktuellen Schaltzustandes durch Mitschneiden des Funkverkehrs, da der Funkverkehr selbst nicht verschlüsselt ist).

Das gesamte System ist in der Handhabung dann aber etwas aufwändiger. So ist es dann z.B. nicht möglich den Sicherheitsschlüssel in einzelnen Aktoren selbst zurückzusetzen. Nur die Zentrale bzw. der HMLAN-Konfigurator kann einen Schlüssel an alle angelernten Komponenten verteilen bzw. angelernte Module in den Werkszustand setzen (Schlüssel wird auf Werksschlüssel zurückgesetzt).

Wenn also ein eigener Schlüssel vergeben wurde und dieser später nicht mehr bekannt ist, dann die Zentrale zurückgesetzt wird (oder eine defekte gegen eine neue mit Werksschlüssel ausgetauscht wird) ohne dass die Komponenten vorher auf Werkseinstellung zurückgesetzt wurden, dann sind die entsprechenden Komponenten (Sensoren, Aktoren und Sender) erst einmal nicht mehr verwendbar.
Wenn man also den selbst gesetzten Schlüssel vergessen / verloren hat, hilft nur noch ein Zurücksetzen beim Hersteller. Dabei fallen dann natürlich entsprechende Kosten an.

'''WICHTIG''': den eigenen Sicherheitsschlüssel gut und sicher aufbewahren.

Wenn man ein Gerät mit gesetztem eigenem Sicherheitsschlüssel an eine andere/neue Zentrale anlernen möchte, so wird man während des Anlernvorgangs nach dem eigenen Sicherheitsschlüssel gefragt.

Da die Schlüsselimplementation der CCU in älteren Firmwareversionen (vor 1.504) z.T. mit Bugs behaftet ist, ergeben sich Risiken selbst dann, wenn der Schlüssel bekannt ist. So darf der Schlüssel z.b. keinesfalls ein "&" enthalten. Gelegentlich wird auch berichtet, dass garantiert richtig eingegebene Schlüssel bei Systemwechseln nicht akzeptiert wurden.

'''WICHTIG''': Sicherheitshalber keine Sonderzeichen im eigenen Sicherheitsschlüssel verwenden.

Der AES-Signier-Schlüssel kann derzeit nicht von FHEM gesetzt werden, sondern muss im [[HMLAN Konfigurator]] per mitgelieferter HomeMatic-Software gesetzt werden.

Die AES-Signierung kann mit einigen Ausnahmen in jedem HM-Gerät separat aktiviert/deaktiviert werden.
In einigen Geräte wie z.B. dem KeyMatic kann die AES-Signierung nicht abgeschaltet werden. Diese Geräte kommunizieren '''immer'''AES-Signiert mit der Zentrale bzw. dem HMLAN-Konfigurator.

[[Kategorie:HomeMatic Components]]

AES Encryption

2013-09-30T09:10:24Z

Stefan Sordon: /* Details */ Typo

Anders als der Name vermuteten lässt, handelt es sich beim HM-AES-Encryption Modus ("BidCos") nicht um tatsächlich encrypteten Funkverkehr, sondern um das Einschalten eines Signingrequest-Modus (AES-Challenge-Response (CR)). Hierdurch soll sichergestellt werden, dass der Funkbefehl auch tatsächlich von der Zentrale kommt, die ihn vorgeblich gesendet hat.

== Details ==
Wenn die AES-Signierung an einem HomeMatic-Gerät eingeschaltet wird, führt ein Aktor einen empfangenen Befehl nicht sofort aus, sondern fragt beim Absender zurück. Dieser muss dann mit einer Bestätigung antworten. Erst dann wird der Befehl tatsächlich ausgeführt. Die AES Challenge-Response Antwort wird dabei mit dem Systemschlüssel erzeugt. Der Systemschlüssel wird von der Zentrale bzw. dem [[HMLAN Konfigurator]] auf alle gepairten HomeMatic Geräte verteilt. Standardmäßig ist hier ab Werk ein einheitlicher Standardschlüssel hinterlegt. Dieser ist in '''allen''' HM-Geräten gleich.
Der Standardschlüssel kann vom Nutzer geändert werden, jedoch bringt dies ggf. einige Nachteile mit sich. Es wird daher verschiedentlich empfohlen, den Schlüssel zumindest solange der werksseitig voreingestellte Schlüssel noch nicht bekannt ist, nicht zu verändern (Details siehe weiter unten).

Der Funkverkehr selbst ist nicht verschlüsselt.

Diese Methode soll die Sicherheit erhöhen, indem der Aktor selber nachfragen kann, ob der Funkbefehl auch tatsächlich von einem autorisierten Absender gekommen ist. Da aber alle HM-Geräte bei der Auslieferung den selben Standardschlüssel besitzen, könnte prinzipiell jede Zentrale (CCU) bzw. jeder HMLAN-Konfigurator mit der entsprechenden eingestellten HM-ID fremde Geräte mit Standardschlüssel steuern.

Es ist daher möglich, mit einem HMLAN-Konfigurator, der per FHEM die richtige HM-ID eingestellt hat, alle Aktoren einer fremden Installation zu schalten (die 3-Byte grosse HM-ID ist Bestandteil der Signingantwort), sofern der werksseitig voreingestellte Schlüssel nicht verändert wurde.

Um hier also einen echten Sicherheitsgewinn zu erzielen, muss daher '''zwingend'''ein eigener Systemschlüssel vergeben werden.

== Nachteile der AES-Signierung Methode ==
* Bis der Aktor schaltet, ist mehr Funkverkehr erforderlich. Anstatt 2 werden 4 Messages versendet (anstatt nach einer wird nach drei Messages geschaltet), die Verzögerung ist deutlich merkbar. Die Batteriebelastung ist ebenfalls höher.
* Jedes Kommando und seine Bestätigung wird unverschlüsselt versendet, so dass Beobachter von außen den Zustand jedes Aktors durch Mitlesen des Funkverkehrs kennen können. Dies trifft auch bei selbst gesetztem Schlüssel zu.
* Durch Fehler in der Firmware verschiedener Aktoren werden Toggle-Kommandos zumindest bei einigen Schaltern (HM-LC-Sw1-Pl und HM-LC-SW2-PB-FM) vor Eintreffen des Signingpaketes geschaltet. Bei einem Test einem HM-LC-SW1-PL mit Firmware Version 1.9 konnte dieses Verhalten allerdings nicht reproduziert werden. In dieser Version scheint der Bug nicht mehr existent zu sein.
* durch Nutzung des HMLAN-Konfigurators ggf. umgehen des Singnings bei der Nutzung des Standardschlüssels möglich (siehe oben).
* CUL und CUN(O) unterstützen die AES-Signierung nicht. Werden HM-Aktoren mit eingeschalteter AES-Signierung an eine CCU oder einem HMLAN-Konfigurator angelernt (gepairt), so können sie von einem CUL trotz gleicher HMID nicht gesteuert werden. Bei einem Wechsel der Zentrale bzw. des HMLAN-Konfigurators müssen alle Geräte an der neuen Zentrale bzw. dem HMLAN-Konfigurator wieder angelernt werden.
* Ein faktischer Sicherheitsgewinn ist nur gegeben, wenn ein eigener System-Sicherheitsschlüssel genutzt wird.
== Erhöhung der Sicherheit durch Vergabe eines eigenen Schlüssels ==
Eine Steigerung der Sicherheit ergibt sich nur, wenn man den werksseitig vorgegeben Schlüssel ändert.

Solange Angreifern dieser unbekannt bleibt, ist ein Fremdschalten nicht mehr möglich (wohl aber ein Ermitteln des aktuellen Schaltzustandes durch Mitschneiden des Funkverkehrs, da der Funkverkehr selbst nicht verschlüsselt ist).

Das gesamte System ist in der Handhabung dann aber etwas aufwändiger. So ist es dann z.B. nicht möglich den Sicherheitsschlüssel in einzelnen Aktoren selbst zurückzusetzen. Nur die Zentrale bzw. der HMLAN-Konfigurator kann einen Schlüssel an alle angelernten Komponenten verteilen bzw. angelernte Module in den Werkszustand setzen (Schlüssel wird auf Werksschlüssel zurückgesetzt).

Wenn also ein eigener Schlüssel vergeben wurde und dieser später nicht mehr bekannt ist, dann die Zentrale zurückgesetzt wird (oder eine defekte gegen eine neue mit Werksschlüssel ausgetauscht wird) ohne dass die Komponenten vorher auf Werkseinstellung zurückgesetzt wurden, dann sind die entsprechenden Komponenten (Sensoren, Aktoren und Sender) erst einmal nicht mehr verwendbar.
Wenn man also den selbst gesetzten Schlüssel vergessen / verloren hat, hilft nur noch ein Zurücksetzen beim Hersteller. Dabei fallen dann natürlich entsprechende Kosten an.

'''WICHTIG''': den eigenen Sicherheitsschlüssel gut und sicher aufbewahren.

Wenn man ein Gerät mit gesetztem eigenem Sicherheitsschlüssel an eine andere/neue Zentrale anlernen möchte, so wird man während des Anlernvorgangs nach dem eigenen Sicherheitsschlüssel gefragt.

Da die Schlüsselimplementation der CCU in älteren Firmwareversionen (vor 1.504) z.T. mit Bugs behaftet ist, ergeben sich Risiken selbst dann, wenn der Schlüssel bekannt ist. So darf der Schlüssel z.b. keinesfalls ein "&" enthalten. Gelegentlich wird auch berichtet, dass garantiert richtig eingegebene Schlüssel bei Systemwechseln nicht akzeptiert wurden.

'''WICHTIG''': Sicherheitshalber keine Sonderzeichen im eigenen Sicherheitsschlüssel verwenden.

Der AES-Signier-Schlüssel kann derzeit nicht von FHEM gesetzt werden, sondern muss im [[HMLAN Konfigurator]] per mitgelieferter HomeMatic-Software gesetzt werden.

Die AES-Signierung kann mit einigen Ausnahmen in jedem HM-Gerät separat aktiviert/deaktiviert werden.
In einigen Geräte wie z.B. dem KeyMatic kann die AES-Signierung nicht abgeschaltet werden. Diese Geräte kommunizieren '''immer'''AES-Signiert mit der Zentrale bzw. dem HMLAN-Konfigurator.

[[Kategorie:HomeMatic Components]]