Cambridge Audio

The Cambridge Audio integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control all receivers and streamers that support the StreamMagic app.

The integration automatically discovers all enabled zones and sources. Each zone is added as a media player device with the enabled sources available as inputs. Media information and controls (such as play, pause, skip) are supported if the selected source reports it. The integration allows you to navigate presets, control streaming (Spotify, Tidal, Qobuz), and play radio stations all from your Home Assistant dashboard.

Supported devices

This integration allows you to connect the following devices:

  • Cambridge Audio Evo One
  • Cambridge Audio Evo 75
  • Cambridge Audio Evo 150
  • Cambridge Audio CXN
  • Cambridge Audio CXN (v2)
  • Cambridge Audio CXN100
  • Cambridge Audio CXR120
  • Cambridge Audio CXR200
  • Cambridge Audio 851N
  • Cambridge Audio MXN10
  • Cambridge Audio AXN10
  • Cambridge Audio EXN100
  • Cambridge Audio Edge NQ

Older, RS-232 serial-based amplifiers like the CXA series use a different protocol and are not currently supported.

Configuration

To add the Cambridge Audio device to your Home Assistant instance, use this My button:

Cambridge Audio can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Cambridge Audio.

  • Follow the instructions on screen to complete the setup.

Host

The IP address of your device can be found by navigating to the device on the StreamMagic app and selecting SettingsIP address.

Data updates

Cambridge Audio devices push data directly to Home Assistant, enabling immediate updates for device state changes, media information, and playback status.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.

Available configuration entities

The integration provides a few entities to configure the device settings. The following entities are supported:

  • Display brightness
  • Pre-Amp
  • Early update
  • Audio output (Speaker select)
  • Control Bus mode
  • Room correction
  • Equalizer state

Pre-Amp

When Pre-Amp mode is enabled, Home Assistant can control the output volume of your device.

Control Bus

When Control Bus mode is enabled, Home Assistant can control the output volume of your power amplifier when it is connected to a Cambridge Audio network player using the Control Bus interface. In this case, Pre-Amp mode can be disabled. The network player will send the signal at full volume to the power amplifier, and the power amplifier’s volume can be controlled using the volume up and down controls. The Control Bus does not support setting the volume to a certain value; it can only increase and decrease the current volume.

Equalizer

If your device supports it, Home Assistant can enable or disable the equalizer.

Playing media

Cambridge Audio supports playing a variety of formats using the media_player.play_media action.

Examples:

Cambridge Audio can recall any stored presets saved on the device. An example action using a preset:

action: media_player.play_media
target:
  entity_id: media_player.cambridge_audio
data:
  media_content_type: "preset"
  media_content_id: "1"

An example action using an Airable radio ID:

action: media_player.play_media
target:
  entity_id: media_player.cambridge_audio
data:
  media_content_type: "airable"
  media_content_id: "12345678"

An example action using an internet radio url:

action: media_player.play_media
target:
  entity_id: media_player.cambridge_audio
data:
  media_content_type: "internet_radio"
  media_content_id: "https://example.com/internet-radio/station_abcd.mp3"

Browsing media

The Cambridge Audio integration allows you to browse saved presets from your dashboard. All stored presets will be categorized into playlists, artists, and tracks.

Troubleshooting

The buttons to skip, shuffle, and repeat the track are missing

Control functionality depends on the source / service that is currently selected. The interface automatically sets which controls are available depending on which source is selected.

The ability to change volume is missing

Volume control is supported only on all-in-one amplifiers, streamers in Pre-Amp mode, or streamers connected to an amplifier via the Control Bus interface. If you do not see volume controls, your device is likely not configured to use Pre-Amp mode, or the Control Bus feature is not activated. To check and adjust these settings:

  • In a web browser, go to the IP address of your device, or open the StreamMagic app, or open the device in Home Assistant.
  • In the settings, set Pre-Amp to On, or set Control Bus mode to Amplifier.

Turning on the device doesn’t work from Home Assistant

Cambridge Audio devices come with ECO mode enabled by default, which disables the network interface when the device is powered down. This can be changed by navigating to the IP address of the device in a web browser, or selecting settings in the StreamMagic app and setting Standby Mode to Network standby.