Documentation officielle

🇬🇧 EN

Guide d'utilisation
de Scheater

Scheater est votre assistant de configuration de plannings de chauffe pour Home Assistant. Ce guide vous accompagne pas à pas, de l'installation initiale jusqu'aux fonctionnalités avancées.

Home AssistantPlannings de chauffeThermostat TPIGestion d'énergieAbsences
🏠

Pas encore installé ? Ajoutez le dépôt de l'add-on à votre instance Home Assistant en un clic :

Ajouter à Home Assistant

Si la boîte de dialogue ne se pré-remplit pas (cela dépend de votre version de Home Assistant), ajoutez le dépôt manuellement : https://github.com/Ninho67/ScheaterAddOn dans Paramètres › Modules complémentaires › Boutique des modules › ⋮ › Dépôts.

01

Configuration de la sonde extérieure

La première étape indispensable est de connecter Scheater à votre sonde de température extérieure. Cette information est utilisée par l'algorithme de régulation pour optimiser le chauffage en fonction des conditions climatiques réelles.

0
Depuis la page principale de Scheater, accédez au menu Parameters dans la barre de navigation gauche.
1
Cliquez sur la section Temperatures.
2
Dans le formulaire, saisissez le nom de l'entité représentant votre sonde de température externe. Récupérez-la depuis votre instance Home Assistant et collez-la dans ce champ.
3
Cliquez sur OK pour valider.
Fenêtre de configuration du capteur de température extérieure
✅
Une fois la sonde configurée, la température extérieure s'affiche sur la page d'accueil (menu Schedules), confirmant que la connexion avec Home Assistant est opérationnelle.
02

Créer et configurer des zones

Qu'est-ce qu'une zone ?

Une zone n'est pas nécessairement égale à une pièce. Dans les maisons avec des espaces communicants, plusieurs pièces partagent le même volume d'air et gagneront à être régulées ensemble. Une zone représente donc une pièce ou un groupe de pièces selon l'organisation de votre logement.

Créer une zone

0
Allez dans Parameters › Zones.
1
Cliquez sur le bouton + pour ouvrir le formulaire de création.
2
Donnez un nom à votre zone (ex. : Living Room).
3
Assignez des utilisateurs. Par défaut, l'utilisateur Family représente l'ensemble du foyer. D'autres utilisateurs peuvent être créés ultérieurement (voir section Absences).
4
Le champ radiateurs peut rester vide pour l'instant. Vous l'alimenterez après avoir créé vos radiateurs. Cliquez OK.
Formulaire de création d'une zone de chauffe
ℹ️
Après création, la zone apparaît sur la page d'accueil sous forme de carte. Elle est vide tant qu'aucun radiateur ne lui est assigné — c'est normal.
03

Configurer les radiateurs

Un radiateur dans Scheater est la représentation d'un équipement de chauffage physique, connecté à Home Assistant via plusieurs entités.

Création d'un radiateur

0
Allez dans Parameters › Heaters et cliquez sur le +.
1
Donnez un nom explicite au radiateur, idéalement relatif à sa position (ex. : Living Room – South). Ce nom vous permettra de l'identifier sans ambiguïté.
2
Sélectionnez la zone à laquelle ce radiateur appartient.

Entités à configurer

Champ Description Obligatoire
Puissance (W) Puissance nominale du radiateur (ex. : 1200). Requis uniquement si vous utilisez le suivi de consommation énergétique. Non
Entité de température Sonde mesurant la température locale du radiateur. Plusieurs radiateurs peuvent partager la même sonde. Oui
Entité fenêtre / porte Capteur d'ouverture permettant de suspendre la régulation automatiquement lorsqu'une fenêtre ou porte est ouverte. Non
Entité switch Entité Home Assistant qui pilote l'alimentation du radiateur. Oui
🧪
Test d'entité intégré : Chaque champ dispose d'un bouton vert ▶ permettant de tester l'entité en temps réel. Un message vert confirme la lecture correcte ; un message rouge signale une erreur de configuration.
Formulaire d'ajout d'un radiateur

Paramètres de régulation

Inversion de la logique du switch : Définit si le switch doit être mis sur ON pour activer le radiateur, ou sur OFF (logique inversée). Configurez ce paramètre selon le comportement de votre équipement.

Algorithme TPI (Time Proportional Integral) : L'algorithme de régulation repose sur deux coefficients, C et T. Les valeurs par défaut fournies par Scheater conviennent à la plupart des installations. Vous pouvez les ajuster pour améliorer les performances thermiques, notamment en fonction du niveau d'isolation de la pièce.

📚
Pour en savoir plus sur l'algorithme TPI, consultez les ressources disponibles en ligne. C'est un algorithme largement répandu dans la régulation thermique.
Réglages TPI d'un radiateur (coefficients, période)
04

