Verbinding maken met de MQTT Broker

Raadpleeg de volgende sectie om te zien hoe u verbinding maakt met de SmartgridOne MQTT Broker: MQTT Broker Connection

VPP-functionaliteit

De VPP is ontworpen om één setpoint/strategie per apparaatgroep (bijvoorbeeld Solar, Storage) te ontvangen en het setpoint te aggregeren tussen de controllers die op de VPP zijn aangesloten.

Terwijl het Live MQTT-protocol een opdracht naar één enkele controller zou sturen, stelt de VPP de gebruiker in staat om één opdracht naar een groep controllers te verzenden.

Controllers toevoegen aan de VPP

Bij het toevoegen van het SmartgridOne MQTT-signaal wordt een vpp/{MQTT Username}/{VPP ID}/warning veld weergegeven. Voer hier de VPP ID in die u hebt ontvangen.

Aggregatie-algoritme

De setpoints worden geaggregeerd op basis van de capaciteit van de apparaten die onder de individuele controllers vallen.

MQTT Topics

Zodra de initiële setup is voltooid, wordt een VPP ID en MQTT-gebruikersnaam (en wachtwoord) verstrekt.

Incoming Topic

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

Dit topic wordt door de gebruiker gebruikt om een geaggregeerde opdracht naar de VPP te sturen.

Live VPP

Body:

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

De componentpolicies en setpoints zijn hier te vinden: MQTT Components and Policies

Scheduled VPP

Body:

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

De componentpolicies en setpoints zijn hier te vinden: MQTT Components and Policies

Acknowledgement Topic

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

Nadat een opdracht is verzonden, zal de VPP reageren met een bevestiging, die aangeeft of de opdracht succesvol is ontvangen of niet.

Body:

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

Feedback Topic

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

Het Feedback Topic bevat de feedback die wordt teruggestuurd door de individuele controllers.

Body:

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

De structuur van de feedbackdict is hier te vinden: MQTT Feedback Payload Structure

Aggregated Feedback Topic

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

De VPP aggregeert de feedback die door elke individuele controller wordt ontvangen.

Body:

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

De geaggregeerde feedbackdictionary is vergelijkbaar gestructureerd als de MQTT Feedback Payload Structure. Stringwaarden, zoals uitgevoerde strategieën, kunnen echter niet worden geaggregeerd en zijn daarom niet inbegrepen.

Dispatched Commands Topic

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

Wanneer opdrachten worden verzonden naar de controllers door de VPP, wordt dit via dit topic gerapporteerd.

Body:

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

De payloadstructuur van de individuele opdrachten die zijn verzonden is hier te vinden: MQTT Feedback Payload Structure.

Warning Topic

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

Als er een fout of waarschuwing optreedt in de VPP, wordt er een bericht verzonden via dit MQTT-topic.

Body:

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