diff --git a/docs/module/VGT-Schnittstelle/README.md b/docs/module/VGT-Schnittstelle/README.md new file mode 100644 index 0000000..f2165a1 --- /dev/null +++ b/docs/module/VGT-Schnittstelle/README.md @@ -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.