Async Python library for Thermia heat pumps on the Genesis platform (Atlas, Calibra,
Calibra E, Calibra Cool, Calibra RXT, Diplomat Inverter), using Modbus via
modbus-connection.
Status: early development. Genesis firmware 17.1 is targeted; 18.0 reads the same.
This library powers the Thermia Genesis Home Assistant integration.
pip install "thermia-genesis[tmodbus]"import asyncio
from modbus_connection import ModbusTcpParams
from modbus_connection.tmodbus import ModbusConnection
from thermia_genesis import ThermiaGenesis
async def main() -> None:
connection = ModbusConnection(ModbusTcpParams(host="192.0.2.10"), timeout=5)
await connection.connect()
try:
# On Modbus TCP the Genesis controller ignores the unit id.
pump = ThermiaGenesis(connection.for_unit(1))
report = await pump.async_update()
print(report.complete, pump.firmware_version, pump.heat_pump.outdoor_temperature)
finally:
await connection.close()
asyncio.run(main())A few settings can be written; the pump applies them on its own terms and the next update reads back what it accepted:
from thermia_genesis.v17_1.heat import Heat
await pump.heat.write(Heat.comfort_wheel_setting, 21.5)Heat.comfort_wheel_setting.writable tells whether a field can be written, .validator
what it accepts (Between(low=10, high=40), or None) and .resolution its step (0.01). Writing a
setting changes how the pump runs; only write what you understand.
thermia-genesis dump reads every register the pump has and writes JSON: the firmware, the
optional parts it found, the raw registers and the decoded values. Attach it to a bug report.
thermia-genesis dump 192.0.2.10 --output pump.jsonChanges are made in git worktrees under .worktrees/, and the tools run in the
repository's devcontainer:
git config worktree.useRelativePaths true
git worktree add .worktrees/my-change -b my-change origin/main
devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . uv run --directory .worktrees/my-change pytestSee AGENTS.md for the workflow and docs/design.md for the
design.
Not affiliated with Thermia AB. Controlling a heat pump remotely is at your own risk.
MIT