Virtuelle Kraftwerke

Verbindung mit dem MQTT-Broker

Bevor Sie fortfahren, stellen Sie sicher, dass Ihr Netzwerk und Ihre Geräte bereit sind, indem Sie der Anleitung MQTT-Einrichtung folgen.

VPP-Funktionalität

Das VPP ist dafür ausgelegt, einen Sollwert/eine Strategie pro Gerätegruppe (z. B. Solar, Speicher) zu empfangen und den Sollwert zwischen den mit dem VPP verbundenen Controllern zu aggregieren.

Während das Live-MQTT-Protokoll einen Befehl an einen einzelnen Controller senden würde, ermöglicht das VPP dem Benutzer, einen Befehl an eine Gruppe von Controllern zu senden.

Controller zum VPP hinzufügen

Beim Hinzufügen des SmartgridOne-MQTT-Signals wird ein Feld VPP ID angezeigt. Geben Sie hier die erhaltene VPP-ID ein.

Aggregationsalgorithmus

Die Sollwerte werden basierend auf der Kapazität der Geräte aggregiert, die den einzelnen Controllern untergeordnet sind.

MQTT-Themen

Sobald die Ersteinrichtung abgeschlossen ist, werden eine VPP-ID und ein MQTT-Benutzername (sowie ein Passwort) bereitgestellt.

Eingehendes Thema

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.

Live-VPP

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: MQTT Components and Policies

Geplantes VPP

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: MQTT Components and Policies

Bestätigungsthema

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)
}

Feedback-Thema

Thema: standard1/outbound/remoteVppMetrics/feedback/{MQTT Username}/{VPP ID}

Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/feedback

Das Feedback-Thema enthält das von den einzelnen Controllern zurückgegebene Feedback.

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-Dictionarys finden Sie hier: MQTT Feedback Payload Structure

Thema für aggregiertes Feedback

Thema: standard1/outbound/remoteVppMetrics/aggregatedFeedback/{MQTT Username}/{VPP ID}

Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

Das VPP aggregiert das von jedem einzelnen Controller empfangene Feedback.

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 strukturiert wie die MQTT Feedback Payload Structure. Stringwerte, wie beispielsweise ausgeführte Strategien, können jedoch nicht aggregiert werden und sind daher nicht enthalten.

Thema für gesendete Befehle

Thema: standard1/outbound/remoteVppMetrics/dispatched/{MQTT Username}/{VPP ID}

Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/dispatched_commands

Wenn das VPP Befehle an die Controller sendet, 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 gesendeten Einzelbefehle finden Sie hier: MQTT Feedback Payload Structure.

Warnungsthema

Thema: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thema (veraltet): vpp/{MQTT Username}/{VPP ID}/warning

Wenn im VPP ein Fehler oder eine Warnung 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)
}