Verbindung zum MQTT-Broker

Bitte beziehen Sie sich auf den folgenden Abschnitt, um herauszufinden, wie Sie eine Verbindung zum SmartgridOne MQTT-Broker herstellen: MQTT-Broker-Verbindung

VPP-Funktionalität

Das VPP ist so konzipiert, dass es pro Gerätegruppe (z.B. Solar, Speicherung) einen Setpoint/Strategie empfängt und den Setpoint zwischen den an das VPP angeschlossenen 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.

Hinzufügen von Controllern zum VPP

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

Aggregationsalgorithmus

Die Setpoints werden basierend auf der Kapazität der Geräte aggregiert, die unter den einzelnen Controllern fallen.

MQTT-Themen

Sobald die initiale Konfiguration abgeschlossen ist, wird eine VPP ID und ein MQTT-Benutzername (und Passwort) bereitgestellt.

Eingehendes Thema

Thema: vpp/{MQTT Benutzername}/{VPP ID}

Dieses Thema wird vom Benutzer verwendet, um einen aggregierten Befehl an das VPP zu senden.

Live VPP

Body:

{
    "msg_id": <Inkrementelle Nachrichten-ID>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Unix-Zeitstempel>(int)",
    "fields": {
        "<Komponentenrichtlinie>": "<Richtlinientyp>",
        "<Komponenten-Leistungs-Setpoint>": <Setpoint in Watt>
    }
}

Die Komponentenrichtlinien und Setpoints finden Sie hier: MQTT-Komponenten und Richtlinien

Geplanter VPP

Body:

{
    "msg_id": <Inkrementelle Nachrichten-ID>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Unix-Zeitstempel>(int)",
    "message_type": "<Nachrichtentyp>(str)",
    "fields": {
        "<Komponentenrichtlinie>": "<Richtlinientyp>",
        "<Komponenten-Leistungs-Setpoint>": <Setpoint in Watt>
    }
}

Die Komponentenrichtlinien und Setpoints finden Sie hier: MQTT-Komponenten und Richtlinien

Bestätigungsthema

Thema: vpp/{MQTT Benutzername}/{VPP ID}/acknowledgement

Nachdem ein Befehl gesendet wurde, wird das VPP mit einer Bestätigung antworten, die angibt, ob der Befehl erfolgreich empfangen wurde oder nicht.

Body:

{
    "payload": {
        "fields": {
            "responseCode": <Erfolgs-/Fehlercode>(int),
            "ack": <Bestätigungsnachricht>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}

Feedback-Thema

Thema: vpp/{MQTT Benutzername}/{VPP ID}/feedback

Das Feedback-Thema enthält das Feedback, das von den einzelnen Controllern zurückgegeben wird.

Body:

{
    "payload": {
        "updated_on": <Unix-Zeitstempel der Daten>(str),
        "feedback_dict": {
            <Feedback-Diktionär>(dict)
        },
        "target": <Standort-Knoten-ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}

Die Struktur des Feedback-Diktionärs finden Sie hier: MQTT-Feedback-Nutzlaststruktur

Aggregiertes Feedback-Thema

Thema: vpp/{MQTT Benutzername}/{VPP ID}/aggregated_feedback

Das VPP aggregiert das Feedback, das von jedem einzelnen Controller empfangen wird.

Body:

{
    "payload": {
        "updated_on": <Unix-Zeitstempel der Daten>(str),
        "feedback_dict": {
            <Aggregierter Feedback-Diktionär>(dict)
        }
    },
    "message_type": <Nachrichtentyp>(str)
}

Das aggregierte Feedback-Dictionary ist ähnlich strukturiert wie die MQTT-Feedback-Nutzlaststruktur. Allerdings können String-Werte, wie ausgeführte Strategien, nicht aggregiert werden und werden daher nicht einbezogen.

Versendete Befehle-Thema

Thema: vpp/{MQTT Benutzername}/{VPP ID}/dispatched_commands

Wenn Befehle von dem VPP an die Controller gesendet werden, wird dies über dieses Thema gemeldet.

Body:

{
    "payload": {
        "aggregated": {
            <Komponentenname>(str): <Befehl Leistungswert>(float)...
        },
        "dispatched_commands": [
            <Liste der einzelnen Befehle, die an die Controller gesendet wurden>
        ]
    },
    "message_type": <Nachrichtentyp>(str)
}

Die Struktur der Nutzlast der einzelnen gesendeten Befehle finden Sie hier: MQTT-Feedback-Nutzlaststruktur.

Warnungsthema

Thema: vpp/{MQTT Benutzername}/{VPP ID}/warning

Wenn ein Fehler oder eine Warnung im VPP auftritt, wird eine Nachricht über dieses MQTT-Thema gesendet.

Body:

{
    "payload": {
        "fields": {
            <Feld-Diktionär>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}