Yamaha MusicCast | IP | Version 3.0

Introduction

The Yamaha MusicCast driver provides multi-room audio control for MusicCast-enabled devices including AV Receivers, Soundbars, Wireless Speakers, and Hi-Fi Components. It communicates over HTTP using the Yamaha Extended Control (YXC) API and receives real-time updates via UDP. Up to 20 MusicCast devices are supported.

Version History

• Version 3.0: Initial release.

Driver Features

This driver supports control of all major Yamaha MusicCast features. Available functions and variables depend on what each individual device reports as supported via the API — the driver only generates controls for capabilities the device actually has.

• Zone Control — Power, Volume, Mute, Input Select, Sleep Timer, and Scene Recall per zone.
• Audio Processing — Direct, Pure Direct, Enhancer, Surround AI, Surround 3D, Tone Control, Equalizer, Balance, Audio Select, and more.
• Network/USB Playback — Play, Pause, Next, Previous, Rewind, Forward, Seek, Shuffle, Repeat, and Now Playing metadata (Artist, Album, Track, Artwork).
• Tuner — Band select (AM/FM/DAB), frequency tuning up/down, and preset recall.
• MusicCast Multi-Room Distribution — Link zones across devices for synchronised multi-room playback.
• Device-Level Controls — Speaker A/B output, HDMI outputs, Party Mode, and Party Volume/Mute for compatible AV receivers.

System Requirements

• Integration Designer: 11.x or above
• XP Processor Firmware: 25.x or above
• Yamaha MusicCast device firmware: 2.58 or above
• All MusicCast devices and the RTI processor must be on the same subnet.

Driver Configuration

1. Prepare Devices

Using the Yamaha MusicCast app, add and configure all devices. Verify basic control (power, volume, input) from the app before proceeding. Assign a static IP to each device via your router before configuring the driver.

2. Configure Driver Settings

Add the driver to your project. After adding the driver to your project, open the driver configuration and set the following:

• Device Count — Number of MusicCast devices to configure (max 20).
• For each device slot:
  • Device Used — Enable or disable this slot.
  • IP — The static IP address of the device.

3. Run the Configuration Script

Click "Get Device Data" to connect to each configured device and pull in device information, then click "Build Driver". The script queries each device's capabilities and dynamically generates sources, functions, and variables scoped to what each device actually supports.

4. Add Sources

After the script finishes running, the following sources are available to add to your project:

• {Name} Zone 1 (and Zone 2/3/4 for multi-zone receivers) — zone-level controls.
• {Name} Network/USB — streaming and network audio playback controls.
• {Name} Tuner — tuner controls. Only appears if the device has a built-in tuner.
• {Name} Device — device-level controls (Speaker A/B, HDMI outputs, Party Mode). Only appears for AV receivers that report these capabilities — not shown for simple speakers or streamers.

{Name} is taken from the Device / Zone 1 Name field in the device configuration. For multi-zone receivers, Zone 2/3/4 names can be set independently in the device configuration.

5. Autoprogram

With sources added, use autoprogramming to link functions and variables to your template buttons. The driver uses generic button tags (Play, Power, Mute, Volume, etc.) that match standard RTI template tags directly.

Limitations

• Functions and variables are generated based on what each device reports as supported. A feature listed in Driver Features may not appear for a specific device model if that device does not report support for it via the API.
• The Device source (Speaker A/B, HDMI outputs, Party Mode) is only generated for devices that report these capabilities.
• MusicCast Link multi-room distribution requires all devices to be on the same subnet.
• Equalizer band adjustment is only effective when the equalizer mode is set to Manual.
• Start Distribution takes 6–10 seconds to take effect. Grouping multiple zones/devices in a single action processes each one in sequence, so total time to reflect the group scales with how many are grouped at once.
• Network/USB and Tuner presets (favorites) are read from each device once during "Get Device Data". If you add, rename, or remove a favorite on the device afterward, re-run "Get Device Data" and "Build Driver" to pick up the change — the driver does not refresh preset lists at runtime.

System Testing

• Integration Designer: 11
• XP Processor Model: XP-6s
• XP Processor Firmware: 25.11.20
• Device Models Tested: WXC-50, WX-030, WX-021
• Device Firmware: 2.58 and above

Support Contact

Miantic AV Distribution Pvt. Ltd. licenses@miantic.com

Copyright Miantic AV Distribution 2021–2026