Intégration personnalisée Home Assistant qui indique quand ouvrir ou fermer les fenêtres pour rafraîchir naturellement le logement, à partir d'une seule prévision météo (température + humidité + couverture nuageuse) et des capteurs de température / humidité de vos pièces. V1 = logique de croisement extérieur/intérieur avec hystérésis, filtre point de rosée (humidité), référence intérieure = la pièce la plus chaude du cœur traversant, et notifications texte (blueprints auto-copiés). Pas de dépendance lourde (pas de numpy / matplotlib en V1).
L'intégration interroge à intervalle régulier (15 min par défaut, réglable) la prévision horaire d'une seule entité météo, qui pilote le calcul (température + humidité, dont le point de rosée est dérivé). La couverture nuageuse (et l'ensoleillement, si la source le fournit) de cette même prévision horaire sont également récupérés et stockés, en réserve pour le futur modèle solaire de la V2, mais ne sont pas utilisés par le calcul en V1.
Important : l'entité météo choisie doit exposer une prévision horaire (
weather.get_forecasts, typehourly) incluant la couverture nuageuse (cloud_coverage) en plus de la température et de l'humidité. Open-Meteo est recommandée : elle fournit température, humidité et couverture nuageuse dans une seule entité, ce qui alimentera le futur modèle de gain solaire de la V2.
Elle combine ça avec vos capteurs de température/humidité (cœur traversant,
bureau) et l'état de la porte de balcon pour produire un verdict (open,
close, keep_closed, open_soon), une prochaine ouverture/fermeture
prévue, et une prévision d'intérieur. La référence intérieure globale est la
température de la pièce la plus chaude parmi les capteurs du cœur traversant.
Trois blueprints d'automatisation (notification, ventilateur et aération) sont
copiés automatiquement dans votre configuration au premier démarrage.
OpenWindows n'est pas (encore) dans le dépôt par défaut de HACS : ajoutez-le comme dépôt personnalisé.
- Ouvrez HACS, puis le menu (⋮) en haut à droite > Dépôts personnalisés.
- Ajoutez l'URL
https://github.com/MicPiePro/openwindows, catégorie Intégration. - Recherchez "OpenWindows" dans HACS et cliquez sur Télécharger.
- Redémarrez Home Assistant.
Vous pouvez aussi installer manuellement : copiez le dossier
custom_components/openwindows dans le dossier custom_components de votre
configuration Home Assistant, puis redémarrez.
Paramètres > Appareils et services > Ajouter une intégration > "OpenWindows", puis renseignez le formulaire :
| Champ | Description |
|---|---|
| Entité météo | Entité weather.* qui fournit la prévision horaire (température, humidité, couverture nuageuse) utilisée pour le calcul, ex. weather.home (Open-Meteo recommandée). Sélectionnez une seule entité. La prévision doit inclure la couverture nuageuse (cloud_coverage) : ces données alimentent le futur modèle solaire de la V2. |
| Capteurs de température — cœur traversant | Capteurs sensor.* (device_class température) des pièces traversantes (salon, cuisine, chambres). La référence intérieure retenue est la température la plus chaude parmi ces capteurs. |
| Capteurs d'humidité — cœur traversant | Capteurs sensor.* (device_class humidité) associés (moyenne, informatif). |
| Capteur de température — bureau | Un seul capteur sensor.* (device_class température). |
| Capteur d'humidité — bureau | Un seul capteur sensor.* (device_class humidité). |
| Capteur d'ouverture de porte | binary_sensor.* de porte/fenêtre. |
| Orientation des fenêtres principales | Point cardinal (N, NE, E, SE, S, SW, W, NW). |
Le champ météo est en sélection unique (une seule entité). Les réglages orientation, inertie des murs et ventilation sont enregistrés pour le modèle thermique de la V2 et n'ont pas encore d'effet sur le verdict en V1.
L'entrée se crée sans étape supplémentaire ; un appareil OpenWindows apparaît avec toutes les entités ci-dessous.
Depuis la carte de l'intégration, cliquez sur Configurer pour ajuster les seuils de décision sans recréer l'intégration : température de confort cible, marge d'ouverture, marge de fermeture (hystérésis), température intérieure minimale, activation du filtre d'humidité (point de rosée) et sa marge, inertie des murs, niveau de ventilation, et intervalle de mise à jour. Ces réglages ne sont pas exposés comme entités Home Assistant en V1 (pas de carte Lovelace dédiée possible) — modifiez-les via Paramètres > Appareils et services > OpenWindows > Configurer.
Toutes les entités partagent l'appareil OpenWindows et sont préfixées
openwindows_.
| Entité | Type | Description | Attributs |
|---|---|---|---|
sensor.openwindows_verdict |
sensor | Verdict global : open, close, keep_closed, open_soon ou inactive (mode Aération). |
reason, outdoor_temp, indoor_ref_temp, humidity_gate_blocking |
sensor.openwindows_next_open |
sensor (timestamp) | Horodatage de la prochaine ouverture conseillée. | — |
sensor.openwindows_next_close |
sensor (timestamp) | Horodatage de la prochaine fermeture conseillée. | — |
sensor.openwindows_predicted_indoor |
sensor (°C) | Pic d'intérieur prévu sur l'horizon de prévision. | forecast : liste {time_iso, outdoor, indoor_pred, comfort} |
sensor.openwindows_current_outdoor |
sensor (°C) | Température extérieure courante utilisée pour la décision. | dew_point |
sensor.openwindows_zone_crossvent |
sensor | Verdict de la zone "cœur traversant" (référence = pièce la plus chaude). | indoor_temp, indoor_dew_point, humidity_gate_blocking |
sensor.openwindows_zone_bureau |
sensor | Verdict de la zone "bureau". | indoor_temp, indoor_dew_point, humidity_gate_blocking |
sensor.openwindows_degrees_saved |
sensor (°C) | Degrés de chauffe intérieure évités en suivant le conseil. | — |
binary_sensor.openwindows_humidity_gate |
binary_sensor | Allumé quand le filtre d'humidité (point de rosée) bloque une ouverture. | — |
L'attribut
forecastdesensor.openwindows_predicted_indoorest une liste de points{time_iso, outdoor, indoor_pred, comfort}. En V1,indoor_predmaintient la température de référence actuelle (pas de modèle RC — voir Roadmap V2).
Depuis la v0.4.0, OpenWindows distingue deux modes saisonniers :
- Rafraîchissement : le comportement habituel (verdicts
open,close,keep_closed,open_soon) pour garder le logement frais pendant les périodes de chaleur. - Aération : hors chaleur, le conseil d'ouverture/fermeture est coupé
(verdict
inactive) et OpenWindows envoie à la place des rappels d'aération courts (3 à 5 minutes, jamais plus) à heures fixes.
En mode Rafraîchissement, le comportement est identique à la v0.3.0. Au
passage vers l'Aération, si le dernier verdict était open, un unique verdict
close (raison mode_change) est publié pour ne pas oublier des fenêtres
ouvertes.
Le mode est choisi automatiquement, avec les valeurs par défaut suivantes (toutes réglables dans les options, voir plus bas) :
- Hors saison chaude : mode Aération. La saison chaude va par défaut du
1er avril au 31 octobre inclus (options
04-01et10-31, au formatMM-JJ: mois puis jour). - Saison chaude : passage en Rafraîchissement dès que le maximum prévu sur les 48 prochaines heures atteint le seuil de chaleur (28 °C).
- Le Rafraîchissement continue tant que ce maximum reste au-dessus du seuil de fin de chaleur (25 °C). Il repasse en Aération quand le maximum reste sous ce seuil pendant 2 jours consécutifs (hystérésis).
- Sans prévision disponible, le mode courant est conservé.
Le mode peut être forcé pour une durée limitée avec
select.openwindows_mode_override (auto, force_cooling, force_airing)
et number.openwindows_override_days (1 à 14 jours, 1 par défaut). Le forçage
est mémorisé (il survit à un redémarrage) et prend fin tout seul à
l'échéance ; choisir auto le retire immédiatement.
| Entité | Type | Description | Attributs |
|---|---|---|---|
sensor.openwindows_mode |
sensor (enum) | Mode courant : cooling ou airing. |
source, override_until, reason, max_48h, in_warm_season |
sensor.openwindows_next_airing |
sensor (timestamp) | Prochain rappel d'aération (mode Aération uniquement). | slot |
select.openwindows_mode_override |
select | Forçage du mode : auto, force_cooling, force_airing. |
— |
number.openwindows_override_days |
number (jours) | Durée du prochain forçage manuel (1 à 14). | — |
event.openwindows_airing_reminder |
event | Se déclenche à chaque rappel d'aération (types morning, office). |
rooms, duration_min, outdoor_temp |
L'attribut reason du capteur de mode prend les valeurs out_of_season,
heat_forecast, heat_ongoing, heat_ending, heat_ended, no_heat,
no_forecast ou override (traduites dans l'interface).
Deux rappels sont proposés, tous deux activés par défaut et configurables (heure locale, jours de la semaine, pièces citées dans la notification) :
- Matin : 08:00, tous les jours, « Chambre et salon ».
- Bureau : 09:20, du lundi au vendredi, « Bureau ».
La durée conseillée (3, 4 ou 5 minutes) dépend de la température extérieure. Les rappels ne sont émis qu'en mode Aération. Un rappel en retard de plus de 15 minutes (Home Assistant arrêté ou en veille à l'heure prévue) est ignoré plutôt qu'envoyé à contretemps.
Configurer ouvre désormais deux étapes. La première reprend les réglages
existants et ajoute : début et fin de la saison chaude (MM-JJ), seuil de
chaleur (22 à 40 °C), seuil de fin de chaleur (18 à 35 °C) et nombre de jours
de fin de chaleur (1 à 7). Le seuil de chaleur doit être supérieur au seuil de
fin de chaleur, et le début de saison antérieur à sa fin. La seconde étape
règle les rappels du matin et du bureau (activation, heure, jours, pièces).
Un troisième blueprint est copié automatiquement avec les deux autres :
- OpenWindows - Notification d'aération : notification texte en français
à chaque déclenchement de
event.openwindows_airing_reminder, par exemple « OpenWindows : aérez chambre et salon » / « Ouvrez grand 4 min (il fait 6 °C dehors), puis refermez. », avec un bouton d'action C'est fait. Si la température extérieure est inconnue, la parenthèse est omise.
Au premier démarrage (et à chaque mise à jour), OpenWindows copie trois
blueprints d'automatisation dans
config/blueprints/automation/openwindows/ :
- OpenWindows - Notification ouverture/fermeture : notification texte en
français (sans image) quand
sensor.openwindows_verdictpasse àopenouclose, avec les températures et deux boutons d'action C'est fait / Rappel. - OpenWindows - Contrôle ventilateur : allume un ventilateur quand le
verdict passe à
open, l'éteint quand il passe àclose. - OpenWindows - Notification d'aération : notification en mode Aération (voir la section « Modes Rafraîchissement / Aération »).
Créez vos automatisations depuis Paramètres > Automatisations et scènes > Blueprints.
OpenWindows n'embarque aucun composant web personnalisé en V1. Utilisez les
cartes natives ci-dessous, plus une carte custom:apexcharts-card
(installable via HACS > Frontend) pour tracer la prévision.
type: entities
title: OpenWindows
entities:
- entity: sensor.openwindows_verdict
name: Verdict
- entity: sensor.openwindows_next_open
name: Prochaine ouverture
- entity: sensor.openwindows_next_close
name: Prochaine fermeture
- entity: sensor.openwindows_current_outdoor
name: Extérieur
- entity: sensor.openwindows_predicted_indoor
name: Intérieur prévu (pic)
- entity: sensor.openwindows_degrees_saved
name: Degrés économisés
- entity: sensor.openwindows_zone_crossvent
name: Zone traversante
- entity: sensor.openwindows_zone_bureau
name: Bureau
- entity: binary_sensor.openwindows_humidity_gate
name: Blocage humidité (point de rosée)type: markdown
title: OpenWindows — Résumé
content: >-
**Verdict : {{ states('sensor.openwindows_verdict') }}** —
{{ state_attr('sensor.openwindows_verdict', 'reason') }}
Extérieur : {{ state_attr('sensor.openwindows_verdict', 'outdoor_temp') }} °C
· Intérieur (pièce la plus chaude) :
{{ state_attr('sensor.openwindows_verdict', 'indoor_ref_temp') }} °C
Prochaine ouverture : {{ states('sensor.openwindows_next_open') }}
Prochaine fermeture : {{ states('sensor.openwindows_next_close') }}type: entities
title: OpenWindows — Zones
entities:
- entity: sensor.openwindows_zone_crossvent
name: Cœur traversant
- type: attribute
entity: sensor.openwindows_zone_crossvent
attribute: indoor_temp
name: Température (traversant)
suffix: " °C"
- type: attribute
entity: sensor.openwindows_zone_crossvent
attribute: humidity_gate_blocking
name: Humidité bloquante (traversant)
- entity: sensor.openwindows_zone_bureau
name: Bureau
- type: attribute
entity: sensor.openwindows_zone_bureau
attribute: indoor_temp
name: Température (bureau)
suffix: " °C"
- type: attribute
entity: sensor.openwindows_zone_bureau
attribute: humidity_gate_blocking
name: Humidité bloquante (bureau)type: glance
title: OpenWindows — Vue rapide
entities:
- entity: sensor.openwindows_verdict
name: Verdict
- entity: binary_sensor.openwindows_humidity_gate
name: Humidité
- entity: sensor.openwindows_degrees_saved
name: Économiséstype: gauge
entity: sensor.openwindows_predicted_indoor
name: Intérieur prévu (pic)
unit: "°C"
min: 18
max: 40
needle: true
severity:
green: 18
yellow: 25
red: 28Trace l'attribut forecast de sensor.openwindows_predicted_indoor
(extérieur vs intérieur prévu vs cible de confort).
type: custom:apexcharts-card
header:
show: true
title: OpenWindows — Prévision intérieure
show_states: true
colorize_states: true
graph_span: 24h
span:
start: hour
apex_config:
chart:
height: 260
legend:
show: true
xaxis:
type: datetime
series:
- entity: sensor.openwindows_predicted_indoor
name: Extérieur
type: line
stroke_width: 2
data_generator: |
return (entity.attributes.forecast || []).map(p => {
return [new Date(p.time_iso).getTime(), p.outdoor];
});
- entity: sensor.openwindows_predicted_indoor
name: Intérieur (prévu)
type: line
stroke_width: 2
data_generator: |
return (entity.attributes.forecast || []).map(p => {
return [new Date(p.time_iso).getTime(), p.indoor_pred];
});
- entity: sensor.openwindows_predicted_indoor
name: Confort
type: line
curve: stepline
stroke_width: 1
data_generator: |
return (entity.attributes.forecast || []).map(p => {
return [new Date(p.time_iso).getTime(), p.comfort];
});L'attribut
forecastest une liste de points{time_iso, outdoor, indoor_pred, comfort}. En V1indoor_predmaintient la température de référence actuelle (pas de modèle RC).
Une checklist pas-à-pas pour valider une installation sur une instance Home
Assistant réelle (installation HACS, ajout de l'intégration, entités,
verdict peuplé, blueprints, notification) est disponible dans
docs/VERIFICATION.md.
Non implémenté en V1, prévu dans un plan dédié : modèle thermique RC à
2 nœuds (numpy) pour une vraie prévision indoor_pred, PNG matplotlib inséré
dans la notification, auto-calibration de τ à partir de l'historique du
recorder, terme solaire via Open-Meteo, et carte Lovelace "hero" empaquetée
en option.