Getting Started¶

This Home Assistant component connects to an ebusd instance through MQTT and auto-discovers Vaillant-compatible entities as topics appear. No manual configuration of individual entities is required.

Installation¶

Before installing, make sure you have these prerequisites:

ebusd configured to publish Vaillant messages over MQTT, see my quick install guide or read the full offical guide
Home Assistant with MQTT integration configured
You know which topic ebusd is publishing MQTT messages on (EBUSD_MQTTTOPIC)

Hardware Setup Guide

HACSManual

Go to HACS Integrations Custom repositories (HACS custom repositories docs)
Add the repository URL: https://github.com/signalkraft/ebusd-vaillant-component with category Integration
Click Install on the ebusd Vaillant integration
Restart Home Assistant
Add the integration through Settings Devices & services Add integration ebusd Vaillant (or click here)
Configure the MQTT topic prefix (default: ebusd) and display name

Download the latest ebusd_vaillant.zip from the releases page
Unzip into your Home Assistant custom_components directory so the path becomes custom_components/ebusd_vaillant/
Restart Home Assistant
Add the integration through Settings Devices & services Add integration ebusd Vaillant (or click here)
Configure the MQTT topic prefix (default: ebusd) and display name

Initial Startup

The component auto-discovers zones, water heater, and sensors on startup by sending discovery messages to ebusd for common device types. It may take a few minutes for all entities to be fully discovered.

Comparison¶

	ebusd-vaillant-component	ebusd over MQTT	mypyllant-component
Scope	Maps eBUS MQTT values to climate controls, partially replicates myVAILLANT app	Direct mapping from eBUS data to HA entities	Matches myVAILLANT app structure & data availability
Communication	Local MQTT Offline capable	Local MQTT Offline capable	Cloud API No offline access
Requirememts	eBUS adapter, ebusd, MQTT broker, HACS	eBUS adapter, ebusd, MQTT broker	sensoNET / myVAILLANT gateway, myVAILLANT account, HACS
Brands	Only tested on Vaillant	Any eBUS brand	Vaillant and some sub-brands
Limitations	Shows far less entities than ebusd over MQTT, but users can use both in parallel	Needs custom climate / hot water configuration to get functional controls	Relies on a somewhat temperamental cloud API, exposes less technical data

Tested Installation Types¶

Vaillant aroTHERM plus heatpump & sensoCOMFORT VRC 720
Have a different one? Check data capture on how to create test data and get you rsystem supported

MQTT¶

See the MQTT Mapping page for a complete reference of which topics map to which Home Assistant controls.

Development¶

See Development for instructions on setting up a local test environment, pre-commit hooks, and running tests.