SONOS

Aus FHEMWiki
Version vom 15. September 2013, 13:43 Uhr von Reinerlein (Diskussion | Beiträge) (Neues Konzept, Neue Installationsmöglichkeiten, Neue Features und Beispiele)

Dieses Anwendungsbeispiel soll den Einstieg in die Steuerung der heimischen Zoneplayer der Firma 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.


! Achtung !

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.


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
  • Automatische Aktualisierung aller aktuellen Titelinformationen innerhalb von FHEM
    • Dabei wird für jede veränderte Information ein Event erzeugt, man kann also dediziert darauf reagieren
    • Es können auch verschiedene Zusammenfassungen der bestehenden Informationen zusammengestellt werden
  • Anzeige des aktuellen Covers als Weblink
  • Steuern der ZonePlayer: Play, Pause, Nächster Titel, Vorheriger Titel, Lautstärke Lauter/Leiser, Stummschalten
  • Einstellen und Abfragen der Abspielparameter Repeat, Shuffle und CrossfadeMode
  • 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 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 Titel und der Lautstärke
  • Erzeugen und temporäres Abspielen von Sprachdurchsagen auf Basis von eingegebenen Texten (wird über die Google-Übersetzungsmaschine realisiert)
  • 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)


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: 

define Sonos SONOS localhost:4711 30

Der Name dieses Devices ist automatisch das Namensprefix beim Anlegen der SonosPlayer. In diesem Fall werden alle erkannten Zoneplayer mit dem Prefix "Sonos_" anfangen. Natürlich kann man das nach dem Anlegen einfach umbenennen.


Erkannte Zoneplayer werden als SONOSPLAYER-Device angelegt: 

define Sonos_Wohnzimmer SONOSPLAYER RINCON_000E5828D0F401400_MR

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

Beim Anlegen werden automatisch einige Attribute mit angelegt: 

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

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 "room" wird wieder aus dem Namen des SONOS-Device gebildet. Das Attribut "group" wird aus dem Namen der Zone gebildet


Des Weiteren wird automatisch ein Weblink mit angelegt: 

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

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


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 

sudo cpan LWP::Simple

das Modul "LWP::Simple" installiert wird. Wenn man bereits als Benutzer root arbeitet, dann ist das sudo 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 

sudo apt-get install <paketname>

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): libwww-perl
  • SOAP::Lite-Paketname: libsoap-lite-perl


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: "sudo su -"
  • Erstellen eines Ordners, z.B. "mkdir lwpsimple"
  • Wechsel in diesen Ordner "cd lwpsimple"
  • Herunterladen der Datei von libwww-perl-6.04 oder direkter Link: libwww-perl-6.04.tar.gz: z.B. "wget http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/libwww-perl-6.04.tar.gz"
  • Entpacken der Datei: "tar -xzvf libwww-perl-6.04.tar.gz"
  • Wechsel in das neu entstandene Verzeichnis: "cd libwww-perl-6.04"
  • Nun kann es nach dem Standardvorgehen weitergehen:
    • "perl Makefile.PL"
    • "make"
    • "make install"


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:


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.: 
    sudo mkdir /mnt/SonosSpeak
  • Installation der notwendigen Pakete für Samba: 
    sudo apt-get install samba samba-common-bin
  • Starten des Editors zum Anpassen der Konfigurationsdatei: 
    sudo nano /etc/samba/smb.conf
  • Folgende Zeilen hinzufügen (Pfade müssen natürlich u.U. angepasst werden):
[SonosSpeak]
  comment = Audio-Files for SonosPlayer to Speak
  read only = false
  path = /mnt/SonosSpeak
  guest ok = yes
  • Samba-Server neustarten: 
    sudo /etc/init.d/samba restart

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 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 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: "SONOS_", 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 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: 

update thirdparty http://fhem.lmsoft.de/sonos sonos

Für einen Vorabcheck, was installiert werden würde, kann man folgendes eingeben: 

update thirdparty http://fhem.lmsoft.de/sonos sonos check

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


Manuelle Installation

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

Für den Betrieb ist das Modul 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 FHEM kopiert werden (wie alle anderen FHEM-Module auch).

Die PerlUPnP-Library muss komplett in das Verzeichnis FHEM/lib/ abgelegt werden. Dabei muss das Verzeichnis UPnP 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 lib 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.


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 minVolume oder maxVolume 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 Volume).


