Yamaha

Dieser Adapter steuert netzwerkfähige Yamaha-Audiogeräte aus ioBroker: AV-Receiver, Stereo-Receiver, MusicCast-Lautsprecher und Soundbars sowie CD-Receiver — ab etwa Baujahr 2008.

Er ersetzt die beiden eingestellten Adapter yamaha und musiccast und spricht alle drei Yamaha-Netzwerkprotokolle gleichzeitig. Ein Gerät erscheint deshalb als ein Gerät, egal wie viele davon es beantwortet.

Welche Geräte funktionieren

Du musst nicht wissen, welches Protokoll dein Gerät spricht. Der Adapter probiert alle drei und nutzt alles, was antwortet.

Einrichtung

1. Adapter installieren und eine Instanz anlegen.
2. Die Instanz-Einstellungen öffnen. Der Abschnitt Geräte zeigt deine Receiver als Karten.
3. Die Liste leer lassen — dann sucht der Adapter selbst im Netz und betreibt, was er findet — oder auf + drücken und die IP-Adresse eines Receivers eintragen. Beides geht zusammen: eingetragene und gefundene Geräte laufen nebeneinander.

Jede Karte zeigt ein Lautsprecher-Symbol für die Lautstärke: einen Lautsprecher mit Prozentzeichen und darunter die aktuelle Lautstärke der Hauptzone, solange Lautstärke als 0–100 % an ist, sonst den schlichten Lautsprecher. Jede Karte lässt sich bearbeiten, auch die eines gefundenen Geräts — gib ihm die feste Adresse, die du dem Receiver vergeben hast, und es wird zu einem deiner eingetragenen Geräte.

Ein Receiver von vor 2010 antwortet auf keine Netzwerksuche und muss immer von Hand eingetragen werden. Dasselbe gilt für jedes Gerät, das dein Router in einem anderen Netzabschnitt hält.

Gib dem Receiver eine feste Adresse. Der Adapter erkennt ein Gerät an seiner Identität, nicht an der Adresse, und folgt ihm bei einem Adresswechsel — ein Gerät, das umzieht, während der Adapter nicht läuft, findet aber erst die nächste Netzwerksuche wieder.

Einstellungen

• Netzsuche nach Geräten — Automatisch sucht, solange die Geräteliste leer ist; so hat der Adapter es immer gemacht. Immer sucht zusätzlich zu den eingetragenen Geräten. Nie überlässt deiner Liste allein das Feld und öffnet keinen Hörer auf UDP-Port 1900. Ein früher gefundenes Gerät, nach dem nicht mehr gesucht wird, behält seine Datenpunkte — sie werden nur als offline gekennzeichnet. Endgültig entfernt es allein der Löschknopf auf seiner Karte. Eine Liste, die nur die aus dem Vorgänger-Adapter übernommene Zeile enthält (ihr Name ist eine IP-Adresse), gilt als leer: diese Adresse hat niemand getippt, die Suche bleibt an und folgt dem Receiver zu einer neuen Adresse.
• Netzwerk-Interface — auf „alle Adressen“ (0.0.0.0) lassen, dann nutzt der Adapter jede Netzwerkkarte deines ioBroker-Rechners. Setzen, wenn dein Server in mehreren Netzen hängt: die Suche, jede Verbindung zu einem Receiver und der MusicCast-Ereignisport nutzen dann nur diese Adresse. Eine Adresse, die der Rechner nicht hat, wird mit einer Warnung im Log übergangen.
• MusicCast-Ereignisport — wird angezeigt, ist nicht änderbar: MusicCast-Geräte melden ihre Änderungen an den UDP-Port 41100, das legt das Protokoll fest. Das Feld ist da, damit der Admin warnen kann, wenn eine zweite Instanz auf demselben Rechner den Port belegen würde.
• XML-Abfrageintervall — wie oft ein Receiver von vor 2010 nach seinem Zustand gefragt wird. Diese Modelle können Änderungen nicht von sich aus melden. 60 Sekunden sind sinnvoll; ein kürzeres Intervall erzeugt mehr Netzverkehr bei wenig Gewinn.
• Datenpunkte — siehe unten.

Auf jeder Gerätekarte