Comprendre le Dashboard

Une fois vos zones et radiateurs configurés, la page principale (menu Schedules) devient un tableau de bord complet donnant une vue en temps réel de l'ensemble de votre installation.

Carte de zone

Chaque zone est représentée par une carte affichant la température moyenne de la zone. La zone droite de la carte présente un diagramme d'acquisition des températures moyennées sur les deux dernières heures.

Carte d'une zone sur le tableau de bord Scheater
⏱️
Attendez environ 10 minutes après la configuration pour voir apparaître les premières acquisitions sur le graphique.

Indicateurs visuels

Icône Couleur Signification
Warning (clignotant) Orange Maintenance (ex. : pile presque vide)
Warning (clignotant) Rouge Erreur grave détectée (ex. : capteur hors service, pile vide)
Fenêtre Orange Une fenêtre ou porte est ouverte — thermostat en pause
Flamme Orange Le radiateur est actuellement en cycle de chauffe

Détail par radiateur

Cliquez sur les trois points (⋯) dans le coin supérieur droit de la carte pour accéder au détail de chaque radiateur de la zone :

  • Niveau de batterie du capteur de température
  • Offset de température appliqué au radiateur (voir section Offsets de température)
  • Température exacte du radiateur (vs. température moyenne de zone)
  • Messages d'erreur (ex. : Sensor error)
Fenêtre popup du tableau de bord Scheater

Modes de confort

Le bouton en bas à gauche de chaque carte permet de basculer rapidement entre trois modes :

Mode Effet sur la consigne
NormalTempérature de planning appliquée
Confort+2 °C par rapport à la consigne
Éco−2 °C par rapport à la consigne
⚙️
Les offsets Confort et Éco sont personnalisables dans Parameters › Temperatures. Voir la section Températures système.
⚠️
Les informations affichées sur le dashboard peuvent ne pas être à jour. Toutes les conditions de régulations sont ré-évaluées périodiquement en interne et l'affichage ne sera mis à jour que lors de leur prise en compte. Ainsi, la prise en compte d'une absence peut prendre jusqu'à 10 secondes et l'application d'une nouvelle consigne jusqu'à 10 minutes si un cycle de chauffe est est en cours.
05

Plannings de chauffe

Concept des time slots

Scheater fonctionne par time slots (créneaux horaires). Chaque time slot définit une température à appliquer à partir d'une heure donnée. Il n'y a pas de date de fin : c'est l'enchaînement des créneaux qui constitue le planning.

Par défaut, une seule entrée couvre toute la semaine à 12 °C. C'est votre point de départ à personnaliser.

Créer un time slot

0
Sur le dashboard, cliquez sur l'icône de calendrier dans le bandeau de la carte de la zone souhaitée.
1
Cliquez sur le + en haut à droite.
2
Sélectionnez le jour ou groupe de jours : jour spécifique, Semaine (lun-dim), Jours de semaine (lun-ven), ou Week-end (sam-dim).
3
Définissez l'heure de début du créneau (ex. : 06:00).
4
Sélectionnez la température de consigne souhaitée (ex. : 18 °C) et cliquez OK.
Formulaire d'ajout d'une plage horaire au planning

Visualisation calendrier

Cliquez sur l'icône calendrier en haut à gauche de la page de planning pour afficher une vue hebdomadaire complète des températures de consigne. Cette vue facilite la détection des erreurs de configuration.

Vue calendrier du planning de chauffe

Règles de priorité

Lorsque des time slots se superposent (ex. : un créneau Semaine, un créneau Week-end et un créneau Samedi pour le même moment), Scheater applique la règle de priorité suivante :

Semaine (fallback)
→
Jours de semaine / Week-end
→
Jour spécifique (priorité max)

La configuration la plus spécifique l'emporte toujours.

06

Activation et modes de régulation

Il est possible d'activer ou désactiver la régulation de chaque zone, et de définir une plage d'activité. Accédez à ces paramètres via la roue dentée ⚙ en haut à droite du planning de chauffe.

Mode Description
Permanent La régulation est active en continu, sans limite de date.
Annuel Deux dates définissent une plage active chaque année, indépendamment de l'année.
Ponctuel Deux dates précises incluant l'année. La régulation sera inactive l'année suivante.
Désactivé La régulation est coupée manuellement.
⚠️
Scheater ne coupe jamais les thermostats. Désactiver la régulation applique une consigne de 12 °C par défaut sur toutes les zones, évitant tout risque de gel dans la tuyauterie.
Formulaire d'activation d'un planning
07

Gérer les absences

La gestion des absences permet de réduire automatiquement la température des zones liées à un utilisateur absent, sans couper entièrement la régulation.

