home-assistant.io/source/_integrations/cambridge_audio.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_domain, ha_platforms, ha_codeowners, ha_config_flow, ha_integration_type, ha_zeroconf, ha_quality_scale

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_codeowners	ha_config_flow	ha_integration_type	ha_zeroconf	ha_quality_scale
Cambridge Audio	Instructions on how to integrate Cambridge Audio Receivers into Home Assistant.	Media player Select	2024.10	Local Push	cambridge_audio	diagnostics media_player select switch	@noahhusby	true	device	true	platinum

The Cambridge Audio {% term integration %} 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 75
• Cambridge Audio Evo 150
• Cambridge Audio CXN
• Cambridge Audio CXN (v2)
• 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.

{% include integrations/config_flow.md %}

{% configuration_basic %} Host: description: The IP address of your device can be found by navigating to the device on the StreamMagic app and selecting Settings → IP address. {% endconfiguration_basic %}

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.

{% include integrations/remove_device_service.md %}

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

Pre-Amp

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

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 with full volume to the power amplifier and the volume of the power amplifier can be controlled using volume up and down controls. Control Bus does not support setting the volume to a certain value, it can only increase and decrease the current volume.

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 only supported on all-in-one amps, or streamers with pre-amp mode. Likely, the device is not configured to be in pre-amp mode. 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 Pre-Amp to On.

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.