Unofficial, local Solarfocus client
Project description
pysolarfocus: Python Client for Solarfocus ecomanager-touch
Python client library to interact with heating systems of Solarfocus (ecomanager-touch and therminator 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 ecomanager-touch version 23.020
.
Systems
- Heat pump vampair with ecomanager-touch
- Biomass boiler therminator 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pysolarfocus-3.6.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82f5520d258851dd5df16403b796a0fff1433d244268272b118dfd9427471342 |
|
MD5 | eb70948587ea4faf5409463be003ab66 |
|
BLAKE2b-256 | 5938dae69f0169fe013c437d436aedc75ccb870826e9efa166aed6c59bb54f7e |