Plantas de Energía Virtuales

Conexión al Broker MQTT

Consulte la siguiente sección para saber cómo conectarse al Broker MQTT SmartgridOne: MQTT Broker Connection

Funcionalidad de VPP

El VPP está diseñado para recibir un setpoint/estrategia por grupo de dispositivos (e.g. Solar, Almacenamiento), y agregar el setpoint 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 aquí el ID de VPP recibido.

Algoritmo de Agregación

Los setpoints se agregan basándose en la capacidad de los dispositivos asignados a cada controlador individual.

Temas MQTT

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

Tema de Entrada

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

Tema (en desuso): 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 setpoints de los componentes pueden encontrarse aquí: MQTT Components and Policies

VPP Programado

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 setpoints de los componentes pueden encontrarse aquí: MQTT Components and Policies

Tema de Acuse de Recibo

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

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

Después de enviar un comando, el VPP responderá con un acuse de recibo, indicando si el comando fue recibido con éxito 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 (en desuso): 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 puede encontrarse aquí: MQTT Feedback Payload Structure

Tema de Retroalimentación Agregada

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

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

El VPP agrega la retroalimentación recibida de 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 forma similar al MQTT Feedback Payload Structure. Sin embargo, valores de tipo cadena, como estrategias ejecutadas, no pueden ser agregados, y por lo tanto no están incluidos.

Tema de Comandos Despachados

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

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

Cuando el VPP envía comandos a los controladores, 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 puede encontrarse aquí: MQTT Feedback Payload Structure.

Tema de Advertencias

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

Tema (en desuso): 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)
}