Connexion au courtier MQTT

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

Fonctionnalité VPP

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

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

Ajouter des contrôleurs au VPP

Lors de l'ajout du signal MQTT SmartgridOne, un champ VPP ID est affiché. Entrez le VPP ID reçu ici.

Algorithme d'agrégation

Les points de consigne sont agrégés en fonction de la capacité des dispositifs relevant des contrôleurs individuels.

Sujets MQTT

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

Sujet entrant

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

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

VPP en direct

Corps :

{
    "msg_id": <Identifiant de message incrémental>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Timestamp Unix>(int)",
    "fields": {
        "<Politique de composant>": "<Type de politique>",
        "<Point de consigne de puissance de composant>": <Point de consigne en watts>
    }
}

Les politiques de composant et les points de consigne peuvent être trouvés ici : MQTT Components and Policies

VPP programmé

Corps :

{
    "msg_id": <Identifiant de message incrémental>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Timestamp Unix>(int)",
    "message_type": "<Type de message>(str)",
    "fields": {
        "<Politique de composant>": "<Type de politique>",
        "<Point de consigne de puissance de composant>": <Point de consigne en watts>
    }
}

Les politiques de composant et les points de consigne peuvent être trouvés ici : MQTT Components and Policies

Sujet d'accusé de réception

Sujet : vpp/{MQTT Username}/{VPP ID}/acknowledgement

Après qu'une commande a été envoyée, le VPP répondra avec un accusé de réception, indiquant si la commande a été reçue avec succès ou non.

Corps :

{
    "payload": {
        "fields": {
            "responseCode": <Code de succès/échec>(int),
            "ack": <Message d'accusé de réception>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type de message>(str)
}

Sujet de retour d'information

Sujet : vpp/{MQTT Username}/{VPP ID}/feedback

Le sujet de retour d'information contient le retour d'information renvoyé par les contrôleurs individuels.

Corps :

{
    "payload": {
        "updated_on": <Timestamp Unix des données>(str),
        "feedback_dict": {
            <Dictionnaire de retour d'information>(dict)
        },
        "target": <ID de nœud de site>(str)
    },
    "message_type": <Type de message>(str)
}

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

Sujet de retour d'information agrégé

Sujet : vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

Le VPP agrège le retour d'information reçu par chaque contrôleur individuel.

Corps :

{
    "payload": {
        "updated_on": <Timestamp Unix des données>(str),
        "feedback_dict": {
            <Dictionnaire de retour d'information agrégé>(dict)
        }
    },
    "message_type": <Type de message>(str)
}

Le dictionnaire de retour d'information agrégé est structuré de manière similaire à la MQTT Feedback Payload Structure. Cependant, les valeurs de chaîne, telles que les stratégies exécutées, ne peuvent pas être agrégées et ne sont donc pas incluses.

Sujet des commandes dispatchées

Sujet : vpp/{MQTT Username}/{VPP ID}/dispatched_commands

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

Corps :

{
    "payload": {
        "aggregated": {
            <Nom de composant>(str): <Valeur de commande de puissance>(float)...
        },
        "dispatched_commands": [
            <Liste des commandes individuelles envoyées aux contrôleurs>
        ]
    },
    "message_type": <Type de message>(str)
}

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

Sujet d'avertissement

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

Si une erreur ou un avertissement se produit dans le VPP, un message sera envoyé sur ce sujet MQTT.

Corps :

{
    "payload": {
        "fields": {
            <Dictionnaire de champ>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type de message>(str)
}