Saltar al contenido principal

Planta de Energía Virtual

tip

El protocolo VPP se basa en el protocolo Live MQTT. Por favor, consulta esta página antes de continuar. Ver Control de Live MQTT.

tip

La configuración inicial de VPP DEBE ser realizada por Eniris. Por favor, contacta a Eniris antes de seguir los siguientes pasos.

Conexión al Broker MQTT​

Por favor, consulta la siguiente sección para averiguar cómo conectarte al Broker MQTT de Eniris: Conexión al Broker MQTT

Funcionalidad de VPP​

El VPP está diseñado para recibir un punto de ajuste/estrategia por grupo de dispositivos (por ejemplo, Solar, Almacenamiento) y agregar el punto de ajuste 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.

Imagen 1

Agregando Controladores al VPP​

Imagen 1
Imagen 1
Imagen 1
Imagen 1

Al agregar la señal MQTT de Eniris, se muestra un campo VPP ID. Ingresa el VPP ID recibido aquí.

Ingresa VPP ID
Imagen 1

Algoritmo de Agregación​

Los puntos de ajuste se agregan en función de la capacidad de los dispositivos que caen bajo los controladores individuales.

Temas de MQTT​

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

Tema de Entrada​

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

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

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 de componente y los puntos de ajuste se pueden encontrar aquí: Componentes y Políticas MQTT

Tema de Reconocimiento​

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

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": <Código de Éxito/Fallo>(int),
            "ack": <Mensaje de Reconocimiento>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Tipo de Mensaje>(str)
}

Tema de Retroalimentación​

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

El Tema de Retroalimentación contiene la retroalimentació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": <Tipo de Mensaje>(str)
}

La estructura del diccionario de retroalimentación se puede encontrar aquí: Estructura de Carga Útil de Retroalimentación MQTT

Tema de Retroalimentación Agregada​

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

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": <Tipo de Mensaje>(str)
}

El diccionario de retroalimentación agregada está estructurado de manera similar a la Estructura de Carga Útil de Retroalimentación MQTT. Sin embargo, los valores de cadena, como las estrategias ejecutadas, no se pueden agregar y, por lo tanto, no están incluidos.

Tema de Comandos Despachados​

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

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

Cuerpo:

{
    "payload": {
        "aggregated": {
            <Nombre del Componente>(str): <Valor de CommandPower>(float)...
        },
        "dispatched_commands": [
            <Lista de comandos individuales enviados a los controladores>
        ],
    },
    "message_type": <Tipo de Mensaje>(str)
}

La estructura de carga útil de los comandos individuales enviados se puede encontrar aquí: Estructura de Carga Útil de Retroalimentación MQTT.

Tema de Advertencia​

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

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

Cuerpo:

{
    "payload": {
        "fields": {
            <Campo Diccionario>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Tipo de Mensaje>(str)
}