Home Assistant Solarfocus ecomanager-touch integration
Custom component for integrating Solarfocus heating systems into Home Assistant.
Table of Contents
1. [About](#about) 2. [Home Assistant Device Types](#home-assistant-device-types) 3. [Supported Solarfocus Software and Hardware](#supported-solarfocus-software-and-hardware) 4. [Getting Started](#getting-started) - [Prerequisites](#prerequisites) - [HACS Installation](#hacs-installation) - [Manual Installation](#manual-installation) - [Integration Setup](#integration-setup) 5. [Contribution](#contribution) 6. [Localization](#localization)About
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.
Home Assistant Device Types
There is currently support for the following device types within Home Assistant:
- Sensors
- Binary Sensors
- Numbers
- Buttons
- Selects
- Water Heater
- Climate
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.
Supported Solarfocus Software and Hardware
Software
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.
Hardware
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) | :white_check_mark: |
| Buffer 1 - 4 (Puffer) | :white_check_mark: |
| Solar (Solar) | :white_check_mark: |
| Boiler 1 - 4 (Boiler) | :white_check_mark: |
| Heat Pump (Wärmepumpe) | :white_check_mark: |
| Biomass Boiler (Kessel) | :white_check_mark: |
| Fresh Water Module 1 - 4 (Frischwassermodul) | :white_check_mark: |
Getting Started
Prerequisites
Home Assistant v2023.1.2 or above.
HACS Installation
You can find it in the default HACS repo. Just search Solarfocus.
Manual Installation
- Copy all files from
custom_components/solarfocus/tocustom_components/solarfocus/inside your config Home Assistant directory. - Restart Home Assistant to install all dependencies
Integration Setup
Contribution
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.
Localization
Currently the integration supports the following languages:
- English
- German