Skip to content

About

Async Python library for Thermia heat pumps on the Genesis platform via Modbus

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

thermia-genesis

CI PyPI Python versions OpenSSF Scorecard License: MIT Coverage: 100% uv Ruff Checked with mypy Conventional Commits

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.

Installation

pip install "thermia-genesis[tmodbus]"

Usage

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.

Dump a pump

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.json

Development

Changes 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 pytest

See AGENTS.md for the workflow and docs/design.md for the design.

Disclaimer

Not affiliated with Thermia AB. Controlling a heat pump remotely is at your own risk.

License

MIT

About

Async Python library for Thermia heat pumps on the Genesis platform via Modbus

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages