Verbindung zum MQTT Broker herstellen

Bitte beachten Sie den folgenden Abschnitt, um herauszufinden, wie Sie eine Verbindung zum a-TroniX MQTT Broker herstellen: MQTT Broker Connection

VPP Funktionalität

Das VPP ist so konzipiert, dass es pro Gerätegruppe (z.B. Solar, Speicher) einen Sollwert/Strategie 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.

Controller zum VPP hinzufügen

Beim Hinzufügen des a-TroniX MQTT Signals wird ein standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID} Feld angezeigt. Geben Sie hier die erhaltene VPP ID ein.

Aggregationsalgorithmus

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

MQTT Themen

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

Eingehendes Thema

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

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": <Inkrementelle Nachrichten-ID>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix Zeitstempel>(int)",
    "fields": {
        "<Komponentenrichtlinie>": "<Richtlinientyp>",
        "<Komponenten-Leistungs-Sollwert>": <Sollwert in Watt>
    }
}

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

Geplantes VPP

Inhalt:

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

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

Bestätigungs-Thema

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

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

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": <Erfolgs-/Fehlercode>(int),
            "ack": <Bestätigungsnachricht>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}

Feedback-Thema

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

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

Das Feedback-Thema enthält das Feedback der einzelnen Controller.

Inhalt:

{
    "payload": {
        "updated_on": <Unix Zeitstempel 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: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

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

Inhalt:

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

Das aggregierte Feedback-Dictionary ist ähnlich der MQTT Feedback Payload Structure aufgebaut. String-Werte, wie ausgeführte Strategien, können jedoch nicht aggregiert werden und sind daher nicht enthalten.

Thema für gesendete Befehle

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

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

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

Inhalt:

{
    "payload": {
        "aggregated": {
            <Komponentenname>(str): <Befehlsleistungswert>(float)...
        },
        "dispatched_commands": [
            <Liste der an die Controller gesendeten Einzelbefehle>
        ],
    },
    "message_type": <Nachrichtentyp>(str)
}

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

Warn-Thema

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": {
            <Feld-Dictionary>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Nachrichtentyp>(str)
}