Solarfocus for Home Assistant (Marketplace integration)

Installs: 84 sharing analytics
GitHub stars: 27
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 7.0.1, October 11, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: solarfocus
Source: github.com/LavermanJJ/home-assistant-solarfocus
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of LavermanJJ/home-assistant-solarfocus.

About

Solarfocus is a local Home Assistant integration for Solarfocus eco manager touch heating systems, read over Modbus TCP. It adds sensors, binary sensors, numbers, selects, buttons, a switch, a water heater and a climate entity for heating circuits. The climate entity handles heating, cooling and switching a circuit off, sets the flow temperature, and remembers the last setpoint per mode. Setup in the UI asks for host, port, polling interval, system type and API version, then how many heating circuits, buffers, boilers and solar circuits are installed, plus whether a heat pump, photovoltaic or biomass boiler is read. An option inverts the door contact reading for installations where the contact is wired the other way round. Cooling is offered only from a certain API version and turns off the controller's dew point monitoring, so that protection has to come from automations.

Automatic summary of the README and code of LavermanJJ/home-assistant-solarfocus. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Climate
Water heaters
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

NameThe name of this entry. The entities of the heating system are named after it.
HostThe hostname or IP address of the eco manager-touch.
PortThe Modbus TCP port of the controller, 502 unless it was changed.
Polling interval (s)How often every configured component is read, in seconds. Five is the lowest accepted.
Solarfocus systemWhich Solarfocus system this is. It decides which components can be selected in the next step.
Solarfocus API VersionThe version the controller shows under Fachmann - Modbus. A higher one than it runs creates entities it cannot answer.

Component Selection

Heating circuitsHow many heating circuits the controller has. Each one becomes its own set of entities.
BuffersHow many buffer tanks are installed.
BoilersHow many hot water boilers are installed.
Heat pumpWhether the heat pump of the system should be read.
PhotovoltaicWhether the photovoltaic registers should be read. Only answered if a meter is connected.
Biomass boilerWhether the biomass boiler of the system should be read.
SolarHow many solar circuits are installed. More than one needs API version 25.030 or newer.
Fresh water moduleHow many fresh water modules are installed.
CirculationHow many circulation groups are installed, one per boiler. Needs API version 25.030 or newer.
Differential control moduleHow many differential control modules are installed, each with two control loops. Needs API version 25.030 or newer.

Solarfocus connection

HostThe hostname or IP address of the eco manager-touch.
PortThe Modbus TCP port of the controller, 502 unless it was changed.
Polling interval (s)How often every configured component is read, in seconds. Five is the lowest accepted.
Solarfocus SystemWhich Solarfocus system this is. Changing it keeps the entities both systems have in common, with their history.
Solarfocus API VersionThe version the controller shows under Fachmann - Modbus. A higher one than it runs creates entities it cannot answer.

After setup

Polling interval (s)How often every configured component is read, in seconds. Five is the lowest accepted.
Heating CircuitHow many heating circuits the controller has. Each one becomes its own set of entities.
BufferHow many buffer tanks are installed.
BoilerHow many hot water boilers are installed.
Heat PumpWhether the heat pump of the system should be read.
PhotovoltaicWhether the photovoltaic registers should be read. Only answered if a meter is connected.
Biomass boilerWhether the biomass boiler of the system should be read.
SolarHow many solar circuits are installed. More than one needs API version 25.030 or newer.
Fresh water moduleHow many fresh water modules are installed.
CirculationHow many circulation groups are installed, one per boiler. Needs API version 25.030 or newer.
Differential control moduleHow many differential control modules are installed, each with two control loops. Needs API version 25.030 or newer.
Door contact reads invertedEnable only if the door contact shows open while the boiler door is closed. The door contact is wired through a terminal that can be strapped either way round, so this is a fact about one installation, not about the model of boiler.

Texts from the code of LavermanJJ/home-assistant-solarfocus.

Entities

Binary sensorsDoor contact, Pump, Relay control loop o1, Relay control loop o2, Valve, Circulator pump, Limit thermostat, Boiler charge, Defrost active, Evu lock active, Overcharge active, Overcharge possible
ButtonsCirculation, Single charge
ClimateThermostat
NumbersOutdoor temperature external, Target temperature, Indoor humidity external, Indoor temperature external, Target room temperature, Target supply temperature, Installer code input, Grid im export, Hems target electrical power, Photovoltaic, Smart meter
SelectsHolding mode, Cooling, Heating mode, Mode, Smart grid
SensorsAsh container, Boiler operating mode, Cleaning, Heat energy total, Log wood, Message number, Octoplus buffer temperature bottom, Octoplus buffer temperature top, Outdoor temperature, Pellet usage last fill, Pellet usage total, Return temperature, and 58 more
SwitchesEvu lock
Water heatersDomestic hot water

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Two Solarfocus entries for one heating system, Cannot be read from your Solarfocus system