HomeMatic: Unterschied zwischen den Versionen

Aus FHEMWiki
K (Korrekturen nach Restore)
Zeile 1: Zeile 1:
'''HomeMatic'''
'''HomeMatic'''
= Allgemeines =
= Allgemeines =
[http://www.homematic.com/ HomeMatic] (HM) ist ein System zur Steuerung und Überwachung von zahlreichen Aufgaben und Situationen im Haus. Anfangs gab es nur auf Funk (868,3 MHz) basierende Sensoren und Aktoren, 2008 kamen die ersten "wired"-Komponenten (basierend auf RS485) auf. Es kann zur Heizungs- und Lichtsteuerung, Temperatur-, Luftfeuchte- und Feuchtemessung, Zutrittskontrolle, als Wasser-, Brand- und Bewegungsmelder sowie als Wetterstation (Wind, Regen, Licht, Temperatur und Luftfeuchte) usw. eingesetzt werden. Zusätzlich gibt es noch Fernbedienungen und Statusdisplays.
[http://www.homematic.com/ HomeMatic] (HM) ist ein System zur Steuerung und Überwachung von zahlreichen Aufgaben und Situationen im Haus. Anfangs gab es nur auf Funk (868,3 MHz) basierende Sensoren und Aktoren, 2008 kamen die ersten "wired"-Komponenten (basierend auf RS485) auf. Es kann zur Heizungs- und Lichtsteuerung, Temperatur-, Luftfeuchte- und Feuchtemessung, Zutrittskontrolle, als Wasser-, Brand- und Bewegungsmelder sowie als Wetterstation (Wind, Regen, Licht, Temperatur und Luftfeuchte) usw. eingesetzt werden. Zusätzlich gibt es noch Fernbedienungen und Statusdisplays.


Da, wo es notwendig ist, sind die Geräte <ins>rückkanalfähig</ins>, soll heißen, dass ein Aktor (z.B. Lichtschalter) an die Steuerungseinheit zurück meldet, ob er einen Schaltbefehl erhalten hat (''ACK'' für '''Ack'''nowledgement, also Empfangsbestätigung). Erkennt der Aktor den Befehl nicht, sendet er ein ''NACK''. Kommt vom Aktor keine Rückmeldung innerhalb einer festgelegten Zeit, meldet FHEM ein ''MISSING ACK''im FHEM-Log.
Da, wo es notwendig ist, sind die Geräte <ins>rückkanalfähig</ins>, soll heißen, dass ein Aktor (z.B. Lichtschalter) an die Steuerungseinheit zurück meldet, ob er einen Schaltbefehl erhalten hat (''ACK'' für '''Ack'''nowledgement, also Empfangsbestätigung). Erkennt der Aktor den Befehl nicht, sendet er ein ''NACK''. Kommt vom Aktor keine Rückmeldung innerhalb einer festgelegten Zeit, meldet FHEM ein ''MISSING ACK'' im FHEM-Log.


Vom Hersteller [http://www.eq-3.de eQ-3] selbst wird entsprechende Hard- und Software für den Aufbau einer HM-Zentrale zur Steuerung und Auswertung der HM-Komponenten angeboten. Diese ist aber nur in Verbindung mit HM-Geräten nutzbar.
Vom Hersteller [http://www.eq-3.de eQ-3] selbst wird entsprechende Hard- und Software für den Aufbau einer HM-Zentrale zur Steuerung und Auswertung der HM-Komponenten angeboten. Diese ist aber nur in Verbindung mit HM-Geräten nutzbar.


= Betrieb mit FHEM =
= Betrieb mit FHEM =
Für den Einsatz mit FHEM benötigt man die entsprechende [[:Kategorie:Server_Hardware|Rechner-Hardware]], FHEM selbst und einen Übertragungs- bzw. Konfigurationsadapter wie z.B. [[CUL]] oder [[HMLAN Konfigurator]].
Für den Einsatz mit FHEM benötigt man die entsprechende [[:Kategorie:Server_Hardware|Rechner-Hardware]], FHEM selbst und einen Übertragungs- bzw. Konfigurationsadapter wie z.B. [[CUL]] oder [[HMLAN Konfigurator]].


Zeile 17: Zeile 20:
* paralleler Betrieb mit Geräten anderer Hersteller (z.B. FS20, mit 2. Adapter!)
* paralleler Betrieb mit Geräten anderer Hersteller (z.B. FS20, mit 2. Adapter!)
* FHEM läuft auf einigen NAS-Systemen, FritzBoxen oder auch z.B. einem RaspBerry Pi
* FHEM läuft auf einigen NAS-Systemen, FritzBoxen oder auch z.B. einem RaspBerry Pi
* &lt;bitte ergänzen&gt;
* <bitte ergänzen>


'''Wichtig:'''Falls Sie sich (zunächst) für den CUL-Betrieb entscheiden, setzen Sie die erforderliche [[HMLAN Konfigurator]] (HMID nur aus '''Groß'''buchstaben und Zahlen). Dies erleichtert einen späteren Wechsel auf HM-LAN.
'''Wichtig:''' Falls Sie sich (zunächst) für den CUL-Betrieb entscheiden, setzen Sie die erforderliche [[HMLAN Konfigurator]] (HMID nur aus '''Groß'''buchstaben und Zahlen). Dies erleichtert einen späteren Wechsel auf HM-LAN.


'''Hinweis:'''Sofern Sie (Konfigurations-)Befehle (egal ob ''set ...''oder ''get ...'') per FHEM an einen HM-Sensor bzw. -Aktor absetzen, müssen Sie auf deren Verarbeitung warten, bis der Sensor/Aktor von sich aus Kontakt mit der HM-Zentrale (hier: FHEM) aufnimmt. Solange sehen Sie in den ''Readings''des HM-Device den Hinweis ''CMDs pending''. Einige Sensoren nehmen nur bei Änderung ihres Status (z.B. HM-Sec-SC, HM-Sec-RHS) Kontakt zur Zentrale auf. Die Kontaktaufnahme dauert in der Regel ca. 5 Minuten. Um diese Kommunikation zu erzwingen bzw. vorzuziehen, können Sie an dem Aktor/Sensor entweder die Anlerntaste (beim HM-CC-TC die &lt;OK&gt;-Taste) für ca. 5 Sekunden drücken oder den Zustand des HM-Gerätes verändern (z.B. Türe/Fenster öffnen).
'''Hinweis:''' Sofern Sie (Konfigurations-)Befehle (egal ob ''set ...'' oder ''get ...'') per FHEM an einen HM-Sensor bzw. -Aktor absetzen, müssen Sie auf deren Verarbeitung warten, bis der Sensor/Aktor von sich aus Kontakt mit der HM-Zentrale (hier: FHEM) aufnimmt. Solange sehen Sie in den ''Readings'' des HM-Device den Hinweis ''CMDs pending''. Einige Sensoren nehmen nur bei Änderung ihres Status (z.B. HM-Sec-SC, HM-Sec-RHS) Kontakt zur Zentrale auf. Die Kontaktaufnahme dauert in der Regel ca. 5 Minuten. Um diese Kommunikation zu erzwingen bzw. vorzuziehen, können Sie an dem Aktor/Sensor entweder die Anlerntaste (beim HM-CC-TC die &lt;OK&gt;-Taste) für ca. 5 Sekunden drücken oder den Zustand des HM-Gerätes verändern (z.B. Türe/Fenster öffnen).


= Pair / Peer bzw. pairen und peeren =
= Pair / Peer bzw. pairen und peeren =
HM-Geräte können unter- bzw. miteinander <ins>gep'''ee'''rt</ins> werden, wenn z.B. ein Sensor einen Aktor direkt (ohne Zentrale) steuern soll.
HM-Geräte können unter- bzw. miteinander <ins>gep'''ee'''rt</ins> werden, wenn z.B. ein Sensor einen Aktor direkt (ohne Zentrale) steuern soll.


HM-Geräte müssen andererseits mit einer Zentrale <ins>gepairt</ins> werden, wenn diese Zentrale die Geräte (um-)konfigurieren bzw. steuern oder zumindest auslesen können soll.
HM-Geräte müssen andererseits mit einer Zentrale <ins>gepairt</ins> werden, wenn diese Zentrale die Geräte (um-)konfigurieren bzw. steuern oder zumindest auslesen können soll.


Der Vorgang des <ins>Peerens mittels Anlerntaste(n)</ins> muss durchgeführt werden '''bevor'''auch nur eines der zu p'''ee'''renden Geräte mit einer Zentrale gep'''ai'''rt wurde. Ansonsten muss dieser Peer-Vorgang durch FHEM-Befehle vorgenommen werden.
Der Vorgang des <ins>Peerens mittels Anlerntaste(n)</ins> muss durchgeführt werden '''bevor''' auch nur eines der zu p'''ee'''renden Geräte mit einer Zentrale gep'''ai'''rt wurde. Ansonsten muss dieser Peer-Vorgang durch FHEM-Befehle vorgenommen werden.


= Aktoren / Sensoren =
= Aktoren / Sensoren =
Zeile 34: Zeile 38:


== Atttribute / Eigenschaften / Readings ==
== Atttribute / Eigenschaften / Readings ==
Alle Aktoren/Sensoren verfügen über Attribute (Eigenschaften), Register und Readings, die mittels FHEM ausgelesen und/oder verändert werden können.
Alle Aktoren/Sensoren verfügen über Attribute (Eigenschaften), Register und Readings, die mittels FHEM ausgelesen und/oder verändert werden können.


Zeile 39: Zeile 44:
Die Ausgabe der Eigenschaften, Register und sonstiger Attribute eines [[HM-SEC-SC Tür-Fensterkontakt]] erfolgt durch den Befehl
Die Ausgabe der Eigenschaften, Register und sonstiger Attribute eines [[HM-SEC-SC Tür-Fensterkontakt]] erfolgt durch den Befehl


  <nowiki>list EG.WZ.Tuerkontakt</nowiki>
  list EG.WZ.Tuerkontakt
wobei ''EG.WZ.Tuerkontakt''dem per ''rename''angepassten Namen des SC entspricht (kann bei Ihnen natürlich anders lauten):


  <nowiki>Internals:
wobei ''EG.WZ.Tuerkontakt'' dem per ''rename'' angepassten Namen des SC entspricht (kann bei Ihnen natürlich anders lauten):
CHANGED
 
DEF    1BB0CF
  Internals:
EVENTS  11
  CHANGED
HMLAN1_MSGCNT 15
  DEF    1BB0CF
HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000
  EVENTS  11
HMLAN1_RSSI -63
  HMLAN1_MSGCNT 15
HMLAN1_TIME 2013-03-19 20:43:14
  HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000
IODev  HMLAN1
  HMLAN1_RSSI -63
LASTInputDev HMLAN1
  HMLAN1_TIME 2013-03-19 20:43:14
MSGCNT  15
  IODev  HMLAN1
NAME    EG.WZ.Tuerkontakt
  LASTInputDev HMLAN1
NR    119
  MSGCNT  15
STATE  MISSING ACK
  NAME    EG.WZ.Tuerkontakt
TYPE    CUL_HM
  NR    119
lastMsg  No:9F - t:10 s:1BB0CF d:123ABC 0201010000
  STATE  MISSING ACK
protCmdDel 3
  TYPE    CUL_HM
protLastRcv 2013-03-19 20:43:14
  lastMsg  No:9F - t:10 s:1BB0CF d:123ABC 0201010000
protResnd 2 last_at:2013-03-19 20:37:33
  protCmdDel 3
protResndFail 1 last_at:2013-03-19 20:37:36
  protLastRcv 2013-03-19 20:43:14
protSnd  7 last_at:2013-03-19 20:43:14
  protResnd 2 last_at:2013-03-19 20:37:33
protState CMDs_done
  protResndFail 1 last_at:2013-03-19 20:37:36
rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15
  protSnd  7 last_at:2013-03-19 20:43:14
  protState CMDs_done
  rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15
  Readings:
  Readings:
   2013-03-19 20:43:11  Activity:    alive
   2013-03-19 20:43:11  Activity:    alive
Zeile 101: Zeile 107:
     max    -50
     max    -50
     min    -77
     min    -77
  Shadowreg:
Shadowreg:
Attributes:
Attributes:
actCycle  028:00
  actCycle  028:00
actStatus alive
  actStatus alive
expert  2_full
  expert  2_full
firmware  2.0
  firmware  2.0
fp_GrundrissEG 465,1077,1,Terrassentüre
  fp_GrundrissEG 465,1077,1,Terrassentüre
model  HM-SEC-SC
  model  HM-SEC-SC
peerIDs  00000000,1AD19403,
  peerIDs  00000000,1AD19403,
room    EG.WohnZ
  room    EG.WohnZ
serialNr  JEQ0383824
  serialNr  JEQ0383824
subType  threeStateSensor</nowiki>
  subType  threeStateSensor
 
'''Erläuterungen zu einzelnen Ausgabezeilen:'''
'''Erläuterungen zu einzelnen Ausgabezeilen:'''
  <nowiki>HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000</nowiki>
 
Hier erfolgte eine Kommunikation zwischen dem Gerät mit der REF-ID ''1BB0CF''(HM-Sec-SC) und der Zentrale mit der HMID ''123ABC''.
  HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000
 
Hier erfolgte eine Kommunikation zwischen dem Gerät mit der REF-ID ''1BB0CF'' (HM-Sec-SC) und der Zentrale mit der HMID ''123ABC''.


  <nowiki>HMLAN1_RSSI -63</nowiki>
  <nowiki>HMLAN1_RSSI -63</nowiki>
Die Sende-/Empfangsstärke der '''letzten'''Funkübertragung. Dies ist im Zusammenhang mit der Zeile
Die Sende-/Empfangsstärke der '''letzten''' Funkübertragung. Dies ist im Zusammenhang mit der Zeile
 
rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15


<nowiki>rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15</nowiki>
zu sehen, welche den Durchschnitts- (avg), Min-, Max- und nochmal den letzten (lst) Wert von insgesamt (cnt) 15 Funkübertragungen angibt.
zu sehen, welche den Durchschnitts- (avg), Min-, Max- und nochmal den letzten (lst) Wert von insgesamt (cnt) 15 Funkübertragungen angibt.


  <nowiki>PairedTo    0x0
  PairedTo    0x0
...
...
R-pairCentral  0x0</nowiki>
R-pairCentral  0x0
 
weist darauf hin, dass hier noch kein P'''ai'''ring des HM-Sec-SC mit dem HMLAN-Konfigurator abgeschlossen wurde.
weist darauf hin, dass hier noch kein P'''ai'''ring des HM-Sec-SC mit dem HMLAN-Konfigurator abgeschlossen wurde.


  <nowiki>IODev  HMLAN1
  IODev  HMLAN1
LASTInputDev HMLAN1</nowiki>
LASTInputDev HMLAN1
Die (letzte) Kommunikation erfolgte mit dem Device ''HMLAN1''(hier der Klarname des HMLAN-Konfigurators, der Zentrale).
 
Die (letzte) Kommunikation erfolgte mit dem Device ''HMLAN1'' (hier der Klarname des HMLAN-Konfigurators, der Zentrale).
 
2013-03-19 20:43:13  R-cyclicInfoMsg on


<nowiki>2013-03-19 20:43:13  R-cyclicInfoMsg on</nowiki>
Hat der HM-Sec-SC fast 24 Stunden nichts zu melden gehabt (Tür/Fenster wurde nicht geöffnet/geschlossen), wird eine Batteriestatus-Meldung an die Zentrale geschickt. Dies ist aber nur bei den Three-State-Sensoren erforderlich (siehe unten).
Hat der HM-Sec-SC fast 24 Stunden nichts zu melden gehabt (Tür/Fenster wurde nicht geöffnet/geschlossen), wird eine Batteriestatus-Meldung an die Zentrale geschickt. Dies ist aber nur bei den Three-State-Sensoren erforderlich (siehe unten).


  <nowiki>2013-03-19 20:43:13  peerList    EG.WZ.Heizung_WindowRec,</nowiki>
  2013-03-19 20:43:13  peerList    EG.WZ.Heizung_WindowRec,
 
in Verbindung mit
in Verbindung mit


  <nowiki>peerIDsRaw ,1AD19403,00000000
  peerIDsRaw ,1AD19403,00000000
...
...
peerIDs  00000000,1AD19403,</nowiki>
peerIDs  00000000,1AD19403,
Der HM-Sec-SC ist mit dem [[HM-CC-TC Funk-Wandthermostat]] (Raumtemperaturregler) mit dem Namen ''EG.WZ.Heizung''(Geräte-ID 1AD194) und dessen Channel ''_WindowRec''(Kanal 03) mit der ID 1AD194'''03'''gep'''ee'''rt. Über diesen erfolgt auch die Steuerung. Steht hier nur die ''00000000,'', ist kein P'''ee'''ring erfolgt und der SC kann nicht gesteuert werden.
 
Der HM-Sec-SC ist mit dem [[HM-CC-TC Funk-Wandthermostat]] (Raumtemperaturregler) mit dem Namen ''EG.WZ.Heizung'' (Geräte-ID 1AD194) und dessen Channel ''_WindowRec'' (Kanal 03) mit der ID 1AD194 '''03'''gep'''ee'''rt. Über diesen erfolgt auch die Steuerung. Steht hier nur die ''00000000,'', ist kein P'''ee'''ring erfolgt und der SC kann nicht gesteuert werden.


  <nowiki>firmware  2.0</nowiki>
  firmware  2.0
Bei HM-Geräten ohne Anzeigedisplay kann nur über das Auflisten der Attribute die Firmware-Version in Erfahrung gebracht werden.
Bei HM-Geräten ohne Anzeigedisplay kann nur über das Auflisten der Attribute die Firmware-Version in Erfahrung gebracht werden.


= Besonderheiten =
= Besonderheiten =
== Three-State-Sensoren ==
== Three-State-Sensoren ==
Bei allen(?) HM-Devices, die von FHEM als "CUL_HM_threeStateSensor_1A2B3C" erkannt und eingebunden werden, gibt es eine Besonderheit bei den Batteriezuständen zu beachten.
Bei allen(?) HM-Devices, die von FHEM als "CUL_HM_threeStateSensor_1A2B3C" erkannt und eingebunden werden, gibt es eine Besonderheit bei den Batteriezuständen zu beachten.


Zeile 157: Zeile 174:
* ...
* ...


Regulär sendet ein Threee-State-Sensor (TSS) keine Meldungen über den Zustand der Batterien an FHEM bzw. nur dann, wenn der Sensor seinen Zustand ändert (z.B. auf &lt;=&gt; zu). Um dies zu ändern, müssen im TSS bestimmte Registerwerte gesetzt werden. Hierzu ist folgende Vorgehensweise erforderlich ([http://forum.fhem.de/index.php?t=msg&amp;th=11563&amp;goto=68193&amp;rid=0#msg_68193 Quelle (auch nachfolgende Thread-Beiträge beachten)]):
Regulär sendet ein Three-State-Sensor (TSS) keine Meldungen über den Zustand der Batterien an FHEM bzw. nur dann, wenn der Sensor seinen Zustand ändert (z.B. auf <=> zu). Um dies zu ändern, müssen im TSS bestimmte Registerwerte gesetzt werden. Hierzu ist folgende Vorgehensweise erforderlich ([http://forum.fhem.de/index.php?t=msg&amp;th=11563&amp;goto=68193&amp;rid=0#msg_68193 Quelle (auch nachfolgende Thread-Beiträge beachten)]):


Beim HM-SEC-SC/RHS z.B. kann man die Register nur beschreiben, nachdem der Anlernknopf im Batteriefach gedrückt wurde.
Beim HM-SEC-SC/RHS z.B. kann man die Register nur beschreiben, nachdem der Anlernknopf im Batteriefach gedrückt wurde.
Zeile 163: Zeile 180:
Um das entsprechende Register zu setzen, muss man zunächst in FHEM folgende Befehle
Um das entsprechende Register zu setzen, muss man zunächst in FHEM folgende Befehle


  <nowiki>get CUL_HM_threeStateSensor_1A2B3C reg all
  get CUL_HM_threeStateSensor_1A2B3C reg all
set CUL_HM_threeStateSensor_1A2B3C regSet cyclicInfoMsg on</nowiki>
set CUL_HM_threeStateSensor_1A2B3C regSet cyclicInfoMsg on
eingeben. Danach siehst man in FHEM beim Device, dass mindestens ein Kommando zur Übertragung ansteht ("pending") und in den "Readings", dass das ''cyclicInfoMsg-register''geschrieben werden soll. Jetzt ist FHEM in den Pairing-Modus zu versetzen
 
eingeben. Danach siehst man in FHEM beim Device, dass mindestens ein Kommando zur Übertragung ansteht ("pending") und in den "Readings", dass das ''cyclicInfoMsg-register'' geschrieben werden soll. Jetzt ist FHEM in den Pairing-Modus zu versetzen
 
set hmPairForSec 120


<nowiki>set hmPairForSec 120</nowiki>
und der Anlernknopf zu drücken. Danach noch mal
und der Anlernknopf zu drücken. Danach noch mal


  <nowiki>get CUL_HM_threeStateSensor_1A2B3C reg all</nowiki>
  get CUL_HM_threeStateSensor_1A2B3C reg all
 
eingeben. Jetzt sollten keine "pending-commands" mehr zu sehen sein und in den "Readings"
eingeben. Jetzt sollten keine "pending-commands" mehr zu sehen sein und in den "Readings"


  <nowiki>R-cyclicInfoMsg on</nowiki>
  R-cyclicInfoMsg on
 
stehen. Ab jetzt kommt regelmäßig eine Batteriemeldung, wenn der TSS etwa 24 Stunden lang nicht betätigt wurde. Zudem kann das Device jetzt auch vom ActionDetector unterstützt werden.
stehen. Ab jetzt kommt regelmäßig eine Batteriemeldung, wenn der TSS etwa 24 Stunden lang nicht betätigt wurde. Zudem kann das Device jetzt auch vom ActionDetector unterstützt werden.


'''Hinweis:'''Das funktioniert seit dem 20.03.2013 auch beim [[HM-Sec-WDS Funk-Wassermelder]] (nach einem ''update'').
'''Hinweis:''' Das funktioniert seit dem 20.03.2013 auch beim [[HM-Sec-WDS Funk-Wassermelder]] (nach einem ''update'').


== Virtuelle Aktorkanäle ==
== Virtuelle Aktorkanäle ==
Zeile 183: Zeile 204:
* [[HM-LC-Dim1PWM-CV Dimmaktor PWM DC-LED]]  
* [[HM-LC-Dim1PWM-CV Dimmaktor PWM DC-LED]]  
* [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP]]  
* [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP]]  
* &lt;bitte ergänzen&gt;
* <bitte ergänzen>


sind <ins>erstmalig</ins> '''virtuelle Aktorkanäle''' und '''Verknüpfungslogiken''' [http://www.elv.de/output/controller.aspx?cid=758&amp;detail=10&amp;detail2=93 eingeführt worden]. Das bedeutet, dass Aktionen unabhängig von der Verfügbarkeit der HM-Zentralen (CCU, FHEM mit HM-LAN-Konfigurator) direkt zwischen verschiedenen Aktoren/Sensoren und dem Gerät mit den virtuellen Aktorkanälen festgelegt werden können.
sind <ins>erstmalig</ins> '''virtuelle Aktorkanäle''' und '''Verknüpfungslogiken''' [http://www.elv.de/output/controller.aspx?cid=758&amp;detail=10&amp;detail2=93 eingeführt worden]. Das bedeutet, dass Aktionen unabhängig von der Verfügbarkeit der HM-Zentralen (CCU, FHEM mit HM-LAN-Konfigurator) direkt zwischen verschiedenen Aktoren/Sensoren und dem Gerät mit den virtuellen Aktorkanälen festgelegt werden können.
Zeile 191: Zeile 212:
Wer jedoch erste Versuche mit FHEM starten möchte, kann - nachdem der entsprechende Aktor in FHEM angelernt wurde - wie folgt verfahren:
Wer jedoch erste Versuche mit FHEM starten möchte, kann - nachdem der entsprechende Aktor in FHEM angelernt wurde - wie folgt verfahren:


in der ''fhem. cfg''müssen Sie nach
in der ''fhem. cfg'' müssen Sie nach
 
define &lt;HM-LC-Dim1PWM-CV&gt; CUL_HM 1C062D


<nowiki>define &lt;HM-LC-Dim1PWM-CV&gt; CUL_HM 1C062D</nowiki>
(wobei "1C062D" bei Ihnen anders lauten kann)
(wobei "1C062D" bei Ihnen anders lauten kann)


folgendes einfügen
folgendes einfügen


  <nowiki>define &lt;HM-LC-Dim1PWM-CV&gt;_SW CUL_HM 1C062D01    &lt;= 1C062D + 01 = 1. virt. Kanal
  define &lt;HM-LC-Dim1PWM-CV&gt;_SW CUL_HM 1C062D01    <= 1C062D + 01 = 1. virt. Kanal
define &lt;HM-LC-Dim1PWM-CV&gt;_SW_V1 CUL_HM 1C062D02  &lt;= 1C062D + 02 = 2. virt. Kanal
define &lt;HM-LC-Dim1PWM-CV&gt;_SW_V1 CUL_HM 1C062D02  <= 1C062D + 02 = 2. virt. Kanal
define &lt;HM-LC-Dim1PWM-CV&gt;_SW_V2 CUL_HM 1C062D03  &lt;= 1C062D + 03 = 3. virt. Kanal</nowiki>
define &lt;HM-LC-Dim1PWM-CV&gt;_SW_V2 CUL_HM 1C062D03  <= 1C062D + 03 = 3. virt. Kanal
(die Anmerkungen oben ab "&lt;= ...." bitte nicht einfügen).
 
(die Anmerkungen oben ab "<= ...." bitte nicht einfügen).


Danach "save"n Sie ihre ''fhem.cfg''und machen zumindest ein ''rereadcfg''. Jetzt sehen Sie die virtuellen Kanäle und können ihre ersten Versuche mit den virtuellen Kanälen nach dem o.a. Artikel starten (so Sie entsprechende Aktoren besitzen).
Danach "save"n Sie ihre ''fhem.cfg'' und machen zumindest ein ''rereadcfg''. Jetzt sehen Sie die virtuellen Kanäle und können ihre ersten Versuche mit den virtuellen Kanälen nach dem o.a. Artikel starten (so Sie entsprechende Aktoren besitzen).


= Tipps / HowTos / Beispiele =
= Tipps / HowTos / Beispiele =
* [[HomeMatic Devices pairen|HM Devices pairen]] zum '''Pairen''' der Geräte untereinander.
* [[HomeMatic Devices pairen|HM Devices pairen]] zum '''Pairen''' der Geräte untereinander.
* [[CUL]] (also gleichzeitig)?
* [[CUL]] (also gleichzeitig)?

Version vom 14. Mai 2013, 20:43 Uhr

HomeMatic

Allgemeines

HomeMatic (HM) ist ein System zur Steuerung und Überwachung von zahlreichen Aufgaben und Situationen im Haus. Anfangs gab es nur auf Funk (868,3 MHz) basierende Sensoren und Aktoren, 2008 kamen die ersten "wired"-Komponenten (basierend auf RS485) auf. Es kann zur Heizungs- und Lichtsteuerung, Temperatur-, Luftfeuchte- und Feuchtemessung, Zutrittskontrolle, als Wasser-, Brand- und Bewegungsmelder sowie als Wetterstation (Wind, Regen, Licht, Temperatur und Luftfeuchte) usw. eingesetzt werden. Zusätzlich gibt es noch Fernbedienungen und Statusdisplays.

Da, wo es notwendig ist, sind die Geräte rückkanalfähig, soll heißen, dass ein Aktor (z.B. Lichtschalter) an die Steuerungseinheit zurück meldet, ob er einen Schaltbefehl erhalten hat (ACK für Acknowledgement, also Empfangsbestätigung). Erkennt der Aktor den Befehl nicht, sendet er ein NACK. Kommt vom Aktor keine Rückmeldung innerhalb einer festgelegten Zeit, meldet FHEM ein MISSING ACK im FHEM-Log.

Vom Hersteller eQ-3 selbst wird entsprechende Hard- und Software für den Aufbau einer HM-Zentrale zur Steuerung und Auswertung der HM-Komponenten angeboten. Diese ist aber nur in Verbindung mit HM-Geräten nutzbar.

Betrieb mit FHEM

Für den Einsatz mit FHEM benötigt man die entsprechende Rechner-Hardware, FHEM selbst und einen Übertragungs- bzw. Konfigurationsadapter wie z.B. CUL oder HMLAN Konfigurator.

Beachten Sie bitte vor der Auswahl des o.a. Adapters HMLAN Konfigurator.

Vorteile von FHEM statt der eQ-3-Software:

  • betriebssystemunabhängig
  • paralleler Betrieb mit Geräten anderer Hersteller (z.B. FS20, mit 2. Adapter!)
  • FHEM läuft auf einigen NAS-Systemen, FritzBoxen oder auch z.B. einem RaspBerry Pi
  • <bitte ergänzen>

Wichtig: Falls Sie sich (zunächst) für den CUL-Betrieb entscheiden, setzen Sie die erforderliche HMLAN Konfigurator (HMID nur aus Großbuchstaben und Zahlen). Dies erleichtert einen späteren Wechsel auf HM-LAN.

Hinweis: Sofern Sie (Konfigurations-)Befehle (egal ob set ... oder get ...) per FHEM an einen HM-Sensor bzw. -Aktor absetzen, müssen Sie auf deren Verarbeitung warten, bis der Sensor/Aktor von sich aus Kontakt mit der HM-Zentrale (hier: FHEM) aufnimmt. Solange sehen Sie in den Readings des HM-Device den Hinweis CMDs pending. Einige Sensoren nehmen nur bei Änderung ihres Status (z.B. HM-Sec-SC, HM-Sec-RHS) Kontakt zur Zentrale auf. Die Kontaktaufnahme dauert in der Regel ca. 5 Minuten. Um diese Kommunikation zu erzwingen bzw. vorzuziehen, können Sie an dem Aktor/Sensor entweder die Anlerntaste (beim HM-CC-TC die <OK>-Taste) für ca. 5 Sekunden drücken oder den Zustand des HM-Gerätes verändern (z.B. Türe/Fenster öffnen).

Pair / Peer bzw. pairen und peeren

HM-Geräte können unter- bzw. miteinander gepeert werden, wenn z.B. ein Sensor einen Aktor direkt (ohne Zentrale) steuern soll.

HM-Geräte müssen andererseits mit einer Zentrale gepairt werden, wenn diese Zentrale die Geräte (um-)konfigurieren bzw. steuern oder zumindest auslesen können soll.

Der Vorgang des Peerens mittels Anlerntaste(n) muss durchgeführt werden bevor auch nur eines der zu peerenden Geräte mit einer Zentrale gepairt wurde. Ansonsten muss dieser Peer-Vorgang durch FHEM-Befehle vorgenommen werden.

Aktoren / Sensoren

Eine Übersicht und weitere Informationen über die von FHEM unterstützten HM-Geräte erreichen Sie über diese Seite.

Atttribute / Eigenschaften / Readings

Alle Aktoren/Sensoren verfügen über Attribute (Eigenschaften), Register und Readings, die mittels FHEM ausgelesen und/oder verändert werden können.

Beispiel: Die Ausgabe der Eigenschaften, Register und sonstiger Attribute eines HM-SEC-SC Tür-Fensterkontakt erfolgt durch den Befehl 

list EG.WZ.Tuerkontakt

wobei EG.WZ.Tuerkontakt dem per rename angepassten Namen des SC entspricht (kann bei Ihnen natürlich anders lauten): 

Internals:
 CHANGED
 DEF    1BB0CF
 EVENTS   11
 HMLAN1_MSGCNT 15
 HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000
 HMLAN1_RSSI -63
 HMLAN1_TIME 2013-03-19 20:43:14
 IODev   HMLAN1
 LASTInputDev HMLAN1
 MSGCNT   15
 NAME    EG.WZ.Tuerkontakt
 NR     119
 STATE   MISSING ACK
 TYPE    CUL_HM
 lastMsg  No:9F - t:10 s:1BB0CF d:123ABC 0201010000
 protCmdDel 3
 protLastRcv 2013-03-19 20:43:14
 protResnd 2 last_at:2013-03-19 20:37:33
 protResndFail 1 last_at:2013-03-19 20:37:36
 protSnd  7 last_at:2013-03-19 20:43:14
 protState CMDs_done
 rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15
Readings:
 2013-03-19 20:43:11  Activity:    alive
 2013-03-19 20:43:12  CommandAccepted yes
 2013-03-19 20:43:13  PairedTo    0x0
 2013-03-19 20:43:14  R-EG.WZ.Heizung_WindowRec-expectAES off
 2013-03-19 20:43:14  R-EG.WZ.Heizung_WindowRec-peerNeedsBurst on
 2013-03-19 20:43:13  R-cyclicInfoMsg on
 2013-03-19 20:43:14  R-eventDlyTime 0 s
 2013-03-19 20:43:13  R-intKeyVisib  invisib
 2013-03-19 20:43:14  R-ledOnTime   0.5 s
 2013-03-19 20:43:14  R-msgScPosA   closed
 2013-03-19 20:43:14  R-msgScPosB   open
 2013-03-19 20:43:13  R-pairCentral  0x0
 2013-03-19 20:43:13  R-sabotageMsg  on
 2013-03-19 20:43:13  R-transmDevTryMax 6
 2013-03-19 20:43:14  R-transmitTryMax 6
 2013-03-19 20:43:13  RegL_00:     02:00 09:01 0A:00 0B:00 0C:00 10:01 14:06 00:00
 2013-03-19 20:43:14  RegL_01:     08:00 20:60 21:00 22:64 30:06 00:00
 2013-03-19 20:43:14  RegL_04:EG.WZ.Heizung_WindowRec  01:01 00:00
 2013-03-19 20:37:23  alive      yes
 2013-03-19 20:37:23  battery     ok
 2013-03-19 20:37:24  contact     open (to EG.WZ.Heizung)
 2013-03-19 20:37:23  cover      open
 2013-03-19 20:43:13  peerList    EG.WZ.Heizung_WindowRec,
 2013-03-19 20:37:36  state      MISSING ACK
Helper:
 mId    002F
 peerIDsRaw ,1AD19403,00000000
 rxType   12
 Rssi:
  At_hmlan1:
   avg    -58.6666666666667
   cnt    15
   lst    -63
   max    -50
   min    -77
Shadowreg:
Attributes:
 actCycle  028:00
 actStatus alive
 expert   2_full
 firmware  2.0
 fp_GrundrissEG 465,1077,1,Terrassentüre
 model   HM-SEC-SC
 peerIDs  00000000,1AD19403,
 room    EG.WohnZ
 serialNr  JEQ0383824
 subType  threeStateSensor

Erläuterungen zu einzelnen Ausgabezeilen: 

HMLAN1_RAWMSG R842D4EED,0001,7C73E9F4,FF,FFC1,9FA0101BB0CF123ABC0201010000

Hier erfolgte eine Kommunikation zwischen dem Gerät mit der REF-ID 1BB0CF (HM-Sec-SC) und der Zentrale mit der HMID 123ABC. 

HMLAN1_RSSI -63

Die Sende-/Empfangsstärke der letzten Funkübertragung. Dies ist im Zusammenhang mit der Zeile 

rssi_at_HMLAN1 avg:-58.66 min:-77 max:-50 lst:-63 cnt:15

zu sehen, welche den Durchschnitts- (avg), Min-, Max- und nochmal den letzten (lst) Wert von insgesamt (cnt) 15 Funkübertragungen angibt. 

PairedTo    0x0
...
R-pairCentral  0x0

weist darauf hin, dass hier noch kein Pairing des HM-Sec-SC mit dem HMLAN-Konfigurator abgeschlossen wurde. 

IODev   HMLAN1
LASTInputDev HMLAN1

Die (letzte) Kommunikation erfolgte mit dem Device HMLAN1 (hier der Klarname des HMLAN-Konfigurators, der Zentrale). 

2013-03-19 20:43:13  R-cyclicInfoMsg on

Hat der HM-Sec-SC fast 24 Stunden nichts zu melden gehabt (Tür/Fenster wurde nicht geöffnet/geschlossen), wird eine Batteriestatus-Meldung an die Zentrale geschickt. Dies ist aber nur bei den Three-State-Sensoren erforderlich (siehe unten). 

2013-03-19 20:43:13  peerList    EG.WZ.Heizung_WindowRec,

in Verbindung mit 

peerIDsRaw ,1AD19403,00000000
...
peerIDs  00000000,1AD19403,

Der HM-Sec-SC ist mit dem HM-CC-TC Funk-Wandthermostat (Raumtemperaturregler) mit dem Namen EG.WZ.Heizung (Geräte-ID 1AD194) und dessen Channel _WindowRec (Kanal 03) mit der ID 1AD194 03gepeert. Über diesen erfolgt auch die Steuerung. Steht hier nur die 00000000,, ist kein Peering erfolgt und der SC kann nicht gesteuert werden. 

firmware  2.0

Bei HM-Geräten ohne Anzeigedisplay kann nur über das Auflisten der Attribute die Firmware-Version in Erfahrung gebracht werden.

Besonderheiten

Three-State-Sensoren

Bei allen(?) HM-Devices, die von FHEM als "CUL_HM_threeStateSensor_1A2B3C" erkannt und eingebunden werden, gibt es eine Besonderheit bei den Batteriezuständen zu beachten.

Zu den Three-State-Sensoren gehören:

Regulär sendet ein Three-State-Sensor (TSS) keine Meldungen über den Zustand der Batterien an FHEM bzw. nur dann, wenn der Sensor seinen Zustand ändert (z.B. auf <=> zu). Um dies zu ändern, müssen im TSS bestimmte Registerwerte gesetzt werden. Hierzu ist folgende Vorgehensweise erforderlich (Quelle (auch nachfolgende Thread-Beiträge beachten)):

Beim HM-SEC-SC/RHS z.B. kann man die Register nur beschreiben, nachdem der Anlernknopf im Batteriefach gedrückt wurde.

Um das entsprechende Register zu setzen, muss man zunächst in FHEM folgende Befehle 

get CUL_HM_threeStateSensor_1A2B3C reg all
set CUL_HM_threeStateSensor_1A2B3C regSet cyclicInfoMsg on

eingeben. Danach siehst man in FHEM beim Device, dass mindestens ein Kommando zur Übertragung ansteht ("pending") und in den "Readings", dass das cyclicInfoMsg-register geschrieben werden soll. Jetzt ist FHEM in den Pairing-Modus zu versetzen 

set hmPairForSec 120

und der Anlernknopf zu drücken. Danach noch mal 

get CUL_HM_threeStateSensor_1A2B3C reg all

eingeben. Jetzt sollten keine "pending-commands" mehr zu sehen sein und in den "Readings" 

R-cyclicInfoMsg on

stehen. Ab jetzt kommt regelmäßig eine Batteriemeldung, wenn der TSS etwa 24 Stunden lang nicht betätigt wurde. Zudem kann das Device jetzt auch vom ActionDetector unterstützt werden.

Hinweis: Das funktioniert seit dem 20.03.2013 auch beim HM-Sec-WDS Funk-Wassermelder (nach einem update).

Virtuelle Aktorkanäle

Mit den HM-Geräten

sind erstmalig virtuelle Aktorkanäle und Verknüpfungslogiken eingeführt worden. Das bedeutet, dass Aktionen unabhängig von der Verfügbarkeit der HM-Zentralen (CCU, FHEM mit HM-LAN-Konfigurator) direkt zwischen verschiedenen Aktoren/Sensoren und dem Gerät mit den virtuellen Aktorkanälen festgelegt werden können.

Eine offizielle Unterstützung seitens FHEM gibt es z.Zt. (16.2.2013) noch nicht.

Wer jedoch erste Versuche mit FHEM starten möchte, kann - nachdem der entsprechende Aktor in FHEM angelernt wurde - wie folgt verfahren:

in der fhem. cfg müssen Sie nach 

define <HM-LC-Dim1PWM-CV> CUL_HM 1C062D

(wobei "1C062D" bei Ihnen anders lauten kann)

folgendes einfügen 

define <HM-LC-Dim1PWM-CV>_SW CUL_HM 1C062D01    <= 1C062D + 01 = 1. virt. Kanal
define <HM-LC-Dim1PWM-CV>_SW_V1 CUL_HM 1C062D02   <= 1C062D + 02 = 2. virt. Kanal
define <HM-LC-Dim1PWM-CV>_SW_V2 CUL_HM 1C062D03   <= 1C062D + 03 = 3. virt. Kanal

(die Anmerkungen oben ab "<= ...." bitte nicht einfügen).

Danach "save"n Sie ihre fhem.cfg und machen zumindest ein rereadcfg. Jetzt sehen Sie die virtuellen Kanäle und können ihre ersten Versuche mit den virtuellen Kanälen nach dem o.a. Artikel starten (so Sie entsprechende Aktoren besitzen).

Tipps / HowTos / Beispiele

  • HM Devices pairen zum Pairen der Geräte untereinander.
  • CUL (also gleichzeitig)?
  • Slider für HM-Rolladensteuerung anzeigen
  • Für den "Fall der Fälle": Erstellen Sie eine Liste aller HM-Geräte mit den Installationsorten, HM-Namen, FHEM-Namen und den Geräte-IDs. Falls Sie sich ihr FHEM einmal zerschießen, wird diese Liste sehr hilfreich sein. Zur Abwicklung von Gewährleistungsansprüchen sind Daten über Kaufdatum und Lieferant (bei größeren Installationen mit Zukauf in zeitlichen Abständen) ebenfalls angebracht.
Abgerufen von „http://wiki.fhem.de/w/index.php?title=HomeMatic&oldid=1953“