Virtuele Energiecentrales

De MQTT-gebruikersnaam en het wachtwoord voor de Eniris-broker moeten worden aangevraagd via de Eniris-webshop. De VPP-ID en projectconfiguratie worden afzonderlijk afgehandeld tijdens de VPP-onboarding.

Verbinden met de MQTT Broker

Zorg ervoor dat uw netwerk en apparaten gereed zijn door de MQTT SetupScheduler-interval

VPP Functionaliteit

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

Waar het Live MQTT-protocol een opdracht naar een enkele controller zou sturen, maakt de VPP het mogelijk om één opdracht naar een groep controllers te sturen.

Controllers toevoegen aan de VPP

Wanneer u het SmartgridOne MQTT Signaal toevoegt, wordt een VPP ID veld weergegeven. Voer hier de ontvangen VPP-ID in.

Aggregatie-algoritme

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

Abonneer Topic:

Zodra de initiële configuratie is voltooid, gebruikt u de VPP-ID uit de VPP-onboarding en de via de Eniris-webshop aangevraagde MQTT-gebruikersnaam en het wachtwoord.

Inkomend Topic

Topic: standard1/outbound/remoteVppMetrics/command/{MQTT Username}/{VPP ID}

Topic (verouderd): 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 component policies en setpoints zijn te vinden op: in de Live MQTT Control documentatie.

Geplande 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 component policies en setpoints zijn te vinden op: in de Live MQTT Control documentatie.

Bevestiging Topic

Topic: standard1/outbound/remoteVppMetrics/acknowledgement/{MQTT Username}/{VPP ID}

Topic (verouderd): vpp/{MQTT Username}/{VPP ID}/acknowledgement

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

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: standard1/outbound/remoteVppMetrics/feedback/{MQTT Username}/{VPP ID}

Topic (verouderd): vpp/{MQTT Username}/{VPP ID}/feedback

Het Feedback Topic bevat de terugkoppeling van 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 feedback dictionary is te vinden op: MQTT Feedback Payload Structure

Geaggregeerd Feedback Topic

Topic: standard1/outbound/remoteVppMetrics/aggregatedFeedback/{MQTT Username}/{VPP ID}

Topic (verouderd): vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

De VPP aggregeert de feedback die door elke individuele controller is 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 feedback dictionary is gestructureerd op een vergelijkbare wijze als de MQTT Feedback Payload Structure. Echter, stringwaarden, zoals uitgevoerde strategieën, kunnen niet worden geaggregeerd en zijn daarom niet inbegrepen.

Verzonden Opdrachten Topic

Topic: standard1/outbound/remoteVppMetrics/dispatched/{MQTT Username}/{VPP ID}

Topic (verouderd): vpp/{MQTT Username}/{VPP ID}/dispatched_commands

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

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 payload-structuur van de individuele opdrachten die zijn verzonden is te vinden op: MQTT Feedback Payload Structure.

Waarschuwing Topic

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

Topic (verouderd): vpp/{MQTT Username}/{VPP ID}/warning

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

Body:

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