+ This module controls a Yamaha Network Player (such as CRX-N560, CRX-N560D, CD-N500 or NP-S2000) via Ethernet.
+ Theoretically, any device understanding the communication protocol of the Yamaha Network Player App should work.
+
+ Currently implemented features:
+
+
+
Power on/off
+
Timer on/off
+
Input selection
+
Timer on/off
+
Volume +/-
+
Mute on/off
+
System Clock Update
+
Tuner: tune +/-, preset +/-, Station information (FM/DAB)
+
Stand-by mode: eco/normal
+
Player (play, stop, next, prev, shuffle, repeat)
+
...
+
+
+ Defining a YAMAHA_NP device will schedule an internal task (interval can be set
+ with optional parameters <off_status_interval> and <on_status_interval> in seconds.
+ <off_status_interval> is a parameter used in case the device is powered off or not available.
+ <on_status_interval> is a parameter used in case the device is powered on.
+ If both parameters are unset, a default value 30 (seconds) for both is used.
+ If <off_status_interval> is set only the same value is used for both parameters.
+
+ The internal task periodically reads the status of the Network Player (power state, selected
+ input, volume and mute status etc.) and triggers notify/filelog commands.
+
+ Example:
+
+ Add the following code into the fhem.cfg configuration file and restart fhem:
+ # With custom status interval of 60 seconds
+ define NP_Player YAMAHA_NP 192.168.0.15 60
+ attr NP_player webCmd input:volume:mute:volumeDown:volumeUp
+ # With custom "off"-interval of 60 seconds and "on"-interval of 10 seconds
+ define NP_Player YAMAHA_NP 192.168.0.15 60 10
+ attr NP_player webCmd input:volume:mute:volumeDown:volumeUp
+
+
+
+
+
+ Set
+
+
+ set <name> <command> [<parameter>]
+
+ Currently, the following commands are defined.
+ The available inputs are depending on the used network player.
+ The module offers only available inputs.
+ Note: Commands and parameters are case sensitive.
+
+ Available commands:
+
cdTray - open/close the CD tray.
+
clockUpdate - updates the system clock with current time. The time information is taken from the FHEM server.
+
input [<parameter>] - selects the input channel. The inputs are read dynamically from the device. Available inputs can be set (e.g. cd, tuner, aux1, aux2, ...).
+
mute [on|off] - activates/deactivates muting
+
off - shuts down the device
+
on - powers on the device
+
player [<parameter>] - sets player related commands.
+
+
play - play.
+
stop - stop.
+
pause - pause.
+
next - next item.
+
prev - previous item.
+
shuffleToggle - Toggles the shuffle mode.
+
repeatToggle - Toggles the repeat modes.
+
+
sleep [off|30min|60min|90min|120min] - activates the internal sleep timer
+
standbyMode [eco|normal] - set the standby mode.
+
statusRequest [<parameter>] - requests the current status of the device
+
+
systemConfig
- requests the system configuration
+
basicStatus - requests the basic status such as volume input etc.
+
playerStatus - requests the player status such as play status, song info, artist info etc.
+
tunerStatus - requests the tuner status such as FM frequency, preset number, DAB information etc.
+
timerStatus - requests device's internal wake-up timer status
+
networkInfo - requests device's network related information such as IP, Gateway, MAC address etc.
+
+
timerHour [0...23] - sets hour of device's internal wake-up timer
+
timerMinute [0...59] - sets minutes of device's internal wake-up timer
timerVolume [<VOL_MIN>...<VOL_MAX>] - sets volume of device's internal wake-up timer
+
timer [on|off] - sets device's internal wake-up timer. (Note: before timer activation timerHour, timerMinute, timerRepeat and timerVolume must be set.)
+
tuner [<parameter>] - sets tuner related commands.
+
+
bandDAB - sets the tuner band to DAB (if available).
+
bandFM - sets the tuner band to FM.
+
tuneUp - tuner tune up.
+
tuneDown - tuner tune down.
+
presetUp - tuner preset up.
+
presetDown - tuner preset down.
+
+
tunerPresetDAB [1...30] - Sets the DAB preset.
+
tunerPresetFM [1...30] - Sets the FM preset.
+
volume [0...100] - set the volume level in %
+
volumeStraight [<VOL_MIN>...<VOL_MAX>] - set the volume as used and displayed in the device. <VOL_MIN> and <VOL_MAX> are read and set from the device automatically.
+
volumeUp [<VOL_MIN>...<VOL_MAX>] - increases the volume by one device's absolute step. <VOL_MIN> and <VOL_MAX> are read and set from the device automatically.
+
volumeDown [<VOL_MIN>...<VOL_MAX>] - increases the volume by one device's absolute step. <VOL_MIN> and <VOL_MAX> are read and set from the device automatically.
+
+
+ A typical example is powering the device remotely and tuning the favourite radio station:
+ Add the following code into the fhem.cfg configuration file:
+ It's a good idea to insert a 'sleep' instruction between each fhem commands due to internal processing time of the network player. During that time the following commands might be ignored...
+
+ Now the function can be called by typing the following line in the FHEM command line or by the notify-definitions:
+
+
+ {startMyFavouriteRadioStation()}
+
+
+
+
+ Get
+
+
+ get <name> <reading>
+
+
+ Currently, the 'get' command returns reading values only. For a specific list of possible values, see section "Generated Readings".
+ Optional attribute change the response timeout in seconds for all queries to the receiver.
+ Possible values: 1...5 seconds. Default value is 4 seconds.
+ Optional attribute to disable the internal cyclic status update of the receiver. Manual status updates via statusRequest command is still possible.
+ Possible values: 0 → perform cyclic status update, 1 → don't perform cyclic status updates.
+
+
+ Readings
+
+
+
Basic readings:
+
input - The selected input source according to the FHEM input commands
+
mute - Reports the mute status of the receiver (on|off)
+
power - Reports the power status of the receiver (on|off)
+
presence - Reports the presence status of the receiver or zone (absent|present). Note: In case of "absent", the device cannot be controlled by FHEM. Check standbyMode.
+
volume - Reports the current volume level of the receiver in % (0...100%)
+
volumeStraight - Reports the current volume level of the receiver as used and displayed in the device (values device specific)
+
sleep - Reports the current sleep timer status (30min|60min|90min|120min|off).
+
state - Reports the current power state and an absence of the device (on|off|absent)
+
Player related readings:
+
playerPlaybackInfo - Reports current player state (play|stop|pause).
+
playerDeviceType - Reports the device type (ipod|msc).
+
playerIpodMode - Reports the Ipod Mode (normal|off)
+
playerRepeat - Reports the Repeat Mode (one|off)
+
playerShuffle - Reports the Shuffle Mode (on|off)
+
playerPlayTime - Reports the play time of the currently played audio (HH:MM:SS).
+
playerTrackNumber - Reports the track number of the currently played audio.
+
playerTotalTracks - Reports the total number of tracks for playing.
+
playerArtist - Reports the artist (if available) of the currently played audio.
+
playerAlbum - Reports the album (if available) of the currently played audio.
+
playerSong - Reports the song name (if available) of the currently played audio.
+
playerAlbumArtURL - Reports the album art url (if available) of the currently played audio. The URL points to the network player.
+
playerAlbumArtID - Reports the album art ID (if available) of the currently played audio.
+
playerAlbumArtFormat - Reports the album art format (if available) of the currently played audio.
+
Tuner related readings:
+
tunerBand - Reports the currently selected tuner band (FM|DAB). DAB if available.
+
tunerPresetFM - Reports the currently selected FM preset. If stored as such (1...30).
+
tunerFrequencyFM - Reports the currently tuned FM frequency. (xxx.xx MHz)
+
tunerProgramServiceFM - Reports the FM service name.
+
tunerRadioTextAFM - Reports the Radio Text A of the selected FM service.
+
tunerRadioTextBFM - Reports the Radio Text B of the selected FM service.
+
tunerPresetDAB - Reports the currently selected DAB preset. If stored as such (1...30).
+
tunerServiceLabelDAB - Reports the service label of the selected DAB service.
+
tunerChannelLabelDAB - Reports the channel label of the selected DAB service.
+
tunerDLSDAB - Reports the dynamic label segment of the selected DAB service.
+
tunerEnsembleLabelDAB - Reports the ensemble label of the selected DAB service.
+
Timer related readings:
+
timer - Reports the time mode (on|off).
+
timerRepeat - Reports the timer repeat mode (once|every).
+
timerStartTime - Reports the timer start time (HH:MM).
+
timerVolumeLevel - Reports the timer volume level.
+
+
+ Implementer's note
+
+ Trivial: In order to use that module the network player must be connected to the Ethernet.
+ The device must be in standbyMode "Normal" in order to power on.
+ However, even if the standbyMode is set to "Eco" the device can be powered off. In that case it has to be switched on manually.
+
+ Mit Hilfe dieses Moduls lassen sich Yamaha Network Player (z.B. CRX-N560, CRX-N560D, CD-N500 or NP-S2000) via Ethernet steuern.
+ Theoretisch sollten alle Geräte, die mit der Yamaha Network Player App kompatibel sind, bedient werden können.
+ Die aktuelle Implementierung ermöglicht u.a. den folgenden Funktionsumfang:
+
+ Eine YAMAHA_NP Definition initiiert einen internen Task, der von FHEM zyklisch abgearbeitet wird.
+ Das Intervall (in Sekunden) kann für die Zustände <on_status_interval> und <off_status_interval> optional gesetzt werden.
+ <off_status_interval> steht für das Intervall, wenn das Gerät ausgeschaltet/abwesend ist.
+ <on_status_interval> steht für das Intervall, wenn das Gerät eingeschaltet/verfügbar ist.
+ Wenn keine Parametere angegeben wurden, wird ein Default-Wert von 30 Sekunden für beide gesetzt.
+ Wenn nur <off_status_interval> gesetzt wird, gilt dieser Wert für beide Zustände (eingeschaltet/ausgeschaltet).
+ Der Task liest zyklisch grundlegende Parameter vom Network Player wie z.B. (Power-Status , gewählter Eingang, Lautstärke etc.) und triggert notify/filelog Befehle.
+ # 60 Sekunden Intervall für "off" und 10 Sekunden für "on"
+ define NP_Player YAMAHA_NP 192.168.0.15 60 10
+ attr NP_player webCmd input:volume:mute:volumeDown:volumeUp
+
+
+
+
+ Set
+
+
+ set <name> <command> [<parameter>]
+
+
+ Aktuell sind folgende Befehle implementiert:
+ Die verfügbaren Eingänge des Network Players werden vom diesem gelesen und dynamisch in FHEM angepasst.
+ Bemerkung: Bitte bei den Befehlen und Parametern die Groß- und Kleinschreibung beachten.
+
+ Verfügbare Befehle:
+
cdTray - Öffnen und Schließen des CD-Fachs.
+
clockUpdate - Aktualisierung der Systemzeit des Network Players. Die Zeitinformation wird von dem FHEM Server bezogen, auf dem das Modul ausgeführt wird.
+
input [<parameter>] - Auswahl des Eingangs des NP. Der aktive Eingang wird vom Gerät gelesen und in FHEM dynamisch dargestellt (z.B. cd, tuner, aux1, aux2, ...).
+
mute [on|off] - Aktiviert/Deaktiviert die Stummschaltung.
+
off - Network Player ausschalten.
+
on - Network Player einschalten.
+
player [<parameter>] - Setzt Player relevante Befehle.
+
+
play - play.
+
stop - stop.
+
pause - pause.
+
next - nächstes Audiostück.
+
prev - vorheriges Audiostück.
+
shuffleToggle - Umschaltung des Zufallswiedergabe.
+
repeatToggle - Umschaltung des Wiederholungsmodes.
+
+
sleep [off|30min|60min|90min|120min] - Aktiviert/Deaktiviert den internen Sleep-Timer
+
standbyMode [eco|normal] - Umschaltung des Standby Modus.
+
statusRequest [<parameter>] - Abfrage des aktuellen Status des Network Players.
+
+
systemConfig
- Abfrage der Systemkonfiguration.
+
basicStatus - Abfrage der Elementarparameter (z.B. Lautstärke, Eingang, etc.)
+
playerStatus - Abfrage des Player-Status.
+
tunerStatus - Abfrage des Tuner-Status (z.B. FM Frequenz, Preset-Nummer, DAB Information etc.)
+
timerStatus - Abfrage des internen Wake-up timers.
timerHour [0...23] - Setzt die Stunde des internen Wake-up Timers
+
timerMinute [0...59] - Setzt die Minute des internen Wake-up Timers
+
timerRepeat [once|every] - Setzt den Wiederholungsmodus des internen Wake-up Timers
+
timerVolume [<VOL_MIN>...<VOL_MAX>] - Setzt die Lautstärke des internen Wake-up Timers
+
timer [on|off] - Schaltet ein/aus den internen Wake-up Timer. (Bemerkung: Bevor der Wake-Up Timer gesetzt werden kann, müssen timerHour, timerMinute, timerRepeat and timerVolume zuvor gesetzt werden.)
+
tuner [<parameter>] - Tuner-relevante Befehle.
+
+
bandDAB - Setzt das Tuner-Band auf DAB (falls verfügbar).
+
bandFM - Setzt das Tuner-Band auf FM.
+
tuneUp - Tuner Frequenz +.
+
tuneDown - Tuner Frquenz -.
+
presetUp - Tuner Voreinstellung hoch.
+
presetDown - Tuner Voreinstellung runter.
+
+
tunerPresetDAB [1...30] - Setzt die DAB Voreinstellung.
+
tunerPresetFM [1...30] - Setzt die FM Voreinstellung.
+
volume [0...100] - Setzt den Lautstärkepegel in %
+
volumeStraight [<VOL_MIN>...<VOL_MAX>] - Setzt die absolute Lautstärke wie vom Gerät benutzt und angezeigt. Die Parameter <VOL_MIN> and <VOL_MAX> werden automatisch ermittelt.
+
volumeUp [<VOL_MIN>...<VOL_MAX>] - Erhöht die Lautstärke um einen absoluten Schritt. Die Parameter <VOL_MIN> and <VOL_MAX> werden automatisch ermittelt.
+
volumeDown [<VOL_MIN>...<VOL_MAX>] - Reduziert die Lautstärke um einen absoluten Schritt. Die Parameter <VOL_MIN> and <VOL_MAX> werden automatisch ermittelt.
+
+ Ein typisches Beispiel ist das Einschalten des Gerätes und das Umschalten auf den Lieblingsradiosender:
+ Beispieldefinition in der fhem.cfg Konfigurationsdatei:
+ Bemerkung: Aufgrund der relativ langsamen Befehlsverarbeitung im Network Player im Vergleich zur asynchronen Ethernet-Kommunikation, kann es vorkommen, dass veraltete Statusinformationen zurückgesendet werden.
+ Aus diesem Grund wird empfohlen, während der Automatisierung zwischen den 'set' und 'get' Befehlen ein Delay einzubauen. Speziell beim Hochfahren des Network Players sollte dies beachtet werden.
+ Die Funktion kann jetzt in der FHEM Befehlszeile eingegeben oder in die Notify-Definitionen eingebunden werden.
+
+
+ {startMyFavouriteRadioStation()}
+
+
+
+
+ Get
+
+ get <name> <reading>
+
+ Aktuell liefert der Befehl 'get' ausschließlich Reading-Werte (s. Abschnitt "Readings").
+ Optionales Attribut zum Deaktivieren des internen zyklischen Timers zum Aktualisieren des NP-Status. Manuelles Update ist nach wie vor möglich.
+ Mögliche Werte: 0 → Zyklisches Update aktiv., 1 → Zyklisches Update inaktiv.
+
+
+ Readings
+
+
+
Elementar-Readings:
+
input - Aktivierter Eingang.
+
mute - Abfrage des Mute Status (on|off)
+
power - Abfrage des Power-Status (on|off)
+
presence - Abfrage der Geräteanwesenheit im Netzwerk (absent|present). Bemerkung: Falls abwesend ("absent"), lässt sich das Gerät nicht fernbedienen.
+
volume - Abfrage der aktuell eingestellten Lautstärke in % (0...100%)
+
volumeStraight - Abfrage der aktuellen absoluten Gerätelautstärke im Gerät (gerätespezifisch)
+
sleep - Abfrage des Sleep-Timer Status (30min|60min|90min|120min|off).
+
state - Abfrage des aktuellen Power Zustands und Anwesenheit (on|off|absent).
+
Player Readings:
+
playerPlaybackInfo - Abfrage des aktuellen Player Status (play|stop|pause).
+
playerDeviceType - Abfrage des Device Typs (ipod|msc).
+
playerIpodMode - Abfrage des *Pod/*Pad/*Phone Modus (normal|off)
+
playerRepeat - Abfrage des Wiederholungsmodus (one|all)
+
playerShuffle - Abfrage des Zufallswiedergabemodus (on|off)
+
playerPlayTime - Abfrage der aktuellen Spielzeit (HH:MM:SS).
+
playerTrackNumber - Abfrage der Audiotracknummer.
+
playerTotalTracks - Abfrage der Gesamtzahl der zu wiedergebenden Tracks.
+
playerArtist - Abfrage des Künstler (Artist) (falls verfügbar) der aktuellen Wiedergabe.
+
playerAlbum - Abfrage des Albumnamens (falls verfügbar) der aktuellen Wiedergabe.
+
playerSong - Abfrage des Tracknamens (falls verfügbar) der aktuellen Wiedergabe.
+
playerAlbumArtURL - Abfrage der Album URL (falls verfügbar) der aktuellen Wiedergabe.
+
playerAlbumArtID - Abfrage der AlbumArtID (falls verfügbar) der aktuellen Wiedergabe.
+
playerAlbumArtFormat - Abfrage des AlbumArt Formats (falls verfügbar) der aktuellen Wiedergabe.
+
Tuner Readings:
+
tunerBand - Abfrage des aktuellen Radio-Bandes (FM|DAB). DAB falls verfügbar.
+
tunerPresetFM - Abfrage der aktuellen FM Voreinstellung. Falls gespeichtert (1...30).
+
tunerFrequencyFM - Abfrage der aktuellen FM Frequenz. (xxx.xx MHz)
+
tunerProgramServiceFM - Abfrage des FM Sendernamen.
+
tunerRadioTextAFM - Abfrage des Radio Text A des FM Senders.
+
tunerRadioTextBFM - Abfrage des Radio Text B des FM Senders.
+
tunerPresetDAB - Abfrage der aktuellen DAB Voreinstellung. Falls gespeichtert (1...30).
+
tunerServiceLabelDAB - Abfrage des DAB Sendernamen.
+
tunerChannelLabelDAB - Abfrage des Channel Labels des gewählten DAB Senders.
+
tunerDLSDAB - Abfrage des 'Dynamic Label Segment' des gewählten DAB Senders.
+
tunerEnsembleLabelDAB - Abfrage des 'Ensemble Label' des gewählten DAB Senders.
+
Timer Readings:
+
timer - Abfrage des Time Modus (Wecker) (on|off).
+
timerRepeat - Abfrage des Timer Wiederholungs Modus (once|every).
+
timerStartTime - Abfrage der Timer Startzeit (HH:MM).
+
timerVolumeLevel - Abfrage der Timer-Lautstärke.
+
+
+ Bemerkung des Entwicklers
+
+ Trivial: Um das Gerät fernbedienen zu können, muss es an das Ethernet-Netzwerk angeschlossen und erreichbar sein.
+ Das Gerät muss sich im standbyMode "Normal" befinden, um es fergesteuert einzuschalten.
+ Das Abschalten funktioniert auch standbyMode "Normal" Modus.
+
+
+=end html_DE
+=cut
diff --git a/fhem/MAINTAINER.txt b/fhem/MAINTAINER.txt
index 1cd75b254..f0cc5b9b8 100644
--- a/fhem/MAINTAINER.txt
+++ b/fhem/MAINTAINER.txt
@@ -1,3 +1,4 @@
+
maintainer of the file to do the change.
The third column specifies, where/how the maintainer should be contacted. If
@@ -202,6 +203,7 @@ FHEM/70_Pushover.pm Johannes_B http://forum.fhem.de Unterstue
FHEM/70_PushNotifier.pm xusader http://forum.fhem.de Unterstuetzende Dienste
FHEM/71_YAMAHA_AVR.pm markusbloch http://forum.fhem.de Multimedia
FHEM/71_YAMAHA_BD.pm markusbloch http://forum.fhem.de Multimedia
+FHEM/71_YAMAHA_NP.pm ra666ack http://forum.fhem.de Multimedia
FHEM/72_FB_CALLMONITOR.pm markusbloch http://forum.fhem.de Unterstuetzende Dienste
FHEM/72_FRITZBOX.pm tupol http://forum.fhem.de FRITZBOX (Link senden: http://forum.fhem.de/index.php?action=pm;sa=send;u=5432)
FHEM/73_km200.pm sailor http://forum.fhem.de Heizungssteuerung/Raumklima