Python Qube Heat Pump Client
Asyncio client for Qube heat pumps via Modbus TCP.
Installation
pip install python-qube-heatpump
Usage
import asyncio
from python_qube_heatpump import QubeClient
async def main():
client = QubeClient("192.168.1.100", port=502, unit_id=1)
await client.connect()
state = await client.read_state()
print(f"Outside temp: {state.temp_outside}°C")
print(f"Supply temp: {state.temp_supply}°C")
print(f"DHW temp: {state.temp_dhw}°C")
await client.disconnect()
asyncio.run(main())
Features
- Async Modbus TCP client using pymodbus
- Entity definitions for sensors, binary sensors, and switches
- FLOAT32 decoding with big endian (ABCD) byte order
- Type-safe dataclasses for entity definitions
- Monotonic clamping with reset detection for the energy totals: sub-kWh jitter is clamped, while a drop of more than 1 kWh that persists for 3 consecutive reads is accepted as a counter reset (logged as a warning);
clear_monotonic_cache()forgets all baselines
Entity Definitions
The library provides pre-defined entity definitions for all Qube Modbus registers:
from python_qube_heatpump.entities import SENSORS, BINARY_SENSORS, SWITCHES
# Access entity definitions by key
temp_supply = SENSORS["temp_supply"]
print(f"Address: {temp_supply.address}, Unit: {temp_supply.unit}")
Vendor Documentation
The official Modbus register documentation from HR-Energy is available at:
- docs/modbus-lijst-qube-totaal.pdf (included in this repo)
- HR-Energy website
Related Projects
- qube_heatpump - Home Assistant HACS integration using this library
License
MIT License
1 maintainer
Metadata
1 maintainer
Release files for python-qube-heatpump 1.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_qube_heatpump-1.14.0.tar.gz | 98.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_qube_heatpump-1.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 119.0 kB
Release files / python_qube_heatpump-1.14.0.tar.gz
| Download URL | python_qube_heatpump-1.14.0.tar.gz |
|---|---|
| Size | 98.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
620ff764585ca8819764d1931abb7969bd96405ef6488785a51d65f1e697282d
|
|
BLAKE2b-256 checksum How to use checksums |
8fe21f7e88ea810dc135873fb2366c145e3abffece541a4f708b4dec1dd17c0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency logRelease files / python_qube_heatpump-1.14.0-py3-none-any.whl
| Download URL | python_qube_heatpump-1.14.0-py3-none-any.whl |
|---|---|
| Size | 20.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3806a8b34c92a5d430a6454a8d7e6393da6bbfb26ac448e87f2e7ba794a1ce09
|
|
BLAKE2b-256 checksum How to use checksums |
ec5d6aa9fb36d7870af16794183a040bcbaa60c26935e103411d8bfd80bc083e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency log
