pysolarfocus 3.5.0

Unofficial, local Solarfocus client

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

What's Supported

Software Version

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

Added biomass boiler pellet statistics (available since version 23.010). To have them available, choose the respective API version when instantiating the client:

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

Systems

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

Solarfocus 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:

Usage

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()