Driver MQTT Neargrid

A integração a seguir pode ser usada para enviar medições de sites via MQTT e receber comandos para os diferentes tipos de dispositivos instalados.

Script de demonstração em Python

Entre em contato com Eniris para solicitar um script de demonstração.

Pré-requisitos

Controlador em Nuvem

Os sites serão controlados via um Controlador em Nuvem. Por favor, entre em contato com Eniris para configurar um novo Controlador em Nuvem.

Configuração do Site

Uma vez que um Controlador em Nuvem tenha sido criado, ele conterá um número de série exclusivo (<Controller SN>).

Novos sites podem ser gerados no Controlador em Nuvem usando filtros de site exclusivos <site_filter>.

Essas duas variáveis devem ser usadas nos Tópicos e no Corpo do MQTT.

atenção

Usar filtros de site idênticos resultará em erros.

Seleção de Dispositivos

Device Type	Suportado
Inversores Solares	✅
Dispositivos de Armazenamento
Bombas de Calor
Medidores de Rede & Consumo
Carregadores de VE	❌

info

Os dispositivos em um site não podem ser editados após a criação.

Credenciais do MQTT

Eniris fornecerá as credenciais do MQTT. O nome de usuário do MQTT deve ser inserido ao gerar um novo site.

info

As credenciais devem ser fornecidas apenas uma vez. Um conjunto de credenciais do MQTT pode ser usado para controlar todos os sites.

Enviando medições

Para enviar medições para o SmartgridOne Controller, o seguinte tópico MQTT pode ser usado para publicação: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

Os campos opcionais são mencionados em itálico.

Os seguintes campos podem ser enviados por tipo de dispositivo:

• Armazenamento

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Solar

  • active_power_W
  • today_energy_Wh

• Bombas de Calor

  • operation_modes
    • Os modos de operação possíveis são desligado, ligado
  • active_power_W
    • Igual à potência nominal enquanto a bomba de calor está ligada

• Medidores

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

A mensagem deve ser estruturada da seguinte forma:

{
    "time": "<Timestamp Unix>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Potência Ativa da Rede em Watts>,
                "today_imported_energy_Wh": <Energia Importada da Rede em Watt-horas>,
                "today_exported_energy_Wh": <Energia Exportada da Rede em Watt-horas>,
            },
            "meter": {
                "active_power_W": <Potência Ativa do Medidor em Watts>,
                "today_imported_energy_Wh": <Energia Importada do Medidor em Watt-horas>,
                "today_exported_energy_Wh": <Energia Exportada do Medidor em Watt-horas>,
            },
            "storage": {
                "energy_stored_Wh": <Energia Armazenada em Watt-horas>,
                "mean_soc_perc": <Porcentagem Média do Estado de Carga>,
                "active_power_W": <Potência Ativa em Watts>,
                "today_charged_Wh": <Energia Carregada Hoje em Watt-horas>,
                "today_discharged_Wh": <Energia Descarregada Hoje em Watt-horas>,
            },
            "solar": {
                "active_power_W": <Potência Ativa Solar em Watts>,
                "today_energy_Wh": <Energia Produzida Hoje em Watt-horas>.
            },
            "heat_pump": {
                "active_power_W": <Potência Ativa da Bomba de Calor em Watts>,
                "operation_modes": <Modo de Operação da Bomba de Calor>
            }
        },
        "response_code": <Código de Resposta>
    },
    "fields": {},
    "requestTime": "<Timestamp Unix>",
    "time": "<Timestamp Unix>",
    "siteNodeId": "<site_filter"
}

Reconhecimento de Medição

Quando uma medição tiver sido recebida com sucesso, um reconhecimento será enviado no seguinte tópico: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Esse reconhecimento pode ser usado para:

1. Verificar se a mensagem de medição foi recebida com sucesso.
2. Verificar se a mensagem de medição continha todos os dados necessários.

Recebendo comandos

Para receber comandos do SmartgridOne Controller, inscreva-se no seguinte tópico MQTT: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

A resposta é estruturada da seguinte forma:

{
    "extraTags": {
        "nodeId": "<Controller SN>_site_0"
    },
    "time": "<Timestamp Unix>",
    "fields": {
        "solar_policy": "<policy>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<policy>",
        "storage_power_setpoint_w": -5000
    }
}

A lista de políticas que podem ser recebidas pode ser encontrada aqui: Lista de Políticas Potenciais