Home Assistant component that interfacts with the myVAILLANT API using the myPyllant library.
Alpha, tested on an aroTHERM plus heatpump, sensoCOMFORT VRC 720, and sensoNET VR 921.
Not affiliated with Vaillant, the developers take no responsibility for anything that happens to your Vaillant devices because of this library.
- Supports climate & hot water controls, as well as sensor information
- Control operating modes, target temperature, and presets such as holiday more or quick veto
- 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, or water pressure
You can expect these entities, although names may vary based on your 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 |
|---|---|---|---|
| Cooling Allowed in Circuit 0 | off | ||
| Error sensoCOMFORT | problem | off | |
| Online Status sensoCOMFORT | connectivity | on | |
| Cooling Allowed in Circuit 0 | off | ||
| Zone 1 | auto | ||
| aroTHERM plus Consumed Electrical Energy Domestic Hot Water | Wh | energy | 0 |
| aroTHERM plus Consumed Electrical Energy Heating | Wh | energy | 0 |
| aroTHERM plus Earned Environment Energy Domestic Hot Water | Wh | energy | 0 |
| aroTHERM plus Earned Environment Energy Heating | Wh | energy | 334.5 |
| aroTHERM plus Heat Generated Heating | Wh | energy | 334.5 |
| aroTHERM plus Heat Generated Domestic Hot Water | Wh | energy | 0 |
| Hydraulic Station Consumed Electrical Energy Domestic Hot Water | Wh | energy | 0 |
| Heating Energy Efficiency | 4 | ||
| Cooling Allowed in Circuit 0 | off | ||
| Current Flow Temperature in Circuit 0 | °C | temperature | 22.0 |
| Heating Curve in Circuit 0 | 0.8 | ||
| Min Flow Temperature Setpoint in Circuit 0 | °C | temperature | 35.0 |
| State in Circuit 0 | STANDBY | ||
| Desired Temperature in Zone 1 | °C | temperature | 0.0 |
| Current Temperature in Zone 1 | °C | temperature | 18.5 |
| Humidity in Zone 1 | % | humidity | 60.0 |
| Heating Operating Mode in Zone 1 | Time Controlled | ||
| Heating State in Zone 1 | Idle | ||
| Current Special Function in Zone 1 | None | ||
| Tank Temperature Domestic Hot Water 255 | °C | temperature | 47.0 |
| Setpoint Domestic Hot Water 255 | °C | temperature | 49.0 |
| Operation Mode Domestic Hot Water 255 | Time Controlled | ||
| Current Special Function Domestic Hot Water 255 | Regular | ||
| Domestic Hot Water 0 | Time Controlled | ||
| Outdoor Temperature | °C | temperature | 2.29 |
| System Mode | REGULAR | ||
| Water Pressure | bar | pressure | 1.4 |
- 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 use in the myVAILLANT app
- 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 use in the myVAILLANT app
Warning
You need at least Python 3.10
Fork and clone this repo, then from the root directory run:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.test.txt
pre-commit install
# Make your changes
pytest
git commit ...