Wirtualna Elektrownia

wskazówka

Protokół VPP oparty jest na protokole Live MQTT. Proszę odwołać się do tej strony wcześniej. Zobacz Live MQTT Control.

wskazówka

Początkowa konfiguracja VPP MUSI być dokonana przez Eniris. Proszę skontaktować się z Eniris przed kontynuowaniem kolejnych kroków.

Połączenie z brokerem MQTT

Proszę zapoznać się z poniższą sekcją, aby dowiedzieć się, jak połączyć się z brokerem MQTT Eniris: MQTT Broker Connection

Funkcjonalność VPP

VPP jest zaprojektowane do otrzymywania jednego punktu ustawienia/strategii na grupę urządzeń (np. Solar, Storage) i agregowania punktu ustawienia między kontrolerami podłączonymi do VPP.

Podczas gdy protokół Live MQTT wysyła polecenie do pojedynczego kontrolera, VPP umożliwia użytkownikowi wysłanie jednego polecenia do grupy kontrolerów.

Dodawanie kontrolerów do VPP

Podczas dodawania sygnału MQTT Eniris, wyświetlane jest pole VPP ID. Wprowadź VPP ID, które zostało tutaj otrzymane.

Algorytm agregacji

Punkty ustawienia są agregowane na podstawie pojemności urządzeń, które podlegają poszczególnym kontrolerom.

Tematy MQTT

Po zakończeniu wstępnej konfiguracji, zostanie podane VPP ID oraz Nazwa Użytkownika MQTT (i hasło).

Temat przychodzący

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}

Ten temat jest używany przez użytkownika do wysyłania agregowanego polecenia do VPP.

Ciało:

{
    "msg_id": <Numer Id komunikatu>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Znacznik Czasu Unix>(int)",
    "fields": {
        "<Polityka komponentu>": "<Typ polityki>",
        "<Punkt ustawienia mocy komponentu>": <Punkt ustawienia w watach>
    }
}

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

Temat potwierdzenia

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}/acknowledgement

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

Ciało:

{
    "payload": {
        "fields": {
            "responseCode": <Kod Sukcesu/Niepowodzenia>(int),
            "ack": <Wiadomość potwierdzająca>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Typ wiadomości>(str)
}

Temat informacji zwrotnej

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}/feedback

Temat informacji zwrotnej zawiera informację zwrotną zwróconą przez poszczególne kontrolery.

Ciało:

{
    "payload": {
        "updated_on": <Znacznik czasu Unix danych>(str),
        "feedback_dict": {
            <Słownik informacji zwrotnej>(dict)
        },
        "target": <ID węzła strony>(str)
    },
    "message_type": <Typ wiadomości>(str)
}

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

Temat agregowanej informacji zwrotnej

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}/aggregated_feedback

VPP agreguje informacje zwrotne otrzymane od każdego poszczególnego kontrolera.

Ciało:

{
    "payload": {
        "updated_on": <Znacznik czasu Unix danych>(str),
        "feedback_dict": {
            <Słownik Agregowanej Informacji Zwrotnej>(dict)
        }
    },
    "message_type": <Typ wiadomości>(str)
}

Agregowany słownik informacji zwrotnej jest zbudowany podobnie do MQTT Feedback Payload Structure. Jednak wartości tekstowe, takie jak wykonane strategie, nie mogą być agregowane i dlatego nie są uwzględnione.

Temat wysłanych poleceń

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}/dispatched_commands

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

Ciało:

{
    "payload": {
        "aggregated": {
            <Nazwa komponentu>(str): <Wartość mocy polecenia>(float)...
        },
        "dispatched_commands": [
            <Lista indywidualnych poleceń wysłanych do kontrolerów>
        ]
    },
    "message_type": <Typ wiadomości>(str)
}

Struktura ładunku poszczególnych wysłanych poleceń znajduje się tutaj: MQTT Feedback Payload Structure.

Temat ostrzeżenia

Temat: vpp/{Nazwa Użytkownika MQTT}/{VPP ID}/warning

Jeżeli wystąpi błąd lub ostrzeżenie w VPP, wiadomość zostanie wysłana za pośrednictwem tego tematu MQTT.

Ciało:

{
    "payload": {
        "fields": {
            <Słownik Pola>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Typ wiadomości>(str)
}