Custom component for integrating Solarfocus heating systems into Home Assistant.
Table of Contents
This Home Assistant custom component is a community driven effort to integrate Solarfocus heating systems to Home Assistant allowing to monitor and control heat pumps, biomass boilers, domestic hot water, buffers, solar, and more. It is not affiliated, associated, authorized, endorsed by, or in any way officially connected with the SOLARFOCUS GmbH.
Warning Use with caution, in case of doubt check with Solarfocus or your installer if a feature / functionality (e.g. cooling) is supported by your installation to avoid damages to your heating system or the building.
The project uses the Python library pysolarfocus for retrieving values via Modbus TCP from the heating system.
There is currently support for the following device types within Home Assistant:
- Sensors
- Binary Sensors
- Numbers
- Buttons
- Selects
- Water Heater
- Climate
In a first version, the climate entity only supports heating. As some heat pump installations also support cooling, this may be added at a later point in time. However, as it is possible to use a heat pump system for cooling, which is not intent for that by the way it was built, damage to the building or system from condensate is possible.
Additionally, it is only possible to set the state (preset) but not setting the supply nor room temperature. This can be done using the number entities. A later version may add control as well. For now, we leave that to the programmed heating curve from Solarfocus.
Important This integration has been tested with Solarfocus ecomanager-touch version
23.020.
Supported versions: 21.140 - 23.020. Features added in later versions are not yet supported.
The ecomanager-touch Modbus TCP specification can be found here.
The ecomanager-touch can integrate the following heating systems
- Vampair heat pumps
- Therminnator biomass boilers
- Ecotoplight / Ecotopzero biomass boilers (beta)
- Octoplus biomass boilers
| Components | Supported |
|---|---|
| Heating Circuit 1 - 8 (Heizkreis) | ✅ |
| Buffer 1 - 4 (Puffer) | ✅ |
| Solar (Solar) | ✅ |
| Boiler 1 - 4 (Boiler) | ✅ |
| Heat Pump (Wärmepumpe) | ✅ |
| Biomass Boiler (Kessel) | ✅ |
| Fresh Water Module 1 - 4 (Frischwassermodul) | ✅ |
Home Assistant v2023.1.2 or above.
You can find it in the default HACS repo. Just search Solarfocus.
- Copy all files from
custom_components/solarfocus/tocustom_components/solarfocus/inside your config Home Assistant directory. - Restart Home Assistant to install all dependencies
If you encounter issues or have any suggestions consider opening issues and contributing through PR. If you are ready to contribute to this please read the Contribution guidelines.
Currently the integration supports the following languages:
- English
- German