Las calderas de condensación Vaillant y Saunier Duval ofrecen un rendimiento óptimo cuando modulan la potencia de la llama según la demanda térmica, algo que se pierde por completo al usar un termostato de contacto seco tradicional. Conectar la caldera a Home Assistant a través de su bus digital propietario eBUS permite leer temperaturas internas, presiones de agua, consumo de energía y enviar consignas de modulación nativas en local. En esta guía verás cómo implementar esta integración usando pasarelas hardware y el protocolo MQTT de manera fiable y sin depender de servidores externos.
Qué es el bus eBUS y por qué no debes usar contacto seco
El protocolo eBUS es un estándar de comunicación serie a dos hilos utilizado por fabricantes del grupo Vaillant (como Saunier Duval, Protherm o Hermann) para comunicar la placa electrónica principal con accesorios como termostatos modulantes (vSMART, sensoCOMFORT, MiGo), sondas exteriores y módulos solares. Opera habitualmente con niveles de tensión de entre 9 y 21 voltios en corriente continua sobre una topología en estrella o bus en paralelo sin polaridad crítica en la mayoría de receptores pasivos.
Cuando sustituyes el control original por un termostato inteligente estándar mediante relé todo/nada (On/Off en los bornes RT 24V o quemador), la caldera arranca al 100% de potencia y apaga de golpe el ciclo térmico al llegar a consigna. Esto genera picos de temperatura, aumenta el consumo de gas y anula la condensación continua de vapor de agua. Si quieres comparar las distintas alternativas comerciales antes de manipular el bus digital, puedes consultar nuestra comparativa de los mejores termostatos inteligentes wifi para caldera.
La integración mediante pasarela de datos captura los telegramas hexadecimales que circulan por los dos hilos del eBUS, los traduce en variables legibles gracias al software demonio ebusd y los publica como tópicos MQTT hacia Home Assistant. De este modo, la electrónica sigue calculando la curva de calefacción eficiente o bien recibe consignas directas de impulsión sin perder sus sistemas de seguridad internos.
Cuándo no merece la pena esta integración
- Viviendas de alquiler: Requiere acceder a la regleta interna de la placa electrónica y mantener una pasarela alimentada de forma continua.
- Calderas muy antiguas sin bus digital: Modelos anteriores a 2006 pueden carecer de conector eBUS físico o usar protocolos analógicos de 7-8-9 voltios donde este sistema no es aplicable.
- Búsqueda de soluciones comerciales cerradas: Si prefieres una app oficial sin mantenimiento local, las pasarelas del fabricante (como Vaillant sensoNET o Saunier Duval MiGo Link) ofrecen soporte técnico directo, aunque con datos bloqueados en sus servidores en la nube.
Qué necesitas antes de empezar
Para montar esta integración de forma robusta necesitarás material de hardware específico y una infraestructura de red local configurada previamente:
- Adaptador de hardware para eBUS: Se desaconsejan los esquemas analógicos caseros por falta de aislamiento galvánico. La opción más utilizada es el adaptador oficial de la comunidad ebusd (diseñado por John30), en sus versiones v3 o v5 (con microcontrolador ESP32 integrado para conexión Wi-Fi o Ethernet) o pasarelas industriales equivalentes como eSmart AI configuradas en modo pasarela transparente UART a red.
- Servidor de domótica: Una instancia operativa de Home Assistant (OS o Container) en una Raspberry Pi, mini PC o servidor doméstico.
- Bróker MQTT: El complemento oficial Mosquitto Broker instalado y funcionando dentro del entorno domótico.
- Software ebusd: Puede ejecutarse como complemento (Add-on) dentro de Home Assistant OS o como contenedor Docker independiente. Este servicio traduce el flujo serie binario del bus en comandos legibles gracias a los ficheros de configuración CSV oficiales del proyecto.
- Herramientas básicas: Destornillador aislado de electricista, cable de dos hilos (mínimo 0,5 mm² o par trenzado tipo cable de red Cat5e/Cat6) y multímetro para verificar tensiones.
Antes de abrir la carcasa de la caldera, comprueba que dispones de cobertura Wi-Fi estable de 2,4 GHz cerca del aparato si tu pasarela no va cableada por Ethernet, o utiliza hubs y pasarelas de red adecuados para evitar pérdidas de enlace en cuartos de calderas o lavaderos.
Esquema de conexión física e instalación
Toda manipulación de la placa electrónica debe realizarse con la caldera completamente desconectada de la red eléctrica de 230 V bajando el magnetotérmico correspondiente en el cuadro general de la vivienda. Si no tienes conocimientos suficientes sobre seguridad eléctrica y circuitos de calefacción, recurre a un instalador profesional autorizado.
- Localización de la regleta de conexiones: Retira la carcasa frontal metálica de la caldera según el manual de mantenimiento del aparato y bascula el panel abatible que contiene la placa de circuito impreso (PCB).
- Identificación de los bornes eBUS: Localiza la regleta serigrafiada con la etiqueta eBUS o el dibujo del bus bifilar (suele ser un conector morado o gris de dos polos, independiente de las entradas de 230 V y de las bornas de termostato On/Off RT).
- Cableado en paralelo: Conecta los dos hilos desde la regleta de la caldera hasta los terminales de entrada eBUS de tu adaptador. No es necesario retirar el termostato original si ya dispones de uno modulante de la marca (como el calorMATIC o sensoCOMFORT); el bus admite varios participantes hablando por arbitraje de colisiones.
- Ajuste de niveles de recepción: Los adaptadores modernos (como el ebusd v5 o eSmart) incorporan potenciómetros digitales o autocalibración para ajustar el umbral de detección de los bits entre los estados bajo (alrededor de 9-12 V) y alto (18-21 V). En adaptadores manuales antiguos v3, ajusta el potenciómetro hasta que el LED de datos parpadee de forma rítmica con el tráfico.
- Arranque del adaptador: Alimenta la pasarela mediante su conector USB-C a una fuente de alimentación externa de calidad (5V 1A mínimo) para no cargar la línea de alimentación propia del bus de la caldera.
Configuración de ebusd y enlace con Home Assistant vía MQTT
Con el hardware conectado y transmitiendo datos a través de tu red local mediante TCP/IP (generalmente en el puerto 9999 o 8888 de la IP asignada al microcontrolador de la pasarela), procede a la configuración del software de traducción.
1. Despliegue del servicio ebusd
Si utilizas Home Assistant OS, instala el repositorio de ebusd desde la tienda de complementos de la comunidad. En el archivo de configuración del Add-on, define los parámetros de arranque:
EBUSD_OPTS: "--scanconfig -d ens:192.168.1.150:9999 --mqttport=1883 --mqtthost=192.168.1.10 --mqttuser=usuario_mqtt --mqttpass=tu_clave --mqttjson --accesslevel=*"Explicación de las variables clave: -d ens:IP:PUERTO establece la conexión de red con el adaptador; --scanconfig permite que el programa identifique de forma automática los identificadores de tu caldera y cargue los ficheros de definición CSV correspondientes desde el repositorio en línea; --mqttjson simplifica la estructura de datos que se enviará al bróker.
2. Comprobación del registro de escaneo
Accede a los registros (logs) del complemento ebusd. Deberías observar líneas similares a:
[bus notice] scan 08: Vaillant BAI00... [bus notice] scan 15: Vaillant UI... [bus notice] read ident: ...La aparición del módulo BAI00 (Boiler Air Interface) indica que la placa electrónica de combustión ha sido identificada con éxito y los parámetros operativos están listos para ser consultados.
3. Creación de entidades en Home Assistant
Las versiones recientes de ebusd pueden enviar tramas de autodescubrimiento para el protocolo MQTT. No obstante, para garantizar total estabilidad frente a reinicios, es recomendable mapear los sensores esenciales de la caldera en tu archivo configuration.yaml:
mqtt: sensor: - name: "Caldera Temperatura Impulsión" state_topic: "ebusd/bai/FlowTemp/get" value_template: "{{ value_json['temp-value'].value }}" unit_of_measurement: "°C" device_class: temperature state_class: measurement - name: "Caldera Presión Circuito" state_topic: "ebusd/bai/WaterPressure/get" value_template: "{{ value_json['pressure-value'].value }}" unit_of_measurement: "bar" device_class: pressure state_class: measurement - name: "Caldera Modulación Quemador" state_topic: "ebusd/bai/ModulationTempDesired/get" value_template: "{{ value_json['temp-value'].value }}" unit_of_measurement: "%" state_class: measurementPara interactuar modificando el valor de consigna de la calefacción, puedes publicar comandos mediante el servicio mqtt.publish apuntando al tópico de escritura correspondiente, como ebusd/bai/SetMode/set.
Tabla comparativa de métodos de control
Antes de integrar una caldera del grupo Vaillant en el ecosistema doméstico, evalúa los compromisos técnicos entre los sistemas disponibles en el mercado:
| Método de conexión | Modulación de potencia | Funcionamiento 100% local | Lectura de presiones y fallos | Dificultad de montaje |
|---|---|---|---|---|
| Contacto seco (Relé On/Off) | No (trabajo por saltos) | Sí (según el relé) | No | Baja |
| Pasarela oficial (sensoNET / MiGo) | Sí | No (requiere nube) | Parcial (app cerrada) | Baja (Plug & Play) |
| OpenTherm (con traductor VR33) | Sí | Sí | Media | Media-Alta |
| eBUS nativo (ebusd + MQTT) | Sí (control total) | Sí (sin nube) | Total (todos los registros) | Alta |
Automatizaciones avanzadas con Home Assistant
Tener acceso directo a los datos de combustión y circulación permite coordinar la caldera con otros subsistemas de la casa, por ejemplo sincronizando la demanda con las estancias donde tengas instalada una cabeza termostática. Puedes ver el proceso de configuración de los radiadores en nuestra guía para conectar una válvula termostática Zigbee a Home Assistant mediante MQTT.
Ejemplo 1: Apagado preventivo por baja presión en el circuito hidráulico
Si la caldera pierde presión y desciende por debajo de un umbral seguro de funcionamiento, puedes forzar el estado de apagado térmico para proteger la bomba de recirculación antes de que la electrónica interna bloquee el sistema con un error F.22:
alias: "Caldera - Alerta y parada por baja presión" trigger: - platform: numeric_state entity_id: sensor.caldera_presion_circuito below: 0.8 for: minutes: 5 action: - action: notify.notify_movil data: title: "Atención en Caldera" message: "La presión del circuito ha bajado de 0,8 bar. Revisa posibles fugas." - action: mqtt.publish data: topic: "ebusd/bai/SetMode/set" payload: "disable"Ejemplo 2: Reducción de la consigna de impulsión cuando la vivienda queda desocupada
Al salir de casa no interesa apagar del todo la caldera en climas fríos para evitar condensaciones estructurales o consumos excesivos al reactivar la vivienda. Resulta más eficaz bajar la temperatura del agua que circula por los radiadores aplicando una lógica similar a la de nuestra guía sobre la automatización del modo vacaciones para calefacción en Home Assistant.
alias: "Caldera - Modo Ausente Dinámico" trigger: - platform: state entity_id: group.habitantes to: "not_home" for: minutes: 20 action: - action: mqtt.publish data: topic: "ebusd/bai/FlowTempDesired/set" payload: "45"Problemas frecuentes y cómo solucionarlos
El log muestra errores continuos de tipo 'ERR: arbitration lost' o 'signal lost'
El estándar eBUS monitoriza que ningún emisor pise los mensajes de otro. Si la pasarela pierde el arbitraje de bus sistemáticamente, el hardware no está ajustando de forma precisa la diferencia de potencial entre el cero y el uno lógico. En placas con potenciómetro manual, gira un cuarto de vuelta en sentido horario mientras monitorizas las caídas de señal con el comando ebusctl info. Si usas cables muy largos o sin apantallar cerca de líneas de 230 V, las corrientes inducidas pueden falsear la lectura; redirige el cable de datos por una canaleta independiente.
ebusd arranca pero no identifica los componentes (scan sin respuesta)
Si el comando de escaneo devuelve valores vacíos, la velocidad serie configurada suele ser incorrecta o la pasarela no está comunicando por el puerto adecuado. Verifica que el firmware de tu adaptador está configurado a 2400 baudios (la velocidad estricta del estándar eBUS) y que la dirección IP asignada a la placa Wi-Fi es estática en tu router para evitar pérdidas de conexión por renovación de concesión DHCP.
La caldera ignora las órdenes de cambio de temperatura enviadas por MQTT
Si tienes un termostato de pared oficial de Vaillant conectado al mismo tiempo en el eBUS, este dispositivo actúa como maestro de climatización y sobreescribe periódicamente la consigna que envíes desde Home Assistant. Para solventar este conflicto existen dos opciones: o bien retiras el termostato propietario y cedes el control maestro de la consigna a un termostato genérico en Home Assistant, o bien configuras tu automatización para modificar parámetros de corrección en lugar de la variable principal de corte de impulsión.
Preguntas frecuentes
¿Pierdo la garantía oficial de la caldera al conectar un adaptador eBUS?
El bus eBUS es un canal de comunicación diseñado para admitir accesorios adicionales en paralelo y trabajar con aislamiento eléctrico de bajo voltaje. Si la pasarela está certificada con aislamiento galvánico o acopladores ópticos, la electrónica de la caldera no sufre estrés térmico ni eléctrico. No obstante, ante revisiones oficiales o incidencias que requieran el servicio técnico del fabricante, desconecta los dos cables del adaptador en la regleta para evitar objeciones por parte del servicio de mantenimiento.
¿Es compatible con calderas Saunier Duval IsoFast, ThemaFast o Hermann?
Sí. Saunier Duval y Hermann pertenecen al grupo empresarial Vaillant Group y comparten la misma arquitectura de comunicación electrónica en sus gamas de condensación actuales. Los ficheros CSV de decodificación de ebusd incluyen matrices de datos específicas para placas lógicas de Saunier Duval, identificadas habitualmente bajo la nomenclatura de dispositivos como sdd o bai.
¿Puedo controlar también el agua caliente sanitaria (ACS)?
Sí. El bus eBUS expone tanto el estado de funcionamiento del circuito de calefacción como el de preparación de agua caliente sanitaria. A través de los tópicos MQTT puedes consultar la temperatura instantánea del acumulador o intercambiador de placas, modificar la consigna deseada del agua caliente (normalmente entre 40 °C y 60 °C) y forzar ciclos de choque antilegionela si el acumulador cuenta con resistencia de apoyo o acumulación indirecta.
¿Necesito comprar obligatoriamente la pasarela con microcontrolador ESP32?
No es obligatorio, pero sí muy recomendable. Existen adaptadores eBUS con conexión directa USB o serie RS-232 pensados para conectarse físicamente por cable a un ordenador o Raspberry Pi cercana. Sin embargo, las calderas suelen estar instaladas en cocinas, galerías o sótanos alejados de los servidores domésticos; un módulo con ESP32 permite transmitir las tramas mediante Wi-Fi o Ethernet hasta el bróker MQTT sin necesidad de tirar tiradas largas de cable por toda la vivienda.





