Wirtualne Elektrownie

Łączenie z brokerem MQTT

Proszę zapoznać się z następującą sekcją, aby dowiedzieć się, jak połączyć się z brokerem MQTT GM Energy: MQTT Broker Connection

Funkcjonalność VPP

VPP jest zaprojektowany do odbierania jednego punktu nastawy/strategii na grupę urządzeń (np. Solar, Storage) i agregowania punktu nastawy pomiędzy kontrolerami podłączonymi do VPP.

Podczas gdy protokół Live MQTT wysyłałby polecenie do pojedynczego kontrolera, VPP pozwala użytkownikowi wysłać jedno polecenie do grupy kontrolerów.

Dodawanie kontrolerów do VPP

Po dodaniu sygnału MQTT GM Energy pojawi się pole standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}. Wprowadź tutaj otrzymany ID VPP.

Algorytm agregacji

Punkty nastawy są agregowane na podstawie zdolności urządzeń przypisanych do poszczególnych kontrolerów.

Tematy MQTT

Po zakończeniu początkowej konfiguracji zostaną dostarczone ID VPP oraz Nazwa użytkownika MQTT (i hasło).

Temat przychodzący

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}

Ten temat jest używany przez użytkownika do wysłania zagregowanego polecenia do VPP.

Live VPP

Treść:

{
    "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>
    }
}

Polityki komponentów i punkty nastawy można znaleźć tutaj: MQTT Components and Policies

Scheduled VPP

Treść:

{
    "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>
    }
}

Polityki komponentów i punkty nastawy można znaleźć tutaj: MQTT Components and Policies

Temat potwierdzenia

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}/warning

Po wysłaniu polecenia, VPP odpowiada potwierdzeniem, wskazując, czy polecenie zostało pomyślnie odebrane.

Treść:

{
    "payload": {
        "fields": {
            "responseCode": <Success/Failure Code>(int),
            "ack": <Acknowledgement Message>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}

Temat informacji zwrotnej

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}/warning

Temat informacji zwrotnej zawiera odpowiedzi zwrotne zwracane przez poszczególne kontrolery.

Treść:

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

Struktura słownika informacji zwrotnej znajduje się tutaj: MQTT Feedback Payload Structure

Temat agregowanej informacji zwrotnej

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}/warning

VPP agreguje informacje zwrotne otrzymane od każdego indywidualnego kontrolera.

Treść:

{
    "payload": {
        "updated_on": <Unix Timestamp of the data>(str)
        "feedback_dict": {
            <Aggregated Feedback Dict>(dict)
        },
    },
    "message_type": <Type of Message>(str)
}

Słownik zagregowanej informacji zwrotnej jest strukturalnie podobny do MQTT Feedback Payload Structure. Wartości tekstowe, takie jak wykonane strategie, nie mogą być agregowane i dlatego nie są uwzględnione.

Temat wysłanych poleceń

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}/warning

Gdy polecenia są wysyłane do kontrolerów przez VPP, jest to zgłaszane za pomocą tego tematu.

Treść:

{
    "payload": {
        "aggregated": {
            <Component Name>(str): <CommandPower Value>(float)...
        },
        "dispatched_commands": [
            <List of individual commands sent to the controllers>
        ],
    },
    "message_type": <Type of Message>(str)
}

Struktura danych poszczególnych wysyłanych poleceń jest dostępna tutaj: MQTT Feedback Payload Structure.

Temat ostrzeżeń

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

Temat (przestarzały): vpp/{MQTT Username}/{VPP ID}/warning

Jeśli w VPP wystąpi błąd lub ostrzeżenie, komunikat zostanie wysłany przez ten temat MQTT.

Treść:

{
    "payload": {
        "fields": {
            <Field Dictionary>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}