Entwurf: docs/module/VGT-Schnittstelle/README.md

2026-09-10 08:04:47 +00:00
parent fcb82a7898
commit 2b8e13db9b
1 changed files with 42 additions and 0 deletions
@@ -0,0 +1,42 @@
+# VGT-Schnittstelle
+
+> Status: Diskussionsentwurf. Führt `MQTTPVSDL` und die vorhandenen
+> Batterie-Felder aus `MQTTBatterySDL` zusammen.
+
+Die bestehende MQTT-Arbeitsweise und technische Alt-Idents bleiben erhalten.
+Die Geräteart PV oder Batterie steuert nur die sichtbaren Felder.
+
+## Variablen
+
+| Technischer Ident | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `IsReady` | Boolean / Anzeige | Bestehender Bereitschaftsstatus. |
+| `IsRunning` | Boolean / Anzeige | Bestehender Bearbeitungsstatus. |
+| `MinSoC` | Float / Anzeige | Nur Batterie; untere Ladezustandsgrenze. |
+| `MaxSoC` | Float / Anzeige | Nur Batterie; obere Ladezustandsgrenze. |
+| `PowerSetpoint` | Integer / bedienbar | Bestehende Leistungsvorgabe und Testaktion. |
+| `Strategy` | String / bedienbar | Bestehende Strategie und Testaktion. |
+| `LastReadResponse` | String / Anzeige | Letzte Lese-Antwort. |
+| `LastWriteResponse` | String / Anzeige | Letzte Steuer-Antwort. |
+
+## Properties
+
+| Technischer Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `Geraeteart` | Auswahl | `PV`; alternativ `Batterie`. |
+| `TopicSuffix` | String | leer; bestehender MQTT-Suffix. |
+| `ReqActionID` | Integer | `0`; bestehende Ausgabevariable/Nennleistung. |
+| `PowerProductionID` | Integer | `0`; aktuelle SDL-Leistung. |
+| `SoCID` | Integer | `0`; nur bei Batterie. |
+| `TargetSoC` | Float | `50` %; nur bei Batterie. |
+| `ChargePower` | Integer | `2500` W; nur bei Batterie. |
+| `DischargePower` | Integer | `2500` W; nur bei Batterie. |
+| `MaxPowerSetpoint` | Integer | `10000` W. |
+
+## Verhalten und offene Punkte
+
+- MQTT-Parent, Auftragsauswertung, Timer, Aktionen und vorhandener Testknopf
+  bleiben fachlicher Ausgangspunkt.
+- Passende MQTT-Verbindung zuordnen oder bei der Instanziierung anlegen.
+- Keine neuen Zieladapter, Protokolle oder Datenqualitätsfelder in diesem Schritt.
+- Optionale EMS-Anbindung darf keine feste Repository-Abhängigkeit erzeugen.