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