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.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4e4d6b8bb83cbeeb25ede3baa9eb92cc0f363e26de3970a112693d1f734fac42 |
|
MD5 | af01897fe8818130fad845e8f0d3a4b7 |
|
BLAKE2b-256 | c83f862bbe7da569065b68e49ec1a3655a67276c01f4456dcd812af71362c571 |