• Lautstärke als 0–100 % — aus tragen die Lautstärke-Datenpunkte dieses Receivers die Skala, die er selbst anzeigt: Dezibel oder seine eigene Schrittzahl. Ein tragen sie stattdessen 0–100 %, Hauptzone wie jede weitere Zone dieses Receivers — der Bereich, den die meisten VIS-Widgets erwarten. Der Adapter rechnet in beide Richtungen um, der Receiver bekommt also immer den Wert, den er erwartet.

  Die Einstellung gehört dem Gerät, nicht der Instanz: dass ein Receiver Prozent will, sagt nichts über die anderen. Du setzt sie dort, wo auch Name und Adresse des Geräts stehen: im Anlegen-/Bearbeiten-Dialog seiner Karte — und solange sie an ist, trägt das Lautsprecher-Symbol der Karte ein Prozentzeichen, du siehst es also, ohne etwas zu öffnen.

Was im Objektbaum entsteht

Jeder Receiver wird ein Gerät. Darunter:

• info — ob das Gerät verbunden ist, sein Modell, die Firmware, die Adresse und welches der drei Protokolle gerade lebt.
• power, volume, mute, input, soundProgram, sleep — der Verstärker-Kern. Nicht abschaltbar; ein Gerät bekommt die, die es hat (ein Lautsprecher hat kein Klangprogramm).
• player — was gerade läuft: Quelle, Interpret, Album, Titel, Titelbild, abgelaufene und Gesamtzeit, Wiederholung und Zufall sowie die Transporttasten. Ein Block je Zone.
• tuner — Band, Frequenz in Kilohertz, Speicherplatz, RDS und die DAB-Details, wo das Gerät DAB hat.
• multiroom — alles, was über eine Zone oder über das Gerät hinausgeht: Zone 2 bis 4 mit eigener Lautstärke und eigenem Eingang, Hauptschalter, Party-Modus und die MusicCast-Gruppe.
• scene — eine Szene über ihre Nummer oder ihren Namen aufrufen, dazu die Liste der Szenen, die das Gerät meldet.
• remote — die Bildschirm-Fernbedienung: ein Steuerkreuz und, wo der Receiver sie hat, die Menütasten.
• sound, hdmi, advanced — Klangregelung, Equalizer, Signalinformationen, HDMI-Ausgänge, Lautsprechereinstellungen, die frei belegbaren Eingangsnamen. Auf MusicCast-Geräten kommen die geräteweiten Einstellungen dazu: automatische Abschaltung und Display-Helligkeit. Zahlen- Datenpunkte tragen die Grenzen, die das Gerät selbst angibt — ein Schieberegler bietet damit genau den Bereich an, den der Receiver annimmt.

Angelegt wird nur, was dein Gerät wirklich meldet. Eine Soundbar bekommt keine Zone 4, ein Stereo-Receiver keinen Surround-Dekoder.

Wiedergabezeiten gibt es in zwei Formen

player.elapsedTime und player.totalTime sind eine Zahl in Sekunden — das ist die Form, die das ioBroker-Medienspieler-Widget, Alexa und Google brauchen, und die Form, mit der du rechnen kannst. Direkt daneben tragen player.elapsedTimeText und player.totalTimeText denselben Wert als lesbaren Text (1:23), für eine Visualisierung, die ihn nur anzeigen will.

Datenpunktgruppen abschalten

Sieben Gruppen lassen sich in den Einstellungen abschalten: Wiedergabe, Tuner, Multiroom, HDMI, Szenen, Klang und Erweitert, dazu die Uhr auf Geräten, die eine haben. Das Menü und die Bildschirm-Fernbedienung gehören zur Wiedergabe-Gruppe. Schaltest du eine Gruppe ab, verschwinden ihre Datenpunkte — der Adapter lässt keine leeren Reste stehen. Beim Wiedereinschalten entstehen sie mit der nächsten Verbindung neu.

Anwendung

Einschalten und Quelle wählen

setState("yamaha.0.rx-v6a-1a2b.power", true);
setState("yamaha.0.rx-v6a-1a2b.input", "HDMI1");

Lautstärke setzen — in der Skala, die der Receiver anzeigt (Dezibel oder seine eigenen Schritte), innerhalb der Grenzen seines volume-Datenpunkts; mit Lautstärke als 0–100 % in Prozent. Auf einem Receiver mit Dezibel-Anzeige:

