FHEMWiki - Benutzerbeiträge [de]

ReadingsProxy

2015-09-20T06:49:40Z

Eppi: /* setExtensions für Geräte implementieren */

{{SEITENTITEL:readingsProxy}}
{{Infobox Modul
|ModPurpose=Aufsplitten von Mehrfachgeräten in einzelne FHEM-Devices
|ModType=h
|ModCmdRef=readingsProxy
|ModTechName=33_readingsProxy.pm
|ModForumArea=Automatisierung
|ModOwner=Andre ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])}}

Das Fhem-[[:Kategorie:Hilfsmodul|Hilfsmodul]] [[readingsProxy]] bietet die Möglichkeit, ein Reading oder einen Teil eines Readings eines Devices als eigenständiges Device (im Folgenden auch als ''Proxy Device'' bezeichnet) zu verwenden. Hiermit können z.B. Mehrfachsensoren und Aktoren (1-Wire 2- oder 8-fach Schalter, EnOcean Serienschalter, ...) in einzeln bedienbare Geräte aufgeteilt werden.

Sobald das Proxy Device ''on'' und ''off'' bereitstellt, stehen über die [http://fhem.de/commandref.html#setExtensions setExtentions] auch ''on-for-timer'', ''on-till'', ''blink'', usw. zur Verfügung.

== Voraussetzungen ==
Keine speziellen Voraussetzungen erforderlich.

== Anwendung ==

=== Definition ===
Die Syntax für die Definition eines Proxy Device: siehe commandref.

=== Attribute ===
Attribute mit spezieller Bedeutung für Proxy Devices:
;readingFnAttributes
:...
;getFn
:...
;setFn
:...
;valueFn
:...

== Anwendungsbeispiele ==
Achtung: Die Beispiele enthalten keine Maskierungen oder Verdoppelungen für {{Taste|;}} und ''Zeilenende'', sondern sind so angegeben, wie sie in [[FHEMWEB]] im Befehl-Eingabefeld oder nach Klick auf ''DEF'' eingegeben werden. Bei manuellem Einfügen in eine [[Konfiguration|Konfigurationsdatei]] sind diese Maskierungen oder Verdoppelungen natürlich vorzunehmen.

=== 1-Wire dual switch (DS2406) mit OWDevice als input (erster Kanal) ===
<pre style="width:500px;">
define myProxy readingsProxy myDS2406:latch.A
attr myProxy valueFn {($VALUE == 1)?"on":"off"}
</pre>

=== 1-Wire 8-fach switch (DS2408) mit OWSWITCH als Output (erster Kanal)===
<pre style="width:500px;">
define SchalterA readingsProxy OWX:xxx
attr SchalterA setFn {($CMD eq "on")?"output A off":"output A on"}
attr SchalterA setList on off
attr SchalterA valueFn {($VALUE == 0)?"off":"on"}
attr SchalterA webCmd on:off
</pre>

=== on/off vertauschen ===
<pre style="width:500px;">
define proxy readingsProxy meineLampe:state
attr proxy setFn {($CMD eq "on")?"off":"on"}
attr proxy valueFn {($VALUE eq "on")?"off":"on"}
</pre>

=== EnOcean Serienschalter ===
Siehe auch [[EnOcean Starter Guide#Aufteilung der Kanäle in unabhängige Devices|EnOcean Starter Guide]]
<pre style="width:500px;">
#Kanal A zur Steuerung mit on und off
define Schalter_channelA readingsProxy Schalter:state
attr Schalter_channelA setFn {($CMD eq "on")?"AI":"A0";;}
attr Schalter_channelA setList on off
attr Schalter_channelA valueFn {$LASTCMD}
attr Schalter_channelA webCmd on:off

#Kanal B zur Steuerung mit on und off
define Schalter_channelB readingsProxy Schalter:state
attr Schalter_channelB setFn {($CMD eq "on")?"BI":"B0";;}
attr Schalter_channelB setList on off
attr Schalter_channelB valueFn {$LASTCMD}
attr Schalter_channelB webCmd on:off
</pre>

=== setExtensions für Geräte implementieren ===
Wenn ein (Original-)Device von sich aus die [http://fhem.de/commandref.html#setExtensions setExtentions] nicht unterstützt, kann das durch Verwendung eines Proxy Device behoben/implementiert werden. Sobald ein Proxy Device ''on'' und ''off'' bereitstellt, stehen über die setExtensions auch ''on-for-timer'', ''on-till'', ''blink'', usw. zur Verfügung.

<pre style="width:500px;">
define STECKD_TEST readingsProxy STECKD_BAUHS:state
attr STECKD_TEST setFn {($CMD eq "on")?"angle 3874":"angle 3873";}
attr STECKD_TEST setList on off
attr STECKD_TEST valueFn {$LASTCMD}
</pre>

Beispiel aus diesem {{Link2Forum|Topic=22753|LinkText=Forenthread}} übernommen. (Anmerkung: Die im Forenthread noch verwendete Lösung über setFN mit "readingsSingleUpdate" sowie valueFn {} ist nach Einführung von $LASTCMD in readingsProxy nicht mehr notwendig. Dementsprechend wurde hier die neuere Variante mit $LASTCMD genutzt)

== Links ==
* Forenthema zur {{Link2Forum|Topic=16827|LinkText=Vorstellung des Moduls}}
* Forenthema zur Fragestellung "{{Link2Forum|Topic=16374|LinkText=DS2408 Ports aufsplitten}}"
* Forenthema zur Fragestellung "{{Link2Forum|Topic=13841|LinkText=Zwei Icons für Channel A und B}}"

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]

Trick der Woche

2015-02-01T09:20:05Z

Eppi:

Diese Seite enthält Tipps und Tricks, die zu unbedeutend sind, einen eigenen Artikel zu rechtfertigen, alternative Schreibweisen/Lösungen für eine Problem darstellen, Ungenauigkeiten oder unklare Formulierungen in den offiziellen Dokumenten ergänzen und ähnliches. Jeder Eintrag ist typischerweise sehr kurz (wenige Zeilen lang) und beleuchtet vielleicht nur einen Aspekt von Fhem, er kann allgemeiner Natur sein, oder sich auf ein spezielles Gerät oder einen speziellen Anwendungsfall beziehen. Dieser Artikel wendet sich eher an den Anfänger.
== Februar 2015 ==
=== fhem.cfg und fhem.state bei jedem "save" speichern ===
Der nachfolgende CodeSnippsel erstellt bei jedem "save" eine Kopie der aktuellen fhem.cfg und fhem.state in ein Verzeichnis "backup_cfg-state" welches unter /opt/fhem/ zufinden ist. Somit kann bei einem Fehler jederzeit auf den letzten Stand zurück gegangen werden.
Zuerst ins FHEM Befehlsfeld nach folgenden Code eingeben:
{ `mkdir backup_cfg-state` }

Danach folgenden nortify anlegen:
define backupCfg notify global:SAVE {\
my $now = TimeNow();; $now =~ s/ /_/g;; \
`cp $attr{global}{configfile} ./backup_cfg-state/fhem.cfg.$now`;;\
`cp $attr{global}{statefile} ./backup_cfg-state/fhem.state.$now`;;\
}
Viel Spass!
Quelle: [http://forum.fhem.de/index.php/topic,30873.msg234412.html#msg234412 FHEM-Forum]
== Januar 2015 ==
=== CUL & CO über Serial ID-einbinden ===
Bei mehreren USB-Geräten kann es vorkommen, dass sie vertauscht werden z.B. ''/dev/ttyUSB0'' zu'' /dev/ttyUSB1'' oder ''/dev/ttyACM0'' zu ''/dev/ttyACM1''.

Um dies zu umgehen, kann man sie über ihre Serial-ID in Fhem einbinden.

Dieser Befehl zeigt die Serial-ID:

:<code>ls -l /dev/serial/by-id</code>

Hier die Beispielausgabe eines CUL868, JeeLink, RFXtrx und eines CUL433

user@xxxx:~# ls -l /dev/serial/by-id
lrwxrwxrwx 1 root root 13 Jan 9 23:34 usb-busware.de_CUL868-if00 -> ../../ttyACM0
lrwxrwxrwx 1 root root 13 Jan 9 13:26 usb-FTDI_FT232R_USB_UART_A901RQ9F-if00-port0-> ../../ttyUSB0
lrwxrwxrwx 1 root root 13 Jan 9 13:26 usb-RFXCOM_RFXtrx433_A1WZWL5Y-if00-port0-> ../../ttyUSB1
lrwxrwxrwx 1 root root 13 Jan 9 21:29 usb-busware.de_CUL433-if00 -> ../../ttyACM1

Damit lässt sich folgende Definition erstellen:

z.B. für einen CUL868

:<code>define CUL868 CUL /dev/serial/by-id/usb-busware.de_CUL868-if00@9600 1134</code>

oder einen JeeLink

:<code>define Jeelink JeeLink /dev/serial/by-id/usb-FTDI_FT232R_USB_UART_A901RQ9F-if00-port0@57600</code>

'''Einschränkung:''' Bei CULs von Busware lassen sich nur CUL433 und CUL868 unterscheiden. Zwei CUL868 haben z.B. immer die gleiche Serial-ID.

=== HM LAN Konfig-Adapter Antenne verbessern===
Die Antenne des [[HM-CFG-LAN LAN Konfigurations-Adapter]] kann man mit etwas Bastelgeschick verlängern um den Empfang zu verbessern.

Sinnvoll ist die Verlängerung auf 1/2 Lambda (868MHz = 17,27 cm) oder gar 1 Lambda.
1 Lambda Antennen haben starke Richtwirkung in Form eines gedachten Zylinders, dessen Mittelachse die Antenne ist.
D.h., Alles was sich in Richtung des Anfangs und des Endes vom Antennedraht befindet, hat schlechteren Empfang als mit einer kurzen Antenne. Daher muss man die Antenne ggf. genauer ausrichten.

Anleitungen dazu werden an verschiedenen Stellen veröffentlicht, z.B. in
[http://www.ip-symcon.de/forum/threads/18411-Umbau-HM-LAN-Adapter-auf-Lambda-1-2-Dipol-Antenne diesem Beitrag] im IP-Symcon Forum (anders als der Namen der Anleitung vermuten lässt, liegt hier kein Dipol vor, sondern eine "normale" 1 Lambda Antenne.)

Prinzipiell so dünnen Draht wie möglich verwenden.

Wer noch mehr rausholen will, kann auch zusätzlichen Aufwand betreiben und die Antenne etwas von der Elektronik entfernen, die nämlich Störstrahlung in die Antenne einkoppelt. Oder eine Groundplane bauen.
Ein Anleitung für die CCU (analog auch für den HM LAN Konfig-Adapter einsetzbar) gibt es [http://www.techwriter.de/beispiel/funkeige.htm hier].

== Dezember 2014 ==
=== FHT80TF als "Prüfsender" einsetzen ===
Da der [[FHT80TF-2]] günstig ist und seinen Zustand ca. alle zwei Minuten sendet, kann er gut zum Ermitteln der Funklage von [[SlowRF]] Komponenten genutzt werden, auch wenn diese nicht senden. Den RSSI einer FS20 Schaltsteckdose kann man z.B. nicht wissen, da die Dose nur ein Empfänger ist. Wenn eine Dose nicht gut funktioniert und man den Verdacht hat, dass sie funktechnisch ungünstig liegt, kann man einen [[FHT80TF-2]] neben die Steckdose legen und man bekommt nach zwei Minuten einen Wert, der (trotz umgekehrter Funkrichtung) gut genug ist, um einem Hinweise zu geben.

== Oktober 2014 ==
=== Aktor für Wanddosen ohne Nulleiter ===
Zwar gibt es viele Aktoren, die man in Wanddosen hinter Schaltern einbauen kann, oft scheitert deren Nutzung aber daran, dass in vielen Elektroinstalltionen in der Wanddose eines (Licht)schalters kein Nulleiter verlegt ist, den die meisten Aktoren zur eigenen Stromversorgung brauchen. Hier kann der [[RSL 2-Draht Einbauschalter]] helfen, der auch ohne Nulleiter funktioniert und kompatibel zu InterTechno ist. Er lässt sich z.B. mit einem CUL(433) schalten.

== August 2014 ==
=== Perl-Skripte Online testen ===
Im Internet existieren Webseiten auf denen man Perl-Code online testen kann. Beispielsweise auf [http://www.compileonline.com/execute_perl_online.php compileonline.com] kann man Code zum Testen eingeben und die Auswirkungen betrachten. Dies eignet sich zur schnellen Fehleranalyse oder um Perl zu lernen. Natürlich lassen sich keine Fhem-Besonderheiten nutzen.

== Juli 2014 ==
=== Funklast reduzieren===
Bewegungsmelder erzeugen in der Regel eine recht hohe Funklast, wenn sie oft ausgelöst werden, also z.B. Licht in einem Zimmer schalten sollen.

Konstruktionen der Art:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* set Licht_Flur on-for-timer 256</code>
haben daher den Nachteil bei viel Bewegung im Flur und je nach Einstellung des Sendeabstandes des Bewegungsmelders mindestens alle 120 Sekunde oder öfter ein
:<code>on-for-timer 256</code>
zu senden. Das erzeugt eine hohe Funklast, speziell wenn der Aktor ein SlowRF Gerät ist (z.B. FS20 Unterputzschalter).
In solchen Fällen kann es helfen, nur dann einen Befehl zu senden, wenn das Licht nicht schon an ist:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* { if (Value("Licht_Flur") eq "off") { fhem ("set Licht_Flur1 on-for-timer 256") } }</code>
Nachteilig ist aber, dass eine Auslösung innerhalb 256 Sekunden die Einschaltzeit nicht verlängert. Dies kann man umgehen, indem man nicht on-for-timer verwendet, sondern den Aktor selber verzögert auschaltet und bei weiteren Auslösungen nur die Verzögerung erneut anlegt:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* { if (Value("Licht_Flur1") eq "off") { fhem ("set Licht_Flur on ;; define FlurLicht_aus at +00:04:16 set Licht_Flur off") } else { fhem ("delete FlurLicht_aus ;; define FlurLicht_aus at +00:04:16 set Licht_Flur off") }}</code>

== Juni 2014 ==
=== Batteriestatus bei HomeMatic Devices aktivieren===
Zumindest einige (wenn nicht alle) batteriegespeisten HM-Geräte können Batteriemeldungen senden, tun dies in der normalen Konfiguration aber nicht.
Dazu muss das Register cyclicInfoMsg auf on gesetzt werden.

Wie man das macht steht z.B. hier
[[HM-SEC-SC_Tür-Fensterkontakt#Batteriestatus_aktivieren]]
und hier
[[HomeMatic_Type_ThreeState]]

== Mai 2014 ==
=== Dummywert mit aktueller Uhrzeit versehen in anderen Dummy kopieren===
Der Inhalt von Dummy1 soll erweitert um Uhrzeit und Datum in Dummy2 kopiert werden (z.B. um die Urzeit der letzten Auslösung einer Alarmanlage anzuzeigen)
:<code>{ fhem("set dummy2 " . (Value("Dummy1")." ".TimeNow()) ) } </code>

=== Zwei Dummywerte in einen anderen Dummy kopieren ===
Der String in Dummy1 soll um den String in Dummy2 erweitert und nach Dummy3 kopiert werden:
:<code>{ fhem("set Dummy3 ".(Value("Dummy1")+Value("Dummy2"))) } </code>
(Achtung: "+" ist Zahlen addieren, "." ist String konkatenieren)

== April 2014==
=== Code sparen ===
Wer Definitionen wie die aus dem März zum [[Trick der Woche#Zuverlässigkeit von FS20 Schaltungen erhöhen|Abfangen von Fehlbedienungen]] verwendet, kann durch eine ELSE Erweiterung auch gleich das Auschalten erledigen.
:<code>define act_on_TV_on notify TV { if ("$EVENT" eq "on" || "$EVENT" eq "dimup") { fhem("set TV on") } else { fhem("set TV off") } }</code>

Hierdurch schaltet ON oder versehentlich zu langes Drücken (also DIMUP) den Fernseher ein, jeder ''andere'' Tastendruck (also insbesondere die OFF Taste oder zu langes Drücken der OFF Taste -> DIMDOWN) den Fernseher aus.

Voraussetzung ist, dass die Fernbedienung standardkonfiguriert ist, siehe auch nächster Tip.

=== Konfiguration eines FS20 Senders prüfen ===
Gelegentlich reagieren bestimmte notifys nicht, die von Sendern (Fernbedienungen, Sensoren oder Schaltern) ausgelöst werden sollen. Speziell bei FS20 aber auch bei HomeMatic kann das daran liegen, dass der Sender nicht sendet was man denkt. So gut wie alle FS20 Sender kennen nämlich nicht nur ON und OFF, sondern über ein Dutzend Schaltzustände. Dimmen ist einem noch hinreichend bewusst, es gibt aber auch exotische Dinge wie Ein-für-Zeitdauer, Ein-auf-alte-Helligkeit, Aus-für-Zeitdauer (nur FS20), Ein-für-Zeitdauer-dannach-alter-Zustand und vieles mehr.

Was also ein Infrarot-Bewegungsmelder bei Auslösung sendet und auch was eine Fernbedienungstaste sendet ist einstellbar. Wenn jetzt zum Beispiel an einer Fernbedienung auf Tastendruck nicht ON sondern Ein-für-Zeitdauer (ON-FOR-TIMER) gesendet wird, wird
:<code>define act_on_TV_on notify TV:on set TV on</code>
seltsamerweise nicht auslösen, obwohl die richtige Taste (und diese auch nicht zu lang) gedrückt wurde.

Auch wenn man sich sicher ist, das Richtige in die Fernbedienung/Sensoren einprogramiert zu haben, ist ein einfacher Test immer, dies mit
:<code>define act_on_TV notify TV set TV on</code>
zu prüfen. Dieses notify löst immer aus, wenn "TV" ''irgendetwas'' sendet, egal was. (Beachte: Man kann dann den Fernseher aber nicht mehr ausschalten, da auch die Austaste das notify auslöst und zum TV-Aktor nur "on" sendet). Geht die Schaltung jetzt (kann man den Fernseher also jetzt EINschalten), liegt der Verdacht nahe, dass die Konfiguration des Senders / Sensors anders ist, als man denkt. Das Logfile gibt Aufschluss, welcher Befehl tatsächlich empfangen wurde.

=== Alles in FHEM, nichts in der Fernbedienung ===
Versuche in deiner FHEM Umgebung nicht, das Verhalten von Aktoren durch entsprechende Befehle aus Sensoren oder Fernbedienungen zu steuern. An Besten senden die nur ON und OFF oder DIM, den Rest möglichst immer in FHEM erledigen.

Wer eine Lampe immer für vier Minuten einschalten will, programmiert seinen Schalter (Fernbedienung) also so, das nur "on" gesendet wird und erledigt den Rest in FHEM:
:<code>define act_on_Schalter notify Schalter set Lampe-on-for-timer 240</code>

== März 2014==
=== Zuverlässigkeit von FS20 Schaltungen erhöhen ===
FS20 Fernbedienungen senden bei Tastendrücken von mehr als 0,4 Sekunden anstatt ON bzw. OFF DIMUP bzw DIMDOWN.

Das führt gelegentlich zu allgemein schlechter Bedienbarkeit (und schlechtem WAF), da 0,4 Sekunden relativ kurz ist und gerne aus versehen länger gedrückt wird. Das ist vor allem problematisch, wenn etwas geschaltet werden soll, was keinen Dimmer hat oder Dimmen nicht unterstützt.

Eine Konfiguration wie
:<code>define act_on_TV_on notify TV:on set TV on</code>
hat also dann den Nachteil, dass bei versehentlich zu langem Tastendruck das TV nicht angeht. Da die meisten Nutzer unbewusst dazu neigen, bei Misserfolg die selbe Taste erneut aber länger zu drücken (was erneut keinen Erfolg zeigt) ist Frustration zu erwarten.

Es kann daher speziell bei nicht dimmbaren Aktoren von Vorteil sein, auch dimmen abzufangen, z.B. durch eine zweite zusätzliche Definition:

:<code>define act_on_TV_dimup notify TV:dimup set TV on</code>

Es ist in der Regel einfacher, einige dieser zusätzlichen Definitionen einzufügen, als allen Bedienern des Systems zu erklären, dass man keinesfalls länger als 0,4 Sekunden drücken darf.

Alternativ kann man auch beide Befehle in einer Definition durch Perlbefehle {} abfangen:

:<code>define act_on_TV_on notify TV { if ("$EVENT" eq "on" || "$EVENT" eq "dimup") { fhem("set TV on") }}</code>

Andere Möglichkeiten vergleiche: [[Trick der Woche#notify durch mehrere Ereignisse auslösen lassen|Notify durch mehrere Ereignisse auslösen lassen]]

== Februar 2014==
=== Sequence nutzen ===
Man kann Aktionen statt mit einem Tastedruck auch mit einer Sequenz von Tastendücken auslösen. Das Format des Befehle ist:

:<code>define <name> sequence <re1> <timeout1> <re2> [<timeout2> <re3> ...] </code>

wobei <re1> ...<re_n> die Aktionen sind und <timeout_n> der maximale Abstand der Tastendrücke in Sekunden.

Angenommen, man wolle z.B. eine Lampe dann anschalten, wenn man zuerst Taste1 EIN, dann Taste2 AUS und dann wieder Taste1 EIN einer Fernbedienung drückt, könnte das konkret so aussehen:

:<code>define MeineLampenSequenz1 sequence Btn1:on 0.5 Btn2:off 0.5 Btn1:on</code>

Zwischen jedem der Tastendrücke darf eine halbe Sekunde Abstand sein. Diese Definition selbst löst die Lampe nicht aus, sondern definiert nur wie die Sequenz aussehen soll. Um die Lampe bei erfolgreicher Betätigung der Sequenz auch einzuschalten, bedarf es zusätzlich etwas wie:

:<code>define MeineLampe notify MeineLampenSequenz1:trigger set Lampe on</code>

Sequence kann man gut nutzen, um mit einer Fernbedienung mehr Funktionen zu schalten als Tasten zur Verfügung stehen. Ebenso könnte man damit simple Codeschlösser für Alarmanlagen bauen, z.B. um eine Anlage auszuschalten, wenn eine bestimmte Abfolge von Tasten gedrückt wird.

Je nach Funksystem nimmt die Zuverlässigkeit aber rasch ab. Angenommen im Bereich FS20 (das System ist etwas unzuverlässiger ist als z.B. HomeMatic) seien 95% aller Funktsignale ungestört übertragbar, dann würden in der Praxis von 100 Tastendrücken an einer Fernbedienung 95x Erfolg zeigen und 5x fehlschlagen; das ist sicher tolerabel.

Bei einer Sequenzlänge von nur 4 Tasten würde die kombinierte Erfolgsquote der Sequenz jedoch nur noch ca. 80% sein, zum Ausschalten einer Alarmanlage vermutlich bereits unpraktisch.

== Januar 2014==
===isday===
Bekanntlich kann man mit "isday" leicht testen ob es draussen hell ist oder nicht. isday ist eine Funktion des (automatisch geladenen) 99_SUNRISE_EL.pm Moduls das auch sunset und sunrise enthält.

Problematisch bei isday ist die fehlende Möglichkeit, Sonnenaufgang und Untergang einzustellen (zumindest wenn man nicht 99_SUNRISE_EL.pm verändern will): isday ist wahr, wenn die Sonne im gegebenen Breitengrad sichtbar ist. Wenn örtliche Gegebenheiten eine Anpassung erfordern, kann man sich auch ein eigenes isday basteln, in dem man sunrise und sunset verwendet und dieses mit getrennten offsets versieht.

Zuerst definiert man sich eine Variable ("dummy") der anstelle isday eingesetzt werden soll, z.B.:

:<code>define Tageslicht dummy </code>

Dann wird diese mit sunset und sunrise befüllt:

define SetDummy1 at *{sunset(-3600)} set Tageslicht hell
define SetDummy2 at *{sunrise(+1800)} set Tageslicht dunkel

Jetzt kann für jeden Wechsel ein eigener Offset gewählt werden, im Beispiel 3600 Sekunden vor Sonnenuntergang und 1800 Sekunden nach Sonnenaufgang. Anstatt das Dummy "Tageslicht" mit den Werten "hell/dunkel" zu befüllen, kann natürlich auch 1/0 oder "Tag/Nacht" etc. verwendet werden, je nach dem was bei der Anwendung besser passt.

Für höhere Ansprüche könnte hingegen das Twiglight-Modul verwendet werden, das Dämmerungsstufen kennt.

===Struktur von "else if" Schleifen===
define ... notify ... {\
if ... {\
fhem ("... ;; ...")\
}\
elsif {\
if ... {\
fhem ("... ;; ...")\
}\
elsif {\
if ... {\
fhem ("... ;; ...")\
}\
else {\
if ... {\
fhem ("... ;; ...")\
}\
}}}}

Achtung: es muss tatsächlich "elsif" heissen und nicht "elseif" oder "else if"
Gilt für Perl Aufrufe.

== Dezember 2013==
===notify durch mehrere Ereignisse auslösen lassen===
Bekanntermassen löst

:<code>define irgendwas notify MeinSchalter …</code>

aus, wenn irgendein Ereignis vom Sender "MeinSchalter" eintrifft.

Mit

:<code>define irgendwas notify MeinSchalter:on …</code>

wird das notify jedoch nur ausgelöst, wenn dieses Ereignis eine "on" ist.
Wenn man aber möchte, das z.B. "on" und "off" auslöst (um etwa Dim-Befehle auszuschliessen) kann dies wie folgt erreicht werden:

:<code>define irgendwas notify MeinSchalter:(on|off) …</code>

Die Klammern sind wichtig, vergleiche eine Lösung, bei der zwei Sender alternativ das notify auslösen können:

:<code>define irgendwas notify MeinSchalter:on|MeinAndererSchalter:on …</code>

Selbstverständlich geht z.B. auch folgendes:

:<code>define irgendwas notify MeinSchalter:on|MeinAndererSchalter …</code>

Hier wird ausgelöst wenn "MeinSchalter" das Ereignis "on" liefert oder "MeinAndererSchalter" irgendein Ereignis

=== Aktoren über mehrere Funkschnittstellen ansprechen ===
Falls man mehrere Funkschnittstellen zur Reichweitenverlängerung hat (CUL / CUNO etc), und ein Aktor von beiden Funkschnittstellen in etwa gleich (schlecht) erreichbar ist, mag der Wunsch aufkommen, einen Funkbefehl über beide Schnittstellen auszusenden. Dies ist bei Funkprotokollen möglich, die kein echtes Pairing der Aktoren an die Funkschnittstelle erfordern, also z.B. FS20 oder Intertechno, nicht jedoch bei HomeMatic.

Problematisch ist aber, dass die Funkschnittstelle über IODev eindeutige je Aktor festgelegt werden muss, eine Zuordnung mehrerer IODevs ist nicht vorgesehen.
(wenn man IODev nicht setzt, wird per default die LETZTE definiert Schnittstelle verwendet)

Diess Problem kann mit einem Trick aber umgangen werden. Und zwar legt man den Aktor 2x mit gleicher Adresse aber abweichenden Namen und IOdevs an, z.B. so:

define brenner_CUL1 FS20 11114244 11
attr brenner_CUL1 IODev CUL1
attr brenner_CUL2 room Keller

define brenner_CUL2 FS20 11114244 11
attr brenner_CUL2 IODev CUL2
attr brenner_CUL2 room Keller

Ein Befehl der Art:

set brenner_CUL1,brenner_CUL2 on

sendet den ON Befehl für den FS20 Aktor 11114244 11 jetzt tatsächlich über beide CULs aus!

Achtung: Wenn die Schnittstellen gleichschnell angebunden sind, sollte vermutlich der [[Sendpool]] verwendet werden, da die Aussendungen sonst tatsächlich gleichzeitig erfolgen könnten und sich dann gegenseitig stören würden.

=== Retrycount bei FHTs ist überflüssig===
Das von der Funktion ''autocreate'' älterer FHEM Versionen beim Anlegen von FHT80 Heizungsreglern voreingetragene attribute "retrycount" hat in den allermeisten Fällen keine Wirkung, da es NUR greift, wenn man als Funkschnittstelle eine FHZ1X00PC verwendet und dann den Softbuffer einschaltet. Selbst wenn man diese Konfiguration nutzt, will gut überlegt werden, ob die Wirkung postiv ist: Bei ungenügender Empfangslage vergrössert es Kommunikationsprobleme eventuell sogar.

Es kann also in der Regel entfernt oder auf den Wert "1" gesetzt werden.

define Heizung_Bad FHT 060d
attr Heizung_Bad retrycount 3 <=== Diese Zeile entfernen

Siehe auch:[[Kommunikationsprobleme mit FHT]]

== November 2013 ==
=== FS20 Funksteckdose sicherer schalten===
Seltsamerweise kommt es vor, das FS20 Aktoren - insbesondere die FS20 Funksteckdose - an der Grenze der Funkreichweite bestimmte Befehle eines Typs empfängt, andere aber nicht. Z.B. lässt sich die FS20 Steckdose zwar immer einschalten, aber oft nicht mehr aus (oder umgekehrt).

Gelegentlich kann man die Zuverlässigkeit erhöhen, indem man statt dem nicht funktionierenden Befehl das Gegenteil mit "for-timer 1" verwendet.

Im Fall, dass eine FS20 Steckdose sich also einwandfrei EINschalten lässt:
:<code>set SteckdoseA on</code>
aber oft ein AUSschalten mittels
:<code>set SteckdoseA off</code>
nicht funktioniert, kann man versuchen die Dose anstelle mit "off" mit dem Befehl
:<code>set SteckdoseA on-for-timer 1</code>
auszuschalten.

Analog kann man mit off-for-timer arbeiten, wenn sich Aktoren nicht einschalten lassen, ausschalten aber geht.

Achtung: Dieser Trick funtioniert ausdrücklich nur, wenn der "on/off-for-timer" Befehl im Aktor selber abgebildet wird. Daher ist der Trick vermutlich nicht auf andere Funksysteme übertragbar.

=== Mehrere Geräte zugleich schalten===
Ein Ereignis soll mehrere Geräte schalten:

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1 on;;set Lampe2 on;;set FunksteckdoseA on</code>

Aus Übersichtlichkeitsgründen können vor und nach den Semikolons auch Leerzeichen eingefügt werden (obwohl in einigen Dokumentation behauptet wird, dies dürfe man nicht machen):

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1 on ;; set Lampe2 on ;; set FunksteckdoseA on</code>

Wenn der Schaltbefehl bei allen Geräten gleich ist, kann man wie folgt zusammenfassen:

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1,Lampe2,FunksteckdoseA on</code>

Das Komma wird nicht [[Escapen in Perlbefehlen|escaped]] (verdoppelt), hier darf tatsächlich KEIN Leerzeichen vor oder nach dem Komma eingefügt werden.

=== Logfileinträge unterdrücken===
Das Attribute "verbose 0" verhindert, dass das Gerät Logfileinträge erzeugt.

Beispiel:

define Funksteckdose FS20 22224222 01
attr Funksteckdose verbose 0

===FHT Lazy Mode benutzen===
Es gibt wenig Gründe, den FHT "Lazy Mode" nicht zu verwenden
define Heizung_Bad FHT 060d
attr Heizung_Bad lazy

Dieser sorgt dafür, dass Temperaturänderungen (genau genommen alle Änderungen, auch z.B. date) nur übertragen werden, wenn sie nicht sowieso schon am FHT eingestellt sind und veringern die Funklast dadurch deutlich.

Siehe auch: [[Kommunikationsprobleme mit FHT]]

== Oktober 2013 ==
=== Zuverlässigkeit von Wiedereinschalten erhöhen ===
Speziell bei FS20 Aktoren ist wegen des fehlenden Rückkanals nicht leicht erkennbar, ob ein Einschaltbefehl Wirkung gezeigt hat. Das hat ganz schlechten WAF, wenn man z.B. mit einem FS20 Aktor eine Heizung ausschaltet und das Wiedereinschalten nach z.B. einer Stunde nicht klappt.

Hier empfiehlt es sich, das Ausschalten mittels
:<code>set Heizungs_schalter off-for-timer 3584</code> (= fast eine Stunde)
zu erledigen. Da bei FS20 der off-for-timer Befehl im Aktor abgewickelt wird (und nicht durch FHEM), schaltet sich der Aktor auch dann garantiert wieder ein, wenn Fhem abstürzt, eine Funkstörung vorliegt oder ähnliches. Bei Bedarf kann der Befehl off-for-timer zur Verlängerung der Ausschaltzeit wiederholt werden. Dies kann z.B. nötig sein, wenn die Ausschaltung länger als 4,5 Stunden (15360 Sekunden, der Maximalwert des Timers) dauern soll.

Achtung: dieser Trick funktioniert nur, wenn der Aktor "off-for-timer" selbst beherrscht. FS20 Geräte können das, HomeMatic können aber nur "on-for-timer". Man kann off-for-timer mit HomeMatic trotzdem verwenden, aber in diesem Fall sendet Fhem den Einschaltbefehl nach der Timerzeit. InterTechno, RSL etc, können gar keinen Timer, hier sendet Fhem immer 2 Befehle im passenden Abstand.

=== FS20 Timerzeiten ===
FS20 Timer werden in Sekunden angegeben. Es sind jedoch nicht alle Werte einstellbar. Da der Timer Wert in 7 Bit übertragen werden muss, sind nur 128 Werte möglich. Um mit diesen Werten im unteren Bereich möglichst fein aufzulösen, andererseits aber auch lange Zeiten zu ermöglichen, ist die Verteilung nicht linear. Einstellbar sind folgende Zeiten in Sekunden;

0,25 0,5 0,75 1 1,25 1,5 1,75 2 2,25 2,5 2,75 3 3,25 3,5 3,75
4 4,5 5 5,5 6 6,5 7 7,5 8 9 10 11 12 13 14 15 16 18 20 22
24 26 28 30 32 36 40 44 48 52 56 60 64 72 80 88 96 104 112
120 128 144 160 176 192 208 224 240 256 288 320 352 384 416
448 480 512 576 640 704 768 832 896 960 1024 1152 1280 1408
1536 1664 1792 1920 2048 2304 2560 2816 3072 3328 3584 3840 4096
4608 5120 5632 6144 6656 7168 7680 8192 9216 10240 11264 12288
13312 14336 15360
(etwas übersichtlicher formatiert auch [[FS20 Allgemein#ON/OFF Befehle mit Time Parameter|hier]]).

Andere Zeiten werden von Fhem gerundet. Ein neues Setzen des Timer für FS20 löscht den alten Wert.

===Butterflecken in Wollpullovern===
Butterflecken in Wollpullovern können leicht durch grossflächiges Aufstreichen von Teer beseitigt werden.

Trick der Woche

2015-01-04T09:55:34Z

Eppi:

Diese Seite enthält Tipps und Tricks, die zu unbedeutend sind, einen eigenen Artikel zu rechtfertigen, alternative Schreibweisen/Lösungen für eine Problem darstellen, Ungenauigkeiten oder unklare Formulierungen in den offiziellen Dokumenten ergänzen und ähnliches. Jeder Eintrag ist typischerweise sehr kurz (wenige Zeilen lang) und beleuchtet vielleicht nur einen Aspekt von Fhem, er kann allgemeiner Natur sein, oder sich auf ein spezielles Gerät oder einen speziellen Anwendungsfall beziehen. Dieser Artikel wendet sich eher an den Anfänger.

== August 2014 ==
=== Perl-Skripte Online testen ===
Im Internet existieren Webseiten auf denen man Perl-Code online testen kann. Beispielsweise auf [http://www.compileonline.com/execute_perl_online.php www.compileonline.com] kann man Code zum Testen eingeben und die Auswirkungen betrachten. Dies eignet sich zur schnellen Fehleranalyse oder um Perl zu lernen. Natürlich lassen sich keine Fhem-Besonderheiten nutzen.

== Juli 2014 ==
=== Funklast reduzieren===
Bewegungsmelder erzeugen in der Regel eine recht hohe Funklast, wenn sie oft ausgelöst werden, also z.b. Licht in einem Zimmer schalten sollen.

Konstruktionen der Art:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* set Licht_Flur on-for-timer 256</code>
haben daher den Nachteil bei viel Bewegung im Flur und je nach Einstellung des Sendeabstandes des Bewegungsmelders mindestens alle 120 Sekunde oder öfter ein
:<code>on-for-timer 256</code>
zu senden. Das erzeugt eine hohe Funklast, speziell wenn der Aktor ein SlowRF Gerät ist (z.b. FS20 Unterputzschalter).
In solchen Fällen kann es helfen, nur dann einen Befehl zu senden, wenn das Licht nicht schon an ist:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* { if (Value("Licht_Flur") eq "off") { fhem ("set Licht_Flur1 on-for-timer 256") } }</code>
Nachteilig ist aber, dass eine Auslösung innerhalb 256 Sekunden die Einschaltzeit nicht verlängert. Dies kann man umgehen, indem man nicht on-for-timer verwendet, sondern den Aktor selber verzögert auschaltet und bei weiteren Auslösungen nur die Verzögerung erneut anlegt:
:<code>define FlurLicht notify Bewegungsmelder_Flur:motion:.* { if (Value("Licht_Flur1") eq "off") { fhem ("set Licht_Flur on ;; define FlurLicht_aus at +00:04:16 set Licht_Flur off") } else { fhem ("delete FlurLicht_aus ;; define FlurLicht_aus at +00:04:16 set Licht_Flur off") }}</code>

== Juni 2014 ==
=== Batteriestatus bei HomeMatic Devices aktivieren===
Zumindest einige (wenn nicht alle) batteriegespeisten HM-Geräte können Batteriemeldungen senden, tun dies in der normalen Konfiguration aber nicht.
Dazu muss das Register cyclicInfoMsg auf on gesetzt werden.

Wie man das macht steht z.b. hier
[[HM-SEC-SC_Tür-Fensterkontakt#Batteriestatus_aktivieren]]
und hier
[[HomeMatic_Type_ThreeState]]

== Mai 2014 ==
=== Dummywert mit aktueller Uhrzeit versehen in anderen Dummy kopieren===
Der Inhalt von Dummy1 soll erweitert um Uhrzeit und Datum in Dummy2 kopiert werden (z.b. um die Urzeit der letzten Auslösung einer Alarmanlage anzuzeigen)
:<code>{ fhem("set dummy2 " . (Value("Dummy1")." ".TimeNow()) ) } </code>

=== Zwei Dummywerte in einen anderen Dummy kopieren ===
Der String in Dummy1 soll um den String in Dummy2 erweitert und nach Dummy3 kopiert werden:
:<code>{ fhem("set Dummy3 ".(Value("Dummy1")+Value("Dummy2"))) } </code>
(Achtung: "+" ist Zahlen addieren, "." ist String konkatenieren)

== April 2014==
=== Code sparen ===
Wer Definitionen wie die aus dem März zum [[Trick der Woche#Zuverlässigkeit von FS20 Schaltungen erhöhen|Abfangen von Fehlbedienungen]] verwendet, kann durch eine ELSE Erweiterung auch gleich das Auschalten erledigen.
:<code>define act_on_TV_on notify TV { if ("$EVENT" eq "on" || "$EVENT" eq "dimup") { fhem("set TV on") } else { fhem("set TV off") } }</code>

Hierdurch schaltet ON oder versehentlich zu langes Drücken (also DIMUP) den Fernseher ein, jeder ''andere'' Tastendruck (also insbesondere die OFF Taste oder zu langes Drücken der OFF Taste -> DIMDOWN) den Fernseher aus.

Voraussetzung ist, dass die Fernbedienung standardkonfiguriert ist, siehe auch nächster Tip.

=== Konfiguration eines FS20 Senders prüfen ===
Gelegentlich reagieren bestimmte notifys nicht, die von Sendern (Fernbedienungen, Sensoren oder Schaltern) ausgelöst werden sollen. Speziell bei FS20 aber auch bei HomeMatic kann das daran liegen, dass der Sender nicht sendet was man denkt. So gut wie alle FS20 Sender kennen nämlich nicht nur ON und OFF, sondern über ein Dutzend Schaltzustände. Dimmen ist einem noch hinreichend bewusst, es gibt aber auch exotische Dinge wie Ein-für-Zeitdauer, Ein-auf-alte-Helligkeit, Aus-für-Zeitdauer (nur FS20), Ein-für-Zeitdauer-dannach-alter-Zustand und vieles mehr.

Was also ein Infrarot-Bewegungsmelder bei Auslösung sendet und auch was eine Fernbedienungstaste sendet ist einstellbar. Wenn jetzt zum Beispiel an einer Fernbedienung auf Tastendruck nicht ON sondern Ein-für-Zeitdauer (ON-FOR-TIMER) gesendet wird, wird
:<code>define act_on_TV_on notify TV:on set TV on</code>
seltsamerweise nicht auslösen, obwohl die richtige Taste (und diese auch nicht zu lang) gedrückt wurde.

Auch wenn man sich sicher ist, das Richtige in die Fernbedienung/Sensoren einprogramiert zu haben, ist ein einfacher Test immer, dies mit
:<code>define act_on_TV notify TV set TV on</code>
zu prüfen. Dieses notify löst immer aus, wenn "TV" ''irgendetwas'' sendet, egal was. (Beachte: Man kann dann den Fernseher aber nicht mehr ausschalten, da auch die Austaste das notify auslöst und zum TV-Aktor nur "on" sendet). Geht die Schaltung jetzt (kann man den Fernseher also jetzt EINschalten), liegt der Verdacht nahe, dass die Konfiguration des Senders / Sensors anders ist, als man denkt. Das Logfile gibt Aufschluss, welcher Befehl tatsächlich empfangen wurde.

=== Alles in FHEM, nichts in der Fernbedienung ===
Versuche in deiner FHEM Umgebung nicht, das Verhalten von Aktoren durch entsprechende Befehle aus Sensoren oder Fernbedienungen zu steuern. An Besten senden die nur ON und OFF oder DIM, den Rest möglichst immer in FHEM erledigen.

Wer eine Lampe immer für vier Minuten einschalten will, programmiert seinen Schalter (Fernbedienung) also so, das nur "on" gesendet wird und erledigt den Rest in FHEM:
:<code>define act_on_Schalter notify Schalter set Lampe-on-for-timer 240</code>

== März 2014==
=== Zuverlässigkeit von FS20 Schaltungen erhöhen ===
FS20 Fernbedienungen senden bei Tastendrücken von mehr als 0,4 Sekunden anstatt ON bzw. OFF DIMUP bzw DIMDOWN.

Das führt gelegentlich zu allgemein schlechter Bedienbarkeit (und schlechtem WAF), da 0,4 Sekunden relativ kurz ist und gerne aus versehen länger gedrückt wird. Das ist vor allem problematisch, wenn etwas geschaltet werden soll, was keinen Dimmer hat oder Dimmen nicht unterstützt.

Eine Konfiguration wie
:<code>define act_on_TV_on notify TV:on set TV on</code>
hat also dann den Nachteil, dass bei versehentlich zu langem Tastendruck das TV nicht angeht. Da die meisten Nutzer unbewusst dazu neigen, bei Misserfolg die selbe Taste erneut aber länger zu drücken (was erneut keinen Erfolg zeigt) ist Frustration zu erwarten.

Es kann daher speziell bei nicht dimmbaren Aktoren von Vorteil sein, auch dimmen abzufangen, z.b. durch eine zweite zusätzliche Definition:

:<code>define act_on_TV_dimup notify TV:dimup set TV on</code>

Es ist in der Regel einfacher, einige dieser zusätzlichen Definitionen einzufügen, als allen Bedienern des Systems zu erklären, dass man keinesfalls länger als 0,4 Sekunden drücken darf.

Alternativ kann man auch beide Befehle in einer Definition durch Perlbefehle {} abfangen:

:<code>define act_on_TV_on notify TV { if ("$EVENT" eq "on" || "$EVENT" eq "dimup") { fhem("set TV on") }}</code>

Andere Möglichkeiten vergleiche: [[Trick der Woche#notify durch mehrere Ereignisse auslösen lassen|Notify durch mehrere Ereignisse auslösen lassen]]

== Februar 2014==
=== Sequence nutzen ===
Man kann Aktionen statt mit einem Tastedruck auch mit einer Sequenz von Tastendücken auslösen. Das Format des Befehle ist:

:<code>define <name> sequence <re1> <timeout1> <re2> [<timeout2> <re3> ...] </code>

wobei <re1> ...<re_n> die Aktionen sind und <timeout_n> der maximale Abstand der Tastendrücke in Sekunden.

Angenommen, man wolle z.B. eine Lampe dann anschalten, wenn man zuerst Taste1 EIN, dann Taste2 AUS und dann wieder Taste1 EIN einer Fernbedienung drückt, könnte das konkret so aussehen:

:<code>define MeineLampenSequenz1 sequence Btn1:on 0.5 Btn2:off 0.5 Btn1:on</code>

Zwischen jedem der Tastendrücke darf eine halbe Sekunde Abstand sein. Diese Definition selbst löst die Lampe nicht aus, sondern definiert nur wie die Sequenz aussehen soll. Um die Lampe bei erfolgreicher Betätigung der Sequenz auch einzuschalten, bedarf es zusätzlich etwas wie:

:<code>define MeineLampe notify MeineLampenSequenz1:trigger set Lampe on</code>

Sequence kann man gut nutzen, um mit einer Fernbedienung mehr Funktionen zu schalten als Tasten zur Verfügung stehen. Ebenso könnte man damit simple Codeschlösser für Alarmanlagen bauen, z.b. um eine Anlage auszuschalten, wenn eine bestimmte Abfolge von Tasten gedrückt wird.

Je nach Funksystem nimmt die Zuverlässigkeit aber rasch ab. Angenommen im Bereich FS20 (das System ist etwas unzuverlässiger ist als z.b. HomeMatic) seien 95% aller Funktsignale ungestört übertragbar, dann würden in der Praxis von 100 Tastendrücken an einer Fernbedienung 95x Erfolg zeigen und 5x fehlschlagen; das ist sicher tolerabel.

Bei einer Sequenzlänge von nur 4 Tasten würde die kombinierte Erfolgsquote der Sequenz jedoch nur noch ca. 80% sein, zum Ausschalten einer Alarmanlage vermutlich bereits unpraktisch.

== Januar 2014==
===isday===
Bekanntlich kann man mit "isday" leicht testen ob es draussen hell ist oder nicht. isday ist eine Funktion des (automatisch geladenen) 99_SUNRISE_EL.pm Moduls das auch sunset und sunrise enthält.

Problematisch bei isday ist die fehlende Möglichkeit, Sonnenaufgang und Untergang einzustellen (zumindest wenn man nicht 99_SUNRISE_EL.pm verändern will): isday ist wahr, wenn die Sonne im gegebenen Breitengrad sichtbar ist. Wenn örtliche Gegebenheiten eine Anpassung erfordern, kann man sich auch ein eigenes isday basteln, in dem man sunrise und sunset verwendet und dieses mit getrennten offsets versieht.

Zuerst definiert man sich eine Variable ("dummy") der anstelle isday eingesetzt werden soll, z.b.:

:<code>define Tageslicht dummy </code>

Dann wird diese mit sunset und sunrise befüllt:

define SetDummy1 at *{sunset(-3600)} set Tageslicht hell
define SetDummy2 at *{sunrise(+1800)} set Tageslicht dunkel

Jetzt kann für jeden Wechsel ein eigener Offset gewählt werden, im Beispiel 3600 Sekunden vor Sonnenuntergang und 1800 Sekunden nach Sonnenaufgang. Anstatt das Dummy "Tageslicht" mit den Werten "hell/dunkel" zu befüllen, kann natürlich auch 1/0 oder "Tag/Nacht" etc. verwendet werden, je nach dem was bei der Anwendung besser passt.

Für höhere Ansprüche könnte hingegen das Twiglight-Modul verwendet werden, das Dämmerungsstufen kennt.

===Struktur von "else if" Schleifen===
define ... notify ... {\
if ... {\
fhem ("... ;; ...")\
}\
elsif {\
if ... {\
fhem ("... ;; ...")\
}\
elsif {\
if ... {\
fhem ("... ;; ...")\
}\
else {\
if ... {\
fhem ("... ;; ...")\
}\
}}}}

Achtung: es muss tatsächlich "elsif" heissen und nicht "elseif" oder "else if"

== Dezember 2013==
===notify durch mehrere Ereignisse auslösen lassen===
Bekanntermassen löst

:<code>define irgendwas notify MeinSchalter …</code>

aus, wenn irgendein Ereignis vom Sender "MeinSchalter" eintrifft.

Mit

:<code>define irgendwas notify MeinSchalter:on …</code>

wird das notify jedoch nur ausgelöst, wenn dieses Ereignis eine "on" ist.
Wenn man aber möchte, das z.B. "on" und "off" auslöst (um etwa Dim-Befehle auszuschliessen) kann dies wie folgt erreicht werden:

:<code>define irgendwas notify MeinSchalter:(on|off) …</code>

Die Klammern sind wichtig, vergleiche eine Lösung, bei der zwei Sender alternativ das notify auslösen können:

:<code>define irgendwas notify MeinSchalter:on|MeinAndererSchalter:on …<code>

Selbstverständlich geht z.B. auch folgendes:

:<code>define irgendwas notify MeinSchalter:on|MeinAndererSchalter …</code>

Hier wird ausgelöst wenn "MeinSchalter" das Ereignis "on" liefert oder "MeinAndererSchalter" irgendein Ereignis

=== Aktoren über mehrere Funkschnittstellen ansprechen ===
Falls man mehrere Funkschnittstellen zur Reichweitenverlängerung hat (CUL / CUNO etc), und ein Aktor von beiden Funkschnittstellen in etwa gleich (schlecht) erreichbar ist, mag der Wunsch aufkommen, einen Funkbefehl über beide Schnittstellen auszusenden. Dies ist bei Funkprotokollen möglich, die kein echtes Pairing der Aktoren an die Funkschnittstelle erfordern, also z.b. FS20 oder Intertechno, nicht jedoch bei HomeMatic.

Problematisch ist aber, dass die Funkschnittstelle über IODev eindeutige je Aktor festgelegt werden muss, eine Zuordnung mehrerer IODevs ist nicht vorgesehen.
(wenn man IODev nicht setzt, wird per default die LETZTE definiert Schnittstelle verwendet)

Diess Problem kann mit einem Trick aber umgangen werden. Und zwar legt man den Aktor 2x mit gleicher Adresse aber abweichenden Namen und IOdevs an, z.b. so:

define brenner_CUL1 FS20 11114244 11
attr brenner_CUL1 IODev CUL1
attr brenner_CUL2 room Keller

define brenner_CUL2 FS20 11114244 11
attr brenner_CUL2 IODev CUL2
attr brenner_CUL2 room Keller

Ein Befehl der Art:

set brenner_CUL1,brenner_CUL2 on

sendet den ON Befehl für den FS20 Aktor 11114244 11 jetzt tatsächlich über beide CULs aus!

Achtung: Wenn die Schnittstellen gleichschnell angebunden sind, sollte vermutlich der [[Sendpool]] verwendet werden, da die Aussendungen sonst tatsächlich gleichzeitig erfolgen könnten und sich dann gegenseitig stören würden.

=== Retrycount bei FHTs ist überflüssig===
Das von der Funktion ''autocreate'' älterer FHEM Versionen beim Anlegen von FHT80 Heizungsreglern voreingetragene attribute "retrycount" hat in den allermeisten Fällen keine Wirkung, da es NUR greift, wenn man als Funkschnittstelle eine FHZ1X00PC verwendet und dann den Softbuffer einschaltet. Selbst wenn man diese Konfiguration nutzt, will gut überlegt werden, ob die Wirkung postiv ist: Bei ungenügender Empfangslage vergrössert es Kommunikationsprobleme eventuell sogar.

Es kann also in der Regel entfernt oder auf den Wert "1" gesetzt werden.

define Heizung_Bad FHT 060d
attr Heizung_Bad retrycount 3 <=== Diese Zeile entfernen

Siehe auch:[[Kommunikationsprobleme mit FHT]]

== November 2013 ==
=== FS20 Funksteckdose sicherer schalten===
Seltsamerweise kommt es vor, das FS20 Aktoren - insbesondere die FS20 Funksteckdose - an der Grenze der Funkreichweite bestimmte Befehle eines Typs empfängt, andere aber nicht. Z.B. lässt sich die FS20 Steckdose zwar immer einschalten, aber oft nicht mehr aus (oder umgekehrt).

Gelegentlich kann man die Zuverlässigkeit erhöhen, indem man statt dem nicht funktionierenden Befehl das Gegenteil mit "for-timer 1" verwendet.

Im Fall, dass eine FS20 Steckdose sich also einwandfrei EINschalten lässt:
:<code>set SteckdoseA on</code>
aber oft ein AUSschalten mittels
:<code>set SteckdoseA off</code>
nicht funktioniert, kann man versuchen die Dose anstelle mit "off" mit dem Befehl
:<code>set SteckdoseA on-for-timer 1</code>
auszuschalten.

Analog kann man mit off-for-timer arbeiten, wenn sich Aktoren nicht einschalten lassen, ausschalten aber geht.

Achtung: Dieser Trick funtioniert ausdrücklich nur, wenn der "on/off-for-timer" Befehl im Aktor selber abgebildet wird. Daher ist der Trick vermutlich nicht auf andere Funksysteme übertragbar.

=== Mehrere Geräte zugleich schalten===
Ein Ereignis soll mehrere Geräte schalten:

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1 on;;set Lampe2 on;;set FunksteckdoseA on</code>

Aus Übersichtlichkeitsgründen können vor und nach den Semikolons auch Leerzeichen eingefügt werden (obwohl in einigen Dokumentation behauptet wird, dies dürfe man nicht machen):

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1 on ;; set Lampe2 on ;; set FunksteckdoseA on</code>

Wenn der Schaltbefehl bei allen Geräten gleich ist, kann man wie folgt zusammenfassen:

:<code>define act_on_Bewegungsmelder notify Bewegungsmelder set Lampe1,Lampe2,FunksteckdoseA on</code>

Das Komma wird nicht [[Escapen in Perlbefehlen|escaped]] (verdoppelt), hier darf tatsächlich KEIN Leerzeichen vor oder nach dem Komma eingefügt werden.

=== Logfileinträge unterdrücken===
Das Attribute "verbose 0" verhindert, dass das Gerät Logfileinträge erzeugt.

Beispiel:

define Funksteckdose FS20 22224222 01
attr Funksteckdose verbose 0

===FHT Lazy Mode benutzen===
Es gibt wenig Gründe, den FHT "Lazy Mode" nicht zu verwenden
define Heizung_Bad FHT 060d
attr Heizung_Bad lazy

Dieser sorgt dafür, dass Temperaturänderungen (genau genommen alle Änderungen, auch z.B. date) nur übertragen werden, wenn sie nicht sowieso schon am FHT eingestellt sind und veringern die Funklast dadurch deutlich.

Siehe auch: [[Kommunikationsprobleme mit FHT]]

== Oktober 2013 ==
=== Zuverlässigkeit von Wiedereinschalten erhöhen ===
Speziell bei FS20 Aktoren ist wegen des fehlenden Rückkanals nicht leicht erkennbar, ob ein Einschaltbefehl Wirkung gezeigt hat. Das hat ganz schlechten WAF, wenn man z.B. mit einem FS20 Aktor eine Heizung ausschaltet und das Wiedereinschalten nach z.B. einer Stunde nicht klappt.

Hier empfiehlt es sich, das Ausschalten mittels
:<code>set Heizungs_schalter off-for-timer 3584</code> (= fast eine Stunde)
zu erledigen. Da bei FS20 der off-for-timer Befehl im Aktor abgewickelt wird (und nicht durch FHEM), schaltet sich der Aktor auch dann garantiert wieder ein, wenn Fhem abstürzt, eine Funkstörung vorliegt oder ähnliches. Bei Bedarf kann der Befehl off-for-timer zur Verlängerung der Ausschaltzeit wiederholt werden. Dies kann z.B. nötig sein, wenn die Ausschaltung länger als 4,5 Stunden (15360 Sekunden, der Maximalwert des Timers) dauern soll.

Achtung: dieser Trick funktioniert nur, wenn der Aktor "off-for-timer" selbst beherrscht. FS20 Geräte können das, HomeMatic können aber nur "on-for-timer". Man kann off-for-timer mit HomeMatic trotzdem verwenden, aber in diesem Fall sendet Fhem den Einschaltbefehl nach der Timerzeit. InterTechno, RSL etc, können gar keinen Timer, hier sendet Fhem immer 2 Befehle im passenden Abstand.

=== FS20 Timerzeiten ===
FS20 Timer werden in Sekunden angegeben. Es sind jedoch nicht alle Werte einstellbar. Da der Timer Wert in 7 Bit übertragen werden muss, sind nur 128 Werte möglich. Um mit diesen Werten im unteren Bereich möglichst fein aufzulösen, andererseits aber auch lange Zeiten zu ermöglichen, ist die Verteilung nicht linear. Einstellbar sind folgende Zeiten in Sekunden;

0,25 0,5 0,75 1 1,25 1,5 1,75 2 2,25 2,5 2,75 3 3,25 3,5 3,75
4 4,5 5 5,5 6 6,5 7 7,5 8 9 10 11 12 13 14 15 16 18 20 22
24 26 28 30 32 36 40 44 48 52 56 60 64 72 80 88 96 104 112
120 128 144 160 176 192 208 224 240 256 288 320 352 384 416
448 480 512 576 640 704 768 832 896 960 1024 1152 1280 1408
1536 1664 1792 1920 2048 2304 2560 2816 3072 3328 3584 3840 4096
4608 5120 5632 6144 6656 7168 7680 8192 9216 10240 11264 12288
13312 14336 15360
(etwas übersichtlicher formatiert auch [[FS20 Allgemein#ON/OFF Befehle mit Time Parameter|hier]]).

Andere Zeiten werden von Fhem gerundet. Ein neues Setzen des Timer für FS20 löscht den alten Wert.

===Butterflecken in Wollpullovern===
Butterflecken in Wollpullovern können leicht durch grossflächiges Aufstreichen von Teer beseitigt werden.

SONOS

2014-03-26T17:33:18Z

Eppi: /* Hinweis für Debian-Systeme */

Dieses Anwendungsbeispiel soll den Einstieg in die Steuerung der heimischen Zoneplayer der Firma [http://www.sonos.com Sonos] erleichtern. Es werden die Verwendung und Einrichtung der dazugehörenden 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; border: 1px solid #dfdfdf; padding: 0 1em 1em 1em; background-color:#fff0e0;">
<center>'''! Achtung !'''</center>
Diese Module sind '''nicht''' im offiziellen Release von FHEM enthalten. Sie müssen mittels des Thirdparty-Updatemechanismus nachinstalliert werden.
Dabei sind trotzdem die Vorbedingungen bzgl. der Perl-Installation einzuhalten, da diese Update-Installation nur im Rahmen von FHEM erfolgt.
</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
*Steuern der ZonePlayer: Play, Pause, Nächster Titel, Vorheriger Titel, Lautstärke Lauter/Leiser (auch als Rampe), Stummschalten
*Alle Player auf einen Befehl hin stoppen oder pausieren lassen
*Einstellen und Abfragen der Abspielparameter Repeat, Shuffle, CrossfadeMode, Loudness, Bass und Treble
*Festlegen einer minimalen und maximalen Lautstärke für jeden ZonePlayer (getrennt zwischen Normalbetrieb und Kopfhörernutzung)
*Laden und Speichern von Playlisten (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
*Erzeugen und temporäres Abspielen von Sprachdurchsagen auf Basis von eingegebenen Texten
**Wird standardmäßig über die Google-Übersetzungsmaschine realisiert
**Kann auch über eine eigenständige, lokale Installation realisiert werden
*Auslesen der verfügbaren gespeicherten Playlisten und Radiofavoriten
*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
*Erzeugen von Events nach festgelegten Tastensequenzen (am Player)
*Umbenennen der Zonen und festlegen der Zonenicons

=== 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 Player nach den Zonennamen und der jeweiligen Funktion des Players innerhalb der Paarungs-Zone.

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

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.

== 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 Sonos SONOS localhost:4711 30</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.

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:
<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 InfoSummarize2
attr Sonos_Wohnzimmer webCmd Play:Pause:Previous:Next:VolumeD:VolumeU:MuteT
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

Des Weiteren wird automatisch ein Weblink mit angelegt:
<pre>
define AlbumArt_Wohnzimmer weblink image fhem/icons/SONOSPLAYER/Sonos_Wohnzimmer_AlbumArt
attr AlbumArt_Wohnzimmer room Sonos
attr AlbumArt_Wohnzimmer htmlattr width="200"
attr AlbumArt_Wohnzimmer group Wohnzimmer
</pre>

Damit wird in der Raumansicht direkt über dem SonosPlayer-Device das Cover des aktuellen Titels angezeigt.

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

== Hardwarevoraussetzungen ==
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
*Raspberry Pi, Default-Perl

Problematische Kombinationen:
*FritzBox: Anscheinend ist Perl dort ohne Thread-Möglichkeit kompiliert. Diese sind aber essentiell notwendig für dieses Modul.

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

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

=== 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</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>
*Folgende Zeilen 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, kann vielleicht folgendes helfen:
**Sicherstellen, daß in der ''Global''-Sektion der Parameter ''Security'' auf ''Share'' steht (oder gar nicht erst definiert wurde):
<pre>
[global]
security = share
</pre>
*Samba-Server neustarten: <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. 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. 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 ===
Um dieses Modul über den Update-Mechanismus von FHEM zu installieren, muss folgender Befehl im Eingabefeld (oder auf der Telnet-Konsole) eingegeben werden:
<pre>update thirdparty http://fhem.lmsoft.de/sonos sonos</pre>

Für einen Vorabcheck, was installiert werden würde, kann man folgendes eingeben:
<pre>update thirdparty http://fhem.lmsoft.de/sonos sonos check</pre>

Wenn die Perl-Installation korrekt erweitert wurde, bzw. bereits erweitert war, sollte das Modul nach einem Neustart zur Verfügung stehen.

==== Living on the bleeding edge ====
Da ich vor einem Releasetermin natürlich einiges entwickelt habe, und dies natürlich auch selber teste, habe ich dafür einen Development-Server eingerichtet.
Dieser kann u.U. sinnvollerweise auch von anderen als Installationsquelle verwendet werden, da er aktuelle Fehlerbereinigungen oder neue Features und Konzepte enthält, die man gerne vorab sehen möchte.

'''Achtung''':
Diese Version muss nicht immer und zwangsläufig besser sein! ich gebe mir Mühe, bin aber auch nur ein Mensch :-)

Folgendes muss für die Installation eingegeben werden:
<pre>update thirdparty http://fhem.lmsoft.de/sonos_dev sonos</pre>

=== Manuelle Installation ===
Dieser Part ist nur solange interessant, wie das Modul (noch) nicht offiziell ist.

Für den Betrieb ist das Modul [http://perlupnp.sourceforge.net/ PerlUPnP] notwendig.

Folgende Dateien sind nötig:
*00_SONOS.pm
*21_SONOSPLAYER.pm
*2 Dateien der PerlUPnP-Library
*Dateien für MP3-Tags bei der Sprachausgabe (Wenn nicht vorhanden, fehlt nur die Funktionalität, das Modul sollte aber dennoch lauffähig sein)
*Die unter ''Softwarevoraussetzungen'' genannten Perlmodule

Die beiden SONOS-Perlmodule müssen einfach in das Verzeichnis <code>FHEM</code> kopiert werden (wie alle anderen FHEM-Module auch).

Die PerlUPnP-Library muss komplett in das Verzeichnis <code>FHEM/lib/</code> abgelegt werden. Dabei muss das Verzeichnis <code>UPnP</code> genannt werden.
Es werden für den Betrieb nicht alle Dateien des Standard-Pakets benötigt, sondern nur zwei .pm Dateien. 
Die resultierende Ordnerstruktur (inkl. Dateien von PerlUPnP) lautet dann wie folgt:
*FHEM/lib
*FHEM/lib/UPnP
*FHEM/lib/UPnP/Common.pm
*FHEM/lib/UPnP/ControlPoint.pm

Die Dateien für die MP3-Tags müssen ebenfalls in das Verzeichnis <code>lib</code> kopiert werden. Diese wird nur bei manchen Dateien für die Zwischendurchsage benötigt, da Sonos nicht immer eine Laufzeit mitliefert, bzw. für die generierten Sprachdurchsagen, da dort die Informationen für die Anzeige im ZonePlayer gesetzt werden. Die Laufzeit z.B. wird für die Pausenberechnung aber gebraucht, und muss dementsprechend auf anderem Wege ermittelt werden. 
Die resultierende Ordnerstruktur lautet dann wie folgt:
*FHEM/lib/
*FHEM/lib/MP3
*FHEM/lib/MP3/Tag.pm
*FHEM/lib/MP3/Info.pm
*FHEM/lib/MP3/Tag
*FHEM/lib/MP3/Tag/File.pm
*FHEM/lib/MP3/Tag/LastResort.pm
*FHEM/lib/MP3/Tag/ImageExifTool.pm
*FHEM/lib/MP3/Tag/CDDB_File.pm
*FHEM/lib/MP3/Tag/ID3v2_Data.pod
*FHEM/lib/MP3/Tag/ImageSize.pm
*FHEM/lib/MP3/Tag/ID3v1.pm
*FHEM/lib/MP3/Tag/ParseData.pm
*FHEM/lib/MP3/Tag/Cue.pm
*FHEM/lib/MP3/Tag/ID3v2.pm
*FHEM/lib/MP3/Tag/Inf.pm
*FHEM/lib/Normalize
*FHEM/lib/Normalize/Text
*FHEM/lib/Normalize/Text/Music_Fields.pm
*FHEM/lib/Normalize/Text/Music_Fields
*FHEM/lib/Normalize/Text/Music_Fields/Music_Fields-rus.lst
*FHEM/lib/Normalize/Text/Music_Fields/G_Gershwin.comp
*FHEM/lib/Normalize/Text/Music_Fields/A_Dvor_k.comp
*FHEM/lib/Normalize/Text/Music_Fields/J_Brahms.comp
*FHEM/lib/Normalize/Text/Music_Fields/L_van_Beethoven.comp
*FHEM/lib/Normalize/Text/Music_Fields/A_Schnittke.comp
*FHEM/lib/Normalize/Text/Music_Fields/D_Shostakovich.comp
*FHEM/lib/Encode
*FHEM/lib/Encode/transliterate_win1251.pm

Nach einem Neustart von FHEM kann das Modul wie beschrieben verwendet werden.

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

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.

*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).
*Wenn man das Problem hat, daß 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. 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. 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). 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 empfehlenswert, daß 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).

=== Changelog ===
*2.5 (07.03.2014):
**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 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'.
*2.4 (31.12.2013):
**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
*2.3 (2.12.2013):
**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
*2.2 (12.10.2013):
**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
*2.1:
**Neuen Befehl 'CurrentPlaylist' eingeführt
*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
*1.13:
**Neuer Abspielzustand 'TRANSITIONING' wird berücksichtigt
**Der Aufruf von 'GetDeviceDefHash' wird nun mit dem Parameter 'undef' anstatt ohne einen Parameter durchgeführt
*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)
*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)
*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
*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
*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.
*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.
*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)
*1.5:
**PlayURI, PlayURITemp und AddURIToQueue hinzugefügt (siehe Doku im Wiki)
*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
*1.3:
**StopHandling prüft nun auch, ob die Referenz noch existiert
*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.
*1.1:
**Ping-Methode einstellbar über Attribut 'pingType'
*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. 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>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.
*<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>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.

=== Attribute von SONOS ===
*<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>targetSpeakDir</code>: Das Verzeichnis, in dem dieses Modul die Sprachdateien von <code>Speak</code> (siehe [http://www.fhemwiki.de/wiki/Sonos_Anwendungsbeispiel#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. 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). z.B. <code>\\192.168.178.45\Sonos</code>
*<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). 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. 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. Das Format ist: <Ausgabedateiendung>:<Befehlszeile>
**Es dürfen folgende Platzhalter verwendet werden: '''%language%''': Wird durch die eingegebene Sprache ersetzt '''%filename%''': Wird durch den kompletten Dateinamen (inkl. Dateiendung) ersetzt. '''%text%''': Wird durch den zu übersetzenden Text ersetzt.
*<code>Speak2</code>: Siehe Speak1
*<code>Speak3</code>: Siehe Speak1
*<code>Speak4</code>: Siehe Speak1

=== Get-Befehle an SONOS ===
*<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 ===
*<code>Groups <Gruppendefinition></code>: Setzt die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft. Das Format ist jenes, welches auch von dem Get-Befehl ''Groups'' geliefert wird.
*<code>StopAll</code>: Stoppt die Wiedergabe in allen Zonen.
*<code>PauseAll</code>: Pausiert die Wiedergabe in allen Zonen.

== 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:
*Grundlegendes
**<code>presence</code>: Erreichbarkeit des Players. Kann "appeared" oder "disappeared" sein
**<code>roomName</code>: Originalname des ZonePlayers. 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>playerType</code>: Typbezeichnung des ZonePlayer. z.B. "ZP90"
**<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-Komfigurationen aber auch RR (für Right-Rear) oder LR (für Left-Rear).
**<code>location</code>: URL zum Informationsdokument des ZonePlayers
**<code>softwareRevision</code>: Version der installierten Software. z.B. "3.8.4"
**<code>serialNum</code>: Seriennummer des ZonePlayers. Entspricht weitestgehend der MAC-Adresse. z.B. "00-0E-58-28-D0-F4:2"
**<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>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. 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.
**<code>Mute</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, den aktuellen Zustand des Mute. 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>Shuffle</code>: Enthält den aktuellen Zustand von Shuffle. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>Repeat</code>: Enthält den aktuellen Zustand von Repeat. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<code>CrossfadeMode</code>: Enthält den aktuellen Zustand von CrossfadeMode. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
**<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. 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>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. 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>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. 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>Loudness</code>: Enthält, wenn eines der beiden Attribute <code>minVolume</code> oder <code>maxVolume</code> gesetzt wurde, den aktuellen Zustand des Loudness. 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>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. 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>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. Diese Information wird automatisch aktualisiert, wenn sie bei einem Player verändert wird. 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>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>DailyIndexRefreshTime</code>: Enthält die aktuell gültige ''DailyIndexRefreshTime'', zu der der Medienindex neu aufgebaut werden soll. Diese Information wird automatisch aktualisiert, wenn sie bei einem Player verändert wird, wenn das Attribut '''getAlarms''' des Player auf ''1'' gesetzt wurde.
**<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. 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>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>ZonePlayerUUIDsInGroup</code>: Eine Liste der in der aktuellen Gruppe befindlichen Zoneplayer.
**<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.
*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>currentOriginalTrackNumber</code>: Nummer des aktuellen Titels bezogen auf das Album
**<code>currentTrack</code>: Nummer des aktuellen Titels in der Abspielliste
**<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>currentSender</code>: Senderbezeichnung, wenn es ein Radiostram ist
**<code>currentSenderCurrent</code>: Zusatzinformationen zur Radiosendung, meist der Programmtitel wie 'Pop&Weck'
**<code>currentSenderInfo</code>: Zusatzinforationen zur Radiosendung, meist der Titel des aktuellen Liedes
**<code>currentAlbumArtURI</code>: Relativer Verzeichnis-Pfad im lokalen FHEM (physisch). Beginnt momentan mit "www"
*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>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
*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>
*Infos zum Gesamtstatus
**<code>transportState</code>: Aktueller Abspielstatus. Kann "ERROR", "STOPPED", "PLAYING" oder "PAUSED_PLAYBACK" sein. Wobei ERROR heißt, dass es keine Verbindung zum Player gibt
**<code>numberOfTracks</code>: Anzahl der momentan in der Abspielliste befindlichen Titel

=== Attribute von SONOSPLAYER ===
*<code>disable(0,1)</code>: Deaktiviert die Verarbeitung von Events dieses Devices
*<code>VolumeStep</code>: Definiert die Schrittweite für den Aufruf von <code>VolumeU</code> und <code>VolumeD</code>.
*<code>generateVolumeSlider(0,1)</code>: Aktiviert einen Slider für die Lautstärkeneinstellung auf der Detailansicht. Standardmäßig ist dieser aktiviert (=1).
*<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>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>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>stateVariable(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,CrossfadeMode, 
Balance,HeadphoneConnected,SleepTimer,Presence,RoomName,SaveRoomName,PlayerType,Location, 
SoftwareRevision,SerialNum,InfoSummarize1,InfoSummarize2,InfoSummarize3,InfoSummarize4)</code>: Legt fest, welcher Variablenwert in den State geschrieben werden soll.
*<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. 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.
*<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. 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.
*<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>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>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>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, daß 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 Z.B.: <code>2:MM</code> 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>.

=== 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).
*<code>CurrentTrackPosition</code>: Liefert die aktuelle Zeitposition im Lied
*<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>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>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>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.

=== 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>.
*<code>Play</code>: Startet die Wiedergabe
*<code>Pause</code>: Pausiert die Wiedergabe
*<code>Stop</code>: Stoppt die Wiedergabe
*<code>Next</code>: Springt zum Anfang des nächsten Liedes
*<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>LoadPlaylist <Playlistname> [ListeVorherLeeren]</code>: Lädt die benannte Playliste in die aktuelle Abspielliste. Der Parameter kann/muss URL-Encoded 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''': 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'''". 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. 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>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 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'''". ''Nähere Informationen zum möglichen Inhalt der Datei siehe unter '''LoadPlayList'''.''
*<code>EmptyPlaylist</code>: Löscht die aktuelle Abspielliste
*<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>StartFavourite <FavouriteName> [NoStart]</code>: Startet den angegebenen Favoriten. Der Name bezeichnet einen Eintrag in der Sonos-Favoritenliste. Der Parameter sollte/kann URL-Encoded werden um auch Spezialzeichen zu ermöglichen.
**Wenn das Wort 'NoStart' als zweiter Parameter angegeben wurde, dann wird der Favorit geladen und fertig vorbereitet, aber nicht explizit gestartet.
**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>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.
*<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>Shuffle</code>: Legt den Zustand des Shuffle-Zustands fest. Liefert den aktuell gültigen Shuffle-Zustand.
*<code>Repeat</code>: Legt den Zustand des Repeat-Zustands fest. Liefert den aktuell gültigen Repeat-Zustand.
*<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>SleepTimer</code>: Legt den aktuellen SleepTimer fest. Der Wert muss ein kompletter Zeitstempel sein (HH:MM:SS). Zum Deaktivieren darf der Zeitstempel nur Nullen enthalten oder das Wort 'off'.
*<code>DailyIndexRefreshTime</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>VolumeD</code>: Verringert die Lautstärke um 10 Einheiten.
*<code>VolumeU</code>: Erhöht die Lautstärke um 10 Einheiten.
*<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. 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>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>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>VolumeRestore</code>: Stellt die mittels VolumeSave gespeicherte Lautstärke wieder her.
*<code>CurrentTrackPosition <TimePosition></code>: Setzt die aktuelle Zeitposition im Lied
*<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).
*<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. 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 AV-Eingang des gewählten Zoneplayer-Device als Wiedergabestrom gewählt.
**'''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. '''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. 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!''': Zum Ermitteln der Liedlänge wird u.U. eine zusätzliche Library verwendet (Wenn die Info nicht vom SonosPlayer bereitgestellt wird): <code>MP3::Info</code>. Diese Library muss zusätzlich in das FHEM-Lib-Verzeichnis kopiert werden.
**'''Achtung!''': Wenn bereits eine temporäre Ausgabe erfolgt, so wird die Aufforderung mit einer entsprechenden Meldung verworfen. Es kann nur eine geben :-)
*<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. 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>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''': In dem generierten MP3 wird ein ID3-Tag eingetragen, in dem die Umlaute wohl leider nicht sauber ankommen. Deswegen ist im Sonos-Controller die Anzeige dieser Umlaute bei den Sprachdurchsagen auch nicht korrekt.
**'''Achtung!''': Für die korrekte Funktionsweise müssen die Attribute <code>targetSpeakDir</code> und <code>targetSpeakURL</code> am Sonos-Device konfiguriert sein (siehe [http://www.fhemwiki.de/wiki/Sonos_Anwendungsbeispiel#Attribute_von_SONOS Attribute von SONOS]).
**Mögliche Sprachparameter 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, erhält man eine Fehlermeldung im Log: "''404 Not found''". Leider erhielt ich in meinen Tests unterschiedliche Ergebnisse bzgl. der verwendbaren Länge (ca. 100 Zeichen). Einfach probieren.
**'''Achtung!''': Wenn bereits eine temporäre Ausgabe erfolgt, so wird die Aufforderung mit einer entsprechenden Meldung verworfen. Es kann nur eine geben :-)
*<code>Alarm <Create|Update|Delete> <ID> <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 den Alarm mit der übergebenen ID und den angegebenen Hash-Daten.
**'''Delete''': Löscht den Alarm-Eintrag mit der übergebenen ID.
**'''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>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>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>GroupVolume <VolumeLevel></code>: Setzt die Gruppenlautstärke. Das dafür verwendete Lautstärkenverhältnis muss zuvor einmal mittels def 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, für den man den Aufruf durchführt.
*<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, 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
*<code>GroupMute <State></code>: Setzt den Mute-Zustand für die komplette Gruppe in einem Schritt. Der Wert kann on oder off sein.
*<code>Reboot</code>: Führt für den Zoneplayer einen Neustart durch.
*<code>Wifi <State></code>: Setzt den WiFi-Zustand des Players. Kann 'off', 'persist-off' oder 'on' sein.

== 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|
CrossfadeMode|Balance|HeadphoneConnected|SleepTimer|Presence|RoomName|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. 
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. 
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). 
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. 
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. 
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)

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

=== 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 wegen FHEM-Notify auf "<code>%%20</code>" kodiert werden muss). Anschließend wird die Lautstärke gesetzt, ein Titel ausgewählt (zufällig) und das Abspielen gestartet.

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

=== 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. 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.
</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. 
2: Hier wird eine deutsche Textnachricht mit 10 Einheiten lauter als aktuell eingestellt ausgegeben. 
3: Hier wird eine englische Textnachricht mit der gleichen Lautstärke wie aktuell eingestellt ausgegeben.

=== 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, daß 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, daß es etwas länger dauert (bei mir 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>

[[Category:Examples]]
[[Category:HOWTOS]]
[[Category:Code Snippets]]
[[Category:Unterhaltungselektronik]]