Readings von SONOS

  • ZoneGroupState: Die Konfigurationsinformationen zu der aktuellen Gruppenlandschaft der Zoneplayer. Der Befehl get SONOS Groups vereinfacht den Zugriff hierauf, indem es eine einfach les- und verarbeitbare Liste erzeugt.
  • UserId_Spotify: 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.
  • UserId_Napster: 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

  • pingType(tcp,udp,icmp,syn): Definiert die Art, wie der Alive-Check eines Zoneplayers erfolgen soll. Die Verfahren funktionieren unterschiedlich gut. Am Ressourcensparsamsten ist icmp, benötigt aber "root"-Rechte. An zweiter Stelle ist syn zu empfehlen. Die anderen Verfahren melden manchmal fehlerhafte not alives. Einfach probieren.
  • targetSpeakDir: Das Verzeichnis, in dem dieses Modul die Sprachdateien von Speak (siehe Set-Befehle an den SONOSPLAYER) ablegen soll. Es wird empfohlen, dass dieses Verzeichnis nicht von Sonos indiziert ist.
    z.B. Pfade unter *Nix: /home/www/Sonos oder unter Windows: C:\InetPub\Sonos
  • targetSpeakURL: Die URL, unter der von außen (also aus Sicht des Zoneplayers) auf die abgelegte Sprachdatei zugegriffen werden kann.
    z.B. \\192.168.178.45\Sonos
  • targetSpeakFileTimestamp(0,1): 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.


Get-Befehle an SONOS

  • Groups: Liefert die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft zurück. Das Format eine Komma-getrennte Liste von Listen mit Devicenamen, also z.B. [Sonos_Kueche], [Sonos_Wohnzimmer, Sonos_Schlafzimmer]. 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 Sonos_Wohnzimmer), von dem die aktuelle Abspielliste und der aktuelle Titel auf die anderen Gruppenmitglieder übernommen wird.


Set-Befehle an SONOS

  • Groups <Gruppendefinition>: Setzt die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft. Das Format ist jenes, welches auch von dem Get-Befehl Groups geliefert wird.


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
    • presence: Erreichbarkeit des Players. Kann "appeared" oder "disappeared" sein
    • roomName: Originalname des ZonePlayers. Kann Leer- oder Sonderzeichen enthalten
    • saveRoomName: Sicherer Name des Zoneplayer. Sonderzeichen wurden in Unterstriche umgewandelt. Das Device wird beim Anlegen mit diesem Namen angelegt
    • playerType: Typbezeichnung des ZonePlayer. z.B. "ZP90"
    • location: URL zum Informationsdokument des ZonePlayers
    • softwareRevision: Version der installierten Software. z.B. "3.8.4"
    • serialNum: Seriennummer des ZonePlayers. Entspricht weitestgehend der MAC-Adresse. z.B. "00-0E-58-28-D0-F4:2"
    • LastGetActionName: Enthält den Namen der letzten Get-Anweisung
    • LastGetActionResult: Enthält das Ergebnis der letzten Get-Anweisung
    • LastSetActionName: Enthält den Namen der letzten Set-Anweisung
    • LastSetActionResult: Enthält das Ergebnis der letzten Set-Anweisung
    • Volume: Enthält im Normalfall die am Player eingestellte Laustärke zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute minVolume oder maxVolume gesetzt wurde, wird diese Lautstärke bei jeder Änderung am Player mit aktualisiert.
      Wenn zusätzlich noch das Attribut generateVolumeEvent 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.
    • Mute: Enthält, wenn eines der beiden Attribute minVolume oder maxVolume gesetzt wurde, den aktuellen Zustand des Mute.
      Wenn zusätzlich noch das Attribut generateVolumeEvent 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.
    • Shuffle: Enthält den aktuellen Zustand von Shuffle. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
    • Repeat: Enthält den aktuellen Zustand von Repeat. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
    • CrossfadeMode: Enthält den aktuellen Zustand von CrossfadeMode. Wird durch Event des Players aktualisiert (zusammen mit der Titelinformation).
    • Balance: Enthält im Normalfall die am Player eingestellte Balance zum Zeitpunkt der Erkennung. Wenn eines der beiden Attribute minVolume oder maxVolume gesetzt wurde, wird diese Balance bei jeder Änderung am Player mit aktualisiert.
      Wenn zusätzlich noch das Attribut generateVolumeEvent 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.
    • HeadphoneConnected: Enthält, wenn eines der beiden Attribute minVolume oder maxVolume (oder auch minVolumeHeadphone und maxVolumeHeadphone) gesetzt wurde, den Zustand, ob ein Kopfhörer verwendet wird, oder nicht.
      Wenn zusätzlich noch das Attribut generateVolumeEvent 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.
    • SleepTimer: 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.
    • SleepTimerVersion: 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.
    • DailyIndexRefreshTime: 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.
    • AlarmList: 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 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 }
    • AlarmListIDs: 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.
    • AlarmListVersion: 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.
    • ZoneGroupID: Die ID des Gruppenkoordinators plus eine laufende Nummer. Sollte die Gruppe nur aus einem Mitglied bestehen, so ist es die eigene ID (=UDN).
    • ZoneGroupName: Der Name der aktuellen Gruppe
    • ZonePlayerUUIDsInGroup: Eine Liste der in der aktuellen Gruppe befindlichen Zoneplayer.
  • Infos zum aktuellen Titel
    • currentTitle: Titelbezeichnung des aktuellen Titels
    • currentArtist: Interpret des aktuellen Titels
    • currentAlbum: Albumname zum aktuellen Titel
    • currentAlbumArtist: Interpret des Albums. Kann z.B. auch "(compilations)" sein, wenn mit iTunes verwaltet
    • currentOriginalTrackNumber: Nummer des aktuellen Titels bezogen auf das Album
    • currentTrack: Nummer des aktuellen Titels in der Abspielliste
    • currentTrackURI: Dateipfad des aktuellen Titels in der Abspielliste. Gültige Formate siehe PlayURI.
    • currentTrackDuration: Länge des aktuellen Titels im Format H:MM:SS
    • currentSender: Senderbezeichnung, wenn es ein Radiostram ist
    • currentSenderCurrent: Zusatzinformationen zur Radiosendung, meist der Programmtitel wie 'Pop&Weck'
    • currentSenderInfo: Zusatzinforationen zur Radiosendung, meist der Titel des aktuellen Liedes
    • currentAlbumArtURI: Relativer Verzeichnis-Pfad im lokalen FHEM (physisch). Beginnt momentan mit "www"
    • infoSummarize1: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
    • infoSummarize2: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
    • infoSummarize3: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
    • infoSummarize4: Frei zusammenstellbare Informationszeile. Zum Format siehe [InfoSummarize]
    • currentStreamAudio: Boolean. 1 wenn gerade ein Radiostream läuft, sonst 0. Momentan faktisch Negation zu <normalAudio>
    • currentNormalAudio: Boolean. 1 wenn gerade ein normaler Titel läuft, sonst 0. Momentan faktisch Negation zu <streamAudio>
  • Infos zum Gesamtstatus
    • transportState: Aktueller Abspielstatus. Kann "ERROR", "STOPPED", "PLAYING" oder "PAUSED_PLAYBACK" sein. Wobei ERROR heißt, dass es keine Verbindung zum Player gibt
    • numberOfTracks: Anzahl der momentan in der Abspielliste befindlichen Titel
    • CurrentTempPlaying: Boolean. 1 wenn gerade eine Temporäre Ausgabe (PlayURITemp oder Speak) auf dem ZonePlayer läuft, 0, wenn der Player frei ist.


