moweb/ha-thermo-control
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
No description
6 commits 3 branches 2 tags 61 KiB
  • Python 100%
Find a file
Exact
mihai 4f7dda4f56
All checks were successful
CI / test (push) Successful in 2m12s
Details
Merge pull request 'fix: don't cancel already-fired started listener on unload' (#2) from fix/started-listener-unload into main 
Reviewed-on: #2
2026-10-16 13:21:51 +00:00
.forgejo/workflows ci: run on ubuntu-latest with setup-python 2026-10-16 15:31:21 +03:00
custom_components/thermo_control fix: don't cancel already-fired started listener on unload 2026-10-16 16:11:49 +03:00
tests feat: initial thermo_control integration 2026-10-16 15:27:34 +03:00
.gitignore chore: repository scaffold 2026-10-16 15:27:34 +03:00
hacs.json chore: repository scaffold 2026-10-16 15:27:34 +03:00
LICENSE chore: repository scaffold 2026-10-16 15:27:34 +03:00
pyproject.toml chore: repository scaffold 2026-10-16 15:27:34 +03:00
README.md chore: repository scaffold 2026-10-16 15:27:34 +03:00

README.md

Thermo Control

Home Assistant custom integration for multi-room heating with thermostatic radiator valves (TRVs) and a boiler.

Features

  • Per-room virtual thermostat climate entity that averages multiple temperature sensors
  • Hysteresis-based heat demand per room
  • Window detection with configurable delay (no demand while a window is open)
  • Presets: comfort, eco, away, boost
  • Optional Schedule helper that switches between comfort and eco
  • Timed boost switch
  • Boiler control with minimum on/off times (anti-short-cycle): demand is deferred rather than dropped
  • Diagnostic sensors: demand reason, deficit, heating time today, rooms calling for heat, boiler lockout remaining, boiler on-time today
  • Restores state after a Home Assistant restart

Installation

HACS

  1. Open HACS → Custom repositories.
  2. Add https://git.moweb.ro/moweb/ha-thermo-control with category Integration.
  3. Install Thermo Control and restart Home Assistant.

Manual

  1. Copy custom_components/thermo_control to /config/custom_components/.
  2. Restart Home Assistant.

Configuration

  1. Go to Settings → Devices & services → Add integration and choose Thermo Control.
  2. Configure the hub options:
    • Boiler climate entity
    • Heat and idle temperatures
    • Minimum on and off times
    • Hysteresis
  3. Add rooms with Add room (a subentry for each room):
    • Temperature sensors
    • TRVs
    • Window sensors and window delay
    • Optional Schedule helper
    • TRV heat and idle temperatures
    • Preset temperatures
    • Hysteresis
    • Boost duration in minutes

How it works

Room demand rules

  • Room is off or a window is open: no demand.
  • Boost active: demand.
  • Temperature ≤ target − hysteresis: demand.
  • Temperature ≥ target: no demand.
  • In between: keeps the previous demand state.

TRV setpoint

  • Room has demand: TRV set to the heat temperature.
  • Room satisfied: TRV set to target + 1.
  • Otherwise: TRV set to the idle temperature.

Development

python -m venv .venv
source .venv/bin/activate
pip install pytest-homeassistant-custom-component ruff
pytest