Usina Virtual

dica

O Protocolo VPP é baseado no Protocolo Live MQTT. Por favor, consulte esta página antes disso. Veja Controle Live MQTT.

dica

A configuração inicial do VPP DEVE ser feita por Eniris. Por favor, entre em contato com Eniris antes de seguir os próximos passos.

Conectando ao Broker MQTT

Por favor, consulte a seção a seguir para descobrir como se conectar ao Broker MQTT Eniris: Conexão do Broker MQTT

Funcionalidade do VPP

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

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

Adicionando Controladores ao VPP

Ao adicionar o Sinal MQTT Eniris, um campo VPP ID é exibido. Insira o VPP ID recebido aqui.

Algoritmo de Agregação

Os pontos de ajuste são agregados com base na capacidade dos dispositivos que se enquadram nos controladores individuais.

Tópicos MQTT

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

Tópico de Entrada

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

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

Corpo:

{
    "msg_id": <ID da mensagem incremental>(int),
    "vpp_id": <VPP ID>(str),
    "time": "<Timestamp Unix>(int)",
    "fields": {
        "<Política do Componente>": "<Tipo de Política>",
        "<Ponto de Ajuste de Potência do Componente>": <Ponto de Ajuste em watts>
    }
}

As políticas e pontos de ajuste dos componentes podem ser encontrados aqui: Componentes e Políticas MQTT

Tópico de Reconhecimento

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

Depois que um comando foi enviado, o VPP responderá com um reconhecimento, indicando se o comando foi recebido com sucesso ou não.

Corpo:

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

Tópico de Feedback

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

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: vpp/{MQTT Username}/{VPP ID}/aggregated_feedback

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 é estruturado de forma semelhante à Estrutura do Payload de Feedback MQTT. 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 Enviados

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

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

Corpo:

{
    "payload": {
        "aggregated": {
            <Nome do Componente>(str): <Valor de Potência do Comando>(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: vpp/{MQTT Username}/{VPP ID}/warning

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

Corpo:

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