setState("yamaha.0.rx-v6a-1a2b.volume", -35.5);

Szene aufrufen — über die Nummer oder über den Namen, der am Gerät steht:

setState("yamaha.0.rx-v6a-1a2b.scene.recall", "Movie Viewing");

Eine Taste der Bildschirm-Fernbedienung drücken — up, down, left, right, select, return, home:

setState("yamaha.0.rx-v6a-1a2b.remote.cursor", "left");

Die Wörter sind auf allen drei Protokollen dieselben, ein Skript überlebt also den Gerätewechsel. Angeboten wird nur, was das Gerät wirklich kann: ältere Modelle kennen keine Menütasten, und ihr Steuerkreuz wirkt auf das geöffnete Menü.

Im Menü einer Netzwerkquelle blättern. player.browse.source öffnet eine Quelle, die acht Datenpunkte line1 bis line8 zeigen das aktuelle Fenster, selectLine wirkt wie die OK-Taste, und pageUp/pageDown/back/home navigieren. Für Skripte gibt es path: schreib Bookmarks>Radio Paradise hinein, und der Adapter läuft den Weg selbst ab.

Was du wissen solltest

Der erste Kontakt dauert. Beim allerersten Verbinden fragt der Adapter den Receiver, welche Funktionen er hat — auf einem YNCA-Gerät bis zu eine halbe Minute. Die Antworten werden je Gerät gemerkt und überstehen einen Neustart, deshalb ist das Gerät bei jedem späteren Start in Sekunden da und die Werte werden im Hintergrund aufgefrischt. Ein Firmware-Update oder ein anderes Gerät unter derselben Adresse fällt auf und wird neu gefragt.

Die Objekt-ID eines Geräts ist sein Modell und das Ende seiner Seriennummer — zum Beispiel yamaha.0.rx-v6a-1a2b. Zwei Geräte desselben Modells bekommen damit zwei Objektbäume, und ein Gerät behält seine ID, wie auch immer du oder die App es nennen: Der Name neben der ID kommt vom Gerät und lässt sich auf seiner Karte ändern. Haben zwei Geräte desselben Modells dieselben letzten vier Stellen, bekommt das zweite die ganze Seriennummer. Ein Gerät, das keine Seriennummer meldet — ein YNCA-Receiver, dessen XML-Steuerung nicht antwortet —, heißt nach seinem Modell: rx-v473, rx-v473-2. Ein Gerät, das du von Hand einträgst, während es aus ist, startet unter dem getippten Namen; sobald es geantwortet hat, ziehen seine Objekte beim nächsten Start auf seine Modell-ID um.

Ein Receiver ist an seiner Seriennummer bekannt, nicht an seiner Adresse. Der Adapter lernt die Seriennummer (und die MAC) vom Receiver selbst — aus seiner Netz-Ankündigung, über MusicCast, über die XML-Steuerung. Ein Gerät, das eine neue IP-Adresse oder einen neuen Namen bekommt, behält seine Objekte: gefundene Geräte und die aus dem Vorgänger übernommene Zeile werden an die neue Adresse umgezogen, meist innerhalb von Sekunden, weil ein Receiver sich beim Start im Netz meldet — spätestens durch die Suche, die ein Verbindungsabriss auslöst. Ein von Hand eingetragenes Gerät bleibt an der getippten Adresse; sieht die Suche es woanders antworten, sagt das Log es einmal — bearbeite die Karte, um es umzuziehen. Der Hörer teilt sich Port 1900 mit anderen UPnP-Diensten auf deinem Rechner; kann er den Port nicht nutzen, steht eine Warnung im Log und der Adapter sucht nur noch periodisch.

Löschen ist endgültig. Der Löschknopf auf einer Karte fragt zuerst und sagt, was mit dem Gerät geht: alle seine Datenpunkte, ihre Historie und jede Visualisierungs-Bindung. Ein per Netzsuche gefundenes Gerät wird nicht wieder aufgenommen — es steht auf der Ausschlussliste, bis du es entweder von Hand hinzufügst oder in Ausgeschlossene Geräte… über der Geräteliste anhakst; dann nimmt die nächste Suche es wieder auf.

