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

The **Cambridge Audio** {% term integration %} allows you to control all receivers and streamers that support the [StreamMagic](https://www.cambridgeaudio.com/usa/en/products/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](https://www.cambridgeaudio.com/usa/en/products/hi-fi/cx-series-2/cxa81)
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](https://www.cambridgeaudio.com/usa/en/products/streammagic) 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:
```yaml
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:

```yaml
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:
```yaml
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**.