Vaillant/MultiMATIC integration

Hello everyone,
I have a Vaillaint VC 206/4-7 Gas boiler and a VIH R 120/5 hot water tank - nothing more. Is it possible to somehow integrate that into Home Assistant?
Or do i really need a VRC 700 / VRC 720 / VRT 380 and a VR 921?
Those componants are quite expensive.

What I actually want to achieve is, to have a button in Home Assistant to just instantly start heating up the warm water.
The general control of the my room temperature will be done by smart thermostats.

Thanks

I wonder the same… but I think it is not possible until the update to the VR will come out

Hi,

when using the multimatic.set_ventilation_day_level’ for my Vaillant RecovAir 360/4 in an automation I do receive the following error:

module 'pymultimatic.api.payloads' has no attribute 'ventilation_day_level'

This is the code of the automation:

alias: AM-Ventilation-humidity-bathroom-ON
description: ""
trigger:
  - platform: numeric_state
    entity_id:
      - sensor.lumi_lumi_weather_5d7ae507_humidity
    above: 65
condition: []
action:
  - service: multimatic.set_ventilation_day_level
    data:
      entity_id: fan.control_sys_multimatic_212XXXXXXXXXXXXXXXXXX
      level: 6
  - service: multimatic.set_ventilation_night_level
    data:
      entity_id: fan.control_sys_multimatic_212XXXXXXXXXXXXXXXXXX
      level: 6
mode: single

Any ideas on what I am doing wrong?

is it possible to force the heating of water ex. every night at 04:00, (so it starts 04.00 to heat my water)

How

@ ha_user22323 It took me ages, but this code works for me.

  • trigger at 03:00, check if temperature is below 35°C
  • continue if away-mode is not set
  • set temperature to 35°C (thats enough for me to just have some hot water in the morning), start quick mode
alias: AM-hotwater-BOOST-35
description: Hotwater to 35
trigger:
  - platform: time
    at: "03:00:00"
condition:
  - condition: numeric_state
    entity_id: >-
      sensor.control_dhw_domestichotwatertanktemperature_SNofYOURvaillantDEVICE
    below: 35
  - condition: state
    entity_id: input_boolean.away_mode
    state: "off"
action:
  - service: water_heater.set_temperature
    data:
      temperature: 35
    target:
      entity_id: water_heater.control_dhw_SNofYOURvaillantDEVICE
    enabled: true
  - service: multimatic.set_quick_mode_SNofYOURvaillantDEVICE
    data:
      quick_mode: QM_HOTWATER_BOOST
mode: single
1 Like

Thanks i will try it

Hello,

could it be that the temperature will only be displayed when the zone is set to “heat”?
i need to set my zone to “festwert” “fixed value”

Hi there,

After some research this is my only chance. I hope someone can help me here:

I am using:

  • Module internet VR921 Vaillant
  • Thermostat Vaillant sensocomfort VRC 720F
  • ambisense VR50
  • Version 1.16.3

After configuring my senso with a new user/password and the serial I am able to retrieve temperatures and other metrics, however if I set the temperature of any of my ambisenses I am getting the following error:

Source: components/websocket_api/commands.py:238
Integration: Home Assistant WebSocket API (documentation, issues)
First occurred: 27 December 2023 at 18:59:43 (6 occurrences)
Last logged: 17:45:52