MusicCast-Meldungen brauchen UDP-Port 41100. MusicCast-Geräte schicken ihre Meldungen an Port 41100 deines ioBroker-Rechners, und den kann nur ein Programm halten. Ist der alte musiccast-Adapter noch installiert und aktiv, hält er diesen Port. Die Meldungen bleiben auch aus, wenn ioBroker in Docker läuft und dieser UDP-Port nicht freigegeben ist, oder wenn sich ein zweites MusicCast-Programm auf demselben Rechner für sie anmeldet. Der Adapter merkt eine Änderung, zu der keine Meldung kam: nach zweien sagt er es einmal im Log, liest jeden Schreibvorgang zurück und fragt alle fünf Minuten alles ab. YNCA-Geräte sind davon nicht betroffen. Gib den Port frei, dann kommen die sofortigen Meldungen zurück — das Log sagt es, sobald sie wieder ankommen.

Zone 2 ist eine vollwertige Zone. Sie hat unter multiroom.zone2 eine eigene Lautstärke, einen eigenen Eingang, einen eigenen Wiedergabeblock und eigene Szenen. Der Aufruf eines Favoriten schaltet die Zone um, die auf diese Quelle hört — nicht immer die Hauptzone.

Ein abgelehnter Befehl steht im Log. Weist ein Receiver etwas zurück — eine Szene, die seine Generation nicht kennt, eine Funktion, die im Bereitschaftszustand nicht geht —, findest du das als Warnung im Adapter-Log, statt dass einfach nichts passiert. Die Antwort eines MusicCast-Geräts kommt mit ihrer Bedeutung, z. B. Guarded für „im jetzigen Zustand nicht möglich“. Der Datenpunkt zeigt danach wieder den Wert des Geräts.

Wenn etwas nicht geht

