Integración domótica ebusd, gratuita y de código abierto
Calderas y bombas de calor Vaillant, Saunier Duval, Wolf… en el eBUS, con ebusd, en local.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.3.0
- ★ 0
Presentación
Esta integración lleva a Gladys su calefacción eBUS: Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder y las demás marcas cuyas calderas, bombas de calor y reguladores se comunican por el eBUS. Pasa por ebusd, un programa libre que escucha el bus con un adaptador eBUS y conoce los mensajes de cada dispositivo.
Cada dispositivo eBUS que ebusd conoce se convierte en un dispositivo de Gladys: la caldera, la bomba de calor, el regulador, los circuitos de calefacción, además del propio ebusd con la señal eBUS. Los valores que cambian en el bus llegan en directo; los demás se leen cada pocos minutos. Todo se queda en su red local.
Integración no oficial, sin relación con el proyecto ebusd ni con las marcas citadas.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- ebusd funcionando en una Raspberry Pi, un NAS, el equipo de Gladys (imagen Docker
john30/ebusd) o como complemento de Home Assistant, con un adaptador eBUS (por ejemplo el eBUS Adapter Shield). - ebusd con sus archivos de configuración (por defecto) y su puerto TCP 8888 accesible desde Gladys: no lo inicie con
--localhost. Compruebe conebusctl infoque ve sus dispositivos y que muestra una configuraciónloadedpara cada uno.
Configuración
ebusd
- Dirección de ebusd: la dirección IP o el nombre del equipo donde funciona ebusd.
localhostno funciona: Gladys ejecuta la integración en su propio contenedor. - Puerto TCP: 8888, salvo que haya cambiado
--port. - Usuario y secreto: solo si ebusd usa un archivo de acceso (
--aclfile). - Intervalo de lectura: de 1 a 10 minutos (2 por defecto). El eBUS es lento y compartido con su calefacción; de todos modos, los valores que cambian llegan en directo.
- Valores ofrecidos: los útiles (temperaturas, presión, llama, modulación, potencia, energía, horas, arranques, modos, error), o todos los que ebusd ha visto.
- Mensajes adicionales: mensajes que siempre se ofrecen y se leen, con el nombre que les da ebusd (
ebusctl find), por ejemplobai.PumpPower, 700.Z1NightTemp. - Idioma de los nombres y textos: el idioma de los nombres de dispositivos y funciones y de los mensajes de error.
Pulse Probar ebusd y buscar los dispositivos: la respuesta indica la versión de ebusd, la señal eBUS y los dispositivos encontrados con su número de valores.
Cambiar ajustes
Desactivado por defecto: Gladys solo lee. Marque Permitir cambios para que Gladys pueda cambiar lo que el regulador deja cambiar a todos:
- consignas de ambiente (día, noche…): de 5 a 30 °C;
- consigna de agua caliente: de 35 a 70 °C;
- encendido / apagado y modos de funcionamiento (calefacción, agua caliente: apagado, auto, día, noche…).
Nunca los ajustes de instalador o de servicio técnico. Nunca se escribe dos veces el mismo valor, un mismo mensaje como máximo una vez por minuto, 100 cambios al día como máximo; el valor se vuelve a leer después de escribirlo.
Uso
Dispositivos
En Integraciones → ebusd → Descubrir, añada los dispositivos que quiera:
- ebusd: la señal eBUS (encendida cuando el adaptador oye el bus);
- un dispositivo por cada circuito eBUS, con el nombre de su tipo y su modelo, por ejemplo Caldera bai (Vaillant BAI00) o Regulador 700 (Vaillant 70000).
Sus funciones son los valores útiles: temperaturas de impulsión, retorno, exterior, ambiente, agua caliente y depósito, presión del agua, llama, modulación, horas y arranques, modos de calefacción y de agua caliente, error actual… Un dispositivo nuevo aparece unos minutos después de que ebusd cargue su configuración: vuelva a pulsar Buscar.
Widgets
- Calefacción: las temperaturas principales, la presión y la modulación, en directo, y después la llama, los modos, la consigna de agua caliente y el error actual.
- Curvas de calefacción: temperaturas exterior, de impulsión, de retorno y de agua caliente durante 24 horas, 3 o 7 días.
- eBUS: ebusd, el tráfico del bus y los dispositivos vistos con su modelo y su software.
Escenas
Desencadenadores: Un dispositivo eBUS indica un error (con el código de error), Un error eBUS desaparece, ebusd deja de responder, ebusd vuelve a responder.
Acciones: Leer un valor eBUS (cualquier mensaje por su circuito y su nombre: valor, valor numérico, unidad, todos los campos) y Escribir un valor eBUS (un mensaje abierto a todos, cuando los cambios están permitidos).
Ejemplos:
- Cuando la caldera indica un error, enviar un mensaje con el código de error.
- Cuando ebusd deja de responder, avisar: puede que la casa no se esté calentando.
- Cada mañana, leer
bai WaterPressure; por debajo de 1 bar, recordar que hay que rellenar la calefacción.
Solución de problemas
- ebusd no responde: compruebe la dirección y el puerto, que ebusd escucha en la red (no con
--localhost) y que ningún cortafuegos bloquea el puerto 8888. - Sin señal eBUS: ebusd funciona pero el adaptador no oye nada; compruebe el adaptador, su cableado y
ebusctl state. - Falta un dispositivo o un valor: espere a que ebusd cargue la configuración del dispositivo (
ebusctl info) y vuelva a buscar; elija «Todos los que ebusd ha visto» o indique el mensaje en «Mensajes adicionales». - Se rechaza un cambio: marque Permitir cambios; un mismo mensaje solo puede cambiar una vez por minuto; los ajustes de instalador nunca se escriben.
- Logs: la pestaña Logs de la página de la integración.
Parámetros de configuración
Estos son los parámetros que ebusd te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su ebusd | section | No | ebusd es un programa libre que dialoga con el eBUS de su calefacción (Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder…) mediante un adaptador eBUS (por ejemplo el eBUS Adapter Shield). Ejecútelo en una Raspberry Pi, un NAS o el equipo de Gladys, con sus archivos de configuración (por defecto) y su puerto TCP 8888 abierto a la red (sin --localhost). Gladys lo lee en la red local: nada sale de su casa. Sin relación con el proyecto ebusd ni con las marcas citadas. |
| Dirección de ebusd | string | No | La dirección IP o el nombre del equipo donde funciona ebusd («localhost» no funciona: Gladys ejecuta la integración en su propio contenedor). |
| Puerto TCP | number | No | La opción --port de ebusd, 8888 salvo que la haya cambiado. |
| Usuario (opcional) | string | No | Solo si ebusd usa un archivo de acceso (--aclfile): el usuario con el que Gladys se conecta. |
| Secreto (opcional) | secret | No | El secreto de ese usuario en el archivo de acceso. |
| Qué lee Gladys | section | No | Gladys sigue en directo cada valor que cambia en el bus, y lee los demás con el intervalo de abajo, de la memoria de ebusd cuando es bastante reciente. Cada dispositivo eBUS (caldera, regulador, bomba de calor, circuito de calefacción…) se convierte en un dispositivo de Gladys; sus funciones son los valores útiles que ebusd ya ha visto (temperaturas, presión, llama, modos, horas, arranques, error), más los conocidos de las instalaciones Vaillant. |
| Intervalo de lectura | select | No | El eBUS es lento y compartido con su calefacción: unos minutos bastan. |
| Valores ofrecidos | select | No | |
| Mensajes adicionales (opcional) | string | No | Nombres de circuito y de mensaje tal como los muestra ebusd (ebusctl find), separados por comas: Gladys los lee aunque ebusd aún no los haya visto. |
| Cambiar ajustes | section | No | Desactivado por defecto: Gladys solo lee. Una vez permitido, Gladys puede cambiar lo que el regulador deja cambiar a todos: consignas de ambiente (5 a 30 °C), consigna de agua caliente (35 a 70 °C), modos de funcionamiento, encendido/apagado. Nunca los ajustes de instalador o de servicio técnico. Un mismo mensaje como máximo una vez por minuto, 100 cambios al día como máximo. |
| Permitir cambios | boolean | No | Márquelo solo si conoce estos ajustes: uno incorrecto puede dejar la casa fría. Consulte el manual de su regulador. |
| Idioma de los nombres y textos | select | No | Gladys no indica a las integraciones el idioma de sus usuarios: elija el de los nombres de dispositivos y funciones y de los mensajes de error. |
Cómo instalar ebusd en Gladys
- En Gladys, abre Integraciones: ebusd 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/william-de71/gladys-ebusd:0.1.0), 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/William-De71/gladys-ebusd.
ebusd requiere Gladys >=5.3.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
ebusd 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 William-De71, 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