Conectando ao Broker MQTT

Por favor, consulte a seção a seguir para descobrir como conectar-se ao Broker MQTT SmartgridOne: MQTT Broker Connection

Funcionalidade do VPP

O VPP é projetado para receber um setpoint/estratégia por grupo de dispositivos (por exemplo, Solar, Armazenamento) e agregar o setpoint entre os controladores conectados ao VPP.

Enquanto o Protocolo Live MQTT enviaria um comando para um único controlador, o VPP permite ao usuário enviar um comando para um grupo de controladores.

Adicionando Controladores ao VPP

Ao adicionar o Sinal MQTT SmartgridOne, um campo vpp/{MQTT Username}/{VPP ID}/warning é exibido. Insira aqui o ID do VPP recebido.

Algoritmo de Agregação

Os setpoints são agregados com base na capacidade dos dispositivos sob cada controlador individual.

Tópicos MQTT

Uma vez que a configuração inicial esteja completa, será fornecido um ID do VPP e um Nome de Usuário MQTT (e senha).

Tópico de Entrada

Tópico: vpp/{MQTT Username}/{VPP ID}

Este tópico é usado pelo usuário para enviar um comando agregado para o VPP.

VPP ao Vivo

Corpo:

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

As políticas e setpoints dos componentes podem ser encontradas aqui: MQTT Components and Policies

VPP Programado

Corpo:

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

As políticas e setpoints dos componentes podem ser encontradas aqui: MQTT Components and Policies

Tópico de Confirmação

Tópico: vpp/{MQTT Username}/{VPP ID}/warning

Após um comando ter sido enviado, o VPP responderá com uma confirmação, indicando se o comando foi recebido com sucesso ou não.

Corpo:

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

Tópico de Feedback

Tópico: vpp/{MQTT Username}/{VPP ID}/warning

O Tópico de Feedback contém o feedback retornado pelos controladores individuais.

Corpo:

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

A estrutura do dicionário de feedback pode ser encontrada aqui: MQTT Feedback Payload Structure

Tópico de Feedback Agregado

Tópico: vpp/{MQTT Username}/{VPP ID}/warning

O VPP agrega o feedback recebido de cada controlador individual.

Corpo:

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

O dicionário de feedback agregado é estruturado de forma semelhante à MQTT Feedback Payload Structure. No entanto, valores em string, como estratégias executadas, não podem ser agregados e, portanto, não estão incluídos.

Tópico de Comandos Despachados

Tópico: vpp/{MQTT Username}/{VPP ID}/warning

Quando comandos são enviados aos controladores pelo VPP, isso é comunicado usando este tópico.

Corpo:

{
    "payload": {
        "aggregated": {
            <Component Name>(str): <CommandPower Value>(float)...
        },
        "dispatched_commands": [
            <List of individual commands sent to the controllers>
        ],
    },
    "message_type": <Type of Message>(str)
}

A estrutura do payload dos comandos individuais enviados pode ser encontrada aqui: MQTT Feedback Payload Structure.

Tópico de Avisos

Tópico: vpp/{MQTT Username}/{VPP ID}/warning

Se ocorrer um erro ou aviso no VPP, uma mensagem será enviada por este tópico MQTT.

Corpo:

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