• Das Gerät wird nicht gefunden. Ältere Geräte antworten auf keine Suche — trag sie über ihre IP-Adresse ein. Ansonsten prüf, ob ioBroker und Receiver im selben Netzabschnitt liegen, und setz das Netzwerk-Interface einmal ausdrücklich.
• Das Gerät bleibt offline. Prüf die Adresse, und ob der Receiver überhaupt erreichbar ist (seine eigene Webseite antwortet meist unter http://<Adresse>). Der Adapter versucht es von selbst weiter, mit wachsenden Pausen. Hat der Receiver eine neue Adresse bekommen, folgt ihm ein gefundenes Gerät von selbst; ein von Hand eingetragenes musst du bearbeiten — das Log nennt die neue Adresse.
• Ich habe ein Gerät gelöscht und es kommt wieder / ich will es zurück. Ein gelöschtes Gerät bleibt aus der Suche draußen, bis du es wieder zulässt: von Hand hinzufügen, oder Ausgeschlossene Geräte… über der Liste öffnen und es anhaken.
• Ein Datenpunkt bleibt leer. Das Gerät meldet diesen Wert nicht — der Adapter legt nur an, was ihm gemeldet wurde. Ein leerer Datenpunkt heißt meist: andere Modelle haben die Funktion, deines nicht.
• Es kommen keine Aktualisierungen mehr. Achte auf den Hinweis zum MusicCast-Port oben und sieh dir info.connection am Gerät an.

Für alles Weitere erstell einen Diagnosebericht: in den Instanz-Einstellungen den Tab Experte öffnen, das Gerät wählen und Diagnosebericht erstellen drücken. Der Adapter liest den Receiver über jedes Protokoll aus, das er spricht — nur lesend, am Receiver ändert sich nichts —, das dauert bis zu einer Minute, und dein Browser speichert eine Datei: was der Receiver kann und was er geantwortet hat, seine Datenpunkte, die letzten Logzeilen des Adapters (auch die Debug-Zeilen, selbst wenn die Protokollstufe auf info steht) und ob der musiccast-Adapter installiert, eingeschaltet und gestartet ist. Adressen, Seriennummern, Netzwerk-, Raum-, Geräte- und Eingangsnamen werden durch Platzhalter ersetzt — auch wenn der Receiver aus ist —, und der Adapter schreibt nichts auf die Festplatte: den Bericht hält er nur im Speicher, bis dein Browser ihn hat. Läuft die Instanz nicht, sagt der Tab das, statt zu warten. Häng die Datei an eine Gerätemeldung auf GitHub.

Changelog

3.3.0 (2026-10-14)

• (krobipd) New: Diagnostics report on the new Expert tab, with a "Report a device" issue form for it
• (krobipd) New: Names you change in the receiver or the MusicCast app reach the input, scene and sound program dropdowns while the adapter runs
• (krobipd) Changed: YNCA, MusicCast and XML datapoints now share names, roles and value lists
• (krobipd) Changed: The YNCA input dropdown shows your input names; advanced.inputNames.* is removed
• (krobipd) Changed: sound.adaptiveDrc is a switch on every receiver; writing "Auto" still works
• (krobipd) Changed: On MusicCast-only devices, sleep is a dropdown and bass and treble are in dB
• (krobipd) Changed: The Zone B name moves from multiroom.zoneB.name to multiroom.zoneB.zoneName
• (krobipd) Changed: The network interface setting applies to every connection of the adapter
• (krobipd) Fixed: info.model and info.firmware are filled on devices without YNCA
• (krobipd) Fixed: Scene, tuner and playback commands work on more receivers
• (krobipd) Fixed: Empty or invalid values written to scene.recall or a preset no longer recall anything
• (krobipd) Fixed: A tuner frequency written right after the band goes to the new band
• (krobipd) Fixed: Switches on 2008–2017 receivers no longer show an On/Standby list
• (krobipd) Fixed: The on-screen remote works over XML on the 2012 entry class (RX-V473 …)
• (krobipd) Fixed: A YNCA receiver that did not answer at one start is read in full at the next
• (krobipd) Fixed: Editing a device card no longer restarts the instance, and deleted receivers stay deleted
• (krobipd) Fixed: Zones on Main Zone Sync show the main zone's playback; zones without a media input get no player datapoints
• (krobipd) Fixed: MusicCast link groups, favourites and volume right after power-on on soundbars work reliably
• (krobipd) Fixed: Receivers with a CD drive and MusicCast get their CD datapoints
• (krobipd) Fixed: Scenes without a title show as "Scene 1", "Scene 2" … in the scene dropdown instead of a bare number
• (krobipd) Fixed: Menu paths find entries on later pages, and XML menus are no longer hidden after a "not now" answer
• (krobipd) Fixed: A powered-off XML receiver goes offline in seconds
• (krobipd) Fixed: A MusicCast-only device that loses power goes offline within three minutes instead of fifteen

3.2.0 (2026-10-02)

• (krobipd) Fixed: Dropdown lists such as sound program, sleep timer and Adaptive DRC no longer go empty when the receiver loses power; lists emptied that way come back
• (krobipd) Changed: Your datapoints stay exactly as they are while the adapter runs, also when a receiver goes offline; they change only after an adapter or firmware update
• (krobipd) New: A command the receiver refuses over one protocol, or one sent while that protocol is offline, goes out over another protocol that understands it
• (krobipd) New: A firmware update of the receiver is noticed and logged; the adapter reads the receiver again and reports it ready once that is done
• (krobipd) Fixed: Datapoints of found receivers are no longer deleted at adapter start when the receiver list cannot be read or an entered receiver has the same address

3.1.3 (2026-10-02)

• (krobipd) Fixed: Menu lines fill again after switching player.browse.source, also on receivers that were in standby when the adapter started
• (krobipd) Fixed: On receivers that offer their menus only over XML (models from before 2010), the menu lines no longer stay empty after a source switch
• (krobipd) Changed: A new instance starts switched off and waits until you have set it up; existing instances keep their own setting

3.1.2 (2026-09-30)

• (krobipd) Fixed: The sleep timer lists the receiver's own values again (Off, 30 min …) instead of MusicCast's minutes, so a picked value is one the receiver accepts

3.1.1 (2026-09-30)

• (krobipd) Fixed: A receiver that replaces another at the same address is asked again whether zones 2 and 3 have an on-screen remote, instead of inheriting the old answer

License

The MIT License (MIT)

Copyright (c) 2015-2024 soef soef@gmx.net
Copyright (c) 2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2026 krobi krobi@power-dreams.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.