Tip
Het VPP Protocol is gebaseerd op het Live MQTT Protocol. Raadpleeg deze pagina hiernaast. Zie Live MQTT Control.
Tip
De initiële VPP-configuratie MOET gedaan worden door SmartgridOne. Neem contact op met SmartgridOne voordat u de volgende stappen volgt.
Verbinden met de MQTT Broker
Raadpleeg de volgende sectie om te ontdekken hoe u verbinding kunt maken met de SmartgridOne MQTT Broker: MQTT Broker Verbinding
VPP Functionaliteit
De VPP is ontworpen om één setpoint/strategie per apparaatgroep (bijv. Zonne-energie, Opslag) te ontvangen en het setpoint te aggregeren tussen de controllers die verbonden zijn met de VPP.
Terwijl het Live MQTT Protocol een opdracht naar één enkele controller zou sturen, staat de VPP de gebruiker toe om één opdracht naar een groep controllers te sturen.

Controllers toevoegen aan de VPP




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


Aggregatie Algoritme
De setpoints worden geaggregeerd op basis van de capaciteit van de apparaten die vallen onder de individuele controllers.
MQTT Topics
Zodra de initiële configuratie compleet is, zullen een VPP ID en MQTT Gebruikersnaam (en wachtwoord) worden verstrekt.
Inkomend Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}
Dit topic wordt gebruikt door de gebruiker om een geaggregeerde opdracht naar de VPP te sturen.
Live VPP
Body:
{
"msg_id": <Incrementeel bericht id>(int),
"vpp_id": <VPP ID>(str),
"time": "<Unix Timestamp>(int)",
"fields": {
"<Component Policy>": "<Policy Type>",
"<Component Power Setpoint>": <Setpoint in watt>
}
}De component beleid en setpoints zijn hier te vinden: MQTT Componenten en Beleid
Gepland VPP
Body:
{
"msg_id": <Incrementeel bericht id>(int),
"vpp_id": <VPP ID>(str),
"time": "<Unix Timestamp>(int)",
"message_type": "<Type van bericht>(str)",
"fields": {
"<Component Policy>": "<Policy Type>",
"<Component Power Setpoint>": <Setpoint in watt>
}
}De component beleid en setpoints zijn hier te vinden: MQTT Componenten en Beleid
Bevestiging Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}/acknowledgement
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": <Succes/Foutcode>(int),
"ack": <Bevestigingsbericht>(str)
},
"target": <VPP ID>(str)
},
"message_type": <Type van Bericht>(str)
}Feedback Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}/feedback
Het Feedback Topic bevat de feedback die is geretourneerd door de individuele controllers.
Body:
{
"payload": {
"updated_on": <Unix Timestamp van de data>(str),
"feedback_dict": {
<Feedback Dict>(dict)
},
"target": <Site Node ID>(str)
},
"message_type": <Type van Bericht>(str)
}De structuur van de feedback dict is hier te vinden: MQTT Feedback Payload Structuur
Geaggregeerd Feedback Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}/aggregated_feedback
De VPP aggregeert de feedback die van elke individuele controller is ontvangen.
Body:
{
"payload": {
"updated_on": <Unix Timestamp van de data>(str),
"feedback_dict": {
<Geaggregeerde Feedback Dict>(dict)
}
},
"message_type": <Type van Bericht>(str)
}De geaggregeerde feedback woordenlijst is gestructureerd op een vergelijkbare manier als de MQTT Feedback Payload Structuur. Echter, stringwaarden, zoals uitgevoerde strategieën, kunnen niet worden geaggregeerd en zijn daarom niet inbegrepen.
Verzonden Commando's Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}/dispatched_commands
Wanneer commando's naar de controllers worden gestuurd door de VPP, wordt dit gerapporteerd via dit topic.
Body:
{
"payload": {
"aggregated": {
<Component Naam>(str): <CommandPower Waarde>(float)...
},
"dispatched_commands": [
<Lijst van individuele commando's die naar de controllers zijn gestuurd>
]
},
"message_type": <Type van Bericht>(str)
}De payloadstructuur van de individuele commando's die zijn verzonden, is hier te vinden: MQTT Feedback Payload Structuur.
Waarschuwing Topic
Topic: vpp/{MQTT Gebruikersnaam}/{VPP ID}/warning
Als er een fout of waarschuwing optreedt in de VPP, wordt een bericht via dit MQTT-topic verzonden.
Body:
{
"payload": {
"fields": {
<Veld Woordenlijst>(dict)
},
"target": <VPP ID>(str)
},
"message_type": <Type van Bericht>(str)
}