FHEMWiki - Benutzerbeiträge [de]

FRITZBOX

2017-01-13T23:24:02Z

Thomas.kregelin: Mögliche Lösung für die Fehlermeldung "Didn't get a session ID" hinzugefügt

{{Infobox Modul
|ModPurpose=Steuerung einer Fritz!Box über Fhem
|ModType=d
|ModForumArea=FRITZ!Box
|ModTechName=72_FRITZBOX.pm
|ModOwner=tupol/Topos ({{Link2FU|5432|Forum}} / [[Benutzer Diskussion:Topos|Wiki]])}}

Das Modul [[FRITZBOX]] ermöglicht die Steuerung einer [[AVM Fritz!Box]] und von AVM FRITZ!WLAN Repeatern durch Fhem. An Fritzboxen können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.

== Voraussetzungen ==
=== Remote-Zugang ===
Für den Remote-Zugang müssen die Module JSON:XS, LWP und SOAP::Lite installiert sein; auf einem [[Raspberry Pi]] oder unter Ubuntu z. B. mit dem Befehl
:<code>sudo apt-get install libjson-perl libwww-perl libsoap-lite-perl libjson-xs-perl</code>

Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.

=== Telnet ===
Das Modul basierte ursprünglich auf dem Zugriff auf die Fritzbox per Telnet. Ab FRITZ!OS 6.2x baut AVM den abgekündigten Telnet-Zugang sowie die webcm-Schnittstelle sukzessive zurück bzw. hat dies, je nach Firmware, schon ganz abgestellt (siehe {{Link2Forum|Topic=38586|LinkText=dieses Forenthema}}). Der zukunftssichere Zugriff auf die Fritzbox sollte also per TR-064 erfolgen. Der Vollständigkeit halber und für ältere Firmwareversionen:

# Wer den Zugang per Telnet (noch) nutzen (kann und) möchte, muss dies zuerst freischalten. Üblicherweise durch Eingabe von #96*7* an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon
# Auf dem System, auf dem Fhem läuft ([[Systemübersicht#Server|Server]]) muss Telnet installiert sein; auf einem [[Raspberry Pi]] und unter Ubuntu z. B. mit dem Befehl
::<code>sudo apt-get install libnet-telnet-perl</code>

== Installation ==
=== Erste Schritte ===
Zur Erstinstallation reicht ein einfaches <code>define FritzBox FRITZBOX</code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).

==== TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
Für den Fernzugriff über TR-064 auf eine oder mehrere Fritzboxen und/oder einen FRITZ!WLAN Repeater sind die folgenden Schritte nötig (für jedes Gerät):

Fritzbox definieren:
:<code>define FritzBox FRITZBOX</code>

Wenn die Fritzbox nicht unter <nowiki>http://fritz.box</nowiki> erreichbar ist, IP im define setzen:
:<code>define FritzBox FRITZBOX 192.168.168.168</code>
192.168.168.168 dabei natürlich durch die passende IP ersetzen... Alternativ kann statt der IP auch der Hostname eingegeben werden.

Wenn ('''und nur wenn''') das Login auf der Benutzeroberfläche der FritzBox mit User und Passwort (und nicht nur per Passwort) geschieht, den User konfigurieren:
:<code>attr FritzBox boxUser ''Benutzername'' </code>
In der Fritzbox muss dann auch "Anmeldung mit FRITZ!Box-Benutzernamen und Kennwort" ausgewählt sein.

Passwort konfigurieren:
:<code>set FritzBox password ''Passwort''</code> - legt das zugehörige Passwort fest (nur einmal --> gehört nicht in die cfg-Datei)

Manuelle TR-064 Kommandos erlauben (Das Auslesen der Readings per TR-064 funktioniert auch ohne dieses Attribut.):
:<code>attr FritzBox allowTR064Command 1</code>

==== Telnet: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
[[Datei:Screenshot_FritzBox_TelnetUser.png|mini|300px|rechts|Anlegen des Attributs telnetUser]]
Bei Fernzugriff über Telnet sind weitere Schritte nötig:
# Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon)
# TelnetUser definieren (wie im Screenshot gezeigt)
# Passwort zum Benutzer auf der Fritzbox definieren

[[Datei:Screenshot_FritzBox_Passwort.png|mini|300px|rechts|Passwort definieren]]

(bitte die Buttons {{Taste|set}} und {{Taste|attr}} bei der Definition der jeweiligen Einträge nicht vergessen)

Wer stattdessen lieber das [[Konfiguration|Befehl-Eingabefeld]] verwendet:

:<code>define FritzBox FRITZBOX</code>
:<code>attr FritzBox telnetUser ''Benutzername'' </code> - legt den Benutzer fest
:<code>set FritzBox password ''Passwort'' </code> - legt das zugehörige Passwort fest

Wer keinen User konfiguriert hat, kann das Feld "telnetUser" leer lassen.

Wer sicher gehen möchte, dass auch tatsächlich Telnet und nicht andere Zugriffe benutzt werden, sollte außerdem noch setzen:

:<code>attr FritzBox forceTelnetConnection 1</code>

=== mögliche Fehlermeldungen ===
Sollte schon bei <code>define FritzBox FRITZBOX</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte prüfen, ob Fhem auf dem aktuellen Stand ist und ggf. [[Update|aktualisieren]].

Kommt jetzt bei der erneuten Definition die Fehlermeldung <code>Error: Perl modul Net::Telnet is missing on this system</code> bitte wie oben schon erwähnt den Befehl
:<code>sudo apt-get install libnet-telnet-perl</code>
direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten.
Sollte alles geklappt haben, seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell vornehmen und/oder automatisch vornehmen lassen.

