Yamaha MusicCast

Geräteprofil · Multimedia

Status: Das Profil wurde anhand der offiziellen Yamaha-Dokumentation erstellt.

Voraussetzungen

Ein Yamaha-Gerät mit MusicCast und der Yamaha Extended Control-Schnittstelle (YXC), z. B.
- AV-Receiver mit MusicCast (ab Modelljahr 2016) der Serien RX-V (z. B. RX-V481…RX-V781, RX-V4A/6A), RX-A (Aventage), TSR, RX-S
- Netzwerk-Receiver wie R-N602 / R-N803
- MusicCast-Lautsprecher (WX-010, WX-021, WX-030, MusicCast 20/50) und Soundbars (YAS-, SR-, YSP-Serie)
Das Profil ist als „AV Receiver“ eingeordnet, funktioniert aber genauso mit MusicCast-Lautsprechern und Soundbars — es nutzt nur Funktionen, die alle YXC-Geräte haben (Ein/Aus, Lautstärke, Mute, Eingang). Ältere Receiver ohne MusicCast (nur „YNCA“/XML-API) werden nicht unterstützt.
Gerät im LAN, per MusicCast-App eingerichtet
Netzwerk-Standby aktiv (Receiver: Setup → Netzwerk → Netzwerk-Standby → Ein, bei MusicCast-Geräten meist Standard). Ohne Netzwerk-Standby ist das Gerät im Standby nicht erreichbar und kann nicht über nomos eingeschaltet werden.

Einrichtung

Dem Yamaha-Gerät im DHCP-Server eine feste IP-Adresse geben
Skills → Add-ons: Profil Yamaha MusicCast importieren
IP-Adresse eintragen (HTTP, Port 80, keine Anmeldung)
Optional Zone: Standard ist main. Für die zweite/dritte Zone eines Receivers zone2 / zone3 / zone4 eintragen und das Gerät pro Zone einmal anlegen.
Abfrageintervall: standardmäßig alle 10 Sekunden (/main/getStatus), einstellbar

Test im Browser: http://<IP>/YamahaExtendedControl/v1/main/getStatus muss ein JSON mit "response_code":0 liefern.

Datenbereich

Wert	Name	Lesen	Schreiben
Ein / Standby	`state`	✓	✓ (`setPower=on/standby`)
Lautstärke 0–100 %	`volume`	✓	✓
Lauter / Leiser	`volup` / `voldown`	–	✓ (eine Stufe)
Stummschaltung	`mute`	✓	✓
Eingang (HDMI 1, Spotify, …)	`input`	✓	✓
Klangprogramm (DSP)	`status` / `soundprogram`	✓	✓
Gerätewert Lautstärke / Max. Lautstärke	`volume_raw` / `max_volume`	✓ (ausgeblendet)	–
Erreichbar	`reachable`	✓	–

Hinweise

Lautstärke-Skalierung: Yamaha liefert die Lautstärke als Geräteschritt, der Bereich unterscheidet sich je Modell (AV-Receiver meist 0…161 = −80,5 dB…+16,5 dB in 0,5-dB-Schritten, WX-030/WX-010 0…60). Das Profil rechnet deshalb nicht mit einem festen Maximum, sondern mit dem Wert max_volume, den das Gerät bei jeder Abfrage selbst meldet: volume % = volume / max_volume × 100 (Lesen) bzw. Geräteschritt = % × max_volume / 100 (Schreiben). max_volume ist dabei die am Gerät eingestellte maximale Lautstärke (Receiver: Setup → Ton → Lautstärke → Max. Lautstärke). Wer am Receiver das Maximum begrenzt, bekommt also 100 % = eingestelltes Maximum. Bei Werkseinstellung eines AV-Receivers bedeutet 100 % = +16,5 dB (volle Leistung) — Vorsicht bei Szenen/Automationen; ggf. die Max. Lautstärke am Gerät begrenzen.
Bis zur ersten erfolgreichen Abfrage (direkt nach dem Start) kennt das Profil max_volume noch nicht; ein Lautstärke-Befehl in diesem Moment setzt die Lautstärke auf 0 (sicherer Fall, nicht laut).
volup / voldown (setVolume?volume=up|down) gibt es erst ab YXC-API-Version 1.17 (Geräte ab ca. 2017). Ältere Geräte antworten mit einem Fehler; die absolute Lautstärke funktioniert trotzdem.
Eingang und Klangprogramm: Die Auswahllisten enthalten alle von Yamaha dokumentierten IDs (plus TIDAL/Deezer). Jedes Gerät unterstützt nur einen Teil davon — welche, zeigt http://<IP>/YamahaExtendedControl/v1/system/getFeatures (input_list, sound_program_list der Zone). Lautsprecher und manche Soundbars haben kein Klangprogramm; status bleibt dann leer.
Statusänderungen, die nicht über nomos kommen (Fernbedienung, App), erscheinen mit der nächsten Abfrage (≤ 10 s). Yamahas UDP-Push-Events werden nicht genutzt.
Wiedergabesteuerung (Play/Pause/Titel), Tuner-Presets und WLAN-Signalstärke sind in Version 1.0 nicht enthalten (eigene API-Aufrufe /netusb/…, /tuner/…, /system/getNetworkStatus).

Quellen: Yamaha Extended Control API Specification (Basic) Rev. 1.10, Yamaha MusicCast HTTP simplified API for Control Systems V1.1.