pysolarfocus 3.6.0

Unofficial, local Solarfocus client

pysolarfocus: Python Client for Solarfocus eco^{manager-touch}

Python client library to interact with heating systems of Solarfocus (eco^{manager-touch} and thermi^nator II) via Modbus TCP. This library has been developed for the integration into Home-Assistant via a custom integration, but can be used indepdently.

What's Supported

Software Version

This integration has been tested with Solarfocus eco^{manager-touch} version 23.020.

Systems

• Heat pump vamp^air with eco^{manager-touch}
• Biomass boiler thermi^nator II

Components

Components	Supported
Heating Circuits (Heizkreis) 1-8	:white_check_mark:
Buffers (Puffer) 1-4	:white_check_mark:
Solar (Solar)	:white_check_mark:
Boilers (Boiler) 1-4	:white_check_mark:
Heatpump (Wärmepumpe)	:white_check_mark:
Biomassboiler (Kessel)	:white_check_mark:
Fresh Water Module (Frishwasser Modul) 1-4	:white_check_mark:

How To

Basic Example

from pysolarfocus import SolarfocusAPI,Systems

# Create the Solarfocus API client
solarfocus = SolarfocusAPI(ip="[Your-IP]",system=Systems.Vampair)
# Connect to the heating system
solarfocus.connect() 
# Fetch the values
solarfocus.update()

# Print the values
print(solarfocus.buffers[0])
print(solarfocus.heating_circuit[0])

Handling multiple components e.g. heating circuits

Solarfocus systems allow the use of multiple heating circuits, buffers and boilers. The api can be configured to interact with multiple components.

# Create the Solarfocus API client with 2 Heating Circuits
solarfocus = SolarfocusAPI(ip="[Your-IP]",heating_circuit_count=2,system=Systems.Vampair)
# Connect to the heating system
solarfocus.connect()

# Update all heating circuits
solarfocus.update_heating()

# Update only the first heating circuit
solarfocus.heating_circuits[0].update()
# Print the first heating circuit
print(solarfocus.heating_circuits[0])

# Set the temperature of the first heating circuit to 30°C
solarfocus.heating_circuits[0].indoor_temperatur_external.set_unscaled_value(30)
# Write the value to the heating system
solarfocus.heating_circuits[0].indoor_temperatur_external.commit()

API-Version specification

By default, the integration uses API-Version21.140. If your system is newer, you can specify the version by using the api_version parameter.

solarfocus = SolarfocusAPI(ip="[Your-IP]", system=Systems.Vampair, api_version=ApiVersions.V_23_010)

Changelog of API-Versions

Note The API-Version of Solarfocus is independent of the versions of this library. Below list refers to to the Solarfocus versions. See releasesfor the changelog of this library.

23.040

• Add fresh water module state.

23.010

• Add biomass boiler pellet statistics.

22.090

• Add biomass boiler sweep function control.
• Allow input of external buffer values.