Das VPP-Protokoll basiert auf dem Live MQTT-Protokoll. Bitte lesen Sie vorher diese Seite. Siehe Live MQTT Control.
Die anfängliche VPP-Einrichtung MUSS von Sofar durchgeführt werden. Bitte kontaktieren Sie Sofar, bevor Sie die nächsten Schritte ausführen.
Der MQTT-Benutzername und das Passwort für den Eniris-Broker müssen über den Eniris-Webshopangefordert werden. Die VPP ID und die Projektkonfiguration werden während des VPP-Onboardings separat verwaltet.
Baselines werden nicht von allen Controllern unterstützt. Bitte kontaktieren Sie den Support für weitere Informationen.Bevor Sie fortfahren, stellen Sie sicher, dass Ihr Netzwerk und Ihre Geräte bereit sind, indem Sie der Anleitung Wiring Best Practices
Das VPP ist so konzipiert, dass es einen Sollwert/Strategie pro Gerätegruppe (z. B. Solar, Speicher) empfängt und den Sollwert zwischen den mit dem VPP verbundenen Controllern aggregiert.
Während das Live MQTT-Protokoll einen Befehl an einen einzelnen Controller sendet, ermöglicht das VPP dem Benutzer, einen Befehl an eine Gruppe von Controllern zu senden.
Beim Hinzufügen des Sofar MQTT-Signals wird ein VPP ID-Feld angezeigt. Geben Sie hier die erhaltene VPP ID ein.
Die Sollwerte werden basierend auf der Kapazität der Geräte aggregiert, die zu den einzelnen Controllern gehören.
Nach Abschluss der anfänglichen Einrichtung verwenden Sie die VPP ID aus dem VPP-Onboarding sowie den MQTT-Benutzernamen und das Passwort, die über den Eniris-Webshop angefordert wurden.
Thema: standard1/outbound/remoteVppMetrics/command/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}
Dieses Thema wird vom Benutzer verwendet, um einen aggregierten Befehl an das VPP zu senden.
Inhalt:
{
"msg_id": <Incremental message id>(int),
"vpp_id": <VPP ID>(str)
"time": "<Unix Timestamp>(int)",
"fields": {
"<Component Policy>": "<Policy Type>",
"<Component Power Setpoint>": <Setpoint in watts>
}
}
Die Komponentenrichtlinien und Sollwerte finden Sie hier: in der Dokumentation zur Live MQTT-Steuerung.
Inhalt:
{
"msg_id": <Incremental message id>(int),
"vpp_id": <VPP ID>(str)
"time": "<Unix Timestamp>(int)",
"message_type": "<Type of message>(str)",
"fields": {
"<Component Policy>": "<Policy Type>",
"<Component Power Setpoint>": <Setpoint in watts>
}
}
Die Komponentenrichtlinien und Sollwerte finden Sie hier: in der Dokumentation zur Live MQTT-Steuerung.
Thema: standard1/outbound/remoteVppMetrics/acknowledgement/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/acknowledgement
Nachdem ein Befehl gesendet wurde, antwortet das VPP mit einer Bestätigung, die angibt, ob der Befehl erfolgreich empfangen wurde oder nicht.
Inhalt:
{
"payload": {
"fields": {
"responseCode": <Success/Failure Code>(int),
"ack": <Acknowledgement Message>(str)
},
"target": <VPP ID>(str)
},
"message_type": <Type of Message>(str)
}
Thema: standard1/outbound/remoteVppMetrics/feedback/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/feedback
Das Feedback-Thema enthält die Rückmeldungen der einzelnen Controller.
Inhalt:
{
"payload": {
"updated_on": <Unix Timestamp of the data>(str)
"feedback_dict": {
<Feedback Dict>(dict)
},
"target": <Site Node ID>(str)
},
"message_type": <Type of Message>(str)
}
Die Struktur des Feedback-Dictionary finden Sie hier: MQTT Feedback Payload Structure
Thema: standard1/outbound/remoteVppMetrics/aggregatedFeedback/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/aggregated_feedback
Das VPP aggregiert das Feedback jedes einzelnen Controllers.
Inhalt:
{
"payload": {
"updated_on": <Unix Timestamp of the data>(str)
"feedback_dict": {
<Aggregated Feedback Dict>(dict)
},
},
"message_type": <Type of Message>(str)
}
Das aggregierte Feedback-Dictionary ist ähnlich aufgebaut wie das MQTT Feedback Payload Structure. String-Werte, wie ausgeführte Strategien, können jedoch nicht aggregiert werden und sind deshalb nicht enthalten.
Thema: standard1/outbound/remoteVppMetrics/dispatched/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/dispatched_commands
Wenn Befehle vom VPP an die Controller gesendet werden, wird dies über dieses Thema gemeldet.
Inhalt:
{
"payload": {
"aggregated": {
<Component Name>(str): <CommandPower Value>(float)...
},
"dispatched_commands": [
<List of individual commands sent to the controllers>
],
},
"message_type": <Type of Message>(str)
}
Die Payload-Struktur der einzeln gesendeten Befehle finden Sie hier: MQTT Feedback Payload Structure.
Thema: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}
Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/warning
Wenn ein Fehler oder eine Warnung im VPP auftritt, wird eine Nachricht über dieses MQTT-Thema gesendet.
Inhalt:
{
"payload": {
"fields": {
<Field Dictionary>(dict)
},
"target": <VPP ID>(str)
},
"message_type": <Type of Message>(str)
}