Source code for steamloop.const

"""Constants and enums for the steamloop thermostat protocol."""

from __future__ import annotations

from enum import IntEnum




class ZoneMode(IntEnum):
    """HVAC zone operating mode."""

    OFF = 0
    AUTO = 1
    COOL = 2
    HEAT = 3





class FanMode(IntEnum):
    """Fan operating mode."""

    AUTO = 1
    ALWAYS_ON = 2
    CIRCULATE = 3





class HoldType(IntEnum):
    """
    Temperature hold type.

    UNDEFINED: No hold type set.
    MANUAL: Manual override by user (permanent hold).
    SCHEDULE: Following the programmed schedule.
    HOLD: Hold until next scheduled period.
    """

    UNDEFINED = 0
    MANUAL = 1
    SCHEDULE = 2
    HOLD = 3



DEFAULT_PORT = 7878
HEARTBEAT_INTERVAL = 55  # seconds (thermostat expects every 60s)
CONNECT_TIMEOUT = 10
PAIRING_TIMEOUT = 120
RESPONSE_TIMEOUT = 10
INITIAL_STATE_TIMEOUT = 1  # seconds to wait for initial state after login
RECONNECT_DELAY = 5  # initial delay before first reconnect attempt
RECONNECT_MAX = 300  # max delay between reconnect attempts (5 minutes)
BACKOFF_FACTOR = 2  # multiply delay by this on each failure