Créer des utilisateurs

0
Allez dans Parameters › Users. L'utilisateur Family est présent par défaut et ne peut pas être supprimé.
1
Cliquez sur +, saisissez le nom de l'habitant (ex. : Frank) et validez.
2
Assignez cet utilisateur à une zone via Parameters › Zones en sélectionnant son nom dans le champ Users.
📥
Pour chaque utilisateur, il est possible de lier une absence à une entité Home Assistant — un input_boolean ou une binary_sensor. Quand l'entité passe à on, Scheater déclenche l'absence automatiquement.

Programmer une absence

0
Accédez au menu Absences dans la barre gauche.
1
Cliquez sur + et donnez un nom unique à l'absence (ex. : Vacances Frank).
2
Sélectionnez les dates de début et de fin, choisissez l'utilisateur concerné, puis validez.
🌡️
En cas d'absence, Scheater applique une température de 14 °C (configurable) dans les zones liées à l'utilisateur absent — la régulation n'est jamais coupée complètement.
Vue de gestion des absences
08

Contrôle manuel temporaire

Le contrôle manuel permet d'appliquer une température ponctuelle à un ou plusieurs radiateurs d'une zone, pour une durée définie, sans modifier le planning permanent.

Cas d'usage typique : chauffer rapidement une salle de bains avant d'y entrer, sans modifier le planning de base.

⏱️
Prévoyez au minimum 20 minutes de préchauffage pour que la pièce atteigne la température souhaitée.
0
Sur le dashboard, repérez la carte de la zone concernée et cliquez sur l'icône ▶ dans le bandeau.
1
Dans le menu qui s'ouvre, sélectionnez le(s) radiateur(s) à contrôler, définissez la température souhaitée et la durée.
2
Cliquez OK. La carte indique alors que le radiateur est en contrôle manuel et affiche un compte à rebours.

À l'expiration du délai, le radiateur reprend automatiquement la température définie dans le planning.

Formulaire de dérogation temporaire de température pour une zone Carte de zone avec une dérogation de température active
✋
Il est possible d'interrompre un contrôle manuel sur simple appui du bouton stop sur la carte de la zone.
09

Suivi de consommation énergétique ✦ Premium

Scheater intègre un module de suivi de consommation qui estime les coûts d'exploitation de vos radiateurs en temps réel.

Configuration

Accédez à Parameters › Power Consumption et activez la fonctionnalité. Vous pourrez ensuite paramétrer :

  • Devise : EUR ou CHF
  • Type de forfait : tarif fixe, ou heures creuses / heures pleines
  • Coût au centime par Watt-heure pour chaque tarification
  • Plages horaires heures pleines / creuses, configurées comme les plannings de chauffe (time slots)
Réglages du suivi de consommation électrique
💡
La puissance nominale (en watts) doit avoir été saisie pour chaque radiateur dans le formulaire Heaters pour que le calcul soit précis.

Dashboard énergétique

Accessible depuis le menu de gauche, ce tableau de bord affiche :

  • Énergie totale consommée depuis l'activation de la régulation
  • Estimation des coûts associés
  • Consommation du jour en cours
  • Graphique de consommation par radiateur
  • Graphique de consommation par jour, mois ou année
  • Possibilité d'afficher les données en facturation monétaire
Tableau de bord de consommation électrique
10

Sauvegarde et restauration ✦ Premium

La fonction de sauvegarde permet d'exporter toute votre configuration en un seul fichier, et de la restaurer en cas de besoin.

Accédez à Parameters › Backup.

Action Description
Export Télécharge un fichier contenant plannings, radiateurs, zones, absences et paramètres généraux.
Import Restaure une configuration depuis un fichier de sauvegarde préalablement exporté.
ℹ️
Attention : L'importation écrase intégralement la configuration existante de votre instance Scheater. Assurez-vous d'importer le bon fichier.
11

Offsets de température par radiateur ✦ Premium

Au sein d'une même zone (volume partagé), certains radiateurs peuvent être plus petits ou certaines zones moins bien isolées. Appliquer une consigne identique à tous les radiateurs peut entraîner une surchauffe ou une sous-chauffe localisée.

L'offset permet de corriger cela en ajoutant ou retirant quelques degrés à la consigne d'un radiateur spécifique.

Configurer un offset

0
Allez dans Parameters › Zones et sélectionnez la zone concernée.
1
En bas du formulaire, retrouvez la liste des radiateurs de la zone avec leurs offsets.
2
Utilisez les boutons + et − pour ajuster l'offset de chaque radiateur.
ℹ️
Exemple : Consigne de zone = 16 °C. Offset +2 °C → radiateur régulé à 18 °C. Offset −2 °C → radiateur régulé à 14 °C. L'offset est visible dans la popup de détail de chaque carte du dashboard.
Formulaire de décalage de température par zone
12

