🐍 IDM Heatpump API – Die Python-Bibliothek
Die IDM Heatpump API ist die asynchrone Python-Bibliothek, die die IDM Heatpump HASS Integration antreibt. Sie kann aber auch eigenständig für beliebige Python-Projekte genutzt werden.
📦 Installation
pip install idm-heatpump-api
🔑 Features
- Asynchron – Voll async via pymodbus mit Auto-Reconnect
- Auto-Detection – Erkennt Modell, Heizkreise, Zone-Module, Solar, ISC, PV und Kaskade automatisch
- 100+ Register – Temperaturen, Energiewerte, Status, Heizkreise A-G, Zone-Module, Solar, ISC, Kaskade, Booster
- Batch-Reads – Intelligentes Gruppieren für maximale Effizienz
- Write-Support – Sicheres Schreiben mit Validierung, Min/Max-Grenzen und EEPROM-Schutz
- Metadata – Jedes Register enthält HA-Mapping-Informationen (binary, state_class, icon, etc.)
💻 Schnellstart
import asyncio
from idm_heatpump import IdmModbusClient, build_register_map
async def main():
client = IdmModbusClient(host="192.168.1.100", port=502)
try:
await client.connect()
model = await client.detect_model()
print(f"Erkannt: {model.model_name} (FW {model.firmware_version})")
registers = build_register_map(model_info=model)
values = await client.read_batch(list(registers.values()))
for name, value in sorted(values.items()):
print(f" {name}: {value}")
finally:
await client.disconnect()
📋 Unterstützte Modelle
- IDM Navigator 10 – NAV10_20.23+ (2025), bestätigt
- IDM Navigator 2.0 – Alle Versionen, bestätigt
- IDM Navigator Pro – Alle Versionen, bestätigt
🔗 GitHub | PyPI | Dokumentation