From 0b8ccc6c9d44c65fb19e33ec113cf3c826f7c813 Mon Sep 17 00:00:00 2001 From: Patrick Schurig Date: Sun, 18 Oct 2026 13:10:46 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20pr=C3=A9vision=20PV,=20FAQ=20et=20accue?= =?UTF-8?q?il=20renvoient=20=C3=A0=20la=20section=20Optimiseur?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Prévision PV, « Et un optimiseur ? » : le protocole existe et est publié, la connexion est en test (« en cours de développement » n'était plus exact) ; lien vers la section. FAQ, open source : « socle (powersync-core) », ancien nom, devient le moteur d'énergie (etm-powersync-energy-plugin-etm) ; protocole ouvert, optimiseur de référence et suite de conformité mentionnés. Accueil : liens vers « Comment le moteur décide » et la section Optimiseur. Trois langues. Co-Authored-By: Claude Opus 5.5 --- docs/faq.de.md | 17 ++++++++++------- docs/faq.en.md | 16 +++++++++------- docs/faq.md | 17 ++++++++++------- docs/fonctionnalites/prevision-pv.de.md | 11 +++++++---- docs/fonctionnalites/prevision-pv.en.md | 11 +++++++---- docs/fonctionnalites/prevision-pv.md | 11 +++++++---- docs/index.de.md | 4 +++- docs/index.en.md | 4 +++- docs/index.md | 4 +++- 9 files changed, 59 insertions(+), 36 deletions(-) diff --git a/docs/faq.de.md b/docs/faq.de.md index 891e5c2..41db5b9 100644 --- a/docs/faq.de.md +++ b/docs/faq.de.md @@ -14,13 +14,16 @@ Option. ## Ist das Projekt Open Source? -Die Basis (`powersync-core`) und die Plugins stehen unter GPL-3.0. Der in die -Energie-Engine integrierte Optimierer-Client ebenfalls — alles, was mit nymea verbunden -ist, ist es. Die **Fachlogik** der Optimierung dagegen (Tarifabwägung, an Ihrer Anlage -gelernte Prognosen) ist proprietär: sie läuft in einem separaten Prozess, angebunden -über eine offene, dokumentierte Schnittstelle. Die Optimierung läuft bei Ihnen, auf der -Box oder auf einem Rechner in Ihrem lokalen Netz. Diese IPC-Grenze ist der Kern des Open-Core-Modells — das Plugin bleibt -frei, die Fachlogik bleibt proprietär. +Die Energie-Engine (`etm-powersync-energy-plugin-etm`) und die Plugins stehen unter +GPL-3.0, einschließlich des in die Engine integrierten Optimierer-Clients — alles, was mit +nymea verbunden ist, ist es. Die Engine funktioniert allein, ohne Optimierer. Das +[Protokoll zwischen Engine und Optimierer](optimiseur/index.md) ist offen und +veröffentlicht, mit einem freien Referenz-Optimierer und einer Konformitäts-Testsuite: +Jeder kann einen eigenen schreiben. Der **ETM-Optimierer** und seine Fachlogik +(Tarifabwägung, an Ihrer Anlage gelernte Prognosen) sind dagegen proprietär: Sie laufen in +einem separaten Prozess, angebunden über dieses Protokoll, bei Ihnen — auf der Box oder auf +einem Rechner in Ihrem lokalen Netz. Diese Prozessgrenze ist der Kern des +Open-Core-Modells — die Engine bleibt frei, die Fachlogik bleibt proprietär. ## Was unterscheidet Community und Pro? diff --git a/docs/faq.en.md b/docs/faq.en.md index c57f257..9a47ac3 100644 --- a/docs/faq.en.md +++ b/docs/faq.en.md @@ -13,13 +13,15 @@ app. That is an architectural decision, not an option. ## Is the project open source? -The foundation (`powersync-core`) and the plugins are under GPL-3.0. So is the optimiser -client built into the energy engine — everything linked against nymea is. The -optimisation **business logic**, however (tariff arbitration, forecasts learned from -your installation), is proprietary: it runs in a separate process, reached through an -open, documented interface. Optimisation runs at your place, on the box or on a machine -in your local network. -That IPC boundary is the heart of the Open Core model — the plugin stays free, the +The energy engine (`etm-powersync-energy-plugin-etm`) and the plugins are under +GPL-3.0, including the optimiser client built into the engine — everything linked against +nymea is. The engine works on its own, without an optimiser. The +[protocol between the engine and an optimiser](optimiseur/index.md) is open and +published, with a free reference optimiser and a conformance suite: anyone can write their +own. The **ETM optimiser** and its business logic (tariff arbitration, forecasts learned +from your installation), however, are proprietary: they run in a separate process, reached +through that protocol, at your place — on the box or on a machine in your local network. +That process boundary is the heart of the Open Core model — the engine stays free, the business logic stays proprietary. ## What is the difference between Community and Pro? diff --git a/docs/faq.md b/docs/faq.md index d7b2e6b..599c735 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -13,13 +13,16 @@ vous-même dans l'application. C'est un choix d'architecture, pas une option. ## Le projet est-il open source ? -Le socle (`powersync-core`) et les plugins sont sous GPL-3.0. Le client de -l'optimiseur, intégré au moteur d'énergie, est lui aussi GPL — tout ce qui est lié à -nymea l'est. En revanche, la **logique métier** d'optimisation (arbitrage tarifaire, -prévisions apprises sur votre installation) est propriétaire : elle tourne dans un -processus séparé, joint par une interface ouverte et documentée. L'optimisation tourne -chez vous, sur la box ou sur une machine de votre réseau local. Cette frontière IPC est le cœur du modèle Open Core — le plugin reste -libre, la logique métier reste propriétaire. +Le moteur d'énergie (`etm-powersync-energy-plugin-etm`) et les plugins sont sous +GPL-3.0, y compris le client de l'optimiseur intégré au moteur — tout ce qui est lié à +nymea l'est. Le moteur fonctionne seul, sans optimiseur. Le +[protocole entre le moteur et un optimiseur](optimiseur/index.md) est ouvert et publié, +avec un optimiseur de référence libre et une suite de conformité : chacun peut écrire le +sien. En revanche, l'**optimiseur ETM** et sa logique métier (arbitrage tarifaire, +prévisions apprises sur votre installation) sont propriétaires : ils tournent dans un +processus séparé, joint par ce protocole, chez vous — sur la box ou sur une machine de +votre réseau local. Cette frontière entre processus est le cœur du modèle Open Core — le +moteur reste libre, la logique métier reste propriétaire. ## Community et Pro, quelle différence ? diff --git a/docs/fonctionnalites/prevision-pv.de.md b/docs/fonctionnalites/prevision-pv.de.md index 71dbfc2..3718616 100644 --- a/docs/fonctionnalites/prevision-pv.de.md +++ b/docs/fonctionnalites/prevision-pv.de.md @@ -102,7 +102,10 @@ aktivieren. ## Und ein Optimierer? -Die Architektur sieht eine **offene, dokumentierte Schnittstelle** zu einem externen -Optimierer vor, der diese Prognosen für die Planung nutzen könnte. Die Optimierung liefe -bei Ihnen, auf der Box oder auf einem Rechner in Ihrem lokalen Netz. Diese Anbindung ist -in Entwicklung; die Community-Version funktioniert vollständig ohne sie. +Ein Optimierer kann diese Prognosen dagegen zur Planung nutzen: Die Engine übergibt sie +ihm, zusammen mit dem eingegebenen Tarif und dem Grundverbrauch, über ein +[offenes, veröffentlichtes Protokoll](../optimiseur/protocole.md). Der Optimierer läuft bei +Ihnen, auf der Box oder auf einem Rechner in Ihrem lokalen Netz, und erhält seine Daten nur +von der Engine; seine Sollwerte bleiben durch die Grenzen und die Sicherheit der Engine +gedeckelt. Die Anbindung eines Optimierers wird erprobt; die Community-Version funktioniert +vollständig ohne. Siehe Abschnitt [Optimierer](../optimiseur/index.md). diff --git a/docs/fonctionnalites/prevision-pv.en.md b/docs/fonctionnalites/prevision-pv.en.md index 5074b54..982368b 100644 --- a/docs/fonctionnalites/prevision-pv.en.md +++ b/docs/fonctionnalites/prevision-pv.en.md @@ -97,7 +97,10 @@ only if you enable it yourself in the app. ## What about an optimiser? -The architecture provides an **open, documented interface** to an external optimiser, -which could use these forecasts to plan. Optimisation would run at your place, on the -box or on a machine in your local network. This connection is under development; the -Community edition works entirely without it. +An optimiser, on the other hand, can use these forecasts to plan: the engine hands them +over, together with the entered tariff and the baseload, through an +[open, published protocol](../optimiseur/protocole.md). The optimiser runs at your place, +on the box or on a machine in your local network, and gets its data from the engine only; +its setpoints stay capped by the engine's bounds and safety. Connecting an optimiser is +being tested; the Community edition works entirely without one. See the +[Optimizer](../optimiseur/index.md) section. diff --git a/docs/fonctionnalites/prevision-pv.md b/docs/fonctionnalites/prevision-pv.md index 31dc6eb..9c52d3f 100644 --- a/docs/fonctionnalites/prevision-pv.md +++ b/docs/fonctionnalites/prevision-pv.md @@ -100,7 +100,10 @@ l'application. ## Et un optimiseur ? -L'architecture prévoit une **interface ouverte et documentée** vers un optimiseur externe, -qui pourrait utiliser ces prévisions pour planifier. L'optimisation tournerait chez vous, -sur la box ou sur une machine de votre réseau local. Cette connexion est en cours de -développement ; la version Community fonctionne entièrement sans elle. +Un optimiseur peut, lui, se servir de ces prévisions pour planifier : le moteur les lui +transmet, avec le tarif saisi et la consommation de base, par un +[protocole ouvert et publié](../optimiseur/protocole.md). L'optimiseur tourne chez vous, +sur la box ou sur une machine de votre réseau local, et ne reçoit ses données que du +moteur ; ses consignes restent plafonnées par les bornes et la sécurité du moteur. La +connexion d'un optimiseur est en test ; la version Community fonctionne entièrement sans. +Voir la section [Optimiseur](../optimiseur/index.md). diff --git a/docs/index.de.md b/docs/index.de.md index 457cb7f..4e0b29b 100644 --- a/docs/index.de.md +++ b/docs/index.de.md @@ -15,7 +15,9 @@ freie Basis (GPL-3.0) und eine proprietäre Optimierungsschicht. ## Wo anfangen - [Installation](installation/index.md) — ETM PowerSync über das APT-Repository ausrollen -- [Funktionen](fonctionnalites/index.md) — was das HEMS leistet, und sein echter Stand +- [Funktionen](fonctionnalites/index.md) — was das HEMS leistet, und sein echter Stand; + [wie die Engine entscheidet](fonctionnalites/moteur.md) +- [Optimierer](optimiseur/index.md) — das offene Protokoll zwischen Engine und Optimierer - [Kompatibilität](appareils/compatibilite.md) — die unterstützten Geräte - [Integrationen](integrations/jsonrpc-api.md) — JSON-RPC-API, MQTT, Home Assistant diff --git a/docs/index.en.md b/docs/index.en.md index a075177..cffffaf 100644 --- a/docs/index.en.md +++ b/docs/index.en.md @@ -15,7 +15,9 @@ foundation (GPL-3.0) and a proprietary optimisation layer. ## Where to start - [Installation](installation/index.md) — deploy ETM PowerSync from the APT repository -- [Features](fonctionnalites/index.md) — what the HEMS does, and its real state +- [Features](fonctionnalites/index.md) — what the HEMS does, and its real state; + [how the engine decides](fonctionnalites/moteur.md) +- [Optimizer](optimiseur/index.md) — the open protocol between the engine and an optimiser - [Compatibility](appareils/compatibilite.md) — supported equipment - [Integrations](integrations/jsonrpc-api.md) — JSON-RPC API, MQTT, Home Assistant diff --git a/docs/index.md b/docs/index.md index 8c41322..5662823 100644 --- a/docs/index.md +++ b/docs/index.md @@ -15,7 +15,9 @@ libre (GPL-3.0) et une couche d'optimisation propriétaire. ## Par où commencer - [Installation](installation/index.md) — déployer ETM PowerSync via le dépôt APT -- [Fonctionnalités](fonctionnalites/index.md) — ce que fait le HEMS, et son état réel +- [Fonctionnalités](fonctionnalites/index.md) — ce que fait le HEMS, et son état réel ; + [comment le moteur décide](fonctionnalites/moteur.md) +- [Optimiseur](optimiseur/index.md) — le protocole ouvert entre le moteur et un optimiseur - [Compatibilité](appareils/compatibilite.md) — les équipements supportés - [Intégrations](integrations/jsonrpc-api.md) — API JsonRPC, MQTT, Home Assistant