Attribute von SONOSPLAYER

  • disable(0,1): Deaktiviert die Verarbeitung von Events dieses Devices
  • <codeVolumeStep: Definiert die Schrittweite für den Aufruf von VolumeU und VolumeD.
  • generateVolumeSlider(0,1): Aktiviert einen Slider für die Lautstärkeneinstellung auf der Detailansicht. Standardmäßig ist dieser aktiviert (=1).
  • generateVolumeEvent(0,1): Aktiviert die Generierung eines Events bei Lautstärkeänderungen, wenn mindestens eines der Attribute minVolume, maxVolume, minVolumeHeadphone oder maxVolumeHeadphone definiert ist. Standardmäßig ist dies deaktiviert (=0), um die Zeitverzögerung so gering wie möglich zu halten.
  • generateSomethingChangedEvent(0,1): 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.
  • generateInfoSummarize1: Generiert das Reading 'InfoSummarize1' mit dem angegebenen Format.
  • generateInfoSummarize2: Generiert das Reading 'InfoSummarize2' mit dem angegebenen Format.
  • generateInfoSummarize3: Generiert das Reading 'InfoSummarize3' mit dem angegebenen Format.
  • generateInfoSummarize4: Generiert das Reading 'InfoSummarize4' mit dem angegebenen Format.
  • stateVariable(TransportState,NumberOfTracks,Track,TrackDuration,Title,Artist,Album,

OriginalTrackNumber,AlbumArtist,Sender,SenderCurrent,SenderInfo,StreamAudio,NormalAudio,
AlbumArtURI,Volume,Mute,Shuffle,Repeat,CrossfadeMode,Balance,HeadphoneConnected,SleepTimer,
Presence,RoomName,SaveRoomName,PlayerType,Location,SoftwareRevision,SerialNum,InfoSummarize1,
InfoSummarize2,InfoSummarize3,InfoSummarize4): Legt fest, welcher Variablenwert in den State geschrieben werden soll.

  • minVolume(0..100): 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 minVolume auf 0 oder maxVolume auf 100 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.
  • maxVolume(0..100): 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 minVolume auf 0 oder maxVolume auf 100 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.
  • minVolumeHeadphone(0..100): 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 minVolume.
  • maxVolumeHeadphone(0..100): 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 maxVolume.
  • getAlarms(0,1): 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.
  • buttonEvents <Time:Pattern>[ <Time:Pattern> ...]: 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
      • H: Die Headphone-Buchse
      • U: Up-Button (Lautstärke Hoch)
      • D: Down-Button (Lautstärke Runter)
    • Das Event, das geworfen wird, heißt ButtonEvent, der Wert ist die definierte Tastenfolge
      Z.B.: 2:MM
      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 ButtonEvent, und den Wert MM.