Températures système ✦ Premium

Plusieurs températures appliquées automatiquement par Scheater sont configurables dans Parameters › Temperatures.

Paramètre Valeur par défaut Description
Température d'absence 14 °C Consigne appliquée dans les zones d'un utilisateur absent.
Température régulation désactivée 12 °C Consigne de sécurité appliquée lorsque la régulation est manuellement désactivée.
Offset mode Confort +2 °C Augmentation de consigne lors du passage en mode Confort.
Offset mode Éco −2 °C Réduction de consigne lors du passage en mode Éco (valeur déduite).
⚠️
Pour le mode Éco, la valeur configurée est déduite de la consigne.
Formulaire des réglages de température
13

Auto-tuning des coefficients ✦ Premium

La fonction Auto-tune adapte automatiquement les coefficients TPI de chaque radiateur en fonction des performances thermiques réelles de la pièce. Cela permet une régulation optimisée et évite les cycles de chauffe inutiles.

Activation

0
Allez dans Parameters › Heaters et sélectionnez le radiateur souhaité.
1
Dans la section Régulation, activez le bouton Auto-tune.

Une fois activé, Scheater ajustera progressivement les coefficients en analysant le comportement thermique de la zone, en particulier en fonction du niveau d'isolation.

✨
L'auto-tuning est particulièrement recommandé pour les installations avec des caractéristiques thermiques hétérogènes (pièces de tailles différentes, expositions variées, isolations inégales).
Activation de l'auto-tuning des coefficients
14

Gestion de licence

La version gratuite de Scheater est limitée à 5 radiateurs. Une clé de licence Premium débloque un nombre de radiateurs illimité, ainsi que toutes les fonctionnalités marquées ✦ Premium dans cette documentation (consommation, sauvegarde, offsets, températures système, auto-tuning). Les clés s'achètent sur la page tarifs.

Activer votre licence

0
Après achat sur la page tarifs, vous recevez votre clé de licence par email (paiement sécurisé via Lemon Squeezy).
1
Dans Home Assistant, allez dans Paramètres › Modules complémentaires › Scheater › Configuration.
2
Collez votre clé dans le champ license_key et enregistrez.
3
Redémarrez l'add-on. Scheater active automatiquement la licence au démarrage.
✅
Vérifiez l'activation dans Scheater : Parameters › Fonctionnalités Premium. L'icône d'état d'activation passe au vert dès que la licence est reconnue.

Suivre le statut de votre licence

La section Parameters › Fonctionnalités Premium affiche en temps réel :

Champ Signification
État d'activation Vert si les fonctions Premium sont actives. Le bouton à côté force une revalidation immédiate auprès du serveur de licence.
Statut de la licence État brut renvoyé par le serveur : Active, Inactive, Expired ou Disabled.
Dernière vérification Horodatage de la dernière revalidation réussie — sert de référence pour le fonctionnement hors-ligne (voir ci-dessous).
Date d'expiration Affichée uniquement si votre licence a une date d'échéance (abonnement). Absente pour une licence à vie.

Fonctionnement hors-ligne

Scheater a vocation à continuer de chauffer votre logement même en cas de problème réseau : une coupure internet ne doit jamais désactiver vos fonctionnalités Premium du jour au lendemain. Si votre instance Home Assistant perd l'accès à internet, les fonctions Premium restent actives pendant 30 jours à partir de la dernière vérification réussie — largement de quoi tenir un long week-end, voire plus, sans connexion.

Limite d'activations & libérer une instance

Chaque clé de licence ne peut être activée que sur un nombre limité d'installations à la fois. Si vous réinstallez Home Assistant, restaurez une sauvegarde ou changez de matériel, l'ancienne installation continue de compter comme une instance active tant que vous ne la libérez pas.

Libérer une instance

0
Sur l'installation que vous retirez, allez dans Parameters › Fonctionnalités Premium.
1
Cliquez sur Libérer cette instance et confirmez.
2
Les fonctions Premium sont coupées immédiatement sur cette installation, et l'emplacement d'activation est libéré pour votre nouvelle installation (ou toute autre).
⚠️
Il n'y a pas de récupération automatique par expiration : si vous oubliez de libérer une ancienne instance et atteignez la limite d'activations, contactez le support avec votre clé de licence.

Engagement de sortie

Si Scheater venait à être abandonné, ou si le service de licence cessait de fonctionner, une version finale de l'add-on avec toutes les fonctions Premium débloquées et sans vérification de licence sera publiée sur GitHub. Vous ne vous retrouverez jamais avec une installation bloquée parce que le projet ou son service de licence a disparu.