titon

Async Python client for Titon Aura-T heat recovery ventilation (HRV) units.

The unit does not expose a local API. It keeps an outbound connection to Titon's relay at app.manageiaq.com:6275, and clients address a specific unit by its MAC address over that relay. This library speaks that protocol.

Reverse engineered from the vendor app's traffic. Unofficial and unaffiliated with Titon. The protocol may change without notice.

Install

pip install titon

The interactive console needs one extra dependency:

pip install "titon[cli]"

Usage

import asyncio

from titon import TitonClient, TitonFanSpeed


async def main():
    client = TitonClient("AA-BB-CC-11-22-33")  # your unit's MAC
    await client.connect()

    fan = TitonFanSpeed(client)
    print("current fan speed:", await fan.perform())

    await fan.set_to(3)

    client.disconnect()


asyncio.run(main())

Each capability is a small request object wrapping the client:

Console

python -m titon.cli AA-BB-CC-11-22-33

Or set TITON_HRV_MAC and omit the argument. Commands: info, fan, set fan, kitchen, set kitchen, quit. Anything else is sent as a raw DAT message.

Protocol notes

See docs/protocol.md for the message framing, checksum, and the register notes gathered so far.

Home Assistant

The Home Assistant integration built on this library lives at ULazdins/titon-has.

License

MIT