Integración domótica Cambridge Audio, gratuita y de código abierto
Cambridge Audio StreamMagic amplifiers and streamers, local: power, volume, source, playback.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.2
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Control your Cambridge Audio amplifiers and streamers with StreamMagic (CXN, MXN, EVO, CXA, AXN, Edge…) from Gladys, locally, without any cloud: power on, standby, volume, mute, source, play, pause, next, previous and the title playing.
Important. This integration has never been tested with a real device: it was written from the
aiostreammagiclibrary (the one Home Assistant uses) and tested against a fake device only. Your feedback is welcome. Unofficial integration, not affiliated with Cambridge Audio.
Setup
- Give each device a fixed IP address in your router (reserved DHCP lease).
- In Gladys, install the Cambridge Audio integration, then open its configuration.
- Type the IP addresses, separated by commas (for example
192.168.1.40, 192.168.1.41). The Find the devices button can also look for them on the network (mDNS, optional: the search cannot cross every network). - Choose the volume cap (50 % by default).
- The devices appear in the Discovery tab: create them.
The integration keeps a websocket open with each device (ws://<ip>/smoip,
port 80): changes made on the device, its remote or the StreamMagic app show
in Gladys right away.
What you get
| Feature | Gladys type | Note |
|---|---|---|
| Power | binary state (read only) | 1 on, 0 in standby or unreachable |
| Power on | button | wakes the device from network standby |
| Standby | button | puts the device in network standby |
| Volume | music / volume (0 to 100) | capped, only when the pre-amplifier of the device is on |
| Mute | button (television / mute) | each press reads the state, then sets the opposite |
| Play, pause | music buttons | the explicit action, or the toggle only when it is needed |
| Next, previous | music buttons | |
| Playback | music state (read only) | 1 playing, 0 otherwise |
| Source | dropdown | the sources of the device; the list only grows |
| Now playing | text (read only) | "Artist - Title" (or the station); "—" when nothing plays |
On purpose, no switch: an "everything off" or "everything on" from a voice assistant or a scene neither wakes nor cuts your amplifier.
Volume cap
The volume asked from Gladys (dashboard, scene, voice assistant) never goes above the cap of the configuration: a higher volume is set to the cap. The cap is read again just before sending: a new value saved applies at once. The volume set on the device itself (knob, remote, app) is not changed by the integration, except in the two cases where Gladys would make it heard:
- Unmute: when the volume of the device is above the cap, it is set to the cap first, then the mute is removed, only once the device says its volume is at or under the cap; otherwise the mute is kept ("volume not lowered to the cap, mute kept"). When the volume cannot be read, nothing is sent.
- Power on: after the wake-up, the volume is read again and set to the cap when above it. When the device is slow to wake up, or does not confirm the lowering, the integration checks again every 2.5 s for about 15 s; a volume turned up above the cap during those 15 s is lowered too (also when the device was already on). A Standby pressed meanwhile does not stop these checks: they only lower the volume of a device that says it is on. After those 15 s, the volume is not corrected (the device resumes the volume it had before standby).
When the pre-amplifier of the device is off (a streamer plugged into another amplifier), the volume is neither shown nor set: set it on the amplifier.
Standby and reconnection
- In network standby, the device stays reachable: Power goes to 0 and the Power on button wakes it up.
- In eco standby, the device leaves the network: it shows as off, is named in the integration status, and the integration tries to connect again at spaced intervals (10 s, then doubled after each failure, up to 5 minutes). The Power on button cannot do anything then.
- When another device answers at the address of a created one (address changed), its address is forgotten and a search runs by itself every 10 minutes; you can also type the new address.
Commands
Every command is answered within 4 seconds (Gladys waits 5 seconds). Power on, standby, volume, mute and source are confirmed only when the device gives back the value asked (a device can accept a message and ignore it): Power on waits for the wake-up up to the end of the 4 seconds; Standby counts only a state read after it, and never while a device is still waking up from a Power on (it says "off" too). A command that left for the device without that confirmation is reported "sent, without confirmation", and the state pushed by the device then shows what it did. A command that could not leave is reported "nothing sent": so is any command, Standby included, to a device that is not connected. Standby never waits behind another command, and cancels the commands still waiting that could wake the device up (power on, source, play, next, previous: "cancelled by Standby, nothing sent"). Mute goes before the commands waiting.
When the source only offers the play/pause toggle, Play acts only when paused or stopped, Pause only when playing; in an in-between state (connecting, buffering…), the command is refused and nothing is sent.
Configuration buttons
- Find the devices: mDNS search through Gladys, then the typed addresses.
- Check the devices: the connection, power and volume of each device, and the cap in force.
Data and privacy
The integration asks for no account and no password: the StreamMagic
websocket has none. It keeps in /data/cambridge-audio.json the list of the
known devices (id, address, name, model, sources). Nothing leaves your local
network.
Known limits
- One zone (
ZONE1), as the StreamMagic app. - No presets, radio, equalizer, balance, display brightness, repeat or shuffle yet.
- Never tested with a real device: the real answers may differ.
Parámetros de configuración
Estos son los parámetros que Cambridge Audio te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Your Cambridge Audio devices, on your local network | section | No | Power on, standby, volume, mute, source, play, pause, next, previous and the title playing of each StreamMagic device (CXN, MXN, EVO, CXA, AXN... streamers and amplifiers), through its local websocket, without any cloud. Give each device a fixed IP address in your router and type it below; "Find the devices" can also look for them (optional). The devices then appear in the Discovery tab. The volume set from Gladys never goes above the cap below. A device in eco standby is off the network: it shows as off, and is tried again at spaced intervals. Never tested with a real device. Unofficial integration, not affiliated with Cambridge Audio. |
| IP addresses of the devices | string | No | Separated by commas, for example 192.168.1.40, 192.168.1.41. Devices found by the search are kept without being typed here. |
| Volume cap (%) | number | No | The highest volume Gladys may set, from 1 to 100 % (100: no cap). A higher volume asked by a scene, a voice assistant or the dashboard is set to this cap. The volume set on the device itself (knob, remote, app) is not changed. |
Cómo instalar Cambridge Audio en Gladys
- En Gladys, abre Integraciones: Cambridge Audio aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/lm1lc3n7/gladys-cambridge-audio:0.1.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-cambridge-audio.
Cambridge Audio requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Cambridge Audio es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación