Il repository `home-assistant-termogea` e una custom integration Home Assistant orientata a un caso reale: controllare impianti Termogea in locale, con logica di presenza persone e gestione multi-zona persistente. Non e un prototipo minimo, ma una base operativa con config flow, storage e servizi dedicati.

Architettura: integrazione locale e polling controllato

Nel `manifest.json` l'integrazione dichiara `integration_type: hub` e `iot_class: local_polling`. Questo significa che il dialogo con il controller avviene sulla rete locale e che lo stato viene aggiornato con un ciclo di polling configurabile (default 30 secondi, range 10-300).

Dal punto di vista operativo e un vantaggio importante: minore dipendenza da cloud esterni e comportamento piu prevedibile in ambienti residenziali o office.

Entita esposte: climate, sensor e binary_sensor

• Entita `climate` per ogni zona con mapping completo
• Supporto a target temperature e modalita heat/off dove disponibile
• Sensori di policy per capire target effettivo, modalita attiva e zone configurate
• Binary sensor per stato presenza persone, presenza rilevata e abilitazione zona

In pratica non hai solo il controllo temperatura: hai anche telemetria utile per dashboard e troubleshooting della logica di automazione.

Config flow e persistenza: meno YAML, piu governance

Il progetto usa `config_flow` e `options flow` per gestire connessione, impostazioni globali, zone, schedule e mapping registri. La persistenza e gestita da storage interno (`TermogeaStorageManager`) e include anche import legacy da YAML.

Questo approccio riduce errori manuali, rende le modifiche piu tracciabili e facilita la manutenzione quando il numero di zone cresce.

Policy di zona: persone, sensori e fallback termici

Uno dei punti piu interessanti e il motore di policy: ogni zona puo combinare persone assegnate, sensore di presenza e parametri come common area, manual override e preset termici (comfort, eco, away, night, inactive).

Quando l'integrazione applica una policy, calcola decisione e target effettivo e poi scrive i registri necessari sul controller (setpoint e, se previsto, stato HVAC).

Servizi utili in esercizio

• `termogea.apply_zone_policy` per applicare la policy a una singola zona
• `termogea.apply_all_zone_policies` per riallineare tutte le zone
• `termogea.force_relogin` per forzare una nuova autenticazione
• `termogea.import_legacy_yaml` per migrazione configurazioni pregresse

Sono servizi pratici in fase di commissioning e nelle attivita di supporto, perche permettono di validare rapidamente comportamento e coerenza stato.

Perche questo repository e rilevante per progetti reali

Per chi integra automazione edificio e software su misura, `home-assistant-termogea` mostra un pattern solido: logica locale, configurazione via UI, policy esplicite, telemetria leggibile e migrazione da legacy. E una base concreta per ridurre attrito operativo e aumentare controllabilita nel tempo.

Repositoryhttps://github.com/Cobracco/home-assistant-termogea