[546845266752] Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/5/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 7.5, 'duration': 3}
[546926412736] Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/5/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 6.0, 'duration': 3}
[546926412736] Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/1/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 9.0, 'duration': 3}
[546926412736] Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/3/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 17.5, 'duration': 3}
[546926412736] Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/3/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 18.5, 'duration': 3}
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/components/websocket_api/commands.py", line 238, in handle_call_service
    response = await hass.services.async_call(
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/core.py", line 2067, in async_call
    response_data = await coro
                    ^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/core.py", line 2104, in _execute_service
    return await target(service_call)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/helpers/entity_component.py", line 272, in handle_service
    return await service.entity_service_call(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/helpers/service.py", line 878, in entity_service_call
    single_response = await _handle_entity_call(
                      ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/helpers/service.py", line 948, in _handle_entity_call
    result = await task
             ^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/climate/__init__.py", line 632, in async_service_temperature_set
    await entity.async_set_temperature(**kwargs)
  File "/config/custom_components/multimatic/climate.py", line 370, in async_set_temperature
    await self.coordinator.api.set_room_target_temperature(
  File "/config/custom_components/multimatic/coordinator.py", line 236, in set_room_target_temperature
    await self._manager.set_room_quick_veto(room.id, qveto)
  File "/usr/local/lib/python3.11/site-packages/pymultimatic/systemmanager.py", line 587, in set_room_quick_veto
    await self._call_api(self.urls.room_quick_veto, params={"id": room_id}, payload=payload)
  File "/usr/local/lib/python3.11/site-packages/pymultimatic/systemmanager.py", line 80, in wrapper
    return await func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.11/site-packages/pymultimatic/systemmanager.py", line 902, in _call_api
    response = await self._connector.request(method, url, payload)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.11/site-packages/pymultimatic/api/connector.py", line 181, in request
    raise ApiError(
pymultimatic.api.error.ApiError: Cannot put https://smart.vaillant.com/mobile/api/v4/facilities/21231900202609620933080448N8/rbr/v1/rooms/5/configuration/quickVeto, status: 400, response: {"errorCode":"INVALID_PARAMS"},payload: {'temperatureSetpoint': 6.5, 'duration': 3}
type or paste code here

Any idea how to fix this? It will be great to be able to move from sensoapp to HA to manage my heating system.

Thanks in advance,

Hi ttuuxxeerr,

You first need to select preset “manual”.
After you can change the temp.

Best regards, Geert

good morning, since I try to update from 0.6.2 onwards I no longer see any value with the integration, do I need to change something in the configuration?

Has someone tried the VR940f using homekit directly into home assistant?
This will solve all the server problems because homekit is a local protocol, you can even block the “gateway” from accessing the internet ones setup and access your system through home assistant.
Does Vaillant gives you the homekit code in the manual or do they force you to use the myvaillant app to add the system in homekit? if this is the case, it will not work unfortunately.
I would very like to know since I don’t want to be reliant on the vaillant servers and “own” my hardware.

it works! you are the best!

a follow up question. changing to preset manual works in home assistant. However in Apple home (homebridge) only shows me AUTO or off. is there any workaround in order to change the temperature in Home?

Thanks in advance,

Hy,

Today I got email with inforamtion, what my vaillant syatem will be updayted and migrateted to new myVAILLANT app.

Any efect for vailant integration on this?

Tx

1 Like

Haven’t found any info, but might’ve missed something.
Is there any way to toggle “ventilation boost” with this integration?
I know this option is missing from application, but myVaillant app is missing many things that are probably in the API.
I know it’s shown when generating test data as “special function”:

zones:
- index: 0
desiredRoomTemperatureSetpointHeating: 0
desiredRoomTemperatureSetpoint: 0
currentRoomTemperature: 21.475
currentRoomHumidity: 29
currentSpecialFunction: VENTILATION_BOOST
heatingState: IDLE

Looking for a way to automate this somehow.

I just got the same message. In the process of activating the new app, I arrived at a point stating my existing accounts would be disabled. Since this means my HA account will also be stopped, I did not continue with the activation. The deadline for switching to the new app, and accounts, is 01/04/2024. @tgermain Will this change brake the existing HA integration ?

The announcement has just been made: Vaillant will completely discontinue the sensoApp and multiMatic applications on March 31, 2024. This integration will no longer work. Many thanks to @tgermain for his work and we’ll see you on the myVaillant integration.

I have just switched over to myVaillant.

Many thanks for the multimatic integration @tgermain.

So… five years later, it’s the end of this journey :relieved:

Multimatic API will be shut down soon for the last of us (me included). See here for the myVaillant compatible integration: GitHub - signalkraft/mypyllant-component: Home Assistant component for the myVAILLANT API, controls Vaillant devices such as aroTHERM heatpumps and ecoTEC boilers. Ambisense support is being developed in myVaillant integration :slight_smile:

I learned so much things and I really enjoyed (and still enjoying) contributing to HA.

I would like to thank all of you who participated directly or indirectly in this project.

multimatic integration project in github will be archived, it means the integration itself will still work until you migrate, but no more support will be provided

2 Likes

Hello, everyone. I have a Vaillant flexoTHERM exclusive system with VRC 700 control panel.

Can anyone give me some info on how to integrate it into Home Assistant? Maybe using an ESP32 as an ebus bridge?

I can’t find much info but maybe someone has already solved a similar problem.

I will leave you with some information about my system.

User Manual:

eBus protocol:

I also found this device online… do I need it?