A thin Python wrapper for the KEBA KeEnergy API.
Project description
KEBA KeEnergy API
A thin Python wrapper for the KEBA KeEnergy API.
Getting started
pip install keba-keenergy-api
Usage
import asyncio
from typing import Any
from keba_keenergy_api import KebaKeEnergyAPI
from keba_keenergy_api.constants import HeatCircuitOperatingMode
from keba_keenergy_api.constants import HeatCircuit
async def main() -> None:
client = KebaKeEnergyAPI(host="YOUR-IP-OR-HOSTNAME", ssl=True)
# Get current outdoor temperature
outdoor_temperature: float = await client.get_outdoor_temperature()
# Get heat circuit temperature from heat circuit 2
heat_circuit_temperature: float = await client.heat_circuit.get_temperature(position=2)
# Read multiple values
data: dict[str, dict[str, Any]] = await client.read_values(
request=[
HeatCircuit.TEMPERATURE,
HeatCircuit.DAY_TEMPERATURE,
],
position=1,
)
# Enable "day" mode for heat circuit
await client.heat_circuit.set_operating_mode(mode=HeatCircuitOperatingMode.DAY)
# Write multiple values
await client.write_values(
request={
HeatCircuit.DAY_TEMPERATURE: 20,
HeatCircuit.NIGHT_TEMPERATURE: 16,
},
position=1,
)
asyncio.run(main())
By default, the library creates a new connection to KEBA KeEnergy API
with each coroutine. If you are calling a large number of coroutines, an aiohttp ClientSession()
can be used for connection pooling:
import asyncio
from keba_keenergy_api import KebaKeEnergyAPI
from keba_keenergy_api.constants import HeatCircuitOperatingMode
from aiohttp import ClientSession
async def main() -> None:
async with ClientSession() as session:
client = KebaKeEnergyAPI(host="YOUR-IP-OR-HOSTNAME", session=session, ssl=True)
...
asyncio.run(main())
API endpoints
Endpoint | Response | Description |
---|---|---|
.get_outdoor_temperature() |
float |
Get outdoor temperature. |
.read_values(request, position) |
Get multiple values with one http request. | |
.write_values(request, position) |
Write multiple values with one http request. |
Device
Endpoint | Response | Description |
---|---|---|
.get_name() |
str |
Get name. |
.get_serial_number() |
int |
Get serial number. |
.get_revision_number() |
int |
Get revision name. |
.get_variant_number() |
int |
Get variant name. |
Hot water tank
Endpoint | Request/Response | Description |
---|---|---|
.get_temperature() |
float |
Get temperature. |
.get_operating_mode() |
int |
Get operating mode as integer (0 is OFF , 1 is AUTO , 2 is DAY and 3 is NIGHT . |
.set_operating_mode(0) |
int |
Set operating mode. |
.get_min_temperature() |
float |
Get minimum temperature. |
.set_min_temperature(20) |
float |
Set minimum temperature. |
.get_max_temperature() |
float |
Get maximum temperature. |
.set_max_temperature(22) |
float |
Set maximum temperature. |
Heat pump
Endpoint | Response | Description |
---|---|---|
.get_status() |
int |
Get operating mode as integer (0 is STANDBY , 1 is FLOW and 2 is AUTO . |
.get_circulation_pump() |
float |
Get circulation pump in percent. |
.get_inflow_temperature() |
float |
Get inflow temperature. |
.get_reflux_temperature() |
float |
Get reflux temperature. |
.get_source_input_temperature() |
float |
Get source input temperature. |
.get_source_output_temperature() |
float |
Get source output temperature. |
.get_compressor_input_temperature() |
float |
Get compressor input temperature. |
.get_compressor_output_temperature() |
float |
Get compressor output temperature. |
.get_compressor() |
float |
Get compressor in percent. |
.get_high_pressure() |
float |
Get high pressure. |
.get_low_pressure() |
float |
Get low pressure. |
Heat circuit
Endpoint | Request/Response | Description |
---|---|---|
.get_temperature() |
float |
Get temperature. |
.get_day_temperature() |
float |
Get day temperature. |
.set_day_temperature(20) |
float |
Set day temperature. |
.get_day_temperature_threshold() |
float |
Get day temperature threshold. |
.get_night_temperature() |
float |
Get night temperature. |
.set_night_temperature(16) |
float |
Set night temperature. |
.get_night_temperature_threshold() |
float |
Get night temperature threshold. |
.get_holiday_temperature() |
float |
Get holiday temperature. |
.get_offset_temperature() |
float |
Get offset temperature. |
.set_offset_temperature(2) |
float |
Set offset temperature. |
.get_operating_mode() |
int |
Get operating mode (0 is OFF and 3 is HEAT_UP ). |
.set_operating_mode(3) |
int |
Set operating mode. |
Changelog
The changelog lives in the CHANGELOG.md document. The format is based on Keep a Changelog.
Contributing
We're happy about your contributions to the project!
You can get started by reading the CONTRIBUTING.md.
Donation
We put a lot of time into this project. If you like it, you can support us with a donation.
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
keba_keenergy_api-1.2.0.tar.gz
(19.9 kB
view hashes)
Built Distribution
Close
Hashes for keba_keenergy_api-1.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 92b980205289af376aed70eaf3e6e2bdaaec31b447c0d3bf38f44d6c905a85c1 |
|
MD5 | 2982439f8fc71ebe06d9a3d8c4854db4 |
|
BLAKE2b-256 | 257e4b0bf909c0d7f5a633754f7d1a85d08bf46f0d898e2a0791d4a16a4af5e6 |