Conectando-se ao Broker MQTT

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

Funcionalidade do VPP

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

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

Adicionando Controladores ao VPP

Ao adicionar o Sinal MQTT SmartgridOne, um campo standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID} será exibido. Insira aqui o ID do VPP recebido.

Algoritmo de Agregação

Os pontos de ajuste são agregados com base na capacidade dos dispositivos sob os controladores individuais.

Tópicos MQTT

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

Tópico de Entrada

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

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

Este tópico é usado pelo usuário para enviar um comando agregado ao 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 pontos de ajuste dos componentes podem ser encontrados aqui: MQTT Components and Policies

VPP Agendado

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 pontos de ajuste dos componentes podem ser encontrados aqui: MQTT Components and Policies

Tópico de Confirmação

Tópico: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

Após o envio de um comando, 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: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

O Tópico de Feedback contém o retorno fornecido 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: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

O VPP agrega o feedback recebido por 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 tem estrutura similar à MQTT Feedback Payload Structure. No entanto, valores do tipo string, como estratégias executadas, não podem ser agregados e, portanto, não são incluídos.

Tópico de Comandos Enviados

Tópico: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

Quando comandos são enviados aos controladores pelo VPP, isso é reportado 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 Aviso

Tópico: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

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

Se ocorrer um erro ou aviso no VPP, uma mensagem será enviada através deste tópico MQTT.

Corpo:

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