Home Assistant component that interfaces with the myVAILLANT API (and branded versions of it, such as the MiGo Link app from Saunier Duval & Bulex).
Warning
This integration is not affiliated with Vaillant, the developers take no responsibility for anything that happens to your devices because of this library.
- Vaillant aroTHERM plus heatpump + sensoCOMFORT VRC 720 + sensoNET VR 921
- Vaillant ECOTEC PLUS boiler + VR940F + sensoCOMFORT
- Vaillant ECOTEC PLUS boiler + VRT380f + sensoNET
- Vaillant EcoCompact VSC206 4-5 boiler + Multimatic VRC700/6 + gateway VR920
- Saunier Duval DUOMAX F30 90 + MISET Radio + MiLink V3
- VR42 controllers are also supported
- More are documented here
- Supports climate & hot water controls, as well as sensor information
- Control operating modes, target temperature, and presets such as holiday more or quick veto
- Set the schedule for climate zones, water heaters, and circulation pumps with a custom service
- Track sensor information of devices, such as temperature, humidity, operating mode, energy usage, or energy efficiency
- See diagnostic information, such as the current heating curve, flow temperature, firmware versions, or water pressure
- Custom services to set holiday mode or quick veto temperature overrides, and their duration
- Install HACS
- Search for the myVAILLANT integration in HACS and install it
- Restart Home Assistant
- Add myVaillant integration
- Sign in with the email & password you used in the myVAILLANT app (or MiGo app for Saunier Duval)
- Download the latest release
- Extract the
custom_componentsfolder to your Home Assistant's config folder, the resulting folder structure should beconfig/custom_components/mypyllant - Restart Home Assistant
- Add myVaillant integration, or go to Settings > Integrations and add myVAILLANT
- Sign in with the email & password you used in the myVAILLANT app (or MiGo app for Saunier Duval & Bulex)
Wait interval between updating (most) sensors. Don't set this too low, for example 10 leads to quota exceeded errors and a temporary ban.
The energy data and efficiency sensors have a fixed hourly interval.
How long to wait between making a request (i.e. setting target temperature) and refreshing data. The Vaillant takes some time to return the updated values.
When setting the temperature with the climate controls, the integration uses the "quick veto" feature of the myVAILLANT app.
With this option you can set for how long the temperature should stay set, before returning to the default value.
When the away mode preset is activated, this duration is used to for the end date (default is 365 days).
When raising or lowering the desired temperature in the myVAILLANT app, it sets a quick veto mode for a limited time with that new temperature, if the zone is in time controlled mode. If you want to permanently change the desired temperature, you need to update the time schedule.
By default, this integration has the same behavior. But when enabling this option, the Home Assistant climate controls instead overwrite the temperatures set in the time schedule with the new value (unless quick veto is already active).
The country you registered your myVAILLANT account in. The list of options is limited to known supported countries.
If a country is missing, please open an issue.
Brand of your HVAC equipment and app, pick Saunier Duval if you use the MiGo Link app.
Your HVAC system might differ from the ones in Tested on above.
If you don't see any entities, or get an error during setup, please check Debugging below and create an issue.
With debugging enabled, there's a chance to find the culprit in the data returned by the myVAILLANT API and fix it.
You can expect these entities, although names will vary based on your home name (here "Home"), installed devices (in this example "aroTHERM plus" and "hydraulic station"), or the naming of your heating zones (in this case "Zone 1"):
| Entity | Unit | Class | Sample |
|---|---|---|---|
| Home Trouble Codes | problem | off | |
| Home Online Status | connectivity | on | |
| Home Firmware Update Required | update | off | |
| Home Firmware Update Enabled | on | ||
| Home EEBUS Enabled | on | ||
| Home EEBUS Capable | on | ||
| Home Circuit 0 Cooling Allowed | on | ||
| Home Zone 1 (Circuit 0) Manual Cooling Active | off | ||
| Home Zone 1 (Circuit 0) | on | ||
| Home Zone 1 (Circuit 0) | on | ||
| Home Domestic Hot Water 0 | on | ||
| Circulating Water in Home Domestic Hot Water 0 | off | ||
| Home Zone 1 (Circuit 0) Climate | auto | ||
| Home Away Mode Start Date | unknown | ||
| Home Away Mode End Date | unknown | ||
| Home Manual Cooling Start Date | unknown | ||
| Home Manual Cooling End Date | unknown | ||
| Home Holiday Duration Remaining | d | 0 | |
| Home Manual Cooling Duration | d | 0 | |
| Home Zone 1 (Circuit 0) Quick Veto Duration | h | 2 | |
| Home Circuit 0 Heating Curve | 1.2733452 | ||
| Home Circuit 0 Heat Demand Limited by Outside Temperature | °C | 18.0 | |
| Home Circuit 0 Min Flow Temperature Setpoint | °C | 32.0 | |
| Vaillant API Request Count | 51 | ||
| Home Outdoor Temperature | °C | temperature | 17.3 |
| Home System Water Pressure | bar | pressure | 1.5 |
| Home Firmware Version | 0357.40.35 | ||
| Home Zone 1 (Circuit 0) Desired Temperature | °C | temperature | 0.0 |
| Home Zone 1 (Circuit 0) Desired Heating Temperature | °C | temperature | 0.0 |
| Home Zone 1 (Circuit 0) Desired Cooling Temperature | °C | temperature | 25.0 |
| Home Zone 1 (Circuit 0) Current Temperature | °C | temperature | 21.5 |
| Home Zone 1 (Circuit 0) Humidity | % | humidity | 62.0 |
| Home Zone 1 (Circuit 0) Heating Operating Mode | Time Controlled | ||
| Home Zone 1 (Circuit 0) Heating State | Idle | ||
| Home Zone 1 (Circuit 0) Current Special Function | Quick Veto | ||
| Home Circuit 0 State | STANDBY | ||
| Home Circuit 0 Current Flow Temperature | °C | temperature | 41.0 |
| Home Circuit 0 Heating Curve | 1.27 | ||
| Home Domestic Hot Water 0 Tank Temperature | °C | temperature | 51.5 |
| Home Domestic Hot Water 0 Setpoint | °C | temperature | 52.0 |
| Home Domestic Hot Water 0 Operation Mode | Time Controlled | ||
| Home Domestic Hot Water 0 Current Special Function | Regular | ||
| Home Heating Energy Efficiency | 4.9 | ||
| Home Device 0 aroTHERM plus Heating Energy Efficiency | 4.9 | ||
| Home Device 0 aroTHERM plus Consumed Electrical Energy Cooling | Wh | energy | 0.0 |
| Home Device 0 aroTHERM plus Consumed Electrical Energy Domestic Hot Water | Wh | energy | 3000.0 |
| Home Device 0 aroTHERM plus Consumed Electrical Energy Heating | Wh | energy | 4000.0 |
| Home Device 0 aroTHERM plus Earned Environment Energy Cooling | Wh | energy | 0.0 |
| Home Device 0 aroTHERM plus Earned Environment Energy Domestic Hot Water | Wh | energy | 9000.0 |
| Home Device 0 aroTHERM plus Earned Environment Energy Heating | Wh | energy | 18000.0 |
| Home Device 0 aroTHERM plus Heat Generated Heating | Wh | energy | 22000.0 |
| Home Device 0 aroTHERM plus Heat Generated Domestic Hot Water | Wh | energy | 12000.0 |
| Home Device 0 aroTHERM plus Heat Generated Cooling | Wh | energy | 0.0 |
| Home Device 1 Hydraulic Station Heating Energy Efficiency | unknown | ||
| Home Device 1 Hydraulic Station Consumed Electrical Energy Domestic Hot Water | Wh | energy | 0.0 |
| Home Device 1 Hydraulic Station Consumed Electrical Energy Heating | Wh | energy | 0.0 |
| Home Away Mode | off | ||
| Home EEBUS | on | ||
| Home Manual Cooling | off | ||
| Home Domestic Hot Water 0 Boost | off | ||
| Home Zone 1 (Circuit 0) Ventilation Boost | off | ||
| Home Domestic Hot Water 0 | Time Controlled |
There are custom services for almost every functionality of the myVAILLANT app:
| Name | Description | Target | Fields |
|---|---|---|---|
| Set quick veto | Sets quick veto temperature with optional duration | climate | Temperature, Duration |
| Set manual mode setpoint | Sets temperature for manual mode | climate | Temperature, Type |
| Cancel quick veto | Cancels quick veto temperature and returns to normal schedule / manual setpoint | climate | |
| Set holiday | Set holiday / away mode with start / end or duration | climate | Start Date, End Date, Duration |
| Cancel Holiday | Cancel holiday / away mode | climate | |
| Set Zone Time Program | Updates the time program for a zone | climate | Type, Time Program |
| Set Water Heater Time Program | Updates the time program for a water heater | water_heater | Time Program |
| Set Water Heater Circulation Time Program | Updates the time program for the circulation pump of a water heater | water_heater | Time Program |
| Export Data | Exports data from the mypyllant library | Data, Data Resolution, Start Date, End Date | |
| Generate Test Data | Generates test data for the mypyllant library and returns it as YAML | ||
| Export Yearly Energy Reports | Exports energy reports in CSV format per year | Year |
Additionally, there are home assistant's built in services for climate controls, water heaters, and switches.
Search for "myvaillant" in Developer Tools > Services in your Home Assistant instance to get the full list plus an interactive UI.
When debugging or reporting issues, turn on debug logging by adding this to your configuration.yaml
and restarting Home Assistant:
logger:
default: warning
logs:
custom_components.mypyllant: debug
myPyllant: debug