powersync-docs/docs/fonctionnalites/moteur.md

Comment le moteur décide

COMMUNITY

Le moteur d'énergie de la box pilote seul vos charges : bornes de recharge, chauffe-eau, pompe à chaleur SG-Ready, relais. Il est libre (GPL-3.0) et c'est lui qui décide dans la version Community. Cette page décrit sa logique pour l'installateur et l'intégrateur ; les pages suivantes détaillent chaque fonction.

Deux boucles, deux priorités

Le moteur sépare la sécurité de la répartition. Ce sont deux boucles distinctes, qui ne tournent pas au même rythme et n'ont pas la même priorité.

• La boucle de sécurité, en temps réel. À chaque variation du bilan mesuré, elle lit le courant de chaque phase au compteur de tête. Si une phase dépasse la limite configurée, elle réduit immédiatement les charges (délestage), puis relâche quand la marge revient. Elle n'attend pas le cycle et prime sur tout le reste.
• Le cycle de répartition, environ une fois par minute. Il répartit la puissance disponible entre les charges. C'est le seul endroit où une stratégie intervient : les règles intégrées, ou un optimiseur s'il est branché.

Si le compteur de tête ne répond plus, le moteur suspend la répartition et passe en repli de sécurité : sans mesure, il ne décide pas.

Les règles, dans l'ordre

À chaque cycle, le moteur applique les mêmes étapes, dans le même ordre.

1. Mesurer. Le point de départ est ce que mesure le compteur de tête. Le moteur y rajoute ce que consomment déjà les charges qu'il pilote : une charge en marche n'est pas comptée contre elle-même.
2. Tenir compte de ce qui est figé. Une charge sous verrou (durée minimale de marche ou d'arrêt, délai entre deux changements de courant) garde sa puissance engagée, et celle-ci est retirée du budget. Une charge indisponible ne reçoit aucune consigne, mais ce qu'elle consomme reste compté.
3. Servir les besoins à échéance. Une obligation quotidienne (par exemple une énergie minimale pour le chauffe-eau avant une heure donnée) ou une demande ponctuelle faite depuis l'application peut, quand l'échéance approche et que le surplus n'a pas suffi, prendre le complément sur le réseau — si l'installateur l'a autorisé.
4. Répartir le surplus en cascade. Les charges sont servies dans l'ordre de priorité que vous avez fixé (1 = servie en premier). Chacune reçoit ce qui reste du budget, dans ses bornes, et le budget est décrémenté d'autant. Le budget est unique : sans lui, trois gestionnaires verraient chacun « 2 kW de surplus » et en tireraient 6.
5. Arrêter ce qui ne peut pas démarrer. Sous sa puissance minimale, une charge reste arrêtée plutôt que de fonctionner à moitié.

Les bornes de chaque charge

Chaque charge porte des bornes saisies par l'installateur, que toute décision respecte, quelle que soit la stratégie :

• un plancher et un plafond de puissance (ou de courant, pour une borne) ;
• des verrous anti-battement : durée minimale de marche et d'arrêt, délai entre deux changements ;
• pour une PAC SG-Ready : l'état choisi selon la puissance estimée de chaque état, avec une durée minimale de maintien.

Le motif de chaque décision

Le moteur ne prend aucune décision sans en dire la raison. Chaque décision porte un motif (decisionReason) non vide : un code stable et ses paramètres, que l'application affiche dans votre langue — « surplus insuffisant », « sous la puissance minimale », « échéance de recharge »… La liste des codes est publiée avec le protocole optimiseur.

La mesure, jamais le résultat du pilotage

Le surplus est calculé sur la mesure brute : production et compteur, tels qu'ils sont mesurés. Jamais sur le bilan net après pilotage : le moteur se lirait lui-même et oscillerait.

Sans internet

Tout ce qui précède tourne sur la box. Sans internet, le moteur pilote, applique la sécurité et répond à l'application sur votre réseau local. Seule la prévision PV s'interrompt — et elle ne sert pas à décider dans la version Community, pas plus que le tarif saisi : tous deux sont affichés et enregistrés, jamais utilisés par les règles.

Et un optimiseur ?

Un optimiseur peut proposer un plan sur plusieurs heures, à partir des prévisions. Il remplace l'étape de répartition, jamais la boucle de sécurité ni les bornes. Voir la section Optimiseur.