Home Assistant Solarfocus eco^{manager-touch} integration

Custom component for integrating Solarfocus heating systems into Home Assistant.

Table of Contents

1. About
2. Home Assistant Device Types
3. Supported Solarfocus Software and Hardware
4. Getting Started
   • Prerequisites
   • HACS Installation
   • Manual Installation
   • Integration Setup
5. Contribution
6. 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 eco^{manager-touch} version 23.020.

Supported versions: 21.140 - 23.020. Features added in later versions are not yet supported.

The eco^{manager-touch} Modbus TCP specification can be found here.

Hardware

The eco^{manager-touch} can integrate the following heating systems

• Vamp^air heat pumps
• Thermin^nator biomass boilers
• Ecotop^light / Ecotop^zero biomass boilers (beta)
• Octo^plus 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)	✅

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/ to custom_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