Centrales électriques virtuelles

Connexion au courtier MQTT

Veuillez vous référer à la section suivante pour savoir comment se connecter au courtier MQTT SmartgridOne : MQTT Broker Connection

Fonctionnalités du VPP

Le VPP est conçu pour recevoir un seul consigne/stratégie par groupe d’appareils (par exemple solaire, stockage), et agréger la consigne entre les contrôleurs connectés au VPP.

Alors que le protocole Live MQTT enverrait une commande à un seul contrôleur, le VPP permet à l’utilisateur d’envoyer une commande à un groupe de contrôleurs.

Ajout de contrôleurs au VPP

Lors de l’ajout du signal MQTT SmartgridOne, un champ standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID} est affiché. Entrez ici l’ID VPP reçu.

Algorithme d’agrégation

Les consignes sont agrégées en fonction de la capacité des appareils relevant des contrôleurs individuels.

Thèmes MQTT

Une fois la configuration initiale terminée, un ID VPP et un Nom d’utilisateur MQTT (et mot de passe) seront fournis.

Thème entrant

Thème : vpp/{MQTT Username}/{VPP ID}/warning

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}

Ce thème est utilisé par l’utilisateur pour envoyer une commande agrégée au VPP.

VPP en direct

Corps :

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

Les politiques des composants et les consignes peuvent être trouvées ici : MQTT Components and Policies

VPP programmé

Corps :

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

Les politiques des composants et les consignes peuvent être trouvées ici : MQTT Components and Policies

Thème d’accusé de réception

Thème : standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}/warning

Après l’envoi d’une commande, le VPP répondra par un accusé de réception, indiquant si la commande a été reçue avec succès ou non.

Corps :

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

Thème de retour d’information

Thème : standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}/warning

Le thème de retour d’information contient les retours envoyés par les contrôleurs individuels.

Corps :

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

La structure de dictionnaire de retour peut être trouvée ici : MQTT Feedback Payload Structure

Thème de retour d’information agrégé

Thème : standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}/warning

Le VPP agrège les retours reçus par chaque contrôleur individuel.

Corps :

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

Le dictionnaire de retours agrégés est structuré de façon similaire à la MQTT Feedback Payload Structure. Cependant, les valeurs de type chaîne, telles que les stratégies exécutées, ne peuvent pas être agrégées et ne sont donc pas incluses.

Thème des commandes dispatchées

Thème : standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}/warning

Lorsque des commandes sont envoyées aux contrôleurs par le VPP, cela est rapporté via ce thème.

Corps :

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

La structure payload des commandes individuelles envoyées peut être trouvée ici : MQTT Feedback Payload Structure.

Thème d’avertissement

Thème : standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Thème (obsolète) : vpp/{MQTT Username}/{VPP ID}/warning

Si une erreur ou un avertissement survient dans le VPP, un message sera envoyé sur ce thème MQTT.

Corps :

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