Get-Befehle an den SONOSPLAYER

Hinweis!: Hier ist es wichtig zu wissen, daß diese Befehle das Ergebnis nicht selber zurückliefern. Sie starten nur die asynchrone Ermittlung der gewünschten Information. Die Information selbst wird in das entsprechende Reading geschrieben, und entsprechend mit Trigger aufgerufen, sodass man darauf mit einem notify reagieren kann. 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.

  • CurrentTrackPosition: Liefert die aktuelle Zeitposition im Lied
  • Playlists: 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"
  • Radios: 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"
  • Alarm <ID>: 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 eval(ReadingsVal(<Devicename>, 'Alarmlist', ()))->{<ID>};, damit sich nicht jeder ausdenken muss, wie er jetzt am einfachsten an die Alarm-Informationen rankommen kann.


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 getan wurde), so landet dies in dem Reading LastSetActionResult<Befehl>.

  • Play: Startet die Wiedergabe
  • Pause: Pausiert die Wiedergabe
  • Stop: Stoppt die Wiedergabe
  • Next: Springt zum Anfang des nächsten Liedes
  • Previous: 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.
  • LoadPlaylist <Playlistname> [ListeVorherLeeren]: 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.
  • SavePlaylist <Playlistname>: 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.
  • EmptyPlaylist: Löscht die aktuelle Abspielliste
  • LoadRadio <Radiostationname>: 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.
  • Mute <State>: Setzt den Mute-Zustand auf den angegebenen Wert. Der Wert kann on oder off sein. Liefert als Ergebnis den neuen Zustand.
  • MuteT: Schaltet den Mute-Zustand um. Liefert als Ergebnis den neuen Zustand.
  • Shuffle: Legt den Zustand des Shuffle-Zustands fest. Liefert den aktuell gültigen Shuffle-Zustand.
  • Repeat: Legt den Zustand des Repeat-Zustands fest. Liefert den aktuell gültigen Repeat-Zustand.
  • CrossfadeMode: Legt den Zustand des Crossfade-Mode fest. Liefert den aktuell gültigen Crossfade-Mode.
  • SleepTimer: 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'.
  • DailyIndexRefreshTime: 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).
  • VolumeD: Verringert die Lautstärke um 10 Einheiten.
  • VolumeU: Erhöht die Lautstärke um 10 Einheiten.
  • Volume <VolumeLevel>: 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.
  • Balance: 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.
  • VolumeSave <VolumeLevel>: 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.
  • VolumeRestore: Stellt die mittels VolumeSave gespeicherte Lautstärke wieder her.
  • CurrentTrackPosition <TimePosition>: Setzt die aktuelle Zeitposition im Lied
  • Track <TrackNumber>: Stellt das Lied an der Position TrackNumber in der Abspielliste als aktuelles Lied ein. Dabei kann als Tracknummer der Wert Random 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).
  • PlayURI <SongURI> [Volume]: 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. Sonos_Wohnzimmer. 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. \\Server\Freigabe\Dateiname.mp3. Erkennungsmerkmal ist der Doppelte Backslash am Anfang. Darstellung aller üblichen Informationen inkl. Cover u.ä.
    • Web-Streams: z.B. http://www.energyradio.de/hot. Erkennungsmerkmal ist die Angabe von http:// am Anfang. Es werden keine Cover aber Streaminformationen dargestellt.
    • Sonstige URI-Typen: z.B. x-sonos-spotify:spotify:track:0jkLC0noG4A4i9lob2gSc3?sid=9&flags=0. 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).
  • PlayURITemp <SongURI> [Volume]: 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 PlayURI, es wird im Anschluß nichts wiederhergestellt.
    • Zulässige Formate stehen unter PlayURI.
    • Achtung!: Zum Ermitteln der Liedlänge wird u.U. eine zusätzliche Library verwendet (Wenn die Info nicht vom SonosPlayer bereitgestellt wird): MP3::Info. 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 :-)
  • AddURIToQueue <SongURI>: 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 PlayURI.
    • 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 PlayURI direkt (ohne Verwendung der Queue) abgespielt wird.
  • Speak <Volume> <Language> <Text>: Wandelt den angegebenen Text mittels Google in gesprochenen Text um und spielt diesen mittels PlayURITemp 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 targetSpeakDir und targetSpeakURL am Sonos-Device konfiguriert sein (siehe 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. Einfach probieren.
    • Achtung!: Wenn bereits eine temporäre Ausgabe erfolgt, so wird die Aufforderung mit einer entsprechenden Meldung verworfen. Es kann nur eine geben :-)
  • Alarm <Create|Update|Delete> <ID> <Datenhash>: 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:
      • 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 }: Erzeugt einen neuen Alarm mit den angegebenen Informationen. Die neue ID wird als Ergebnis zurückgegeben.
      • set Sonos_Wohnzimmer Alarm Update 17 { Shuffle => 1 }: Aktualisiert den Alarm mit der ID 17, und passt dort Shuffle auf Aktiv an.
      • set Sonos_Wohnzimmer Alarm Delete 17: Löscht den Alarm mit der ID 17.
  • AddMember <Devicename>: 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.
  • RemoveMember <Devicename>: 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.
  • GroupVolume <VolumeLevel>: Setzt die Gruppenlautstärke in der Art des Original-Controllers. Das bedeutet, dass das Lautstärkenverhältnis der Player zueinander beim Anpassen erhalten bleibt.
  • GroupMute <State>: Setzt den Mute-Zustand für die komplette Gruppe in einem Schritt. Der Wert kann on oder off sein.


