Usinas Virtuais

Conectando ao Broker MQTT

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

Funcionalidade do VPP

O VPP é projetado para receber um setpoint/estratégia por grupo de dispositivos (ex. Solar, Armazenamento), e agregar o setpoint 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} é exibido. Insira o ID do VPP recebido aqui.

Algoritmo de Agregação

Os setpoints são agregados com base na capacidade dos dispositivos vinculados aos 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 (obsoleto): 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 em watts>
    }
}

As políticas e setpoints dos componentes podem ser encontrados aqui: Componentes e Políticas MQTT

VPP Agendado

Corpo:

{
    "msg_id": <Incremental message id>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix Timestamp>(int)",
    "message_type": "<Tipo de mensagem>(str)",
    "fields": {
        "<Component Policy>": "<Policy Type>",
        "<Component Power Setpoint>": <Setpoint em watts>
    }
}

As políticas e setpoints dos componentes podem ser encontrados aqui: Componentes e Políticas MQTT

Tópico de Confirmação

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

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

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

Corpo:

{
    "payload": {
        "fields": {
            "responseCode": <Código de Sucesso/Falha>(int),
            "ack": <Mensagem de Confirmação>(str)
        },
        "target": <ID do VPP>(str)
    },
    "message_type": <Tipo de Mensagem>(str)
}

Tópico de Feedback

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

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

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

Corpo:

{
    "payload": {
        "updated_on": <Timestamp Unix dos dados>(str)
        "feedback_dict": {
            <Dicionário de Feedback>(dict)
        },
        "target": <ID do Nó do Site>(str)
    },
    "message_type": <Tipo de Mensagem>(str)
}

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

Tópico de Feedback Agregado

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

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

O VPP agrega o feedback recebido de cada controlador individual.

Corpo:

{
    "payload": {
        "updated_on": <Timestamp Unix dos dados>(str)
        "feedback_dict": {
            <Dicionário de Feedback Agregado>(dict)
        },
    },
    "message_type": <Tipo de Mensagem>(str)
}

O dicionário de feedback agregado tem uma estrutura semelhante à Estrutura do Payload de Feedback MQTT. No entanto, valores em formato string, como estratégias executadas, não podem ser agregados, e portanto, não são incluídos.

Tópico de Comandos Despachados

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

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

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

Corpo:

{
    "payload": {
        "aggregated": {
            <Nome do Componente>(str): <Valor do Comando de Potência>(float)...
        },
        "dispatched_commands": [
            <Lista de comandos individuais enviados aos controladores>
        ],
    },
    "message_type": <Tipo de Mensagem>(str)
}

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

Tópico de Aviso

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

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

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

Corpo:

{
    "payload": {
        "fields": {
            <Dicionário de Campos>(dict)
        },
        "target": <ID do VPP>(str)
    },
    "message_type": <Tipo de Mensagem>(str)
}