FHEMWiki - Benutzerbeiträge [de]

VELUX Rolladen steuern

2026-04-04T07:28:56Z

LHBL2003: Link zu einem YouTube Video, wo gezeigt wird wie man Mehrere Rollos ansteuern kann mit wenig Hardware. Passend zum Thema.

'''Achtung, Seite ist total veraltet'''

Unbedingt lesen: [[KLF200]]

==Vorwort==
Wird ein VELUX Rollladen neu eingebaut und man hat die Absicht diesen mit FHEM zu steuern so sollte zwingend darauf geachtet werden KEINE Steuerbox (zb. KLF-100) anzuschließen. Auch nicht mal zu testen. Hat der Rollen einmal solche Steuerbox erkannt, schaltet er intern auf diesen Steuerbox-Modus um und ist nicht mehr per Polumschaltung steuerbar!

Ist der Rollladen noch per Polumschaltung steuerbar, so kann hier weitergelesen werden

Es gibt mehrere Möglichkeiten einen VELUX Rollladen mit einem Homematic Rollladenaktor zu schalten, um diesen damit in FHEM zu integrieren
==Homematic HM-LC-Bl1PBU-FM auf 24VDC umbauen==
Diese Modifikation ist [https://forum.fhem.de/index.php/topic,35802 hier] sehr gut erklärt.

==Homematic HM-LC-Bl1PBU-FM In Verbindung mit Relais==
Möchte mal keine Lötaktionen am Rollladenaktor vornehmen, so ist evtl. diese Variante interessant. Allerdings benötigt man zusätzlichen Platz für einen Unterputz Schaltschrank.
Es wird ein 24VDC Hutschienennetzteil mit entsprechender Leistung benötigt. Es muss mindestens 1A pro Rollladen bereitstellen. Z.B. bei 3 Rollläden eignet sich das 4,2A 24DVC Modul sehr gut. Es belegt 6TE im Schaltschrank. Pro Rollladen benötigt man zwei 230V 4fach Wechsler Koppelrelais. Von diesen 4 Wechslern je Relais werden 3 benötigt: 2 Stück für +/- Pol, 1 Stück für die Steuerung des 24VDC Netzteils

Beim Einbau in eine Unterputzverteilung bietet sich folgendes Relais aufgrund geringer Tiefe an:<br>
''Phoenix Contact 2903304 RIF Monostabiles Relais für DIN-Schienen, 230Vac Spule, 4-poliger Wechsler 5 A / 250Vdc''

Die 2 Phasen des Rollladenaktors steuern nun je ein Relais an.
Die Wechsler Ausgänge Relais werden nun wie folgt verdrahtet:

Relais für Hochfahrt
* Wechsler 1: IN: + Pol Netzteil, OUT: Pol 1 des Rollladens
* Wechsler 2: IN: - Pol Netzteil, OUT: Pol 2 des Rollladens
* Wechsler 3: IN: 230V Phase, OUT: 230V Stromzufuhr des Netzteils

Relais für Runterfahrt
* Wechsler 1: IN: + Pol Netzteil, OUT: Pol 2 des Rollladens
* Wechsler 2: IN: - Pol Netzteil, OUT: Pol 1 des Rollladens
* Wechsler 3: IN: 230V Phase, OUT: 230V Stromzufuhr des Netzteils

Man sieht, es sind lediglich die Ausgänge des Rollladen vertauscht.
Wichtig ist, dass beide Relais NICHT gleichzeitig angezogen sind. Das verursacht einen 24V Kurzschluss.
Der HM Rollladenaktor stellt dies aber sicher. Er wird NIE eine Hoch- und Runterfahrt initiieren.

Hat man mehrere Rollläden, so ist pro Rollladen identisch zu verfahren.

==Lernfahrt initiieren==
Fährt der Rollladen nicht komplett herunter oder hoch, so hilft ev. eine erneute Lernfahrt. Diese kann wie folgt initiiert werden:
* Rollladen komplett herunter fahren
* 3x kurzen Runterfahr-Impuls geben
* Jetzt Dauerstrom zum Herunterfahren geben

Nun sollte der Rollladen erst hoch, dann wieder herunterfahren, jetzt aber bis zum Anschlag - der eigentlichen und korrekten Endposition.

Je nach Ausgangslage kann es erforderlich sein, den dreifachen Runterfahr-Impuls sowie den anschließenden Dauerstrom zum Herunterfahren nicht bei ganz geschlossenem Rollladen abzusetzen, sondern beispielsweise auf halber Strecke.

==Mögliche Probleme bei Nutzung von mehreren Rollläden an einem Netzteil==
Es besteht der Verdacht, das die Rollläden untereinander kommunizieren. Wurden weitere Rollläden erkannt, so kann es zu Störungen kommen bis dahin, das die Rollläden die Fahrt verweigern.
Dazu ist lediglich jeweils dicht am Rollladen ein zb. 220uF Elko an beiden Polen parallel anzuschließen.

Siehe auch: Mehrere VLUX SML Rollo mit einem 24 Volt Hutschienen Netzteil Ansteuern https://youtu.be/LGG70vniB9g

==Links==
* [https://forum.fhem.de/index.php/topic,60451.15/ FHEM Thread zur Initiierung einer Lernfahrt]
* [https://forum.fhem.de/index.php/topic,35802 FHEM Thread zur Modifikation eines HM-LC-Bl1PBU-FM für 24VDC]
* [http://www.chrysophylax.de/prj/W010/W010.htm Eine Bauanleitung "from Scratch" mit ein paar nützlichen Erklärungen]
[[Kategorie:Rollladensteuerung]]

FHEM Connector für Amazon Alexa

2023-01-07T22:01:44Z

LHBL2003: Alexa Namen durch Komma trennen statt Strichpunkt.

{{Baustelle}}
'''Alexa FHEMlazy''' war historisch ein Fork des Original [[Alexa-Fhem|alexa-fhem]], der im Januar 2019 mit dem Original zusammengeführt wurde und nun als '''FHEM Connector''' verfügbar ist.

Er ermöglicht innerhalb von Minuten die Verknüpfung von FHEM mit einem Amazon Echo Gerät. Auch Geräte anderer Hersteller mit verbauten Mikrofonen und Alexa-Sprachassistenten-Unterstützung sollten problemlos funktionieren. Für folgende Geräte ist dies bspw. der Fall (Falls Ihr andere/weitere Gerätemodelle bzw. Hersteller in Verwendung habt, bitte hier pflegen):

* SONOS Beam und SONOS One

Gegenüber dem klassischen Ansatz ergeben sich Einschränkungen, so läuft die Software normalerweise unter dem gleichen Benutzer wie FHEM auf dem gleichen Server, und es wird z.Zt. nur der Smarthome-Skill unterstützt (die Variante, bei der die Möglichkeiten der Interaktion von Amazon festgelegt wurden).
Dafür ist weder ein Developer-Account bei Amazon, eigene Lambda- und Skillfunktionen, noch das Öffnen eines eingehenden Ports aus dem Internet nötig.
* Die Software integriert einen Installer, der die Erstkonfiguration und Anmeldung übernimmt
* Die Kommunikation zur Software auf dem heimischen Rechner und dann zu FHEM verläuft über SSH und einen vom FHEM-Verein gehosteten Server
* Funktioniert mit IPv4, IPv6, echtem Dual Stack und DS-Lite
* Als Skill bei Amazon wird der Skill "FHEM Connector" verwendet.

Der Thread im Forum zur Software ist hier: {{Link2Forum|Topic=94817}}.

{{Infobox Modul
|ModPurpose=Einfache Anbindung von FHEM an Amazon Assistent Alexa
|ModType=h
|ModCmdRef=alexa
|ModTechName=39_alexa.pm / alexa-fhem
|ModForumArea=Frontends/Sprachsteuerung
|ModOwner=gvzdus, André/ justme1968 ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:Justme|Wiki]])
}}

==Einführung==

===Arbeitsweise und Datenfluss===
Vorläufig ist alexa-fhem im "FHEM Connector-Modus" ein reiner [https://developer.amazon.com/de/docs/smarthome/understand-the-smart-home-skill-api.html SmartHome-Skill].
SmartHome-Skills erhalten weder die Sprachdaten selber noch das, was Amazon in Textform verstanden hat, sondern vielmehr extrahiert Amazon aus dem verstandenen Text Anweisungen und Abfragen für Geräte, die dann an den Skill übermittelt werden. Charmant ist dabei, dass unmittelbar gefragt werden kann "Alexa, wie ist die Temperatur im Wohnzimmer?", während andere Skills zunächst explizit angesprochen werden müssen ("Alexa, frage FHEM nach der Temperatur im Wohnzimmer"). Außerdem kann der Nutzer mehrere Smarthome-Skills installieren, und die Geräte werden zu einer Gesamtmenge zusammengefasst.

Gehen wir den Datenfluss bei der konkreten Frage "Wie ist die Temperatur im Wohnzimmer?" durch:
* Alexa hat bei der Skillinstallation gelernt, dass "FHEM Connector" bei Dir einen Thermostaten im Raum Wohnzimmer kennt. Dadurch wird bei der Sprachanalyse von "Alexa Voice Service" in der Cloud erkannt, dass eine Abfrage an "FHEM Connector" erfolgversprechend ist.
* Zunächst wird die zentrale "Lambda-Funktion" von "FHEM Connector" aufgerufen. Die Funktion leitet aber im Kern nur den Request unverändert an den vom Verein bereitgestellten Server weiter. Im Request enthalten ist ein Token, das sogenannte "Bearer-Token".
* Der "Vereinsserver" prüft anhand dieses Tokens, ob es überhaupt bekannt ist, und zu welchem Nutzer es gehört. Ist dieser Nutzer verbunden, wird der Request wiederum quasi unverändert an den Nutzer weitergeleitet.
* Diese Weiterleitung passiert über einen sogenannten SSH-Reverse-Tunnel, der von Deiner Seite und der Software auf dem FHEM-Tunnel automatisch aufgebaut wird.
* Auf Deiner Seite läuft die eigentliche Software, und zwar unter nodeJS. nodeJS ist ein Javascript ausführender Miniserver, der lokal auf einem Zufallsport auf Requests "lauscht". In der Original-Version [[Alexa-Fhem|Alexa FHEM]] kommen die Requests aus dem Internet (hoffentlich von der eigenen Lambda-Funktion), hier bei "FHEM Connector" kommen sie ausschließlich aus dem SSH-Tunnel von lokal.
* Die Software validiert nun diesen Request anhand des Bearer-Tokens. Konkret wird dabei das bei der Installation generierte Token, dass bei der Skill-Aktivierung an Amazon übertragen wurde, mit dem lokal gespeicherten Wert verglichen. Stimmt das Token, wird der Befehl verarbeitet, üblicherweise wird hierbei ein Aufruf an die Webschnittstelle von FHEM abgesetzt.
* FHEM führt den Befehl aus

Hört sich langsam und kompliziert an? Kompliziert: Okay. Langsam eher nicht, in etlichen Fällen liegt die Gesamtantwortszeit unter 200 ms.

Soweit ein erster Überblick über die Datenflüsse. Im Abschnitt Sicherheit ist das Konzept der Absicherung deutlich genauer und ausführlicher beschrieben.

==Installation==

Du wirst bei der Installation zuerst auf der Kommandozeile auf Deinem Raspberry (o.ä.) unterwegs sein, anschließend im Webfrontend von FHEM, und zum Schluss auf der Alexa-Konsole im Web.

===node.js installieren===

Ab Jessy liegt NodeJS bereits in einer ausreichend aktuellen Version vor (Stretch und Buster funktionieren ebenfalls). Mit

<syntaxhighlight lang="bash" style="width:50%;">
sudo apt-get install nodejs npm
</syntaxhighlight>

kannst Du es installieren. Mit
<syntaxhighlight lang="bash" style="width:50%;">
node --version
</syntaxhighlight>

erfährst Du die aktuelle Version - wenn hier etwas mit "8" oder höher vorneweg erscheint, ist alles gut.
Ansonsten suche Dir bitte eine Anleitung im Web, wie Du NodeJS auf Deinem System auf einen aktuellen Stand bringen kannst.

'''Anmerkung:''' diese Aussage bzgl. node-Version (und Jessie/Stretch) stimmt wohl für alexa-fhem Stand heute (12.06.2020) nicht mehr, siehe https://forum.fhem.de/index.php/topic,112025.msg1063218.html#msg1063218

=== Alexa-FHEM installieren ===

Nun installieren wir Alexa-fhem aus dem offiziellen Repository:

<syntaxhighlight lang="bash" style="width:50%;">
sudo npm install -g alexa-fhem
</syntaxhighlight>

Der Vorgang benötigt etwas Zeit.

=== Alexa-FHEM aktivieren ===

Wechsele jetzt in FHEM-Web!

Wichtig ist, dass das Alexa-Modul in der Version ab Januar 2019 vorliegt. Dafür bitte einmal FHEM aktualisieren:
Speichern der Config nicht vergessen, und

<syntaxhighlight lang="bash" style="width:50%;">
update
shutdown restart
</syntaxhighlight>

Alles, was jetzt noch nötig ist, ist das Anlegen eines Alexa-Devices. Gib dafür in der FHEM-Web-Kommandozeile

<syntaxhighlight lang="bash" style="width:50%;">
define alexa alexa
</syntaxhighlight>

an. Nun läuft, während Du bereits das neu angelegte Alexa-Devices siehst, ein komplexer Prozess im Hintergrund:

* Falls noch kein SSH-Key für den Benutzer, unter dem FHEM läuft, existiert, wird einer generiert
* Es wird ein Secret-Key im Prozess generiert, dass den Server nicht verlässt, und der Skillanmeldung dient.
* Du wirst auf dem Server "va-fhem.fhem.de" des FHEM-Vereins mit dem SSH-Key angemeldet, und der Hash-Wert Deines Secret-Key dort abgelegt.

Und wenn Du diese Sätze gelesen hast, sollte inzwischen sich das Alexa-Device in FHEM-Web aktualisiert haben, und
ungefähr so aussehen:

[[Datei:Alexa-Device-2.png|800px]]

Neben dem Status für alexa-fhem und der Proxyverbindung ist wichtig, dass diese beiden Zeilen beim Reload aufgetaucht sind:

<syntaxhighlight lang="bash" style="width:90%;">
alexaFHEM.bearerToken crypt:...
alexaFHEM.skillRegKey crypt:...
</syntaxhighlight>

Ja, und diesen Schlüssel benötigst Du wirklich! Also am besten schon einmal mit

<syntaxhighlight lang="bash" style="width:90%;">
get <alexa> proxyKey
</syntaxhighlight>

in Klartext anzeigen lassen und in ein Editor-Fenster dauerhaft wegsichern.

Jetzt solltest Du Dein Alexa-Device nicht mehr löschen, denn das im Reading angezeigte "bearerToken" zu löschen bedeutet, dass die Software die Zugriffe von nicht mehr überprüfen kann und keine Kommandos mehr funktionieren. In diesem Fall hilft nur die Neuinstallation des Skills.

==== Fehler bei der Aktivierung ====

Während kompliziertere Fehlerfälle im Abschnitt "Mögliche Probleme und Lösungen" behandelt werden, hier häufige Fälle, warum die kryptischen Zeilen nicht auftauchen:

* Zuerst bitte einfach einmal die Seite neu laden.

===== 401: Authorization Required =====

Wenn Du FHEM-Web mit einem User/Passwort-Schutz versehen hast, wirst du folgende Fehlermeldung sehen:

<syntaxhighlight lang="bash" style="width:90%;">
alexaFHEM stopped; failed to connect to fhem: 401: Authorization Required
</syntaxhighlight>

In der Regel musst du die Angaben User/Passwort noch einmal explizit setzen. Im Attribute-Abschnitt "alexaFHEM-auth" auswählen, User/Passwort mit ":" getrennt angeben und "attr" anklicken. alexa-fhem wird automatisch neu gestartet. Hier das Ganze in der Text-Variante:

<syntaxhighlight lang="bash" style="width:90%;">
attr alexa alexaFHEM-auth user:pass
</syntaxhighlight>

===== Permission denied =====

Wenn du folgende Fehlermeldungen im Alexa Logfile siehst, wurde das Verzeichnis "/opt/fhem/.ssh/" von dir bei der Arbeit mit "root" oder "sudo" mit den falschen Berechtigungen versehen:

<syntaxhighlight lang="bash" style="width:90%;">
[2019-7-25 11:59:12] sshautoconf: aborted with ssh-keygen returned error - key_save_private: Permission denied
[2019-7-25 11:59:12] *** SSH: proxy configuration failed: ssh-keygen returned error - key_save_private: Permission denied
</syntaxhighlight>

Prüfen kannst du die Berechtigungen mit folgendem Befehl auf der Shell-Konsole:

<syntaxhighlight lang="bash" style="width:90%;">
ls -l /opt/fhem/.ssh
</syntaxhighlight>

Du solltest dann folgende Ausgabe erhalten:

<syntaxhighlight lang="bash" style="width:90%;">
insgesamt 12
-rw------- 1 fhem dialout 1675 Jul 12 13:10 id_rsa
-rw-r--r-- 1 fhem dialout 391 Jul 12 13:10 id_rsa.pub
-rw-r--r-- 1 fhem dialout 884 Jul 12 13:10 known_hosts
</syntaxhighlight>

Steht in der Ausgabe nicht "fhem dialout" (dein fhem User), sondern bspw. "root root", dann bspw. mit folgendem Befehl an deinen fhem User anpassen:

<syntaxhighlight lang="bash" style="width:90%;">
chown fhem:dialout /opt/fhem/.ssh
</syntaxhighlight>

Mit dem ersten Befehl "ls -l ..." kannst du dann nochmal prüfen, ob die Berechtigungen korrekt übernommen wurden.

===== weitere Prüfungen =====

Hast Du noch die Shell-Konsole offen? Dann prüfe bitte noch einmal auf der Konsole, ob nun zwei Prozesse laufen:

<syntaxhighlight lang="bash" style="width:50%;">
ps -ef | egrep '(alexa|ssh)'
</syntaxhighlight>

sollte Dir idealerweise so etwas anzeigen:
<syntaxhighlight lang="bash" style="width:90%;">
fhem 31322 1 99 13:56 ? 00:00:03 alexa
fhem 31332 31322 8 13:56 ? 00:00:00 /usr/bin/ssh -R 1234:127.0.0.1:<zufälliger port> -oServerAliveInterval=90 -p 58824 fhem-va.fhem.de
</syntaxhighlight>

"alexa" ist dabei der Node-JS-Prozess, der ssh-Prozess ist die aufgebaute Verbindung zum Vereinsserver.

Wenn Du diese Prozesse '''nicht''' siehst oder das Alexa-Device keinen Registrierungskey anzeigt, dann ist leider der Start nicht glatt verlaufen.

Im Logfile (über den link <code>Logfile</code> in der Detail-Ansicht über <code>set</code>, oder über den Namen bei ''currentlogfile'' in den Internals) findest Du idealerweise selber Hinweise, wo es hakt, oder kannst im Forum nachfragen.

=== Geräte im FHEM-Webfrontend zuweisen ===
Um das Aha-Erlebnis zu vergrößern, ist jetzt ein guter Zeitpunkt, 1 oder besser mind. 2 Geräte für den Alexa-Dienst zuzuweisen. Von Haus aus wird keines Deiner FHEM-Geräte automatisch Alexa zugewiesen!

Wähle die Geräte aus, rufe sie auf und setze das Attribut "alexaName". Hierbei in Kürze nur der Hinweis:
* Keine Angst vor Leerzeichen und Umlauten, funktioniert.
* Große Angst vor Rechtschreibfehlern (Terrasse, Rollladen) oder komplizierten Wörtern "handgebastelte Martinslaterne im Kinderzimmer Iphigenie-Chantal".
* Mehrere Namen für dasselbe Gerät/Device in fhem werden unterstützt. Mehrere Namen werden durch <s>Strichpunkt</s> Komma getrennt<ref>Feature nicht dokumentiert {{Link2Forum|Topic=74041|LinkText=Forumsthread}}</ref>.
* Das Attribut "alexaRoom" ist NUR FÜR DEN CUSTOM SKILL relevant. Ausnahme: structure und LightScene Devices, siehe: [[FHEM_Connector_f%C3%BCr_Amazon_Alexa#Was_geht_alles_.3F]].

Lade die Geräte neu in die Software, indem Du <code>set <alexa> restart</code> ausführst!
[[Datei:HowToSet alexaName.png|alternativtext=How to set alexaName|ohne|mini|Wie setzt man das Attribut alexaName]]

'''Anmerkungen (weil oft gestellte Fragen im Forum) bzgl. Erkennung von Geräten:'''

* Wichtig ist, dass die Filtereinstellung in der alexa-fhem.cfg (zu finden unter "Edit Files") passt.
Das, was dort eingetragen ist (Standard: alexaName=..* / also es ist ein alexaName vergeben) auch an den entsprechenden Devices in fhem vorhanden ist.
Stimmt das nicht überein, kann alexa-fhem keine Devices von fhem abfragen/finden.
Ob der Filter entsprechend funktioniert kann man wie folgt testen: ''list Filtereinstellung'' beispiel mit Standardfilter: ''list alexaName=..*''

* Hat alexa-fhem per Filter Devices aus fhem "gefunden", geht es weiter mit der "Erkennung". Also um welches Device (Typ und "Fähigkeiten") handelt es sich. Dazu gilt folgendes:
** sind entsprechende Readings beim Device vorhanden (z.B. temperature, state mit on/off, ...) erkennt das alexa-fhem automatisch. Die Liste der automatisch erkannten Readings wächst ständig. Daher erst mal schauen ob das Device bereits entsprechend erkannt (typisiert) wurde. Das kann durch prüfen des alexa-fhem-Logs geschehen (NICHT fhem-log!).
** sind entsprechende "set-Befehle" erkennbar (oft auch durch Readings). Also ist beispielsweise (wie beim Dummy nötig) ein ''setList'' mit entsprechenden Einträgen vorhanden oder entsprechende Readings, z.B. desired-temp zum Stellen der Temperatur etc.
** wird das Device nicht richtig oder "unvollständig" erkannt helfen folgende Attribute:
*** genericDeviceType: hiermit kann alexa-fhem in die gewünschte Richtung "geschubbst" werden. Anmerkung: man kann nicht alles erzwingen, Readings bzw. set-Befehle müssen passen (oder per homebridgeMapping passend gemacht werden). Wenn ein genericDeviceType nicht per "Drop-Down" erscheint, dann kann er auch (wenn bekannt) einfach per WEB-cmd eingegeben werden: ''attr Devicename genericDeviceType media''
*** homebridgeMapping: hierdurch kann alexa-fhem bei der Erkennung von Zuständen und möglichen Einstellungen (also WAS kann das Device) unterstützt werden. Mittels homebridgeMapping können vorhandene Readings (Zustände) auf für alexa-fhem bekannte Zustände gemappt werden. Ebenso können damit Standard-fhem-Kommandos von alexa-fhem auf Device-spezifische gemappt werden. Beispiel: on/off auf Ein/Aus (falls das Device statt on/off eben ein Ein/Aus erwartet). Zum Beispiel: <syntaxhighlight lang="bash" style="width:50%;">
attr <thermostat> homebridgeMapping TargetTemperature=target::target,minValue=18,maxValue=25,minStep=0.5 CurrentTemperature=myTemp:temperature
</syntaxhighlight> [https://github.com/justme-1968/homebridge-fhem/blob/master/README.md weitere Beispiele]

<br>'''Mehrere Namen für dasselbe Gerät/Device in fhem sind möglich.'''<br>
Die Namen werden durch <s>Strichpunkt</s> Komma getrennt.<br>
Beispiel:<br>
<code>attr dmLampe alexaName Lichtkuppel,Lichtkugel</code>

'''Anmerkung bzgl. genericDeviceType und homebridgeMapping:'''<br>
* diese Attribute werden von verschiedenen "Sprachsteuerungsmodulen" in fhem verwendet (homebridge [dort wurde es "erfunden"], alexa-fhem, gassistant, ...). Daher ist nicht jedes Mapping für alle "Dienste" verwendbar. Ausprobieren schadet aber nicht.
* ebenso kann man mit diesen Attributen (homebridgeMapping wird gerne so "missbraucht") nichts erzwingen, was seitens Amazon/Alexa nicht unterstützt bzw. verstanden wird! D.h. zunächst ist zu prüfen, ob ein bestimmter (gewünschter) Sprachbefehl seitens Amazon/Alexa unterstützt wird! Aktuelles Beispiel (Stand Jan 2020): "Alexa, fahre den Rollo hoch/runter". Da ist Amazon/Alexa gerade dabei etwas zu tun. Bislang wird das nicht unterstützt, also ist das auch mit einem entsprechenden homebridgeMapping nicht zu erzwingen! Was unterstützt wird kann man bei Amazon nachlesen: [https://developer.amazon.com/es-ES/docs/alexa/device-apis/list-of-interfaces.html]

== Finale: Skill verknüpfen ==
Suche im WebFrontend oder der Alexa-App den Skill "FHEM Connector". Für nicht-Mac/iOS Anwerder empfiehlt das WebFrontend (https://alexa.amazon.de) statt die App, damit Du den Anmeldeschlüssel auch bequem kopieren kannst.

Wenn du noch nicht bei Amazon angemeldet bist, erwartet Amazon zunächst, dass Du Dich normal bei Amazon anmeldest.

Sobald Du "FHEM Connector" aktivierst, öffnet sich ein Browser-Tab mit folgender Maske:<br />
[[Datei:FHEMlazy_login.png|240px]]

Hier kopierst Du Deinen Anmeldeschlüssel (im Klartext!) hinein und klickst auf Check. Als glücklicher Mensch ist auf der folgenden Statusseite alles grün:<br />
[[Datei:FHEMlazy_check.png|240px]]

Im Einzelnen wird hier geprüft, ob Du per SSH verbunden bist (und auch Deine IP zur Sicherheit angezeigt), ob der Reverse-Tunnel steht, ob nodeJS erreichbar ist und wie viele Geräte Alexa gleich finden sollte (in meinem Fall 22).

Sollte etwas nicht grün sein und Du eine Idee zum Fixen haben, kannst Du mit "Retry" neue Versuche auslösen.

Ist alles okay, klicke rechts den Button "Activate Skill". Du springst damit wieder zurück zu Amazon, die Dir hoffentlich zur erfolgreichen Verknüpfung gratulieren.

Amazon möchte nun unmittelbar die Gerätesuche starten, und unter SmartHome-Geräte sollten diese nun auftauchen.

== Was geht alles ? ==

* Geräte, die sich ein- und ausschalten lassen:
** Automatisch: Müssen <code>set on</code> und <code>set off</code> Kommandos haben
** dummys müssen <code>setList</code> mit on und off haben
** Über <code>genericDeviceType</code> switch bzw. light kann bestimmt werden ob es in alexa als Schalter oder Licht behandelt wird.
** Wenn die Set-Kommandos im FHEM Device anders benannt sind: homebridgeMapping On:cmdOn=<ein>,cmdOff=<aus> setzen
** Kommandos:
***Alexa, schalte <name> ein/aus
***Alexa, Licht an/aus
***Alexa, schalte <gruppe> ein/aus
* Geräte, die eine Temperatur messen
** Automatisch: Es muss ein Reading <code>temperature</code> geben
** Über <code>genericDeviceType</code> thermometer
** Sonst: homebridgeMapping CurrentTemperature:reading=<reading>

* Geräte, deren Helligkeit sich ändern lässt
** Automatisch: wenn <code>dim</code> oder <code>pct</code> Kommandos erkannt werden
** Über <code>genericDeviceType</code> light
** Über homebridgeMapping: Wenn <code>helligkeit</code> das Reading für die aktuelle Helligkeit enthält und die Helligkeit mit <code>set <device> prozent xxx</code> gesetzt wird, sieht das homebridgeMapping wie folgt aus: homebridgeMapping Brightness=helligkeit::prozent,minValue=0,maxValue=<maximalwert>
** Kommandos:
*** Alexa, mache <name> heller/dunkler
*** Alexa, Licht heller/dunkler
* Geräte, deren Farbe sich ändern lässt
** ...

* Geräte, deren Farbtemperatur sich ändern lässt
** ...

* Geräte, bei denen sich eine Lautstärke einstellen lässt
** ...

* Geräte, bei denen sich ein prozentualer Wert einstellen lässt
** Automatisch: wenn <code>dim</code> oder <code>pct</code> Kommandos erkannt werden
** ...

* elektrische Türschlösser
** <code>genericDeviceType</code>: lock
** homebridgeMapping mit LockCurrentState und LockTargetState

* Thermostate
** Über <code>genericDeviceType</code> thermostate
** ...

* structure Devices aus FHEM (ab alexa-fhem version 0.5.7)
** können mit <code>genericDeviceType</code> scene als Szene eingebunden werden
** über <code>alexaRoom</code> kann der name um einen Ort ergänzt werden
** Szenen aus einer structure lassen sich ein- und ausschalten
** Wichtig:
*** Ein Skill darf nur 12 Szenen automatisch erkennen und einbinden.

* LightScene Devices aus FHEM (ab alexa-fhem version 0.5.8)
** können mit <code>genericDeviceType</code> scene als Szenen eingebunden werden
** über <code>alexaRoom</code> kann der name um einen Ort ergänzt werden
** Szenen aus einer LightScene lassen sich nur einschalten
** Wichtig:
*** Ein Skill darf nur 12 Szenen automatisch erkennen und einbinden.

* Geräte, deren Kanal sich umschalten lässt (ab alexa-fhem version 0.5.13)
** Über <code>genericDeviceType</code> media
** homebridgeMapping ChannelController:reading=<reading>,cmd=<cmd>
** Erlaubte Werte siehe hier: https://developer.amazon.com/de/docs/device-apis/alexa-channelcontroller.html#changechannel
** ...

* Geräte, deren Playback status sich schalten lässt (ab alexa-fhem version 0.5.13)
** Über <code>genericDeviceType</code> media
** homebridgeMapping PlaybackController:playback,values=Play;Pause;Stop;Previous;Next
** Erlaubte Werte siehe hier: https://developer.amazon.com/de/docs/device-apis/alexa-playbackcontroller.html#discovery
** ...

* Geräte, deren Eingang sich umschalten lässt (ab alexa-fhem version 0.5.13)
** Über <code>genericDeviceType</code> media
** homebridgeMapping InputController:reading=<reading>,cmd=<cmd>,values=HDMI+1;HDMI+2;XBOX
** Erlaubte Werte siehe hier: https://developer.amazon.com/de/docs/device-apis/alexa-property-schemas.html#input
** ...

* Kontaktsensoren (ab alexa-fhem version 0.5.15)
** Über <code>genericDeviceType</code> contact
** homebridgeMapping ContactSensorState:reading=<reading> oder CurrentDoorState:reading=<reading>
** Die Anzeige in der Alexa-App funktioniert sofort, die Abfrage per Sprache erst ab Version 0.5.27.

* Geräte, deren Lautstärke sich ändern lässt (ab alexa-fhem version 0.5.24)
** Über <code>genericDeviceType</code> speaker
** Automatisch: es muss ein Reading <code>volume</code> und/oder <code>mute</code> geben
** homebridgeMapping Volume:reading=<reading>,cmd=<cmd> Mute:reading=<reading>,cmd=<cmd>
** ...

* Geräte, die sich ein- (und optional) ausschalten lassen als Szene (ab alexa-fhem version 0.5.26)
** Über <code>genericDeviceType</code> scene
** Automatisch: Müssen <code>set on</code> und <code>set off</code> Kommandos haben
** homebridgeMapping On:reading=<reading>,cmdOn=<cmd>[,cmdOff=<cmd>]
** Hinweis: Fehlende Kommandos lassen sich mit cmdalias erzeugen
** Wichtig:
*** Ein Skill darf nur 12 Szenen automatisch erkennen und einbinden.
* Rollläden. Lange ein Problemthema, das nur mit "Schalte auf 0%, schalte auf 100% lief". Wichtig: "alexa-fhem" ab Version 0.5.39 einsetzen. GenericDevice-Type auf "blind" setzen. Nach Restart von alexa-fhem und neuer Gerätesuche sollte folgendes funktionieren:
** "..., öffne <Name> ganz"
** "..., schließe <Name> komplett"
** "hoch" und "runter" (ohne "ganz" oder "komplett") schalten jeweils nur einen bestimmten Prozentsatz hoch oder runter. Dieser kann mit <code>attr <name> homebridgeMapping TargetPosition:minStep=<wert></code>geändert werden. Aber Achtung: In diesem Intervall kann dann auch nur noch ein absoluter Prozentwert per Sprache oder Slider eingestellt werden! Bei z.B. 25% würden 13% zu 25% aufgerundet, 12% zu 0% abgerundet werden.
* Kontaktsensoren (ab alexa-fhem version 0.5.47)
** Automatisch wenn ein Reading <code>motion</code> vorhanden ist oder es sich um einen Zigbee bewgungsmelder an einer HUE oder deCONZ Bridge handelt
** Über <code>genericDeviceType</code> MotionSensor
** homebridgeMapping MotionDetected:reading=<reading>,values=<wert für bewgung>:1;<wert für keine bewegung>:0

* Alarmmelder (noch nicht in Deutschland):
** genericDeviceType Security
** homebridgeMapping Alarm=<reading>[,type=[fireAlarm|waterAlarm|burglaryAlarm|carbonMonoxideAlarm]]
** wenn der type nicht angegeben wird ist fireAlarm der default
** automatisch werden 0, ok und alles was mit no anfängt als OK erkannt. alles andere gilt als ALARM.
*Geräte mit mehrstufigen Modi:
**siehe den zugehörigen Thread im Forum: {{Link2Forum|Topic= 125604}}

Es werden noch einige andere häufig verwendete Geräte (Homematic, hue,...) automatisch erkannt.

to be continued ...

In der [https://developer.amazon.com/docs/device-apis/list-of-interfaces.html List of Capability Interfaces] bei Amazon kann man sehen, welche Möglichkeiten das Smart Home Skill API aktuell in einzelnen Ländern bietet. Leider ohne die jeweiligen landessprachlichen Kommandos.

=== Aktiv Routinen starten ===
Routinen (eine Funktionalität, die rein - genauso wie "Räume" - bei Amazon liegt und nicht von FHEM Connector beeinflusst wird) waren lange die ewige Antwort auf die Frage: "Meine Frau möchte aber '''Öffne Rollläden''<nowiki/>' sagen": In der Alexa-App gibt es im Menü den Punkt "Routinen", und hier lässt sich eine gewisse Anzahl von Aktionen (unter optionalen Bedingungen) an ein Sprachkommando knüpfen.

Neu: Routinen können inzwischen auch von Skills getriggert werden, und seit Version 0.5.47 (Februar 2020) auch von FHEM Connector. Das braucht niemand, um die Rollläden hochzufahren, denn das kann FHEM ja selber, aber um z.B. eine Ansage auf einem Alexa-Gerät zu triggern. Dafür gibt es auch das FHEM-Modul "echodevice", aber es erfordert ein paar Klimmzüge. Mit dem aktiven Triggern von Routinen kann FHEM auslösen, dass Alexa ungefragt (!) Dinge wie

''"Die Temperatur in der Tiefkühltruhe hat -16 Grad überschritten"''

in den Raum sagt. Also eine Alternative bzw. Ergänzung zu Alarmen / Erinnerungen per Telegram o.ä.

'''Vorgeschichte''':

Die Smarthome-Skill-API von Amazon sah schon lange das "proactiveReporting" vor: Also z.B. die gemessene Temperatur nicht erst auf Anfrage hin zu übermitteln, sondern laufend aktiv zu pushen. Aber warum Daten an Amazon senden, wenn es dafür keinen Mehrwert gibt? Beim Öffnen z.B. des Thermostaten in der Alexa-App kommen ohnehin laufend Statusabfragen. Warum also einen Datenpool bei Amazon über die Haustemperatur aufbauen und Änderungen pushen, wenn es keinen Mehrwert dafür gibt?

Inzwischen lassen sich (reale oder vermeintliche) Änderungen von ''Bewegungssensoren'' und ''Fensterkontakten'' als Startbedingung an Alexa-Routinen koppeln. Man kann in der Alexa-App (ggf. fiktive) Öffnen eines Fensterkontaktes an das Aufsagen eines freien Textes durch die Hausbutlerin knüpfen.

'''Umsetzung''':
* Jedes Alexa-Device, dessen Status aktiv zu Amazon gepusht werden soll, im Attribut "alexaProactiveEvents" mit einer "1" versehen. Per Default wird ''kein'' Gerät laufend aktiv zu Amazon gepusht!
* das geänderte Device einmal zu Amazon pushen "set <alexa> add <device>" (oder 'Alexa, suche neue Geräte' murmeln)
* Das Gerät sollte jetzt beim Anlegen einer neuen Routine ("Neue Routine", "Wenn Folgendes passiert", "Smart Home") als möglicher Triggerpunkt erscheinen.

==== Dummygeräte: ====
Ein Dummydevice sollte einen Kontaktschalter oder Bewegungssensor simulieren, um dann in FHEM eine beliebige Bedingung als Trigger zu definieren, und eine freie Ansage in Alexa als Routine zu definieren. Hier ein Beispiel:

<syntaxhighlight lang="bash" style="width:90%;">
define voicetrigger1 dummy
attr voicetrigger1 alexaName alle Fenster
attr voicetrigger1 alexaProactiveEvents 1
attr voicetrigger1 genericDeviceType contact
attr voicetrigger1 homebridgeMapping ContactSensorState=state,values=closed:CONTACT_DETECTED;open:CONTACT_NOT_DETECTED
attr voicetrigger1 setList open closed

set alexa add voicetrigger1
set alexa restart
</syntaxhighlight>

'''Fehlersuche:'''

Der Push setzt ein intaktes Push-Token voraus. Sollte im Alexa-Logfile Folgendes erscheinen:

<code>failed to refresh token: invalid_grant: 'The request has an invalid grant parameter : refresh_token'</code>

so ist das Push-Token nicht aktuell. Weil die Auswirkung lange nur war, dass Geräteänderungen nicht aktiv an Amazon gemeldet wurden, gibt es noch keine umfassende Analyse des Problems. Es lässt sich lösen, indem eine oder beide folgenden Aktionen ausgeführt werden:
* Löschen des ".eventToken" im Alexa-Device über "deletereading"
* "FHEM-Connector"-Skill auf "alexa.amazon.de" einmal deaktivieren und dann neu verbinden

== Mögliche Probleme und Lösungen ==

Es kann vorkommen, dass Geräte zwar korrekt erkannt werden, aber das durch Alexa erkannte Kommando nicht richtig umgesetzt wird (Beispiel - mittlerweile behoben: {{Link2Forum|Topic=96766}}). Neben dem FHEM-Log gibt es noch das Logfile, welches von alexa-fhem angelegt wird.

=== Fehlersuche über die FHEM-Oberfläche ===

* alexa-fhem Logfile anschauen (Detail-Ansicht des <alexa>-Device aufrufen, klick auf '''Logfile''' oben)
* alexa-fhem im Debug-Modus aufrufen:
** -D zum alexaFHEM-params attribut hinzufügen
** Alexa-Befehl auslösen
** -D aus dem alexaFHEM-params attribut entfernen
* Die notwendigen Informationen finden sich in dem alexa-Logfile (siehe oben)

=== Fehlersuche über Kommandozeile (lies: Shell) + FHEM-Oberfläche ===

:* set <alexa> stop (FHEM-Oberfläche)
:* Auf der Kommandozeile <code>alexa-fhem -D -c /opt/fhem/alexa-fhem.cfg > debug.log</code> starten (dadurch wird die Datei debug.log erzeugt im aktuellen Verzeichnis)
:* Alexa-Befehl auslösen
:* alexa-fhem auf der Kommandozeile wieder stoppen (CTRL-C)
:* set <alexa> start (FHEM-Oberfläche)

Die Datei debug.log sollte Hinweise enthalten, wie das Problem zu lösen ist oder Dich zumindest in die richtige Richtung schieben.

Im Beispiel aus dem Forum fand sich in dem Logfile der Hinweis darauf, dass das Device mit falschen min/max-Werten unterwegs war.

=== Registrierungskey vergessen, Registrierung zurücksetzen ===

Auf der Kommandoshell:

<syntaxhighlight lang="bash" style="width:90%;">
pi@raspberrypi:~# sudo -u fhem ssh -p 58824 fhem-va.fhem.de status
Registered.
Registered on 2019-01-13T15:38:13Z.
</syntaxhighlight>

heisst, das der Vereinsserver eigentlich alles hat, was er will. Es wird kein neuer Schlüssel generiert.
Wenn Du die Situation zurücksetzen möchtest, wäre die hässliche Methode, Deinen SSH-Key zu löschen. Eleganter ist, die Registrierung auf Vereinsseite zu löschen:

<syntaxhighlight lang="bash" style="width:90%;">
pi@raspberrypi:~# sudo -u fhem ssh -p 58824 fhem-va.fhem.de unregister
Your registration has been removed
</syntaxhighlight>

löscht Deinen Schlüssel mitsamt allen dort gespeicherten Daten auf Vereinsseite. Bei Restart von alexa-fhem in FHEM-WEB wird jetzt ein neuer Registrierungskey angefordert.

== Sicherheitskonzept und Secrets ==

Um diesen Abschnitt zu verstehen, solltest Du den Abschnitt "Arbeitsweise" im Kopf haben. Einerseits ist Dir vermutlich einleuchtend, dass ein Server, der per SSH rückwärts nur ausgewählte Kommandos in den Tunnel, den Du aufgebaut hast, leitet, "irgendwie sicherer" ist. Andererseits möchte man nicht blind vertrauen.

=== SSH ===
==== SSH - macht das nichts Gefährliches? ====
SSH ist ein Veteran des Internet und entstand, um sich sicher (verschlüsselt) und schnell auf Servern einzuloggen. Schon früh wurde dabei der sogenannte "Reverse-Tunnel" implementiert: Also der vom Client (Deinem Rechner) geäußerte Wunsch: "Bitte leite mir Requests, die bei Dir, Server, auf Port xy eingehen, an meinen lokalen Port yz weiter.". Dieses Verfahren implementiert der Reverseproxy, wobei tatsächlich auf dem Server für Dich kein echter Port geöffnet wird.

Wie Dir ggf. sicher der Unix-Guru Deines Vertrauens bestätigen wird: Die Kombination
<syntaxhighlight lang="bash" style="width:50%;">
ssh -R 1234:localhost:<zufälliger port> zielserver
</syntaxhighlight>
erlaubt keine Ausführung von Shell-Kommandos auf Deinem Server, sondern einzig, dass vom SSH-Programm Verbindungen zu einem lokalen Port auf Deinem Server auf dem alexa-fhem lauscht aufgebaut werden. Du kannst also z.B. mit einem
<syntaxhighlight lang="bash" style="width:50%;">
sudo /usr/sbin/tcpdump -X -s 0 -i lo port <zufälliger port>
</syntaxhighlight>
vollständig überwachen (oder ggf. permanent aufzeichen), was auf Deinem Server von außen gesteuert passiert.

==== Wie wird bei SSH verschlüsselt? ====
Im Prinzip wie im Web auf SSL-Seiten, teils mit den gleichen Verschlüsselungsverfahren. Allerdings arbeitet SSH eher wie das im Web recht seltene Verfahren: Bei jeder Verbindung übermitteln sowohl Server wie auch Client den öffentlichen Teil ihres Schlüssels. Anders als im Web wird der Schlüssel aber nicht von einer öffentlichen Zertifizierungsstelle wie "LetsEncrypt" unterschrieben. Stattdessen entscheiden Server wie Client beim ersten Verbindungsaufbau typischerweise per manueller Frage: "Willst Du jetzt und künftig diesem Schlüssel vertrauen?" Bei der Installation wird diese Frage für Deine Seite bejaht, und fortan wird der öffentliche Schlüssel des FHEM-Servers auf Deinem Rechner gespeichert. Ab da bist Du z.B. davor sicher, dass jemand den DNS-Eintrag verbiegt oder sich in den Datenfluss Deines Providers einhängt: Ein geänderter Serverschlüssel würde bemerkt werden.
<br />
Soweit klar? Aus Deinem öffentlichen Schlüssel wiederum leitet der Server her: "Das ist definitiv wieder derjenige, der sich damals "registriert" hat". Und an dieser Stelle kann ich auch den <b>ersten Teil des 3-teiligen Registrierungskeys</b> erläutern: Die typischerweise 6-stellige Hex-Zahl am Anfang ist der Java-Hashcode Deines öffentlichen Schlüssel. Sie ist damit sozusagen Deine aus Deinem öffentlichen Schlüssel abgeleitete Benutzer-ID.

=== Die Rolle der Secrets ===
Wenn jetzt klar ist, dass die Verbindung zum Vereinsserver sicher und vertauschungsfrei funktioniert, bleiben noch 2 Probleme zu lösen:
1) Im Web bei der Skill-Aktivierung musst Du beweisen, dass Du der Mensch am Browser bist, dem der SSH-Tunnel von IP xy mit dem öffentlichen Schlüssel X gehört. Bei der automatischen Registrierung werden lokal auf Deinem Rechner zwei 64-Bit-Secrets generiert:
* Das <b>Anmelde</b>-Secret
* Das <b>Bearer</b>-Token
Beim Anmelden des SSH-Keys auf dem öffentlichen Server wird nun der <b>Hashwert</b> des ersten Secrets übertragen und dort in Verbindung mit Deinem öffentlichen Schlüssel gespeichert. Ein Hashwert bedeutet, dass (sofern das Verfahren, hier SHA256, funktioniert), niemand aus dem Hash das Secret zurückrechnen kann. Ein Datenbankklau auf dem Server gefährdet also nicht die Sicherheit Deines Passwortes.

Wenn Du nun beim Skill-Aktivieren den Registrierungskey eingibst, dann "sieht" der Server zum ersten Mal Dein ausgewürfeltes Secret, vergleicht es mit dem Hashwert und wird es anschließend wieder umgehend vergessen. Anhand des Hashwertes kann der Server aber entscheiden, dass Du der legitime Nutzer zum öffentlichen Schlüssel XY bist.

2) Das zweite Problem ist: Wie soll Amazon "beweisen", dass sie der legitime Aufrufer sind? Amazon erhält binnen wenigen Sekunden nach dem Klick auf "Activate Skill" den <b>dritten Teil</b> des Registrierungskeys als sogenanntes Bearer-Token. Zwar läuft er durch den Registrierungsserver, er wird dort, auf dem Registrierungs/Vereinsserver aber nicht gespeichert. Das Bearer-Token wird von Amazon bei allen Requests zu Deinem Server mitgesendet. Da es am Anfang zusätzlich Deine "User-ID" enthält, weiß der Vereinsserver, zu welchem SSH-Tunnel der Request zu senden ist. Aber lokal auf Deinem Rechner wird ausgewertet, ob das Token "stimmt".

== alexa-fhem Updaten bzw. "Upgraden" ==

'''Updaten einer "Connector" Installation:'''
* alexa-fhem über FHEM anhalten (Name des Alexa-Device: alexa):
:<syntaxhighlight lang="perl" style="width:50%;">set alexa stop</syntaxhighlight>

*Auf der Konsole wie anfangs bei der Installation:
:<syntaxhighlight lang="bash" style="width:50%;">sudo npm update -g alexa-fhem</syntaxhighlight>

:Manchmal hat npm Probleme mit einem Update. Dann einfach die aktuelle Version noch mal drüber Installieren:

:<syntaxhighlight lang="bash" style="width:50%;">sudo npm install -g alexa-fhem</syntaxhighlight>

*alexa-fhem über FHEM wieder starten:
:<syntaxhighlight lang="perl" style="width:50%;">set alexa start</syntaxhighlight>

'''"Upgraden von einer "Nicht-Connector" Installation (z.B. manuelle Installation per pm-Download):'''
* Daten der aktuellen Installation sichern (v.a. config.json / man weiß ja nie)
* Autostart der aktuellen alexa-fhem Installation deaktivieren:
** Bei initd: Service deaktivieren mittels: <code>sudo update-rc.d -f alexa remove</code> Vorher mittels stoppen: <code>sudo service alexa stop</code> Startscript unter /etc/init.d/ löschen.
** Bei systemd: Service deaktivieren mittels: <code>sudo systemctl disable alexa</code> Vorher mittels stoppen: <code>sudo systemctl alexa stop</code> Startscript unter /etc/systemd/system/ löschen.
* ALLE vorhandenen alexa-fhem Daten LÖSCHEN! Bleiben Dinge zurück und wird dann laut Connector installiert kann es zu Problemen kommen!
* (reboot)
* Installation von alexa-fhem laut Anleitung (Beginn dieses Wiki)
* Falls eigene Dinge von früher genutzt werden wollen/sollen (z.B. Custom Skill), dann die entsprechenden Einträge aus der gesicherten config.json in die neu angelegte alexa-fhem.cfg (zu finden unter "Edit files") übernehmen.
* Werden keine eigenen Dinge verwendet, dann kann der Port (Standard: 3000) geschlossen werden und auch die Daten unter Amazon-Developer können gelöscht werden.

== Bug- und Wunschliste ==
* Ist beim Start keine Internetverbindung vorhanden, erfolgt kein Retry -- alexa-fhem muss restartet werden (ssh_autoconfig wertet keine temporären Fehler aus)

==Weitergehende Informationen==
*[[Alexa und Mappings]]
*[[Alexa Tipps und Kniffe]]
*[[FHEM Connector for Amazon Alexa]]
[[Kategorie:HOWTOS]]
[[Kategorie:Sprachsteuerung]]

==Hinweise==
<references />

EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais

2022-10-23T16:20:09Z

LHBL2003: Hinweis das die Konfiguration auch für das FSR14SSR Model funktioniert, hierzu gibt es aktuell keinen eigenen Wiki Beitrag, da dieses Modul auch nicht recht günstig und gebraucht selten zu bekommen ist.

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Empfänger, Aktor und Sender, Sensor
|HWCategory=EnOcean
|HWComm=Eltako RS485-Bus
|HWChannels=4 Schaltkanäle (bidirektional)
|HWVoltage=230V~
|HWPowerConsumption=Standby: 0,1W, alle Kanäle geschlossen: 0,7W
|HWPoweredBy=12VDC
|HWSize=1 Teilungseinheit = 18mm breit, 58mm tief
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

'''EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais''' (FSR14) ist ein Aktor
* für:
** Montage auf Hutschiene
* angesteuert (bidirektional) über
** den Eltako RS485-Bus
***Anschlussklemmen RSA und RSB
* für
** 4 Schalt-Kanäle mit je 4A maximaler Schaltstrom (1000W Glühlampen)

== Features ==
Schaltrelais (bidirektional)

== Hinweise zum Betrieb mit FHEM ==
siehe auch [[EnOcean-Eltako-RS485-Bus]]

=== Definition/Anlernvorgang ===
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Die Einbindung in FHEM kann entweder über die Nutzung der inoffiziellen, gerätespezifischen EEP (empfohlen) '''oder''' über die manuelle Vorgehensweise erfolgen.

===== Nutzung der inoffziellen EEP =====
Im nachfolgenden wird 1 Aktor Ausgang eingelernt und muss für Ausgang 2 bis 4 wiederholt werden. Zudem Funktioniert dieses vorgehen auch beim FSR14SSR Model.

* Beim Definieren wird zunächst der FHEM-Device <name> (hier: EnOcean_switch_FSR14_A01) für Ausgang 1 mit dem inoffiziellen EEP für den FSR14 (M5-38-08) erstellt. Die Beispielhafte HEX Adresse (hier: 00000016) ist die Adresse des FSR14-Kanals welche z.B. über die Software PCT14 vergeben wurde. Z.B. "Adr. 16-19, V1.1, Beschreibung" Bei einem FSR-14-4x werden bei der Adressvergabe 4 aufeinanderfolgende Adressen vergeben. z.B. Adresse 16-19. Die Definition des Devices erfolgt über die Eingabe in das [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] definieren. Beipiel für alle vier Devices Device 1-4 für Ausgang 1-4 erstellen:
: <code>define EnOcean_switch_FSR14_A01 EnOcean 00000016 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A02 EnOcean 00000017 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A03 EnOcean 00000018 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A04 EnOcean 00000019 M5-38-08</code>
: Hierdurch wird jeweis ein FHEM-Device mit fast allen notwendigen Attributen für den FSR14 angelegt.
: Folgende Attribute werden der folständigkeit noch je Device benötigt (für A01-A04):
: Verhindert das massige Schreiben in Logfiles:
: <code>attr EnOcean_switch_FSR14_A01 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A02 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A03 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A04 event-on-change-reading .*</code>
: Adresse definieren, mit welcher FHEM seine anforderung für on/off Befehle sendet:
: <code>attr EnOcean_switch_FSR14_A01 subDef FF000016</code>
: <code>attr EnOcean_switch_FSR14_A02 subDef FF000017</code>
: <code>attr EnOcean_switch_FSR14_A03 subDef FF000018</code>
: <code>attr EnOcean_switch_FSR14_A04 subDef FF000019</code>
:
: Die Adresse <code>FF000016 bis FF000019</code> muss ebenso angepasst werden, es handelt sich um die Adresse mit welche sich FHEM beim EnOcean System authentifiziert. Siehe auch PTC14 -> ID-Zuordnungsbereich --> Spalte ID. Beispielsweise kann man hier die Hex ID mit FF beginnen lasse zur besseren Erennung und endet mit der Adress ID welche für die Kanäle 1 bis 4 vergeben wurden. z.B. 16 bis 19.
:
: Theach Method RPS festlegen, da man andernfalls die Rückmeldung / den Status in FHEM nicht erhält.
:<code>attr EnOcean_switch_FSR14_A01 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A02 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A03 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A04 teachMethod RPS</code>
:
:Ebenso muss das Attribut <code>comMode = confirm</code>gelöscht werden.
:<code>deleteattr EnOcean_switch_FSR14_A01 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A02 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A03 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A04 comMode</code>
* Nun muss der Aktor (der Ausgan 1 bis 4 eingelernt werden)
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter auf Kanal 1 stellen.
* FHEM Eingabefeld: <code>set EnOcean_switch_FSR14_A01 teach</code> die LEDs am Aktor hören auf zu blinken.
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position zurückstellen. (z.B. Mitte&Unten auf Auto)
* Den Vorgang für Kanal 2-4 wiederholen.
* Fertig

===== Alternative: manuelle Vorgehensweise =====
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Folgende Schritte sind für jeden Kanal durchzuführen:
* EnOcean-FHEM-Device <name> mit der Sender-ID des FSR14-Aktors definieren
* Die Attribute subType, gwCmd und manufID wie nachfolgend im Config-Auszug anlegen
* Das Attribut subDef mit einer freien Sender-ID des TCMs anlegen ODER falls keine freie Sender-ID bekannt ist, das Attribut komplett weglassen, damit die Vergabe automatisch durch FHEM erfolgt
* Am Aktor anlernen
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter den korrekten Kanal einstellen
** FHEM Eingabefeld: <code>set <name> teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
define EnOcean_switch_FSR14_A01 EnOcean 00000001 <- SenderID eines FSR14-Kanals (Aktor)
attr EnOcean_switch_FSR14_A01 subDef FF834381 <--- FF834381 ist eine der 127 Sender-ID's des TCM
attr EnOcean_switch_FSR14_A01 eep A5-38-08
attr EnOcean_switch_FSR14_A01 manufID 00D
attr EnOcean_switch_FSR14_A01 webCmd on:off
attr EnOcean_switch_FSR14_A01 gwCmd switching # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 subType gateway # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 event-on-change-reading .* # Verhindert das massige Schreiben in Logfiles
define FileLog_EnOcean_switch_FSR14_A01 FileLog ./log/EnOcean_switch_FSR14_A01-%Y.log EnOcean_switch_FSR14_A01
attr FileLog_EnOcean_switch_FSR14_A01 logtype text

=== Logbeispiel ===

== Einsatzbeispiel ==

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/BR14_datenblatt_FSR14-4x.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FSR14-4x_30014001-2_dt.pdf PDF]
* Forum: {{Link2Forum|Topic=25068|Message=181966}}

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

Hue

2021-12-28T21:51:37Z

LHBL2003: Verständlichkeit verbessert

<div style="float:right">{{Infobox Modul
|Name=HUEBridge
|ModPurpose=Anbindung Bridge des Philips Hue Lighting System
|ModType=d

|ModCmdRef=HUEBridge
|ModForumArea=Zigbee
|ModTechName=30_HUEBridge.pm
|ModOwner=Andre ([http://forum.fhem.de/index.php?action=profile;u=430 Forum] / [[Benutzer Diskussion:justme|Wiki]])
}}
{{Infobox Modul
|Name=HUEDevice
|ModPurpose=Ansteuerung Geräte des Philips Hue Lighting System über HUEBridge
|ModType=d

|ModCmdRef=HUEDevice
|ModForumArea=Zigbee
|ModTechName=31_HUEDevice.pm
|ModOwner=Andre ([http://forum.fhem.de/index.php?action=profile;u=430 Forum] / [[Benutzer Diskussion:justme|Wiki]])
}}
</div>

== HUE-Bridge ==
=== Einrichtung in FHEM ===
Die Einrichtung ist wirklich einfach. Mit
:<code>define Wiesollesheißen HUEBridge 192.168.0.123</code>
wird die Bridge eingebunden. (Die IP-Adresse gegen die der HUE Bridge ersetzen oder den DNS Namen.) Dann einfach auf den runden Knopf in der Mitte der Bridge drücken und sie wird von FHEM erkannt. Die drei Lampen des Starterkits werden automatisch erkannt und sind ansteuerbar -> fertig!

WICHTIG: danach in FHEM einmal die Konfiguration speichern damit der Pairing-Key gesichert wird. Sonst muss beim nächsten FHEM-Neustart das Pairing erneut durchgeführt werden.

Falls die Hue Bridge resetet wurde bleibt der Status auf "paired" und geht nicht mehr auf connected. Um das pairing erneut durchzuführen, muss das Attribut "key" gelöscht werden.

=== Nonblocking ===
Wenn man möchte, dass die Versuche, die HUEBridge zu kontaktieren, FHEM nicht blockieren, sollte man
:<code>attr <HUEBridge_Name> httpUtils 1</code>
setzen.

== HUE-Device ==
Als Gerät können alle Hue und LightLink kompatiblen Modelle verwendet werden, die sich an der Bridge anlernen lassen. Dies sind unter anderem:
*HueBulbs (E27, GU10, Lux, White, ...)
*Hue Beyond und Phoenix
*Friends of Hue LightStrips und LivingColors Bloom
*LivingColors ab gen2
*LivingColors Bloom, Iris und Aura
*LivingWhites Energiesparlampen
*LivingWhites Leuchtenadapter
*LivingWhites Bulbs
*[[HUE_Dimmer_Switch|Hue Tap und Hue Dimmer]] (mit Einschränkungen)
*dresden elektronik Vorschaltgeräte
*OSRAM LIGHTIFY Lampen (an der Hue Bridge angelernt)
*Müller Licht tint
*...

Diese sind jeweils über eine Bridge (HueBridge) steuerbar. Die LivingColors und LivingWhites Geräte sind vorher mit Hilfe einer LivingColors oder LivingWhites Fernbedienung an der Bridge anzulernen.

Es werden auch alle HUE Sensoren (Taster, Bewegungsmelder) unterstützt. Diese werden aber nicht per [[autocreate]] angelegt, sondern müssen manuell definiert werden. Hier ist auf ein passendes Polling-Intervall zu achten (siehe: [[HUE_Dimmer_Switch|HUE Dimmer Switch]]).

Sensoren (und Aktoren) lassen sich Konfigurieren (parameter Einstellen) und eigene Set- und Get- Kommandos im definieren.

=== Mögliche andere Gateways ===
HUEDevice Client-Devices können (mit leicht unterschiedlichem Funktionsumfang) auch mit den folgenden Gateways anderer Hersteller und dem zugehörigen Bridge-Device verwendet werden:
*[[Hue#RaspBee_.26_ConBee|RaspBee & ConBee mit deCONZ]] von Dresden Elektronik
** inklusive Push-API Erweiterung und Szenen
*[[TRÅDFRI| TRÅDFRI bzw. IKEA Home smart]]
** inklusive Rollos
*[https://github.com/bwssytems/ha-bridge HA-Bridge]
** inklusive aller [https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/Supported-Devices unterstützten Geräte] (Lampen, Sensoren, Thermostate, Rollos, ...)
** inklusive Update des HA-Bridge internen Gerätestatus per <code>habridgeupdate</code> Kommando
*[[ZigBee#Lightify_von_Osram|OSRAM LIGHTIFY Gateway]]

Das HUEBridge Modul erkennt, wenn ein Leuchtmittel zwischen einer Hue und einer deCONZ Bridge (oder umgekehrt) wechselt und verschiebt das zugehörige HUEDevice in FHEM jeweils zum richtigen Bridge-Device. D.h. wenn z.B. zum Firmwareupdate die Bridge gewechselt wird, ist auf FHEM Seite nichts weiter zu tun.

=== Grundlagen - Farbmodelle ===
Ein HueDevice kann per set-Befehl über unterschiedliche Farbmodelle gesteuert werden. In der folgenden Tabelle ist dargestellt, welche Werte-Kombinationen sinnvoll sind:
{| class="wikitable"
|-
! Farbmodell !! Bestandteile !! Beispiel
|-
| xyY || x- und y-Koordinate im Farbraum, Y ist die Helligkeit || <code> set bulb1 xy 0.4595,0.4105 : bri 220 </code>
|-
| hue,sat,bri || Farbwert, Sättigung und Helligkeit || <code> set bulb1 hue 14922 : sat 144 : bri 220 </code>
|-
| ct || Farbwert über Farbtemperatur || <code> set bulb1 color 2600 </code>
|-
| rgb || Farbbestandteile rot, grün und blau || <code> set bulb1 rgb FFC698 </code>
|}
'''Hinweis:''' Zur Regelung der Helligkeit sind die Befehle ''bri'' und ''pct'' gleichwertig. ''bri'' hat den Bereich 0..254, ''pct'' 0..100 .

Das Modul lässt die Mischung von Angaben aus unterschiedlichen Farbmodellen technisch zu, jedoch sind diese nicht immer sinnvoll.

'''HA-Bridge:''' In der HA-Bridge können virtuelle Devices definiert werden, welche in FHEM als ''Dimmable light'' eingebunden und verwendet werden können.

Zusätzlich zu den bereits beschriebenen set-Befehlen kann der Zustand der HA-Bridge-Devices mit Hilfe von ''habridgeupdate'' in Kombination mit ''on'', ''off'', ''pct'' und ''bri'' aktualisiert werden, ohne dass die HA-Bridge einen Schaltbefehl versendet. Beispiel: <code>set bulb1 habridgeupdate : on : pct 50</code> Details siehe: [https://github.com/bwssytems/ha-bridge#update-bridge-internal-light-state].

=== Darstellung im Webfrontend ===
Wenn man die SVG Icons verwendet, ist es sinnvoll, das Attribut color-icons zu setzen. Mit
:<code>attr HUEDevice1 color-icons 2</code>
werden z.B. die Farben und der Dimmzustand der Lampe als Icon dargestellt. Damit das ganze funktioniert, muss noch
:<code>attr WEB iconPath fhemSVG:openautomation:default</code>
gesetzt werden.

=== Spezielle Konfigurationsmöglichkeiten ===
Zur Syntax der nachfolgenden Attribute (für widgets) siehe {{Link2Forum|Topic=119298|LinkText=
Patchvorschlag im Forum}}
==== setList ====
Ermöglicht einen indirekten Zugriff auf den Befehl ''setsensor'' der HUEBridge.

Beispiele
* {{Link2Forum|Topic=118788|LinkText=
Eurotonics Spirit bzw. MOES Thermostat}}
* [https://forum.fhem.de/index.php/topic,11020.msg1192888.html#msg1192888 HueLabs Scene aus FHEM über die HUEBridge ein- und ausschalten]

==== configList ====
Ermöglicht einen indirekten Zugriff auf den Befehl ''configsensor'' der HUEBridge.

Beispiele
* {{Link2Forum|Topic=115102|Message=1093876|LinkText=Aqara motion sensor - duration}}
* {{Link2Forum|Topic=111887|Message=1064164|LinkText=Aqara vibration sensor - sensitivity}}

== RaspBee & ConBee ==
Das HUEBridge Modul unterstützt auch die ZigBee Gateway Module RaspBee und ConBee von Dresden Elektronik über die zugehörige deCONZ Software und die Wireless Light Control WebApp und die Phoscon WebApp (kommt zusammen mit deConz). Die hierzu erhältlichen Funk-Vorschaltgeräte sind noch nicht getestet, sollten aber auch funktionieren.

Im diesem {{Link2Forum|Topic=80985|LinkText=Forenbeitrag}} wird über Details der HUE Module diskutiert, die das deCONZ PushAPI über Websockets unterstützen (die entsprechenden Modulversionen sind mittlerweile regulär verfügbar). Sensoren müssen hier nicht mehr gepollt werden.

Mittlerweile funktioniert die Einbindung der RaspBee und ConBee Module auf einem sehr einfachen Weg. Dieser ist in diesem {{Link2Forum|Topic=95288|LinkText=Forenbeitrag}} zusammengefasst. Zusätzliche Plugins sind nicht mehr nötig.

=== Installation von deCONZ unter Proxmox auf einem Intel Nuc ===
Folgende Schritte sind notwendig, um unter Proxmox zu installieren:

* Installation einer Ubuntu oder Debian VM:
:<syntaxhighlight lang="bash">
cd /var/lib/vz/template/iso/
wget http://releases.ubuntu.com/18.04/ubuntu-18.04.2-desktop-amd64.iso
</syntaxhighlight>
:oder
:<syntaxhighlight lang="bash">
cd /var/lib/vz/template/iso/
wget https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-9.8.0-amd64-xfce-CD-1.iso
</syntaxhighlight>

* Weiterreichen des USB Devices in die VM:
: Auflistung der verfügbaren USB Geräte:
:<syntaxhighlight lang="bash">
root@node1:~# lsusb
Bus 002 Device 004: ID 0403:6015 Future Technology Devices International, Ltd Bridge(I2C/SPI/UART/FIFO)
Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
</syntaxhighlight>
:Der Conbee meldet sich als "Future Technology Devices International, Ltd Bridge(I2C/SPI/UART/FIFO)", hier ist die ID wichtig (0403:6015).
:Anschließend kann das USB Gerät an die VM weitergeleitet werden. Der Wert 804 ist durch die ID der VM zu ersetzen.
:<syntaxhighlight lang="bash">
qm set 804 -usb0 host=0403:6015
</syntaxhighlight>

* Installation von deCONZ:
:<syntaxhighlight lang="bash">
apt-get update && apt-get upgrade -y
wget http://www.dresden-elektronik.de/deconz/ubuntu/beta/deconz-2.05.60-qt5.deb
sudo dpkg -i deconz-2.05.60-qt5.deb
sudo apt install -f
sudo systemctl enable deconz
reboot now
</syntaxhighlight>

=== Installation von deCONZ unter Docker ===
https://hub.docker.com/r/marthoc/deconz/

=== Installation von deCONZ auf einem RaspberryPI ===
Für den ConBee2 [https://phoscon.de/en/conbee2/install#raspbian kann der guten Installation von Phoscon gefolgt werden]. Entweder ihr installiert deCONZ direkt (wie hier beschrieben) oder über einen Docker Container. Der Docker Container hat ein paar Einschränkungen bzgl. Firmware Updates.

Der ausführende Benutzer muss dialout Rechte haben um auf /dev/tty* zugreifen zu dürfen:
:<syntaxhighlight lang="bash">
sudo gpasswd -a pi dialout
</syntaxhighlight>
Im Standard wird deCONZ mit dem pi-Benutzer (user id 1000) ausgeführt.

Das deCONZ Repository bei APT hinzufügen (Vorteil davon ist dass später ganz normal mit sudo apt update/upgrade deCONZ aktualisieren könnt):
:<syntaxhighlight lang="bash">
wget -O - http://phoscon.de/apt/deconz.pub.key | \
sudo apt-key add -;
sudo sh -c "echo 'deb http://phoscon.de/apt/deconz \
$(lsb_release -cs) main' > \
/etc/apt/sources.list.d/deconz.list";
sudo apt update
</syntaxhighlight>

Mit der Einführung des Raspberry Pi 3 sind noch weitere Einstellungen notwendig. Diese sind hier: [[Raspberry Pi 3: GPIO-Port Module und Bluetooth|Raspberry Pi 3: GPIO-Port Module und Bluetooth – FHEMWiki]] ausführlich beschrieben.

deCONZ installieren:
:<syntaxhighlight lang="bash">
sudo apt install deconz
</syntaxhighlight>
Wenn ihr euren RaspberryPI mit UI betreibt, kann deCONZ über ''Menu > Programming > deCONZ'' aufgerufen werden. Es gibt aber auch den Service-Modus, der ohne X11 funktionert. Hierfür die Datei ''/lib/systemd/system/deconz.service'' anpassen (ich habe z.B. den Port des Webservers geändert) und den Service wie folgt aktivieren:
:<syntaxhighlight lang="bash">
systemctl enable deconz.service
</syntaxhighlight>

== HUE auf der Fritzbox ==
Da auf der FB standardmäßig kein JSON installiert ist, muss dies nachinstalliert werden: Man lädt das JSON-Paket http://search.cpan.org/CPAN/authors/id/M/MA/MAKAMAKA/JSON-2.53.tar.gz, packt es aus und kopiert den Inhalt vom <b>lib-Verzeichnis</b> nach \fhem\lib\perl5\site_perl\5.12.2

== HUE auf der Synology Diskstation ==
Da auf der DS standardmäßig kein JSON installiert ist, muss dies nachinstalliert werden, die Anleitung dazu {{Link2Forum|Topic=19093|Message=224641|LinkText=in diesem Forenbeitrag}}.

[[Kategorie:ZigBee]]
[[Kategorie:Lichteffektgeräte]]
[[Kategorie:IP Components]]

E-Mail senden

2021-12-11T15:44:35Z

LHBL2003: Beispiel für Mailversand mit Gmail über Terminal

Um aus FHEM heraus '''E-Mail senden''' zu können, sind abhängig von der verwendeten Platform unterschiedliche Vorgehensweisen erforderlich.
{{Randnotiz|RNTyp=y|RNText=Anleitung zur Einrichtung von Exim4 auf Debian mit GMX als Smarthost:[[Media:Anleitung_Exim4_Debian_GMX.pdf|PDF]]}}
== Linux ==
=== FritzBox 7170 (non-chroot) oder "reine" Linuxe ===
Datei 99_email.pm im Modul-Verzeichnis mit folgender Funktion anlegen (oder in bestehende 99_irgendwas.pm kopieren):
<syntaxhighlight lang="perl">
sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" | /usr/bin/mail send -i - -s \"$subject\" -t \"$rcpt\"");
}
</syntaxhighlight>
Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
Darauf achten, dass der fhem-User Mails senden darf (in richtige Gruppe eintragen. Ggf. vorher einmal su fhem und probieren).

=== Fritz!Box 7390 ===
Auf der [[AVM Fritz!Box|FritzBox 7390]] ist diese Funktion seit 10/2012 Bestandteil der FHEM Standardauslieferung. Sie ist untergebracht in FritzBoxUtils.pm und heisst dort FB_mail($$$) (Groß-Kleinschreibung beachten).

Da der Dateiname von FritzBoxUtils.pm nicht mit 99_ beginnt, wird diese Programmdatei nicht automatisch beim Start von FHEM geladen. FHEM muss zum Laden dieser Programmdatei aufgefordert werden. Dazu (z. B. in 99_myUtils.pm) die Zeile ''use FritzBoxUtils;'' einfügen.

Mit dem Install von AVM.de wird fhem in einer chroot-Umgebung ausgeführt, die den Zugriff auf die Mailfunktion der Fritzbox nicht zulässt. Daher muss FHEM in der [http://fhem.de/fhem.html#Download Version von fhem.de] installiert sein. Sollte Ihre Fritzbox bisher mit dem install von AVM laufen, kann (nach einem backup!) das image von fhem.de einfach drüberinstalliert werden. Es sollten dabei alle Einstellungen erhalten bleiben.

<syntaxhighlight lang="perl">
sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" > /var/tmp/fhem_nachricht.txt");
system("/sbin/mailer send -i '/var/tmp/fhem_nachricht.txt' -s \"$subject\" -t \"$rcpt\"");
system("rm /var/tmp/fhem_nachricht.txt");
}
</syntaxhighlight>

Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
bzw.
:<code>{ FB_mail('empfaenger@mail.de','Subject','text 123') }</code>

Dem Mailer können noch weitere Parameter hinzugefügt werden. Mehr dazu siehe: [http://www.wehavemorefun.de/fritzbox/Mailer Mailer]

=== OpenWRT ===
Die Anleitung wurde mit einer frühen Beta von Barrier Breaker (r391xx) mit einem TP_Lind WDR 4900 getestet. Da "sendEmail" nicht als Package vorliegt wird in dieser Anleitung "ssmtp" verwendet.
Die Installation erfolgt mittels:

<syntaxhighlight lang="bash">
opkg update
opkg install ssmtp_2.64-4_mpc85xx.ipk
</syntaxhighlight>

Hierbei werden die Pakete libopenssl und zlib mit installiert. Damit ssmtp funktioniert müssen die Dateien /etc/ssmtp/ssmtp.conf und /etc/ssmtp/revaliases angepasst werden.

/etc/ssmtp/ssmtp.conf
<syntaxhighlight lang="text">
root=arnold@gmx.net
mailhub=mail.gmx.net:465
rewriteDomain=gmx.net
hostname=gmx.net
FromLineOverride=YES
UseTLS=YES
#UseSTARTTLS=YES
AuthUser=arnold@gmx.net
AuthPass=Passwort_von_arnold@gmx.net
</syntaxhighlight>

/etc/ssmtp/revaliases
<syntaxhighlight lang="text">
root:arnold@gmx.net:mail.gmx.net:465
</syntaxhighlight>

In der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen (von der RPi-Anleitung übernommen):

<syntaxhighlight lang="perl">
sub OpenWRTMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "dockstar\@heye-tammo.de";
Log 1, "sendEmail RCP: $rcpt, Subject: $subject, Text: $text";
$ret .= qx(echo -e 'to:$rcpt\n from:$sender\nsubject:$subject\n$text\n' | ssmtp $rcpt);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}
</syntaxhighlight>

Ab hier den entsprechenden Abschnitt unter "Raspberry Pi" lesen.

=== Synology DiskStation ===
Beim DSM 3.2 gab es keinen <code>sendmail</code>-Befehl, sondern nur eine Funktion für den Versand der System-Benachrichtigungen. Interessanterweise funktionierte aber der <code>php-mail</code>-Befehl, so dass man mittels folgendem Modul Mails frei versenden kann:
<syntaxhighlight lang="perl">
sub sendmail($$$) {
my($empf, $subj, $nachricht) = @_;
system("php -r 'mail(\"$empf\",\"$subj\",\"$nachricht\");'");
undef;
}
</syntaxhighlight>

=== Raspberry Pi ===
{{Randnotiz|RNTyp=o|RNText=In früheren Distributionen wurde das Paket sowie der Aufruf uU. mit großem "E" geschrieben: ''sendEmail''.}}Auf einem [[Raspberry Pi]] muß noch sendemail nachinstalliert werden. Diese Anleitung funktioniert ab der Stretch-Version von Raspbian bzw. '''Debian''' sowie unter '''Ubuntu''' seit ca. Version 16.04.
<syntaxhighlight lang="bash">
sudo apt-get update
sudo apt-get install sendemail libio-socket-ssl-perl libnet-ssleay-perl perl
</syntaxhighlight>

Man kann die korrekte Funktion im Terminal (ohne <code>{qx()}</code> ) oder auch in der FHEM Kommandozeile testen (Hinweis: manche Provider (z.B. gmail) lassen diesen Zugang erst nach Freischaltung zu!).
<syntaxhighlight lang="perl">
{qx(sendemail -f 'Ab\@send.er' -t 'Emp\@faeng.er' -u 'subject' -m 'text' -a 'DateinameOderLeer' -s 'smtpFQDN:port' -xu 'MailUser' -xp 'PasswortOhneKlammeraffen')}
</syntaxhighlight>

Beispiel mit Gmail über Linux Terminalfenster:
(PS: Zusätzlich muss der "Zugriff durch weniger sichere Apps" in Gmail aktiviert werden. https://myaccount.google.com/lesssecureapps)
<syntaxhighlight lang="perl">
sendemail -f 'Der.Absender@gmail.com' -t 'Der.Empfaenger@gmail.com' -u 'subject' -m 'text' -a '' -s 'smtp.gmail.com:587' -xu 'Der.Absender' -xp DASSUPERGEHEIMEPASSW0RT
</syntaxhighlight>

In der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen:
<syntaxhighlight lang="perl">
######## DebianMail Mail auf dem RPi versenden ############
# $provider für SMTP Server anpassen.
# Einmal in der FHEM Kommandozeile, user und password anpassen:
# {setKeyValue("myEmailKonto",'user@domain');;setKeyValue("myEmailPasswrd",'password')}
sub DebianMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $attach = shift;
my $ret = "";
my $error;
my $konto = getKeyValue("myEmailKonto");
my $passwrd = getKeyValue("myEmailPasswrd");
my $from = $konto; # or use different KeyValue if konto is not the from email address
my $provider = "smtp.1und1.de"; # smtp.domain.tld:port see provider documentation
#Log 1, "sendEmail RCP: $rcpt";
#Log 1, "sendEmail Subject: $subject";
#Log 1, "sendEmail Text: $text";
#Log 1, "sendEmail Anhang: $attach";
if (not defined($attach)){$attach=''}
$ret .= qx(sendemail -f '$from' -t '$rcpt' -u '$subject' -m '$text' -a '$attach' -s '$provider' -xu '$konto' -xp '$passwrd' -o tls=auto -o message-charset=utf-8);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendemail returned: $ret";
}
###############################################################################
</syntaxhighlight>

Die Zugangsdaten für den Email-Account müssen dabei FHEM-intern gespeichert werden. Dazu gibt man einmalig über die Kommandozeile folgendes ein (user@domain und password müssen auf den Email Account geändert werden):
:<code><nowiki> {setKeyValue("myEmailKonto",'user@domain');;setKeyValue("myEmailPasswrd",'password')}</nowiki></code>

Um die TLS Verschlüsselung (ehem. SSL) nicht zu nutzen, muss in der viertletzten Zeile tls=no verwendet und der Port des Mailproviders auf 25 eigetragen werden. Sollte anschließend keine Mail verschickt werden, siehe Probleme.

Falls der Body-Text in einem (Android-)Mailer auf dem Handy nicht gezeigt wird, kann der Parameter '''-o message-content-type=html''' helfen.

Die Funktion kann beispielsweise folgendermaßen aufgerufen werden:
{{Randnotiz|RNTyp=g|RNText=Bei allen Feldern können generell doppelte " oder einfache ' Anführungszeichen verwendet werden. Innerhalb von "" müssen Sonderzeichen wie @ aber maskiert werden, da sie sonst als Steuerzeichen interpretiert werden:
:<code><nowiki>"email\@email.domain" oder 'email@email.domain'</nowiki></code>
}}
Direkt in der FHEM Kommandozeile (ohne Anhang)
:<code><nowiki>{DebianMail("email\@email.domain","Subject","Text")}</nowiki></code>
Die ordnungsgemäße Ausführung wird mit 71 quittiert.
Oder im notify mit mehreren Anhängen
:<code><nowiki>define Sonstiges notify Fenster:Window:.*,.*Low.Batt*. {\ DebianMail("email\@email.domain","Subject","Text","'Anhang1' 'Anhang2' ...");;\ }</nowiki></code>

oder (mehr als einen Empfänger, diese können durch Leerzeichen, Semikolon oder Komma getrennt sein)

<syntaxhighlight lang="text">
define Sonstiges at *01:00:00 {\
DebianMail('email@email.domain,email2@email.domain',"Subject","Text","'Anhang1' 'Anhang2' ...");;\
}
</syntaxhighlight>
{{Randnotiz|RNTyp=y|RNText=Eine erweiterte - nicht blockierende - Version des Scripts ist [[SSCAM_-_Steuerung_von_Kameras_in_Synology_Surveillance_Station#Mail mit Snapshot im Anhang und Aufnahmelink versenden (sendEmail)|hier]] zu finden}}
Es ist wichtig, die Dateinamen mit ' ' zu klammern, da hierdurch auch Leerzeichen im Pfad/Dateinamen möglich sind.

=== BeagleBoard-xM ===
Auf einem [[:Kategorie:BeagleBoard-xM|BeagleBoard-xM]] mit einem [http://en.opensuse.org/HCL:BeagleBoard-xM OpenSUSE 12.2] kann man ebenfalls das Perl-Programm ''sendEmail'' wie beim RPi nutzen. Dies gibt es aber nicht in den Repositories von openSUSE, sondern man muss sich ''sendEmail'' als Source herunterladen. Das geht am einfachsten per ''wget'', welches man ebenfalls erst installieren muss (aber aus einem Repository).
<syntaxhighlight lang="bash">
$ zypper in wget
$ cd /opt
$ wget http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v1.56.tar.gz
$ tar xvfz sendEmail-v1.56.tar.gz
$ cd sendEmail-v1.56
$ cp sendMail /usr/local/bin
</syntaxhighlight>
Dann geht man weiter vor wie unter RPi beschrieben (anlegen der SUB-Routine in 99_myUtils usw.).

'''Hinweis:''' Die Version 1.56 von ''sendEmail'' ist Stand Januar 2013 die aktuelle. Da diese Programmversion von 2009 stammt, ist mit neuen Versionen selten zu rechnen. Vielleicht schauen Sie trotzdem vorher auf der [http://caspian.dotconf.net/menu/Software/SendEmail/ Homepage von sendEmail] nach.

== Windows ==
# Kopiere die Datei sendEmail.exe* in Dein FHEM Verzeichnis (hier c:\fhem-5.0\); Quelle: [http://caspian.dotconf.net/menu/Software/SendEmail/ Homepage von sendEmail]
# Erstelle im FHEM Verzeichnis die Datei wmail.bat mit folgendem Inhalt (eine Zeile):
:<code>sendEmail -f absender@domain.de -u "%1" -m " " -s SMTP-SERVERAdresse -xu SMTP_USERNAME -xp SMTP_PASSWORT -t empfänger@domain.de -o message-header="X-Message-Flag: FHEM"</code>
# Beispiel fhem.cfg
## Mail wenn sich der Status von Heizung.* oder Hzg.* ändert <br><code>define Mail_Heizung notify Heizung.*|Hzg.* { system("wmail $NAME:$EVENT")}</code>
## Mail bei Signal Aussentemperatur (für dieses Beispiel wird [http://fhem.de/commandref.html#getstate http://fhem.de/commandref.html#getstate getstate] benötigt) <br><code>define Mail_Aussentemperatur notify Aussentemperatur {\</code><br><code>my ($val);;\</code><br><code>$val = fhem "getstate $NAME";;\</code><br><code>system("wmail \"$NAME: $val\"");;\</code><br><code>}</code>

== Probleme ==
=== sendEmail / sendemail (Schreibweise alt / neu ) ===
Erhält man Fehler bez. TLS (''ERROR => TLS setup failed: SSL connect attempt failed error: ...'' ), sind eventuell die ca-certificates veraltet oder nicht installiert. Prüfung:
:<code>apt-cache policy ca-certificates</code>
Falls man keine E-Mails verschicken kann, kann man in einem ersten Test prüfen, ob sendEmail als solches funktioniert und die Konfiguration (Benutzer, Passwort, Server-Name usw.) des Mail-Kontos, über das die Mails abgesetzt werden sollen, richtig ist.

Hierzu setzt man in der FHEM-Befehlszeile die folgende Anweisung ab:
:<code>{ SUB-Routinen-Name('EMailAdresse@Mail.Domain','Test','Test-Text');; }</code>
und ersetzt ''SUB-Routinen-Name'' durch den Namen der in 99_myUtils erzeugten Prozedur. Statt ''EMailAdresse@Mail.Domain'' trägt man noch eine gültige E-Mail-Adresse ein und bestätigt den Befehl dann mittels <Enter> (nicht "save"). Empfangen Sie nicht kurzfristig eine entsprechende E-Mail, ist sehr wahrscheinlich an den Zugangsdaten etwas verkehrt.

Vor dem testen der Routine oben kann sendEmail auch über die Konsole (z. B. via ssh) getestet werden:
:<code>sendEmail -vv -f 'Absender@AbsDomain.de' -t 'Empfänger@EmpfDomain.de' -u 'subject' -m 'body' -s 'smtp.AbsDomain.de' -xu 'AbsenderBenutzername' -xp 'AbsenderPasswort' -o tls=yes</code>

=== Keine Mail mit TLS Verschlüsselung ===
{{Randnotiz|RNTyp=y|RNText=Diese Information trifft nur auf alte Systeme zu, aktuell (2021) befindet sich in Zeile 1933 der korrekte Code}}
Prüfung mit <code>grep -n SSLv /usr/bin/sendEmail</code>

Den Test über die Konsole durchführen. Erhält man folgende Fehlermeldung:
''invalid SSL_version specified at /usr/share/perl5/IO/Socket/SSL.pm line 332''
muss auf dem Raspberry folgende Datei angepasst werden: ''/usr/bin/sendEmail''.
In Zeile 1907 muss
if (! IO::Socket::SSL->start_SSL($SERVER, SSL_version => 'SSLv3 TLSv1')) {

in folgendes geändert werden
if (! IO::Socket::SSL->start_SSL($SERVER, SSL_version => 'SSLv23:!SSLv2')) {

Der frühere Tipp, direkt in der SSL.pm Datei zu editieren, führt zu Problemen, wenn man auf FHEM per HTTPS zugreifen will und ist daher nicht zu empfehlen.

=== Email laut Log gesendet aber nicht angekommen? ===
Dann bitte in der Fritzbox Oberfläche überpüfen, ob unter "System" -> "Push Service" selbiger eingerichtet und aktiviert wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:FritzBox]]
[[Kategorie:BeagleBoard-xM]]
[[Kategorie:Raspberry Pi]]
[[Kategorie:E-Mail]]

EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais

2020-11-29T15:39:08Z

LHBL2003: /* Nutzung der inoffziellen EEP */ etwas vergessen du dem vorherigen

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Empfänger, Aktor und Sender, Sensor
|HWCategory=EnOcean
|HWComm=Eltako RS485-Bus
|HWChannels=4 Schaltkanäle (bidirektional)
|HWVoltage=230V~
|HWPowerConsumption=Standby: 0,1W, alle Kanäle geschlossen: 0,7W
|HWPoweredBy=12VDC
|HWSize=1 Teilungseinheit = 18mm breit, 58mm tief
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

'''EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais''' (FSR14) ist ein Aktor
* für:
** Montage auf Hutschiene
* angesteuert (bidirektional) über
** den Eltako RS485-Bus
***Anschlussklemmen RSA und RSB
* für
** 4 Schalt-Kanäle mit je 4A maximaler Schaltstrom (1000W Glühlampen)

== Features ==
Schaltrelais (bidirektional)

== Hinweise zum Betrieb mit FHEM ==
siehe auch [[EnOcean-Eltako-RS485-Bus]]

=== Definition/Anlernvorgang ===
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Die Einbindung in FHEM kann entweder über die Nutzung der inoffiziellen, gerätespezifischen EEP (empfohlen) '''oder''' über die manuelle Vorgehensweise erfolgen.

===== Nutzung der inoffziellen EEP =====
Im nachfolgenden wird 1 Aktor Ausgang eingelernt und muss für Ausgang 2 bis 4 wiederholt werden:
* Beim Definieren wird zunächst der FHEM-Device <name> (hier: EnOcean_switch_FSR14_A01) für Ausgang 1 mit dem inoffiziellen EEP für den FSR14 (M5-38-08) erstellt. Die Beispielhafte HEX Adresse (hier: 00000016) ist die Adresse des FSR14-Kanals welche z.B. über die Software PCT14 vergeben wurde. Z.B. "Adr. 16-19, V1.1, Beschreibung" Bei einem FSR-14-4x werden bei der Adressvergabe 4 aufeinanderfolgende Adressen vergeben. z.B. Adresse 16-19. Die Definition des Devices erfolgt über die Eingabe in das [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] definieren. Beipiel für alle vier Devices Device 1-4 für Ausgang 1-4 erstellen:
: <code>define EnOcean_switch_FSR14_A01 EnOcean 00000016 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A02 EnOcean 00000017 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A03 EnOcean 00000018 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A04 EnOcean 00000019 M5-38-08</code>
: Hierdurch wird jeweis ein FHEM-Device mit fast allen notwendigen Attributen für den FSR14 angelegt.
: Folgende Attribute werden der folständigkeit noch je Device benötigt (für A01-A04):
: Verhindert das massige Schreiben in Logfiles:
: <code>attr EnOcean_switch_FSR14_A01 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A02 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A03 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A04 event-on-change-reading .*</code>
: Adresse definieren, mit welcher FHEM seine anforderung für on/off Befehle sendet:
: <code>attr EnOcean_switch_FSR14_A01 subDef FF000016</code>
: <code>attr EnOcean_switch_FSR14_A02 subDef FF000017</code>
: <code>attr EnOcean_switch_FSR14_A03 subDef FF000018</code>
: <code>attr EnOcean_switch_FSR14_A04 subDef FF000019</code>
:
: Die Adresse <code>FF000016 bis FF000019</code> muss ebenso angepasst werden, es handelt sich um die Adresse mit welche sich FHEM beim EnOcean System authentifiziert. Siehe auch PTC14 -> ID-Zuordnungsbereich --> Spalte ID. Beispielsweise kann man hier die Hex ID mit FF beginnen lasse zur besseren Erennung und endet mit der Adress ID welche für die Kanäle 1 bis 4 vergeben wurden. z.B. 16 bis 19.
:
: Theach Method RPS festlegen, da man andernfalls die Rückmeldung / den Status in FHEM nicht erhält.
:<code>attr EnOcean_switch_FSR14_A01 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A02 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A03 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A04 teachMethod RPS</code>
:
:Ebenso muss das Attribut <code>comMode = confirm</code>gelöscht werden.
:<code>deleteattr EnOcean_switch_FSR14_A01 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A02 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A03 comMode</code>
:<code>deleteattr EnOcean_switch_FSR14_A04 comMode</code>
* Nun muss der Aktor (der Ausgan 1 bis 4 eingelernt werden)
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter auf Kanal 1 stellen.
* FHEM Eingabefeld: <code>set EnOcean_switch_FSR14_A01 teach</code> die LEDs am Aktor hören auf zu blinken.
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position zurückstellen. (z.B. Mitte&Unten auf Auto)
* Den Vorgang für Kanal 2-4 wiederholen.
* Fertig

===== Alternative: manuelle Vorgehensweise =====
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Folgende Schritte sind für jeden Kanal durchzuführen:
* EnOcean-FHEM-Device <name> mit der Sender-ID des FSR14-Aktors definieren
* Die Attribute subType, gwCmd und manufID wie nachfolgend im Config-Auszug anlegen
* Das Attribut subDef mit einer freien Sender-ID des TCMs anlegen ODER falls keine freie Sender-ID bekannt ist, das Attribut komplett weglassen, damit die Vergabe automatisch durch FHEM erfolgt
* Am Aktor anlernen
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter den korrekten Kanal einstellen
** FHEM Eingabefeld: <code>set <name> teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
define EnOcean_switch_FSR14_A01 EnOcean 00000001 <- SenderID eines FSR14-Kanals (Aktor)
attr EnOcean_switch_FSR14_A01 subDef FF834381 <--- FF834381 ist eine der 127 Sender-ID's des TCM
attr EnOcean_switch_FSR14_A01 eep A5-38-08
attr EnOcean_switch_FSR14_A01 manufID 00D
attr EnOcean_switch_FSR14_A01 webCmd on:off
attr EnOcean_switch_FSR14_A01 gwCmd switching # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 subType gateway # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 event-on-change-reading .* # Verhindert das massige Schreiben in Logfiles
define FileLog_EnOcean_switch_FSR14_A01 FileLog ./log/EnOcean_switch_FSR14_A01-%Y.log EnOcean_switch_FSR14_A01
attr FileLog_EnOcean_switch_FSR14_A01 logtype text

=== Logbeispiel ===

== Einsatzbeispiel ==

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/BR14_datenblatt_FSR14-4x.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FSR14-4x_30014001-2_dt.pdf PDF]
* Forum: {{Link2Forum|Topic=25068|Message=181966}}

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

EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais

2020-11-29T15:32:46Z

LHBL2003: /* Alternative: manuelle Vorgehensweise */

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Empfänger, Aktor und Sender, Sensor
|HWCategory=EnOcean
|HWComm=Eltako RS485-Bus
|HWChannels=4 Schaltkanäle (bidirektional)
|HWVoltage=230V~
|HWPowerConsumption=Standby: 0,1W, alle Kanäle geschlossen: 0,7W
|HWPoweredBy=12VDC
|HWSize=1 Teilungseinheit = 18mm breit, 58mm tief
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

'''EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais''' (FSR14) ist ein Aktor
* für:
** Montage auf Hutschiene
* angesteuert (bidirektional) über
** den Eltako RS485-Bus
***Anschlussklemmen RSA und RSB
* für
** 4 Schalt-Kanäle mit je 4A maximaler Schaltstrom (1000W Glühlampen)

== Features ==
Schaltrelais (bidirektional)

== Hinweise zum Betrieb mit FHEM ==
siehe auch [[EnOcean-Eltako-RS485-Bus]]

=== Definition/Anlernvorgang ===
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Die Einbindung in FHEM kann entweder über die Nutzung der inoffiziellen, gerätespezifischen EEP (empfohlen) '''oder''' über die manuelle Vorgehensweise erfolgen.

===== Nutzung der inoffziellen EEP =====
Im nachfolgenden wird 1 Aktor Ausgang eingelernt und muss für Ausgang 2 bis 4 wiederholt werden:
* Beim Definieren wird zunächst der FHEM-Device <name> (hier: EnOcean_switch_FSR14_A01) für Ausgang 1 mit dem inoffiziellen EEP für den FSR14 (M5-38-08) erstellt. Die Beispielhafte HEX Adresse (hier: 00000016) ist die Adresse des FSR14-Kanals welche z.B. über die Software PCT14 vergeben wurde. Z.B. "Adr. 16-19, V1.1, Beschreibung" Bei einem FSR-14-4x werden bei der Adressvergabe 4 aufeinanderfolgende Adressen vergeben. z.B. Adresse 16-19. Die Definition des Devices erfolgt über die Eingabe in das [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] definieren. Beipiel für alle vier Devices Device 1-4 für Ausgang 1-4 erstellen:
: <code>define EnOcean_switch_FSR14_A01 EnOcean 00000016 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A02 EnOcean 00000017 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A03 EnOcean 00000018 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A04 EnOcean 00000019 M5-38-08</code>
: Hierdurch wird jeweis ein FHEM-Device mit fast allen notwendigen Attributen für den FSR14 angelegt.
: Folgende Attribute werden der folständigkeit noch je Device benötigt (für A01-A04):
: Verhindert das massige Schreiben in Logfiles:
: <code>attr EnOcean_switch_FSR14_A01 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A02 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A03 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A04 event-on-change-reading .*</code>
: Adresse definieren, mit welcher FHEM seine anforderung für on/off Befehle sendet:
: <code>attr EnOcean_switch_FSR14_A01 subDef FF000016</code>
: <code>attr EnOcean_switch_FSR14_A02 subDef FF000017</code>
: <code>attr EnOcean_switch_FSR14_A03 subDef FF000018</code>
: <code>attr EnOcean_switch_FSR14_A04 subDef FF000019</code>
:
: Die Adresse <code>FF000016 bis FF000019</code> muss ebenso angepasst werden, es handelt sich um die Adresse mit welche sich FHEM beim EnOcean System authentifiziert. Siehe auch PTC14 -> ID-Zuordnungsbereich --> Spalte ID. Beispielsweise kann man hier die Hex ID mit FF beginnen lasse zur besseren Erennung und endet mit der Adress ID welche für die Kanäle 1 bis 4 vergeben wurden. z.B. 16 bis 19. Theach Method RPS festlegen, da man andernfalls die Rückmeldung / den Status in FHEM nicht erhält.
:<code>attr EnOcean_switch_FSR14_A01 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A02 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A03 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A04 teachMethod RPS</code>
* Nun muss der Aktor (der Ausgan 1 bis 4 eingelernt werden)
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter auf Kanal 1 stellen.
* FHEM Eingabefeld: <code>set EnOcean_switch_FSR14_A01 teach</code> die LEDs am Aktor hören auf zu blinken.
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position zurückstellen. (z.B. Mitte&Unten auf Auto)
* Den Vorgang für Kanal 2-4 wiederholen.
* Fertig

===== Alternative: manuelle Vorgehensweise =====
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Folgende Schritte sind für jeden Kanal durchzuführen:
* EnOcean-FHEM-Device <name> mit der Sender-ID des FSR14-Aktors definieren
* Die Attribute subType, gwCmd und manufID wie nachfolgend im Config-Auszug anlegen
* Das Attribut subDef mit einer freien Sender-ID des TCMs anlegen ODER falls keine freie Sender-ID bekannt ist, das Attribut komplett weglassen, damit die Vergabe automatisch durch FHEM erfolgt
* Am Aktor anlernen
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter den korrekten Kanal einstellen
** FHEM Eingabefeld: <code>set <name> teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
define EnOcean_switch_FSR14_A01 EnOcean 00000001 <- SenderID eines FSR14-Kanals (Aktor)
attr EnOcean_switch_FSR14_A01 subDef FF834381 <--- FF834381 ist eine der 127 Sender-ID's des TCM
attr EnOcean_switch_FSR14_A01 eep A5-38-08
attr EnOcean_switch_FSR14_A01 manufID 00D
attr EnOcean_switch_FSR14_A01 webCmd on:off
attr EnOcean_switch_FSR14_A01 gwCmd switching # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 subType gateway # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 event-on-change-reading .* # Verhindert das massige Schreiben in Logfiles
define FileLog_EnOcean_switch_FSR14_A01 FileLog ./log/EnOcean_switch_FSR14_A01-%Y.log EnOcean_switch_FSR14_A01
attr FileLog_EnOcean_switch_FSR14_A01 logtype text

=== Logbeispiel ===

== Einsatzbeispiel ==

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/BR14_datenblatt_FSR14-4x.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FSR14-4x_30014001-2_dt.pdf PDF]
* Forum: {{Link2Forum|Topic=25068|Message=181966}}

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

EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais

2020-11-29T15:29:41Z

LHBL2003: /* Nutzung der inoffziellen EEP */ Anpassung der Beschreibung, da der beschriebene Vorgang zu keinen vollständigen erfolg fürte. Zudem ist nicht auf anhieb ersichtlich, dass dieser Vorgang für alle Kanäle wiederholt werden muss.Device Name erweitert

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Empfänger, Aktor und Sender, Sensor
|HWCategory=EnOcean
|HWComm=Eltako RS485-Bus
|HWChannels=4 Schaltkanäle (bidirektional)
|HWVoltage=230V~
|HWPowerConsumption=Standby: 0,1W, alle Kanäle geschlossen: 0,7W
|HWPoweredBy=12VDC
|HWSize=1 Teilungseinheit = 18mm breit, 58mm tief
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

'''EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais''' (FSR14) ist ein Aktor
* für:
** Montage auf Hutschiene
* angesteuert (bidirektional) über
** den Eltako RS485-Bus
***Anschlussklemmen RSA und RSB
* für
** 4 Schalt-Kanäle mit je 4A maximaler Schaltstrom (1000W Glühlampen)

== Features ==
Schaltrelais (bidirektional)

== Hinweise zum Betrieb mit FHEM ==
siehe auch [[EnOcean-Eltako-RS485-Bus]]

=== Definition/Anlernvorgang ===
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Die Einbindung in FHEM kann entweder über die Nutzung der inoffiziellen, gerätespezifischen EEP (empfohlen) '''oder''' über die manuelle Vorgehensweise erfolgen.

===== Nutzung der inoffziellen EEP =====
Im nachfolgenden wird 1 Aktor Ausgang eingelernt und muss für Ausgang 2 bis 4 wiederholt werden:
* Beim Definieren wird zunächst der FHEM-Device <name> (hier: EnOcean_switch_FSR14_A01) für Ausgang 1 mit dem inoffiziellen EEP für den FSR14 (M5-38-08) erstellt. Die Beispielhafte HEX Adresse (hier: 00000016) ist die Adresse des FSR14-Kanals welche z.B. über die Software PCT14 vergeben wurde. Z.B. "Adr. 16-19, V1.1, Beschreibung" Bei einem FSR-14-4x werden bei der Adressvergabe 4 aufeinanderfolgende Adressen vergeben. z.B. Adresse 16-19. Die Definition des Devices erfolgt über die Eingabe in das [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] definieren. Beipiel für alle vier Devices Device 1-4 für Ausgang 1-4 erstellen:
: <code>define EnOcean_switch_FSR14_A01 EnOcean 00000016 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A02 EnOcean 00000017 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A03 EnOcean 00000018 M5-38-08</code>
: <code>define EnOcean_switch_FSR14_A04 EnOcean 00000019 M5-38-08</code>
: Hierdurch wird jeweis ein FHEM-Device mit fast allen notwendigen Attributen für den FSR14 angelegt.
: Folgende Attribute werden der folständigkeit noch je Device benötigt (für A01-A04):
: Verhindert das massige Schreiben in Logfiles:
: <code>attr EnOcean_switch_FSR14_A01 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A02 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A03 event-on-change-reading .*</code>
: <code>attr EnOcean_switch_FSR14_A04 event-on-change-reading .*</code>
: Adresse definieren, mit welcher FHEM seine anforderung für on/off Befehle sendet:
: <code>attr EnOcean_switch_FSR14_A01 subDef FF000016</code>
: <code>attr EnOcean_switch_FSR14_A02 subDef FF000017</code>
: <code>attr EnOcean_switch_FSR14_A03 subDef FF000018</code>
: <code>attr EnOcean_switch_FSR14_A04 subDef FF000019</code>
:
: Die Adresse <code>FF000016 bis FF000019</code> muss ebenso angepasst werden, es handelt sich um die Adresse mit welche sich FHEM beim EnOcean System authentifiziert. Siehe auch PTC14 -> ID-Zuordnungsbereich --> Spalte ID. Beispielsweise kann man hier die Hex ID mit FF beginnen lasse zur besseren Erennung und endet mit der Adress ID welche für die Kanäle 1 bis 4 vergeben wurden. z.B. 16 bis 19. Theach Method RPS festlegen, da man andernfalls die Rückmeldung / den Status in FHEM nicht erhält.
:<code>attr EnOcean_switch_FSR14_A01 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A02 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A03 teachMethod RPS</code>
:<code>attr EnOcean_switch_FSR14_A04 teachMethod RPS</code>
* Nun muss der Aktor (der Ausgan 1 bis 4 eingelernt werden)
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter auf Kanal 1 stellen.
* FHEM Eingabefeld: <code>set EnOcean_switch_FSR14_A01 teach</code> die LEDs am Aktor hören auf zu blinken.
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position zurückstellen.
* Den Vorgang für Kanal 2-4 wiederholen.
* Fertig

===== Alternative: manuelle Vorgehensweise =====
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Folgende Schritte sind für jeden Kanal durchzuführen:
* EnOcean-FHEM-Device <name> mit der Sender-ID des FSR14-Aktors definieren
* Die Attribute subType, gwCmd und manufID wie nachfolgend im Config-Auszug anlegen
* Das Attribut subDef mit einer freien Sender-ID des TCMs anlegen ODER falls keine freie Sender-ID bekannt ist, das Attribut komplett weglassen, damit die Vergabe automatisch durch FHEM erfolgt
* Am Aktor anlernen
** Mittlerer Funktions-Drehschalter: auf LRN
** Unteren Funktions-Drehschalter den korrekten Kanal einstellen
** FHEM Eingabefeld: <code>set <name> teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
define EnOcean_switch_FSR14_A01 EnOcean 00000001 <- SenderID eines FSR14-Kanals (Aktor)
attr EnOcean_switch_FSR14_A01 subDef FF834381 <--- FF834381 ist eine der 127 Sender-ID's des TCM
attr EnOcean_switch_FSR14_A01 eep A5-38-08
attr EnOcean_switch_FSR14_A01 manufID 00D
attr EnOcean_switch_FSR14_A01 webCmd on:off
attr EnOcean_switch_FSR14_A01 gwCmd switching # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 subType gateway # Wichtig für FSR14
attr EnOcean_switch_FSR14_A01 event-on-change-reading .* # Verhindert das massige Schreiben in Logfiles
define FileLog_EnOcean_switch_FSR14_A01 FileLog ./log/EnOcean_switch_FSR14_A01-%Y.log EnOcean_switch_FSR14_A01
attr FileLog_EnOcean_switch_FSR14_A01 logtype text

=== Logbeispiel ===

== Einsatzbeispiel ==

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/BR14_datenblatt_FSR14-4x.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FSR14-4x_30014001-2_dt.pdf PDF]
* Forum: {{Link2Forum|Topic=25068|Message=181966}}

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

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

2019-12-29T14:34:29Z

LHBL2003: /* Channel (Kanal) 01 _Weather */ Hinweis zum CMDs_pending / CMDs_done

{{Infobox Hardware
|Bild=HM-TC-IT-WM-W-EU.jpg
|Bildbeschreibung=HM-TC-IT-WM-W-EU mit Standard-Einstellungen
|HWProtocol=[[HomeMatic]]
|HWType=[[HomeMatic Type Thermostat|thermostat]]
|HWCategory=[[:Kategorie:Temperatursensoren|Temperatursensoren]] [[:Kategorie:Feuchtesensoren|Feuchtesensoren]]
|HWComm=868,3 MHz
|HWChannels=7
|HWVoltage=3 V
|HWPowerConsumption=40 mA (max)
|HWPoweredBy=2 x LR6/Mignon/AA
|HWSize=ohne Rahmen: 55 x 55 x 20 mm<br />mit Rahmen: 86 x 86 x 21,5 mm
|HWDeviceFHEM=[[CUL_HM]]

|HWManufacturer=ELV / eQ-3
}}
'''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 ==
: ''→ Allgemeine Informationen, die alle HomeMatic Thermostate betreffen, sind unter [[HomeMatic Type Thermostat]] zu finden.''

Der '''HM-TC-IT-WM-W-EU Funk-Wandthermostat''' 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.

Der Hauptnutzen gegenüber den Heizkörperthermostaten besteht neben einer weitaus bequemeren Bedienung und der möglichen Anzeige von Istwerten von Temperatur und Luftfeuchte auch in einer Entkopplung der Raumtemperaturreglung aus der räumlichen Nähe des Heizkörpers. Zusätzlich oder alternativ zur Heizkörpersteuerung ist auch die Anbindung von Fußbodenheizung oder anderen Wärmequellen über einen funkgesteuerten Schaltaktor durch einen separaten Schaltkanal möglich.

== 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 ==
Grundsätzlich sind speziell bei der Ansteuerung von [[HM-CC-RT-DN Funk-Heizkörperthermostat]] zwei Betriebsarten mit FHEM denkbar.

=== Steuerung nur über den Wandthermostat ===

In diesem Fall werden zunächst alle [[HM-CC-RT-DN Funk-Heizkörperthermostat]]e mit dem HM-TC-IT-WM-W-EU Funk-Wandthermostat verbunden wie in den Handbüchern beschrieben (dort "verknüpfen" genannt, technisch handelt es sich um eine peering).
Dazu muss die mittlere Taste der Heizkörper Ventile länger als 3 Sekunden gedrückt werden, ebenso das Einstellrad am Wandthermostat. Die "Verknüpfung" war erfolgreich, wenn beide Geräte "ACK" im Display zeigen.

Wichtig ist, dass keines der Geräte vorher mit einer Zentrale (u.B. VCCU) gepairt sein darf. Im Zweifel vorher unpairen.

Wenn alle Heizkörperthermostat gepeert ("verknüpft") sind, dann wird das HM-TC-IT-WM-W-EU Funk-Wandthermostat mit FHEM wie in [[HomeMatic Devices pairen]] beschrieben gepairt.

Anschliessend kann per FHEM mit dem Befehl
set myTC desired-temp 22
die Zieltemperatur an den Wandthermostat übermittelt werden. Dieser verteilt diese Temperatur und seine gemessene Ist-Temperatur an die Heizkörperthermostate weiter, die dann entsprechend das Ventil öffnen oder schliessen. Die Wunschtemperatur kann auch lokal an '''allen''' Geräten (also auch an einem der Heizkörperthermostate) per Drehregler geändert werden und wird anschliessend an alle anderen Geräte und FHEM weiterübertragen. Kommunikationspartner für FHEM ist aber immer nur das gepairte HM-TC-IT-WM-W-EU Funk-Wandthermostat.

Vorteile dieser Methode:
* schnell eingerichtet - weniger Komplex, keine Channel peering notwendig.
* weniger Geräte in FHEM, weniger Daten, weniger Defs, weniger Prozessorlast, geringer Verbrauch des Funkkontingents an FHEMs Funkschnittstelle etc. (Es ist allerdings fraglich, ob in normalen Installationen diese Effekte überhaupt spürbar sind)
* Heizung kann am HM-TC-IT-WM-W-EU Funk-Wandthermostat auch bei Ausfall von FHEM eingestellt werden.
* eventuelles Wochenprogramm muss nur an einer Stelle eingespielt werden (nämlich in den Wandthmermostaten)

Nachteile dieser Methode:
* keine direkte Kontrolle über die Heizkörperthermostate, weniger Daten. Z.B. ist der Valevöffnungsgrad FHEM unbekannt, ebenso Batteriewarnungen, auch lassen sich diverse Dinge nicht konfigurieren wie Button lock, boost-time, remote Kanal zur Abschaltung, temp-offset, maximale Ventilöffnung etc.
* leichte Verzögerung in der Übermittlung der Zieltemperatur, da diese zuerst an den Wandthermostaten übermittelt wird und dieser erst mit etwas Verzögerung die Daten an die Heizkörperthermostaten weiterreicht.
* eventuelles Wochenprogramm kann nur an einer Stelle eingespielt werden (nämlich in den Wandthmermostaten), man kann also nicht einzelnen Heizkörpern abweichende Programme geben. Da man einen Wandthermostat wohl in der Praxis nur mit Heizkörperthermostaten '''eines''' einzelnen Raumes peeren wird, ist dieser Nachteil ggf eher theoretischern Natur.

=== Steuerung aller Komponenten durch FHEM ===

Diese Methode wird zumindest von den meisten Nutzern des Forums favorisiert, weil sie mehr Kontrolle auch über Details und Geräte ermöglicht.

In diesem Fall werden zunächst alle Geräte - also die Heizkörperthermostate und der Wandthermostat - wie in [[HomeMatic Devices pairen]] beschrieben mit FHEM (also i.d.R. der VCCU) gepairt.

Danach kann das [[Peering (HomeMatic)|Peering]] mit den Heizkörperthermostaten des betreffenden Raumes stattfinden. Je nach Funktion sind dazu einer oder mehrer Channels zu peeren, Details weiter unten.

Vorteile dieser Methode:
* direkte Kontrolle über die Heizkörperthermostate, Verfügbarkeit Daten wie z.B Valevöffnungsgrad FHEM, Batteriestatus, am jedem Heizkörper gemessene Temperatur etc.; diverse Paramter am Heizkörperthermostat konfigurierbar, wie Button lock, boost-time, remote Kanal zur Abschaltung, temp-offset, maximale Ventilöffnung etc.
* schneller Übermittlung der Zieltemperatur (und sonstiger Daten), da diese zugleich an alle gepeerten Thermostaten übermittelt wird.
* Wochenprogramm frei in alle Geräte übertragbar, dadurch in grossen Räumen gezieltes Ansteuern einzelner Heizkörper möglich etc.

Nachteile dieser Methode:
* deutlich komplexer in der Einrichtung
* mehr Geräte in FHEM, mehr Daten, mehr Defs notwendig, höhere Prozessorlast, höhere Auslastung des Funkkontingents an der HM Funkschnittstelle von FHEM (zumindest für ''normale'' Anzahl von Thermostaten eher theoretischer Natur)
* Zieltemperatur kann ohne FHEM nicht mehr am HM-TC-IT-WM-W-EU Funk-Wandthermostat eingestellt werden, sondern müsste an jedem Heizkörper einzeln eingestellt werden.
* Wochenprogramm muss ggf auf mehrere Geräte verteilt werden.

Bei der Steuerung aller Komponenten über FHEM müssen je nach Anwendungsfall bestimmte Channels gepeert werden.

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

===== Channel (Kanal) 01 _Weather =====
Damit das [[HM-CC-RT-DN Funk-Heizkörperthermostat]] 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

Hinweis: Nach jeden dieser peer Aufgaben, sollte am Thermostat sowie am Wandthermostat die Status-Meldung CMDs_pending abgewartet werden, bis wieder CMDs_done ausgegeben wird. Andernfalls bekommt man ggf. unerwartete Probleme oder es wird ggf. beim Thermostat oder beim Wandthermostat das peer nicht sauber durchgeführt.

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

Damit der Tür-Fensterkontakt den Thermostat aufwecken kann, muss zuerst der Burst-Modus aktiviert werden, siehe dazu [[HM-SEC-SC_Tür-Fensterkontakt#Problembehebung]].

Das eigentliche 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 kann 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 =====
Dieser Kanal kann direkt mit einem HomeMatic-Schaltaktor verknüpft (gepeert) werden, um temperaturgesteuerte Schaltvorgänge auszulösen. Eine direkte Nutzung als Feuchtigkeitssensor zur Lüftungssteuerung ist hingegen nicht möglich. Geeignete Aktoren sind alle dauerhaft mit Klein- oder Netzspannung versorgten Aktoren, die zum Betrieb keinen sog. Burst benötigen (Hutschienen-, Unterputz- und Wandmontage). Nicht geeignet sind demnach die batterieversorgten ein- oder vierkanaligen HM-LC-Sw(x)-BA-PCB-Aktoren oder das Empfangsmodul HM-MOD-Re-8, weil der Thermostat den zum "Aufwecken" dieser Geräte nötigen Burst nicht senden kann.

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> single set

Dies allein ist nicht ausreichend, da der so gepeerte Aktor sich bei jedem Heizbefehl abwechselnd ein- und ausschaltet, da er die Ausschaltbefehle des Thermostaten (short trigger mit Wert 0) ignoriert. Um das zu korrigieren, wird er so programmiert, dass er, wenn eingeschaltet, auf den Ausschaltbefehl reagiert (und ihn ansonsten ignoriert):

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

Möchte man mit dem Aktor ein inverses Verhalten erreichen (etwa beim Einsatz als Kühlthermostat oder für stromlos offene Ventilsteuerköpfe von Fußbodenheizungen), so setzt man '''stattdessen'''

set <HM-LC-SW1-FM> regSet shCtOff ltLo <HM-TC-IT-WM-W-EU_SwitchTr>

== Einstellungen ==

Die folgenden Einstellungen werden in **Registern** des HM-TC-IT-WM-W-EU vorgenommen. Das heißt, dass diese Einstellungen im Gerät selbst gespeichert werden, nicht in der Konfigurations-Datei von FHEM.

=== Anzeige ===

Register im Kanal 2 ''(_Climate)'' erlauben es zu konfigurieren, welche Daten der HM-TC-IT-WM-W-EU in seinem LC-Display anzeigt.

==== showInfo time|date ====

Wählt aus, ob die ''Uhrzeit'' (<code>time</code>, Standard-Einstellung) oder das ''Datum'' (<code>date</code>) angezeigt wird. Der folgende Befehl erlaubt es das Datum anzeigen zu lassen:

set <HM-TC-IT-WM-W-EU>_Climate regSet showInfo date

==== showSetTemp actTemp|setTemp ====

Wählt aus, ob die ''Ist-Temperatur'' (<code>actTemp</code>, Standard-Einstellung) oder die ''Soll-Temperatur'' (<code>setTemp</code>) im Display angezeigt wird.

set <HM-TC-IT-WM-W-EU>_Climate regSet showSetTemp setTemp

==== showHumidity temp|tempHum ====

Wählt aus, ob dauerhaft die ''Temperatur'' (<code>temp</code>, Standard-Einstellung) oder ''Temperatur und Luftfeuchtigkeit'' im Wechsel (<code>tempHum</code>) im Display angezeigt werden.

set <HM-TC-IT-WM-W-EU>_Climate regSet showHumidity tempHum

=== 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 zu anderern HomeMatic Thermostaten verwaltet, siehe [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]]. Beim HM-TC-IT-WM-W-EU ist der Kanal 2 ''(_Climate)'' für die Temperaturlisten zuständig.

=== Luftfeuchtigkeit in SVG Plot ===

Um die Luftfeuchtigkeit im Plot darzustellen benötigt man im Logfile folgenden Eintrag:

2017-10-24_22:03:12 WANDTHERMOSTAT_Weather humidity: 61

Um diesen zu erhalten muss man in der Logfile Konfiguration evtl. das DEF um die Weather Information erweitern:

Standardbeispiel:
./log/WANDTHERMOSTAT-%Y.log WANDTHERMOSTAT

Erweiterung:
./log/WANDTHERMOSTAT-%Y.log WANDTHERMOSTAT|WANDTHERMOSTAT_Weather:.*

Nach einer Weile, sollte der Eintrag "WANDTHERMOSTAT_Weather humidity:" im SVG Plot zur Auswahl zur Verfügung stehen.

== 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]]. Das Thermostat wird in den Updatemodus gebracht, indem beide äußeren Tasten gedrückt werden, während die Batterien eingesetzt werden. Das Display zeigt "FUP" an.

== 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 [https://de.elv.com/forum/hm-tc-it-wm-w-eu-hystereseeinstellung-hat-keine-funktion-10076 Forum von ELV]

* Der Sensor sollte nur innerhalb seiner Spezifikationen (0° - 50°C) betrieben werden; bei kleineren Temperaturen werden überhöhte Temperaturen gesendet, siehe {{Link2Forum|Topic=80383|LinkText=dieser Forumsbeitrag}}.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-TC-IT-WM-W-EU_UM_GE_eQ-3_web.pdf Manual]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Wandthermostat_132030A0_Produktdatenblatt_V1.2.pdf Produktdatenblatt]

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

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

2019-12-27T10:55:21Z

LHBL2003: /* Auflistung und Beschreibung der Readings Beispiel Änderung der Einstellung von Readings*/

{{Infobox Hardware
|Bild=HM-CC-RT-DN.jpg
|Bildbeschreibung=HM-CC-RT-DN an Heizkörper montiert
|HWProtocol=[[HomeMatic]]
|HWType=[[HomeMatic Type Thermostat|thermostat]]
|HWCategory=[[:Kategorie:Heizungsventile|Heizungsventile]]
|HWComm=868 MHz
|HWChannels=6
|HWVoltage=3 V
|HWPowerConsumption=180 mA
|HWPoweredBy=2x LR6/Mignon/AA
|HWSize=54x65x93 mm (BxHxT)
|HWDeviceFHEM=[[CUL_HM]]

|HWManufacturer=ELV / eQ-3
}}

'''HM-CC-RT-DN''' (häufig einfach '''RT''' genannt) ist ein Funk-''Heizkörperthermostate'' mit integriertem ''Stellantrieb''. Das Thermostat ist seit September 2013 verfügbar und ist der Nachfolger des [[HM-CC-VD Funk-Stellantrieb]]s.

== Vorbemerkungen ==
: ''→ Einstellungen und Informationen, die alle [[HomeMatic]] Thermostate betreffen, sind unter [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]] zu finden.''

Der HM-CC-RT-DN kann die Temperatur selbst messen (im Gegensatz zum [[HM-CC-VD Funk-Stellantrieb|Vorgänger]]) und verfügt über eine Fenster-Offen-Erkennung sowie eine Boost-Funktion. Der HM-CC-RT-DN ''kann'' von einem [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP]] gesteuert werden, das ist aber ''optional''.

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 Firmwareupdate-Software. Weitere Details sind unter [[#Firmware Update|Firmware Update]] beschrieben.
{{Hinweis|Die Solltemperaturen eines HM-CC-RT-DN lassen sich ''nicht'' durch einen [[HM-CC-TC Funk-Wandthermostat]] ''steuern''. Dieser kann nur die Ist-Temperatur an den HM-CC-RT-DN weitergeben, damit nicht die am HM-CC-RT-DN direkt gemessene Raumtemperatur zur Regelung verwendet 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
[[Peering (HomeMatic)|gepeert]] werden.

{{Hinweis|Wird für Wartungs-/Umbaumaßnahmen das Wasser der Heizung abgelassen bzw. diese neubefüllt, sind alle Stellantriebe manuell dauerhaft auf '''on''' zu setzen: set <HM_Stellantrieb>_Clima controlManu on. Beim Einsatz eines Wandthermostaten ist der Wandthermostat entsprechend einzustellen.}}

== 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 (2018)

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

Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden

=== Channels (Kanäle) ===
==== Channel (Kanal) 01 _Weather ====

Dieser Kanal dient zur Einspeisung der (gemessenen) ''Ist-Temperatur''. Als Sensor können zum Beispiel das [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP|HM-TC-IT-WM-W-EU Funk-Wandthermostat]] oder ein [[HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor innen (IT)|HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor]] dienen.

Ein Temperatur-Sensor ''tempSensor'' kann mit dem ''_Weather''-Kanal wie folgt [[Peering (HomeMatic)|gepeert]] werden:

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

Beispiel:
set EG_Buero_WANDTHERMOSTAT_Weather peerChan 0 EG_Buero_THERMOSTAT_Weather single set

ACHTUNG: Das Wandthermostat sowie das Thermostat Ventil (Beispiel "EG_Buero_WANDTHERMOSTAT" und EG_Buero_THERMOSTAT) werden vorher in FHEM den Status "CMDs_done" anzeigen.
Beim peerChan wird dann bei beiden "CMDs_pending" stehen. Wobei das Wandthermostat sehr schnell wieder auf CMDs_done zurück springt.
Allerdings ist dringend darauf zu achten, dass das Thermostat Ventil auch wieder auf "CMDs_done" wechselt, bevor man den nächsten Befehl absendet.
Das Heizkörper Ventil kann unter Umständen 3 bis 5 min benötigen bis wieder "CMDs_done" steht. Evtl. kann man dies durch die BOOST Taste beschleunigen. Da das Ventil etwa alle 3 min aufwacht, prüft und Daten sendet / empfängt. Sollte man mit dem Befehlen weiter gemacht haben, so kann es zu dem Problem führen, dass einer nicht mehr mit dem Pending aufhört. In dem Fall empfiehlt es sich beide Devices von FHEM abzumelden und auf Werkseinstellung zu resetten.

Zum Test haucht man das Wandthermostat an oder hält es einige Zeit in der Hand bis die Temperatur steigt, nach etwa 3 Minuten sollte man auch am Thermostat Ventil einen Temperaturanstieg sehen.

==== Channel (Kanal) 02 _Climate ====
Dieser Kanal erlaubt es dem [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP|HM-TC-IT-WM-W-EU Funk-Wandthermostat]] den HM-CC-RT-DN zu steuern. Dazu müssen die beiden Geräte gepeert werden:

set <HM-TC-IT-WM-W-EU>_Climate peerChan 0 <HM-CC-RT-DN>_Climate single set

==== Channel (Kanal) 03 _WindowRec ====
Mit diesem Kanal können Fensterkontakte ([[HM-SEC-SC Tür-Fensterkontakt|HM-SEC-SC]] und [[HM-Sec-RHS Funk-Fenster-Drehgriffkontakt|HM-SEC-RHS]]) 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]] 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 <HM-CC-RT-DN>_WindowRec single set

Zum Löschen (=unpeeren) dieser Kopplung:
set <fensterSensor> peerChan 0 <HM-CC-RT-DN>_WindowRec single unset

'''Achtung''': Der Peer-(Lösch-)Vorgang muss erst am Fensterkontakt durch Drücken der Anlerntaste ausgelöst werden, und zwar auch dann, wenn der Fensterkontakt schon vorher mit FHEM gepairt wurde. Dann kann der oben genannte Befehl in FHEM abgesetzt werden. 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 <HM-CC-RT-DN>_WindowRec regSet winOpnTemp <Temp> <fensterSensor>

Weitere Hinweise im Forum, siehe {{Link2Forum|Topic=41541|Message=348044|LinkText=FHEM Forum-Beitrag]

==== Channel (Kanal) 04 _Clima ====
Dieser Kanal dient zum Einstellen der Betriebsparameter, auch [[#Temperaturlisten|Temperaturlisten]] sind hierauf zu übertragen.
Mit dem Modul [[Weekprofile|Wochenplan / Weekprofile]] können die Wochenpläne komfortabel in FHEM erstellt und an die Thermostate übertragen werden.

{{Hinweis|In älteren Versionen von FHEM wurde dieser Kanal durch ''autocreate'' als <code>_ClimRT_tr</code> angelegt. Der Hersteller hat hier offenbar die internen Bezeichnungen geändert, denn beim Vorläufermodell 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 <HM-CC-RT-DN>_Clima regSet valveMaxPos 80

Die interne "Fenster-auf"-Erkennung kann man wie folgt abschalten:
set <HM-CC-RT-DN>_Clima regSet winOpnMode off

==== Channel (Kanal) 05 _ClimaTeam ====
Dieser Kanal erlaubt es mehrere HM-CC-RT-DN zu einem "Team" zu gruppieren. 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 ''<HM-CC-RT-DN#1>_ClimaTeam'', ''<HM-CC-RT-DN#2>_ClimaTeam'', ..., ''<HM-CC-RT-DN#8>_ClimaTeam'' die Kanalbezeichnungen der jeweiligen ClimaTeam-Kanäle sind:
set <HM-CC-RT-DN#1>_ClimaTeam peerChan 0 <HM-CC-RT-DN#2>_ClimaTeam single
set <HM-CC-RT-DN#1>_ClimaTeam peerChan 0 <HM-CC-RT-DN#3>_ClimaTeam single
set <HM-CC-RT-DN#2>_ClimaTeam peerChan 0 <HM-CC-RT-DN#3>_ClimaTeam single
...

==== Channel (Kanal) 06 _remote ====
Dieser Kanal kann 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:
set <button> peerChan 0 <HM-CC-RT-DN>_remote single

=== Betriebsmodus Auto, Manu, Party (Urlaub) ===

Der HM-CC-RT-DN verfügt über drei Betriebsmodus: Auto, Manu (Manuell) und Party (Urlaub).

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

==== Modus Manu ====
Die Temperatur wird manuell eingestellt, das Wochenprogramm wird nicht abgearbeitet. "Manuell Einstellen" bedeutet entweder am Handrad oder durch Übermittlung eines "set desired temp"-Befehls von FHEM (oder equivalent von einer CCU).

==== Modus Party (Urlaub) ====
Die eingestellte Temperatur gilt bis zu einem gegebenen Endzeitpunkt, anschließend wechselt das Thermostat in den ''Auto''-Modus.

==== Welchen Modus nutzen? ====
Im Umfeld von FHEM sind alle drei Modi einsetzbar. Betrieb in "Auto" hat den Vorteil, dass bei Ausfall der FHEM-Instanz der Thermostat trotzdem noch die eingespeicherten Wochenprogramme abarbeitet. Nachteilig ist aber, dass die Steuerung komplexer wird, weil sowohl die Einstellungen am Thermostat als auch Schaltbefehle von FHEM das Verhalten beeinflussen. Vielfach wird daher im Umfeld von FHEM der Modus "Manu" benutzt, hier wird die Temperatur nur per einzelnem FHEM Schaltbefehl gesteuert, ausgelöst z.b. durch "at" Kommandos, Anwesenheitserkennung oder Bewegungsmelder. Sollte FHEM (oder die Funkverbindung) ausfallen, bleibt der Thermostat allerdings auf der letzten eingestellten Temperatur stehen.

Denkbar ist auch, den Modus "Auto" zu verwenden und dann die Steuerung per FHEM dadurch durchzuführen, dass durch FHEM die Wochenprogramme verändert werden. Dies verbindet zwar die Vorteil der vorgenannten Methoden, ist aber am Aufwendigsten in der Programmierung und erzeugt die höchste Funklast.

Auch der Urlaubsmodus ist einsetzbar, so kann beispielsweise bei Abwesenheit ein niedrigeres Temperaturprofil eingestellt werden, ohne dass eventuell vorhandene Temperaturlisten verändert werden müssen.

set <HM-CC-RT-DN>_Clima controlParty 16 06.12.13 16:30 09.12.13 05:00

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

{{Hinweis|
* Der Befehl muss auf dem Kanal 4 ''(_Clima)'' erfolgen.
* Es werden nur Uhrzeiten zu jeder vollen oder halben Stunde angenommen (Minuten also 00 oder 30).}}

Mit der folgenden Funktion <code>Urlaub()</code> kann man eine ganze Wohnung (also mehrere RTs) mit nur einem Befehl in den Party-Modus versetzen. Im Beispiel werden zwei Heizkörper ("Treppenhaus" und "Kammer") angesteuert.

Zu beachten sind folgende Dinge:
# Aktuelle Dateien (z.B. <code>10_CUL_HM</code>) verwenden!
# Bei dem ''controlParty''-Befehl ''kein'' Komma zwischen den Parametern.
# Bei der Funktion die Parameterübergabe definieren <code>($$$$$)</code>

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

'''Funktion:'''
<syntaxhighlight lang=perl>
my $Urlaub;
sub
Urlaub($$$$$)
{
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/;

# controlParty bei jedem HM-CC-RT-DN setzen.
for my $rt (qw(Kammer Treppenhaus)) {
fhem ("set $rt controlParty $temp $startDate $startTime $endDate $endTime");
}
}
</syntaxhighlight>

=== 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 HM-CC-RT-DN 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

Es gibt auch eine Tastensperre die nur das Umschalten des Modus (Auto, Manuell, Urlaub) am Gerät verhindert. Diese wird mit

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

eingeschaltet. Abschalten geht mit:

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

=== 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 Kommandos. 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 Burst-Modus benötigt mehr Leistung, das heißt die Batterien müssen häufiger gewechselt werden: Der RT muss den Receiver ständig empfangsbereit halten. Außerdem wachen bei jedem Burst ''alle'' Burst-Empfänger auf – egal an wen die Kommunikation gerichtet war.

'''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 dieses Konto deutlich - so können nicht mehr als 100 bursts /h gesendet werden - dann geht HMLAN in overload. Wenn zusätzliche Nachrichten gesendet werden sind es entsprechend weniger.
Es ist 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 Nachricht.

'''ConditionalBurst devices'''

Devices mit abschaltbarem Burst wie z.B. der ''HM-CC-RT-DN'' haben ein Register, ''burstRx'', mit dem das burst-Erwachen eingestellt werden kann.
Sendern, 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 [[HomeMatic HMInfo|HMinfo]] Befehl ''models'' um herauszufinden, welche Devices welchen Modus unterstützen.

'''Attribut burstAccess'''

Devices, die abschaltbaren burst haben kann man ein attribut burstAccess 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 conditional-Burst zu Verfügung steht, wird der burst gezielt vom User angestoßen.

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 [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]]). 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'' aktualisiert 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 ==
{{Randnotiz|RNTyp=r|RNText=* Für jeden separat zu steuernden HM-CC-RT-DN kann nur je ein Kanal eines virtuellen Devices als Temperatur- bzw. Fensterkontakt genutzt werden. Insbesondere die virtuellen Kanäle der VCCU eignen sich nicht dazu, mehrere HM-CC-RT-DN unabhängig voneinander anzusteuern!
* Die folgenden Beispiele sind nicht für Anfänger und Unwissende geeignet! Es gibt zahlreiche Stolpersteine:
# Die HMId für virtuelle Geräte muss einmalig im System sein. Sie muss selbst gewählt werden und es darf '''keine''' vorhandene ID verwendet werden!
# Es kann vorkommen, das beim Anlegen eines virtual Gerätes kein attr IODev gesetzt wird. Das Attribute ist aber notwendig, sonst arbeitet das Gerät nicht! Bitte kontrollieren und gegebenenfalls per Hand setzen
}}
grober Ablauf:
* erstelle ein virtuelles Device
* erstelle dazu einen virtuellen Kanal
* peere den Kanal mit dem RT (als Fenster-Kontakt oder als remote, wenn 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

Ggf noch interne "Fenster-auf" Erkennung abschalten
set <HM-CC-RT-DN>_Clima regSet winOpnMode off

Die virtuelle Tür wird dann entsprechend über ein Notify getriggert:
define notify_virtualKitchenDoor notify (Fensterkontakt_1|Fensterkontakt_2) {if($EVENT eq "open" and Value("virtualKitchenDoor") eq "set_postEvent closed"){fhem("set virtualKitchenDoor postEvent open")} elsif (Value("Fensterkontakt") eq "closed" && Value("Fensterkontakt_2") eq "closed") {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.

Sollte es Probleme geben, dass der RT des Öfteren wieder auf seine eigenen Messwerte wechselt, so sollte das Attr cyclicMsgOffset im Virtuellen Kanal beachtet werden. Näheres dazu ist ca. ab {{Link2Forum|Topic=45735|Message=572806|LinkText=hier}} im Forum zu finden.

== Auflistung und Beschreibung der Readings ==

Einige der Readings können via "regSet" parametriert werden.
Wobei der Registername etwas anders geschrieben wird als der Reading Name (ohne R-).

set <name> regSet <register> <value>
Beispiel für Reading R-winOpnPeriod erhöhen auf 60 Minuten:
set EG_Buero_THERMOSTAT_Clima regSet winOpnPeriod 60

Eine vollständige Liste erhält man auch, wenn man einen Falschen Register Namen angibt.
supported register are backOnTime boostPeriod boostPos btnLock btnNoBckLight burstRx cyclicInfoMsg cyclicInfoMsgDis dayTemp daylightSaveTime decalcTime decalcWeekday globalBtnLock localResDis lowBatLimitRT modePrioManu modePrioParty modusBtnLock nightTemp noMinMax4Manu pairCentral regAdaptive reguExtI reguExtP reguExtPstart reguIntI reguIntP reguIntPstart showInfo showWeekday sign tempMax tempMin tempOffset valveErrPos valveMaxPos valveOffsetRt winOpnBoost winOpnDetFall winOpnMode winOpnPeriod winOpnTempI

<table cellspacing="0" border="0">
<tr>
<td style="border-top: 2px solid #ffffff; border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Reading</font></td>
<td style="border-top: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Beispielwert</font></td>
<td style="border-top: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Mögliche Werte</font></td>
<td style="border-top: 2px solid #ffffff; border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Beschreibung</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">CommandAccepted</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">yes</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">yes; no</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Letztes Kommando akzeptiert (yes/ No)</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-boostPeriod</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">5 min</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1 min bis x min</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Zeit wie lange das Ventil im Boost Modus sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-boostPos</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="0.8" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">80%</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Ventilposition die im Boost Modus gesetzt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-btnNoBckLight</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-dayTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">21 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur die gesetzt werden soll, wenn das Sonnensymbol am Thermostat gedrückt wird. Ebenso wird bei dieser Solltemperatur das Sonnensymbol im Display angezeigt.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-daylightSaveTime</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-decalcTime</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="0.458333333333333" sdnum="1033;1033;H:MM"><font face="Arial" size=2 color="#CCCCCC">11:00</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;1033;H:MM"><font face="Arial" size=2 color="#CCCCCC">00:00 bis 23:59</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Uhrzeit wann die Entkalkungsfahrt durchgeführt werden soll. </font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-decalcWeekday</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Sat</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Mon; Tue; Wed; Thu; Fri; Sat; Sun</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Tag an dem die Entkalkungsfahrt durchgeführt werden soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-modePrioManu</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">all</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">all; ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-modePrioParty</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">all</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">all; ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-nightTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">17 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur die gesetzt werden soll, wenn das Mondsymbol am Thermostat gedrückt wird. Ebenso wird bei dieser Solltemperatur das Mondsymbol im Display angezeigt.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-noMinMax4Manu</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-regAdaptive</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguExtI</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="15" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">15</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguExtP</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="30" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">30</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguExtPstart</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="30" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">30</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguIntI</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="18" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">18</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguIntP</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="33" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">33</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguIntPstart</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="44" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">44</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-showInfo</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">time</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">date; time</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Zeige Datum oder Uhrzeit im Display an</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-showWeekday</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Zeige den Wochentag im Display an</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-sign</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-tempMax</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">30.5 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Größte einstellbare Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-tempMin</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">4.5 C</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Kleinste einstellbare Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-tempOffset</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">0.0K</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">0.0 bis ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Temperaturabweichung gemessene Temperatur vs. realer Temperatur in Grad Kelvin. Angabe in 0.5-Schritten ohne Einheitenzeichen, z.B. 0.5 oder -1.0</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-valveErrPos</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="0.15" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">15%</font></td>
<td align="left" valign=middle bgcolor="#333333" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-valveMaxPos</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="1" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">100%</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Maximale Ventilstellung die das Thermostat fahren darf.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-valveOffsetRt</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="0" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0%</font></td>
<td align="left" valign=middle bgcolor="#333333" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 Bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="52" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnBoost</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Startet nach dem Fensterschließen die Boostfunktion um unabhängig von der Raumtemperatur den Heizkörper eine Zeit x aufzuheizen. (Siehe R-boostPeriod & R-boostPos)</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-winOpnDetFall</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1.4 K</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">0.5 bis 2.5</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Temperatur Sturz zwischen zwei Messungen, die als Fenster offen erkannt werden.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnMode</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Thermostat soll anhand eines schnellen Temperaturabfalls erkennen, dass das Fenster geöffnet ist.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-winOpnPeriod</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">15 min</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1 bis 60 Minuten</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Dauer bis das Signal Fenster offen wieder entfernt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">12 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Temperatur die eingestellt werden soll, wenn das Fenster als offen erkannt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="104" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">07:00 20.0 22:30 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">incomplete = Daten werden mit Thermostat abgeglichen<br><br>Zeit/Temperaturangaben siehe Beispiel</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Tages Solltemperaturen abhängig von der Uhrzeit. <br>- Der Beginn um 00:00 ist nicht einzutragen. <br>- Es sind immer Paare einzutragen (Uhrzeit Temperatur). <br>- Der letzte Eintrag muss an jedem Tag 24:00 sein.<br>- Uhrzeiten sind auf halbe Stunden beschränkt. Einträge 08:00 und 08:30 sind gültig. 08:20 ist ungültig.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_1_tempListSun</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">07:00 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_2_tempListMon</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_3_tempListTue</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_4_tempListWed</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_5_tempListThu</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_6_tempListFri</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_tempList_State</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">verified</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">incomplete = Daten werden mit Thermostat abgeglichen<br>verified = Daten sind mit Thermostat abgeglichen</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Aktualisierungsstatus der Wochen Temperatur Einstellungen</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">ValvePosition</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="36" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">36</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">aktuelle Ventilstellung</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">boostTime</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-<br>1 min bis n min</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Zeit wie lange der Boostmodus noch aktiv ist.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="121" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">controlMode</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">auto</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">auto = Thermostat wird nach der TempListe gesteuert<br>manual = Die eingestellte Temperatur am Thermostat wird nicht verändert, außer bei Verwendung von WinOpn; <br>boost = Thermostat wird in den Boost Modus gesetzt. Siehe R-boostPeriod/Pos<br>day = Thermostat wird auf die eingestellte Tag Temperatur gesetzt (R-dayTemp).<br>night = Thermostat wird auf die eingestellte Nacht Temperatur gesetzt (R-nightTemp).</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Setzt das Thermostat in einen bestimmten Modus</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">desired-temp</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="22" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">22</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">N/A</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">measured-temp</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="23.2" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">23.2</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">N/A</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Isttemperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">partyEnd</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Ende Datum/Zeit in dem die Party Temperatur (partyTemp) gesetzt sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">partyStart</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Start Datum/Zeit in dem die Party Temperatur (partyTemp) gesetzt sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">partyTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-; 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Party Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">recentStateType</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">ack</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333" sdnum="1033;1033;M/D/YYYY H:MM"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-bottom: 2px solid #ffffff; border-left: 2px solid #ffffff" height="23" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">state</font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">T: 23.2 desired: 22.0 valve: 36</font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC"><br></font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Aktuelle Statusinformation</font></td>
</tr>
</table>

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

=== Der Thermostat heizt über die Solltemperatur hinaus ===
In der Regel ist das ein ganz normales Verhalten, wenn der Thermostat nicht mit einem externen Temperaturfühler oder einem Wandthermostat gepeert ist. In dem Fall muss sich der Thermostat auf den eingebauten Temperatursensor verlassen, der sehr nahe an der Heizung selbst sitzt. Dadurch ist die gemessene Temperatur höher, als sie z.B. in der Raummitte wäre. Der Hersteller hat hier einen mehr oder weniger intelligenten Algorithmus eingebaut, um diesen Effekt zu kompensieren. Das sieht dann so aus, als ob der Thermostat nicht richtig regelt.
Dieses Verhalten kann man im Prinzip nur verhindern, indem man einen externen Temperatursensor oder einen Wandthermostat peert. Wie das geht ist hier beschrieben: [[#Channel (Kanal) 01 _Weather]]. Normalerweise regelt der Thermostat dann genau auf die Solltemperatur.
Ansonsten sollte man sich auch fragen, ob das gezeigte Verhalten vielleicht doch gut genug ist. Dazu platziert man irgendein Thermometer möglichst in der Mitte des Raums und beobachtet den Temperaturverlauf eine Weile. Wenn man dann noch eine Abweichung feststellt, kann es sinnvoll sein, diese mittels des Registers R-tempOffset zu beheben.

== Links ==
* [http://www.eq-3.de/produkt-detail-aktoren/items/homematic-funk-heizkoerperthermostat.html Produktinfo bei EQ-3]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-CC-RT-DN_UM_GE_eQ-3_web.pdf Bedienungsanleitung bei EQ-3 (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/pdb/Funk-Heizkoerperthermostat_105155_Produktdatenblatt_V2.3.pdf Datenblatt bei EQ-3 (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads/Ventilkompatibilitaeten.pdf Ventil-Kompatibilitätsliste bei EQ-3 (zur Zeit nicht verfügbar)]
* {{Link2Forum|Topic=14738|LinkText=Forenthema zum Thermostat}}
* {{Link2Forum|Topic=64446|LinkText=Reparatur einer durch mechanischen Stoß von außen abgerissenen Lichtschranke}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Heizungsventile]]
[[Kategorie:868MHz]]

SONOS

2019-12-26T15:54:47Z

LHBL2003: /* Zusammenfassung der Spracheinrichtung */ Kurzanleitung für Sprachanleitung zusammengefasst

<div style="float:right">{{Infobox Modul
|ModPurpose=Anbindung des Sonos-Systems via UPnP
|ModType=d

|ModCmdRef=
|ModForumArea=Multimedia
|ModTechName=00_SONOS.pm
|ModOwner=Reinerlein
}}
{{Infobox Modul
|Name=SONOSPLAYER
|ModPurpose=Steuerung eines Sonos Zoneplayer
|ModType=d

|ModCmdRef=SONOSPLAYER
|ModForumArea=Multimedia
|ModTechName=21_SONOSPLAYER.pm
|ModOwner=Reinerlein
}}
</div>

Sonos ist ein Multiroom-Musiksystem der kalifornischen Firma [http://www.sonos.com Sonos].
Es bietet die Möglichkeit der verteilten Musikabspielung und Steuerung, sowie der Verknüpfung von mehreren Playern, um diese dasselbe abspielen zu lassen. Hierfür gibt es verschiedene Abspiel-Komponenten, die in einem eigenen Netzwerk miteinander kommunizieren und für verschiedene Anwendungsfälle konzipiert wurden.

Diese Beschreibung soll den Einstieg in die Steuerung der heimischen Zoneplayer erleichtern. Es werden die Verwendung und Einrichtung der dazugehörenden FHEM-Module '''SONOS''' und '''SONOSPLAYER''' beschrieben, und einige Beispiele für eine mehr oder weniger sinnvolle Nutzung von Events und Steuerungsmöglichkeiten gegeben.

Sollte etwas fehlen oder unklar sein, dann einfach eine kurze Nachricht an den Autor.

<div style="margin: 0; margin-top:10px; margin-right: 315px; border: 1px solid #dfdfdf; padding: 0 1em 0.3em 1em; background-color:#fff0e0;">
<center>'''! Achtung !'''</center>
Obwohl die Module in FHEM mitgeliefert werden, sind trotzdem die Vorbedingungen bzgl. der Perl-Installation unter [[#Softwarevoraussetzungen|Softwarevoraussetzungen]] einzuhalten, da das Modul sonst nicht lauffähig ist.
</div>

== Kurzüberblick ==
Hier soll nur ein kurzer Überblick über die mittlerweile doch recht umfangreichen Möglichkeiten geboten werden:
*Automatisches Erkennen aller ZonePlayer im lokalen Netzwerk. Dabei werden alle Player einer Paarung zusammengehörig benannt und gruppiert
*Automatische Aktualisierung aller aktuellen (und wenn verfügbar: der nächsten) Titelinformationen innerhalb von FHEM
**Dabei wird für jede veränderte Information ein Event erzeugt, man kann also dediziert darauf reagieren
**Bei normalen Abspiellisten werden auch die Informationen zum nächsten Titel ermittelt und angezeigt
**Es können auch verschiedene Zusammenfassungen der bestehenden Informationen zusammengestellt werden
*Anzeige des aktuellen (oder auch nächsten) Covers als Weblink oder [[readingsGroup]]
*Steuern der ZonePlayer: Play, Pause, Nächster Titel, Vorheriger Titel, Lautstärke Lauter/Leiser (auch als vordefinierte Rampe), Stummschalten
*Alle Player auf einen Befehl hin stoppen, pausieren oder stummschalten lassen
*Einstellen und Abfragen der Abspielparameter Repeat, RepeatOne, Shuffle, CrossfadeMode, Loudness, Bass und Treble
*Festlegen einer minimalen und maximalen Lautstärke für jeden ZonePlayer (getrennt zwischen Normalbetrieb und Kopfhörernutzung)
*Laden, Speichern und Löschen von Playlisten (Laden und Speichern: auch M3U-Dateien aus dem Filesystem)
*Abspielen eines Sonos-Favoriten (z.B. Playlist, Spotify-Playlist, Titel, Radiosender, usw.)
*Abspielen beliebiger Titel (auch von Freigaben, die nicht von Sonos indiziert wurden)
*Abspielen beliebiger Radiostationen über deren HTTP-Link
*Hinzufügen beliebiger Titel und Radiostationen zur aktuellen Abspielliste
*Temporäres Abspielen von Dateien, mit nachfolgender Wiederherstellung des vorherigen Titels inkl. genauer Position im vorherigen Titel und der Lautstärke
*Füllen der aktuellen Abspielliste mit nach diversen Kriterien zusammengesuchten Titeln aus der Sonos Bibliothek
*Erzeugen und temporäres Abspielen von Sprachdurchsagen auf Basis von eingegebenen Texten und vorhandenen MP3-Dateien
**Wird standardmäßig über die Google-Übersetzungsmaschine realisiert
**Kann auch über eine eigenständige, lokale Installation eines Text2Speech-Tools realisiert werden
*Auslesen und Setzen/Starten der verfügbaren gespeicherten Playlisten, Radiofavoriten und Sonos-Favoriten
*Erzeugung und Bearbeitung von Alarmen, sowie Event bei Veränderung der Alarme duch andere Controller
*Setzen des Sleeptimer inkl. FHEM-Event bei Veränderung durch andere Controller und Ablauf des Timers
*Setzen und Auslesen der Gruppierungskonfiguration, sowie einzelnes Hinzufügen und Entfernen von Gruppenmitgliedern
*Bildung und Trennung von Stereopaaren
*Erzeugen von Events nach festgelegten Tastensequenzen (am Player)
*Umbenennen der Zonen und festlegen der Zonenicons
*Standardanzeige eines Player als ReadingsGroup mit automatischem Titel- und Coverwechsel sowie einer RemoteControl zum Steuern
*Anzeigemöglichkeit einer Vollbilddarstellung ähnlich dem Original-Controller
*Definitionsmöglichkeit von automatischen Bookmarks, die beim Aufrufen derselben Playliste oder Titel die gespeicherte Position anspringen.

== Kurze Anmerkungen zur Sonos-Landschaftsgestaltung ==
Es ist im allgemeinen besser, die Sonos-Landschaft mit allen Paarungen vor dem Einrichten des Moduls zu erzeugen.
Dieses Modul benennt die FHEM-Playerdevices nach den Zonennamen und der jeweiligen Funktion des Players innerhalb der Paarung.

Das bedeutet aber auch, dass in diesem Augenblick möglichst keine Player gruppiert sein sollten (mehrere Zonen spielen dasselbe ab), da diese sonst komische Namen erhalten könnten (es geht hier ausschliesslich um die FHEM-interne Device-Benennung, natürlich bleiben die Zoneplayer selbst wie sie sind).<br />Insbesondere gilt das für temporäre Stereopaare. Diese nicht ständigen Paare sollten erst getrennt werden, bis das Modul alle Player erkannt und angelegt hat.

Damit man nun eine einigermaßen passende Bezeichnung in FHEM erhält, sollte also die Gestaltung der Sonos-Player abgeschlossen sein. Natürlich funktioniert das System nach einer FHEM-Einrichtung und anschließender Sonos-Umbenennung immer noch, da intern alles mittels der eindeutigen Bezeichner gehandhabt wird, allerdings wird es u.U. etwas unübersichtlich bzgl. der FHEM-Device-Namen. Diese passen dann nicht mehr zu den Zonennamen (die entsprechenden Readings werden aber natürlich korrekt besetzt), was man aber natürlich auch nachträglich wieder anpassen kann.

'''Hinweis:''' Man kann das Attribut ''disable'' am Sonos-Device setzen, um den Subprozess zu beenden. Damit kann man seine Zonenlandschaft später erweitern, ohne FHEM komplett abschalten zu müssen.
Nachdem die Einrichtung des neuen Zoneplayers abgeschlossen ist, löscht man das Attribut ''disable'' einfach wieder - der Subprozess startet und beginnt mit der Erkennung der neuen Komponenten.

== Einbindung von Sonos in FHEM ==
Die Einbindung erfolgt über die beiden Module '''SONOS''' und '''SONOSPLAYER'''. Dabei ist Hauptsächlich das Modul '''SONOS''' einzurichten. Alle Zoneplayer werden automatisch erkannt, und dann entsprechend angelegt:

<pre>define <Devicename> SONOS [<Hostname:Port> [Prüfintervall [WaitTime [DelayTime]]]]</pre>

=== Beispiele für die Einbindung ===
Einfachste Einbindung mit Standardwerten:
<pre>define Sonos SONOS</pre>

Einbindung mit Kontrolle über den verwendeten Port und das IsAlive Prüfintervall:
<pre>define Sonos SONOS localhost:4711 45</pre>

Der Name dieses Devices ist automatisch das Namensprefix beim Anlegen der SonosPlayer. In diesem Fall werden alle erkannten Zoneplayer mit dem Prefix "<code>Sonos_</code>" anfangen. Natürlich kann man das nach dem Anlegen einfach umbenennen.<br />Als Prüfintervall wurde hier 45s angegeben. Wenn kein Intervall angegeben wird, dann werden 30s verwendet.

<pre>define Sonos SONOS localhost:4711 30 1</pre>

Hier wurde eine verkürzte Wartezeit für den Subprozess von einer Sekunde angegeben. Bei schnellen Systemen wird dadurch der gesamte Startmechanismus schneller verarbeitet.<br />Wenn nichts angegeben wird, dann wird 8s verwendet, was einen guten Wert für einen Raspberry Pi darstellt.

<pre>define Sonos SONOS localhost:4711 30 1 5</pre>

Hier wurde noch eine zusätzliche Verzögerung von 5s eingebaut, da manche Systeme bei einem FHEM-Restart oder ähnlichem die belegten Ports nicht schnell genug wieder freigeben.<br />Hier kann diese Verzögerung helfen, da erst nach Ablauf dieser Zeitspanne ein Verbindungsversuch zum SubProzess unternommen wird (und auch erst dann der Versuch einen eigenen Prozess zu Starten unternommen wird).<br />Wenn nichts angegeben wird, dann wird keine Verzögerung durchgeführt.

=== Namensvergabe der automatischen Erkennung ===
Der automatische Erkennungsmechanismus vergibt Devicenamen auf Basis der Zonennamen und der Funktion eines Players innerhalb eines Stereopaares oder einer Surroundkonstellation.
Dabei wird immer ein Player (der Master dieser Konstellationen) nur den Namen der Zone erhalten (ohne Anhängekürzel) und die anderen werden mit Kürzel versehen. Dadurch ist der Master der Zone automatisch dasjenige Playerdevice, welches gesteuert werden muss. Alle anderen Player leiten Steueranfragen automatisch an den Master weiter.
Besteht eine Zone nur aus einem Player, so gibt es natürlich auch nur diesen einen als Master.

Als Anhängekürzel wird immer der Inhalt des Readings '''fieldType''' verwendet.

Bei der Funktion gibt es später dann zwei Fälle zu unterscheiden:
*Stereopaare werden von Sonos intern als Gruppe behandelt. Das bedeutet, dass der zweite Player (der nicht-Master) immer ''PLAYING'' als Status anzeigt, und nur der Master den korrekten Wert. Stereopaare haben, wie normale Gruppen oder Einzelplayer auch, eine Verzögerung von 70ms zu einem Eingangssignal.
*Surroundsysteme werden als Satelliten angebunden, und werden vom Modul nur mit ''intialized'' angegeben, da Sonos für diese nie eine Statusmeldung sendet. Diese Playersysteme haben eine verkürzte Verzögerung von 30ms zu einem Eingangssignal.

Dabei ist ein Eingangsignal so etwas wie ein Line-In- oder SPDIF-Eingang.

==== Beispiel für eine Zonenlandschaft ====
Folgende Landschaft mit Status könnte es geben:
<pre>
Sonos_Schlafzimmer (STOPPED => [Keine Musikdatei])
Sonos_Schlafzimmer_RF (PLAYING => 'Keine Titelinformation bei Gruppenwiedergabe')
Sonos_Kinderzimmer (PAUSED_PLAYBACK => 'Titelinformation')
Sonos_Gaestezimmer (STOPPED => [Keine Musikdatei])
Sonos_Wohnzimmer (STOPPED => [Keine Musikdatei])
Sonos_Wohnzimmer_LR (initialized)
Sonos_Wohnzimmer_RR (initialized)
Sonos_Wohnzimmer_SW (initialized)
</pre>
Dabei wäre Schlafzimmer ein Stereopaar, Kinder- und Gästezimmer jeweils ein einzelner Player und Wohnzimmer z.B. eine Playbar mit zwei Rear-Lautsprechern und Subwoofer. In keiner Zone läuft eine aktive Wiedergabe.
Hier kann man schön die einzelnen Zustände und die erzeugten Namen erkennen.

=== Zusammenfassung der Spracheinrichtung ===
Um die Sprachausgabe des Moduls nutzen zu können, müssen einige Grundvoraussetzungen geschaffen werden.
Hier soll nur eine kurze Übersicht geschaffen werden, was alles getan werden muss. Die einzelnen Themen selbst sind in diesem Wiki-Artikel bereits beschrieben.
*Es muss einen Speicherplatz für Dateien geben, wo das Sonos-Modul (also FHEM) schreibend zugreifen kann, und das Sonos-System selbst lesend zugreifen kann. Das Sonos-System versucht immer ohne Passwort zuzugreifen, FHEM mit seinem Benutzerkontext
**Dafür kann man sich z.B. auf dem lokalen Debian-System (sofern FHEM darauf läuft) eine Samba-Freigabe einrichten. Das ist unter "[[#Einrichtung von Samba für Sprachausgabemöglichkeit|Einrichtung von Samba für Sprachausgabemöglichkeit]]" beschrieben.
**Man kann sich auch auf einem bestehenden NAS-System einen Ordner extra für diesen Zweck anlegen und entsprechend freigeben
**Bei Problemen bitte die Datei-/Ordnerrechte genauestens prüfen, notfalls mit einem Windows-/Macrechner einen direkten Zugriffstest durchführen. Hier sind die häufigsten Fehlerquellen zu suchen.
*Es müssen mindestens die Attribute '''targetSpeakDir''' und '''targetSpeakURL''' am FHEM-Sonos-Device gesetzt werden. Diese Attribute werden bei den "[[#Sprachattribute|Sonos Sprachattributen]]" beschrieben.
*Empfehlenswert ist auch das Setzen eines der Attribute '''targetSpeakFileTimestamp''' oder '''targetSpeakFileHashCache''' am FHEM-Sonos-Device. Damit werden Indizierungsprobleme des Sonos-Systems umgangen. Es ist nicht sinnvoll beide Attribute gleichzeitig zu setzen. Auch diese Attribute werden bei den "[[#Sprachattribute|Sonos Sprachattributen]]" beschrieben.
*Wenn man die Möglichkeit der in den Text eingebetteten MP3-Dateien nutzen möchte, ist es empfehlenswert, das Attribut '''targetSpeakMP3FileDir''' für den Standardpfad der Jingles zu setzen. Damit werden die einzugebenden Texte deutlich übersichtlicher.
*Bei Bedarf kann man sich ein lokales Programm installieren und dem Modul angeben, welches die Sprachausgabedatei erzeugt.<br />Das sollte man nicht als Anfänger tun!
**Unter [[#Beispiel für einen Offline-Sprachsynthetisierer|Beispiel für einen Offline-Sprachsynthetisierer]] ist das am Beispiel von ''espeak'' beschrieben.
**Das Programm kann man dem Modul mit den Attributen ''Speak1'', ''Speak2'', ''Speak3'' und ''Speak4'' einstellen. Also bis zu vier verschiedene. Diese Attribute werden ebenfalls bei den "[[#Sprachattribute|Sonos Sprachattributen]]" beschrieben.
*Mit einem Shell-Skript kann man den Cacheordner für die Sprachausgabe bereinigen lassen. Unter [[#Beispiel für ein Shell-Skript zum Aufräumen eines Speak-Verzeichnisses|Beispiel für ein Shell-Skript zum Aufräumen eines Speak-Verzeichnisses]] gibt es den Code.

=== Schnelleinrichtung einer Sprachausgabe ===
Siehe auch: "[[#Einrichtung von Samba für Sprachausgabemöglichkeit|Einrichtung von Samba für Sprachausgabemöglichkeit]]", "[[#Sprachattribute|Sonos Sprachattributen]]", "[[#Beispiel für eine Sprachdurchsage auf Basis eines Notify|Beispiel für eine Sprachdurchsage auf Basis eines Notify]]"

-FHEM Befehl zum Aktualisieren auslösen:
update
-Raspberry PI neustarten (SSH):
shutdown restart
-Software nachinstallieren mit User root (SSH):
sudo apt-get update && sudo apt-get -y install libwww-perl libsoap-lite-perl libxml-parser-lite-perl
-Samba Installieren (SSH):
sudo apt-get update && sudo apt-get -y install samba samba-common-bin
-Ordner Anlegen (SSH):
sudo mkdir -p /opt/fhem/SonosSpeak
-Ordner Rechte geben (SSH):
sudo chmod 777 /opt/fhem/SonosSpeak
-SMB Konfigurationsdatei öffnen:
sudo nano /etc/samba/smb.conf

-Folgenden Eintrag ergenzen:
[global]
security = user
map to guest = bad user

-Folgenden Eintrag am Ende hinzufügen:
[SonosSpeak]
comment = Audio-Files for SonosPlayer to Speak
read only = false
path = /opt/fhem/SonosSpeak
guest ok = yes

-Neustart Samba (SSH):
sudo /etc/init.d/samba restart

-Sonos Schnittstelle in FHEM anlegen:
define Sonos SONOS
Hinweis: Es wird ein Raum Sonos angelegt indem Automatisch die Sonos Lautsprecher bedienelemente importiert werden.
Ebenso werden unter undefine weitere Elemente angelegt.

Via FHEM Befehl weitere Einstellungen in der Schnittstelle vornehmen:
-Pfad in dem FHEM die mp3 Datei ablegt:
attr Sonos targetSpeakDir /opt/fhem/SonosSpeak
-Pfad für den Sonos lautsprecher:
attr Sonos targetSpeakURL \\<ip-Adresse-oder-der-Name-des-raspberry>\SonosSpeak
-Zeitstempel an Dateinamen anhängen, damit Sonos keine alten Daten aus dem Cash nutzt:
attr Sonos targetSpeakFileTimestamp 1
-Für eingebettete MP3 Dateien:
attr Sonos targetSpeakMP3FileDir /opt/fhem/SonosSpeak
-FHEM Befehl Konfiguration speichern:
Save config
-Raspberry PI neustarten (SSH):
shutdown restart
-Sprachausgabe Testen:
set NameDesAngelegtenLautsprechersImSonosRaum Speak 30 de Der auszugebene Text.

=== Zusammenfassung der Bookmarkeinrichtung ===
Da die Möglichkeiten mit den Bookmarks sehr vielfältig sind, soll in dieser kleinen Zusammenfassung ein Überblick gegeben werden.

Grundsätzlich muss zwischen den beiden Grundbereichen für Bookmarks unterschieden werden. Diese können unabhängig voneinander verwendet werden:
*Bookmarks für die aktuelle Abspielliste/Playlisten
*Bookmarks für Titel

Bei den Listen wird über die aktuelle Abspielliste (also alle Titel die gerade so abgespielt werden sollen) ein Hashwert gebildet, und mit diesem der aktuelle Titel (genauer: die Tracknummer) zusammen mit einem Zeitstempel gespeichert.

Bei den Titeln wird für jeden Titel die genaue Position im Titel zusammen mit einem Zeitstempel gespeichert, wenn der Titel gewechselt wird.

Beide Bereiche behandeln also getrennte Situationen und können jeder für sich, aber auch gemeinsam, sinnvoll eingesetzt werden.

Die Konfiguration der Bookmarks wird erst bei einem Neustart des SubProzesses (also durch einen FHEM-Neustart (vorher Speichern nicht vergessen) oder dem Setzen/Zurücksetzen des Attributs '''disable''' am Sonos-Device) berücksichtigt.

Mit den Befehlen ''DisableBookmark'' und ''EnableBookmark'' können Bookmark-Gruppen (temporär) deaktiviert bzw. wieder aktiviert werden.<br />'''Achtung''': Diese Änderung gilt nur bis zum nächsten FHEM Neustart, da dieser Zustand nicht in die Definition (also das Attribut) zurückgeschrieben wird.

Die im Arbeitsspeicher gehaltenen Bookmarks werden beim Starten des SubProzesses aus den vorhandenen Dateien geladen, und beim Beenden entsprechend dort gespeichert.
Man kann mit dem Befehl '''SaveBookmarks''' (oder entsprechend '''LoadBookmarks''') diesen Vorgang selber anstossen.
Bei einem globalen Save-Aufruf (also dem FHEM-Befehl ''''save'''') werden die Bookmark-Daten ebenfalls gesichert.

Die komplette Verarbeitung der Bookmarks erfolgt im SubProzess (zunächst mal ohne FHEM-Interaktion) und damit sehr nah an den Ereignissen des Players.
Im Normalfall hört man z.B. beim Sprung innerhalb eines Titel (nach einem Wechsel des Titels) gerade mal ein kurzes Zucken des Titels, bevor dieser schon ''vorgespult'' wird.
Beim Anspringen eines Titels in der aktuellen Abspielliste (wegen der Hash-Berechnung, je nach Länge der aktuellen Abspielliste) etwas länger, aber bei mir deutlich unter einer Sekunde.
FHEM ist nur insoweit involviert, da die Sprungaktionen abschließend als '''LastActionResult'''-Aktualisierungen gemeldet werden.

==== Attribute für Bookmarks am Sonos-Device ====
*<code>bookmarkSaveDir</code>: Verzeichnis, wo die Bookmarkdateien abgelegt und geladen werden sollen
*<code>bookmarkPlaylistDefinition</code>: Definition für Playlist-Bookmarks
*<code>bookmarkTitleDefinition</code>: Definition für Titel-Bookmarks

==== Readings für Bookmarks am Sonosplayer-Device ====
*<code>QueueHash</code>: Der Hash-Wert für die aktuelle Abspielliste. Damit kann man in eigenen Events bei Bedarf Dinge selber entsprechend verarbeiten.

==== Bookmarks für die aktuelle Abspielliste/Playlisten ====
Attributname am Sonos-Device:<br />
<code>bookmarkPlaylistDefinition</code>

Definition:<br />
<code><Groupname>:<PlayerDeviceRegEx>:<MinListLength>:<MaxListLength>:<MaxAge> [...]</code>

Bedeutung:
*<code>Groupname</code>: Ein beliebiger Name, der auch als Dateiname verwendet werden kann und keinerlei Sonder-/Leerzeichen enthält
*<code>PlayerDeviceRegEx</code>: Ein regulärer Ausdruck, der für das Matching der zu berücksichtigten Player verwendet wird. Das Matching erfolgt auf dem FHEM-Devicenamen. Wenn nicht angegeben, dann wird ''''.*'''' verwendet.
*<code>MinListLength</code>: Eine Zahl die angibt, wieviel Titel eine aktuelle Abspielliste mindestens haben muss, um berücksichtigt zu werden. Wenn nicht angegeben, dann wird ''''0'''' verwendet.
*<code>MaxListLength</code>: Eine Zahl die angibt, wieviel Titel eine aktuelle Abspielliste maximal haben darf, um berücksichtigt zu werden. Wenn nicht angegeben, dann wird ''''99999'''' verwendet.
*<code>MaxAge</code>: Das maximale Alter für die Verwendung eines gespeicherten Bookmarks in Sekunden. Hier kann ein beliebiger Perl-Ausdruck (natürlich ohne Doppelpunkte) verwendet werden, der zu einer Zahl evaluierbar sein muss. Wenn nicht angegeben, dann wird ''''28*24*60*60'''' (also vier Wochen) verwendet.

Nach hinten hin dürfen die Doppelpunkte von leergelassenen Werten ebenfalls weggelassen werden.

Es können beliebig viele Gruppen mit diversen (auch überlappenden) Bereichen gebildet werden. Diese verschiedenen Gruppen werden mit Leerzeichen getrennt, sodass innerhalb einer Bookmarkdefinition selbst keinerlei Leerzeichen vorkommen dürfen.

Die Dateinamen für das Speichern und Laden werden wie folgt gebildet: <bookmarkSaveDir>/BookmarkPlaylist_<BookmarkGroupName>.save

Beispiele
*<code>Eltern:Sonos_(Schlaf|Wohn|Ess)zimmer</code><br />Hiermit wird eine Gruppe mit dem Namen '''Eltern''' definiert, die alle Listen, die auf den drei Playern '''Schlafzimmer''', '''Wohnzimmer''' und '''Esszimmer''' verwendet werden, beachtet.
*<code>Kind1:Sonos_Kind1:0:5</code><br />Hiermit wird eine Gruppe '''Kind1''' definiert, die alle Listen, die mindestens 0 und maximal 5 Titel haben, berücksichtigt.
*<code>All</code><br />Alle Listen aller Player werden berücksichtigt.

==== Bookmarks für Titel ====
Attributname am Sonos-Device:<br />
<code>bookmarkTitleDefinition</code>

Definition:<br />
<code><Groupname>:<PlayerdeviceRegEx>:<TrackURIRegEx>:<MinTitleLength>:<RemainingLength>:<MaxAge>:<ReadOnly> [...]</code>

Bedeutung:
*<code>Groupname</code>: Ein beliebiger Name, der auch als Dateiname verwendet werden kann und keinerlei Sonder-/Leerzeichen enthält
*<code>PlayerDeviceRegEx</code>: Ein regulärer Ausdruck, der für das Matching der zu berücksichtigten Player verwendet wird. Das Matching erfolgt auf dem FHEM-Devicenamen. Wenn nicht angegeben, dann wird ''''.*'''' verwendet.
*<code>TrackURIRegEx</code>: Ein regulärer Ausdruck, der für das Matching der zu berücksichtigten Titel verwendet wird. Wenn nicht angegeben, dann wird '''.*'''' verwendet.
*<code>MinTitleLength</code>: Die minimale Lieddauer in Sekunden, die der Titel lang sein muss, um berücksichtigt zu werden. Wenn nicht angegeben, dann wird ''''60'''' verwendet.
*<code>RemainingLength</code>: Die minimale Restspielzeit in Sekunden, die ein Titel noch haben muss, um berücksichtigt zu werden. Wenn nicht angegeben, dann wird ''''10'''' verwendet.
*<code>MaxAge</code>: Das maximale Alter für die Verwendung eines gespeicherten Bookmarks in Sekunden. Hier kann ein beliebiger Perl-Ausdruck (natürlich ohne Doppelpunkte) verwendet werden, der zu einer Zahl evaluierbar sein muss. Wenn nicht angegeben, dann wird ''''28*24*60*60'''' (also vier Wochen) verwendet.
*<code>ReadOnly</code>: Wenn hier etwas angegeben wird, was von Perl als '''true''' erkannt wird, dann wird diese Gruppe beim Aufruf von '''SaveBookmarks''' (also auch beim Beenden von FHEM) nicht berücksichtigt. Wenn nicht angegeben, dann wird ''''0'''' verwendet (die Gruppe wird also gespeichert).

Nach hinten hin dürfen die Doppelpunkte von leergelassenen Werten ebenfalls weggelassen werden.

Es können beliebig viele Gruppen mit diversen (auch überlappenden) Bereichen gebildet werden. Diese verschiedenen Gruppen werden mit Leerzeichen getrennt, sodass innerhalb einer Bookmarkdefinition selbst keinerlei Leerzeichen vorkommen dürfen.

Die Dateinamen für das Speichern und Laden werden wie folgt gebildet: <bookmarkSaveDir>/Bookmark_<BookmarkGroupName>.save

Beispiele
*<code>Eltern:Sonos_(Schlaf|Wohn|Ess)zimmer</code><br />Hiermit wird eine Gruppe mit dem Namen '''Eltern''' definiert, die alle Titel, die auf den drei Playern '''Schlafzimmer''', '''Wohnzimmer''' und '''Esszimmer''' laufen, beachtet.
*<code>Kind1:Sonos_Kind1:.*?\/Hörspiele\/.*:240:30</code><br />Hiermit wird eine Gruppe '''Kind1''' definiert, die alle Titel, die im Pfad den Teil '''/Hörspiele/''' enthalten, mindestens 240 Sekunden (also vier Minuten) lang und mehr als 30 Sekunden vom Ende entfernt sind, berücksichtigt.
*<code>All</code><br />Alle Titel aller Player werden berücksichtigt.

==== Hinweise ====
*Beim Speichern/Laden kann der Einfachheit halber nur der Gruppenname mitgegeben werden. Gibt es sowohl im Bereich Playlist als auch im Bereich Titel eine Gruppe mit diesem Namen, dann werden beide gespeichert/geladen. Wenn man das verhindern möchte, dann müssen die Gruppennamen global eindeutig sein.

== Hardware-/Betriebssystemvoraussetzungen ==
Diese Liste sollte im Laufe der Zeit fortgeführt werden. Es soll die Hardware-/Softwarevoraussetzungen festhalten, um Probleme im Vorfeld erkennen zu können.

Funktionierende Kombinationen:
*Windows, ActivePerl 32Bit (zusätzliche Pakete sollten dort mit Hilfe des mitgelieferten, grafischen Paketmanagers installiert werden)
*Raspberry Pi, Default-Perl
*Mac Mini, Perl 5.18 mit ''-useThreads'' kompiliert

Problematische Kombinationen:
*FritzBox: Anscheinend ist Perl dort ohne Thread-Möglichkeit kompiliert. Diese sind aber essentiell notwendig für dieses Modul.
*Windows, ActivePerl 64Bit (das Paket SOAP::Lite gibt es momentan nicht für 64Bit)

== Anpassungen bei Nutzung von IPTables als Firewall ==
Benutzt man bereits IPTables, so müssen folgende Regeln hinzugefügt werden. z.B. unter /etc/defauts/iptables

*filter
:INPUT DROP [0:0]
:FORWARD DROP [0:0]
:OUTPUT ACCEPT [0:0]

# Sonos Kommunikation
-A INPUT -m pkttype --pkt-type multicast -j ACCEPT
-A INPUT -s 224.0.0.0/8 -j ACCEPT

# alles im lokalen LAN
-A INPUT -s 192.168.0.0/16 -j ACCEPT

== Softwarevoraussetzungen ==
Für die Verwendung sind Perlmodule notwendig, die unter Umständen noch nachinstalliert werden müssen:
*'''LWP::Simple'''
*'''LWP::UserAgent'''
*'''SOAP::Lite'''
*'''HTTP::Request'''
*('''XML::Parser::Lite''')<br />Ist im Normalfall im Standardpaket von Perl enthalten. Kann aber u.U. fehlen (scheint unter Ubuntu und verschiedenen Debian-Systemen so zu sein), und muss dann manuell nachinstalliert werden.

Die Installation dieser Module geht in der Regel per CPAN. Das bedeutet das zum Beispiel mit
<pre>
sudo cpan LWP::Simple
</pre>
das Modul "<code>LWP::Simple</code>" installiert wird. Wenn man bereits als Benutzer '''root''' arbeitet, dann ist das <code>sudo</code> natürlich nicht nötig.

Sollte es bei der Installation mittels CPAN zu Problemen kommen, dann folgt hier eine Beschreibung der manuellen Installation.

=== Hinweis für Debian-Systeme ===
Bei Debian-basierten Systemen (also auch Raspbian für den Raspberry Pi oder Ubuntu usw.) kann auch mittels
<pre>
sudo apt-get install <paketname>
</pre>
installiert werden. Manchmal ist es etwas schwieriger, die Paketnamen zu ermitteln, aber Google ist da sehr hilfreich.

Hier mal die Liste für die oben genannten Pakete:
*'''LWP::Simple'''-Paketname (inkl. '''LWP::UserAgent''' und '''HTTP::Request'''): <code>libwww-perl</code>
*'''SOAP::Lite'''-Paketname: <code>libsoap-lite-perl</code>
*'''XML::Parser::Lite'''-Paketname: <code>libxml-parser-lite-perl</code> oder falls nicht verfügbar <code>libxml-parser-perl</code>

=== Hinweis für Windows-Systeme mit ActivePerl ===
Bei Windows Systemen mit ActivePerl kann man die Installation über den ActivePerl Packagemanager durchführen:
*Installation von Package LWP (inkl. LWP::UserAgent und HTTP::Request)
*Installation von Package SOAP::Lite
**SOAP::Lite-Besonderheit für Versionen nach 5.18:
***Eine neue Paketquelle aus den Vorschlägen oder manuell hinzufügen: Bribes de Perl (http://www.bribes.org/perl/ppm)
***Installation von Package: SOAP::Lite

'''Hinweis:''' Windows ActivePerl 64Bit kann momentan nicht verwendet werden, da es das Paket SOAP::Lite aktuell nicht gibt.

=== Manuelle Installation LWP::Simple ===
Wenn sich dieses Paket nicht einfach per CPAN-Anweisung installieren läßt, dann hilft folgende Anleitung weiter.
Beim Abbruch der Installation mittels CPAN erscheint mittendrin ein Fehler, das die Datei nicht entpackt werden könne (couldn't untar). Da scheint es einen Fehler im Installationsskript zu geben.

Man kann das aber auch Manuell installieren:
*Am Einfachsten ist ein Wechsel in den Kontext des Benutzers '''root''': "<code>sudo su -</code>"
*Erstellen eines Ordners, z.B. "<code>mkdir lwpsimple</code>"
*Wechsel in diesen Ordner "<code>cd lwpsimple</code>"
*Herunterladen der Datei von [http://search.cpan.org/~gaas/libwww-perl-6.04/ libwww-perl-6.04] oder direkter Link: [http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/libwww-perl-6.04.tar.gz libwww-perl-6.04.tar.gz]: z.B. "<code>wget http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/libwww-perl-6.04.tar.gz</code>"
*Entpacken der Datei: "<code>tar -xzvf libwww-perl-6.04.tar.gz</code>"
*Wechsel in das neu entstandene Verzeichnis: "<code>cd libwww-perl-6.04</code>"
*Nun kann es nach dem Standardvorgehen weitergehen:
**"<code>perl Makefile.PL</code>"
**"<code>make</code>"
**"<code>make install</code>"

=== Manuelle Installation SOAP::Lite ===
Wenn sich dieses Paket nicht einfach per CPAN-Anweisung installieren läßt, dann hilft folgende Anleitung weiter.
Beim Abbruch der Installation mittels CPAN erscheint mittendrin ein Fehler, das die Datei nicht entpackt werden könne (couldn't untar). Da scheint es einen Fehler im Installationsskript zu geben.

Man kann das aber auch Manuell installieren:
*Am Einfachsten ist ein Wechsel in den Kontext des Benutzers '''root''': "<code>sudo su -</code>"
*Erstellen eines Ordners, z.B. "<code>mkdir soaplite</code>"
*Wechsel in diesen Ordner "<code>cd soaplite</code>"
*Herunterladen der Datei von [http://search.cpan.org/~mkutter/SOAP-Lite-0.715/ CPAN-SOAP-Lite-0.715] oder direkter Link: [http://mirror.informatik.uni-mannheim.de/pub/mirrors/CPAN/authors/id/M/MK/MKUTTER/SOAP-Lite-0.715.tar.gz SOAP-Lite-0.715.tar.gz]: z.B. "<code>wget http://mirror.informatik.uni-mannheim.de/pub/mirrors/CPAN/authors/id/M/MK/MKUTTER/SOAP-Lite-0.715.tar.gz</code>"
*Entpacken der Datei: "<code>tar -xzvf SOAP-Lite-0.715.tar.gz</code>"
*Wechsel in das neu entstandene Verzeichnis: "<code>cd SOAP-Lite-0.715</code>"
*Nun kann es nach der [http://www.soaplite.com/2003/06/installation_in.html Anleitung] weitergehen:
**"<code>perl Makefile.PL</code>"
**Dann kommt eine Nachfrage, was zusammengebaut werden soll. An dieser Stelle ist es jetzt wie eine normale CPAN Installation. Einfach mit <Enter> weitermachen lassen.
**"<code>make</code>"
**"<code>make install</code>"

=== Einrichtung von Samba für Sprachausgabemöglichkeit ===
Wenn die Sprachausgabe verwendet werden soll, muss ein lokaler Samba-Daemon (Server für Windowsfreigaben) laufen oder eine für FHEM beschreibbare (Windows-)Freigabe woanders existieren, da Sonos nur auf eine solche lesend zugreifen kann.

Diese Beschreibung soll anhand des Raspberry-Pi (und anderer Debian-Systeme) zeigen, wie man einen solchen lokalen Samba-Server schnell für diesen Zweck einrichten kann:
*Lokales Verzeichnis für die Ablage der Tondateien erzeugen. z.B.:
<pre>
sudo mkdir /mnt/SonosSpeak
sudo chmod 777 /mnt/SonosSpeak/
</pre>
*Installation der notwendigen Pakete für Samba: <pre>sudo apt-get install samba samba-common-bin</pre>
*Starten des Editors zum Anpassen der Konfigurationsdatei: <pre>sudo nano /etc/samba/smb.conf</pre>
*Ist die Datei Original von der Raspbian Installation, muss außer dem Eintrag für das Share nichts geändert werden! Folgende Zeilen am Ende der smb.conf hinzufügen (Pfade müssen natürlich u.U. angepasst werden):
<pre>
[SonosSpeak]
comment = Audio-Files for SonosPlayer to Speak
read only = false
path = /mnt/SonosSpeak
guest ok = yes
</pre>
*Falls der Zugriff nicht funktioniert, ist eventuell die smb.conf nicht im Originalzustand:
**Sicherstellen, dass in der ''Global''-Sektion der Parameter ''Security'' nicht definiert wurde oder auf ''security = user'' steht und der Eintrag ''map to guest = bad user'' noch vorhanden ist.
{{Randnotiz|RNText=Hinweis: Siehe auch https://forum.fhem.de/index.php/topic,79335.msg719716.html#msg719716}}
<pre>
[global]
security = user
map to guest = bad user
</pre>
*Samba-Server neustarten:
<pre>sudo systemctl restart smbd</pre>
Ältere Systeme
<pre>sudo /etc/init.d/samba restart</pre>

Damit wird eine Freigabe mit dem Namen '''SonosSpeak''' erzeugt, die von allen ohne Anmeldung gelesen und beschrieben werden kann.

== Interner Aufbau ==
Um die Kommunikation mit dem UPnP-Netzwerk parallel zum normalen Betrieb von FHEM zu ermöglichen, werden [http://perldoc.perl.org/threads.html Threads] eingesetzt. Dadurch sind manche Hardwareplattformen leider überfordert und können u.U. nicht mit diesem Modul verwendet werden.<br />Das läßt sich aus technologischen Gründen auch nicht umgehen.

Dabei wird der SubThread verwendet um die Callback-Aufrufe, die erfolgen, wenn z.B. eine Statusänderung eines Players erfolgt, zu verarbeiten. Die Aktualisierung der Daten selbst wird dann über eine interne [http://perldoc.perl.org/Thread/Queue.html Queue] "nach oben" zum Hauptthread übertragen, und dann mittels einer bestehenden TCP-Verbindung zur Verarbeitung in FHEM übertragen.<br /> Dadurch wird gewährleistet, dass die Daten immer im Hauptthread (also dem "eigentlichen" FHEM-Thread) verfügbar sind.

Da dieser SubThread auch die Kommandoübergabe an den Player übernimmt, gibt es auch eine Kommando-Queue in die andere Richtung, die dann mittels eines Thread-Signals im SubThread-Kontext ausgeführt wird.

Dieser Aufbau sorgt natürlich dafür, dass man auf die üblichen Nebenläufigskeitsprobleme achten muss (in der Hauptsache sind das Dead-Locks, da man oftmals über drei Ecken aufeinander wartet, ohne das direkt zu sehen). Deswegen wird in allen Log-Ausgaben des Moduls ein Kürzel vorangestellt: "<code>SONOS_</code>", wobei der Unterstrich durch die Nummer des aktiven, loggenden, Threads ersetzt wird. Damit kann man sehr leicht feststellen, auf welcher "Ebene" diese Ausgabe erfolgt ist, und ob das alles so seine Richtigkeit hat.

Der Rest sind nur viele Zeilen, die XML-Strukturen (mittels regulärer Ausdrücke) parsen oder erzeugen, und die entsprechenden Informationen setzen oder abfragen.

== Installation des Moduls selbst ==
Hier wird die Installation des eigentlichen Moduls beschrieben, sowie ein Changelog ausgegeben, damit man nachvollziehen kann, was am Modul so passiert ist. Dieser Changelog steht auch in der Datei 00_SONOS.pm.

=== Installation mittels FHEM-Updatemechanismus ===
Dieses Modul wird seit Dezember 2014 zusammen mit FHEM ausgeliefert. Es sind keine weiteren Schritte zur Installation des Moduls selbst notwendig.

=== Fehlersuche ===
Da das Modul noch in der Entwicklung steht, und natürlich sowieso immer wieder Probleme auftauchen können, hier ein paar Hinweise zur Fehlersuche:
Das Modul besteht zunächst aus zwei Ebenen:
*Eine Ebene, die innerhalb von FHEM selbst läuft
*Eine Ebene, die als eigenständiger Prozess läuft (entweder durch FHEM selbst oder manuell angestartet)

Die Logausgaben der ersten Ebene landen direkt im FHEM-Log, die der zweiten Ebene können dort nicht reingeschrieben werden, und landen dementsprechend auf der Konsole (genauer: auf STDOUT).
Wenn man also die Log-Ausgaben dieses Sub-Prozesses sehen möchte, muss man im Startskript den STDOUT entsprechend umlenken, oder einen manuellen Start ausführen:
<code>sudo perl fhem.pl fhem.cfg</code>
Dazu muss man natürlich vorher in das entsprechende Verzeichnis wechseln.

Die Menge der Logausgaben werden, wie in FHEM üblich, über das Attribut Verbose am Sonos-Device gesteuert (Bis auf wenige Zeilen beim Start des Sub-Prozesses, die nur mit dem globalen Verbose-Attribut gesteuert werden können, da noch keine Verbindung besteht).

'''Hinweis!''': <br />In neueren Versionen von FHEM wird die Konsolenlogausgabe in das normale FHEMlog umgeleitet, sodass man das nicht mehr umständlich selber umlenken und suchen muss.

Im Normalfall sollte Anhand der Ausgabe erkennbar sein, was das jeweilige Problem ist. Bei Unklarheiten am Besten im Forum suchen/posten.

==== Hinweise / Häufige Fehler / FAQ ====
Hier soll mal eine Liste mit häufigen Fehlern, Problemen und Hinweisen entstehen.

*In neueren Versionen von FHEM werden die Konsolen-Logausgaben in das FHEMlog umgeleitet. Dadurch wird die Logdatei in der Standardeinstellung von (3) ziemlich voll. Wenn man das verhindern möchte, dann muss man das Attribut ''verbose'' am Sonos-Device auf einen Wert kleiner 3 setzen (z.B. 0).
*Das Modul wird im Normalfall stets an die aktuelle Sonos-Firmwareversion angepasst. Es empfiehlt sich also im Normalfall bei komischem Verhalten des Moduls, welches auf eine solche Inkompatibilität hindeutet, auf die neueste Sonos-Firmware upzudaten.<br />Ein Beispiel ist hierfür die Verarbeitung der Alarme. Dort wurde bei einem Sonos-Update die Logik verändert, sodass das Modul nun eine Inkompatibilität mit der Vorgängerfirmwareversion hat.
*Allgemein läuft das Modul besser, wenn es im Benutzerkontext ''root'' läuft. Für diverse Funktionalitäten ist das sogar notwendig (z.B. Pingtype auf ''icmp'' konfiguriert).
**Um FHEM als ''root'' laufen lassen zu können, kann es notwendig sein, den Benutzer ''fhem'' in der Datei '''/etc/passwd''' auszumarkieren oder mittels '''deleteuser''' zu löschen. FHEM schaltet in den Benutzerkontext ''fhem'' um, wenn es diesen Benutzer beim Start findet.
*Wenn man das Problem hat, dass Befehle an den falschen Player gesendet werden, sollte man das Reading '''ZoneGroupID''' prüfen. Bei ungruppierten Playern sollte es die eigene UDN enthalten, bei gruppierten Playern die UDN des Gruppenmaster.<br />Sollte das mal nicht der Fall sein, so kann es sein, dass im Sonos-System eine Falschinformation vorliegt. Da es jetzt nicht so einfach ist, die bei Sonos dazu zu bewegen, diesen Fehler zu beseitigen, gibt es u.U. eine Workaround-Möglichkeit mit dem Modul.<br />Wenn wir z.B. zwei Player haben: ''Sonos_Bad'' und ''Sonos_Kueche'', und dort die Steuerung nicht korrekt funktioniert, dann einmal die folgenden Schritte versuchen (bei mehr oder anderen Playern natürlich analog dazu).<br />Dadurch werden die Gruppen gebildet, und nochmal explizit aufgelöst.
**<code>set Sonos Groups [Sonos_Bad, Sonos_Kueche]</code>
**<code>set Sonos Groups [Sonos_Kueche, Sonos_Bad]</code>
**<code>set Sonos Groups [Sonos_Bad], [Sonos_Kueche]</code>
*Es ist wichtig, dass erst das '''Sonos'''-Device definiert wird, und dann erst die entsprechenden '''Sonosplayer'''-Devices dazu. Sonst kann es u.U. zu einer Verdoppelung des SubProzesses kommen.
*Manchmal bleiben 'Reste' beim Beenden von FHEM. Dann kann es sinnvoll sein, erst alle Perl-Prozesse zu beenden. Diese kann man mit <pre>sudo ps -aux | grep perl</pre> finden, und dann einzeln mittels <pre>sudo kill ID</pre> beenden (die ID steht in der ersten Spalte des Ergebnisses des vorherigen Befehls).

Einträge, die mittlerweile behoben wurden:
*'''Fehler'''-Ausgaben beim FHEM-Start: Einige Readings dürfen bei einem Neustart von FHEM nicht bereits vorbelegt sein, da der entsprechende Zoneplayer mittlerweile andere Informationen haben könnte, bzw. einige Events sonst nicht erzeugt werden. Aus diesem Grund werden diese beim Start auch nicht geladen.<br />Folgende Meldung erscheint z.B.:<code>Reading Sonos_Wohnzimmer->AlarmListVersion must not be used out of statefile.</code><br />Diese Meldungen kann man getrost ignorieren, da sie nicht auf einen Fehler hindeuten, sondern nur klarstellen, dass diese Readings eben nicht aus dem Statefile verwendet werden dürfen (was durch Ausgabe dieser Meldung auch nicht passiert).
**Das konnte mittlerweile durch ein Setzen eines "Lademarkers" verhindert werden. Dadurch wird das Laden des Readings nicht mehr unterbunden, sondern auf einen sicher ungültigen Wert gesetzt. Damit funktionieren die folgenden Readings-Update Aufrufe wieder.

=== Changelog ===
{| class="wikitable mw-collapsible mw-collapsed" style="width:100%"
! style="width:10%" | Datum !! style="width:8%" | Version !! style="width:82%" | Änderungen
|-
| colspan="3" style="vertical-align:top" | SVN-History
|-
| colspan="2" style="vertical-align:top;text-align:center" | 25.04.2018
|
*"Deep Recursion"-Warnung beim loggen wird nun verhindert
*Beim Erzeugen der Gruppen-ReadingsGroup ist bei der Verwendung eines Boosts ab und zu ein Fehler aufgetreten
*Beim Erzeugen eines ControlPoint-Objekts kann man nun das Envelope-Prefix angeben (nicht für das Sonos-Modul relevant)
|-
| colspan="2" style="vertical-align:top;text-align:center" | 15.04.2018
|
*Streams über Alexa (z.B. Sonos One) werden nun korrekt als Radiostreams dargestellt
*Es werden nun auch Updateinformationen und die interne Softwareversionsnummer gesucht und als Reading gesetzt: "softwareRevisionAvailable", "softwareRevisionInternal" und "softwareRevisionInternalAvailable"
|-
| colspan="2" style="vertical-align:top;text-align:center" | 24.03.2018
|
*Einige Log-Ausgaben haben bei undefinierten Default-Übergaben Fehlermeldungen verursacht.
*Bei einigen Positionsabfragen an die Player wurden Sonderfälle (wie NOT_IMPLEMENTED) nicht berücksichtigt.
*Slider-Wertebereich für Bass und Treble auf den Bereich -10..10 korrigiert.
*Es gibt jetzt ein Reading "IsZoneGroup", das 0 oder 1 sein kann. Danach wird jetzt auch entschieden, ob eine Playersteuerung dargestellt wird, oder nicht.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 10.03.2018
|
*Die PlayBase kann nun auch den SPDIF-Eingang aktivieren (wie die PlayBar)
*Wenn man über Alexa Musik hört, wird das aktuelle Cover nun auch angezeigt.
*Wenn ein Player nach einem Neustart disabled war, und während des Betriebs enabled wird, wird nun versucht ihn wiederzufinden.
*Wenn ein Player disabled oder disappeared ist, wird ein Proxy-Cover-Zugriffsversuch auf diesen Player unterbunden.
*Ein Modify-Befehlsaufruf wird nun am Vorhandensein von $hash->{OLDDEF} erkannt.
*Bei einigen PERL-Installationen stand im Reading 'currentTrackPositionSimulatedSec' eine Kommazahl (da sie von time() aus berechnet wird). Diese Zahl wird nun gerundet.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 26.02.2018
|
*ComObjectTransportQueue in Client_ReceiveQueue umbenannt.
*If-Abfrage um die can_read-Schleife im SubProzess eingebaut, Um Signalunterbrechungen zu berücksichtigen.
*Neuer Getter "WifiPortStatus". Liefert Active, wenn das WLAN aktiviert ist, sonst Inactive.
*Drei neue (automatisch ermittelte) Readings "Orientation", "WifiEnabled" und "WirelessMode".
*Warnung mit "unescaped left brace" in Tag.pm wurde korrigiert.
*ExportSonosBibliothek wird nun in einem eigenen Thread (LongJobs-Thread) ausgeführt. Dadurch bleibt das System steuerbar, auch wenn gerade ein langwieriger Export läuft.
*Prüfmethode eingebaut, um verlorengegangene Fhem-Prozessverbindungen (aus Sicht des SubProzesses) zu erkennen, und entsprechende Thread-Bereinigungmaßnahmen durchführen zu können.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 07.01.2018
|
*Der Initialwert von LastProcessAnswer (wird beim Start auf 0 gesetzt) wird nun korrekt berücksichtigt
*Bei ignoredIPs und bei usedOnlyIPs kann jetzt für jedes Komma-Getrennte Element auch ein regulärer Ausdruck stehen. Wird mit // umschlossen, und darf keine Doppelpunkte enthalten.
*Logausgabe im UPnP-Modul, welche Devices mit welchen Header-Angaben nun akzeptiert wurden (Ausgabe auf Level 5)
|-
| colspan="2" style="vertical-align:top;text-align:center" | 23.12.2017
|
*Subscriptions-Refresh umgebaut.
*Devicenamen mit Punkt (.) funktionieren nun.
*Fehler mit "undefined value $value" behoben.
*GetTrackProvider liefert bei Nichtfinden in der MusicServicesList nun eine leere Angabe, und keine undefined.
*Die Angabe in LastProcessAnswer ist nicht Zeitumstellungsfest. Der Wert wurde nun umgestellt auf epoch-Zeit.
*Der Verweis auf %intAt wurde entfernt. Die Variable wurde sowieso nie verwendet.
*Warnungsunterdrückung von 'mumpitzstuff' eingebaut.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 28.09.2017
|
*Provider-Icons werden wieder korrekt ermittelt
*Das Verarbeiten der Arbeitsschlange im SubProcess wurde optimiert
*Die Fehlermeldung mit den redundanten Argumenten bei sprintf wurde umgestellt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 14.07.2017
|
*Änderung in der ControlPoint.pm: Es wurden zuviele Suchantworten berücksichtigt.
*Bei einem Modify wird von Fhem nur die DefFn aufgerufen (und nicht vorher UndefFn). Dadurch blieben Reste, die aber vor einer Definition aufgeräumt werden müssen. Resultat war eine 100%-CPU-Last.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 09.07.2017
|
*BulkUpdate: Beginn und Ende sind nun sicher davor einen vom SubProzess gestarteten BulkUpdate vorzeitig zu beenden.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 05.07.2017
|
*Neue Variante für das Ermitteln der laufenden Favoriten, Radios oder Playlists
|-
| colspan="2" style="vertical-align:top;text-align:center" | 05.07.2017
|
*Veralteten Mechanismus für das Unterbrechen der Sendeschleife aufgeräumt.
*SONOS_ConvertNumToWord kann nun mit undef-Übergaben umgehen.
*Andere Methodik zum Ermitteln von FavouriteName, RadioName und PlaylistName eingebaut.
*Es gibt ein neues Attribut "SubProcessLogfileName". Damit kann die Logausgabe des SubProzesses in eine eigene Datei umgeleitet werden. Unter Windows z.B. gibt es sonst keine saubere Darstellungsmöglichkeit für die Logausgabe, da die beiden Prozesse sich gegenseitig die Ausgaben im Fhem-Log überschreiben. Bei Angabe von '-' wird wie bisher auf STDOUT (und damit im Fhem-Log) geloggt.
*Kleinere Fehler bei einzelnen Reading-Aktualisierungen behoben.
*Beim Zerlegen der MusicServicesList gab es einen Fehler, der z.B. dafür gesorgt hatte, dass Apple Music nicht erkannt wurde.
*Umbau der Verarbeitungslogik in Richtung SubProzess. Das sollte nun schneller und sicher sequentiell verarbeitet werden.
*Die Aktualisierung des Readings "LastProcessAnswer" wird jetzt während eines laufenden Bulkupdates auch als solches durchgeführt, und zerstört damit nicht mehr dieses laufende Update.
*Alle noch vorhandenen ReadingsSingleUpdate-Aufrufe wurden BulkUpdate-Sicher gemacht.
*Die prozentuale Fortschrittsanzeige hat bei Streams negative, hohe Werte angezeigt. Steht jetzt wieder auf 0.
*Beim Löschen blieb noch die automatisch angelegte ReadingsGroup für die aktuelle Abspielliste bestehen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 21.06.2017
|
*Bei der ersten Verbindung war das Reading für die letzte SubProzess-Antwort eventuell bereits veraltet. Das wird nun durch ein Datum in der Zukunft verhindert.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 20.06.2017
|
*Die Verarbeitung des Notify-Events für die Anzeigeaktualisierung ist in das SONOSPLAYER-Modul umgezogen (wo es auch logisch hingehört).
*Die Zeitkonvertierung hatte einen Sekundenfehler.
*Durch eine fehlerhafte IF-Verschachtelung in der ControlPoint.pm gab es komische Log-Augaben.
*Die lokalen Cover werden nur noch heruntergeladen, wenn das Attribut "getLocalCoverArt" am Sonos-Device gesetzt ist. Normalerweise merkt man davon nichts, da die eingebauten Coveranzeigen diese nicht verwenden. Wenn man diese heruntergeladenen Cover selbst noch verwendet werden, dann muss dieses Attribut gesetzt werden!
*Das Problem mit den Wide-Character bei der Hashwert-Berechnung von ProxyCache und SpeakBuffer wird abgefangen, und ein Versuch mit einem dazwischenliegenden Konverter durchgeführt.
*Das Subscribing für Rendering-Events wird in einem Eval durchgeführt, sodass eine abgefangene Fehlermeldung bei nicht-Erfolg ausgegeben wird. Das passiert z.B. bei einem Sub- oder Surroundlautsprecher.
*Die Simulation der aktuellen TrackPosition lief weiter, wenn der Player vor einem disappeared nicht gestoppt wurde.
*Bei der Verarbeitung eines Befehls im SubProzess wurde in einigen Fällen die Befehlsqueue nicht korrekt verringert, was zu Folgefehlern führte.
*Wenn der RestoreThread einen ungültigen Datensatz in der RestoreQueue vorfindet, überspringt er ihn...
*Bessere Behandlung der TrackProviderermittlung
*Bei MakeCoverURL gab es Logausgaben mit dem falschen Level.
*Es gibt vier neue Attribute am Sonosdevice: "getFavouritesListAtNewVersion", "getPlaylistsListAtNewVersion", "getRadiosListAtNewVersion" und "getQueueListAtNewVersion". In Zusammenarbeit mit "getListsDirectlyToReadings" wird dann bei Änderung der entsprechenden Liste automatisch das entsprechende Reading aller Sonosplayer-Devices aktualisiert. Hierbei entfallen dann etwaige eigene Notifies, die eine Aktualisierung der Readings veranlassen. Diese sollten dann natürlich auch entfernt werden.
*Die Überprüfung, ob der SubProzess noch lebt, wird nun über die bereits bestehende Verbindung abgewickelt. Dadurch entfallen die ständigen Verbindungsversuche zum SubProzess. Dazu wird ein Reading 'LastProcessAnswer' am zentralen Sonos-Device geführt.
*Bei Verlust der Verbindung zum SubProzess wird nun keine 100% Systemlast mehr verursacht.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 14.05.2017
|
*FHEMWEB-Anzeige der Player auf die neu möglichen, nicht quadratischen, Radiocover angepasst.
*In der Datei ControlPoint.pm wurde beim Öffnen des SSDP-Ports das Attribut ReusePort hinzugefügt (sofern das Betriebssystem das unterstützt).
*Es gibt ein neues Reading "currentEnqueuedTransportHandle", welches zur Weitergabe der aktuellen Quelle des aktuellen Titels verwendet werden kann.
*Es gibt zwei neue Readings "currentTrackHandle" und "nextTrackHandle", welche zur Weitergabe der aktuellen bzw. nächsten Wiedergabe geeignet sind.
*Es gibt ein neues Reading "currentSource", welches (wenn beliefert) den Namen der Quelle des Titels angibt. Bei Spotify z.B. die gewählte Playliste oder das Album, oder die gewählte Sonos-Playliste.
*Die Trackprovider werden jetzt über die verfügbaren, von Sonos bereitgestellten, MusicServices ermittelt.
*(Fehlende) Radiocover werden nun über den offiziellen Webservice von Sonos ermittelt, und werden wieder geladen.
*Etwaige, immer noch, fehlende Radiocover werden als Fallback wie bisher geladen. Das sollte aber nicht mehr vorkommen.
*Spotify-Playlisten-Cover werden wieder geladen.
*Teilweise wurden Bibliothekscover nicht geladen, das sollte wieder gehen.
*Die Verbindungsprüfung zwischen Fhem-Modul und SubProzess erfolgt nur noch, wenn nicht sowieso schon Daten übertragen werden, und sollte dementsprechend nicht mehr dazwischenfunken.
*Die Verbindungsprüfung und der grundsätzliche Verbindungsaufbau zum SubProzess wurden umgestellt.
*Fehlermeldungen bei Fhem-Player-Such-Prozeduren verbessert.
*Es gibt zwei (bzw. vier) neue Readings "TrackProviderIconRoundURL" und "TrackProviderIconQuadraticURL" (jeweils für "current" und für "next"). Mit diesen lassen sich die entsprechenden Provider-Icons anzeigen.
*Die Titelanzeige in FhemWeb enthält nun auch die neuen Provider-Icons.
*Detaildarstellung der SonosPlayer-Devices enthält jetzt auch die Coverdarstellung.
*Bug in "SONOS_GetTimeFromString" behoben.
*Es gibt zwei neue Attribute "simulateCurrentTrackPosition" und "simulateCurrentTrackPositionPercentFormat". Mit diesen kann man eine Simulation des Fortschritts von currentTrackPosition im gewählten Intervall aktivieren. Dabei werden die Readings "currentTrackPositionSimulated", "currentTrackPositionSimulatedSec" und "currentTrackPositionSimulatedPercent" (nur bei gelieferter "currentTrackDuration") aktualisiert.
*Es gibt zwei neue Readings "currentTrackDurationSec" und "nextTrackDurationSec", welche die jeweilige Tracklänge in Sekunden angeben.
*Durch ein mittlerweile verändertes Notify-Event-Handling in Fhem wurden die Bookmarks nicht immer zusammen mit dem globalen Save-Befehl gespeichert.
*Die Cover-/Titelanzeige wird nun intern vom Modul durchgeführt. Deshalb ist keine zusätzliche ReadingsGroup für die Anzeige und Aktualisierung mehr notwendig. In der Raumansicht kann man das Verhalten für alle Sonosplayer einheitlich mit dem Attribut "deviceRoomView" beeinflussen. Es kann die Zustände "Both" und "DeviceLineOnly" annehmen.
*Die Steuermöglichkeiten werden nun intern vom Modul dargestellt. Dazu muss die Cover-/Titelanzeige aktiviert sein. Will man die Steuerung ausblenden, kann man das Attribut "suppressControlButtons" für Sonosplayer einzeln setzen setzen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 09.04.2017
|
*Beim Maskieren der Anzeigelisten für Playlisten, Radios oder Favoriten werden Klammern und andere Sonderzeichen für reguläre Ausdrücke nun auch in Punkte umgewandelt, da diese sonst den regulären Such-Ausdruck stören.
*Beim Starten/Laden von Playlisten, Radios oder Favoriten werden, vor der eigentlichen Suche im Sonossystem, einfache Anführungszeichen (') in die HTML-Schreibweise (') übersetzt, da diese so auch von Sonos verwendet werden.
*Radiocover werden nun in höherer Auflösung von einer TuneIn-API-Schnittstelle geladen (von dort wo auch der Controller selbst die Cover lädt).
|-
| colspan="2" style="vertical-align:top;text-align:center" | 04.04.2017
|
*Es gibt zwei neue Readings "AvailablePlayerList" und "AvailablePlayerListAlias" am Sonosplayer-Device, wenn das Attribut "getListsDirectlyToReadings" am Sonos-Device gesetzt wurde. Diese Reading geben die anderen noch verfügbaren, nicht gebundenen, Player an. Das ist die Grundlage für eine Player-zur-Abspielgruppe-hinzufügen-Funktion als Listendarstellung.
*Es gibt zwei neue Readings "AllPlayerNotBonded" und "AllPlayerNotBondedCount" am Sonos-Device, welche alle Masterplayer angibt, die nicht gebunden sind.
*Es gibt ein neues Reading "IsBonded" am Sonosplayer-Device, welches angibt, ob der Player in einer Bindung zum Masterplayer steht (anstatt ein einfaches Gruppenmitglied zu sein). Gebundene Player sind z.B. der rechte Player im Stereoverbund, sowie die Satellitenplayer in einem 5.1er Surroundsystem (also Subwoofer, hintere Lautsprecher und vordere Lautsprecher).
*Es gibt drei neue Readings "SlavePlayerNotBonded", "SlavePlayerNotBondedList" und "SlavePlayerNotBondedListAlias" am Sonosplayer-Device, wobei die beiden letzteren nur erzeugt werden, wenn das Attribut "getListsDirectlyToReadings" am Sonos-Device gesetzt wurde.
*Es gibt jetzt ein Attribut "getTitleInfoFromMaster" am Sonosplayer-Device, mit welchem man ein Slave-Device (auch gebundene) dazu bringen kann, die wichtigsten Abspielreadings automatisch vom Master zu duplizieren.
*Die Oberflächenauswahl für "AddMember", "RemoveMember" und "CreateStereoPair" wurde auf die nicht bereits gebundenen Player bzw. die Teilnehmer deer Gruppe beschränkt.
*Es gibt zwei neue Readings "AllPlayer" und "AllPlayerCount" am Sonos-Device. Damit erhält man eine komplette Liste aller Player (und deren Anzahl), egal wie sie gerade verwendet werden.
*Die mitgelieferte Prozedur für die ReadingsGroup-Anzeigen wurde für das neue Reading "Queue" erweitert, außerdem wurde ein Darstellungsproblem der Gruppierungsanzeige mit aktuellen Versionen von FHEMWEB behoben
*Es gibt zwei neue Readings "ButtonState" und "ButtonLockState", sowie einen Setter für "ButtonLockState".
*Es gibt ein neues Reading "LineInPlayer" am Sonos-Device, und wenn das Attribut "getListsDirectlyToReadings" gesetzt ist, auch "LineInPlayerList" und "LineInPlayerListAlias". Diese Liste enthält die gültigen LineIn-Eingänge aller Player, die für die Wiedergabe ausgewählt werden können.
*Es gibt zwei neue Attribute "stopSleeptimerInAction" und "saveSleeptimerInAction" am Sonosplayer-Device. Mit "stopSleeptimerInAction" wird das Modul dazu angehalten, bei einem Wechsel des TransportState auf "STOPPED" oder "PAUSED_PLAYBACK" einen etwaig aktivierten SleepTimer zu deaktivieren. Mit dem Attribut "saveSleeptimerInAction" kann man dieses Verhalten (z.B. temporär) wieder unterdrücken.
*Es gibt jetzt ein Reading "ZoneGroupNameDetails" am Sonosplayer-Device, welches die Slavezonen als textuelle Auflistung mittels '+' enthält. Ist leer, wenn es keine Slaveplayer gibt. Enthält den Namen des Gruppenmasters, wenn es einen solchen gibt.
*Interne Aufräumarbeiten: Mittlerweile überflüssige Codeteile wurden entfernt, und einige Single-Readingsupdates zu einem Bulk-Readingsupdate zusammengefasst.
*Die Readings "currentFavouriteNameMasked", "currentPlaylistNameMasked" und "currentRadioNameMasked" werden automatisch gesetzt, wenn das Attribut "getListsDirectlyToReadings" gesetzt ist.
*Tippfehler bei den Readings "RadioList" und "RadioListAlias" korrigiert. Korrekt ist nun "RadiosList" und "RadiosListAlias" (also Mehrzahl bei Radios).
|-
| colspan="2" style="vertical-align:top;text-align:center" | 19.03.2017
|
*Es gibt ein neues Attribut "getListsDirectlyToReadings", mit welchem die UserReadings bzgl. Favourites, Playlists und Radios (sowie currentTrackPosition) obsolet werden, da sie dann direkt in die passenden Readings geschrieben werden. Wenn man selber beeinflussen möchte, auf welche Weise und mit welchem Namen diese Readings gefüllt werden, dann darf dieses Attribut nicht gesetzt werden (es bleibt dann das bisherige Verhalten)
*Es gibt zwei neue Getter "Queue" und "QueueWithCovers", welche die aktuelle Abspielliste liefern. Diese können wieder mit UserReadings oder dem neuen Attribut "getListsDirectlyToReadings" in entsprechende Readings übertragen werden. Hierbei werden auch zwei neue Readings "QueueDuration" und "QueueDurationSec" gefüllt, die die gesamte Abspieldauer der Abspielliste enthalten.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 13.03.2017
|
*Saubere Fehlerbehandlung bei der Verarbeitung von currentFavouriteName, currentPlaylistName und currentRadioName.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 12.03.2017
|
*NotifyFn und NotifyDev werden nun im Define des Moduls festgelegt (anstatt wie vorher im Initialize). Dadurch sollten deutlich weniger Notify-Anfragen beim Modul ankommen.
*Es gibt nun einen Set-Befehl "RefreshShareIndex" zum Aktualisieren der Bibliothek und ein Reading "ShareIndexInProgress", welches angibt, ob eine Aktualisierung gerade in Ausführung ist.
*Die Fehlermeldung beim Verbinden zum Device wurde um die Zieladresse erweitert.
*Es gibt drei neue Readings, die sich auf Spotify-Direct-Play beziehen: DirectControlClientID, DirectControlIsSuspended und DirectControlAccountID
*Man kann beim Setzen der Titelposition nun auch relative Angaben machen, also z.B. '+0:00:15' oder auch '+10%'. Geht natürlich auch mit '-'.
*Man kann beim Setzen der Titelposition nun auch eine ganze Zahl als Sekundenangabe machen. Dabei gehen auch Relativangaben
*Beim Cover-Download wird nun ein Standard_Timeout von 5s verwendet, sodass ein fehlender Player keine Blockade mehr verursachen sollte. Dafür gibt es auch ein neues Attribut 'coverLoadTimeout', womit dieser Wert eingestellt werden kann. Das ganze geht nur für Nicht-Windows-Systeme, da der Timeout über einen Alarm realisiert wird.
*Wenn während eines Subscriptions-Renews ein Timeout-Fehler auftreten sollte, wird nun der Discovery-Prozess neu angestartet, um sicherzustellen, daß der Player wieder gefunden und neu initialisiert wird.
*In der ControlPoint.pm wurde eine Sicherheitsabfrage eingebaut, wenn total verstümmelte Pakete beim SSDP-Recover ankommen.
*Es gibt ein neues Reading "currentEnqueuedTransportURI", welches den TransportURI des hinzugefügten Paketes enthält, aus welchem der Titel gerade abgespielt wird (z.B. der Identifier der Spotify-Playliste)
*Es gibt ein neues Reading "currentFavouriteName", welches versucht den "currentEnqueuedTransportURI" in den Favoriten zu finden, und enthält dann den gefundenen Favoritennamen. Dazu müssen die Favoriten einmal mittels "get FavouritesWithCover" ermittelt worden sein, und im Reading "Favourites" bereitstehen.
*Es gibt ein neues Reading "currentPlaylistName", welches versucht den "currentEnqueuedTransportURI" in den Playlisten zu finden, und enthält dann den gefundenen Playlistnamen. Dazu müssen die Playlisten einmal mittels "get PlaylistsWithCover" ermittelt worden sein, und im Reading "Playlists" bereitstehen.
*Es gibt ein neues Reading "currentRadioName", welches versucht den "currentEnqueuedTransportURI" in den Radios zu finden, und enthält dann den gefundenen Radionamen. Dazu müssen die Radios einmal mittels "get RadiosWithCover" ermittelt worden sein, und im Reading "Radios" bereitstehen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 19.03.2016
|
*Bei der Alarmbearbeitung kann man nun mehrere Alarm-IDs mit Komma getrennt angeben, und das Schlüsselwort "All" verwenden, um alle Alarme dieses Players anzusprechen.
*Man kann bei der Alarmbearbeitung nun auch zwei neue, direkte und kürzere, Befehle für Standardaufgaben verwenden: "Enable", "Disable".
|-
| colspan="2" style="vertical-align:top;text-align:center" | 06.02.2016
|
*Zusätzlich zu "Mute" (mit Parameter) am Sonos-Device gibt es jetzt auch "MuteOn" und "MuteOff" (jeweils ohne Parameter) zur Verwendung als WebCmd.
*Es gibt ein neues Reading "IsMaster" am Sonosplayer-Device, welches angibt, ob der Player gerade ein Masterplayer ist
*Es gibt ein neues Reading "MasterPlayer" am Sonosplayer-Device, welches angibt, wie der aktuelle MasterPlayer zu diesem Player heißt. Ist der Player selber der Master (also IsMaster = 1), so steht dort der eigene Name drin.
*Es gibt ein neues Reading "SlavePlayer" am Sonosplayer-Device, welches angibt, welche Slaveplayer zu diesem Player zugeordnet sind. Enthält nur Playerdevicenamen, wenn dieser Player ein Masterplayer ist, und dann auch nicht sich selber.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 31.01.2016
|
*Im Modul ControlPoint.pm gab es eine fehlerhafte Bearbeitung des Arrays @LWP::Protocol::http::EXTRA_SOCK_OPTS, welche in manchen Fällen zu der Fehlermeldung "Odd number of elements in hash assignment" geführt hat.
*Der Anbieter SoundCloud wird als Quelle erkannt und angezeigt
*Es gibt drei neue Readings "MasterPlayer", "MasterPlayerPlaying" und "MasterPlayerNotPlaying" am Sonos-Device (zzgl. der jeweiligen Angabe der Anzahl)
*Die Ausgabe von "get Sonos Groups" liefert nun stets eine normalisierte Liste (also sortiert).
|-
| colspan="2" style="vertical-align:top;text-align:center" | 31.12.2015
|
*Das Reading ZoneGroupID wurde immer länger (mit ":__"), wenn Gruppierungen anderer Player verändert wurden.
*Bei den Settern von "SleepTimer" und "SnoozeAlarm" kann man jetzt auch eine Zahl als Dauer in Sekunden angeben. Dazu wurde auch die Doku entsprechend angepasst.
*In der ControlPoint.pm wurde eine Fehlermeldung korrigiert
|-
| colspan="2" style="vertical-align:top;text-align:center" | 24.12.2015
|
*Wenn ein Player ein "ß" (oder auch andere besondere Zeichen, wie Smilies o.ä.) im Namen hatte, funktionierte die Erkennung nicht mehr, und der SubThread verstarb.
*Man kann nun mittels dem Setter "Name" auch "ß" und Smilies o.ä. im Playernamen setzen.
*Bei der Namensvergabe des Sonosplayer-FHEM-Device wird jetzt ein bißchen besser umgewandelt. Erst werden alle Sonderzeichen entfernt, dann Leerzeichen an den Rändern entfernt, und dann die restlichen Leerzeichen in "_" umgewandelt
*Das Attribut "characterDecoding" wurde entfernt, da es keine Funktion mehr hatte.
*Der UPnP-Teil verwendet nun einen beliebigen freien Port für die Kommunikation mit den Playern. Dadurch sind auch mehrere Instanzen auf ein und derselben Maschine möglich.
*Es gibt jetzt einen neuen Setter "RescanNetwork" am Sonos-Device. Damit kann man den Erkennungsprozess des UPnP-Moduls neu anstarten.
*Es gibt jetzt eine Get-Anweisung "SupportLinks" am Playerdevice, die direkte Links (momentan zwei) zu den Player-Support-Seiten liefert.
*Ein Datei-Ordner als Favorit konnte nicht sauber gestartet werden. Es wurde nicht als Album in die aktuelle Abspielliste übertragen, sondern als ein Titel direkt abgespielt. Des Weiteren wurde dafür kein Coverbild ermittelt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 15.12.2015
|
*Es gibt eine neue Funktionalität an den Sonosplayern: Repeat für einen einzelnen Titel. Durch diese Umstellung wurde der Repeat-Zustand nicht korrekt erkannt. Dafür gibt es jetzt noch einen zusätzlichen Setter und ein zusätzliches Reading: "RepeatOne".
*Es gibt eine neue Funktion "DeleteFromQueue", die Titel aus der aktuellen Abspielliste entfernen kann. Angegeben wird der Index des Elements / der Elemente.
*Das Reading "fieldType" wurde nicht ordnungsgemäß auf Leer gesetzt, wenn die Gruppierung aufgelöst wurde.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 08.12.2015
|
*Bei der Erkennung von Streams beim Restore von PlayURITemp wurde ein neues Format nicht berücksichtigt.
*Bei der Verwendung von "set Sonos Groups Reset" tauchte eine Fehlermeldung wegen eines Leerstrings auf.
*Es wurde ein neuer Setter "LoadFavourite" eingebaut, der einem StartFavourite mit der Angabe von NoStart entspricht.
*Man kann bei LoadSearchList nun auch an das Ende der aktuellen Abspielliste anhängen lassen. Dazu muss man an den Parameter maxElem ein "+" anhängen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 07.12.2015
|
*Zwei neue Setter "DialogLevel" und "NightMode", die an einer PlayBar ausgeführt werden können.
*"Set Sonos Groups" hat eine neue Option "Reset", mit der alle Gruppen in einem Rutsch aufgelöst werden können.
*ControlPoint.pm: Bei einem Fehler beim Verbindungsaufbau zum Player wurde aus dem "carp" ein "croak" gemacht. Dadurch greifen die Auffangmechanismen.
*Beim Verlieren des Gruppenmaster stand der TransportState bei allen zukünftigen NICHT-Gruppenmastern bis zum nächsten Titelwechsel auf "ERROR".
*Man kann bei einer Speak-Definition nun auch den Parameter %textescaped% verwenden, um den URL-Enkodierten Text einzufügen.
*Die Smartmatch-Fehlermeldung wird nun unterdrückt
*Die Fehlerausgabe bei fehlenden Set- oder Get-Parametern enthält jetzt auch den zulässigen Wertebereich des Parameters (z.B. '(0..100)' für die Lautstärke), sowie die optionalen Parameter
*StartSearchList hat die Wiedergabe immer neu gestartet, obwohl das u.U. gar nicht nötig war.
*Die Attribute für die Lautstärke (minVolume, maxVolume, minVolumeHeadphone und maxVolumeHeadphone) können nun im laufenden Betrieb geändert werden und die neuen Grenzen werden sofort sichergestellt.
*Es gibt einen neuen Setter 'MakeStandaloneGroup', mit dem man einen Player aus seiner Gruppe lösen kann.
*Es wird der Provider Amazon nun mit angezeigt.
*Es gibt nun ein Attribut usedonlyIPs, mit dem man die IP-Adressen der zu verwendenden Player angeben kann. Damit ist man manchmal besser dran, als mit dem Ausschluss von einzelnen Adressen
*Es gibt einen neuen Setter "TruePlay".
*Es gibt ein neues Attribut 'SpeakGoogleURL' für die Definition der zu verwendenden Google-URL für die Sprachausgabe
*Die Standard-Google-URL wurde nach neuen Hinweisen angepasst.
*Es gibt neue Setter "AudioDelayLeftRear" (Abstand hinterer linker Lautsprecher), "AudioDelayRightRear" (Abstand hinterer rechter Lautsprecher) und "SubPolarity" (Sub Aufstellung) bei einem 5.1 Surroundsystem.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 02.08.2015
|
*uri_escape() umgestellt, sodass auch UTF8-Sonderzeichen übersetzt werden
*Google-Translator-URL parametrisiert und um die mittlerweile notwendigen Parameter 'client=t' und 'prev=input' erweitert
|-
| colspan="2" style="vertical-align:top;text-align:center" | 12.07.2015
|
*Es gibt zwei neue Setter "GroupVolumeU" und "GroupVolumeD", um die Gruppenlautstärke um 'VolumeStep'-Einheiten zu erhöhen oder zu verringern.
*Innerhalb des SubProzesses wurden die Devicenamen der bereits in FHEM definierten Player nicht korrekt verwendet. Das machte sich erst mit dem neuen Feature Bookmarks bemerkbar.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 14.06.2015
|
*Zwei weitere Ausnahmen für das Neustarten des SubThreads eingefügt.
*ControlPoint.pm: Beim Renew von Subscription wurde aus dem "carp" ein "croak" gemacht. Dadurch greifen die darüberliegenden Auffangmassnahmen.
*Neues Feature: Bookmarks für Playlisten und Titel
*Changelog in der Quelltextdatei enthält nur noch für die letzten vier Veröffentlichungen. Die komplette Liste ist nur noch im Wiki vorhanden. Dadurch wird die Dateigröße geringer.
*SetEQ eingebaut, um Subwoofer und Surroundeinstellungen vornehmen zu können: "SurroundEnable", "SurroundLevel", "SubEnable", "SubGain" und "AudioDelay"
|-
| colspan="2" style="vertical-align:top;text-align:center" | 02.05.2015
|
*Es gibt drei neue Readings "FavouritesVersion", "RadiosVersion" und "PlaylistsVersion", die bei einer Änderung des jeweiligen Bereichs durch einen Sonos Controller aktualisiert werden, und auf die man mit einem Notify reagieren kann, um z.B. ein "get player FavouritesWithCovers" ausführen zu können. Damit entfällt die Notwendigkeit von zeitgesteuerten Aktualisierungen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 14.04.2015
|
*Zusätzliche Fehlerüberprüfung und -ausgabe beim Herunterladen der Cover-Bilder eingebaut, sowie relative URLs unterbunden
|-
| colspan="2" style="vertical-align:top;text-align:center" | 07.04.2015
|
*Neues Feature 'ExportSonosBibliothek': Hiermit kann eine Datei mit der textuellen Darstellung eines Struktur- und Titelhashs erzeugt werden, das die komplette Navigationsstruktur aus der Sonos-Bibliothek abbildet. Richtwerte bei ca. 22.000 Titeln auf einem Windows-Server mit Intel Core i5 mit 2.8GHz: Laufzeit: ca. 28Min, Arbeitsspeicher: ca. 1GB, Resultierende Datei: ca. 90MB
*Neues Feature 'DeletePlaylist': Hiermit kann eine Playlist gelöscht werden. Genauso wie bei LoadPlaylist kann man hier URL-Encoded arbeiten, oder einen regulären Ausdruck verwenden
*Neues Feature 'SnoozeAlarm': Hiermit kann ein gerade abspielender Alarm für die übergebene Zeit unterbrochen werden
*Neues Feature bei 'LoadPlaylist': Man kann nun einen Devicenamen angeben, dann wird dessen aktuelle Abspielliste kopiert
*Bei der Titelanzeige wird der Numerische Vergleichsfehler abgefangen, der auftritt, wenn der Player keinerlei aktuelle Abspielinformationen hat
|-
| colspan="2" style="vertical-align:top;text-align:center" | 03.04.2015
|
*IsAlive-Check Anpassungen: Bei einer Antwort wird nun nicht mehr geprüft, ob diese von derselben Netzwerkschnittstelle stammt, an die der Ping gesendet wurde. Damit werden Player besser erkannt, die sowohl am Funknetz als auch am LAN angeschlossen sind.
*IsAlive-Check Anpassungen: Bei der Option 'tcp' wird nun versucht auf den Standard-Webport des Players zu verbinden (1400)
*Callback-Aufrufmethoden: Wenn ein Player eine Nachricht an FHEM sendet und dieser Player in FHEM als 'disappeared' geführt wird, dann wird der Discovery-Process neu angestartet, um diesen Player wieder sauber zu erkennen
*Sonos hat das Verfahren zum Hinzufügen von Spotify-Titeln angepasst. Jetzt kann man diese Titel auch wieder mit dem Modul einfügen und abspielen lassen
*Das Heraussuchen der Spotify-Cover (z.B. für Playlisten) schlug fehl, wenn die API kein Bild mit 640er Höhe angeboten hat. Nun wird das erste Cover verwendet, welches immer das größte sein sollte
|-
| colspan="2" style="vertical-align:top;text-align:center" | 28.03.2015
|
*Die Wiederholungsintervalle (Tage) von Alarmen werden wieder korrekt erkannt, und gesetzt
*Bei PlaylistWithCovers wird nun auch ein Cover angezeigt, wenn der erste Titel ein Spotify-Titel ist
|-
| colspan="2" style="vertical-align:top;text-align:center" | 28.02.2015
|
*Der Speak-Befehl kann jetzt auch eingeschobene MP3-Datei-Verweise verarbeiten. Diese werden im Text mit "|" eingeschlossen, und mit Leerzeichen abgetrennt. z.B.: "Dies ist ein |/path/to/tada.mp3| Test.". Funktioniert nur bei "Speak" (und nicht bei eigenen Programmaufrufen wie "Speak1")
*Es gibt für die einfachere Handhabung der neuen Speakmöglichkeiten zwei neue Attribute "targetSpeakMP3FileDir" und "targetSpeakMP3FileConverter". Mit "targetSpeakMP3FileDir" kann ein Standardverzeichnis für die eingschobenen MP3-Dateien angegeben werden, und mit "targetSpeakMP3FileConverter" kann ein MP3-Konverter definiert werden, der am Ende die zusammengebaute Durchsage-MP3-Datei nochmal sauber durchkodiert (um z.B. Restzeitanzeigeprobleme zu beheben).
*Beim internen Entfernen der Player-Objekte (wenn z.B. die Subscription nicht erneuert werden konnte), werden nun alle Referenzen entfernt. Teilweise wurden Subscription-Referenzen noch aufbewahrt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 19.02.2015
|
*Das Attribut "verbose" am Sonos-Device wird nun zur Laufzeit an den SubProzess übertragen und wirkt dort sofort.
*Beim initialen Erkennen der wichtigsten Abspielparameter während des Discover-Prozesses gab es einen Fehler, der das Setzen verhindert hat
|-
| colspan="2" style="vertical-align:top;text-align:center" | 14.02.2015
|
*Festen Lib-Pfad für Synology-Stations hinzugefügt.
*Im Modul 21_SONOSPLAYER wurde ein require auf das Modul 00_SONOS eingefügt.
*Es gibt jetzt einen neuen Setter "ResetAttributesToDefault", mit dem man die Attribute eines Devices auf den Standard beim Anlegen zurücksetzen lassen kann. Die notwendigen Informationen werden frisch vom Player angefordert, und können sich somit, auf den ursprünglichen Anlege-Zeitpunkt bezogen, verändert haben.
*Ein Fehler bei der Verarbeitung von Devicebeschreibungen wurde in der Datei "Common.pm" des UPnP-Moduls behoben.
*Es gibt jetzt zwei neue Readings "GroupVolume" und "GroupMute", die automatisch aktualisiert werden. Damit passt jetzt auch die Anzeige des Slider beim Setter "GroupVolume" und die Vorauswahl beim Setter "GroupMute".
*Fehlermeldungen für Speak wurden erweitert.
*Bei der Verwendung von "targetSpeakFileHashCache" wird nun auch Digest::SHA versucht, wenn Digest::SHA1 nicht funktioniert.
*Es gibt zwei neue Reading "currentTrackProvider" und "nextTrackProvider", in dem die 'Quelle' der aktuellen (bzw. nächsten) Wiedergabe abgelegt wird. Damit kann man sich Anzeigen lassen, ob der aktuelle Titel z.B. von Spotify oder aus der hausinternen Bibliothek kommt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 06.02.2015
|
*Der Getter "EthernetPortStatus" hat jetzt auch die Portnummern 2 und 3 zur Auswahl.
*Es gibt ein neues Reading "OutputFixed" sowie ein zugehöriger Setter zum Setzen des Wertes.
*Es wurde im Standard-RemoteControl-Design ein :blank zwischen den Steuerbefehlen und den drei Umschaltbefehlen ("MuteT", "ShuffleT" und "RepeatT") eingefügt.
*Es gibt ein neues Reading "roomNameAlias", das den Namen enthält, der für das Attribut "alias" beim Erkennen des Players verwendet werden würde (z.B. "Wohnzimmer - Rechts"). Wird zu Laufzeit mit aktualisiert.
*Es gibt zwei neue Setter-Befehle "LoadSearchlist" und "StartSearchlist". Mit diesen kann eine dynamisch erzeugte Playliste mit Titeln aus der Sonos-Bibliothek geladen werden. Nähere Informationen dazu im Wiki.
*Es gibt einen neuen Getter-Befehl "SearchlistCategories", mit dem die möglichen Kategorien für den Aufruf von "LoadSearchlist" oder "StartSearchlist" ermittelt werden können.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 01.02.2015
|
*Es gibt nun zwei neue Befehle "ShuffleT" und "RepeatT", die jeweils den aktuellen Zustand von "Shuffle" und "Repeat" umschalten
*Das angelegte RemoteControl sowie die RemoteControl Vorlagen enthalten nun zwei neue Icons für Shuffle-Umschaltung und Repeat-Umschaltung
|-
| colspan="2" style="vertical-align:top;text-align:center" | 31.01.2015
|
*Es gibt jetzt drei Sonos-Vorlagen für RemoteControl: "Sonos", "SonosSVG_Buttons" und "SonosSVG_Icons".
*Es gibt jetzt ein neues Standardlayout (SonosSVG_Buttons) für die Erzeugung der RemoteControl.
*Es gibt jetzt ein Attribut "ignoredIPs", mit dem man problematische oder unerwünschte IPs bei der UPnP-Erkennung ausschließen kann.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 30.01.2015
|
*Commandref wurde optisch übersichtlicher gestaltet, und die Windows-Hinweise eingefügt.
*Bei der Anzeige des nächsten Titels in der Standard-ReadingsGroup stand "Artist". Das wurde auf "Interpret" korrigiert.
*Es gibt jetzt eine Prozedur "SONOSPLAYER_GetSlavePlayerNames()", mit der man sich die Teilnehmer einer Gruppe liefern lassen kann. Der Master wird nicht mit zurückgegeben. Man kann den Namen eines beliebigen Teilnehmers angeben.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 27.01.2015
|
*Bei den Befehlen "AddMember", "RemoveMember" und "CreateStereoPair" werden nun alle in FHEM verfügbaren Sonosplayer in einer Auswahl angeboten. Das erfolgt allerdings ungeachtet der Gültigkeit eines Players in diesem Kontext (z.B. kann man keinen Player aus der Gruppe entfernen, der nicht in der Gruppe ist, die Auswahl bietet aber alle an).
*Es gibt jetzt eine Prozedur "SONOSPLAYER_GetMasterPlayerName()" mit der man sich den Devicenamen des Masterplayer zu dem übergebenen Playernamen geben lassen kann.
*Es gibt einen neuen Setter "Mute" am Sonos-Device. Damit kann man mit einem Schritt bei allen Playern den Mute-Zustand setzen.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 26.01.2015
|
*Beim Setzen von "disable" am Sonos-Device wurde der "state" und "STATE" der Player nicht korrekt gesetzt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 24.01.2015
|
*Wenn man seine Player umbenannt hatte, wurde ein Attribut-Kommando (für das Model-Attribut) falsch aufgerufen und hat eine Fehlermeldung im FHEM-Log verursacht (z.B. "Please define Sonos_Wohnzimmer first")
|-
| colspan="2" style="vertical-align:top;text-align:center" | 19.01.2015
|
*Verweise auf die "alte" Wikiseite "Sonos Anwendungsbeispiel" in der commandref durch die "neue" Seite "SONOS" ersetzt.
*Wenn kein Pingtype definiert wurde, dann wurde fälschlicherweise nicht der Standard "syn" verwendet, sondern "none"
|-
| colspan="2" style="vertical-align:top;text-align:center" | 16.01.2015
|
*Speak hatte eine fehlerhafte Überprüfung der Attribute, und konnte nicht ausgeführt werden.
*Bei Streams wird das Reading "currentTrackPosition" nun fest auf "0:00:00" gesetzt, und nicht mehr beim Player angefragt
|-
| colspan="2" style="vertical-align:top;text-align:center" | 15.01.2015
|
*Für die Setter "LoadPlaylist", "StartPlaylist", "LoadRadio", "StartRadio" und "StartFavourite" kann man jetzt anstatt des Namens einen regulären Ausdruck verwenden.
*Beim Erkennen der Player werden einige Abspielreadings ("transportState", "currentTrackURI", "currentTrackDuration", "currentTrackPosition", "currentTrack", "numberOfTracks", "currentStreamAudio" und "currentNormalAudio") nun direkt abgeholt, und werden somit aktuell korrekt gesetzt.
*Beim Anlegen der neuen Devices werden die Aliasnamen nun mit der Funktion im Team erweitert
*Der Mechanismus zum Starten des SubProzesses wurde angepasst, um auf Synology-Begebenheiten Rücksicht zu nehmen
*Die Coverdarstellung für einige Spotify-Titel wurde korrigiert, indem eine andere Spotify-API verwendet wird
*Bei Playlist-Covern wird nun das Cover des ersten Titels mit AlbumArt angezeigt
*Bei Favourite-Covern werden nun Album-Favoriten auch mit Cover dargestellt (das Cover des ersten Titels mit AlbumArt)
*Ein Album aus der lokalen Bibliothek konnte mittels "StartFavourite" nicht korrekt gestartet werden (es wurde nicht als Liste übertragen, sondern als Titel gestartet)
*LogLevel für die "Connection accepted"-Meldungen auf 3 hochgesetzt
*Es gibt jetzt ein Attribut "disable" am Sonos-Device. Wird es auf 1 gesetzt, wird der SubProzess beendet und verarbeitet somit keine Sonos-Nachrichten mehr. Wird es auf 0 gesetzt (oder gelöscht), wird der SubProzess wieder gestartet.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 08.01.2015
|
*Bei der Wiedergabeanweisung "PlayURI" gab es einen Fehler
|-
| colspan="2" style="vertical-align:top;text-align:center" | 05.01.2015
|
*Die Cover beim Abspielen "von diesem Gerät" (also iPad, oder Android-Tablet) wurden nicht angezeigt.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 04.01.2015
|
*Bei der Ermittlung des Readings "AlbumArtist" gab es einen Fehler, wenn dieser von Sonos nicht übermittelt wurde.
*Wenn ein Player einen Dock (iPod) wiedergibt, dann werden die Titelinformationen dort mitgesetzt. Damit entfällt die Anzeige des Titels z.B. mit 'iPod von Reinerlein'.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 03.01.2015
|
*Dokumentation angepasst (commandref und Installationsdoku im Dateiheader)
*Fehler bei der Dockbehandlung behoben
|-
| colspan="2" style="vertical-align:top;text-align:center" | 02.01.2015
|
*Anzeige bei der Wiedergabe eines Docks verbessert. Dort werden nun der Titel und Album/Artist-Informationen und ein Dock-Cover angezeigt.
*Getter/Setter bei Bedarf um ":noArg" erweitert.
*Getter/Setter sind nun nicht mehr CaseSensitive
*Getter/Setter habe nun soweit möglich eine Auswahlliste der möglichen Werte (alle on/off Setter, sowie Wifi und RoomIcon)
*Setter für "Treble" und "Bass" haben nun auch einen Slider
*Setter "Icon" in "RoomIcon" umbenannt, damit die Auswahlliste den aktuellen vorauswählt
*Beim Erzeugen der Sonosplayer-Devices wird nun das Attribut "alias" auf den Sonos-Raumnamen gesetzt.
*Zusätzlich zu "StopAll" oder "PauseAll" gibt es am Sonos-Device nun auch "Stop" und "Pause" mit der gleichen Funktionalität
|-
| colspan="2" style="vertical-align:top;text-align:center" | 01.01.2015
|
*Anzeige in der Player-ReadingsGroup für die Darstellung von disappeared angepasst, dabei auch gleich die Höhenverhältnisse etwas angepasst.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 31.12.2014
|
*Das Bilden von Stereopaaren wird nun unterstützt. Dafür gibt es die Anweisungen 'CreateStereoPair' und 'SeparateStereoPair' an einem Playerdevice.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 28.12.2014
|
*Umlaute: Die Erkennung von Umlauten war wegen der Quelltextumstellung auf UTF8 fehlerhaft. Das betraf nur die Zonennamenumwandlung, wo z.B. aus 'Küche' ein 'Kueche' gemacht wird.
*Sonos-Coverlieferung: Es waren noch ein paar Return-Anweisungen zuviel drin.
|-
| colspan="2" style="vertical-align:top;text-align:center" | 26.12.2014
|
*DeleteFn für Sonos wurde implementiert. Das Sonos-Device löscht erst alle SonosPlayer-Devices und beendet den selbst gestarteten SubProzess. Danach wird das Sonos-Device selber von FHEM abgeräumt.
*DeleteFn für SonosPlayer wurde implementiert. Es werden erst alle automatisch erzeugten Devices (RemoteControl und ReadingsGroups) entfernt, sofern sie noch unter dem Originalnamen existieren.
*ReportUnresponsiveDevice hat manchmal versucht, die Mitteilung an "sich selbst" zu senden, was naturgemäß nicht klappen kann.
|-
| colspan="3" style="vertical-align:top" | Versionen von fhem.lmsoft.de
|-
| style="vertical-align:top;text-align:center" | 17.12.2014
| style="vertical-align:top;text-align:center" | 2.6
|
*Die Zeichenkodierung bei Datenübernahme vom Zoneplayer kann nun über das Attribut characterDecoding eingestellt werden
*Bei Gruppen-/LineIn-/SPDIF-Wiedergabe wird wieder die liefernde Zone angezeigt (als Albumname)
*SetCurrentPlaylist hatte einen Tippfehler, und konnte dementsprechend nicht ausgeführt werden
*Unter Ubuntu gibt es die SHA1-Library nicht mehr, sodass man dort eine andere einbinden muss (SHA)
*Wenn bei den Methoden zum heraussuchen der FHEM-Devices etwas nicht gefunden wurde, dann wird jetzt eine Fehlermeldung mit dem gesuchten Merkmal ausgegeben
*Es können jetzt IP-Adressen von der UPnP-Verarbeitung ausgeschlossen werden
*Es wird nun ein fester Mimetype 'jpg' für Google Music und Simfy festgelegt
*Beim Alarm-Reading-Setzen wurde etwas doppelt gesetzt, was u.U. zu Fehlern führen konnte
*Die Read-Function wurde robuster gegen Übertragungsprobleme gemacht
*Das Wiederherstellen des Playerzustands nach einem PlayURITemp sieht nun auch den PlayBar-Eingang vor
*Es wird nun anstatt der WebCmd-Auflistung ein RemoteControl beim Erstellen der Komponenten erzeugt
*Wenn sich doch noch ein UPnP-Device als Player ausgibt, dann wird dies nun etwas sicherer erkannt
*Der Eingang einer Playbar kann nun auf anderen Playern wiedergegeben werden (mittels des FHEM-Namens)
*Lesen wurde auf DevIo_SimpleRead umgestellt (stand auf DevIo_DoSimpleRead). Dadurch wird das Fehlerhandling vereinfacht.
*Man kann die Zeit für das Warten auf den Subprozess nun beim Define mit angeben. Standardmäßig wird 8 verwendet.
*Es wird nun in regelmäßigen Abständen (Intervall wie bei der Prüfung der Sonosplayer) geprüft, ob die Verbindung zum Subprozess noch funktioniert
*Die Readings, die beim Start nicht geladen werden dürfen, werden beim Start von FHEM nun initialisiert. Damit wird die Fehlermeldung in MOTD verhindert
*Der Zeitstempel in der Konsolenausgabe berücksichtigt nun auch die Global-Angabe, ob Millisekunden mit ausgegeben werden sollen
*Der Start wurde komplett überarbeitet. Nun sind die einzelnen Wartebereiche in Timer ausgelagert, sodass FHEM nicht mit warten blockiert wird.
*Die Wiederherstellung des alten Playerzustands nach einem PlayURITemp (und damit auch bei Speak) wird nun auch bei Dateien gemacht, die mit 0s Dauer ermittelt werden (da sie sehr kurz sind).
*Der Aufruf der Google Text2Speech-Engine wird nun bei mehr als 95 Zeichen in mehrere Aufrufe aufgeteilt. Damit sind nun auch lange Texte über Google möglich, allerdings geht die Textmelodie u.U. verloren.
*Man kann jetzt für die Speak-Erzeugung ein JPG- oder PNG-Bild angeben. Dies kann für jedes Speak-Programm getrennt erfolgen.
*Beim Speak-Aufruf werden Umlaute nun auch korrekt an den Text2Speech-Generator (z.B. Google) übergeben, und korrekt in den MP3-Tag geschrieben
*Spotify-Cover werden nun in größerer Auflösung (meist 640x640 Pixel) direkt von Spotify heruntergeladen, und enthalten dann nicht mehr das Spotify-Logo
*Es gibt zwei neue Readings 'AlbumArtURL' und 'nextAlbumArtURL', die die Originalpfade zum eigenen Download darstellen
*Es gibt nun zwei Prozeduren, die als Grundlage oder Beispiel für die Verwendung von ReadingsGroups dienen können: 'SONOS_getTitleRG' und 'SONOS_getCoverRG'
*Beim automatischen Erzeugen der Sonos-Devices werden nun ReadingsGroups mit mehr Informationen erzeugt. Dies kann (und soll) auch als Vorlage für eigene Ideen Verwendet werden
*Es gibt eine weitere ReadingsGroup-Vorlage (steht auch im Wiki), mit der Listen (Playlisten, Favoriten und Radios) dargestellt werden können
*Es gibt zwei neue Attribute "proxyCacheTime" und "proxyCacheDir", die einen Cache im Proxy aktivieren
*Es gibt drei neue Getter am Sonosplayer-Device: "FavouritesWithCover", "PlaylistsWithCover" und "RadiosWithCovers". Diese geben eine Datenstruktur zurück, die den Titel und das Cover des Elements enthält.
*Die Prozeduren für die Anzeige des aktuellen und nächsten Titels verwenden nun ausschließlich DIV-Container (anstatt Tabellen). Dadurch klappt die Anzeige auch in einem Dashboard.
*Die Standard-ReadingsGroup-Anzeige durch die Prozeduren sind nun Parametrisiert. Man kann die minimale Breite der Anzeige sowie den Abstand zwischen aktuellem und nächstem Titel in Pixel festlegen
*Manche Sender (z.B. Capital Radio Türkiye) haben verbotene Newlines in den Titelinformationen mitgesendet. Diese werden nun entfernt.
*Man kann das Cover nun anklicken (oder antippen), und erhält dann die Coverdarstellung in einer Vollbilddarstellung mit Abspielstatus und Titelinformationen
*Es gibt zwei neue Befehle 'StartPlaylist' und 'StartRadio', die die gleichen Parameter wie ihre Pendants mit 'Load' am Anfang haben, nur dass hier das Abspielen gleich gestartet wird.
*Es gibt jetzt ein Reading 'currentTrackPosition', welches bei jedem Transportstate-Wechsel (neuer Titel, Play/Pause/Stop usw.) gesetzt wird. Damit kann man die verbleibende Restzeit eines laufenden Titels ermitteln, bzw. den Pausezeitpunkt anzeigen.
*Beim Wiedergeben von TV oder sonstigen externen Quellen, wird jetzt nicht mehr das 'leere' Cover angezeigt, sondern ein TV-Cover bzw. ein Default-Input-Cover
*Aufnahme in das offizielle Release von FHEM
|-
| style="vertical-align:top;text-align:center" | 07.03.2014
| style="vertical-align:top;text-align:center" | 2.5
|
*Verwendung und Speicherung der Benutzer-IDs für Spotify und Napster wurden stabiler gegenüber Sonderzeichen gemacht
*Spotify-URLs werden im Reading 'currentTrackURI' und 'nextTrackURI' lesbarer abgelegt
*Ein Fehler beim Öffnen von M3U-Playlistdateien wurde behoben (dafür Danke an John)
*Überholt: Für die Informationsanfragen an FHEM durch den SubProzess wird nun standardmäßig der Telnet-Port von FHEM verwendet. Wenn das fehlschlägt, wird auf den alten Mechanismus zurückgeschaltet
*Neu: Es werden keine Informationsanfragen mehr zwischen FHEM und dem SubProzess ausgetauscht. Notwendige Informationen müssen vorher übertragen werden. Das bedeutet, dass bei einer Attributänderung ein Neustart von FHEM erfolgen muss.
*Es wurde ein Standard-Layout für das RemoteControl-Hilfsmodul angelegt
*Der Verbose-Level des Sonos-Devices wird nun auch an den SubProzess weitergereicht (auch zur Laufzeit), und beim initialen Start des SubProzess-Threads mitgegeben.
*AlbumArt von Napster erhält nun den festen Mimetype 'jpg', da dieser nicht übertragen wird
*Es werden nun die durch FHEM definierten Standard-Attribute mit angeboten
*Es gab ein Problem mit der Befehlsverarbeitung, wenn das Verbose-Attribut an einem Sonos-Device gesetzt war.
*Es wird nun auf Änderungsevents für den Zonennamen und das Zonenicon reagiert, und die entsprechenden Readings aktualisiert
*Es gibt jetzt zwei neue Setter: 'Name' und 'Icon', mit dem der Name und das Icon der Zone eingestellt werden kann
*Es gibt jetzt einen Getter 'PossibleRoomIcons', welcher die möglichen Angaben für den neuen Setter 'Icon' liefert
*Das Reading 'ZoneGroupID' wird nun auf eine andere Weise ermittelt und gesetzt
*Es gib jetzt ein neues Reading 'AlarmRunning', welches auf '1' steht, wenn gerade eine Alarmabspielung aktiv ist
*Die Namens- und Aufgabenerkennung beim Ermitteln der Player wurde angepasst
*Der Aufruf von AddMember und RemoveMember wurde bzgl. des SonosDevice-Namen abgesichert, sodass hier kein Absturz mehr bei einer falschen Deviceangabe erfolgt
*Es gibt jetzt ein neues Reading 'AlarmRunningID', welches bei einer Alarmausführung die ID des aktiven Alarms enthält
*Das Senden von Aktualisierungen an FHEM wurde etwas sicherer gemacht, wenn FHEM auf der anderen Seite gerade nicht zuhören kann
*Die Readings 'AlarmList', 'AlarmListIDs' und 'AlarmListVersion' werden nicht mehr aus dem Statefile geladen, da dort Sonderzeichen wie '#' zum Abschneiden der restlichen Zeile führen
*Anpassung der UPnP-Klasse, damit das Device-Beschreibungsdokument nur noch einmal geladen wird (anstatt wie bisher zweimal)
*Anpassung im Bereich der Cover Aktualisierung über FHEMWeb. Das geht jetzt mit viel weniger Aufwand durch.
*Es gibt jetzt einen Setter 'SnapshotGroupVolume', der das aktuelle Lautstärkenverhältnis der einzelnen Player einer Gruppe für die folgenden Aufrufe des Setter 'GroupVolume' festhält. Die Anweisungen 'PlayURI' und 'PlayURITemp' (sowie darauf aufbauende Aufrufe wie 'Speak') führen diese Anweisung selbsttätig beim Starten durch.
*Wenn beim Auffrischen der Subscriptions ein Fehler auftritt, der darauf schließen läßt, dass der Player weg ist, dann wird die entsprechende Referenz aufgeräumt
*Man kann als relative Angabe bei setVolume nun einen Prozentwert angeben, z.B. '+20%'. Damit wird die Lautstärke um den jeweiligen prozentualen Anteil erhöht oder abgesenkt.
*Es gibt jetzt ein Reading 'LineInConnected', welches eine '1' enthält, wenn der Line-In-Eingang angeschlossen wurde, sonst '0'.
|-
| style="vertical-align:top;text-align:center" | 31.12.2013
| style="vertical-align:top;text-align:center" | 2.4
|
*Initiale Lautstärkenermittlung wurde nun abgesichert, falls die Anfrage beim Player fehlschlägt
*Verbesserte Gruppenerkennung für die Anzeige der Informationen wie Titel usw.
*Fallback (Log) für den Aufruf von Log3 geschaffen, damit auch alte FHEM-Versionen funktionieren
*Es wurde eine Korrektur im verwendetetn UPnP-Modul gemacht, die eine bessere Verarbeitung der eingehenden Datagramme gewährleistet (dafür Danke an Sacha)
*Es werden nun zusätzliche Readings (beginnend mit 'next') mit den Informationen über den nächsten Titel befüllt. Diese können natürlich auch für InfoSummarize verwendet werden
*Es kann nun ein Eintrag aus der Sonos-Favoritenliste gestartet werden (Playlist oder Direkteintrag)
*Das Benennen der Sonos-FHEM-Devices wird nun auf Namensdoppelungen hin überprüft, und der Name eindeutig gemacht. Dabei wird im Normalfall das neue Reading 'fieldType' an den Namen angehangen. Nur der Master einer solchen Paarung bekommt dann den Original-Raumnamen als FHEM-Devicenamen
*Es gibt ein neues Reading 'fieldType', mit dem man erkennen kann, an welcher Position in einer Paarung dieser Zoneplayer steht
*Diverse Probleme mit Gruppen und Paarungen beim neu Erkennen der Sonos-Landschaft wurden beseitigt
*Es gibt jetzt einen Getter 'EthernetPortStatus', der den Status des gewünschten Ethernet-Ports liefert
*Es gibt jetzt einen Setter 'Reboot', der einen Neustart des Zoneplayers durchführt
*Es gibt jetzt einen Setter 'Wifi', mit dem der Zustand des Wifi-Ports eines Zoneplayers gesetzt werden kann
*Wenn ein Player als "Disappeared" erkannt wird, wird dem Sonos-System dies mitgeteilt, sodass er aus allen Listen und Controllern verschwindet
*Kleinere Korrektur, die eine bessere Verarbeitung der Kommunikation zwischen FHEM und dem Subprozess bewirkt
|-
| style="vertical-align:top;text-align:center" | 02.12.2013
| style="vertical-align:top;text-align:center" | 2.3
|
*Die Antwort von 'SetCurrentPlaylist' wurde korrigiert. Dort kam vorher 'SetToCurrentPlaylist' zurück.
*VolumeStep kann nun auch als Attribut definiert werden. Das fehlte in der zulässigen Liste noch.
*Speak kann nun auch für lokale Binary-Aufrufe konfiguriert werden.
*Speak kann nun einen Hash-Wert auf Basis des gegebenen Textes in den Dateinamen einarbeiten, und diese dann bei Gleichheit wiederverwenden (Caching)
*Sonos kann nun ein "set StopAll" oder "set PauseAll" ausführen, um alle Player/Gruppen auf einen Schlag zu stoppen/pausieren
*Beim Discover-Event wird nun genauer geprüft, ob sich überhaupt ein ZonePlayer gemeldet hat
*Die UserIDs für Napster und Spotify werden wieder korrekt ermittelt. Damit kann auch wieder ein Playlistenimport erfolgen.
*Loudness Einstell- und Abfragbar
*Bass Einstell- und Abfragbar
*Treble Einstell- und Abfragbar
*Volume kann nun auch als RampToVolume ausgeführt werden
|-
| style="vertical-align:top;text-align:center" | 12.10.2013
| style="vertical-align:top;text-align:center" | 2.2
|
*Befehlswarteschlange wieder ausgebaut. Dadurch gibt es nur noch das Reading LastActionResult, und alles wird viel zügiger ausgeführt, da FHEM nicht auf die Ausführung warten muss.
*TempPlaying berücksichtigt nun auch die Wiedergabe von Line-In-Eingängen (also auch Speak)
*Veraltete, mittlerweile unbenutzte, Readings werden nun gelöscht
*SetLEDState wurde hinzugefügt
*Die IsAlive-Überprüfung kann mit 'none' abgeschaltet werden
*CurrentTempPlaying wird nicht mehr benötigt
|-
| style="vertical-align:top;text-align:center" | 23.09.2013
| style="vertical-align:top;text-align:center" | 2.1
|
*Neuen Befehl 'CurrentPlaylist' eingeführt
|-
| style="vertical-align:top;text-align:center" | 15.09.2013
| style="vertical-align:top;text-align:center" | 2.0
|
*Neue Konzeptbasis eingebaut
*Man kann Gruppen auf- und wieder abbauen
*Es gibt neue Lautstärke- und Mute-Einstellungen für Gruppen ingesamt
*Man kann Button-Events definieren
|-
| style="vertical-align:top;text-align:center" | 27.05.2013
| style="vertical-align:top;text-align:center" | 1.13
|
*Neuer Abspielzustand 'TRANSITIONING' wird berücksichtigt
*Der Aufruf von 'GetDeviceDefHash' wird nun mit dem Parameter 'undef' anstatt ohne einen Parameter durchgeführt
|-
| style="vertical-align:top;text-align:center" | 23.05.2013
| style="vertical-align:top;text-align:center" | 1.12
|
*TrackURI hinzugefügt
*LoadPlayList und SavePlayList können nun auch Dateinamen annehmen, um eine M3U-Datei zu erzeugen/als Abspielliste zu laden
*Alarme können ausgelesen, gesetzt und gelöscht werden
*SleepTimer kann gesetzt und ausgelesen werden
*Reading DailyIndexRefreshTime hinzugefügt
*Bei AddURIToQueue und PlayURI können jetzt auch (wie bei LoadPlayList) Spotify und Napster-Ressourcen angegeben werden
*Beim Erzeugen des Cover-Weblinks wird nun nur noch die Breite festgelegt, damit Nicht-Quadratische Cover auch korrekt dargestellt werden
*SONOS_Stringify gibt Strings nun in einfachen Anführungszeichen aus (und maskiert etwaig enthaltene im String selbst)
|-
| style="vertical-align:top;text-align:center" | 10.03.2013
| style="vertical-align:top;text-align:center" | 1.11
|
*Ein Transport-Event-Subscribing wird nur dann gemacht, wenn es auch einen Transport-Service gibt. Die Bridge z.B. hat sowas nicht.
*Bei PlayURITemp wird nun der Mute-Zustand auf UnMute gesetzt, und anschließend wiederhergestellt
*Shuffle, Repeat und CrossfadeMode können nun gesetzt und abgefragt werden. Desweiteren wird der Status beim Transport-Event aktualisiert.
*Umlaute bei "generateInfoSmmarize3" durch "sichere" Schreibweise ersetzt (Lautstärke -> Lautstaerke)
|-
| style="vertical-align:top;text-align:center" | 22.02.2013
| style="vertical-align:top;text-align:center" | 1.10
|
*IsAlive beendet nicht mehr den Thread, wenn der Player nicht mehr erreichbar ist, sondern löscht nur noch die Proxy-Referenzen
*FHEMWEB-Icons werden nur noch im Hauptthread aktualisiert
*Getter 'getBalance' und Setter 'setBalance' eingeführt.
*HeadphoneConnected inkl. minVolumeHeadphone und maxVolumeHeadphone eingeführt
*InfoSummarize um die Möglichkeit der Volume/Balance/HeadphoneConnected-Felder erweitert. Außerdem werden diese Info-Felder nun auch bei einem Volume-Event neu berechnet (und triggern bei Bedarf auch!)
*InfoSummarize-Features erweitert: 'instead' und 'emptyval' hinzugefügt
*IsAlive prüft nicht mehr bei jedem Durchgang bis zum Thread runter, ob die Subscriptions erneuert werden müssen
|-
| style="vertical-align:top;text-align:center" | 16.02.2013
| style="vertical-align:top;text-align:center" | 1.9
|
*RTL.it Informationen werden nun schöner dargestellt (Da steht eine XML-Struktur im Titel)
*Wenn kein Cover vom Sonos geliefert werden kann, wird das FHEM-Logo als Standard verwendet (da dieses sowieso auf dem Rechner vorliegt)
*UPnP-Fehlermeldungen eingebaut, um bei einer Nichtausführung nähere Informationen erhalten zu können
|-
| style="vertical-align:top;text-align:center" | 13.02.2013
| style="vertical-align:top;text-align:center" | 1.8
|
*Device-Removed wird nun sicher ausgeführt. Manchmal bekommt man wohl deviceRemoved-Events ohne ein vorheriges deviceAdded-Event. Dann gibt es die gesuchte Referenz nicht.
*Renew-Subscriptions wurden zu spät ausgeführt. Da war alles schon abgelaufen, und konnte nicht mehr verlängert werden.
*ZonePlayer-Icon wird nun immer beim Discover-Event heruntergeladen. Damit wird es auch wieder aktualisiert, wenn FHEM das Icon beim Update verwirft.
*MinVolume und MaxVolume eingeführt. Damit kann nun der Lautstärkeregelbereich der ZonePlayer festgelegt werden
*Umlaute beim Übertragen in das Reading State werden wieder korrekt übertragen. Das Problem waren die etwaigen doppelten Anführungsstriche. Diese werden nun maskiert.
*Sonos Docks werden nun auch erkannt. Dieses hat eine andere Device-Struktur, weswegen der Erkennungsprozess angepasst werden musste.
|-
| style="vertical-align:top;text-align:center" | 04.02.2013
| style="vertical-align:top;text-align:center" | 1.7
|
*Umlaute werden bei Playernamen beim Anlegen des Devices korrekt umgewandelt, und nicht in Unterstriche
*Renew-Subscription eingebaut, damit ein Player nicht die Verbindung zum Modul verliert
*CurrentTempPlaying wird nun auch sauber beim Abbrechen des Restore-Vorgangs zurückgesetzt
*Die Discovermechanik umgebaut, damit dieser Thread nach einem Discover nicht neu erzeugt werden muss.
|-
| style="vertical-align:top;text-align:center" | 30.01.2013
| style="vertical-align:top;text-align:center" | 1.6
|
*Speak hinzugefügt (siehe Doku im Wiki)
*Korrektur von PlayURITemp für Dateien, für die Sonos keine Abspiellänge zur Verfügung stellt
*Korrektur des Thread-Problems welches unter *Nix-Varianten auftrat (Windows war nicht betroffen)
|-
| style="vertical-align:top;text-align:center" | 29.01.2013
| style="vertical-align:top;text-align:center" | 1.5
|
*PlayURI, PlayURITemp und AddURIToQueue hinzugefügt (siehe Doku im Wiki)
|-
| style="vertical-align:top;text-align:center" | 28.01.2013
| style="vertical-align:top;text-align:center" | 1.4
|
*Exception-Handling bei der Befehlsausführung soll FHEM besser vor verschwundenen Playern schützen
*Variable $SONOS_ThisThreadEnded sichert die korrekte Beendigung des vorhandenen Threads, trotz Discover-Events in der Pipeline
*Einrückungen im Code korrigiert
|-
| style="vertical-align:top;text-align:center" | 26.01.2013
| style="vertical-align:top;text-align:center" | 1.3
|
*StopHandling prüft nun auch, ob die Referenz noch existiert
|-
| style="vertical-align:top;text-align:center" | 24.01.2013
| style="vertical-align:top;text-align:center" | 1.2
|
*Proxy-Objekte werden beim Disappearen des Player entfernt, und sorgen bei einem nachfolgenden Aufruf für eine saubere Fehlermeldung
*Probleme mit Anführungszeichen " in Liedtiteln und Artist-Angaben. Diese Zeichen werden nun ersetzt
*Weblink wurde mit fehlendem "/" am Anfang angelegt. Dadurch hat dieser nicht im Floorplan funktionert
*pingType wird nun auf Korrektheit geprüft.
*Play:3 haben keinen Audio-Eingang, deshalb funktioniert das Holen eines Proxy dafür auch nicht. Jetzt ist das Holen abgesichert.
|-
| style="vertical-align:top;text-align:center" | 18.01.2013
| style="vertical-align:top;text-align:center" | 1.1
|
*Ping-Methode einstellbar über Attribut 'pingType'
|-
| style="vertical-align:top;text-align:center" | 16.01.2013
| style="vertical-align:top;text-align:center" | 1.0
|
*Initial Release
|}

== Modul '''SONOS''' ==
Dieses Modul erledigt die eigentliche Kommunikationsarbeit zu den ZonePlayern mittles UPnP.
Es startet (und läßt ihn dauerhaft laufen) einen Discovery Prozess, der alle ZonePlayer auffordert, sich zu melden, und reagiert auf entsprechende Signalisierungen.
Es instantiiert einen Listener und meldet diesen bei allen ZonePlayern für Abspielaktualisierungen an.

Wenn ein Aufruf des Discovery-Prozesses erfolgt, wird geprüft, ob der Player bereits definiert wurde. Wenn nicht, wird eine Definition erzeugt, wenn ja, dann wird die Komponente mit den neu erhaltenen Informationen aktualisiert.

Wenn ein Aufruf der Abspielaktualisierung erfolgt, so wird die entsprechene Zoneplayer-Komponente in FHEM mit den neu erhaltenen Informationen aktualisiert, und entsprechende FHEM-Events generiert.

Wenn das Feature mit <code>minVolume</code> oder <code>maxVolume</code> verwendet wird, wird ein weiterer Listener beim entsprechenden Zoneplayer angemeldet. Mittels diesem werden Lautstärkenänderungen am Zoneplayer gemeldet umd können entsprechend umgehend korrigiert werden.<br >Als Nebeneffekt wird für jede Lautstärkenänderung auch ein Event in FHEM erzeugt (als Folge einer Aktualisierung des Readings <code>Volume</code>).

=== Readings von SONOS ===
*<code>AllPlayer</code>: Enthält alle Player.
*<code>AllPlayerCount</code>: Enthält die Anzahl der Player in "AllPlayer".
*<code>AllPlayerNotBonded</code>: Enhtält alle Masterplayer, die nicht gebunden sind (also keine Stereo- oder Satellitenteilnehmer sind).
*<code>AllPlayerNotBondedCount</code>: Enhtält die Anzahl der Player in "AllPlayerNotBonded".
*<code>LastProcessAnswer</code>: Enthält den letzten Zeitpunkt einer Datenübertragung vom SubProzess zum FHEM-Modul.
*<code>LastProcessRestart</code>: Enthält (falls vorhanden) den Zeitpunkt des letzten Neustarts des SubProzesses.
*<code>LastProcessRestartCount</code>: Enthält (falls vorhanden) die Anzahl der durchgeführten Neustarts des SubProzesses.
*<code>LineInPlayer</code>: Enthält die gültigen LineIn-Eingänge aller Player, die für die Wiedergabe ausgewählt werden können als visualisiertes Perl-Array.
*<code>LineInPlayerList</code>: Enthält die gültigen LineIn-Eingänge aller Player, die für die Wiedergabe ausgewählt werden können als "|"-separierte Liste von Devicenamen, wenn das Attribut "" am Sonos-Device angegeben ist.
*<code>LineInPlayerListAlias</code>: Enthält die gültigen LineIn-Eingänge aller Player, die für die Wiedergabe ausgewählt werden können als "|"-separierte Liste von Raumnamen, wenn das Attribut "" am Sonos-Device angegeben ist.
*<code>MasterPlayer</code>: Hier werden alle Masterplayer in einer per eval zu einem Array umwandelbaren Liste angegeben. z.B.: ['Sonos_Kueche','Sonos_Flur']
*<code>MasterPlayerCount</code>: Hier wird die Anzahl der erkannten Masterplayer angegeben. z.B.: 2
*<code>MasterPlayerNotPlaying</code>: Hier werden alle Masterplayer in einer per eval zu einem Array umwandelbaren Liste angegeben, die gerade keine laufende Wiedergabe haben. z.B.: ['Sonos_Kueche']
*<code>MasterPlayerNotPlayingCount</code>: Hier wird die Anzahl der nicht abspielenden Masterplayer angegeben. z.B.: 1
*<code>MasterPlayerPlaying</code>: Hier werden alle Masterplayer in einer per eval zu einem Array umwandelbaren Liste angegeben, die gerade eine laufende Wiedergabe haben. z.B.: ['Sonos_Flur']
*<code>MasterPlayerPlayingCount</code>: Hier wird die Anzahl der abspielenden Masterplayer angegeben. z.B.: 1
*<code>QueueHash</code>: Der Hash-Wert für die aktuelle Abspielliste. Dieser wird bei jeder Änderung der aktuellen Abspielliste aktualisiert.
*<code>ShareIndexInProgress</code>: Gibt an, ob gerade eine Aktualisierung des Indexes der Freigaben erfolgt.
*<code>UserId_Napster</code>: Speichert die UserId für den Napster-Zugriff. Diese Information ist notwendig, wenn eine M3U-Datei mit Napster-Titeln importiert werden soll, und wird automatisch ermittelt, sobald man mit dem Original-Controller einen einzelnen Titel aus Napster in die aktuelle Abspielliste überträgt.
*<code>UserId_Spotify</code>: Speichert die UserId für den Spotify-Zugriff. Diese Information ist notwendig, wenn eine M3U-Datei mit Spotify-Titeln importiert werden soll, und wird automatisch ermittelt, sobald man mit dem Original-Controller einen einzelnen Titel aus Spotify in die aktuelle Abspielliste überträgt.
*<code>ZoneGroupState</code>: Die Konfigurationsinformationen zu der aktuellen Gruppenlandschaft der Zoneplayer. Der Befehl <code>get SONOS Groups</code> vereinfacht den Zugriff hierauf, indem es eine einfach les- und verarbeitbare Liste erzeugt.

=== Attribute von SONOS ===
'''Hinweis'''<br />Die Attribute werden (bis auf <code>verbose</code> und <code>disable</code>) erst bei einem Neustart von FHEM verwendet, da diese dem SubProzess initial zur Verfügung gestellt werden müssen.

*Grundsätzliches
**<code>coverLoadTimeout(0..10,15,20,25,30)</code>: Definiert den Timeout der für die Abfrage des Covers beim Sonosplayer verwendet wird. Wenn nicht angegeben, dann wird 5 verwendet.
**<code>deviceRoomView(Both,DeviceLineOnly)</code>: Gibt an, was in der Raumansicht zum Sonosplayer-Device angezeigt werden soll. <code>Both</code> bedeutet "normale" Devicezeile zzgl. Cover-/Titelanzeige und u.U. Steuerbereich, <code>DeviceLineOnly</code> bedeutet nur die Anzeige der "normalen" Devicezeile.
**<code>disable(0,1)</code>: Hiermit kann das Modul abgeschaltet werden. Wirkt sofort. Bei 1 wird der SubProzess beendet, und somit keine weitere Verarbeitung durchgeführt. Bei 0 wird der Prozess wieder gestartet.<br />Damit kann das Modul temporär abgeschaltet werden, um bei der Neueinrichtung von Sonos-Komponenten keine halben Zustände mitzubekommen.<br />Des Weiteren kann man damit Attribut-Änderungen an den SubProzess weiterreichen, da ja ein neuer Prozess gestartet wird, dem natürlich zu Beginn wieder alle verfügbaren/notwendigen Attribute zur Verfügung gestellt werden.
**<code>getFavouritesListAtNewVersion(0,1)</code>: Mit diesem Attribut kann das Modul aufgefordert werden, die Favoriten (bei definiertem Attribut <code>getListsDirectlyToReadings</code>) bei Aktualisierung automatisch herunterzuladen.
**<code>getPlaylistsListAtNewVersion(0,1)</code>: Mit diesem Attribut kann das Modul aufgefordert werden, die Playlisten (bei definiertem Attribut <code>getListsDirectlyToReadings</code>) bei Aktualisierung automatisch herunterzuladen.
**<code>getQueueListAtNewVersion <value></code>: Mit diesem Attribut kann das Modul aufgefordert werden, die aktuelle Abspielliste (bei definiertem Attribut <code>getListsDirectlyToReadings</code>) bei Aktualisierung automatisch herunterzuladen.
**<code>getRadiosListAtNewVersion <value></code>: Mit diesem Attribut kann das Modul aufgefordert werden, die Radioliste (bei definiertem Attribut <code>getListsDirectlyToReadings</code>) bei Aktualisierung automatisch herunterzuladen.
**<code>getListsDirectlyToReadings(0,1)</code>: Mit diesem Attribut kann das Modul aufgefordert werden, die Listen für Favoriten, Playlists, Radios und Queue direkt in die entsprechenden Readings zu schreiben. Dafür sind dann keine Userreadings mehr notwendig.
**<code>getLocalCoverArt(0,1)</code>: Mit diesem Attribut kann das Modul aufgefordert werden, die Cover lokal herunterzuladen (bisheriges Standardverhalten).
**<code>ignoredIPs</code>: Mit diesem Attribut können IP-Adressen angegeben werden, die vom UPnP-System ignoriert werden sollen. Z.B.: '''192.168.0.11,192.168.0.37'''. Es sind auch reguläre Ausdrücke pro Element zulässig. Diese dürfen nur keine Kommata oder Doppelpunkte enthalten. Z.B: '''/192.168.0.(1|2|3)/,/192.168.1.\d*/'''. Alle Meldungen und Benachrichtigungen von den angegebenen IP-Adressen werden ignoriert.<br />'''Hinweis''': Dieses Attribut kann hilfreich sein, wenn sich falsche UPnP-Devices melden, obwohl nur Sonos-Devices angefragt waren. Manchmal passiert das mit irgendwelchen NAS oder sonstigen Serverdevices.<br />Folgende Meldungen (z.B.) sind ein Indiz auf falsche Devices: <code>Loading device description failed with error: 500 Can't connect to 192.168.2.29:2869 (timeout) at ./FHEM/00_SONOS.pm line xx thread 1</code>, wenn die angegebene IP-Adresse gar kein Sonos-Devices ist.
**<code>pingType(none,tcp,udp,icmp,syn)</code>: Definiert die Art, wie der Alive-Check eines Zoneplayers erfolgen soll. Die Verfahren funktionieren unterschiedlich gut. Am Ressourcensparsamsten ist ''icmp'', benötigt aber "<code>root</code>"-Rechte. An zweiter Stelle ist ''syn'' zu empfehlen. Die anderen Verfahren melden manchmal fehlerhafte not alives. Einfach probieren. Mittels ''none'' kann dieser Mechanismus auch deaktiviert werden.
**<code>reusePort(0,1)</code>: Eines von (0,1). Gibt an, ob die Portwiederwendung für SSDP aktiviert werden soll, oder nicht. Kann Restart-Probleme lösen. Wenn man diese Probleme nicht hat, sollte man das Attribut nicht setzen.
**<code>SubProcessLogfileName <Pfad></code>: Hiermit kann für den SubProzess eine eigene Logdatei angegeben werden. Unter Windows z.B. überschreiben sich die beiden Logausgaben (von Fhem und SubProzess) sonst gegenseitig. Wenn "-" angegeben wird, wird wie bisher auf STDOUT (und damit im Fhem-Log) geloggt. Der Hauptanwendungsfall ist die mehr oder weniger kurzfristige Fehlersuche. Es werden keinerlei Variablenwerte ersetzt, und der Wert direkt als Dateiname verwendet.
**<code>usedonlyIPs <IP-Adresse>[,IP-Adresse]</code>: Mit diesem Attribut können IP-Adressen angegeben werden, die ausschließlich vom UPnP-System berücksichtigt werden sollen. Z.B.: "192.168.0.11,192.168.0.37". Es sind auch reguläre Ausdrücke pro Element zulässig. Diese dürfen nur keine Kommata oder Doppelpunkte enthalten. Z.B: '''/192.168.0.(1|2|3)/,/192.168.1.\d*/'''.
*Bookmark-Einstellungen<br />'''Hinweis''': Die Konfiguration der Bookmarks wird erst bei einem Neustart des SubProzesses (also durch einen FHEM-Neustart (vorher Speichern nicht vergessen) oder dem Setzen/Zurücksetzen des Attributs '''disable''' am Sonos-Device) berücksichtigt.
**<code>bookmarkSaveDir <path></code>: Das Verzeichnis, in dem die Dateien für die gespeicherten Bookmarks abgelegt werden sollen. Wenn nicht festgelegt, dann wird "." verwendet.
**<code>bookmarkTitleDefinition <Groupname>:<PlayerdeviceRegEx>:<TrackURIRegEx>:<MinTitleLength>:<RemainingLength>:<MaxAge>:<ReadOnly> [...]</code>: Die Definition für die Verwendung von Bookmarks für Titel.
**<code>bookmarkPlaylistDefinition <Groupname>:<PlayerdeviceRegEx>:<MinListLength>:<MaxListLength>:<MaxAge> [...]</code>: Die Definition für die Verwendung von Bookmarks für aktuelle Abspiellisten/Playlisten.
*Proxy-Einstellungen
**<code>generateProxyAlbumArtURLs(0,1)</code>: Wenn aktiviert, werden alle Cover-Links als Proxy-Aufrufe an FHEM generiert. Dieser Proxy-Server wird vom Sonos-Modul bereitgestellt. In der Grundeinstellung erfolgt kein Caching der Cover, sondern nur eine Durchreichung der Cover von den Sonosplayern (Damit ist der Zugriff durch einen externen Proxyserver auf FHEM möglich).
**<code>proxyCacheDir</code>: Hiermit wird das Verzeichnis festgelegt, in dem die Cover zwischengespeichert werden. Wenn nicht festgelegt, so wird '''/tmp''' verwendet.
**<code>proxyCacheTime</code>: Mit einer Angabe ungleich 0 wird der Caching-Mechanismus des Sonos-Modul-Proxy-Servers aktiviert. Dabei werden Cover, die im Cache älter sind als diese Zeitangabe in Sekunden, neu vom Sonosplayer geladen, alle anderen direkt ausgeliefert, ohne den Player zu fragen.
**<code>webname <String></code>: Hiermit kann der zu verwendende Webname für die Cover-Link-Erzeugung angegeben werden. Da vom Modul Links zu Cover u.ä. erzeugt werden, ohne dass es einen FhemWeb-Aufruf dazu gibt, kann das Modul diesen Pfad nicht selber herausfinden. Wenn das Attribut nicht angegeben wird, dann wird 'fhem' angenommen.
*{{Anker|Sprachattribute}}Sprachoptionen
**<code>targetSpeakDir</code>: Das Verzeichnis, in dem dieses Modul die Sprachdateien von <code>Speak</code> (siehe [[#Set-Befehle_an_den_SONOSPLAYER|Set-Befehle an den SONOSPLAYER]]) ablegen soll (also die Adresse für den '''Schreib'''zugriff). Es wird empfohlen, dass dieses Verzeichnis '''nicht''' von Sonos indiziert ist.<br />z.B. Pfade unter *Nix: <code>/home/www/Sonos</code> oder unter Windows: <code>C:\InetPub\Sonos</code>
**<code>targetSpeakMP3FileConverter</code>: Hiermit kann ein MP3-Konverter angegeben werden, der am Ende der Verkettung der Speak-Ansage das resultierende MP3-File nochmal sauber durchkodiert. Damit können Restzeitanzeigeprobleme behoben werden. Dadurch vegrößert sich allerdings u.U. die Ansageverzögerung.<br />z.B. <code>/usr/bin/avconv -i %infile% %outfile%</code>
***'''Hinweis''': Der Platzhalter ''%infile%'' wird durch den Quelldateinamen ersetzt werden.
***'''Hinweis''': Der Platzhalter ''%outfile%'' wird durch den Zieldateinamen ersetzt werden.
***'''Hinweis''': Das Programm ''avconv'' kann unter Debian z.B. mittels <code>sudo apt-get install ffmpeg</code> installiert werden.
**<code>targetSpeakMP3FileDir</code>: Das Verzeichnis, welches als Standard für MP3-Fileangaben in Speak-Texten verwendet werden soll. Wird dieses Attribut definiert, können die Angaben bei Speak ohne Verzeichnis erfolgen.<br />z.B. Pfade unter *Nix: <code>/home/www/Sonos</code> oder unter Windows: <code>C:\InetPub\Sonos</code>
**<code>targetSpeakURL</code>: Die URL, unter der ''von außen'' (also aus Sicht des Zoneplayers) auf die abgelegte Sprachdatei zugegriffen werden kann (also die Adresse für den '''Lese'''zugriff). <br />z.B. <code>\\192.168.178.45\Sonos</code>
***'''Achtung!''': Dabei muss darauf geachtet werden, dass als letztes Zeichen vor dem Zeilenumbruch kein Backslash steht (ist hier für den Pfad auch nicht notwendig). Dieser würde von FHEM als Maskierer für den folgenden Zeilenumbruch interpretiert werden, und die nächste Zeile wäre auch noch Bestandteil dieses Attributs (und damit des Pfades).
**<code>targetSpeakFileTimestamp(0,1)</code>: Definiert, ob in dem Namen der Sprachausgabedatei ein Zeitstempel enthalten sein soll. Das sorgt dafür, dass alle Dateien beibehalten werden (da nicht mit demselben Namen überschrieben wird).<br />Manchmal kann das auch Caching-Probleme beseitigen. In meinen Tests hat die Anzeige der in der Sprachdatei enthaltenen MP3-Tags nur mit dieser aktivierten Option sauber funktioniert, da der ZonePlayer bei mir die Tags gecached hält.<br />Anderseits muss man sich dabei Gedanken über eine Aufräumstrategie machen, da die alten Dateien immer vorhanden bleiben.
**<code>targetSpeakFileHashCache(0,1)</code>: Definiert, ob in dem Namen der Sprachausgabedatei ein Hash-Wert enthalten sein soll. Das sorgt dafür, dass die Dateien bei gleichem Text wiederverwendet werden und nicht neu generiert werden.
***Für diese Funktionalität wird das Perl-Modul '''Digest::SHA1''' für die Berechnung des Hash-Werts benötigt. Am einfachsten kann es bei Bedarf per CPAN installiert werden: <code>sudo cpan install Digest::SHA1</code>.
**<code>Speak1</code>: Hiermit kann ein Systemaufruf definiert werden, der zu Erzeugung einer Sprachausgabe verwendet werden kann. Sobald dieses Attribut definiert wurde, ist ein entsprechender Setter am Sonosplayer verfügbar.<br />Das Format ist:<br /><Ausgabedateiendung>:<Befehlszeile>
***Es dürfen folgende Platzhalter verwendet werden:<br />'''%language%''': Wird durch die eingegebene Sprache ersetzt<br />'''%filename%''': Wird durch den kompletten Dateinamen (inkl. Dateiendung) ersetzt.<br />'''%text%''': Wird durch den zu übersetzenden Text ersetzt.<br />'''%textescaped%''': Wird durch den URL-Enkodierten zu übersetzenden Text ersetzt.<br />Zusätzliche Ersetzungen:<br />'''%textutf8%''': Wird durch den zu übersetzenden Text im UTF8-Format ersetzt.<br />'''%textutf8escaped%''': Wird durch den URL-Enkodierten zu übersetzenden Text im UTF8-Format ersetzt.
**<code>Speak2</code>: Siehe Speak1
**<code>Speak3</code>: Siehe Speak1
**<code>Speak4</code>: Siehe Speak1
**<code>SpeakCover</code>: Hiermit kann ein JPG- oder PNG-Bild als Cover für die Google-Sprachdurchsagen definiert werden.
**<code>Speak1Cover</code>: Analog zu SpeakCover für Speak1.
**<code>Speak2Cover</code>: Analog zu SpeakCover für Speak2.
**<code>Speak3Cover</code>: Analog zu SpeakCover für Speak3.
**<code>Speak4Cover</code>: Analog zu SpeakCover für Speak4.
**<code>SpeakGoogleURL <GoogleURL></code>: Die zu verwendende Google-URL. Wenn dieser Parameter nicht angegeben wird, dann wird ein Standard verwendet. Hier müssen Platzhalter für die Ersetzung durch das Modul eingetragen werden: %1$s -> Sprache, %2$s -> Text
***Die Standard-URL lautet momentan: <code>http://translate.google.com/translate_tts?tl=%1$s&client=tw-ob&q=%2$s</code>

=== Get-Befehle an SONOS ===
*Gruppenbefehle
**<code>Groups</code>: Liefert die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft zurück. Das Format ist eine Komma-getrennte Liste von Listen mit Devicenamen, also z.B. <code>[Sonos_Kueche], [Sonos_Wohnzimmer, Sonos_Schlafzimmer]</code>. In diesem Beispiel sind also zwei Gruppen definiert, von denen die erste aus einem Player und die zweite aus Zwei Playern besteht. Dabei ist die Reihenfolge innerhalb der Unterlisten wichtig, da der erste Eintrag der sogenannte Gruppenkoordinator ist (in diesem Fall also <code>Sonos_Wohnzimmer</code>), von dem die aktuelle Abspielliste und der aktuelle Titel auf die anderen Gruppenmitglieder übernommen wird.

=== Set-Befehle an SONOS ===
*Grundsätzliches
**<code>RefreshShareIndex</code>: Startet eine Aktualisierung des Indexes der Freigaben
**<code>RescanNetwork</code>: Startet die Erkennung der im Netzwerk vorhandenen Player erneut.
*Steuerbefehle
**<code>Mute <State></code>: Setzt den Mute-Zustand bei allen Playern. Der Wert kann on oder off sein.
**<code>PauseAll</code>: Pausiert die Wiedergabe in allen Zonen.
**<code>Pause</code>: Synonym für PauseAll.
**<code>StopAll</code>: Stoppt die Wiedergabe in allen Zonen.
**<code>Stop</code>: Synonym für StopAll.
*Bookmark-Befehle
**<code>DisableBookmark <Groupname></code>: Deaktiviert die angegebene Gruppe.
**<code>EnableBookmark <Groupname></code>: Aktiviert die angegebene Gruppe.
**<code>LoadBookmarks [Groupname]</code>: Lädt die angegebene Gruppe (oder alle Gruppen, wenn nicht angegeben) aus den entsprechenden Dateien.
**<code>SaveBookmarks [Groupname]</code>: Speichert die angegebene Gruppe (oder alle Gruppen, wenn nicht angegeben) in die entsprechenden Dateien.
*Gruppenbefehle
**<code>Groups <Gruppendefinition></code>: Setzt die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft. Das Format ist jenes, welches auch von dem Get-Befehl ''Groups'' geliefert wird.<br >'''Hinweis''': Hier kann als Gruppendefinition das Wort ''Reset'' verwendet werden, um alle Player aus ihren Gruppen zu entfernen.

== Modul '''SONOSPLAYER''' ==
Dieses Modul dient im großen und ganzen als Platzhalter für FHEM, damit der Anwender FHEM-Konform informiert werden, bzw. steuern kann.

Hier werden die Informationen, die vom '''SONOS'''-Modul erkannt werden, abgelegt, und die Aktualisierungs-Events erzeugt.

=== Readings von SONOSPLAYER ===
Folgende Informationen werden im SONOSPLAYER als Reading abgelegt:
*Systemzustand
**<code>AlarmList</code>: Enthält die textuelle Repräsentation des Hashs mit den aktuell für diesen Player gültigen Alarminformationen. Diese Information wird automatisch aktualisiert, wenn das Attribut '''getAlarms''' auf ''1'' gesetzt wurde, ansonsten steht sie nicht zur Verfügung (und es kann kein Alarm angelegt, verändert und gelöscht werden). Das Format des Hashs entspricht dem, das zum Setzen oder Anpassen eines Alarms notwendig ist.<br />Folgene Schlüssel sind dort zulässig/notwendig:
***'''Enabled(0,1)''': Gibt an, ob der Alarm aktiviert ist.
***'''Volume(0..100)''': Die Lautstärke, mit der der Alarm wiedergegeben werden soll.
***'''StartTime(Timstamp)''': Die Uhrzeit, zu der der Alarm starten soll.
***'''Duration(Timstamp)''': Die Dauer, die der Alarm laufen soll.
***'''Repeat(0,1)''': Gibt an, ob die Wiedergabe wiederholt werden soll.
***'''Shuffle(0,1)''': Gibt an, ob die Wiedergabe zufällig erfolgen soll.
***'''RoomUUID''': Die ID der Zone, in der der Alarm wiedergegeben werden soll. Dieser Wert muss nie mit angegeben werden, da er automatisch befüllt wird (Diese Information ist durch das verwendete FHEM-Zoneplayer-Device klar).
***'''ProgramURI''': Die abzuspielende URI.
***'''ProgramMetaData''': Die Metadaten zu der abzuspielenden URI.
***'''Recurrence_Once(0,1)''': Gibt an, dass der Alarm nur einmal laufen soll. Wenn hier eine ''1'' angegeben wurde, dann werden die anderen ''Recurrence''-Angaben ignoriert.
***'''Recurrence_Monday(0,1)''': Gibt an, dass der Alarm jeden Montag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Tuesday(0,1)''': Gibt an, dass der Alarm jeden Dienstag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Wednesday(0,1)''': Gibt an, dass der Alarm jeden Mittwoch laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Thursday(0,1)''': Gibt an, dass der Alarm jeden Donnerstag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Friday(0,1)''': Gibt an, dass der Alarm jeden Freitag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Saturday(0,1)''': Gibt an, dass der Alarm jeden Samstag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''Recurrence_Sunday(0,1)''': Gibt an, dass der Alarm jeden Sonntag laufen soll. Kann mit den anderen Tagesangaben kombiniert werden.
***'''IncludeLinkedZones(0,1)''': Gibt an, ob die aktuell verlinkten Zonen diesen Alarm ebenfall abspielen sollen.
***'''Beispiel-Hash''': { Enabled => 1, Volume => 12, StartTime => '16:00:00', Duration => '00:15:00', Repeat => 0, Shuffle => 0, ProgramURI => 'x-rincon-buzzer:0', ProgramMetaData => ' ', Recurrence_Once => 0, Recurrence_Monday => 1, Recurrence_Tuesday => 1, Recurrence_Wednesday => 1, Recurrence_Thursday => 1, Recurrence_Friday => 1, Recurrence_Saturday => 0, Recurrence_Sunday => 0, IncludeLinkedZones => 0 }
**<code>AlarmListIDs</code>: Enthält die Hash-Schlüssel der Alarme als kommaseparierte Liste. Dieses Reading gibt es Hauptsächlich zur Vereinfachung des Zugriffs auf das Reading '''AlarmList'''. Damit hat man direkt die Anzahl und Primärschlüssel im Zugriff.
**<code>AlarmListVersion</code>: Dieses Reading enthält die Information über die aktuelle Version der gespeicherten Alarm-Informationen. Diese Information wird Hauptsächlich intern benötigt, um beurteilen zu können, ob die Alarminformationen neu geladen werden müssen.
**<code>AudioDelay</code>: Gibt das AudioDelay des Players an. Der Wert kann zwischen 0 und 5 liegen.
**<code>AudioDelayLeftRear</code>: Gibt den AudioDelayLeftRear des Players an. Der Wert kann zwischen 0 und 2 liegen. Wobei die Werte folgende Bedeutung haben: 0: >3m, 1: >0.6m und <3m, 2: <0.6m
**<code>AudioDelayRightRear</code>: Gibt den AudioDelayRightRear des Players an. Der Wert kann zwischen 0 und 2 liegen. Wobei die Werte folgende Bedeutung haben: 0: >3m, 1: >0.6m und <3m, 2: <0.6m
**<code>ButtonState</code>: Gibt den Zustand des Buttons an.
**<code>ButtonLockState</code>: Gibt den Sperr-Zustand des Buttons an.
**<code>DailyIndexRefreshTime</code>: Enthält die aktuell gültige ''DailyIndexRefreshTime'', zu der der Medienindex neu aufgebaut werden soll. <br />Diese Information wird automatisch aktualisiert, wenn sie bei einem Player verändert wird, wenn das Attribut '''getAlarms''' des Player auf ''1'' gesetzt wurde.
**<code>DialogLevel</code>: Gibt den Zustand der Sprachverbesserung an der Playbar an.
**<code>FavouritesVersion</code>: Dieses Reading enthält die Information über die aktuelle Version der gespeicherten Favoriten. Eine Änderung dieses Readings wird durch eine Anpassung der Favoriten (z.B. durch einen Controller) ausgelöst.
**<code>fieldType</code>: In einer Paarung wird jedem Player vom Sonos-System ein eindeutiger FieldType zugewiesen. Dieser wird von diesem Modul für die Eindeutigkeit des Device-Namen verwendet. Bei einer Stereopaarung z.B. hat ein Player den Type 'LF' (für Left-Front), 'RF' (für Right-Front) oder SW (für Subwoofer); bei Surround-Konfigurationen aber auch RR (für Right-Rear) oder LR (für Left-Rear).
**<code>HeadphoneConnected</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> (oder auch <code>minVolumeHeadphone</code> und <code>maxVolumeHeadphone</code>) gesetzt wurde, den Zustand, ob ein Kopfhörer verwendet wird, oder nicht. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung dieses Zustands auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>LastActionResult</code>: Enthält den Namen und das Ergebnis der letzten Aktion auf dem Player. Da die Aktionen asyncron übertragen werden, kann nur hier kontrolliert werden, ob das gewünschte Ergebnis erreicht wurde.
**<code>LineInConnected</code>: Gibt an, ob der Line-In-Eingang angeschlossen ist, oder nicht. Wird bei Änderung am Player automatisch aktualisiert, und erzeugt damit auch ein Event.
**<code>location</code>: URL zum Informationsdokument des ZonePlayers
**<code>NightMode</code>: Gibt den Zustand des Nachtsounds an der Playbar an.
**<code>Orientation</code>: Gibt die Lage des Players an.
**<code>playerType</code>: Typbezeichnung des ZonePlayer. z.B. "ZP90"
**<code>PlaylistsVersion</code>: Dieses Reading enthält die Information über die aktuelle Version der gespeicherten Playlists. Eine Änderung dieses Readings wird durch eine Anpassung der Playlists (z.B. durch einen Controller) ausgelöst.
**<code>presence</code>: Erreichbarkeit des Players. Kann "appeared" oder "disappeared" sein
**<code>RadiosVersion</code>: Dieses Reading enthält die Information über die aktuelle Version der gespeicherten Radiofavoriten. Eine Änderung dieses Readings wird durch eine Anpassung der Radios (z.B. durch einen Controller) ausgelöst.
**<code>roomName</code>: Originalname des ZonePlayers. Kann Leer- oder Sonderzeichen enthalten
**<code>roomNameAlias</code>: Originalname des ZonePlayers mit einem angehangenen Funktionsnamen, wie er für das Attribut "alias" verwendet werden würde (z.B. "Wohnzimmer - Rechts"). Wird zur Laufzeit aktualisiert. Kann Leer- oder Sonderzeichen enthalten
**<code>saveRoomName</code>: Sicherer Name des Zoneplayer. Sonderzeichen wurden in Unterstriche umgewandelt. Das Device wird beim Anlegen mit diesem Namen angelegt
**<code>serialNum</code>: Seriennummer des ZonePlayers. Entspricht weitestgehend der MAC-Adresse. z.B. "00-0E-58-28-D0-F4:2"
**<code>softwareRevision</code>: Version der installierten Software. z.B. "8.4"
**<code>softwareRevisionAvailable</code>: Version der verfügbaren Software. z.B. "8.5"
**<code>softwareRevisionInternal</code>: Interne Version der installierten Software. z.B. "41.3-50131"
**<code>softwareRevisionInternalAvailable</code>: Interne Version der verfügbaren Software. z.B. "42.2-51240"
**<code>SubEnable</code>: Gibt den Zustand des Sub-Zustands für diesen Player an.
**<code>SubGain</code>: Gibt den SubGain für diesen Player an. Der Wert kann zwischen -15 und 15 liegen.
**<code>SubPolarity</code> Gibt den SubPolarity für diesen Player an. Der Wert kann zwischen 0 und 2 liegen.
**<code>SurroundEnable</code>: Gibt an, ob für diesen Player die Surround-Wiedergabe aktiviert wurde, oder nicht.
**<code>SurroundLevel</code>: Gibt den Surroundlevel für diesen Player an. Der Wert kann zwischen -15 und 15 sein.
**<code>TruePlay</code>: Gibt an, ob für diesen Player die TruePlay-Wiedergabe aktiviert ist, oder nicht.
**<code>WifiEnabled</code>: Gibt an, ob für diesen Player Wifi aktiviert ist, oder nicht.
**<code>WirelessMode</code>: Gibt den Wirelessmode des Players an.
*Gruppierungsinformationen
**<code>AvailablePlayerList</code>: Wird gesetzt, wenn das Attribut "getListsDirectlyToReadings" am Sonos-Device gesetzt wurde. Es enthält die anderen und noch verfügbaren und nicht gebundenen Player-Devicenamen. Das ist die Grundlage für eine Player-zur-Abspielgruppe-hinzufügen-Funktion als Listendarstellung.
**<code>AvailablePlayerListAlias</code>: Wird gesetzt, wenn das Attribut "getListsDirectlyToReadings" am Sonos-Device gesetzt wurde. Es enthält die anderen und noch verfügbaren und nicht gebundenen Player-Raumnamen. Das ist die Grundlage für eine Player-zur-Abspielgruppe-hinzufügen-Funktion als Listendarstellung.
**<code>IsBonded</code>: Gibt an, ob der Player in einer Bindung zum Masterplayer steht (anstatt ein einfaches Gruppenmitglied zu sein). Gebundene Player sind z.B. der rechte Player im Stereoverbund, sowie die Satellitenplayer in einem 5.1er Surroundsystem (also Subwoofer, hintere Lautsprecher und vordere Lautsprecher).
**<code>IsMaster</code>: Gibt an, ob dieser Player aktuell ein Masterplayer einer Gruppe ist. Dabei kann die Gruppe auch nur einen Teilnehmer haben (wieder dieser Player).<br />Damit kann ermittelt werden, welche Player korrekte Abspielinformationen darstellen können.
**<code>IsZoneBridge</code>: Gibt an, ob dieser Player eine Bridge ist.
**<code>MasterPlayer</code>: Gibt den FHEM-Devicenamen des Masterplayers zu diesem Player an. Wenn dieser Player alleine eine Gruppe darstellt, dann steht in diesem Reading der FHEM-Devicenamen dieses Players.
**<code>SlavePlayer</code>: Gibt eine per '''eval''' umwandelbare Liste von FHEM-Devicenamen der zu diesem Masterplayer gehörenden Slaveplayer an. Diese Liste kann auch leer sein, wenn dieser Player kein Masterplayer ist, oder die Gruppe nur aus einem Mitglied besteht.
**<code>SlavePlayerNotBonded</code>: Enthält alle SlavePlayer, die nicht gebunden sind als visualisiertes Perl-Array.
**<code>SlavePlayerNotBondedList</code>: Enthält alle SlavePlayer, die nicht gebunden sind als "|"-separierte Liste der Devicenamen.
**<code>SlavePlayerNotBondedListAlias</code>: Enthält alle SlavePlayer, die nicht gebunden sind als "|"-separierte Liste der Raumnnamen.
**<code>ZoneGroupID</code>: Die ID des Gruppenkoordinators plus eine laufende Nummer. Sollte die Gruppe nur aus einem Mitglied bestehen, so ist es die eigene ID (=UDN).
**<code>ZoneGroupName</code>: Der Name der aktuellen Gruppe
**<code>ZoneGroupNameDetails</code>: Enthält die Slavezonen als textuelle Auflistung mittels '+'. Ist leer, wenn es keine Slaveplayer gibt. Enthält den Namen des Gruppenmasters, wenn es einen solchen gibt.
**<code>ZonePlayerUUIDsInGroup</code>: Eine Liste der in der aktuellen Gruppe befindlichen Zoneplayer.
*Abspielzustand
**<code>AlarmRunning</code>: Dieses Reading enthält ''1'', wenn gerade ein Alarm abgespielt wird, sonst ''0''
**<code>AlarmRunningID</code>: Dieses Reading enthält die ID des verursachenden Alarms, wenn gerade ein Alarm abgespielt wird, sonst ist es leer.
**<code>Balance</code>: Enthält im Normalfall die am Player eingestellte Balance zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, wird diese Balance bei jeder Änderung am Player mit aktualisiert. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung der Balance auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>Bass</code>: Enthält im Normalfall den am Player eingestellten Basslevel zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, wird dieser Basslevel bei jeder Änderung am Player mit aktualisiert. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung des Basslevels auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>CrossfadeMode</code>: Enthält den aktuellen Zustand von CrossfadeMode. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>GroupMute</code>: Enthält den GroupMute-Zustand. Wird automatisch aktualisiert.
**<code>GroupVolume</code>: Enthält den GroupVolume-Zustand. Wird automatisch aktualisiert.
**<code>GroupVolumeD</code>: Verringert die aktuelle Gruppenlautstärke um volumeStep-Einheiten.
**<code>GroupVolumeU</code>: Erhöht die aktuelle Gruppenlautstärke um volumeStep-Einheiten.
**<code>Loudness</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, den aktuellen Zustand des Loudness. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung des Loudness-Zustands auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>Mute</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, den aktuellen Zustand des Mute. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung des Mute-Zustands auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>numberOfTracks</code>: Anzahl der momentan in der Abspielliste befindlichen Titel
**<code>OutputFixed</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, den aktuellen Zustand des OutputFixed. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung des OutputFixed-Zustands auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>QueueDuration</code>: Enthält die Abspieldauer der aktuellen Abspielliste als Zeitangabe. ''Achtung!'': Nicht jeder Titel wird mit Abspiellänge von Sonos geliefert, sodass dieser Wert auch ungenau sein kann.
**<code>QueueDurationSec</code>: Enthält die Abspieldauer der aktuellen Abspielliste in Sekunden. ''Achtung!'': Nicht jeder Titel wird mit Abspiellänge von Sonos geliefert, sodass dieser Wert auch ungenau sein kann.
**<code>QueueHash</code>: Enthält den Hashwert der aktuellen Abspielliste. Dieser wird für die Bookmarkfunktionalität verwendet
**<code>Repeat</code>: Enthält den aktuellen Zustand von Repeat. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>RepeatOne</code>: Enthält den aktuellen Zustand von RepeatOne. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>Shuffle</code>: Enthält den aktuellen Zustand von Shuffle. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>SleepTimer</code>: Enthält die Restzeit des Sleeptimers. Diese Information wird vom Player beim Setzen und Ablaufen gemeldet, und erzeugt somit ein Event zu Beginn und Ende des Timers. Während der Timer läuft, wird hier nichts aktualisiert. Man muss also, falls benötigt, selber die verbleibende Restzeit mittels des Readings-Timestamps und diesem Wert ermitteln.<br />Diese Information wird automatisch aktualisiert, wenn sie bei einem Player verändert wird.<br />Beim Ablaufen des Timers wird vom Player eine Aktualisierung auf den Wert '''off''' gesendet. Darauf kann in einem Notify-Event geprüft werden.
**<code>SleepTimerVersion</code>: Dieses Reading enthält die Information über die aktuelle Version der gespeicherten ''SleepTimer''-Informationen. Diese Information wird Hauptsächlich intern benötigt, um beurteilen zu können, ob das Reading ''SleepTimer'' neu geladen werden muss.
**<code>transportState</code>: Aktueller Abspielstatus. Kann "ERROR", "STOPPED", "PLAYING" oder "PAUSED_PLAYBACK" sein. Wobei ERROR heißt, dass es keine Verbindung zum Player gibt.<br />'''Hinweis'': Bei Gruppen hat nur der Gruppenmaster den korrekten Abspielzustand. Alle Slaveplayer enthalten immer den Zustand "PLAYING", da sie ja gerade den Masterplayer "abspielen", und keine Information dazu haben, ob und was abgespielt wird.
**<code>Treble</code>: Enthält im Normalfall den am Player eingestellten Treblelevel zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, wird dieser Treblelevel bei jeder Änderung am Player mit aktualisiert. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung des Treblelevels auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
**<code>Volume</code>: Enthält im Normalfall die am Player eingestellte Laustärke zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, wird diese Lautstärke bei jeder Änderung am Player mit aktualisiert. <br />Wenn zusätzlich noch das Attribut <code>generateVolumeEvent</code> gesetzt ist, erzeugt jede Änderung der Lautstärke auch ein FHEM-Event. Standardmäßig ist dies aus Zeitgründen deaktiviert, da FHEM-Events an jeden(!) notify innerhalb FHEM gemeldet werden. Dies kann u.U. zu Verzögerungen bei dem ZonePlayer führen.
*Infos zum aktuellen Titel
**<code>currentTitle</code>: Titelbezeichnung des aktuellen Titels
**<code>currentArtist</code>: Interpret des aktuellen Titels
**<code>currentAlbum</code>: Albumname des aktuellen Titel
**<code>currentAlbumArtist</code>: Interpret des Albums. Kann z.B. auch "(compilations)" sein.
**<code>currentEnqueuedTransportHandle</code>: Handle, welches zur Weitergabe der aktuellen Quelle des aktuellen Titels verwendet werden kann.
**<code>currentEnqueuedTransportURI</code>: Enthält den Identifier der Quelle des aktuellen Titels. Z.B. die ID der Spotify-Playliste
**<code>currentFavouriteName</code>: Enthält den Namen des Quellfavoriten, der den aktuellen Titel zur Liste hinzugefügt hat. Dazu müssen die Favoriten mittels "get FavouritesWithCover" ermittelt worden sein, und die Liste im Reading "Favourites" zur Verfügung stehen.
**<code>currentPlaylistName</code>: Enthält den Namen der Quellplaylist, die den aktuellen Titel zur Liste hinzugefügt hat. Dazu müssen die Playlisten mittels "get PlaylistsWithCover" ermittelt worden sein, und die Liste im Reading "Playlists" zur Verfügung stehen.
**<code>currentRadioName</code>: Enthält den Namen des Quellradios, der den aktuellen Titel zur Liste hinzugefügt hat. Dazu müssen die Radios mittels "get RadiosWithCover" ermittelt worden sein, und die Liste im Reading "Radios" zur Verfügung stehen.
**<code>currentOriginalTrackNumber</code>: Nummer des aktuellen Titels bezogen auf das Album
**<code>currentSource</code>: Enthält die aktuelle Quelle zum aktuellen Titel. Bei Spotify z.B. die gewählte Playliste oder das Album, oder die gewählte Sonos-Playliste.
**<code>currentTrack</code>: Nummer des aktuellen Titels in der Abspielliste
**<code>currentTrackHandle</code>: Handle des aktuellen Titels, welches zur Weitergabe geeignet ist.
**<code>currentTrackURI</code>: Dateipfad des aktuellen Titels in der Abspielliste. Gültige Formate siehe PlayURI.
**<code>currentTrackDuration</code>: Länge des aktuellen Titels im Format H:MM:SS
**<code>currentTrackDurationSec</code>: Länge des aktuellen Titels in Sekunden.
**<code>currentTrackPosition</code>: Position innerhalb des aktuellen Titels im Format H:MM:SS. Wird zum Zeitpunkt einer Änderung des Abspielstatus (Play, Pause, Stop, Nächster Titel, usw.) aktualisiert.
**<code>currentTrackPositionSimulated</code>: Simulierte und laufend aktualisierte Abspielposition des Titels im Format H:MM:SS.
**<code>currentTrackPositionSimulatedSec</code>: Simulierte und laufend aktualisierte Abspielposition des Titels in Sekunden.
**<code>currentTrackPositionSimulatedPercent</code>: Simulierte und laufend aktualisierte Abspielposition des Titels in Prozent.
**<code>currentTrackProvider</code>: 'Quelle' der aktuellen Wiedergabe. Enthält z.B. ''Spotify'' oder ''Bibliothek''
**<code>currentTrackProviderIconQuadraticURL</code>: Enthält eine URL zu einem quadratischen TrackProvider-Icon.
**<code>currentTrackProviderIconRoundURL</code>: Enthält eine URL zu einem runden TrackProvider-Icon.
**<code>currentSender</code>: Senderbezeichnung, wenn es ein Radiostream ist
**<code>currentSenderCurrent</code>: Zusatzinformationen zur Radiosendung, meist der Programmtitel wie 'Pop&Weck'
**<code>currentSenderInfo</code>: Zusatzinformationen zur Radiosendung, meist der Titel des aktuellen Liedes
**<code>currentAlbumArtURI</code>: Relativer Verzeichnis-Pfad im lokalen FHEM (physisch). Beginnt momentan mit "www"
**<code>currentAlbumArtURL</code>: Kompletter Pfad für den eigenen Download der Coverdatei des aktuellen Titels oder für die Angabe in einer HTML-IMG-Source.
*Infos zum nächsten Titel
**<code>nextTitle</code>: Titelbezeichnung des nächsten Titels
**<code>nextArtist</code>: Interpret des nächsten Titels
**<code>nextAlbum</code>: Albumname des nächsten Titel
**<code>nextAlbumArtist</code>: Interpret des Albums des nächsten Titels. Kann z.B. auch "(compilations)" sein.
**<code>nextOriginalTrackNumber</code>: Nummer des nächsten Titels bezogen auf das Album
**<code>nextAlbumArtURI</code>: Relativer Verzeichnis-Pfad im lokalen FHEM (physisch). Beginnt momentan mit "www"
**<code>nextAlbumArtURL</code>: Kompletter Pfad für den eigenen Download der Coverdatei des nächsten Titels oder für die Angabe in einer HTML-IMG-Source.
**<code>nextTrackHandle</code>: Handle des nächsten Titels, welches zur Weitergabe geeignet ist.
**<code>nextTrackURI</code>: Dateipfad des nächsten Titels in der Abspielliste. Gültige Formate siehe PlayURI.
**<code>nextTrackDuration</code>: Länge des nächsten Titels im Format H:MM:SS
**<code>nextTrackDurationSec</code>: Länge des nächsten Titels in Sekunden.
**<code>nextTrackProvider</code>: 'Quelle' der nächsten Wiedergabe. Enthält z.B. ''Spotify'' oder ''Bibliothek''
**<code>nextTrackProviderIconQuadraticURL</code>: Enthält eine URL zu einem quadratischen TrackProvider-Icon.
**<code>nextTrackProviderIconRoundURL</code>: Enthält eine URL zu einem runden TrackProvider-Icon.
*Generierte Informationen
**<code>infoSummarize1</code>: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
**<code>infoSummarize2</code>: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
**<code>infoSummarize3</code>: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
**<code>infoSummarize4</code>: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
**<code>currentStreamAudio</code>: Boolean. 1 wenn gerade ein Radiostream läuft, sonst 0. Momentan faktisch Negation zu <currentNormalAudio>
**<code>currentNormalAudio</code>: Boolean. 1 wenn gerade ein normaler Titel läuft, sonst 0. Momentan faktisch Negation zu <currentStreamAudio>

=== Attribute von SONOSPLAYER ===
'''Hinweis'''<br />Die Attribute werden meistens erst bei einem Neustart von FHEM verwendet, da diese dem SubProzess initial zur Verfügung gestellt werden müssen.

*Grundsätzliches
**<code>disable(0,1)</code>: Deaktiviert die Verarbeitung von Events dieses Devices
**<code>generateSomethingChangedEvent(0,1)</code>: Bestimmt, ob ein Event mit dem Namen 'SomethingChanged' generiert werden soll, wenn überhaupt ein Event generiert wurde. Das ist nützlich, wenn man auf eine beliebige Änderung des Player reagieren möchte.
**<code>generateVolumeEvent(0,1)</code>: Aktiviert die Generierung eines Events bei Lautstärkeänderungen, wenn mindestens eines der Attribute <code>minVolume</code>, <code>maxVolume</code>, <code>minVolumeHeadphone</code> oder <code>maxVolumeHeadphone</code> definiert ist. Standardmäßig ist dies deaktiviert (=0), um die Zeitverzögerung so gering wie möglich zu halten.
**<code>generateVolumeSlider(0,1)</code>: Aktiviert einen Slider für die Lautstärkeneinstellung auf der Detailansicht. Standardmäßig ist dieser aktiviert (=1).
**<code>getAlarms(0,1)</code>: Meldet sich bei Playern für die Aktualisierung von Alarm-Informationen an. Diese werden bei Änderung direkt aktualisiert, und erzeugen dementsprechend ein FHEM-Event. Gleichzeitig wird hiermit die '''DailyIndexRefreshTime''' mit aktualisiert.
**<code>suppressControlButtons(0,1)</code>: Gibt an, ob die Steuerbuttons unter der Cover-/Titelanzeige angezeigt werden sollen (=1) oder nicht (=0).
**<code>VolumeStep</code>: Definiert die Schrittweite für den Aufruf von <code>VolumeU</code> und <code>VolumeD</code>.
*Informationen generieren
**<code>generateInfoSummarize1</code>: Generiert das Reading 'InfoSummarize1' mit dem angegebenen Format.
**<code>generateInfoSummarize2</code>: Generiert das Reading 'InfoSummarize2' mit dem angegebenen Format.
**<code>generateInfoSummarize3</code>: Generiert das Reading 'InfoSummarize3' mit dem angegebenen Format.
**<code>generateInfoSummarize4</code>: Generiert das Reading 'InfoSummarize4' mit dem angegebenen Format.
**<code>getTitleInfoFromMaster(0,1)</code>: Bringt das Device dazu, seine aktuellen Abspielinformationen vom aktuellen Gruppenmaster zu holen, wenn es einen solchen gibt.
**<code>simulateCurrentTrackPosition(0,1)</code>: Bringt das Device dazu, seine aktuelle Abspielposition simuliert weiterlaufen zu lassen. Dazu werden die Readings <code>currentTrackPositionSimulated</code> und <code>currentTrackPositionSimulatedSec</code> gesetzt. Gleichzeitig wird auch das Reading <code>currentTrackPositionSimulatedPercent</code> (zwischen 0.0 und 100.0) gesetzt.
**<code>simulateCurrentTrackPositionPercentFormat <Format></code>: Definiert das Format für die sprintf-Prozentausgabe im Reading <code>currentTrackPositionSimulatedPercent</code>.
**<code>stateVariable(TransportState,NumberOfTracks,Track,TrackDuration,Title,Artist,Album,<br />
OriginalTrackNumber,AlbumArtist,Sender,SenderCurrent,SenderInfo,StreamAudio,NormalAudio,<br />
AlbumArtURI,nextTrackDuration,nextTrackURI,nextAlbumArtURI,nextTitle,nextArtist,<br />
nextAlbum,nextAlbumArtist,nextOriginalTrackNumber,Volume,Mute,Shuffle,Repeat,RepeatOne,CrossfadeMode,<br />
Balance,HeadphoneConnected,SleepTimer,Presence,RoomName,RoomNameAlias,SaveRoomName,PlayerType,Location,<br />
SoftwareRevision,SerialNum,InfoSummarize1,InfoSummarize2,InfoSummarize3,InfoSummarize4)</code>: Legt fest, welcher Variablenwert in den State geschrieben werden soll.
*Steueroptionen
**<code>maxVolume(0..100)</code>: Legt die obere Grenze für die einstellbare Lautstärke dieses ZonePlayers fest. Diese kann auch mit keinem Controller überschritten werden, da diese überwacht wird.
***Wenn eine untere oder obere Grenze festgelegt wurde, so wird das Reading '''Volume''' am entsprechenden SonosPlayer bei jeder Änderung am Player aktualisiert.<br />Möchte man also immer die aktuelle Lautstärke kennen, aber keine Enschränkung machen, dann sollte der Wert von <code>minVolume</code> auf <code>0</code> oder <code>maxVolume</code> auf <code>100</code> gesetzt werden. Desweiteren werden gleichzeitig auch Änderungen an der Balance aktualisiert, da diese mit übertragen werden.
***'''Achtung!''': Wenn eine untere oder obere Grenze festgelegt wird, werden für Lautstärkenänderungen auch Events erzeugt. Es ist unbedingt darauf zu achten, dass etwaige Notify-Definitionen zügig bearbeitet werden, da sonst das Sonos-System träge werden könnte.
***'''Hinweis''': Dieses Attribut kann auch im laufenden Betrieb angepasst werden. Die Einhaltung der Grenzen wird umgehend sichergestellt.<br />Bedingung ist nur, dass zum Startzeitpunkt des SubProzesses eine Grenze festgelegt sein musste, damit die entsprechenden Listener angemeldet werden.
**<code>minVolume(0..100)</code>: Legt die untere Grenze für die einstellbare Lautstärke dieses ZonePlayers fest. Diese kann auch mit keinem Controller unterschritten werden, da diese überwacht wird.
***Wenn eine untere oder obere Grenze festgelegt wurde, so wird das Reading '''Volume''' am entsprechenden SonosPlayer bei jeder Änderung am Player aktualisiert.<br />Möchte man also immer die aktuelle Lautstärke kennen, aber keine Enschränkung machen, dann sollte der Wert von <code>minVolume</code> auf <code>0</code> oder <code>maxVolume</code> auf <code>100</code> gesetzt werden. Desweiteren werden gleichzeitig auch Änderungen an der Balance aktualisiert, da diese mit übertragen werden.
***'''Achtung!''': Wenn eine untere oder obere Grenze festgelegt wird, werden für Lautstärkenänderungen auch Events erzeugt. Es ist unbedingt darauf zu achten, dass etwaige Notify-Definitionen zügig bearbeitet werden, da sonst das Sonos-System träge werden könnte.
***'''Hinweis''': Dieses Attribut kann auch im laufenden Betrieb angepasst werden. Die Einhaltung der Grenzen wird umgehend sichergestellt.<br />Bedingung ist nur, dass zum Startzeitpunkt des SubProzesses eine Grenze festgelegt sein musste, damit die entsprechenden Listener angemeldet werden.
**<code>maxVolumeHeadphone(0..100)</code>: Legt die obere Grenze für die einstellbare Lautstärke dieses ZonePlayers im Kopfhörerbetrieb fest.
***'''Hinweis!''': Es gelten die gleichen Bedingungen und Hinweise wie bei <code>maxVolume</code>.
**<code>minVolumeHeadphone(0..100)</code>: Legt die untere Grenze für die einstellbare Lautstärke dieses ZonePlayers im Kopfhörerbetrieb fest.
***'''Hinweis!''': Es gelten die gleichen Bedingungen und Hinweise wie bei <code>minVolume</code>.
**<code>buttonEvents <Time:Pattern>[ <Time:Pattern> ...]</code>: Definiert, dass bei einer bestimten Tastenfolge am Player ein Event erzeugt werden soll. Die Definition der Events erfolgt als Tupel: Der erste Teil vor dem Doppelpunkt ist die Zeit in Sekunden, die berücksichtigt werden soll, der zweite Teil hinter dem Doppelpunkt definiert die Abfolge der Buttons, die für dieses Event notwendig sind.
***Folgende Button-Kürzel sind zulässig:
****'''M''': Der Mute-Button ('''Achtung''': Der Mute-Button am SonosPlayer ist seit Firmware 4.2 ein Play/Pause/Next-Button, der kein Mute-Event mehr erzeugt, meine Beschwerde an Sonos, dass es nicht benutzerfreundlich ist, einen Mute-Symbolisierten Button mit Play/Pause zu belegen, wurde im großen und ganzen ignoriert)
****'''H''': Die Headphone-Buchse
****'''U''': Up-Button (Lautstärke Hoch)
****'''D''': Down-Button (Lautstärke Runter)
***Das Event, das geworfen wird, heißt <code>ButtonEvent</code>, der Wert ist die definierte Tastenfolge<br />Z.B.: <code>2:MM</code><br />Hier wird definiert, dass ein Event erzeugt werden soll, wenn innerhalb von 2 Sekunden zweimal die Mute-Taste gedrückt wurde. Das damit erzeugte Event hat dann den Namen <code>ButtonEvent</code>, und den Wert <code>MM</code>.
**<code>saveSleeptimerInAction(0,1)</code>: Wenn gesetzt, wird ein etwaig gesetztes Attribut "stopSleeptimerInAction" ignoriert.
**<code>stopSleeptimerInAction(0,1)</code>: Wenn gesetzt, wird bei einem Wechsel des transportState auf "PAUSED_PLAYBACK" oder "STOPPED" ein etwaig definierter SleepTimer deaktiviert.

=== Get-Befehle an den SONOSPLAYER ===
'''Hinweis!''': Es wurden ein paar Get-Möglichkeiten entfernt. Diese Befehle (wie z.B. ''Volume'') können mittlerweile direkt geliefert werden, und müssen nicht angefordert werden. Übrig geblieben sind nur noch solche Anweisungen, die Informationen beschaffen, die nicht automatisch geliefert werden (können).
*Grundsätzliches
**<code>Alarm <ID></code>: Ausnahmefall. Diese Get-Anweisung liefert direkt ein Hash zurück, in welchem die Informationen des Alarms mit der gegebenen ID enthalten sind. Es ist die Kurzform für <code>eval(ReadingsVal(<Devicename>, 'Alarmlist', ()))->{<ID>};</code>, damit sich nicht jeder ausdenken muss, wie er jetzt am einfachsten an die Alarm-Informationen rankommen kann.
**<code>EthernetPortStatus <PortNumber></code>: Liefert den Ethernet-Portstatus des gegebenen Ports ('0' oder '1'). Kann 'Active' oder 'Inactive' liefern.
**<code>PossibleRoomIcons</code>: Liefert eine Liste aller möglichen RoomIcon-Bezeichnungen zurück.
**<code>SupportLinks</code>: Ausnahmefall. Diese Get-Anweisung liefert eine Liste mit passenden Links zu den Supportseiten des Player.
**<code>WifiPortStatus</code>: Liefert den Wifi-Portstatus. Kann 'Active' oder 'Inactive' liefern.
*Listen
**<code>Favourites</code>: Liefert eine Liste mit den Namen aller gespeicherten Sonos-Favoriten. Das Format der Liste ist eine Komma-Separierte Liste, bei der die Namen in doppelten Anführungsstrichen stehen. z.B. "Liste 1","Eintrag 2","Test"
**<code>FavouritesWithCovers</code>: Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Favoriten. Z.B.: {'FV:2/22' => {'Cover' => 'urlzumcover', 'Title' => '1. Favorit'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.
**<code>Playlists</code>: Liefert eine Liste aller gespeicherten Playlists. Diese Anfrage liefert bei allen Zoneplayern die gleiche Liste zurück. Das Format ist eine Komma-Separierte Liste, bei der die Einträge in doppelten Anführungszeichen stehen z.B. "Liste 1","Liste 2","Test"
**<code>PlaylistsWithCovers</code>: Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Playlisten. Z.B.: {'SQ:14' => {'Cover' => 'urlzumcover', 'Title' => '1. Playlist'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.
**<code>Queue</code>: Liefert eine Liste mit den Namen aller Titel in der aktuellen Abspielliste. Das Format der Liste ist eine Komma-Separierte Liste, bei der die Namen in doppelten Anführungsstrichen stehen. z.B. "1. Liste 1 [0:02:14]","2. Eintrag 2 [k.A.]","3. Test [0:14:00]"
**<code>QueueWithCovers</code>: Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller Titel der aktuellen Abspielliste. Z.B.: {'Q:0/22' => {'Cover' => 'urlzumcover', 'Title' => '1. Titel'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.
**<code>Radios</code>: Liefert eine Liste aller gespeicherten Radiosender (Favoriten). Diese Anfrage liefert bei allen Zoneplayern die gleiche Liste zurück. Das Format ist eine Komma-Separierte Liste, bei der die Einträge in doppelten Anführungszeichen stehen z.B. "Sender 1","Sender 2","Test"
**<code>RadiosWithCovers</code>: Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Radiofavoriten. Z.B.: {'R:0/0/2' => {'Cover' => 'urlzumcover', 'Title' => '1. Radiosender'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.
**<code>SearchlistCategories</code>: Liefert eine Liste mit allen verfügbaren Kategorien, die beim Set-Befehl '''LoadSearchlist''' verwendet werden können. Diese Liste kann dynamisch durch Sonos erweitert werden.
*Informationen zum aktuellen Titel
**<code>CurrentTrackPosition</code>: Liefert die aktuelle Zeitposition im Lied

=== Set-Befehle an den SONOSPLAYER ===
'''Hinweis!''': Alle Set-Befehle liefern kein direktes Ergebnis zurück. Sollte ein Ergebnis generiert werden (meistens eine Statusmeldung, bzw. was genau getan wurde), so landet dies nach der Ausführung in dem Reading <code>LastActionResult</code>.
*Grundsätzliche Einstellungen
**<code>Alarm <Create|Update|Delete|Enable|Disable> <ID[,ID]|All> <Datenhash></code>: Diese Anweisung wird für die Bearbeitung der Alarme verwendet:
***'''Create''': Erzeugt einen neuen Alarm-Eintrag mit den übergebenen Hash-Daten. Der Rückgabewert ist die ID des neuen Alarms.
***'''Update''': Aktualisiert die Alarme mit den übergebenen IDs und den angegebenen Hash-Daten.
***'''Delete''': Löscht die Alarm-Einträge mit den übergebenen IDs.
***'''Enable''': Aktiviert die Alarm-Einträge mit den übergebenen IDs.
***'''Disable''': Deaktiviert die Alarm-Einträge mit den übergebenen IDs.
***''Hinweis'': Bei Angabe des Worts ''All'' als ID werden alle, diesem Player zugeordneten, Alarme verarbeitet.
***'''Datenhash''': Das Format ist ein Perl-Hash und wird mittels der eval-Funktion interpretiert. Eine Beschreibung befindet sich bei der Dokumentation des Readings '''AlarmList''' oder den folgenden Beispielen.
***'''Beispiele''':
****<code>set Sonos_Wohnzimmer Alarm Create 0 { Enabled => 1, Volume => 35, StartTime => '00:00:00', Duration => '00:15:00', Repeat => 0, Shuffle => 0, ProgramURI => 'x-rincon-buzzer:0', ProgramMetaData => ' ', Recurrence_Once => 0, Recurrence_Monday => 1, Recurrence_Tuesday => 1, Recurrence_Wednesday => 1, Recurrence_Thursday => 1, Recurrence_Friday => 1, Recurrence_Saturday => 0, Recurrence_Sunday => 0, IncludeLinkedZones => 0 }</code>: Erzeugt einen neuen Alarm mit den angegebenen Informationen. Die neue ID wird als Ergebnis zurückgegeben.
****<code>set Sonos_Wohnzimmer Alarm Update 17 { Shuffle => 1 }</code>: Aktualisiert den Alarm mit der ID ''17'', und passt dort Shuffle auf ''Aktiv'' an.
****<code>set Sonos_Wohnzimmer Alarm Delete 17</code>: Löscht den Alarm mit der ID ''17''.
**<code>AudioDelay <Level></code>: Setzt das AudioDelay der Playbar auf den angegebenen Wert. Der Wert kann zwischen 0 und 5 liegen.
**<code>AudioDelayLeftRear <Level></code>: Setzt den AudioDelayLeftRear des Players auf den angegebenen Wert. Der Wert kann zwischen 0 und 2 liegen. Wobei die Werte folgende Bedeutung haben: 0: >3m, 1: >0.6m und <3m, 2: <0.6m
**<code>AudioDelayRightRear <Level></code>: Setzt den AudioDelayRightRear des Players auf den angegebenen Wert. Der Wert kann zwischen 0 und 2 liegen. Wobei die Werte folgende Bedeutung haben: 0: >3m, 1: >0.6m und <3m, 2: <0.6m
**<code>ButtonLockState(0,1)</code>: Setzt den aktuellen Button-Sperr-Zustand.
**<code>DailyIndexRefreshTime <Timestring></code>: Legt die aktuell gültige ''DailyIndexRefreshTime'' fest, zu der der Medienindex neu aufgebaut werden soll. Der Wert muss ein kompletter Zeitstempel sein (HH:MM:SS).
**<code>DialogLevel <Level></code>: Legt den Zustand der Sprachverbesserung an der Playbar fest.
**<code>ExportSonosBibliothek <Filename></code>: Exportiert eine Datei mit der textuellen Darstellung eines Struktur- und Titelhashs, das die komplette Navigationsstruktur aus der Sonos-Bibliothek abbildet. Dieser Prozess braucht viel CPU-Zeit und Arbeitsspeicher zum Ermitteln und wegspeichern der Daten.
***'''Hinweis''': Richtwerte bei ca. 22.000 Titeln auf einem Windows-Server mit Intel Core i5 mit 2.8GHz: Laufzeit: ca. 28Min, Arbeitsspeicher: ca. 1GB, Resultierende Datei: ca. 90MB
**<code>Name</code>: Legt den Namen der Zone fest.
**<code>NightMode <State></code>: Legt den Zustand des Nachtsounds an der Playbar fest.
**<code>OutputFixed <State></code>: Setzt den OutputFixed-Zustand (die Lautstärkepegelsteuerung des Ausgangs des Players) auf den angegebenen Wert. Der Wert kann on oder off sein. Liefert als Ergebnis den neuen Zustand.
**<code>Reboot</code>: Führt für den Zoneplayer einen Neustart durch.
**<code>ResetAttributesToDefault <DeleteAllOtherAttributes></code>: Setzt die Attribute eines Players auf die Voreinstellung zurück, wie sie beim Anlegen des Players gesetzt waren. Wenn der Parameter "DeleteAllOtherAttributes" mit "1" oder "on" angegeben wurde, werden vor dem Setzen alle Attribute gelöscht.
**<code>RoomIcon</code>: Legt das Icon für die Zone fest.
**<code>SnoozeAlarm <Timestring|Seconds></code>: Unterbricht eine laufende Alarmwiedergabe für den übergebenen Zeitraum.
**<code>SubEnable <State></code>: Legt den Zustand des Sub-Zustands fest.
**<code>SubGain <Level></code>: Setzt den SubGain auf den angegebenen Wert. Der Wert kann zwischen -15 und 15 liegen.
**<code>SubPolarity <Level></code> Setzt den SubPolarity auf den angegebenen Wert. Der Wert kann zwischen 0 und 2 liegen.
**<code>SurroundEnable <State></code>: Legt den Zustand des Surround-Zustands fest. Liefert den aktuell gültigen Surround-Zustand.
**<code>SurroundLevel <Level></code>: Setzt den Surroundlevel auf den angegebenen Wert. Der Wert kann zwischen -15 und 15 sein.
**<code>TruePlay <State></code>: Setzt den TruePlay-Zustand.
**<code>Wifi <State></code>: Setzt den WiFi-Zustand des Players. Kann 'off', 'persist-off' oder 'on' sein.
*Abspiel-Steuerbefehle
**<code>CurrentTrackPosition <TimePosition></code>: Setzt die aktuelle Zeitposition im Lied. Man kann hier auch relative Angaben machen wie '+0:00:10' oder nur '+10'. Zusätzlich kann man auch Prozentwerte angeben wie z.B. '+10%'. Natürlich können diese Angaben auch negativ sein.
**<code>Pause</code>: Pausiert die Wiedergabe
**<code>Previous</code>: Springt zum Anfang des vorhergehenden Liedes. Das ist ein anderes Verhalten als mit einem Controller. Der Controller springt zunächst an den Anfang des aktuellen Liedes, und erst beim erneuten Drücken an den Anfang des vorhergehenden Liedes.
**<code>Play</code>: Startet die Wiedergabe
**<code>PlayURI <SongURI> [Volume]</code>: Spielt die angegebene MP3-Datei mit der optional verwendbaren Lautstärke ab. Die Datei muss vom SonosPlayer aus direkt erreichbar (und natürlich auch lesbar) sein, braucht aber nicht indiziert worden zu sein.<br />Folgende Formate werden momentan akzeptiert:
***'''Sonos-Devicenamen''': z.B. <code>Sonos_Wohnzimmer</code>. Der Devicename muss natürlich bereits definiert worden sein. Es wird der Audio(oder AV)-Eingang des gewählten Zoneplayer-Device als Wiedergabestrom gewählt.
****Bei normalen Audio-Eingängen (LineIn) kann man einen beliebigen Player für die Wiedergabe verwenden. Es muss nicht der lokale Player für die Wiedergabe verwendet werden.
****Besonderheit bei Sonos Playbar-Komponenten:<br />Wenn als Quelle eine Playbar ausgewählt wird, so wird erst die Playbar selbst auf den SPDIF-Eingang umgestellt, und anschließend eine Gruppe mit dem gewünschten Player gebildet.<br />Wenn diese Anweisung an die Playbar selbst gegeben wird, dann wird nur der SPDIF-Eingang als Quelle aktiviert.
***'''UNC-Pfade''': z.B. <code>\\Server\Freigabe\Dateiname.mp3</code>. Erkennungsmerkmal ist der Doppelte Backslash am Anfang. Darstellung aller üblichen Informationen inkl. Cover u.ä.
***'''Web-Streams''': z.B. <code>http://www.energyradio.de/hot</code>. Erkennungsmerkmal ist die Angabe von <code>http://</code> am Anfang. Es werden keine Cover aber Streaminformationen dargestellt.
***'''Sonstige URI-Typen''': z.B. <code>x-sonos-spotify:spotify:track:0jkLC0noG4A4i9lob2gSc3?sid=9&flags=0</code>. Darstellung aller üblichen Informationen. Die verfügbaren Formate können durch Sonos erweitert/verändert werden.<br />'''Hinweis''': Das Format der URI, das hier angegeben werden kann, ist stets identisch zum Reading '''currentTrackURI''', das bedeutet, dass die URI, die man dort sieht, hier direkt wieder angegeben werden kann.<br />Es gibt lediglich die oben benannte Vereinfachung für MP3-Dateien und Radio-URLs (aber auch dafür könnte man das offizielle Format angeben).
**<code>PlayURITemp <SongURI> [Volume]</code>: Spielt die angegebene MP3-Datei mit der optional verwendbaren Lautstärke als temporäre Datei ab. Nachdem die Datei abgespielt wurde, werden die vorhergehenden Abspielparameter (Lautstärke, Titel, Position usw.) wiederhergestellt. Im Normalfall geht es also direkt dort weiter, wo die Unterbrechung stattgefunden hat. Die Datei muss vom SonosPlayer aus direkt erreichbar (und natürlich auch lesbar) sein, braucht aber nicht indiziert worden zu sein. Für eine ordnungsgemäße Wiederherstellung ist es notwendig, dass dies eine Datei und kein Stream ist, da die Abspiellänge vorher bekannt sein muss.
***Für Streams (genauer: Für Dateien, deren Abspiellänge nicht ermittelt werden kann) ist dieser Aufruf identisch zu <code>PlayURI</code>, es wird im Anschluß nichts wiederhergestellt.
***Zulässige Formate stehen unter <code>PlayURI</code>.
***'''Achtung!''': Wenn bereits eine temporäre Ausgabe erfolgt, so wird die Aufforderung mit einer entsprechenden Meldung verworfen. Es kann nur eine geben :-)
**<code>Next</code>: Springt zum Anfang des nächsten Liedes
**<code>Speak <Volume> <Language> <Text></code>: Wandelt den angegebenen Text mittels Google in gesprochenen Text um und spielt diesen mittels <code>PlayURITemp</code> ab. An dieser Stelle ist zu berücksichtigen, dass der Text-Parameter auch Leerzeichen enthalten darf (und damit nach FHEM-Regeln eigentlich mehrere Parameter sind). Deswegen steht die Lautstärke vorne als nicht optionaler Parameter.
***'''Hinweis''': Im Text können MP3-File-Verweise eingebettet werden. Diese müssen vorne und hinten mit einem '''|''' und einem Leerzeichen abgetrennt werden. Außerdem darf der Dateiname selbst kein Leerzeichen enthalten.<br />Beispieltexte:
****'''|/path/to/Gong.mp3| Achtung! Achtung! Die Waschmaschine ist fertig.'''
****'''Die Datei kann auch |/path/to/Tada.mp3| mittendrin stehen.'''
****'''|/path/to/Gong.mp3| Es können auch |/path/to/Tada.mp3| mehrere Dateien eingebettet werden.'''
***'''Hinweis''': Es kann ein Standardpfad für diese Jingle-Dateien angegeben werden, dann braucht man im Text nur den Dateinamen anzugeben. Das Attribut am Sonos-Device dafür lautet ''targetSpeakMP3FileDir''. z.B.: '''/path/to'''. Des Weiteren kann die Endung ''.mp3'' auch weggelassen werden.<br />Damit können die Texte z.B. so gekürzt werden:
****'''|Gong| Achtung! Achtung! Die Waschmaschine ist fertig.'''
****'''Die Datei kann auch |Tada| mittendrin stehen.'''
****'''|Gong| Es können auch |Tada| mehrere Dateien eingebettet werden.'''
***'''Hinweis''': Eine Website mit einigen Jingles und kurzen Tönen zur kostenfreien, privaten, Verwendung ist z.B. [http://soundbible.com/tags-gong.html soundbible.com]. Dort gibt es auch Gebell und ähnliches :-)
***'''Achtung!''': Die Verkettung der diversen MP3-Dateien erfolgt durch einfaches hintereinanderschreiben. Bei verschiedenen Formaten (Mono oder Stereo, 16kHz oder 22kHz, usw.) funktioniert zwar die Wiedergabe auf dem Sonos-System fehlerfrei, allerdings werden die Zeitinformationen nicht korrekt dargestellt. Um das zu korrigieren, kann man noch nachträglich einen lokal installierten Konverter (z.B. ''avconv'') drüberlaufen lassen. Diesen kann man mit dem Sonos-Device-Attribut ''targetSpeakMP3FileConverter'' einstellen (z.B. mit ''/usr/bin/avconv -i %infile% %outfile%''). Dabei ist zu beachten, dass dieser Zeit benötigt und somit die Verzögerung der Durchsage vergrößert.
***'''Achtung!''': Für die korrekte Funktionsweise müssen die Attribute <code>targetSpeakDir</code> und <code>targetSpeakURL</code> am Sonos-Device konfiguriert sein (siehe [[#Attribute_von_SONOS|Attribute von SONOS]]).
***Mögliche Sprachparamter können bei Google herausgefunden werden. Diese sind z.B. '''de''', '''en''', '''es''', '''fr''', '''it'''...
***'''Achtung!''': Die Textlänge ist durch Google begrenzt. Wenn die Größe überschritten wird, wird die Tonerzeugung in mehrere Aufrufe unterteilt. Davon merkt man im Prinzip wenig, ausser dass die Wiedergabeverzögerung höher ist, und die Sprachmelodie an der Trennstelle etwas "holprig" wirkt.
***'''Achtung!''': Wenn bereits eine temporäre Ausgabe erfolgt, so wird die Aufforderung mit einer entsprechenden Meldung verworfen. Es kann nur eine geben :-)
**<code>StartFavourite <FavouriteName> [NoStart]</code>: Startet den angegebenen Favoriten. Der Name bezeichnet einen Eintrag in der Sonos-Favoritenliste. Der Parameter sollte/kann URL-Encoded (z.B. mittels '''uri_escape()''' oder manuell) werden um auch Spezialzeichen zu ermöglichen.<br />Siehe auch die Hinweise unter '''LoadFavourite'''.
***Wenn das Wort 'NoStart' als zweiter Parameter angegeben wurde, dann wird der Favorit geladen und fertig vorbereitet, aber nicht explizit gestartet (entspricht dann einem ''LoadFavourite'').
**<code>StartPlaylist <Playlistname> [ListeVorherLeeren]</code>: Lädt die benannte Playlist und startet sofort die Wiedergabe.<br />Zu den Parametern und Bemerkungen bitte unter '''LoadPlaylist''' nachsehen.
**<code>StartRadio <Radiostationname></code>: Lädt den benannten Radiosender, genauer gesagt, den benannten Radiofavoriten und startet sofort die Wiedergabe. Dabei wird die bestehende Abspielliste beibehalten, aber deaktiviert. Der Parameter kann/muss URL-Encoded (z.B. mittels '''uri_escape()''' oder manuell) sein, um auch Leer- und Sonderzeichen angeben zu können.
**<code>StartSearchlist <Kategoriename> <KategorieElement> [[TitelfilterRegEx]/[AlbumfilterRegEx]/[ArtistfilterRegEx] [maxElem]]</code>: Ruft den Befehl '''LoadSearchlist''' auf und startet anschließend die Wiedergabe. Zu den genauen Beschreibungen der Funktion und Parameter bitte den Set-Befehl '''LoadSearchlist''' nachschlagen.
**<code>Stop</code>: Stoppt die Wiedergabe
**<code>Track <TrackNumber></code>: Stellt das Lied an der Position TrackNumber in der Abspielliste als aktuelles Lied ein. Dabei kann als Tracknummer der Wert <code>Random</code> angegeben werden. Dann wird eine zufällige Tracknummer ausgewählt (diese Ermittlung erfolgt nach Setzen der aktuellen Abspielliste, und erfolgt somit korrekt auf die gesamte zur Verfügung stehende Liste).
*Einstellungen zum Abspielen
**<code>Balance</code>: Setzt die Balance auf den angegebenen Wert. Der Wert kann zwischen -100 (voll links) und 100 (voll rechts) liegen. Gibt die wirklich eingestellte Balance als Ergebnis zurück.
**<code>Bass</code>: Setzt den Bass-Level auf den angegebenen Wert. Der Wert kann zwischen -10 und 10 liegen.
**<code>CrossfadeMode</code>: Legt den Zustand des Crossfade-Mode fest. Liefert den aktuell gültigen Crossfade-Mode.
**<code>LEDState</code>: Legt den Zustand der LED fest. Liefert den aktuell gültigen Zustand zurück.
**<code>Loudness</code>: Aktiviert oder deaktiviert das Loudness (Bassanhebung bei geringen Lautstärken). Kann 0 oder 1 sein.
**<code>Mute <State></code>: Setzt den Mute-Zustand auf den angegebenen Wert. Der Wert kann on oder off sein. Liefert als Ergebnis den neuen Zustand.
**<code>MuteT</code>: Schaltet den Mute-Zustand um. Liefert als Ergebnis den neuen Zustand.
**<code>Repeat</code>: Legt den Zustand des Repeat-Zustands fest. Liefert den aktuell gültigen Repeat-Zustand.
**<code>RepeatOne</code>: Legt den Zustand des RepeatOne-Zustands fest. Liefert den aktuell gültigen RepeatOne-Zustand.
**<code>RepeatOneT</code>: Schaltet den Zustand des RepeatOne-Zustands um. Liefert den aktuell gültigen RepeatOne-Zustand.
**<code>RepeatT</code>: Schaltet den Zustand des Repeat-Zustands um. Liefert den aktuell gültigen Repeat-Zustand.
**<code>Shuffle</code>: Legt den Zustand des Shuffle-Zustands fest. Liefert den aktuell gültigen Shuffle-Zustand.
**<code>ShuffleT</code>: Schaltet den Zustand des Shuffle-Zustands um. Liefert den aktuell gültigen Shuffle-Zustand.
**<code>SleepTimer <Timestring|Seconds></code>: Legt den aktuellen SleepTimer fest. Der Wert muss ein kompletter Zeitstempel sein (HH:MM:SS) (oder eine Zahl in Sekunden). Zum Deaktivieren darf der Zeitstempel nur Nullen enthalten oder das Wort 'off'.
**<code>Treble</code>: Setzt den Höhen-Level auf den angegebenen Wert. Der Wert kann zwischen -10 und 10 liegen.
**<code>Volume <VolumeLevel> [RampType]</code>: Setzt die Lautstärke auf den angegebenen Wert. Der kann eine relative Angabe mittels + oder - sein. Dann wird um die entsprechende Höhe erhöht oder verringert. Wird eine relative Lautstärke angegeben, so kann diese mit einem folgenden Prozentzeichen als anteilige Änderung ausgeführt werden (z.B. +20%). Liefert als Ergebnis die neue Lautstärke.<br />Als optionaler Parameter ist ein Ramptype zulässig. Mögliche Werte sind 1 (SLEEP_TIMER_RAMP_TYPE), 2 (AUTOPLAY_RAMP_TYPE) und 3 (ALARM_RAMP_TYPE). Die Werte entsprechen verschiedenen Mustern bei der Geschwindigkeit nach oben oder unten.
**<code>VolumeD</code>: Verringert die Lautstärke um [VolumeStep]-Einheiten (Standardmäßig 7).
**<code>VolumeRestore</code>: Stellt die mittels VolumeSave gespeicherte Lautstärke wieder her.
**<code>VolumeSave <VolumeLevel></code>: Setzt die Lautstärke auf den angegebenen Wert. Der kann eine relative Angabe mittels + oder - sein. Dann wird um die entsprechende Höhe erhöht oder verringert. Liefert als Ergebnis die neue Lautstärke. Zusätzlich wird die alte Lautstärke in einem Reading abgelegt, um sie wiederherstellen zu können.
**<code>VolumeU</code>: Erhöht die Lautstärke um [VolumeStep]-Einheiten (Standardmäßig 7).
*Steuerung der aktuellen Abspielliste
**<code>AddURIToQueue <SongURI></code>: Fügt die angegebene Datei in die aktuelle Abspielliste an die Stelle hinter dem aktuellen Titel hinzu. Ändert nichts am aktuell abgespielten Titel.<br />Zulässige Formate stehen unter <code>PlayURI</code>.
***'''Achtung!''': Es kann auch ein Radio-Stream hinzugefügt werden. Dieser wird auch normal abgespielt, wenn er dran ist. Dabei ist zu beachten, dass dieser Titel nie enden wird, und die Titel- und Interpretinformationen nicht dargestellt werden. Auch nicht die sonst üblichen Streaminformationen. Diese werden nur angezeigt, wenn der Stream mittels <code>PlayURI</code> direkt (ohne Verwendung der Queue) abgespielt wird.
**<code>CurrentPlaylist</code>: Setzt den Abspielmodus auf die aktuelle Abspielliste, startet aber keine Wiedergabe (z.B. nach dem Hören eines Radiostreams, wo die aktuelle Abspielliste zwar noch existiert, aber gerade "nicht verwendet" wird)
**<code>DeleteFromQueue <index_of_elems></code>: Löscht die angegebenen Elemente aus der aktuellen Abspielliste. Die Angabe erfolgt über die Indizies der Titel. Es können die bei Perl-Array-üblichen Formate verwendet werden: "1..12,17,20..22". Die Indizies beziehen sich auf die aktuell angezeigte Reihenfolge (diese unterscheidet sich zwischen der normalen Abspielweise und dem Shufflemodus).
**<code>DeletePlaylist</code>: Löscht die bezeichnete Playliste. Zum möglichen Format des Playlistenamen unter '''LoadPlaylist''' nachsehen.
**<code>EmptyPlaylist</code>: Löscht die aktuelle Abspielliste
**<code>LoadFavourite <FavouriteName></code>: Lädt den angegebenen Favoriten. Der Name bezeichnet einen Eintrag in der Sonos-Favoritenliste. Der Parameter sollte/kann URL-Encoded (z.B. mittels '''uri_escape()''' oder manuell) werden um auch Spezialzeichen zu ermöglichen.
***'''Hinweis''': Man kann anstatt des Namens auch einen regulären Ausdruck verwenden. Es dürfen keine Leerzeichen vorkommen. Der erste Treffer wird verwendet.<br />Beispiele:
****'''/meine.hits/''' - Trifft Case-Sensitive auf z.B. '''meine hits''' zu. Auch '''meineXhits''' oder '''meine-hits''' wird gefunden.
****'''/(?i)meine.hits/''' - Trifft Case-Insensitive auf z.B. '''Meine Hits''' zu. Auch '''Meine-Hits''' wird gefunden.
***Folgende Unterscheidungen werden auf Basis des Typs des Sonos-Favoriten gemacht:
****Bei einem Playlist-Typ (z.B. Sonos-Playlist, Spotify-Playlist, usw.) wird die aktuelle Abspielliste geleert, mit dem neuen Inhalt befüllt und die Wiedergabe gestartet
****Bei einem Einzel-Eintrag (Direkter Titel, Radiosender, Spotify-Titel, usw) wird die aktuelle Abspielliste nicht angetastet, sondern der aktuelle Abspieleintrag entsprechend angepasst und gestartet
**<code>LoadPlaylist <Playlistname|FHEM-Devicename> [ListeVorherLeeren]</code>: Lädt die benannte Playliste in die aktuelle Abspielliste. Der Parameter kann/muss URL-Encoded (z.B. mittels '''uri_escape()''' oder manuell) sein, um auch Leer- und Sonderzeichen angeben zu können. Wenn der Parameter ''ListeVorherLeeren'' mit ''1'' angegeben wurde, wird die aktuelle Abspielliste vor dem Import geleert. Standardmäßig wird hier eine ''1'' angenommen.
***'''Hinweis''': Man kann anstatt des Namens auch einen FHEM-Sonosplayer-Devicenamen angeben. Dann wird dessen aktuelle Abspielliste zum Player übertragen/kopiert.
***'''Hinweis''': Man kann anstatt des Namens auch einen regulären Ausdruck verwenden. Es dürfen keine Leerzeichen vorkommen. Der erste Treffer wird verwendet.<br />Beispiele:
****'''/meine.hits/''' - Trifft Case-Sensitive auf z.B. '''meine hits''' zu. Auch '''meineXhits''' oder '''meine-hits''' wird gefunden.
****'''/(?i)meine.hits/''' - Trifft Case-Insensitive auf z.B. '''Meine Hits''' zu. Auch '''Meine-Hits''' wird gefunden.
***'''Hinweis''': Es kann auch ein Dateiname angegeben werden, um eine übliche M3U-Datei aus dem Filesystem zu laden. Dieser muss mit "'''file:'''" eingeleitet werden. Beispiel: "'''file:c:/Test.m3u'''".<br />Innerhalb der Datei selbst werden bislang folgende Sonderformate unterstützt:
****'''Spotify:''' Titel aus Spotify werden mit dem Kürzel ''x-sonos-spotify:'' begonnen.
****'''Napster/Rhapsody:''' Titel aus Napster/Rhapsody werden mit dem Kürzel ''npsdy:'' begonnen.
****''Hinweise'': Die Benutzernamen für diese Importe, die zum Zeitpunkt des Import bekannt sein müssen, müssen zuvor dem System bekannt gemacht werden. Ansonsten erscheint eine entsprechende Fehlermeldung.<br />So kann der Benutzername für eines der Systeme bekannt gemacht werden:
*****Aktuelle Abspielliste eines Players leeren
*****Einen beliebigen Titel aus dem gewünschten Anbieter in die aktuelle Abspielliste einfügen. Dabei ist zu beachten, dass man das direkt aus der Auswahl des Anbietes heraus macht (also nicht über eine Playliste, Favoriten o.ä. Direktzugriffe)
*****Nun gibt es ein neues Reading am zentralen Sonos-Device, welches den Benutzernamen enthält. Um diesen Dauerhaft bereitzustellen, muss der Zustand mittels ''save'' gespeichert werden.
**<code>LoadRadio <Radiostationname></code>: Lädt den benannten Radiosender, genauer gesagt, den benannten Radiofavoriten. Dabei wird die bestehende Abspielliste beibehalten, aber deaktiviert. Der Parameter kann/muss URL-Encoded sein, um auch Leer- und Sonderzeichen angeben zu können.
***'''Hinweis''': Man kann anstatt des Namens auch einen regulären Ausdruck verwenden. Es dürfen keine Leerzeichen vorkommen. Der erste Treffer wird verwendet.<br />Beispiele:
****'''/NRJ.90s/''' - Trifft Case-Sensitive auf z.B. '''NRJ 90s''' zu. Auch '''NRJx90s''' oder '''NRJ-90s''' wird gefunden.
****'''/(?i)nrj.90s/''' - Trifft Case-Insensitive auf z.B. '''NRJ 90s''' zu. Auch '''NRJ-90s''' wird gefunden.
**<code>LoadSearchlist <Kategoriename> <KategorieElement> [[TitelfilterRegEx]/[AlbumFilterRegEx]/[ArtistfilterRegEx] [[*]maxElem[+|-]]]</code>: Hiermit kann die aktuelle Abspielliste mit Suchergebnissen aus der Sonos-Bibliothek gefüllt werden.<br />Dazu kann man sich im Controller anschauen, wie die Suchstruktur aufgebaut ist:
***'''Kategoriename''': kann "Albums", "Artists", "Composers", "Contributing Artists", "Genres", "Playlists" oder "Tracks" sein. Leerzeichen müssen wie immer URI-Encoded sein (also ''%20''). Diese Liste kann mit dem Get-Befehl ''SearchlistCategories'' ermittelt werden, da Sonos auch neue hinzufügen könnte.<br />Man kann hier einen regulären Ausdruck mit ''/'' eingeschlossen angeben, z.B. ''/Contr.*/''.
***'''KategorieElement''': enthält einen zur Suchkategorie passenden Wert als gesamten Match. Kann/muss URI-Encoded (z.B. mittels '''uri_escape()''' oder manuell) sein.<br />Man kann hier auch einen regulären Ausdruck mit ''/'' eingeschlossen angeben, z.B. ''/(?i)udo.jürgens/''.
***'''Filter''': Man kann reguläre Ausdrücke als Titel-, Album- oder Artistfilter angeben, der als ein Parameter mit ''/'' getrennt angegeben werden muss.<br />Dieser Filter filtert die durch die beiden vorangehenden Werten vorgegebene Liste getrennt nach Titel, Album oder Artist, z.B. ''(?i)haus'' (enthält dann alles, was auf Haus im Titel ohne Berücksichtigung der Groß-/Kleinschreibung passt) oder ''(?i)haus//(?i)udo'' (enhält dann alles, was auf den Titel ''Haus'' und den Interpret ''Udo'' ohne Berücksichtigung der Groß-/Kleinschreibung passt) sowie z.B. ''/(?i)Best.of/'' (enthält dann alle Best-of-Alben beliebiger Interpreten).
****'''Beispiele''' für den Filter-Parameter:
*****<code>//Udo</code>: Filtert nach dem Interpretenbestandteil ''Udo'', der Titel ist beliebig. Alternative Schreibweise: <code>.*/.*/Udo</code>
*****<code>Sahne</code>: Filtert nach dem Titelbestandteil ''Sahne'', das Album und der Interpret sind beliebig. Alternative Schreibweisen: <code>Sahne/.*/.*</code> oder <code>Sahne//</code>.
*****<code>Sahne//Udo</code>: Filtert nach dem Titelbestandteil ''Sahne'' und dem Interpretenbestandteil ''Udo''
*****<code>(?i)sahne//(?i)udo</code>: Filtert nach dem Titelbestandteil ''sahne'' und dem Interpretenbestandteil ''udo'' ohne die Groß-/Kleinschreibung zu berücksichtigen.
*****<code>/(?i)best.of/</code>: Filtert nach dem Albumtitel Best-of. Alternative Schreibweisen: <code>.*/(?i)best.of</code> oder <code>.*/(?i)best.of/.*</code>
***'''maxElem''': Hiermit kann eine Begrenzung der einzutragenden Element angegeben werden. Des Weiteren kann hier durch ein vorangestelltes ''*'' eine Durchmischung der Ausgangsmenge erreicht werden, und durch ein nachgestelltes ''-'' das Leeren der aktuellen Abspielliste erreicht werden. Durch ein nachgestelltes ''+'' wird ein Anhängen der gefundenen Titel an das Ende der aktuellen Abspielliste erreicht (sonst wird hinter dem aktuellen Titel eingefügt).<br />Eine Angabe von 0 übernimmt alle verfügbaren Titel.<br />Diese Mengenbegrenzung erfolgt erst nach Anwendung der Filter auf die Ausgangsmenge (die Durchmischung ebenfalls). z.B. ''*20-'' (es werden nur 20 Titel ausgesucht, die Ausgangsmenge wird zuvor zufällig gemischt, und die aktuelle Abspielliste vor dem Einfügen geleert), ''*10'' (es werden 10 zufällige Titel zu der Abspielliste an der aktuellen Stelle hinzugefügt) oder ''10'' (es werden die ersten 10 Titel zu der Abspielliste an der aktuellen Stelle hinzugefügt).
***'''Hinweis''': Wenn die Kategorie ''Tracks'' verwendet wird, wird der zweite Parameter (''KategorieElement'') nicht verwendet. Dieser muss als Platzhalter trotzdem vorhanden sein, und kann z.B. mit einem Punkt ''.'' angegeben werden.
***'''Achtung''': Wenn die Kategorie ''Tracks'' verwendet wird, werden *alle* Titel, die in der Sonos-Bibliothek enthalten sind, durchsucht. Das kann bei einer Bibliothek mit 20.000 Titeln locker mal 4 Minuten dauern. Dabei wird die Zeit hauptsächlich vom Sonosplayer verbraucht; Es ist also für die Laufzeit nicht relevant, ob das Modul z.B. auf einem Raspberry Pi oder einer leistungsfähigeren Hardware läuft.<br />Bitte beachten, das während dieser Zeit keine Sonos-Nachrichten verarbeitet werden, und keine Befehle an die Player gesendet werden können. FHEM wird währenddessen nicht blockiert.
***'''Beispiele'''<br />Bitte beachten, dass sich die Möglichkeiten nach der zugrundeliegenden Bibliothek richten.
****<code>set Sonos_Wohnzimmer LoadSearchlist Genres Synthpop .*/(?i)pet *20-</code>: Hier wird das Genre ''Synthpop'' als Ausgangsliste verwendet und nach Interpreten mit ''pet'' gefiltert. Von dieser Menge werden 20 zufällige Einträge in die Abspielliste übernommen, die vorher geleert wurde.
****<code>set Sonos_Wohnzimmer LoadSearchlist /(?i)contr.*/ /(?i)pet.*?shop.*?boys/ / *10-</code>: Hier werden die Teilnehmenden Interpreten nach den ''Pet Shop Boys'' durchsucht, und anschließend aus dieser Liste 10 beliebige Titel in die vorher geleerte Abspielliste übertragen. Es erfolgt keine zusätzliche Filterung.
****<code>set Sonos_Wohnzimmer LoadSearchlist Tracks . / *50-</code>: Hier werden 50 beliebige Titel aus der gesamten Bibliothek in die Abspielliste übertragen. Bitte Hinweis zur Laufzeit beachten.
****<code>set Sonos_Wohnzimmer LoadSearchlist Tracks . /(?i)best.of/ *50-</code>: Hier werden 50 zufällige Titel von Best-of-Alben aus der gesamten Bibliothek in die Abspielliste übertragen. Bitte Hinweis zur Laufzeit beachten.
**<code>SavePlaylist <Playlistname></code>: Speichert die aktuelle Abspielliste unter dem angegebenen Namen als Playliste ab. Dabei wird eine etwaig bestehende Liste gleichen Namens überschrieben. Der Parameter kann/muss URL-Encoded (z.B. mittels '''uri_escape()''' oder manuell) sein, um auch Leer- und Sonderzeichen angeben zu können.
***'''Hinweis''': Es kann auch ein Dateiname angegeben werden, um eine übliche M3U-Datei im Filesystem zu erzeugen. Dieser muss mit "'''file:'''" eingeleitet werden. Beispiel: "'''file:c:/Test.m3u'''".<br />''Nähere Informationen zum möglichen Inhalt der Datei siehe unter '''LoadPlayList'''.''
*Gruppenbefehle
**<code>AddMember <Devicename></code>: Fügt dem Device das übergebene Device als Gruppenmitglied hinzu. Die Wiedergabe des aktuellen Devices bleibt erhalten, und wird auf das angegebene Device mit übertragen.
**<code>CreateStereoPair <rightPlayerDevicename></code>: Fügt dem Device das übergebene Device als rechtes Stereopaar-Element hinzu. Die Wiedergabe des aktuellen Devices bleibt erhalten (als linker Lautsprecher), und wird auf das angegebene Device mit übertragen (als rechter Lautsprecher).
**<code>GroupMute <State></code>: Setzt den Mute-Zustand für die komplette Gruppe in einem Schritt. Der Wert kann on oder off sein.
**<code>GroupVolume <VolumeLevel></code>: Setzt die Gruppenlautstärke. Das dafür verwendete Lautstärkenverhältnis muss zuvor einmal mittels der Anweisung '''SnapshotGroupVolume''' festgelegt worden sein.
***''Hinweis'': Wenn man '''GroupVolume''' aufruft, ohne vorher '''SnapshotGroupVolume''' aufgerufen zu haben, wird nur die Lautstärke des Players verändert wird, für den man den Aufruf durchführt.
**<code>MakeStandaloneGroup</code>: Macht diesen Player zu seiner eigenen Gruppe.
**<code>RemoveMember <Devicename></code>: Entfernt dem Device das übergebene Device, sodass die beiden keine Gruppe mehr bilden. Die Wiedergabe des aktuellen Devices läuft normal weiter. Das abgetrennte Device stoppt seine Wiedergabe, und hat keine aktuelle Abspielliste mehr (seit Sonos Version 4.2 hat der Player wieder die Playliste von vorher aktiv).
**<code>SeparateStereoPair</code>: Trennt das Stereopaar wieder auf.
**<code>SnapshotGroupVolume</code>: Legt das Lautstärkeverhältnis der aktuellen Player der Gruppe für folgende '''GroupVolume'''-Aufrufe fest. Dieses festgelegte Verhältnis wird bis zum nächsten Aufruf von '''SnapshotGroupVolume''' beibehalten.
***''Hinweis'': Das einzelne Verstellen von Zoneplayer-Laustärken mittels '''Volume''' wird nicht im bereits gespeicherten Lautstärkenverhältnis aktualisiert/widergespiegelt. Hat man also nachträglich die Lautstärke eines einzelnen Players geändert (auch über den Controller), so muss '''SnapshotGroupVolume''' erneut aufgerufen werden, damit das Verhältnis bei einer weiteren Gruppenlautstärkenänderung wieder erhalten bleibt (ansonsten wird das alte Verhältnis vor der Lautstärkeänderung wiederhergestellt).
***''Hinweis'': Dieser Aufruf muss vor einem eventuellen Aufruf von '''GroupVolume''' erfolgen, da sonst nur die Lautstärke des Players verändert wird, für den man den Aufruf durchführt.
***''Beispiel'' für eine Gruppe mit stark verschiedenen Lautstärken:
****Aufruf von '''SnapshotGroupVolume''' => Aktuelles Lautstärkeverhältnis wird gespeichert
****Aufruf von '''GroupVolume 2''' => Gruppe wird sehr leise gestellt, dabei sieht das relative Lautstärkeverhältnis fast gleich aus, da sich die Abstände immer weiter annähern
****Aufruf von '''GroupVolume 35''' => Gruppe wird laut gestellt, dabei kommt wieder das vorhergehende Lautstärkeverhältnis zum tragen

== Nützliche Hilfs-Prozeduren aus den Modulen ==
Das Modul liefert eine Menge kleiner Hilfs-Prozeduren mit, die teilweise auch für die eigene Verwendung interessant sein können.

*Grundsätzliches
**<code>SONOS_getAllSonosplayerDevices()</code>: Liefert ein Array mit allen Sonosplayerdevices, die in FHEM definiert sind.<br />'''Beispiel''':
***<code>my @allPlayer = SONOS_getAllSonosplayerDevices();</code><br />Liefert alle Sonosplayer.
**<code>SONOSPLAYER_DeleteIfExists($name)</code>: Löscht das Device mit dem übergebenen Namen, wenn es existiert.<br />'''Beispiel''':
***<code>SONOSPLAYER_DeleteIfExists('Sonos_Wohnzimmer');</code><br />Löscht das Device mit dem Namen ''Sonos_Wohnzimmer'', sofern es existiert. Es wird also keine Fehlermeldung erzeugt, wenn das Device nicht existiert.
**<code>SONOS_GetTimeSeconds($timeStr)</code>: Liefert die Anzahl der Sekunden, die vom übergebenen Zeitstring beschrieben werden. Der Zeitstring muss vom Format "H:M:S" sein. Die Zahlen könne auch mehrere Stellen umfassen.<br />'''Beispiel''':
***<code>my $sec = SONOS_GetTimeSeconds('0:04:12')</code><br />Liefert die Anzahl der Sekunden des String '0:04:12', in diesem Fall also ''252''.
**<code>SONOS_LoadExportedSonosBibliothek($fileName, $deviceName, $internalName)</code>: Lädt die angegebene Datei in das übergebene Device in das übergebene Internal. Vorher wird der Dateiinhalt per '''eval()''' in eine interne Datenstruktur umgewandelt. Damit kann eine zuvor mit '''ExportSonosBibliothek''' erzeugte Datei als Hash in ein beliebiges FHEM-Device eingelesen werden.<br />'''Beispiel''':
***<code>SONOS_LoadExportedSonosBibliothek('c:/data.txt', 'MyDummyDevice', 'Bibliothek');</code><br />Lädt die Datei '''c:/data.txt''' zunächst in einen Hash ein, und weist diesen Hash dann dem Device '''MyDummyDevice''' (kann ein beliebiges FHEM-Device sein) dem Internal '''Bibliothek''' zu.
**<code>SONOS_Max($param1, $param2)</code>: Liefert den größeren der beiden übergebenen Parameter zurück.<br />'''Beispiel''':
***<code>my $min = SONOS_Min(15, 23);</code><br />Das Ergebnis ist ''23'', da es der größere der beiden Werte ist.
**<code>SONOS_Min($param1, $param2)</code>: Liefert den kleineren der beiden übergebenen Parameter zurück.<br />'''Beispiel''':
***<code>my $min = SONOS_Min(15, 23);</code><br />Das Ergebnis ist ''15'', da es der kleinere der beiden Werte ist.
**<code>SONOS_isInList($search, @list)</code>: Liefert ''1'', wenn ''$search'' in ''@list'' enthalten ist, sonst ''0''.<br />'''Beispiel''':
***<code>my $exists = SONOS_isInList('Eins', qw(Eins Zwei Drei));</code><br />Das Ergebnis ist ''true'' (bzw. ''1''), da der String ''Eins'' in der Liste enthalten ist.
**<code>SONOS_posInList($search, @list)</code>: Liefert die Position des gefundenen Strings ''$search'' in der Liste ''@list'', wenn ''$search'' in ''@list'' enthalten ist, sonst ''-1''. Zählt 0-basiert.<br />'''Beispiele''':
***<code>my $pos = SONOS_posInList('Eins', qw(Eins Zwei Drei));</code><br />Das Ergebnis ist ''0'', da der String ''Eins'' in der Liste an der ersten Stelle enthalten ist.
***<code>my $pos = SONOS_posInList('Eins', qw(Zwei Eins Drei));</code><br />Das Ergebnis ist ''1'', da der String ''Eins'' in der Liste an der zweiten Stelle enthalten ist.
***<code>my $pos = SONOS_posInList('Vier', qw(Eins Zwei Drei));</code><br />Das Ergebnis ist ''-1'', da der String ''Vier'' in der Liste nicht enthalten ist.
**<code>SONOS_Stringify($elem)</code>: Liefert eine Stringrepräsentation der übergebenen Datenstruktur. Diese Struktur darf nicht rekursiv sein, da sonst eine Endlosschleife auftritt.<br />'''Beispiel''':
***<code>my @list = qw(Eins Zwei Drei); my $string = SONOS_Stringify(\@list);</code><br />Liefert eine Stringrepräsentation des Arrayparameters. In diesem Fall also <code>['Eins', 'Zwei', 'Drei']</code>
*Gruppenfunktionen
**<code>SONOSPLAYER_GetMasterPlayerName($name)</code>: Liefert den Namen des Masterplayerdevices zu einem übergebenen Sonosplayer-Devicenamen. Sollte der Player nicht Bestandteil einer Gruppe sein, dann wird der Name des übergebenen Players zurückgegeben.<br />'''Beispiel''':
***<code>my $groupMasterName = SONOSPLAYER_GetMasterPlayerName('Sonos_Wohnzimmer');</code><br />Liefert den Masterplayernamen der Gruppe, in der sich der Wohnzimmerplayer gerade befindet.
**<code>SONOSPLAYER_GetSlavePlayerNames($name)</code>: Liefert die Teilnehmer einer Gruppe. Der Master wird nicht mit zurückgegeben. Man kann den Namen eines beliebigen Teilnehmers angeben.<br />'''Beispiel''':
***<code>my @member = SONOSPLAYER_GetSlavePlayerNames('Sonos_Wohnzimmer');</code><br />Liefert alle Teilnehmer der Gruppe in der sich der Player ''Sonos_Wohnzimmer'' gerade befindet. Der Master der Gruppe wird nicht mitgeliefert.
**<code>SONOSPLAYER_GetRealTargetPlayerHash($hash)</code>: Liefert den Hash des Masterplayerdevices zu einem übergebenen Sonosplayer-Devicehash. Sollte der Player nicht Bestandteil einer Gruppe sein, dann wird der Hash des übergebenen Players zurückgegeben.<br />'''Beispiel''':
***<code>my $groupMasterHash = SONOSPLAYER_GetRealTargetPlayerHash($defs{'Sonos_Wohnzimmer'});</code><br />Liefert den Masterplayerhash der Gruppe, in der sich der Wohnzimmerplayer gerade befindet.

=== Die Funktionalität "ExportSonosBibliothek" ===
Die Funktionalität ''ExportSonosBibliothek'' ermöglicht einen kompletten Export der Struktur und Titelinformationen wie sie in dem Bereich ''Bibliothek'' des Sonos-Controllers dargestellt wird.
Dabei wird ein großer Perl-Hash erzeugt, der sowohl die Struktur als auch die eigentlichen Titel enthält. Im Bereich ''Struktur'' werden auf unterster (Titel-)Ebene die IDs der zugehörigen Titel als Verweis abgelegt, sodass man diese nicht mehrfach im Hash vorliegen hat.
Im Bereich ''Titel'' werden alle irgendwo referenzierten Titel mit ihren IDs und allen von Sonos übermittelten Informationen abgelegt.

Das Ermitteln dauert einige Zeit. Als Beispiel: Mein WindowsServer mit Intel Core i5 mit 2.8GHz benötigt für meine ca. 22.000 Titel 28 Minuten und 1GB RAM zum Ermitteln. Die resultierende Datendatei ist ca. 90MB groß.

==== Das Grundkonzept ====
Es gibt einen Setter ''ExportSonosBibliothek'' am Sonosplayer-Device, der eine Datei mit dem übergebenen Dateinamen erzeugt. In dieser Datei wird der komplette Datenhash als textuelle, und damit per <code>eval()</code> einlesbare, Darstellung gespeichert.
Die Cover der Titel werden als Aufruf auf den verwendeten Player erzeugt, und es wird berücksichtigt, ob man die Proxy-Einstellung aktiviert hat.

Um diese Datei wieder einzulesen, kann die mitgelieferte Prozedur <code>SONOS_LoadExportedSonosBibliothek($fileName, $deviceName, $internalName)</code> verwendet werden. Diese legt den geladenen Datenhash in einem Internal mit übergebenem Namen im benannten FHEM-Device ab. Das muss kein Sonosplayer-Device sein, sondern kann auch ein Dummy bzw. ein beliebiges FHEM-Device sein.

Von hier aus kann man mit anderen Methodiken auf diese Daten zugreifen. Durch die Dateiablage kann die Datei auch über einen Neustart hinweg verwendet werden, da die Ermittlung ja etwas Zeit in Anspruch nimmt.

'''Hinweis''': Mit Vorsicht ist z.B. der Bereich unter ''Tracks'' zu sehen, da dort alle(!) Titel auftauchen werden. Das kann eine Auswahlmöglichkeit auf einer (Web-)Oberfläche schnell mal sprengen.

==== Das Datenformat ====
Grundsätzlich gibt es zwei Bereiche im Hash: Einen für die Struktur und einen für die Titel.
Die Struktur ist dann mit einem dynamischen Unterbaum ausgestattet, um die nächsten Ebenen zu repräsentieren. Welche Ebenen dort vohanden sind, und wie tief die Verschachtelung geht, kann sich u.U. in Zukunft ändern, wenn Sonos dort Anpassungen vornimmt.
Die Titel sind als eine Liste ohne weitere Verschachtelung abgelegt.

Hier der Hash mit einigen Dummy-Beispieldaten, um den Inhalt zu verdeutlichen:
<pre>
my $hash =
{'Structure' => {
'A:PLAYLISTS' => {
'ID' => 'A:PLAYLISTS',
'Type' => 'Container',
'Title' => 'Playlists',
'Children' => {}
},
'A:GENRE' => {
'ID' => 'A:GENRE',
'Type' => 'Container',
'Title' => 'Genres',
'Children' => {}
},
'A:ALBUM' => {
'ID' => 'A:ALBUM',
'Type' => 'Container',
'Title' => 'Albums',
'Children' => {
'A:ALBUM/Chaos' => {
'ID' => 'A:ALBUM/Chaos',
'Type' => 'Container',
'Title' => 'Chaos',
'Artist' => 'Herbert Grönemeyer',
'Cover' => '/Pfad/zum/Cover/auch/mit/proxy/pfad',
'Children' => {
'TitleID1' => {
'ID' => 'TitleID1',
'Type' => 'Track'
},
'TitleID2' => {
'ID' => 'TitleID2',
'Type' => 'Track'
},
}
},
'A:ALBUM/Testalbum' => {
'ID' => 'A:ALBUM/Testalbum',
'Type' => 'Container',
'Title' => 'Testalbum',
'Artist' => 'Hansi Fischer',
'Cover' => '/Pfad/zum/Cover/auch/mit/proxy/pfad',
'Children' => {
'TitleID1' => {
'ID' => 'TitleID3',
'Type' => 'Track'
},
'TitleID2' => {
'ID' => 'TitleID4',
'Type' => 'Track'
},
}
}
}
},
'A:TRACKS' => {
'ID' => 'A:TRACKS',
'Type' => 'Container',
'Title' => 'Tracks',
'Children' => {}
},
'A:COMPOSER' => {
'ID' => 'A:COMPOSER',
'Type' => 'Container',
'Title' => 'Composers',
'Children' => {}
},
'A:ARTIST' => {
'ID' => 'A:ARTIST',
'Type' => 'Container',
'Title' => 'Contributing Artists',
'Children' => {}
},
'A:ALBUMARTIST' => {
'ID' => 'A:ALBUMARTIST',
'Type' => 'Container',
'Title' => 'Artists',
'Children' => {}
}
},
'Titles' => {
'TitleID1' => {
'ID' => 'TitleID1',
'TrackURI' => '/Pfad/zur/Datei.mp3',
'Title' => 'Titel des Musikstücks',
'Artist' => 'Interpret des Musikstücks',
'Album' => 'Titel des Albums',
'AlbumArtist' => 'Interpret des Albums',
'Cover' => '/Pfad/zum/Cover/auch/mit/proxy/pfad',
'OriginalTrackNumber' => 5
},
'TitleIDn' => {
'ID' => 'TitleIDn',
'TrackURI' => '/Pfad/zur/Datei.mp3',
'Title' => 'Titel des Musikstücks',
'Artist' => 'Interpret des Musikstücks',
'Album' => 'Titel des Albums',
'AlbumArtist' => 'Interpret des Albums',
'Cover' => '/Pfad/zum/Cover/auch/mit/proxy/pfad',
'OriginalTrackNumber' => 5
}
}
}
</pre>

==== Wie kann es angezeigt werden? ====
(Das soll noch erweitert werden...)

== Was wird alles automatisch erzeugt? ==
Hier soll kurz beschrieben werden, welche Elemente der automatische Erkennungsprozess anlegt, und welche Funktion diese haben.

=== Automatische Zoneplayererkennung ===
Erkannte Zoneplayer werden als '''SONOSPLAYER'''-Device angelegt:

<pre>define Sonos_Wohnzimmer SONOSPLAYER RINCON_000E5828D0F401400_MR</pre>

Der Name des Device wird aus dem Namen des SONOS-Device und dem Namen der Zone gebildet. Dabei werden Leer- und Sonderzeichen in "<code>_</code>" umgewandelt.

Beim Anlegen werden automatisch einige Attribute mit angelegt, am Beispiel eines Wohnzimmer-Players:
<pre>
attr Sonos_Wohnzimmer generateInfoSummarize1 <NormalAudio><Artist prefix="(" suffix=")"/>
<Title prefix=" '" suffix="'" ifempty="[Keine Musikdatei]"/>
<Album prefix=" vom Album '" suffix="'"/></NormalAudio>
<StreamAudio><Sender suffix=":"/><SenderCurrent prefix=" '" suffix="' -"/>
<SenderInfo prefix=" "/></StreamAudio>
attr Sonos_Wohnzimmer generateInfoSummarize2 <TransportState/><InfoSummarize1 prefix=" => "/>
attr Sonos_Wohnzimmer generateInfoSummarize3 <Volume prefix="Lautstärke: "/>
<Mute instead=" ~ Kein Ton" ifempty=" ~ Ton An" emptyval="0"/>
~ Balance: <Balance ifempty="Mitte" emptyval="0"/>
<HeadphoneConnected instead=" ~ Kopfhörer aktiv"
ifempty=" ~ Kein Kopfhörer" emptyval="0"/>
attr Sonos_Wohnzimmer icon icoSONOSPLAYER_icon-ZP90.png
attr Sonos_Wohnzimmer room Sonos
attr Sonos_Wohnzimmer stateVariable presence
attr Sonos_Wohnzimmer group Wohnzimmer
</pre>

Dadurch ist dieses Device direkt in der FHEM-Oberfläche steuerbar. Auch hier gilt, dass man das natürlich anpassen kann. Das sollen nur vereinfachende Vorgaben sein.
Das Attribut "<code>room</code>" wird wieder aus dem Namen des SONOS-Device gebildet.
Das Attribut "<code>group</code>" wird aus dem Namen der Zone gebildet

=== Zusätzliche Readingsgroups, die zunächst nichts anzeigen ===
Es werden zusätzliche [[readingsGroup]]s angelegt, die zunächst keine Inhalte anzeigen. Diese lesen das der Readingsgroup entsprechende Reading ''Favourites'', ''Radios'' oder ''Playlists'' aus.
Um diese Readings zu füllen gibt es bereits ein angelegtes '''userReadings''', welches auf die Get-Aufrufe von ''FavouritesWithCovers'', ''RadiosWithCovers'' oder ''PlaylistsWithCovers'' reagiert und die entsprechenden Readings füllt.

Unter [[#Beispiel für eine ReadingsGroup für die Darstellung von Listen (Favoriten, Playlisten und Radios)|Beispiel für eine ReadingsGroup für die Darstellung von Listen (Favoriten, Playlisten und Radios)]] gibt es Beispiele für ein at-Statement, mit dem diese Readings automatisch gefüllt werden können.
Damit werden diese auch in FHEM aktualisiert, wenn man diese am Sonos-Controller verändert.

=== Definition der InfoSummarize ===
<pre>
infoSummarizeX := <NormalAudio>:sumElem:</NormalAudio> <StreamAudio>:sumElem:</StreamAudio>|
:sumElem:
sumElem := <:variable:[ prefix=":text:"][ suffix=":text:"][ instead=":text:"]
[ ifempty=":text:"][ emptyval=":text:"]/>
variable := TransportState|NumberOfTracks|Track|TrackDuration|Title|Artist|Album|
OriginalTrackNumber|AlbumArtist|Sender|SenderCurrent|SenderInfo|StreamAudio|NormalAudio|
AlbumArtURI|nextTrackDuration|nextTrackURI|nextAlbumArtURI|nextTitle|nextArtist|
nextAlbum|nextAlbumArtist|nextOriginalTrackNumber|Volume|Mute|Shuffle|Repeat|RepeatOne|
CrossfadeMode|Balance|HeadphoneConnected|SleepTimer|Presence|RoomName|RoomNameAlias|
SaveRoomName|PlayerType|Location|SoftwareRevision|SerialNum|InfoSummarize1|InfoSummarize2|
InfoSummarize3|InfoSummarize4
text := [Beliebiger Text ohne doppelte Anführungszeichen]
</pre>
Die Unterscheidung zwischen <code><NormalAudio></code> und <code><StreamAudio></code> liegt bei der anliegenden Musikquelle. Gestreamte Audioquellen habe nur einen kleineren Set an Informationen vorliegen, während bei einer "normalen" Musikquelle z.B. eine Unterscheidung zwischen Artist und Title gemacht wird, und im Gegenzug z.B. kein Sendername existiert.<br />
Man kann diese Unterscheidung auch weglassen, und direkt die Variablenausgaben hinschreiben. Dann gilt der Code für beide Musikquellenarten gleichermaßen (u.U. sind dann einige Felder nicht sinnvoll bzw. gar nicht gefüllt).

Die Tag-Erweiterungen <code>prefix</code> und <code>suffix</code> werden jeweils vor bzw. hinter den Feldwert in die Ausgabe gesetzt, wenn es einen Feldwert zum Ausgeben gibt. <br />
Die Erweiterung <code>instead</code> wird anstatt des Feldwerts ausgegeben, wenn normalerweise der Feldwert ausgegeben werden würde (abhängig davon, ob der Feldwert als ''empty'' angesehen wird, oder nicht).<br />
Die Erweiterung <code>ifempty</code> wird eingesetzt, wenn es gerade ''keinen'' Feldinhalt gibt. In diesem Fall werden natürlich auch keine Pre- und Suffixe sowie Instead-Angaben ausgegeben.<br />
Die Erweiterung <code>emptyval</code> legt fest, was neben einem undefinierten Feldwert noch als ''leer'' gelten soll. Dies ist interessant, wenn man z.B. den Zahlwert ''0'' als ''leer'' festlegen möchte.<br />
Beim Definieren dieser Erweiterungen ist zu beachten, dass keine doppelten Anführungszeichen angegeben werden. Diese zerstören die weitere, interne Verarbeitung durch FHEM (Irgendwas ist immer :-)
Desweiteren können Verweise auf andere <code>InfoSummarize</code>-Felder nur in aufsteigender Reihenfolge erfolgen. Es sind also keine Vorwärtsreferenzen oder Rekursionen möglich.

== Fehlende Kommandos ==
Sollte eine Steuerungsmöglichkeit oder Information fehlen, oder anderes gewünscht sein, dann einfach eine Nachricht ins Forum. Meistens läßt sich da was machen :-)

=== Ideenpipeline ===
Folgende Ideen sind bereits in der gedanklichen Pipeline. Aber alles Schritt für Schritt und der Reihe nach:
*'''Momentan Leer'''

Erledigte Ideen:
*'''Zwischendurchsage''': Eine Datei abspielen, und danach wieder an der alten Stelle mit der alten Lautstärke weiterspielen (In Version 1.5 hinzugekommen)
*'''Beliebige MP3s in die Queue legen oder abspielen''': Entgegen dem Controllergefühl kann man sehr wohl völlig frei abspielbare Dateien in der Queue haben. Es kann nur sein, das man kein Cover oder ähnliches angezeigt bekommt (noch zu testen). (In Version 1.5 hinzugekommen, Cover funktionieren wie immer)
*'''Beliebige Radiostationen abspielen''': Hier gilt das gleich wie für die MP3s. (In Version 1.5 hinzugekommen, Cover und Streaminformationen funktionieren beim Direktabspielen, aus der Queue heraus wird nur der Stream abgespielt)
*'''Lautstärkegrenzen festlegen''': Damit soll festgelegt werden können, in welchen Grenzen die Lautstärke überhaupt verändert werden kann. Das soll in der entsprechenden Zone natürlich auch für die normalen Sonos-Controller gelten. Dabei werden explizit ''keine'' Readings im FHEM aktualisiert, da eine Lautstärkeänderung sonst von der Verarbeitungsgeschwindigkeit von FHEM (inkl. seiner Notifies) abhängig wäre. (In Version 1.8 hinzugekommen)
*'''Zonentopologie verwenden/anpassen''': Es soll eine Speichermöglichkeit für die aktuelle Topologie geschaffen werden, und auch eine neue Topologie gesetzt werden können. Ich stelle mir da eine Art von "Szenen" vor die man nach Bedarf setzen und dann natürlich auch steuern kann. Diese Szenen sollen den Gruppierungszustand aller verfügbaren ZonePlayer repräsentieren (können), also wer mit wem in einer Gruppe ist, und wer der jeweilige Koordinator ist (nur dieser kann die Steuerung entgegennehmen, und für die gesamte Gruppe ausführen). (In Version 2.0 hinzugekommen)
*'''Button-Events''': Es soll eine Möglichkeit zum direkten Reagieren auf Tastenevents am Player existieren. Man soll verschiedene Tastensequenzen festlegen können, die dann FHEM-Events erzeugen, auf die man reagieren kann. (In Version 2.0 hinzugekommen)
*'''relatives Spulen''': während einer Wiedergabe soll mit "currentTrackPosition x" mit x festgelegt werden, umwieviel sekunden vorgespult werden soll. Analog dazu das zurückspulen (In Version vom 12.3.2017 hinzugekommen)

== Beispiele ==
Hier können mit der Zeit ein paar Beispiele eingestellt werden, um die Möglichkeiten zu verdeutlichen.

'''Hinweis:''' Die Codebeispiele wurden umgebaut, damit diese für eine Bearbeitung über die FHEMWeb-Oberfläche passend sind. Wenn man die Beispiele direkt in einer Konfigurationsdatei verwenden möchte, so müssen die ''';''' maskiert werden (also verdoppelt).

=== Beispiel zum Loggen aller Aktionen auf allen Playern ===
<pre>define FileLog_Sonos_Actions FileLog /path/to/log/Sonos_Actions-%Y-%m.log \
Sonos_.*:.*LastActionResult.*</pre>
Hiermit wird jede Aktion, die, durch FHEM verursacht, an die Player gesendet wurde, mitgeschrieben. Sehr praktisch für Fehlersuche, bzw. die Kontrolle darüber, was eigentlich von FHEM aus so auf den Playern gesteuert wird.

=== Beispiel zum automatischen Abspielen einer Liste nach dem Einschalten eines Players ===
<pre>define Sonos_Wohnzimmer_Appeared_Notify notify Sonos_Wohnzimmer:presence:.appeared { \
fhem "set Sonos_Wohnzimmer LoadPlaylist R.%20Spielliste" ; \
fhem "set Sonos_Wohnzimmer Volume 15" ; \
fhem "set Sonos_Wohnzimmer Track random" ; \
fhem "set Sonos_Wohnzimmer Play" \
}</pre>

Hier wird auf das Event '''presence: appeared''' reagiert und eine Playlist geladen (hier mit Leerzeichen im Namen, darum mittels "<code>%20</code>" HTML-kodiert, was wiederum bei FHEM-Featurelevel < 5.7 wegen FHEM-Notify auf "<code>%%20</code>" kodiert werden müsste). Anschließend wird die Lautstärke gesetzt, ein Titel ausgewählt (zufällig) und das Abspielen gestartet.

Da dies aber auch bei einem Neustart von FHEM getriggert wird, kann man noch eine zusätzliche Prüfung einbauen:
<pre>define Sonos_Wohnzimmer_Appeared_Notify notify Sonos_Wohnzimmer:presence:.appeared { \
if (ReadingsVal('Sonos_Wohnzimmer', 'numberOfTracks', -1) == 0) {\
fhem "set Sonos_Wohnzimmer LoadPlaylist R.%20Spielliste" ; \
fhem "set Sonos_Wohnzimmer Volume 15" ; \
fhem "set Sonos_Wohnzimmer Track random" ; \
fhem "set Sonos_Wohnzimmer Play" \
}\
}</pre>

Alternativ kann man auch das Reading '''currentTrackURI''' prüfen, je nachdem, was mit dem Player passieren soll.

=== Beispiel für eine Verstärkerschaltung auf Basis des Player-Zustands ===
<pre>define Sonos_Wohnzimmer_GoPlaying_Notify notify Sonos_Wohnzimmer:transportState.*PLAYING { \
fhem "delete wohnzimmer_Sonos_Ton_Off_Timer" ; \
if (Value('wohnzimmer_Sonos_Ton') ne 'on') { \
fhem "set wohnzimmer_Sonos_Ton on" \
} \
}
define Sonos_Wohnzimmer_GoNotPlaying_Notify notify \
Sonos_Wohnzimmer:transportState.*(STOPPED|PAUSED_PLAYBACK) { \
fhem "delete wohnzimmer_Sonos_Ton_Off_Timer" ; \
fhem "define wohnzimmer_Sonos_Ton_Off_Timer at +00:05:00 \
set wohnzimmer_Sonos_Ton off" \
}</pre>

Hier wird beim Wechsel des <code>transportState</code> auf "<code>PLAYING</code>" der Verstärker angeschaltet, und beim Wechsel auf "<code>STOPPED</code>" oder "<code>PAUSED_PLAYBACK</code>" ein Timer zum Ausschalten des Verstärkers in 5 Minuten definiert.<br />Der Timer ist notwendig, da beim Wechsel zwischen einem "normalen" Titel und einem Radiostream ein kurzer Zwischenwechsel auf "<code>STOPPED</code>" erfolgt, und ich nicht den Verstärker innerhalb von ein paar Sekunden aus- und wieder einschalten will.

Das Ganze geht mittlerweile viel kürzer mit dem Modul [[DOIF]]:
<pre>define Sonos_Wohnzimmer_PlayingCheck DOIF ([Sonos_Wohnzimmer:transportState] eq "PLAYING") \
(set wohnzimmer_Sonos_Ton on) DOELSE (set wohnzimmer_Sonos_Ton off)
attr Sonos_Wohnzimmer_PlayingCheck wait 0:300</pre>

=== Beispiel für das Loggen des gerade abgespielten Titels ===
<pre>define FileLog_Sonos_Wohnzimmer FileLog /etc/fhem/log/Sonos_Wohnzimmer-%Y-%m.log \
Sonos_Wohnzimmer:infoSummarize2:.{2,}
attr FileLog_Sonos_Wohnzimmer room Sonos</pre>

Hier wird bei jedem Wechsel des Titels oder des Abspielzustands ein Eintrag ins Log geschrieben. Damit kann man, auch bei einem Radiosender, verfolgen, welche Titel zu welcher Zeit so über den Player gelaufen sind :-)

=== Beispiel für eine Stummschaltung bei einem Anruf ===
<pre>
define fritzBox_anrufstartring_notify notify fritzBox:.*ring set Sonos_Wohnzimmer VolumeSave 15
define fritzBox_anrufstartcall_notify notify fritzBox:.*call set Sonos_Wohnzimmer VolumeSave +0
define fritzBox_anrufende_notify notify fritzBox:.*disconnect set Sonos_Wohnzimmer VolumeRestore
</pre>

Der Trigger auf 'call' existiert nur, damit ausgehende Telefonate beim Beenden nicht die Lautstärke verändern. Das passiert, weil das Disconnected-Event auch nach ausgehenden Anrufen kommt.<br />Das Beispiel kann man natürlich noch beliebig erweitern, vielleicht etwas mit Anrufererkennung usw.

=== Beispiel für eine Anrufsignalisierung per MP3 bei einem Anruf ===
<pre>
define fritzBox_anrufstartringsong_notify notify fritzBox:.*ring set Sonos_Wohnzimmer \
PlayURITemp \\Server\Audio\RingRingRing.mp3 30
</pre>

Hier wird bei Anruf die angegebene MP3-Datei temporär mit der Lautstärke 30 eingeblendet. Wenn die Datei abgespielt wurde, wird der vorherige Zustand im Player wiederhergestellt, und es geht weiter, wo unterbrochen wurde.

=== Beispiel für beide Varianten beim Telefonanruf gleichzeitig ===
<pre>
define fritzBox_anrufstartring_notify notify fritzBox:.*ring set Sonos_Wohnzimmer VolumeSave 15 \
;; set Sonos_Wohnzimmer PlayURITemp \\Server\Audio\RingRingRing.mp3 30
define fritzBox_anrufstartcall_notify notify fritzBox:.*call set Sonos_Wohnzimmer VolumeSave +0
define fritzBox_anrufende_notify notify fritzBox:.*disconnect set Sonos_Wohnzimmer VolumeRestore
</pre>

Dieses Beispiel soll nur die Kombinationsmöglichkeiten verdeutlichen, und hat mehr spielerischen Character.

=== Beispiel für eine Sprachdurchsage auf Basis eines Notify ===
<pre>
define wohnzimmer_Tastenfeld_1_Notify notify wohnzimmer_Tastenfeld_1 set Sonos_Wohnzimmer Speak \
45 de Hier dann die Textnachricht, wie sie auf dem Player ausgegeben werden soll.
define wohnzimmer_Tastenfeld_2_Notify notify wohnzimmer_Tastenfeld_2 set Sonos_Wohnzimmer Speak \
+10 de Hier dann die Textnachricht, wie sie auf dem Player ausgegeben werden soll.
define wohnzimmer_Tastenfeld_3_Notify notify wohnzimmer_Tastenfeld_3 set Sonos_Wohnzimmer Speak \
+0 en Hello, this is a short message.

define wohnzimmer_Tastenfeld_4_doif DOIF ([EnO_switch:?B0] and [?06:00-09:05]) \
({my $temp = "Außentemperatur: " . ReadingsVal("MeinWetter","temperature","unbekannt") . \
" °C. Höchsttemperatur: " . ReadingsVal("MeinWetter","fc1_high_c","unbekannt") . " °.";; \
fhem "set Sonos_Bad Speak 30 de $temp"})
</pre>

1: Hier wird auf Basis eines Notify (hier ein FS20-Taster) eine Textnachricht auf Deutsch mit der Lautstärke 45 auf dem SonosPlayer ausgegeben.<br />
2: Hier wird eine deutsche Textnachricht mit 10 Einheiten lauter als aktuell eingestellt ausgegeben.<br />
3: Hier wird eine englische Textnachricht mit der gleichen Lautstärke wie aktuell eingestellt ausgegeben.<br />
4: Hier wird, wenn der EnOcean-Taster rechts oben ("B0") zwischen 6:00 und 9:05 Uhr gedrückt wird, die aktuelle Außentemperatur und die Tageshöchsttemperatur (vom [[weather]]-Modul) in Lautstärke 30 ausgegeben (nicht mit [[notify]], sondern mit [[DOIF]] realisiert).

=== Beispiel für das Reagieren auf Tastenevents ===
Hier ein Beispiel, wie man die Tasten an einem Play5 (und natürlich auch an jedem anderen Player) zu einer einfachen, autarken Steuerung programmieren kann.

Grundlagen, die ich zur allgemeinen Vereinfachung in meiner <code>99_myUtils.pm</code> habe:
<pre>
# Wird benötigt, da ein reDefine nur einen Befehl aufrufen kann
sub pauseMuteOff($) {
my ($devName) = @_;

if (defined($main::defs{$devName})) {
fhem("set $devName Pause");
fhem("set $devName Mute Off");
}
}

# Löscht ein Define, wenn es existiert. Damit kann man dynamische AT-Defines löschen,
# ohne zu wissen, ob sie überhaupt existieren
sub deleteDefineIfExists($) {
my ($devName) = @_;

if (defined($main::defs{$devName})) {
fhem("delete $devName");
}
}

# Definiert ein define neu; Heisst, es wird, wenn es bereits existiert, gelöscht und neu angelegt
sub reDefine($$) {
my ($devName, $define) = @_;

deleteDefineIfExists($devName);
fhem('define '.$devName.' '.$define);
}
</pre>

Attribut am Sonosplayer-Device:
<pre>
attr Sonos_Schlafzimmer buttonEvents 1:MM
</pre>

Notify-Defines, die die Steuerung übernehmen:
<pre>
define Sonos_Schlafzimmer_WantPlaying_Notify notify Sonos_Schlafzimmer:ButtonEvent:.MM \
set Sonos_Schlafzimmer Play
define Sonos_Schlafzimmer_WantStopPlaying notify Sonos_Schlafzimmer:Mute.*1 \
{ reDefine('Schlafzimmer_Sonos_Stop_Timer', 'at +00:00:30 \
{ pauseMuteOff("Sonos_Schlafzimmer") }') }
define Sonos_Schlafzimmer_WantStopPlayingOff notify Sonos_Schlafzimmer:Mute.*0 \
{ deleteDefineIfExists('Schlafzimmer_Sonos_Stop_Timer') }
</pre>

Hier wird mittels des Attributs <code>buttonEvents</code> ein Event bei zweimaligen Drücken von <code>M</code>ute innerhalb von 1 Sekunde definiert.
Anschließend wird auf dieses Event reagiert, indem der Player mit der Wiedergabe beginnen soll.
Desweiteren wird auf das Ändern von Mute reagiert, indem beim Aktivieren von Mute (also einmal drücken) ein Timer gestartet wird, der nach 30 Sekunden die Wiedergabe anhält, und den Mute-Zustand wieder zurücksetzt. Das letzte notify existiert nur, damit man das Beenden der Wiedergabe innerhalb der 30 Sekunden noch verhindern kann.

Hier ist zu beachten, dass diese Events natürlich nicht unterscheiden können, ob das ganze am Player selbst oder über einen Controller geschaltet wurde. Von beiden Stellen aus kann diese Funktionalität verursacht werden.

=== Beispiel für einen Offline-Sprachsynthetisierer ===
Man kann mit den Attributen ''Speak1'', ''Speak2'', ''Speak3'' und ''Speak4'' am zentralen Sonos-Device Kommandozeilen definieren, die einen Text in eine Sounddatei umwandeln.
Hier soll dies am Beispiel von ''espeak'' verdeutlicht werden.
<pre>
wav:/usr/bin/espeak -v %language% -w %filename% "%text%"
</pre>
Zuerst muss das Ausgabedateiformat definiert werden, damit die internen Funktionen entsprechend reagieren können. Anschließend wird die Befehlszeile mit den entsprechenden Platzhaltern angegeben.
Hier muss beachtet werden, dass der Platzhalter ''%language%'' mit dem zweiten Parameter der FHEM-Befehlseingabe gefüllt wird. In diesem Beispiel muss man dort also ''german'' angeben (anstatt ''de'' bei Google), um eine deutsche Ausgabe zu erhalten.

Dieses Beispiel hat den kleinen Nachteil, dass die Ausgabe in einer WAV-Datei erfolgt, die keinerlei Tag-Informationen tragen kann. Um das zu ändern, kann man einen Konverter nachschalten:
<pre>
mp3:/usr/bin/espeak -v %language% --stdout "%text%" | /usr/bin/avconv -i - %filename%
</pre>
Damit wird die Ausgabe von ''espeak'' direkt in das MP3-Format umgewandelt, und intern mit den entsprechenden Tags versehen. Hier ist allerdings der Nachteil, dass es etwas länger dauert (auf meinem Raspberry Pi ca. 1-3 Sekunden).

Die in diesem Beispiel verwendeten Pakete können unter Debian mittels der Anweisungen
<pre>
sudo apt-get install espeak
sudo apt-get install ffmpeg
</pre>
installiert werden.

=== Beispiel zu InfoSummarize ===
Standard, wie er angelegt wird:
<pre>
InfoSummarize1 = <NormalAudio><Artist prefix="(" suffix=")"/>\
<Title prefix=" '" suffix="'" ifempty="[Keine Musikdatei]"/>\
<Album prefix=" vom Album '" suffix="'"/></NormalAudio> \
<StreamAudio><Sender suffix=":"/>\
<SenderCurrent prefix=" '" suffix="' -"/>\
<SenderInfo prefix=" "/></StreamAudio>
InfoSummarize2 = <TransportState/><InfoSummarize1 prefix=" => "/>
InfoSummarize3 = <Volume prefix="Lautstärke: "/>\
<Mute instead=" ~ Kein Ton" ifempty=" ~ Ton An" emptyval="0"/>\
~ Balance: <Balance ifempty="Mitte" emptyval="0"/>\
<HeadphoneConnected instead=" ~ Kopfhörer aktiv" ifempty=" ~ Kein Kopfhörer" \
emptyval="0"/>
</pre>

Dabei ist zu beachten, dass man auf andere InfoSummarize-Felder verweisen darf, solange man diese nur in aufsteigender Reihenfolge verwendet. Rekursionen oder Vorwärtrsreferenzen werden nicht unterstützt.

Hier noch ein Beispiel, um die Informationen des nächsten Titels zusammenzufassen:
<pre>
InfoSummarize4 = <NormalAudio>Nächster Titel: <nextArtist prefix="(" suffix=")"/>\
<nextTitle prefix=" '" suffix="'" ifempty="[Keine Musikdatei]"/>\
<nextAlbum prefix=" vom Album '" suffix="'"/></NormalAudio>\
<StreamAudio>Kein nächster Titel ermittelbar</StreamAudio>
</pre>

=== Beispiel für eine Cover-Anzeige des nächsten Titels ===
Mit diesem Beispiel wird gezeigt, wie man sich einen Weblink für die Anzeige des Covers des nächsten Titels erzeugen kann:
<pre>
define NextAlbumArt_Wohnzimmer weblink image fhem/icons/SONOSPLAYER/Sonos_Wohnzimmer_NextAlbumArt
attr NextAlbumArt_Wohnzimmer group Wohnzimmer
attr NextAlbumArt_Wohnzimmer htmlattr width="200"
attr NextAlbumArt_Wohnzimmer room Sonos
</pre>

=== Beispiel für das Übertragen eines Titels an einen anderen Player ===
Mein Sohn hat öfter den Wunsch, einen gerade im Wohnzimmer laufenden Titel auch in seine eigene Abspielliste zu bekommen. Der Weg am Sonos-Controller über eine gespeicherte Playliste ist dabei sehr umständlich.
Ich habe ein 8-fach Sensorfeld an der Wohnzimmerwand, wo ich ein Feld dafür programmiert habe, das Reading ''currentTrackURI'' mittels der Set-Anweisung ''AddURIToQueue'' in die aktuelle Abspielliste meines Sohnes zu packen.
Das ist natürlich nichts besonderes, aber vielleicht für den einen oder anderen auch eine nette Idee:
<pre>
define wohnzimmer_Sensorfeld_Notify notify wohnzimmer_Sensorfeld { \
fhem "set Sonos_Sohnemann AddURIToQueue ".\
ReadingsVal("Sonos_Wohnzimmer", "currentTrackURI", "") \
}
</pre>

=== Beispiel für eine eigene ReadingsGroup zur Darstellung der Cover- und Titelinformationen ===
Wenn man das Standarddesign der generierten [[readingsGroup]] überarbeiten möchte, muss man sich einfach eine eigene Prozedur in der '''99_myUtils.pm''' anlegen, die dann in der [[readingsGroup]] verwendet werden kann.

Da die Original-Vorlage wegen des Vollbildmodus sehr umfangreich ist, gibt es hier nur eine abgespeckte Version, die nur die Anzeige selbst übernimmt. Wer gerne den Vollbildmodus anpassen möchte, kann sich die entsprechende Prozedur '''SONOS_getCoverTitleRG''' einfach aus dem Modulcode kopieren (umbenennen nicht vergessen).

Hier die Vorlage der drei Prozeduren:
<pre>
sub getCoverTitleRG($;$$) {
my ($device, $width, $space) = @_;
$width = 500 if (!defined($width));

return '<div style="float: left;">'.getCoverRG($device).\
'</div><div style="margin-left: 150px; min-width: '.$width.\
'px;>'.getTitleRG($device, $space).'</div>';
}

sub getCoverRG($;$) {
my ($device) = @_;

return '<img style="margin-right: 5px; border: 1px solid lightgray; \
height: 175px" src="'.ReadingsVal($device, 'currentAlbumArtURL', '').'" />';
}

sub SONOS_getTitleRG($;$) {
my ($device, $space) = @_;
$space = 20 if (!defined($space));

my $infoString = '';

my $transportState = ReadingsVal($device, 'transportState', '');
$transportState = 'Spiele' if ($transportState eq 'PLAYING');
$transportState = 'Pausiere' if ($transportState eq 'PAUSED_PLAYBACK');
$transportState = 'Stop bei' if ($transportState eq 'STOPPED');

# Läuft Radio oder ein "normaler" Titel
if (ReadingsVal($device, 'currentNormalAudio', 1) == 1) {
$infoString = sprintf('<div style="margin-left: -150px;">%s Titel %s \
von %s<br />Titel: <b>%s</b><br />Interpret: <b>%s</b><br />Album: \
<b>%s</b><div style="height: %dpx;"></div>'.encode('UTF-8', \
'Nächste Wiedergabe:').'</div><div style="float: left; margin-left: \
0px;"><img style="margin: 0px; padding: 0px; margin-right: 5px; \
border: 1px solid lightgray;" height="55" border="0" src="%s" />\
</div><div style="margin-left: 0px;">Titel: %s<br />Artist: %s<br />\
Album: %s</div>',
$transportState,
ReadingsVal($device, 'currentTrack', ''),
ReadingsVal($device, 'numberOfTracks', ''),
ReadingsVal($device, 'currentTitle', ''),
ReadingsVal($device, 'currentArtist', ''),
ReadingsVal($device, 'currentAlbum', ''),
$space,
ReadingsVal($device, 'nextAlbumArtURL', ''),
ReadingsVal($device, 'nextTitle', ''),
ReadingsVal($device, 'nextArtist', ''),
ReadingsVal($device, 'nextAlbum', ''));
} else {
$infoString = sprintf('<div style="margin-left: -150px;">%s Radiostream\
<br />Sender: <b>%s</b><br />Info: <b>%s</b><br />'.encode('UTF-8', \
'Läuft:').' <b>%s</b></div>',
$transportState,
ReadingsVal($device, 'currentSender', ''),
ReadingsVal($device, 'currentSenderInfo', ''),
ReadingsVal($device, 'currentSenderCurrent', ''));
}

return $infoString;
}
</pre>
Diese kann man als Kopiervorlage für eigene Ideen verwenden. Die Backslashs vor den Zeilenumbrüchen sind hauptsächlich der Optik halber hier. Generell empfehle ich die so getrennten Befehle in eine Zeile zu schreiben...

Hier noch eine beispielhafte [[readingsGroup]] dazu:
<pre>
define Sonos_WohnzimmerRG readingsGroup Sonos_Wohnzimmer:\
<{getCoverTitleRG($DEVICE)}@infoSummarize1>
</pre>

=== Beispiel für eine ReadingsGroup für die Darstellung von Listen (Favoriten, Playlisten und Radios) ===
Es gibt eine mitgelieferte Prozedur, die für diese Darstellung verwendet werden kann. Diese stellt die Listen einfach als zweispaltige Tabelle dar (links das Cover, rechts der Titel als ausführbarer Link).
Für die Datenlieferung (z.B. die Favoriten in einem Reading) muss man sich noch ein entsprechendes userReading schaffen.
Beim Generieren der Devices vom Autocreate-Mechanismus werden diese Elemente und Attribute bereits mit erzeugt. Es muss lediglich ein Automatismus zum Aktualisieren des entsprechenden Readings geschaffen werden, oder dieses einmal manuell ausgeführt werden.

Hier die Vorlage für das userReadings:
<pre>
attr Sonos_Wohnzimmer userReadings Favourites:LastActionResult.*?\
GetFavouritesWithCovers.* { if (ReadingsVal($name, \
"LastActionResult", "") =~ m/.*?: (.*)/) { return $1; } }, Radios:\
LastActionResult.*?GetRadiosWithCovers.* { if (ReadingsVal($name, \
"LastActionResult", "") =~ m/.*?: (.*)/) { return $1; } }, Playlists:\
LastActionResult.*?GetPlaylistsWithCovers.* { if (ReadingsVal($name, \
"LastActionResult", "") =~ m/.*?: (.*)/) { return $1; } }
</pre>
Damit wird jeweils ein Reading für Favoriten, Playlisten und Radios angelegt, sobald im Reading '''LastActionResult''' dieses Ergebnis asynchron geliefert wurde.

Die Lieferung selbst kann man mit einem '''at'''-Statement zu bestimmten Zeitpunkten erzeugen/aktualisieren lassen:
<pre>
define refreshFavouritesWohnzimmer at *06:00 get Sonos_Wohnzimmer FavouritesWithCovers
</pre>

Das ganze muss natürlich für jede gewünschte Liste an jedem Player aktualisiert werden. Man kann also auch sowas schreiben:
<pre>
define refreshFavouritesSonos at *06:00 get Sonos_.*.Favourites FavouritesWithCovers
define refreshPlaylistsSonos at *06:01 get Sonos_.*.Playlists PlaylistsWithCovers
define refreshRadiosSonos at *06:02 get Sonos_.*.Radios RadiosWithCovers
</pre>

Möchte man eine andere Darstellung, so muss man sich eine eigene Prozedur in eine '''99_myUtils.pm''' packen. Hier eine Kopiervorlage:
<pre>
sub getListRG($$;$) {
my ($device, $reading, $ul) = @_;
$ul = 0 if (!defined($ul));

my $resultString = '';

# Manchmal ist es etwas komplizierter mit den Zeichensätzen...
my %elems = %{eval(decode('CP1252', ReadingsVal($device, $reading, '{}')))};

for my $key (keys %elems) {
my $command;
if ($reading eq 'Favourites') {
$command = 'cmd.'.$device.uri_escape('=set '.$device.' \
StartFavourite '.uri_escape($elems{$key}->{Title}));
} elsif ($reading eq 'Playlists') {
$command = 'cmd.'.$device.uri_escape('=set '.$device.' \
StartPlaylist '.uri_escape($elems{$key}->{Title}));
} elsif ($reading eq 'Radios') {
$command = 'cmd.'.$device.uri_escape('=set '.$device.' \
StartRadio '.uri_escape($elems{$key}->{Title}));
}
$command = "FW_cmd('/fhem?XHR=1&$command')";

if ($ul) {
$resultString .= '<li style="list-style-type: none; display: inline;">\
<a onclick="'.$command.'"><img style="border: solid 1px lightgray; \
margin: 3px;" width="70" src="'.$elems{$key}->{Cover}.'" /></a></li>';
} else {
$resultString .= '<tr><td><img width="70" src="'.$elems{$key}->{Cover}.\
'" /></td><td><a onclick="'.$command.'">'.$elems{$key}->{Title}."</a>\
</td></tr>\n";
}
}

if ($ul) {
return '<ul style="margin-left: 0px; padding-left: 0px; list-style-type: none; \
display: inline;">'.$resultString.'</ul>';
} else {
return '<table>'.$resultString.'</table>';
}
}
</pre>
Diese Prozedur hat einen optionalen Parameter ($ul). Mit diesem kann man angeben, ob eine Tabelle mit vertikaler Darstellung ($ul=0) oder eine Unordered-List mit horizontaler Darstellung ($ul=1) erzeugt wird.
Die Variante mit den ListItems ist auch für eine Darstellung in einem Dashboard geeignet.
Da bei der horizontalen Darstellung kein Platz für Namen ist, eignet sich diese Darstellung nur für Listen, deren Icon für jeden Eintrag unterschiedlich ist (Playlisten kann man hier also nicht mehr unterscheiden :-).

Die eigentliche [[readingsGroup]] verwendet dann diese Prozedur:
<pre>
define Sonos_WohnzimmerFavouriteListRG readingsGroup Sonos_Wohnzimmer:\
<{getListRG($DEVICE,"Favourites")}@Favourites>
</pre>

oder für die Variante mit den List-Elementen:
<pre>
define Sonos_WohnzimmerFavouriteListRG readingsGroup Sonos_Wohnzimmer:\
<{getListRG($DEVICE,"Favourites",1)}@Favourites>
</pre>

Damit kann man sich dynamische Listen auf Basis der Informationen im Sonosplayer für die Darstellung erzeugen lassen.

Die Backslashs vor den Zeilenumbrüchen sind hauptsächlich der Optik halber hier. Generell empfehle ich die so getrennten Befehle in eine Zeile zu schreiben...

=== Beispiel für die Anzeige der Gruppenkonstellation in einer ReadingsGroup ===
[[Datei:ReadingsGroupSonosGruppierung.png|right|75px|Beispiel der Visualisierung der Gruppenkonstellation im Style "dark"]]
Mit der folgende Prozedur (in die '''99_myUtils.pm''' schreiben) und der [[readingsGroup]] läßt sich auf einfache Weise die Gruppenkonstellation stets aktuell darstellen.

Die Prozedur, die die Zerlegung des Strings und in diesem Fall die Aufbereitung als UL (Unordered-List) übernimmt:
<pre>
sub getGroupsRG() {
my $groups = CommandGet(undef, SONOS_getSonosPlayerByName(undef)->{NAME}.\
' Groups');

my $result = '';
my $i = 0;
while ($groups =~ m/\[(.*?)\]/ig) {
my @member = split(/, /, $1);
@member = map { my $elem = $_; $elem = FW_makeImage('icoSONOSPLAYER_icon-'.\
ReadingsVal($elem, 'playerType', '').'.png', '', '').ReadingsVal($elem,\
'roomNameAlias', $elem); $elem; } @member;

$result .= '<li>'.++$i.'. Gruppe:<ul style="list-style-type: none; \
padding-left: 0px;"><li>'.join('</li><li>', @member).'</li></ul></li>';
}
return '<ul>'.$result.'</ul>';
}
</pre>

Und hier die entsprechende ReadingsGroup dazu:
<pre>
define SonosRG readingsGroup Sonos:<{getGroupsRG()}@ZoneGroupState>
</pre>

Damit wird eine einfache Darstellung der Gruppenkonstellation durchgeführt, die man sich natürlich selber nach Belieben anpassen kann/soll.

Die Backslashs vor den Zeilenumbrüchen sind hauptsächlich der Optik halber hier. Generell empfehle ich die so getrennten Befehle in eine Zeile zu schreiben...

=== Beispiel für eine ReadingsGroup, die die Informationen des Masters anzeigt ===
Wenn Player in einer Gruppe sind, werden keine Titelinformationen des eigentlichten Streams angezeigt. Man kann sich jetzt zu jedem Player eine [[readingsGroup]] bauen, die die Informationen des Gruppenmasters anzeigen.

<pre>
define Sonos_WohnzimmerRG2 readingsGroup Sonos_Wohnzimmer:infoSummarize2@{\
SONOSPLAYER_GetMasterPlayerName($DEVICE)}
attr Sonos_WohnzimmerRG2 valueFormat {" "}
attr Sonos_WohnzimmerRG2 valuePrefix {SONOS_getCoverTitleRG(\
SONOSPLAYER_GetMasterPlayerName($DEVICE))}
attr Sonos_WohnzimmerRG2 noheading 1
attr Sonos_WohnzimmerRG2 nonames 1
attr Sonos_WohnzimmerRG2 notime 1
</pre>

''Hinweis'': Diese ReadingsGroup wird automatisch per longpoll aktualisiert. Lediglich bei einer Umgruppierung muss bislang die Seite neu geladen werden. Es kann aber gut sein, dass man das in Zukunft auch per longpoll hinbekommen kann.

=== Beispiel für ein Shell-Skript zum Aufräumen eines Speak-Verzeichnisses ===
Mit der freundlichen Freigabe von Loredo und CQuadrat hier ein kleines Shell-Skript, mit dem länger nicht abgespielte Dateien gelöscht werden können.
Bei allen Varianten muss berücksichtigt werden, dass der ausführende Benutzer die Dateien auch löschen darf. Bitte die Dateirechte prüfen.

==== Variante mit Ausgabe der gelöschten Dateien ====
<pre>
#!/bin/bash

FILES=`ls /mnt/SonosSpeak/RINCON*.mp3*`
CURRENTTIME=`date +"%s"`
PASTDAYS=75

THESHOLDATIME=`expr $CURRENTTIME - $PASTDAYS \* 24 \* 60 \* 60`

echo -e "Cleaning up all files older than $PASTDAYS days ...\n\n"

for f in $FILES
do

FILEATIME=`stat -c "%X" $f`

if [[ "$FILEATIME" < "$THESHOLDATIME" ]]; then
echo "cleaned up $f: last access on `stat -c "%x" $f`"
rm $f
fi

done
</pre>
Unter Umständen gibt es eine aktuellere Version unter [https://gist.github.com/jpawlowski/689d1cf74334488cd127 cleanupSonosSpeak.sh auf GitHub].

==== Variante für die crontab ====
<pre>
0 4 * * * find /mnt/SonosSpeak -name "RINCON*" ! -atime -75 -delete
</pre>
Hier wird jeden Tag um 4:00 Uhr der Ordner mit den Sprachausgabedateien bereinigt.

=== Betrieb des Sonos an einer Funksteckdose (regelmäßiges Ausschalten) - Verbindungsprobleme ===

Wenn das Sonossystem per Funksteckdose regelmäßig vom Netz genommen wird, bereitet der Neustart und das anschließende
Verbinden mit FHEM oft Probleme. Das Sonosmodul bleibt auf dem Status "disappeared" stehen und das Playerdevice ebenfalls.
Ergo ist eine Bedienung per FHEM oder die Sprachausgabe nicht mehr möglich.

Um diesem Problem Abhilfe zu schaffen reicht ein kleines notify oder DOIF, welches den Player beim Abschalten
das Attribut disable = 1 verschafft und beim Wiedereinschalten dieses Attribut löscht.

<pre>
define RebootSonosDOIF DOIF ([FunksteckerSonos:state] eq "on" )(deleteattr MeinSonosDevice disable) (save)
DOELSEIF ([FunksteckerSonos:state] eq "off" )(attr MeinSonosDevice disable 1)(save)
</pre>

Das Setzen von "disable" sorgt dafür, dass der Sonosthread beendet wird und beim Einschalten ein neuer Prozess erstellt wird.
Diese automatische Änderung an der Konfiguration des Device benötigt ein save config im Nachgang der DOIF- oder notify-Aktion.
Daher wird der jeweilige attr-Befehl mit einem (save) abgeschlossen.

Wichtig hierbei (wie auch in der Überschrift erwähnt) funktioniert das nur, wenn die einzelnen Sonosplayer an einer schaltbaren Steckdose betrieben werden.

Das DOIF triggert nur bei Änderung des "state" der jeweilige Funksteckdose.

=== Beispiele für FTUI-Integrationen ===
Hier können diverse Beispiele für eine FTUI (FHEM Tablet User Interface) Integration aufgeführt werden. Dabei sollten die Beispiele ''vollständig'' sein, und auch alle notwendigen Dummies und/oder Userreadings beschreiben.

==== Beispiel von Reinerlein ====
[[Datei:ReinersSonosFTUIIntegration.jpg|mini|Beispiel der SONOS-FTUI-Integration von Reinerlein]]
[[Datei:ReinersSonosFTUIIntegrationHeadline.jpg|mini|Kopfzeile bei Gruppenwiedergabe]]
Hier gebe ich mal mein Beispiel zum Besten. Es ist eine 3 Spalten x 5 Zeilen Integration mit der Möglichkeit einer Favoriten-, Playlisten- und Radioauswahl, sowie einer Titelauswahl und Gruppierungsanpassung.

Die Formatierung der Listen erfolgt mit einem '''|''' als Trenner der Elemente, da dieses Zeichen hier nie im Titel vorkommt.

Die Maskierung der Leerzeichen für die Schlüsselliste erfolgt auf den Punkt. Damit besteht die Möglichkeit, den Wert direkt als regulären Ausdruck an den entsprechenden Start-Befehl zu übermitteln. Es müssen nur noch die Schrägstriche '''/''' vorne und hinten angefügt werden.

Beim Antippen des Covers wird ein Vollbild-Popup geöffnet, welches das Cover in groß, den Abspielzustand und die Abspielposition darstellt.

Im Header jedes Players wird angezeigt, ob gerade irgendwelche Slaveplayer mitbedient werden, bzw. wer der aktuelle Masterplayer zu dieser Wiedergabe ist. Des Weiteren kann dort direkt ein Player zu der Wiedergabegruppe hinzugefügt oder aus ihr entfernt werden.

Im Header kann jetzt bei einer Gruppenwiedergabe auch der GroupMute-Zustand gesetzt werden.

Über dem Cover wird nun die aktuelle Quelle des Titels angezeigt (Playlist, Album o.ä.)

===== FTUI-Code =====
Der Code ist in zwei Bereiche aufgeteilt, damit die Templatemöglichkeiten für mehrere Player verwendet werden können.

Zunächst die Einbindung des Templates. Hier wird auch der Rahmen festgelegt. In diesem Fall der Gridster-Kasten mit 3x5 Feldgröße:
<pre>
<li data-row="1" data-col="1" data-sizex="3" data-sizey="5" class="border-down-gray lesstransparent">
<div data-template="template_musik_sonos.html" data-parameter='{"Device":"Sonos_Wohnzimmer"}'></div>
</li>
</pre>
Dadurch, dass der Rahmen nicht mit im Template enthalten ist, könnte man z.B. auch mehrere Player nebeneinander in einem Rahmen darstellen, dabei aber nicht den umschließenden DIV-Tag um das Template vergessen, da sonst die Titelanzeigen ''rauswandern'' könnten.
''Hinweis:'' In der vorherigen Version gab es noch einen Parameter für den Raumnamen, und der Header wurde hier bei der Einbindung festgelegt. Das entfällt nun, da der Raumname per Reading ermittelt wird, und im Header nun Gruppierungsinformationen enthalten sind.

Für die Coverdarstellung ist ein neues Widget notwendig (welches momentan noch nicht offiziell ist), da in der neuen Sonosversion größere Radiocover geladen werden, und diese nicht unbedingt quadratisch orientiert sind.

Das Widget kann im Forum heruntergeladen werden: [https://forum.fhem.de/index.php/topic,70265.0.html https://forum.fhem.de/index.php/topic,70265.0.html].

Für die Lauftext-Animation sind eigene CSS-Klassen, eine Javascript-Funktion und (momentan noch) eine Anpassung des JoinedLabel-Widgets notwendig.

Hier die notwendigen Styles und Javascript. Ich habe diese einfach in den Kopfbereich meiner index.html gepackt:
<pre>

<style>
.flowanimation {
position: relative;
white-space: nowrap;
display: inline-block;
animation: floatText 8s infinite alternate ease-in-out;
}

@keyframes floatText {
from {
left: 0px;
}

to {
left: calc(355px - 100%);
}
}

.mycenteredtext {
position: relative;
white-space: nowrap;
display: inline-block;
left: calc(355px / 2 - 50%);
}
</style>

<script type="text/javascript">
function checkFlowAnimation(elemName) {
if ($(elemName).innerWidth() >= 355) {
$(elemName).addClass('flowanimation');
} else {
$(elemName).addClass('mycenteredtext');
}
}
</script>

</pre>

Die Anpassungen in der Datei "widget_joinedlabel.js" beschränken sich auf zwei Zeilen:
*In der Funktion "init_attr()" als letztes Statement vor der abschließenden Log-Ausgabe: <pre>elem.initData('onupdate', '');</pre>
*In der Funktion "update" als letztes Statement nach der "me.update_colorize()"-Anweisung: <pre>eval(elem.data('onupdate'));</pre>

Hier nun der Inhalt der Datei '''template_musik_sonos.html''':
<pre>
<header>
<div data-type="classchanger" data-device="Device" data-get="SlavePlayerNotBonded" data-get-on='["[]"]' data-on-class="hide" data-off-class="mini" class="inline">
<div data-type="switch" data-device="Device" data-get="GroupMute" data-set="GroupMute"
data-icon="fa-deaf" data-background-icon="-"
data-on-color="#aa6900" data-off-color="gray"
data-get-on="1" data-get-off="0"
data-set-on="1" data-set-off="0" class="mini" style="margin-right: -5px;">
</div>
</div>

<div data-type="joinedlabel" data-device="Device" data-mask="[$1][ ($2)]" data-get='["roomName","ZoneGroupNameDetails"]' class="truncate inline"></div>

<div data-type="classchanger" data-device="Device" data-get="MasterPlayer" data-get-on="Device" data-on-class="hide" class="inline left-narrow">
<div data-type="push"
data-device="Device"
data-icon="fa-minus-circle"
data-background-icon="-"
data-set-on="MakeStandaloneGroup"
class="inline mini gray">
</div>
</div>

<div data-type="classchanger" data-device="Device" data-get="MasterPlayer" data-get-on="Device" data-off-class="hide" class="inline left-narrow">
<div data-type="popup" class="" data-width="400px" data-height="110px">
<div data-type="symbol"
data-icon="fa-chevron-circle-down"
class="mini"
style="height: 10px;">
</div>

<div class="dialog">
<header><div data-type="joinedlabel" data-device="Device" data-mask="Wiedergabegruppe[ für $1] anpassen" data-get='["roomName"]' class="inline"></div></header>

<div class="top-space-10 left-align left-space">
<div>
<div class="large middle inline">Player hinzufügen: </div>
<div data-type="select"
data-device="Device"
data-list="AvailablePlayerList"
data-alias="AvailablePlayerListAlias"
data-delimiter="|"
data-get="-"
data-set="AddMember"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>

<div>
<div class="large middle inline">Player entfernen: </div>
<div data-type="select"
data-device="Device"
data-list="SlavePlayerNotBondedList"
data-alias="SlavePlayerNotBondedListAlias"
data-delimiter="|"
data-get="-"
data-set="RemoveMember"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>
</div>
</div>
</div>
</div>
</header

<div class="">
<div data-type="joinedlabel" data-device="Device" data-mask=" [~ $1 ~] " data-get='["currentSource"]' class="bottom-narrow mini white" style="padding-top: 3px; background: rgba(170, 105, 0, 0.6);"></div>

<div data-type="popup" data-width="100%" data-height="100%">
<div style="margin-bottom: -40px;">
<div data-type="imagecover"
data-device="Device"
data-get="currentAlbumArtURL"
data-opacity="1.0"
data-width="350px"
data-height="350px"
class=""
onclick="$('.dialog-close').trigger('click');"
style="margin-left: 12px; margin-top: 12px; border: 1px solid rgba(170, 105, 0, 0.6);">
</div>

<div data-type="classchanger" data-device="Device" data-get="currentTrackProviderIconRoundURL" data-get-on="" data-on-class="hide">
<div class="inline" style="width: 40px; height: 40px; background: rgba(0, 0, 0, 0.40); position: relative; top: -349px; left: -152px;">
<div data-type="imagecover"
data-device="Device"
data-get="currentTrackProviderIconRoundURL"
data-opacity="1.0"
data-width="30px"
data-height="30px"
class=""
style="margin-left: 5px; margin-top: 5px;">
</div>
</div>
</div>
<div data-type="classchanger" data-device="Device" data-get="currentTrackProviderIconRoundURL" data-get-on="" data-off-class="hide">
<div class="inline" style="width: 40px; height: 40px; position: relative; top: -349px; left: -152px;">
</div>
</div>
</div>

<div class="dialog">
<header><div data-type="joinedlabel" data-device="Device" data-mask="Cover[ für $1]" data-get='["roomName"]' class="inline"></div></header>

<div data-type="imagecover"
data-device="Device"
data-get="currentTrackProviderIconRoundURL"
data-opacity="1.0"
data-width="30px"
data-height="30px"
class=""
style="position: absolute; top: 25px; left: 5px;"
style="margin-left: 5px; margin-top: 5px;">
</div>

<div data-type="switch"
data-device="Device"
data-get="transportState"
data-states='["PLAYING","PAUSED_PLAYBACK","STOPPED"]'
data-background-icon="-"
data-background-colors='["white","white","white"]'
data-colors='["white","white","white"]'
data-icons='["fa-play","fa-pause","fa-pause"]'
class="inline readonly"
style="position: absolute; top: 10px; right: -10px;"
onclick="$('.dialog-close').trigger('click');">
</div>

<div data-type="imagecover"
data-device="Device"
data-get="currentAlbumArtURL"
data-opacity="1.0"
data-width="100%"
data-height="calc(100vh - 60px)"
class=""
onclick="$('.dialog-close').trigger('click');"
style="">
</div>

<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide">
<div data-type="slider"
data-device="Device"
data-get="currentTrackPositionSimulatedSec"
data-max="currentTrackDurationSec" data-min="0"
data-step="1"
data-handle-diameter="5"
data-width="68%"
class="horizontal top-narrow readonly centered"></div>
</div>

<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide">
<div data-type="joinedlabel" data-device="Device" data-mask="[$1][ ~ $2][ ~ $3]" data-get='["currentTitle","currentArtist","currentAlbum"]' class="truncate top-space"></div>
</div>
<div data-type="classchanger" data-device="Device" data-get="currentStreamAudio" data-get-on="1" data-off-class="hide">
<div data-type="joinedlabel" data-device="Device" data-mask="[$1 ~ ][$2][: $3]" data-get='["currentSenderInfo","currentSender","currentSenderCurrent"]' class="truncate top-space"></div>
</div>
</div>
</div>

<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide">
<div data-type="label" data-device="Device" data-get="currentTrackPositionSimulated" class="inline" style="width: 3em;"></div>
<div data-type="slider"
data-device="Device"
data-set="CurrentTrackPosition"
data-get="currentTrackPositionSimulatedSec"
data-max="currentTrackDurationSec" data-min="0"
data-step="1"
data-handle-diameter="5"
data-width="250"
class="horizontal tap inline">
</div>
<div data-type="label" data-device="Device" data-get="currentTrackDuration" class="inline" style="width: 3em;"></div>

<div class="newline">
<div data-type="label" data-device="Device" data-get="currentTrack" class="inline center-align" style="width: 3em;"></div>
<div data-type="slider"
data-device="Device"
data-set="Track"
data-get="currentTrack"
data-max="numberOfTracks" data-min="0"
data-step="1"
data-handle-diameter="5"
data-width="250"
class="horizontal tap inline">
</div>
<div data-type="label" data-device="Device" data-get="numberOfTracks" class="inline center-align" style="width: 3em;"></div>
</div>
</div>

<div data-type="classchanger" data-device="Device" data-get="currentStreamAudio" data-get-on="1" data-off-class="hide">
<div style="height: 40px;"> </div> 
</div>

<div class="large top-space">
<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide">
<div style="height: 21px;">
<div style="width: 355px; position: absolute; overflow: hidden; height: 21px; margin-left: 10px; margin-right: 10px;">
<div style="position: absolute;">
<div id="Device_Title" data-type="joinedlabel" data-device="Device" data-mask="[$1]" data-get='["currentTitle"]' data-onupdate="checkFlowAnimation('#Device_Title');" class="bold"></div>
</div>
</div>
</div>

<div style="height: 21px;">
<div style="width: 355px; position: absolute; overflow: hidden; height: 21px; margin-left: 10px; margin-right: 10px;">
<div style="position: absolute;">
<div id="Device_Interpret" data-type="joinedlabel" data-device="Device" data-mask="[$1][ ~ $2]" data-get='["currentArtist","currentAlbum"]' data-onupdate="checkFlowAnimation('#Device_Interpret');" class="">
</div>
</div>
</div>
</div>
</div>
<div data-type="classchanger" data-device="Device" data-get="currentStreamAudio" data-get-on="1" data-off-class="hide">
<div style="height: 21px;">
<div style="width: 355px; position: absolute; overflow: hidden; height: 21px; margin-left: 10px; margin-right: 10px;">
<div style="position: absolute;">
<div id="Device_SenderInfo" data-type="joinedlabel" data-device="Device" data-mask="[$1]" data-get='["currentSenderInfo"]' data-onupdate="checkFlowAnimation('#Device_SenderInfo');" class="bold"></div>
</div>
</div>
</div>

<div style="height: 21px;">
<div style="width: 355px; position: absolute; overflow: hidden; height: 21px; margin-left: 10px; margin-right: 10px;">
<div style="position: absolute;">
<div id="Device_Sender" data-type="joinedlabel" data-device="Device" data-mask="[$1][: $2]" data-get='["currentSender","currentSenderCurrent"]' data-onupdate="checkFlowAnimation('#Device_Sender');"class=""></div>
</div>
</div>
</div>
</div>
</div>

<div class="top-space">
<div data-type="switch" data-device="Device" data-get="Mute" data-set="Mute"
data-icon="fa-deaf" data-background-icon="-"
data-on-color="#aa6900" data-off-color="gray"
data-get-on="1" data-get-off="0"
data-set-on="1" data-set-off="0" class="inline mini">
</div>

<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide" class="inline top-space">
<div data-type="switch" data-device="Device" data-get="Repeat" data-set="Repeat"
data-icon="fa-repeat" data-background-icon="-"
data-on-color="#aa6900" data-off-color="gray"
data-get-on="1" data-get-off="0"
data-set-on="1" data-set-off="0" class="inline mini">
</div>

<div data-type="push" data-device="Device"
data-icon="fa-step-backward" data-background-icon="-"
data-off-color="#fff" data-on-color="#aa6900"
data-set-on="Previous" class="inline mini">
</div>

<div data-type="push" data-device="Device"
data-set="CurrentTrackPosition"
data-icon="fa-backward" data-background-icon="-"
data-off-color="#fff" data-on-color="#aa6900"
data-set-on="-30" class="inline mini">
</div>
</div>

<div data-type="switch"
data-device="Device"
data-get="transportState"
data-states='["PLAYING","PAUSED_PLAYBACK","STOPPED"]'
data-set-states='["Pause","Play","Play"]'
data-background-icon="fa-circle-thin"
data-background-colors='["#aa6900","white","white"]'
data-colors='["#aa6900","white","white"]'
data-icons='["fa-pause","fa-play","fa-play"]'
class="inline small">
</div>

<div data-type="classchanger" data-device="Device" data-get="currentNormalAudio" data-get-on="1" data-off-class="hide" class="inline">
<div data-type="push" data-device="Device"
data-set="CurrentTrackPosition"
data-icon="fa-forward" data-background-icon="-"
data-off-color="#fff" data-on-color="#aa6900"
data-set-on="+30" class="inline mini">
</div>

<div data-type="push" data-device="Device"
data-icon="fa-step-forward" data-background-icon="-"
data-off-color="#fff" data-on-color="#aa6900"
data-set-on="Next" class="inline mini">
</div>

<div data-type="switch" data-device="Device" data-get="Shuffle" data-set="Shuffle"
data-icon="fa-random" data-background-icon="-"
data-on-color="#aa6900" data-off-color="gray"
data-get-on="1" data-get-off="0"
data-set-on="1" data-set-off="0" class="inline mini">
</div>
</div>

<div data-type="popup" class="inline" data-width="650px" data-height="210px">
<div data-type="push"
data-icon="fa-list" data-background-icon="-"
data-off-color="#fff" data-on-color="#aa6900"
class="mini">
</div>

<div class="dialog">
<header><div data-type="joinedlabel" data-device="Device" data-mask="Musikauswahl[ für $1]" data-get='["roomName"]' class="inline"></div></header>

<div class="top-space-10 left-align left-space">
<div>
<div class="large middle inline">Favoriten: </div>
<div data-type="select"
data-device="Device"
data-list="FavouritesList"
data-alias="FavouritesListAlias"
data-delimiter="|"
data-quote="/"
data-get="currentFavouriteNameMasked"
data-set="StartFavourite"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>

<div>
<div class="large middle inline">Playlists: </div>
<div data-type="select"
data-device="Device"
data-list="PlaylistsList"
data-alias="PlaylistsListAlias"
data-delimiter="|"
data-quote="/"
data-get="currentPlaylistNameMasked"
data-set="StartPlaylist"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>

<div>
<div class="large middle inline">Radios: </div>
<div data-type="select"
data-device="Device"
data-list="RadiosList"
data-alias="RadiosListAlias"
data-delimiter="|"
data-quote="/"
data-get="currentRadioNameMasked"
data-set="StartRadio"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>

<div>
<div class="large middle inline">Audio-Eingang: </div>
<div data-type="select"
data-device="Device"
data-list="Sonos:LineInPlayerList"
data-alias="Sonos:LineInPlayerListAlias"
data-delimiter="|"
data-get="currentAlbum"
data-set="PlayURI"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>

<div>
<div class="large middle inline">Abspielliste: </div>
<div data-type="select"
data-device="Device"
data-list="QueueList"
data-alias="QueueListAlias"
data-delimiter="|"
data-get="currentTrack"
data-set="Track"
class="inline w3x"
onchange="$('.dialog-close').trigger('click');"></div>
</div>
</div>
</div>
</div>
</div>

<div data-type="spinner"
data-device="Device"
data-get="Volume"
data-set="Volume"
data-max="50"
data-step="1"
data-width="350"
data-icon-left="fa-volume-down tall"
data-icon-right="fa-volume-up tall"
data-gradient-color='["orange","red"]'
class="tap value positiononly top-space centered">
</div>
</div>
</pre>

===== Notwendige Userreadings =====

''Vorherige Version der Listenermittlung per Userreading''
<div class="mw-collapsible mw-collapsed">
Für die Funktionalität der Favoriten- / Playlisten- / Radioauswahl werden u.U. Userreadings benötigt, die die entsprechenden Listen ermitteln, und für die Verwendung im FTUI aufbereiten.
Außerdem gibt es ein Userreading für die Anzeige der Position innerhalb des Titels. Dieses kann man selber mittels eines wiederkehrenden AT- oder DOIF-Befehls aktualisieren lassen (ich verwende dafür eine 15 Sekündige Aktualisierung mittels DOIF, solange eine Wiedergabe läuft).

Userreading an jedem Sonosplayer-Device:
<pre>
Favourites:LastActionResult.*?GetFavouritesWithCovers.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
return $1;
}
},

Radios:LastActionResult.*?GetRadiosWithCovers.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
return $1;
}
},

Playlists:LastActionResult.*?GetPlaylistsWithCovers.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
return $1;
}
},

currentTrackPosition:LastActionResult.*?GetCurrentTrackPosition.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
return $1;
}
},

currentTrackPositionSec:currentTrackPosition.* {
return SONOS_GetTimeSeconds(ReadingsVal($name, "currentTrackPosition", "00:00:00"));
},

currentTrackDurationSec:currentTrackDuration.* {
return SONOS_GetTimeSeconds(ReadingsVal($name, "currentTrackDuration", "00:00:00"));
},

FavouritesList:LastActionResult.*?GetFavourites:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { $_ =~ s/ /./g; $_ } map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

FavouritesListAlias:LastActionResult.*?GetFavourites:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

currentFavouriteNameMasked:currentFavouriteName.* {
my $favouriteName = ReadingsVal($name, "currentFavouriteName", "");
$favouriteName =~ s/ /\./g;
return $favouriteName;
},

PlaylistsList:LastActionResult.*?GetPlaylists:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { $_ =~ s/ /./g; $_ } map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

PlaylistsListAlias:LastActionResult.*?GetPlaylists:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

currentPlaylistNameMasked:currentPlaylistName.* {
my $name = ReadingsVal($name, "currentPlaylistName", "");
$name =~ s/ /\./g;
return $name;
},

RadiosList:LastActionResult.*?GetRadios:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { $_ =~ s/ /./g; $_ } map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

RadiosListAlias:LastActionResult.*?GetRadios:.* {
if (ReadingsVal($name, "LastActionResult", "") =~ m/.*?: (.*)/) {
my @list = map { substr($_, 1, -1) } split(',', $1);
return join('|', @list);
}
},

currentRadioNameMasked:currentRadioName.* {
my $name = ReadingsVal($name, "currentRadioName", "");
$name =~ s/ /\./g;
return $name;
},

currentFavouriteNameMasked:currentFavouriteName.* {
my $favouriteName = ReadingsVal($name, "currentFavouriteName", "");
$favouriteName =~ s/ /\./g;
return $favouriteName;
},

currentPlaylistNameMasked:currentPlaylistName.* {
my $name = ReadingsVal($name, "currentPlaylistName", "");
$name =~ s/ /\./g;
return $name;
},

currentRadioNameMasked:currentRadioName.* {
my $name = ReadingsVal($name, "currentRadioName", "");
$name =~ s/ /\./g;
return $name;
},

ZoneGroupNameDetails:(MasterPlayer|roomName|SlavePlayer).* {
my $result = ReadingsVal(ReadingsVal($name, 'MasterPlayer', $name), 'roomName', 'k.A.');
$result = '' if ($name eq ReadingsVal($name, 'MasterPlayer', $name));
foreach my $slave (@{eval(ReadingsVal($name, 'SlavePlayer', '[]'))}) {
$result .= ' + '.ReadingsVal($slave, 'roomName', $slave);
}

return $result;
},

SlavePlayerList:SlavePlayer:.* {
my @player = @{eval(ReadingsVal($name, 'SlavePlayer', '[]'))};
return (scalar(@player) ? '-|' : '').join('|', @player);
},

SlavePlayerListAlias:SlavePlayer:.* {
my @player = @{eval(ReadingsVal($name, 'SlavePlayer', '[]'))};
return (scalar(@player) ? 'Auswahl|' : '').join('|', map { $_ = ReadingsVal($_, 'roomName', $_); $_ } @player);
},

AvailablePlayerList:(MasterPlayer|SlavePlayer):.* {
my @player = @{eval(ReadingsVal('Sonos', 'MasterPlayer', '[]'))};

# Selber entfernen...
splice(@player, SONOS_posInList($name, @player), 1);

# Slaveplayer entfernen...
foreach my $elem (@{eval(ReadingsVal($name, 'SlavePlayer', '[]'))}) {
my $pos = SONOS_posInList($elem, @player);
splice(@player, $pos, 1) if ($pos >= 0);

}

return (scalar(@player) ? '-|' : '').join('|', @player);
},

AvailablePlayerListAlias:(MasterPlayer|SlavePlayer):.* {
my @player = @{eval(ReadingsVal('Sonos', 'MasterPlayer', '[]'))};

# Selber entfernen...
splice(@player, SONOS_posInList($name, @player), 1);

# Slaveplayer entfernen...
foreach my $elem (@{eval(ReadingsVal($name, 'SlavePlayer', '[]'))}) {
my $pos = SONOS_posInList($elem, @player);
splice(@player, $pos, 1) if ($pos >= 0);
}

return (scalar(@player) ? 'Auswahl|' : '').join('|', map { $_ = ReadingsVal($_, 'roomName', $_); $_ } @player);
}
</pre>
Damit werden bei einem Abruf der Favoriten / Playlists / Radios mittels entsprechendem Get-Befehl die entsprechenden Listen für alle Features aufbereitet und am Sonosplayer-Device bereitgestellt.
</div>

<br />''Aktuelle Userreading''<br />
Mit der aktuellen Modulversion werden hierfür keinerlei Userreadings mehr benötigt.

Mit dem Attribute ''getListsDirectlyToReadings'' werden alle möglichen Listen zu Favoriten, Playlists, Radios und der aktuellen Abspielliste (= Queue) automatisch in die richtigen Readings geschrieben.

Des Weiteren kann man mit dem Attribut ''simulateCurrentTrackPosition'' eine Simulation der aktuellen Titelposition aktivieren, sodass eine wiederkehrende Aktualisierung durch ein DOIF o.ä. nicht mehr notwendig ist.

===== Automatische Aktualisierung der Favoriten / Playlisten / Radios durch Notifies =====
Mit den folgenden Notifies kann man auf die Mitteilung der Sonosplayer über eine neue Version der jeweiligen Liste reagieren, und diese im Playerdevice automatisch aktualisieren lassen.
Damit hat man stets die aktuellen und zum Sonos-System passenden Listen in den Userreadings.

<pre>
define Sonos_GetNewFavouritesNotify notify Sonos_[^_]+:FavouritesVersion.* { fhem("get $NAME FavouritesWithCovers");; fhem("get $NAME Favourites");; }

define Sonos_GetNewPlaylistsNotify notify Sonos_[^_]+:PlaylistsVersion.* { fhem("get $NAME PlaylistsWithCovers");; fhem("get $NAME Playlists");; }

define Sonos_GetNewRadiosNotify notify Sonos_[^_]+:RadiosVersion.* { fhem("get $NAME RadiosWithCovers");; fhem("get $NAME Radios");; }

define Sonos_GetNewQueueNotify notify Sonos_[^_]+:QueueVersion.* { fhem("get $NAME QueueWithCovers");; fhem("get $NAME Queue");; }
</pre>

[[Category:Examples]]
[[Category:HOWTOS]]
[[Category:Code Snippets]]
[[Category:Unterhaltungselektronik]]
[[Kategorie:Akustische Ausgabe]]

Copy

2019-12-03T20:46:17Z

LHBL2003:

{{SEITENTITEL:copy}}
{{Infobox Modul
|ModPurpose=Befehl zum Kopieren einer Gerätedefinition
|ModType=cmd
|ModCmdRef=copy
|ModForumArea=Sonstiges
|ModTechName=98_copy.pm
|ModOwner=justme1968 ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:Justme|Wiki]])
}}
Der Befehl [[copy]] dient dazu, eine Kopie eines Gerätes (Device) zu erstellen. Hierbei werden die Definition und alle Attribute unter einem neuen Namen dupliziert.

Der Befehl kann direkt über die [[FHEMWEB|Weboberfläche]] eingegeben werden. Nach dem Ende des Kopiervorgangs wird automatisch die Detailansicht des '''neuen''' Gerätes angezeigt, so dass die in der Regel erforderlichen weiteren Anpassungen gleich durchgeführt werden können.

Beispiel: copy AktuellerName NameDerKopie

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

2019-01-31T19:37:14Z

LHBL2003: /* Luftfeuchtigkeit in Plot */

{{Infobox Hardware
|Bild=HM-TC-IT-WM-W-EU.jpg
|Bildbeschreibung=HM-TC-IT-WM-W-EU mit Standard-Einstellungen
|HWProtocol=[[HomeMatic]]
|HWType=[[HomeMatic Type Thermostat|thermostat]]
|HWCategory=[[:Kategorie:Temperatursensoren|Temperatursensoren]] [[:Kategorie:Feuchtesensoren|Feuchtesensoren]]
|HWComm=868,3 MHz
|HWChannels=7
|HWVoltage=3 V
|HWPowerConsumption=40 mA (max)
|HWPoweredBy=2 x LR6/Mignon/AA
|HWSize=ohne Rahmen: 55 x 55 x 20 mm<br />mit Rahmen: 86 x 86 x 21,5 mm
|HWDeviceFHEM=[[CUL_HM]]

|HWManufacturer=ELV / eQ-3
}}
'''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 ==
: ''→ Allgemeine Informationen, die alle HomeMatic Thermostate betreffen, sind unter [[HomeMatic Type Thermostat]] zu finden.''

Der '''HM-TC-IT-WM-W-EU Funk-Wandthermostat''' 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.

Der Hauptnutzen gegenüber den Heizkörperthermostaten besteht neben einer weitaus bequemeren Bedienung und der möglichen Anzeige von Istwerten von Temperatur und Luftfeuchte auch in einer Entkopplung der Raumtemperaturreglung aus der räumlichen Nähe des Heizkörpers. Zusätzlich oder alternativ zur Heizkörpersteuerung ist auch die Anbindung von Fußbodenheizung oder anderen Wärmequellen über einen funkgesteuerten Schaltaktor durch einen separaten Schaltkanal möglich.

== 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 ==
Grundsätzlich sind speziell bei der Ansteuerung von [[HM-CC-RT-DN Funk-Heizkörperthermostat]] zwei Betriebsarten mit FHEM denkbar.

=== Steuerung nur über den Wandthermostat ===

In diesem Fall werden zunächst alle [[HM-CC-RT-DN Funk-Heizkörperthermostat]]e mit dem HM-TC-IT-WM-W-EU Funk-Wandthermostat verbunden wie in den Handbüchern beschrieben (dort "verknüpfen" genannt, technisch handelt es sich um eine peering).
Dazu muss die mittlere Taste der Heizkörper Ventile länger als 3 Sekunden gedrückt werden, ebenso das Einstellrad am Wandthermostat. Die "Verknüpfung" war erfolgreich, wenn beide Geräte "ACK" im Display zeigen.

Wichtig ist, dass keines der Geräte vorher mit einer Zentrale (u.B. VCCU) gepairt sein darf. Im Zweifel vorher unpairen.

Wenn alle Heizkörperthermostat gepeert ("verknüpft") sind, dann wird das HM-TC-IT-WM-W-EU Funk-Wandthermostat mit FHEM wie in [[HomeMatic Devices pairen]] beschrieben gepairt.

Anschliessend kann per FHEM mit dem Befehl
set myTC desired-temp 22
die Zieltemperatur an den Wandthermostat übermittelt werden. Dieser verteilt diese Temperatur und seine gemessene Ist-Temperatur an die Heizkörperthermostate weiter, die dann entsprechend das Ventil öffnen oder schliessen. Die Wunschtemperatur kann auch lokal an '''allen''' Geräten (also auch an einem der Heizkörperthermostate) per Drehregler geändert werden und wird anschliessend an alle anderen Geräte und FHEM weiterübertragen. Kommunikationspartner für FHEM ist aber immer nur das gepairte HM-TC-IT-WM-W-EU Funk-Wandthermostat.

Vorteile dieser Methode:
* schnell eingerichtet - weniger Komplex, keine Channel peering notwendig.
* weniger Geräte in FHEM, weniger Daten, weniger Defs, weniger Prozessorlast, geringer Verbrauch des Funkkontingents an FHEMs Funkschnittstelle etc. (Es ist allerdings fraglich, ob in normalen Installationen diese Effekte überhaupt spürbar sind)
* Heizung kann am HM-TC-IT-WM-W-EU Funk-Wandthermostat auch bei Ausfall von FHEM eingestellt werden.
* eventuelles Wochenprogramm muss nur an einer Stelle eingespielt werden (nämlich in den Wandthmermostaten)

Nachteile dieser Methode:
* keine direkte Kontrolle über die Heizkörperthermostate, weniger Daten. Z.B. ist der Valevöffnungsgrad FHEM unbekannt, ebenso Batteriewarnungen, auch lassen sich diverse Dinge nicht konfigurieren wie Button lock, boost-time, remote Kanal zur Abschaltung, temp-offset, maximale Ventilöffnung etc.
* leichte Verzögerung in der Übermittlung der Zieltemperatur, da diese zuerst an den Wandthermostaten übermittelt wird und dieser erst mit etwas Verzögerung die Daten an die Heizkörperthermostaten weiterreicht.
* eventuelles Wochenprogramm kann nur an einer Stelle eingespielt werden (nämlich in den Wandthmermostaten), man kann also nicht einzelnen Heizkörpern abweichende Programme geben. Da man einen Wandthermostat wohl in der Praxis nur mit Heizkörperthermostaten '''eines''' einzelnen Raumes peeren wird, ist dieser Nachteil ggf eher theoretischern Natur.

=== Steuerung aller Komponenten durch FHEM ===

Diese Methode wird zumindest von den meisten Nutzern des Forums favorisiert, weil sie mehr Kontrolle auch über Details und Geräte ermöglicht.

In diesem Fall werden zunächst alle Geräte - also die Heizkörperthermostate und der Wandthermostat - wie in [[HomeMatic Devices pairen]] beschrieben mit FHEM (also i.d.R. der VCCU) gepairt.

Danach kann das [[Peering (HomeMatic)|Peering]] mit den Heizkörperthermostaten des betreffenden Raumes stattfinden. Je nach Funktion sind dazu einer oder mehrer Channels zu peeren, Details weiter unten.

Vorteile dieser Methode:
* direkte Kontrolle über die Heizkörperthermostate, Verfügbarkeit Daten wie z.B Valevöffnungsgrad FHEM, Batteriestatus, am jedem Heizkörper gemessene Temperatur etc.; diverse Paramter am Heizkörperthermostat konfigurierbar, wie Button lock, boost-time, remote Kanal zur Abschaltung, temp-offset, maximale Ventilöffnung etc.
* schneller Übermittlung der Zieltemperatur (und sonstiger Daten), da diese zugleich an alle gepeerten Thermostaten übermittelt wird.
* Wochenprogramm frei in alle Geräte übertragbar, dadurch in grossen Räumen gezieltes Ansteuern einzelner Heizkörper möglich etc.

Nachteile dieser Methode:
* deutlich komplexer in der Einrichtung
* mehr Geräte in FHEM, mehr Daten, mehr Defs notwendig, höhere Prozessorlast, höhere Auslastung des Funkkontingents an der HM Funkschnittstelle von FHEM (zumindest für ''normale'' Anzahl von Thermostaten eher theoretischer Natur)
* Zieltemperatur kann ohne FHEM nicht mehr am HM-TC-IT-WM-W-EU Funk-Wandthermostat eingestellt werden, sondern müsste an jedem Heizkörper einzeln eingestellt werden.
* Wochenprogramm muss ggf auf mehrere Geräte verteilt werden.

Bei der Steuerung aller Komponenten über FHEM müssen je nach Anwendungsfall bestimmte Channels gepeert werden.

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

===== Channel (Kanal) 01 _Weather =====
Damit das [[HM-CC-RT-DN Funk-Heizkörperthermostat]] 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.

Damit der Tür-Fensterkontakt den Thermostat aufwecken kann, muss zuerst der Burst-Modus aktiviert werden, siehe dazu [[HM-SEC-SC_Tür-Fensterkontakt#Problembehebung]].

Das eigentliche 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 kann 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 =====
Dieser Kanal kann direkt mit einem HomeMatic-Schaltaktor verknüpft (gepeert) werden, um temperaturgesteuerte Schaltvorgänge auszulösen. Eine direkte Nutzung als Feuchtigkeitssensor zur Lüftungssteuerung ist hingegen nicht möglich. Geeignete Aktoren sind alle dauerhaft mit Klein- oder Netzspannung versorgten Aktoren, die zum Betrieb keinen sog. Burst benötigen (Hutschienen-, Unterputz- und Wandmontage). Nicht geeignet sind demnach die batterieversorgten ein- oder vierkanaligen HM-LC-Sw(x)-BA-PCB-Aktoren oder das Empfangsmodul HM-MOD-Re-8, weil der Thermostat den zum "Aufwecken" dieser Geräte nötigen Burst nicht senden kann.

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> single set

Dies allein ist nicht ausreichend, da der so gepeerte Aktor sich bei jedem Heizbefehl abwechselnd ein- und ausschaltet, da er die Ausschaltbefehle des Thermostaten (short trigger mit Wert 0) ignoriert. Um das zu korrigieren, wird er so programmiert, dass er, wenn eingeschaltet, auf den Ausschaltbefehl reagiert (und ihn ansonsten ignoriert):

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

Möchte man mit dem Aktor ein inverses Verhalten erreichen (etwa beim Einsatz als Kühlthermostat oder für stromlos offene Ventilsteuerköpfe von Fußbodenheizungen), so setzt man '''stattdessen'''

set <HM-LC-SW1-FM> regSet shCtOff ltLo <HM-TC-IT-WM-W-EU_SwitchTr>

== Einstellungen ==

Die folgenden Einstellungen werden in **Registern** des HM-TC-IT-WM-W-EU vorgenommen. Das heißt, dass diese Einstellungen im Gerät selbst gespeichert werden, nicht in der Konfigurations-Datei von FHEM.

=== Anzeige ===

Register im Kanal 2 ''(_Climate)'' erlauben es zu konfigurieren, welche Daten der HM-TC-IT-WM-W-EU in seinem LC-Display anzeigt.

==== showInfo time|date ====

Wählt aus, ob die ''Uhrzeit'' (<code>time</code>, Standard-Einstellung) oder das ''Datum'' (<code>date</code>) angezeigt wird. Der folgende Befehl erlaubt es das Datum anzeigen zu lassen:

set <HM-TC-IT-WM-W-EU>_Climate regSet showInfo date

==== showSetTemp actTemp|setTemp ====

Wählt aus, ob die ''Ist-Temperatur'' (<code>actTemp</code>, Standard-Einstellung) oder die ''Soll-Temperatur'' (<code>setTemp</code>) im Display angezeigt wird.

set <HM-TC-IT-WM-W-EU>_Climate regSet showSetTemp setTemp

==== showHumidity temp|tempHum ====

Wählt aus, ob dauerhaft die ''Temperatur'' (<code>temp</code>, Standard-Einstellung) oder ''Temperatur und Luftfeuchtigkeit'' im Wechsel (<code>tempHum</code>) im Display angezeigt werden.

set <HM-TC-IT-WM-W-EU>_Climate regSet showHumidity tempHum

=== 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 zu anderern HomeMatic Thermostaten verwaltet, siehe [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]]. Beim HM-TC-IT-WM-W-EU ist der Kanal 2 ''(_Climate)'' für die Temperaturlisten zuständig.

=== Luftfeuchtigkeit in SVG Plot ===

Um die Luftfeuchtigkeit im Plot darzustellen benötigt man im Logfile folgenden Eintrag:

2017-10-24_22:03:12 WANDTHERMOSTAT_Weather humidity: 61

Um diesen zu erhalten muss man in der Logfile Konfiguration evtl. das DEF um die Weather Information erweitern:

Standardbeispiel:
./log/WANDTHERMOSTAT-%Y.log WANDTHERMOSTAT

Erweiterung:
./log/WANDTHERMOSTAT-%Y.log WANDTHERMOSTAT|WANDTHERMOSTAT_Weather:.*

Nach einer Weile, sollte der Eintrag "WANDTHERMOSTAT_Weather humidity:" im SVG Plot zur Auswahl zur Verfügung stehen.

== 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]]. Das Thermostat wird in den Updatemodus gebracht, indem beide äußeren Tasten gedrückt werden, während die Batterien eingesetzt werden. Das Display zeigt "FUP" an.

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

* Der Sensor sollte nur innerhalb seiner Spezifikationen (0° - 50°C) betrieben werden; bei kleineren Temperaturen werden überhöhte Temperaturen gesendet, siehe {{Link2Forum|Topic=80383|LinkText=dieser Forumsbeitrag}}.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-TC-IT-WM-W-EU_UM_GE_eQ-3_web.pdf Manual]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Wandthermostat_132030A0_Produktdatenblatt_V1.2.pdf Produktdatenblatt]

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

DOIF/Einsteigerleitfaden, Grundfunktionen und Erläuterungen

2018-12-02T21:22:47Z

LHBL2003: Hinweistext an merheren Stellen hinzugefügt: Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.

[[DOIF]], für FHEM-Einsteiger konzipiert, wurde über Benutzeranforderungen zu einem immer vielfältigeren Werkzeug weiter entwickelt. Damit orientiert sich die Weiterentwicklung des [[DOIF]] an praktischen Aufgabenstellungen. Im Ergebnis können einfache Probleme, sowie auch spezielle und komplexe Aufgaben in kompakter Weise gelöst werden. Damit nimmt jedoch auch die Zahl der Einstellungsmöglichkeiten über Attribute, Syntaxvarianten und deren Kombinationen zu. Das macht es für Einsteiger und Fortgeschrittene nicht leicht den Überblick zu behalten.

Hier soll der Blick auf die Teile des DOIF beschränkt werden, die für die Einfachheit des DOIF aus seiner Anfangszeit stehen und die ausreichen 80% der Aufgabenstellungen lösen.
{{Randnotiz|RNTyp=g|RNText='''Hinweis!'''

Die {{Link2CmdRef|Lang=de|Anker=DOIF|Label=deutschsprachige FHEM-Befehlsreferenz (Commandref)}} zum DOIF sollte bei Fragen immer das erste Nachschlagewerk sein. Sie ist aktueller, genauer und mit Beispielen versehen. Dieser Artikel ist eine geraffte Darstellung der Grundlagen des DOIF mit einigen Erläuterungen.}}

== Voraussetzung ==

Die FHEM-Begriffe [[Gerät]] ([[Device]]), State (Status), [[Readings]], [[Internals]], [[Attribute]], [[Event]] ([[Ereignis]]), Befehl (Command) und deren Funktion sollen bekannt sein.

== DOIF-Light für Einsteiger ==

Die meisten Verknüpfungsaufgaben können mit einem Verständnis der folgenden Abschnitte der {{Link2CmdRef|Lang=de|Anker=DOIF|Label=Hilfe zum DOIF (deutschsprachige Befehlsreferenz)}} gelöst werden.

* {{Link2CmdRef|Lang=de|Anker=DOIF|Label=Einleitung}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Features|Label=Features}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Lesbarkeit_der_Definitionen|Label=Lesbarkeit der Definitionen}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Ereignissteuerung_ueber_Auswertung_von_Events|Label=Ereignissteuerung}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Zeitsteuerung|Label=Zeitsteuerung}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Wochentagsteuerung|Label=Wochentagsteuerung}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Label=Zeitsteuerung mit Zeitintervallen}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Indirekten_Zeitangaben|Label=Indirekte Zeitangaben}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_Nutzung_von_Readings_Stati_oder_Internals_im_Ausfuehrungsteil|Label=Angaben im Ausführungsteil}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_do_always|Label=do always}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_wait|Label=wait}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_do_resetwait|Label=do resetwait}}
* {{Link2CmdRef|Lang=de|Anker=DOIF_setList__readingList|Label=readingList, setList}} Frontendgestaltung
* {{Link2CmdRef|Lang=de|Anker=DOIF_Zu_beachten|Label=zu beachten}} zusätzliche Hinweise und Tipps
* {{Link2CmdRef|Lang=de|Anker=DOIF_Kurzreferenz|Label=Kurzreferenz}} als Überblick

== Struktur und Verhalten des DOIF ==

Der Aufbau des DOIF entspricht einer Baumstruktur mit Bedingungszweigen. {{Randnotiz|RNTyp=y|RNText='''Achtung!''' Der Begriff '''Ereignis''' wird in diesem Artikel erweitert verwendet und umfasst ablaufende Timer und [[Event|Ereignisse]]([[Event|Events]]). }}

[[Image:DOIF_Aufbau_Ablauf_nSVG.png|top|alt="DOIF_Aufbau_Ablauf"]]

=== Verhaltensweise ohne steuernde Attribute ===

==== Angaben im Bedingungsteil ====
Der Bedingungsteil besteht aus einer Perl-Ebene und einer Präprozessorebene.

{{Hinweis|'''('''''Perl-Ebene'' '''['''''DOIF-Präprozessor''''']''' ''Perl-Ebene'' '''['''''DOIF-Präprozessor''''']''' ...''')'''}}

Die erste Ebene der ersten runden Klammer nach den Schlüsselwörtern '''DOIF''' oder '''DOELSEIF''' umschliesst eine Bedingung.

Für Angaben in dieser Klammer (Perl-Ebene) gilt die Perl-Syntax (Operatoren, Operanden, wie Funktionen, Variablen), ausgenommen sind die Angaben in der ersten Ebene der eckigen Klammern, sie umschliessen die Ebene des DOIF-Präprozessors, dort gilt die Syntax des DOIF-Präprozessors.

In dieser Ebene der eckigen Klammern werden '''DOIF-Operanden''' angegeben. Die '''DOIF-Operanden''' beinhalten '''Auslöser'''.

'''Auslöser''' sind Zeitpunkte, Gerätenamen(bei checkReadingEvent 0, voreingestellt bis Version 16651 2018-04-23 06:28:53Z Damian) oder die Kombination von Gerätename:Reading(bei checkReadingEvent 1, voreingestellt nach Version 16651 2018-04-23 06:28:53Z Damian) und Reguläre Ausdrücke, die auf Gerätenamen oder das '''Ereignis''' passen.

'''Ereignisse''' sind für DOIF ablaufende Timer oder [[Event|Ereignisse]] ([[Event|Events]]) die durch [[Gerät|Geräte]] initiiert werden.

Der '''DOIF-Prozess''' wird gestartet wenn ein '''Ereignis''' eintrifft.

Passt ein '''Auslöser''' einer Bedingung zu dem '''Ereignis''' wird diese Bedingung geprüft.

Ist die Bedingung '''wahr''', werden die nach der Bedingung stehenden Befehle ausgeführt.

Nach der Befehlsausführung wird der '''Status''' des '''DOIF''' auf die Befehlsnummer gesetzt ('''cmd_x''') und DOIF wartet auf das nächste '''Ereignis'''.

Ist die Bedingung '''unwahr''' ('''falsch''') wird der nächste Zweig bearbeitet.

Ist '''DOELSE''' angegeben, es gab einen passenden '''Auslöser''' und alle geprüften Bedingungen waren '''unwahr''', dann werden die nach '''DOELSE''' angegebenen '''Befehle''' ausgeführt.

Die '''Befehle''' eines Zweiges werden ohne vorherigen '''Statuswechsel''' nur einmal ausgeführt.

Ein '''Statuswechsel''' findet statt nachdem ein anderer Bedingungszweig '''wahr''' wurde und die zugehörigen '''Befehle''' ausgeführt worden sind.

Ein DOIF mit nur einem Zweig enthält ein internes '''DOELSE''', d.h. bei '''unwahrer''' Bedingung und vorhandenem '''Auslöser''', findet ein '''Statuswechsel''' auf '''cmd_2''' statt.

==== Auslöser ====

Auslöser können durch direkte Angabe des Gerätenamen, [[Readings]], [[Internals]] usw. angegeben werden.

===== Readings und Internals =====

'''['''<''Gerätename''>''']''' oder '''['''<''Gerätename''>''':&STATE]''' bezieht sich auf das Internal '''STATE''' des Gerätes.

'''['''<''Gerätename''>''':'''<''Readingname''>''']''' bezieht sich auf das '''Reading''' des Gerätes.

'''['''<''Gerätename''>''':'''<''Readingname''>''':d]''' bezieht sich auf den '''ersten numerischen Teil''' des '''Reading-Wertes'''.

'''['''<''Gerätename''>''':'''<''Readingname''>''':d<Anzahl der gerundeten Stellen nach dem Dezimaltrenner>]''' bezieht sich auf den '''ersten numerischen Teil''' des '''Reading-Wertes''', der auf '''Anzahl''' Stellen gerundet ist.

'''['''<''Gerätename''>''':'''<''Readingname''>''':sec]''' bezieht sich auf das '''Alter des Zeitstempels''' in Sekunden.

'''['''<''Gerätename''>''':&'''<''Internalname''>''']''' bezieht sich auf das '''Internal''' des Gerätes.

'''['''<''Auslöserangabe''>''','''<''Vorgabewert''>''']''' nicht existierende '''Auslöser''' können mit einem '''Vorgabewert''' angegeben werden.

===== Zeitangaben =====

'''['''<''Zeitpunkt''>''']''' gibt einen Zeitpunkt an

'''['''<''Zeitpunkt Beginn''>'''-'''<''Zeitpunkt Ende''>'''|'''<''Wochentagangaben''>''']''' gibt eine Zeitspanne an, optionale Wochentagangabe

'''<nowiki>[[</nowiki>'''<''Auslöserangabe''>''']]''' gibt einen Zeitpunkt indirekt an.

Mit Zeitangaben kann gerechnet werden, Berechnungen erfolgen in runden Klammern.

Liefert eine Perl-Funktion HH:MM:SS muss sie in geschweifte Klammern eingeschlossen werden.

'''[{sunrise}]''' z.B. Angabe eines Zeitpunktes durch die Perl-Funktion '''sunrise'''.

==== Auslöser (erweitert) ====

'''Auslöser''' können auch allgemein formuliert werden, dazu ist die Fertigkeit erforderlich [[regulärer Ausdruck|'''Reguläre Ausdrücke''']] (Regex) formulieren zu können.

===== Readings und Internals =====

'''['''<''Auslöserangabe''>''':'''<''Regex Filter''>''','''<''Ausgabeformatierung''>''']''' '''Auslöser''' können mit einem Filter eränzt werden, die gefilterten Werte können in der Ausgabeformatierung weiterverarbeitet werden.

===== Ereignisse =====

'''['''<''Gerätename''>''':"'''<''Regex Ereignisrest''>'''"]'''

'''["'''<''Regex Gerätename''>''':'''<''Regex Ereignisrest''>'''"]'''

'''["'''<''Regex Ereignis''>'''",'''<''Vorgabewert''>''']'''

'''["'''<''Regex Ereignis''>'''":'''<''Regex Filter''>''','''<''Ausgabeformatierung''>''','''<''Vorgabewert''>''']''' optional: Filter und Formatierung, verpflichtend: Vorgabe

===== Ereignisse mit Aggregation (Sammlung) von Werten =====

'''['''<''Funktion''>''':'''<''Format''>''':"'''<''Regex Gerätename''>''':'''<''Regex Ereignisrest''>'''":'''<''Reading''>''':'''<''Bedingung''>''','''<''Vorgabewert''>''']''' optional: Format, Reading, Bedingung und Vorgabewert

==== Alle Auslöser ====

'''[?'''<''Auslöserangabe''>''']''' Auslöser, die mit Fragezeichen beginnen lösen nicht aus, sie werden nur abgefragt

==== Angaben im Befehlsteil ====

'''Befehle''' stehen nach einer '''Bedingung''' oder nach '''DOELSE''' in runden Klammern (erste Klammerebene), das ist die FHEM-Ebene. Befehle können direkt angegeben werden.

{{Hinweis|'''('''<''FHEM-Befehle''>''')''', '''("'''<''Systembefehle''>'''")''' oder '''{'''<''Perl-Befehle''>'''}'''}}

Befehle können zu Sequenzen gruppiert werden durch mehrere runde Klammerpaare der ersten Ebene)

{{Hinweis|'''('''<''Befehle der Sequenz 1''>''')''' '''('''<''Befehle der Sequenz 2''>''')''' ... '''('''<''Befehle der Sequenz n''>''')'''}}

Trennzeichen für Befehle ist das Komma, daher ist keine Verdoppelung der Trennzeichen erforderlich.

{{Hinweis|'''('''<Befehl 1>''',''' <Befehl 2>''',''' ... <Befehl n>''')'''}}

Enthält ein Befehl ein Komma, dass kein Befehlstrennzeichen ist, dann ist der Befehl in zusätzliche runde Klammern einzuschliessen.

{{Hinweis|'''(('''<Befehlsteil 1a>''','''<Befehlsteil 1b>'''),''' <Befehl 2>''',''' ... <Befehl n>''')'''}}

Berechnungen erfolgen in geschweiften Klammern auf der Perl-Ebene und müssen unmittelbar mit einer runden Klammer beginnen.

Der Zugriff auf [[Readings]], [[Internals]] usw. erfolgt wie im DOIF üblich, über Angaben in eckigen Klammern inklusive Ausgabeformatierung und Präprozessorersatznamen, wie '''$SELF''', '''$DEVICE''', '''$EVENT''', '''$EVENTS''' (extended [[set magic]]).

=== Häufige Attribute ===

Attribute verändern das Standardverhalten des DOIF.

==== do always ====

Ohne '''do always''' gilt:Die Befehle eines Bedingungszweiges werden ohne vorherigen Statuswechsel nur einmal ausgeführt.

Das Attribut setzt diese Regel ausser Kraft. Befehle werden wiederholt im bestehenden Status ausgeführt.

Das interne DOELSE entfällt bei DOIF mit einem Zweig.

Wait-Timer werden bei wiederholtem Wahrwerden der Bedingung nicht abgebrochen.

==== wait ====

Das Attribut verzögert die Befehlsausführung, nach wahr werden einer Bedingung.

Laufende Wait-Timer werden bei einem eingeleiteten Statuswechsel des DOIF abgebrochen, daher werden die zu verzögernden Befehle nicht mehr ausgeführt.

==== do resetwait ====

Das Attribut beinhaltet '''do always,''' bricht aber die Wait-Timer bei wiederholtem Wahrwerden der Bedingung ab.

==== readingList, setList, webCmd, widgetOverride ====

Diese Attribute statten DOIF mit Dummy-Eigenschaften aus, so dass DOIF als erweitertes Eingabeelement im Frontend dienen kann.

== Erste Schritte mit DOIF: Zeit- und Ereignissteuerung ==
Die nachfolgenden Beispiele sind aus der Einleitung der Hilfe zum DOIF entnommen. Sie werden hier weiter erläutert.
===Beispiel A): Ereignissteuerung ===
{{Randnotiz|RNText=Hinweis: Verwendung von
* <code>[<Gerätename>:"<Ereignis>"]</code> zur Abfrage eines Ereignisses von einem [[Gerät]]
* '''DOELSE''' das Schlüsselwort leitet einen Befehlszweig ohne explizite Bedingung ein. Dieser Zweig wird ausgeführt, wenn keine geprüfte Bedingung wahr ist.
* '''devStateIcon''' zum direkten Ausführen eines Befehls im [[DOIF]] und zur Anzeige von Icons
}}
<u>Aufgabenstellung:</u>

Eine Fernbedienung soll einen Fernseher einschalten, der über eine Funkstekdose angeschlossen ist.

Das [[Gerät]] '''Fernbedienung''' wird durch den Dummy '''remotecontrol''' dargestellt. In der Realität könnte es die Definition eines Empfängers für eine Infrarot-Fernbedienung sein.

Das [[Gerät]] '''Funksteckdose TV''' wird durch den Dummy '''tv''' dargestellt. In der Realität könnte es die Definition einer Intertechno-Funkstekdose aus dem Baumarkt sein.

Die Signale von '''remotecontrol''' werden über das DOIF '''di_rc_tv''' alias '''Steuerlogik''' in einen Befehl für die Funksteckdose '''tv''' umgesetzt.

Das Signal ist als [[Ereignis]] im [[Event monitor|Eventmonitor]] sichtbar <code>2017-02-28 09:07:03 dummy tv on</code>

Das [[DOIF]] reagiert durch die Angabe von <code>[remotecontrol:"on"]</code> in der Schaltbedingung. Weil '''on''' als Wert in dem Ereignis enthalten ist, wird die Bedingung wahr. Das bewirkt das Ausführen des Befehls <code>set tv on</code>. Danach nimmt das [[DOIF]] den Status '''cmd_1''' an.

Falls '''off''' im Ereignis enthalten ist wird die Bedingung nicht wahr, daher wird der Befehl <code>set tv off</code> des DOELSE-Zweiges des [[DOIF]] ausgeführt und [[DOIF]] nimmt den Status '''cmd_2''' an.

<u>Definition:</u>
<pre>define di_rc_tv DOIF ([remotecontol:"on"]) (set tv on) DOELSE (set tv off)</pre>

Über das [[Attribute|Attribut]] '''devStateIcon''' können die Befehle des [[DOIF]] direkt ausgeführt werden.
<pre>attr di_rc_tv devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1</pre>
Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.

Das erste Tripel <code>cmd_1:general_an:cmd_2</code> hat die Bedeutung ''aktueller Status''''':'''''Icon-Name''''':'''''Status nach Betätigung des Icons''. Also, wenn der Status '''cmd_2''' ist, dann zeige das Icon '''general_an''' und wenn das Icon betätigt wird, dann führe den Befehl aus, der zu '''cmd_1''' gehört.

Das zweite Tripel hat die gleiche Funktion, jedoch wird in diesem Fall das Icon '''general_aus''' angezeigt, wenn der Status des [[DOIF]] '''cmd_1''' ist oder '''initialized''' .

Die nachstehende, komplette Definition für die Gruppe A) kann über '''[[Import von Code Snippets|Raw definition]]''' in [[FHEM]] importiert werden.
Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.
<pre>
defmod di_rc_tv DOIF ([remotecontrol:"on"]) (set tv on) DOELSE (set tv off)
attr di_rc_tv alias Steuerlogik
attr di_rc_tv devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1
attr di_rc_tv group A) Fernbedienung (Ereignissteuerung)
attr di_rc_tv icon helper_doif
attr di_rc_tv room Schulungsraum

defmod remotecontrol dummy
attr remotecontrol alias Fernbedienung
attr remotecontrol devStateIcon .*:noIcon
attr remotecontrol group A) Fernbedienung (Ereignissteuerung)
attr remotecontrol icon it_remote
attr remotecontrol room Schulungsraum
attr remotecontrol webCmd on:off

defmod tv dummy
attr tv alias Funksteckdose TV
attr tv devStateIcon on:it_television@red off:it_television@blue
attr tv group A) Fernbedienung (Ereignissteuerung)
attr tv icon it_television
attr tv room Schulungsraum
save
</pre>

=== Beispiel B): Zeitsteuerung ===
{{Randnotiz|RNText=Hinweis: Verwendung von
* <code><nowiki>[<Zeitpunkt>|<Wochentagangabe>]</nowiki></code> zur Angabe eines Zeitpunktes mit Wochentagbeschränkung. Die Zeiten gelten für die angegebenen Wochentage.
* '''DOELSEIF''' das Schlüsselwort leitet einen Bedingungszweig ein und muss eine Bedingung enthalten. Dieser Zweig wird ausgeführt, wenn eine Bedingung geprüft wird und sie wahr ist.
* '''devStateIcon''' zum direkten Ausführen eines Befehls im [[DOIF]] und zur Anzeige von Icons
}}
<u>Aufgabenstellung:</u>

Ein Radio soll werktags und am Wochenende zu unterschiedlichen Zeiten ein- u. ausgeschaltet werden.

Das [[Gerät]] '''Funksteckdose Radio''' wird durch den Dummy '''radio''' dargestellt. In der Realität könnte es die Definition einer Intertechno-Funkstekdose aus dem Baumarkt sein.

Wenn die Uhrzeit mit einem Schaltzeitpunkt übereinstimmt, wird die Zeitpunktangabe wahr. Wird dann auch die gesamte Bedingung wahr, dann wird der zu diesem Bedingungszweig gehörende Befehl ausgeführt. Das [[DOIF]] '''di_clock_radio''' alias '''Zeitschaltuhr''' setzt dann einen Befehl zum Schalten der Funksteckdose '''radio''' ab.

Das Zeitereignis ist im [[Event monitor|Eventmonitor]] nicht sichtbar.

Die Zeitpunkte eines Bedingungszweiges sind '''or'''(oder) verknüpft. Im ersten Bedingungszweig steht die Einschaltbedingung, im Zweiten (DOELSEIF) die Auschaltbedingung.

<u>Definition:</u>
<pre>define di_clock_radio DOIF ([06:30|Mo Di Mi] or [08:30|Do Fr Sa So]) (set radio on) DOELSEIF ([08:00|Mo Di Mi] or [09:30|Do Fr Sa So]) (set radio off)</pre>

Über das [[Attribute|Attribut]] '''devStateIcon''' können die Befehle des [[DOIF]] über das WEB-Frontend unabhängig von den Schaltzeitpunkten ausgeführt werden.
<pre>attr ddi_clock_radio devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1</pre>
Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.

Die nachstehende, komplette Definition für die Gruppe B) kann über '''[[Import von Code Snippets|Raw definition]]''' in [[FHEM]] importiert werden.
<pre>
defmod di_clock_radio DOIF ([06:30|8] or [08:30|7]) (set radio on) DOELSEIF ([08:00|8] or [09:30|7]) (set radio off)
attr di_clock_radio alias Zeitschaltuhr
attr di_clock_radio devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1
attr di_clock_radio group B) Zeitschaltuhr (Zeitsteuerung)
attr di_clock_radio icon helper_doif
attr di_clock_radio room Schulungsraum

defmod radio dummy
attr radio alias Funksteckdose Radio
attr radio devStateIcon on:it_radio@red off:it_radio@blue
attr radio group B) Zeitschaltuhr (Zeitsteuerung)
attr radio icon it_radio
attr radio room Schulungsraum
save
</pre>

=== Beispiel C): Kombinierte Ereignis- und Zeitsteuerung ===
{{Randnotiz|RNText=Hinweis: Verwendung von
* <code><nowiki>[<Beginzeitpunkt>-<Endzeitpunkt>]</nowiki></code> zur Angabe einer Zeitspanne.
* <code>[<Gerätename>:<Reading-Name>]</code> zur Abfrage eines Reading-Inhaltes.
* <code> < </code>, eines numerischen Vergleichsoperators und Vergleich mit einer Konstanten (40).
* '''DOELSE''' das Schlüsselwort leitet einen Befehlszweig ohne explizite Bedingung ein. Dieser Zweig wird ausgeführt, wenn keine geprüfte Bedingung wahr ist.
* '''devStateIcon''' zum direkten Ausführen eines Befehls im [[DOIF]] und zur Anzeige von Icons
* '''readingList''', '''setList''' und '''webCmd''' zur Erzeugung eines Eingabeelementes im Frontend
* '''stateFormat''' um einen benutzerdefinierten Status zu erzeugen.
}}
<u>Aufgabenstellung:</u>

Eine Lampe soll in einer Zeispanne eingeschaltet werden, wenn die Helligkeit einen bestimmten Wert unterschreitet.

Das [[Gerät]] '''Lampe''' wird durch den Dummy '''lamp''' dargestellt. In der Realität könnte es die Definition einer funkgesteuerten Lampenfassung sein.

Das [[Gerät]] '''Helligkeitssensor''' wird durch den Dummy '''sensor''' dargestellt. In der Realität könnte es die Definition eines Homematic Funk-Lichtsensor sein oder ein selbstgebauter Helligkeitssensor mit TSL2561-Chip.

Wenn die aktuelle Uhrzeit in der angegebenen Zeitspanne liegt, ist die Zeitspanne wahr. Wenn dann auch die Helligkeit unter 40 sinkt, wird die gesamte Bedingung wahr, weil Zeitspanne und Hellikeitsvergleich '''and'''(und) verknupft sind. Der zu diesem Bedingungszweig gehörende Befehl wird dann ausgeführt. Das [[DOIF]] '''di_lamp''' alias '''Lampenlogik''' setzt dann einen Befehl zum Schalten der Lampe '''lamp''' ab.
Der DOELSE-Zweig wird ausgeführt, wenn die Bedingung im ersten Zweig unwahr wird.

<u>Definition:</u>
<pre>define di_lamp DOIF ([06:00-19:00] and [sensor:brightness] < 40) (set lamp on) DOELSE (set lamp off)</pre>

Über das [[Attribute|Attribut]] '''devStateIcon''' können die Befehle des [[DOIF]] über das WEB-Frontend unabhängig von den Schaltzeitpunkten ausgeführt werden.
<pre>attr di_lamp devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1</pre>
Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.

Das [[Attribute|Attribut]] '''setList''' zusammen mit '''readingList''' und '''webCmd''' realisiert im [[Gerät]] '''sensor''' für das Reading '''brightness''' einen Schieberegler, mit dem eine Helligkeit zwischen 0 und 100 in in Schritten von 1 simuliert werden kann und der im Frontend angezeigt wird.
<pre>
attr sensor readingList brightness
attr sensor setList brightness:slider,0,1,100
attr sensor webCmd brightness
</pre>

Mit dem [[Attribute|Attribut]] '''stateFormat''' wird im [[Gerät]] '''sensor''' das Reading '''brightness''' in den Status geschrieben. Damit wird der Helligkeitswert auch im Frontend sichtbar.
<pre>
attr sensor stateFormat brightness</pre>

Die nachstehende, komplette Definition für die Gruppe C) kann über '''[[Import von Code Snippets|Raw definition]]''' in [[FHEM]] importiert werden.
Hinweis: In neueren Versionen ggf. '''initialized''' durch '''initialize''' ersetzen.
<pre>
defmod di_lamp DOIF ([06:00-19:00] and [sensor:brightness] < 40) (set lamp on) DOELSE (set lamp off)
attr di_lamp alias Lampenlogik
attr di_lamp devStateIcon cmd_1:general_an:cmd_2 cmd_2|initialized:general_aus:cmd_1
attr di_lamp group C) Kombinierte Ereignis- und Zeitsteuerung
attr di_lamp icon helper_doif
attr di_lamp room Schulungsraum

defmod lamp dummy
attr lamp alias Lampe
attr lamp group C) Kombinierte Ereignis- und Zeitsteuerung
attr lamp icon light_light
attr lamp room Schulungsraum

defmod sensor dummy
attr sensor alias Helligkeitssensor
attr sensor group C) Kombinierte Ereignis- und Zeitsteuerung
attr sensor icon message_light_intensity
attr sensor readingList brightness
attr sensor room Schulungsraum
attr sensor setList brightness:slider,0,1,100
attr sensor stateFormat brightness
attr sensor webCmd brightness
save
</pre>

=== Ansicht der Gruppen A) bis C) im Frontend ===

[[Datei:erste_schritte_DOIF.png|670px]]

==Links==
* [[DOIF]]
* [[DOIF/Tipps zur leichteren Bedienung]] Erstellung, Bearbeitung, Syntaxhervorhebung, Klammerprüfung, Suchen&Ersetzen, Zeilennummerierung, uvm. (nicht nur) von DOIF
* [[Regulärer_Ausdruck]]
* [[Event]] Ereignisse
* [[Readings]]
* [[Internals]]
* [[Attribute]]

* [http://perldoc.perl.org/perlop.html http://perldoc.perl.org/perlop.html] Perloperatoren
* [http://perldoc.perl.org/perlre.html http://perldoc.perl.org/perlre.html] Reguläre Ausdrücke

[[Kategorie:HOWTOS]]

Watchdog

2018-11-17T23:35:52Z

LHBL2003: /* Anwendung */

{{SEITENTITEL:watchdog}}

{{Infobox Modul
|ModPurpose=Zeitverzögerte Ausführung von Aktionen beim Ausbleiben von Ereignissen
|ModType=h

|ModCmdRef=watchdog
|ModTechName=91_watchdog.pm
|ModOwner=rudolfkoenig / [http://forum.fhem.de/index.php?action=profile;u=8 rudolfkoenig]
}}

[[watchdog]] ist ein Fhem-Erweiterungsmodul, mit dem z. B. zeitverzögert auf das Ausbleiben von Ereignissen reagiert werden kann. In Verbindung mit [[THRESHOLD]] kann auch auf das Über- oder Unterschreiten von Schwellwerten reagiert werden.

== Voraussetzungen ==
Keine.

== Anwendung ==
{{Randnotiz|RNText=Die Reaktivierung des watchdog hat mit dem Befehl <code><nowiki>trigger <device> .</nowiki></code> (Achtung den Punkt nicht vergessen.) oder durch Setzen des Attributs <code>autoRestart</code> zu erfolgen. Die in Blogs und Forumsbeiträgen häufiger zu findende Variante mit <code><nowiki>setstate</nowiki></code> entspricht nicht und entsprach nie der commandref. Sie funktioniert nur "aus Versehen". Es existiert dafür kein Bestandsschutz und unerwünschte Seiteneffekte sind nicht auszuschließen!}}
:<code>define <name> watchdog <regexp1> <timespec> <regexp2> <command> </code>
=== Define ===
Führe Befehl <command> aus, wenn nach Ereignis <regexp1> nicht innerhalb der Zeitspanne <timespec> das Ereignis <regexp2> auftritt.

=== Attribute ===

== Anwendungsbeispiele ==

=== Heizungsabschaltung bei geöffnetem Fenster ===
Wenn der Tür-/Fensterkontakt an der Balkontür (MAX_WZ_SK) länger als 15 Sekunden geöffnet ist, wird die Heizung im Wohnzimmer (MAX_WZ) ausgeschaltet:

<code>define wd_WZ_SK_opened watchdog MAX_WZ_SK:opened.* 00:00:15 MAX_WZ_SK:closed.* set MAX_WZ desiredTemperature off;; trigger wd_WZ_SK_opened .</code>

Der Befehl <code>trigger wd_WZ_SK_opened .</code> schaltet den watchdog nach einem Auslösen wieder in den Ursprungszustand. Ohne diesen Befehl würde der watchdog nur genau einmal auslösen. Statt über den angehängten Befehl <code>trigger wd_WZ_SK_opened .</code> könnte man auch durch Setzen des Attributes <code>autoRestart</code> für den watchdog (<code>attr wd_WZ_SK_opened autoRestart 1</code>) ein automatisches Rücksetzen in den Ursprungszustand (state = "defined") erreichen.

Quelle: {{Link2Forum|Topic=51387}}

=== Unterstützung der Statusermittlung für die Module RESIDENTS, ROOMMATE, GUEST ===
Ein watchdog kann bei der Statusermittlung eines Bewohners im Rahmen der Modulfamilie {{Link2CmdRef|Anker=RESIDENTS|Label=RESIDENTS}}, {{Link2CmdRef|Anker=ROOMMATE|Label=ROOMMATE}} und {{Link2CmdRef|Anker=GUEST|Label=GUEST}} genutzt werden. Mit folgender watchdog-Defintion wird der Status von Resident Ralf (rr_Ralf) automatisch 10 Minuten nach Umschalten auf den Status gotosleep auf asleep gesetzt, wenn keine andere Statusmeldung kommt:

<code>define wd_Ralf_gotosleep_asleep watchdog rr_Ralf:gotosleep.* 00:10:00 rr_Ralf:(home|absent|gone|none|asleep|awoken) set rr_Ralf asleep;; trigger wd_Ralf_gotosleep_asleep .</code>

Quelle: {{Link2Forum|Topic=51387}}

== Links ==
* Vorstellung einer Lösung im {{Link2Forum|Topic=23260}}, zeitverzögert auf das Ausbleiben von Temperaturwerten eines Sensors zu reagieren. (HINWEIS: Die Reaktivierung des watchdog im verlinkten Thema mit <code><nowiki>setstate <device> defined</nowiki></code> ist entsprechend commandref durch <code><nowiki>trigger <device> .</nowiki></code> oder Aktivierung des Attributs <code>autoRestart</code> zu ersetzen.)
* [[Watchdog kombiniert mit Threshold]]

Watchdog

2018-11-17T23:35:24Z

LHBL2003: /* Anwendung */

{{SEITENTITEL:watchdog}}

{{Infobox Modul
|ModPurpose=Zeitverzögerte Ausführung von Aktionen beim Ausbleiben von Ereignissen
|ModType=h

|ModCmdRef=watchdog
|ModTechName=91_watchdog.pm
|ModOwner=rudolfkoenig / [http://forum.fhem.de/index.php?action=profile;u=8 rudolfkoenig]
}}

[[watchdog]] ist ein Fhem-Erweiterungsmodul, mit dem z. B. zeitverzögert auf das Ausbleiben von Ereignissen reagiert werden kann. In Verbindung mit [[THRESHOLD]] kann auch auf das Über- oder Unterschreiten von Schwellwerten reagiert werden.

== Voraussetzungen ==
Keine.

== Anwendung ==
{{Randnotiz|RNText=Die Reaktivierung des watchdog hat mit <code><nowiki>trigger <device> .</nowiki></code> (Achtung den Punkt nicht vergessen.) oder durch Setzen des Attributs <code>autoRestart</code> zu erfolgen. Die in Blogs und Forumsbeiträgen häufiger zu findende Variante mit <code><nowiki>setstate</nowiki></code> entspricht nicht und entsprach nie der commandref. Sie funktioniert nur "aus Versehen". Es existiert dafür kein Bestandsschutz und unerwünschte Seiteneffekte sind nicht auszuschließen!}}
:<code>define <name> watchdog <regexp1> <timespec> <regexp2> <command> </code>
=== Define ===
Führe Befehl <command> aus, wenn nach Ereignis <regexp1> nicht innerhalb der Zeitspanne <timespec> das Ereignis <regexp2> auftritt.

=== Attribute ===

== Anwendungsbeispiele ==

=== Heizungsabschaltung bei geöffnetem Fenster ===
Wenn der Tür-/Fensterkontakt an der Balkontür (MAX_WZ_SK) länger als 15 Sekunden geöffnet ist, wird die Heizung im Wohnzimmer (MAX_WZ) ausgeschaltet:

<code>define wd_WZ_SK_opened watchdog MAX_WZ_SK:opened.* 00:00:15 MAX_WZ_SK:closed.* set MAX_WZ desiredTemperature off;; trigger wd_WZ_SK_opened .</code>

Der Befehl <code>trigger wd_WZ_SK_opened .</code> schaltet den watchdog nach einem Auslösen wieder in den Ursprungszustand. Ohne diesen Befehl würde der watchdog nur genau einmal auslösen. Statt über den angehängten Befehl <code>trigger wd_WZ_SK_opened .</code> könnte man auch durch Setzen des Attributes <code>autoRestart</code> für den watchdog (<code>attr wd_WZ_SK_opened autoRestart 1</code>) ein automatisches Rücksetzen in den Ursprungszustand (state = "defined") erreichen.

Quelle: {{Link2Forum|Topic=51387}}

=== Unterstützung der Statusermittlung für die Module RESIDENTS, ROOMMATE, GUEST ===
Ein watchdog kann bei der Statusermittlung eines Bewohners im Rahmen der Modulfamilie {{Link2CmdRef|Anker=RESIDENTS|Label=RESIDENTS}}, {{Link2CmdRef|Anker=ROOMMATE|Label=ROOMMATE}} und {{Link2CmdRef|Anker=GUEST|Label=GUEST}} genutzt werden. Mit folgender watchdog-Defintion wird der Status von Resident Ralf (rr_Ralf) automatisch 10 Minuten nach Umschalten auf den Status gotosleep auf asleep gesetzt, wenn keine andere Statusmeldung kommt:

<code>define wd_Ralf_gotosleep_asleep watchdog rr_Ralf:gotosleep.* 00:10:00 rr_Ralf:(home|absent|gone|none|asleep|awoken) set rr_Ralf asleep;; trigger wd_Ralf_gotosleep_asleep .</code>

Quelle: {{Link2Forum|Topic=51387}}

== Links ==
* Vorstellung einer Lösung im {{Link2Forum|Topic=23260}}, zeitverzögert auf das Ausbleiben von Temperaturwerten eines Sensors zu reagieren. (HINWEIS: Die Reaktivierung des watchdog im verlinkten Thema mit <code><nowiki>setstate <device> defined</nowiki></code> ist entsprechend commandref durch <code><nowiki>trigger <device> .</nowiki></code> oder Aktivierung des Attributs <code>autoRestart</code> zu ersetzen.)
* [[Watchdog kombiniert mit Threshold]]

Rename

2018-11-17T16:19:25Z

LHBL2003: Beispiel für "rename" hinzugefügt, da es nur ein Beispiel für Homatic gab.

{{SEITENTITEL:rename}}
{{Infobox Modul
|ModPurpose=Befehl zur Umbenennung von FHEM-Geräten
|ModType=cmd
|ModCmdRef=rename
|ModForumArea=Sonstiges
|ModTechName=fhem.pl ("Built-in")
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}
Der Befehl [[rename]] ist der "offizielle" Weg, um Geräten in FHEM einen neuen Namen zu geben. Hierbei wird soweit möglich Sorge getragen, dass andere Objekte, die in Bezug zum umbenannten Device stehen, berücksichtigt und entsprechend mit behandelt werden.
:<code>rename '''''meinDevice''''' '''''neuerName'''''</code>

Bei [[HomeMatic]] Geräten mit mehreren Kanälen, die jeweils eigene Namen (normalerweise ein angehängtes ''_KanalName'') haben, sollte besser (sofern bei dem Gerät verfügbar) der Befehl
:<code>set '''''meinDevice''''' deviceRename '''''neuerName'''''</code>
verwendet werden. Damit bekommt das Gerät inklusive aller Kanäle konsistente neue Bezeichnungen.

EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais

2018-09-09T19:07:35Z

LHBL2003: /* FHEM Config-Auszug */

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

2018-03-30T20:15:26Z

LHBL2003: Auflistung und Beschreibung der Readings hinzugefügt, Vervollständigung notwendig

{{Infobox Hardware
|Bild=HM-CC-RT-DN.jpg
|Bildbeschreibung=HM-CC-RT-DN an Heizkörper montiert
|HWProtocol=[[HomeMatic]]
|HWType=[[HomeMatic Type Thermostat|thermostat]]
|HWCategory=[[:Kategorie:Heizungsventile|Heizungsventile]]
|HWComm=868 MHz
|HWChannels=6
|HWVoltage=3 V
|HWPowerConsumption=180 mA
|HWPoweredBy=2x LR6/Mignon/AA
|HWSize=54x65x93 mm (BxHxT)
|HWDeviceFHEM=[[CUL_HM]]

|HWManufacturer=ELV / eQ-3
}}

'''HM-CC-RT-DN''' (häufig einfach '''RT''' genannt) ist ein Funk-''Heizkörperthermostate'' mit integriertem ''Stellantrieb''. Das Thermostat ist seit September 2013 verfügbar und ist der Nachfolger des [[HM-CC-VD Funk-Stellantrieb]]s.

== Vorbemerkungen ==
: ''→ Einstellungen und Informationen, die alle [[HomeMatic]] Thermostate betreffen, sind unter [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]] zu finden.''

Der HM-CC-RT-DN kann die Temperatur selbst messen (im Gegensatz zum [[HM-CC-VD Funk-Stellantrieb|Vorgänger]]) und verfügt über eine Fenster-Offen-Erkennung sowie eine Boost-Funktion. Der HM-CC-RT-DN ''kann'' von einem [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP]] gesteuert werden, das ist aber ''optional''.

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 Firmwareupdate-Software. Weitere Details sind unter [[#Firmware Update|Firmware Update]] beschrieben.
{{Hinweis|Die Solltemperaturen eines HM-CC-RT-DN lassen sich ''nicht'' durch einen [[HM-CC-TC Funk-Wandthermostat]] ''steuern''. Dieser kann nur die Ist-Temperatur an den HM-CC-RT-DN weitergeben, damit nicht die am HM-CC-RT-DN direkt gemessene Raumtemperatur zur Regelung verwendet 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
[[Peering (HomeMatic)|gepeert]] werden.

{{Hinweis|Wird für Wartungs-/Umbaumaßnahmen das Wasser der Heizung abgelassen bzw. diese neubefüllt, sind alle Stellantriebe manuell dauerhaft auf '''on''' zu setzen: set <HM_Stellantrieb>_Clima controlManu on. Beim Einsatz eines Wandthermostaten ist der Wandthermostat entsprechend einzustellen.}}

== 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 (2018)

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

Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden

=== Channels (Kanäle) ===
==== Channel (Kanal) 01 _Weather ====

Dieser Kanal dient zur Einspeisung der (gemessenen) ''Ist-Temperatur''. Als Sensor können zum Beispiel das [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP|HM-TC-IT-WM-W-EU Funk-Wandthermostat]] oder ein [[HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor innen (IT)|HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor]] dienen.

Ein Temperatur-Sensor ''tempSensor'' kann mit dem ''_Weather''-Kanal wie folgt [[Peering (HomeMatic)|gepeert]] werden:

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

Beispiel:
set EG_Buero_WANDTHERMOSTAT_Weather peerChan 0 EG_Buero_THERMOSTAT_Weather single set

ACHTUNG: Das Wandthermostat sowie das Thermostat Ventil (Beispiel "EG_Buero_WANDTHERMOSTAT" und EG_Buero_THERMOSTAT) werden vorher in FHEM den Status "CMDs_done" anzeigen.
Beim peerChan wird dann bei beiden "CMDs_pending" stehen. Wobei das Wandthermostat sehr schnell wieder auf CMDs_done zurück springt.
Allerdings ist dingend darauf zu achten, dass das Thermostat Ventil auch wieder auf "CMDs_done" wechselt, bevor man den nächsten Befehl absendet.
Das Heizkörper Ventile kann unter umständen 3 bis 5 min benötigen bis wieder "CMDs_done" steht. Evtl. kann man dies durch die BOOST Taste beschleunigen. Da das Ventil etwa alle 3 min aufwacht, prüft und Daten sendet / empfängt. Sollte man mit dem Befehlen weiter gemacht haben, so kann es zu Problemen führen, das einer nicht mehr mit dem Pending aufhört. In dem Fall empfiehlt es sich beide Devices von Fhem abzumelden und auf Werkseinstellung zu resetten.

Zum Test haucht man das Wandthermostat an oder hält es einige Zeit in der Hand bis die Temperatur steigt, nach etwa 3 Minuten sollte man auch am Thermostat Ventil ein Temperaturanstieg sehen.

==== Channel (Kanal) 02 _Climate ====
Dieser Kanal erlaubt es dem [[HM-TC-IT-WM-W-EU Funk-Wandthermostat AP|HM-TC-IT-WM-W-EU Funk-Wandthermostat]] den HM-CC-RT-DN zu steuern. Dazu müssen die beiden Geräte gepeert werden:

set <HM-TC-IT-WM-W-EU>_Climate peerChan 0 <HM-CC-RT-DN>_Climate single set

==== Channel (Kanal) 03 _WindowRec ====
Mit diesem Kanal können Fensterkontakte ([[HM-SEC-SC Tür-Fensterkontakt|HM-SEC-SC]] und [[HM-Sec-RHS Funk-Fenster-Drehgriffkontakt|HM-SEC-RHS]]) 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]] 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 <HM-CC-RT-DN>_WindowRec single set

Zum Löschen (=unpeeren) dieser Kopplung:
set <fensterSensor> peerChan 0 <HM-CC-RT-DN>_WindowRec single unset

'''Achtung''': Der Peer-(Lösch)Vorgang muss erst am Fensterkontakt durch Drücken der Anlerntaste ausgelöst werden, und zwar auch dann, wenn der Fensterkontakt schon vorher mit FHEM gepairt wurde. Dann kann der oben genannte Befehl in FHEM abgesetzt werden. 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 <HM-CC-RT-DN>_WindowRec regSet winOpnTemp <Temp> <fensterSensor>

==== Channel (Kanal) 04 _Clima ====
Dieser Kanal dient zum Einstellen der Betriebsparameter, auch [[#Temperaturlisten|Temperaturlisten]] sind hierauf zu übertragen.
Mit dem Modul [[Weekprofile|Wochenplan / Weekprofile]] können die Wochenpläne komfortabel in FHEM erstellt und an die Thermostate übertragen werden.

{{Hinweis|In älteren Versionen von FHEM wurde dieser Kanal durch ''autocreate'' als <code>_ClimRT_tr</code> angelegt. Der Hersteller hat hier offenbar die internen Bezeichnungen 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 <HM-CC-RT-DN>_Clima regSet valveMaxPos 80

Die interne "Fenster-auf"-Erkennung kann man wie folgt abschalten:
set <HM-CC-RT-DN>_Clima regSet winOpnMode off

==== Channel (Kanal) 05 _ClimaTeam ====
Dieser Kanal erlaubt es mehrere HM-CC-RT-DN zu einem "Team" zu gruppieren. 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 ''<HM-CC-RT-DN#1>_ClimaTeam'', ''<HM-CC-RT-DN#2>_ClimaTeam'', ..., ''<HM-CC-RT-DN#8>_ClimaTeam'' die Kanalbezeichnungen der jeweiligen ClimaTeam-Kanäle sind:
set <HM-CC-RT-DN#1>_ClimaTeam peerChan 0 <HM-CC-RT-DN#2>_ClimaTeam single
set <HM-CC-RT-DN#1>_ClimaTeam peerChan 0 <HM-CC-RT-DN#3>_ClimaTeam single
set <HM-CC-RT-DN#2>_ClimaTeam peerChan 0 <HM-CC-RT-DN#3>_ClimaTeam single
...

==== Channel (Kanal) 06 _remote ====
Dieser Kanal kann 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:
set <button> peerChan 0 <HM-CC-RT-DN>_remote single

=== Betriebsmodus Auto, Manu, Party (Urlaub) ===

Der HM-CC-RT-DN verfügt über drei Betriebsmodus: Auto, Manu (Manuell) und Party (Urlaub).

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

==== Modus Manu ====
Die Temperatur wird manuell eingestellt, das Wochenprogramm wird nicht abgearbeitet. "Manuell Einstellen" bedeutet entweder am Handrad oder durch Übermittlung eines "set desired temp"-Befehls von FHEM (oder equivalent von einer CCU).

==== Modus Party (Urlaub) ====
Die eingestellte Temperatur gilt bis zu einem gegebenen Endzeitpunkt, anschließend wechselt das Thermostat in den ''Auto''-Modus.

==== Welchen Modus nutzen? ====
Im Umfeld von FHEM sind alle drei Modi einsetzbar. Betrieb in "Auto" hat den Vorteil, dass bei Ausfall der FHEM-Instanz der Thermostat trotzdem noch die eingespeicherten Wochenprogramme abarbeitet. Nachteilig ist aber, dass die Steuerung komplexer wird, weil sowohl die Einstellungen am Thermostat als auch Schaltebefehle von FHEM das Verhalten beeinflussen. Vielfach wird daher im Umfeld von FHEM der Modus "Manu" benutzt, hier wird die Temperatur nur per einzelnem FHEM Schaltbefehl gesteuert, ausgelöst z.b. durch "at" Kommandos, Anwesenheitserkennung oder Bewegungsmelder. Sollte FHEM (oder die Funkverbindung) ausfallen, bleibt der Thermostat allerdings auf der letzten eingestellten Temperatur stehen.

Denkbar ist auch, den Modus "Auto" zu verwenden und dann die Steuerung per FHEM dadurch durchzuführen, dass durch FHEM die Wochenprogramme verändert werden. Dies verbindet zwar die Vorteil der vorgenannten Methoden, ist aber am aufwendigsen in der Programmierung und erzeugt die höchste Funklast.

Auch der Urlaubsmodus ist einsetzbar, so kann beispielsweise bei Abwesenheit ein niedrigeres Temperaturprofil eingestellt werden, ohne dass eventuell vorhandene Temperaturlisten verändert werden müssen.

set <HM-CC-RT-DN>_Clima controlParty 16 06.12.13 16:30 09.12.13 05:00

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

{{Hinweis|
* Der Befehl muss auf dem Kanal 4 ''(_Clima)'' erfolgen.
* Es werden nur Uhrzeiten zu jeder vollen oder halben Stunde angenommen (Minuten also 00 oder 30).}}

Mit der folgenden Funktion <code>Urlaub()</code> kann man eine ganze Wohnung (also mehrere RTs) mit nur einem Befehl in den Party-Modus versetzen. Im Beispiel werden zwei Heizkörper ("Treppenhaus" und "Kammer") angesteuert.

Zu beachten sind folgende Dinge:
# Aktuelle Dateien (z.B. <code>10_CUL_HM</code>) verwenden!
# Bei dem ''controlParty''-Befehl ''kein'' Komma zwischen den Parametern.
# Bei der Funktion die Parameterübergabe definieren <code>($$$$$)</code>

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

'''Funktion:'''
<syntaxhighlight lang=perl>
my $Urlaub;
sub
Urlaub($$$$$)
{
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/;

# controlParty bei jedem HM-CC-RT-DN setzen.
for my $rt (qw(Kammer Treppenhaus)) {
fhem ("set $rt controlParty $temp $startDate $startTime $endDate $endTime");
}
}
</syntaxhighlight>

=== 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 HM-CC-RT-DN 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

Es gibt auch eine Tastensperre die nur das Umschalten des Modus (Auto, Manuell, Urlaub) am Gerät verhindert. Diese wird mit

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

eingeschaltet. Abschalten geht mit:

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

=== 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 Kommandos. 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 Burst-Modus benötigt mehr Leistung, das heißt die Batterien müssen häufiger gewechselt werden: Der RT muss den Receiver ständig empfangsbereit halten. Außerdem wachen bei jedem Burst wachen ''alle'' Burst-Empfänger auf – egal an wen die Kommunikation gerichtet war.

'''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 Nachrichten 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 Nachricht.

'''ConditionalBurst devices'''

Devices mit abschaltbarem Burst wie z.B. der ''HM-CC-RT-DN'' haben ein Register, ''burstRx'', mit dem das burst-Erwachen eingestellt werden kann.
Sendern, 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 [[HomeMatic HMInfo|HMinfo]] Befehl ''models'' um herauszufinden, 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 [[HomeMatic Type Thermostat#Temperaturlisten|HomeMatic Type Thermostat]]). 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

Ggf noch interne "Fenster-auf" Erkennung abschalten
set <HM-CC-RT-DN>_Clima regSet winOpnMode off

Die virtuelle Tür wird 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.

Sollte es Probleme geben, dass der RT des Öfteren wieder auf seine eigenen Messwerte wechselt, so sollte das Attr cyclicMsgOffset im Virtuellen Kanal beachtet werden. Näheres dazu ist ca. ab {{Link2Forum|Topic=45735|Message=572806|LinkText=hier}} im Forum zu finden.

== Auflistung und Beschreibung der Readings ==

<table cellspacing="0" border="0">
<tr>
<td style="border-top: 2px solid #ffffff; border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Reading</font></td>
<td style="border-top: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Beispielwert</font></td>
<td style="border-top: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Mögliche Werte</font></td>
<td style="border-top: 2px solid #ffffff; border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#A6A6A6"><font face="Arial" size=2 color="#0D0D0D">Beschreibung</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">CommandAccepted</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">yes</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">yes; no</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Letztes Komando akzeptiert (yes/ No)</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-boostPeriod</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">5 min</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1 min bis x min</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Zeit wie lange das Ventil im Boost Modus sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-boostPos</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="0.8" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">80%</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Ventilposition die im Boost Modus gesetzt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-btnNoBckLight</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-dayTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">21 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur die gesetzt werden soll, wenn das Sonnensymbol am Thermostat gedrückt wird. Ebenso wird bei dieser Solltemperatur das Sonnensymbol im Display angezeigt.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-daylightSaveTime</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-decalcTime</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="0.458333333333333" sdnum="1033;1033;H:MM"><font face="Arial" size=2 color="#CCCCCC">11:00</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;1033;H:MM"><font face="Arial" size=2 color="#CCCCCC">00:00 bis 23:59</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Uhrzeit wann die Entkalkungsfahrt durchgeführt werden soll. </font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-decalcWeekday</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Sat</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Mon; Tue; Wed; Thu; Fri; Sat; Sun</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Tag an dem die Entkalkungsfahrt durchgeführt werden soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-modePrioManu</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">all</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">all; ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-modePrioParty</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">all</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">all; ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-nightTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">17 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur die gesetzt werden soll, wenn das Mondsymbol am Thermostat gedrückt wird. Ebenso wird bei dieser Solltemperatur das Mondsymbol im Display angezeigt.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-noMinMax4Manu</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-regAdaptive</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguExtI</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="15" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">15</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguExtP</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="30" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">30</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguExtPstart</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="30" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">30</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguIntI</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="18" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">18</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-reguIntP</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="33" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">33</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-reguIntPstart</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="44" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">44</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-showInfo</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">time</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">date; time</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Zeige Datum oder Urzeit im Sysplay an</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-showWeekday</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Zeige den Wochentag im Display an</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-sign</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-tempMax</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">30.5 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Größte einstellbare Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-tempMin</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">4.5 C</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Kleinste einstellbare Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-tempOffset</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">0.0K</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">0.0 bis ???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-valveErrPos</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="0.15" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">15%</font></td>
<td align="left" valign=middle bgcolor="#333333" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-valveMaxPos</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="1" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">100%</font></td>
<td align="left" valign=middle bgcolor="#111111" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Maximale Ventielstellung die das Thermostat fahren darf.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-valveOffsetRt</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="0" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0%</font></td>
<td align="left" valign=middle bgcolor="#333333" sdnum="1033;0;0%"><font face="Arial" size=2 color="#CCCCCC">0 Bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="52" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnBoost</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Startet nach dem Fensterschließen die Boostfunktion um unabhängig von der Raumtemperatur den Heizkörper eine Zeit x aufzuheizen. (Siehe R-boostPeriod & R-boostPos)</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-winOpnDetFall</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1.4 K</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">0.5 bis 2.5</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Temperatur Sturz zwischen zwei Messungen, die als Fenster offen erkannt werden.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnMode</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">off</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">on; off</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Thermostat soll anhand eines schnellen Temperaturabfalls erkennen, dass das Fenster geöffnet ist.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R-winOpnPeriod</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">15 min</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">1 bis ??? Minuten</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Dauer bis das Signal Fenster offen wieder entfernt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R-winOpnTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">12 C</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R-tempMin bis R-tempMax</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Temperatur die eingestellt werden soll, wenn das Fenster als offen erkannt wird.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="104" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">07:00 20.0 22:30 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">incomplete = Daten werden mit Thermostat abgeglichen<br><br>Zeit/Temperaturangaben siehe Beispiel</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Tages Solltemperaturen abhängig von der Uhrzeit. <br>- Der Beginn um 00:00 ist nicht einzutragen. <br>- Es sind immer Paare einzutragen (Uhrzeit Temperatur). <br>- Der letzte Eintrag muss an jeden Tag 24:00 sein.<br>- Uhrzeiten sind auf halbe Stunden beschränkt. Einträge 08:00 und 08:30 sind gültig. 08:20 ist ungültig.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_1_tempListSun</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">07:00 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_2_tempListMon</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_3_tempListTue</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_4_tempListWed</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_5_tempListThu</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">R_6_tempListFri</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">04:30 20.0 07:00 22.0 12:45 20.0 22:00 22.0 24:00 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Siehe R_0_tempListSat</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">R_tempList_State</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">verified</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">incomplete = Daten werden mit Thermostat abgeglichen<br>verified = Daten sind mit Thermostat abgeglichen</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Aktualisierungsstatus der Wochen Temperatur Einstellungen</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">ValvePosition</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="36" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">36</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">0 bis 100</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">aktuelle Ventielstellung</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="35" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">boostTime</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-<br>1 min bis n min</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Zeit wie lange der Boostmodus noch aktiv ist.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="121" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">controlMode</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">auto</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">auto = Thermostat wird nach der TempListe gesteuert<br>manual = Die eingestellte Temperatur am Thermostat wird nicht verändert, außer bei Verwendung von WinOpn; <br>boost = Thermostat wird in den Boost Modus gesetzt. Siehe R-boostPeriod/Pos<br>day = Thermostat wird auf die eingestellte Tag Temperatur gesetzt (R-dayTemp).<br>night = Thermostat wird auf die eingestellte Nacht Temperatur gesetzt (R-nightTemp).</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Setzt das Thermostat in ein bestimten Modus</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">desired-temp</font></td>
<td align="left" valign=middle bgcolor="#111111" sdval="22" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">22</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">N/A</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Solltemperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">measured-temp</font></td>
<td align="left" valign=middle bgcolor="#333333" sdval="23.2" sdnum="1033;"><font face="Arial" size=2 color="#CCCCCC">23.2</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">N/A</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Isttemperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">partyEnd</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Ende Datum/Zeit indem die Party Temperatur (partyTemp) gesetzt sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">partyStart</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">Start Datum/Zeit indem die Party Temperatur (partyTemp) gesetzt sein soll.</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">partyTemp</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-</font></td>
<td align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">-; 20.0</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Party Temperatur</font></td>
</tr>
<tr>
<td style="border-left: 2px solid #ffffff" height="21" align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">recentStateType</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">ack</font></td>
<td align="left" valign=middle bgcolor="#333333"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
<td style="border-right: 2px solid #ffffff" align="left" valign=middle bgcolor="#333333" sdnum="1033;1033;M/D/YYYY H:MM"><font face="Arial" size=2 color="#CCCCCC">???</font></td>
</tr>
<tr>
<td style="border-bottom: 2px solid #ffffff; border-left: 2px solid #ffffff" height="23" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">state</font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">T: 23.2 desired: 22.0 valve: 36</font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC"><br></font></td>
<td style="border-bottom: 2px solid #ffffff" align="left" valign=middle bgcolor="#111111"><font face="Arial" size=2 color="#CCCCCC">Aktuelle Statusinformation</font></td>
</tr>
</table>

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

=== Der Thermostat heizt über die Solltemperatur hinaus ===
In der Regel ist das ein ganz normales Verhalten, wenn der Thermostat nicht mit einem externen Temperaturfühler oder einem Wandthermostat gepeert ist. In dem Fall muss sich der Thermostat auf den eingebauten Temperatursensor verlassen, der sehr nahe an der Heizung selbst sitzt. Dadurch ist die gemessene Temperatur höher, als sie z.B. in der Raummitte wäre. Der Hersteller hat hier einen mehr oder weniger intelligenten Algorithmus eingebaut, um diesen Effekt zu kompensieren. Das sieht dann so aus, als ob der Thermostat nicht richtig regelt.
Dieses Verhalten kann man im Prinzip nur verhindern, indem man einen externen Temperatursensor oder einen Wandthermostat peert. Wie das geht ist hier beschrieben: [[#Channel (Kanal) 01 _Weather]]. Normalerweise regelt der Thermostat dann genau auf die Solltemperatur.
Ansonsten sollte man sich auch fragen, ob das gezeigte Verhalten vielleicht doch gut genug ist. Dazu platziert man irgendein Thermometer möglichst in der Mitte des Raums und beobachtet den Temperaturverlauf eine Weile. Wenn man dann noch eine Abweichung feststellt, kann es sinnvoll sein, diese mittels des Registers R-tempOffset zu beheben.

== Links ==
* [http://www.eq-3.de/produkt-detail-aktoren/items/homematic-funk-heizkoerperthermostat.html Produktinfo]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-CC-RT-DN_UM_GE_eQ-3_web.pdf Bedienungsanleitung (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/pdb/Funk-Heizkoerperthermostat_105155_Produktdatenblatt_V2.3.pdf Datenblatt (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads/Ventilkompatibilitaeten.pdf Ventil-Kompatibilitätsliste (zur Zeit nicht verfügbar)]
* {{Link2Forum|Topic=14738|LinkText=Forenthema zum Thermostat}}
* {{Link2Forum|Topic=64446|LinkText=Reparatur einer durch mechanischen Stoß von außen abgerissenen Lichtschranke}}

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

EnOcean-FUD14-RS485-Bus-Universal-Dimmaktor

2018-03-04T20:46:23Z

LHBL2003: /* Definition/Anlernvorgang */ Reihenfolge der Durchzuführenden Schritte besser dargestellt. Da ein wichtiger Teil zu leicht überlesen wurde.

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Empfänger, Aktor
|HWCategory=EnOcean
|HWComm=Eltako RS485-Bus
|HWChannels=1 Schaltkanal (unidirektional)
|HWVoltage=230V~
|HWPowerConsumption=Standby: 0,1W
|HWPoweredBy=12VDC
|HWSize=1 Teilungseinheit = 18mm breit, 58mm tief
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

'''EnOcean-FUD14-RS485-Bus-Universal-Dimmaktor''' (FUD14) ist ein Dimmaktor
* für
** Montage auf Hutschiene
* angesteuert (bidirektional) über
** den Eltako RS485-Bus
* für
** 1 Kanal
* je nach Modell für 400W (FUD14/400W) respektive 800W (FUD14/800W, dann 2 TE breit, über Leistungszusätze erweiterbar)

== Features ==
Dimmaktor (bidirektional)

== Hinweise zum Betrieb mit FHEM ==
siehe auch [[EnOcean-Eltako-RS485-Bus]]

=== Definition/Anlernvorgang ===
Da der Aktor bidirektional arbeitet, kann bei auf Position 4 eingestelltem FAM14 und über FGW14 angebundenem FHEM ein Teil der erforderlichen Definition automatisch per autocreate erzeugt werden. Der Dimmer erscheint dann als
EnO_sensor_00000003 oder als EnO_00000003, wobei 00000003 hier exemplarisch für eine vom FAM14 vergebene Busadresse steht. Die Busadresse 3 findet man im PCT14 als "Adr. 3, V3.10..." wieder. Um zum Einen eine korrekte Statusausgabe des Dimmers zu erhalten und zum Anderen den Dimmer auch über FHEM schalten zu können,
müssen anschließend noch einige Attribute manuell gesetzt und schließlich noch FHEM als Schalter in den Dimmaktor eingelernt werden.

Folgende Schritte sind durchzuführen:

* Die Attribute gwCmd, subType, subDef, und manufID anlegen (stateFormat und webCmd sind optional)

attr EnO_sensor_00000003 gwCmd dimming
attr EnO_sensor_00000003 subType gateway
attr EnO_sensor_00000003 subDef 01000003
attr EnO_sensor_00000003 manufID 00D
attr EnO_sensor_00000003 model Eltako_TF # nur bei Aktoren mit Produktionswoche ab ca. Mitte 2016 ({{Link2Forum|Topic=57591|Message=490825}})
attr EnO_sensor_00000003 webCmd on:off:dim

* Am Aktor anlernen
** Oberer Funktions-Drehschalter: auf PCT einstellen (Rechtsanschlag)
** Mittlerer Funktions-Drehschalter: Stellung „LRN“
** FHEM Eingabefeld: „set <name> teach“, <Enter>
** #Beispiel: set EnO_sensor_00000003 teach
** Nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration|fhem.cfg]], 00000003 ist hier die vom FAM14 vergeben ID für den FUD14, 01000003 ist eine frei gewählte, einzigartige ID, die von FHEM als Sende-ID für die Schaltkommandos verwendet wird:
define EnO_sensor_00000003 EnOcean 00000003 # Wird durch autocreate von FHEM erzeugt
attr EnO_sensor_00000003 gwCmd dimming
attr EnO_sensor_00000003 subType gateway
attr EnO_sensor_00000003 subDef 01000003
attr EnO_sensor_00000003 manufID 00D
attr EnO_sensor_00000003 model Eltako_TF # nur bei Aktoren mit Produktionswoche ab ca. Mitte 2016 ({{Link2Forum|Topic=57591|Message=490825}})
attr EnO_sensor_00000003 webCmd on:off:dim

== Einsatzbeispiel ==
=== Fahrzeit mit höherer Auflösung senden ===
FHEM sendet die Fahrzeit im Standard mit einer Auflösung von 1 s. Bei neueren Eltako Jalousieaktoren (FSB14 ab Version 2.1) kann die Fahrzeit mit einer Auflösung von 1/10 s gesendet werden. Um die Fahrzeit mit höherer Genauigkeit innerhalb von FHEM zu berechnen und zu senden, ist das Attribut <code>settingAccuracy</code> auf <code>high</code> zu setzen. Die Eingabe der Fahrzeit oder der Position erfolgt weiterhin ohne Dezimalstellen!

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/BR14_datenblatt_FUD14.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FUD14_30014005-2_dt.pdf PDF]

[[Kategorie:EnOcean Components]]
[[Kategorie:Dimmer]]

Serial/Netzwerk-RS485-Adapter

2018-02-17T19:57:01Z

LHBL2003: /* Bekannte Probleme */

== Vorbemerkungen ==
Alternativ zum [[HomeMatic_Wired_RS485_LAN_Gateway]], können einfache Serial/Netzwerk-RS485-Adaptern für die Kommunikation von FHEM zu HomeMatic-Wired-Geräten eingesetzt werden.
In diesem Artikel werden sowohl RS232-RS485-Adapter, USB-RS485-Adapter als auch Netzwerk-RS485-Adapter als Serial-RS485-Adaptern bezeichnet, denn in jedem Fall wird ein serieller Datenstrom an den RS485 Transceiver weitergeleitet.

Da diese hier beschriebenen Interfaces keine "Intelligenz" besitzen, also die Daten lediglich auf den RS485-Bus umsetzen, wird zur Ansteuerung noch der ''hm485d.pl''-Daemon benötigt. Dieser Prozess setzt die RAW-Befehle in das HomeMatic-Wired-Protokoll um. Der hm485d kann dabei transparent im Hintergrund arbeiten.

=== Liste der aktuell getesteten Adapter / Schnittstellen (bitte ggf. ergänzen) ===
* DIGITUS DA-70157: USB-Serial Adapter mit RS485 Schnittstelle. Dieser Adapter wird derzeit wahrscheinlich am häufigsten und erfolgreichsten zusammen mit FHEM eingesetzt. In ein paar Fällen gab es jedoch Probleme mit unvollständigen Lötstellen oder anderen Fabrikationsfehlern. Dies kann sich darin äußern, dass FHEM überhaupt keine Kommunikation aufbauen kann oder entweder nur senden oder nur empfangen kann. Bevor man dann lange herumprobiert ist es in den meisten Fällen besser, sich einen zweiten Adapter zuzulegen. [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187]
* Eigenbau basierend auf FT232RL und Max485 {{Link2Forum|Topic=64947|Message=562328}}
* Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module [http://www.wiznet.io/product-item/wiz108sr/]
* Wiznet - {{Link2Forum|Topic=14096|LinkText=WIZ108SR im Hutschienengehäuse}}
* USB - RS485 Konverter von Sertronics [https://www.sertronics-shop.de/Raspberry-PiCo/Raspberry-Pi/KabelAdapter/USB-KabelAdapter/USB-RS485-Konverter/] Dieser Adapter wurde zwar erfolgreich getestet, ist aber trotzdem nicht zu empfehlen. Der Adapter beruht auf einem CH340 oder CH341 Chip und funktioniert im Gegensatz zur Beschreibung auf der Herstellerseite mit Raspbian nur nach der Installation eines neuen Treibers. Außerdem fehlen den CH34x-Chips die Seriennummer, was Probleme bereiten kann, wenn man mehrere serielle Schnittstellen hat (das schließt auch verschiedene Billig-Arduino-Clones ein). Des Weiteren gibt es keinen GND-Anschluss, weswegen der Busabschlusswiderstand nicht korrekt angeschlossen werden kann. Details dazu wurden hier diskutiert: {{Link2Forum|Topic=68681|Message=601863}}

== Einbindung in FHEM ==
Zunächst muss man das Modul HM485_LAN installiert haben.
Siehe [https://forum.fhem.de/index.php?topic=19312.0]

Zum Einbinden des Gateways braucht man ein HM485_LAN-Device mit folgender Definition:

define hm485 HM485_LAN localhost:2000
attr hm485 hmwId 00000001
attr hm485 HM485d_device <SerialDevice>
attr hm485 HM485d_bind 1

Der Name "hm485" kann frei vergeben werden.
Bei <SerialDevice> muss der Gerätename angegeben werden unter dem das serielle Device anzusprechen ist.

'''Beispiele:'''
# Serieller USB-RS485-Adapter
attr hm485 HM485d_device /dev/ttyUSB0

# Netzwerk-RS485-Adapter
attr hm485 HM485d_device 192.168.1.15:5000

'''Gerätename nach einstecken des USB Dongels von DIGITUS DA-70157 unter Linux finden:'''

Im Verzeichnis /var/log/ in der Datei "messages" und "syslog" wird nach anstecken des Dongels folgender Eintrag geschrieben
Feb 16 20:16:09 raspberrypi kernel: [72956.525494] usb 1-1.3: Detected FT232RL
Feb 16 20:16:09 raspberrypi kernel: [72956.526514] usb 1-1.3: FTDI USB Serial Device converter now attached to ttyUSB0
In diesem Fall ist der Name "ttyUSB0" der Gerätename und muss für RS485 Adapter mit dem Pfad zusammengebaut werden: /dev/ttyUSB0

HM485d_bind 1 sorgt dafür, dass der hm485d beim FHEM-Start automatisch mit gestartet wird und durch FHEM auch gesteuert, also auch beendet werden kann.

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

Zu beachten ist auch, dass der hm485d '''gleichzeitig''' nur eine Netzwerkverbindung erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* '''hmwId''' Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* '''do_not_notify''' FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.
* '''HM485d_bind''' Startet den hm485d automatisch beim Start von FHEM und ermöglicht FHEM zudem die Prozesskontrolle
* '''HM485d_startTimeout''' Manchmal, z.B. auf langsameren Geräten wie der FritzBox oder dem Raspberry Pi, ist es erforderlich den hm485d verzögert zu starten. Hier kann die Verzögerung in Sekunden angegeben werden.
* '''HM485d_device''' Das serielle Gerät zum Interface (siehe Beispiel oben).
* '''HM485d_serialNumber''' Die Seriennummer die der hm485d an die Zentrale (FHEM) melden soll.
* '''HM485d_logfile''' Der hm485d kann ein eigenes Logfile schreiben. Hier kann dafür ein Dateiname angegeben werden.
* '''HM485d_detatch''' Wenn der hm485d mit FHEM zusammen gestartet wird (siehe HM485d_bind) so kann der Prozess hier von FHEM entkoppelt werden. Der Prozess wird dann auch nicht zusammen mit FHEM beendet.
* '''HM485d_logVerbose''' Der Loglevel vom hm485d.

Die folgenden drei Attribute können verwendet werden, wenn der hm485d über einen einfachen UART ohne Flusskontrolle z.B. über den UART des Raspberry Pi, an einen RS485 Transceiver angeschlossen wird. Dafür müssen ggf. GPIO-Pins zur Steuerung des RS485 Transceivers (Senden/Empfangen) definiert werden:
* '''HM485d_gpioTxenInit''' Shell-Befehl zum Initialisieren des benutzten GPIO-Pins für die Sendekontrolle
* '''HM485d_gpioTxenCmd0''' Shell-Befehl um den Sende-GPIO-Pin zurück zu setzen
* '''HM485d_gpioTxenCmd1''' Shell-Befehl um den Sende-GPIO-Pin zu setzen

'''Hinweis'''
Da auch der hm485d sich noch in Entwicklung befindet, ist es möglich dass es in einigen Fällen noch zu Fehlverhalten kommen kann.

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

=== Discovery ===
Mit dem discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
Dieser Befehl funktioniert allerdings NICHT mit dem Original eq3-Lan-Gateway!

set HM485_LAN discovery start

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

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

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

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

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

'''Funktionale Beispiele:'''
# Rollladenaktor öffnen
set HM485_LAN RAW 01234567 98 00000001 7802C8

# Rollladenaktor stoppen
set HM485_LAN RAW 01234567 98 00000001 7802C9

# Rollladenaktor schließen
set HM485_LAN RAW 01234567 98 00000001 780200

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
set HM485_LAN RAW 01234567 98 00000001 730003FF

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
set HM485_LAN RAW 01234567 98 00000001 73000000

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

==Bekannte Probleme==
===Disconnects mit WIZ108SR===
Bei Verwendung eines auf WIZ108SR (oder ähnlich) basierenden Adapters kann es zu regelmäßigen disconnects kommen. Im Log erscheint dann in etwa Folgendes:
2015.09.13 20:17:11.809 2: HM485d: DISCONNECTED
2015.09.13 20:17:11.812 2: HM485d: SERIAL connected to device 192.168.nnn.nnn:pppp
2015.09.13 20:17:11.813 2: HM485d: RECONNECTED
Das Problem lässt sich in der Regel lösen, indem man in der Konfiguration des WIZ108SR den "Inactivity Timer" auf 0 setzt. Siehe auch diesen {{Link2Forum|Topic=41054|LinkText=Thread im Forum}}.

===Disconnects mit DIGITUS DA-70157===
Sollte nach der Erstkonfiguration der Status Disconnected erscheinen, so hilft evtl. ein einfacher FHEM neustart um den Status opened zu erhalten.

== Links ==
* [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187 DIGITUS DA-70157: USB-Serial Adapter]
* [http://www.wiznet.io/product-item/wiz108sr/ Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module]
* {{Link2Forum|Topic=14096|LinkText=Wiznet - WIZ108SR im Hutschienengehäuse}}
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

Serial/Netzwerk-RS485-Adapter

2018-02-17T19:42:26Z

LHBL2003: /* Einbindung in FHEM */

== Vorbemerkungen ==
Alternativ zum [[HomeMatic_Wired_RS485_LAN_Gateway]], können einfache Serial/Netzwerk-RS485-Adaptern für die Kommunikation von FHEM zu HomeMatic-Wired-Geräten eingesetzt werden.
In diesem Artikel werden sowohl RS232-RS485-Adapter, USB-RS485-Adapter als auch Netzwerk-RS485-Adapter als Serial-RS485-Adaptern bezeichnet, denn in jedem Fall wird ein serieller Datenstrom an den RS485 Transceiver weitergeleitet.

Da diese hier beschriebenen Interfaces keine "Intelligenz" besitzen, also die Daten lediglich auf den RS485-Bus umsetzen, wird zur Ansteuerung noch der ''hm485d.pl''-Daemon benötigt. Dieser Prozess setzt die RAW-Befehle in das HomeMatic-Wired-Protokoll um. Der hm485d kann dabei transparent im Hintergrund arbeiten.

=== Liste der aktuell getesteten Adapter / Schnittstellen (bitte ggf. ergänzen) ===
* DIGITUS DA-70157: USB-Serial Adapter mit RS485 Schnittstelle. Dieser Adapter wird derzeit wahrscheinlich am häufigsten und erfolgreichsten zusammen mit FHEM eingesetzt. In ein paar Fällen gab es jedoch Probleme mit unvollständigen Lötstellen oder anderen Fabrikationsfehlern. Dies kann sich darin äußern, dass FHEM überhaupt keine Kommunikation aufbauen kann oder entweder nur senden oder nur empfangen kann. Bevor man dann lange herumprobiert ist es in den meisten Fällen besser, sich einen zweiten Adapter zuzulegen. [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187]
* Eigenbau basierend auf FT232RL und Max485 {{Link2Forum|Topic=64947|Message=562328}}
* Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module [http://www.wiznet.io/product-item/wiz108sr/]
* Wiznet - {{Link2Forum|Topic=14096|LinkText=WIZ108SR im Hutschienengehäuse}}
* USB - RS485 Konverter von Sertronics [https://www.sertronics-shop.de/Raspberry-PiCo/Raspberry-Pi/KabelAdapter/USB-KabelAdapter/USB-RS485-Konverter/] Dieser Adapter wurde zwar erfolgreich getestet, ist aber trotzdem nicht zu empfehlen. Der Adapter beruht auf einem CH340 oder CH341 Chip und funktioniert im Gegensatz zur Beschreibung auf der Herstellerseite mit Raspbian nur nach der Installation eines neuen Treibers. Außerdem fehlen den CH34x-Chips die Seriennummer, was Probleme bereiten kann, wenn man mehrere serielle Schnittstellen hat (das schließt auch verschiedene Billig-Arduino-Clones ein). Des Weiteren gibt es keinen GND-Anschluss, weswegen der Busabschlusswiderstand nicht korrekt angeschlossen werden kann. Details dazu wurden hier diskutiert: {{Link2Forum|Topic=68681|Message=601863}}

== Einbindung in FHEM ==
Zunächst muss man das Modul HM485_LAN installiert haben.
Siehe [https://forum.fhem.de/index.php?topic=19312.0]

Zum Einbinden des Gateways braucht man ein HM485_LAN-Device mit folgender Definition:

define hm485 HM485_LAN localhost:2000
attr hm485 hmwId 00000001
attr hm485 HM485d_device <SerialDevice>
attr hm485 HM485d_bind 1

Der Name "hm485" kann frei vergeben werden.
Bei <SerialDevice> muss der Gerätename angegeben werden unter dem das serielle Device anzusprechen ist.

'''Beispiele:'''
# Serieller USB-RS485-Adapter
attr hm485 HM485d_device /dev/ttyUSB0

# Netzwerk-RS485-Adapter
attr hm485 HM485d_device 192.168.1.15:5000

'''Gerätename nach einstecken des USB Dongels von DIGITUS DA-70157 unter Linux finden:'''

Im Verzeichnis /var/log/ in der Datei "messages" und "syslog" wird nach anstecken des Dongels folgender Eintrag geschrieben
Feb 16 20:16:09 raspberrypi kernel: [72956.525494] usb 1-1.3: Detected FT232RL
Feb 16 20:16:09 raspberrypi kernel: [72956.526514] usb 1-1.3: FTDI USB Serial Device converter now attached to ttyUSB0
In diesem Fall ist der Name "ttyUSB0" der Gerätename und muss für RS485 Adapter mit dem Pfad zusammengebaut werden: /dev/ttyUSB0

HM485d_bind 1 sorgt dafür, dass der hm485d beim FHEM-Start automatisch mit gestartet wird und durch FHEM auch gesteuert, also auch beendet werden kann.

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

Zu beachten ist auch, dass der hm485d '''gleichzeitig''' nur eine Netzwerkverbindung erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* '''hmwId''' Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* '''do_not_notify''' FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.
* '''HM485d_bind''' Startet den hm485d automatisch beim Start von FHEM und ermöglicht FHEM zudem die Prozesskontrolle
* '''HM485d_startTimeout''' Manchmal, z.B. auf langsameren Geräten wie der FritzBox oder dem Raspberry Pi, ist es erforderlich den hm485d verzögert zu starten. Hier kann die Verzögerung in Sekunden angegeben werden.
* '''HM485d_device''' Das serielle Gerät zum Interface (siehe Beispiel oben).
* '''HM485d_serialNumber''' Die Seriennummer die der hm485d an die Zentrale (FHEM) melden soll.
* '''HM485d_logfile''' Der hm485d kann ein eigenes Logfile schreiben. Hier kann dafür ein Dateiname angegeben werden.
* '''HM485d_detatch''' Wenn der hm485d mit FHEM zusammen gestartet wird (siehe HM485d_bind) so kann der Prozess hier von FHEM entkoppelt werden. Der Prozess wird dann auch nicht zusammen mit FHEM beendet.
* '''HM485d_logVerbose''' Der Loglevel vom hm485d.

Die folgenden drei Attribute können verwendet werden, wenn der hm485d über einen einfachen UART ohne Flusskontrolle z.B. über den UART des Raspberry Pi, an einen RS485 Transceiver angeschlossen wird. Dafür müssen ggf. GPIO-Pins zur Steuerung des RS485 Transceivers (Senden/Empfangen) definiert werden:
* '''HM485d_gpioTxenInit''' Shell-Befehl zum Initialisieren des benutzten GPIO-Pins für die Sendekontrolle
* '''HM485d_gpioTxenCmd0''' Shell-Befehl um den Sende-GPIO-Pin zurück zu setzen
* '''HM485d_gpioTxenCmd1''' Shell-Befehl um den Sende-GPIO-Pin zu setzen

'''Hinweis'''
Da auch der hm485d sich noch in Entwicklung befindet, ist es möglich dass es in einigen Fällen noch zu Fehlverhalten kommen kann.

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

=== Discovery ===
Mit dem discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
Dieser Befehl funktioniert allerdings NICHT mit dem Original eq3-Lan-Gateway!

set HM485_LAN discovery start

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

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

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

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

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

'''Funktionale Beispiele:'''
# Rollladenaktor öffnen
set HM485_LAN RAW 01234567 98 00000001 7802C8

# Rollladenaktor stoppen
set HM485_LAN RAW 01234567 98 00000001 7802C9

# Rollladenaktor schließen
set HM485_LAN RAW 01234567 98 00000001 780200

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
set HM485_LAN RAW 01234567 98 00000001 730003FF

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
set HM485_LAN RAW 01234567 98 00000001 73000000

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

==Bekannte Probleme==
===Disconnects mit WIZ108SR===
Bei Verwendung eines auf WIZ108SR (oder ähnlich) basierenden Adapters kann es zu regelmäßigen disconnects kommen. Im Log erscheint dann in etwa Folgendes:
2015.09.13 20:17:11.809 2: HM485d: DISCONNECTED
2015.09.13 20:17:11.812 2: HM485d: SERIAL connected to device 192.168.nnn.nnn:pppp
2015.09.13 20:17:11.813 2: HM485d: RECONNECTED
Das Problem lässt sich in der Regel lösen, indem man in der Konfiguration des WIZ108SR den "Inactivity Timer" auf 0 setzt. Siehe auch diesen {{Link2Forum|Topic=41054|LinkText=Thread im Forum}}.

== Links ==
* [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187 DIGITUS DA-70157: USB-Serial Adapter]
* [http://www.wiznet.io/product-item/wiz108sr/ Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module]
* {{Link2Forum|Topic=14096|LinkText=Wiznet - WIZ108SR im Hutschienengehäuse}}
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

Serial/Netzwerk-RS485-Adapter

2018-02-16T21:46:15Z

LHBL2003: Nochmalige Anpassung Gerätename für DIGITUS DA-70157 unter Linux finden.

== Vorbemerkungen ==
Alternativ zum [[HomeMatic_Wired_RS485_LAN_Gateway]], können einfache Serial/Netzwerk-RS485-Adaptern für die Kommunikation von FHEM zu HomeMatic-Wired-Geräten eingesetzt werden.
In diesem Artikel werden sowohl RS232-RS485-Adapter, USB-RS485-Adapter als auch Netzwerk-RS485-Adapter als Serial-RS485-Adaptern bezeichnet, denn in jedem Fall wird ein serieller Datenstrom an den RS485 Transceiver weitergeleitet.

Da diese hier beschriebenen Interfaces keine "Intelligenz" besitzen, also die Daten lediglich auf den RS485-Bus umsetzen, wird zur Ansteuerung noch der ''hm485d.pl''-Daemon benötigt. Dieser Prozess setzt die RAW-Befehle in das HomeMatic-Wired-Protokoll um. Der hm485d kann dabei transparent im Hintergrund arbeiten.

=== Liste der aktuell getesteten Adapter / Schnittstellen (bitte ggf. ergänzen) ===
* DIGITUS DA-70157: USB-Serial Adapter mit RS485 Schnittstelle. Dieser Adapter wird derzeit wahrscheinlich am häufigsten und erfolgreichsten zusammen mit FHEM eingesetzt. In ein paar Fällen gab es jedoch Probleme mit unvollständigen Lötstellen oder anderen Fabrikationsfehlern. Dies kann sich darin äußern, dass FHEM überhaupt keine Kommunikation aufbauen kann oder entweder nur senden oder nur empfangen kann. Bevor man dann lange herumprobiert ist es in den meisten Fällen besser, sich einen zweiten Adapter zuzulegen. [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187]
* Eigenbau basierend auf FT232RL und Max485 {{Link2Forum|Topic=64947|Message=562328}}
* Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module [http://www.wiznet.io/product-item/wiz108sr/]
* Wiznet - {{Link2Forum|Topic=14096|LinkText=WIZ108SR im Hutschienengehäuse}}
* USB - RS485 Konverter von Sertronics [https://www.sertronics-shop.de/Raspberry-PiCo/Raspberry-Pi/KabelAdapter/USB-KabelAdapter/USB-RS485-Konverter/] Dieser Adapter wurde zwar erfolgreich getestet, ist aber trotzdem nicht zu empfehlen. Der Adapter beruht auf einem CH340 oder CH341 Chip und funktioniert im Gegensatz zur Beschreibung auf der Herstellerseite mit Raspbian nur nach der Installation eines neuen Treibers. Außerdem fehlen den CH34x-Chips die Seriennummer, was Probleme bereiten kann, wenn man mehrere serielle Schnittstellen hat (das schließt auch verschiedene Billig-Arduino-Clones ein). Des Weiteren gibt es keinen GND-Anschluss, weswegen der Busabschlusswiderstand nicht korrekt angeschlossen werden kann. Details dazu wurden hier diskutiert: {{Link2Forum|Topic=68681|Message=601863}}

== Einbindung in FHEM ==
Zunächst muss man das Modul HM485_LAN installiert haben.
Siehe [https://forum.fhem.de/index.php?topic=19312.0]

Zum Einbinden des Gateways braucht man ein HM485_LAN-Device mit folgender Definition:

define hm485 HM485_LAN localhost:2000
attr HM485_LAN hmwId 00000001
attr HM485_LAN HM485d_device <SerialDevice>
attr HM485_LAN HM485d_bind 1

Der Name "HM485_LAN" kann frei vergeben werden.
Bei <SerialDevice> muss der Gerätename angegeben werden unter dem das serielle Device anzusprechen ist.

'''Beispiele:'''
# Serieller USB-RS485-Adapter
attr HM485_LAN HM485d_device /dev/ttyUSB0

# Netzwerk-RS485-Adapter
attr HM485_LAN HM485d_device 192.168.1.15:5000

# Serieller DIGITUS DA-70157
attr HM485_LAN HM485d_device FT232RL

'''Gerätename nach einstecken des USB Dongels von DIGITUS DA-70157 unter Linux finden:'''

Im Verzeichnis /var/log/ in der Datei messages und syslog wird nach anstecken des Dongels folgender Eintrag geschrieben
Feb 16 20:16:09 raspberrypi kernel: [72956.525494] usb 1-1.3: Detected FT232RL
Feb 16 20:16:09 raspberrypi kernel: [72956.526514] usb 1-1.3: FTDI USB Serial Device converter now attached to ttyUSB0
In diesem Fall ist der Name "FT232RL" der Gerätename

HM485d_bind 1 sorgt dafür, dass der hm485d beim FHEM-Start automatisch mit gestartet wird und durch FHEM auch gesteuert, also auch beendet werden kann.

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

Zu beachten ist auch, dass der hm485d '''gleichzeitig''' nur eine Netzwerkverbindung erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* '''hmwId''' Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* '''do_not_notify''' FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.
* '''HM485d_bind''' Startet den hm485d automatisch beim Start von FHEM und ermöglicht FHEM zudem die Prozesskontrolle
* '''HM485d_startTimeout''' Manchmal, z.B. auf langsameren Geräten wie der FritzBox oder dem Raspberry Pi, ist es erforderlich den hm485d verzögert zu starten. Hier kann die Verzögerung in Sekunden angegeben werden.
* '''HM485d_device''' Das serielle Gerät zum Interface (siehe Beispiel oben).
* '''HM485d_serialNumber''' Die Seriennummer die der hm485d an die Zentrale (FHEM) melden soll.
* '''HM485d_logfile''' Der hm485d kann ein eigenes Logfile schreiben. Hier kann dafür ein Dateiname angegeben werden.
* '''HM485d_detatch''' Wenn der hm485d mit FHEM zusammen gestartet wird (siehe HM485d_bind) so kann der Prozess hier von FHEM entkoppelt werden. Der Prozess wird dann auch nicht zusammen mit FHEM beendet.
* '''HM485d_logVerbose''' Der Loglevel vom hm485d.

Die folgenden drei Attribute können verwendet werden, wenn der hm485d über einen einfachen UART ohne Flusskontrolle z.B. über den UART des Raspberry Pi, an einen RS485 Transceiver angeschlossen wird. Dafür müssen ggf. GPIO-Pins zur Steuerung des RS485 Transceivers (Senden/Empfangen) definiert werden:
* '''HM485d_gpioTxenInit''' Shell-Befehl zum Initialisieren des benutzten GPIO-Pins für die Sendekontrolle
* '''HM485d_gpioTxenCmd0''' Shell-Befehl um den Sende-GPIO-Pin zurück zu setzen
* '''HM485d_gpioTxenCmd1''' Shell-Befehl um den Sende-GPIO-Pin zu setzen

'''Hinweis'''
Da auch der hm485d sich noch in Entwicklung befindet, ist es möglich dass es in einigen Fällen noch zu Fehlverhalten kommen kann.

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

=== Discovery ===
Mit dem discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
Dieser Befehl funktioniert allerdings NICHT mit dem Original eq3-Lan-Gateway!

set HM485_LAN discovery start

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

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

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

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

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

'''Funktionale Beispiele:'''
# Rollladenaktor öffnen
set HM485_LAN RAW 01234567 98 00000001 7802C8

# Rollladenaktor stoppen
set HM485_LAN RAW 01234567 98 00000001 7802C9

# Rollladenaktor schließen
set HM485_LAN RAW 01234567 98 00000001 780200

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
set HM485_LAN RAW 01234567 98 00000001 730003FF

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
set HM485_LAN RAW 01234567 98 00000001 73000000

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

==Bekannte Probleme==
===Disconnects mit WIZ108SR===
Bei Verwendung eines auf WIZ108SR (oder ähnlich) basierenden Adapters kann es zu regelmäßigen disconnects kommen. Im Log erscheint dann in etwa Folgendes:
2015.09.13 20:17:11.809 2: HM485d: DISCONNECTED
2015.09.13 20:17:11.812 2: HM485d: SERIAL connected to device 192.168.nnn.nnn:pppp
2015.09.13 20:17:11.813 2: HM485d: RECONNECTED
Das Problem lässt sich in der Regel lösen, indem man in der Konfiguration des WIZ108SR den "Inactivity Timer" auf 0 setzt. Siehe auch diesen {{Link2Forum|Topic=41054|LinkText=Thread im Forum}}.

== Links ==
* [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187 DIGITUS DA-70157: USB-Serial Adapter]
* [http://www.wiznet.io/product-item/wiz108sr/ Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module]
* {{Link2Forum|Topic=14096|LinkText=Wiznet - WIZ108SR im Hutschienengehäuse}}
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

Serial/Netzwerk-RS485-Adapter

2018-02-16T21:29:57Z

LHBL2003: Installation HM485_LAN Modul

== Vorbemerkungen ==
Alternativ zum [[HomeMatic_Wired_RS485_LAN_Gateway]], können einfache Serial/Netzwerk-RS485-Adaptern für die Kommunikation von FHEM zu HomeMatic-Wired-Geräten eingesetzt werden.
In diesem Artikel werden sowohl RS232-RS485-Adapter, USB-RS485-Adapter als auch Netzwerk-RS485-Adapter als Serial-RS485-Adaptern bezeichnet, denn in jedem Fall wird ein serieller Datenstrom an den RS485 Transceiver weitergeleitet.

Da diese hier beschriebenen Interfaces keine "Intelligenz" besitzen, also die Daten lediglich auf den RS485-Bus umsetzen, wird zur Ansteuerung noch der ''hm485d.pl''-Daemon benötigt. Dieser Prozess setzt die RAW-Befehle in das HomeMatic-Wired-Protokoll um. Der hm485d kann dabei transparent im Hintergrund arbeiten.

=== Liste der aktuell getesteten Adapter / Schnittstellen (bitte ggf. ergänzen) ===
* DIGITUS DA-70157: USB-Serial Adapter mit RS485 Schnittstelle. Dieser Adapter wird derzeit wahrscheinlich am häufigsten und erfolgreichsten zusammen mit FHEM eingesetzt. In ein paar Fällen gab es jedoch Probleme mit unvollständigen Lötstellen oder anderen Fabrikationsfehlern. Dies kann sich darin äußern, dass FHEM überhaupt keine Kommunikation aufbauen kann oder entweder nur senden oder nur empfangen kann. Bevor man dann lange herumprobiert ist es in den meisten Fällen besser, sich einen zweiten Adapter zuzulegen. [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187]
* Eigenbau basierend auf FT232RL und Max485 {{Link2Forum|Topic=64947|Message=562328}}
* Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module [http://www.wiznet.io/product-item/wiz108sr/]
* Wiznet - {{Link2Forum|Topic=14096|LinkText=WIZ108SR im Hutschienengehäuse}}
* USB - RS485 Konverter von Sertronics [https://www.sertronics-shop.de/Raspberry-PiCo/Raspberry-Pi/KabelAdapter/USB-KabelAdapter/USB-RS485-Konverter/] Dieser Adapter wurde zwar erfolgreich getestet, ist aber trotzdem nicht zu empfehlen. Der Adapter beruht auf einem CH340 oder CH341 Chip und funktioniert im Gegensatz zur Beschreibung auf der Herstellerseite mit Raspbian nur nach der Installation eines neuen Treibers. Außerdem fehlen den CH34x-Chips die Seriennummer, was Probleme bereiten kann, wenn man mehrere serielle Schnittstellen hat (das schließt auch verschiedene Billig-Arduino-Clones ein). Des Weiteren gibt es keinen GND-Anschluss, weswegen der Busabschlusswiderstand nicht korrekt angeschlossen werden kann. Details dazu wurden hier diskutiert: {{Link2Forum|Topic=68681|Message=601863}}

== Einbindung in FHEM ==
Zunächst muss man das Modul HM485_LAN installiert haben.
Siehe [https://forum.fhem.de/index.php?topic=19312.0]

Zum Einbinden des Gateways braucht man ein HM485_LAN-Device mit folgender Definition:

define hm485 HM485_LAN localhost:2000
attr hm485 hmwId 00000001
attr hm485 HM485d_device <SerialDevice>
attr hm485 HM485d_bind 1

Der Name "hm485" kann frei vergeben werden.
Bei <SerialDevice> muss der Gerätename angegeben werden unter dem das serielle Device anzusprechen ist.

'''Beispiele:'''
# Serieller USB-RS485-Adapter
attr HM485_LAN HM485d_device /dev/ttyUSB0

# Netzwerk-RS485-Adapter
attr HM485_LAN HM485d_device 192.168.1.15:5000

'''Beispiele:'''
Gerätename nach einstecken des USB Dongels von DIGITUS DA-70157 unter Linux finden:
ls -al /dev/serial/by-id
Ergebnis:
total 0
drwxr-xr-x 2 root root 60 Feb 16 20:16 .
drwxr-xr-x 4 root root 80 Feb 16 20:16 ..
lrwxrwxrwx 1 root root 13 Feb 16 20:16 usb-FTDI_FT232R_USB_UART_AO000KS2-if00-port0 -> ../../ttyUSB0
Das "ttyUSB0" ist in dem Fall der Gerätename und sollte dann unter folgenden Pfad gefunden werden.
cd /dev/
ls

HM485d_bind 1 sorgt dafür, dass der hm485d beim FHEM-Start automatisch mit gestartet wird und durch FHEM auch gesteuert, also auch beendet werden kann.

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

Zu beachten ist auch, dass der hm485d '''gleichzeitig''' nur eine Netzwerkverbindung erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* '''hmwId''' Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* '''do_not_notify''' FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.
* '''HM485d_bind''' Startet den hm485d automatisch beim Start von FHEM und ermöglicht FHEM zudem die Prozesskontrolle
* '''HM485d_startTimeout''' Manchmal, z.B. auf langsameren Geräten wie der FritzBox oder dem Raspberry Pi, ist es erforderlich den hm485d verzögert zu starten. Hier kann die Verzögerung in Sekunden angegeben werden.
* '''HM485d_device''' Das serielle Gerät zum Interface (siehe Beispiel oben).
* '''HM485d_serialNumber''' Die Seriennummer die der hm485d an die Zentrale (FHEM) melden soll.
* '''HM485d_logfile''' Der hm485d kann ein eigenes Logfile schreiben. Hier kann dafür ein Dateiname angegeben werden.
* '''HM485d_detatch''' Wenn der hm485d mit FHEM zusammen gestartet wird (siehe HM485d_bind) so kann der Prozess hier von FHEM entkoppelt werden. Der Prozess wird dann auch nicht zusammen mit FHEM beendet.
* '''HM485d_logVerbose''' Der Loglevel vom hm485d.

Die folgenden drei Attribute können verwendet werden, wenn der hm485d über einen einfachen UART ohne Flusskontrolle z.B. über den UART des Raspberry Pi, an einen RS485 Transceiver angeschlossen wird. Dafür müssen ggf. GPIO-Pins zur Steuerung des RS485 Transceivers (Senden/Empfangen) definiert werden:
* '''HM485d_gpioTxenInit''' Shell-Befehl zum Initialisieren des benutzten GPIO-Pins für die Sendekontrolle
* '''HM485d_gpioTxenCmd0''' Shell-Befehl um den Sende-GPIO-Pin zurück zu setzen
* '''HM485d_gpioTxenCmd1''' Shell-Befehl um den Sende-GPIO-Pin zu setzen

'''Hinweis'''
Da auch der hm485d sich noch in Entwicklung befindet, ist es möglich dass es in einigen Fällen noch zu Fehlverhalten kommen kann.

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

=== Discovery ===
Mit dem discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
Dieser Befehl funktioniert allerdings NICHT mit dem Original eq3-Lan-Gateway!

set HM485_LAN discovery start

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

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

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

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

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

'''Funktionale Beispiele:'''
# Rollladenaktor öffnen
set HM485_LAN RAW 01234567 98 00000001 7802C8

# Rollladenaktor stoppen
set HM485_LAN RAW 01234567 98 00000001 7802C9

# Rollladenaktor schließen
set HM485_LAN RAW 01234567 98 00000001 780200

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
set HM485_LAN RAW 01234567 98 00000001 730003FF

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
set HM485_LAN RAW 01234567 98 00000001 73000000

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

==Bekannte Probleme==
===Disconnects mit WIZ108SR===
Bei Verwendung eines auf WIZ108SR (oder ähnlich) basierenden Adapters kann es zu regelmäßigen disconnects kommen. Im Log erscheint dann in etwa Folgendes:
2015.09.13 20:17:11.809 2: HM485d: DISCONNECTED
2015.09.13 20:17:11.812 2: HM485d: SERIAL connected to device 192.168.nnn.nnn:pppp
2015.09.13 20:17:11.813 2: HM485d: RECONNECTED
Das Problem lässt sich in der Regel lösen, indem man in der Konfiguration des WIZ108SR den "Inactivity Timer" auf 0 setzt. Siehe auch diesen {{Link2Forum|Topic=41054|LinkText=Thread im Forum}}.

== Links ==
* [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187 DIGITUS DA-70157: USB-Serial Adapter]
* [http://www.wiznet.io/product-item/wiz108sr/ Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module]
* {{Link2Forum|Topic=14096|LinkText=Wiznet - WIZ108SR im Hutschienengehäuse}}
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

Serial/Netzwerk-RS485-Adapter

2018-02-16T20:51:08Z

LHBL2003: Beschreibung Gerätename unter Linux Finden

== Vorbemerkungen ==
Alternativ zum [[HomeMatic_Wired_RS485_LAN_Gateway]], können einfache Serial/Netzwerk-RS485-Adaptern für die Kommunikation von FHEM zu HomeMatic-Wired-Geräten eingesetzt werden.
In diesem Artikel werden sowohl RS232-RS485-Adapter, USB-RS485-Adapter als auch Netzwerk-RS485-Adapter als Serial-RS485-Adaptern bezeichnet, denn in jedem Fall wird ein serieller Datenstrom an den RS485 Transceiver weitergeleitet.

Da diese hier beschriebenen Interfaces keine "Intelligenz" besitzen, also die Daten lediglich auf den RS485-Bus umsetzen, wird zur Ansteuerung noch der ''hm485d.pl''-Daemon benötigt. Dieser Prozess setzt die RAW-Befehle in das HomeMatic-Wired-Protokoll um. Der hm485d kann dabei transparent im Hintergrund arbeiten.

=== Liste der aktuell getesteten Adapter / Schnittstellen (bitte ggf. ergänzen) ===
* DIGITUS DA-70157: USB-Serial Adapter mit RS485 Schnittstelle. Dieser Adapter wird derzeit wahrscheinlich am häufigsten und erfolgreichsten zusammen mit FHEM eingesetzt. In ein paar Fällen gab es jedoch Probleme mit unvollständigen Lötstellen oder anderen Fabrikationsfehlern. Dies kann sich darin äußern, dass FHEM überhaupt keine Kommunikation aufbauen kann oder entweder nur senden oder nur empfangen kann. Bevor man dann lange herumprobiert ist es in den meisten Fällen besser, sich einen zweiten Adapter zuzulegen. [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187]
* Eigenbau basierend auf FT232RL und Max485 {{Link2Forum|Topic=64947|Message=562328}}
* Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module [http://www.wiznet.io/product-item/wiz108sr/]
* Wiznet - {{Link2Forum|Topic=14096|LinkText=WIZ108SR im Hutschienengehäuse}}
* USB - RS485 Konverter von Sertronics [https://www.sertronics-shop.de/Raspberry-PiCo/Raspberry-Pi/KabelAdapter/USB-KabelAdapter/USB-RS485-Konverter/] Dieser Adapter wurde zwar erfolgreich getestet, ist aber trotzdem nicht zu empfehlen. Der Adapter beruht auf einem CH340 oder CH341 Chip und funktioniert im Gegensatz zur Beschreibung auf der Herstellerseite mit Raspbian nur nach der Installation eines neuen Treibers. Außerdem fehlen den CH34x-Chips die Seriennummer, was Probleme bereiten kann, wenn man mehrere serielle Schnittstellen hat (das schließt auch verschiedene Billig-Arduino-Clones ein). Des Weiteren gibt es keinen GND-Anschluss, weswegen der Busabschlusswiderstand nicht korrekt angeschlossen werden kann. Details dazu wurden hier diskutiert: {{Link2Forum|Topic=68681|Message=601863}}

== Einbindung in FHEM ==
Zum Einbinden des Gateways braucht man ein HM485_LAN-Device mit folgender Definition:

define hm485 HM485_LAN localhost:2000
attr hm485 hmwId 00000001
attr hm485 HM485d_device <SerialDevice>
attr hm485 HM485d_bind 1

Der Name "hm485" kann frei vergeben werden.
Bei <SerialDevice> muss der Gerätename angegeben werden unter dem das serielle Device anzusprechen ist.

'''Beispiele:'''
# Serieller USB-RS485-Adapter
attr HM485_LAN HM485d_device /dev/ttyUSB0

# Netzwerk-RS485-Adapter
attr HM485_LAN HM485d_device 192.168.1.15:5000

'''Beispiele:'''
Gerätename nach einstecken des USB Dongels von DIGITUS DA-70157 unter Linux finden:
ls -al /dev/serial/by-id
Ergebnis:
total 0
drwxr-xr-x 2 root root 60 Feb 16 20:16 .
drwxr-xr-x 4 root root 80 Feb 16 20:16 ..
lrwxrwxrwx 1 root root 13 Feb 16 20:16 usb-FTDI_FT232R_USB_UART_AO000KS2-if00-port0 -> ../../ttyUSB0
Das "ttyUSB0" ist in dem Fall der Gerätename und sollte dann unter folgenden Pfad gefunden werden.
cd /dev/
ls

HM485d_bind 1 sorgt dafür, dass der hm485d beim FHEM-Start automatisch mit gestartet wird und durch FHEM auch gesteuert, also auch beendet werden kann.

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

Zu beachten ist auch, dass der hm485d '''gleichzeitig''' nur eine Netzwerkverbindung erlaubt. Somit ist ein Gateway auch nur mit einer Zentrale / FHEM-Instanz zur gleichen Zeit nutzbar.

=== HM485_LAN Attribute ===
* '''hmwId''' Hier muss die HMW-ID angegeben werden. Standardmäßig wird die 00000001 benutzt.
* '''do_not_notify''' FileLog/notify/inform Benachrichtigung für das Gerät ist abgeschaltet.
* '''HM485d_bind''' Startet den hm485d automatisch beim Start von FHEM und ermöglicht FHEM zudem die Prozesskontrolle
* '''HM485d_startTimeout''' Manchmal, z.B. auf langsameren Geräten wie der FritzBox oder dem Raspberry Pi, ist es erforderlich den hm485d verzögert zu starten. Hier kann die Verzögerung in Sekunden angegeben werden.
* '''HM485d_device''' Das serielle Gerät zum Interface (siehe Beispiel oben).
* '''HM485d_serialNumber''' Die Seriennummer die der hm485d an die Zentrale (FHEM) melden soll.
* '''HM485d_logfile''' Der hm485d kann ein eigenes Logfile schreiben. Hier kann dafür ein Dateiname angegeben werden.
* '''HM485d_detatch''' Wenn der hm485d mit FHEM zusammen gestartet wird (siehe HM485d_bind) so kann der Prozess hier von FHEM entkoppelt werden. Der Prozess wird dann auch nicht zusammen mit FHEM beendet.
* '''HM485d_logVerbose''' Der Loglevel vom hm485d.

Die folgenden drei Attribute können verwendet werden, wenn der hm485d über einen einfachen UART ohne Flusskontrolle z.B. über den UART des Raspberry Pi, an einen RS485 Transceiver angeschlossen wird. Dafür müssen ggf. GPIO-Pins zur Steuerung des RS485 Transceivers (Senden/Empfangen) definiert werden:
* '''HM485d_gpioTxenInit''' Shell-Befehl zum Initialisieren des benutzten GPIO-Pins für die Sendekontrolle
* '''HM485d_gpioTxenCmd0''' Shell-Befehl um den Sende-GPIO-Pin zurück zu setzen
* '''HM485d_gpioTxenCmd1''' Shell-Befehl um den Sende-GPIO-Pin zu setzen

'''Hinweis'''
Da auch der hm485d sich noch in Entwicklung befindet, ist es möglich dass es in einigen Fällen noch zu Fehlverhalten kommen kann.

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

=== Discovery ===
Mit dem discovery-Befehl wird der gesamte RS485-Bus nach unbekannten HMW Geräten durchsucht.
Dieser Befehl funktioniert allerdings NICHT mit dem Original eq3-Lan-Gateway!

set HM485_LAN discovery start

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

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

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

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

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

'''Funktionale Beispiele:'''
# Rollladenaktor öffnen
set HM485_LAN RAW 01234567 98 00000001 7802C8

# Rollladenaktor stoppen
set HM485_LAN RAW 01234567 98 00000001 7802C9

# Rollladenaktor schließen
set HM485_LAN RAW 01234567 98 00000001 780200

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR ein
set HM485_LAN RAW 01234567 98 00000001 730003FF

# erster Ausgang (Relais) eines HMW-IO-12-Sw14-DR aus
set HM485_LAN RAW 01234567 98 00000001 73000000

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

==Bekannte Probleme==
===Disconnects mit WIZ108SR===
Bei Verwendung eines auf WIZ108SR (oder ähnlich) basierenden Adapters kann es zu regelmäßigen disconnects kommen. Im Log erscheint dann in etwa Folgendes:
2015.09.13 20:17:11.809 2: HM485d: DISCONNECTED
2015.09.13 20:17:11.812 2: HM485d: SERIAL connected to device 192.168.nnn.nnn:pppp
2015.09.13 20:17:11.813 2: HM485d: RECONNECTED
Das Problem lässt sich in der Regel lösen, indem man in der Konfiguration des WIZ108SR den "Inactivity Timer" auf 0 setzt. Siehe auch diesen {{Link2Forum|Topic=41054|LinkText=Thread im Forum}}.

== Links ==
* [http://www.reichelt.de/USB-Konverter/DIGITUS-DA-70157/3//index.html?ARTICLE=122187 DIGITUS DA-70157: USB-Serial Adapter]
* [http://www.wiznet.io/product-item/wiz108sr/ Wiznet - WIZ108SR Compact RS422/RS485-to-Ethernet module]
* {{Link2Forum|Topic=14096|LinkText=Wiznet - WIZ108SR im Hutschienengehäuse}}
* [http://forum.fhem.de/index.php?action=dlattach;topic=10027.0;attach=2441 HMW-Protokoll-Doku]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HomeMatic Devices pairen

2017-11-19T17:13:07Z

LHBL2003: /* Pairing lösen */

HomeMatic Geräte müssen mit dem für das HomeMatic-Protokoll eingesetzten IO-Device (zB [[CUL]], CUN, [[HomeMatic|Homematic IO's]]) ''[[Pairing (HomeMatic)|gepairt]]'' (deutsch: "gepaart") werden, damit sie von FHEM gesteuert oder ausgelesen werden können.

Die Adresse eines HomeMatic Gerätes ist nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben. Da die HM-Geräte über eine sehr komplexe Kanalstruktur verfügen, empfiehlt sich daher, die Geräte in FHEM per ''autocreate'' Funktion anlegen zu lassen, Eine nachträgliche Umbenennung oder manuelle Bearbeitung der erzeugten Konfigurationsdaten ist problemlos möglich.

Zunächst mal muss man einen [[HomeMatic_Installieren|CUL/CUN/Homematic IO installieren]].

Einige Geräte werden mit aktivierter [[AES Encryption]] ausgeliefert (Meistens, aber nicht immer mit SEC im Namen). Das Anlernen an HM IO's funktioniert ohne Probleme, für alle CUL Derivate muss unbedingt der Hinweis im Artikel AES Encryption im Abschnitt I/O-Device <-> Gerät beachtet werden. '''Die dort beschriebene Installation sollte generell vorgenommen werden!'''

Danach geht es hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät genau 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:''' Ist ein Device gepairt werden Konfigurationsänderungen über die Zentrale (FHEM) vorgenommen. Man kann u.a. keine Kanäle mehr ''direkt'' peeren (verknüpfen). Stattdessen verwendet man Kommandos in FHEM. Siehe <u>[[Homematic_Peering_Beispiele|peeren]]</u>

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

Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
Das Vorgehen ist stark vom Gerät(Typ) abhängig, bitte unbedingt das Handbuch lesen: Stichwort "anlernen".

Falls das Gerät einen separaten Anlernknopf hat, ist der normalerweise nur ganz kurz zu drücken.
Danach beginnt die LED regelmäßig zu blinken.

Hat das Gerät keinen separaten Anlernknopf, muss in der Regel eine Taste solange gedrückt werden, bis die LED anfängt regelmäßig zu blinken.

Kommt der Anlernvorgang in Gang, wird dies durch ein wechselndes, schnelles Blinken signalisiert. Kommt kein Anlernvorgang zustande, blinkt die LED regelmäßig für einen bestimmten Zeitraum (ca. 20 sec).
Ist das Gerät schon gepairt, werden bei batteriebetriebenen Geräten eventuell auch noch nicht übertragende Daten gesendet. Dabei blinkt die LED auch unregelmäßig.
{{Randnotiz|RNText=Hinweis: Das genaue Vorgehen ist bei jedem Gerätetyp anders -> unbedingt Handbuch genau lesen!}}
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach sichert die neu gepairten Geräte in der Konfiguration.

Hinweis: Auch mit hmPairForSec kann jeweils nur '''ein''' Device gepaired werden. Für mehrere Devices den Vorgang bitte wiederholen.

= 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
* die Anlerntaste / Configtaste / irgendeine Taste am Gerät (hängt vom konkreten Device ab) wiederholt drücken um die Datenübertragung anzustoßen.

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

define hm HMInfo
get 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.

Beim Pairen ist, wie im normalen Betrieb auch, ein Mindestabstand (etwa 1-2 Meter) zwischen dem Sender der Zentrale (CUL, HMLAN etc.) einzuhalten, da die Funkempfänger sonst mit Übersteuerung reagieren und keine Kommunikation zustande kommt.
Außerdem kann die Funklast beim Auslesen einer unfangreichen Konfiguration eines Gerätes bereits nach wenigen Versuchen das Limit der 1%-Regel erreichen. Sollte also scheinbar keine Kommunikation stattfinden können, ist auch zu prüfen, ob der Zentralensender sich deswegen temporär deaktiviert hat.

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

Sollte man z.B. ein HomeMatic HM-CC-RT-DN Funk-Heizkörperthermostat und ein Fensterkontakt verbunden haben, so steht unter THERMOSTAT_WindowRec im Attribut peerIDs die ID des Fensterkontakts.
Bei einem Defekt des Fensterkontakts sollte man wie im HM-CC-RT-DN beschrieben das unset durchführen. Hat man aber das Device Fensterkontakt gelöscht und das Pairing nicht durchgeführt, so kann man die Zuordnung im Heizkörperthermostat dennoch mit folgenden Befehl aufheben.

set <Name HM-Gerät>_WindowRec peerBulk <peerID> unset

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

HomeMatic Devices pairen

2017-11-19T17:12:08Z

LHBL2003: /* Pairing lösen */

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

2017-10-24T20:11:45Z

LHBL2003: Information um die Luftfeuchtigkeit im Plot zu erhalten

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

2017-09-24T19:27:18Z

LHBL2003: /* Channel (Kanal) 01 _Weather */

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

2017-09-22T19:47:47Z

LHBL2003: Beschreibung set EG_Buero_WANDTHERMOSTAT_Weather peerChan... und wichtiger Hinweis bevor man weitere Befehle sendet

SUNRISE EL

2017-05-13T17:00:15Z

LHBL2003: Google Maps-Hilfe (Breiten- und Längengrad finden oder eingeben) hinzugefügt

{{SEITENTITEL:SUNRISE_EL}}
{{Infobox Modul
|ModPurpose=Funktionen für Sonnenstandsabhängige Aktionen
|ModType=h

|ModCmdRef=SUNRISE_EL
|ModForumArea=Automatisierung
|ModTechName=99_SUNRISE_EL.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}}] / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

Das Hilfsmodul [[SUNRISE_EL]] bietet Funktionen, um Aktionen abhängig von Sonnenauf- und -untergangszeiten durchzuführen.

== Voraussetzungen ==
In der [[Konfiguration]] (fhem.cfg) muss der gewünschte Standort definiert werden, da der Sonnenauf- und -untergang nicht nur vom Datum, sondern auch vom Längen- und Breitengrad des Standortes abhängig sind. Dazu sind die folgenden Definitionen erforderlich:
:<code>attr global latitude 52.51626 </code>
:<code>attr global longitude 13.37778 </code>
und zwar in genau dieser Schreibweise. Die Koordinaten können entweder mit Hilfe eines GPS-Systems oder über einen entsprechenden Internet-Dienst ermittelt werden.

Als Internet-Dienst eignet sich beipielsweise [https://support.google.com/maps/answer/18539?source=gsearch&hl=de Google Maps-Hilfe (Breiten- und Längengrad finden oder eingeben)] oder [http://www.openstreetmap.org/#map=12/52.51626/13.37778 OpenStreetMap]. Die Werte ''latitude'' und ''longitude'' können aus der URL abgelesen werden. In diesem Beispiel ''latitude'' 52.51626 und ''longitude'' 13.37778 (Brandenburger Tor in Berlin).

== Funktionen ==
Das Modul SUNRISE_EL stellt die folgenden Funktionen zur Verfügung:
* sunrise / sunset geben die absolute Zeit des nächsten Sonnenauf- bzw. -untergangs zurück, wobei 24 Stunden addiert werden, sofern das entsprechende Ereignis am nächsten Tag stattfindet
* sunrise_rel / sunset_rel geben die relative Zeit bis zum nächsten Sonnenauf- bzw. -untergang zurück
* sunrise_abs / sunset_abs geben die absolute Zeit für den aktuellen Tag zurück
Diese Funktionen können jeweils mit einem speziellen und drei weiteren (optionalen) Parametern aufgerufen werden:
: <code>...(offset,min,max)</code>
: mit der Bedeutung
:* Horizont; nur einer der Werte REAL, CIVIL, NAUTIC, ASTRONOMIC (in genau dieser Schreibweise) bzw. HORIZON= ist erlaubt
:* offset = Sekunden (Ganzzahl), die auf die Zeit addiert werden
:* min = frühester Zeitpunkt (in Stunden:Minuten - hh:mm), der zurückgegeben werden soll
:* max = spätester Zeitpunkt (in Stunden:Minuten - hh:mm), der zurückgegeben werden soll
* isday() kann benutzt werden um festzustellen, ob der aktuelle Zeitpunkt nach Sonnenauf- aber vor Sonnenuntergang des aktuellen Tages liegt

== Steuerung ==
Mittels folgender Anweisungen in der Konfiguration:
Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off

wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Links ==
* Workaround um die Zeiten für Sonnenaufgang und -untergang anpassen zu können: [[Trick der Woche#isday]]
* Diskussion über das Modul im {{Link2Forum|Topic=8527|LinkText=Fhem Forum}}

== Hinweise ==
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).

Rolladensteuerung mit Eingabemöglichkeiten

2017-05-13T16:58:00Z

LHBL2003: /* ATs */

In diesem Artikel beschreibe ich, wie ich meine Rollläden steuere.

==Grundsätzliche Beschreibung==
Mein erstes große Projekt in Sachen FHEM war es meine Rolläden automatisiert zu steuern, so dass man möglichst wenig manuell eingreifen muss.
Da der ein und andere Riemen der manuellen Steuerung den Geist aufgegeben hat, habe ich nach und nach alle Rolläden mit Motoren und HM Aktoren versehen.

Da ich eine Photovoltaikanlage besitze habe ich ein kleines Modul geschrieben, welches mir die Ertragsleistung in FHEM darstellt.
Anhand dieser Werte steuere ich Rolläden, welche zur Südseite gerichtet sind. Dadurch wird dann dynamisch die Sonneneinstrahlung und damit die Erwärmung der Zimmer eingestellt.
Zwischenzeitlich ist ein Helligkeitssensor installiert worden. Dieser sorgt für das Herunterfahren der Rolläden bei Eintreten der Dunkelheit.

Dieser Wert korreliert zwar mit den Werten der PV Anlage, dies habe ich aber bislang noch nicht aufgelöst.

==Komponenten==
1. HM Funk-Jalousieaktor HM-LC-Bi1PBU-FM

2. Solarlog-Modul

3. Helligkeitssensor aus diesem Posting
{{Link2Forum|Topic=20620|LinkText=Selbstbau HM_WDS10_TH_O mit Luftdruckmessung}}

==Visualisierung==
Hier ist der Status eines jeden Rolladens ersichtlich und dieser ist bedienbar.
Die Darstellung habe ich mittels [[Dashboard]] umgesetzt.

[[Datei:Dashboard01.png]]

Über diese Einstellungsseite können diverse Parameter der Steuerung gesetzt werden.

[[Datei:Dashboard02.png]]

==Einstellungen==
;'''Automatik aktiv:'''
:Hiermit wird die komplette Steuerung der Rolläden ein- bzw ausgeschaltet.
:Sofern der Modus "aus" aktiv ist, werden meine Rolläden lediglich über die Aktoren direkt oder eine HM Fernbedienung gesteuert.

;'''Art:'''
:Hier werden derzeit drei Modi unterstützt:

:''1. Normal''
:Bei diesem Modus fahren die Rollläden zu den definierten Zeiten hoch. Dabei wird eine Unterscheidung zwischen Wochentagen und Wochenenden berücksichtigt. Ausserdem werden mit Hilfe einer Holiday-Datei auch Feiertage und Urlaube berücksichtigt.
:Abends ist ein Zeitraum und ein Helligkeitswert definiert. Sobald dieser Helligkeitswert in dem Zeitfenster unterschritten wird, fahren die Rolläden runter. Spätestens aber zum Ende des Zeitfensters.

:''2. Weihnachten''
:Vom Prinzip arbeitet dieser Modus wie der Modus "Normal". Lediglich ein Rolladen fährt zum Ende des Zeitfensters runter und nicht bei Unterschreitung des Helligkeitswertes, damit die Weihnachtsaussenbeleuchtung auch von innen begutachtet werden kann.

:''3. Urlaub''
:Dieser Modus schaltet die Rolläden genauso wie der Modus "Normal". Des Weiteren aktiviere ich noch eine Zufallssteuerung für eine Anwesenheitsbeleuchtung.

;'''PV:'''
:Hiermit wird der Ertrag der Photovoltaikanlage mit einbezogen, damit die Rolläden zur Südseite anhand definierter Werte geschaltet werden.

;'''Zeit hoch:'''
:Hier wird der Zeitpunkt definiert, wann die Rollläden an Werktagen geöffnet werden sollen.

;'''Zeit hoch WE:'''
:Dies definiert die Zeit, wann die Rolläden am Wochenende bzw an Tagen, welche in einer Holiday Datei definiert sind hoch gehen sollen.

;'''Helligkeit runter:'''
:Dieser Wert ist der untere Schwellwert des Helligkeitssensors, ab wann die Rolläden in dem definierten Zeitraum geschlossen werden sollen.

;'''Zeit runter:'''
:Zu dieser Zeit fahren die Rolläden runter, egal ob der angegebene Hellgleitswert erreicht wurde. Sofern eventuelle Tür-/Fensterkontakte den Status "open" aufweisen, bleiben diese oben.

==Codierung==
Meine Aktoren haben den folgenden Aufbau, was den Namen angeht:

'''OG_ki1_RO_Carport'''

Die ersten zwei Zeichen geben das Geschoss an.
Die Zeichen 4-6 beschreiben das Zimmer.
Die Zeichen 8 und 9 stellen die Art des Aktors dar.
Ab Zeichen 11 wird noch weiter beschrieben wo sich der Aktor befindet bzw was für eine Funktion dieser besitzt.

===Dummys===
Beginnen möchte ich hier mit den Dummys, welche die Konfiguration der Steuerung darstellen.

;'''Automatik aktiv:'''

<nowiki>NAME du_Rollo_Master
TYPE dummy

Attributes:
alias Automatik aktiv:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon fts_shutter_automatic
room LichtRollo
setList state:an,aus
sortby 01
webCmd state</nowiki>

;'''Art:'''

<nowiki>NAME du_Rollo_Art
TYPE dummy

Attributes:
alias Art:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon fts_shutter_updown
room LichtRollo
setList state:Normal,Urlaub,Weihnachten
sortby 02
webCmd state</nowiki>

;'''PV:'''

<nowiki>NAME du_Rollo_PV
TYPE dummy

Attributes:
alias PV:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon weather_sun
room LichtRollo
setList state:an,aus
sortby 03
webCmd state</nowiki>

;'''Zeit hoch:'''

<nowiki>NAME du_Rollo_Zeit_ho
TYPE dummy

Attributes:
alias Zeit hoch:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon icoUhr
room LichtRollo
setList state:time
sortby 10
webCmd state</nowiki>

;'''Zeit hoch WE:'''

<nowiki> NAME du_Rollo_Zeit_ho_WE
TYPE dummy

Attributes:
alias Zeit hoch WE:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon icoUhr
room LichtRollo
setList state:time
sortby 11
webCmd state</nowiki>

;'''Helligkeit runter:'''

<nowiki>NAME du_Rollo_Luminosity_ru
TYPE dummy

Attributes:
alias Helligkeit runter
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon sani_solar
room LichtRollo
setList state:textField
sortby 20
webCmd state</nowiki>

;'''Zeit runter:'''

<nowiki>NAME du_Rollo_Zeit_ru
TYPE dummy

Attributes:
alias Zeit runter:
devStateIcon .*:rc_BLANK
group Rollos_Settings
icon icoUhr
room LichtRollo
setList state:time
sortby 21
webCmd state</nowiki>

;'''Tageslicht:'''

Dieser Dummy beinhaltet den Wert "hell" oder "dunkel".
Diese beiden Werte werden von zwei at's in Abhängigkeit von Sunset/Sunrise gesetzt.
Dadurch gehen die Rollos hoch, wenn im Dunkeln eine Tür geöffnet wird. Wird die Tür geschlossen. Geht der Rollo auch wieder runter.

<nowiki>NAME du_Tageslicht
TYPE dummy

Attributes:
alias Tageslicht
devStateIcon devStateIcon hell:hell dunkel:nacht@crimson
icon sani_solar
</nowiki>

===ATs===

Für beide ATs muss [[:SUNRISE_EL|SUNRISE_EL]] konfiguriert sein.

'''at_LichtRollo_hell'''

<nowiki>NAME at_LichtRollo_hell
DEF *{sunrise(1200)} set du_Tageslicht hell </nowiki>

'''at_LichtRollo_dunkel'''

<nowiki>NAME at_LichtRollo_dunkel
DEF *{sunset(1200)} set du_Tageslicht dunkel</nowiki>

===DOIFs===

'''di_EG_ku_RO_StrasseLinks'''

Dieses DOIF beachtet den Helligkeitswert und den Modus "Weihnachten".
D.h., daß dieser Rollo erst am Ende des definierten Zeitraums herunterfährt.

<nowiki>(([EG_dr_TS_Terrasse:luminosity] < [du_Rollo_Luminosity_ru] and [du_Rollo_Art] ne "Weihnachten" and [du_Tageslicht:state] eq "dunkel") or [{ReadingsVal("du_Rollo_Zeit_ru", "state", "22:00:00")}])
({if (ReadingsVal("EG_ku_RO_StrasseLinks", "state", "---") ne "off") {fhem("set EG_ku_RO_StrasseLinks off")}})
DOELSEIF (([[du_Rollo_Zeit_ho]|8] or [[du_Rollo_Zeit_ho_WE]|7]))
({if (ReadingsVal("EG_ku_RO_StrasseLinks", "state", "---") ne "on") {fhem("set EG_ku_RO_StrasseLinks on")}})</nowiki>

'''di_EG_ku_RO_StrasseRechts'''

Hier wird ein Fensterkontakt mit in die Schaltung einbezogen.
D.h. während des definierten Zeitraums gehen Rollos hoch, wenn eine Tür oder ein Fenster geöffnet wird. Ebenso wieder runter, sofern der Kontakt wieder geschlossen wird.

<nowiki>([EG_ku_TK_Strasse] eq "closed" and ([EG_dr_TS_Terrasse:luminosity] < [du_Rollo_Luminosity_ru:state] and [du_Tageslicht:state] eq "dunkel") or [[du_Rollo_Zeit_ru]])
({if (ReadingsVal("EG_ku_RO_StrasseRechts", "state", "---") ne "off") {fhem("set EG_ku_RO_StrasseRechts off")}})
DOELSEIF (([[du_Rollo_Zeit_ho]|8] or [[du_Rollo_Zeit_ho_WE]|7]) or ([EG_ku_TK_Strasse:state] eq "open") and ([du_Tageslicht:state] eq "dunkel"))
({if (ReadingsVal("EG_ku_RO_StrasseRechts", "state", "---") ne "on") {fhem("set EG_ku_RO_StrasseRechts on")}})</nowiki>

'''di_EG_wz_RO_TerrasseLinks'''

Dieses DOIF beachtet einen Fensterkontakt und bezieht die Photovoltaikanlage mit ein.
Dieser Rollo geht während des Zeitraums der Dunkelheit rauf und runter, sofern der Türkontakt geöffnet oder geschlossen wird.

<nowiki>([EG_wz_TK_Terrasse:state] eq "closed" and (([EG_dr_TS_Terrasse:luminosity] < [du_Rollo_Luminosity_ru:state] and [du_Tageslicht:state] eq "dunkel") or [[du_Rollo_Zeit_ru]]))
({if (ReadingsVal("EG_wz_RO_TerrasseLinks", "state", "---") ne "off") {fhem("set EG_wz_RO_TerrasseLinks off")}})
DOELSEIF (([[du_Rollo_Zeit_ho]|8] or [[du_Rollo_Zeit_ho_WE]|7]) or (([EG_wz_TK_Terrasse:state] eq "open") and [du_Tageslicht:state] eq "dunkel"))
({if (ReadingsVal("EG_wz_RO_TerrasseLinks", "state", "---") ne "on") {fhem("set EG_wz_RO_TerrasseLinks on")}})
DOELSEIF ([du_Rollo_PV] eq "an" and [EG_wz_TK_Terrasse] eq "closed" and [mySL:Pac_avg] >= 2100)
(set EG_wz_RO_TerrasseLinks 0)
DOELSEIF ([du_Rollo_PV] eq "an" and [EG_wz_TK_Terrasse] eq "closed" and [mySL:Pac_avg] >= 1501)
(set EG_wz_RO_TerrasseLinks 30)
DOELSEIF ([du_Rollo_PV] eq "aus")
(set EG_wz_RO_TerrasseLinks on)

wait 0:0:300:300:0 </nowiki>

Alle anderen Aktoren sind vereinfachte Versionen der genannten DOIFs und werden daher hier nicht genannt.

'''di_Rollo_Art'''

Dieses DOIF enabled und disabled einen Randomtimer, welcher ein Zufallslicht schaltet.

<nowiki>([du_Rollo_Art:state] eq "Urlaub") (attr UrlaubTimer disable 0, attr at_Urlaub_DG_hz_SD_Zirkpumpe disable 0)
DOELSE ([du_Rollo_Art:state] ne "Urlaub") (attr UrlaubTimer disable 1, attr at_Urlaub_DG_hz_SD_Zirkpumpe disable 1)</nowiki>

===ReadingsGroup===

Hier seien noch die beiden ReadingsGroup aufgeführt, welche im Dashboard dargestellt werden.

Folgende Funktionen sind in der myRollosUtils.pm gespeichert und dienen der Bedienung ausgehend aus den ReadingsGroups.

<nowiki>############## Rollos hoch/runter in Readingsgroup

sub myRollosUtils_RollosUpDown($$) {
my($DEVICE,$CMD) = @_;

my $icon = $CMD;
my $link;

if( $CMD eq "up" ) {
$icon = "remotecontrol/black_btn_CHUP";
$link = "setreading $DEVICE cmd-new on";
} elsif( $CMD eq "down" ) {
$icon = "remotecontrol/black_btn_CHDOWN";
$link = "setreading $DEVICE cmd-new off";
} elsif( $CMD eq "stop" ) {
$icon = "remotecontrol/black_btn_STOP";
$link = "setreading $DEVICE cmd-new stop";
}

my $notify = "no_RollosUpDown";
if( !defined($defs{$notify}) ) {
CommandDefine(undef,
"$notify notify .*:cmd-new.* "
."{ myRollos_RollosUpDownNotify(\$NAME,\$EVTPART1); }" );
}

my $ret = "%$icon";
$ret .= "%$link" if( $link );

return $ret;
}

sub myRollosUtils_RollosUpDownNotify($$) {
my($DEVICE,$CMD) = @_;

return if( $CMD eq "" );

CommandSet(undef, "$DEVICE $CMD");

return undef;
}

sub myRollosUtils_RollosIcon($) {
my($DEVICE) = @_;
my $level = ReadingsVal($DEVICE,"level", "0");
my $pct = ReadingsVal($DEVICE, "pct", "0");

my $ret = int((100 - $level)/10)*10;

my $icon;
if ($ret eq "0") {
$icon = "fts_window_2w\@orange";
} else {
$icon = "fts_shutter_".$ret."\@orange";
}

return $pct." %";
}
</nowiki>

'''EG_rg_Rolllaeden'''

<nowiki>EG.*_RO_S.*:level,<{myRollosUtils_RollosUpDown($DEVICE,"up")}>,<{myRollosUtils_RollosUpDown($DEVICE,"stop")}>,
<{myRollosUtils_RollosUpDown($DEVICE,"down")}> EG.*_RO_C.*:level,<{myRollosUtils_RollosUpDown($DEVICE,"up")}>,
<{myRollosUtils_RollosUpDown($DEVICE,"stop")}>,<{myRollosUtils_RollosUpDown($DEVICE,"down")}> EG.*_RO_T.*:level,
<{myRollosUtils_RollosUpDown($DEVICE,"up")}>,<{myRollosUtils_RollosUpDown($DEVICE,"stop")}>,
<{myRollosUtils_RollosUpDown($DEVICE,"down")}> EG.*_RO_M.*:level,<{myRollosUtils_RollosUpDown($DEVICE,"up")}>,
<{myRollosUtils_RollosUpDown($DEVICE,"stop")}>,<{myRollosUtils_RollosUpDown($DEVICE,"down")}>

Attributes:
group Rollos/Markise_EG
mapping %ALIAS
valueFormat {pct => "%.1f"}
valueIcon %VALUE </nowiki>

===Notify===

Ein Notify ist für die Bedienung ausgehend aus den ReadingsGroup notwendig.

<nowiki>DEF .*:cmd-new.* { myRollosUtils_RollosUpDownNotify($NAME,$EVTPART1); }
NAME no_RollosUpDown
TYPE notify

Attributes:
group notify</nowiki>

[[Kategorie:HOWTOS]]

Weekprofile

2017-02-17T20:33:47Z

LHBL2003: EG_Bad_THERMOSTAT_Clima zu EG_Bad_THERMOSTAT_Climate

{{SEITENTITEL:weekprofile}}

{{Infobox Modul
|ModPurpose=Verwaltung von Wochenprofilen für Heizungssteuerung
|ModType=h
|ModForumArea=Frontends
|ModCmdRef=weekprofile
|ModTechName=98_weekprofile.pm
|ModOwner={{Link2FU|7869|Risiko}}
}}

Das Modul [[weekprofile]] stellt Funktionen zur Verwaltung von Wochenprofilen\Wochenplänen für Heizkörperthermostate zur Verfügung. Aktuell werden folgenden Systeme unterstützt:
* [[MAX]]
* [[HomeMatic]]
<br>
Es ist möglich, verschiedene Wochenprofile anzulegen, zu kopieren, zu ändern und zu löschen. Außerdem können die erstellten Profile den entsprechenden Devices zugewiesen werden.
<br>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br>

== Voraussetzung ==
Zum einwandfreien Betrieb des Moduls wird JSON benötigt. Dieses kann z.B. über folgendes installiert werden

<code>
sudo apt-get install libjson-pp-perl
</code>

== FHEMWEB Widget ==
Zur Bedienung des Moduls existiert ein passendes widget für FHEMWEB.<br>
[[Datei:Weekprofile_master.png]]<br>
Alle notwendigen Aufgaben wie bspw. Kopieren, Bearbeiten, Zuweisen, etc. können über die FHEMWEB Oberfläche erfolgen.<br>
Ein direkte Verwendung der Befehle für get und set ist somit nicht zwingend erforderlich.<br>

== Betriebsarten ==
Das Modul besitzt 3 unterschiedliche Betriebsarten, die im Folgenden beschrieben werden. Obwohl auch Mischformen möglich sind, sollte man sich der Übersichtlichkeit halber für eine Betriebsart entscheiden.

Bei allen Änderungen sollte man immer bedenken, dass die Änderung an die entsprechenden Thermostaten übertragen werden müssen, was je nach Menge etwas Zeit in Anspruch nehmen kann.

=== Assoziiertes Master Gerät ===
Dieses ist der einfachste Betriebsmodus, bei dem jeder Definition genau ein Thermostat zugeordnet ist. D.h. entsprechend der Anzahl der Thermostaten, die man steuern möchte, benötigt man eine passende Anzahl von Weekprofile-Definitionen.
Bei der Definition des Moduls wird das zu steuernde Thermostat direkt mit angegeben.

:<code>define <name> weekprofile <device></code>
Beispiel:
:<code>define EG_Bad_WEEKPROFILE weekprofile EG_Bad_THERMOSTAT_Climate</code>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br><br>
Bei der Definition wird automatisch ein Wochenplan mit dem Namen 'master' angelegt.
Der Wochenplan entspricht dem im Device hinterlegtem Profil.

Dieser spezielle Masterplan kann nicht gelöscht werden, da er immer dem aktuellen Profil im Device entspricht.
Ändert man das Profil direkt über das Device, wird der Masterplan automatisch aktualisiert.

Wird der Masterplan über das Modul weekprofile geändert\gespeichert, wird das Profil automatisch zum assoziiertem Device übertragen.

Wird in dieser Betriebsart für einen Befehl kein spezielles Device angegeben, wird immer das assoziierte Device verwendet. So wird bspw. bei
:<code>set <name> send_to_device urlaub</code>
das Profil 'urlaub' an das bei define angegebene Thermostat übertragen.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| '-->'
| Profil an ein oder mehrere Thermostate übertragen, die nicht dem assoziierten Mastergerät entsprechen. Dabei bietet das Modul alle kompatiblen gefundenen Thermostaten automatisch zur Auswahl an.
|}

=== Standard Verwaltung ===
Diese Betriebsart ist für die einfache Verwaltung von Wochenplänen gedacht, welche dann an unterschiedliche Thermostate manuell übertragen werden können.
Für diese Betriebsart sollte kein assoziiertes Master Gerät bei define angegeben werden.
:<code>define <name> weekprofile</code>
In diesem Fall wird beim erstmaligen Anlegen ein Default-Profil mit dem Namen 'default' angelegt.
Dieses bildet die Grundlage zur Erstellung weiterer Pläne durch kopieren.
Existieren mindestens. 2 Profile, kann das Default-Profil gelöscht werden.
Die einzelnen Wochenpläne können mittels <code>send_to_device</code> an ein oder mehrere Thermostate übertragen werden.

==== Funktionen des Wigets ====
Siehe Betriebsmodus assoziiertes Master Gerät.

=== Topics ===
Dieser Betriebsmodus erlaubt es mit Hilfe von Topics oder Kategorien wie bspw. (Urlaub, Sommer, Winter, Party, etc.) komplexeren Verwaltung von Wochenplänen zu realisieren.
Dieses Feature wird mittels dem Atribute <code>useTopics</code> aktiviert.
Innerhalb eines Topics kann es mehrere Wochenpläne geben. Sinnvollerweise für jedes Thermostat ein Wochenplan.
Mit dem Befehl <code>restore_topic</code> kann man dann zwischen unterschiedlichen Kategorien wechseln. Die Wochenpläne werden automatisch an die Thermostate übertragen. Dazu muss im Thermostat ein User-Attribut 'weekprofile' mit dem Namen des verbundenen Wochenplans hinterlegt sein.

Bei der Verwendung von Topics wird beim erstmaligen Anlegen automatisch die Topic 'default' mit den Default-Wochenprofil 'default' angelegt.
In dieser Topic kann man beispielsweise Pläne ablegen, die bei mehreren Thermostaten oder anderen Kategorien verwendet werden sollen.

'''Wichtig:'''<br>
Bei der Verwendung von Topics, besteht der Profilname immer aus <code>Topicname:Planname</code><br>
Wird kein Topicname angegeben, wird immer 'default' als Topicnamen verwendet.

==== Verwendung von Referenzen ====
Mittels Referenzierung kann man auf dieser Pläne verweisen und muss so nur einen Plan ändern, um gleich für eine Vielzahl von Thermostaten die Pläne zu ändern.
So könnte bspw. ''Sommer:Plan_WZ'' nur eine Referenz auf ''default:Fest_24h'' sein. <br>
Existiert ''default:Fest_24h'', wird der Verweis so angelegt:
:<code>set weekprf reference_profile default:Fest_24h Sommer:Plan_WZ</code>
Referenzen können nicht bearbeitet werden. Im Beispiel wäre der Plan ''Sommer:Plan_WZ'' nicht bearbeitbar.<br>

Für das Anlegen eines Wochenplans, der auf einen anderen referenziert, wählt man den Quellplan im Dropdown aus und erstellt dann einen neuen, indem man den entsprechenden Haken beim Erstellen aktiviert.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung/Referenzierung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| 'T'
| Topic aktiviert und die entsprechenden Wochenpläne an die Thermostaten übertragen.
|}

==== Beispiel ====
User-Attribut im Thermostat definieren:<br>
<code>
MAX Thermostate:
define WT_Wohnzimmer MAX WallMountedThermostat 0d657f<br>
attr WT_Wohnzimmer userattr weekprofile<br>
attr WT_Wohnzimmer weekprofile Plan_WZ</code>
<br><br>

HomeMatic Thermostate:<br>
Fügen Sie ein [[HM-CC-RT-DN Funk-Heizkörperthermostat]] über hmPairForSec hinzu (Beispiel DeviceName HM_123456)<br>
<code>attr HM_123456_Clima userattr weekprofile<br>
attr HM_123456_Clima weekprofile Plan_WZ
</code>
<br><br>
Weiter wird angenommen, dass es die Topics Winter und Sommer mit jeweils einem Wochenplan Namens 'Plan_WZ' im Modul 'weekprf' gibt.
<br>
<code>
define weekprf weekprofile<br>
attr weekprf useTopics 1</code>
<br><br>
Die Abfrage mittels <code>get weekprf profile_names *</code> muss ergeben:<br>
''Winter:Plan_WZ,Sommer:Plan_WZ''
<br><br>
Wechselt man nun mit <code>set weekprf restore_topic Sommer</code> auf Sommer, wird der Plan ''Sommer:Plan_WZ'' an das Thermostat ''WT_Wohnzimmer'' übertragen.
<br>

== Befehle und Attribute ==

=== Modul Befehle: set ===

==== Wochenprofile kopieren ====
Siehe Commandref

==== Wochenprofile löschen ====
Siehe Commandref

==== Wochenprofile an ein Device übertragen ====
Siehe Commandref

==== Wochenprofile per Datei konfigurieren ====

Die Wochenprofile werden mit dem Befehl
:<code>set <name> profile_data <profilename> <json data></code>
angelegt/geändert (überschrieben). Die eigentlichen Daten müssen dabei in einer [https://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] Datenstruktur angegeben werden.

Für jeden Tag müssen die Schaltzeiten und die Solltemperaturen in Form von Listen angegeben werden.
Die Datenstruktur sieht bspw. wie folgt aus:

<pre style="width:350px;">{
"Sun": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Sat": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Thu": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Fri": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Tue": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Wed": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Mon": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
}
}
</pre>

Es handelt sich dabei um eine unsortierte Liste von "Tages-Objekten", die wiederum eine unsortierte Liste von Schlüssel-Werte Paaren enthält. Die beiden verwendeten Schlüssel "time" und "temp" für Zeit und Temperatur verweisen jeweils auf eine sortierte Liste mit Werten.

Der Schlüssel "time" enthält die Liste der gewünschten Zeitpunkte, zu denen ein Temperaturwechsel stattfinden soll. Die Zeitangaben müssen im Format "hh:mm" angegeben werden. Falls für den ganzen Tag nur eine Temperatur verwendet werden soll, so ist als Zeitpunkt "24:00" anzugeben.

Der Schlüssel "temp" enthält die Temperaturen, die zu den in "time" hinterlegten Schaltzeitpunkten eingestellt werden sollen. Dabei entspricht die Reihenfolge der Temperaturen der Reihenfolge der Zeitpunkte in "time".

Zur Übergabe an FHEM sollte die JSON Struktur von sämtlichen Formatierungen (Zeilenumbrüche, Tabs, überflüssige Leerzeichen) bereinigt werden, so dass ein einzeiliger String entsteht. Für das oben angegebene Beispiel würde das dann so aussehen:

<code><nowiki>{"Sun":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Sat":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Thu":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Fri":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Tue":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Wed":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Mon":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]}}</nowiki></code>

==== Referenzprofil konfigurieren ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

==== Topic wiederherstellen ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

=== Modul Befehle: get ===

==== Wochenprofile exportieren ====
Siehe Commandref

==== Wochenprofilnamen exportieren ====
Siehe Commandref

==== Wochenprofil-Refrenzen exportieren ====
Siehe Commandref

=== Modul Attribute ===
Die meisten Attribute sind selbsterklärend. Daher wird an dieser Stelle zumeist auf die Informationen in der Commandref verwiesen.

==== Namen der Wochentage festlegen ====
widgetWeekdays: Siehe Commandref

==== Anzeigeart: Anzahl der Spalten====
widgetEditDaysInRow: Siehe Commandref

==== Anzeigeart: editieren auf neuer Seite ====
widgetEditOnNewPage: Siehe Commandref

==== Pfad zur Konfigurationsdatei ====
configFile: Siehe Commandref

==== Verwendung von Topics ====
useTopics: Aktiviert den Betriebsmodus: Topics

== bekannte Probleme ==
* Derzeit (Version: 10924) können keine Leerzeichen oder Umlaute verwendet werden. Leerzeichen werden bei der Eingabe abgefangen. Hat man versehentlich doch Umlaute verwendet, müssen in der Datei ./log/weekprofile-<name>.cfg die entsprechenden Zeilen manuell gelöscht/umbenennt werden und danach ein rereadcfg ausführt werden.
* Speichert man einen Wochenplan, wird die Änderung erst nach einem reload der Seite angezeigt.

== Links ==
*[http://forum.fhem.de/index.php/topic,46117.0.html Thread] im FHEM-Forum
*[http://www.jsoneditoronline.org/ JSON-Editor] für eine einfache Bearbeitung der JSON Daten

Weekprofile

2017-01-25T19:21:02Z

LHBL2003: /* Beispiel */ Homematic Beispiel

{{SEITENTITEL:weekprofile}}

{{Infobox Modul
|ModPurpose=Verwaltung von Wochenprofilen für Heizungssteuerung
|ModType=h
|ModForumArea=Frontends
|ModCmdRef=weekprofile
|ModTechName=98_weekprofile.pm
|ModOwner={{Link2FU|7869|Risiko}}
}}

Das Modul [[weekprofile]] stellt Funktionen zur Verwaltung von Wochenprofilen\Wochenplänen für Heizkörperthermostate zur Verfügung. Aktuell werden folgenden Systeme unterstützt:
* [[MAX]]
* [[HomeMatic]]
<br>
Es ist möglich, verschiedene Wochenprofile anzulegen, zu kopieren, zu ändern und zu löschen. Außerdem können die erstellten Profile den entsprechenden Devices zugewiesen werden.
<br>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br>

== Voraussetzung ==
Zum einwandfreien Betrieb des Moduls wird JSON benötigt. Dieses kann z.B. über folgendes installiert werden

<code>
sudo apt-get install libjson-pp-perl
</code>

== FHEMWEB Widget ==
Zur Bedienung des Moduls existiert ein passendes widget für FHEMWEB.<br>
[[Datei:Weekprofile_master.png]]<br>
Alle notwendigen Aufgaben wie bspw. Kopieren, Bearbeiten, Zuweisen, etc. können über die FHEMWEB Oberfläche erfolgen.<br>
Ein direkte Verwendung der Befehle für get und set ist somit nicht zwingend erforderlich.<br>

== Betriebsarten ==
Das Modul besitzt 3 unterschiedliche Betriebsarten, die im Folgenden beschrieben werden. Obwohl auch Mischformen möglich sind, sollte man sich der Übersichtlichkeit halber für eine Betriebsart entscheiden.

Bei allen Änderungen sollte man immer bedenken, dass die Änderung an die entsprechenden Thermostaten übertragen werden müssen, was je nach Menge etwas Zeit in Anspruch nehmen kann.

=== Assoziiertes Master Gerät ===
Dieses ist der einfachste Betriebsmodus, bei dem jeder Definition genau ein Thermostat zugeordnet ist. D.h. entsprechend der Anzahl der Thermostaten, die man steuern möchte, benötigt man eine passende Anzahl von Weekprofile-Definitionen.
Bei der Definition des Moduls wird das zu steuernde Thermostat direkt mit angegeben.

:<code>define <name> weekprofile <device></code>
Beispiel:
:<code>define EG_Bad_WEEKPROFILE weekprofile EG_Bad_THERMOSTAT_Clima</code>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br><br>
Bei der Definition wird automatisch ein Wochenplan mit dem Namen 'master' angelegt.
Der Wochenplan entspricht dem im Device hinterlegtem Profil.

Dieser spezielle Masterplan kann nicht gelöscht werden, da er immer dem aktuellen Profil im Device entspricht.
Ändert man das Profil direkt über das Device, wird der Masterplan automatisch aktualisiert.

Wird der Masterplan über das Modul weekprofile geändert\gespeichert, wird das Profil automatisch zum assoziiertem Device übertragen.

Wird in dieser Betriebsart für einen Befehl kein spezielles Device angegeben, wird immer das assoziierte Device verwendet. So wird bspw. bei
:<code>set <name> send_to_device urlaub</code>
das Profil 'urlaub' an das bei define angegebene Thermostat übertragen.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| '-->'
| Profil an ein oder mehrere Thermostate übertragen, die nicht dem assoziierten Mastergerät entsprechen. Dabei bietet das Modul alle kompatiblen gefundenen Thermostaten automatisch zur Auswahl an.
|}

=== Standard Verwaltung ===
Diese Betriebsart ist für die einfache Verwaltung von Wochenplänen gedacht, welche dann an unterschiedliche Thermostate manuell übertragen werden können.
Für diese Betriebsart sollte kein assoziiertes Master Gerät bei define angegeben werden.
:<code>define <name> weekprofile</code>
In diesem Fall wird beim erstmaligen Anlegen ein Default-Profil mit dem Namen 'default' angelegt.
Dieses bildet die Grundlage zur Erstellung weiterer Pläne durch kopieren.
Existieren mindestens. 2 Profile, kann das Default-Profil gelöscht werden.
Die einzelnen Wochenpläne können mittels <code>send_to_device</code> an ein oder mehrere Thermostate übertragen werden.

==== Funktionen des Wigets ====
Siehe Betriebsmodus assoziiertes Master Gerät.

=== Topics ===
Dieser Betriebsmodus erlaubt es mit Hilfe von Topics oder Kategorien wie bspw. (Urlaub, Sommer, Winter, Party, etc.) komplexeren Verwaltung von Wochenplänen zu realisieren.
Dieses Feature wird mittels dem Atribute <code>useTopics</code> aktiviert.
Innerhalb eines Topics kann es mehrere Wochenpläne geben. Sinnvollerweise für jedes Thermostat ein Wochenplan.
Mit dem Befehl <code>restore_topic</code> kann man dann zwischen unterschiedlichen Kategorien wechseln. Die Wochenpläne werden automatisch an die Thermostate übertragen. Dazu muss im Thermostat ein User-Attribut 'weekprofile' mit dem Namen des verbundenen Wochenplans hinterlegt sein.

Bei der Verwendung von Topics wird beim erstmaligen Anlegen automatisch die Topic 'default' mit den Default-Wochenprofil 'default' angelegt.
In dieser Topic kann man beispielsweise Pläne ablegen, die bei mehreren Thermostaten oder anderen Kategorien verwendet werden sollen.

'''Wichtig:'''<br>
Bei der Verwendung von Topics, besteht der Profilname immer aus <code>Topicname:Planname</code><br>
Wird kein Topicname angegeben, wird immer 'default' als Topicnamen verwendet.

==== Verwendung von Referenzen ====
Mittels Referenzierung kann man auf dieser Pläne verweisen und muss so nur einen Plan ändern, um gleich für eine Vielzahl von Thermostaten die Pläne zu ändern.
So könnte bspw. ''Sommer:Plan_WZ'' nur eine Referenz auf ''default:Fest_24h'' sein. <br>
Existiert ''default:Fest_24h'', wird der Verweis so angelegt:
:<code>set weekprf reference_profile default:Fest_24h Sommer:Plan_WZ</code>
Referenzen können nicht bearbeitet werden. Im Beispiel wäre der Plan ''Sommer:Plan_WZ'' nicht bearbeitbar.<br>

Für das Anlegen eines Wochenplans, der auf einen anderen referenziert, wählt man den Quellplan im Dropdown aus und erstellt dann einen neuen, indem man den entsprechenden Haken beim Erstellen aktiviert.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung/Referenzierung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| 'T'
| Topic aktiviert und die entsprechenden Wochenpläne an die Thermostaten übertragen.
|}

==== Beispiel ====
User-Attribut im Thermostat definieren:<br>
<code>
MAX Thermostate:
define WT_Wohnzimmer MAX WallMountedThermostat 0d657f<br>
attr WT_Wohnzimmer userattr weekprofile<br>
attr WT_Wohnzimmer weekprofile Plan_WZ</code>
<br><br>

HomeMatic Thermostate:<br>
Fügen Sie ein [[HM-CC-RT-DN Funk-Heizkörperthermostat]] über hmPairForSec hinzu (Beispiel DeviceName HM_123456)<br>
<code>attr HM_123456_Clima userattr weekprofile<br>
attr HM_123456_Clima weekprofile Plan_WZ
</code>
<br><br>
Weiter wird angenommen, dass es die Topics Winter und Sommer mit jeweils einem Wochenplan Namens 'Plan_WZ' im Modul 'weekprf' gibt.
<br>
<code>
define weekprf weekprofile<br>
attr weekprf useTopics 1</code>
<br><br>
Die Abfrage mittels <code>get weekprf profile_names *</code> muss ergeben:<br>
''Winter:Plan_WZ,Sommer:Plan_WZ''
<br><br>
Wechselt man nun mit <code>set weekprf restore_topic Sommer</code> auf Sommer, wird der Plan ''Sommer:Plan_WZ'' an das Thermostat ''WT_Wohnzimmer'' übertragen.
<br>

== Befehle und Attribute ==

=== Modul Befehle: set ===

==== Wochenprofile kopieren ====
Siehe Commandref

==== Wochenprofile löschen ====
Siehe Commandref

==== Wochenprofile an ein Device übertragen ====
Siehe Commandref

==== Wochenprofile per Datei konfigurieren ====

Die Wochenprofile werden mit dem Befehl
:<code>set <name> profile_data <profilename> <json data></code>
angelegt/geändert (überschrieben). Die eigentlichen Daten müssen dabei in einer [https://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] Datenstruktur angegeben werden.

Für jeden Tag müssen die Schaltzeiten und die Solltemperaturen in Form von Listen angegeben werden.
Die Datenstruktur sieht bspw. wie folgt aus:

<pre style="width:350px;">{
"Sun": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Sat": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Thu": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Fri": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Tue": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Wed": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Mon": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
}
}
</pre>

Es handelt sich dabei um eine unsortierte Liste von "Tages-Objekten", die wiederum eine unsortierte Liste von Schlüssel-Werte Paaren enthält. Die beiden verwendeten Schlüssel "time" und "temp" für Zeit und Temperatur verweisen jeweils auf eine sortierte Liste mit Werten.

Der Schlüssel "time" enthält die Liste der gewünschten Zeitpunkte, zu denen ein Temperaturwechsel stattfinden soll. Die Zeitangaben müssen im Format "hh:mm" angegeben werden. Falls für den ganzen Tag nur eine Temperatur verwendet werden soll, so ist als Zeitpunkt "24:00" anzugeben.

Der Schlüssel "temp" enthält die Temperaturen, die zu den in "time" hinterlegten Schaltzeitpunkten eingestellt werden sollen. Dabei entspricht die Reihenfolge der Temperaturen der Reihenfolge der Zeitpunkte in "time".

Zur Übergabe an FHEM sollte die JSON Struktur von sämtlichen Formatierungen (Zeilenumbrüche, Tabs, überflüssige Leerzeichen) bereinigt werden, so dass ein einzeiliger String entsteht. Für das oben angegebene Beispiel würde das dann so aussehen:

<code><nowiki>{"Sun":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Sat":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Thu":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Fri":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Tue":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Wed":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Mon":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]}}</nowiki></code>

==== Referenzprofil konfigurieren ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

==== Topic wiederherstellen ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

=== Modul Befehle: get ===

==== Wochenprofile exportieren ====
Siehe Commandref

==== Wochenprofilnamen exportieren ====
Siehe Commandref

==== Wochenprofil-Refrenzen exportieren ====
Siehe Commandref

=== Modul Attribute ===
Die meisten Attribute sind selbsterklärend. Daher wird an dieser Stelle zumeist auf die Informationen in der Commandref verwiesen.

==== Namen der Wochentage festlegen ====
widgetWeekdays: Siehe Commandref

==== Anzeigeart: Anzahl der Spalten====
widgetEditDaysInRow: Siehe Commandref

==== Anzeigeart: editieren auf neuer Seite ====
widgetEditOnNewPage: Siehe Commandref

==== Pfad zur Konfigurationsdatei ====
configFile: Siehe Commandref

==== Verwendung von Topics ====
useTopics: Aktiviert den Betriebsmodus: Topics

== bekannte Probleme ==
* Derzeit (Version: 10924) können keine Leerzeichen oder Umlaute verwendet werden. Leerzeichen werden bei der Eingabe abgefangen. Hat man versehentlich doch Umlaute verwendet, müssen in der Datei ./log/weekprofile-<name>.cfg die entsprechenden Zeilen manuell gelöscht/umbenennt werden und danach ein rereadcfg ausführt werden.
* Speichert man einen Wochenplan, wird die Änderung erst nach einem reload der Seite angezeigt.

== Links ==
*[http://forum.fhem.de/index.php/topic,46117.0.html Thread] im FHEM-Forum
*[http://www.jsoneditoronline.org/ JSON-Editor] für eine einfache Bearbeitung der JSON Daten

Weekprofile

2017-01-25T19:01:53Z

LHBL2003: /* Assoziiertes Master Gerät */ Beispiel erstellt

{{SEITENTITEL:weekprofile}}

{{Infobox Modul
|ModPurpose=Verwaltung von Wochenprofilen für Heizungssteuerung
|ModType=h
|ModForumArea=Frontends
|ModCmdRef=weekprofile
|ModTechName=98_weekprofile.pm
|ModOwner={{Link2FU|7869|Risiko}}
}}

Das Modul [[weekprofile]] stellt Funktionen zur Verwaltung von Wochenprofilen\Wochenplänen für Heizkörperthermostate zur Verfügung. Aktuell werden folgenden Systeme unterstützt:
* [[MAX]]
* [[HomeMatic]]
<br>
Es ist möglich, verschiedene Wochenprofile anzulegen, zu kopieren, zu ändern und zu löschen. Außerdem können die erstellten Profile den entsprechenden Devices zugewiesen werden.
<br>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br>

== Voraussetzung ==
Zum einwandfreien Betrieb des Moduls wird JSON benötigt. Dieses kann z.B. über folgendes installiert werden

<code>
sudo apt-get install libjson-pp-perl
</code>

== FHEMWEB Widget ==
Zur Bedienung des Moduls existiert ein passendes widget für FHEMWEB.<br>
[[Datei:Weekprofile_master.png]]<br>
Alle notwendigen Aufgaben wie bspw. Kopieren, Bearbeiten, Zuweisen, etc. können über die FHEMWEB Oberfläche erfolgen.<br>
Ein direkte Verwendung der Befehle für get und set ist somit nicht zwingend erforderlich.<br>

== Betriebsarten ==
Das Modul besitzt 3 unterschiedliche Betriebsarten, die im Folgenden beschrieben werden. Obwohl auch Mischformen möglich sind, sollte man sich der Übersichtlichkeit halber für eine Betriebsart entscheiden.

Bei allen Änderungen sollte man immer bedenken, dass die Änderung an die entsprechenden Thermostaten übertragen werden müssen, was je nach Menge etwas Zeit in Anspruch nehmen kann.

=== Assoziiertes Master Gerät ===
Dieses ist der einfachste Betriebsmodus, bei dem jeder Definition genau ein Thermostat zugeordnet ist. D.h. entsprechend der Anzahl der Thermostaten, die man steuern möchte, benötigt man eine passende Anzahl von Weekprofile-Definitionen.
Bei der Definition des Moduls wird das zu steuernde Thermostat direkt mit angegeben.

:<code>define <name> weekprofile <device></code>
Beispiel:
:<code>define EG_Bad_WEEKPROFILE weekprofile EG_Bad_THERMOSTAT_Clima</code>
'''Hinweis:'''<br>
Bei HomeMatic müssen die Kanäle "Clima" bzw. "_Climate" verwendet werden.<br><br>
Bei der Definition wird automatisch ein Wochenplan mit dem Namen 'master' angelegt.
Der Wochenplan entspricht dem im Device hinterlegtem Profil.

Dieser spezielle Masterplan kann nicht gelöscht werden, da er immer dem aktuellen Profil im Device entspricht.
Ändert man das Profil direkt über das Device, wird der Masterplan automatisch aktualisiert.

Wird der Masterplan über das Modul weekprofile geändert\gespeichert, wird das Profil automatisch zum assoziiertem Device übertragen.

Wird in dieser Betriebsart für einen Befehl kein spezielles Device angegeben, wird immer das assoziierte Device verwendet. So wird bspw. bei
:<code>set <name> send_to_device urlaub</code>
das Profil 'urlaub' an das bei define angegebene Thermostat übertragen.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| '-->'
| Profil an ein oder mehrere Thermostate übertragen, die nicht dem assoziierten Mastergerät entsprechen. Dabei bietet das Modul alle kompatiblen gefundenen Thermostaten automatisch zur Auswahl an.
|}

=== Standard Verwaltung ===
Diese Betriebsart ist für die einfache Verwaltung von Wochenplänen gedacht, welche dann an unterschiedliche Thermostate manuell übertragen werden können.
Für diese Betriebsart sollte kein assoziiertes Master Gerät bei define angegeben werden.
:<code>define <name> weekprofile</code>
In diesem Fall wird beim erstmaligen Anlegen ein Default-Profil mit dem Namen 'default' angelegt.
Dieses bildet die Grundlage zur Erstellung weiterer Pläne durch kopieren.
Existieren mindestens. 2 Profile, kann das Default-Profil gelöscht werden.
Die einzelnen Wochenpläne können mittels <code>send_to_device</code> an ein oder mehrere Thermostate übertragen werden.

==== Funktionen des Wigets ====
Siehe Betriebsmodus assoziiertes Master Gerät.

=== Topics ===
Dieser Betriebsmodus erlaubt es mit Hilfe von Topics oder Kategorien wie bspw. (Urlaub, Sommer, Winter, Party, etc.) komplexeren Verwaltung von Wochenplänen zu realisieren.
Dieses Feature wird mittels dem Atribute <code>useTopics</code> aktiviert.
Innerhalb eines Topics kann es mehrere Wochenpläne geben. Sinnvollerweise für jedes Thermostat ein Wochenplan.
Mit dem Befehl <code>restore_topic</code> kann man dann zwischen unterschiedlichen Kategorien wechseln. Die Wochenpläne werden automatisch an die Thermostate übertragen. Dazu muss im Thermostat ein User-Attribut 'weekprofile' mit dem Namen des verbundenen Wochenplans hinterlegt sein.

Bei der Verwendung von Topics wird beim erstmaligen Anlegen automatisch die Topic 'default' mit den Default-Wochenprofil 'default' angelegt.
In dieser Topic kann man beispielsweise Pläne ablegen, die bei mehreren Thermostaten oder anderen Kategorien verwendet werden sollen.

'''Wichtig:'''<br>
Bei der Verwendung von Topics, besteht der Profilname immer aus <code>Topicname:Planname</code><br>
Wird kein Topicname angegeben, wird immer 'default' als Topicnamen verwendet.

==== Verwendung von Referenzen ====
Mittels Referenzierung kann man auf dieser Pläne verweisen und muss so nur einen Plan ändern, um gleich für eine Vielzahl von Thermostaten die Pläne zu ändern.
So könnte bspw. ''Sommer:Plan_WZ'' nur eine Referenz auf ''default:Fest_24h'' sein. <br>
Existiert ''default:Fest_24h'', wird der Verweis so angelegt:
:<code>set weekprf reference_profile default:Fest_24h Sommer:Plan_WZ</code>
Referenzen können nicht bearbeitet werden. Im Beispiel wäre der Plan ''Sommer:Plan_WZ'' nicht bearbeitbar.<br>

Für das Anlegen eines Wochenplans, der auf einen anderen referenziert, wählt man den Quellplan im Dropdown aus und erstellt dann einen neuen, indem man den entsprechenden Haken beim Erstellen aktiviert.

==== Funktionen des Wigets ====

{| class="wikitable"
|-
! Button
! Funktion
|-
| Zahnräder
| Beabeitungsmodus öffnen; Auf der dann angezeigten Seite kann über "-->" der Plan eines Tages auf einen anderen kopiert werden.
|-
| 'DropDown'
| Profil für Ansicht/Bearbeitung/Referenzierung auswählen
|-
| '+'
| Neues Profil durch Kopie erstellen
|-
| '-'
| Profil löschen
|-
| 'T'
| Topic aktiviert und die entsprechenden Wochenpläne an die Thermostaten übertragen.
|}

==== Beispiel ====
User-Attribut im Thermostat definieren:<br>
<code>
define WT_Wohnzimmer MAX WallMountedThermostat 0d657f<br>
attr WT_Wohnzimmer userattr weekprofile<br>
attr WT_Wohnzimmer weekprofile Plan_WZ
</code>
<br><br>
Weiter wird angenommen, dass es die Topics Winter und Sommer mit jeweils einem Wochenplan Namens 'Plan_WZ' im Modul 'weekprf' gibt.
<br>
<code>
define weekprf weekprofile<br>
attr weekprf useTopics 1</code>
<br><br>
Die Abfrage mittels <code>get weekprf profile_names *</code> muss ergeben:<br>
''Winter:Plan_WZ,Sommer:Plan_WZ''
<br><br>
Wechselt man nun mit <code>set weekprf restore_topic Sommer</code> auf Sommer, wird der Plan ''Sommer:Plan_WZ'' an das Thermostat ''WT_Wohnzimmer'' übertragen.
<br>

== Befehle und Attribute ==

=== Modul Befehle: set ===

==== Wochenprofile kopieren ====
Siehe Commandref

==== Wochenprofile löschen ====
Siehe Commandref

==== Wochenprofile an ein Device übertragen ====
Siehe Commandref

==== Wochenprofile per Datei konfigurieren ====

Die Wochenprofile werden mit dem Befehl
:<code>set <name> profile_data <profilename> <json data></code>
angelegt/geändert (überschrieben). Die eigentlichen Daten müssen dabei in einer [https://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON] Datenstruktur angegeben werden.

Für jeden Tag müssen die Schaltzeiten und die Solltemperaturen in Form von Listen angegeben werden.
Die Datenstruktur sieht bspw. wie folgt aus:

<pre style="width:350px;">{
"Sun": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Sat": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Thu": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Fri": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Tue": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Wed": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
},
"Mon": {
"time": ["06:00","22:00","24:00"],
"temp": ["20.0","22.0","20.0"]
}
}
</pre>

Es handelt sich dabei um eine unsortierte Liste von "Tages-Objekten", die wiederum eine unsortierte Liste von Schlüssel-Werte Paaren enthält. Die beiden verwendeten Schlüssel "time" und "temp" für Zeit und Temperatur verweisen jeweils auf eine sortierte Liste mit Werten.

Der Schlüssel "time" enthält die Liste der gewünschten Zeitpunkte, zu denen ein Temperaturwechsel stattfinden soll. Die Zeitangaben müssen im Format "hh:mm" angegeben werden. Falls für den ganzen Tag nur eine Temperatur verwendet werden soll, so ist als Zeitpunkt "24:00" anzugeben.

Der Schlüssel "temp" enthält die Temperaturen, die zu den in "time" hinterlegten Schaltzeitpunkten eingestellt werden sollen. Dabei entspricht die Reihenfolge der Temperaturen der Reihenfolge der Zeitpunkte in "time".

Zur Übergabe an FHEM sollte die JSON Struktur von sämtlichen Formatierungen (Zeilenumbrüche, Tabs, überflüssige Leerzeichen) bereinigt werden, so dass ein einzeiliger String entsteht. Für das oben angegebene Beispiel würde das dann so aussehen:

<code><nowiki>{"Sun":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Sat":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Thu":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Fri":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Tue":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Wed":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]},"Mon":{"time":["06:00","22:00","24:00"],"temp":["20.0","22.0","20.0"]}}</nowiki></code>

==== Referenzprofil konfigurieren ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

==== Topic wiederherstellen ====
Dieser Befehl kommt nur zum Tragen, wenn per Attribut useTopics die Verwendung von Topics aktiviert wurde.

Siehe Commandref.

=== Modul Befehle: get ===

==== Wochenprofile exportieren ====
Siehe Commandref

==== Wochenprofilnamen exportieren ====
Siehe Commandref

==== Wochenprofil-Refrenzen exportieren ====
Siehe Commandref

=== Modul Attribute ===
Die meisten Attribute sind selbsterklärend. Daher wird an dieser Stelle zumeist auf die Informationen in der Commandref verwiesen.

==== Namen der Wochentage festlegen ====
widgetWeekdays: Siehe Commandref

==== Anzeigeart: Anzahl der Spalten====
widgetEditDaysInRow: Siehe Commandref

==== Anzeigeart: editieren auf neuer Seite ====
widgetEditOnNewPage: Siehe Commandref

==== Pfad zur Konfigurationsdatei ====
configFile: Siehe Commandref

==== Verwendung von Topics ====
useTopics: Aktiviert den Betriebsmodus: Topics

== bekannte Probleme ==
* Derzeit (Version: 10924) können keine Leerzeichen oder Umlaute verwendet werden. Leerzeichen werden bei der Eingabe abgefangen. Hat man versehentlich doch Umlaute verwendet, müssen in der Datei ./log/weekprofile-<name>.cfg die entsprechenden Zeilen manuell gelöscht/umbenennt werden und danach ein rereadcfg ausführt werden.
* Speichert man einen Wochenplan, wird die Änderung erst nach einem reload der Seite angezeigt.

== Links ==
*[http://forum.fhem.de/index.php/topic,46117.0.html Thread] im FHEM-Forum
*[http://www.jsoneditoronline.org/ JSON-Editor] für eine einfache Bearbeitung der JSON Daten

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-25T18:50:50Z

LHBL2003: /* Verwendung AES in FHEM */ Link korrektur

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael (Linux Befehl: "sudo apt-get install libcrypt-rijndael-perl" siehe auch unter [[Raspberry Pi]]) benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus FHEM aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.

Bekannte Probleme: Nachdem die Firmware 1.1.5 über die Software Netfinder geladen wurde, wird das Gateway automatisch neu gestartet. Nach dem Neustart wird im Netfinder eine ältere Version angezeigt (z.B. vorher 1.1.3 nachher 1.1.1). Am Homatic Gateway muss der Netzstecker gezogen und wieder gesteckt werden. Nach dem Neustart wird dann die richtige Version angezeigt.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit FHEM ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry
ssh pi@ipadresse
b: Wechseln Sie in das Firmware Verzeichnis von FHEM
cd /opt/fhem/FHEM/firmware/
c: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in FHEM
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-25T18:48:36Z

LHBL2003: /* Verwendung AES in FHEM */ Link zu Rijndael Konfiguration

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael (Linux Befehl: "sudo apt-get install libcrypt-rijndael-perl" siehe auch unter [[Planung]]) benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus FHEM aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.

Bekannte Probleme: Nachdem die Firmware 1.1.5 über die Software Netfinder geladen wurde, wird das Gateway automatisch neu gestartet. Nach dem Neustart wird im Netfinder eine ältere Version angezeigt (z.B. vorher 1.1.3 nachher 1.1.1). Am Homatic Gateway muss der Netzstecker gezogen und wieder gesteckt werden. Nach dem Neustart wird dann die richtige Version angezeigt.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit FHEM ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry
ssh pi@ipadresse
b: Wechseln Sie in das Firmware Verzeichnis von FHEM
cd /opt/fhem/FHEM/firmware/
c: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in FHEM
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

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

2017-01-25T18:39:33Z

LHBL2003: Position Link Weekprofile korrigiert

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

2017-01-25T18:35:52Z

LHBL2003: /* Channel (Kanal) 05 _ClimaTeam */ Verlinkung auf das Modul Weekprofile

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-23T07:51:55Z

LHBL2003: /* Firmware */

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus Fhem aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.

Bekannte Probleme: Nachdem die Firmware 1.1.5 über die Software Netfinder geladen wurde, wird das Gateway automatisch neu gestartet. Nach dem Neustart wird im Netfinder eine ältere Version angezeigt (z.B. vorher 1.1.3 nachher 1.1.1). Am Homatic Gateway muss der Netzstecker gezogen und wieder gesteckt werden. Nach dem Neustart wird dann die richtige Version angezeigt.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit Fhem ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry
ssh pi@ipadresse
b: Wechseln Sie in das Firmware Verzeichnis von Fhem
cd /opt/fhem/FHEM/firmware/
c: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in Fhem
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-23T07:51:28Z

LHBL2003: /* Firmware */

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus Fhem aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.
Bekannte Probleme: Nachdem die Firmware 1.1.5 über die Software Netfinder geladen wurde, wird das Gateway automatisch neu gestartet. Nach dem Neustart wird im Netfinder eine ältere Version angezeigt (z.B. vorher 1.1.3 nachher 1.1.1). Am Homatic Gateway muss der Netzstecker gezogen und wieder gesteckt werden. Nach dem Neustart wird dann die richtige Version angezeigt.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit Fhem ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry
ssh pi@ipadresse
b: Wechseln Sie in das Firmware Verzeichnis von Fhem
cd /opt/fhem/FHEM/firmware/
c: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in Fhem
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-18T18:42:20Z

LHBL2003:

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus Fhem aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit Fhem ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry
ssh pi@ipadresse
b: Wechseln Sie in das Firmware Verzeichnis von Fhem
cd /opt/fhem/FHEM/firmware/
c: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in Fhem
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

HM-LGW-O-TW-W-EU Funk-LAN Gateway

2017-01-18T18:40:27Z

LHBL2003: Firmware herunterladen für Fhem detaillierter beschrieben

{{Infobox Hardware
|Bild=HM-LGW-O-TW-W-EU-2.jpg
|Bildbeschreibung=HomeMatic Funk-LAN Gateway
|HWProtocol=HomeMatic
|HWType=Gateway
|HWCategory=HomeMatic
|HWComm=868,3/869,525 MHz
|HWChannels=n/a
|HWVoltage=5V DC
|HWPowerConsumption=0,8W
|HWPoweredBy=DC-Buchse
|HWSize=116x150x34mm
|HWDeviceFHEM=[[HMUARTLGW]]
|HWManufacturer=ELV / eQ-3
}}

Das [[HM-LGW-O-TW-W-EU Funk-LAN Gateway|HM-LGW-O-TW-W-EU(-2) Funk-LAN Gateway]] ist ein [[Interface]] zu [[HomeMatic]] Geräten, ähnlich dem [[HM-CFG-LAN LAN Konfigurations-Adapter|LAN Konfigurations-Adapter]]. Die folgende Beschreibung bezieht sich sowohl auf HM-LGW-O-TW-W-EU als auch auf HM-LGW-O-TW-W-EU-2 (wenn nicht anders angegeben).

== Features ==
(Noch zu ergänzen)
* ...

== Hinweise zum Betrieb mit FHEM ==
Juni 2016: Beginn der Entwicklung eines FHEM-Moduls (HMUARTLGW) für dieses Interface, beschrieben im Forum unter dem Titel {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}. Dieses Modul unterstützt gleichzeitig auch das [[HM-MOD-RPI-PCB HomeMatic Funkmodul für Raspberry Pi|Funkmodul für Raspberry Pi]].

Juli 2016: [[HMUARTLGW]] wird über FHEM [[update]] verteilt, damit ist dieses Funkmodul offiziell unterstützt.

=== Definition in FHEM ===

define meinLGW HMUARTLGW 192.168.42.23
attr meinLGW lgwPw LGWPasswort
attr meinLGW hmId xxxxxx

=== Verwendung AES in FHEM===
Das Modul beherrscht von sich aus AES zu den Geräten. Für weitere Informationen zum Thema Verschlüsselung gibt es den Beitrag [[AES Encryption]].
Soll auch die LAN Kommunikation verschlüsselt ablaufen wird das Modul Crypt::Rijndael benötigt (siehe auch Meldung im Log).
Die LAN Verschlüsselung kann mit dem Tool Lankonfigurator (netfinder) von eq3 aktiviert oder deaktiviert werden. Im Auslieferungszustand ist sie aktiviert.
Da das Modul Crypt::Rijndael für die Kommunikation mit den Rauchmeldern SD2 auch benötigt wird, kann man dieses Modul per default installieren.

=== Firmware ===

Es sollte darauf geachtet werden, dass die beiden Firmware-Versionen des Funk-LAN Gateway aktuell sind (aktuell: Applikation: 1.4.1, LAN: 1.1.5). LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme.

Die Applikationsfirmware kann direkt aus Fhem aktualisiert werden, für die Aktualisierung der LAN-Firmware wird entweder der [http://www.eq-3.de/service/downloads.html?id=53 HomeMatic Netfinder] (Java, läuft unter Linux/OSX/Windows, [https://github.com/eq-3/occu/raw/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/hm-lgw-o-tw-w-eu_update.eq3 passendes Firmware-Image v. 1.1.5]) oder die eQ-3 Tools unter Linux benötigt. Die eQ-3 Tools liegen nur in 32bit vor, weshalb auf einem x86_64 System (amd64) noch die 32bit Kompatibilitätsbibliotheken ''libc6-i386'' und ''lib32stdc++6'' installiert werden müssen.

(Im folgenden "NEQ0218723" durch die eigene Seriennummer des Funk-LAN Gateway ersetzen und "geheimesLGWPasswort" durch das LGW-Passwort. Falls die Verschlüsselung deaktiviert wurde, dann das -k komplett weglassen.

=== Vorbereitung des LAN-Firmwareupdates mit den eQ-3 Tools ===

Installation der Kompatibilitätsbibliotheken (nur auf x86_64/amd64 ohne konfiguriertes Multiarch):
$ sudo apt-get install libc6-i386 lib32stdc++6

Auschecken und Vorbereitung der eQ-3-Tools:
$ git clone https://github.com/eq-3/occu
...
$ cd occu
$ sudo ln -s $(pwd)/firmware /firmware

Auf arm:
$ cd arm-gnueabihf/packages-eQ-3/LinuxBasis/bin

Auf x86 bzw. x86_64:
$ cd X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin (auf X86/X86_64)

Wieder gemeinsam auf allen Plattformen:
$ chmod 755 eq3configcmd

=== Update der LAN-Firmware mit den eQ-3 Tools ===

Um das Update durchzuführen, muss man sich im Verzeichnis ''occu/arm-gnueabihf/packages-eQ-3/LinuxBasis/bin'' bzw. ''occu/X86_32_Debian_Wheezy/packages-eQ-3/LinuxBasis/bin'' befinden.

$ LD_LIBRARY_PATH=../lib:../../RFD/lib ./eq3configcmd update-lgw-firmware -u ../../../../firmware/hm-lgw-o-tw-w-eu_update.eq3 -console -l 1 -s NEQ0218723 -k 'geheimesLGWPasswort'
2016/07/28 09:25:24.264 <Info> LAN Gateway Firmware Update...

2016/07/28 09:25:24.265 <Info> Gateway NEQ0218723
2016/07/28 09:25:26.273 <Info> Gateway type is eQ3-HM-LGW-App
cryptEnabled true2016/07/28 09:25:33.313 <Info> Updating firmware....

2016/07/28 09:25:38.467 <Info> Update performed. Waiting for gateway to get ready.

=== Update der Applikationsfirmware mit Fhem ===

1. Firmware herunterladen
a: Verbinden Sie sich auf ihren Raspberry und wechseln Sie in das Firmware Verzeichnis von Fhem
cd /opt/fhem/FHEM/firmware/
b: Firmware Downloaden
wget https://raw.githubusercontent.com/eq-3/occu/28045df83480122f90ab92f7c6e625f9bf3b61aa/firmware/coprocessor_update_hm_only.eq3
2. Flashen der neuen Firmware über die Befehlszeile in Fhem
set meinLGW updateCoPro /opt/fhem/FHEM/firmware/coprocessor_update_hm_only.eq3

=== Logbeispiel ===

== Bekannte Probleme ==
Das LGW hat (anders als das UART-Modul) keine eigene ''hmId'' (das Reading ''D-HMIdOriginal'' ist auf FFFFFF gesetzt). Es muss also mit
:<code>attr meinLGW hmId xxxxxx</code>
eine nach den in der [http://fhem.de/commandref.html#hmId commandref] definierten Regeln gewählte Id gesetzt werden.

== Links ==
* {{Link2Forum|Topic=41203|LinkText=Forenthread}} mit Nachfrage zur Unterstützung dieses Geräts in FHEM
* {{Link2Forum|Topic=54511|LinkText=Modul für HomeMatic UART-Modul (RPi) und HomeMatic LAN Gateway}}
* [http://www.elv.de/homematic-funk-lan-gateway.html Produktseite] bei ELV
* {{DocLink|elv|/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Bedienungsanleitung}}

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

FHEM Tablet UI

2016-12-19T21:36:00Z

LHBL2003: data-type="thermostat" für HomeMatic um ValvePosition erweitert

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

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

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

Raspberry Pi

2016-12-01T07:32:23Z

LHBL2003: Perl JSON: Im Befehl fehlte die Angabe sudo

Beim '''Raspberry Pi''' handelt es sich um einen postkartengroßen Einplatinen-Computer, der von der Raspberry Pi Foundation entwickelt wird. Die Hardware basiert auf dem BCM 283x SoC (System-on-Chip) von Broadcom, einem ARM-Prozessor. Zu Hardwaredetails und den verschiedenen Modellen sowie Produktentwicklungen siehe [http://de.wikipedia.org/wiki/Raspberry_Pi#Hardware Wikipedia].
Dank der kleinen Abmessungen, dem recht geringen Energieverbrauch (bis ca. 4 Watt) sowie der günstigen Anschaffungskosten (ca. 30€) ist der Raspberry Pi eine attraktive Hardware für die Heimautomatisierung mit FHEM. Er ist dank dem Linux-Betriebssystem vollständig kompatibel zur aktuell vorhandenen und von FHEM unterstützen Hardware. Das derzeit empfohlene Standard-Image zum Betrieb des Raspberry Pi ist die auf Debian basierende Raspbian Distribution.

== Installation / Setup ==
=== Betriebssystem ===
Das Betriebssystem sollte direkt bei Raspberry unter dem Link [http://www.raspberrypi.org/downloads http://www.raspberrypi.org/downloads] ([http://downloads.raspberrypi.org/raspbian_latest Raspbian]) geholt werden.

Nach dem Herunterladen des entsprechenden Archivs muss das Image entpackt und auf die Speicherkarte (SD-Karte bis Modell B / MicroSD ab Modell B+) geschrieben werden. Detaillierte englische Anleitungen zum Vorgehen für verschiedene Betriebssysteme stellt Raspberry [http://www.raspberrypi.org/documentation/installation/installing-images/README.md hier] zur Verfügung.

Unter '''Unix/Linux''' erfolgt dies via dd-Befehl. Zum Beispiel:
:<code>sudo dd bs=1M if=2012-08-16-wheezy-raspbian.img of=/dev/sdz</code>

'''Achtung:''' Bei Angabe eines falschen Device hinter of= kann der Anfang der eigenen Festplatte überschrieben werden. (Datenverlust!)

Je nach System/Distribution und vorhandenen Festplatten variiert das Device, z.B. /dev/mmcblk0 (Ubuntu), /dev/sdb, /dev/sdc oder /dev/rdisk1 (OSX). Folgende Möglichkeiten können helfen, das richtige Device zu ermitteln:
* Mit dem Befehl <code>df</code> erhält kann eine Übersicht aller angeschlossenen und gemounteten(!) Speichermedien.
* Beim Einstecken der Speicherkarte in den PC wird in die Log-Datei <code>/var/log/messages</code> ein Eintrag gemacht. Beispiel: <code>kernel: [2077612.776470] sd 14:0:0:0: ['''sdb'''] 7954432 512-byte logical blocks: ('''4.07 GB'''/3.79 GiB)</code>
* Mit dem Befehl fdisk kann die Größe eines bestimmten Devices geprüft werden: <code>fdisk -l /dev/sdb</code> Beispielausgabe: <code>Platte /dev/sdb: 4072 MByte, 4072669184 Byte</code>

Unter '''Windows''' kann das Tool [https://launchpad.net/win32-image-writer Win32DiskImager] genutzt werden.

Nach der Installation des Images sollte der Raspberry Pi von der Speicherkarte booten.

Um eventuell eine größere Speicherkarte komplett zu nutzen, kann dies per folgendem Menu erledigt werden:
:<code>sudo raspi-config</code>

=== Fhem ===
Die Installation auf dem Raspberry Pi kann nach der Installation des Betriebssystems über das Debian-Repository von FHEM, automatisiert per Skript oder auch manuell vorgenommen werden.

==== Debian-Repository ====
Seit Oktober 2014 ({{Link2Forum|Topic=27679}}) kann FHEM auf Debian-basierten Systemen, wozu auch Raspian OS zählt, aus einem Debian-Repository installiert werden. Dabei werden neben FHEM selbst alle für den Betrieb von FHEM unabdingbaren Pakete automatisch mit installiert und eine Reihe weiterer Pakete für die Installation vorgeschlagen. Details zur Vorgehensweise finden sich direkt auf [https://debian.fhem.de https://debian.fhem.de].

'''Hinweis:''' Bei manchen Distributionen ist es erforderlich die apt-Methode HTTPS nachzuinstallieren. Der folgende Befehl installiert die Methode:
<pre>sudo apt-get install apt-transport-https</pre>

==== Skript-basiert ====
Durch Ausführung des in diesem {{Link2Forum|Topic=15848|Message=103268}} dargestellten Skriptes nach Installation eines "nackten" Raspian OS wird automatisiert ein funktionsfähiges FHEM (inkl. korrekter Rechtevergabe) auf dem Raspberry Pi installiert.

'''Hinweis:''' Bei dieser Installationsweise erfolgt kein automatischer Start von FHEM. Um das zu erreichen, verwenden Sie die folgende "manuelle" Methode.

==== Manuell ====
Die Installation von FHEM auf dem Raspberry Pi kann mit dem fertigen debian-package erledigt werden. Lediglich das Perl-Modul "Serialport" wird benötigt - Perl ist in der Regel bereits installiert, kann aber sicherheitshalber einfach mit dem apt-get-Befehl zugefügt werden:

sudo apt-get install perl libdevice-serialport-perl
sudo apt-get install libio-socket-ssl-perl
# fhem-X.Y.deb bitte mit der [http://fhem.de/fhem.html#Download aktuellsten, stabilen Version] ersetzen
wget [http://fhem.de/fhem-X.Y.deb http://fhem.de/fhem-X.Y.deb]
sudo dpkg -i fhem-X.Y.deb

Möglicherweise ist es noch nötig, fehlende Abhängigkeiten aufzulösen. Das kann mit folgendem Befehl erledigt werden:
:<code>sudo apt-get install -f</code>

Eine etwas ausführlichere Anleitung gibt es auch [http://www.fhemwiki.de/wiki/FHEM_auf_Raspberry_PI_mit_COC_betreiben#FHEM_Installieren hier]

=== Nützliche Zusatzpakete ===
Nachdem der Rpi eingerichtet ist, können weitere Pakete installiert werden. Keines davon ist zwingend erforderlich, um FHEM grundsätzlich betreiben zu können. Einige Pakete erhöhen aber den Bedienungskomfort oder sind zur Nutzung bestimmter FHEM-Module erforderlich. Hier eine Übersicht.
{| class="wikitable"
! style="width:10%" | Beschreibung
! style="width:10%" | Paketname
! style="width:50%" | Kontext
! style="width:30%" | Installieren
|-
|FHEM
|fhem
|Installiert eine komplett lauffähige FHEM-Installation.
Details siehe auf [https://debian.fhem.de/ Stable build using aptitude], für Optionen siehe diesen [http://forum.fhem.de/index.php/topic,27679.0.html Forumsartikel]
Achtung: In der Befehlsliste rechts erstreckt sich der erste Befehl über 2 Zeilen!
| <code>sudo wget -qO - https://debian.fhem.de/archive.key <nowiki>|</nowiki> apt-key add -</code>
<code>sudo deb https://debian.fhem.de/stable ./</code>
<code>sudo apt-get update</code><br>
<code>sudo apt-get install fhem</code>
|-
|Zeitserver
|ntpdate
|Setzt die Systemzeit bei Start des RPi. Wird für FHEM benötigt, da es sonst nicht startet.
|<code>sudo apt-get install ntpdate
sudo ntpdate -u de.pool.ntp.org</code>
|-
|Perl JSON
|JSON
|Wird von einigen Modulen benötigt, z.B. harmony, iTunes
|<code>sudo apt-get install libjson-perl</code>
|-
|Samba-Server
|samba
|Mittels Samba kann man z.B. den Ordner /opt/fhem als Share freigeben. Dieser Share kann z.B. im Windows-Explorer als Laufwerk verbunden werden, so dass die Bearbeitung von config- und Programmdateien bequem möglich ist. Hier eine hilfreiche [https://www.elektronik-kompendium.de/sites/raspberry-pi/2007071.htm Kurzanleitung] aus der (wenn man auf einen speziellen user verzichtet) nur die Einträge für smb.conf gesetzt werden müssen.
|<code>sudo apt-get install samba cifs-utils</code>
Danach muss der share definiert werden mittels

<code>sudo nano /etc/samba/smb.conf</code>
|-
|Mailversand
|sendEmail
|Wird benötigt, um Mails versenden zu können, bspw. für Alarm-Benachrichtigungen.
Nach Installation des Paketes benötigt man noch eine Routine in FHEM gemäß [http://www.fhemwiki.de/wiki/E-Mail_senden#Raspberry_Pi diesem Forumsartikel]
|<code>sudo apt-get install sendEmail</code>
|-
|Wake-on-LAN
|etherwake
|Wird z.B. für das Modul WOL benötigt.
|<code>sudo apt-get install etherwake</code>
|-
|Perl Telnet
|telnet
|Wird z.B. für das Modul FRITZBOX benötigt, da es eine im Netzwerk vorhandene Fritzbox über deren Telnet-Port anspricht.
|<code>sudo apt-get install libnet-telnet-perl</code>
|-
|Socat
|socat
|Kann verwendet werden, um auf anderen Rechnern im Netzwerk Linux-Befehle oder Skripts auszuführen. Auch können auf Slave-FHEM-Installationen Befehl ausgeführt werden, z.B. mit

<code><nowiki>system("echo 'set lampe on' | /usr/bin/socat - TCP:1.2.3.4:7072");</nowiki></code>

1.2.3.4 muss natürlich durch die IP-Adresse des Zielrechners ersetzt werden.
|<code>sudo apt-get install socat</code>
|-
|Libcrypt
|Libcrypt
|Perl libcrypt, erforderlich falls Homematic-devices mit AES verwendet werden sollen.
|<code>sudo apt-get install libcrypt-rijndael-perl</code>
|-
|libdatetime
|libdatetime
|Perl libdatetime, erforderlich für das Weather-Modul.
|<code>sudo apt-get install libdatetime-format-strptime-perl</code>
|}

== Bekannte Probleme ==
=== Netzteil ===
Der RPi verwendet ein USB Netzteil als Spannungsversorgung. Gemessen kann der RPi allein bereits um die 900mA Strom fordern. Das bringt kleine Netzteile, besonders wenn noch CULs oder WLAN Sticks an USB hängen schnell an die Grenze. Die Fehler die daraus resultieren sind Abstürze, Netzwerkprobleme uvm. Daher bitte ein ausreichend starkes Netzteil mit mind. 2000mA oder einen aktiven USB-HUB für die Periperie verwenden.

=== Echtzeituhr ===
Der RPi hat keine [http://de.wikipedia.org/wiki/Echtzeituhr Real-Time-Clock] (RTC), das heißt, dass er nach einem Neustart keine gültige (im Sinne von aktuell) Systemzeit hat, sondern ein Datum in der Vergangenheit. Dieses Problem wird sinnvollerweise mit einer [http://de.wikipedia.org/wiki/Network_Time_Protocol NTP-Konfiguration] umgangen.

Dabei muss Sorge getragen werden, dass der [http://wiki.debian.org/NTP ntpd] schon einen Datums-/Zeitabgleich gemacht hat, bevor FHEM gestartet wird. Geschieht der Abgleich nicht vorher, sondern erst nachdem FHEM schon läuft, stellt FHEM die Logs zwar auf das nun aktuelle Datum um (die "alten" Logs mit dem eigentlich ungültigen Datum werden natürlich behalten), aber irgendetwas scheint FHEM dabei so zu belasten, dass es eine Last von über 0.8 bis 0.9 erzeugt. Diese Last besteht auf Dauer und verschwindet erst, wenn man das Ganze sauber durchkonfiguriert und FHEM neu gestartet hat. Die hohe Systemauslastung zeigt sich auch in einem sehr trägen Laden der FHEM-Webseiten in einem beliebigen Browser.

=== Last durch Backup (während update) ===
Bei einen [[Update]] von FHEM durch den Befehl <code>update</code> kann durch Setzen des Attributs "<code>attr global backup_before_update 1</code>" automatisch vorab ein [[Backup]] durchgeführt werden. Die (ggf. großen) Log-Dateien werden dabei ebenfalls archiviert. Während der Archivierung ist FHEM blockiert. Durch die beschränkte Leistungsfähigkeit des Raspberry Pi kann das Backup zudem lange dauern. Durch ein "<code>attr global updateInBackground 1</code>" wird ein Backup im Hintergrund ausgeführt (Quelle: {{Link2Forum|Topic=15729}}).

Alternative Möglichkeiten:
* Backup ausschalten und manuell durchführen
* Backup-Befehl anpassen und so große Dateien bzw. Verzeichnisse (log/) nicht archivieren

=== SD-Kartenfehler / Dateisystemfehler durch Stromausfall ===
Standardmässig läuft der RPi von der SD-Karte. Diese sind gegenüber Stromausfällen relativ empfindlich und es kommt immer wieder zu Schreib/Lesefehlern. Dies kann durch den Einsatz von unterbrechungsfreien Stromversorgungen umgangen werden. Eine andere Lösung ist der Einsatz von USB-Sticks als "root-Dateisystem" nach dem Start. USB-Sticks sind in der Regel besser gegen Fehler bei spontanem Spannungsausfall (Ausstecken) geschützt als SD-Karten. Anleitungen dies beim RPi zu konfigurieren sind abhängig von verwendeten Version des RPi online zu finden.

== Watchdog einrichten ==
Vor allem wenn das Netzteil nicht stark genug ist, schmiert FHEM gelegentlich ab (siehe oben - Netzteil). Man kann den RPi alle halbe Stunde prüfen lassen, ob FHEM noch läuft, und ggf. einen Neustart durchführen lassen.
Wie man das einrichtet steht hier: [http://forum.fhem.de/index.php/topic,20553.0.html Einrichten eines Watchdog]

== Interne Links ==
* Erste Schritte: [[FHEM auf Raspberry PI mit COC betreiben]]
* [[CUL am Raspberry Pi flashen]]
* [[Raspberry Pi und 1-Wire]]

== Externe Links ==
* {{Link2Forum|Topic=33460|Message=264679}} zum Umzug von Raspberry B auf Raspberry Pi 2
* [http://www.raspberrypi.org/ Offizielle Webseite der Raspberry Pi Foundation]
* [http://www.raspberrypi.org/downloads Offizielle Downloads der Raspberry Pi Foundation]
* Blog mit dem Thema [http://www.meintechblog.de/2013/05/fhem-server-auf-dem-raspberry-pi-in-einer-stunde-einrichten/ FHEM-Server auf RaspBerry Pi in einer Stunde einrichten]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

E-Mail senden

2016-12-01T07:27:00Z

LHBL2003: Platzhalter Bezeichnungen für SendMail überarbeitet um besser zu verstehen, was eingetragen werden muss.

Um aus FHEM heraus '''E-Mail senden''' zu können, sind abhängig von der verwendeten Platform unterschiedliche Vorgehensweisen erforderlich.

{{Randnotiz|RNTyp=y|RNText=Anleitung zur Einrichtung von Exim4 auf Debian mit GMX als Smarthost:[http://www.fhemwiki.de/w/images/f/f6/Anleitung_Exim4_Debian_GMX.pdf PDF]}}

== Linux ==
=== FritzBox 7170 (non-chroot) oder "reine" Linuxe ===
Datei 99_email.pm im Modul-Verzeichnis mit folgender Funktion anlegen (oder in bestehende 99_irgendwas.pm kopieren):

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" | /usr/bin/mail send -i - -s \"$subject\" -t \"$rcpt\"");
}</nowiki>
Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
Darauf achten, dass der fhem-User Mails senden darf (in richtige Gruppe eintragen. Ggf. vorher einmal su fhem und probieren).

=== Fritz!Box 7390 ===
Auf der [[AVM Fritz!Box|FritzBox 7390]] ist diese Funktion seit 10/2012 Bestandteil der Fhem Standardauslieferung. Sie ist untergebracht in FritzBoxUtils.pm und heisst dort FB_mail($$$) (Groß-Kleinschreibung beachten).

Da der Dateiname von FritzBoxUtils.pm nicht mit 99_ beginnt, wird diese Programmdatei nicht automatisch beim Start von Fhem geladen. Fhem muss zum Laden dieser Programmdatei aufgefordert werden. Dazu (z. B. in 99_myUtils.pm) die Zeile ''use FritzBoxUtils;'' einfügen.

Mit dem Install von AVM.de wird fhem in einer chroot-Umgebung ausgeführt, die den Zugriff auf die Mailfunktion der Fritzbox nicht zulässt. Daher muss Fhem in der [http://fhem.de/fhem.html#Download Version von fhem.de] installiert sein. Sollte Ihre Fritzbox bisher mit dem install von AVM laufen, kann (nach einem backup!) das image von fhem.de einfach drüberinstalliert werden. Es sollten dabei alle Einstellungen erhalten bleiben.

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" > /var/tmp/fhem_nachricht.txt");
system("/sbin/mailer send -i '/var/tmp/fhem_nachricht.txt' -s \"$subject\" -t \"$rcpt\"");
system("rm /var/tmp/fhem_nachricht.txt");
}</nowiki>

Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
bzw.
:<code>{ FB_mail('empfaenger@mail.de','Subject','text 123') }</code>

Dem Mailer können noch weitere Parameter hinzugefügt werden. Mehr dazu siehe: [http://www.wehavemorefun.de/fritzbox/Mailer Mailer]

=== OpenWRT ===
Die Anleitung wurde mit einer frühen Beta von Barrier Breaker (r391xx) mit einem TP_Lind WDR 4900 getestet. Da "sendEmail" nicht als Package vorliegt wird in dieser Anleitung "ssmtp" verwendet.
Die Installation erfolgt mittels:

<pre>
opkg update
opkg install ssmtp_2.64-4_mpc85xx.ipk
</pre>

Hierbei werden die Packete libopenssl und zlib mit installiert. Damit ssmtp funktioniert müssen die Dateien /etc/ssmtp/ssmtp.conf und /etc/ssmtp/revaliases angepasst werden.

/etc/ssmtp/ssmtp.conf
<nowiki>root=arnold@gmx.net
mailhub=mail.gmx.net:465
rewriteDomain=gmx.net
hostname=gmx.net
FromLineOverride=YES
UseTLS=YES
#UseSTARTTLS=YES
AuthUser=arnold@gmx.net
AuthPass=Passwort_von_arnold@gmx.net
</nowiki>

/etc/ssmtp/revaliases
<nowiki>
root:arnold@gmx.net:mail.gmx.net:465</nowiki>

In der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen (von der RPi-Anleitung übernommen):

<nowiki>sub
OpenWRTMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "dockstar\@heye-tammo.de";
Log 1, "sendEmail RCP: $rcpt, Subject: $subject, Text: $text";
$ret .= qx(echo -e 'to:$rcpt\n from:$sender\nsubject:$subject\n$text\n' | ssmtp $rcpt);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

Ab hier den entsprechenden Abschnitt unter "Raspberry Pi" lesen.

=== Synology DiskStation ===
Beim DSM 3.2 gab es keinen <code>sendmail</code>-Befehl, sondern nur eine Funktion für den Versand der System-Benachrichtigungen. Interessanterweise funktionierte aber der <code>php-mail</code>-Befehl, so dass man mittels folgendem Modul Mails frei versenden kann:

<nowiki>sub sendmail($$$) {
my($empf, $subj, $nachricht) = @_;
system("php -r 'mail(\"$empf\",\"$subj\",\"$nachricht\");'");
undef;
}</nowiki>

=== Raspberry Pi ===
In der weezy-Version, wie sie von busware zur Verfügung gestellt wird, muss auf einem [[Raspberry Pi]] noch sendEmail nachinstalliert werden. Diese Anleitung funktioniert auch unter '''Ubuntu'''.

<pre>
sudo apt-get update
sudo apt-get install sendEmail libio-socket-ssl-perl libnet-ssleay-perl perl
</pre>

in der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen:

<nowiki>######## DebianMail Mail auf dem RPi versenden ############
sub
DebianMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $attach = shift;
my $ret = "";
my $sender = "absender\@account.de";
my $konto = "kontoname\@account.de";
my $passwrd = "passwrd";
my $provider = "smtp.provider.de:587";
Log 1, "sendEmail RCP: $rcpt";
Log 1, "sendEmail Subject: $subject";
Log 1, "sendEmail Text: $text";
Log 1, "sendEmail Anhang: $attach";

$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -a $attach -s '$provider' -xu '$konto' -xp '$passwrd' -o tls=auto -o message-charset=utf-8);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

Um die TLS Verschlüsselung (ehem. SSL) nicht zu nutzen, muss in der 4. letzten Zeile tls=no verwendet und der Port des Mailproviders auf 25 eigetragen werden. Sollte anschließend keine Mail verschickt werden, siehe Probleme.

Falls der Body-Text in einem (Android-)Mailer auf dem Handy nicht gezeigt wird, kann der Parameter '''-o message-content-type=html''' helfen.

Die Funktion kann beispielsweise folgendermaßen aufgerufen werden:
{{Randnotiz|RNTyp=g|RNText=Bei allen Feldern können generell doppelte " oder einfache ' Anführungszeichen verwendet werden. Innerhalb von "" müssen Sonderzeichen wie @ aber maskiert werden, da sie sonst als Steuerzeichen interpretiert werden:
<nowiki>"email\@email.domain" oder 'email@email.domain'</nowiki> }}

<nowiki>define Sonstiges notify Fenster:Window:.*,.*Low.Batt*. {\
DebianMail("email\@email.domain","Subject","Text","'Anhang1' 'Anhang2' ...");;\
}</nowiki>

oder (mehr als einen Empfänger, diese können durch Leerzeichen, Semikolon oder Komma getrennt sein)

<nowiki>define Sonstiges at *01:00:00 {\
DebianMail('email@email.domain,email2@email.domain',"Subject","Text","'Anhang1' 'Anhang2' ...");;\
}</nowiki>

Es ist wichtig die Dateinamen mit ' ' zu klammern, da hierdurch auch Leerzeichen im Pfad/Dateinamen möglich sind.

=== BeagleBoard-xM ===
Auf einem [[:Kategorie:BeagleBoard-xM|BeagleBoard-xM]] mit einem [http://en.opensuse.org/HCL:BeagleBoard-xM OpenSUSE 12.2] kann man ebenfalls das Perl-Programm ''sendEmail'' wie beim RPi nutzen. Dies gibt es aber nicht in den Repositories von openSUSE, sondern man muss sich ''sendEmail'' als Source herunterladen. Das geht am einfachsten per ''wget'', welches man ebenfalls erst installieren muss (aber aus einem Repository).

<nowiki>$ zypper in wget
$ cd /opt
$ wget http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v1.56.tar.gz
$ tar xvfz sendEmail-v1.56.tar.gz
$ cd sendEmail-v1.56
$ cp sendMail /usr/local/bin</nowiki>
Dann geht man weiter vor wie unter RPi beschrieben (anlegen der SUB-Routine in 99_myUtils usw.).

'''Hinweis:''' Die Version 1.56 von ''sendEmail'' ist Stand Januar 2013 die aktuelle. Da diese Programmversion von 2009 stammt, ist mit neuen Versionen selten zu rechnen. Vielleicht schauen Sie trotzdem vorher auf der [http://caspian.dotconf.net/menu/Software/SendEmail/ Homepage von sendEmail] nach.

== Windows ==
# Kopiere die Datei sendEmail.exe* in Dein FHEM Verzeichnis (hier c:\fhem-5.0\); Quelle: [http://caspian.dotconf.net/menu/Software/SendEmail/ http://caspian.dotconf.net/menu/Software/SendEmail/]
# Erstelle im FHEM Verzeichnis die Datei wmail.bat mit folgendem Inhalt (eine Zeile): <br><code>sendEmail -f absender@domain.de -u "%1" -m " " -s SMTP-SERVERAdresse -xu SMTP_USERNAME -xp SMTP_PASSWORT -t empfänger@domain.de -o message-header="X-Message-Flag: FHEM"</code>
# Beispiel fhem.cfg
## Mail wenn sich der Status von Heizung.* oder Hzg.* ändert <br><code>define Mail_Heizung notify Heizung.*|Hzg.* { system("wmail $NAME:$EVENT")}</code>
## Mail bei Signal Aussentemperatur (für dieses Beispiel wird [http://fhem.de/commandref.html#getstate http://fhem.de/commandref.html#getstate getstate] benötigt) <br><code>define Mail_Aussentemperatur notify Aussentemperatur {\</code><br><code>my ($val);;\</code><br><code>$val = fhem "getstate $NAME";;\</code><br><code>system("wmail \"$NAME: $val\"");;\</code><br><code>}</code>

== Probleme ==
=== sendEmail ===
Falls man keine E-Mails verschicken kann, kann man in einem ersten Test prüfen, ob sendEmail als solches funktioniert und die Konfiguration (Benutzer, Passwort, Server-Name usw.) des Mail-Kontos, über das die Mails abgesetzt werden sollen, richtig ist.

Hierzu setzt man in der FHEM-Befehlszeile die folgende Anweisung ab:
:<code>{ SUB-Routinen-Name('EMailAdresse@Mail.Domain','Test','Test-Text');; }</code>
und ersetzt ''SUB-Routinen-Name'' durch den Namen der in 99_myUtils erzeugten Prozedur. Statt ''EMailAdresse@Mail.Domain'' trägt man noch eine gültige E-Mail-Adresse ein und bestätigt den Befehl dann mittels <Enter> (nicht "save"). Empfangen Sie nicht kurzfristig eine entsprechende E-Mail, ist sehr wahrscheinlich an den Zugangsdaten etwas verkehrt.

Vor dem testen der Routine oben kann sendEmail auch über die Konsole (z. B. via Putty) getestet werden:
:<code>sendEmail -f 'Absender@AbsDomain.de' -t 'Empfänger@EmpfDomain.de' -u 'subject' -m 'body' -s 'smtp.AbsDomain.de' -xu 'AbsenderBenutzername' -xp 'AbsenderPasswort' -o tls=yes</code>

=== Keine Mail mit TLS Verschlüsselung ===
Den Test über die Konsole durchführen. Erhält man folgende Fehlermeldung:
''invalid SSL_version specified at /usr/share/perl5/IO/Socket/SSL.pm line 332''
muss auf dem Raspberry folgende Datei angepasst werden: ''/usr/bin/sendEmail''.
In Zeile 1907 muss
if (! IO::Socket::SSL->start_SSL($SERVER, SSL_version => 'SSLv3 TLSv1')) {

in folgendes geändert werden
if (! IO::Socket::SSL->start_SSL($SERVER, SSL_version => 'SSLv23:!SSLv2')) {

Der frühere Tipp direkt in der SSL.pm Datei zu editieren führt zu Problemen wenn man auf FHEM per HTTPS zugreifen will und ist daher nicht zu empfehlen.

== Email laut Log gesendet aber nicht angekommen? ==
Dann bitte in der Fritzbox Oberfläche überpüfen, ob unter "System" -> "Push Service" selbiger eingerichtet und aktiviert wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:FritzBox]]
[[Kategorie:BeagleBoard-xM]]
[[Kategorie:Raspberry Pi]]

Raspberry Pi

2016-12-01T07:22:07Z

LHBL2003: Änderung Link für Samba-Server auf ein anderen Bericht, da das Beispiel zuvor nicht funktionierte.

Beim '''Raspberry Pi''' handelt es sich um einen postkartengroßen Einplatinen-Computer, der von der Raspberry Pi Foundation entwickelt wird. Die Hardware basiert auf dem BCM 283x SoC (System-on-Chip) von Broadcom, einem ARM-Prozessor. Zu Hardwaredetails und den verschiedenen Modellen sowie Produktentwicklungen siehe [http://de.wikipedia.org/wiki/Raspberry_Pi#Hardware Wikipedia].
Dank der kleinen Abmessungen, dem recht geringen Energieverbrauch (bis ca. 4 Watt) sowie der günstigen Anschaffungskosten (ca. 30€) ist der Raspberry Pi eine attraktive Hardware für die Heimautomatisierung mit FHEM. Er ist dank dem Linux-Betriebssystem vollständig kompatibel zur aktuell vorhandenen und von FHEM unterstützen Hardware. Das derzeit empfohlene Standard-Image zum Betrieb des Raspberry Pi ist die auf Debian basierende Raspbian Distribution.

== Installation / Setup ==
=== Betriebssystem ===
Das Betriebssystem sollte direkt bei Raspberry unter dem Link [http://www.raspberrypi.org/downloads http://www.raspberrypi.org/downloads] ([http://downloads.raspberrypi.org/raspbian_latest Raspbian]) geholt werden.

Nach dem Herunterladen des entsprechenden Archivs muss das Image entpackt und auf die Speicherkarte (SD-Karte bis Modell B / MicroSD ab Modell B+) geschrieben werden. Detaillierte englische Anleitungen zum Vorgehen für verschiedene Betriebssysteme stellt Raspberry [http://www.raspberrypi.org/documentation/installation/installing-images/README.md hier] zur Verfügung.

Unter '''Unix/Linux''' erfolgt dies via dd-Befehl. Zum Beispiel:
:<code>sudo dd bs=1M if=2012-08-16-wheezy-raspbian.img of=/dev/sdz</code>

'''Achtung:''' Bei Angabe eines falschen Device hinter of= kann der Anfang der eigenen Festplatte überschrieben werden. (Datenverlust!)

Je nach System/Distribution und vorhandenen Festplatten variiert das Device, z.B. /dev/mmcblk0 (Ubuntu), /dev/sdb, /dev/sdc oder /dev/rdisk1 (OSX). Folgende Möglichkeiten können helfen, das richtige Device zu ermitteln:
* Mit dem Befehl <code>df</code> erhält kann eine Übersicht aller angeschlossenen und gemounteten(!) Speichermedien.
* Beim Einstecken der Speicherkarte in den PC wird in die Log-Datei <code>/var/log/messages</code> ein Eintrag gemacht. Beispiel: <code>kernel: [2077612.776470] sd 14:0:0:0: ['''sdb'''] 7954432 512-byte logical blocks: ('''4.07 GB'''/3.79 GiB)</code>
* Mit dem Befehl fdisk kann die Größe eines bestimmten Devices geprüft werden: <code>fdisk -l /dev/sdb</code> Beispielausgabe: <code>Platte /dev/sdb: 4072 MByte, 4072669184 Byte</code>

Unter '''Windows''' kann das Tool [https://launchpad.net/win32-image-writer Win32DiskImager] genutzt werden.

Nach der Installation des Images sollte der Raspberry Pi von der Speicherkarte booten.

Um eventuell eine größere Speicherkarte komplett zu nutzen, kann dies per folgendem Menu erledigt werden:
:<code>sudo raspi-config</code>

=== Fhem ===
Die Installation auf dem Raspberry Pi kann nach der Installation des Betriebssystems über das Debian-Repository von FHEM, automatisiert per Skript oder auch manuell vorgenommen werden.

==== Debian-Repository ====
Seit Oktober 2014 ({{Link2Forum|Topic=27679}}) kann FHEM auf Debian-basierten Systemen, wozu auch Raspian OS zählt, aus einem Debian-Repository installiert werden. Dabei werden neben FHEM selbst alle für den Betrieb von FHEM unabdingbaren Pakete automatisch mit installiert und eine Reihe weiterer Pakete für die Installation vorgeschlagen. Details zur Vorgehensweise finden sich direkt auf [https://debian.fhem.de https://debian.fhem.de].

'''Hinweis:''' Bei manchen Distributionen ist es erforderlich die apt-Methode HTTPS nachzuinstallieren. Der folgende Befehl installiert die Methode:
<pre>sudo apt-get install apt-transport-https</pre>

==== Skript-basiert ====
Durch Ausführung des in diesem {{Link2Forum|Topic=15848|Message=103268}} dargestellten Skriptes nach Installation eines "nackten" Raspian OS wird automatisiert ein funktionsfähiges FHEM (inkl. korrekter Rechtevergabe) auf dem Raspberry Pi installiert.

'''Hinweis:''' Bei dieser Installationsweise erfolgt kein automatischer Start von FHEM. Um das zu erreichen, verwenden Sie die folgende "manuelle" Methode.

==== Manuell ====
Die Installation von FHEM auf dem Raspberry Pi kann mit dem fertigen debian-package erledigt werden. Lediglich das Perl-Modul "Serialport" wird benötigt - Perl ist in der Regel bereits installiert, kann aber sicherheitshalber einfach mit dem apt-get-Befehl zugefügt werden:

sudo apt-get install perl libdevice-serialport-perl
sudo apt-get install libio-socket-ssl-perl
# fhem-X.Y.deb bitte mit der [http://fhem.de/fhem.html#Download aktuellsten, stabilen Version] ersetzen
wget [http://fhem.de/fhem-X.Y.deb http://fhem.de/fhem-X.Y.deb]
sudo dpkg -i fhem-X.Y.deb

Möglicherweise ist es noch nötig, fehlende Abhängigkeiten aufzulösen. Das kann mit folgendem Befehl erledigt werden:
:<code>sudo apt-get install -f</code>

Eine etwas ausführlichere Anleitung gibt es auch [http://www.fhemwiki.de/wiki/FHEM_auf_Raspberry_PI_mit_COC_betreiben#FHEM_Installieren hier]

=== Nützliche Zusatzpakete ===
Nachdem der Rpi eingerichtet ist, können weitere Pakete installiert werden. Keines davon ist zwingend erforderlich, um FHEM grundsätzlich betreiben zu können. Einige Pakete erhöhen aber den Bedienungskomfort oder sind zur Nutzung bestimmter FHEM-Module erforderlich. Hier eine Übersicht.
{| class="wikitable"
! style="width:10%" | Beschreibung
! style="width:10%" | Paketname
! style="width:50%" | Kontext
! style="width:30%" | Installieren
|-
|FHEM
|fhem
|Installiert eine komplett lauffähige FHEM-Installation.
Details siehe auf [https://debian.fhem.de/ Stable build using aptitude], für Optionen siehe diesen [http://forum.fhem.de/index.php/topic,27679.0.html Forumsartikel]
Achtung: In der Befehlsliste rechts erstreckt sich der erste Befehl über 2 Zeilen!
| <code>sudo wget -qO - https://debian.fhem.de/archive.key <nowiki>|</nowiki> apt-key add -</code>
<code>sudo deb https://debian.fhem.de/stable ./</code>
<code>sudo apt-get update</code><br>
<code>sudo apt-get install fhem</code>
|-
|Zeitserver
|ntpdate
|Setzt die Systemzeit bei Start des RPi. Wird für FHEM benötigt, da es sonst nicht startet.
|<code>sudo apt-get install ntpdate
sudo ntpdate -u de.pool.ntp.org</code>
|-
|Perl JSON
|JSON
|Wird von einigen Modulen benötigt, z.B. harmony, iTunes
|<code>apt-get install libjson-perl</code>
|-
|Samba-Server
|samba
|Mittels Samba kann man z.B. den Ordner /opt/fhem als Share freigeben. Dieser Share kann z.B. im Windows-Explorer als Laufwerk verbunden werden, so dass die Bearbeitung von config- und Programmdateien bequem möglich ist. Hier eine hilfreiche [https://www.elektronik-kompendium.de/sites/raspberry-pi/2007071.htm Kurzanleitung] aus der (wenn man auf einen speziellen user verzichtet) nur die Einträge für smb.conf gesetzt werden müssen.
|<code>sudo apt-get install samba cifs-utils</code>
Danach muss der share definiert werden mittels

<code>sudo nano /etc/samba/smb.conf</code>
|-
|Mailversand
|sendEmail
|Wird benötigt, um Mails versenden zu können, bspw. für Alarm-Benachrichtigungen.
Nach Installation des Paketes benötigt man noch eine Routine in FHEM gemäß [http://www.fhemwiki.de/wiki/E-Mail_senden#Raspberry_Pi diesem Forumsartikel]
|<code>sudo apt-get install sendEmail</code>
|-
|Wake-on-LAN
|etherwake
|Wird z.B. für das Modul WOL benötigt.
|<code>sudo apt-get install etherwake</code>
|-
|Perl Telnet
|telnet
|Wird z.B. für das Modul FRITZBOX benötigt, da es eine im Netzwerk vorhandene Fritzbox über deren Telnet-Port anspricht.
|<code>sudo apt-get install libnet-telnet-perl</code>
|-
|Socat
|socat
|Kann verwendet werden, um auf anderen Rechnern im Netzwerk Linux-Befehle oder Skripts auszuführen. Auch können auf Slave-FHEM-Installationen Befehl ausgeführt werden, z.B. mit

<code><nowiki>system("echo 'set lampe on' | /usr/bin/socat - TCP:1.2.3.4:7072");</nowiki></code>

1.2.3.4 muss natürlich durch die IP-Adresse des Zielrechners ersetzt werden.
|<code>sudo apt-get install socat</code>
|-
|Libcrypt
|Libcrypt
|Perl libcrypt, erforderlich falls Homematic-devices mit AES verwendet werden sollen.
|<code>sudo apt-get install libcrypt-rijndael-perl</code>
|-
|libdatetime
|libdatetime
|Perl libdatetime, erforderlich für das Weather-Modul.
|<code>sudo apt-get install libdatetime-format-strptime-perl</code>
|}

== Bekannte Probleme ==
=== Netzteil ===
Der RPi verwendet ein USB Netzteil als Spannungsversorgung. Gemessen kann der RPi allein bereits um die 900mA Strom fordern. Das bringt kleine Netzteile, besonders wenn noch CULs oder WLAN Sticks an USB hängen schnell an die Grenze. Die Fehler die daraus resultieren sind Abstürze, Netzwerkprobleme uvm. Daher bitte ein ausreichend starkes Netzteil mit mind. 2000mA oder einen aktiven USB-HUB für die Periperie verwenden.

=== Echtzeituhr ===
Der RPi hat keine [http://de.wikipedia.org/wiki/Echtzeituhr Real-Time-Clock] (RTC), das heißt, dass er nach einem Neustart keine gültige (im Sinne von aktuell) Systemzeit hat, sondern ein Datum in der Vergangenheit. Dieses Problem wird sinnvollerweise mit einer [http://de.wikipedia.org/wiki/Network_Time_Protocol NTP-Konfiguration] umgangen.

Dabei muss Sorge getragen werden, dass der [http://wiki.debian.org/NTP ntpd] schon einen Datums-/Zeitabgleich gemacht hat, bevor FHEM gestartet wird. Geschieht der Abgleich nicht vorher, sondern erst nachdem FHEM schon läuft, stellt FHEM die Logs zwar auf das nun aktuelle Datum um (die "alten" Logs mit dem eigentlich ungültigen Datum werden natürlich behalten), aber irgendetwas scheint FHEM dabei so zu belasten, dass es eine Last von über 0.8 bis 0.9 erzeugt. Diese Last besteht auf Dauer und verschwindet erst, wenn man das Ganze sauber durchkonfiguriert und FHEM neu gestartet hat. Die hohe Systemauslastung zeigt sich auch in einem sehr trägen Laden der FHEM-Webseiten in einem beliebigen Browser.

=== Last durch Backup (während update) ===
Bei einen [[Update]] von FHEM durch den Befehl <code>update</code> kann durch Setzen des Attributs "<code>attr global backup_before_update 1</code>" automatisch vorab ein [[Backup]] durchgeführt werden. Die (ggf. großen) Log-Dateien werden dabei ebenfalls archiviert. Während der Archivierung ist FHEM blockiert. Durch die beschränkte Leistungsfähigkeit des Raspberry Pi kann das Backup zudem lange dauern. Durch ein "<code>attr global updateInBackground 1</code>" wird ein Backup im Hintergrund ausgeführt (Quelle: {{Link2Forum|Topic=15729}}).

Alternative Möglichkeiten:
* Backup ausschalten und manuell durchführen
* Backup-Befehl anpassen und so große Dateien bzw. Verzeichnisse (log/) nicht archivieren

=== SD-Kartenfehler / Dateisystemfehler durch Stromausfall ===
Standardmässig läuft der RPi von der SD-Karte. Diese sind gegenüber Stromausfällen relativ empfindlich und es kommt immer wieder zu Schreib/Lesefehlern. Dies kann durch den Einsatz von unterbrechungsfreien Stromversorgungen umgangen werden. Eine andere Lösung ist der Einsatz von USB-Sticks als "root-Dateisystem" nach dem Start. USB-Sticks sind in der Regel besser gegen Fehler bei spontanem Spannungsausfall (Ausstecken) geschützt als SD-Karten. Anleitungen dies beim RPi zu konfigurieren sind abhängig von verwendeten Version des RPi online zu finden.

== Watchdog einrichten ==
Vor allem wenn das Netzteil nicht stark genug ist, schmiert FHEM gelegentlich ab (siehe oben - Netzteil). Man kann den RPi alle halbe Stunde prüfen lassen, ob FHEM noch läuft, und ggf. einen Neustart durchführen lassen.
Wie man das einrichtet steht hier: [http://forum.fhem.de/index.php/topic,20553.0.html Einrichten eines Watchdog]

== Interne Links ==
* Erste Schritte: [[FHEM auf Raspberry PI mit COC betreiben]]
* [[CUL am Raspberry Pi flashen]]
* [[Raspberry Pi und 1-Wire]]

== Externe Links ==
* {{Link2Forum|Topic=33460|Message=264679}} zum Umzug von Raspberry B auf Raspberry Pi 2
* [http://www.raspberrypi.org/ Offizielle Webseite der Raspberry Pi Foundation]
* [http://www.raspberrypi.org/downloads Offizielle Downloads der Raspberry Pi Foundation]
* Blog mit dem Thema [http://www.meintechblog.de/2013/05/fhem-server-auf-dem-raspberry-pi-in-einer-stunde-einrichten/ FHEM-Server auf RaspBerry Pi in einer Stunde einrichten]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

ReadingsGroup

2016-11-13T20:35:01Z

LHBL2003: /* Heizungswerte, Status, Steuerung und Wochenprofil */

{{SEITENTITEL:readingsGroup}}
{{Infobox Modul
|ModPurpose=Einfache zusammenfassende Darstellung von Informationen über mehrere Geräte und deren Steuerung
|ModType=h
|ModCmdRef=readingsGroup
|ModForumArea=Frontends
|ModTechName=33_readingsGroup.pm
|ModOwner=Andre ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])}}

Das Fhem-[[:Kategorie:Hilfsmodul|Hilfsmodul]] [[readingsGroup]] bietet eine einfache Möglichkeit, ''Readings'' (kein Präfix vor dem Reading-Namen), ''Internals'' (Präfix "+" vor dem Namen des internen Wertes) und ''Attributes'' (Präfix "?" vor dem Namen des Attributs) von einem oder mehreren ''Devices'' darzustellen und flexibel zu formatieren.

Die Aktualisierung im Browserfenster geschieht per longpoll und überträgt nur die jeweils geänderten Zellen. Wenn eine readingsGroup in keinem Browserfenster angezeigt wird findet keine longpoll aktualisierung statt.

== Definition ==
Siehe [http://fhem.de/commandref.html#readingsGroup commandref].

== Attribute ==
{{Randnotiz|RNText=In allen Mappings die einen Hash verwenden muss der Key (das was jeweils links von => Operator steht) in Anführungszeichen stehen. Die einzige Ausnahme hiervon sind Keys die aus einem String bestehen der mit einem Buchstaben beginnt und nur Buchstaben und Zahlen enthält.}}
Weitergehende Erläuterungen zu einzelnen Attributen.

Die komplette Liste der Attribute ist der commandref zu entnehmen.

=== noheading ===
[[Datei:ReadingsGroup_noheading.png|mini|rechts|400px|ReadingsGroup: rechts mit "noheading" Attribut, links der anklickbare Titel]]
Das Attribut <code>noheading</code> führt dazu, dass der Alias der ReadingsGroup nicht mehr als Titel angezeigt wird. Das kann wünschenswert sein, wenn die ReadingsGroup auf einer [[Dashboard]]-Seite angezeigt werden soll, hat allerdings den Nachteil, dass die Detail-Ansicht der ReadingsGroup nicht mehr über einen Klick auf den Titel aufgerufen werden kann. Der Einstellungsdialog der ReadingsGroup ist dann nur noch (z. B.) über
* <code>list TYPE=readingsGroup</code>
* einen "Probably associated with"-Link eines anderen Objekts oder über
* manuelle Modifikation der URL eines anderen Objekts (<code>http:.../fhem?detail=<objektname></code>)
erreichbar.

=== nolinks ===
Devicenamen und Titel der readingsGroup verlinken nicht mehr zur zugehörigen Detailansicht und sind nicht mehr anklickbar.

=== nostate ===
Das state-Reading wird bei regex match nicht berücksichtigt und nicht angezeigt.

=== notime ===
Es werden keine Timestamps für die Readings angezeigt. Nur für einspaltige readingsGroups sinnvoll.

== Beispiele ==
Bitte beachten: die folgenden Beispiele enthalten keine Maskierungen oder Verdoppelungen für ; und Zeilenende, sondern sind so angegeben, wie sie im [[PGM2|Web Interface]] im Befehls-Eingabefeld, nach Klick auf DEF und im Attribut-Eingabefeld eingegeben werden. Beim manuellen Einfügen in eine [[Konfiguration|Konfigurationsdatei]] sind diese Maskierungen oder Verdoppelungen natürlich vorzunehmen.

=== Einfache Auswahl über Reading-Namen ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define battStatus readingsGroup .*:[Bb]attery</code>
| Alle readings mit Namen '''Battery''' oder '''battery''' von allen Devices.
| rowspan=3 | [[Datei:rgBattery.png|thumb]]
|-
| <code>attr battStatus alias FHT Batteriestatus </code>
| Der Alias wird als Zeilentitel verwendet
|-
| <code>attr battStatus mapping %ROOM </code>
| ''Mapping %ROOM'' führt dazu, dass der Raumname als Zeilentitel angezeigt wird.
|}

=== Übersicht HomeMatic Geräte ===

<nowiki>define HM_Components readingsGroup <Gerät>,<Name>,<Model>,<S/N> TYPE=CUL_HM:+NAME,?model,D-serialNr</nowiki>

=== Auswahl über Reading-Namen, Status als Symbol dargestellt ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg_battery readingsGroup .*:battery</code>
| Alle readings mit Namen '''battery''' von allen Devices.
| rowspan=4 | [[Datei:rgBattery2.png|thumb]]
|-
| <code>attr rg_battery alias Batteriestatus </code>
| Der Alias wird als Überschrift verwendet
|-
| <code>attr rg_battery valueIcon {'battery.ok' => 'batterie', 'battery.low' => 'batterie@red'}</code>
| Statt der reading Werte "ok" und "low" soll ein Icon angezeigt werden.
|-
|<code>attr rg_battery commands { "battery.low" => "set %DEVICE replaceBatteryForSec 60" }</code>
| Für LaCrosse devices kann man beim Klick auf ein rotes "battery low icon" direkt replaceBatteryForSec setzen.
|}

=== Reading-Werte zuordnen (Icon / Text) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg readingsGroup Contact.Dachboden_gross:sensed.*</code>
| Alle sensedreadings des Contact.Dachboden_gross device.
| rowspan=4 | [[Datei:rgFenster.png|thumb]]
|-
| <code>attr rg mapping { 'sensed.A' => 'links', 'sensed.B' => 'rechts' }</code>
| Die Zuordnung rechts/links
|-
| <code>attr rg valueFormat {($VALUE eq '1')?"fts_window_roof":"fts_window_roof_open_2"}</code>
| Die Zuordnung von reading Wert zu Icon Namen.
|-
| <code>attr rg_battery valueIcon %VALUE </code>
| Statt des reading Werts soll ein Icon angezeigt werden.
|}

=== Formatvorgabe für Ausgabewerte ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define TempHygro readingsGroup TYPE=CUL_WS:temperature,humidity,dewpoint</code>
| Alle readings mit Namen '''temperature''', '''humidity''', '''dewpoint''' von allen Devices des Typs '''CUL_WS'''
| rowspan=4 | [[Datei:rgTemperatur.png|thumb|[[S300TH]]-Werte in einer readingsGroup]]
|-
| <code>attr TempHygro alias Temperatur / rel. Feuchte / Taupunkt</code>
| Der Alias der readingsGroup wird als Überschrift verwendet
|-
| <code>attr TempHygro mapping %ALIAS</code>
| ''Mapping %ALIAS'' führt dazu, dass der Alias des Geräts als Zeilentitel angezeigt wird.
|-
| <code>attr TempHygro valueFormat { temperature => "%.1f&deg;C", humidity => "%.1f %%", dewpoint => "%.1f&deg;C"}</code>
| Formatierung der Ausgabewerte. '''Achtung:''' "%" die in der Ausgabe erscheinen sollen, müssen verdoppelt werden!
|}

=== Ausgabestil (hier rechtsbündig) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Wetter readingsGroup WetterXXX:<%temp_temperature>,<Temperatur>,temperature WetterXXX:<%weather_humidity>,<Luftfeuchte>,humidity WetterXXX:<%weather_barometric_pressure>,<Luftdruck>,pressure
</code>
| Die readings mit Namen '''temperature''', '''humidity''' und '''pressure''' vom Device WetterXXX jeweils mit einem Icon und einem Label davor.
| rowspan=3 | [[Datei:rgWetter.png|thumb]]
|-
| <code>attr Wetter valueFormat { temperature => '%1.f &deg;C', humidity => '%1.f %%', pressure => '%i mbar' }</code>
| Die Formatierung der Readingswerte
|-
| <code>attr Wetter valueStyle style="text-align:right"</code>
| Die Readings sollen rechtsbündig dargestellt werden.
|}

=== Internal Value ausgeben ===
Diese Beispiel könnte entfallen (nächstes Beispiel ist sehr ähnlich; es wird lediglich ein weiterer Wert ausgegeben).
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI</code>
| Den RSSI Wert aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.
| rowspan=1 | [[Datei:rgculRSSI.png|thumb]]
|}

=== Internal Values ausgeben ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI,+cul_TIME</code>
| Den RSSI Wert mit der zugehörigen Zeit aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.<br>"Internal Values" werden durch das vorangestellte '''+''' (Pluszeichen) identifiziert.
| rowspan=2 | [[Datei:rgculRSSI2.png|thumb]]
|-
|attr culRSSI valueStyle {return undef if($READING =~ m/TIME/); ($VALUE <= -85)?'style="color:red"':($VALUE <= -80)?'style="color:yellow"':undef}
|Schlechte RSSI Werte sollen abhängig von zwei Schwellwerten gelb oder rot eingefärbt werden (auf dem Screenshot nicht zu sehen).
|}

=== Alle Readings eines Gerätes, mit Ausnahme von... ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Systemstatus readingsGroup sysstat</code>
| Alle readings des sysstat Device
| rowspan=4 | [[Datei:rgSysstat.png|thumb]]
|-
| <code>attr Systemstatus nostate 1</code>
| Ohne state
|-
| <code>attr Systemstatus notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Systemstatus mapping {'load' => 'Systemauslastung', 'temperature' => 'Systemtemperatur in &deg;C'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|}

=== Anzeige auf einem Floorplan ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Heizung readingsGroup t(1|2|3):temperature</code>
| Die Temperatur readings der Devices t1, t2 und t3
| rowspan=6 | [[Datei:rgHeizung.png|thumb|220px]]
|-
| <code>attr Heizung mapping {'t1.temperature' => 'Vorlauf', 't2.temperature' => 'R&ücklauf', 't3.temperature' => 'Zirkulation'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|-
| <code>attr Heizung nameStyle style="text-align:left"</code>
| Zeilentitel linksbündig wegen floorplan
|-
| <code>attr Heizung style style="font-size:20px;color:lightgray"</code>
| Großer Font und Farbe passend für den floorplan
|-
| <code>attr Heizung notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Heizung valueFormat : %.1f &deg;C</code>
| Doppelpunkt zwischen Zeilentitel und Wert, eine Nachkommastelle plus Einheit
|}

=== LightScene DropDown-Menü für smallscreen Styles oder Floorplan ===

{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define lcDropDown readingsGroup meineLightScene:!state</code>
| Für die LightScene ''meineLightScene'' soll ein DropDown-Menü zur Auswahl der Szene erstellt werden.
| rowspan=6 |
|-
| <code>attr lcDropDown commands { state => 'scene:' }</code>
| Die Anzeige des state Readings wird auf das DropDown-Menü für das scene Kommando gemapped.
|-
| <code>attr lcDropDown nonames 1</code>
| Keine Readingnamen
|-
| <code>attr lcDropDown notime 1</code>
| Kein Timestamp
|}

=== Schriftgrößen, Farben, Icons ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgVerbrauchPCA301.png|links|mini|400px|Schriftgröße, Farbe, Icons...]]
|-
| style="width:40%" |<code>define Verbrauch readingsGroup TYPE=PCA301:state,power,consumption</code>
| Die readings state, power und consumption aller [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] Devices mit einer Zeile pro Device.
|-
| <code>attr Verbrauch mapping %ROOM %ALIAS</code>
| Der Raumname und der Alias werden als Zeilentitel verwendet
|-
| <code>attr Verbrauch nameStyle style="font-weight:bold"</code>
| Der Zeilentitel soll fett sein
|-
| <code>attr Verbrauch style style="font-size:20px"</code>
| Alles in einem größeren Font
|-
| <code>attr Verbrauch valueFormat {power => "%.1f W", consumption => "%.2f kWh"}</code>
| Die Formatierung für die power und consumption readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr Verbrauch valueIcon { state => '%devStateIcon' }</code>
| Für die Dosen, die schaltbar sind, soll das anklickbare device icon gezeigt werden.
|-
|<code>attr Verbrauch valueStyle {($READING eq "power" && $VALUE > 40)?'style="color:red"':'style="color:green"'}</code>
|Wenn das power reading >40 ist, soll es in rot angezeigt werden, alle anderen Werte und readings in grün
|}

=== Wertabhängige Farbgebung ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:TemperaturenRG.png|600px|mini|links|Wertabhängige Farben]]
[[Datei:TemperaturenRG2.png|600px|mini|links|Andere Werte - andere Farben]]
|-
| style="width:40%" |<code>define wzTemperaturenRG readingsGroup Aussen:,<Temperatur>,temperature,<Luftfeuchte>,humidity Wohnzimmer:,<Temperatur>,temperature,<Luftfeuchte>,humidity Kasten_E_Geraete:,<Temperatur>,temperature,<Luftfeuchte>,humidity</code>
| Die readings temperatur und humidity der Devices Aussen, Wohnzimmer und Kasten_E_Geraete in einer Zeile pro Device.
|-
| <code>attr wzTemperaturenRG group 3. Temperaturen</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzTemperaturenRG noheading 1</code>
| noheading
|-
| <code>attr wzTemperaturenRG nostate 1</code>
| nostate
|-
| <code>attr wzTemperaturenRG notime 1</code>
| notime
|-
| <code>attr wzTemperaturenRG valueFormat {temperature => "%.1f °C", humidity =>"%.1f %%" }</code>
| Die Formatierung für die temperatur und humidity readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr wzTemperaturenRG valueStyle { if($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 20) { 'style="color:orange"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE < 5) { 'style="color:blue"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 23) { 'style="color:red"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 21) { 'style="color:orange"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE < 20) { 'style="color:blue"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 28) { 'style="color:orange"'}elsif($READING eq "humidity" && $VALUE > 65) { 'style="color:red"'}elsif($READING eq "humidity" && $VALUE > 60) { 'style="color:orange"'}else{'style="color:green"'} }</code>
| Diverse Farbkombinationen sind möglich
|}

=== Enigma Receiver ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:ReceiverRG.jpg|600px|mini|links|Wertabhängige Farben]]
[[Datei:ReceiverRGmute.jpg|600px|mini|links|Wertabhängige Farben]]
|-
| style="width:40%" |<code>define wzReceiverRG readingsGroup wzReceiver:,<Aktuell>,eventtitle,<Rest>,eventremaining_hr,<Dauer>,eventduration_hr wzReceiver:<Beschreibung>,eventdescription wzReceiver:,<Nächste>,eventtitle_next,<Start>,eventstart_next_hr,<Dauer>,eventduration_next_hr wzReceiver:,<HDD Kapazität>,hdd1_capacity,<Frei>,wzReceiver:hdd1_free wzReceiver:,<Lautstärke>,volume,<HDD>,hdd1_capacity,<Frei>,hdd1_free</code>
| Mehrere readings des Device wzReceiver in mehreren Zeilen. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke, mute angezeigt. Farbige Anzeige des freien Speicherplatzes
'''Benötigt:''' ENIGMA2 Receiver, 70_ENIGMA2.pm - Siehe: [[Enigma2 Receiver (Dreambox, VUplus etc.) steuern]]
|-
| <code>attr wzReceiverRG group Fernseher Receiver</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzReceiverRG mapping &nbsp;</code>
| mapping wird auf &nbsp; (Leerzeichen) gesetzt, damit der Device Name nicht angezeigt wird
|-
| <code>attr wzReceiverRG noheading 1</code>
| noheading
|-
| <code>attr wzReceiverRG nostate 1</code>
| nostate
|-
| <code>attr wzReceiverRG notime 1</code>
| notime
|-
|-
| <code>attr wzReceiverRG valueColumns { eventdescription => 'colspan="4"' }</code>
| Die Beschreibung soll über 4 Spalten gehen
|-
| <code>attr wzReceiverRG valueFormat { wzReceiverRGvalueFormat($DEVICE,$READING,$VALUE);; }</code>
| Die Formatierung wird in die 99_myUtils.pm ausgelagert. Siehe: [[99 myUtils anlegen]]
|-
|<code>attr wzReceiverRG valueStyle { if($READING eq "hdd1_free" && $VALUE < 200){ 'style="color:red"' }elsif( $READING eq "hdd1_free" && $VALUE < 500 ){ 'style="color:orange"' }elsif( $READING eq "volume" && ReadingsVal($DEVICE, "mute", "") eq "on" ){ 'style="color:red"' }else{ 'style="color:green"' } }</code>
| Diverse Farbkombinationen sind möglich. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke <span style="color: red;">mute</span> angezeigt.
|-
|<source lang="perl">
sub
wzReceiverRGvalueFormat($$$)
{
my ($DEVICE,$READING,$VALUE) = @_;

if($READING eq 'hdd1_capacity') {
return "%.2f MB";
} elsif( $READING eq 'hdd1_free') {
return "%.2f MB";
} elsif( $READING eq 'volume' ) {
if( ReadingsVal($DEVICE, "mute", "") eq "on") {
return "mute";
} else {
return "%i %%";
}
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]
|}

=== Heizungswerte inklusive Batterie- und Fensterstatus ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung3.png|thumb|links|500px|Heizungswerte inklusive Batterie- und Fensterstatus]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<%18>,<%20>,<%22>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte commands { 'Heizungswerte.18' => 'set $DEVICE desired-temp 18', 'Heizungswerte.20' => 'set $DEVICE desired-temp 20', 'Heizungswerte.22' => 'set $DEVICE desired-temp 22' }</code>
| Die Links/Kommandos die hinter den 18, 20 und 22 liegen sollen.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte inklusive Ventilposition ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:Rg_Heizung_Valveposition.png|thumb|links|500px|Heizungswerte inklusive Statusinformationen (MAX!)]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,<Ventil>,<Soll>,<Ist>,<MaxV>,<GID>,<Mode>,<Batterie> TYPE=CUL_HM:ValvePosition,desired-temp,measured-temp,R-valveMaxPos,groupid,mode,battery</code>
| Diverse readings aller Devices des Typs <b>MAX</b>.
|-
| <code>attr Heizungswerte mapping %ROOM</code>
| Die Raumnamen werden angezeigt.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb (fett) sein.
|-
| <code>attr Heizungswerte room Heizung</code>
| Die "readingsgroup" wird dem Raum "Heizung" zugeordnet.
|-
| <code>attr Heizungswerte valueFormat {'temperature' => "%.0f °C", 'desiredTemperature' => "%.0f °C", 'valveposition' =>"%.0f %%", 'maxValveSetting' =>"%.0f %%" }</code>
| Es wird noch die Einheit °C hinter den Temperaturwerten angezeigt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriezustand werden Icons anstatt Klartextwerte genommen!
|-
| <code>attr Heizungswerte valueStyle { if($READING eq "temperature" && $VALUE > 20){ 'style="color:green;;font-weight:bold"' }elsif( $READING eq "temperature" && $VALUE <= 20 ){ 'style="color:blue"' }elsif( $READING eq "temperature" && $VALUE > 23 ){ 'style="color:red"' }else{ 'style="color:gray"' } }</code>
| Die Temperaturwerte werden abhängig vom Wert farbig dargestellt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte, Status und Regelmöglichkeit ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung2.png|thumb|500px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define Heizungswerte2 readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<{myUtils_HeizungUpDown($DEVICE,"up")}@desired-temp>,desired-new,<{myUtils_HeizungUpDown($DEVICE,"down")}@desired-temp>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte2 nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte2 valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|-
| <code>attr Heizungswerte2 valueStyle {($VALUE eq "00")?'style="visibility:hidden"':''}</code>
| Nach dem Einstellen den Wert wieder ausblenden.
|-
| <source lang="perl">
#Heizung regeln in readingsGroup
sub
myUtils_HeizungUpDown($$)
{
my($DEVICE,$CMD) = @_;

my $icon = $CMD;
my $VALUE = ReadingsVal($DEVICE,"desired-new","20" );
$VALUE = ReadingsVal($DEVICE,"desired-temp","20" )
if( !$VALUE || $VALUE == 0 );
my $link;

if( $CMD eq "up" ) {
$icon = "control_arrow_upward";
$VALUE += 1;

if( $VALUE <= 24 ) {
$icon .= "\@red";
$link = "setreading $DEVICE desired-new $VALUE";
}
} elsif( $CMD eq "down" ) {
$icon = "control_arrow_downward";
$VALUE -= 1;

if( $VALUE >= 18 ) {
$icon .= "\@blue";
$link = "setreading $DEVICE desired-new $VALUE";
}
}

my $notify = "notifyHeizungUpDown";
if( !defined($defs{$notify}) ) {
CommandDefine(undef,
"$notify notify .*:desired-new.* "
."{ myUtils_HeizungUpDownNotify(\$NAME,\$EVTPART1); }" );
}

my $ret = "%$icon";
$ret .= "%$link" if( $link );

return $ret;
}

sub
myUtils_HeizungUpDownNotify($$)
{
my($DEVICE,$VALUE) = @_;

return if( $VALUE == 0 );

my $at = "triggerHeizungUpDown_$DEVICE";
CommandDelete(undef, $at) if( defined($defs{$at}) );
CommandDefine(undef,
"$at at +00:00:03 "
."{my \$v = ReadingsVal(\"$DEVICE\",\"desired-new\",undef);"
."fhem(\"set $DEVICE desired-temp \$v\") if( \$v );"
."fhem(\"setreading $DEVICE desired-new 00\");}" );

return undef;
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit werden die Icons zum Ändern der gewünschten Temperatur dargestellt und im Bereich >=18 und <= 24 Grad anklickbar gemacht. Zwischen den Pfeilen wird der gerade eingestellte Wert angezeigt. Wenn dieser drei Sekunden nicht mehr geändert wurde wird die desired-temp auf diesen Wert gesetzt und die Anzeige zwischen den Pfeilen ausgeblendet.
|}

=== Heizungswerte, Status, Steuerung und Wochenprofil ===
Dieses Beispiel funktioniert nur mit HomeMatic HM-CC-RT-DN, für andere Thermostate müssen an diversen Stellen Änderungen vorgenommen werden.
{{Todo|Überarbeiten: umstellen auf readingList oder setreading, label als readings in die readingsGroup selber stecken statt in einen extra dummy. oder !<reading> und mapping verwenden.}}
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgThermostate.png|thumb|750px|links|Status, Steuerung und Wochenprofil]]
|-
| style="width:40%" |<pre>
define d_label dummy
setreading d_label Heizung Heizung
setreading d_label Temperatur Temperatur
setreading d_label Status Status
setreading d_label Wochenplan Wochenplan
setreading d_label Werktag Werktag
setreading d_label Samstag Samstag
setreading d_label Sonntag Sonntag
setreading d_label Zeitraum1 Zeitraum 1
setreading d_label Zeitraum2 Zeitraum 2 </pre>
|Erzeugen der Readings im Device [[dummy#d_label|d_label]]. (Zeilenweise in die Befehlszeile eintragen.)
|-
| <code>
define rg_thermostate readingsGroup <>,Heizung@d_label,<|>,Temperatur@d_label,<|>,Status@d_label,<|>,Wochenplan@d_label,<|>,Werktag@d_label,<|>,Samstag@d_label,<|>,Sonntag@d_label,<|>,<> CUL_HM_HM_CC_RT_DN_......_Clima:<>,?alias,<|>,<Soll>,desired-temp,<Tag>,dayTemp@{rg($DEVICE."§clima")},impossible@{$DEVICE},<|>,controlMode,R-globalBtnLock@{rg($DEVICE."§device")},<|>,Zeitraum1@d_label,<|>,workday_period_1_start@{rg($DEVICE."§clima")},workday_period_1_stop@{rg($DEVICE."§clima")},<|>,saturday_period_1_start@{rg($DEVICE."§clima")},saturday_period_1_stop@{rg($DEVICE."§clima")},<|>,sunday_period_1_start@{rg($DEVICE."§clima")},sunday_period_1_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},<%system_fhem_update>,<nowiki><br></nowiki>,state@{rg($DEVICE."§device")},<%getConfig>,<|>,<Ist>,measured-temp,<Nacht>,nightTemp@{rg($DEVICE."§clima")},<|>,<Ventil>,ValvePosition,<|>,Zeitraum2@d_label,<|>,workday_period_2_start@{rg($DEVICE."§clima")},workday_period_2_stop@{rg($DEVICE."§clima")},<|>,saturday_period_2_start@{rg($DEVICE."§clima")},saturday_period_2_stop@{rg($DEVICE."§clima")},<|>,sunday_period_2_start@{rg($DEVICE."§clima")},sunday_period_2_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},impossible@{rg($DEVICE."§device")},<%burstXmit> </code>
| Diverse readings aller Devices <b>CUL_HM_HM_CC_RT_DN_......_Clima</b>, entsprechender [[Makefine#d_climaControl|d_climaControl]] (müssen vorher angelegt werden) und [[dummy#d_label|d_label]].
|-
| <code>attr rg_thermostate commands { 'desired-temp' => 'desired-temp:', 'dayTemp' => 'dayTemp:', 'controlMode' => 'trigger ntfy_rg $DEVICE controlMode', 'R-globalBtnLock' => 'trigger ntfy_rg $DEVICE globalBtnLock', 'workday_period_1_start' => 'workday_period_1_start:', 'workday_period_1_stop' => 'workday_period_1_stop:', 'saturday_period_1_start' => 'saturday_period_1_start:', 'saturday_period_1_stop' => 'saturday_period_1_stop:', 'sunday_period_1_start' => 'sunday_period_1_start:', 'sunday_period_1_stop' => 'sunday_period_1_stop:', 'rg_thermostate.system_fhem_update' => 'trigger ntfy_rg $DEVICE setTimeTable', 'rg_thermostate.getConfig' => 'set $DEVICE getConfig', 'nightTemp' => 'nightTemp:', 'workday_period_2_start' => 'workday_period_2_start:', 'workday_period_2_stop' => 'workday_period_2_stop:', 'saturday_period_2_start' => 'saturday_period_2_start:', 'saturday_period_2_stop' => 'saturday_period_2_stop:', 'sunday_period_2_start' => 'sunday_period_2_start:', 'sunday_period_2_stop' => 'sunday_period_2_stop:', 'rg_thermostate.burstXmit' => 'set $DEVICE burstXmit'}</code>
| Temperaturen werden als DropDown Auswahl dargestellt, Icons triggern [[readingsGroup#sub_rg|ntfy_rg]]
|-
| <code>attr rg_thermostate mapping { 'desired-temp' => '', 'dayTemp' => '', 'workday_period_1_start' => '', 'workday_period_1_stop' => '', 'saturday_period_1_start' => '', 'saturday_period_1_stop' => '', 'sunday_period_1_start' => '', 'sunday_period_1_stop' => '', 'nightTemp' => '', 'workday_period_2_start' => '', 'workday_period_2_stop' => '', 'saturday_period_2_start' => '', 'saturday_period_2_stop' => '', 'sunday_period_2_start' => '', 'sunday_period_2_stop' => ''}</code>
| Ausblenden der Texte vor den DropDowns.
|-
| <code>
attr rg_thermostate nameStyle{($READING eq "Soll" ||$READING eq "Tag" ||$READING eq "%getConfig" ||$READING eq "Ist" ||$READING eq "Nacht" ||$READING eq "Ventil" )?'style="text-align:right"' :($READING eq "%burstXmit" )?'style="text-align:center"' :'style=""'}
</code>
| Ausrichten der Überschriften die keine readings sind.
|-
| <code>attr rg_thermostate nonames 1</code>
| Ausblenden der Device Namen.
|-
| <code>attr rg_thermostate valueColumns { 'Heizung' => 'colspan="2"', 'Temperatur' => 'colspan="4"', 'Status' => 'colspan="2"', 'Werktag' => 'colspan="2"', 'Samstag' => 'colspan="2"', 'Sonntag' => 'colspan="2"', 'alias' => 'colspan="2"'}</code>
| Diverse Readings sollen über mehrere Spalten dargestellt werden.
|-
| <code>attr rg_thermostate valueFormat { 'measured-temp' => "%0.1f °C", 'ValvePosition' => "%0.1f %%"}</code>
| Formatierung für measured-temp und ValvePosition.
|-
| <code>attr rg_thermostate valueIcon { 'controlMode.auto' => 'sani_heating_automatic@green', 'controlMode.set_auto' => 'sani_heating_automatic@orange', 'controlMode.manual' => 'sani_heating_manual@red', 'controlMode.set_manual' => 'sani_heating_manual@orange', 'R-globalBtnLock.on' => 'secur_locked@green', 'R-globalBtnLock.on ' => 'secur_locked@green', 'R-globalBtnLock.set_on ' => 'secur_locked@orange', 'R-globalBtnLock.off' => 'secur_open@red', 'R-globalBtnLock.off ' => 'secur_open@red', 'R-globalBtnLock.set_off ' => 'secur_open@orange'}</code>
| Zuweisung der Icons.
|-
| <code>
attr rg_thermostate valueStyle{($READING eq "Heizung" ||$READING eq "Temperatur" ||$READING eq "Status" ||$READING eq "Wochenplan" ||$READING eq "Werktag" ||$READING eq "Samstag" ||$READING eq "Sonntag" )?'style="font-size:20px;;color:RoyalBlue;;text-align:center"' :($READING eq "alias" )?'style="font-size:11px;;font-weight:bold;;text-align:left"' :($READING eq "ValvePosition" &&$VALUE > 40 )?'style="font-weight:bold;;color:Orange;;text-align:left"' :($READING eq "desired-temp" ||$READING eq "measured-temp" )?'style="text-align:center"' :($READING eq "state" ||$READING eq "ValvePosition" )?'style="text-align:left"' :'style="text-align:right"'}
</code>
| Ausrichten und Einfärben der Readings.
|}

=== Heizungsteuerung für HM Wand- und Heizkörperthermostate ===

Dieses Beispiel wurde für HM-TC-IT-WM-W-EU / HM-CC-RT-DN Geräte erstellt. Verwendung anderer Thermostate wird ggf. Anpassungen erforderlich machen. Die Geräte werden nicht automatisch ermittelt, sondern sind einzeln angegeben.
Es werden Soll- und Ist-Temperaturen angezeigt, Luftfeuchte und Ventilpositionen, Modus, Batterie und Global-Tastenlock.
Steuerungsmöglichkeiten: Solltemperatur, Modus (Manual/Automatik), (globale) Tastenlock.
Die Abweichung der Isttemperatur, die Ventilpositionen, Batteriestand etc. werden farblich hervorgehoben.

Die Gerätenamen (EG_WZ_WT01_Climate / EG_WZ_WT01, EG_WZ_TT01_Clima / EG_WZ_TT01 / EG_WZ_TT02, OG_BZ_WT01_Climate / OG_BZ_WT01, OG_BZ_TT01_Clima / OG_BZ_TT01, OG_SZ_WT01_Climate / OG_SZ_WT01, OG_SZ_TT01_Clima / OG_SZ_TT01, OG_DZ_WT01_Climate / OG_DZ_WT01, OG_DZ_TT01_Clima / OG_DZ_TT01) müssen natürlich entsprechend angepasst werden.

Hinweis: Bei den Geräten muss das Attribut „expert“ auf "1_on" gesetzt werden, andernfalls fehlt das Reading „R-globalBtnLock“. Dies hätte zur Folge, dass in der Spalte Lock der batteryLevel dargestellt wird.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgHMTh.jpg|thumb|500px|links|Status, Steuerung und Wochenprofil]]
|-
| <code>define heatingInfo readingsGroup <%sani_heating>,<Soll>,<Soll neu>,<Ist>,<Ventil / RH>,<Modus>,<Lock>,<Bat><br>
EG_WZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@EG_WZ_WT01,batteryLevel@EG_WZ_WT01 \<br>
EG_WZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT01,batteryLevel@EG_WZ_TT01 \<br>
EG_WZ_TT02_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT02,batteryLevel@EG_WZ_TT02 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_BZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_BZ_WT01,batteryLevel@OG_BZ_WT01 \<br>
OG_BZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_BZ_TT01,batteryLevel@OG_BZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_SZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_SZ_WT01,batteryLevel@OG_SZ_WT01 \<br>
OG_SZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_SZ_TT01,batteryLevel@OG_SZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_DZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_DZ_WT01,batteryLevel@OG_DZ_WT01 \<br>
OG_DZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_DZ_TT01,batteryLevel@OG_DZ_TT01</code>
| ReadingsGoup anlegen.
|-
| <code>attr heatingInfo cellStyle { "r:1"=>'style="font-weight:bold;;font-size:16px"',<br>
"r:2,c:0"=>'style="font-weight:bold"',"r:6,c:0" =>'style="font-weight:bold"',<br>
"r:9,c:0"=>'style="font-weight:bold"',"r:12,c:0"=>'style="font-weight:bold"'}</code>
| Schrift fett setzen etc.
|-
| <code>attr heatingInfo commands {<br>
'heatingInfo.sollsetz'=>'desired-temp:5.0,12.0,18.0,19.0,20.0,20.5,21.0,21.5,22.0,22.5,23.0,23.5,24.0',<br>
"controlMode.manual"=>"set %DEVICE controlMode auto","controlMode.auto"=>"set %DEVICE controlMode manual",<br>
"R-globalBtnLock.on"=>"set %DEVICE regSet globalBtnLock off",<br>
"R-globalBtnLock.off"=>"set %DEVICE regSet globalBtnLock on"}</code>
| Heizungssteuerung ermöglichen
|-
| <code>
attr heatingInfo mapping {OG_BZ_WT01_Climate=>"Bad",<br>
OG_BZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_SZ_WT01_Climate=>"Schlafzimmer",<br>
OG_SZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_DZ_WT01_Climate=>"Duschbad",<br>
OG_DZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",EG_WZ_WT01_Climate=>"Wohnzimmer",<br>
EG_WZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler1",EG_WZ_TT02_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler2",'desired-temp' => ''}<br>
</code>
| Gewünschte Namen definieren.
|-
| <code>
attr heatingInfo valueFormat {if($READING eq "ValvePosition" && $VALUE ne "0"){$VALUE = int($VALUE/10)*10}<br>
elsif($READING eq "batteryLevel"){if($VALUE>=3){$VALUE=100}<br>
elsif($VALUE>=2.7){$VALUE=75}elsif($VALUE>=2.5){$VALUE=50}elsif($VALUE>=2.2){$VALUE=25}<br>
else{$VALUE=0}}}
</code>
| Werte vorformatieren (für die Icon-Zuordnung).
|-
| <code>
attr heatingInfo valueIcon {'controlMode.manual' => 'sani_heating_manual@795CFF',<br>
'controlMode.auto' => 'sani_heating_automatic@FFC13A', 'controlMode.boost' => 'sani_heating_boost@FB0C02',<br>
'humidity'=>'humidity@6FD9FB', 'R-globalBtnLock.on'=>'secur_locked@F7301D', <br>
'R-globalBtnLock.off'=>'secur_open@0CFB0C','ValvePosition.0' => 'sani_heating_level_0@002AE0',<br>
'ValvePosition.10' => 'sani_heating_level_10@F8D53D','ValvePosition.20' => 'sani_heating_level_20@FF9341',<br>
'ValvePosition.30' => 'sani_heating_level_30@F17F3F','ValvePosition.40' => 'sani_heating_level_40@E46C3C',<br>
'ValvePosition.50' => 'sani_heating_level_50@DE3B3A','ValvePosition.60' => 'sani_heating_level_60@A30D2D',<br>
'ValvePosition.70' => 'sani_heating_level_70@B40A23','ValvePosition.80' => 'sani_heating_level_80@C40619',<br>
'ValvePosition.90' => 'sani_heating_level_90@D4030F','ValvePosition.100' => 'sani_heating_level_100@E50005',<br>
'batteryLevel.100'=>'measure_battery_100@0CFB0C','batteryLevel.75'=>'measure_battery_75@42BC0A',<br>
'batteryLevel.50'=>'measure_battery_50@F5FF10','batteryLevel.25'=>'measure_battery_25@FB5909',<br>
'batteryLevel.0'=>'measure_battery_0@E50005','controlMode.set_boost' => 'hourglass',<br>
'controlMode.set_auto' => 'hourglass','controlMode.set_manual' => 'hourglass',<br>
'R-globalBtnLock.set_on' => 'hourglass','R-globalBtnLock.set_off' => 'hourglass'}
</code>
| Icons zuordnen.
|-
| <code>
attr heatingInfo valueStyle {if($READING eq "measured-temp")<br>
{my $t=$VALUE;;my $d=ReadingsVal($DEVICE,'desired-temp',0);;<br>
if($t-$d>=1){'style="color:rgb(251,63,11);;"'}elsif($t-$d<=-1){'style="color:rgb(79,58,251);;"'}<br>
else{'style="color:rgb(12,251,12);;"'}}}
</code>
| Farben (zu kalt: blau, zu warm: rot, ok: grün).
|-
| <code>
attr heatingInfo valueSuffix {"desired-temp"=>" °C", "measured-temp"=>" °C", <br>
"ValvePosition"=>" (".ReadingsVal($DEVICE,$READING,0)." %)", <br>
"humidity"=>" ".ReadingsVal($DEVICE,$READING,0)." % RH", <br>
"batteryLevel"=>" (".ReadingsVal($DEVICE,$READING,0)." V)"}
</code>
| Messeinheiten und Zahlenwerte.
|}

=== Readings aus zusätzlichen Devices ===
Im folgenden Beispiel wird gezeigt wie sich Readings zusätzlicher Devices zu einer Zeile mit mehreren Readings hinzufügen lassen. Diese zusätzlichen Devices können z.b. die unterschiedlichen Channel eines HomeMatic Gerätes sein. Im folgenden Beispiel wird der Name des zugehörigen Geräts dynamisch bestimmt.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung4.png|thumb|750px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define myTemp readingsGroup <Raum>,<Tist>,<Tsoll>,<Mode>,<Tnight>,<Tday>,<Hum>,<BatTC>,<Vist>,<Vsoll>,<Verr>,<BatVD> Thermostat.(WZ|OZ|AZ|Bad|Kueche|SZ|GZ|Bad.OG):measured-temp,desired-temp,controlMode,night-temp,day-temp,humidity,battery,ValvePosition@{valveOfDevice($DEVICE)},ValveDesired@{valveOfDevice($DEVICE)},R-valveErrorPos@{valveOfDevice($DEVICE)},battery@{valveOfDevice($DEVICE)} Broetje:ToutIst </code>
| Diverse Readings aller Thermostat Devices und des jeweils zugehörigen Ventilantriebs.
|-
| <code>attr myTemp mapping { 'Broetje' => 'Garten','Thermostat.AZ' => 'EG Arbeitszimmer','Thermostat.SZ' => 'OG Schlafzimmer','Thermostat.WZ'=>'EG Wohnzimmer','Thermostat.Kueche' => 'EG Küche','Thermostat.GZ' => 'OG Gästezimmer','Thermostat.Bad' => 'EG Bad','Thermostat.Bad.OG' => 'OG Bad','Thermostat.OZ' => 'EG Kaminzimmer','desired-temp' => <nowiki>''</nowiki> }</code>
| Die Benennung der Zeilentitel (Das ist je nach Konfiguration auch über $ALIAS und/oder $ROOM lösbar).
|-
| <code>attr myTemp commands { 'desired-temp' => 'desired-temp:' }</code>
| desired-temp soll per dropDown einstellbar sein.
|-
| <code>attr myTemp nameStyle style="color:yellow"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr myTemp valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriestand sollen jeweils Icons angezeigt werden.
|-
| <code>attr myTemp valueFormat { 'measured-temp' => "%0.1f &deg;C",'ToutIst' => "%.1f &deg;C",'night-temp' => "%.1f &deg;C",'day-temp' => "%.1f &deg;C",'humidity' => "%.0f
%%",'ValvePosition' => "%.0f %%",'ValveDesired' => "%.0f %%",'R-valveErrorPos' => "%.0f %%" }</code>
| Die Formatierung der Werte.
|-
|<source lang="perl">
#namen des ventil device aus thermostat device ableiten
sub valveOfDevice ($) {
my ($DEVICE) = @_;

if ($DEVICE =~ m/AZ/) {
return "Ventil.".substr($DEVICE,11).".Nord";
} else {
return "Ventil.".substr($DEVICE,11);
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hier wird aus dem Namen des Thermostaten der Name des zugehörigen Ventilantriebs abgeleitet.
|}
Da im {...} Teil des <reading>@<device> Arguments keine Leerzeichen oder Kommas vorkommen dürfen ist er in der Regel das Einfachste die Funktionalität wie in diesem Beispiel in eine eigene Routine auszulagern. Mit ein paar 'Tricks' lässt es sich aber manchmal auch ohne Leerzeichen oder Kommas lösen und dann direkt in die Definition schreiben:<code>...,ValvePosition@{$DEVICE=~s/Thermostat/Ventil/;$DEVICE;},...</code>

=== Inhalte filtern ===
Wenn man gewisse Zeilen einer Readingsgroup nicht dargestellt haben möchte, so kann man diese mit Hilfe von <code>valueFormat</code> ausfiltern, bspw.:

<code>attr rg valueFormat { return $VALUE if ( $VALUE > 0 );; return undef;; }</code>

In diesem Bsp. werden alle Zeilen/Devices, deren Value > 0 sind, angezeigt. Alle anderen werden als <code>undef</code> formatiert und erscheinen damit nicht im Listing.

Dies kann man noch weiter ausbauen und dynamische Auswahllisten erstellen (s. [[ReadingsGroup#Dynamische Inhalte]]).

=== Dynamische Inhalte ===
[[Datei:rgDynamic-1.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 1]]
[[Datei:rgDynamic-2.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 2]]
Es ist möglich, den in einer readingsGroup dargestellten Inhalt dynamisch von zusätzlichen Bedingungen abhängig zu machen. Im folgenden Beispiel lässt sich
einstellen, dass nur die Devices angezeigt werden, die einen bestimmten Zustand (hier: on/off, open/tilted/closed) haben. Hier wird zum Umschalten ein dummy, der direkt über der readingsGroup dargestellt wird, verwendet. Über das links und/oder commands lässt sich auch eine Darstellung erzeugen, bei der das Umschalten direkt innerhalb der readingsGroup möglich ist.

<pre>
define LXrg dummy
attr LXrg group -
attr LXrg setList mode1:on,off mode2:open,closed,tilted
attr LXrg stateFormat 1=mode1 2=mode2
attr LXrg webCmd mode1:mode2

define rg readingsGroup Window.*:state Light.*:state
attr rg group -
attr rg valueFormat { return $VALUE if ( $VALUE eq ReadingsVal("LXrg","mode1","") || $VALUE eq ReadingsVal("LXrg","mode2","") );; return undef;;}

define Watch_LX notify LX.*:.* {my $value = ReadingsVal($NAME,'state','');;;;fhem("setreading $NAME $value")}
</pre>

=== Enable/Disable Button am Beispiel eines WeekdayTimer ===
Dieses Beispiel zeigt die Anwendung einer readingsGroup, um im Frontend einen Enable/Disable Button für ein Objekt darzustellen. Für den [[WeekdayTimer]] gibt es hier spezielle Erweiterungen (set Routinen, um das Attribut ''disable'' zu setzen). Es gibt aber auch eine allgemeinere Variante (siehe [http://forum.fhem.de/index.php/topic,23655.msg169141.html#msg169141 diesen Forumsbeitrag]) für alle Objekte, die das Fhem Attribut ''disable'' unterstützen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_scheduling.png|thumb|500px|links|Enable/Disable Button]]
|-
| style="width:40%" |<code>define rg_Timer_Wasser readingsGroup timer_Wasser_..:disabled,+DEF,<{rg_timer_Wasser_show_conditional($DEVICE,"nextUpdate")}@disabled>,<{rg_timer_Wasser_show_conditional($DEVICE,"nextValue")}@disabled></code>
| Definition der angezeigten Readings. Das Attribut ''disabled'' wird mit weiteren Einstellungen (''commands'') zum Button, +DEF zeigt die Definition, d.h. die Schaltzeiten, des Timers an. Die Readings nextUpdate und nextValue sollen nur angezeigt werden, falls der Timer aktiv ist. Hierfür sorgt eine Routine <code>rg_timer_Wasser_show_conditional</code>, die in der 99_myUtils.pm definiert wird. Das abschließende @disabled sorgt dafür, dass der LongPoll Mechanismus die Anzeige sofort ändert, wenn der Button betätigt wird.
|-
| <code>attr rg_Timer_Wasser valueFormat { if ( $READING =~ m/.*DEF/ ) { my @text = split(" ", $VALUE); shift @text; return join(" ", @text) }}</code>
| Der Name des Timers wird aus dem Internal "+DEF" vorne abgeschnitten. Damit werden nur die definierten Schaltpunkte angezeigt.
|-
| <code>attr rg_Timer_Wasser valueIcon { 'disabled.0' => 'Restart', 'disabled.1' => 'Shutdown' }</code>
| Die beiden Zustände für den Button werden durch zwei Standard-Icons angezeigt.
|-
| <code>attr rg_Timer_Wasser commands { 'disabled.0' => 'set $DEVICE disable', 'disabled.1' => 'set $DEVICE enable' }</code>
| Toggle-Funktion für den Button. Wenn der Timer aktiv ("disabled.0") sorgt ein Klick auf den Button, dass der Timer deaktiviert wird ("set $DEVICE disable").
|-
|<source lang="perl">
sub rg_timer_Wasser_show_conditional($$)
{
my ($DEVICE,$READING) = @_;
return ( ReadingsVal($DEVICE, "disabled", "1") eq "0" )?
ReadingsVal($DEVICE, $READING, "reading_undef") : "disabled";
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit wird das übergebene Reading des Timers nur angezeigt, wenn der Timer aktiv ist. Andernfalls wird der String "disabled" angezeigt.
|}

=== Ändern von Attributen: Noch ein WeekdayTimer Beispiel ===
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Inzwischen ist es auch möglich das commands Mapping auf Attribute anzuwenden. Die Syntax ist die gleiche wie für die set Kommandos. Um das Beispiel übersichtlich zu halten werden hier die Werte und Icons auch für deaktiviert WeekdayTimer angezeigt.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_timer.png|thumb|500px|links|FhemWidget für das 'disable' Attribut]]
|-
| style="width:40%" |<code>define rgTimer readingsGroup <>,<Current>,<Update-Time>,<New>,<disable> TYPE=WeekdayTimer:state,nextUpdate,nextValue,?!disable</code>
| Definition der angezeigten Readings. Das Attribut ''disable'' wird mit weiteren Einstellungen (''commands'') zum Button. Durch das ! wird das Attribut auch dann angezeigt wenn es noch nicht gesetzt ist.
|-
| <code>attr rgTimer valueIcon { state => '%devStateIcon', nextValue => '{(split(":",Color::devStateIcon($DEVICE,"dimmer",undef,"nextValue")))[1]}' }</code>
| Für den aktuellen Zustand wird das devStateIcon angezeigt und für den nächsten Zustand das passende Lampen-Icon.
|-
| <code>attr rgTimer valueFormat '{(split(" ", $VALUE))[1]}'</code>
| Vom nächsten Schaltpunkt wird nur die Zeit angezeigt.
|-
| <code>attr rgTimer commands { disable => 'disable:' }</code>
| Für das disable attribut wird das normale dropDown mit 0 und 1 angezeigt das auch in der Device Detail Ansicht verwendet wird.
|}

=== Readings löschen ===
Es kann vorkommen, dass Readings angezeigt werden, die garnicht existieren sollten - bspw. wenn man in einer HTTPMOD ein Reading umbeannt hat, kann auch der alte Readingsname immernoch angezeigt werden. Solche Readings können mit der globalen Funktion [http://fhem.de/commandref.html#deletereading deletereading] gelöscht werden.

'''Achtung:''' Auf jeden Fall die [http://fhem.de/commandref.html#deletereading CommandRef dazu] lesen!

Beispiel:
Im HTTPMOD des [[Pollenflug]] war zuerst das <code>reading04Name Graeser</code> definiert und wurde später in <code>reading04Name Gräser</code> umbenannt. In der zugehörigen ReadingGroup wurden dann konsequent beide Varianten dargestellt - auch nachdem alle Alt-Einträge aus den Logs entfernt wurden. Erst ein <code>deletereading Pollenflug Graeser</code> in der fhem-Befehltszeile hat das veraltete Reading entfernt.

=== Ausrichtung der Tabelle drehen (horizontal/vertikal) ===
Eine Readingsgroup wird standardmäßig immer zeilenweise aufgebaut, zB. jedes Gerät in eine neue Zeile. Die Werte der Geräte werden dann in den Spalten dargestellt.
Wenn man eine Readingsgroup für nur ein Gerät mit vielen Readings hat (zB. [[Allergy]]), so kann man die Darstellung horizontal oder vertikal ausrichten, indem man die Readingsgroup detailliert definiert. Ein Bsp. dazu liefert der Foreneintrag [https://forum.fhem.de/index.php/topic,37194.msg440446.html#msg440446] :

<pre>
define Pollenflugvorhersage allergy <PLZ>
attr Pollenflugvorhersage levelsFormat rc_dot@white,rc_dot@yellow,rc_dot@orange,rc_dot@red
attr Pollenflugvorhersage stateFormat fc1_maximum
attr Pollenflugvorhersage updateEmpty 1
attr Pollenflugvorhersage updateIgnored 1

# Pollen in Spalten, Tage in Zeilen
define PollenAlarmHorizontal readingsGroup <>,<Ampfer>,<Ambrosia>,<Beifuß>,<Birke>,<Buche>,<Eiche>,<Erle>,<Gräser>,<Hasel>,<Pappel>,<Roggen>,<Ulme>,<Wegerich>,<Weide> \
Pollenflugvorhersage:fc1_day_of_week,fc1_Ampfer,fc1_Ambrosia,fc1_Beifuß,fc1_Birke,fc1_Buche,fc1_Eiche,fc1_Erle,fc1_Gräser,fc1_Hasel,fc1_Pappel,fc1_Roggen,fc1_Ulme,fc1_Wegerich,fc1_Weide \
Pollenflugvorhersage:fc2_day_of_week,fc2_Ampfer,fc2_Ambrosia,fc2_Beifuß,fc2_Birke,fc2_Buche,fc2_Eiche,fc2_Erle,fc2_Gräser,fc2_Hasel,fc2_Pappel,fc2_Roggen,fc2_Ulme,fc2_Wegerich,fc2_Weide \
Pollenflugvorhersage:fc3_day_of_week,fc3_Ampfer,fc3_Ambrosia,fc3_Beifuß,fc3_Birke,fc3_Buche,fc3_Eiche,fc3_Erle,fc3_Gräser,fc3_Hasel,fc3_Pappel,fc3_Roggen,fc3_Ulme,fc3_Wegerich,fc3_Weide \
Pollenflugvorhersage:fc4_day_of_week,fc4_Ampfer,fc4_Ambrosia,fc4_Beifuß,fc4_Birke,fc4_Buche,fc4_Eiche,fc4_Erle,fc4_Gräser,fc4_Hasel,fc4_Pappel,fc4_Roggen,fc4_Ulme,fc4_Wegerich,fc4_Weide \
Pollenflugvorhersage:fc5_day_of_week,fc5_Ampfer,fc5_Ambrosia,fc5_Beifuß,fc5_Birke,fc5_Buche,fc5_Eiche,fc5_Erle,fc5_Gräser,fc5_Hasel,fc5_Pappel,fc5_Roggen,fc5_Ulme,fc5_Wegerich,fc5_Weide \
Pollenflugvorhersage:fc6_day_of_week,fc6_Ampfer,fc6_Ambrosia,fc6_Beifuß,fc6_Birke,fc6_Buche,fc6_Eiche,fc6_Erle,fc6_Gräser,fc6_Hasel,fc6_Pappel,fc6_Roggen,fc6_Ulme,fc6_Wegerich,fc6_Weide \
Pollenflugvorhersage:fc7_day_of_week,fc7_Ampfer,fc7_Ambrosia,fc7_Beifuß,fc7_Birke,fc7_Buche,fc7_Eiche,fc7_Erle,fc7_Gräser,fc7_Hasel,fc7_Pappel,fc7_Roggen,fc7_Ulme,fc7_Wegerich,fc7_Weide
attr PollenAlarm nonames 1
attr PollenAlarm valueFormat %VALUE
attr PollenAlarm valueIcon %VALUE

# Tage in Spalten, Pollen in Zeilen
define PollenAlarmVertikal readingsGroup Pollenflugvorhersage:<Pollen>,fc0_day_of_week,fc1_day_of_week,fc2_day_of_week,fc3_day_of_week,fc4_day_of_week,fc5_day_of_week,fc6_day_of_week,fc7_day_of_week \
Pollenflugvorhersage:<Ambrosia>,fc0_Ambrosia,fc1_Ambrosia,fc2_Ambrosia,fc3_Ambrosia,fc4_Ambrosia,fc5_Ambrosia,fc6_Ambrosia,fc7_Ambrosia\
Pollenflugvorhersage:<Ampfer>,fc0_Ampfer,fc1_Ampfer,fc2_Ampfer,fc3_Ampfer,fc4_Ampfer,fc5_Ampfer,fc6_Ampfer,fc7_Ampfer\
Pollenflugvorhersage:<Beifuß>,fc0_Beifuss,fc1_Beifuss,fc2_Beifuss,fc3_Beifuss,fc4_Beifuss,fc5_Beifuss,fc6_Beifuss,fc7_Beifuss\
Pollenflugvorhersage:<<b>Birke<Birke</b>>,fc0_Birke,fc1_Birke,fc2_Birke,fc3_Birke,fc4_Birke,fc5_Birke,fc6_Birke,fc7_Birke\
Pollenflugvorhersage:<Buche>,fc0_Buche,fc1_Buche,fc2_Buche,fc3_Buche,fc4_Buche,fc5_Buche,fc6_Buche,fc7_Buche\
Pollenflugvorhersage:<Eiche>,fc0_Eiche,fc1_Eiche,fc2_Eiche,fc3_Eiche,fc4_Eiche,fc5_Eiche,fc6_Eiche,fc7_Eiche\
Pollenflugvorhersage:<<b>Erle<Erle</b>>,fc0_Erle,fc1_Erle,fc2_Erle,fc3_Erle,fc4_Erle,fc5_Erle,fc6_Erle,fc7_Erle\
Pollenflugvorhersage:<Gräser>,fc0_Graeser,fc1_Graeser,fc2_Graeser,fc3_Graeser,fc4_Graeser,fc5_Graeser,fc6_Graeser,fc7_Graeser\
Pollenflugvorhersage:<<b>Hasel<Hasel</b>>,fc0_Hasel,fc1_Hasel,fc2_Hasel,fc3_Hasel,fc4_Hasel,fc5_Hasel,fc6_Hasel,fc7_Hasel\
Pollenflugvorhersage:<Pappel>,fc0_Pappel,fc1_Pappel,fc2_Pappel,fc3_Pappel,fc4_Pappel,fc5_Pappel,fc6_Pappel,fc7_Pappel\
Pollenflugvorhersage:<Roggen>,fc0_Roggen,fc1_Roggen,fc2_Roggen,fc3_Roggen,fc4_Roggen,fc5_Roggen,fc6_Roggen,fc7_Roggen\
Pollenflugvorhersage:<Ulme>,fc0_Ulme,fc1_Ulme,fc2_Ulme,fc3_Ulme,fc4_Ulme,fc5_Ulme,fc6_Ulme,fc7_Ulme\
Pollenflugvorhersage:<Wegerich>,fc0_Wegerich,fc1_Wegerich,fc2_Ulme,fc3_Wegerich,fc4_Wegerich,fc5_Wegerich,fc6_Wegerich,fc7_Wegerich\
Pollenflugvorhersage:<Weide>,fc0_Weide,fc1_Weide,fc2_Weide,fc3_Weide,fc4_Weide,fc5_Weide,fc6_Weide,fc7_Weide
</pre>

== Berechnungen ==
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Das Rechnen funktioniert über das Flag "$", mit dem eine Funktion angegeben werden kann, die auf beliebige Kombinationen von Zeilen, Spalten und einzelnen Zellen angewendet wird. Ähnlich wie in einer Tabellenkalkulation.

Ein Beispiel:
:<code>define rg readingsGroup .*:temperature rg:$avg</code>
Damit wird eine readingsGroup über alle ''temperature'' Readings definiert. In einer zusätzlichen Zeile am Ende wird mit ''$avg'' der Durchschnittswert aller darüber liegenden Temperaturen angezeigt.

Das genaue Format: <code>$<operator>[(<zellen>)]</code> mit
*<code><operator></code>: sum, avg, min, max, scalar, count oder der Name einer beliebigen anderen Funktion, die ein Array mit allen Werten übergeben bekommt und ein Ergebnis zurückliefert.
*<code><zellen></code> ist eine durch Semikolon getrennte Liste aus <code><zeilen>:<spalten></code> Paaren.
*<code><zeilen></code> und <code><spalten></code> sind jeweils eine Perl Liste, d.h. hier können
** einzelne Werte,
** durch Komma getrennte Aufzählungen,
** mit .. angegebene Wertebereiche
** sowie <code>$ROW</code> und <code>$COLUMN</code> als Bezeichner für die aktuelle Zelle
:verwendet werden.

Alle Möglichkeiten sind kombinierbar. Die Zählung der Zeilen und Spalten beginnt bei 1. Eine nicht vorhandene Zeilenangabe wird durch den Bereich von Zeile 1 bis zur aktuellen Zeile ersetzt, eine nicht vorhandene Spalte durch die aktuelle Spalte.

Es ergeben sich somit unter anderem folgende Möglichkeiten:
*<code>$sum</code> equivalent zu <code>$sum(1..$ROW), $sum(:$COLUMN)</code> und <code>$sum(1..$ROW:$COLUMN)</code> die Summe der Werte in der Spalte über der aktuellen Zelle.
*<code>$max($ROW:1..$COLUMN-1)</code> Maximum aller Werte links von der aktuellen Zelle (in der aktuellen Zeile)
*<code>$avg(1..$ROW:1)</code> Durchschnitt aller Werte in Spalte 1 bis zur aktuellen Zeile
*<code>$scalar(:1)</code> Anzahl der Werte in Spalte 1
*<code>$min(1..5:1,2,4)</code> Minimum der Werte aus den Zeilen 1-5 in den Spalten 1, 2 und 4

Eigene Funktionen lassen sich über 99_myUtils anlegen und z.B. verwenden um Häufigkeiten zu zählen oder mit nichtnumerischen Readings umzugehen.

Die Ergebnisse werden im Weiteren wie normale Readings behandelt. Sie lassen sich von links oben nach rechts unten kaskadieren und lassen sich über valuePrefix, valueSuffix, valueFormat und valueStyle in der Darstellung beeinflussen. Also z.B. einfärben, als Balkendiagramm darstellen, ...

Mit Hilfe der Funktionalität zum auf- und zu-klappen von Teilen einer readingsGroup lassen sich z.B. im zusammengeklappten Zustand Summen, Extremwerte oder andere Ausreißer anzeigen und die Details nur beim Aufklappen zeigen.

Weitere Möglichkeiten:
* Attribut <code>firstCalcRow</code>: Hiermit kann der Default für die Nummer der ersten Zeile vorgegeben werden (sofern im Ausdruck nichts genaueres angegeben ist). firstCalcRow sollte z.B. auf 2 gesetzt werden, wenn in der readingsGroup Spaltenüberschriften verwendet werden.
* special <code><nowiki><hr></nowiki></code> um eine horizontale Linie über die volle Breite einzufügen
* Über ein angehängtes <code>@<alias></code> kann einem Rechenergebniss ein Alias-Name gegeben werden. Über diesen kann der Wert dann zur Formatierung mit den value-Attributen angesprochen werden.
* das <code>alwaysTrigger</code> Attribut kann jetzt auch den Wert 2 bekommen. Damit werden in der readingsGroup Readings für alle durch die Aggregation gebildeten Werte und entsprechende Events auch dann erzeugt wenn die readingsGroup nicht angezeigt wird. Wenn ein Alias-Name vergeben ist, wird dieser auch für den Reading-Namen verwendet.
* Über den operator <code>$count(<wert>)(<zellen>)</code> um das Vorkommen von <code><wert></code> in den angegebenen Zellen zu zählen. <code><wert></code> kann enweder direkt der zu zählende Wert sein (ohne Anführungzeichen) oder eine in / eingeschlossene regex. Mit <code>!<wert></code> kann das Nicht-Vorkommen von <code><wert></code> gezählt werden.

=== Ein interaktives Beispiel ===
[[Datei:rgCalc.png|mini|right|400px|Beispiel-readingsGroup mit Berechnungen]]
In drei [[dummy]] Objekten lässt sich jeweils ein Reading über einen Slider einstellen. In der darunter liegenden readingsGroup werden diese Readings und diverse daraus abgeleitete Werte dargestellt. Alle Readings und die daraus abgeleiteten Werte werden live per longpoll aktualisiert, wenn die slider bewegt werden.
<br clear=all>
<pre>
define t1 dummy
attr t1 room rg
attr t1 setList state:slider,-10,1,30
attr t1 webCmd state
define t2 dummy
attr t2 room rg
attr t2 setList state:slider,-10,1,30
attr t2 webCmd state
define t3 dummy
attr t3 room rg
attr t3 setList state:slider,-10,1,30
attr t3 webCmd state

define rg readingsGroup <>,<value>,<sum>,<min>,<max>,<avg>\
t\d:+NAME,state,$sum(1..$ROW:2),$min(1..$ROW:2),$max(1..$ROW:2),$avg(1..$ROW:2)\
<hr>\
rg:<>,$scalar,$sum(:2)@SUM,$min(:2)@MIN,$max(:2)@MAX,$avg(:2)@AVG\
<hr>\
t1:<t1,t2,t3>,state,state@t2,state@t3,$sum($ROW:2..4)@SUM,$count(/\d/)(2..$ROW-4:2)\

attr rg nonames 1
attr rg room rg
attr rg style style='text-align:center'
attr rg valueFormat { 'avg' => '%.2f', 'AVG' => '%.2f' }
attr rg valuePrefix { 'rg.scalar' => '#', 'rg.SUM' =>'Σ; ', 'rg.MIN' =>'Min: ', 'rg.MAX' =>'Max: ', 'rg.AVG' =>'∅; ', 'rg.count' => '#(X): ' }
attr rg valueSuffix { state => '°;C' }
</pre>

== Links und Trigger ==
=== readingsGroup mit Link ===
[[Datei:rgPCA-detail.png|mini|400px|readingsGroup mit Link]]
Das PCA301 Beispiel oben lässt sich mit einem ans Ende des define angehängten
:<code><{appendTrigger($DEVICE,"clear","Alle löschen")}></code>
und der folgenden appendTrigger Definition in 99_myUtils.pm um einen Link erweitern, der ein Event auslöst, an das z.B. ein notify gehängt werden kann, um die Verbrauchszähler der PCA301 Dosen zurückzusetzen.
:<code>define clearVerbrauch notify Verbrauch:clear set TYPE=PCA301 clear</code>

<source lang="perl">
use vars qw($FW_ME);
use vars qw($FW_subdir);
sub
appendTrigger($$$)
{
my ($name,$trigger,$label) = @_;

my $ret .= "</table></td></tr>";

my $link = "cmd=trigger $name $trigger";
my $txt = "<a onClick=\"FW_cmd('$FW_ME$FW_subdir?XHR=1&$link')\">$label</a>";
$ret .= "<td colspan=\"99\"><div style=\"cursor:pointer;color:#888888;text-align:right\">$txt</div></td>";

return ($ret,0);
}</source>

wenn hierdurch Änderungen an einer readingsGroup erfolgen, die ein Neuladen der Seite erforderlich machen, kann dies so erfolgen:
:<code>{myUtils_refresh("WEB")}</code>
mit folgendem code in 99_myUtils.pm:
<source lang="perl">
sub
myUtils_refresh($)
{
my ($name) = @_;

FW_directNotify("#FHEMWEB:$name", "location.reload(true);","" );
}</source>

Ein weiteres Beispiel für 'custom links und trigger' findet sich in {{Link2Forum|Topic=14425|Message=109383|LinkText=diesem Forenbeitrag}}: dort wird damit eine readingsGroup dynamisch umgeschaltet, um nur die eingeschalteten, nur die ausgeschalteten oder alle Lampen anzuzeigen.

=== sub rg ===
Damit beim klicken auf ein Icon oder einen Text in einer readingsGroup etwas passiert ist es möglich dies über das commands Attribut auf ein <code>'trigger ntfy_rg $DEVICE $READING'</code> oder Ähnliches zu mappen.
Anlegen des ntfy_rg notify
<pre>
define ntfy_rg notify ntfy_rg {rg($EVENT)}
</pre>
Folgender Code muss noch in de [[99_myUtils_anlegen|99_myUtils.pm]]
<source lang="perl">
sub rg($){
my @input = split(/[§\s]+/,shift);
my $device = $input[0];
my $function = $input[1];

if($function eq "clima"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;

return(("d_climaControl_".$room));
}
elsif($function eq "device"){
return InternalVal($device,"device","device error");
}
elsif($function eq "controlMode"){
my $controlMode = ReadingsVal($device,"controlMode","controlMode error");

if($controlMode ~~ /manual/)
{fhem("set $device controlMode auto")}
elsif($controlMode ~~ /auto/)
{fhem("set $device controlMode manual")};
}
elsif($function eq "globalBtnLock"){
my $globalBtnLock = ReadingsVal($device,"R-globalBtnLock","globalBtnLock error");

if($globalBtnLock ~~ /off/){
{fhem("set $device regSet globalBtnLock on")}
{fhem ("set $device getConfig")}
}
elsif($globalBtnLock ~~ /on/){
{fhem("set $device regSet globalBtnLock off")}
{fhem ("set $device getConfig")}
};
}
elsif($function eq "state"){
my $state = Value($device);

if($state ~~ /off/){
{fhem("set $device on")}
}
elsif($state ~~ /on/){
{fhem("set $device off")}
};
}
elsif($function eq "setTimeTable"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;
my $climaControl = ("d_climaControl_".$room);
my $dayTemp = ReadingsVal( $climaControl, "dayTemp" , 21.0 );
my $nightTemp = ReadingsVal( $climaControl, "nightTemp" , 17.0 );
my $workday_period_1_start = ReadingsVal( $climaControl, "workday_period_1_start" , "06:30" );
my $workday_period_1_stop = ReadingsVal( $climaControl, "workday_period_1_stop" , "18:00" );
my $workday_period_2_start = ReadingsVal( $climaControl, "workday_period_2_start" , "24:00" );
my $workday_period_2_stop = ReadingsVal( $climaControl, "workday_period_2_stop" , "24:00" );
my $saturday_period_1_start = ReadingsVal( $climaControl, "saturday_period_1_start" , "06:30" );
my $saturday_period_1_stop = ReadingsVal( $climaControl, "saturday_period_1_stop" , "12:00" );
my $saturday_period_2_start = ReadingsVal( $climaControl, "saturday_period_2_start" , "24:00" );
my $saturday_period_2_stop = ReadingsVal( $climaControl, "saturday_period_2_stop" , "24:00" );
my $sunday_period_1_start = ReadingsVal( $climaControl, "sunday_period_1_start" , "24:00" );
my $sunday_period_1_stop = ReadingsVal( $climaControl, "sunday_period_1_stop" , "24:00" );
my $sunday_period_2_start = ReadingsVal( $climaControl, "sunday_period_2_start" , "24:00" );
my $sunday_period_2_stop = ReadingsVal( $climaControl, "sunday_period_2_stop" , "24:00" );

{fhem("set $device tempListMon prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListTue prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListWed prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListThu prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListFri prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSat prep $saturday_period_1_start $nightTemp $saturday_period_1_stop $dayTemp $saturday_period_2_start $nightTemp $saturday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSun exec $sunday_period_1_start $nightTemp $sunday_period_1_stop $dayTemp $sunday_period_2_start $nightTemp $sunday_period_2_stop $dayTemp 24:00 $nightTemp")};
}
}
</source>
Hier sind die benötigten CodeBlöcke für [[ReadingsGroup#Heizungswerte.2C_Status.2C_Steuerung_und_Wochenprofil|Heizungswerte, Status, Steuerung und Wochenprofil]] enthalten, aber auch um state zu triggern.

== Sonstiges ==
In der Regel werden die Parameter zu einem reading in den mappings unter <$DEVICE> und dann <$DEVICE>.<$READING> und dann unter <$READING>.<$VALUE> gesucht.

=== Lesbar machen ===
Für die meisten Attribute gilt:

* Wenn es komplexer wird ist es einfacher, den Code in eine eigene Routine in (beispielsweise) [[99 myUtils anlegen|99_myUtils]] auszulagern und diese aufzurufen:
:<code> attr <name> valueStyle {myValueToFormat($READING,$VALUE)}</code>
* code für unterschiedliche readings kann auch im mapping schon aufgeteilt werden:
:<code>attr <name> valueStyle { SuperE5 => '{perl code}', Diesel => '{perl code}' }</code>
* Ifs lassen sich verschachteln und sortieren. So kann die Anzahl der Klammern und Else-Zweige reduziert werden:
if( $READING eq ... ) {
return xxx if( $VALUE < 1 );
return yyy if( $VALUE < 1.5 );
return zzz;
} elsif( $READING eq ... ) {
...
}

Da alles lässt sich natürlich auch kombinieren und so viel lesbarer machen als ein einziger langer Bandwurm.

=== readingsGroup in einer Gruppe ===
Wenn der doppelte Rahmen um eine readingsGroup bei Darstellung in einer Gruppe stört, lässt er sich mit dem passenden style entfernen:
:<code>attr <rgName> style style="border:0px;background:none;box-shadow:none"</code>
Für die readingsGroup ''rgName'' wird der Darstellungsstil verändert.

Anwendungs-Bsp: [[Pollenflug]]

=== Einfache Balkendiagramme ===
[[Datei:rgBars.png|mini|400px|readingsGroup mit Balken]]
Readings lassen sich mit einem valueStyle der folgenden Art mit einem "Füllstandsbalken" hinterlegen:
:<code>attr <rgName> valueStyle style="width:200px; text-align:center; border: 1px solid #ccc; background:-webkit-linear-gradient(left, red $VALUE%, rgba(0,0,0,0) $VALUE%)"</code>

Die Balken werden bei Änderungen der Readings automatisch per longpoll aktualisiert.

Diese direkte Definition des <code>valueStyle</code> ist allerdings sehr unflexibel - bspw. müsste der <code>$VALUE</code> zufällig max 100 erreichen und es darf nur ein Browsertyp eingesetzt werden, damit alles sauber funktioniert.

Deutlich flexibler ist eine Auslagerung als eigenständige Funktion in die [[99_myUtils_anlegen|99_myUtils.pm]], die den valueStyle dynamisch generiert, bspw.:

<source lang="perl">
sub Balkenanzeige($)
{
# Zuweisung der übergebenen Variablen
my ($val) = @_;

# Konfiguration des maximal übergebenen Werts (hier wäre der höchste zu erwartende Wert = 3)
my $maxValue = 3;

# Normalisierung auf 100%-Wert
my $percent = $val / $maxValue * 100;

# Definition des valueStyles
my $stylestring = 'style="
width: 200px;
text-align:center;
border: 1px solid #ccc;
background-image: -webkit-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -moz-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -ms-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -o-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
"';

# Rückgabe des definierten Strings
return $stylestring;
}
</source>

Der Aufruf sähe dann wie folgt aus:

<code> attr <rgName> valueStyle { Balkenanzeige($VALUE) } </code>

Die einzelnen Werte des <code>$stylestring</code> haben folgende Bedeutungen:
* width - Breite des Balkenrahmens
* text-align - Ausrichtung des Texts
* border - Format des Balkenrahmens
* background-image - Format des Hintergrunds des Balkenrahmens, also des Balkens selbst
** linear-gradient - css-Funktion zur Erstellung von Farbverläufen ''(*)''
*** left - linksbündiger Balken
*** red x% - roter Balken x% breit
*** rgba(0,0,0,0) x% - farbloser Teil startet bei x%

''(*) linear-gradient wird in verschiedenen Browsern unterschiedlich umgesetzt. Deshalb sollten immer alle Varianten zusammen angegeben werden, damit die Darstellung auf allen Browsern funktioniert. (vgl. Link unten)''

Weitere Infos zu:
* linear-gradient - [https://developer.mozilla.org/de/docs/Web/CSS/linear-gradient]
* Farbanpassungen, z.B. auch unter Verwendung der [[Color#Skalenfarbe_mit_Color::pahColor|Color::pahColor]] Routine.
* Anpassung von Werten s.o. [[ReadingsGroup#Lesbar_machen]]
* weiteren Möglichkeiten zur Erzeugung von Balkendiagrammen in Forenbeiträgen {{Link2Forum|Topic=25313|LinkText=hier}} und {{Link2Forum|Topic=28318|LinkText=hier}}
* [[99_myUtils_anlegen|99_myUtils.pm]]

Anwendungs-Bsp: [[Pollenflug]]

=== readingsGroup Styling mit CSS ===
Jede readingsGroup lässt sich durch CSS individuell stylen.

==== Allgemeines ====
Damit der eigene CSS Code nach einem [[Update]] der FHEM-Style Dateien vorhanden bleibt, ist es notwenig eine eigene .css Datei (zB ios7ReadingsGroups.css) zu erstellen und ins Verzeichnis ''fhem/www/pgm2/'' zu kopieren. Anschließend muss in der [[FHEMWEB]] Instanz das Attribut ''CssFiles'' auf zB ''pgm2/ios7ReadingsGroups.css'' gesetzt werden.

==== Erweiterte Device Übersicht ====
Diese ReadingsGroup ist an der [[FHEMWEB]] Device-Übersicht angelehnt. Zusätzlich werden weitere Readings, hier Leistung, Betriebszeit Heute und Jahr, ein Link zu Detail-Seite der ReadingsGroup und Links zu den jeweiligen Device-Detail-Seite, dargestellt.

{| class="wikitable"
| [[Datei:RgStylingOhneCss.png|600px|mini|left|Device ReadingsGroup ohne CSS]] [[Datei:RgStylingMitCss.png|600px|mini|left|Device ReadingsGroup mit CSS]]
|}

===== Definition =====
<pre>
define rg_devices readingsGroup <{rgLink($DEVICE,"konfigurieren","Details")}>,<Device>,<Status>,<Leistung>,<Heute>,<Jahr>\
wzDeckenfluter:<%light_floor_lamp>,<{rgLink("wzDeckenfluter","detail","Deckenfluter")}>,state,<>,dauerHeute,dauerJahr\
wzMacMini:<%it_nas>,<{rgLink("wzMacMini","detail","MacMini")}>,state,power,consumption,consumptionYear\
attr rg_devices noheading 1
attr rg_devices nonames 1
attr rg_devices notime 1
attr rg_devices room ReadingsGroup Styling
attr rg_devices style class="block wide rgDevices"
attr rg_devices valueFormat { 'power' => "%.1f W ", consumption => "%.2f kWh", 'consumptionYear' => "%.2f kWh" }
attr rg_devices valueIcon { state => '%devStateIcon' }
</pre>

Damit sich der CSS auf die richtige readingsGroup bezieht, ist es nötigt
das Attribut ''style'' anzupassen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| style="width:40%" |<code>attr <rgName> style class="block wide rgDevices"</code>
| Die Klassen ''block'' und ''wide'' müssen eingetragen werden. Der Name der Nachfolgenden Klasse, hier ''rgDevices'', ist frei wählbar.
|}
===== Funktion rgLink() =====
Die Funktion rgLink($name,$action,$label) liefert einen Link mit dem Namen $label zurück. Der Code gehört in die [[99 myUtils anlegen|99_myUtils.pm]].
* $name - Name des Device das aufgerufen werden soll
* $action - Aktion die Ausgeführt werden soll.
**''konfigurieren'' erzeugt den kleinen ''Details'' Button links oben der einem zur Detail Seite der ReadingsGroup führt - nützlich wenn das ReadingsGroup-Attribut ''noheading'' gesetzt ist
** ''detail'' erzeugt einen Link zu Device-Detail Seite
* $label - Link-Name
<source lang="perl">
sub rgLink($$$){
my ($name,$action,$label) = @_;
my $link = "";
my $fhemLink = "";
my $txt = "";
my $ret = "";
my $divStyle = "";
my $aStyle = "";

# FHEM Variablen einbinden
use vars qw($FW_ME);
use vars qw($FW_subdir);
use vars qw($FW_ss);
use vars qw($FW_tp);

if( $action eq "konfigurieren" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;font-size:11px;padding-bottom:2px;padding-left:3px;";
}
elsif( $action eq "detail" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;display:inline;";
}

$link = '<a onclick="location.href=\'' . $FW_ME . $FW_subdir . '?' . $fhemLink . '\'" style="' . $aStyle . '">' . $label . '</a>';
$txt = '<div style="' . $divStyle . '">' . $link . '</div>';
$ret = "$txt";

return $ret;
}
</source>

{{Randnotiz|RNText=Tipp
Verwende zum Bearbeiten der eigenen .css Dateien entweder den [[Konfiguration#Syntaxhervorhebung|Codemirror Editor]] oder einen eigenen Editor mit [http://de.wikipedia.org/wiki/Syntaxhervorhebung Syntax Highlighting] . Das hilft bei der Fehlersuche enorm. }}

===== Styling =====
Die eigene .css Datei erscheint in FHEM unter Edit-Files --> styles und kann direkt im FHEM-Editor oder mit eigenen Editor bearbeitet werden.

ios7ReadingsGroups.css:
<pre>
/* Readings Groups Devices */
table.rgDevices tr td{ text-align: center; }
table.rgDevices tr:first-child td:nth-child(2){ /* 1. Zeile 2. Spalte */ text-align: center; }
table.rgDevices tr td:first-child{ /* 1. Spalte */ width: 45px; text-align: center; }
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 33%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
</pre>

==== Auf Portrait / Landscape Modus des Smartphone unterscheiden ====
Dieses Beispiel ist an das obige Beispiel [[#Erweiterte_Device_.C3.9Cbersicht|Erweiterte Device Übersicht]] angelehnt.

{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortrait.png|300px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscape.png|550px|mini|center|Device ReadingsGroup im Landscape Modus]]
|}

===== Allgemeines =====
Mit CSS ist man in der Lage auf die aktuelle Bildschirmlage zu reagieren. Alle Anweisungen die in diesen beiden Funktionen zwischen den beiden { } stehen, werden je nach Bildschirmlage aufgerufen
<pre>
/* Portrait Modus */
@media all and (orientation:portrait) { }

/* Landscape Modus */
@media all and (orientation:landscape) { }
</pre>

===== Styling =====
{{Randnotiz|RNText=Info
* ''width: xx%'' ändert die Breite der Spalte
* ''display: none'' blendet die Spalte aus}}
In der FHEMWEB_phone Instanz muss wie [[#Allgemeines|hier]] beschrieben eine neue eigene .css Datei eingetragen werden. In diesem Beispiel ios7smallscreenReadingsGroups.css

ios7smallscreenReadingsGroups.css
<pre>
/* landscape und portrait modus */
table.rgDevices tr td { /* Zuerst alles centern */ text-align: center; }
table.rgDevices tr:first-child td:nth-child(1){ /* 1. Zeile 1. Spalte */ text-align: center; }
table.rgDevices tr td:first-child { /* 1. Spalte */ width: 5%; }
table.rgDevices tr:first-child td:nth-child(2) { /* 1. Zeile 2. Spalte */ text-align: center; }
table.block table tr td table.rgDevices tr td { border-bottom: 1px solid #cbcbcb; }

/* Portrait Modus */
@media all and (orientation:portrait) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 50%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: auto; text-align: right; display: table-cell; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(6){ width: 0; display: none; }
table.rgDevices tr td div a svg{ margin-left: 90px; }
}

/* Landscape Modus */
@media all and (orientation:landscape) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 35%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
}
</pre>

==== Plots im Portrait Modus des Smartphones ausblenden ====
{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortraitPlot.png|350px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscapePlot.PNG|550px|mini|center|Plot nur im Landscape]]
|}

Um die Plot und alle Steuerelemente im Portrait Modus auszublenden fügt man in seine eigene smallscreen.css wie [[#Allgemeines|hier beschrieben]] folgendes ein:
<pre>
@media all and (orientation:portrait) {
.SVGplot, .SVGlabel, .Zoom-in, .Zoom-out, .Prev { width: 0; display: none; }
}
</pre>

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]

ReadingsGroup

2016-11-13T20:34:11Z

LHBL2003: /* Heizungswerte, Status, Steuerung und Wochenprofil */

{{SEITENTITEL:readingsGroup}}
{{Infobox Modul
|ModPurpose=Einfache zusammenfassende Darstellung von Informationen über mehrere Geräte und deren Steuerung
|ModType=h
|ModCmdRef=readingsGroup
|ModForumArea=Frontends
|ModTechName=33_readingsGroup.pm
|ModOwner=Andre ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])}}

Das Fhem-[[:Kategorie:Hilfsmodul|Hilfsmodul]] [[readingsGroup]] bietet eine einfache Möglichkeit, ''Readings'' (kein Präfix vor dem Reading-Namen), ''Internals'' (Präfix "+" vor dem Namen des internen Wertes) und ''Attributes'' (Präfix "?" vor dem Namen des Attributs) von einem oder mehreren ''Devices'' darzustellen und flexibel zu formatieren.

Die Aktualisierung im Browserfenster geschieht per longpoll und überträgt nur die jeweils geänderten Zellen. Wenn eine readingsGroup in keinem Browserfenster angezeigt wird findet keine longpoll aktualisierung statt.

== Definition ==
Siehe [http://fhem.de/commandref.html#readingsGroup commandref].

== Attribute ==
{{Randnotiz|RNText=In allen Mappings die einen Hash verwenden muss der Key (das was jeweils links von => Operator steht) in Anführungszeichen stehen. Die einzige Ausnahme hiervon sind Keys die aus einem String bestehen der mit einem Buchstaben beginnt und nur Buchstaben und Zahlen enthält.}}
Weitergehende Erläuterungen zu einzelnen Attributen.

Die komplette Liste der Attribute ist der commandref zu entnehmen.

=== noheading ===
[[Datei:ReadingsGroup_noheading.png|mini|rechts|400px|ReadingsGroup: rechts mit "noheading" Attribut, links der anklickbare Titel]]
Das Attribut <code>noheading</code> führt dazu, dass der Alias der ReadingsGroup nicht mehr als Titel angezeigt wird. Das kann wünschenswert sein, wenn die ReadingsGroup auf einer [[Dashboard]]-Seite angezeigt werden soll, hat allerdings den Nachteil, dass die Detail-Ansicht der ReadingsGroup nicht mehr über einen Klick auf den Titel aufgerufen werden kann. Der Einstellungsdialog der ReadingsGroup ist dann nur noch (z. B.) über
* <code>list TYPE=readingsGroup</code>
* einen "Probably associated with"-Link eines anderen Objekts oder über
* manuelle Modifikation der URL eines anderen Objekts (<code>http:.../fhem?detail=<objektname></code>)
erreichbar.

=== nolinks ===
Devicenamen und Titel der readingsGroup verlinken nicht mehr zur zugehörigen Detailansicht und sind nicht mehr anklickbar.

=== nostate ===
Das state-Reading wird bei regex match nicht berücksichtigt und nicht angezeigt.

=== notime ===
Es werden keine Timestamps für die Readings angezeigt. Nur für einspaltige readingsGroups sinnvoll.

== Beispiele ==
Bitte beachten: die folgenden Beispiele enthalten keine Maskierungen oder Verdoppelungen für ; und Zeilenende, sondern sind so angegeben, wie sie im [[PGM2|Web Interface]] im Befehls-Eingabefeld, nach Klick auf DEF und im Attribut-Eingabefeld eingegeben werden. Beim manuellen Einfügen in eine [[Konfiguration|Konfigurationsdatei]] sind diese Maskierungen oder Verdoppelungen natürlich vorzunehmen.

=== Einfache Auswahl über Reading-Namen ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define battStatus readingsGroup .*:[Bb]attery</code>
| Alle readings mit Namen '''Battery''' oder '''battery''' von allen Devices.
| rowspan=3 | [[Datei:rgBattery.png|thumb]]
|-
| <code>attr battStatus alias FHT Batteriestatus </code>
| Der Alias wird als Zeilentitel verwendet
|-
| <code>attr battStatus mapping %ROOM </code>
| ''Mapping %ROOM'' führt dazu, dass der Raumname als Zeilentitel angezeigt wird.
|}

=== Übersicht HomeMatic Geräte ===

<nowiki>define HM_Components readingsGroup <Gerät>,<Name>,<Model>,<S/N> TYPE=CUL_HM:+NAME,?model,D-serialNr</nowiki>

=== Auswahl über Reading-Namen, Status als Symbol dargestellt ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg_battery readingsGroup .*:battery</code>
| Alle readings mit Namen '''battery''' von allen Devices.
| rowspan=4 | [[Datei:rgBattery2.png|thumb]]
|-
| <code>attr rg_battery alias Batteriestatus </code>
| Der Alias wird als Überschrift verwendet
|-
| <code>attr rg_battery valueIcon {'battery.ok' => 'batterie', 'battery.low' => 'batterie@red'}</code>
| Statt der reading Werte "ok" und "low" soll ein Icon angezeigt werden.
|-
|<code>attr rg_battery commands { "battery.low" => "set %DEVICE replaceBatteryForSec 60" }</code>
| Für LaCrosse devices kann man beim Klick auf ein rotes "battery low icon" direkt replaceBatteryForSec setzen.
|}

=== Reading-Werte zuordnen (Icon / Text) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg readingsGroup Contact.Dachboden_gross:sensed.*</code>
| Alle sensedreadings des Contact.Dachboden_gross device.
| rowspan=4 | [[Datei:rgFenster.png|thumb]]
|-
| <code>attr rg mapping { 'sensed.A' => 'links', 'sensed.B' => 'rechts' }</code>
| Die Zuordnung rechts/links
|-
| <code>attr rg valueFormat {($VALUE eq '1')?"fts_window_roof":"fts_window_roof_open_2"}</code>
| Die Zuordnung von reading Wert zu Icon Namen.
|-
| <code>attr rg_battery valueIcon %VALUE </code>
| Statt des reading Werts soll ein Icon angezeigt werden.
|}

=== Formatvorgabe für Ausgabewerte ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define TempHygro readingsGroup TYPE=CUL_WS:temperature,humidity,dewpoint</code>
| Alle readings mit Namen '''temperature''', '''humidity''', '''dewpoint''' von allen Devices des Typs '''CUL_WS'''
| rowspan=4 | [[Datei:rgTemperatur.png|thumb|[[S300TH]]-Werte in einer readingsGroup]]
|-
| <code>attr TempHygro alias Temperatur / rel. Feuchte / Taupunkt</code>
| Der Alias der readingsGroup wird als Überschrift verwendet
|-
| <code>attr TempHygro mapping %ALIAS</code>
| ''Mapping %ALIAS'' führt dazu, dass der Alias des Geräts als Zeilentitel angezeigt wird.
|-
| <code>attr TempHygro valueFormat { temperature => "%.1f&deg;C", humidity => "%.1f %%", dewpoint => "%.1f&deg;C"}</code>
| Formatierung der Ausgabewerte. '''Achtung:''' "%" die in der Ausgabe erscheinen sollen, müssen verdoppelt werden!
|}

=== Ausgabestil (hier rechtsbündig) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Wetter readingsGroup WetterXXX:<%temp_temperature>,<Temperatur>,temperature WetterXXX:<%weather_humidity>,<Luftfeuchte>,humidity WetterXXX:<%weather_barometric_pressure>,<Luftdruck>,pressure
</code>
| Die readings mit Namen '''temperature''', '''humidity''' und '''pressure''' vom Device WetterXXX jeweils mit einem Icon und einem Label davor.
| rowspan=3 | [[Datei:rgWetter.png|thumb]]
|-
| <code>attr Wetter valueFormat { temperature => '%1.f &deg;C', humidity => '%1.f %%', pressure => '%i mbar' }</code>
| Die Formatierung der Readingswerte
|-
| <code>attr Wetter valueStyle style="text-align:right"</code>
| Die Readings sollen rechtsbündig dargestellt werden.
|}

=== Internal Value ausgeben ===
Diese Beispiel könnte entfallen (nächstes Beispiel ist sehr ähnlich; es wird lediglich ein weiterer Wert ausgegeben).
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI</code>
| Den RSSI Wert aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.
| rowspan=1 | [[Datei:rgculRSSI.png|thumb]]
|}

=== Internal Values ausgeben ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI,+cul_TIME</code>
| Den RSSI Wert mit der zugehörigen Zeit aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.<br>"Internal Values" werden durch das vorangestellte '''+''' (Pluszeichen) identifiziert.
| rowspan=2 | [[Datei:rgculRSSI2.png|thumb]]
|-
|attr culRSSI valueStyle {return undef if($READING =~ m/TIME/); ($VALUE <= -85)?'style="color:red"':($VALUE <= -80)?'style="color:yellow"':undef}
|Schlechte RSSI Werte sollen abhängig von zwei Schwellwerten gelb oder rot eingefärbt werden (auf dem Screenshot nicht zu sehen).
|}

=== Alle Readings eines Gerätes, mit Ausnahme von... ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Systemstatus readingsGroup sysstat</code>
| Alle readings des sysstat Device
| rowspan=4 | [[Datei:rgSysstat.png|thumb]]
|-
| <code>attr Systemstatus nostate 1</code>
| Ohne state
|-
| <code>attr Systemstatus notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Systemstatus mapping {'load' => 'Systemauslastung', 'temperature' => 'Systemtemperatur in &deg;C'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|}

=== Anzeige auf einem Floorplan ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Heizung readingsGroup t(1|2|3):temperature</code>
| Die Temperatur readings der Devices t1, t2 und t3
| rowspan=6 | [[Datei:rgHeizung.png|thumb|220px]]
|-
| <code>attr Heizung mapping {'t1.temperature' => 'Vorlauf', 't2.temperature' => 'R&ücklauf', 't3.temperature' => 'Zirkulation'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|-
| <code>attr Heizung nameStyle style="text-align:left"</code>
| Zeilentitel linksbündig wegen floorplan
|-
| <code>attr Heizung style style="font-size:20px;color:lightgray"</code>
| Großer Font und Farbe passend für den floorplan
|-
| <code>attr Heizung notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Heizung valueFormat : %.1f &deg;C</code>
| Doppelpunkt zwischen Zeilentitel und Wert, eine Nachkommastelle plus Einheit
|}

=== LightScene DropDown-Menü für smallscreen Styles oder Floorplan ===

{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define lcDropDown readingsGroup meineLightScene:!state</code>
| Für die LightScene ''meineLightScene'' soll ein DropDown-Menü zur Auswahl der Szene erstellt werden.
| rowspan=6 |
|-
| <code>attr lcDropDown commands { state => 'scene:' }</code>
| Die Anzeige des state Readings wird auf das DropDown-Menü für das scene Kommando gemapped.
|-
| <code>attr lcDropDown nonames 1</code>
| Keine Readingnamen
|-
| <code>attr lcDropDown notime 1</code>
| Kein Timestamp
|}

=== Schriftgrößen, Farben, Icons ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgVerbrauchPCA301.png|links|mini|400px|Schriftgröße, Farbe, Icons...]]
|-
| style="width:40%" |<code>define Verbrauch readingsGroup TYPE=PCA301:state,power,consumption</code>
| Die readings state, power und consumption aller [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] Devices mit einer Zeile pro Device.
|-
| <code>attr Verbrauch mapping %ROOM %ALIAS</code>
| Der Raumname und der Alias werden als Zeilentitel verwendet
|-
| <code>attr Verbrauch nameStyle style="font-weight:bold"</code>
| Der Zeilentitel soll fett sein
|-
| <code>attr Verbrauch style style="font-size:20px"</code>
| Alles in einem größeren Font
|-
| <code>attr Verbrauch valueFormat {power => "%.1f W", consumption => "%.2f kWh"}</code>
| Die Formatierung für die power und consumption readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr Verbrauch valueIcon { state => '%devStateIcon' }</code>
| Für die Dosen, die schaltbar sind, soll das anklickbare device icon gezeigt werden.
|-
|<code>attr Verbrauch valueStyle {($READING eq "power" && $VALUE > 40)?'style="color:red"':'style="color:green"'}</code>
|Wenn das power reading >40 ist, soll es in rot angezeigt werden, alle anderen Werte und readings in grün
|}

=== Wertabhängige Farbgebung ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:TemperaturenRG.png|600px|mini|links|Wertabhängige Farben]]
[[Datei:TemperaturenRG2.png|600px|mini|links|Andere Werte - andere Farben]]
|-
| style="width:40%" |<code>define wzTemperaturenRG readingsGroup Aussen:,<Temperatur>,temperature,<Luftfeuchte>,humidity Wohnzimmer:,<Temperatur>,temperature,<Luftfeuchte>,humidity Kasten_E_Geraete:,<Temperatur>,temperature,<Luftfeuchte>,humidity</code>
| Die readings temperatur und humidity der Devices Aussen, Wohnzimmer und Kasten_E_Geraete in einer Zeile pro Device.
|-
| <code>attr wzTemperaturenRG group 3. Temperaturen</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzTemperaturenRG noheading 1</code>
| noheading
|-
| <code>attr wzTemperaturenRG nostate 1</code>
| nostate
|-
| <code>attr wzTemperaturenRG notime 1</code>
| notime
|-
| <code>attr wzTemperaturenRG valueFormat {temperature => "%.1f °C", humidity =>"%.1f %%" }</code>
| Die Formatierung für die temperatur und humidity readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr wzTemperaturenRG valueStyle { if($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 20) { 'style="color:orange"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE < 5) { 'style="color:blue"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 23) { 'style="color:red"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 21) { 'style="color:orange"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE < 20) { 'style="color:blue"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 28) { 'style="color:orange"'}elsif($READING eq "humidity" && $VALUE > 65) { 'style="color:red"'}elsif($READING eq "humidity" && $VALUE > 60) { 'style="color:orange"'}else{'style="color:green"'} }</code>
| Diverse Farbkombinationen sind möglich
|}

=== Enigma Receiver ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:ReceiverRG.jpg|600px|mini|links|Wertabhängige Farben]]
[[Datei:ReceiverRGmute.jpg|600px|mini|links|Wertabhängige Farben]]
|-
| style="width:40%" |<code>define wzReceiverRG readingsGroup wzReceiver:,<Aktuell>,eventtitle,<Rest>,eventremaining_hr,<Dauer>,eventduration_hr wzReceiver:<Beschreibung>,eventdescription wzReceiver:,<Nächste>,eventtitle_next,<Start>,eventstart_next_hr,<Dauer>,eventduration_next_hr wzReceiver:,<HDD Kapazität>,hdd1_capacity,<Frei>,wzReceiver:hdd1_free wzReceiver:,<Lautstärke>,volume,<HDD>,hdd1_capacity,<Frei>,hdd1_free</code>
| Mehrere readings des Device wzReceiver in mehreren Zeilen. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke, mute angezeigt. Farbige Anzeige des freien Speicherplatzes
'''Benötigt:''' ENIGMA2 Receiver, 70_ENIGMA2.pm - Siehe: [[Enigma2 Receiver (Dreambox, VUplus etc.) steuern]]
|-
| <code>attr wzReceiverRG group Fernseher Receiver</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzReceiverRG mapping &nbsp;</code>
| mapping wird auf &nbsp; (Leerzeichen) gesetzt, damit der Device Name nicht angezeigt wird
|-
| <code>attr wzReceiverRG noheading 1</code>
| noheading
|-
| <code>attr wzReceiverRG nostate 1</code>
| nostate
|-
| <code>attr wzReceiverRG notime 1</code>
| notime
|-
|-
| <code>attr wzReceiverRG valueColumns { eventdescription => 'colspan="4"' }</code>
| Die Beschreibung soll über 4 Spalten gehen
|-
| <code>attr wzReceiverRG valueFormat { wzReceiverRGvalueFormat($DEVICE,$READING,$VALUE);; }</code>
| Die Formatierung wird in die 99_myUtils.pm ausgelagert. Siehe: [[99 myUtils anlegen]]
|-
|<code>attr wzReceiverRG valueStyle { if($READING eq "hdd1_free" && $VALUE < 200){ 'style="color:red"' }elsif( $READING eq "hdd1_free" && $VALUE < 500 ){ 'style="color:orange"' }elsif( $READING eq "volume" && ReadingsVal($DEVICE, "mute", "") eq "on" ){ 'style="color:red"' }else{ 'style="color:green"' } }</code>
| Diverse Farbkombinationen sind möglich. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke <span style="color: red;">mute</span> angezeigt.
|-
|<source lang="perl">
sub
wzReceiverRGvalueFormat($$$)
{
my ($DEVICE,$READING,$VALUE) = @_;

if($READING eq 'hdd1_capacity') {
return "%.2f MB";
} elsif( $READING eq 'hdd1_free') {
return "%.2f MB";
} elsif( $READING eq 'volume' ) {
if( ReadingsVal($DEVICE, "mute", "") eq "on") {
return "mute";
} else {
return "%i %%";
}
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]
|}

=== Heizungswerte inklusive Batterie- und Fensterstatus ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung3.png|thumb|links|500px|Heizungswerte inklusive Batterie- und Fensterstatus]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<%18>,<%20>,<%22>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte commands { 'Heizungswerte.18' => 'set $DEVICE desired-temp 18', 'Heizungswerte.20' => 'set $DEVICE desired-temp 20', 'Heizungswerte.22' => 'set $DEVICE desired-temp 22' }</code>
| Die Links/Kommandos die hinter den 18, 20 und 22 liegen sollen.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte inklusive Ventilposition ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:Rg_Heizung_Valveposition.png|thumb|links|500px|Heizungswerte inklusive Statusinformationen (MAX!)]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,<Ventil>,<Soll>,<Ist>,<MaxV>,<GID>,<Mode>,<Batterie> TYPE=CUL_HM:ValvePosition,desired-temp,measured-temp,R-valveMaxPos,groupid,mode,battery</code>
| Diverse readings aller Devices des Typs <b>MAX</b>.
|-
| <code>attr Heizungswerte mapping %ROOM</code>
| Die Raumnamen werden angezeigt.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb (fett) sein.
|-
| <code>attr Heizungswerte room Heizung</code>
| Die "readingsgroup" wird dem Raum "Heizung" zugeordnet.
|-
| <code>attr Heizungswerte valueFormat {'temperature' => "%.0f °C", 'desiredTemperature' => "%.0f °C", 'valveposition' =>"%.0f %%", 'maxValveSetting' =>"%.0f %%" }</code>
| Es wird noch die Einheit °C hinter den Temperaturwerten angezeigt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriezustand werden Icons anstatt Klartextwerte genommen!
|-
| <code>attr Heizungswerte valueStyle { if($READING eq "temperature" && $VALUE > 20){ 'style="color:green;;font-weight:bold"' }elsif( $READING eq "temperature" && $VALUE <= 20 ){ 'style="color:blue"' }elsif( $READING eq "temperature" && $VALUE > 23 ){ 'style="color:red"' }else{ 'style="color:gray"' } }</code>
| Die Temperaturwerte werden abhängig vom Wert farbig dargestellt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte, Status und Regelmöglichkeit ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung2.png|thumb|500px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define Heizungswerte2 readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<{myUtils_HeizungUpDown($DEVICE,"up")}@desired-temp>,desired-new,<{myUtils_HeizungUpDown($DEVICE,"down")}@desired-temp>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte2 nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte2 valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|-
| <code>attr Heizungswerte2 valueStyle {($VALUE eq "00")?'style="visibility:hidden"':''}</code>
| Nach dem Einstellen den Wert wieder ausblenden.
|-
| <source lang="perl">
#Heizung regeln in readingsGroup
sub
myUtils_HeizungUpDown($$)
{
my($DEVICE,$CMD) = @_;

my $icon = $CMD;
my $VALUE = ReadingsVal($DEVICE,"desired-new","20" );
$VALUE = ReadingsVal($DEVICE,"desired-temp","20" )
if( !$VALUE || $VALUE == 0 );
my $link;

if( $CMD eq "up" ) {
$icon = "control_arrow_upward";
$VALUE += 1;

if( $VALUE <= 24 ) {
$icon .= "\@red";
$link = "setreading $DEVICE desired-new $VALUE";
}
} elsif( $CMD eq "down" ) {
$icon = "control_arrow_downward";
$VALUE -= 1;

if( $VALUE >= 18 ) {
$icon .= "\@blue";
$link = "setreading $DEVICE desired-new $VALUE";
}
}

my $notify = "notifyHeizungUpDown";
if( !defined($defs{$notify}) ) {
CommandDefine(undef,
"$notify notify .*:desired-new.* "
."{ myUtils_HeizungUpDownNotify(\$NAME,\$EVTPART1); }" );
}

my $ret = "%$icon";
$ret .= "%$link" if( $link );

return $ret;
}

sub
myUtils_HeizungUpDownNotify($$)
{
my($DEVICE,$VALUE) = @_;

return if( $VALUE == 0 );

my $at = "triggerHeizungUpDown_$DEVICE";
CommandDelete(undef, $at) if( defined($defs{$at}) );
CommandDefine(undef,
"$at at +00:00:03 "
."{my \$v = ReadingsVal(\"$DEVICE\",\"desired-new\",undef);"
."fhem(\"set $DEVICE desired-temp \$v\") if( \$v );"
."fhem(\"setreading $DEVICE desired-new 00\");}" );

return undef;
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit werden die Icons zum Ändern der gewünschten Temperatur dargestellt und im Bereich >=18 und <= 24 Grad anklickbar gemacht. Zwischen den Pfeilen wird der gerade eingestellte Wert angezeigt. Wenn dieser drei Sekunden nicht mehr geändert wurde wird die desired-temp auf diesen Wert gesetzt und die Anzeige zwischen den Pfeilen ausgeblendet.
|}

=== Heizungswerte, Status, Steuerung und Wochenprofil ===
Dieses Beispiel funktioniert nur mit HomeMatic HM-CC-RT-DN, für andere Thermostate müssen an diversen Stellen Änderungen vorgenommen werden.
{{Todo|Überarbeiten: umstellen auf readingList oder setreading, label als readings in die readingsGroup selber stecken statt in einen extra dummy. oder !<reading> und mapping verwenden.}}
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgThermostate.png|thumb|750px|links|Status, Steuerung und Wochenprofil]]
|-
| style="width:40%" |<pre>
define d_label dummy
setreading d_label Heizung Heizung
setreading d_label Temperatur Temperatur
setreading d_label Status Status
setreading d_label Wochenplan Wochenplan
setreading d_label Werktag Werktag
setreading d_label Samstag Samstag
setreading d_label Sonntag Sonntag
setreading d_label Zeitraum1 Zeitraum 1
setreading d_label Zeitraum2 Zeitraum 2 </pre>
|Erzeugen der Readings im Device [[dummy#d_label|d_label]].
|-
| <code>
define rg_thermostate readingsGroup <>,Heizung@d_label,<|>,Temperatur@d_label,<|>,Status@d_label,<|>,Wochenplan@d_label,<|>,Werktag@d_label,<|>,Samstag@d_label,<|>,Sonntag@d_label,<|>,<> CUL_HM_HM_CC_RT_DN_......_Clima:<>,?alias,<|>,<Soll>,desired-temp,<Tag>,dayTemp@{rg($DEVICE."§clima")},impossible@{$DEVICE},<|>,controlMode,R-globalBtnLock@{rg($DEVICE."§device")},<|>,Zeitraum1@d_label,<|>,workday_period_1_start@{rg($DEVICE."§clima")},workday_period_1_stop@{rg($DEVICE."§clima")},<|>,saturday_period_1_start@{rg($DEVICE."§clima")},saturday_period_1_stop@{rg($DEVICE."§clima")},<|>,sunday_period_1_start@{rg($DEVICE."§clima")},sunday_period_1_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},<%system_fhem_update>,<nowiki><br></nowiki>,state@{rg($DEVICE."§device")},<%getConfig>,<|>,<Ist>,measured-temp,<Nacht>,nightTemp@{rg($DEVICE."§clima")},<|>,<Ventil>,ValvePosition,<|>,Zeitraum2@d_label,<|>,workday_period_2_start@{rg($DEVICE."§clima")},workday_period_2_stop@{rg($DEVICE."§clima")},<|>,saturday_period_2_start@{rg($DEVICE."§clima")},saturday_period_2_stop@{rg($DEVICE."§clima")},<|>,sunday_period_2_start@{rg($DEVICE."§clima")},sunday_period_2_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},impossible@{rg($DEVICE."§device")},<%burstXmit> </code>
| Diverse readings aller Devices <b>CUL_HM_HM_CC_RT_DN_......_Clima</b>, entsprechender [[Makefine#d_climaControl|d_climaControl]] (müssen vorher angelegt werden) und [[dummy#d_label|d_label]].
|-
| <code>attr rg_thermostate commands { 'desired-temp' => 'desired-temp:', 'dayTemp' => 'dayTemp:', 'controlMode' => 'trigger ntfy_rg $DEVICE controlMode', 'R-globalBtnLock' => 'trigger ntfy_rg $DEVICE globalBtnLock', 'workday_period_1_start' => 'workday_period_1_start:', 'workday_period_1_stop' => 'workday_period_1_stop:', 'saturday_period_1_start' => 'saturday_period_1_start:', 'saturday_period_1_stop' => 'saturday_period_1_stop:', 'sunday_period_1_start' => 'sunday_period_1_start:', 'sunday_period_1_stop' => 'sunday_period_1_stop:', 'rg_thermostate.system_fhem_update' => 'trigger ntfy_rg $DEVICE setTimeTable', 'rg_thermostate.getConfig' => 'set $DEVICE getConfig', 'nightTemp' => 'nightTemp:', 'workday_period_2_start' => 'workday_period_2_start:', 'workday_period_2_stop' => 'workday_period_2_stop:', 'saturday_period_2_start' => 'saturday_period_2_start:', 'saturday_period_2_stop' => 'saturday_period_2_stop:', 'sunday_period_2_start' => 'sunday_period_2_start:', 'sunday_period_2_stop' => 'sunday_period_2_stop:', 'rg_thermostate.burstXmit' => 'set $DEVICE burstXmit'}</code>
| Temperaturen werden als DropDown Auswahl dargestellt, Icons triggern [[readingsGroup#sub_rg|ntfy_rg]]
|-
| <code>attr rg_thermostate mapping { 'desired-temp' => '', 'dayTemp' => '', 'workday_period_1_start' => '', 'workday_period_1_stop' => '', 'saturday_period_1_start' => '', 'saturday_period_1_stop' => '', 'sunday_period_1_start' => '', 'sunday_period_1_stop' => '', 'nightTemp' => '', 'workday_period_2_start' => '', 'workday_period_2_stop' => '', 'saturday_period_2_start' => '', 'saturday_period_2_stop' => '', 'sunday_period_2_start' => '', 'sunday_period_2_stop' => ''}</code>
| Ausblenden der Texte vor den DropDowns.
|-
| <code>
attr rg_thermostate nameStyle{($READING eq "Soll" ||$READING eq "Tag" ||$READING eq "%getConfig" ||$READING eq "Ist" ||$READING eq "Nacht" ||$READING eq "Ventil" )?'style="text-align:right"' :($READING eq "%burstXmit" )?'style="text-align:center"' :'style=""'}
</code>
| Ausrichten der Überschriften die keine readings sind.
|-
| <code>attr rg_thermostate nonames 1</code>
| Ausblenden der Device Namen.
|-
| <code>attr rg_thermostate valueColumns { 'Heizung' => 'colspan="2"', 'Temperatur' => 'colspan="4"', 'Status' => 'colspan="2"', 'Werktag' => 'colspan="2"', 'Samstag' => 'colspan="2"', 'Sonntag' => 'colspan="2"', 'alias' => 'colspan="2"'}</code>
| Diverse Readings sollen über mehrere Spalten dargestellt werden.
|-
| <code>attr rg_thermostate valueFormat { 'measured-temp' => "%0.1f °C", 'ValvePosition' => "%0.1f %%"}</code>
| Formatierung für measured-temp und ValvePosition.
|-
| <code>attr rg_thermostate valueIcon { 'controlMode.auto' => 'sani_heating_automatic@green', 'controlMode.set_auto' => 'sani_heating_automatic@orange', 'controlMode.manual' => 'sani_heating_manual@red', 'controlMode.set_manual' => 'sani_heating_manual@orange', 'R-globalBtnLock.on' => 'secur_locked@green', 'R-globalBtnLock.on ' => 'secur_locked@green', 'R-globalBtnLock.set_on ' => 'secur_locked@orange', 'R-globalBtnLock.off' => 'secur_open@red', 'R-globalBtnLock.off ' => 'secur_open@red', 'R-globalBtnLock.set_off ' => 'secur_open@orange'}</code>
| Zuweisung der Icons.
|-
| <code>
attr rg_thermostate valueStyle{($READING eq "Heizung" ||$READING eq "Temperatur" ||$READING eq "Status" ||$READING eq "Wochenplan" ||$READING eq "Werktag" ||$READING eq "Samstag" ||$READING eq "Sonntag" )?'style="font-size:20px;;color:RoyalBlue;;text-align:center"' :($READING eq "alias" )?'style="font-size:11px;;font-weight:bold;;text-align:left"' :($READING eq "ValvePosition" &&$VALUE > 40 )?'style="font-weight:bold;;color:Orange;;text-align:left"' :($READING eq "desired-temp" ||$READING eq "measured-temp" )?'style="text-align:center"' :($READING eq "state" ||$READING eq "ValvePosition" )?'style="text-align:left"' :'style="text-align:right"'}
</code>
| Ausrichten und Einfärben der Readings.
|}

=== Heizungsteuerung für HM Wand- und Heizkörperthermostate ===

Dieses Beispiel wurde für HM-TC-IT-WM-W-EU / HM-CC-RT-DN Geräte erstellt. Verwendung anderer Thermostate wird ggf. Anpassungen erforderlich machen. Die Geräte werden nicht automatisch ermittelt, sondern sind einzeln angegeben.
Es werden Soll- und Ist-Temperaturen angezeigt, Luftfeuchte und Ventilpositionen, Modus, Batterie und Global-Tastenlock.
Steuerungsmöglichkeiten: Solltemperatur, Modus (Manual/Automatik), (globale) Tastenlock.
Die Abweichung der Isttemperatur, die Ventilpositionen, Batteriestand etc. werden farblich hervorgehoben.

Die Gerätenamen (EG_WZ_WT01_Climate / EG_WZ_WT01, EG_WZ_TT01_Clima / EG_WZ_TT01 / EG_WZ_TT02, OG_BZ_WT01_Climate / OG_BZ_WT01, OG_BZ_TT01_Clima / OG_BZ_TT01, OG_SZ_WT01_Climate / OG_SZ_WT01, OG_SZ_TT01_Clima / OG_SZ_TT01, OG_DZ_WT01_Climate / OG_DZ_WT01, OG_DZ_TT01_Clima / OG_DZ_TT01) müssen natürlich entsprechend angepasst werden.

Hinweis: Bei den Geräten muss das Attribut „expert“ auf "1_on" gesetzt werden, andernfalls fehlt das Reading „R-globalBtnLock“. Dies hätte zur Folge, dass in der Spalte Lock der batteryLevel dargestellt wird.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgHMTh.jpg|thumb|500px|links|Status, Steuerung und Wochenprofil]]
|-
| <code>define heatingInfo readingsGroup <%sani_heating>,<Soll>,<Soll neu>,<Ist>,<Ventil / RH>,<Modus>,<Lock>,<Bat><br>
EG_WZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@EG_WZ_WT01,batteryLevel@EG_WZ_WT01 \<br>
EG_WZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT01,batteryLevel@EG_WZ_TT01 \<br>
EG_WZ_TT02_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT02,batteryLevel@EG_WZ_TT02 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_BZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_BZ_WT01,batteryLevel@OG_BZ_WT01 \<br>
OG_BZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_BZ_TT01,batteryLevel@OG_BZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_SZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_SZ_WT01,batteryLevel@OG_SZ_WT01 \<br>
OG_SZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_SZ_TT01,batteryLevel@OG_SZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_DZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_DZ_WT01,batteryLevel@OG_DZ_WT01 \<br>
OG_DZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_DZ_TT01,batteryLevel@OG_DZ_TT01</code>
| ReadingsGoup anlegen.
|-
| <code>attr heatingInfo cellStyle { "r:1"=>'style="font-weight:bold;;font-size:16px"',<br>
"r:2,c:0"=>'style="font-weight:bold"',"r:6,c:0" =>'style="font-weight:bold"',<br>
"r:9,c:0"=>'style="font-weight:bold"',"r:12,c:0"=>'style="font-weight:bold"'}</code>
| Schrift fett setzen etc.
|-
| <code>attr heatingInfo commands {<br>
'heatingInfo.sollsetz'=>'desired-temp:5.0,12.0,18.0,19.0,20.0,20.5,21.0,21.5,22.0,22.5,23.0,23.5,24.0',<br>
"controlMode.manual"=>"set %DEVICE controlMode auto","controlMode.auto"=>"set %DEVICE controlMode manual",<br>
"R-globalBtnLock.on"=>"set %DEVICE regSet globalBtnLock off",<br>
"R-globalBtnLock.off"=>"set %DEVICE regSet globalBtnLock on"}</code>
| Heizungssteuerung ermöglichen
|-
| <code>
attr heatingInfo mapping {OG_BZ_WT01_Climate=>"Bad",<br>
OG_BZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_SZ_WT01_Climate=>"Schlafzimmer",<br>
OG_SZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_DZ_WT01_Climate=>"Duschbad",<br>
OG_DZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",EG_WZ_WT01_Climate=>"Wohnzimmer",<br>
EG_WZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler1",EG_WZ_TT02_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler2",'desired-temp' => ''}<br>
</code>
| Gewünschte Namen definieren.
|-
| <code>
attr heatingInfo valueFormat {if($READING eq "ValvePosition" && $VALUE ne "0"){$VALUE = int($VALUE/10)*10}<br>
elsif($READING eq "batteryLevel"){if($VALUE>=3){$VALUE=100}<br>
elsif($VALUE>=2.7){$VALUE=75}elsif($VALUE>=2.5){$VALUE=50}elsif($VALUE>=2.2){$VALUE=25}<br>
else{$VALUE=0}}}
</code>
| Werte vorformatieren (für die Icon-Zuordnung).
|-
| <code>
attr heatingInfo valueIcon {'controlMode.manual' => 'sani_heating_manual@795CFF',<br>
'controlMode.auto' => 'sani_heating_automatic@FFC13A', 'controlMode.boost' => 'sani_heating_boost@FB0C02',<br>
'humidity'=>'humidity@6FD9FB', 'R-globalBtnLock.on'=>'secur_locked@F7301D', <br>
'R-globalBtnLock.off'=>'secur_open@0CFB0C','ValvePosition.0' => 'sani_heating_level_0@002AE0',<br>
'ValvePosition.10' => 'sani_heating_level_10@F8D53D','ValvePosition.20' => 'sani_heating_level_20@FF9341',<br>
'ValvePosition.30' => 'sani_heating_level_30@F17F3F','ValvePosition.40' => 'sani_heating_level_40@E46C3C',<br>
'ValvePosition.50' => 'sani_heating_level_50@DE3B3A','ValvePosition.60' => 'sani_heating_level_60@A30D2D',<br>
'ValvePosition.70' => 'sani_heating_level_70@B40A23','ValvePosition.80' => 'sani_heating_level_80@C40619',<br>
'ValvePosition.90' => 'sani_heating_level_90@D4030F','ValvePosition.100' => 'sani_heating_level_100@E50005',<br>
'batteryLevel.100'=>'measure_battery_100@0CFB0C','batteryLevel.75'=>'measure_battery_75@42BC0A',<br>
'batteryLevel.50'=>'measure_battery_50@F5FF10','batteryLevel.25'=>'measure_battery_25@FB5909',<br>
'batteryLevel.0'=>'measure_battery_0@E50005','controlMode.set_boost' => 'hourglass',<br>
'controlMode.set_auto' => 'hourglass','controlMode.set_manual' => 'hourglass',<br>
'R-globalBtnLock.set_on' => 'hourglass','R-globalBtnLock.set_off' => 'hourglass'}
</code>
| Icons zuordnen.
|-
| <code>
attr heatingInfo valueStyle {if($READING eq "measured-temp")<br>
{my $t=$VALUE;;my $d=ReadingsVal($DEVICE,'desired-temp',0);;<br>
if($t-$d>=1){'style="color:rgb(251,63,11);;"'}elsif($t-$d<=-1){'style="color:rgb(79,58,251);;"'}<br>
else{'style="color:rgb(12,251,12);;"'}}}
</code>
| Farben (zu kalt: blau, zu warm: rot, ok: grün).
|-
| <code>
attr heatingInfo valueSuffix {"desired-temp"=>" °C", "measured-temp"=>" °C", <br>
"ValvePosition"=>" (".ReadingsVal($DEVICE,$READING,0)." %)", <br>
"humidity"=>" ".ReadingsVal($DEVICE,$READING,0)." % RH", <br>
"batteryLevel"=>" (".ReadingsVal($DEVICE,$READING,0)." V)"}
</code>
| Messeinheiten und Zahlenwerte.
|}

=== Readings aus zusätzlichen Devices ===
Im folgenden Beispiel wird gezeigt wie sich Readings zusätzlicher Devices zu einer Zeile mit mehreren Readings hinzufügen lassen. Diese zusätzlichen Devices können z.b. die unterschiedlichen Channel eines HomeMatic Gerätes sein. Im folgenden Beispiel wird der Name des zugehörigen Geräts dynamisch bestimmt.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung4.png|thumb|750px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define myTemp readingsGroup <Raum>,<Tist>,<Tsoll>,<Mode>,<Tnight>,<Tday>,<Hum>,<BatTC>,<Vist>,<Vsoll>,<Verr>,<BatVD> Thermostat.(WZ|OZ|AZ|Bad|Kueche|SZ|GZ|Bad.OG):measured-temp,desired-temp,controlMode,night-temp,day-temp,humidity,battery,ValvePosition@{valveOfDevice($DEVICE)},ValveDesired@{valveOfDevice($DEVICE)},R-valveErrorPos@{valveOfDevice($DEVICE)},battery@{valveOfDevice($DEVICE)} Broetje:ToutIst </code>
| Diverse Readings aller Thermostat Devices und des jeweils zugehörigen Ventilantriebs.
|-
| <code>attr myTemp mapping { 'Broetje' => 'Garten','Thermostat.AZ' => 'EG Arbeitszimmer','Thermostat.SZ' => 'OG Schlafzimmer','Thermostat.WZ'=>'EG Wohnzimmer','Thermostat.Kueche' => 'EG Küche','Thermostat.GZ' => 'OG Gästezimmer','Thermostat.Bad' => 'EG Bad','Thermostat.Bad.OG' => 'OG Bad','Thermostat.OZ' => 'EG Kaminzimmer','desired-temp' => <nowiki>''</nowiki> }</code>
| Die Benennung der Zeilentitel (Das ist je nach Konfiguration auch über $ALIAS und/oder $ROOM lösbar).
|-
| <code>attr myTemp commands { 'desired-temp' => 'desired-temp:' }</code>
| desired-temp soll per dropDown einstellbar sein.
|-
| <code>attr myTemp nameStyle style="color:yellow"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr myTemp valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriestand sollen jeweils Icons angezeigt werden.
|-
| <code>attr myTemp valueFormat { 'measured-temp' => "%0.1f &deg;C",'ToutIst' => "%.1f &deg;C",'night-temp' => "%.1f &deg;C",'day-temp' => "%.1f &deg;C",'humidity' => "%.0f
%%",'ValvePosition' => "%.0f %%",'ValveDesired' => "%.0f %%",'R-valveErrorPos' => "%.0f %%" }</code>
| Die Formatierung der Werte.
|-
|<source lang="perl">
#namen des ventil device aus thermostat device ableiten
sub valveOfDevice ($) {
my ($DEVICE) = @_;

if ($DEVICE =~ m/AZ/) {
return "Ventil.".substr($DEVICE,11).".Nord";
} else {
return "Ventil.".substr($DEVICE,11);
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hier wird aus dem Namen des Thermostaten der Name des zugehörigen Ventilantriebs abgeleitet.
|}
Da im {...} Teil des <reading>@<device> Arguments keine Leerzeichen oder Kommas vorkommen dürfen ist er in der Regel das Einfachste die Funktionalität wie in diesem Beispiel in eine eigene Routine auszulagern. Mit ein paar 'Tricks' lässt es sich aber manchmal auch ohne Leerzeichen oder Kommas lösen und dann direkt in die Definition schreiben:<code>...,ValvePosition@{$DEVICE=~s/Thermostat/Ventil/;$DEVICE;},...</code>

=== Inhalte filtern ===
Wenn man gewisse Zeilen einer Readingsgroup nicht dargestellt haben möchte, so kann man diese mit Hilfe von <code>valueFormat</code> ausfiltern, bspw.:

<code>attr rg valueFormat { return $VALUE if ( $VALUE > 0 );; return undef;; }</code>

In diesem Bsp. werden alle Zeilen/Devices, deren Value > 0 sind, angezeigt. Alle anderen werden als <code>undef</code> formatiert und erscheinen damit nicht im Listing.

Dies kann man noch weiter ausbauen und dynamische Auswahllisten erstellen (s. [[ReadingsGroup#Dynamische Inhalte]]).

=== Dynamische Inhalte ===
[[Datei:rgDynamic-1.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 1]]
[[Datei:rgDynamic-2.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 2]]
Es ist möglich, den in einer readingsGroup dargestellten Inhalt dynamisch von zusätzlichen Bedingungen abhängig zu machen. Im folgenden Beispiel lässt sich
einstellen, dass nur die Devices angezeigt werden, die einen bestimmten Zustand (hier: on/off, open/tilted/closed) haben. Hier wird zum Umschalten ein dummy, der direkt über der readingsGroup dargestellt wird, verwendet. Über das links und/oder commands lässt sich auch eine Darstellung erzeugen, bei der das Umschalten direkt innerhalb der readingsGroup möglich ist.

<pre>
define LXrg dummy
attr LXrg group -
attr LXrg setList mode1:on,off mode2:open,closed,tilted
attr LXrg stateFormat 1=mode1 2=mode2
attr LXrg webCmd mode1:mode2

define rg readingsGroup Window.*:state Light.*:state
attr rg group -
attr rg valueFormat { return $VALUE if ( $VALUE eq ReadingsVal("LXrg","mode1","") || $VALUE eq ReadingsVal("LXrg","mode2","") );; return undef;;}

define Watch_LX notify LX.*:.* {my $value = ReadingsVal($NAME,'state','');;;;fhem("setreading $NAME $value")}
</pre>

=== Enable/Disable Button am Beispiel eines WeekdayTimer ===
Dieses Beispiel zeigt die Anwendung einer readingsGroup, um im Frontend einen Enable/Disable Button für ein Objekt darzustellen. Für den [[WeekdayTimer]] gibt es hier spezielle Erweiterungen (set Routinen, um das Attribut ''disable'' zu setzen). Es gibt aber auch eine allgemeinere Variante (siehe [http://forum.fhem.de/index.php/topic,23655.msg169141.html#msg169141 diesen Forumsbeitrag]) für alle Objekte, die das Fhem Attribut ''disable'' unterstützen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_scheduling.png|thumb|500px|links|Enable/Disable Button]]
|-
| style="width:40%" |<code>define rg_Timer_Wasser readingsGroup timer_Wasser_..:disabled,+DEF,<{rg_timer_Wasser_show_conditional($DEVICE,"nextUpdate")}@disabled>,<{rg_timer_Wasser_show_conditional($DEVICE,"nextValue")}@disabled></code>
| Definition der angezeigten Readings. Das Attribut ''disabled'' wird mit weiteren Einstellungen (''commands'') zum Button, +DEF zeigt die Definition, d.h. die Schaltzeiten, des Timers an. Die Readings nextUpdate und nextValue sollen nur angezeigt werden, falls der Timer aktiv ist. Hierfür sorgt eine Routine <code>rg_timer_Wasser_show_conditional</code>, die in der 99_myUtils.pm definiert wird. Das abschließende @disabled sorgt dafür, dass der LongPoll Mechanismus die Anzeige sofort ändert, wenn der Button betätigt wird.
|-
| <code>attr rg_Timer_Wasser valueFormat { if ( $READING =~ m/.*DEF/ ) { my @text = split(" ", $VALUE); shift @text; return join(" ", @text) }}</code>
| Der Name des Timers wird aus dem Internal "+DEF" vorne abgeschnitten. Damit werden nur die definierten Schaltpunkte angezeigt.
|-
| <code>attr rg_Timer_Wasser valueIcon { 'disabled.0' => 'Restart', 'disabled.1' => 'Shutdown' }</code>
| Die beiden Zustände für den Button werden durch zwei Standard-Icons angezeigt.
|-
| <code>attr rg_Timer_Wasser commands { 'disabled.0' => 'set $DEVICE disable', 'disabled.1' => 'set $DEVICE enable' }</code>
| Toggle-Funktion für den Button. Wenn der Timer aktiv ("disabled.0") sorgt ein Klick auf den Button, dass der Timer deaktiviert wird ("set $DEVICE disable").
|-
|<source lang="perl">
sub rg_timer_Wasser_show_conditional($$)
{
my ($DEVICE,$READING) = @_;
return ( ReadingsVal($DEVICE, "disabled", "1") eq "0" )?
ReadingsVal($DEVICE, $READING, "reading_undef") : "disabled";
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit wird das übergebene Reading des Timers nur angezeigt, wenn der Timer aktiv ist. Andernfalls wird der String "disabled" angezeigt.
|}

=== Ändern von Attributen: Noch ein WeekdayTimer Beispiel ===
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Inzwischen ist es auch möglich das commands Mapping auf Attribute anzuwenden. Die Syntax ist die gleiche wie für die set Kommandos. Um das Beispiel übersichtlich zu halten werden hier die Werte und Icons auch für deaktiviert WeekdayTimer angezeigt.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_timer.png|thumb|500px|links|FhemWidget für das 'disable' Attribut]]
|-
| style="width:40%" |<code>define rgTimer readingsGroup <>,<Current>,<Update-Time>,<New>,<disable> TYPE=WeekdayTimer:state,nextUpdate,nextValue,?!disable</code>
| Definition der angezeigten Readings. Das Attribut ''disable'' wird mit weiteren Einstellungen (''commands'') zum Button. Durch das ! wird das Attribut auch dann angezeigt wenn es noch nicht gesetzt ist.
|-
| <code>attr rgTimer valueIcon { state => '%devStateIcon', nextValue => '{(split(":",Color::devStateIcon($DEVICE,"dimmer",undef,"nextValue")))[1]}' }</code>
| Für den aktuellen Zustand wird das devStateIcon angezeigt und für den nächsten Zustand das passende Lampen-Icon.
|-
| <code>attr rgTimer valueFormat '{(split(" ", $VALUE))[1]}'</code>
| Vom nächsten Schaltpunkt wird nur die Zeit angezeigt.
|-
| <code>attr rgTimer commands { disable => 'disable:' }</code>
| Für das disable attribut wird das normale dropDown mit 0 und 1 angezeigt das auch in der Device Detail Ansicht verwendet wird.
|}

=== Readings löschen ===
Es kann vorkommen, dass Readings angezeigt werden, die garnicht existieren sollten - bspw. wenn man in einer HTTPMOD ein Reading umbeannt hat, kann auch der alte Readingsname immernoch angezeigt werden. Solche Readings können mit der globalen Funktion [http://fhem.de/commandref.html#deletereading deletereading] gelöscht werden.

'''Achtung:''' Auf jeden Fall die [http://fhem.de/commandref.html#deletereading CommandRef dazu] lesen!

Beispiel:
Im HTTPMOD des [[Pollenflug]] war zuerst das <code>reading04Name Graeser</code> definiert und wurde später in <code>reading04Name Gräser</code> umbenannt. In der zugehörigen ReadingGroup wurden dann konsequent beide Varianten dargestellt - auch nachdem alle Alt-Einträge aus den Logs entfernt wurden. Erst ein <code>deletereading Pollenflug Graeser</code> in der fhem-Befehltszeile hat das veraltete Reading entfernt.

=== Ausrichtung der Tabelle drehen (horizontal/vertikal) ===
Eine Readingsgroup wird standardmäßig immer zeilenweise aufgebaut, zB. jedes Gerät in eine neue Zeile. Die Werte der Geräte werden dann in den Spalten dargestellt.
Wenn man eine Readingsgroup für nur ein Gerät mit vielen Readings hat (zB. [[Allergy]]), so kann man die Darstellung horizontal oder vertikal ausrichten, indem man die Readingsgroup detailliert definiert. Ein Bsp. dazu liefert der Foreneintrag [https://forum.fhem.de/index.php/topic,37194.msg440446.html#msg440446] :

<pre>
define Pollenflugvorhersage allergy <PLZ>
attr Pollenflugvorhersage levelsFormat rc_dot@white,rc_dot@yellow,rc_dot@orange,rc_dot@red
attr Pollenflugvorhersage stateFormat fc1_maximum
attr Pollenflugvorhersage updateEmpty 1
attr Pollenflugvorhersage updateIgnored 1

# Pollen in Spalten, Tage in Zeilen
define PollenAlarmHorizontal readingsGroup <>,<Ampfer>,<Ambrosia>,<Beifuß>,<Birke>,<Buche>,<Eiche>,<Erle>,<Gräser>,<Hasel>,<Pappel>,<Roggen>,<Ulme>,<Wegerich>,<Weide> \
Pollenflugvorhersage:fc1_day_of_week,fc1_Ampfer,fc1_Ambrosia,fc1_Beifuß,fc1_Birke,fc1_Buche,fc1_Eiche,fc1_Erle,fc1_Gräser,fc1_Hasel,fc1_Pappel,fc1_Roggen,fc1_Ulme,fc1_Wegerich,fc1_Weide \
Pollenflugvorhersage:fc2_day_of_week,fc2_Ampfer,fc2_Ambrosia,fc2_Beifuß,fc2_Birke,fc2_Buche,fc2_Eiche,fc2_Erle,fc2_Gräser,fc2_Hasel,fc2_Pappel,fc2_Roggen,fc2_Ulme,fc2_Wegerich,fc2_Weide \
Pollenflugvorhersage:fc3_day_of_week,fc3_Ampfer,fc3_Ambrosia,fc3_Beifuß,fc3_Birke,fc3_Buche,fc3_Eiche,fc3_Erle,fc3_Gräser,fc3_Hasel,fc3_Pappel,fc3_Roggen,fc3_Ulme,fc3_Wegerich,fc3_Weide \
Pollenflugvorhersage:fc4_day_of_week,fc4_Ampfer,fc4_Ambrosia,fc4_Beifuß,fc4_Birke,fc4_Buche,fc4_Eiche,fc4_Erle,fc4_Gräser,fc4_Hasel,fc4_Pappel,fc4_Roggen,fc4_Ulme,fc4_Wegerich,fc4_Weide \
Pollenflugvorhersage:fc5_day_of_week,fc5_Ampfer,fc5_Ambrosia,fc5_Beifuß,fc5_Birke,fc5_Buche,fc5_Eiche,fc5_Erle,fc5_Gräser,fc5_Hasel,fc5_Pappel,fc5_Roggen,fc5_Ulme,fc5_Wegerich,fc5_Weide \
Pollenflugvorhersage:fc6_day_of_week,fc6_Ampfer,fc6_Ambrosia,fc6_Beifuß,fc6_Birke,fc6_Buche,fc6_Eiche,fc6_Erle,fc6_Gräser,fc6_Hasel,fc6_Pappel,fc6_Roggen,fc6_Ulme,fc6_Wegerich,fc6_Weide \
Pollenflugvorhersage:fc7_day_of_week,fc7_Ampfer,fc7_Ambrosia,fc7_Beifuß,fc7_Birke,fc7_Buche,fc7_Eiche,fc7_Erle,fc7_Gräser,fc7_Hasel,fc7_Pappel,fc7_Roggen,fc7_Ulme,fc7_Wegerich,fc7_Weide
attr PollenAlarm nonames 1
attr PollenAlarm valueFormat %VALUE
attr PollenAlarm valueIcon %VALUE

# Tage in Spalten, Pollen in Zeilen
define PollenAlarmVertikal readingsGroup Pollenflugvorhersage:<Pollen>,fc0_day_of_week,fc1_day_of_week,fc2_day_of_week,fc3_day_of_week,fc4_day_of_week,fc5_day_of_week,fc6_day_of_week,fc7_day_of_week \
Pollenflugvorhersage:<Ambrosia>,fc0_Ambrosia,fc1_Ambrosia,fc2_Ambrosia,fc3_Ambrosia,fc4_Ambrosia,fc5_Ambrosia,fc6_Ambrosia,fc7_Ambrosia\
Pollenflugvorhersage:<Ampfer>,fc0_Ampfer,fc1_Ampfer,fc2_Ampfer,fc3_Ampfer,fc4_Ampfer,fc5_Ampfer,fc6_Ampfer,fc7_Ampfer\
Pollenflugvorhersage:<Beifuß>,fc0_Beifuss,fc1_Beifuss,fc2_Beifuss,fc3_Beifuss,fc4_Beifuss,fc5_Beifuss,fc6_Beifuss,fc7_Beifuss\
Pollenflugvorhersage:<<b>Birke<Birke</b>>,fc0_Birke,fc1_Birke,fc2_Birke,fc3_Birke,fc4_Birke,fc5_Birke,fc6_Birke,fc7_Birke\
Pollenflugvorhersage:<Buche>,fc0_Buche,fc1_Buche,fc2_Buche,fc3_Buche,fc4_Buche,fc5_Buche,fc6_Buche,fc7_Buche\
Pollenflugvorhersage:<Eiche>,fc0_Eiche,fc1_Eiche,fc2_Eiche,fc3_Eiche,fc4_Eiche,fc5_Eiche,fc6_Eiche,fc7_Eiche\
Pollenflugvorhersage:<<b>Erle<Erle</b>>,fc0_Erle,fc1_Erle,fc2_Erle,fc3_Erle,fc4_Erle,fc5_Erle,fc6_Erle,fc7_Erle\
Pollenflugvorhersage:<Gräser>,fc0_Graeser,fc1_Graeser,fc2_Graeser,fc3_Graeser,fc4_Graeser,fc5_Graeser,fc6_Graeser,fc7_Graeser\
Pollenflugvorhersage:<<b>Hasel<Hasel</b>>,fc0_Hasel,fc1_Hasel,fc2_Hasel,fc3_Hasel,fc4_Hasel,fc5_Hasel,fc6_Hasel,fc7_Hasel\
Pollenflugvorhersage:<Pappel>,fc0_Pappel,fc1_Pappel,fc2_Pappel,fc3_Pappel,fc4_Pappel,fc5_Pappel,fc6_Pappel,fc7_Pappel\
Pollenflugvorhersage:<Roggen>,fc0_Roggen,fc1_Roggen,fc2_Roggen,fc3_Roggen,fc4_Roggen,fc5_Roggen,fc6_Roggen,fc7_Roggen\
Pollenflugvorhersage:<Ulme>,fc0_Ulme,fc1_Ulme,fc2_Ulme,fc3_Ulme,fc4_Ulme,fc5_Ulme,fc6_Ulme,fc7_Ulme\
Pollenflugvorhersage:<Wegerich>,fc0_Wegerich,fc1_Wegerich,fc2_Ulme,fc3_Wegerich,fc4_Wegerich,fc5_Wegerich,fc6_Wegerich,fc7_Wegerich\
Pollenflugvorhersage:<Weide>,fc0_Weide,fc1_Weide,fc2_Weide,fc3_Weide,fc4_Weide,fc5_Weide,fc6_Weide,fc7_Weide
</pre>

== Berechnungen ==
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Das Rechnen funktioniert über das Flag "$", mit dem eine Funktion angegeben werden kann, die auf beliebige Kombinationen von Zeilen, Spalten und einzelnen Zellen angewendet wird. Ähnlich wie in einer Tabellenkalkulation.

Ein Beispiel:
:<code>define rg readingsGroup .*:temperature rg:$avg</code>
Damit wird eine readingsGroup über alle ''temperature'' Readings definiert. In einer zusätzlichen Zeile am Ende wird mit ''$avg'' der Durchschnittswert aller darüber liegenden Temperaturen angezeigt.

Das genaue Format: <code>$<operator>[(<zellen>)]</code> mit
*<code><operator></code>: sum, avg, min, max, scalar, count oder der Name einer beliebigen anderen Funktion, die ein Array mit allen Werten übergeben bekommt und ein Ergebnis zurückliefert.
*<code><zellen></code> ist eine durch Semikolon getrennte Liste aus <code><zeilen>:<spalten></code> Paaren.
*<code><zeilen></code> und <code><spalten></code> sind jeweils eine Perl Liste, d.h. hier können
** einzelne Werte,
** durch Komma getrennte Aufzählungen,
** mit .. angegebene Wertebereiche
** sowie <code>$ROW</code> und <code>$COLUMN</code> als Bezeichner für die aktuelle Zelle
:verwendet werden.

Alle Möglichkeiten sind kombinierbar. Die Zählung der Zeilen und Spalten beginnt bei 1. Eine nicht vorhandene Zeilenangabe wird durch den Bereich von Zeile 1 bis zur aktuellen Zeile ersetzt, eine nicht vorhandene Spalte durch die aktuelle Spalte.

Es ergeben sich somit unter anderem folgende Möglichkeiten:
*<code>$sum</code> equivalent zu <code>$sum(1..$ROW), $sum(:$COLUMN)</code> und <code>$sum(1..$ROW:$COLUMN)</code> die Summe der Werte in der Spalte über der aktuellen Zelle.
*<code>$max($ROW:1..$COLUMN-1)</code> Maximum aller Werte links von der aktuellen Zelle (in der aktuellen Zeile)
*<code>$avg(1..$ROW:1)</code> Durchschnitt aller Werte in Spalte 1 bis zur aktuellen Zeile
*<code>$scalar(:1)</code> Anzahl der Werte in Spalte 1
*<code>$min(1..5:1,2,4)</code> Minimum der Werte aus den Zeilen 1-5 in den Spalten 1, 2 und 4

Eigene Funktionen lassen sich über 99_myUtils anlegen und z.B. verwenden um Häufigkeiten zu zählen oder mit nichtnumerischen Readings umzugehen.

Die Ergebnisse werden im Weiteren wie normale Readings behandelt. Sie lassen sich von links oben nach rechts unten kaskadieren und lassen sich über valuePrefix, valueSuffix, valueFormat und valueStyle in der Darstellung beeinflussen. Also z.B. einfärben, als Balkendiagramm darstellen, ...

Mit Hilfe der Funktionalität zum auf- und zu-klappen von Teilen einer readingsGroup lassen sich z.B. im zusammengeklappten Zustand Summen, Extremwerte oder andere Ausreißer anzeigen und die Details nur beim Aufklappen zeigen.

Weitere Möglichkeiten:
* Attribut <code>firstCalcRow</code>: Hiermit kann der Default für die Nummer der ersten Zeile vorgegeben werden (sofern im Ausdruck nichts genaueres angegeben ist). firstCalcRow sollte z.B. auf 2 gesetzt werden, wenn in der readingsGroup Spaltenüberschriften verwendet werden.
* special <code><nowiki><hr></nowiki></code> um eine horizontale Linie über die volle Breite einzufügen
* Über ein angehängtes <code>@<alias></code> kann einem Rechenergebniss ein Alias-Name gegeben werden. Über diesen kann der Wert dann zur Formatierung mit den value-Attributen angesprochen werden.
* das <code>alwaysTrigger</code> Attribut kann jetzt auch den Wert 2 bekommen. Damit werden in der readingsGroup Readings für alle durch die Aggregation gebildeten Werte und entsprechende Events auch dann erzeugt wenn die readingsGroup nicht angezeigt wird. Wenn ein Alias-Name vergeben ist, wird dieser auch für den Reading-Namen verwendet.
* Über den operator <code>$count(<wert>)(<zellen>)</code> um das Vorkommen von <code><wert></code> in den angegebenen Zellen zu zählen. <code><wert></code> kann enweder direkt der zu zählende Wert sein (ohne Anführungzeichen) oder eine in / eingeschlossene regex. Mit <code>!<wert></code> kann das Nicht-Vorkommen von <code><wert></code> gezählt werden.

=== Ein interaktives Beispiel ===
[[Datei:rgCalc.png|mini|right|400px|Beispiel-readingsGroup mit Berechnungen]]
In drei [[dummy]] Objekten lässt sich jeweils ein Reading über einen Slider einstellen. In der darunter liegenden readingsGroup werden diese Readings und diverse daraus abgeleitete Werte dargestellt. Alle Readings und die daraus abgeleiteten Werte werden live per longpoll aktualisiert, wenn die slider bewegt werden.
<br clear=all>
<pre>
define t1 dummy
attr t1 room rg
attr t1 setList state:slider,-10,1,30
attr t1 webCmd state
define t2 dummy
attr t2 room rg
attr t2 setList state:slider,-10,1,30
attr t2 webCmd state
define t3 dummy
attr t3 room rg
attr t3 setList state:slider,-10,1,30
attr t3 webCmd state

define rg readingsGroup <>,<value>,<sum>,<min>,<max>,<avg>\
t\d:+NAME,state,$sum(1..$ROW:2),$min(1..$ROW:2),$max(1..$ROW:2),$avg(1..$ROW:2)\
<hr>\
rg:<>,$scalar,$sum(:2)@SUM,$min(:2)@MIN,$max(:2)@MAX,$avg(:2)@AVG\
<hr>\
t1:<t1,t2,t3>,state,state@t2,state@t3,$sum($ROW:2..4)@SUM,$count(/\d/)(2..$ROW-4:2)\

attr rg nonames 1
attr rg room rg
attr rg style style='text-align:center'
attr rg valueFormat { 'avg' => '%.2f', 'AVG' => '%.2f' }
attr rg valuePrefix { 'rg.scalar' => '#', 'rg.SUM' =>'Σ; ', 'rg.MIN' =>'Min: ', 'rg.MAX' =>'Max: ', 'rg.AVG' =>'∅; ', 'rg.count' => '#(X): ' }
attr rg valueSuffix { state => '°;C' }
</pre>

== Links und Trigger ==
=== readingsGroup mit Link ===
[[Datei:rgPCA-detail.png|mini|400px|readingsGroup mit Link]]
Das PCA301 Beispiel oben lässt sich mit einem ans Ende des define angehängten
:<code><{appendTrigger($DEVICE,"clear","Alle löschen")}></code>
und der folgenden appendTrigger Definition in 99_myUtils.pm um einen Link erweitern, der ein Event auslöst, an das z.B. ein notify gehängt werden kann, um die Verbrauchszähler der PCA301 Dosen zurückzusetzen.
:<code>define clearVerbrauch notify Verbrauch:clear set TYPE=PCA301 clear</code>

<source lang="perl">
use vars qw($FW_ME);
use vars qw($FW_subdir);
sub
appendTrigger($$$)
{
my ($name,$trigger,$label) = @_;

my $ret .= "</table></td></tr>";

my $link = "cmd=trigger $name $trigger";
my $txt = "<a onClick=\"FW_cmd('$FW_ME$FW_subdir?XHR=1&$link')\">$label</a>";
$ret .= "<td colspan=\"99\"><div style=\"cursor:pointer;color:#888888;text-align:right\">$txt</div></td>";

return ($ret,0);
}</source>

wenn hierdurch Änderungen an einer readingsGroup erfolgen, die ein Neuladen der Seite erforderlich machen, kann dies so erfolgen:
:<code>{myUtils_refresh("WEB")}</code>
mit folgendem code in 99_myUtils.pm:
<source lang="perl">
sub
myUtils_refresh($)
{
my ($name) = @_;

FW_directNotify("#FHEMWEB:$name", "location.reload(true);","" );
}</source>

Ein weiteres Beispiel für 'custom links und trigger' findet sich in {{Link2Forum|Topic=14425|Message=109383|LinkText=diesem Forenbeitrag}}: dort wird damit eine readingsGroup dynamisch umgeschaltet, um nur die eingeschalteten, nur die ausgeschalteten oder alle Lampen anzuzeigen.

=== sub rg ===
Damit beim klicken auf ein Icon oder einen Text in einer readingsGroup etwas passiert ist es möglich dies über das commands Attribut auf ein <code>'trigger ntfy_rg $DEVICE $READING'</code> oder Ähnliches zu mappen.
Anlegen des ntfy_rg notify
<pre>
define ntfy_rg notify ntfy_rg {rg($EVENT)}
</pre>
Folgender Code muss noch in de [[99_myUtils_anlegen|99_myUtils.pm]]
<source lang="perl">
sub rg($){
my @input = split(/[§\s]+/,shift);
my $device = $input[0];
my $function = $input[1];

if($function eq "clima"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;

return(("d_climaControl_".$room));
}
elsif($function eq "device"){
return InternalVal($device,"device","device error");
}
elsif($function eq "controlMode"){
my $controlMode = ReadingsVal($device,"controlMode","controlMode error");

if($controlMode ~~ /manual/)
{fhem("set $device controlMode auto")}
elsif($controlMode ~~ /auto/)
{fhem("set $device controlMode manual")};
}
elsif($function eq "globalBtnLock"){
my $globalBtnLock = ReadingsVal($device,"R-globalBtnLock","globalBtnLock error");

if($globalBtnLock ~~ /off/){
{fhem("set $device regSet globalBtnLock on")}
{fhem ("set $device getConfig")}
}
elsif($globalBtnLock ~~ /on/){
{fhem("set $device regSet globalBtnLock off")}
{fhem ("set $device getConfig")}
};
}
elsif($function eq "state"){
my $state = Value($device);

if($state ~~ /off/){
{fhem("set $device on")}
}
elsif($state ~~ /on/){
{fhem("set $device off")}
};
}
elsif($function eq "setTimeTable"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;
my $climaControl = ("d_climaControl_".$room);
my $dayTemp = ReadingsVal( $climaControl, "dayTemp" , 21.0 );
my $nightTemp = ReadingsVal( $climaControl, "nightTemp" , 17.0 );
my $workday_period_1_start = ReadingsVal( $climaControl, "workday_period_1_start" , "06:30" );
my $workday_period_1_stop = ReadingsVal( $climaControl, "workday_period_1_stop" , "18:00" );
my $workday_period_2_start = ReadingsVal( $climaControl, "workday_period_2_start" , "24:00" );
my $workday_period_2_stop = ReadingsVal( $climaControl, "workday_period_2_stop" , "24:00" );
my $saturday_period_1_start = ReadingsVal( $climaControl, "saturday_period_1_start" , "06:30" );
my $saturday_period_1_stop = ReadingsVal( $climaControl, "saturday_period_1_stop" , "12:00" );
my $saturday_period_2_start = ReadingsVal( $climaControl, "saturday_period_2_start" , "24:00" );
my $saturday_period_2_stop = ReadingsVal( $climaControl, "saturday_period_2_stop" , "24:00" );
my $sunday_period_1_start = ReadingsVal( $climaControl, "sunday_period_1_start" , "24:00" );
my $sunday_period_1_stop = ReadingsVal( $climaControl, "sunday_period_1_stop" , "24:00" );
my $sunday_period_2_start = ReadingsVal( $climaControl, "sunday_period_2_start" , "24:00" );
my $sunday_period_2_stop = ReadingsVal( $climaControl, "sunday_period_2_stop" , "24:00" );

{fhem("set $device tempListMon prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListTue prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListWed prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListThu prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListFri prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSat prep $saturday_period_1_start $nightTemp $saturday_period_1_stop $dayTemp $saturday_period_2_start $nightTemp $saturday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSun exec $sunday_period_1_start $nightTemp $sunday_period_1_stop $dayTemp $sunday_period_2_start $nightTemp $sunday_period_2_stop $dayTemp 24:00 $nightTemp")};
}
}
</source>
Hier sind die benötigten CodeBlöcke für [[ReadingsGroup#Heizungswerte.2C_Status.2C_Steuerung_und_Wochenprofil|Heizungswerte, Status, Steuerung und Wochenprofil]] enthalten, aber auch um state zu triggern.

== Sonstiges ==
In der Regel werden die Parameter zu einem reading in den mappings unter <$DEVICE> und dann <$DEVICE>.<$READING> und dann unter <$READING>.<$VALUE> gesucht.

=== Lesbar machen ===
Für die meisten Attribute gilt:

* Wenn es komplexer wird ist es einfacher, den Code in eine eigene Routine in (beispielsweise) [[99 myUtils anlegen|99_myUtils]] auszulagern und diese aufzurufen:
:<code> attr <name> valueStyle {myValueToFormat($READING,$VALUE)}</code>
* code für unterschiedliche readings kann auch im mapping schon aufgeteilt werden:
:<code>attr <name> valueStyle { SuperE5 => '{perl code}', Diesel => '{perl code}' }</code>
* Ifs lassen sich verschachteln und sortieren. So kann die Anzahl der Klammern und Else-Zweige reduziert werden:
if( $READING eq ... ) {
return xxx if( $VALUE < 1 );
return yyy if( $VALUE < 1.5 );
return zzz;
} elsif( $READING eq ... ) {
...
}

Da alles lässt sich natürlich auch kombinieren und so viel lesbarer machen als ein einziger langer Bandwurm.

=== readingsGroup in einer Gruppe ===
Wenn der doppelte Rahmen um eine readingsGroup bei Darstellung in einer Gruppe stört, lässt er sich mit dem passenden style entfernen:
:<code>attr <rgName> style style="border:0px;background:none;box-shadow:none"</code>
Für die readingsGroup ''rgName'' wird der Darstellungsstil verändert.

Anwendungs-Bsp: [[Pollenflug]]

=== Einfache Balkendiagramme ===
[[Datei:rgBars.png|mini|400px|readingsGroup mit Balken]]
Readings lassen sich mit einem valueStyle der folgenden Art mit einem "Füllstandsbalken" hinterlegen:
:<code>attr <rgName> valueStyle style="width:200px; text-align:center; border: 1px solid #ccc; background:-webkit-linear-gradient(left, red $VALUE%, rgba(0,0,0,0) $VALUE%)"</code>

Die Balken werden bei Änderungen der Readings automatisch per longpoll aktualisiert.

Diese direkte Definition des <code>valueStyle</code> ist allerdings sehr unflexibel - bspw. müsste der <code>$VALUE</code> zufällig max 100 erreichen und es darf nur ein Browsertyp eingesetzt werden, damit alles sauber funktioniert.

Deutlich flexibler ist eine Auslagerung als eigenständige Funktion in die [[99_myUtils_anlegen|99_myUtils.pm]], die den valueStyle dynamisch generiert, bspw.:

<source lang="perl">
sub Balkenanzeige($)
{
# Zuweisung der übergebenen Variablen
my ($val) = @_;

# Konfiguration des maximal übergebenen Werts (hier wäre der höchste zu erwartende Wert = 3)
my $maxValue = 3;

# Normalisierung auf 100%-Wert
my $percent = $val / $maxValue * 100;

# Definition des valueStyles
my $stylestring = 'style="
width: 200px;
text-align:center;
border: 1px solid #ccc;
background-image: -webkit-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -moz-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -ms-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -o-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
"';

# Rückgabe des definierten Strings
return $stylestring;
}
</source>

Der Aufruf sähe dann wie folgt aus:

<code> attr <rgName> valueStyle { Balkenanzeige($VALUE) } </code>

Die einzelnen Werte des <code>$stylestring</code> haben folgende Bedeutungen:
* width - Breite des Balkenrahmens
* text-align - Ausrichtung des Texts
* border - Format des Balkenrahmens
* background-image - Format des Hintergrunds des Balkenrahmens, also des Balkens selbst
** linear-gradient - css-Funktion zur Erstellung von Farbverläufen ''(*)''
*** left - linksbündiger Balken
*** red x% - roter Balken x% breit
*** rgba(0,0,0,0) x% - farbloser Teil startet bei x%

''(*) linear-gradient wird in verschiedenen Browsern unterschiedlich umgesetzt. Deshalb sollten immer alle Varianten zusammen angegeben werden, damit die Darstellung auf allen Browsern funktioniert. (vgl. Link unten)''

Weitere Infos zu:
* linear-gradient - [https://developer.mozilla.org/de/docs/Web/CSS/linear-gradient]
* Farbanpassungen, z.B. auch unter Verwendung der [[Color#Skalenfarbe_mit_Color::pahColor|Color::pahColor]] Routine.
* Anpassung von Werten s.o. [[ReadingsGroup#Lesbar_machen]]
* weiteren Möglichkeiten zur Erzeugung von Balkendiagrammen in Forenbeiträgen {{Link2Forum|Topic=25313|LinkText=hier}} und {{Link2Forum|Topic=28318|LinkText=hier}}
* [[99_myUtils_anlegen|99_myUtils.pm]]

Anwendungs-Bsp: [[Pollenflug]]

=== readingsGroup Styling mit CSS ===
Jede readingsGroup lässt sich durch CSS individuell stylen.

==== Allgemeines ====
Damit der eigene CSS Code nach einem [[Update]] der FHEM-Style Dateien vorhanden bleibt, ist es notwenig eine eigene .css Datei (zB ios7ReadingsGroups.css) zu erstellen und ins Verzeichnis ''fhem/www/pgm2/'' zu kopieren. Anschließend muss in der [[FHEMWEB]] Instanz das Attribut ''CssFiles'' auf zB ''pgm2/ios7ReadingsGroups.css'' gesetzt werden.

==== Erweiterte Device Übersicht ====
Diese ReadingsGroup ist an der [[FHEMWEB]] Device-Übersicht angelehnt. Zusätzlich werden weitere Readings, hier Leistung, Betriebszeit Heute und Jahr, ein Link zu Detail-Seite der ReadingsGroup und Links zu den jeweiligen Device-Detail-Seite, dargestellt.

{| class="wikitable"
| [[Datei:RgStylingOhneCss.png|600px|mini|left|Device ReadingsGroup ohne CSS]] [[Datei:RgStylingMitCss.png|600px|mini|left|Device ReadingsGroup mit CSS]]
|}

===== Definition =====
<pre>
define rg_devices readingsGroup <{rgLink($DEVICE,"konfigurieren","Details")}>,<Device>,<Status>,<Leistung>,<Heute>,<Jahr>\
wzDeckenfluter:<%light_floor_lamp>,<{rgLink("wzDeckenfluter","detail","Deckenfluter")}>,state,<>,dauerHeute,dauerJahr\
wzMacMini:<%it_nas>,<{rgLink("wzMacMini","detail","MacMini")}>,state,power,consumption,consumptionYear\
attr rg_devices noheading 1
attr rg_devices nonames 1
attr rg_devices notime 1
attr rg_devices room ReadingsGroup Styling
attr rg_devices style class="block wide rgDevices"
attr rg_devices valueFormat { 'power' => "%.1f W ", consumption => "%.2f kWh", 'consumptionYear' => "%.2f kWh" }
attr rg_devices valueIcon { state => '%devStateIcon' }
</pre>

Damit sich der CSS auf die richtige readingsGroup bezieht, ist es nötigt
das Attribut ''style'' anzupassen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| style="width:40%" |<code>attr <rgName> style class="block wide rgDevices"</code>
| Die Klassen ''block'' und ''wide'' müssen eingetragen werden. Der Name der Nachfolgenden Klasse, hier ''rgDevices'', ist frei wählbar.
|}
===== Funktion rgLink() =====
Die Funktion rgLink($name,$action,$label) liefert einen Link mit dem Namen $label zurück. Der Code gehört in die [[99 myUtils anlegen|99_myUtils.pm]].
* $name - Name des Device das aufgerufen werden soll
* $action - Aktion die Ausgeführt werden soll.
**''konfigurieren'' erzeugt den kleinen ''Details'' Button links oben der einem zur Detail Seite der ReadingsGroup führt - nützlich wenn das ReadingsGroup-Attribut ''noheading'' gesetzt ist
** ''detail'' erzeugt einen Link zu Device-Detail Seite
* $label - Link-Name
<source lang="perl">
sub rgLink($$$){
my ($name,$action,$label) = @_;
my $link = "";
my $fhemLink = "";
my $txt = "";
my $ret = "";
my $divStyle = "";
my $aStyle = "";

# FHEM Variablen einbinden
use vars qw($FW_ME);
use vars qw($FW_subdir);
use vars qw($FW_ss);
use vars qw($FW_tp);

if( $action eq "konfigurieren" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;font-size:11px;padding-bottom:2px;padding-left:3px;";
}
elsif( $action eq "detail" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;display:inline;";
}

$link = '<a onclick="location.href=\'' . $FW_ME . $FW_subdir . '?' . $fhemLink . '\'" style="' . $aStyle . '">' . $label . '</a>';
$txt = '<div style="' . $divStyle . '">' . $link . '</div>';
$ret = "$txt";

return $ret;
}
</source>

{{Randnotiz|RNText=Tipp
Verwende zum Bearbeiten der eigenen .css Dateien entweder den [[Konfiguration#Syntaxhervorhebung|Codemirror Editor]] oder einen eigenen Editor mit [http://de.wikipedia.org/wiki/Syntaxhervorhebung Syntax Highlighting] . Das hilft bei der Fehlersuche enorm. }}

===== Styling =====
Die eigene .css Datei erscheint in FHEM unter Edit-Files --> styles und kann direkt im FHEM-Editor oder mit eigenen Editor bearbeitet werden.

ios7ReadingsGroups.css:
<pre>
/* Readings Groups Devices */
table.rgDevices tr td{ text-align: center; }
table.rgDevices tr:first-child td:nth-child(2){ /* 1. Zeile 2. Spalte */ text-align: center; }
table.rgDevices tr td:first-child{ /* 1. Spalte */ width: 45px; text-align: center; }
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 33%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
</pre>

==== Auf Portrait / Landscape Modus des Smartphone unterscheiden ====
Dieses Beispiel ist an das obige Beispiel [[#Erweiterte_Device_.C3.9Cbersicht|Erweiterte Device Übersicht]] angelehnt.

{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortrait.png|300px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscape.png|550px|mini|center|Device ReadingsGroup im Landscape Modus]]
|}

===== Allgemeines =====
Mit CSS ist man in der Lage auf die aktuelle Bildschirmlage zu reagieren. Alle Anweisungen die in diesen beiden Funktionen zwischen den beiden { } stehen, werden je nach Bildschirmlage aufgerufen
<pre>
/* Portrait Modus */
@media all and (orientation:portrait) { }

/* Landscape Modus */
@media all and (orientation:landscape) { }
</pre>

===== Styling =====
{{Randnotiz|RNText=Info
* ''width: xx%'' ändert die Breite der Spalte
* ''display: none'' blendet die Spalte aus}}
In der FHEMWEB_phone Instanz muss wie [[#Allgemeines|hier]] beschrieben eine neue eigene .css Datei eingetragen werden. In diesem Beispiel ios7smallscreenReadingsGroups.css

ios7smallscreenReadingsGroups.css
<pre>
/* landscape und portrait modus */
table.rgDevices tr td { /* Zuerst alles centern */ text-align: center; }
table.rgDevices tr:first-child td:nth-child(1){ /* 1. Zeile 1. Spalte */ text-align: center; }
table.rgDevices tr td:first-child { /* 1. Spalte */ width: 5%; }
table.rgDevices tr:first-child td:nth-child(2) { /* 1. Zeile 2. Spalte */ text-align: center; }
table.block table tr td table.rgDevices tr td { border-bottom: 1px solid #cbcbcb; }

/* Portrait Modus */
@media all and (orientation:portrait) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 50%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: auto; text-align: right; display: table-cell; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(6){ width: 0; display: none; }
table.rgDevices tr td div a svg{ margin-left: 90px; }
}

/* Landscape Modus */
@media all and (orientation:landscape) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 35%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
}
</pre>

==== Plots im Portrait Modus des Smartphones ausblenden ====
{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortraitPlot.png|350px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscapePlot.PNG|550px|mini|center|Plot nur im Landscape]]
|}

Um die Plot und alle Steuerelemente im Portrait Modus auszublenden fügt man in seine eigene smallscreen.css wie [[#Allgemeines|hier beschrieben]] folgendes ein:
<pre>
@media all and (orientation:portrait) {
.SVGplot, .SVGlabel, .Zoom-in, .Zoom-out, .Prev { width: 0; display: none; }
}
</pre>

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]

ReadingsGroup

2016-11-13T20:33:26Z

LHBL2003: /* Heizungswerte, Status, Steuerung und Wochenprofil */

{{SEITENTITEL:readingsGroup}}
{{Infobox Modul
|ModPurpose=Einfache zusammenfassende Darstellung von Informationen über mehrere Geräte und deren Steuerung
|ModType=h
|ModCmdRef=readingsGroup
|ModForumArea=Frontends
|ModTechName=33_readingsGroup.pm
|ModOwner=Andre ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])}}

Das Fhem-[[:Kategorie:Hilfsmodul|Hilfsmodul]] [[readingsGroup]] bietet eine einfache Möglichkeit, ''Readings'' (kein Präfix vor dem Reading-Namen), ''Internals'' (Präfix "+" vor dem Namen des internen Wertes) und ''Attributes'' (Präfix "?" vor dem Namen des Attributs) von einem oder mehreren ''Devices'' darzustellen und flexibel zu formatieren.

Die Aktualisierung im Browserfenster geschieht per longpoll und überträgt nur die jeweils geänderten Zellen. Wenn eine readingsGroup in keinem Browserfenster angezeigt wird findet keine longpoll aktualisierung statt.

== Definition ==
Siehe [http://fhem.de/commandref.html#readingsGroup commandref].

== Attribute ==
{{Randnotiz|RNText=In allen Mappings die einen Hash verwenden muss der Key (das was jeweils links von => Operator steht) in Anführungszeichen stehen. Die einzige Ausnahme hiervon sind Keys die aus einem String bestehen der mit einem Buchstaben beginnt und nur Buchstaben und Zahlen enthält.}}
Weitergehende Erläuterungen zu einzelnen Attributen.

Die komplette Liste der Attribute ist der commandref zu entnehmen.

=== noheading ===
[[Datei:ReadingsGroup_noheading.png|mini|rechts|400px|ReadingsGroup: rechts mit "noheading" Attribut, links der anklickbare Titel]]
Das Attribut <code>noheading</code> führt dazu, dass der Alias der ReadingsGroup nicht mehr als Titel angezeigt wird. Das kann wünschenswert sein, wenn die ReadingsGroup auf einer [[Dashboard]]-Seite angezeigt werden soll, hat allerdings den Nachteil, dass die Detail-Ansicht der ReadingsGroup nicht mehr über einen Klick auf den Titel aufgerufen werden kann. Der Einstellungsdialog der ReadingsGroup ist dann nur noch (z. B.) über
* <code>list TYPE=readingsGroup</code>
* einen "Probably associated with"-Link eines anderen Objekts oder über
* manuelle Modifikation der URL eines anderen Objekts (<code>http:.../fhem?detail=<objektname></code>)
erreichbar.

=== nolinks ===
Devicenamen und Titel der readingsGroup verlinken nicht mehr zur zugehörigen Detailansicht und sind nicht mehr anklickbar.

=== nostate ===
Das state-Reading wird bei regex match nicht berücksichtigt und nicht angezeigt.

=== notime ===
Es werden keine Timestamps für die Readings angezeigt. Nur für einspaltige readingsGroups sinnvoll.

== Beispiele ==
Bitte beachten: die folgenden Beispiele enthalten keine Maskierungen oder Verdoppelungen für ; und Zeilenende, sondern sind so angegeben, wie sie im [[PGM2|Web Interface]] im Befehls-Eingabefeld, nach Klick auf DEF und im Attribut-Eingabefeld eingegeben werden. Beim manuellen Einfügen in eine [[Konfiguration|Konfigurationsdatei]] sind diese Maskierungen oder Verdoppelungen natürlich vorzunehmen.

=== Einfache Auswahl über Reading-Namen ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define battStatus readingsGroup .*:[Bb]attery</code>
| Alle readings mit Namen '''Battery''' oder '''battery''' von allen Devices.
| rowspan=3 | [[Datei:rgBattery.png|thumb]]
|-
| <code>attr battStatus alias FHT Batteriestatus </code>
| Der Alias wird als Zeilentitel verwendet
|-
| <code>attr battStatus mapping %ROOM </code>
| ''Mapping %ROOM'' führt dazu, dass der Raumname als Zeilentitel angezeigt wird.
|}

=== Übersicht HomeMatic Geräte ===

<nowiki>define HM_Components readingsGroup <Gerät>,<Name>,<Model>,<S/N> TYPE=CUL_HM:+NAME,?model,D-serialNr</nowiki>

=== Auswahl über Reading-Namen, Status als Symbol dargestellt ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg_battery readingsGroup .*:battery</code>
| Alle readings mit Namen '''battery''' von allen Devices.
| rowspan=4 | [[Datei:rgBattery2.png|thumb]]
|-
| <code>attr rg_battery alias Batteriestatus </code>
| Der Alias wird als Überschrift verwendet
|-
| <code>attr rg_battery valueIcon {'battery.ok' => 'batterie', 'battery.low' => 'batterie@red'}</code>
| Statt der reading Werte "ok" und "low" soll ein Icon angezeigt werden.
|-
|<code>attr rg_battery commands { "battery.low" => "set %DEVICE replaceBatteryForSec 60" }</code>
| Für LaCrosse devices kann man beim Klick auf ein rotes "battery low icon" direkt replaceBatteryForSec setzen.
|}

=== Reading-Werte zuordnen (Icon / Text) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define rg readingsGroup Contact.Dachboden_gross:sensed.*</code>
| Alle sensedreadings des Contact.Dachboden_gross device.
| rowspan=4 | [[Datei:rgFenster.png|thumb]]
|-
| <code>attr rg mapping { 'sensed.A' => 'links', 'sensed.B' => 'rechts' }</code>
| Die Zuordnung rechts/links
|-
| <code>attr rg valueFormat {($VALUE eq '1')?"fts_window_roof":"fts_window_roof_open_2"}</code>
| Die Zuordnung von reading Wert zu Icon Namen.
|-
| <code>attr rg_battery valueIcon %VALUE </code>
| Statt des reading Werts soll ein Icon angezeigt werden.
|}

=== Formatvorgabe für Ausgabewerte ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define TempHygro readingsGroup TYPE=CUL_WS:temperature,humidity,dewpoint</code>
| Alle readings mit Namen '''temperature''', '''humidity''', '''dewpoint''' von allen Devices des Typs '''CUL_WS'''
| rowspan=4 | [[Datei:rgTemperatur.png|thumb|[[S300TH]]-Werte in einer readingsGroup]]
|-
| <code>attr TempHygro alias Temperatur / rel. Feuchte / Taupunkt</code>
| Der Alias der readingsGroup wird als Überschrift verwendet
|-
| <code>attr TempHygro mapping %ALIAS</code>
| ''Mapping %ALIAS'' führt dazu, dass der Alias des Geräts als Zeilentitel angezeigt wird.
|-
| <code>attr TempHygro valueFormat { temperature => "%.1f&deg;C", humidity => "%.1f %%", dewpoint => "%.1f&deg;C"}</code>
| Formatierung der Ausgabewerte. '''Achtung:''' "%" die in der Ausgabe erscheinen sollen, müssen verdoppelt werden!
|}

=== Ausgabestil (hier rechtsbündig) ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Wetter readingsGroup WetterXXX:<%temp_temperature>,<Temperatur>,temperature WetterXXX:<%weather_humidity>,<Luftfeuchte>,humidity WetterXXX:<%weather_barometric_pressure>,<Luftdruck>,pressure
</code>
| Die readings mit Namen '''temperature''', '''humidity''' und '''pressure''' vom Device WetterXXX jeweils mit einem Icon und einem Label davor.
| rowspan=3 | [[Datei:rgWetter.png|thumb]]
|-
| <code>attr Wetter valueFormat { temperature => '%1.f &deg;C', humidity => '%1.f %%', pressure => '%i mbar' }</code>
| Die Formatierung der Readingswerte
|-
| <code>attr Wetter valueStyle style="text-align:right"</code>
| Die Readings sollen rechtsbündig dargestellt werden.
|}

=== Internal Value ausgeben ===
Diese Beispiel könnte entfallen (nächstes Beispiel ist sehr ähnlich; es wird lediglich ein weiterer Wert ausgegeben).
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI</code>
| Den RSSI Wert aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.
| rowspan=1 | [[Datei:rgculRSSI.png|thumb]]
|}

=== Internal Values ausgeben ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define culRSSI readingsGroup cul_RSSI=.*:+cul_RSSI,+cul_TIME</code>
| Den RSSI Wert mit der zugehörigen Zeit aller Devices (am IODev ''cul'') die einen solchen haben anzeigen.<br> '''Achtung''': "internal values" werden nicht per longpoll aktualisiert, sondern nur beim Seitenaufbau.<br>"Internal Values" werden durch das vorangestellte '''+''' (Pluszeichen) identifiziert.
| rowspan=2 | [[Datei:rgculRSSI2.png|thumb]]
|-
|attr culRSSI valueStyle {return undef if($READING =~ m/TIME/); ($VALUE <= -85)?'style="color:red"':($VALUE <= -80)?'style="color:yellow"':undef}
|Schlechte RSSI Werte sollen abhängig von zwei Schwellwerten gelb oder rot eingefärbt werden (auf dem Screenshot nicht zu sehen).
|}

=== Alle Readings eines Gerätes, mit Ausnahme von... ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Systemstatus readingsGroup sysstat</code>
| Alle readings des sysstat Device
| rowspan=4 | [[Datei:rgSysstat.png|thumb]]
|-
| <code>attr Systemstatus nostate 1</code>
| Ohne state
|-
| <code>attr Systemstatus notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Systemstatus mapping {'load' => 'Systemauslastung', 'temperature' => 'Systemtemperatur in &deg;C'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|}

=== Anzeige auf einem Floorplan ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define Heizung readingsGroup t(1|2|3):temperature</code>
| Die Temperatur readings der Devices t1, t2 und t3
| rowspan=6 | [[Datei:rgHeizung.png|thumb|220px]]
|-
| <code>attr Heizung mapping {'t1.temperature' => 'Vorlauf', 't2.temperature' => 'R&ücklauf', 't3.temperature' => 'Zirkulation'}</code>
| Die Zuordnung der reading Namen zu den Zeilentiteln
|-
| <code>attr Heizung nameStyle style="text-align:left"</code>
| Zeilentitel linksbündig wegen floorplan
|-
| <code>attr Heizung style style="font-size:20px;color:lightgray"</code>
| Großer Font und Farbe passend für den floorplan
|-
| <code>attr Heizung notime 1</code>
| Ohne readings timestamp
|-
| <code>attr Heizung valueFormat : %.1f &deg;C</code>
| Doppelpunkt zwischen Zeilentitel und Wert, eine Nachkommastelle plus Einheit
|}

=== LightScene DropDown-Menü für smallscreen Styles oder Floorplan ===

{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>define lcDropDown readingsGroup meineLightScene:!state</code>
| Für die LightScene ''meineLightScene'' soll ein DropDown-Menü zur Auswahl der Szene erstellt werden.
| rowspan=6 |
|-
| <code>attr lcDropDown commands { state => 'scene:' }</code>
| Die Anzeige des state Readings wird auf das DropDown-Menü für das scene Kommando gemapped.
|-
| <code>attr lcDropDown nonames 1</code>
| Keine Readingnamen
|-
| <code>attr lcDropDown notime 1</code>
| Kein Timestamp
|}

=== Schriftgrößen, Farben, Icons ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgVerbrauchPCA301.png|links|mini|400px|Schriftgröße, Farbe, Icons...]]
|-
| style="width:40%" |<code>define Verbrauch readingsGroup TYPE=PCA301:state,power,consumption</code>
| Die readings state, power und consumption aller [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] Devices mit einer Zeile pro Device.
|-
| <code>attr Verbrauch mapping %ROOM %ALIAS</code>
| Der Raumname und der Alias werden als Zeilentitel verwendet
|-
| <code>attr Verbrauch nameStyle style="font-weight:bold"</code>
| Der Zeilentitel soll fett sein
|-
| <code>attr Verbrauch style style="font-size:20px"</code>
| Alles in einem größeren Font
|-
| <code>attr Verbrauch valueFormat {power => "%.1f W", consumption => "%.2f kWh"}</code>
| Die Formatierung für die power und consumption readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr Verbrauch valueIcon { state => '%devStateIcon' }</code>
| Für die Dosen, die schaltbar sind, soll das anklickbare device icon gezeigt werden.
|-
|<code>attr Verbrauch valueStyle {($READING eq "power" && $VALUE > 40)?'style="color:red"':'style="color:green"'}</code>
|Wenn das power reading >40 ist, soll es in rot angezeigt werden, alle anderen Werte und readings in grün
|}

=== Wertabhängige Farbgebung ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:TemperaturenRG.png|600px|mini|links|Wertabhängige Farben]]
[[Datei:TemperaturenRG2.png|600px|mini|links|Andere Werte - andere Farben]]
|-
| style="width:40%" |<code>define wzTemperaturenRG readingsGroup Aussen:,<Temperatur>,temperature,<Luftfeuchte>,humidity Wohnzimmer:,<Temperatur>,temperature,<Luftfeuchte>,humidity Kasten_E_Geraete:,<Temperatur>,temperature,<Luftfeuchte>,humidity</code>
| Die readings temperatur und humidity der Devices Aussen, Wohnzimmer und Kasten_E_Geraete in einer Zeile pro Device.
|-
| <code>attr wzTemperaturenRG group 3. Temperaturen</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzTemperaturenRG noheading 1</code>
| noheading
|-
| <code>attr wzTemperaturenRG nostate 1</code>
| nostate
|-
| <code>attr wzTemperaturenRG notime 1</code>
| notime
|-
| <code>attr wzTemperaturenRG valueFormat {temperature => "%.1f °C", humidity =>"%.1f %%" }</code>
| Die Formatierung für die temperatur und humidity readings: eine Nachkommastelle plus Einheit.
|-
|<code>attr wzTemperaturenRG valueStyle { if($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE > 20) { 'style="color:orange"'}elsif($DEVICE eq "Aussen" && $READING eq "temperature" && $VALUE < 5) { 'style="color:blue"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 23) { 'style="color:red"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE > 21) { 'style="color:orange"'}elsif($DEVICE eq "Wohnzimmer" && $READING eq "temperature" && $VALUE < 20) { 'style="color:blue"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 30) { 'style="color:red"'}elsif($DEVICE eq "Kasten_E_Geraete" && $READING eq "temperature" && $VALUE > 28) { 'style="color:orange"'}elsif($READING eq "humidity" && $VALUE > 65) { 'style="color:red"'}elsif($READING eq "humidity" && $VALUE > 60) { 'style="color:orange"'}else{'style="color:green"'} }</code>
| Diverse Farbkombinationen sind möglich
|}

=== Enigma Receiver ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:ReceiverRG.jpg|600px|mini|links|Wertabhängige Farben]]
[[Datei:ReceiverRGmute.jpg|600px|mini|links|Wertabhängige Farben]]
|-
| style="width:40%" |<code>define wzReceiverRG readingsGroup wzReceiver:,<Aktuell>,eventtitle,<Rest>,eventremaining_hr,<Dauer>,eventduration_hr wzReceiver:<Beschreibung>,eventdescription wzReceiver:,<Nächste>,eventtitle_next,<Start>,eventstart_next_hr,<Dauer>,eventduration_next_hr wzReceiver:,<HDD Kapazität>,hdd1_capacity,<Frei>,wzReceiver:hdd1_free wzReceiver:,<Lautstärke>,volume,<HDD>,hdd1_capacity,<Frei>,hdd1_free</code>
| Mehrere readings des Device wzReceiver in mehreren Zeilen. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke, mute angezeigt. Farbige Anzeige des freien Speicherplatzes
'''Benötigt:''' ENIGMA2 Receiver, 70_ENIGMA2.pm - Siehe: [[Enigma2 Receiver (Dreambox, VUplus etc.) steuern]]
|-
| <code>attr wzReceiverRG group Fernseher Receiver</code>
| Die readingsGroup kommt in eine Gruppe
|-
| <code>attr wzReceiverRG mapping &nbsp;</code>
| mapping wird auf &nbsp; (Leerzeichen) gesetzt, damit der Device Name nicht angezeigt wird
|-
| <code>attr wzReceiverRG noheading 1</code>
| noheading
|-
| <code>attr wzReceiverRG nostate 1</code>
| nostate
|-
| <code>attr wzReceiverRG notime 1</code>
| notime
|-
|-
| <code>attr wzReceiverRG valueColumns { eventdescription => 'colspan="4"' }</code>
| Die Beschreibung soll über 4 Spalten gehen
|-
| <code>attr wzReceiverRG valueFormat { wzReceiverRGvalueFormat($DEVICE,$READING,$VALUE);; }</code>
| Die Formatierung wird in die 99_myUtils.pm ausgelagert. Siehe: [[99 myUtils anlegen]]
|-
|<code>attr wzReceiverRG valueStyle { if($READING eq "hdd1_free" && $VALUE < 200){ 'style="color:red"' }elsif( $READING eq "hdd1_free" && $VALUE < 500 ){ 'style="color:orange"' }elsif( $READING eq "volume" && ReadingsVal($DEVICE, "mute", "") eq "on" ){ 'style="color:red"' }else{ 'style="color:green"' } }</code>
| Diverse Farbkombinationen sind möglich. Wenn der Receiver auf mute ist, wird anstatt der Lautstärke <span style="color: red;">mute</span> angezeigt.
|-
|<source lang="perl">
sub
wzReceiverRGvalueFormat($$$)
{
my ($DEVICE,$READING,$VALUE) = @_;

if($READING eq 'hdd1_capacity') {
return "%.2f MB";
} elsif( $READING eq 'hdd1_free') {
return "%.2f MB";
} elsif( $READING eq 'volume' ) {
if( ReadingsVal($DEVICE, "mute", "") eq "on") {
return "mute";
} else {
return "%i %%";
}
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]
|}

=== Heizungswerte inklusive Batterie- und Fensterstatus ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung3.png|thumb|links|500px|Heizungswerte inklusive Batterie- und Fensterstatus]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<%18>,<%20>,<%22>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte commands { 'Heizungswerte.18' => 'set $DEVICE desired-temp 18', 'Heizungswerte.20' => 'set $DEVICE desired-temp 20', 'Heizungswerte.22' => 'set $DEVICE desired-temp 22' }</code>
| Die Links/Kommandos die hinter den 18, 20 und 22 liegen sollen.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte inklusive Ventilposition ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:Rg_Heizung_Valveposition.png|thumb|links|500px|Heizungswerte inklusive Statusinformationen (MAX!)]]
|-
| style="width:40%" |<code>define Heizungswerte readingsGroup <%sani_heating>,<Ventil>,<Soll>,<Ist>,<MaxV>,<GID>,<Mode>,<Batterie> TYPE=CUL_HM:ValvePosition,desired-temp,measured-temp,R-valveMaxPos,groupid,mode,battery</code>
| Diverse readings aller Devices des Typs <b>MAX</b>.
|-
| <code>attr Heizungswerte mapping %ROOM</code>
| Die Raumnamen werden angezeigt.
|-
| <code>attr Heizungswerte nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb (fett) sein.
|-
| <code>attr Heizungswerte room Heizung</code>
| Die "readingsgroup" wird dem Raum "Heizung" zugeordnet.
|-
| <code>attr Heizungswerte valueFormat {'temperature' => "%.0f °C", 'desiredTemperature' => "%.0f °C", 'valveposition' =>"%.0f %%", 'maxValveSetting' =>"%.0f %%" }</code>
| Es wird noch die Einheit °C hinter den Temperaturwerten angezeigt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriezustand werden Icons anstatt Klartextwerte genommen!
|-
| <code>attr Heizungswerte valueStyle { if($READING eq "temperature" && $VALUE > 20){ 'style="color:green;;font-weight:bold"' }elsif( $READING eq "temperature" && $VALUE <= 20 ){ 'style="color:blue"' }elsif( $READING eq "temperature" && $VALUE > 23 ){ 'style="color:red"' }else{ 'style="color:gray"' } }</code>
| Die Temperaturwerte werden abhängig vom Wert farbig dargestellt.
|-
| <code>attr Heizungswerte valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|}

=== Heizungswerte, Status und Regelmöglichkeit ===
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung2.png|thumb|500px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define Heizungswerte2 readingsGroup <%sani_heating>,< >,<Act>,<Soll>,<Ist> TYPE=FHT:actuator,desired-temp,measured-temp,<{myUtils_HeizungUpDown($DEVICE,"up")}@desired-temp>,desired-new,<{myUtils_HeizungUpDown($DEVICE,"down")}@desired-temp>,window,battery</code>
| Diverse readings aller Devices des Typs <b>FHT</b>.
|-
| <code>attr Heizungswerte2 nameStyle style="color:yellow;font-weight:bold"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr Heizungswerte2 valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red', 'window.closed' => 'fts_window_1w@lightgreen', 'window.open' => 'fts_window_1w_open@red'}</code>
| Für den Batteriestand und den Zustand der Fenster sollen jeweils Icons angezeigt werden.
|-
| <code>attr Heizungswerte2 valueStyle {($VALUE eq "00")?'style="visibility:hidden"':''}</code>
| Nach dem Einstellen den Wert wieder ausblenden.
|-
| <source lang="perl">
#Heizung regeln in readingsGroup
sub
myUtils_HeizungUpDown($$)
{
my($DEVICE,$CMD) = @_;

my $icon = $CMD;
my $VALUE = ReadingsVal($DEVICE,"desired-new","20" );
$VALUE = ReadingsVal($DEVICE,"desired-temp","20" )
if( !$VALUE || $VALUE == 0 );
my $link;

if( $CMD eq "up" ) {
$icon = "control_arrow_upward";
$VALUE += 1;

if( $VALUE <= 24 ) {
$icon .= "\@red";
$link = "setreading $DEVICE desired-new $VALUE";
}
} elsif( $CMD eq "down" ) {
$icon = "control_arrow_downward";
$VALUE -= 1;

if( $VALUE >= 18 ) {
$icon .= "\@blue";
$link = "setreading $DEVICE desired-new $VALUE";
}
}

my $notify = "notifyHeizungUpDown";
if( !defined($defs{$notify}) ) {
CommandDefine(undef,
"$notify notify .*:desired-new.* "
."{ myUtils_HeizungUpDownNotify(\$NAME,\$EVTPART1); }" );
}

my $ret = "%$icon";
$ret .= "%$link" if( $link );

return $ret;
}

sub
myUtils_HeizungUpDownNotify($$)
{
my($DEVICE,$VALUE) = @_;

return if( $VALUE == 0 );

my $at = "triggerHeizungUpDown_$DEVICE";
CommandDelete(undef, $at) if( defined($defs{$at}) );
CommandDefine(undef,
"$at at +00:00:03 "
."{my \$v = ReadingsVal(\"$DEVICE\",\"desired-new\",undef);"
."fhem(\"set $DEVICE desired-temp \$v\") if( \$v );"
."fhem(\"setreading $DEVICE desired-new 00\");}" );

return undef;
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit werden die Icons zum Ändern der gewünschten Temperatur dargestellt und im Bereich >=18 und <= 24 Grad anklickbar gemacht. Zwischen den Pfeilen wird der gerade eingestellte Wert angezeigt. Wenn dieser drei Sekunden nicht mehr geändert wurde wird die desired-temp auf diesen Wert gesetzt und die Anzeige zwischen den Pfeilen ausgeblendet.
|}

=== Heizungswerte, Status, Steuerung und Wochenprofil ===
Dieses Beispiel funktioniert nur mit HomeMatic HM-CC-RT-DN, für andere Thermostate müssen an diversen Stellen Änderungen vorgenommen werden.
{{Todo|Überarbeiten: umstellen auf readingList oder setreading, label als readings in die readingsGroup selber stecken statt in einen extra dummy. oder !<reading> und mapping verwenden.}}
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgThermostate.png|thumb|750px|links|Status, Steuerung und Wochenprofil]]
|-
| style="width:40%" |<pre>set d_label Heizung Heizung
setreading d_label Temperatur Temperatur
setreading d_label Status Status
setreading d_label Wochenplan Wochenplan
setreading d_label Werktag Werktag
setreading d_label Samstag Samstag
setreading d_label Sonntag Sonntag
setreading d_label Zeitraum1 Zeitraum 1
setreading d_label Zeitraum2 Zeitraum 2 </pre>
|Erzeugen der Readings im Device [[dummy#d_label|d_label]].
|-
| <code>
define rg_thermostate readingsGroup <>,Heizung@d_label,<|>,Temperatur@d_label,<|>,Status@d_label,<|>,Wochenplan@d_label,<|>,Werktag@d_label,<|>,Samstag@d_label,<|>,Sonntag@d_label,<|>,<> CUL_HM_HM_CC_RT_DN_......_Clima:<>,?alias,<|>,<Soll>,desired-temp,<Tag>,dayTemp@{rg($DEVICE."§clima")},impossible@{$DEVICE},<|>,controlMode,R-globalBtnLock@{rg($DEVICE."§device")},<|>,Zeitraum1@d_label,<|>,workday_period_1_start@{rg($DEVICE."§clima")},workday_period_1_stop@{rg($DEVICE."§clima")},<|>,saturday_period_1_start@{rg($DEVICE."§clima")},saturday_period_1_stop@{rg($DEVICE."§clima")},<|>,sunday_period_1_start@{rg($DEVICE."§clima")},sunday_period_1_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},<%system_fhem_update>,<nowiki><br></nowiki>,state@{rg($DEVICE."§device")},<%getConfig>,<|>,<Ist>,measured-temp,<Nacht>,nightTemp@{rg($DEVICE."§clima")},<|>,<Ventil>,ValvePosition,<|>,Zeitraum2@d_label,<|>,workday_period_2_start@{rg($DEVICE."§clima")},workday_period_2_stop@{rg($DEVICE."§clima")},<|>,saturday_period_2_start@{rg($DEVICE."§clima")},saturday_period_2_stop@{rg($DEVICE."§clima")},<|>,sunday_period_2_start@{rg($DEVICE."§clima")},sunday_period_2_stop@{rg($DEVICE."§clima")},<|>,impossible@{$DEVICE},impossible@{rg($DEVICE."§device")},<%burstXmit> </code>
| Diverse readings aller Devices <b>CUL_HM_HM_CC_RT_DN_......_Clima</b>, entsprechender [[Makefine#d_climaControl|d_climaControl]] (müssen vorher angelegt werden) und [[dummy#d_label|d_label]].
|-
| <code>attr rg_thermostate commands { 'desired-temp' => 'desired-temp:', 'dayTemp' => 'dayTemp:', 'controlMode' => 'trigger ntfy_rg $DEVICE controlMode', 'R-globalBtnLock' => 'trigger ntfy_rg $DEVICE globalBtnLock', 'workday_period_1_start' => 'workday_period_1_start:', 'workday_period_1_stop' => 'workday_period_1_stop:', 'saturday_period_1_start' => 'saturday_period_1_start:', 'saturday_period_1_stop' => 'saturday_period_1_stop:', 'sunday_period_1_start' => 'sunday_period_1_start:', 'sunday_period_1_stop' => 'sunday_period_1_stop:', 'rg_thermostate.system_fhem_update' => 'trigger ntfy_rg $DEVICE setTimeTable', 'rg_thermostate.getConfig' => 'set $DEVICE getConfig', 'nightTemp' => 'nightTemp:', 'workday_period_2_start' => 'workday_period_2_start:', 'workday_period_2_stop' => 'workday_period_2_stop:', 'saturday_period_2_start' => 'saturday_period_2_start:', 'saturday_period_2_stop' => 'saturday_period_2_stop:', 'sunday_period_2_start' => 'sunday_period_2_start:', 'sunday_period_2_stop' => 'sunday_period_2_stop:', 'rg_thermostate.burstXmit' => 'set $DEVICE burstXmit'}</code>
| Temperaturen werden als DropDown Auswahl dargestellt, Icons triggern [[readingsGroup#sub_rg|ntfy_rg]]
|-
| <code>attr rg_thermostate mapping { 'desired-temp' => '', 'dayTemp' => '', 'workday_period_1_start' => '', 'workday_period_1_stop' => '', 'saturday_period_1_start' => '', 'saturday_period_1_stop' => '', 'sunday_period_1_start' => '', 'sunday_period_1_stop' => '', 'nightTemp' => '', 'workday_period_2_start' => '', 'workday_period_2_stop' => '', 'saturday_period_2_start' => '', 'saturday_period_2_stop' => '', 'sunday_period_2_start' => '', 'sunday_period_2_stop' => ''}</code>
| Ausblenden der Texte vor den DropDowns.
|-
| <code>
attr rg_thermostate nameStyle{($READING eq "Soll" ||$READING eq "Tag" ||$READING eq "%getConfig" ||$READING eq "Ist" ||$READING eq "Nacht" ||$READING eq "Ventil" )?'style="text-align:right"' :($READING eq "%burstXmit" )?'style="text-align:center"' :'style=""'}
</code>
| Ausrichten der Überschriften die keine readings sind.
|-
| <code>attr rg_thermostate nonames 1</code>
| Ausblenden der Device Namen.
|-
| <code>attr rg_thermostate valueColumns { 'Heizung' => 'colspan="2"', 'Temperatur' => 'colspan="4"', 'Status' => 'colspan="2"', 'Werktag' => 'colspan="2"', 'Samstag' => 'colspan="2"', 'Sonntag' => 'colspan="2"', 'alias' => 'colspan="2"'}</code>
| Diverse Readings sollen über mehrere Spalten dargestellt werden.
|-
| <code>attr rg_thermostate valueFormat { 'measured-temp' => "%0.1f °C", 'ValvePosition' => "%0.1f %%"}</code>
| Formatierung für measured-temp und ValvePosition.
|-
| <code>attr rg_thermostate valueIcon { 'controlMode.auto' => 'sani_heating_automatic@green', 'controlMode.set_auto' => 'sani_heating_automatic@orange', 'controlMode.manual' => 'sani_heating_manual@red', 'controlMode.set_manual' => 'sani_heating_manual@orange', 'R-globalBtnLock.on' => 'secur_locked@green', 'R-globalBtnLock.on ' => 'secur_locked@green', 'R-globalBtnLock.set_on ' => 'secur_locked@orange', 'R-globalBtnLock.off' => 'secur_open@red', 'R-globalBtnLock.off ' => 'secur_open@red', 'R-globalBtnLock.set_off ' => 'secur_open@orange'}</code>
| Zuweisung der Icons.
|-
| <code>
attr rg_thermostate valueStyle{($READING eq "Heizung" ||$READING eq "Temperatur" ||$READING eq "Status" ||$READING eq "Wochenplan" ||$READING eq "Werktag" ||$READING eq "Samstag" ||$READING eq "Sonntag" )?'style="font-size:20px;;color:RoyalBlue;;text-align:center"' :($READING eq "alias" )?'style="font-size:11px;;font-weight:bold;;text-align:left"' :($READING eq "ValvePosition" &&$VALUE > 40 )?'style="font-weight:bold;;color:Orange;;text-align:left"' :($READING eq "desired-temp" ||$READING eq "measured-temp" )?'style="text-align:center"' :($READING eq "state" ||$READING eq "ValvePosition" )?'style="text-align:left"' :'style="text-align:right"'}
</code>
| Ausrichten und Einfärben der Readings.
|}

=== Heizungsteuerung für HM Wand- und Heizkörperthermostate ===

Dieses Beispiel wurde für HM-TC-IT-WM-W-EU / HM-CC-RT-DN Geräte erstellt. Verwendung anderer Thermostate wird ggf. Anpassungen erforderlich machen. Die Geräte werden nicht automatisch ermittelt, sondern sind einzeln angegeben.
Es werden Soll- und Ist-Temperaturen angezeigt, Luftfeuchte und Ventilpositionen, Modus, Batterie und Global-Tastenlock.
Steuerungsmöglichkeiten: Solltemperatur, Modus (Manual/Automatik), (globale) Tastenlock.
Die Abweichung der Isttemperatur, die Ventilpositionen, Batteriestand etc. werden farblich hervorgehoben.

Die Gerätenamen (EG_WZ_WT01_Climate / EG_WZ_WT01, EG_WZ_TT01_Clima / EG_WZ_TT01 / EG_WZ_TT02, OG_BZ_WT01_Climate / OG_BZ_WT01, OG_BZ_TT01_Clima / OG_BZ_TT01, OG_SZ_WT01_Climate / OG_SZ_WT01, OG_SZ_TT01_Clima / OG_SZ_TT01, OG_DZ_WT01_Climate / OG_DZ_WT01, OG_DZ_TT01_Clima / OG_DZ_TT01) müssen natürlich entsprechend angepasst werden.

Hinweis: Bei den Geräten muss das Attribut „expert“ auf "1_on" gesetzt werden, andernfalls fehlt das Reading „R-globalBtnLock“. Dies hätte zur Folge, dass in der Spalte Lock der batteryLevel dargestellt wird.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:RgHMTh.jpg|thumb|500px|links|Status, Steuerung und Wochenprofil]]
|-
| <code>define heatingInfo readingsGroup <%sani_heating>,<Soll>,<Soll neu>,<Ist>,<Ventil / RH>,<Modus>,<Lock>,<Bat><br>
EG_WZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@EG_WZ_WT01,batteryLevel@EG_WZ_WT01 \<br>
EG_WZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT01,batteryLevel@EG_WZ_TT01 \<br>
EG_WZ_TT02_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@EG_WZ_TT02,batteryLevel@EG_WZ_TT02 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_BZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_BZ_WT01,batteryLevel@OG_BZ_WT01 \<br>
OG_BZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_BZ_TT01,batteryLevel@OG_BZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_SZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_SZ_WT01,batteryLevel@OG_SZ_WT01 \<br>
OG_SZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_SZ_TT01,batteryLevel@OG_SZ_TT01 \<br>
<>,<>,<>,<>,<>,<>,<>,<> \<br>
OG_DZ_WT01_Climate:desired-temp,<sollsetz>,measured-temp,humidity,controlMode,R-globalBtnLock@OG_DZ_WT01,batteryLevel@OG_DZ_WT01 \<br>
OG_DZ_TT01_Clima:desired-temp,<>,measured-temp,ValvePosition,controlMode,R-globalBtnLock@OG_DZ_TT01,batteryLevel@OG_DZ_TT01</code>
| ReadingsGoup anlegen.
|-
| <code>attr heatingInfo cellStyle { "r:1"=>'style="font-weight:bold;;font-size:16px"',<br>
"r:2,c:0"=>'style="font-weight:bold"',"r:6,c:0" =>'style="font-weight:bold"',<br>
"r:9,c:0"=>'style="font-weight:bold"',"r:12,c:0"=>'style="font-weight:bold"'}</code>
| Schrift fett setzen etc.
|-
| <code>attr heatingInfo commands {<br>
'heatingInfo.sollsetz'=>'desired-temp:5.0,12.0,18.0,19.0,20.0,20.5,21.0,21.5,22.0,22.5,23.0,23.5,24.0',<br>
"controlMode.manual"=>"set %DEVICE controlMode auto","controlMode.auto"=>"set %DEVICE controlMode manual",<br>
"R-globalBtnLock.on"=>"set %DEVICE regSet globalBtnLock off",<br>
"R-globalBtnLock.off"=>"set %DEVICE regSet globalBtnLock on"}</code>
| Heizungssteuerung ermöglichen
|-
| <code>
attr heatingInfo mapping {OG_BZ_WT01_Climate=>"Bad",<br>
OG_BZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_SZ_WT01_Climate=>"Schlafzimmer",<br>
OG_SZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",OG_DZ_WT01_Climate=>"Duschbad",<br>
OG_DZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler",EG_WZ_WT01_Climate=>"Wohnzimmer",<br>
EG_WZ_TT01_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler1",EG_WZ_TT02_Clima=>"&nbsp;;&nbsp;;&nbsp;;Regler2",'desired-temp' => ''}<br>
</code>
| Gewünschte Namen definieren.
|-
| <code>
attr heatingInfo valueFormat {if($READING eq "ValvePosition" && $VALUE ne "0"){$VALUE = int($VALUE/10)*10}<br>
elsif($READING eq "batteryLevel"){if($VALUE>=3){$VALUE=100}<br>
elsif($VALUE>=2.7){$VALUE=75}elsif($VALUE>=2.5){$VALUE=50}elsif($VALUE>=2.2){$VALUE=25}<br>
else{$VALUE=0}}}
</code>
| Werte vorformatieren (für die Icon-Zuordnung).
|-
| <code>
attr heatingInfo valueIcon {'controlMode.manual' => 'sani_heating_manual@795CFF',<br>
'controlMode.auto' => 'sani_heating_automatic@FFC13A', 'controlMode.boost' => 'sani_heating_boost@FB0C02',<br>
'humidity'=>'humidity@6FD9FB', 'R-globalBtnLock.on'=>'secur_locked@F7301D', <br>
'R-globalBtnLock.off'=>'secur_open@0CFB0C','ValvePosition.0' => 'sani_heating_level_0@002AE0',<br>
'ValvePosition.10' => 'sani_heating_level_10@F8D53D','ValvePosition.20' => 'sani_heating_level_20@FF9341',<br>
'ValvePosition.30' => 'sani_heating_level_30@F17F3F','ValvePosition.40' => 'sani_heating_level_40@E46C3C',<br>
'ValvePosition.50' => 'sani_heating_level_50@DE3B3A','ValvePosition.60' => 'sani_heating_level_60@A30D2D',<br>
'ValvePosition.70' => 'sani_heating_level_70@B40A23','ValvePosition.80' => 'sani_heating_level_80@C40619',<br>
'ValvePosition.90' => 'sani_heating_level_90@D4030F','ValvePosition.100' => 'sani_heating_level_100@E50005',<br>
'batteryLevel.100'=>'measure_battery_100@0CFB0C','batteryLevel.75'=>'measure_battery_75@42BC0A',<br>
'batteryLevel.50'=>'measure_battery_50@F5FF10','batteryLevel.25'=>'measure_battery_25@FB5909',<br>
'batteryLevel.0'=>'measure_battery_0@E50005','controlMode.set_boost' => 'hourglass',<br>
'controlMode.set_auto' => 'hourglass','controlMode.set_manual' => 'hourglass',<br>
'R-globalBtnLock.set_on' => 'hourglass','R-globalBtnLock.set_off' => 'hourglass'}
</code>
| Icons zuordnen.
|-
| <code>
attr heatingInfo valueStyle {if($READING eq "measured-temp")<br>
{my $t=$VALUE;;my $d=ReadingsVal($DEVICE,'desired-temp',0);;<br>
if($t-$d>=1){'style="color:rgb(251,63,11);;"'}elsif($t-$d<=-1){'style="color:rgb(79,58,251);;"'}<br>
else{'style="color:rgb(12,251,12);;"'}}}
</code>
| Farben (zu kalt: blau, zu warm: rot, ok: grün).
|-
| <code>
attr heatingInfo valueSuffix {"desired-temp"=>" °C", "measured-temp"=>" °C", <br>
"ValvePosition"=>" (".ReadingsVal($DEVICE,$READING,0)." %)", <br>
"humidity"=>" ".ReadingsVal($DEVICE,$READING,0)." % RH", <br>
"batteryLevel"=>" (".ReadingsVal($DEVICE,$READING,0)." V)"}
</code>
| Messeinheiten und Zahlenwerte.
|}

=== Readings aus zusätzlichen Devices ===
Im folgenden Beispiel wird gezeigt wie sich Readings zusätzlicher Devices zu einer Zeile mit mehreren Readings hinzufügen lassen. Diese zusätzlichen Devices können z.b. die unterschiedlichen Channel eines HomeMatic Gerätes sein. Im folgenden Beispiel wird der Name des zugehörigen Geräts dynamisch bestimmt.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rgHeizung4.png|thumb|750px|links|Anzeige + Regelmöglichkeit]]
|-
| style="width:40%" |<code>define myTemp readingsGroup <Raum>,<Tist>,<Tsoll>,<Mode>,<Tnight>,<Tday>,<Hum>,<BatTC>,<Vist>,<Vsoll>,<Verr>,<BatVD> Thermostat.(WZ|OZ|AZ|Bad|Kueche|SZ|GZ|Bad.OG):measured-temp,desired-temp,controlMode,night-temp,day-temp,humidity,battery,ValvePosition@{valveOfDevice($DEVICE)},ValveDesired@{valveOfDevice($DEVICE)},R-valveErrorPos@{valveOfDevice($DEVICE)},battery@{valveOfDevice($DEVICE)} Broetje:ToutIst </code>
| Diverse Readings aller Thermostat Devices und des jeweils zugehörigen Ventilantriebs.
|-
| <code>attr myTemp mapping { 'Broetje' => 'Garten','Thermostat.AZ' => 'EG Arbeitszimmer','Thermostat.SZ' => 'OG Schlafzimmer','Thermostat.WZ'=>'EG Wohnzimmer','Thermostat.Kueche' => 'EG Küche','Thermostat.GZ' => 'OG Gästezimmer','Thermostat.Bad' => 'EG Bad','Thermostat.Bad.OG' => 'OG Bad','Thermostat.OZ' => 'EG Kaminzimmer','desired-temp' => <nowiki>''</nowiki> }</code>
| Die Benennung der Zeilentitel (Das ist je nach Konfiguration auch über $ALIAS und/oder $ROOM lösbar).
|-
| <code>attr myTemp commands { 'desired-temp' => 'desired-temp:' }</code>
| desired-temp soll per dropDown einstellbar sein.
|-
| <code>attr myTemp nameStyle style="color:yellow"</code>
| Die Überschriften sollen gelb sein.
|-
| <code>attr myTemp valueIcon {'battery.ok' => 'batterie@lightgreen', 'battery.low' => 'batterie@red'}</code>
| Für den Batteriestand sollen jeweils Icons angezeigt werden.
|-
| <code>attr myTemp valueFormat { 'measured-temp' => "%0.1f &deg;C",'ToutIst' => "%.1f &deg;C",'night-temp' => "%.1f &deg;C",'day-temp' => "%.1f &deg;C",'humidity' => "%.0f
%%",'ValvePosition' => "%.0f %%",'ValveDesired' => "%.0f %%",'R-valveErrorPos' => "%.0f %%" }</code>
| Die Formatierung der Werte.
|-
|<source lang="perl">
#namen des ventil device aus thermostat device ableiten
sub valveOfDevice ($) {
my ($DEVICE) = @_;

if ($DEVICE =~ m/AZ/) {
return "Ventil.".substr($DEVICE,11).".Nord";
} else {
return "Ventil.".substr($DEVICE,11);
}
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hier wird aus dem Namen des Thermostaten der Name des zugehörigen Ventilantriebs abgeleitet.
|}
Da im {...} Teil des <reading>@<device> Arguments keine Leerzeichen oder Kommas vorkommen dürfen ist er in der Regel das Einfachste die Funktionalität wie in diesem Beispiel in eine eigene Routine auszulagern. Mit ein paar 'Tricks' lässt es sich aber manchmal auch ohne Leerzeichen oder Kommas lösen und dann direkt in die Definition schreiben:<code>...,ValvePosition@{$DEVICE=~s/Thermostat/Ventil/;$DEVICE;},...</code>

=== Inhalte filtern ===
Wenn man gewisse Zeilen einer Readingsgroup nicht dargestellt haben möchte, so kann man diese mit Hilfe von <code>valueFormat</code> ausfiltern, bspw.:

<code>attr rg valueFormat { return $VALUE if ( $VALUE > 0 );; return undef;; }</code>

In diesem Bsp. werden alle Zeilen/Devices, deren Value > 0 sind, angezeigt. Alle anderen werden als <code>undef</code> formatiert und erscheinen damit nicht im Listing.

Dies kann man noch weiter ausbauen und dynamische Auswahllisten erstellen (s. [[ReadingsGroup#Dynamische Inhalte]]).

=== Dynamische Inhalte ===
[[Datei:rgDynamic-1.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 1]]
[[Datei:rgDynamic-2.png|mini|450px|readingsGroup mit umschaltbarem Inhalt 2]]
Es ist möglich, den in einer readingsGroup dargestellten Inhalt dynamisch von zusätzlichen Bedingungen abhängig zu machen. Im folgenden Beispiel lässt sich
einstellen, dass nur die Devices angezeigt werden, die einen bestimmten Zustand (hier: on/off, open/tilted/closed) haben. Hier wird zum Umschalten ein dummy, der direkt über der readingsGroup dargestellt wird, verwendet. Über das links und/oder commands lässt sich auch eine Darstellung erzeugen, bei der das Umschalten direkt innerhalb der readingsGroup möglich ist.

<pre>
define LXrg dummy
attr LXrg group -
attr LXrg setList mode1:on,off mode2:open,closed,tilted
attr LXrg stateFormat 1=mode1 2=mode2
attr LXrg webCmd mode1:mode2

define rg readingsGroup Window.*:state Light.*:state
attr rg group -
attr rg valueFormat { return $VALUE if ( $VALUE eq ReadingsVal("LXrg","mode1","") || $VALUE eq ReadingsVal("LXrg","mode2","") );; return undef;;}

define Watch_LX notify LX.*:.* {my $value = ReadingsVal($NAME,'state','');;;;fhem("setreading $NAME $value")}
</pre>

=== Enable/Disable Button am Beispiel eines WeekdayTimer ===
Dieses Beispiel zeigt die Anwendung einer readingsGroup, um im Frontend einen Enable/Disable Button für ein Objekt darzustellen. Für den [[WeekdayTimer]] gibt es hier spezielle Erweiterungen (set Routinen, um das Attribut ''disable'' zu setzen). Es gibt aber auch eine allgemeinere Variante (siehe [http://forum.fhem.de/index.php/topic,23655.msg169141.html#msg169141 diesen Forumsbeitrag]) für alle Objekte, die das Fhem Attribut ''disable'' unterstützen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_scheduling.png|thumb|500px|links|Enable/Disable Button]]
|-
| style="width:40%" |<code>define rg_Timer_Wasser readingsGroup timer_Wasser_..:disabled,+DEF,<{rg_timer_Wasser_show_conditional($DEVICE,"nextUpdate")}@disabled>,<{rg_timer_Wasser_show_conditional($DEVICE,"nextValue")}@disabled></code>
| Definition der angezeigten Readings. Das Attribut ''disabled'' wird mit weiteren Einstellungen (''commands'') zum Button, +DEF zeigt die Definition, d.h. die Schaltzeiten, des Timers an. Die Readings nextUpdate und nextValue sollen nur angezeigt werden, falls der Timer aktiv ist. Hierfür sorgt eine Routine <code>rg_timer_Wasser_show_conditional</code>, die in der 99_myUtils.pm definiert wird. Das abschließende @disabled sorgt dafür, dass der LongPoll Mechanismus die Anzeige sofort ändert, wenn der Button betätigt wird.
|-
| <code>attr rg_Timer_Wasser valueFormat { if ( $READING =~ m/.*DEF/ ) { my @text = split(" ", $VALUE); shift @text; return join(" ", @text) }}</code>
| Der Name des Timers wird aus dem Internal "+DEF" vorne abgeschnitten. Damit werden nur die definierten Schaltpunkte angezeigt.
|-
| <code>attr rg_Timer_Wasser valueIcon { 'disabled.0' => 'Restart', 'disabled.1' => 'Shutdown' }</code>
| Die beiden Zustände für den Button werden durch zwei Standard-Icons angezeigt.
|-
| <code>attr rg_Timer_Wasser commands { 'disabled.0' => 'set $DEVICE disable', 'disabled.1' => 'set $DEVICE enable' }</code>
| Toggle-Funktion für den Button. Wenn der Timer aktiv ("disabled.0") sorgt ein Klick auf den Button, dass der Timer deaktiviert wird ("set $DEVICE disable").
|-
|<source lang="perl">
sub rg_timer_Wasser_show_conditional($$)
{
my ($DEVICE,$READING) = @_;
return ( ReadingsVal($DEVICE, "disabled", "1") eq "0" )?
ReadingsVal($DEVICE, $READING, "reading_undef") : "disabled";
}</source>
| Dieser Teil kommt in die [[99_myUtils_anlegen|99_myUtils.pm]]: Hiermit wird das übergebene Reading des Timers nur angezeigt, wenn der Timer aktiv ist. Andernfalls wird der String "disabled" angezeigt.
|}

=== Ändern von Attributen: Noch ein WeekdayTimer Beispiel ===
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Inzwischen ist es auch möglich das commands Mapping auf Attribute anzuwenden. Die Syntax ist die gleiche wie für die set Kommandos. Um das Beispiel übersichtlich zu halten werden hier die Werte und Icons auch für deaktiviert WeekdayTimer angezeigt.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Datei:rg_timer.png|thumb|500px|links|FhemWidget für das 'disable' Attribut]]
|-
| style="width:40%" |<code>define rgTimer readingsGroup <>,<Current>,<Update-Time>,<New>,<disable> TYPE=WeekdayTimer:state,nextUpdate,nextValue,?!disable</code>
| Definition der angezeigten Readings. Das Attribut ''disable'' wird mit weiteren Einstellungen (''commands'') zum Button. Durch das ! wird das Attribut auch dann angezeigt wenn es noch nicht gesetzt ist.
|-
| <code>attr rgTimer valueIcon { state => '%devStateIcon', nextValue => '{(split(":",Color::devStateIcon($DEVICE,"dimmer",undef,"nextValue")))[1]}' }</code>
| Für den aktuellen Zustand wird das devStateIcon angezeigt und für den nächsten Zustand das passende Lampen-Icon.
|-
| <code>attr rgTimer valueFormat '{(split(" ", $VALUE))[1]}'</code>
| Vom nächsten Schaltpunkt wird nur die Zeit angezeigt.
|-
| <code>attr rgTimer commands { disable => 'disable:' }</code>
| Für das disable attribut wird das normale dropDown mit 0 und 1 angezeigt das auch in der Device Detail Ansicht verwendet wird.
|}

=== Readings löschen ===
Es kann vorkommen, dass Readings angezeigt werden, die garnicht existieren sollten - bspw. wenn man in einer HTTPMOD ein Reading umbeannt hat, kann auch der alte Readingsname immernoch angezeigt werden. Solche Readings können mit der globalen Funktion [http://fhem.de/commandref.html#deletereading deletereading] gelöscht werden.

'''Achtung:''' Auf jeden Fall die [http://fhem.de/commandref.html#deletereading CommandRef dazu] lesen!

Beispiel:
Im HTTPMOD des [[Pollenflug]] war zuerst das <code>reading04Name Graeser</code> definiert und wurde später in <code>reading04Name Gräser</code> umbenannt. In der zugehörigen ReadingGroup wurden dann konsequent beide Varianten dargestellt - auch nachdem alle Alt-Einträge aus den Logs entfernt wurden. Erst ein <code>deletereading Pollenflug Graeser</code> in der fhem-Befehltszeile hat das veraltete Reading entfernt.

=== Ausrichtung der Tabelle drehen (horizontal/vertikal) ===
Eine Readingsgroup wird standardmäßig immer zeilenweise aufgebaut, zB. jedes Gerät in eine neue Zeile. Die Werte der Geräte werden dann in den Spalten dargestellt.
Wenn man eine Readingsgroup für nur ein Gerät mit vielen Readings hat (zB. [[Allergy]]), so kann man die Darstellung horizontal oder vertikal ausrichten, indem man die Readingsgroup detailliert definiert. Ein Bsp. dazu liefert der Foreneintrag [https://forum.fhem.de/index.php/topic,37194.msg440446.html#msg440446] :

<pre>
define Pollenflugvorhersage allergy <PLZ>
attr Pollenflugvorhersage levelsFormat rc_dot@white,rc_dot@yellow,rc_dot@orange,rc_dot@red
attr Pollenflugvorhersage stateFormat fc1_maximum
attr Pollenflugvorhersage updateEmpty 1
attr Pollenflugvorhersage updateIgnored 1

# Pollen in Spalten, Tage in Zeilen
define PollenAlarmHorizontal readingsGroup <>,<Ampfer>,<Ambrosia>,<Beifuß>,<Birke>,<Buche>,<Eiche>,<Erle>,<Gräser>,<Hasel>,<Pappel>,<Roggen>,<Ulme>,<Wegerich>,<Weide> \
Pollenflugvorhersage:fc1_day_of_week,fc1_Ampfer,fc1_Ambrosia,fc1_Beifuß,fc1_Birke,fc1_Buche,fc1_Eiche,fc1_Erle,fc1_Gräser,fc1_Hasel,fc1_Pappel,fc1_Roggen,fc1_Ulme,fc1_Wegerich,fc1_Weide \
Pollenflugvorhersage:fc2_day_of_week,fc2_Ampfer,fc2_Ambrosia,fc2_Beifuß,fc2_Birke,fc2_Buche,fc2_Eiche,fc2_Erle,fc2_Gräser,fc2_Hasel,fc2_Pappel,fc2_Roggen,fc2_Ulme,fc2_Wegerich,fc2_Weide \
Pollenflugvorhersage:fc3_day_of_week,fc3_Ampfer,fc3_Ambrosia,fc3_Beifuß,fc3_Birke,fc3_Buche,fc3_Eiche,fc3_Erle,fc3_Gräser,fc3_Hasel,fc3_Pappel,fc3_Roggen,fc3_Ulme,fc3_Wegerich,fc3_Weide \
Pollenflugvorhersage:fc4_day_of_week,fc4_Ampfer,fc4_Ambrosia,fc4_Beifuß,fc4_Birke,fc4_Buche,fc4_Eiche,fc4_Erle,fc4_Gräser,fc4_Hasel,fc4_Pappel,fc4_Roggen,fc4_Ulme,fc4_Wegerich,fc4_Weide \
Pollenflugvorhersage:fc5_day_of_week,fc5_Ampfer,fc5_Ambrosia,fc5_Beifuß,fc5_Birke,fc5_Buche,fc5_Eiche,fc5_Erle,fc5_Gräser,fc5_Hasel,fc5_Pappel,fc5_Roggen,fc5_Ulme,fc5_Wegerich,fc5_Weide \
Pollenflugvorhersage:fc6_day_of_week,fc6_Ampfer,fc6_Ambrosia,fc6_Beifuß,fc6_Birke,fc6_Buche,fc6_Eiche,fc6_Erle,fc6_Gräser,fc6_Hasel,fc6_Pappel,fc6_Roggen,fc6_Ulme,fc6_Wegerich,fc6_Weide \
Pollenflugvorhersage:fc7_day_of_week,fc7_Ampfer,fc7_Ambrosia,fc7_Beifuß,fc7_Birke,fc7_Buche,fc7_Eiche,fc7_Erle,fc7_Gräser,fc7_Hasel,fc7_Pappel,fc7_Roggen,fc7_Ulme,fc7_Wegerich,fc7_Weide
attr PollenAlarm nonames 1
attr PollenAlarm valueFormat %VALUE
attr PollenAlarm valueIcon %VALUE

# Tage in Spalten, Pollen in Zeilen
define PollenAlarmVertikal readingsGroup Pollenflugvorhersage:<Pollen>,fc0_day_of_week,fc1_day_of_week,fc2_day_of_week,fc3_day_of_week,fc4_day_of_week,fc5_day_of_week,fc6_day_of_week,fc7_day_of_week \
Pollenflugvorhersage:<Ambrosia>,fc0_Ambrosia,fc1_Ambrosia,fc2_Ambrosia,fc3_Ambrosia,fc4_Ambrosia,fc5_Ambrosia,fc6_Ambrosia,fc7_Ambrosia\
Pollenflugvorhersage:<Ampfer>,fc0_Ampfer,fc1_Ampfer,fc2_Ampfer,fc3_Ampfer,fc4_Ampfer,fc5_Ampfer,fc6_Ampfer,fc7_Ampfer\
Pollenflugvorhersage:<Beifuß>,fc0_Beifuss,fc1_Beifuss,fc2_Beifuss,fc3_Beifuss,fc4_Beifuss,fc5_Beifuss,fc6_Beifuss,fc7_Beifuss\
Pollenflugvorhersage:<<b>Birke<Birke</b>>,fc0_Birke,fc1_Birke,fc2_Birke,fc3_Birke,fc4_Birke,fc5_Birke,fc6_Birke,fc7_Birke\
Pollenflugvorhersage:<Buche>,fc0_Buche,fc1_Buche,fc2_Buche,fc3_Buche,fc4_Buche,fc5_Buche,fc6_Buche,fc7_Buche\
Pollenflugvorhersage:<Eiche>,fc0_Eiche,fc1_Eiche,fc2_Eiche,fc3_Eiche,fc4_Eiche,fc5_Eiche,fc6_Eiche,fc7_Eiche\
Pollenflugvorhersage:<<b>Erle<Erle</b>>,fc0_Erle,fc1_Erle,fc2_Erle,fc3_Erle,fc4_Erle,fc5_Erle,fc6_Erle,fc7_Erle\
Pollenflugvorhersage:<Gräser>,fc0_Graeser,fc1_Graeser,fc2_Graeser,fc3_Graeser,fc4_Graeser,fc5_Graeser,fc6_Graeser,fc7_Graeser\
Pollenflugvorhersage:<<b>Hasel<Hasel</b>>,fc0_Hasel,fc1_Hasel,fc2_Hasel,fc3_Hasel,fc4_Hasel,fc5_Hasel,fc6_Hasel,fc7_Hasel\
Pollenflugvorhersage:<Pappel>,fc0_Pappel,fc1_Pappel,fc2_Pappel,fc3_Pappel,fc4_Pappel,fc5_Pappel,fc6_Pappel,fc7_Pappel\
Pollenflugvorhersage:<Roggen>,fc0_Roggen,fc1_Roggen,fc2_Roggen,fc3_Roggen,fc4_Roggen,fc5_Roggen,fc6_Roggen,fc7_Roggen\
Pollenflugvorhersage:<Ulme>,fc0_Ulme,fc1_Ulme,fc2_Ulme,fc3_Ulme,fc4_Ulme,fc5_Ulme,fc6_Ulme,fc7_Ulme\
Pollenflugvorhersage:<Wegerich>,fc0_Wegerich,fc1_Wegerich,fc2_Ulme,fc3_Wegerich,fc4_Wegerich,fc5_Wegerich,fc6_Wegerich,fc7_Wegerich\
Pollenflugvorhersage:<Weide>,fc0_Weide,fc1_Weide,fc2_Weide,fc3_Weide,fc4_Weide,fc5_Weide,fc6_Weide,fc7_Weide
</pre>

== Berechnungen ==
{{Randnotiz|RNTyp=y|RNText=Dieses Beispiel benutzt Funktionen, die erst ab [[version|Modulversion]] 8761/16.6.2015 verfügbar sind.}}
Das Rechnen funktioniert über das Flag "$", mit dem eine Funktion angegeben werden kann, die auf beliebige Kombinationen von Zeilen, Spalten und einzelnen Zellen angewendet wird. Ähnlich wie in einer Tabellenkalkulation.

Ein Beispiel:
:<code>define rg readingsGroup .*:temperature rg:$avg</code>
Damit wird eine readingsGroup über alle ''temperature'' Readings definiert. In einer zusätzlichen Zeile am Ende wird mit ''$avg'' der Durchschnittswert aller darüber liegenden Temperaturen angezeigt.

Das genaue Format: <code>$<operator>[(<zellen>)]</code> mit
*<code><operator></code>: sum, avg, min, max, scalar, count oder der Name einer beliebigen anderen Funktion, die ein Array mit allen Werten übergeben bekommt und ein Ergebnis zurückliefert.
*<code><zellen></code> ist eine durch Semikolon getrennte Liste aus <code><zeilen>:<spalten></code> Paaren.
*<code><zeilen></code> und <code><spalten></code> sind jeweils eine Perl Liste, d.h. hier können
** einzelne Werte,
** durch Komma getrennte Aufzählungen,
** mit .. angegebene Wertebereiche
** sowie <code>$ROW</code> und <code>$COLUMN</code> als Bezeichner für die aktuelle Zelle
:verwendet werden.

Alle Möglichkeiten sind kombinierbar. Die Zählung der Zeilen und Spalten beginnt bei 1. Eine nicht vorhandene Zeilenangabe wird durch den Bereich von Zeile 1 bis zur aktuellen Zeile ersetzt, eine nicht vorhandene Spalte durch die aktuelle Spalte.

Es ergeben sich somit unter anderem folgende Möglichkeiten:
*<code>$sum</code> equivalent zu <code>$sum(1..$ROW), $sum(:$COLUMN)</code> und <code>$sum(1..$ROW:$COLUMN)</code> die Summe der Werte in der Spalte über der aktuellen Zelle.
*<code>$max($ROW:1..$COLUMN-1)</code> Maximum aller Werte links von der aktuellen Zelle (in der aktuellen Zeile)
*<code>$avg(1..$ROW:1)</code> Durchschnitt aller Werte in Spalte 1 bis zur aktuellen Zeile
*<code>$scalar(:1)</code> Anzahl der Werte in Spalte 1
*<code>$min(1..5:1,2,4)</code> Minimum der Werte aus den Zeilen 1-5 in den Spalten 1, 2 und 4

Eigene Funktionen lassen sich über 99_myUtils anlegen und z.B. verwenden um Häufigkeiten zu zählen oder mit nichtnumerischen Readings umzugehen.

Die Ergebnisse werden im Weiteren wie normale Readings behandelt. Sie lassen sich von links oben nach rechts unten kaskadieren und lassen sich über valuePrefix, valueSuffix, valueFormat und valueStyle in der Darstellung beeinflussen. Also z.B. einfärben, als Balkendiagramm darstellen, ...

Mit Hilfe der Funktionalität zum auf- und zu-klappen von Teilen einer readingsGroup lassen sich z.B. im zusammengeklappten Zustand Summen, Extremwerte oder andere Ausreißer anzeigen und die Details nur beim Aufklappen zeigen.

Weitere Möglichkeiten:
* Attribut <code>firstCalcRow</code>: Hiermit kann der Default für die Nummer der ersten Zeile vorgegeben werden (sofern im Ausdruck nichts genaueres angegeben ist). firstCalcRow sollte z.B. auf 2 gesetzt werden, wenn in der readingsGroup Spaltenüberschriften verwendet werden.
* special <code><nowiki><hr></nowiki></code> um eine horizontale Linie über die volle Breite einzufügen
* Über ein angehängtes <code>@<alias></code> kann einem Rechenergebniss ein Alias-Name gegeben werden. Über diesen kann der Wert dann zur Formatierung mit den value-Attributen angesprochen werden.
* das <code>alwaysTrigger</code> Attribut kann jetzt auch den Wert 2 bekommen. Damit werden in der readingsGroup Readings für alle durch die Aggregation gebildeten Werte und entsprechende Events auch dann erzeugt wenn die readingsGroup nicht angezeigt wird. Wenn ein Alias-Name vergeben ist, wird dieser auch für den Reading-Namen verwendet.
* Über den operator <code>$count(<wert>)(<zellen>)</code> um das Vorkommen von <code><wert></code> in den angegebenen Zellen zu zählen. <code><wert></code> kann enweder direkt der zu zählende Wert sein (ohne Anführungzeichen) oder eine in / eingeschlossene regex. Mit <code>!<wert></code> kann das Nicht-Vorkommen von <code><wert></code> gezählt werden.

=== Ein interaktives Beispiel ===
[[Datei:rgCalc.png|mini|right|400px|Beispiel-readingsGroup mit Berechnungen]]
In drei [[dummy]] Objekten lässt sich jeweils ein Reading über einen Slider einstellen. In der darunter liegenden readingsGroup werden diese Readings und diverse daraus abgeleitete Werte dargestellt. Alle Readings und die daraus abgeleiteten Werte werden live per longpoll aktualisiert, wenn die slider bewegt werden.
<br clear=all>
<pre>
define t1 dummy
attr t1 room rg
attr t1 setList state:slider,-10,1,30
attr t1 webCmd state
define t2 dummy
attr t2 room rg
attr t2 setList state:slider,-10,1,30
attr t2 webCmd state
define t3 dummy
attr t3 room rg
attr t3 setList state:slider,-10,1,30
attr t3 webCmd state

define rg readingsGroup <>,<value>,<sum>,<min>,<max>,<avg>\
t\d:+NAME,state,$sum(1..$ROW:2),$min(1..$ROW:2),$max(1..$ROW:2),$avg(1..$ROW:2)\
<hr>\
rg:<>,$scalar,$sum(:2)@SUM,$min(:2)@MIN,$max(:2)@MAX,$avg(:2)@AVG\
<hr>\
t1:<t1,t2,t3>,state,state@t2,state@t3,$sum($ROW:2..4)@SUM,$count(/\d/)(2..$ROW-4:2)\

attr rg nonames 1
attr rg room rg
attr rg style style='text-align:center'
attr rg valueFormat { 'avg' => '%.2f', 'AVG' => '%.2f' }
attr rg valuePrefix { 'rg.scalar' => '#', 'rg.SUM' =>'Σ; ', 'rg.MIN' =>'Min: ', 'rg.MAX' =>'Max: ', 'rg.AVG' =>'∅; ', 'rg.count' => '#(X): ' }
attr rg valueSuffix { state => '°;C' }
</pre>

== Links und Trigger ==
=== readingsGroup mit Link ===
[[Datei:rgPCA-detail.png|mini|400px|readingsGroup mit Link]]
Das PCA301 Beispiel oben lässt sich mit einem ans Ende des define angehängten
:<code><{appendTrigger($DEVICE,"clear","Alle löschen")}></code>
und der folgenden appendTrigger Definition in 99_myUtils.pm um einen Link erweitern, der ein Event auslöst, an das z.B. ein notify gehängt werden kann, um die Verbrauchszähler der PCA301 Dosen zurückzusetzen.
:<code>define clearVerbrauch notify Verbrauch:clear set TYPE=PCA301 clear</code>

<source lang="perl">
use vars qw($FW_ME);
use vars qw($FW_subdir);
sub
appendTrigger($$$)
{
my ($name,$trigger,$label) = @_;

my $ret .= "</table></td></tr>";

my $link = "cmd=trigger $name $trigger";
my $txt = "<a onClick=\"FW_cmd('$FW_ME$FW_subdir?XHR=1&$link')\">$label</a>";
$ret .= "<td colspan=\"99\"><div style=\"cursor:pointer;color:#888888;text-align:right\">$txt</div></td>";

return ($ret,0);
}</source>

wenn hierdurch Änderungen an einer readingsGroup erfolgen, die ein Neuladen der Seite erforderlich machen, kann dies so erfolgen:
:<code>{myUtils_refresh("WEB")}</code>
mit folgendem code in 99_myUtils.pm:
<source lang="perl">
sub
myUtils_refresh($)
{
my ($name) = @_;

FW_directNotify("#FHEMWEB:$name", "location.reload(true);","" );
}</source>

Ein weiteres Beispiel für 'custom links und trigger' findet sich in {{Link2Forum|Topic=14425|Message=109383|LinkText=diesem Forenbeitrag}}: dort wird damit eine readingsGroup dynamisch umgeschaltet, um nur die eingeschalteten, nur die ausgeschalteten oder alle Lampen anzuzeigen.

=== sub rg ===
Damit beim klicken auf ein Icon oder einen Text in einer readingsGroup etwas passiert ist es möglich dies über das commands Attribut auf ein <code>'trigger ntfy_rg $DEVICE $READING'</code> oder Ähnliches zu mappen.
Anlegen des ntfy_rg notify
<pre>
define ntfy_rg notify ntfy_rg {rg($EVENT)}
</pre>
Folgender Code muss noch in de [[99_myUtils_anlegen|99_myUtils.pm]]
<source lang="perl">
sub rg($){
my @input = split(/[§\s]+/,shift);
my $device = $input[0];
my $function = $input[1];

if($function eq "clima"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;

return(("d_climaControl_".$room));
}
elsif($function eq "device"){
return InternalVal($device,"device","device error");
}
elsif($function eq "controlMode"){
my $controlMode = ReadingsVal($device,"controlMode","controlMode error");

if($controlMode ~~ /manual/)
{fhem("set $device controlMode auto")}
elsif($controlMode ~~ /auto/)
{fhem("set $device controlMode manual")};
}
elsif($function eq "globalBtnLock"){
my $globalBtnLock = ReadingsVal($device,"R-globalBtnLock","globalBtnLock error");

if($globalBtnLock ~~ /off/){
{fhem("set $device regSet globalBtnLock on")}
{fhem ("set $device getConfig")}
}
elsif($globalBtnLock ~~ /on/){
{fhem("set $device regSet globalBtnLock off")}
{fhem ("set $device getConfig")}
};
}
elsif($function eq "state"){
my $state = Value($device);

if($state ~~ /off/){
{fhem("set $device on")}
}
elsif($state ~~ /on/){
{fhem("set $device off")}
};
}
elsif($function eq "setTimeTable"){
my $room = AttrVal($device, 'room', 'undef');
$room =~ s/\D//g;
my $climaControl = ("d_climaControl_".$room);
my $dayTemp = ReadingsVal( $climaControl, "dayTemp" , 21.0 );
my $nightTemp = ReadingsVal( $climaControl, "nightTemp" , 17.0 );
my $workday_period_1_start = ReadingsVal( $climaControl, "workday_period_1_start" , "06:30" );
my $workday_period_1_stop = ReadingsVal( $climaControl, "workday_period_1_stop" , "18:00" );
my $workday_period_2_start = ReadingsVal( $climaControl, "workday_period_2_start" , "24:00" );
my $workday_period_2_stop = ReadingsVal( $climaControl, "workday_period_2_stop" , "24:00" );
my $saturday_period_1_start = ReadingsVal( $climaControl, "saturday_period_1_start" , "06:30" );
my $saturday_period_1_stop = ReadingsVal( $climaControl, "saturday_period_1_stop" , "12:00" );
my $saturday_period_2_start = ReadingsVal( $climaControl, "saturday_period_2_start" , "24:00" );
my $saturday_period_2_stop = ReadingsVal( $climaControl, "saturday_period_2_stop" , "24:00" );
my $sunday_period_1_start = ReadingsVal( $climaControl, "sunday_period_1_start" , "24:00" );
my $sunday_period_1_stop = ReadingsVal( $climaControl, "sunday_period_1_stop" , "24:00" );
my $sunday_period_2_start = ReadingsVal( $climaControl, "sunday_period_2_start" , "24:00" );
my $sunday_period_2_stop = ReadingsVal( $climaControl, "sunday_period_2_stop" , "24:00" );

{fhem("set $device tempListMon prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListTue prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListWed prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListThu prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListFri prep $workday_period_1_start $nightTemp $workday_period_1_stop $dayTemp $workday_period_2_start $nightTemp $workday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSat prep $saturday_period_1_start $nightTemp $saturday_period_1_stop $dayTemp $saturday_period_2_start $nightTemp $saturday_period_2_stop $dayTemp 24:00 $nightTemp")};
{fhem("set $device tempListSun exec $sunday_period_1_start $nightTemp $sunday_period_1_stop $dayTemp $sunday_period_2_start $nightTemp $sunday_period_2_stop $dayTemp 24:00 $nightTemp")};
}
}
</source>
Hier sind die benötigten CodeBlöcke für [[ReadingsGroup#Heizungswerte.2C_Status.2C_Steuerung_und_Wochenprofil|Heizungswerte, Status, Steuerung und Wochenprofil]] enthalten, aber auch um state zu triggern.

== Sonstiges ==
In der Regel werden die Parameter zu einem reading in den mappings unter <$DEVICE> und dann <$DEVICE>.<$READING> und dann unter <$READING>.<$VALUE> gesucht.

=== Lesbar machen ===
Für die meisten Attribute gilt:

* Wenn es komplexer wird ist es einfacher, den Code in eine eigene Routine in (beispielsweise) [[99 myUtils anlegen|99_myUtils]] auszulagern und diese aufzurufen:
:<code> attr <name> valueStyle {myValueToFormat($READING,$VALUE)}</code>
* code für unterschiedliche readings kann auch im mapping schon aufgeteilt werden:
:<code>attr <name> valueStyle { SuperE5 => '{perl code}', Diesel => '{perl code}' }</code>
* Ifs lassen sich verschachteln und sortieren. So kann die Anzahl der Klammern und Else-Zweige reduziert werden:
if( $READING eq ... ) {
return xxx if( $VALUE < 1 );
return yyy if( $VALUE < 1.5 );
return zzz;
} elsif( $READING eq ... ) {
...
}

Da alles lässt sich natürlich auch kombinieren und so viel lesbarer machen als ein einziger langer Bandwurm.

=== readingsGroup in einer Gruppe ===
Wenn der doppelte Rahmen um eine readingsGroup bei Darstellung in einer Gruppe stört, lässt er sich mit dem passenden style entfernen:
:<code>attr <rgName> style style="border:0px;background:none;box-shadow:none"</code>
Für die readingsGroup ''rgName'' wird der Darstellungsstil verändert.

Anwendungs-Bsp: [[Pollenflug]]

=== Einfache Balkendiagramme ===
[[Datei:rgBars.png|mini|400px|readingsGroup mit Balken]]
Readings lassen sich mit einem valueStyle der folgenden Art mit einem "Füllstandsbalken" hinterlegen:
:<code>attr <rgName> valueStyle style="width:200px; text-align:center; border: 1px solid #ccc; background:-webkit-linear-gradient(left, red $VALUE%, rgba(0,0,0,0) $VALUE%)"</code>

Die Balken werden bei Änderungen der Readings automatisch per longpoll aktualisiert.

Diese direkte Definition des <code>valueStyle</code> ist allerdings sehr unflexibel - bspw. müsste der <code>$VALUE</code> zufällig max 100 erreichen und es darf nur ein Browsertyp eingesetzt werden, damit alles sauber funktioniert.

Deutlich flexibler ist eine Auslagerung als eigenständige Funktion in die [[99_myUtils_anlegen|99_myUtils.pm]], die den valueStyle dynamisch generiert, bspw.:

<source lang="perl">
sub Balkenanzeige($)
{
# Zuweisung der übergebenen Variablen
my ($val) = @_;

# Konfiguration des maximal übergebenen Werts (hier wäre der höchste zu erwartende Wert = 3)
my $maxValue = 3;

# Normalisierung auf 100%-Wert
my $percent = $val / $maxValue * 100;

# Definition des valueStyles
my $stylestring = 'style="
width: 200px;
text-align:center;
border: 1px solid #ccc;
background-image: -webkit-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -moz-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -ms-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: -o-linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
background-image: linear-gradient(left,red '.$percent.'%, rgba(0,0,0,0) '.$percent.'%);
"';

# Rückgabe des definierten Strings
return $stylestring;
}
</source>

Der Aufruf sähe dann wie folgt aus:

<code> attr <rgName> valueStyle { Balkenanzeige($VALUE) } </code>

Die einzelnen Werte des <code>$stylestring</code> haben folgende Bedeutungen:
* width - Breite des Balkenrahmens
* text-align - Ausrichtung des Texts
* border - Format des Balkenrahmens
* background-image - Format des Hintergrunds des Balkenrahmens, also des Balkens selbst
** linear-gradient - css-Funktion zur Erstellung von Farbverläufen ''(*)''
*** left - linksbündiger Balken
*** red x% - roter Balken x% breit
*** rgba(0,0,0,0) x% - farbloser Teil startet bei x%

''(*) linear-gradient wird in verschiedenen Browsern unterschiedlich umgesetzt. Deshalb sollten immer alle Varianten zusammen angegeben werden, damit die Darstellung auf allen Browsern funktioniert. (vgl. Link unten)''

Weitere Infos zu:
* linear-gradient - [https://developer.mozilla.org/de/docs/Web/CSS/linear-gradient]
* Farbanpassungen, z.B. auch unter Verwendung der [[Color#Skalenfarbe_mit_Color::pahColor|Color::pahColor]] Routine.
* Anpassung von Werten s.o. [[ReadingsGroup#Lesbar_machen]]
* weiteren Möglichkeiten zur Erzeugung von Balkendiagrammen in Forenbeiträgen {{Link2Forum|Topic=25313|LinkText=hier}} und {{Link2Forum|Topic=28318|LinkText=hier}}
* [[99_myUtils_anlegen|99_myUtils.pm]]

Anwendungs-Bsp: [[Pollenflug]]

=== readingsGroup Styling mit CSS ===
Jede readingsGroup lässt sich durch CSS individuell stylen.

==== Allgemeines ====
Damit der eigene CSS Code nach einem [[Update]] der FHEM-Style Dateien vorhanden bleibt, ist es notwenig eine eigene .css Datei (zB ios7ReadingsGroups.css) zu erstellen und ins Verzeichnis ''fhem/www/pgm2/'' zu kopieren. Anschließend muss in der [[FHEMWEB]] Instanz das Attribut ''CssFiles'' auf zB ''pgm2/ios7ReadingsGroups.css'' gesetzt werden.

==== Erweiterte Device Übersicht ====
Diese ReadingsGroup ist an der [[FHEMWEB]] Device-Übersicht angelehnt. Zusätzlich werden weitere Readings, hier Leistung, Betriebszeit Heute und Jahr, ein Link zu Detail-Seite der ReadingsGroup und Links zu den jeweiligen Device-Detail-Seite, dargestellt.

{| class="wikitable"
| [[Datei:RgStylingOhneCss.png|600px|mini|left|Device ReadingsGroup ohne CSS]] [[Datei:RgStylingMitCss.png|600px|mini|left|Device ReadingsGroup mit CSS]]
|}

===== Definition =====
<pre>
define rg_devices readingsGroup <{rgLink($DEVICE,"konfigurieren","Details")}>,<Device>,<Status>,<Leistung>,<Heute>,<Jahr>\
wzDeckenfluter:<%light_floor_lamp>,<{rgLink("wzDeckenfluter","detail","Deckenfluter")}>,state,<>,dauerHeute,dauerJahr\
wzMacMini:<%it_nas>,<{rgLink("wzMacMini","detail","MacMini")}>,state,power,consumption,consumptionYear\
attr rg_devices noheading 1
attr rg_devices nonames 1
attr rg_devices notime 1
attr rg_devices room ReadingsGroup Styling
attr rg_devices style class="block wide rgDevices"
attr rg_devices valueFormat { 'power' => "%.1f W ", consumption => "%.2f kWh", 'consumptionYear' => "%.2f kWh" }
attr rg_devices valueIcon { state => '%devStateIcon' }
</pre>

Damit sich der CSS auf die richtige readingsGroup bezieht, ist es nötigt
das Attribut ''style'' anzupassen.
{| class="wikitable"
! Definition !! Erläuterungen
|-
| style="width:40%" |<code>attr <rgName> style class="block wide rgDevices"</code>
| Die Klassen ''block'' und ''wide'' müssen eingetragen werden. Der Name der Nachfolgenden Klasse, hier ''rgDevices'', ist frei wählbar.
|}
===== Funktion rgLink() =====
Die Funktion rgLink($name,$action,$label) liefert einen Link mit dem Namen $label zurück. Der Code gehört in die [[99 myUtils anlegen|99_myUtils.pm]].
* $name - Name des Device das aufgerufen werden soll
* $action - Aktion die Ausgeführt werden soll.
**''konfigurieren'' erzeugt den kleinen ''Details'' Button links oben der einem zur Detail Seite der ReadingsGroup führt - nützlich wenn das ReadingsGroup-Attribut ''noheading'' gesetzt ist
** ''detail'' erzeugt einen Link zu Device-Detail Seite
* $label - Link-Name
<source lang="perl">
sub rgLink($$$){
my ($name,$action,$label) = @_;
my $link = "";
my $fhemLink = "";
my $txt = "";
my $ret = "";
my $divStyle = "";
my $aStyle = "";

# FHEM Variablen einbinden
use vars qw($FW_ME);
use vars qw($FW_subdir);
use vars qw($FW_ss);
use vars qw($FW_tp);

if( $action eq "konfigurieren" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;font-size:11px;padding-bottom:2px;padding-left:3px;";
}
elsif( $action eq "detail" ){
$fhemLink = "detail=$name";
$divStyle = "cursor:pointer;display:inline;";
}

$link = '<a onclick="location.href=\'' . $FW_ME . $FW_subdir . '?' . $fhemLink . '\'" style="' . $aStyle . '">' . $label . '</a>';
$txt = '<div style="' . $divStyle . '">' . $link . '</div>';
$ret = "$txt";

return $ret;
}
</source>

{{Randnotiz|RNText=Tipp
Verwende zum Bearbeiten der eigenen .css Dateien entweder den [[Konfiguration#Syntaxhervorhebung|Codemirror Editor]] oder einen eigenen Editor mit [http://de.wikipedia.org/wiki/Syntaxhervorhebung Syntax Highlighting] . Das hilft bei der Fehlersuche enorm. }}

===== Styling =====
Die eigene .css Datei erscheint in FHEM unter Edit-Files --> styles und kann direkt im FHEM-Editor oder mit eigenen Editor bearbeitet werden.

ios7ReadingsGroups.css:
<pre>
/* Readings Groups Devices */
table.rgDevices tr td{ text-align: center; }
table.rgDevices tr:first-child td:nth-child(2){ /* 1. Zeile 2. Spalte */ text-align: center; }
table.rgDevices tr td:first-child{ /* 1. Spalte */ width: 45px; text-align: center; }
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 33%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
</pre>

==== Auf Portrait / Landscape Modus des Smartphone unterscheiden ====
Dieses Beispiel ist an das obige Beispiel [[#Erweiterte_Device_.C3.9Cbersicht|Erweiterte Device Übersicht]] angelehnt.

{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortrait.png|300px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscape.png|550px|mini|center|Device ReadingsGroup im Landscape Modus]]
|}

===== Allgemeines =====
Mit CSS ist man in der Lage auf die aktuelle Bildschirmlage zu reagieren. Alle Anweisungen die in diesen beiden Funktionen zwischen den beiden { } stehen, werden je nach Bildschirmlage aufgerufen
<pre>
/* Portrait Modus */
@media all and (orientation:portrait) { }

/* Landscape Modus */
@media all and (orientation:landscape) { }
</pre>

===== Styling =====
{{Randnotiz|RNText=Info
* ''width: xx%'' ändert die Breite der Spalte
* ''display: none'' blendet die Spalte aus}}
In der FHEMWEB_phone Instanz muss wie [[#Allgemeines|hier]] beschrieben eine neue eigene .css Datei eingetragen werden. In diesem Beispiel ios7smallscreenReadingsGroups.css

ios7smallscreenReadingsGroups.css
<pre>
/* landscape und portrait modus */
table.rgDevices tr td { /* Zuerst alles centern */ text-align: center; }
table.rgDevices tr:first-child td:nth-child(1){ /* 1. Zeile 1. Spalte */ text-align: center; }
table.rgDevices tr td:first-child { /* 1. Spalte */ width: 5%; }
table.rgDevices tr:first-child td:nth-child(2) { /* 1. Zeile 2. Spalte */ text-align: center; }
table.block table tr td table.rgDevices tr td { border-bottom: 1px solid #cbcbcb; }

/* Portrait Modus */
@media all and (orientation:portrait) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 50%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: auto; text-align: right; display: table-cell; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 0; display: none; }
table.rgDevices tr td:nth-child(6){ width: 0; display: none; }
table.rgDevices tr td div a svg{ margin-left: 90px; }
}

/* Landscape Modus */
@media all and (orientation:landscape) {
table.rgDevices tr td:nth-child(2){ /* 2. Spalte */ width: 35%; text-align: left; }
table.rgDevices tr td:nth-child(3){ /* 3. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(4){ /* 4. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
table.rgDevices tr td:nth-child(5){ /* 5. Spalte */ width: 15%; }
}
</pre>

==== Plots im Portrait Modus des Smartphones ausblenden ====
{| class="wikitable"
| style="width:40%" |[[Datei:RgStylingSmallscreenPortraitPlot.png|350px|mini|center|Device ReadingsGroup im Portrait Modus]]
|[[Datei:RgStylingSmallscreenLandscapePlot.PNG|550px|mini|center|Plot nur im Landscape]]
|}

Um die Plot und alle Steuerelemente im Portrait Modus auszublenden fügt man in seine eigene smallscreen.css wie [[#Allgemeines|hier beschrieben]] folgendes ein:
<pre>
@media all and (orientation:portrait) {
.SVGplot, .SVGlabel, .Zoom-in, .Zoom-out, .Prev { width: 0; display: none; }
}
</pre>

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]