Skip to content

Lurchi70/ha-solvis-heating

Repository files navigation

HA Solvis Heating custom component

GitHub Release License

pre-commit

hacs_badge

Important note: troubleshooting

If you don't manage to get the data from your heating device, please enable debug logging and log_response. This will provide you with information for continued investigation.

If all of this doesn't help, use the home assistant forum. I cannot give everyone personal assistance and please don't create github issues unless you are sure there is a bug. Check the wiki for help and other details on the functionality of this component.

Introduction

The solvis_heating custom component uses the XML datainterface of the solvis remote extension of the heating system. The Solvis Heating Device is providing a lot of information about its state. To access this information the Heating device must be acessible via a computer network. Solvis provides the solvis remote as an additional device to make the heating available. Beside the officially documented http interface, the remote also provides an xml interface. This allows you to get details from your Solvis Heating device and integrate these into your Home Assistant installation.

Before being able to use the integration, you have to own a solvis remote device and have it attached, configured and available in your network. The communication with solvice remote and decoding of the returned data is done by the pypi package sc2xmlreader.

XML interface vs. MODBUS Interface

Since Solvis SC2 Centralcontroller version MA205 (or higher) the data can be retrieved via the MODBUS interface (see Solvis Heizung via Modbus auslesen und steuern)

If you have an older Centralcontroller version, MODBUS is not available. But the XML Interface is available (currently i don't know since which version of SC2 - may be someone can tell me)

Due to my own heating system, I could only test the XML interface agains a SolvisMax 6 with Solvis Remote 200. As far as I know, it should be possible to use this against other system as well, as long as there is a Solvis Remote available.

Sample integration into HA

The provided data can be integrated into HA Dashboard. Sample Dashboard for heating overview Sample Screenshot for integration into HA

Sample Dashboard for solar details Sample Screenshot for details about solar

integration into Energy Dashboard

Burner consumption and solar yield are also available in the energy dashboard (unfortunately und the label of "gas consumption" ...) To add the values, just add "burner consumption" and "solar yield" to the dashboard: Sample Screenshot in "Edit Enery Dashboard"

...and the values will be part of the enery dashboard: Sample Screenshot for integration into HA

Installation

hacs

  • Install the pypi package sc2xmlreader at your HA installation (prerequsite)
  • Install manually by copying the files in 'custom_components/solvis_heating' to a new 'custom_components/solvis_heating' directory in HA config directory.
  • Create 'customize.yaml' in config directory and add
sensor.solvis_remote_volume_stream_solar:
  unit_of_measurement: 'l/h'

sensor.solvis_remote_volume_stream_warm_water:
  unit_of_measurement: 'l/min'
  • Restart HA
  • In HA Setting - use "Add Integration" and search for Solvis
  • Configure the integration test (ui configuration)
  • Configure your dashboard

Sensors

The following sensors are available:

name Unit Description
last_update Time since latest data update.
runtime_solar_pump h Total output runtime of the solar pump.
solar_power W Current solarpower from the solar panels.
solar_pressure bar Current pressure in the solar pipes.
solar_yield kWh Total yield of the solar panels to the heating system
temperature_buffer_reference °C current refernce temperature in the buffer
temperature_H_buffer_top °C current temperature in the H buffer top
temperature_H_buffer_bottom °C current temperature in the H buffer bottom
temperature_circulation °C current temperature warm water circulation
temperature_heating_circuit_1_flow °C current flow temperature heating circuit 1
temperature_heating_circuit_2_flow °C current flow temperature heating circuit 2
temperature_outside °C current temperature out the building
temperature_solar_flow °C current flow temperature of solar heating
temperature_solar_panel °C current temperature on the solar panel(s)
temperature_solar_return °C current return temperature of solar heating
volume_solar_pump l/h current volume of fluid stream in solar heating
volume_warm_water l/min current volume of fluid stream in warm water station

Binary Sensors

The following binary sensors are available:

name Description
burner oil/gas buner started.
burner_s2 oil/gas s2 buner started
circulation_pump warm water circulation pump running
heating_circuit_1_mixer_open indicates that the heating circuit 1 increases the flow temperture
heating_circuit_1_mixer_close indicates that the heating circuit 1 decreases the flow temperture
heating_circuit_1_pump heating circuit 1 pump is running
heating_circuit_2_mixer_open indicates that the heating circuit 2 increases the flow temperture
heating_circuit_2_mixer_close indicates that the heating circuit 2 decreases the flow temperture
heating_circuit_2_pump heating circuit 2 pump is running
heating_circuit_3_pump heating circuit 3 pump is running
recovery recovery is active
solar_pump solar pump is active
solar_2_pump second solar pump is active
warm_water_station_pump warm water station pump is started

Known Issues

  • Translation
  • Modbus integration as option instead of XML when SC is supporting that
  • Additional logging (debug / setup / missing components / configuration errors)
  • Reconfigure of component
  • Solvis Brand Icon
  • assisted identification of Solvis Hardware

About

Integrate your Solvis heating (e.g. SolvisMax) via solvis remote extension into home assistant

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages