Verbindung zum MQTT Broker herstellen

Bitte lesen Sie den folgenden Abschnitt, um zu erfahren, wie Sie eine Verbindung zum SmartgridOne MQTT Broker herstellen: MQTT Broker Connection

VPP-Funktionalität

Das VPP wurde entwickelt, um einen Sollwert/Strategie pro Gerätegruppe (z.B. Solar, Speicher) zu empfangen und den Sollwert zwischen den mit dem VPP verbundenen Reglern zu aggregieren.

Während das Live-MQTT-Protokoll einen Befehl an einen einzelnen Regler sendet, ermöglicht das VPP dem Benutzer, einen Befehl an eine Gruppe von Reglern zu senden.

Hinzufügen von Reglern zum VPP

Beim Hinzufügen des SmartgridOne MQTT-Signals wird ein Feld vpp/{MQTT Username}/{VPP ID}/warning angezeigt. Geben Sie hier die VPP ID ein, die Sie erhalten haben.

Aggregationsalgorithmus

Die Sollwerte werden basierend auf der Kapazität der unter den einzelnen Reglern fallenden Geräte aggregiert.

MQTT-Themen

Nach Abschluss der Erstkonfiguration werden eine VPP ID und ein MQTT-Benutzername (sowie Passwort) bereitgestellt.

Eingehendes Thema

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

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

Live VPP

Body:

{
    "msg_id": <Inkremementielle Nachrichten-ID>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix-Timestamp>(int)",
    "fields": {
        "<Komponenten-Richtlinie>": "<Richtlinientyp>",
        "<Komponenten-Leistungs-Sollwert>": <Sollwert in Watt>
    }
}

Die Komponentenrichtlinien und Sollwerte finden Sie hier: MQTT Components and Policies

Geplantes VPP

Body:

{
    "msg_id": <Inkremementielle Nachrichten-ID>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix-Timestamp>(int)",
    "message_type": "<Nachrichtentyp>(str)",
    "fields": {
        "<Komponenten-Richtlinie>": "<Richtlinientyp>",
        "<Komponenten-Leistungs-Sollwert>": <Sollwert in Watt>
    }
}

Die Komponentenrichtlinien und Sollwerte finden Sie hier: MQTT Components and Policies

Bestätigungsthema

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

Nachdem ein Befehl gesendet wurde, antwortet das VPP mit einer Bestätigung, 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 Username}/{VPP ID}/warning

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

Body:

{
    "payload": {
        "updated_on": <Unix-Timestamp der Daten>(str)
        "feedback_dict": {
            <Feedback-Dictionary>(dict)
        },
        "target": <Site-Node-ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}

Die Struktur des Feedback-Dictionaries finden Sie hier: MQTT Feedback Payload Structure

Aggregiertes Feedback-Thema

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

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

Body:

{
    "payload": {
        "updated_on": <Unix-Timestamp der Daten>(str)
        "feedback_dict": {
            <Aggregiertes Feedback-Dictionary>(dict)
        },
    },
    "message_type": <Nachrichtentyp>(str)
}

Das aggregierte Feedback-Dictionary ist ähnlich strukturiert wie das MQTT Feedback Payload Structure. Allerdings können Zeichenkettenwerte, wie ausgeführte Strategien, nicht aggregiert werden und sind daher nicht enthalten.

Verteilte Befehle-Thema

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

Wenn Befehle vom VPP an die Regler gesendet werden, wird dies über dieses Thema gemeldet.

Body:

{
    "payload": {
        "aggregated": {
            <Komponentenname>(str): <CommandPower-Wert>(float)...
        },
        "dispatched_commands": [
            <Liste der einzelnen an die Regler gesendeten Befehle>
        ],
    },
    "message_type": <Nachrichtentyp>(str)
}

Die Payload-Struktur der einzelnen gesendeten Befehle finden Sie hier: MQTT Feedback Payload Structure.

Warn-Thema

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

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

Body:

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