Centrales électriques virtuelles

Connexion au broker MQTT

Avant de continuer, assurez-vous que votre réseau et vos appareils sont prêts en suivant le guide Configuration MQTT.

Fonctionnalités du VPP

Le VPP est conçu pour recevoir un point de consigne/une stratégie par groupe d'appareils (p. ex. solaire, stockage) et agréger le point de consigne entre les contrôleurs connectés au VPP.

Alors que le protocole MQTT Live 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 VPP ID s'affiche. Saisissez ici l'ID VPP reçu.

Algorithme d'agrégation

Les points de consigne sont agrégés en fonction de la capacité des appareils dépendant de chaque contrôleur.

Topics MQTT

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

Topic entrant

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

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

Ce topic est utilisé par l'utilisateur pour envoyer une commande agrégée au VPP.

VPP Live

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 stratégies et points de consigne des composants sont disponibles ici : Composants et stratégies MQTT

VPP planifié

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 stratégies et points de consigne des composants sont disponibles ici : Composants et stratégies MQTT

Topic d'accusé de réception

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

Topic (obsolète) : vpp/{MQTT Username}/{VPP ID}/acknowledgement

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

Corps :

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

Topic de retour d'information

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

Topic (obsolète) : vpp/{MQTT Username}/{VPP ID}/feedback

Le topic de retour d'information contient les retours renvoyés par les différents contrôleurs.

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 du dictionnaire de retours est disponible ici : Structure de la charge utile de retour MQTT

Topic de retour d'information agrégé

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

Topic (obsolète) : vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

Le VPP agrège les retours reçus de 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 manière similaire à la structure de la charge utile de retour MQTT. 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.

Topic des commandes distribuées

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

Topic (obsolète) : vpp/{MQTT Username}/{VPP ID}/dispatched_commands

Lorsque des commandes sont envoyées aux contrôleurs par le VPP, cela est signalé via ce topic.

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 de la charge utile des commandes individuelles envoyées est disponible ici : Structure de la charge utile de retour MQTT.

Topic d'avertissement

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

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

Si une erreur ou un avertissement se produit dans le VPP, un message est envoyé via ce topic MQTT.

Corps :

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