Neargrid MQTT Driver

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

Script de demonstração em Python

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

Pré-requisitos

Cloud Controller

Os sites serão controlados via um Cloud Controller. Por favor, entre em contato com Controller para configurar um novo Cloud Controller.

Configuração do Site

Depois que um Cloud Controller for criado, ele conterá um número de série único (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).

Novos sites podem ser gerados no Cloud Controller usando filtros de site únicos standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.

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

Seleção de Dispositivo

Credenciais MQTT

SmartgridOne fornecerá as credenciais MQTT. O nome de usuário MQTT deve ser informado ao gerar um novo site.

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>/

Campos opcionais são mencionados em itálico.

Os seguintes campos podem ser enviados por tipo de dispositivo:

• Storage

  • mean_soc_perc
  • active_power_W
  • today_charged_Wh
  • today_discharged_Wh
  • energy_stored_Wh

• Solar

  • active_power_W
  • today_energy_Wh

• Heat Pumps

  • operation_modes
    • Modos de operação possíveis são off, on
  • active_power_W
    • Equivale à potência nominal enquanto a bomba de calor está on*

• Meters

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

A mensagem deve ser estruturada da seguinte forma:

{
    "time": "<Unix Timestamp>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <Potência Ativa da Rede em Watts>,
                "today_imported_energy_Wh": <Energia Importada da Rede em Watt-hora>,
                "today_exported_energy_Wh": <Energia Exportada da Rede em Watt-hora>,
            },
            "meter": {
                "active_power_W": <Potência Ativa do Medidor em Watts>,
                "today_imported_energy_Wh": <Energia Importada do Medidor em Watt-hora>,
                "today_exported_energy_Wh": <Energia Exportada do Medidor em Watt-hora>,
            },
            "storage": {
                "energy_stored_Wh": <Energia Armazenada em Watt-hora>,
                "mean_soc_perc": <Média do Estado de Carga Percentual>,
                "active_power_W": <Potência Ativa em Watts>,
                "today_charged_Wh": <Energia Carregada no Dia Atual em Watt-hora>,
                "today_discharged_Wh": <Energia Descarrregada no Dia Atual em Watt-hora>,
            },
            "solar": {
                "active_power_W": <Potência Ativa Solar em Watts>,
                "today_energy_Wh": <Energia Produzida Hoje em Watt-hora>.
            },
            "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": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Confirmação de Medição

Quando uma medição for recebida com sucesso, uma confirmação será enviada no seguinte tópico: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Esta confirmação pode ser usada para:

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

Recebendo comandos

Para receber comandos do SmartgridOne Controller, assine o 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": "<Unix Timestamp>",
    "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 está aqui: List of Potential Policies