== Anwendung ==
=== Define ===
Siehe [http://fhem.de/commandref_DE.html#FRITZBOX commandref]

=== Attribute ===
Siehe commandref

=== TR-064 ===
Die offizielle Programmier-Schnittstelle der Fritz!Box läuft über das Protokoll TR-064.

mit dem Attribute<br/>
<code>attr <device> allowTR064Command 1</code><br/>
kann man den Befehl<br/>
<code>get <device> tr064Command <service> <control> <action> [[parameterName1 parameterValue1] ...]</code><br/>
freischalten und damit auf diese Schnittstelle zugreifen.

AVM hat die Schnittstellenbeschreibung unter [http://avm.de/service/schnittstellen/] veröffentlicht. Diese wird jedoch nur sehr sporadisch gepflegt.<br>
Ein besserer Einstiegspunkt befindet sich auf der Box unter http://fritz.box:49000/tr64desc.xml.<br>
Die möglichen TR-064-Aktionen kann man auch über den Befehl <code>get <device> tr064ServiceList</code> auslesen.

Folgende Service und Controls existieren (für den get-Befehl ''tr064Command'' werden nur die fett formatierten Wörter benötigt)

{| class="wikitable"
|-
!serviceType!!controlURL!!XML!!Dokument bei AVM
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceInfo:1'''||/upnp/control/'''deviceinfo'''||[http://fritz.box:49000/deviceinfoSCPD.xml deviceinfoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceinfoSCPD.pdf deviceinfoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceConfig:1'''||/upnp/control/'''deviceconfig'''||[http://fritz.box:49000/deviceconfigSCPD.xml deviceconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceconfigSCPD.pdf deviceconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Layer3Forwarding:1'''||/upnp/control/'''layer3forwarding'''||[http://fritz.box:49000//layer3forwardingSCPD.xml layer3forwardingSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/layer3forwardingSCPD.pdf layer3forwardingSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANConfigSecurity:1'''||/upnp/control/'''lanconfigsecurity'''||[http://fritz.box:49000//lanconfigsecuritySCPD.xml lanconfigsecuritySCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanconfigsecuritySCPD.pdf lanconfigsecuritySCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''ManagementServer:1'''||/upnp/control/'''mgmsrv'''||[http://fritz.box:49000//mgmsrvSCPD.xml mgmsrvSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/mgmsrvSCPD.pdf mgmsrvSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Time:1'''||/upnp/control/'''time'''||[http://fritz.box:49000//timeSCPD.xml timeSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/timeSCPD.pdf timeSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''UserInterface:1'''||/upnp/control/'''userif'''||[http://fritz.box:49000//userifSCPD.xml userifSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/userifSCPD.pdf userifSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_VoIP:1'''||/upnp/control/'''x_voip'''||[http://fritz.box:49000//x_voipSCPD.xml x_voipSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_voipSCPD.pdf x_voipSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Storage:1'''||/upnp/control/'''x_storage'''||[http://fritz.box:49000//x_storageSCPD.xml x_storageSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_storageSCPD.pdf x_storageSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_OnTel:1'''||/upnp/control/'''x_contact'''||[http://fritz.box:49000//x_contactSCPD.xml x_contactSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_contactSCPD.pdf x_contactSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_WebDAVClient:1'''||/upnp/control/'''x_webdav'''||[http://fritz.box:49000//x_webdavSCPD.xml x_webdavSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_webdavSCPD.pdf x_webdavSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_UPnP:1'''||/upnp/control/'''x_upnp'''||[http://fritz.box:49000//x_upnpSCPD.xml x_upnpSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_upnp.pdf x_upnp.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_RemoteAccess:1'''||/upnp/control/'''x_remote'''||[http://fritz.box:49000/x_remoteSCPD.xml x_remoteSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_remoteSCPD.pdf x_remoteSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_MyFritz:1'''||/upnp/control/'''x_myfritz'''||[http://fritz.box:49000/x_myfritzSCPD.xml x_myfritzSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_myfritzSCPD.pdf x_myfritzSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_TAM:1'''||/upnp/control/'''x_tam'''||[http://fritz.box:49000/x_tamSCPD.xml x_tamSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_tam.pdf x_tam.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_AppSetup:1'''||/upnp/control/'''x_appsetup'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_appsetupSCPD.pdf x_appsetupSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Homeauto:1'''||/upnp/control/'''x_homeauto'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_homeautoSCPD.pdf x_homeautoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:1'''||/upnp/control/'''wlanconfig1'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:2'''||/upnp/control/'''wlanconfig2'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:3'''||/upnp/control/'''wlanconfig3'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Hosts:1'''||/upnp/control/'''hosts'''||[http://fritz.box:49000/hostsSCPD.xml hostsSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/hostsSCPD.pdf hostsSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANEthernetInterfaceConfig:1'''||/upnp/control/'''lanethernetifcfg'''||[http://fritz.box:49000/lanifconfigSCPD.xml lanifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanifconfigSCPD.pdf lanifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANHostConfigManagement:1'''||/upnp/control/'''lanhostconfigmgm'''||[http://fritz.box:49000/lanhostconfigmgmSCPD.xml lanhostconfigmgmSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanhostconfigmgmSCPD.pdf lanhostconfigmgmSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANCommonInterfaceConfig:1'''||/upnp/control/'''wancommonifconfig1'''||[http://fritz.box:49000/wancommonifconfigSCPD.xml wancommonifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wancommonifconfigSCPD.pdf wancommonifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLInterfaceConfig:1'''||/upnp/control/'''wandslifconfig1'''||[http://fritz.box:49000/wandslifconfigSCPD.xml wandslifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandslifconfigSCPD.pdf wandslifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLLinkConfig:1'''||/upnp/control/'''wandsllinkconfig1'''||[http://fritz.box:49000/wandsllinkconfigSCPD.xml wandsllinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandsllinkconfigSCPD.pdf wandsllinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANEthernetLinkConfig:1'''||/upnp/control/'''wanethlinkconfig1'''||[http://fritz.box:49000/wanethlinkconfigSCPD.xml wanethlinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanethlinkconfigSCPD.pdf wanethlinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANPPPConnection:1'''||/upnp/control/'''wanpppconn1'''||[http://fritz.box:49000/wanpppconnSCPD.xml wanpppconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanpppconnSCPD.pdf wanpppconnSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANIPConnection:1'''||/upnp/control/'''wanipconnection1'''||[http://fritz.box:49000/wanipconnSCPD.xml wanipconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanipconnSCPD.pdf wanipconnSCPD.pdf]
|-
|}

=== Status-Symbol ===
<code>attr <device> devStateIcon .*on.*off:WLAN_on_gWLAN_off .*on.*on.*:WLAN_on_gWLAN_on WLAN..off.*:WLAN_off</code>

Im Verzeichnis www/images/default müssen die passenden Dateien "WLAN_on_gWLAN_off.png", "WLAN_on_gWLAN_on.png" und "WLAN_off.png" liegen. Wenn die PNGs fehlen, können sie {{Link2Forum|Topic=29725|Message=318113|LinkText=hier}} heruntergeladen werden.

== Anwendungsbeispiele ==
[[Datei:Screenshot_FritzBox1.png|mini|300px|rechts|FRITZBOX Gerät auf der Fhem Oberfläche]]
Sollte alles geklappt haben, seht ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").

=== TR-064 Beispiele ===
*Box Reboot: <code>get <device> tr064Command DeviceConfig:1 deviceconfig Reboot</code>
*Internet Reconnect: <code>get <device> tr064Command WANIPConnection:1 wanipconnection1 ForceTermination</code>
*Daten eines Smart-Home-Gerätes auslesen: <code>get <device> tr064Command X_AVM-DE_Homeauto:1 x_homeauto GetGenericDeviceInfos NewIndex 0</code>

=== Klingel- und Sprachausgabe per TR-064 ===
Das geht derzeit nicht, da entsprechende Kommandos per TR-064 nicht verfügbar sind. Da Telnet sukzessive abgestellt wird, sollten sich Interessenten per Feature-Request an AVM wenden, wie {{Link2Forum|Topic=38586|LinkText=hier}} beschrieben.

=== Anwesenheitserkennung per regelmäßiger Abfrage über das PRESENCE Modul ===
Fritzboxen und die FRITZ!WLAN Repeater speichern den Status angemeldeter Geräte. Dieser Status lässt sich mittels des FRITZBOX Moduls über Readings abfragen, die das Format mac_AA_AA_AA_AA_AA_AA haben und die MAC-Adressen der jeweils angemeldeten Geräte (AA:AA:AA:AA:AA:AA) enthalten. Das Reading existiert, wenn das Gerät angemeldet ist. Wenn das Gerät abgemeldet ist, existiert es nicht mehr. Es gibt auch noch den Zwischenstatus "inactive", der anscheinend gesetzt wird, bevor das Reading gelöscht wird.

Mit Hilfe des [[PRESENCE]] Moduls (vgl. [[Anwesenheitserkennung]]) kann man auf diese Weise den Anwesenheitsstatus abfragen. Anregungen dazu gibt es im zugehörigen {{Link2Forum|Topic=39433|LinkText=Forenthread}} zur Anwesenheitserkennung und in [http://heinz-otto.blogspot.de/2015/07/die-zeiten-andern-sich.html diesem Blogpost]. Auf dieser Basis könnte eine einfache Implementierung zum Beispiel so aussehen:

Funktion in [[99_myUtils anlegen|99_myUtils]]:

<source lang='perl'>sub checkFritzMACpresent($$) {
# Benötigt: Name der zu testenden Fritzbox ($Device),
# zu suchende MAC ($MAC),
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($Device, $MAC) = @_;
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my $StatusFritz = ReadingsVal($Device, $MAC, "weg");
if ($StatusFritz eq "weg") {
Log 1, ("checkFritzMACpresent ($Device): $MAC nicht gefunden, abwesend.");
$Status = 0;
} elsif ($StatusFritz eq "inactive") {
Log 1, ("checkFritzMACpresent ($Device): $MAC ist >inactive<, also abwesend.");
$Status = 0;
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät per WLAN angemeldet.
Log 1, ("checkFritzMACpresent ($Device): $MAC gefunden, Gerät heißt >$StatusFritz<.");
$Status = 1;
}
return $Status
}
</source>

Nutzung dieser Funktion mit dem PRESENCE Modul definieren:
:<code>define <Name> PRESENCE function {checkFritzMACpresent("Fritzbox","AA:BB:CC:DD:EE:FF")} 60 60</code>
wobei
*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,
*Fritzbox der Name ist, mit dem ihr die abzufragende Fritzbox als FRITZBOX definiert habt,
*AA:BB:CC:DD:EE:FF die MAC-Adresse des gesuchten Geräts ist.
* "60 60" sagt, dass der Anwesenheitsstatus im 60-Sekunden-Takt abgefragt wird. Das macht natürlich nur Sinn, wenn ihr mit <code>attr Fritzbox INTERVAL 60</code> den Abfrageinterval bei der Fritzbox auch entsprechend hochgesetzt habt. Der Standard ist 300.
* "Log 1" führt immer zum Loggen. Das ist zum Einrichten praktisch, ohne dass man gleich für das ganze Modul oder ganz FHEM <code>attr <device> verbose 5</code> setzen muss. Wenn es läuft, können die "Log 1"-Zeilen gelöscht, auskommentiert (# an den Zeilenanfang) oder in "Log 5" geändert werden.

=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===
Existiert ein AVM Repeater im Netzwerk, kann der als eigenständiges Gerät mit FRITZBOX definiert werden. WLAN Geräte an der Fritzbox werden in der Instanz der Fritzbox gelistet und WLAN Geräte am Repeater in der Repeater Instanz. Um trotzdem die Anwesenheit im Netzwerk einfach zu erkennen, muss die Subroutine in 99_myUtils.pm abgewandelt werden.

Existiert eine zweite Fritzbox im Accesspointmodus, werden die WLAN Geräte im Netzwerk alle in der Hauptfritzbox an einem LAN Anschluss gelistet. D.h. man sieht an der Hauptfritzbox nicht, dass sie im WLAN sind. Eine zweite Instanz mit dem FRITZBOX Modul muss wegen der Anwesenheitserkennung nicht gemacht werden. Die folgende Routine kann aber universell eingesetzt werden, unabhängig von der Anzahl der FRITZBOX Instanzen. Wer mitloggen will, kann das analog zur obigen Routine einbauen

<source lang='perl'>sub checkAllFritzMACpresent($) {
# Benötigt: nur die zu suchende MAC ($MAC),
# Es werden alle Instanzen vom Type FRITZBOX abgefragt
#
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($MAC) = @_;
# Wird in keiner Instanz die MAC Adresse gefunden bleibt der Status 0
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my @FBS = devspec2array("TYPE=FRITZBOX");
foreach( @FBS ) {
my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
} elsif ($StatusFritz eq "inactive") {
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät am Netzwerk angemeldet.
$Status = 1;
}
}
return $Status
}
</source>

Da hiermit nach allen Instanzen mit dem TYPE=FRITZBOX durchsucht wird, braucht der Name der Fritzbox nicht angegeben werden.

:<code>define <Name> PRESENCE function {checkAllFritzMACpresent("AA:BB:CC:DD:EE:FF")} 60 60</code>

Weitere Hinweise zu komplexeren Abfragen mehrere Boxen auf einmal etc. findet ihr auch im diesem {{Link2Forum|Topic=39433|LinkText=Forenthread}}.

=== Anwesenheitserkennung per Notify ===
Der von Fritzboxen und Fritz!WLAN Repeatern gespeicherte Status zum Status angemeldeter Geräte lässt sich (statt per PRESENCE, s.o.) auch per [[notify]] anfragen:

<source lang="perl">define <Name> notify Fritzbox:mac_AA_BB_CC_DD_EE_FF:.* {
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive")
{
fhem("set anwesend_smartphone absent");
}
else
{
fhem("set anwesend_smartphone present");
}
}</source>

Hinweise:
* <code>fhem("set anwesend_smartphone absent");</code> ist nur ein Beispiel, das einen Dummy auf den Status "absent" bzw. "present" setzt. Man kann hier natürlich auch gleich entsprechende Aktionen durchführen. Wer das Beispiel übernehmen möchte, sollte den Dummy vorher definieren (<code>define anwesend_smartphone dummy</code>).
* mac_AA_BB_CC_DD_EE_FF ist die MAC-Adresse des gesuchten Geräts.
* "Fritzbox" ist der Name, unter dem die Fritzbox als FRITZBOX-Modul definiert wurde.
* Das Notify funktioniert, weil Geräte, wenn sie sich abgemeldet haben, erst den Status "inactive" erhalten. Ist das Gerät ganz abgemeldet, verschwindet das mac_.*-Reading. Dabei löst das Notify nicht mehr aus. Da das mac-.*-Reading aber vorher auf "inactive" stand, wurde die Abwesend-Aktion schon ausgeführt.
* Damit der Notify nicht andauernd losgeht, sollte man mittels <code>attr Fritzbox [[event-on-change-reading]] mac_AA_BB_CC_DD_EE_FF</code> Events nur auslösen, wenn sich der Status des Gerätes ändert. Will man mehrere Geräte abfragen, sollte man <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF,mac_GG_HH_II_JJ_KK_LL</code> setzen, damit bei der Änderung jedes Readings ein Event ausgelöst wird.

=== Vergleich Anwesenheitserkennung PRESENCE/Notify ===
Die Anwesenheitserkennung per regelmäßiger PRESENCE-Abfrage hat den Vorteil, dass sie im Turnus der regelmäßigen Abfragen immer einen aktuellen Status produziert. Sie hat dafür den Nachteil, dass die PRESENCE-Funktionen regelmäßig abgearbeitet werden müssen, auch wenn sich gar nichts ändert. Außerdem aktualisiert sich der Status nicht sofort, sondern erst bei der nächsten regelmäßigen Abfrage. Durch häufiges Abfragen kann dieser Nachteil verringert werden (bei entsprechend höherer Systemlast).

Die Anwesenheitserkennung per Notify hat den Vorteil, dass ein sich ändernder Status sofort abgebildet wird. Ändert sich kein Status, werden keine Routinen ausgeführt, was die Systemlast gering hält. Der Nachteil ist, dass - z.B. nach einem Systemstart - die entsprechende Aktion erst bei einer Änderung des Status ausgeführt wird. D.h. ist das zu testende Gerät anwesend, wird dann FHEM beendet, das Gerät entfernt und FHEM wieder gestartet, ist der Status in FHEM immer noch "anwesend". Da das Reading für das Gerät nicht existiert, wird darauf auch erst wieder ein Notify ausgeführt, wenn sich der Status des Geräts wieder ändert, d.h. es wieder ankommt. Bis dahin ist der Status im System falsch.
Der Nachteil des Notify kann verringert werden, wenn man statt <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF</code> ein <code>attr Fritzbox [[event-on-update-reading]] mac_AA_BB_CC_DD_EE_FF</code> setzt. Das erhöht allerdings die Systemlast und funktioniert auch nur für den Status "anwesend". Bei "abwesend" ist kein Reading vorhanden, so dass auch event-on-update-reading nicht ausgeführt wird.
Eine weitere Möglichkeit, den Nachteil der Notify-Methode auszugleichen, ist, die Statusabfrage beim Systemstart einmal manuell auszuführen, durch ein notify auf "GLOBAL:initialized":
<source lang="perl">
global:INITIALIZED {
Reset_Variables;
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive") {
fhem("set anwesend_smartphone absent");
} else {
fhem("set anwesend_smartphone present");
}
}
</source>
Das hilft allerdings nur beim Systemstart. Nicht, wenn FHEM aufgrund irgendwelcher Hänger eine Aktualisierung des Status verpasst hat.

=== userReadings per get tr064Command ===
Um dem Gerätewert <userReadingName> den Wert von <VariabelName> aus der Rückgabe des get-Befehls ''tr064Command'' zuzuordnen
<pre>
attr <device> userReadings <userReadingName> {my $resp=fhem("get <device> tr064Command <service> <control> <action> [[<argName1> <argValue1>] ...]",1);;$resp =~/\'<VariabelName>\' => '(.*)'/;;return $1;;}
</pre>
Beispielsweise
<pre>attr Fritzbox userReadings urMobilteil_1 {my $resp=fhem("get Fritzbox tr064Command X_AVM-DE_OnTel:1 x_contact GetDECTHandsetInfo NewDectID 1",1);;$resp =~/'NewHandsetName' => '(.*)'/;;return $1;;},
urDownstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewDownstreamCurrRate' => '(.*)'/;;return $1;;},
urUpstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewUpstreamCurrRate' => '(.*)'/;;return $1;;}</pre>

=== Klingelton-Einstellung und Abspielen von Sprachnachrichten bei Fritz!OS-Versionen >6.24 ===
Wenn die Fritzbox weder die Telnet- noch die webcmd-Schnittstelle hat, kann der Klingelton der Fritz!Fons nicht mehr verstellt und auch keine Sprachnachricht über ein Fritz!Fon ausgegeben werden.

Es gibt eine Behelfslösung über das Attribut ''useGuiHack''. Dadurch wird eine Eingabe in die WebGUI der Fritzbox simuliert.

'''ACHTUNG''': Vor allem nach einem Update der FritzBox kann es durch dieses Attribut zu ungewolltem Verstellen von Werten in der Fritzbox kommen.

Bei Verwendung der ring-Parameter "play:" und "say:" wird die abzuspielende URL in die M3U-Datei, die unter dem Internal ''M3U_LOCAL'' steht, eingetragen.<br>
Standardmäßig wird versucht, diese Datei im image-Verzeichnis von FHEM abzulegen. Diese kann dann vom Fritz!Fon über [[FHEMWEB]] abgespielt werden (IP-Freigaben beachten). Direkt nach dem ersten Anlegen der m3u-Datei kennt [[FHEMWEB]] diese noch nicht, daher bitte entweder ''set <webdevice> rereadicons'' ausführen oder FHEM neu starten.<br>

Aufgrund der Beschränkungen von [[FHEMWEB]] oder auch bei Authentifizierungsanforderungen ist es empfehlenswert, die Datei über das Attribute ''m3uFileLocal'' selber vorzugeben. Am besten auf einem Webserver, der auf dem FHEM-Server läuft und dessen Seiten-Verzeichnis durch FHEM beschreibbar ist.<br>
Beispiel: <code>attr Fritzbox m3uFileLocal /var/www/mp3/Fritzbox.m3u</code>

In dem Radioeintrag ''FHEM'' muss dann '''auf der FritzBox''', die '''Web'''-Adresse der entsprechenden Datei eingetragen werden. Dieser Sender sollte zu Testzwecken dann auch einmal am Fritz!Fon von Hand gestartet werden.<br>
Das Modul versucht, beim Start die einzutragende Radio-URL im image-Verzeichnis selber zu ermitteln (IP-Freigabe beachten). Gelingt dies, so steht diese im Internal ''M3U_URL''.

=== Ring auf mehreren Telefonen gleichzeitig ===

Damit mehrere Telefone per ring gleichzeitig Klingel, muss in der Fritzbox eine Rufgruppe definiert werden.
Sollte eine Türsprechanlage schon in Benutzung sein, kann die eventuell hierfür bereits eingerichtete Gruppe verwendet werden.
Das anlegen der Gruppe erfolgt wie in folgender AVM Anleitung erledigt werden. [http://http://avm.de/service/fritzbox/fritzbox-7390/wissensdatenbank/publication/show/1148_Interne-Rufgruppe-in-FRITZ-Box-einrichten-Gruppenruf/ AVM Interne Rufgruppe anlegen]

Es muss eine Kurzwahl bei der Gruppe zwingend hinterlegt sein.
Danach kann mit folgendem Beispiel Code gearbeitet werden:

<code>set FritzBox ring 791 15 show:Türklingel</code>

Name des Devices, Rufgruppen Nummer, Länge und gezeigter Text auf das gewünschte anpassen.

== Bekannte Probleme / Fehlersuche ==
=== Modul bleibt im Status "Check APIs" hängen===
Im Log steht die Meldung: "Error: Timeout when reading Fritz!Box data.".

Mögliche Ursache: Nutzung des FHEM-Befehls [[FHEM_Command_Beispiele#rereadcfg|rereadcfg]]. Dieser verträgt sich nicht mit dem Modul "blocking.pm", das für parallel laufende FHEM-Prozesse genutzt wird.

Abhilfe schafft ein Neustart <code>shutdown restart</code> oder das Einfügen eines zusätzlichen, lokalen Telnet-Ports z.B. durch <code>define tPortLocal telnet 7073</code>

=== Nachtschaltung Doppel-WLAN ===
Beim Abschalten des WLAN über das Modul wird (über TR064) zuerst das 2.4 GHz und dann das 5 GHz WLAN ausgeschaltet. Bei der gleichzeitigen Nutzung der WLAN-Nachtschaltung (Anschalten über das Fritz!OS) wird dann jedoch nur noch das 5 GHz WLAN wieder angeschaltet. Die Box interpretiert den TR064-Befehl anscheinend als ein komplettes Abwählen des 2.4 GHz WLAN.

Abhilfe schafft hier nur ein notify auf das 5 GHz WLAN mit einem nachträglichem Anschalten des 2.4 GHz WLAN.

Alternativ kann das Ausschalten des WLANs nicht direkt über TR064-Kommandos, sondern über einen indirekten Weg erfolgen: über TR064 ein set call abzusetzen und hier den Tastencode zum Ausschalten des WLANs einzugeben, bei einer FritzBox 7490 wäre dies z. B. #96*0*.
Schaltet man über diese Methode das WLAN aus, kann es über die Nachtschaltung wieder automatisch auf beiden Frequenzen angeschaltet werden.

=== Kabelboxen ===
Bei Fritz!Boxen für den Kabelanschluss (z.B. Kabel Deutschland) scheint neben Telnet auch die TR064-API nicht zu funktionieren. Vermutlich wurde die API von AVM auf Betreiberwunsch deaktiviert, da man sonst Dinge ändern kann, die das gesamte Kabelnetz stören können.

=== Wenn's nicht klingelt ===
Das Klingeln erfolgt über die Wählhilfe. Eventuell muss über die Weboberfläche der Fritz!Box ein anderer Port eingestellt werden. Der aktuelle steht in "box_stdDialPort".

=== TR064-Transport-Error: 500 Can't connect to ...:49443 (certificate verify failed) ===
Eventuell hilft es, die Perl Module Net::HTTPS, Net::SSL und IO::Socket::SSL zu aktualisieren.

=== "Error: Old SID not valid anymore." nach Erlauben von IPv6 auf der Fritzbox ===
Ohne hier den genauen Grund zu kennen - es hilft die Angabe der IPv4-Adresse: also statt <code>define FritzBox FRITZBOX</code> dann <code>define FritzBox FRITZBOX <IP></code> (z.B. <code>define FritzBox FRITZBOX 192.168.10.1</code>), so dass das Modul nicht über IPv6 geht.

=== "Didn't get a session ID" ===
Höchstwahrscheinlich wurde ein falsches Passwort gesetzt.

:<code>set <DEVICE> password <PASSWORD></code>

== Links ==
* {{Link2Forum|Topic=29725|LinkText=Forenthread}} zu diesem Modul

[[Kategorie:FritzBox]]

FHEM Tablet UI

2017-01-13T19:35:49Z

Thomas.kregelin: Platzhalter für data-get-warn Attribut eingefügt im Symbol-Widget

{{Infobox Modul
|ModPurpose=Oberfläche für Fhem
|ModType=x
|ModFTopic=34233
|ModForumArea=Frontends
|ModTechName=n.a.
|ModOwner=setstate ({{Link2FU|7023|Forum}})
}}
[[Datei:tablet_ui.png|200px|thumb|right|Fhem Tablet UI]]
FHEM Tablet UI ist ein leichtgewichtiges aber funktionsreiches Framework zum Steuern und Überwachen von in Fhem integrierten Geräten. Zahlreiche Widgets können sehr flexibel und leicht per HTML Code konfiguriert werden.

In dieser Anleitung wird die Installation und Konfiguration des FHEM Tablet UI beschrieben.

{{Todo|alle Widgets hier übernehmen, Übersetzung, weitere Beispiele aus dem Forum einfügen (evtl. mit Link!?)}}

== Voraussetzungen ==
Das User Interface hat sehr wenige Anforderungen für den Betrieb. Es benötigt <u>keine</u> zusätzliche Frameworks, wie z.B. PHP oder MySQL.

Voraussetzungen ist eine Fhem Installation mit HTTPSRV Modul. Das UI kann mit den gängigen Browsern Betriebssystem unabhängig genutzt werden oder mit dem Webviewcontrol.
Das Interface wird dabei in dem FHEM eigenen Webserver ausgeführt. Mit wenigen Anpassungen ist es auch möglich das UI auf anderen Webservern (Apache, u.a.) zu betreiben, dann kann FHEM und UI auch auf getrennten Systemen ausgeführt werden.

== Installation ==
* Im Befehls-Eingabefeld eingeben: <code><nowiki>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>
* Im Befehls-Eingabefeld eingeben: <code>define TABLETUI HTTPSRV ftui/ ./www/tablet Tablet-UI</code>
* Im Verzeichnis ./fhem/www/tablet die Datei index-example.html in index.html umbenennen oder eine neue index.html erzeugen und diese index.html wie nachfolgend beschrieben editieren.

Das UI ist über den Link "Tablet-UI" auf der Fhem-Hauptseite oder durch Direktaufruf der URL "<nowiki>http://<Fhem-url>:8083/fhem/tablet/index.html</nowiki>" zu erreichen.

Hinweise zu einer manuellen Installation und weitere Infos sind auf der Projektseite https://github.com/knowthelist/fhem-tablet-ui zu finden.

== Update ==
* Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von: <code><nowiki>update check https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>
* Update des UI durch Eingabe von: <code><nowiki>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

Über
<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>
kann seit dem 24.12.2015 die URL zum normalen Updatebefehl von FHEM hinzugefügt werden. Mit einen "update check" sieht man dann gleich alle Updates aus beiden "Welten".

== Weitere Widgets ==

=== Widgets for Fhem-tablet-ui ===

'''Achtung''': die nesges-Widgets sind nicht mehr kompatibel mit der aktuellen FHEM Tablet UI Version. Aktuell bitte kein Installation aus dieser Quelle mehr durchführen.

Zusätzlich zu den bei der Installation des Tablet UI direkt zur Verfügung stehenden Widgets, gibt es eine weitere Widget-Quelle von nesges unter https://github.com/nesges/Widgets-for-fhem-tablet-ui. Die Widgets aus dieser Quelle müssen für eine Nutzung separat installiert werden.

Dazu folgenden Befehl in die Fhem-Befehlszeile eingeben: <code><nowiki>update all https://raw.githubusercontent.com/nesges/Widgets-for-fhem-tablet-ui/master/controls_widgets-for-fhem-tablet-ui.txt</nowiki></code>.

Näheres zur Installation unter [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/Installation Wiki: Installation].

Die Dokumentation der einzelnen Widgets befindet sich ebenfalls [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki im Github-Wiki].

== Konfiguration ==
'''META-Parameter'''

Das Tablet UI lässt sich über die META-Parameter konfigurieren. Mit den meisten META-Parametern kann das verhalten des UI beeinflusst werden. Diese Parameter befinden sich in der jeweiligen '''.html''' Datei (z.B. index.html) im Abschnitt '''<head>'''. Nachfolgend sind die verschiedenen Konfigurationsparameter aufgeführt. Die Parameter sind immer gleich aufgebaut.

:<code><meta name="<META-Parameter>" content="<Wert>"></code>

{| class="wikitable"
|-
! META-Parameter !! Wert / Beispiel !! Erklärung
|-
| longpoll || 1 oder 0 || Refresh sofort, alle 15 Minuten ein voller Refresh (shortpoll) statt alle 30 Sekunden ein voller Refresh.
|-
| gridster_disable || 1 oder 0 || Drag&Drop der Gridster-Elemente auf der Seite deaktivieren.
|-
| toast || 1 oder 0 || Toast messages deaktivieren
|-
| fhemweb_url || http://meinFhemServer:8083/fhem || Wird benötigt wenn der Webserver des TabletUI nicht auf dem FHEM Server läuft.Default: "/fhem/"
|-
| widget_margin || 1 bis 9999 || Abstände der Gridsterelemente verändern.
|-
| widget_base_width || 1 bis 9999 || Größe des Basis-Rasters (data-sizey=1/data-sizex=1) verändern.
|-
| widget_base_height || 1 bis 9999 || Größe des Basis-Rasters (data-sizey=1/data-sizex=1) verändern.
|}

''Layout''

Erscheint zum Beispiel das Layout der Example index.html zu klein, kann das durch ändern der Gridster-Basis angepasst werden.

vorher

<pre><meta name="widget_base_width" content="77">
<meta name="widget_base_height" content="71"></pre>

nachher

<pre><meta name="widget_base_width" content="154">
<meta name="widget_base_height" content="142"></pre>

''FHEM URL''

Werden die FTUI Seiten von einem anderen Server als FHEM-HTTPSRV bereitgestellt, muss man die URL, unter der FHEM angesprochen wird, anpassen:

<pre><meta name="fhemweb_url" content="/fhem/"></pre>

'''CSS-Styles'''

Das Layout und das Aussehen des UI kann durch diverse vorgegebene CSS-Klassen beeinflusst werden. Die verfügbaren Klassen sind im Abschnitt [[#CSS Class description|CSS Class description]] oder [[#Positioning|Positioning]] aufgeführt. Es besteht auch die Möglichkeit eine eigene CSS Datei zu erstellen und darüber Änderungen am aussehen des UI vorzunehmen. Die eigenen CSS Datei würde bei einem Update unverändert bleiben. Daher ist abzuraten ein CSS Datei die mit dem UI Update verteilt wird zu modifizieren. Die eigene CSS Datei ist unter '''/fhem/tablet/css''' mit dem Namen '''fhem-tablet-ui-user.css''' zu finden. Sollte diese nicht vorhanden sein kann die Datei manuell erstellt werden.
Wird keine eigene CSS-Datei verwendet empfiehlt es sich den folgenden Eintrag im <head> der jeweiligen .html Datei zu entfernen, bzw. in Kommentar gesetzt werden um Probleme beim Laden der Seite zu verhindern.

:<code><link rel="stylesheet" href="/fhem/tablet/css/fhem-tablet-ui-user.css" /></code>

== Farbe ==
Es besteht die Möglichkeit, die Farbwerte in hexadezimaler Form oder als RGB-Wert anzugeben. Zum Beispiel: Hex: #A3CFA3 RBG: rgb(163, 207, 163).

Knallige Farben wie #ff0000 für Rot oder #00ff00 für Grün sollten vermieden werden. Es ist besser unterhalb von #D0 (208) für die Grundfarben zu bleiben.

Hilfreich bei der Suche nach den Farbwerten ist der color picker: http://www.w3schools.com/tags/ref_colorpicker.asp oder diese Quelle: https://flatuicolors.com

== CSS Class description ==

Not all widgets support all classes

* readonly : changing of state is not allowed
* wider : 25px extra space for the widget to the top
* narrow : shorter distant to the widget above
* w1x, w2x, w3x : set the widget to a fix width: 1x, 2x, 3x width
* mini : lowest diameter for volume widget
* small : font 80% size (label), small diameter for volume widget
* medium : font 120% size
* large : font 150% size
* big : font 200% size
* bigplus : font 270% size
* bigger : font 320% size
* bigger.thin : font 450% size
* grande : font 600% size
* gigantic: font 144px size + 120px line-height
* thin : font thin
* darker : forecolor in gray
* hue-tick : draw ticks in color range
* hue-front : draw handle in color range
* hue-back : draw background in color range
* dim-tick : draw ticks in brightness range
* dim-front : draw handle in brightness range
* dim-back : draw background in brightness range
* red : foreground color red
* green : foreground color green
* blue : foreground color blue
* doublebox-v : container to place 2 small widgets (e.g. switch) one above the other
* doublebox-h : container to place 2 small widgets (e.g. switch) side by side
* timestamp : deliver the date time for the reading instead the value
* inline : positioning elements in a row, no line break
* top-space : 15px extra on top (top-space-2x -> 30px; top-space-3x -> 45px)
* left-space : 15px extra on left (left-space-2x -> 30px; left-space-3x -> 45px)
* right-space : 15px extra on right (right-space-2x -> 30px; right-space-3x -> 45px)
* blink : blink animatation for label or symbol widget
* verticalLine : Vertikale Line am rechten Rand

== Positioning ==

*container : new box or new row
*col-x-y : new column with x/y of width (col-1-3,col-2-3,col-1-2,col-1-4,col-1-8,col-1-5,col-2-5,col-3-5,col-4-5)
*inline : positioning elements in a row, no line break
*top-space : 15px extra on top (top-space-2x -> 30px; top-space-3x -> 45px)
*left-space : 15px extra on left (left-space-2x -> 30px; left-space-3x -> 45px)
*right-space : 15px extra on right (right-space-2x -> 30px; right-space-3x -> 45px)
*top-narrow : -15px closer on top (top-narrow-2x -> -30px; top-narrow-10 -> -10px)
*centered : horizontal centered
*left-align : align text left
*left : floating left
*right-align : align text right
*right : floating right
*wider : 15px extra space for the widget all around
*narrow : shorter distant to the widget above
*fullsize : 100% in width and height

== Widgets -- Konfiguration ==

Teilweise dokumentierte Widgets:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/button button]: Variante der push und switch Widgets, die entweder einen URL ansteuern oder einen Fhem-Befehl absetzen kann.
* [[#chart|chart]]: chart with similar capabilities as the FHEM plots
* checkbox:
* [[#circlemenu|circlemenu]]: Mehrere Widgets hinter einem Widget verborgen, trotz des 'circle' im Namen kann das Menue jetzt auch horizontal oder vertikal ausgeklappt werden
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/clicksound clicksound]: Mit dem Widget "clicksound" können Sounds an Click-Events von Elementen gebunden werden.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/clock clock]: Das Widget "clock" stellt eine einfach Uhr zur verfügung.
* colorwheel:
* daytimepicker:
* [[#departure|departure]]: show timetable of public transport provider
* [[#dimmer|dimmer]]: toogle button with a setter for on value
* eventmonitor:
* highchart:
* [[#homestatus|homestatus]]: selector for 4 states (1=home, 2=night, 3=away, 4=holiday)
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/iframe iframe]]: Widget zum Einbinden externer Inhalte in einem Iframe.
* [[#image|image]]: insert an image, the URL is given by a reading
* input:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/itunes_artwork itunes_artwork]: itunes_artwork durchsucht die iTunes-Datenbank anhand eines Arrays von beliebigen Suchworten nach einem Cover-Artwork und zeigt dieses an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/javascript javascript]: Ermöglicht die Ausführung beliebigen Javascript-Codes aus einem Reading.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/joinedlabel joinedlabel]: verbindet mehrere Readings zu einem Feld
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/klimatrend klimatrend]: wandelt Daten aus dem statistics-Modul in einen Pfeil um, der den aktuellen Trend anzeigt.
* Knob:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/kodinowplaying kodinowplaying]: zeigt Informationen zu grade in KODI gespielten Medien in Form eines Labels an.
* [[#label|label]]: STATE als Text anzeigen
* [[#level|level]]: vertical/horizontal bar to show values between min/max value
* link:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/mpdnowplaying mpdnowplaying]: zeigt Titelinformationen eines per MPD-Modul angebundenen Music Player Daemon an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/multistatebutton multistatebutton]: Variante des push-Widgets das den set-Befehl abhängig vom gelesenen Status ändert.
* [[#pagetab|pagetab]]: Element to smoothly exchange the whole page with another page
* pagebutton:
* [[#playstream|playstream]]: Abspielen eines Webradio-Streams per Button
* [[#popup|popup]]: a popup dialog which open on click on another widget
* [[#progress|progress]]: round symbolic display for percent values
* [[#push|push]]: send any command to Fhem e.g. up / down
* range:
* readingsgroup:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/reload reload]: auslösen eine Pagereloads
* [[#rotor|rotor]]: Umschalten von zwei oder mehr Widgets an einer Position
* [[#select|select]]: Combobox to provide a list for selection
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/settimer settimer]: zum anzeigen und einstellen einer Uhrzeit.
* [[#simplechart|simplechart]]: simple XY line chart for one value (reads directly from Fhem log file)
* [[#slider|slider]]: vertical slider to select between min/max value
* spinner:
* swiper:
* [[#switch|switch]]: Toggle any command to Fhem (e.g. on / off)
* [[#symbol|symbol]]: State als Symbol darstellen (z.B. Fenster offen)
* [[#thermostat|thermostat]]: dial for heater thermostates to set desired value and show current value
* [[#volume|volume]]: dial to set a single value (e.g. 0-60)
* [[#weather|weather]]: insert an icon or image, represending a weather literal
* [https://github.com/svenson08/ftui-weekdaytimer-widget weekdaytimer]: Visualisierung des [[WeekdayTimer]] Modul
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/wind_direction wind_direction]: Zeigt die Windrichtung auf einer Windrose an.

Ein Demo der Widgets findet ihr [http://knowthelist.github.io/fhem/tablet/demo_widgets.html Hier].
----------------------------------

Für alle Widgets gilt:
{| class="wikitable"
|+allgemeine Attribute
|-
!align="right" |data-type
|Widget-Typ
|-
!align="right" |data-device
|Fhem-Name des Gerätes (mit dem Befehl 'list' bekommt man im Fhem die kpl. Liste)
|-
!align="right" |class
|CSS-Klassen für Aussehen und Formatierung des Widgets
|-
|}

{| class="wikitable"
|+Daten Empfangen
|-
!align="right" |data-get
|Reading Name
|-
!align="right" |data-get-on
|Wert für den Status on
|-
!align="right" |data-get-off
|Wert für den Status off
|-
|}

{| class="wikitable"
|+Daten Senden
|-
!align="right" |data-set
|Reading Name
|-
!align="right" |data-set-on
|Wert für den Status on
|-
!align="right" |data-set-off
|Wert für den Status off
|-
|}

<div id="chart">'''CHART'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-logdevice
|name of the logdevice (e.g. FileLog_WohnzimmerHeizung) or array of names if more than one graph shall be displayed
|-
|-
!align="right" |data-logfile
|name of the logfile (e.g. WohnzimmerHeizung-2015.log) or or array of names if more than one graph shall be displayed
|'-' or omitting this data means current logfile
|-
!align="right" |data-columnspec
|definition for how to find the values (e.g. "4:meas.*:1:int") or or array of columnspecs if more than one graph shall be displayed
|-
|-
!align="right" |data-style
|name of the graph style to be used (e.g. 'SVGplot l0' or 'ftui l0dash') or or array of styles if more than one graph shall be displayed using different stlyes. The standard fhem plot styles can be used furthermore there are some more predefined styles existing (details see css file). Own styles can be specified e.g. in the fhem-table-ui-user.css file.
|-
|-
!align="right" |data-ptype
|name of the plot type (e.g. 'lines' or 'fa-cog') or or array of plottypes if more than one graph shall be displayed. All fhem plot styles are supported. Additionally it is possible to specify symbols (currently supported are font awesome ('fa-...'), open automation ('oa-...') and fhem symbols ('fs-...')). Can also be something like 'icon:1' in which case the respective columnspec should result in links to icons (e.g. for weather forecast) and the y-value is taken from the graph number 1
|'lines'
|-
!align="right" |data-uaxis
|name of the axis to be used ('primary' or 'secondary') or or array of axis' to be used if more than one graph shall be displayed. The 'primary' axis is labelled on the left side, the 'secondary' axis is labelled on the right side
|'primary'
|-
!align="right" |data-legend
|caption of the graph (used in the legend and at the cursor) or an array of legend texts if more than one graph shall be displayed.
|-
|-
!align="right" |data-minvalue
|min Y value to Show or an array of values for dynamic minY for primary axis. A value of 'auto' means that the value is calculated from the data displayed dynamically
|10
|-
!align="right" |data-minvalue_sec
|min Y value to Show or an array of values for dynamic minY for secondary axis. A value of 'auto' means that the value is calculated from the data displayed dynamically
|'auto'
|-
!align="right" |data-maxvalue
|max Y value to Show or an array of values for dynamic maxY for primary axis. A value of 'auto' means that the value is calculated from the data displayed dynamically
|30
|-
!align="right" |data-maxvalue_sec
|max Y value to Show or an array of values for dynamic maxY for secondary axis. A value of 'auto' means that the value is calculated from the data displayed dynamically
|'auto'
|-
!align="right" |data-yticks
|value distance between Y tick lines (related to primary axis). A value of 'auto' means that the value is calculated from the data displayed dynamically. Can be an array containing value pairs in order to have arbitrary text for given values (e.g. data-yticks='[[0,"open"],[1,"closed"]]')
|'auto'
|-
!align="right" |data-yticks_sec
|value distance between Y tick lines (related to secondary axis). A value of 'auto' means that the value is calculated from the data displayed dynamically.Can be an array containing value pairs in order to have arbitrary text for given values (e.g. data-yticks_sec='[[0,"open"],[1,"closed"]]')
|'auto'
|-
!align="right" |data-xticks
|time range between each X tick lines (in minutes). A value of 'auto' means that the value is calculated from the data displayed dynamically
|'auto'
|-
!align="right" |data-daysago_start
|number of days back from now for the start of the plot (0 means the plot starts from today 0:00). Additionally the x-axis start value can be set here unsing standard data formats like ('2013-10-23'), the time portion of the string is only used when <code>data-nofulldays</code> is 'true'. If the setting ends with 'w', 'W', 'm', 'M', 'y', 'Y' the nuber given is interpreted as week, month or year respectively (capital letters mean rounding to full weeks, months years) (e.g. '2Y' means that, if current date is 3.6.2015, the graph will start 1.1.2013).
|0
|-
!align="right" |data-daysago_end
|number of days back from now for the end of the plot (-1 means the plot ends today 24:00). Additionally the x-axis end value can be set here unsing standard data formats like ('2013-10-23'), the time portion of the string is only used when <code>data-nofulldays</code> is 'true'. If the setting ends with 'w', 'W', 'm', 'M', 'y', 'Y' the nuber given is interpreted as week, month or year respectively (capital letters mean rounding to full weeks, months years) (e.g. '2Y' means that, if current date is 3.6.2015, the graph will end 31.12.2013).
|-1
|-
!align="right" |data-timeformat
|setting for the formatting of the x-tick text. The format can be configured in a quite flexible way. Several format classifiers are supported which are separated by special characters ('-', '.', '/', ' ', ':', ',', '\'). All characters despite '\' will be displayed in the final output.
The following is a list of supported classifiers:
* 'LF'enters a linefeed
* 'mm' - displays minutes as 2 digits
* 'hh' - displays hours as 2 digits
* 'dd' - displays day of the month as 2 digits
* 'MM' - displays months as 2 digits (e.g. 02 for February)
* 'MMM' - displays months as 3 characters (e.g. Dec for December)
* 'MMMM' - displays monhts as full names (e.g. March)
* 'ee' - displays weekdays as 2 digits (e.g. 00 for Sunday)
* 'eee' - displays weekdays as 3 characters (e.g. Mon for Monday)
* 'eeee' - displays weekdays as full names (e.g. Tuesday)
* 'yy' - displays years as 2 digits (e.g. 16 as 2016)
* 'yyyy' - displays years as 4 digits
For example a string given as 'MMM\LF\yyyy' will display 'Jan' in one line and '2016' in a second one. A string given as 'MM.dd 2016' will display '03.05 2016'.
|-
|-
!align="right" |data-nofulldays
|switch to activate/deactivate rounding of the xaxis start and end values to full days ('true' or 'false')
|'false'
|-
!align="right" |data-ytext
|text to be shown besides the primary y axis.
|-
|-
!align="right" |data-ytext_sec
|text to be shown besides the secondary y axis.
|-
|-
!align="right" |data-yunit
|unit of the value to show beside of each Y ticks for primary y axis.
|-
|-
!align="right" |data-crosshair
|switch to activate/deactivate the crosshair cursor ('true' or 'false')
|'false'
|-
!align="right" |data-cursorgroup
|number to define coupling of the crosshair cursor. The cursors of all charts having the same number are coupled and move together.
|-
|-
!align="right" |data-scrollgroup
|number to define coupling of the scrolling (shift and zoom). All charts having the same number are scrolled (shifted and zoomed) together.
|-
|-
!align="right" |data-showlegend
|switch to activate/deactivate the initial display of the legend window ('true' or 'false')
|'false'
|-
!align="right" |data-legendpos
|array of two values (horizontal and vertical) to set the initial position of the legend window. Allowed values are "left", "right" or a number giving the position in percent for the first parameter (horizontal position) and 'top', 'bottom' or a number giving the position in percent for the second parameter (vertical position).
|'["top","right"]'
|-
!align="right" |data-yunit_sec
|unit of the value to show beside of each Y ticks for secondary y axis.
|-
|-
!align="right" |data-width
|fixed size for width (in % or px)
|-
|-
!align="right" |data-height
|fixed size for height (in % or px)
|-
|-
!align="right" |data-graphsshown
|boolean to define if graphs are activated (shown) initially or an array of booleans if more than one graph shall be displayed.
|-
|-
!align="right" |data-ddd
|setting for 3D display. Array with 3 angles for rotation of the 3D chart in x, y, z (z not yet supported) (e.g. '["40","60","0"]'). If the array is existing, there will be 2 additional buttons on top for changing rotation in x and y.
|-
|-
!align="right" |data-dddspace
|setting for the space between different graphs in y direction if 3D is activated (space given in pixels).
|15
|-
!align="right" |data-dddwidth
|setting for the width of the graphs if 3D is activated (width given in pixels).
|10
|-
!align="right" |data-title
|setting for inclusion of chart title on top of the chart. Includes the possibility for calculation of values like in SVG Plots (e.g. data-title="Min: $data{mindate4}, Max: $data{maxdate4}, Last: $data{currdate4}"). Supported are:
* min1: minimum value of graph 1 (first graph in the given list). Number can be any graph or omitted if calculation shall be done over all graphs.
* max1: maximum value of graph 1 (first graph in the given list)
* avg1: average value of graph 1 (first graph in the given list)
* cnt1: number of values of graph 1 (first graph in the given list)
* currval1: last (current) value of graph 1 (first graph in the given list)
* mindate1: minimum x value of graph 1 (first graph in the given list)
* maxdate1: maximum x value of graph 1 (first graph in the given list)
* currdate1: last (current) x value of graph 1 (first graph in the given list)
|''
|-
!align="right" |class
|fullsize, noticks, nobuttons, small, normal, big
|-
|-
|}

<code>data-logfile</code> can be omitted in this case the default value "-" will be used. This means that the current logfile is going to be used.

There are several buttons that control the dynamic behaviour of the chart. The <-, ->, + and - buttons shift and zoom the displayed data. The "legend" and "cursor" buttons are switching on and off the display of the legend window and the crosshair cursor respectively. If 3D display is activated (see above) 2 more buttons control the rotation in x and y.

When the legend window is displayed, a click on the legend text shows/hides the respective graph. The legend window can be dragged to other positions on desktop browsers (currently not yet working for iOS and Android).

The crosshair cursor currently only works dynamically on desktop browsers. On iOS and Android you have to tap on the screen to set the cursor to a new position.

Three classes define default values for the texts (small, normal, big). Additionally there is a number of css styles that control the visible appearance of the chart. The following classes are supported:

{| class="wikitable"
!CSS class name
!Description
|-
!.chart-background
|Color etc. for the chart background
|-
!.text.axes
|Font and color for the chart axes
|-
!.buttons
|Size and color for the buttons (shift etc.)
|-
!.gridlines
|Size and color for gridlines generally
|-
!.xaxis
|Font, size and color for xaxis
|-
!.yaxis
|Font, size and color for yaxis
|-
!.xticks
|Font, size and color for xticks
|-
!.yticks
|Font, size and color for yticks
|-
!.crosshair
|Font, size and color (foreground/background) for the crosshair cursor
|-
!.caption
|Font, size and color for text buttons for legend and cursor switching
|-
!.legend
|Font, size and background color for legend window
|-
|-
|}

[[#Beispiel_chart|Link zu einem Beispiel]]

<div id="circlemenu">'''CIRCLEMENU'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-item-diameter
|diameter of the circle
|52
|-
!align="right" |data-circle-radius
|radius of each item, in pixel
|70
|-
!align="right" |data-direction
|position of the items in relation to the center
|'full'
|-
!align="right" |data-close-after
|closing time of the circle-menu
|(item-count + 1s) or a minimum of 4s
|-
!align="right" |class
|keepopen
|
|-
|}

Optionen für data-direction: top | right | bottom | left | top-right | top-left | bottom-right | bottom-left | top-half | right-half | bottom-half | left-half | full | vertical | horizontal

[[#Beispiel_circlemenu|Link zu einem Beispiel]]

<div id="departure">'''DEPARTURE'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-type
|widget-type; must be departure
|
|-
!align="right" |data-device
|name of the device to get data from
|
|-
!align="right" |data-get
|name of the reading of device to get data from
|
|-
!align="right" |data-icon
|define icon for widget
|
|-
!align="right" |data-interval
|interval to reload automatically
|
|-
!align="right" |class
|choose style of widget; see example
|
|-
|}

[[#Beispiel_departure|Link zu einem Beispiel]]

<div id="dimmer">'''DIMMER'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-get-on
|value for ON status to get
|'on'
|-
!align="right" |data-get-off
|value for OFF status to get
|'off'
|-
!align="right" |data-set
|(<command> <device> <reading> <value>)
|
|-
!align="right" |data-set-on
|value for ON status to set
|value of data-get-on
|-
!align="right" |data-set-off
|value for OFF status to set
|value of data-get-off
|-
!align="right" |data-cmd
|name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-dim
|name of the reading responsible for dim (<command> <device> <reading> <value>)
|value of data-get-on
|-
!align="right" |data-icon
|name of the font-awesome icon
|fa-lightbulb-o
|-
|}

[[#Beispiel_dimmer|Link zu einem Beispiel]]

<div id="homestatus">'''HOMESTATUS'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-set
|command to send to Fhem (<code>set <device> <command> <value></code>)
|''
|-
!align="right" |data-get-on
|array of states using for get
|['1','2','3','4']
|-
!align="right" |data-set-on
|array of states using for set.
|value of data-get-on
|-
!align="right" |data-alias
|array of fix names to show only in the UI as an alias to the real states
|''
|-
!align="right" |data-icons
|array of icons related to the data-get-on array
|''
|-
!align="right" |data-version
|name of the status model e.g. 'residents','roommate','guest'
|(default NULL)
|-
|}

The default version has 4 states: '1','2','3','4' The default aliases are 'Home','Night','Away','Holiday'; data-version='residents' or 'roommate' or 'guest' has 5 states ('home','asleep','absent','gone','gotosleep') They have these aliases 'Home','Night','Away','Holiday','Retire'

[[#Beispiel_homestatus|Link zu einem Beispiel]]

<div id="image">'''IMAGE'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get an URL from Fhem
|'STATE'
|-
!align="right" |data-size
|width of the image in px or %, the height scales proportionally
|50%
|-
!align="right" |data-url
|URL of the image to show (use data-url or data-device + data-get, not both)
|
|-
!align="right" |data-refresh
|Interval in seconds for image refresh for usage together with data-url
|900
|-
|}

[[#Beispiel_image|Link zu einem Beispiel]]

=== Widget LABEL ===
<div id="label">'''LABEL'''</div>

Mit dem LABEL Widget kann der STATUS eines Device in Textform angezeigt werden. Dabei kann das die Farbe des Anzeigetext abhängig von dessen Wert festgelegt werden.

Neben den '''allgemeine Attribute''' besitzt das LABEL-Widget die nachfolgenden Attribute.

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|Name des Readings in FHEM
|
|-
!align="right" |data-fix
|Eine bestimmte Anzahl an Dezimalstellen
|'-1' -> non-numeric
|-
!align="right" |data-part
|split position of the space separated value to show or an RegEx
|
|-
!align="right" |data-color
| fix color attribute or DEVICE:READING for dynamic setting of label color
| ''
|-
!align="right" |data-colors
|a array of color values to affect the colour of the label according to the limit value
|
|-
!align="right" |data-limits-get
|name of the DEVICE:Reading to colorize the label
|data-device:data-get
|-
!align="right" |data-limits
|an array of numeric values to affect the colour of the Label
|
|-
!align="right" |data-limits-part
|part number of the space separated value to show or a RegEx
|'-1' -> all
|-
!align="right" |data-unit
|add a unit after a numeric value. use encoded strings e.g. "%B0C%0A"
|
|-
!align="right" |data-substitution
|regex-substitution to apply on the value. Standard regex notation (s/regex/subst/modifier) is expected
|
|-
!align="right" |data-hide
|string to compare with current value. hide element when it's value equals data-hide
|
|-
!align="right" |data-hideparents
|jquery selector to hide element's parents too
|
|-
!align="right" |class
|small, large, big, bigger, thin, red, green, blue, darker, timestamp, w1x, w2x, w3x, fixedlabel, icon, bg-limit
|
|}

Mit der Class 'fixedlabel' kann man Label einbauen, die einen festen Text (direkt im HTML) haben, aber trotzdem die Farbe per Reading Value beeinflusst werden könnte.<br>
Mit der Class 'icon' kann man Label einbauen, die wie Icons aussehen. Als Hintergrund gibt es 'icon round' (rund), 'icon square' (Rechteck mit abgerundeten Ecken) und 'icon squareborder' (Rechteck mit abgerundeten Ecken und einem zusätzlichen Rand).<br>
Mit der Class 'bg-limit' wird der Hintergrund des Icon auf grün oder rot gesetzt, passend zum on/off Status des data-limits.
Use data-color OR data-colors + data-limits, not both.

With class="bg-limit" it changes the background color not the forecolor according data-limits

class="icon square" or class="icon round" forces the label to a fix width and height in icon style

Special layout can be achieved by overwriting of following classes in the fhem-tablet-ui-user.css:

.label-precomma .label-comma .label-aftercomma .label-unit

e.g.: .label-aftercomma{ font-size:40%; left: 4px; top: -25px; position: relative; }

Functions for data-substitution:

Array of replacements
RegEx-substitution to apply on the value. Standard regex notation (s/regex/subst/modifier) is expected
data-substitution="weekdayshort"
JS functions data-substitution="toDate().ddmm()" - convert to day:month
data-substitution="toDate().hhmm()" - convert to hour:minutes

data-substitution="toDate().hhmmss()" - convert to hour:minutes:secondes

data-substitution="toDate().eeee()" - convert to name of the week day

data-substitution="toDate().ago()" - convert to time span

[[#Beispiel_label|Link zu einem Beispiel]]

=== Widget LEVEL ===
<div id="level">'''LEVEL'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-min
|minimal value to set
|'0'
|-
!align="right" |data-max
|maximal value to set
|'100'
|-
!align="right" |data-on
|value where the slider moves to max
|'on'
|-
!align="right" |data-off
|value where the slider moves to min
|'off'
|-
!align="right" |data-part
|part number of the space separated value to show or an RegEx
|
|-
!align="right" |data-colors
|a array of color values to affect the colour of the label according to the limit value
|
|-
!align="right" |data-limits
|a array of numeric or RegEx values to affect the colour of the label
|
|-
!align="right" |class
|mini, horizontal
|
|-
|}

[[#Beispiel_level|Link zu einem Beispiel]] (fehlt noch)

<div id="pagetab">'''PAGETAB'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-url
|URL of the new page to show
|
|-
!align="right" |data-icon
|name of the font-awesome icon
|'fa-power-off'
|-
!align="right" |data-background-icon
|name of the font-awesome icon for background
|''
|-
!align="right" |data-on-background-color
|color of ON state
|'#aa6900'
|-
!align="right" |data-off-background-color
|color of OFF state
|'#505050'
|-
!align="right" |data-on-color
|color of ON state
|'#aa6900'
|-
!align="right" |data-off-color
|color of Off state
|'#505050'
|-
!align="right" |data-get-on
|array of status to assign a special icon-list from data-icons
|
|-
!align="right" |data-icons
|array of icons related to the a data-get-on array
|
|-
!align="right" |class
|warn, activate (as additionals for data-icons)
|
|-
|}

[[#Beispiel_pagetab|Link zu einem Beispiel]]

<div id="playstream">'''PLAYSTREAM'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-url
|URL des Radio-Streams
|-
!align="right" |data-get
|name of the reading to get the control state from FHEM
|'STATE'
|-
!align="right" |data-get-on
|value for PLAY status to get.
|'on'
|-
!align="right" |data-get-off
|value for STOP status to get.
|'off'
|-
!align="right" |data-volume
|name of the reading to get the volume value (0-100)
|volume
|-
|}

[[#Beispiel_playstream|Link zu einem Beispiel]]

<div id="popup">'''POPUP'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading where to get the alert value from
|'STATE'
|-
!align="right" |data-get-on
|value which trigger to open the dialog
|'on'
|-
!align="right" |data-off
|value which trigger to close the dialog
|'off'
|-
!align="right" |data-width
|fixe size for width (in % or px)
|
|-
!align="right" |data-height
|fixe size for height (in % or px)
|
|-
|}

[[#Beispiel_popup|Link zu einem Beispiel]]

<div id="progress">'''PROGRESS'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-max
|maximal value to set or name of the reading which helds the max value
|100
|-
!align="right" |class
|novalue, percent
|
|-
|}

[[#Beispiel_progress|Link zu einem Beispiel]] (fehlt noch)

<div id="push">'''PUSH'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default-Wert
|-
!align="right" |data-set
| name of the reading to set on FHEM (<command> <device> <reading> <value>)
|
|-
!align="right" |data-set-on
|value to send when the the button get pressed oder ein Array zwischen dessen Werten umgeschaltet werden kann
|
|-
!align="right" |data-icon
|name of the font-awesome icon
|
|-
!align="right" |data-background-icon
|name of the font-awesome icon for background
|'fa-circle'
|-
!align="right" |data-cmd
|name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-doubleclick
|timeout to wait for a second click or touch. '0' disables the doubleclick feature.
|0
|-
!align="right" |data-countdown
|secondes for the countdown progress control
|autodetect from 'on-for-timer' command
|-
!align="right" |data-background-icon
|name of the font-awesome icon for background
|
|-
!align="right" |data-off-background-color
|fix color attribute for OFF state or DEVICE:READING for dynamic setting
|#505050
|-
!align="right" |data-off-color
|fix color attribute for Off state or DEVICE:READING for dynamic setting
|#505050
|-
|}

'data-set-on' can also be an array of values to toggle between this values

[[#Beispiel_push|Link zu einem Beispiel]]

<div id="rotor">'''ROTOR'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" | data-delay
|time in millisecondes to wait until next list item get shown
|3500
|-
!align="right" |class
|fade, rotate
|''
|-
|}
Ohne Angabe von class erfolgt keine Animation.

[[#Beispiel_rotor|Link zu einem Beispiel]]

<div id="select">'''SELECT'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading that get the selected item of the list
|
|-
!align="right" |data-set
|name of the reading to set on Fhem (<command> <device> <reading> <value>)
|''
|-
!align="right" |data-list
|name of the reading to get a :-separated list from Fhem
|''
|-
!align="right" |data-items
|an array of fix items to show in the selection box (alternative if data-list is empty)
|
|-
!align="right" |data-alias
|an array of fix names to show only in the selection box as an alias to the real items
|
|-
!align="right" |data-cmd
|name of the command to send to Fhem (<command> <device> <reading> <value>) (e.g. setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-quote
|characters to enclose the send value
|
|-
!align="right" |class
|wider, w1x, w2x, w3x, large, big
|
|-
|}

[[#Beispiel_select|Link zu einem Beispiel]]

<div id="simplechart">'''SIMPLECHART'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-logdevice
|name of the logdevice (e.g. FileLog_WohnzimmerHeizung)
|
|-
!align="right" |data-logfile
|name of the logfile (e.g. WohnzimmerHeizung-2015.log)
|'-' means current logfile
|-
!align="right" |data-columnspec
|definition for how to find the values (e.g. "4:meas.*:1:int")
|''
|-
!align="right" |data-minvalue
|min Y value to Show or an array of values for dynamic minY
|10
|-
!align="right" |data-maxvalue
|max Y value to Show or an array of values for dynamic maxY
|30
|-
!align="right" |data-yticks
|value distance between Y tick lines
|5
|-
!align="right" |data-xticks
|time range between each X tick line (in Minuten)
|360 minutes
|-
!align="right" |data-daysago
|number of days back from now
|0
|-
!align="right" |data-caption
|name of the chart to show as text
|
|-
!align="right" |data-yunit
|unit of the value to show beside of each Y ticks
|
|-
!align="right" |data-width
|fixe size for width (in % or px)
|
|-
!align="right" |data-height
|fixe size for height (in % or px)
|
|-
!align="right" |class
|fullsize, noticks
|
|-
|}

[[#Beispiel_simplechart|Link zu einem Beispiel]] (fehlt noch)

<code>data-logfile</code> kann man auch weglassen, dann greift der Defaultwert "-". Damit wird das neuste Logfile gelesen.

<div id="slider">'''SLIDER'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-set
|command to send to Fhem (<code>set <device> <command> <value></code>)
|''
|-
!align="right" |data-cmd
|name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-min
|minimal value to set
|0
|-
!align="right" |data-max
|maximal value to set
|100
|-
!align="right" |data-step
|step value
|1
|-
!align="right" |data-on
|value where the slider moves to max
|'on'
|-
!align="right" |data-off
|value where the slider moves to min
|'off'
|-
!align="right" |data-get-value
|RegEx to retrieve the value or part number of the space separated input to get the value
|'-1': all of the input
|-
!align="right" |data-set-value
|Format of the value to send to FHEM
|'$v': the value only
|-
!align="right" |data-width
|width for horizontal sliders
|'120px', for mini '60px'
|-
!align="right" |data-height
|height for vertical sliders
|'120px', for mini '60px'
|-
!align="right" |data-color
|color for quantity range
|'#aa6900'
|-
!align="right" |data-background-color
|color for range bar
|#404040
|-
!align="right" |class
|Aussehen/Ausrichtung
|
|-
|}

Für class steht mini, horizontal und negated (0 liegt oben) zur Verfügung.

[[#Beispiel_slider|Link zu einem Beispiel]]

<div id="switch">'''SWITCH'''</div>

{| class="wikitable"
!HTML-Attribut
!Beschreibung
!Default-Wert
|-
!align="right" |data-get
|Name des Reading, was gelesen werden soll
|'STATE'
|-
!align="right" |data-set
|Name des Reading, was gelesen werden soll
|'STATE'
|-
!align="right" |data-cmd
|Kommando Name (<command> <device> <value>) <br />(z.B setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-doubleclick
|timeout to wait for x millisecondes click or touch. '0' disables the doubleclick feature.
|'0'
|-
|}
Einstellung bei zwei Werten

{| class="wikitable"
!HTML-Attribut
!Beschreibung
!Default-Wert
|-
!align="right" |data-get-on
|Wert, bei dem zum Status ON geschaltet werden soll.
|'on'
|-
!align="right" |data-get-off
|Wert, bei dem zum Status OFF geschaltet werden soll.
|'off'
|-
!align="right" |data-set-on
|Wert, der zu Fhem gesendet werden soll, wenn das Widget auf ON geschaltet wurde
|Wert von data-get-on
|-
!align="right" |data-set-off
|Wert, der zu Fhem gesendet werden soll, wenn das Widget auf OFF geschaltet wurde
|Wert von data-get-off
|-
!align="right" |data-icon
|Name des Font-Awesome Icon.
|'fa-lightbulb-o'
|-
!align="right" |data-background-icon
|Name des Font-Awesome Hintergrund Icon.
|'fa-circle'
|-
!align="right" |data-on-background-color
|Hintergrundfarbe beim Status on oder DEVICE:Reading bei dynamischen Einstellungen
|'#aa6900'
|-
!align="right" |data-off-background-color
|Hintergrundfarbe beim Status off oder DEVICE:Reading bei dynamischen Einstellungen
|'#505050'
|-
!align="right" |data-on-color
|Widget Farbe beim Status ON
|'#aa6900'
|-
!align="right" |data-off-color
|Widget Farbe beim Status OFF
|'#505050'
|-
|}

Einstellung bei mehreren Werten
{| class="wikitable"
!HTML-Attribut
!Beschreibung
!Default-Wert
|-
!align="right" |data-states
|Array mit Status Angaben
|
|-
!align="right" |data-set-states
|Array mit Status Angaben, die gesetzt werden sollen
|
|-
!align="right" |data-icons
|Array Icons zum zuvor definierten Status
|
|-
!align="right" |data-background-icons
|Array mit Hintergrund Icons zum zuvor definierten Status
|
|-
!align="right" |data-colors
|Array mit Farben zum zuvor definierten Status
|
|-
!align="right" |data-background-colors
|Array mit Hintergrund Farben zum zuvor definierten Status
|
|-
!align="right" |class : readonly
|Es wird nur der Status angezeigt und kann nicht geändert werden
|
|-
|}

<code>data-get-on</code> and <code>data-get-off</code> accept also RegEx values. e.g. data-get-on="[0-9]{1,3}|on" means set switch on if STATE is a numeric value or 'on'. data-get-off="!on" means accept all but the data-get-on value (negation)

[[#Beispiel_switch|Link zu einem Beispiel]]

=== Widget SYMBOL ===
<div id="symbol">'''SYMBOL'''</div>

Mit dem SYMBOL Widget kann der STATUS eines Device dargestellt werden. Dabei kann das angezeigte Symbol und dessen Farbe bestimmt werden. Wie bei anderen Widgets kann das Symbol und die Farbe vom State abhängig konfiguriert werden. Das SYMBOL-Widget dient nur zur Anzeige eines STATUS, es besitzt kein Möglichkeit der Interaktion.

Neben den '''allgemeine Attribute''' besitzt das SYMBOL-Widget die nachfolgenden Attribute.

dual state notation
{| class="wikitable"
! HTML Attribut !! Beschreibung !! Default Wert
|-
| data-get || Name des Reading, was gelesen werden soll || 'STATE'
|}

Einstellung bei zwei Werten
{| class="wikitable"
!HTML-Attribut !! Beschreibung !! Default-Wert
|-
|'''data-get-on''' ||Wert für on ||'open'
|-
|'''data-get-off''' ||Wert für off ||'closed'
|-
|'''data-get-warn''' ||?????? ||'-1'
|-
|'''data-icon''' ||Name des Symbols ||'ftui-window'
|-
|'''data-background-icon''' ||Hintergrundsymbol ||'''leer'''
|-
|'''data-on-background-color''' ||Farbe für ON-Zustand. ||'#aa6900'
|-
|'''data-off-background-color''' ||Farbe für OFF-Zustand. ||'#505050'
|-
|'''data-on-color''' ||Farbe für ON-Zustand. ||'#aa6900'
|-
|'''data-off-color''' ||Farbe für OFF-Zustand. ||'#505050'
|-
|}

Einstellung bei mehreren Werten

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-states
|Array für states.
|
|-
!align="right" |data-icons
|Array mit Icons zu data-states Array
|
|-
!align="right" |data-background-icons
|Array mit Icons zu data-states Array
|
|-
!align="right" |data-colors
|Array mit Farben zu data-states aArray
|''
|-
!align="right" |data-background-colors
|Array mit Hintergrundfarben zu data-states array
|''
|-
|}

data-get-on,data-get-off and data-states accept also RegEx values. The value for one icon can also contain an additional animatation CSS name, e.g. "fa-exclamation-triangle fa-blink" for a blinking Symbol

[[#Beispiel_symbol|Link zu einem Beispiel]]

=== Widget THERMOSTAT===
<div id="thermostat">'''THERMOSTAT'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'desired-temp'
|-
!align="right" |data-temp
|reading for measured temperature of thermostates
|'measured-temp'
|-
!align="right" |data-set
|command to send to Fhem (set <device> <command> <value>)
|'desired-temp'
|-
!align="right" |data-valve
|reading for valve position of thermostates
|
|-
!align="right" |data-min
|minimal value to set
| 10
|-
!align="right" |data-max
|maximal value to set
| 30
|-
!align="right" |data-minColor
|Farbe des Keises für Min
| #4477FF
|-
!align="right" |data-maxColor
|Farbe des Kreises für Max, zwischen Min und Max wird linear interpoliert
| #FF0000
|-
!align="right" |data-step
|step size for value adjustment e.g. 0.5
|1
|-
!align="right" |data-bgColor
|Die Farbe der Kreises zwischen den ticks
|'transparent'
|-
!align="right" |data-fgColor
|Die Farbe der zahl im Kreismittelpunkt
|#bbbbbb
|-
!align="right" |data-tkColor
|Die Farbe der ticks
|#696969
|-
|-
!align="right" |data-angleOffset
|Start der ticks im Kreis (in Winkelgraden, 0 = oben)
| -120
|-
!align="right" |data-angleArc
|Bereich der ticks im Kreis (in Winkelgraden)
|240
|-
!align="right" |class
|big, readonly
|
|-
|}

[[#Beispiel_thermostat|Link zu einem Beispiel]]

<div id="volume">'''VOLUME'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get from Fhem
|'STATE'
|-
!align="right" |data-set
|command to send to Fhem (set <device> <command> <value>)
|''
|-
!align="rigth" |data-cmd
|name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)
|'set'
|-
!align="right" |data-min
|minimal value to set
|0
|-
!align="right" |data-max
|maximal value to set
|70
|-
!align="right" |data-get-value
|RegEx to retrieve the value or part number of the space separated input to get the value
|'-1': all of the input
|-
!align="right" |data-set-value
|Format of the value to send to FHEM
|'$v': the value only
|-
!align="right" |data-tickstep
|distance between ticks
|4|20
|-
!align="right" |data-unit
|add a unit after the desired value.
|
|-
!align="right" |class
|mini, small, big, bigger, hue-tick, hue-front, hue-back, dim-tick ,dim-front, dim-back, readonly
|
|-
|}

[[#Beispiel_volume|Link zu einem Beispiel]] (fehlt noch)

<div id="weather">'''WEATHER'''</div>

{| class="wikitable"
!HTML Attribut
!Beschreibung
!Default Wert
|-
!align="right" |data-get
|name of the reading to get the weather literal from Fhem
|'STATE'
|-
!align="right" |data-imageset
|collection of images to display current weather situation. Possible values: 'meteocons', 'kleinklima'
|'meteocons'
|-
!align="right" |data-image-path
|path to the images of the selected imageset
|/images/weather/
|-
|}

[[#Beispiel_weather|Link zu einem Beispiel]]

== Widgets -- Beispiele ==

<div id="Beispiel_chart">'''Chart'''</div>

Display a chart with similar capabilities as the FHEM plots

<pre>
<div data-type="chart"
data-logdevice='["Log.Garden","Log.Garden","Log.Garden","Log.Predicted"]'
data-columnspec='["4:Garden.T:15:","10:Garden.T:0:delta-h","10:Garden.T:0:delta-d","4:predicted.*:15:"]'
data-style='["ftui l0fill","ftui l1fill","ftui l2","ftui l3dot"]'
data-ptype='["lines","histeps","histeps","cubic"]'
data-uaxis='["primary","secondary","secondary","primary"]'
data-legend='["Temperature","Rain/hour","Rain/day","Predicted Temp."]'
data-yunit="°C"
data-ytext="Temperature"
data-minvalue="auto"
data-maxvalue="auto"
data-yunit_sec="mm"
data-ytext_sec="Rain (mm)"
data-height="250"
data-yticks="auto"
data-minvalue_sec="auto"
data-maxvalue_sec="auto"
data-nofulldays="true"
data-daysago_start="2013-08-13T00:00:00"
data-daysago_end="2013-08-14T00:00:00"
data-cursorgroup="1"
data-scrollgroup="1"
data-xticks="auto">
</div>
</pre>

[[Datei:chart_tabletUI.png]]

<div id="Beispiel_circlemenu">'''Circlemenu'''</div>

Cover a lot of other button behind one single button

<pre>
<div class="left">
<div data-type="circlemenu" class="cell circlemenu">
<ul class="menu">
<li><div data-type="push" data-icon="fa-wrench"></div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level -6"
data-icon="">-6</div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level -2"
data-icon="">-2</div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level 0"
data-icon="">0</div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level +3"
data-icon="">2</div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level +9"
data-icon="">9</div></li>
<li><div data-type="push" data-device="AvReceiver"
data-set="remoteControl subwoofer-temporary-level +C"
data-icon="">12</div></li>
</ul>
</div>
<div data-type="label" class="cell">Woofer</div>
</div>
</pre>

[[Datei:circlemenu_tabletUI.png]]

<div id="Beispiel_departure">'''Departure'''</div>

Departure Widget Beispiel

Minimalvariante
<pre>
<div data-type="departure"
data-device="vvs"
data-get="SSB-Zentrum"
data-icon="fa-train"
data-interval="0">
</div>
</pre>

Optionen für class
<pre>
class="" : default Style (grau)
class="DVB" anderer Style (gelb)
class="VVO" : anderer Style (blau)
class="alternate" : alternierender Hintergrund
class="deptime" : Abfahrtszeit statt Minuten
</pre>

weiteres Beispiel
<pre>
<div data-type="departure"
data-device="vvs"
data-get="SSB-Zentrum"
data-icon="fa-train"
data-interval="0"
class="DVB deptime alternate">
</div>
</pre>

<div id="Beispiel_dimmer">'''Dimmer'''</div>

Dimmer Widget Beispiel für Philips Hue

Minimalvariante
<pre>
<div data-type="dimmer" data-device="HUEDevice1"
data-get-on="!off" data-get-off="off"
data-set="pct"</div>
</pre>

Mit Anzeige der Dimstufe
<pre>
<div data-type="dimmer" data-device="HUEDevice1"
data-get="onoff"
data-get-on="1" data-get-off="0"
data-set=""
data-set-on="on" data-set-off="off"
data-dim="pct">
</div>
</pre>

Dimmer Widget für MilightDevice

<pre>
<div data-type="dimmer"
data-device="SonstWas"
data-get="brightness"
data-get-off="0"
data-get-on="[1-9][0-9]*"
data-set-on="on"
data-set-off="off"
data-dim="dim"
data-min="0"
data-max="100"
></div>
</pre>

<div id="Beispiel_homestatus">'''Homestatus'''</div>

Beispiel rechts im Bild:
<pre>
<div data-type="homestatus" data-device='dummy1'
data-get-on='["1","2","3","4"]'
data-alias='["Home","Night","Away","Holiday"]'
data-icons='["fa-home","fa-bed","fa-car","fa-suitcase"]'>
</div>
</pre>

Beispiel links im Bild:
<pre>
<div data-type="homestatus" data-device='dummy1'
data-get-on='["home","asleep","absent","gone","gotosleep"]'
data-alias='["Home","Night","Away","Holiday","Retire"]'
data-icons='["fa-fire","fa-film","fa-plus","fa-car","fa-tint"]'
data-version='residents'>
</div>
</pre>

[[Datei:homestatus_tabletUI.png]]

<div id="Beispiel_image">'''Image'''</div>

Erzeugt ein Widget mit einem Bild aus dem www, das alle 5 Sekunden aktualisiert wird (hier eine Wetterkarte vom DWD).

<pre>
<div data-type="image"
data-size="80%"
data-url="http://www.dwd.de/wundk/wetter/de/Deutschland.jpg"
</div>
</pre>

[[Datei:image_tabletUI.jpg]]

Example for how to add an image to the dashboard which its URL is delivered by a Fhem module like PROPLANTA:

<pre>
<div data-type="image" data-device="Wetter1"
data-get="fc0_weatherDayIcon"
data-size="40px"
class="cell">
</div>
</pre>

<div id="Beispiel_label">'''Label'''</div>

Example for HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor innen

<pre>
STATE T: 20.0 H: 61
</pre>
<pre>
<div data-type="label" data-device="THSensorWZ"
data-part="2" data-unit="%B0C%0A" class="cell big"></div>
<div data-type="label" class="cell">Temperatur</div>
<div data-type="label" data-device="THSensorWZ" data-part="4"
data-unit="%" class="cell big"></div>
<div data-type="label" class="cell">Luftfeuchte</div>
</pre>

But the same result can reached by getting single readings:
<pre>
humidity 58
temperature 20.1
</pre>

<pre>
<div data-type="label" data-device="THSensorWZ"
data-get="temperature" data-unit="%B0C%0A" class="cell big"></div>
<div data-type="label" class="cell">Temperatur</div>
<div data-type="label" data-device="THSensorWZ"
data-get="humidity" data-unit="%" class="cell big"></div>
<div data-type="label" class="cell">Luftfeuchte</div>
</pre>

Example for how to influence the color of the label according to value limits
<pre>
<div data-type="label"
data-device="OutTemp"
data-limits='[-73,10,23]'
data-colors='["#6699FF","#AA6900","#FF0000"]'
data-unit="%B0C%0A"
class="cell big">
</div>
</pre>

Example for how to create a widget for shutter via push: show state and set up/down
<pre>
<div data-type="switch"
data-device="wzRollo"
data-get-on="up"
data-get-off="down"
data-icon="fa-bars"
class="cell" >
</div>
<div data-type="label"
class="cell">Rollo</div>
</pre>

Example for how to create a label for a time value in short format with usage of RegEx.

<pre>
<div data-type="label"
data-device="dummy1"
data-part="(\d\d\.\d\d\.).*"
class="cell">
</div>
</pre>

Example for how to show two labels in one line.

<pre>
<div class="">
<div type="label" device="OnSunrise" class="inline"></div>bis
<div type="label" device="OnSunset" class="inline"></div>
</div>
</pre>

Beispiel für die Anzeige des UV-Indexes und der Abhängigkeit der anzuzeigenden Farbe.

<pre>
<div data-type="label" class="wider cell bigger" data-device="ProVorhersage"
data-get="fc0_uv"
data-limits="[-2, 2, 5, 7, 10]"
data-colors='["#66FF33","#FFFF00","#FF6600","#FF0000","#993399"]'></div>
<div data-type="label" class="cell" data-device="ProVorhersage" data-get="fc0_date"></div>
<div data-type="label" class="wider cell bigger" data-device="ProVorhersage"
data-get="fc1_uv"
data-limits="[-2, 2, 5, 7, 10]"
data-colors='["#66FF33","#FFFF00","#FF6600","#FF0000","#993399"]'></div>
<div data-type="label" class="cell" data-device="ProVorhersage" data-get="fc1_date"></div>
</pre>

[[Datei:label_tabletUI.jpg]]

Beispiel für die Anzeige des Labels als Icon.
<pre>
<div class="cell">
<div data-type="label" data-device="AvReceiver" data-get="input" class="icon round bg-red cell"></div>
<div data-type="label" data-device="AvReceiver" data-get="input" class="icon square bg-blue cell"></div>
<div data-type="label" data-device="AvReceiver" data-get="input" class="icon squareborder cell"></div>
<div data-type="label" data-device="PowerAV_Sw" data-colors='["red","green"]' data-limits='["off","on"]' class="icon round bg-limit cell"></div>
</div>
</pre>

[[Datei:Label_tabletUI_icon.png]]

<div id="Beispiel_pagetab">'''Pagetab'''</div>

Example for a tab menu to switch smoothly between multiple pages. Multiple pagetabs in a template file: menu.html

<pre>
<html>
<body>
<header>MENU</header>
<div class="cell">
<div data-type="pagetab" data-url="index.html" data-icon="fa-home" class="cell"></div>
<div data-type="pagetab" data-url="index_2.html" data-icon="fa-sliders" class="cell"></div>
<div data-type="pagetab" data-url="index_3.html" data-icon="fa-music" class="cell"></div>
<div data-type="pagetab" data-url="index_4.html" data-icon="fa-hotel" class="cell"></div>
<div data-type="pagetab" data-url="index_5.html" data-icon="fa-music" class="cell"></div>
<div data-type="pagetab" data-url="index_6.html" data-icon="fa-database" class="cell"></div>
<div data-type="pagetab" data-url="index_7.html" data-icon="fa-fax" class="cell"></div>
</div>
</body>
</html>
</pre>

<div id="Beispiel_playstream">'''Playstream'''</div>

Erzeugt einen Knopf zum direkten Abspielen eines Webradio-Streams.

<pre>
<div data-type="playstream" data-url="http://radioeins.de/stream"></div>
<div data-type="label" class="darker">Radio eins</div>
</pre>

<div id="Beispiel_push">'''Push'''</div>

Example for how to create a push button widget to trigger all devices on:

<pre>
<div data-type="push"
data-device="LightAll"
data-cmd="trigger"
data-set="on"
class="cell">
</div>
</pre>

Beispiel für zwei horizontale Buttons:

<pre>
<div class="cell">
<div class="doublebox-h">
<div data-type="push" data-device="Rollo"
data-icon="fa-angle-up" data-background-icon="fa-square-o"
data-set="up">
</div>
<div data-type="push" data-device="Rollo"
data-icon="fa-angle-down" data-background-icon="fa-square-o"
data-set="down">
</div>
</div>
</div>
</pre>

[[Datei:push1.png]]

Beispiel für zwei quadratische vertikale Buttons:

<pre>
<div class="cell">
<div class="doublebox-v">
<div data-type="push" data-device="Rollo"
data-icon="fa-chevron-up" data-background-icon="fa-square-o"
data-set="up">
</div>
<div data-type="push" data-device="Rollo"
data-icon="fa-chevron-down" data-background-icon="fa-square-o"
data-set="down">
</div>
</div>
</div>
</pre>

[[Datei:push2.png]]

<div id="Beispiel_rotor">'''Rotor'''</div>

Example for a rotor widget, which switches between to days of weather forecast

<pre>
<div data-type="rotor" class="fade">
<ul>
<li>
<div data-type="label" class="darker">Heute</div>
<div data-type="weather" data-device="AgroWeather" data-get="fc0_weatherDay" class="big"></div>
<div data-type="label" data-device="AgroWeather" data-get="fc0_weatherDay" class=""></div>
<div data-type="label" data-device="AgroWeather" data-get="fc0_tempMax" data-unit="%B0C%0A" class="large"></div>
</li>
<li>
<div data-type="label" class="darker">Morgen</div>
<div data-type="weather" data-device="AgroWeather" data-get="fc1_weatherDay" class="big"></div>
<div data-type="label" data-device="AgroWeather" data-get="fc1_weatherDay" class=""></div>
<div data-type="label" data-device="AgroWeather" data-get="fc1_tempMax" data-unit="%B0C%0A" class="large"></div>
</li>
</ul>
</div>
</pre>

<div id="Beispiel_select">'''Select'''</div>

Erzeugt zwei Comboboxen zur Auswahl des Eingang eines 2-Zonen-AV-Receivers. Die Liste für Zone2 ist fest, die Liste für Zone1 wird von Fhem übergeben.

<pre>
<div class="cell wider">
<div data-type="label" class="inline wider">Zone2</div>
<div data-type="select" data-device="AvReceiverZ2" data-items='["Airplay","Webradio","BD/DVD","PHONO"]' data-get="input" data-set="input" class="cell w2x" ></div>
<div></div>
<div data-type="label" class="inline">Zone1</div>
<div data-type="select" data-device="AvReceiver" data-list="inputs" data-get="input" data-set="input" class="cell w2x" ></div>
</div>
</pre>

[[Datei:select_tabeltUI.png]]

<div id="Beispiel_slider">'''Slider'''</div>

Slider mit einstellbaren Werten von 10 bis 90:

<pre>
<div data-type="slider"
data-device='Dummy1'
data-min="10"
data-max="90"
class="cell" >
</div>
<div data-type="label" class="cell">Light1</div>
</pre>

[[Datei:slider_tabletUI.png]]

Horizontal angeordneter Slider:

<pre>
<div data-type="slider"
data-device='Dummy1'
data-min="0"
data-max="100"
class="horizontal"
</div>
</pre>

[[Datei:slider_tabletUI2.jpg]]

<div id="Beispiel_switch">'''Switch'''</div>

Schalter. Usage of RegEx pattern for state request:

<pre>
<div data-type="switch" class="cell"
data-device="MILIGHT_Zone1_Wohnzimmer"
data-get-on="on.*"
data-get-off="off"></div>
</pre>

[[Datei:switch.png]]

Beispiel für eine Gruppe von Schaltern, um zwischen vier verschiedenen Werten eines device umzuschalten:

<pre>
<div class="cell left">
<div data-type="switch" data-device="dummy1"
data-get-off="((?!Wert1).)*"
data-get-on="Wert1" class="cell" ></div>
<div data-type="label" class="cell">Wert1</div>
<div data-type="switch" data-device="dummy1"
data-get-off="((?!Wert2).)*"
data-get-on="Wert2" class="cell" ></div>
<div data-type="label" class="cell">Wert2</div>
<div data-type="switch" data-device="dummy1"
data-get-off="((?!Wert3).)*"
data-get-on="Wert3" class="cell" ></div>
<div data-type="label" class="cell">Wert3</div>
<div data-type="switch" data-device="dummy1"
data-get-off="((?!Wert4).)*"
data-get-on="Wert4" class="cell" ></div>
<div data-type="label" class="cell">Wert4</div>
</div>
</pre>

[[Datei:switch4.png]]

<div id="Beispiel_symbol">'''Symbol'''</div>

Example for a tristate icon

<pre>
<div data-type="symbol" data-device="dummy1"
data-get-on='["wert1","wert2","wert3"]'
data-icons='["fa-arrow-up","fa-user","fa-arrow-down"]'
data-on-colors='["SeaGreen","SlateBlue","IndianRed"]'
class="cell big">
</div>
</pre>

Example for a tristate icon with blink and spin animation

<pre>
<div data-type="symbol" data-device="dummy1"
data-icons='["fa-exclamation-triangle fa-blink","fa-exclamation-circle","fa-cog fa-spin"]'
data-on-colors='["Crimson","GoldenRod","SeaGreen"]'
data-get-on='["Wert1","Wert2","Wert3"]' >
</div>
</pre>

Example for a battery level control with RegEx

<pre>
<div data-type="symbol" data-device="BadHeizung" data-get="batteryLevel"
data-icons='["oa-measure_battery_100","oa-measure_battery_75","oa-measure_battery_50","oa-measure_battery_25","oa-measure_battery_0"]'
data-get-on='["3\\.[0-9]","2\\.[789]","2\\.[456]","2\\.[123]","((2\\.0)|([01]\\.[0-9]))"]'
data-on-colors='["#505050","#505050","#505050","#ad3333","#ad3333"]'>
</div>
</pre>

Example for a battery level control with greater-equal compare and 90° rotated symbols

<pre>
<div data-type="symbol" data-device="BadHeizung" data-get="batteryLevel"
data-icons='["oa-measure_battery_0 fa-rotate-90","oa-measure_battery_25 fa-rotate-90","oa-measure_battery_50 fa-rotate-90","oa-measure_battery_75 fa-rotate-90","oa-measure_battery_0 fa-rotate-90"]'
data-get-on='["0","2","2.4","2.7","3.0"]'
data-on-colors='["#ad3333","#ad3333","#505050","#505050","#505050"]'>
</div>
</pre>

<div id="Beispiel_thermostat">'''Thermostat'''</div>

Configure as data-device='...' that item which delivers temp and desired-temp as reading.

Default parameters are:
<pre>
data-get="desired-temp" data-temp="measured-temp" data-set="desired-temp"
</pre>

Therefor for HomaMatic HM-CC-RT-DN this is sufficient.

<pre>
<div data-type="thermostat" data-device='KH_Clima' class="cell"></div>
</pre>

The long format looks like this:

<pre>
<div data-type="thermostat"
data-device="KH_Clima"
data-valve="ValvePosition"
data-get="desired-temp"
data-temp="measured-temp"
class="cell">
</div>
</pre>

Example for MAX!:
<pre>
<div data-type="thermostat" data-device="HZ_Tuer"
data-valve="valveposition"
data-get="desiredTemperature"
data-temp="temperature"
data-set="desiredTemperature"
class="cell">
</div>
</pre>

The wigets will show the valve value only in case of a valid data-valve attribute. The default for data-valve ist null. That means, a empty data-valve attribute hides the valve label for the widget.

[[Datei:thermostat.png]]

<div id="Beispiel_weather">'''Weather'''</div>

Das Widget fügt ein dem Wetter entsprechendes Bild ein. Die Daten können durch Fhem-Module wie [[PROPLANTA]], [[OPENWEATHER]] und [[Weather]] bereitgestellt werden.
Add 'big' or 'bigger' to CSS class to get a bigger weather icon.

Beispiel:
<pre>
<div data-type="weather"
data-device="Weather"
data-get="fc0_weatherDay"
class="cell big">
</div>
</pre>

[[Datei:weather.png]]

== Icon-Konfiguration ==

* Eingebaute Icons: Diese haben das ftui-Präfix. Zurzeit sind folgende verfügbar: ftui-window, ftui-door

* Mehr als 500 Icons von "http://fortawesome.github.io/Font-Awesome/icons" verfügbar. Einfach den Icon-Namen angeben (Präfix "fa-" nicht vergessen, Z.B. <code>data-icon="fa-volume-up"</code>

* Es stehen auch Openautomation Font-Files zur Verfügung. Wer sie nutzen möchte, muss folgende Stylesheets in die index.html hinzufügen.
<pre>
<link rel="stylesheet" href="/fhem/tablet/lib/openautomation.css" />
<link rel="stylesheet" href="/fhem/tablet/lib/fhemSVG.css" />
</pre>

Diese font icons haben das Präfix 'fs-' bzw. 'oa-'.

Beispiel bei einem Schalter:
<pre><div data-type="switch" data-device='dummy1' data-icon="oa-secur_locked"></div></pre>

Und so als großes Symbol:
<pre>
<div data-type="symbol" data-device='dummy1'
data-icon="oa-status_frost"
data-on-color="#bb3232"
data-get-on="on"
data-get-off="!on"
class="bigger">
</div>
</pre>

Die Icons kann man auch etwas dicker darstellen mit den Zusatz bold: <code>data-icon="oa-secur_locked bold"</code>

Die Namen der verfügbaren Icons findet man auch in den CSS Files (openautomation.css / fhemSVG.css)

== Spezial ==
Folgender Befehl setzt einen direkten Befehl an Fhem ab (<code>set dummy1 off</code>):
<pre>
<div onclick="ftui.setFhemStatus('set dummy1 off')">All off!</div>
</pre>

== FAQ ==
Häufig gestellte Fragen zum FHEM Tablet UI sind in der [[FHEM_Tablet_UI/FAQ|FHEM Tablet UI FAQ]] zusammengestellt.

== Links ==
* [http://forum.fhem.de/index.php/topic,34233.0.html Forums-Beitrag]
* [https://github.com/knowthelist/fhem-tablet-ui Projekt auf Github]
* [http://forum.fhem.de/index.php/topic,37378.0.html User-Demos]
* [https://github.com/ovibox/fhem-ftui-user-demos Download der User-Demo-Dateien]

[[Kategorie:FHEM Tablet UI]]

Calendar

2017-01-13T17:53:42Z

Thomas.kregelin: Modulname im Beispielcode ergänzt

{{Infobox Modul
|ModPurpose=Anlegen eines Kalenderobjekts
|ModType=h
|ModForumArea=Unterstützende Dienste/Kalendermodule
|ModTechName=57_Calendar.pm
|ModOwner=borisneubert ({{Link2FU|10|Dr. Boris Neubert}})
}}

[[Calendar]] ist ein Hilfsmodul, das Kalenderereignisse aus einer Datei oder einem über die URL angegeben Kalender holt. Der Kalender muss im iCal-Format vorliegen.

Zur Anzeige der Kalenderereignisse kann das Modul [[CALVIEW]] verwendet werden.

== Voraussetzungen ==
Wenn die Kalender-URL mit ''https://'' beginnt, muss das Perl Modul IO::Socket::SSL installiert sein (z.B. mit <code>cpan -i IO::Socket::SSL</code> oder mit <code>apt-get install libio-socket-ssl-perl</code>).

== Anwendung ==
=== Define ===
Siehe commandref;
:<code>define <name> Calendar ical url <URL> [<interval>]</code>
:<code>define <name> Calendar ical file <FILENAME> [<interval>]</code>

Sofern für den Zugriff auf den Kalender Benutzername und Passwort erforderlich sind, können diese in der URL beispielsweise so mit angegeben werden:
:<code>define myCalendar Calendar ical url <nowiki>https://user:password@my.domain.com/.../yourcalendar.ics</nowiki></code>

=== Attribute ===
Siehe commandref;

== Anwendungsbeispiel(e) ==
* Einbindung von owncloud-Kalendern
Für ownCloud-Kalender muss bei der Definition als <URL> der Link zum Export des jeweiligen Kalenders angegeben werden. Der Link kann in der Weboberfläche von ownCloud gefunden werden. Für ownCloud 9.0 folgt dieser URL z.B. dem folgenden Muster:
:<code>http://<ownCloud-Benutzer>:<ownCloud-Passwort>@example.com/owncloud/remote.php/dav/calendars/<ownCloud-Benutzer>/<Kalendername>?export</code>
Der Standard für <Kalendername> ist <code>defaultcalendar</code>
* [[Google-Kalender zur Steuerung von Dummies]]
* [[Wochenende, Feiertage und Schulferien]]

== Links ==
* Modul, das alle Termine aus einer bestehenden Instanz von [[Calendar]] in Readings übernimmt: [[CALVIEW]]

HM-TC-IT-WM-W-EU Funk-Wandthermostat AP

2015-11-29T18:46:13Z

Thomas.kregelin:

[[Datei:HM-TC-IT-WM-W-EU.jpg|thumb|right|HM-TC-IT-WM-W-EU Funk-Wandthermostat AP]]
'''HM-TC-IT-WM-W-EU Funk-Wandthermostat AP'''

HomeMatic-Wandthermostat Aufputz. Verfügbar seit Februar 2014. Nachfolger des [[HM-CC-TC_Funk-Wandthermostat|HM-CC-TC]].

== Vorbemerkungen ==
'''Einstellungen und Informationen die alle HomeMatic Thermostat betreffen sind unter <u>[http://www.fhemwiki.de/wiki/HomeMatic_Type_Thermostat#Temperaturlisten|HomeMatic Type Thermostat]</u> zu finden.'''

Er misst die Raumtemperatur und Luftfeuchtigkeit. Er verfügt über individuell einstellbare Wochenprogramme und Programmierung direkt am Gerät. Zusätzlich ist auch eine Boost-Funktion vorhanden (ermöglicht ein schnelles, kurzzeitiges Aufheizen des Heizkörpers). Er verfügt über ein eigenes Anzeigedisplay für Soll- und Isttemperatur sowie Luftfeuchtigkeit. Er kann mittels Klebestreifen irgendwo aufgeklebt werden, soll aber auch in Mehrfachrahmen von Berker, ELSO, Gira, Merten und JUNG passen.

== Technische Daten ==

'''Technische Daten:'''
* Versorgungsspannung: 2 Stck. 1,5 V LR03/Micro/AAA
* Stromaufnahme (max.): 40 mA
* Schutzart: IP20
* Schutzklasse: III
* Abmessungen (BxHxT ohne Rahmen): 55 x 55 x 20 mm
* Abmessungen (BxHxT mit Rahmen): 86 x 86 x 21,5 mm
* Gewicht (ohne Batterien): 74 g
* Temperaturwahl in Schritten von: 0,5 °C

Im Gegensatz zum HM-CC-TC kann der HM-TC-IT-WM-W-EU auch andere HomeMatic-Schaltaktoren (z.B. [[HM-LC-SW1-FM_Schaltaktor_1-fach_UP|HM-LC-SW1-FM]]) über den Channel 07 SwitchTr direkt anlernen, womit z.B. die Steuerung elektrischer Heizungen möglich wird. Der HM-CC-TC konnte direkt nur die HM-CC-VD steuern.

== Betrieb mit FHEM ==

Zuerst muss das Wandthermostat natürlich mit FHEM gepairt werden. Danach kann das Peering mit den Heizkörperthermostaten des betreffenden Raumes stattfinden:

=== Channels (Kanäle) ===

==== Channel (Kanal) 01 _Weather ====
Damit das Heizkörperthermostat HM-CC-RT-DN die Temperatur des Wandthermostats übernimmt, muss der Weather Kanal gepeert werden:

set <HM-TC-IT-WM-W-EU-Gerät>_Weather peerChan 0 <HM-CC-RT-DN-Gerät>_Weather single set

==== Channel (Kanal) 02 _Climate ====
Damit der Heizkörperthermostat vom Wandthermostat auch eingestellt werden kann (Soll-Temperatur, Mode etc.), muss der Climate Kanal gepeert werden:

set <HM-TC-IT-WM-W-EU-Gerät>_Climate peerChan 0 <HM-CC-RT-DN-Gerät>_Climate single set
Dies muss für jedes zu steuernde Heizkörperthermostat wiederholt werden.

==== Channel (Kanal) 03 _WindowRec ====
Mit diesem Kanal lassen sich Fensterkontakte (HM-SEC-SC oder HM-SEC-RHS) peeren, die ihren Fensterstatus (geöffnet/gekippt) an ein oder mehrere Thermostate senden. Die Thermostate stellen anschließend die entsprechende (konfigurierbare) Temperatur ein. Der Temperaturwert kann je Fenster-Sensor unterschiedlich definiert werden. Sind mehrere Fenster gleichzeitig geöffnet, so wird der Thermostat auf die Temperatur des Sensors mit dem geringsten Temperaturwert eingestellt.

Das Peering mit einem Tür-Fensterkontakt läuft wie folgt ab:

set <HM-Sec-SC> peerChan 0 <HM-TC-IT-WM-W-EU-Gerät>_WindowRec single set

Der Befehl zur Temperatureinstellung des Heizkörperthermostaten für den Zustand "Fenster offen" lautet, wobei <fensterSensor> die Fhem-Kanalbezeichnung für den Fensterkontakt ist und <tc_WindowRec> die Kanalbezeichnung für den entsprechenden Kanal des Heizkörperthermostates, sowie <Temp> die einzustellende Temperatur (ganzzahliger Wert):
set <tc_WindowRec> regSet winOpnTemp <Temp> <fensterSensor>

==== Channel (Kanal) 06 _remote ====
Dieser Kanal ann an eine Fernbedienung gekoppelt werden. Per Tastendruck kann man einen bestimmten Mode und/oder eine bestimmte Temperatur wählen. Dabei kann die Reaktion auf einen langen oder kurzen Tastendruck gesondert eingestellt werden.

Der Befehl zum peeren lautet, wobei <button> die Kanalbezeichnung der Fernbedienung und <tc-remote> die Kanalbezeichnung des Heizkörperthermostates ist:
<pre>set <button> peerChan 0 <rt-remote> single</pre>

==== Channel (Kanal) 07 _SwitchTr ====
Das Peering mit einem Schaltaktor läuft z.B. wie folgt ab:

set <HM-TC-IT-WM-W-EU_SwitchTr> peerChan 0 <HM-LC-SW1-FM> dual set
set <HM-LC-SW1-FM> regSet shCtOn ltLo <HM-TC-IT-WM-W-EU_SwitchTr>

=== Tastensperre ===

Um zu verhindern, dass der Modus oder die Temperatur per Tasten bzw. Drehrad am HM-TC-IT-WM-W-EU verändert wird, kann eine Tastensperre gesetzt werden. Dies erfolgt mittels des Befehls:

set <HM-TC-IT-WM-W-EU> regSet btnLock on

Rückgängig machen geht per:

set <HM-TC-IT-WM-W-EU> regSet btnLock off

Diese Tastensperre kann man aber am Thermostat durch eine Tastenkombination wieder zurücksetzen. Um sie nur per Fhem rücksetzen zu können, muss

set <HM-TC-IT-WM-W-EU> regSet globalBtnLock on

abgesetzt werden. Rückgängig wieder per:

set <HM-TC-IT-WM-W-EU> regSet globalBtnLock off

=== Temperaturlisten ===
Die Temperaturlisten des HM-TC-IT-WM-W-EU werden identisch mit denen anderer HomeMatic Thermostate verwaltet, siehe <u>[http://www.fhemwiki.de/wiki/HomeMatic_Type_Thermostat#Temperaturlisten|HomeMatic Type Thermostat]</u>. Beim HM-TC-IT-WM-W-EU ist der Kanal 4 (_Climate) für die Temperaturlisten zuständig.

== Fhem-Log ==
=== Event monitor ===

Hier habe ich einmal die Wunschtemperatur erhöht, damit auch was passiert:

2014-04-09 09:35:11 CUL_HM KH_Bad_Therm CMDs_pending
2014-04-09 09:35:11 CUL_HM KH_Bad_Therm_Climate set_desired-temp 18.0
2014-04-09 09:35:11 CUL_HM KH_Bad_Therm CMDs_done

Bei mir ist es so, das der SwitchTr Kanal nur mit dem gepeerten Device spricht, hier ein HM-LC-SW1-FM:

2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung trig_KH_Bad_Therm_SwitchTr: 200
2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung trigLast: KH_Bad_Therm_SwitchTr :200

Der hat auch prompt reagiert und die Heizung eingeschaltet:

2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung level: 100
2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung pct: 100
2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung deviceMsg: on (to KH_Bad_Therm)
2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung on
2014-04-09 09:35:17 CUL_HM KH_Bad_Heizung timedOn: off

und noch ein wenig Geplauder der vorhandenen Kanäle:

2014-04-09 09:36:39 CUL_HM KH_Bad_Therm_Climate measured-temp: 16.0
2014-04-09 09:36:39 CUL_HM KH_Bad_Therm_Climate desired-temp: 18.0
2014-04-09 09:36:39 CUL_HM KH_Bad_Therm_Climate humidity: 50
2014-04-09 09:36:39 CUL_HM KH_Bad_Therm_Climate T: 16.0 desired: 18.0
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm battery: ok
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm batteryLevel: 3
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm measured-temp: 16.0
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm desired-temp: 18.0
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm_Climate measured-temp: 16.0
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm_Climate desired-temp: 18.0
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm_Climate mode: auto
2014-04-09 09:36:49 CUL_HM KH_Bad_Therm_Climate T: 16.0 desired: 18.0
2014-04-09 09:36:59 CUL_HM KH_Bad_Therm_Weather temperature: 16.0
2014-04-09 09:36:59 CUL_HM KH_Bad_Therm_Weather humidity: 50
2014-04-09 09:36:59 CUL_HM KH_Bad_Therm_Weather T: 16.0 H: 50

== Firmware Update ==
Updates für den HM-TC-IT-WM-W-EU können von der eQ-3 Webseite heruntergeladen werden. Genauere Informationen gibt es unter [[HomeMatic_Firmware_Update]]

== Bekannte Probleme ==
Bei der Firmware 1.2 und dem Kanal Climate funktioniert die Einstellung der Hysterese über das Register hyst2point nicht. Der Eintrag wird ignoriert.

Siehe auch Bericht im [http://www.elv.de/topic/hystereseeinstellung-bei-hm-tc-it-wm-w-eu-firmware-1-2-wird-ignoriert.html Forum von ELV]

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-TC-IT-WM-W-EU_UM_V1.0_GE_eQ-3_20131211_web.pdf Manual]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Wandthermostat_132030_Produktdatenblatt_V1.0.pdf Produktdatenblatt]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]

HM-CC-VD Funk-Stellantrieb

2015-11-29T18:41:11Z

Thomas.kregelin:

[[Datei:HM-CC-VD.jpg|thumb|right|HM-CC-VD Funk-Stellantrieb]]
'''HM-CC-VD Funk-Stellantrieb'''

'''Achtung: Dieses Gerät ist abgekündigt (wird nicht mehr hergestellt). Nachfolgeprodukt ist der [[HM-CC-RT-DN]].'''

= Allgemeines =

Stellantrieb für den [[HM-CC-TC Funk-Wandthermostat|HM-CC-TC]]. Es können maximal 4 HM-CC-VD an ein HM-CC-TC angelernt werden.

Aktuelle Firmware: 2.0

Der HM-CC-VD '''misst nicht selbst''' die Temperatur. Diese wird von dem HM-CC-TC, mit dem der Stellantrieb gepairt wurde, gemessen.

= Probleme =

Bei Firmwareversionen vor 2.0 kann es vorkommen, dass sich der Stellantrieb bei einer bestimmten Stellung "festfährt" (z.B. 4%) und der Raum sich kontinuierlich erhitzt, obwohl eine niedrigere Temperatur am Wandthermostat eingestellt ist. Erst nach einem Reset des Stellantriebs oder manuellen Erhöhung der Temperatur am Wandthermostat/FHEM verrichtet der Stellantrieb wieder wie gewohnt seine Arbeit.

Quelle: [[http://www.elv.de/output/controller.aspx?cid=834&detail=2&detail2=582 1]]

Ein Firmwareupdate kann derzeit nur mittels Einschicken des Stellantriebs erfolgen.

Ist der Stellantrieb mit dem HM-CC-TC gepairt (zu sehen im Menü des HM-CC-TC als VST Nummer X), erscheint aber nicht in Fhem (hier mit HMLAN), dann hilft der Befehl ''set <HMLAN-Name> hmPairForSec 300'' und das Drücken des Anlernknopfes am HM-CC-VD für mind. 5 Sekunden.

= Betrieb mit FHEM =

HM-CC-VDs werden mit dem für ihren Betrieb/Raum zuständigen HM-CC-TC gepeert. Dadurch ist der TC für die Ansteuerung der Ventiltriebe da.

== Log-Daten ==
=== Device-Log ===

Zur Behebung des "1 bzw. 4 % Fehlers" wurde die Raumtemperatur über die Ansteuerung des HM-CC-TC temporär auf 28 °C erhöht. Nachdem das Thermostat (VD) laut Logs das Ventil auf hier 68 % geöffnet hat, wurde die Temperatur wieder auf die gewünschte (desired) Temperatur (am TC) gesetzt. Diese Befehle mussten allerdings einige Male wiederholt werden und es bedurfte einiger Minuten Wartezeit zwischen den Umstellungen.
<pre>
2013-03-18_22:34:57 OG.AZ.Thermostat set_0 %
2013-03-18_22:34:57 OG.AZ.Thermostat ValveDesired: 0 %
2013-03-18_22:34:58 OG.AZ.Thermostat ValvePosition: 1 %
2013-03-18_22:34:58 OG.AZ.Thermostat 1 %
2013-03-18_22:34:58 OG.AZ.Thermostat battery: ok
2013-03-18_22:34:58 OG.AZ.Thermostat motorErr: ok
2013-03-18_22:34:58 OG.AZ.Thermostat motor: stop
2013-03-18_22:34:58 OG.AZ.Thermostat operState: errorTargetNotMet
2013-03-18_22:34:58 OG.AZ.Thermostat operStateErrCnt: 1
2013-03-18_22:37:42 OG.AZ.Thermostat set_68 %
2013-03-18_22:37:42 OG.AZ.Thermostat ValveDesired: 68 %
2013-03-18_22:37:43 OG.AZ.Thermostat ValvePosition: 1 %
2013-03-18_22:37:43 OG.AZ.Thermostat 1 %
2013-03-18_22:40:20 OG.AZ.Thermostat set_68 %
2013-03-18_22:40:20 OG.AZ.Thermostat ValveDesired: 68 %
2013-03-18_22:40:22 OG.AZ.Thermostat ValvePosition: 68 %
2013-03-18_22:40:22 OG.AZ.Thermostat 68 %
2013-03-18_22:40:22 OG.AZ.Thermostat battery: ok
2013-03-18_22:40:22 OG.AZ.Thermostat motorErr: ok
2013-03-18_22:40:22 OG.AZ.Thermostat motor: stop
2013-03-18_22:40:22 OG.AZ.Thermostat operState: onTarget
2013-03-18_22:42:31 OG.AZ.Thermostat set_0 %
2013-03-18_22:42:31 OG.AZ.Thermostat ValveDesired: 0 %
2013-03-18_22:42:33 OG.AZ.Thermostat ValvePosition: 68 %
2013-03-18_22:42:33 OG.AZ.Thermostat 68 %
2013-03-18_22:42:33 OG.AZ.Thermostat battery: ok
2013-03-18_22:42:33 OG.AZ.Thermostat motorErr: ok
2013-03-18_22:42:33 OG.AZ.Thermostat motor: closing
2013-03-18_22:42:33 OG.AZ.Thermostat operState: adjusting
2013-03-18_22:44:34 OG.AZ.Thermostat set_0 %
2013-03-18_22:44:34 OG.AZ.Thermostat ValveDesired: 0 %
2013-03-18_22:44:36 OG.AZ.Thermostat ValvePosition: 0 %
2013-03-18_22:44:36 OG.AZ.Thermostat 0 %
</pre>

=== Event monitor ===
<pre>
2013-03-18 22:42:33 CUL_HM OG.AZ.Thermostat motor: closing
2013-03-18 22:42:33 CUL_HM OG.AZ.Thermostat operState: adjusting
</pre>

== Batteriealarme des HM-CC-VD in Verbindung mit HM-CC-TC ==
1. bei U-Bat. < 2,4 V erscheint im Display des VD und des TC das Batteriesymbol mit battery: low in den Readings und Events!
2. bei U-Bat. < 2,3 V erscheint im Display des VD zusätzlich F4 mit battery: critical in den Readings und Events!
Es wird dringend geraten, die Batterien bei battery: low zu tauschen!

= Links =
Anleitung: [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-CC-VD_UM_GE_eQ-3_081013.pdf HM-CC-VD Funk-Stellantrieb]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Heizungsventile]]

HM-CC-TC Funk-Wandthermostat

2015-11-29T18:37:38Z

Thomas.kregelin:

[[Datei:HM-CC-TC.jpg|thumb|right|HM-CC-TC Funk-Wandthermostat]]
Programmierbarer Raumthermostat, der bis zu 4 [[HM-CC-VD Funk-Stellantrieb]] steuern kann.

'''Achtung: Dieses Gerät ist abgekündigt (wird nicht mehr hergestellt).'''

Nachfolgeprodukt ist der [[HM-CC-RT-DN]] bzw. (ab März 2014) [[HM-TC-IT-WM-W-EU_Funk-Wandthermostat_AP|HM-TC-IT-WM-W-EU]].

'''Einstellungen und Informationen die alle HomeMatic Thermostat betreffen sind unter [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]].'''

= Features =
* Am Raumthermostat programmierbare Tages- und Nachttemperatur.
* Pro Wochentag können bis zu 24 Schaltpunkte definiert werden.
* Anbindung von <ins>jeweils</ins> '''maximal''' 4 Tür- bzw. Fensterkontakten ([[HM-Sec-RHS]]) zur Absenkung der Temperatur auf einen eigens eingestellten Temperaturwert (ab Werk: 12°C) bei offenem Fenster bzw. offener Tür.
* Anzeige der Temperatur und Luftfeuchtigkeit im Raum und Hintergrundbeleuchtung des Displays.

Alle 120 bis 184 Sekunden überträgt der Wandthermostat vorhandene Befehle zu den Stellantrieben. Jeder empfangene Befehl wird vom Stellantrieb bestätigt und dann ausgeführt. Täglich gegen Mitternacht synchronisiert ein HM-CC-TC seine Uhrzeit mit der HomeMatic-Zentrale (CCU, HMLAN).

= Hinweise zum Betrieb mit FHEM =
Vor dem Einsatz mit einer Zentrale sind erst alle Stellantriebe und Tür-/Fensterkontakte mit dem HM-CC-TC zu verbinden (P'''ee'''r).
Damit das ganze dann in FHEM auftaucht, muss der TC noch mit dem [[HMLAN Konfigurator]] gep'''ai'''rt werden.

Mit

<nowiki>set CUL hmPairForSec 300</nowiki>
setzt man das CUL / den HMLAN-Konfigurator für 5 Minuten in den Anlernmodus. Danach am Thermostaten 5 Sekunden lang die OK-Taste drücken und es wird eine Zeit von 20 auf 0 Sekunden gezählt:

* Klappt das Anlernen in diesen 20 Sekunden, wird der Countdown sofort beendet, anschließend für ca. 2-3 Sekunden "OK" angezeigt und der Thermostat ist in FHEM eingebunden.
* Gelingt das Anlernen nicht in den 20 Sekunden, erscheint nach Erreichen der "0" noch für 2 bis 3 Sekunden ein "NOK" ('''N'''ot '''OK''') im Display des TCs.

'''Alternativ'''(und so vom Entwickler des Fhem-HomeMatic-Moduls empfohlen) kann wie folgt vorgegangen werden:

* Alle Stellantriebe und Tür-/Fensterkontakte sowie den HM-CC-TC mit Fhem p'''ai'''ren (also ''set CUL hmPairForSec 300'' und an allen Devices den Anlernknopf drücken innerhalb des Zeitfensters von 300 Sekunden).
* Die Stellantriebe und Tür-/Fensterkontakte mit den ''Channels'' (siehe unten) p'''ee'''ren (siehe <nowiki>[http://fhem.de/commandref.html#CUL_HMpeerChan commandref :peerChan]</nowiki>). Hierzu werden die entsprechenden Fhem-Befehle über das Webinterface von Fhem erteilt.

'''Hinweis:'''
* Alle in der FHEM-Eingabezeile eingegebenen ''attr''-, ''define''-Befehle usw. müssen zum Schluss noch per Klick auf den "Save"-Button dauerhaft in der ''fhem.cfg'' gespeichert werden, sonst sind sie nach z.B. einem Systemabsturz verloren.
* Falls in der FHEM-Weboberfläche für ihren HM-CC-TC etwas wie ''X CMDs pending'' steht, sollten Sie ihren HM-CC-TC zur Hand nehmen und für 20 Sekunden auf die OK-Taste drücken. Dadurch werden alle noch ausstehenden Befehle eingelesen.

== Auszug aus der fhem.cfg ==
Die nachfolgenden Einstellungen zum HM-CC-TC werden von FHEM <ins>weitestgehend</ins> automatisch gesetzt. Die Pfadangaben für die Log-Dateien sind system-, die Raumbenennungen benutzerabhängig. Zu ''autoReadReg''und ''expert''siehe unten. Neben dem eigentlichen Basis-Gerät (HM-CC-TC) werden in FHEM automatisch noch 3 weitere "Unter"-Geräte (Channels/Kanäle), nämlich

* ''_Weather''
* ''_Climate''
* ''_WindowRec''

definiert (durch das Anlernen des TC an FHEM; siehe unten), deren Benennung sich (jeweils mit einem vorangestellten Unterstrich "_") am Namen des Basis-Gerätes orientiert.

'''Anmerkung:'''Die in den unten gezeigten ''fhem.cfg''-Auszügen markierten <ins>Peer</ins>-Einträge tauchen erst auf, sobald man die Daten aus dem TC mit ''set HM-CC-TC-Basisname getConfig''bzw. ''autoReadReg''ausgelesen hat.

=== Hauptgerät ===
<nowiki>define <HM-CC-TC>.Heizung CUL_HM 1DA491
attr <HM-CC-TC>.Heizung actCycle 000:10
attr <HM-CC-TC>.Heizung actStatus alive
attr <HM-CC-TC>.Heizung autoReadReg 1
attr <HM-CC-TC>.Heizung devInfo 00FFFF
attr <HM-CC-TC>.Heizung expert 2_full
attr <HM-CC-TC>.Heizung firmware 2.1
attr <HM-CC-TC>.Heizung hmClass receiver
attr <HM-CC-TC>.Heizung model HM-CC-TC
attr <HM-CC-TC>.Heizung room <IhrRaum>
attr <HM-CC-TC>.Heizung serialNr JE********
attr <HM-CC-TC>.Heizung subType thermostat</nowiki>
=== Channel (Kanal) 01 _Weather ===
<nowiki>define <HM-CC-TC>.Heizung_Weather CUL_HM 1DA49101 <<<=== 01 = Kanal 1
attr <HM-CC-TC>.Heizung_Weather model HM-CC-TC
attr <HM-CC-TC>.Heizung_Weather peerIDs
attr <HM-CC-TC>.Heizung_Weather room <IhrRaum>
define FileLog_<HM-CC-TC>.Heizung_Weather FileLog /opt/fhem/log/<HM-CC-TC>.Heizung_Weather-%Y-%m.log <HM-CC-TC>.Heizung_Weather
attr FileLog_<HM-CC-TC>.Heizung_Weather logtype text
attr FileLog_<HM-CC-TC>.Heizung_Weather room CUL_HM,<IhrRaum></nowiki>
=== Channel (Kanal) 02 _Climate ===
<nowiki>define <HM-CC-TC>.Heizung_Climate CUL_HM 1DA49102 <<<=== 02 = Kanal 2
attr <HM-CC-TC>.Heizung_Climate model HM-CC-TC
attr <HM-CC-TC>.Heizung_Climate peerIDs 1AD52B01,1B7A4C01,1C4CD101,1C48EC01, <<<=== gepeerte HM-CC-VDs
attr <HM-CC-TC>.Heizung_Climate room <IhrRaum>
define FileLog_<HM-CC-TC>.Heizung_Climate FileLog /opt/fhem/log/<HM-CC-TC>.Heizung_Climate-%Y-%m.log <HM-CC-TC>.Heizung_Climate
attr FileLog_<HM-CC-TC>.Heizung_Climate logtype text
attr FileLog_<HM-CC-TC>.Heizung_Climate room CUL_HM,<IhrRaum></nowiki>
=== Channel (Kanal) 03 _WindowRec ===
<nowiki>define <HM-CC-TC>.Heizung_WindowRec CUL_HM 1DA49103 <<<=== 03 = Kanal 3
attr <HM-CC-TC>.Heizung_WindowRec model HM-CC-TC
attr <HM-CC-TC>.Heizung_WindowRec peerIDs 1CFBB001, <<<=== gepeerte HM-Sec-SCs
attr <HM-CC-TC>.Heizung_WindowRec room <IhrRaum>
define FileLog_<HM-CC-TC>.Heizung_WindowRec FileLog /opt/fhem/log/<HM-CC-TC>.Heizung_WindowRec-%Y-%m.log <HM-CC-TC>.Heizung_WindowRec
attr FileLog_<HM-CC-TC>.Heizung_WindowRec logtype text
attr FileLog_<HM-CC-TC>.Heizung_WindowRec room CUL_HM,<IhrRaum></nowiki>
== Einstellungen eines HM-CC-TC lesen, anzeigen und sichern ==
=== expert ===
Anfang Februar 2013 wurde eine Änderung bei der Anzeige der so genannten ''Readings'' (Register usw.), also der Einstellungen bzw. Eigenschaften eines HM-Devices, eingeführt. '''Alle''' Werte sieht man nur noch, wenn man am HM-CC-TC das Attribut ''expert'' auf ''2_all'' setzt. Per '''default''' (nicht in ''fhem.cfg'' gesetzt) steht dieser Wert auf ''0_off'' (nur die notwendigsten Readings/Eigenschaften werden angezeigt). Mittelweg ist der Wert ''1_on''.

Mittels

<nowiki>attr <HM-CC-TC-Name> expert 2_full</nowiki>
in der FHEM-Befehlszeile mit anschließendem <Enter> setzt man diesen Level.

Falls man mit '''Temperaturlisten''' arbeitet (siehe unten), dann kann man die komplette Liste im "Channel" (Kanal) ''<HM-CC-TC-Name>__Climate'' einsehen. Auch für diesen Kanal ist evtl. ein setzen des Attributes ''expert 2_full'' angeraten.

<ins>Anmerkung:</ins> Es gibt auch noch sogenannte "hidden datas" (versteckte interne Werte, Register oder Eigenschaften deren Namen mit einem "." beginnen). Diese sieht man nur dann, wenn auch das Attribut ''showInternalValues 1'' gesetzt ist (default: 0 bzw. nicht gesetzt).

=== autoReadReg ===
Mitte Januar 2013 wurde das neue Attribut ''autoReadReg'' eingeführt, welches auf ''0'' voreingestellt ist (kein Eintrag in der ''fhem.cfg''). Das Setzen dieses Attributes auf ''1'' bewirkt, dass <ins>beim Neustart von FHEM</ins> die Einstellungen des entsprechenden HM-Gerätes ausgelesen werden. Dies wird bei mehreren ''autoReadReg''s automatisch zeitversetzt vorgenommen, um die Funk-Kommunikation nicht unnötig zu belasten.

Mittels

<nowiki>attr <HM-CC-TC-Name> autoReadReg 1 </nowiki>
in der FHEM-Befehlszeile mit anschließendem <Enter> setzt man diesen Wert.

=== list ===
Um sich alle Eigenschaften/Readings eines Gerätes anzusehen, gibt es den Befehl ''list''.

Mittels

<nowiki>list <HM-CC-TC-Name></nowiki>
und Bestätigung mit <Enter> erhalten Sie die gewünschte Anzeige Ihres TCs <ins>incl.</ins> seiner 3 Channels. Über

<nowiki>list <HM-CC-TC-Name>_<Channel-Name></nowiki>
werden nur die Daten des angegebenen Channels angezeigt.

=== Einstellungen sichern ===
Die Durchführung von ''autoReadReg'' kann durchaus mehrere Minuten dauern. Anschließend besteht die Möglichkeit, diese per

<nowiki>get HM-CC-TC-Basisname saveConfig [/Verzeichnis/mit/Schreibrechten/]<Dateiname></nowiki>
für jedes HM-CC-TC getrennt zu sichern (für eine später notwendige Wiederherstellung). Die Sicherungsdatei wird regulär im ''modpath'' (siehe ''fhem.cfg'') abgelegt. Falls dies nicht zum Erfolg führt (es wird - ohne Fehlermeldungen bei regulärem ''verbose'' und ''loglevel'' - im ''modpath'' keine Datei angelegt), müssen Sie vor dem Dateinamen einen vollständigen Pfad mit Schreibrechten für den Benutzer, unter dem FHEM läuft, angeben.

In der <ins>Log-Datei</ins> von FHEM erscheinen danach Meldungen folgender Art

<nowiki><Datum>_<Zeit> 2: CUL_HM set <HM-CC-TC-Name> statusRequest rxt:12
<Datum>_<Zeit> 2: CUL_HM set <HM-CC-TC-Name> getConfig rxt:12</nowiki>
Hierbei kann es (im <ins>Event monitor</ins> von FHEM) zu folgenden Fehlermeldungen kommen

<nowiki><Datum>_<Zeit> CUL_HM <HM-CC-TC-Name> RESPONSE TIMEOUT:RegisterRead
<Datum>_<Zeit> CUL_HM <HM-CC-TC-Name> RESPONSE TIMEOUT:PeerList
<Datum>_<Zeit> CUL_HM <HM-CC-TC-Name> RESPONSE TIMEOUT:StatusReq</nowiki>
Diese Meldungen können auch mehrfach pro Gerät auftreten. Dann hat das Auslesen der Einstellungen nicht geklappt und sollte nochmals durchgeführt werden. Dafür muss man FHEM aber nicht neu starten, sondern das HM-Device per

<nowiki>set <HM-CC-TC-Name> getConfig</nowiki>
in der Befehlszeile von FHEM und anschließendem <Enter> (nicht "save") darauf einstellen.

Die Channels (z.B. <HM-CC-TC-Name>_Climate, _Weather, _WindowRec) eines HM-Gerätes brauchen nicht (können aber bei Bedarf) separat ausgelesen bzw. gesichert zu werden, da sie Bestandteil der Basisabfrage sind.

== Funkprobleme auffangen ==
Der wohl am häufigsten an den HM-CC-TC gesendete Befehl ist "set desired-temp", mit dem die Wunschtemperatur neu gesetzt wird.
Funktioniert dieser Befehl jedoch nicht zuverlässig, wird die Wohnung ggf. zu lange oder nicht rechtzeitig beheizt.
Der folgende Mechanismus soll die Sicherheit erhöhen, indem die Antworten des HM-CC-TC geprüft werden und ggf. das Funktelegramm erneut gesendet wird.

Um den Sollwert zum erneuten Senden des Funktelegramms verfügbar zu haben, wird ein dummy definiert:

<nowiki>define HM_TC_Solltemperatur dummy</nowiki>
Wann immer die Solltemperatur geändert wird, setzt man die neue desired-temp nicht nur auf dem HM-TC-CC (hier HM_TC genannt), sondern auch auf dem dummy. Der Befehl (z.B. in der [[Zuhause-Status|Routine zum HomeStatus]]) sieht dann so aus:

<nowiki>set HM_TC desired-temp 21;set HM_TC_Solltemperatur 21</nowiki>
Falls das ausgehende Funktelegramm verlorengeht, fehlt die Antwort "command accepted". Dies kann mit einem watchdog aufgefangen werden, der dann den Befehl an den HM-CC-TC erneut sendet:

<nowiki>define w_HM_TC watchdog HM_TC:set_desired-temp.* 00:02:30 HM_TC_Climate:CommandAccepted:.yes { \
Log 1, ">>>>>>>>> w_HM_TC desired temp - missing response.";\
fhem("set HM_TC desired-temp ".Value("HM_TC_Solltemperatur"));\
}</nowiki>
Falls ein Fehler bei der Funkkommunikation auftritt, erhält man die Antwort "missing ACK" oder "NACK". Auch in diesem Fall soll das Telegramm zum Ändern der Wunschtemperatur erneut an den HM-CC-TC gesendet werden:

<nowiki>define n_HM_TC_err notify HM_TC:(MISSING.ACK.*|.*NACK.*) {\
Log 1, ">>>>>>>>> n_HM_TC desired temp - missing ack/nack.\n";\
fhem("set HM_TC desired-temp ".Value("HM_TC_Solltemperatur"));\
}</nowiki>
Mit diesen beiden Helfern ist die Funkkommunikation zum HM-CC-TC sehr zuverlässig.

== Plots / Grafiken ==
=== Problem ===
Durch ''autocreate'' wird zwar ein Log angelegt, aber kein Plot (Grafische Auswertung). Dem kann man aber abhelfen (siehe unten).

=== Plots erzeugen ===
''PGM2'' ist die Standardansicht des Fhem-Web-Interfaces. Um hier Plots/Grafiken zu erzeugen einfach unter dem ''Filelog'' des Thermostaten das ''attr logtype'' auf ''temp4hum6:Plot,text'' setzen und es wird ein Plot-Link neben dem Text-Link angezeigt. Nun können Sie auf diesen Plot-Link klicken und ...

=== alternative Plots ===
Mit dem fht.gplot funktioniert die Anzeige der Ventilstellung (actuator) nicht.

Mit folgendem angepassten .gplot File wird die gemessene Temperatur und Ventilstellung angezeigt.

<nowiki>############################
# Display the measured temp and the actuator.
# Corresponding FileLog definition:
# define <filelogname> FileLog /var/log/fhem/actuator_name-%Y.log <actuator_name>:(measured-temp|actuator).*

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
set y2tics
#set ytics
set title '<L1>'
set grid xtics y2tics

set y2label "Temperatur in C"
set ylabel "Ventil (%)"

#FileLog 4:measured:10:
#FileLog 4:actuator:50:

plot \
"< egrep 'temperature' <IN>"\
using 1:4 axes x1y2 title 'Temperatur in C' with lines,\
"< egrep 'actuator' <IN>"\
using 1:4 axes x1y1 title 'Ventil (%)' with lines\</nowiki>
=== Alles-drin-Plot ===
dazu nimmt man folgendes .gplot. Man/Fra beachte, dass hierfür alle Parameter nach der define-Anweisung in das Logfile geschrieben werden.

<nowiki>############################
# Display the measured temp and the actuator.
# Corresponding FileLog definition:
# define <filelogname> FileLog /var/log/fhem/HM_CC_TC-%Y.log <HM_CC_TC-name>
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
set y2tics
#set ytics
set title '<L1>'
set grid xtics y2tics
set y2label "Temperature in C"
set ylabel "Actuator (%)"
#FileLog 4:temperature:0:
#FileLog 4:desired:0:
#FileLog 4:humidity:0:
#FileLog 4:actuator:0:int
plot \
"< awk '/temperature/{print $1, $4}' <IN>"\
using 1:2 axes x1y2 title 'Measured temperature' with lines lw 2,\
"< awk '/desired/{print $1, $4}' <IN>"\
using 1:2 axes x1y2 title 'Desired temperature' with steps,\
"< awk '/humidity/ {print $1, $4+0}' <IN>"\
using 1:2 axes x1y1 title 'Humidity (%)' with lines,\
"< awk '/actuator/ {print $1, $4+0}' <IN>"\
using 1:2 axes x1y1 title 'Actuator (%)' with lines\</nowiki>

== Steuerungsmodi ==
Das Wandthermostat hat 4 verschiedene Steuerungsmöglichkeiten:

* Auto (automatisch)
* Cent (Zentrale)
* Manu (manuell)
* Prog / Koffer-Symbol (Urlaubs/Party-Modus, wird hier nicht näher erörtert)

Der Steuerungsmodus wird über wiederholtes Drücken der linken Taste des HM-CC-TC ausgewählt bzw. gewechselt.

'''Hinweis:''' Durch das P'''ai'''ren des HM-CC-TC <ins>und</ins> der Stellantrieb sowie Tür-/Fensterkontakte an Fhem verlieren Sie '''nicht''' die Steuerungsmöglichkeiten. Im Gegenteil: Nur wenn auch die VDs usw. mit Fhem gep'''ai'''rt sind, haben Sie die Möglichkeit, auch diese zu überwachen. Die Steuerung '''können''' Sie dennoch allein dem HM-CC-TC überlassen.

=== Auto-Modus ===
Im Modus '''Auto''' wird die Temperaturregelung über die im TC hinterlegten Temperaturlisten vorgenommen. Das Thermostat arbeitet also selbständig, somit unabhängig von einer Zentrale / FHEM. Nur in diesem Modus werden die evtl. per FHEM an das TC übermittelten "templist" abgearbeitet. Über das Senden von angepassten Temperatur-Listen kann eine indirekte Steuerung per FHEM erfolgen. '''Jederzeit''' kann zudem die Raumtemperatur über das Drehrad des Wandthermostaten oder die FHEM-Web-Oberfläche verändert werden. Diese ''Übersteuerung'' der Temperaturliste gilt bis zur nächsten Temperaturänderung nach der vorgenannten Liste.

=== Cent-Modus ===
Im Modus '''Cent''' steuert eine HomeMatic-Zentrale (CCU) oder eben ein FHEM-Server mit z.B. [[HMLAN Konfigurator]] zu den in der FHEM-Config hinterlegten Zeiten und mit den dort festgelegten Temperaturen. Fällt also die HM-Zentrale aus, erfolgt keine Steuerung der Thermostaten bzw. Heizungsventile mehr.

<ins>Anmerkung</ins>: Der Modus ''cent'' erscheint nur dann im Display des HM-CC-TC, wenn er an eine Zentrale bzw. das [[CUL]] angelernt (gepairt) wurde.

=== Manu-Modus ===
Der Modus '''Manu''' übersteuert die im TC hinterlegten Temperaturlisten und die evtl. von der HM-Zentrale / dem FHEM <ins>vor Umstellung auf ''Manu''</ins> gesendeten Einstellungen. Es wird also bis zur nächsten Modusumstellung bzw. manuellen Temperaturverstellung der per Einstellrad gesetzte Temperaturwert gefahren.

Aber auch in diesem Modus kann man die ''desired-temperature'' per FHEM verstellen. Der dadurch eingestellte Wert gilt ab sofort als der neue im ''Manu-Modus'' zu haltende Wert.

=== Tastensperre ===

Um zu verhindern, dass der Modus oder die Temperatur per Tasten bzw. Drehrad am HM-CC-TC verändert wird, kann eine Tastensperre gesetzt werden. Dies erfolgt mittels des Befehls:

set <HM-CC-TC> regSet btnLock on

Rückgängig machen geht per:

set <HM-CC-TC> regSet btnLock off

=== Auslesen des eingestellten Steuerungsmodus ===
Der eingestellte Steuerungsmodus erscheint normalerweise in den ''Readings'' des HM-CC-TC unter ''controlMode''. Zusätzlich haben Sie die Möglichkeit, diesen Modus auch in der FHEM-Weboberfläche ''everything'' => Abschnitt ''thermostat'' zu sehen, '''wenn''' Sie für den HM-CC-TC das folgende Attribut setzen:

<nowiki>attr <HM-CC-TC-Name> stateFormat T:measured-temp, H:humidity, VD:actuator, controlMode</nowiki>
Erscheint dort selbst nach einem

<nowiki>set <HM-CC-TC-Name> getConfig</nowiki>
kein "Reading" ''controlMode'' oder keine Angabe des aktuell eingestellten Modus bzw. nur das Wort "controlMode", dann setzen Sie ihren HM-CC-TC von Hand in einen anderen Kontrollmodus und machen einen Browser-Refresh. Klappt dies nicht, geben Sie bitte erneut den Befehl

<nowiki>set <HM-CC-TC-Name> getConfig</nowiki>
ein. Halten Sie anschließend die Taste <OK> am HM-CC-TC für 5 Sekunden gedrückt (oder warten ca. 5 Minuten) und machen in der FHEM-Weboberfläche einen Browser-Refresh (FF => <F5>). Jetzt sollte der manuell eingestellte Kontrollmodus erscheinen (ggfls. muss dieser Vorgang einmal wiederholt werden). Jetzt können Sie wieder den gewünschten Modus einstellen, erneut ein

<nowiki>set <HM-CC-TC-Name> getConfig</nowiki>
absetzen und nach erneutem Drücken der <OK>-Taste für 5 Sekunden mit nachfolgendem Browser-Refresh sollte alles richtig angezeigt werden.

Dies setzt natürlich voraus, dass der HM-CC-TC richtig gepairt ist.

== Temperaturlisten ==
Die Temperaturlisten des TC werden identisch mit denen anderer HomeMatic Thermostate verwaltet, siehe [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]].
Beim TC ist der Kanal 4 (_Climate) für die Temperaturlisten zuständig.

== Batteriealarme des HM-CC-VD in Verbindung mit HM-CC-TC ==
1. bei U-Bat. < 2,4 V erscheint im Display des VD und des TC das Batteriesymbol mit '''battery: low''' in den Readings und Events!

2. bei U-Bat. < 2,3 V erscheint im Display des VD zusätzlich '''F4''' mit '''battery: critical''' in den Readings und Events!

Es wird dringend geraten, die Batterien bei battery: low zu tauschen!

== Log-Auszug ==
HM-CC-TC sendet alle 2 Minuten folgenden Statusbericht:

<nowiki>Datum-Zeit <Device Name> T: 17.3 H: 66
Datum-Zeit <Device Name> measured-temp: 17.3
Datum-Zeit <Device Name> temperature: 17.3
Datum-Zeit <Device Name> humidity: 66
Datum-Zeit <Device Name> actuator: 96 %</nowiki>
Bei Status-Änderungen sendet HM-CC-TC auch entsprechende Meldungen, z.b.:

<nowiki>Datum-Zeit <Device Name> desired-temp: 15.5</nowiki>

= Probleme =

== Verstellen der Solltemperatur am HM-CC-TC per Drehrad ==

'''Symptom:''' Beim Verstellen der Solltemperatur per seitlichem Drehrad wurde die aktuelle Solltemperatur - '''egal ob''' man hoch oder runter drehte - immer nur in 0,5 °C Schritten '''runter''' gestellt, bis schließlich die Mindesttemperatur von 6,0 °C erreicht war. Weitere Änderungen waren nicht möglich

'''Abhilfe:''' Letztlich half nur das kurzzeitige Entfernen einer Batterie. Das danach für einige Zeit erscheinende Batteriesymbol zeigte den kleinstmöglichen guten Zustand an, in FHEM wurde das ''Reading'' des Batteriezustandes mit ''ok'' ausgegeben (wie in den Logs aber vorher auch). '''Letztlich half aber nur''' das Einsetzen neuer Batterien, denn die o.a. Störung trat nach ca. 2 Stunden erneut auf. Die "alten" Batterien (die, die dem HM-CC-TC ab Werk beilagen) hatten somit eine Nutzungsdauer von knapp 11 Monaten, waren aber auch in einem HM-CC-TC, der mit 4 Stck. HM-Sec-SC (mussten sehr oft "Meldung machen") und 4 Stck. HM-CC-VD gepeert war. ''Ohne Last'' zeigten die beiden alten AA-Batterien eine Spannung von jeweils 1,29 V an.

'''Hinweis:''' Die unter ''Abhilfe'' beschriebene Lösung war leider nur von kurzer Dauer. Bereits kurz danach zeigte der HM-CC-TC die gleichen Ausfallerscheinungen. Bei ELV gibt es das Bauteil für das Drehrad (Inkrementalgeber) als [http://www.elv.de/inkrementalgeber-fuer-fs20-str-fht-8-und-homematic-hm-cc-tc.html Ersatzteil]. Sobald dieses geliefert und ein Reparaturversuch unternommen wurde, wird an dieser Stelle weiter berichtet.

== HM-CC-TC misst zu hohe/niedrige Luftfeuchte-Werte ==

'''Symptom:''' In den Fhem-Logs und demzufolge auch in den Plots/Grafiken eines seit über 18 Monaten im Einsatz befindlichen HM-CC-TC wurden viel zu hohe (einzelne Spitzenwerte von 98 oder 99 %) bzw. ständig zu niedrige (um die 20 oder sogar vereinzelt nur 2 %) Werte für die relative Luftfeuchte gemessen (im direkten Vergleich zu anderen HM-CC-TCs). Die anderen Werte (Temperatur, Actuator) waren aber schlüssig.

'''Abhilfe:''' Batteriewechsel. Die alten Batterien hatten (unbelastet) noch knapp über 1 V Spannung.

'''Hinweis:''' Eine Batteriewarnung des Gerätes gab es nicht. Im Display war das entsprechende Symbol noch auf 1 Balken.

= Firmware =
Aktuelle Firmware-Version: 2.1

= Links =
* Anleitung [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-CC-TC_UM_GE_eQ-3_110405.pdf PDF]
* Ersatzteil Inkrementalgeber [http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=41344 ELV]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]

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

2015-11-29T18:33:55Z

Thomas.kregelin:

[[Datei:bild_HM-CC-RT-DN.jpg|thumb|right|HM-CC-RT-DN Funk-Heizkörperthermostat]]
Beim '''HM-CC-RT-DN''' handelt es sich um einen '''Funk-Heizkörperthermostaten mit integriertem Stellantrieb''', der als Nachfolger den [[HM-CC-VD]] ablöst und seit Mitte September 2013 verfügbar ist.

== Vorbemerkungen ==

'''Einstellungen und Informationen die alle HomeMatic Thermostat betreffen sind unter [[HomeMatic_Type_Thermostat#Temperaturlisten|HomeMatic Type Thermostat]] zu finden.'''

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 hat eine eigene Fenster-Offen-Erkennung. Ein passender Wandthermostat ([[HM-TC-IT-WM-W-EU_Funk-Wandthermostat_AP|HM-TC-IT-WM-W-EU]]) ist seit Februar 2014 verfügbar.

Das Gerät wird seit Anfang Oktober 2013 von Fhem unterstützt (siehe Diskussion im {{Link2Forum|Topic=14738|LinkText=Forum}}).

Der '''HM-CC-RT-DN''' scheint das erste HomeMatic-Device zu sein, bei dem ein Update der Firmware auch vom Anwender durchgeführt werden kann. Ein Firmware-Update erfordert einen [[HM-CFG-USB_USB_Konfigurations-Adapter|USB Konfigurations-Adapter]] und eine auf der eQ-3 Webseite herunterladbare Firmware Update Software. Weitere Details sind unter [[HM-CC-RT-DN_Funk-Heizkörperthermostat#Firmware_Update|Firmware Update]] beschrieben.

'''Achtung:''' Die Solltemperaturen eines HM-CC-RT-DN lassen sich <ins>nicht</ins> durch einen [[HM-CC-TC Funk-Wandthermostat|HM-CC-TC]] steuern. Dieser kann höchstens die Ist-Temperatur an den RT weiter geben, damit die Raumtemperatur nicht am RT selbst zur Ventilsteuerung genommen wird.

Mit einem HM-CC-RT-DN können maximal (neben der Zentrale/Fhem):
* 7 HomeMatic Heizkörperthermostate
* 8 HomeMatic Tür-Fensterkontakte / Fenster-Drehgriffkontakte
* 8 Tastenpaare von HomeMatic Fernbedienungen bzw. Display-Wandtaster
* 1 HomeMatic Innen-Temperatur-Sensor
gep'''ee'''rt werden.

== Technische Daten ==
* Betriebsspannung: 2 Stck. 1,5V LR6/Mignon/AA
* Stromaufnahme: 180 mA max.
* Abmessungen (B x H x T): 54 x 65 x 93 mm
* Gewicht: 180 g (ohne Batterien)
* Ventilanschluss: M30 x 1,5 mm

Aktuelle Firmware: 1.4

== Betrieb mit FHEM ==
Der Funk-Heizkörperthermostat muss zuerst mit Fhem [[HomeMatic_Devices_pairen|gepairt]] werden. Stellen Sie sicher, dass Fhem aktuell ist (update durchführen).

=== Channels (Kanäle) ===
==== Channel (Kanal) 01 _Weather ====
Dieser Kanal dient zur Einspeisung der gemessenen ("Ist"-) Temperatur, als Sensor kann z.B. ein HomeMatic HM-WDS10-TH-O Funk-Temperatur-/Luftfeuchtesensor OTH dienen.

Der Befehl zum peeren lautet, wobei <tempSensor> die Fhem-Kanalbezeichnung für den Sensor ist und <rt_Weather> die Kanalbezeichnung für den entsprechenden Kanal des Heizkörperthermostates:
set <tempSensor> peerChan 0 <rt_Weather> single

==== Channel (Kanal) 02 _Climate ====
Der Climate-channel dient der Kommunikation mit einem Temperatur-Kontroller (aktuell nur [[HM-TC-IT-WM-W-EU_Funk-Wandthermostat_AP|HM-TC-IT-WM-W-EU]]).
Zum peeren von TC und RT siehe [[HM-TC-IT-WM-W-EU_Funk-Wandthermostat_AP#Hinweise zur Inbetriebnahme und Installation|HM-TC-IT-WM-W-EU]].

==== Channel (Kanal) 03 _WindowRec ====
Mit diesem Kanal lassen sich Fensterkontakte (HM-SEC-SC oder HM-SEC-RHS) peeren, die ihren Fensterstatus (geöffnet/gekippt) an ein oder mehrere Thermostate senden. Die Thermostate stellen anschließend die entsprechende (konfigurierbare) Temperatur ein. Der Temperaturwert kann je Fenster-Sensor unterschiedlich definiert werden. Sind mehrere Fenster gleichzeitig geöffnet, so wird der Thermostat auf die Temperatur des Sensors mit dem geringsten Temperaturwert eingestellt.
Ferner wird empfohlen, bei Einsatz von externen Sensoren, die interne „Fenster auf Erkennung“ zu deaktivieren (Weitere Details sind im [[HM-CC-RT-DN_Funk-Heizkörperthermostat#Channel_.28Kanal.29_04_Clima|Channel (Kanal) 04 _Clima]] näher beschrieben).

Der Befehl zum peeren lautet, wobei <fensterSensor> die Fhem-Kanalbezeichnung für den Fensterkontakt ist und <rt_WindowRec> die Kanalbezeichnung für den entsprechenden Kanal des Heizkörperthermostates:
set <fensterSensor> peerChan 0 <rt_WindowRec> single

Zum Löschen (=unpeeren) dieser Kopplung:
set <fensterSensor> peerChan 0 <rt_WindowRec> single unset

'''Achtung''': Der Peer-(Lösch)Vorgang muss am Fensterkontakt durch Drücken der Anlerntaste bestätigt werden, und zwar auch dann, wenn der Fensterkontakt schon vorher mit Fhem gepairt wurde. Wichtig scheint auch dass der Fensterkontakt geschlossen ist wenn man die Anlerntaste drückt.

Der Befehl zur Temperatureinstellung des Heizkörperthermostaten für den Zustand "Fenster offen" lautet, wobei <fensterSensor> die Fhem-Kanalbezeichnung für den Fensterkontakt ist und <rt_WindowRec> die Kanalbezeichnung für den entsprechenden Kanal des Heizkörperthermostates, sowie <Temp> die einzustellende Temperatur (ganzzahliger Wert):
set <rt_WindowRec> regSet winOpnTemp <Temp> <fensterSensor>

==== Channel (Kanal) 04 _Clima ====
Dieser Kanal dient zum Einstellen der Betriebsparameter, auch [[#Temperaturlisten]] sind hierauf zu übrtragen.

'''Achtung:''' In älteren Versionen von Fhem wurde dieser Kanal durch autocreate als "_ClimRT_tr" angelegt. Der Hersteller hat hier offenbar die internen Bezeichnunen geändert, denn beim Vorläufernmodell HM-CC-TC mussten Temperaturlisten auf den Kanal ''Climate'' übertragen werden.

Die maximale Öffnung des Ventils kann mittels folgendem Befehl eingestellt werden (hier auf 80 %):
set <rt_Clima> regSet valveMaxPos 80

Die interne "Fenster-auf" Erkennung kann man wie folgt abschalten:
set <rt_Clima> regSet winOpnMode off

==== Channel (Kanal) 05 _ClimaTeam ====
Dieser Kanal dient zum peeren von mehreren Heizkörperthermostaten untereinander. Ein Mitglied des "Teams" meldet
* Änderungen der Temperatur am Handrad
* Einschalten des Boost-Modus am Taster
an seine "Teamkollegen" weiter. Folgende Änderungen werden '''nicht''' weitergegeben:
* Status der Fensterkontakte
* Temperaturlisten/Wochenplan und daraus folgende Änderungen
* Änderungen durch Fernbedienungen
* Änderungen durch eine HomeMatic-Zentrale

Befehl zum peeren, wobei <rt1-ClimaTeam> und <rt2-ClimaTeam> die Kanalbezeichnungen der beiden ClimaTeam-Kanäle sind:
set <rt1-ClimaTeam> peerChan 0 <rt2-ClimaTeam> single

==== Channel (Kanal) 06 _remote ====
Dieser Kanal ann an eine Fernbedienung gekoppelt werden. Per Tastendruck kann man einen bestimmten Mode und/oder eine bestimmte Temperatur wählen. Dabei kann die Reaktion auf einen langen oder kurzen Tastendruck gesondert eingestellt werden.

Der Befehl zum peeren lautet, wobei <button> die Kanalbezeichnung der Fernbedienung und <rt-remote> die Kanalbezeichnung des Heizkörperthermostates ist:
<pre>set <button> peerChan 0 <rt-remote> single</pre>

=== Betriebsmodus Auto, Manu, Party (Urlaub) ===
Im Automode kann man die Temperatur am Einstellrad des RT ändern. Zum nächsten Schaltpunkt wird dies dann überschrieben. Will man dies nicht (z.B. lange Party, ...), kann man auf manuell schalten. Dann bleibt die mit dem Drehregler (oder der Zentrale) eingestellte Temperatur stehen bis ''ultimo''. Es gibt dann noch den Party- oder Urlaubsmodus. In diesen kann man den Automodus für eine gegebene Zeit überschreiben.

==== Tastensperre ====
Um zu verhindern, dass der Modus oder die Temperatur per Tasten bzw. Drehrad am HM-CC-RT-DN verändert wird, kann eine Tastensperre gesetzt werden. Dies erfolgt mittels des Befehls:

set <HM-CC-RT-DN> regSet btnLock on

Rückgängig machen geht per:

set <HM-CC-RT-DN> regSet btnLock off

Diese Tastensperre kann man aber am RT durch eine Tastenkombination wieder zurücksetzen. Um sie nur per Fhem rücksetzen zu können, muss

set <HM-CC-RT-DN> regSet globalBtnLock on

eingegeben werden. Rückgängig geht wieder per:

set <HM-CC-RT-DN> regSet globalBtnLock off

==== Modus Auto ====
Das Device arbeitet gemäß des gespeicherten Wochenprogramms. Manuelle Änderungen sind möglich, werden beim nächsten Schaltpunkt überschrieben.

==== Modus Manu ====
Das Wochenprogramm wird nicht abgearbeitet, die Temperatur wird manuell eingestellt.

==== Modus Party (Urlaub) ====
Will man für eine festgesetzte Zeit (Stunden oder Tage) die Temperatur auf einen festen Wert einstellen (z.B. weil man in Urlaub fährt), kann man dies zwar auch durch Änderungen der Temperaturlisten erreichen, einfacher ist aber die Zuweisung über den Urlaubsmodus, da nach dessen Ablaufdatum und -zeitpunkt automatisch in den Auto-Modus gewechselt wird.

'''Ein Beispiel:'''
:<code>set HM-CC-RT-DN_Clima controlParty 16 06.12.13 16:30 09.12.13 05:00</code>

Dadurch wird
* vom 06.12.2013, 16:30 Uhr,
* bis zum 09.12.2013, 05:00 Uhr
* die gewünschte Raumtemperatur auf 16 °C

eingestellt.

'''Hinweise:'''
* Der Befehl muss auf den Channel 4 ("_Clima") erfolgen.
* Es werden nur Uhrzeiten zu jeder vollen oder halben Stunde angenommen (Minuten also 00 oder 30).

Mit der Funktion "Urlaub" kann man eine ganze Wohnung (also mehrere RT´s) mit nur einem Befehl in den Party-mode versetzen.

Der Name "Urlaub" kann natürlich frei gewählt werden. Im Beispiel werden zwei Heizkörper (Treppenhaus und Kammer) angesteuert.

Zu beachten sind folgende Dinge:
# Aktuelle Dateien (z.B. 10_CUL_HM) verwenden!
# Bei dem partycontrol-Befehl in der Funktion KEIN Komma zwischen den Parametern.
# Bei der Funktion die Parameterübergabe definieren ($$$$$)

'''Aufruf:'''
:<code>{Urlaub ("16", "06.12.13", "16:30", "09.12.13" ,"05:00")}</code>

'''Funktion:'''
<source lang=perl>
my $Urlaub;
sub
Urlaub($$$$$)
{
#lokale Variablendeklaration
my ($temp,$startDate,$startTime,$endDate,$endTime) = @_;

# HM-CC-RT-DN akzeptiert nur Zeiten, die auf Minute 00 oder 30 enden.
# Daher $startTime und $endTime abrunden
$startTime =~ s/\:[0-2].$/:00/;
$startTime =~ s/\:[3-5].$/:30/;
$endTime =~ s/\:[0-2].$/:00/;
$endTime =~ s/\:[3-5].$/:30/;

#Sendebefehl für ein HM-CC-RT-DN
{fhem ("set Kammer controlParty $temp $startDate $startTime $endDate $endTime")}

# alternative Schreibweise der Parameter:
{fhem ("set Treppenhaus controlParty @_[0] @_[1] @_[2] @_[3] @_[4]")};
}
</source>

=== Burst-Modus ===
Das ist ein '''Übertragungs'''modus für Nachrichten zwischen HM-Geräten und der Zentrale. Der RT erwacht alle 2,5 Minuten und dann überträgt die Zentrale die Kommanods. Wenn man einen Fensterkontakt oder eine Fernsteuerung nutzt, muss der RT sofort reagieren - dann muss man den Burst ''enablen''. Der RT kann in diesem Fall sofort aufgeweckt werden und bearbeitet die Anforderung (Request). Das kann man auch von der Zentrale aus nutzen (so man möchte). Das ist der '''Vorteil''' des eingeschalteten Burst-Modus.

'''Nachteil:''' Der RT muss den Receiver wach halten. Der RT und alle anderen Burst-Devices erwachen bei '''jedem''' Burst (egal für wen) und legen sich dann wieder schlafen.
* jeder Burst-trigger kostet Batterie für '''alle''' Burst-Geräte im System
* wenn Burst enabled ist kostet es dem RT Batteriekapazität

'''Burst – wie es funktioniert'''

Schickt ein Sender eine burst Sequenz, wachen alle burst-Empfänger auf und prüfen die Message.
Wenn sie betroffen sind bleiben sie eine Zeit lang wach, ansonsten schlafen sie wieder ein.
Man beachte also, dass Senden eines Burst Energie in ALLEN burst-Empfängern verbraucht, egal ob sie angesprochen sind.

'''HMLAN und burst'''

HMLAN hat ein Sendebudget das über eine Stunde berechnet wird. Burst belastet diese Konto deutlich - so können nicht mehr als 100 bursts /h gesendet werden - dann geht HMLAN in overload Wenn zusätzliche messages gesendet werden sind es entsprechend weniger.
Es ist als nicht vorteilhaft, unnötig bursts zu senden.

'''Burst devices'''

Es gibt Devices, die immer auf burst reagieren und solche bei denen es abgeschaltet werden kann. So reagiert ein Rauchmelder immer auf Burst damit er seine Team-Kollegen hören kann.
Ein TC oder RT hingegen hat diese Funktion abschaltbar. 'Per default ist dies ausgeschaltet um Batterie zu sparen'. Wenn ein VD gesteuert wird ist der TC ja selbst wach. Wird er aber mit einem Fensterkontakt gekoppelt muss es eingeschaltet werden – sonst verpasst er die message.

'''ConditionalBurst devices'''

Devices mit abschaltbarem burst wie z.B. der 'HM-CC-RT-DN', gibt es ein Register burstRx mit dem das burst-erwachen eingestellt werden kann.
Sender, die einen burst-Aktor erwecken sollen muss man sagen, welcher peer burst benötigt. Hier kann ggf. das Register peerNeedsBurst nach dem peeren gesetzt werden. FHEM versucht dies automatisch beim Peeren zu erledigen. Siehe Hminfo Befehl 'models', um festzustellen, welche Devices welchen Modus unterstützen.

'''Attribut burstAccess'''

Devices, die abschaltbaren burst haben kann man ein attribut bustAccess 1_auto setzen. Es wird beim Abschicken eines Kommandos versucht, das Device mit burst zu wecken. Sollte es nicht funktionieren wird gewartet, bis das Device aufwacht (meist reagieren solche Devices auch auf wakeup). Das Setzen des Attributs ist angenehm – es werden aber ggf. viele bursts gesendet.

'''Kommando burstXmit'''

Mit diesem Kommando, das bei Devices mit contitional-Burst zu Verfügung steht, wird der burst gezielt von User angestossen.

Der User schickt erst seine Kommandos an das device. Die Kommandos werden im Command-stack gesammelt.

Dann sendet der User ein set burstXmit.

Es passiert das gleiche wie bei burstAccess.

FHEM versucht mittels burst zu wecken und sendet bei Erfolg die Messages aus dem Kommandostack.

Im Gegensatz zu burstAccess ist burstXmit gezielt einsetzbar und kann sparsamer verwendet werden.

''' FHEM und burst devices'''

FHEM sendet eine burst automatisch mit Kommandos zu Devices, die nur burst unterstützen.

'''So aktiviert man den burst-Betrieb am HM-CC-RT-DN'''

''Burst Mode einschalten'' (der Kanal 4 des Device WZ1 heisst hier WZ1_4)
:<code>set WZ1_4 regSet burstRx on </code>
prüfen mit:
:<code>get WZ1_4 reg burstRx </code>
''Nun in FHEM den Burst mode einschalten (sofern nicht burstXmit verwendet wird)''
:<code>attr WZ1 burstAccess 1_auto</code>

Hinweis: Das Attribut im Device und nicht im Kanal setzen, ansonsten gibt es eine Fehlermeldung.

=== Temperaturlisten ===
Die Temperaturlisten des HM-CC-RT-DN werden identisch mit denen anderer HomeMatic Thermostate verwaltet, siehe <u>[http://www.fhemwiki.de/wiki/HomeMatic_Type_Thermostat#Temperaturlisten|HomeMatic Type Thermostat]</u>. Beim HM-CC-RT-DN ist der Kanal 4 (_Clima) für die Temperaturlisten zuständig.

==Fhem-Log==
In den folgenden Logs heißt Kanal 4 noch "_ClimRT_tr". Inzwischen würde man dort "_Clima" sehen.

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

== Firmware Update ==
Seit 24.10.2014 gibt es für den HM-CC-RT-DN die neue Firmware Version 1.4. Diese kann von der eQ-3 Webseite heruntergeladen werden. Genauere Informationen gibt es unter [[HomeMatic_Firmware_Update]]

=== HM-CC-RT-DN spezifische Update Informationen ===
Durch gleichzeitiges Drücken der "Auto-/Manu"-Taste und der "Comfort-/Eco"-Taste am HM-CC-RT-DN während man die Batterien wieder einlegt wird der updatemodus gestartet. Während des Updates steht "FUP" im Display. Nach erfolgreichem Update erscheint "Ins" im Display und es muss eine erneute Adaptierfahrt durch drücken der Boost-Taste ausgelöst werden. Anschließend sollte der HM-CC-RT-DN wieder normal funktionieren. Die eingestellten Parameter und das Pairing mit FHEM gehen beim Update nicht verloren. Sollte das Update fehlschlagen, erscheint "Err" bzw. "CrC" im Display.

Normalerweise sollte dann durch erneutes starten der Prozedur am PC und HM-CC-RT-DN das ganze erneut durchführbar sein.

Es gibt einige Readings, die nicht durch ein einfaches ''getConfig'' aktualisisert werden, z.B. "battery"(nicht batteryLevel). Um diese Readings zu bekommen, ist ein
:<code>set Device_Channel04 controlMode auto </code>
notwendig. Daraufhin werden die Readings übertragen/aktualisiert.

== Simulation von Fensterkontakten und externen Temperatursensoren ==
grober Ablauf:
* erstellen ein virtuelles Device
* erstelle dazu einen virtuellen Kanal
* peeren den Kanal mit dem RT (als fenster-kontakt oder als remote, wen du willst)
* sende ein postEvent

=== Fensterkontakte ===
''Entnommen aus diesem {{Link2Forum|Topic=31078|Message=236245|LinkText=Forenbeitrag}}''
define virSC CUL_HM 221133
attr virSC autoReadReg 4_reqStatus
attr virSC expert 2_full
attr virSC model virtual_1
attr virSC peerIDs
attr virSC subType virtual
attr virSC webCmd press short:press long

define virtualKitchenDoor CUL_HM 22113301
attr virtualKitchenDoor dummy 1
attr virtualKitchenDoor expert 1
attr virtualKitchenDoor group Virtual
attr virtualKitchenDoor model virtual_1
attr virtualKitchenDoor webCmd postEvent open:postEvent closed

Anschließend peeren und Temperatur festlegen mit:
set virtualKitchenDoor peerChan 0 <Thermostat_Window_Rec> single set
set <Thermostat_Window_Rec> regSet winOpnTemp 5 virtualKitchenDoor

Die virtuelle Tür wird dann dann entsprechend über ein Notify getriggert:
define notify_virtualKitchenDoor notify (Fensterkontakt_1|Fensterkontakt_2) {if(Value("Fensterkontakt") eq "open" && Value("Fensterkontakt_2") eq "open"){fhem("set virtualKitchenDoor postEvent open")}else{fhem("set virtualKitchenDoor postEvent closed")}}

=== Temperatursensoren ===
''Entnommen aus diesem {{Link2Forum|Topic=19686|Message=233788|LinkText=Forenbeitrag}}''

1. Virtuelles HomeMatic Device mit _deiner_ HM Id definieren:
define wz_vT CUL_HM <hmId>

2. Dem Device einen virtuellen Kanal (Default ist ein virtueller Button) hinzufügen:
set wz_vT virtual 1

3. Es ist kein virtueller Button sondern ein virtueller Temperatursensor - darum rename:
rename wz_vT_Btn1 wz_vT_Sensor1

4. Virtuellen Peer Sensor mit dem Weather Channel des RT-DN peeren:
set wz_vT_Sensor1 peerChan 0 <RT_DN>_Weather single

5. Peering kontrollieren (Voraussetzung: Device ''hm'' vom Typ [[HomeMatic HMInfo|HMinfo]] existiert):
:<code>set hm peerXref</code>
Beispiel-Ausgabe:
peerXref done:
x-ref list
wz_Thermostat_Weather => wz_vT_Sensor1
wz_vT_Sensor1 => wz_Thermostat_Weather

6. Gemessene Temperatur vom z.B. 1-Wire DS1820 dem virtuellen HM Sensor übergeben. Z.B. alle zwei Minuten per at:
define at_wz_vT at +*00:02 { my $T=(ReadingsVal("<DS1820B>","temperature",20.0)); fhem "set wz_vT_Sensor1 virtTemp $T" }

Fertig.

== Bekannte Probleme ==
=== TempList: Bad format ... ===
Wenn Sie beim Setzen einer Temperaturliste nach dem o.a. Schema ("SetTempList...") die Meldung

Bad format, use HH:MM TEMP ......

erhalten, sollten Sie zunächst ein [[update]] von Fhem durchführen.

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

2014-05-11T19:27:53Z

Thomas.kregelin: /* Pairing lösen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Pairing per Befehl gelöst werden. Siehe dazu unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem HM-Gerät kann man mit:

set <Name HM-Gerät> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing lösen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebenen HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:17:51Z

Thomas.kregelin: /* Gezieltes Pairing */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Pairing per Befehl gelöst werden. Siehe dazu unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem HM-Gerät kann man mit:

set <Name HM-Gerät> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing lösen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebene HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:17:09Z

Thomas.kregelin: /* Pairing löschen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Pairing per Befehl gelöst werden. Siehe dazu unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing lösen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebene HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:16:53Z

Thomas.kregelin: /* Vorgehen bei Problemen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Pairing per Befehl gelöst werden. Siehe dazu unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing löschen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebene HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:14:25Z

Thomas.kregelin: /* Gezieltes Pairing */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Gerät zunächst per Befehl Entpairt werden. Dazu siehe unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing löschen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebene HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:13:18Z

Thomas.kregelin: /* Pairing löschen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Gerät zunächst per Befehl Entpairt werden. Dazu siehe unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebene HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:09:59Z

Thomas.kregelin: /* Vorgehen bei Problemen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ kann das Gerät zunächst per Befehl Entpairt werden. Dazu siehe unten.

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:07:49Z

Thomas.kregelin: /* Vorgehen bei Problemen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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.

Alternativ

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

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:03:24Z

Thomas.kregelin: /* IO-Device in den Pairing-Modus versetzen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:02:23Z

Thomas.kregelin: /* IO-Device in den pairing Modus versetzen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

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

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:02:04Z

Thomas.kregelin: /* IO-Device in den pairing Modus versetzen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

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

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T22:01:47Z

Thomas.kregelin: /* IO-Device in den pairing Modus versetzen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:58:05Z

Thomas.kregelin: /* HMLAN in den pairing Modus versetzen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= IO-Device in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:57:19Z

Thomas.kregelin: /* Grundlagen */

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:56:07Z

Thomas.kregelin:

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben ist. Es empfiehlt sich daher, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:54:22Z

Thomas.kregelin:

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät nicht mit FHEM, sondern mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei vergeben (am Gerät eingestellt) werden kann, sondern für jedes Gerät fest vorgegeben ist. Daher empfiehlt es sich, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:53:49Z

Thomas.kregelin:

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM gepairt werden, damit sie angesprochen werden können. Genau genommen wird das Gerät mit dem IO-Device (zB CUL, CUN, HMLAN) gepairt.

Das Pairing funktioniert anders als bei FHT Devices, da die Adresse eines HomeMatic Gerätes nicht frei vergeben (am Gerät eingestellt) werden kann, sondern für jedes Gerät fest vorgegeben ist. Daher empfiehlt es sich, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:51:27Z

Thomas.kregelin:

Im Gegensatz zu FS20 Komponenten müssen HomeMatic Geräte mit FHEM, genau genommen mit dem IO-Device (zB CUL, CUN, HMLAN), gepairt werden, damit sie angesprochen werden können. Das Pairing funktioniert anders als bei FHT Devices, da die Adressen der HomeMatic Geräte nicht frei vergeben (am Gerät eingestellt) werden können, sondern für jedes Gerät fest vorgegeben ist. Daher empfiehlt es sich, die Geräte per ''autocreate'' Funkton anlegen zu lassen, und den ''define'' Befehl nicht manuell in die fhem.cfg einzutragen.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:48:16Z

Thomas.kregelin: /* Grundlagen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:42:18Z

Thomas.kregelin: /* Pairing verifizieren */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:38:58Z

Thomas.kregelin: /* Pairing verifizieren */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>. Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID 0xF11034 stehen.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:32:24Z

Thomas.kregelin: /* Devices pairen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:31:09Z

Thomas.kregelin: /* HMLAN in den pairing Modus versetzen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:30:24Z

Thomas.kregelin: /* Grundlagen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:29:19Z

Thomas.kregelin: /* Grundlagen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices (CUL) mit der in das HM-Gerät geschriebenen HMID, das Gerät steuern. Hinzu kommt, dass die FHEM-autocreate Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit derselben HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:25:02Z

Thomas.kregelin: /* Grundlagen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein Gerät einer Zentrale zugeordnet. Wenn ein Gerät mit der Zentrale gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die Adresse der Zentrale (hmId) in das Gerät geschrieben. Die Adresse der Zentrale ist die jeweilige HMID des IOs (HMLAN, CUL,...). Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte die Zentralen nur anhand der HMIDs unterscheiden, können alle in Reichweite der HM-Geräte befindlichen IOs (CUL), die mit der in das HM-Gerät geschriebenen HMID konfiguriert sind, das HM-Gerät steuern. Hinzu kommt, dass die FHEM autocreate Funktion die in Reichweite befindlichen HM-Geräte finded und automatisch einbindet. Nachbarn mit der gleichen HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T21:24:03Z

Thomas.kregelin: /* Grundlagen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch Pairing wird ein Gerät der Kontrolle einer Zentrale unterworfen. Wenn ein Gerät mit der Zentrale gepairt ist, kann man es darüber steuern und konfigurieren.

Beim Pairing wird die Adresse der Zentrale (hmId) in das Gerät geschrieben. Die Adresse der Zentrale ist die jeweilige HMID des IOs (HMLAN, CUL,...). Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte die Zentralen nur anhand der HMIDs unterscheiden, können alle in Reichweite der HM-Geräte befindlichen IOs (CUL), die mit der in das HM-Gerät geschriebenen HMID konfiguriert sind, das HM-Gerät steuern. Hinzu kommt, dass die FHEM autocreate Funktion die in Reichweite befindlichen HM-Geräte finded und automatisch einbindet. Nachbarn mit der gleichen HMID können also gepairte Geräte sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu Individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T20:50:22Z

Thomas.kregelin: /* Pairing verifizieren */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch Pairing wird ein Gerät der Kontrolle einer Zentrale unterworfen. Nur wenn ein Gerät gepair ist, kann man es von der Zentrale aus steuern und konfigurieren.
Beim Pairing wird in das Device des Geräts die Adresse (HMID) der Zentrale geschrieben. Die Adresse der Zentrale ist die jeweilige HMID des IOs (HMLAN, CUL,...). Das pairen ist findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.
Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die hmId des <CUL>.

Ist das Pairing noch nicht abgeschlossen, kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder:
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HomeMatic Devices pairen

2014-05-10T20:48:11Z

Thomas.kregelin: /* Vorgehen bei Problemen */

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.

Zuerst [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch Pairing wird ein Gerät der Kontrolle einer Zentrale unterworfen. Nur wenn ein Gerät gepair ist, kann man es von der Zentrale aus steuern und konfigurieren.
Beim Pairing wird in das Device des Geräts die Adresse (HMID) der Zentrale geschrieben. Die Adresse der Zentrale ist die jeweilige HMID des IOs (HMLAN, CUL,...). Das pairen ist findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.
Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

Achtung: Nach dem Pairing kann das Device nicht mehr selbst peeren - das übernimmt nun die Zentrale

= HMLAN in den pairing Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen, dazu set-Kommando beim CUL/CUNO/HMLAN eintragen:

set HMLAN hmPairForSec 600

600 bedeutet hier, dass FEHM 600 Sekunden = 10 Minuten im Pairingmodus ist. Solange im hmPair: 1 steht ist der Pairingmodus aktiv.
Alternativ kann

set HMLAN hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM wird nun
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde heißt '''nicht''' dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

Ist das pairing noch nicht vollständig. Dann kann man getConfig aufrufen. Wenn es danach immer noch dort steht hat das pairing '''nicht''' geklappt. Man kann entweder
* probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn ein Gerät nicht paired ist es möglich, dass es schon gepairt ist, mit einer anderen Zentrale. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft 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 Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> 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.

= Gezieltes Pairing =
Bei bereits bekanntem FHEM Device <name> kann man mit:

set <name> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon eine Zentrale eingetragen ist.

= Pairing löschen =
Pairing kann von der eingetragenen Zentrale mit :

set <name> unpair

gelöscht werden.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T12:17:57Z

Thomas.kregelin: /* Funktionen */

'''HomeMatic HM-WDS100-C6-O Funk-Wetterstation außen'''
Homematic Wetterstation für die Messung von Temperatur, relative Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.
== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

===Funktionen===
Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_MyUtils anlegen:

(Abgeleitet von einer Funktion zur Mittelwertberechnung unter : [http://www.fhemwiki.de/wiki/Relative_Mittelwerte_berechnen_und_loggen])

<nowiki>
# myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
}
</nowiki>

Danach in der fhem.cfg Folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>
define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
}
</nowiki>

Dann können die Werte mit dem openweathermap Modul übertragen werden:

<nowiki>
...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...
</nowiki>

== Probleme ==
Bisher keine.

== FHEM Config-Auszug ==
<<< folgt >>>

== FHEM Log-Auszug ==
== Links ==
http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf

http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf
[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtigkeitssensor]]
[[Kategorie:Temperatursensor]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T12:16:58Z

Thomas.kregelin: /* Funktionen */

'''HomeMatic HM-WDS100-C6-O Funk-Wetterstation außen'''
Homematic Wetterstation für die Messung von Temperatur, relative Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.
== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

===Funktionen===
Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_MyUtils anlegen:

(Abgeleitet von einer Funktion zur Mittelwertberechnung unter : [url]http://www.fhemwiki.de/wiki/Relative_Mittelwerte_berechnen_und_loggen[/url] )

<nowiki>
# myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
}
</nowiki>

Danach in der fhem.cfg Folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
}</nowiki>

Dann können die Werte mit dem openweathermap Modul übertragen werden:

<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

== Probleme ==
Bisher keine.

== FHEM Config-Auszug ==
<<< folgt >>>

== FHEM Log-Auszug ==
== Links ==
http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf

http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf
[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtigkeitssensor]]
[[Kategorie:Temperatursensor]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T12:16:15Z

Thomas.kregelin:

'''HomeMatic HM-WDS100-C6-O Funk-Wetterstation außen'''
Homematic Wetterstation für die Messung von Temperatur, relative Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.
== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

===Funktionen===
Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_MyUtils anlegen:

(Abgeleitet von einer Funktion zur Mittelwertberechnung unter : [url]http://www.fhemwiki.de/wiki/Relative_Mittelwerte_berechnen_und_loggen[/url] )

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
}</nowiki>

Danach in der fhem.cfg Folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
}</nowiki>

Dann können die Werte mit dem openweathermap Modul übertragen werden:

<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

== Probleme ==
Bisher keine.

== FHEM Config-Auszug ==
<<< folgt >>>

== FHEM Log-Auszug ==
== Links ==
http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf

http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf
[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtigkeitssensor]]
[[Kategorie:Temperatursensor]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T11:54:41Z

Thomas.kregelin: /* Links */

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T11:53:49Z

Thomas.kregelin:

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-16T11:53:04Z

Thomas.kregelin:

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2013-09-15T23:06:01Z

Thomas.kregelin: Die Seite wurde neu angelegt: „'''HomeMatic HM-WDS100-C6-O Funk-Wetterstation außen''' Homematic Wetterstation für die Messung von Temperatur, relative Luftfeuchte, Windrichtung, Windstär…“

'''HomeMatic HM-WDS100-C6-O Funk-Wetterstation außen'''
Homematic Wetterstation für die Messung von Temperatur, relative Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.
== Features ==
* Batteriebetrieb (4 x AA)
* Für Temp. von -20 °C bis +80 °C
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

== Probleme ==
Bisher keine.

== FHEM Config-Auszug ==
<<< folgt >>>

== FHEM Log-Auszug ==
== Links ==

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtigkeitssensor]]
[[Kategorie:Temperatursensor]]