Definition der InfoSummarize

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

Die Unterscheidung zwischen <NormalAudio> und <StreamAudio> 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 prefix und suffix werden jeweils vor bzw. hinter den Feldwert in die Ausgabe gesetzt, wenn es einen Feldwert zum Ausgeben gibt.
Die Erweiterung instead 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 ifempty 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 emptyval 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 InfoSummarize-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 automatischen Abspielen einer Liste nach dem Einschalten eines Players

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 ".\
		int(ReadingsVal("Sonos_Wohnzimmer", "numberOfTracks", 0) - rand(60)) \
	fhem "set Sonos_Wohnzimmer Play" \
}

Hier wird auf das Event presence: appeared reagiert und eine Playlist geladen (hier mit Leerzeichen im Namen, darum mittels "%20" HTML-kodiert, was wiederum wegen FHEM auf "%%20" kodiert werden muss). Anschließend wird die Lautstärke gesetzt, ein Titel ausgewählt (mit Zufallszahl, im Bereich -60 vom Ende an, damit nicht immer der gleiche Titel kommt, aber immer einer der neueren) und das Abspielen gestartet.


Beispiel für eine Verstärkerschaltung auf Basis des Player-Zustands

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" \
		}

Hier wird beim Wechsel des transportState auf "PLAYING" der Verstärker angeschaltet, und beim Wechsel auf "STOPPED" oder "PAUSED_PLAYBACK" 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 "STOPPED" 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

define FileLog_Sonos_Wohnzimmer FileLog /etc/fhem/log/Sonos_Wohnzimmer-%Y-%m.log \
		Sonos_Wohnzimmer:infoSummarize2:.{2,}
attr FileLog_Sonos_Wohnzimmer room Sonos

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

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

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

define fritzBox_anrufstartringsong_notify notify fritzBox:.*ring set Sonos_Wohnzimmer \
		PlayURITemp \\Server\Audio\RingRingRing.mp3 30

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

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

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


Beispiel für eine Sprachdurchsage auf Basis eines Notify

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.

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 99_myUtils.pm habe: 

# 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);
}

Attribut am Sonosplayer-Device: 

attr Sonos_Schlafzimmer buttonEvents 1:MM

Notify-Defines, die die Steuerung übernehmen: 

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') }

Hier wird mittels des Attributs buttonEvents ein Event bei zweimaligen Drücken von Mute 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 zu InfoSummarize

Standard, wie er angelegt wird: 

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

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.

Abgerufen von „http://wiki.fhem.de/w/index.php?title=SONOS&oldid=2907“