Driver MQTT da Taylor

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 demo em Python

Entre em contato com Eniris para solicitar um script demo.

Pré-requisitos

Controlador em Nuvem

Os sites serão controlados através de 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 foi criado, ele conterá um número de série único (<Controller SN>).

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

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

atenção

Usar filtros de site idênticosresultará em erros.

Seleção de Dispositivos

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

info

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

Credenciais MQTT

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

info

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

Enviando medições

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

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 off, on
  • active_power_W
    • Igual à potência nominal enquanto a bomba de calor estiver on*

• Medidores

  • 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": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
            },
            "meter": {
                "active_power_W": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>,
            },
            "storage": {
                "energy_stored_Wh": <Energy Stored in Watt-hours>,
                "mean_soc_perc": <Mean State of Charge Percentage>,
                "active_power_W": <Active Power in Watts>,
                "today_charged_Wh": <Energy Charged on the Current Today in Watt-hours>,
                "today_discharged_Wh": <Energy Discharged on the Current Today in Watt-hours>,
            },
            "solar": {
                "active_power_W": <Solar Active Power in Watts>,
                "today_energy_Wh": <Energy Produced Today in Watt-hours>.
            },
            "heat_pump": {
                "active_power_W": <Heat Pump Active Power in Watts>,
                "operation_modes": <Heat Pump Operation Mode>
            }
        },
        "response_code": <Response Code>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Confirmação de medições

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

Essa confirmação pode ser usada 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/taylor_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 pode ser encontrada aqui: Lista de Políticas Potenciais