HEOS

Aus FHEMWiki
HEOS
Zweck / Funktion
Steuern und auslesen des Denon Multiroom-Soundsystem
Allgemein
Typ Gerätemodul
Details
Dokumentation EN / DE
Support (Forum) Multimedia
Modulname 21_HEOSMaster, 21_HEOSPlayer, 21_HEOSGroup
Ersteller CoolTux
(Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


HEOSMaster / HEOSPlayer / HEOSGroup

HEOSMaster

In Kombination mit HEOSPlayer und HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Voraussetzung

Installation der folgenden Pakete: apt-get install libjson-perl libnet-telnet-perl libencode-perl

Define

define <name> HEOSMaster <IP address>

Beispiel:

define MyMasterBox HEOSMaster 192.168.178.67

<IP address> ist die IP-Adresse des HEOS Receivers oder der HEOS Box. Das Master Device wird im Raum HEOS angelegt und danach erfolgt das Einlesen und automatische Anlegen der Player. Von nun an können die Player gesteuert werden. Außerdem wird der Status und die Media Readings der Player entsprechend geändert, wenn man in der HEOS-App oder direkt am Receiver etwas ändert.


Readings

  • enableChangeEvents - Status der Event Wiedergabe auf dem CLI Master
  • heosAccount - signed_out | signed_in as <HEOSAccount>
  • lastCommand - zuletzt ausgeführtes Kommando
  • lastPlayerId - Player-Id des Geräts, welches das Kommando ausgeführt hat
  • lastPlayerName - Player-Name des Geräts, welches das Kommando ausgeführt hat
  • lastResult - Ergebnis des zuletzt ausgeführten Kommandos
  • state - Status des HEOSMaster


Set

  • checkAccount - prüft das HEOS Konto
  • enableChangeEvents - aktiviert die Event Wiedergabe auf dem CLI Master
  • getGroups - holt eine Liste aller Gruppen und legt die Devices an, sofern noch nicht geschehen
  • getPlayers - holt eine Liste aller Player und legt die Devices an, sofern noch nicht vorhanden
  • password - setzt das Passwort des HEOS Kontos
  • reboot - rebootet das CLI Interface am Master
  • reopen - versucht eine neue Socket-Verbindung zum CLI Master aufzubauen
  • signAccount In|Out - anmelden|abmelden am HEOS Konto (attr MyMasterBox heosUsername <username>)


Get

  • ShowAccount - zeigt das HEOS Konto an


State

  • connected - der HEOSmaster ist mit dem CLI Master verbunden
  • not connected - der HEOSmaster ist nicht mit dem CLI Master verbunden


Attribute

  • heosUsername - Benutzername des HEOS Kontos



HEOSPlayer

In Kombination mit HEOSMaster and HEOSGroup steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.


Readings

  • channel - Nr des gerade abgespielten Favoriten
  • currentAlbum - Name des gerade abgespielten Albums
  • currentArtist - Name des gerade abgespielten Künstlers
  • currentImageUrl - URL des Albumcovers, Senderlogos, etc.
  • currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
  • currentMid - media ID
  • currentQid - queue ID
  • currentSid - source ID
  • currentStation - Name des gerade abgespielten Senders
  • currentTitle - Name des gerade abgespielten Titels
  • error - letzte Fehlermeldung
  • gid - ID der Gruppe, in der der Player Mitglied ist
  • ip-address - IP-Adresse des Players
  • lineout - lineout level type (variable|Fixed)
  • model - Modell des HEOS Lautsprechers (z.B. HEOS 1)
  • mute - Player mute Status (on|off)
  • name - Name des Players (aus der App übernommen)
  • network - Netzwerkverbindung (wired|wifi)
  • playStatus - Status des Players (play|pause|stop)
  • repeat - Player Repeat Status (on_all|on_one|off)
  • shuffle - Player Shuffle Status (on|off)
  • state - Status der Player-Verbindung (on|off)
  • version - Softwareversion des HEOS Lautsprechers
  • volume - aktuelle Lautstärke (0-100)
  • volumeDown - Schrittweite Lautstärke (1-10, default 5)
  • volumeUp - Schrittweite Lautstärke (1-10, default 5)


Set

  • aux - aktiviert die Quelle am AUX-Eingang des Players
  • channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
  • channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
  • channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
  • clear queue - löscht die Warteschlange
  • deletePlaylist <myList> - löscht die Playlist <myList>
  • set <hp1> groupWithMember <hp2> - erzeugt eine Gruppierung mit hp1 als Leader und hp2 als Mitglied
  • input sid[,cid][,mid] - setze input source-id[,container-id][,media-id]
    • Beispiel: set Küche input 1027,1772574848,inputs/tvaudio, startet "TV-Audio" auf dem Player "Küche"
  • mute on|off - setzt den mute Status on|off
  • next - spielt nächsten Titel in Warteschlange
  • pause - setzt den Status des Players auf "pause"
  • play - setzt den Status des Players auf "play"
  • playPlaylist <myList> - spielt die Playlist <myList> ab
  • playQueueItem <nr> - spielt Titel <nr> in Warteschlange
  • prev - spielt vorherigen Titel in Warteschlange
  • repeat - setzt den Player Repeat Status (on_all|on_one|off)
  • saveQueue <myList> - speichert die Warteschlange als Playlist <myList>
  • shuffle - setzt den Player Shuffle Status auf on|off
  • stop - setzt den Status des Players auf "stop"
  • volume - setzt die Lautstärke auf 0..100
  • volumeDown - verringert die Lautstärke um <volumeDown>
  • volumeUp - erhöht die Lautstärke um <volumeUp>


Get

  • ls - listet Musikquellen (Eingänge, Playlists, Favoriten, Musik-Dienste, ...)
  • channelscount - Anzahl der Favoriten


state

Status der Player-Verbindung (on|off)


Attribute

  • channelring - Beim Erreichen des letzten Favoriten schaltet ChannelUp/Down im Kreis, also wieder auf den ersten/letzten Favoriten
  • mute2play - Beim Betätigen der Mute-Taste am Lautsprecher wird auch der Stream angehalten



HEOSGroup

In Kombination mit HEOSMaster and HEOSPlayer steuert dieses FHEM Modul das Denon Multiroom-Soundsystem mit Hilfe einer telnet Socket-Verbindung und dem HEOS Command Line Interface (CLI).

Nachdem der Master einmal angelegt ist werden die Player und Gruppierungen des Systems automatisch erkannt und in FHEM angelegt. Von da an können die Player und Gruppierungen gesteuert werden und Veränderungen in der HEOS App oder am Reveiver werden mit dem Status und den Media Readings der Player und Gruppierungen synchronisiert.

Gruppierungen können aus einem Player heraus mit "groupWithMember" erzeugt werden.

Beispiel

set Wohnzimmer groupWithMember Küche

... erzeugt eine Gruppierung namens "Wohnzimmer+Küche" mit dem Player "Wohnzimmer" als Leader und dem Player "Küche" als Mitglied.


Readings

  • channel - Nr des gerade abgespielten Favoriten
  • currentAlbum - Name des gerade abgespielten Albums
  • currentArtist - Name des gerade abgespielten Künstlers
  • currentImageUrl - URL des Albumcovers, Senderlogos, etc.
  • currentMedia - Medientyp des gerade abgespielten Streams (song|station|genre|artist|album|container)
  • currentMid - media ID
  • currentQid - queue ID
  • currentSid - source ID
  • currentStation - Name des gerade abgespielten Senders
  • currentTitle - Name des gerade abgespielten Titels
  • error - letzte Fehlermeldung
  • gid - Gruppen-ID
  • leader - Leader der Gruppierung
  • member - Mitglied(er) der Gruppierung
  • mute - Player mute Status (on|off)
  • name - Name der Gruppierung
  • playStatus - Status des Players (play|pause|stop)
  • repeat - Player Repeat Status (on_all|on_one|off)
  • shuffle - Player Shuffle Status (on|off)
  • state - Status der Player-Verbindung (on|off)
  • volume - aktuelle Lautstärke (0-100)
  • volumeDown - Schrittweite Lautstärke (1-10, default 5)
  • volumeUp - Schrittweite Lautstärke (1-10, default 5)


Set

  • channel <nr> - spielt den vorher mit der App erstellten Favoriten <nr> ab
  • channelUp - schaltet auf den nächsten Favoriten in der Favoritenliste um
  • channelDown- schaltet auf vorherigen Favoriten in der Favoritenliste um
  • clearGroup - Auflösen der Gruppierung (setzt state auf off)
  • getGroupInfo - holt die Media-Informationen der Gruppierung
  • mute on|off - setze den mute Status on|off
  • next - spielt nächsten Titel in Warteschlange
  • pause - setzt den Status des Players auf "pause"
  • play - setzt den Status des Players auf "play"
  • playPlaylist <myList> - spielt die Playlist <myList> ab
  • prev - spielt vorherigen Titel in Warteschlange
  • repeat - setzt den Player Repeat Status (on_all|on_one|off)
  • shuffle - setzt den Player Shuffle Status auf on|off
  • stop - setzt den Status des Players auf "stop"
  • volume - setzt die Lautstärke auf 0..100
  • volumeDown - verringert die Lautstärke um <volumeDown>
  • volumeUp - erhöht die Lautstärke um <volumeUp>


State

  • Status der Gruppierung (on|off)