Plantas de Energía Virtuales

Conexión al Broker MQTT

Antes de continuar, asegúrese de que su red y dispositivos estén listos siguiendo la guía Configuración MQTT.

Funcionalidad VPP

El VPP está diseñado para recibir un punto de consigna/estrategia por grupo de dispositivos (ej. Solar, Almacenamiento), y agregar el punto de consigna entre los controladores conectados al VPP.

Mientras que el Protocolo Live MQTT enviaría un comando a un solo controlador, el VPP permite al usuario enviar un comando a un grupo de controladores.

Añadiendo Controladores al VPP

Al añadir la Señal MQTT SmartgridOne, se muestra un campo standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}. Ingrese el ID VPP recibido aquí.

Algoritmo de Agregación

Los puntos de consigna se agregan basándose en la capacidad de los dispositivos que dependen de los controladores individuales.

Temas MQTT

Una vez completada la configuración inicial, se proporcionará un ID VPP y un Nombre de Usuario MQTT (y contraseña).

Tema de Entrada

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}

Este tema es utilizado por el usuario para enviar un comando agregado al VPP.

VPP en Vivo

Cuerpo:

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

Las políticas y puntos de consigna de los componentes se encuentran aquí: Componentes y Políticas MQTT

VPP Programada

Cuerpo:

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

Las políticas y puntos de consigna de los componentes se encuentran aquí: Componentes y Políticas MQTT

Tema de Reconocimiento

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}/warning

Después de que se envía un comando, el VPP responderá con un reconocimiento, indicando si el comando fue recibido correctamente o no.

Cuerpo:

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

Tema de Retroalimentación

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}/warning

El Tema de Retroalimentación contiene la información devuelta por los controladores individuales.

Cuerpo:

{
    "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 estructura del diccionario de retroalimentación se encuentra aquí: Estructura Payload Retroalimentación MQTT

Tema de Retroalimentación Agregada

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}/warning

El VPP agrega la retroalimentación recibida por cada controlador individual.

Cuerpo:

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

El diccionario de retroalimentación agregada está estructurado de manera similar a la Estructura Payload Retroalimentación MQTT. Sin embargo, los valores de tipo cadena, como estrategias ejecutadas, no pueden agregarse, por lo que no están incluidos.

Tema de Comandos Despachados

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}/warning

Cuando se envían comandos a los controladores desde el VPP, esto se informa usando este tema.

Cuerpo:

{
    "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 estructura del payload de los comandos individuales enviados se encuentra aquí: Estructura Payload Retroalimentación MQTT.

Tema de Advertencias

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

Tema (obsoleto): vpp/{MQTT Username}/{VPP ID}/warning

Si ocurre un error o advertencia en el VPP, se enviará un mensaje a través de este tema MQTT.

Cuerpo:

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