Integração do Medidor de Energia com Home Assistant: MQTT, Modbus TCP e IAMMETER-Link

Integração do Medidor de Energia com Home Assistant: MQTT, Modbus TCP e IAMMETER-Link

Os medidores de energia IAMMETER podem ser integrados com Home Assistant através de HTTP local, Modbus TCP ou MQTT. O melhor método depende se você prefere uma integração oficial, configuração baseada em interface, atualizações locais rápidas, descoberta automática MQTT ou uso contínuo do IAMMETER Cloud.

Este guia compara os métodos disponíveis e direciona você para o guia de configuração apropriado. Ele cobre todos os medidores de energia IAMMETER atuais. O descontinuado WEM3162 não está incluído.

Qual integração do Home Assistant devo usar?

Method	Meter-side setup	Home Assistant setup	Typical update interval	Fully local	IAMMETER Cloud at the same time	Auto-discovery	Best for
Home Assistant Core	Keep the meter accessible on the LAN	Add the built-in IAMMETER integration in YAML	30 seconds	Yes	Yes	No	Users who prefer an official built-in integration
Home Assistant Modbus	Make Modbus TCP available on the LAN	Configure the built-in Modbus integration and sensors in YAML	Configurable; commonly 1–5 seconds	Yes	Yes	No	Fast monitoring and real-time automations
MQTT Manual	Configure the MQTT broker in the meter WebUI	Enable the MQTT integration and define sensors in YAML	Configurable; latest firmware supports down to 2 seconds	Yes, with a local broker	No	No	Users who need custom topics and sensors
HACS HTTP	Keep the meter accessible on the LAN	Install IAMMETER HTTP through HACS and configure it in the UI	60 seconds	Yes	Yes	SSDP-assisted	UI setup without YAML
HACS Modbus	Make Modbus TCP available on the LAN	Install IAMMETER Modbus through HACS and configure it in the UI	Configurable; default 3 seconds	Yes	Yes	SSDP-assisted	Fast local updates with UI configuration
MQTT Discovery	Configure the broker and enable HA MQTT Discovery in the meter WebUI	Enable the MQTT integration; sensors are created automatically	Configurable; latest firmware supports down to 2 seconds	Yes, with a local broker	No	Yes	The simplest MQTT setup

Recomendações rápidas:

• Escolha Home Assistant Core se quiser a integração oficial integrada e um intervalo de atualização de 30 segundos for suficiente.
• Escolha HACS HTTP se preferir configuração por interface e não precisar de atualizações rápidas.
• Escolha HACS Modbus se quiser configuração por interface com dados locais mais rápidos para painéis e automações.
• Escolha Home Assistant Modbus se estiver confortável com YAML e quiser controle total sobre registradores, sensores e intervalos de polling.
• Escolha MQTT Discovery se já usa MQTT e quiser que o Home Assistant crie o dispositivo e as entidades automaticamente.
• Escolha MQTT Manual se precisar de controle completo sobre tópicos MQTT, modelos e definições de entidades.

O MQTT Manual e o MQTT Discovery alteram o modo de envio do medidor para MQTT. Nestes modos, o medidor não envia medições simultaneamente para o IAMMETER Cloud. As integrações HTTP local e Modbus TCP podem continuar funcionando enquanto o medidor envia para o IAMMETER Cloud.

1. Integração oficial Home Assistant Core

A integração oficial IAMMETER está incluída no Home Assistant e lê a API HTTP local do medidor. Ela não requer HACS ou conexão com a internet entre o Home Assistant e o medidor.

Principais características:

• configurada em configuration.yaml;
• polling HTTP local a cada 30 segundos;
• pode ser usada em conjunto com o IAMMETER Cloud;
• entidades de energia importada e exportada incluem os metadados exigidos pelo Painel de Energia do Home Assistant;
• sem descoberta automática de dispositivos.

Use este método quando a estabilidade e o suporte oficial do Home Assistant forem mais importantes que taxas de atualização rápidas.

• Integração oficial IAMMETER no Home Assistant

2. Integração Home Assistant Modbus TCP

A integração Modbus integrada do Home Assistant lê os registradores Modbus TCP locais do medidor. É adequada para automações baseadas em potência, controle de excedente solar e outras aplicações que precisam de atualizações mais rápidas.

Principais características:

• configurada em YAML;
• scan_interval configurável, comumente de 1 a 5 segundos para automação em tempo real;
• completamente local e independente da internet;
• pode ser usada em conjunto com o IAMMETER Cloud;
• requer o endereço de registrador, tipo de dado, escala e metadados do Painel de Energia corretos.

Use um intervalo de polling maior quando dados em nível de segundos não forem necessários. Evite executar vários clientes Modbus de alta frequência contra o mesmo medidor.

• Guia do medidor de energia Modbus TCP para Home Assistant
• Mapa de registradores Modbus TCP IAMMETER

3. Integração HACS HTTP

A integração personalizada IAMMETER HTTP oferece uma alternativa baseada em interface à integração YAML oficial. Ela lê /monitorjson pela rede local e cria as entidades correspondentes no Home Assistant.

Principais características:

• instalada através do HACS;
• configurada através da interface Dispositivos e Serviços do Home Assistant;
• polling HTTP local a cada 60 segundos;
• SSDP pode auxiliar na descoberta de dispositivos;
• compatível com o IAMMETER Cloud e o Painel de Energia.

Use este método quando preferir configuração por interface e um intervalo de atualização de um minuto for suficiente.

• Integração IAMMETER HACS HTTP
• Guia de configuração HACS HTTP

4. Integração HACS Modbus

A integração personalizada IAMMETER Modbus combina o polling Modbus TCP local com a configuração por interface do Home Assistant. É a opção mais conveniente para usuários que precisam de atualizações mais rápidas mas não querem definir cada registrador em YAML.

Principais características:

• instalada através do HACS e configurada na interface;

• intervalo de varredura configurável, com padrão de 3 segundos na integração atualizada;

• operação local e compatibilidade com o IAMMETER Cloud;

• cria entidades de potência e energia importada/exportada com os metadados apropriados do Home Assistant;

• suporta todos os medidores IAMMETER atuais, com diferentes contagens de entidades para modelos monofásicos e trifásicos.

• Integração IAMMETER HACS Modbus

• Guia de configuração HACS Modbus

5. Integração MQTT Manual

No modo MQTT Manual, o medidor publica dados de medição no seu broker MQTT e você define os sensores correspondentes no Home Assistant.

A configuração do lado do medidor e a configuração do Home Assistant são separadas:

1. Configure o endereço do broker, porta, nome de usuário e senha na WebUI mais recente do medidor.
2. Ative a integração MQTT no Home Assistant.
3. Defina os sensores MQTT necessários e os modelos JSON em YAML.

Este método é útil quando várias aplicações precisam assinar as mesmas medições, ou quando você precisa de tópicos personalizados e definições de entidades.

• Configurar um medidor de energia IAMMETER com um servidor MQTT
• Configuração manual do medidor de energia MQTT para Home Assistant

6. Home Assistant MQTT Discovery

O MQTT Discovery é destinado a usuários que desejam o mínimo de configuração manual. Após configurar o broker e ativar o HA MQTT Discovery na WebUI do medidor, o Home Assistant cria automaticamente o dispositivo IAMMETER e suas entidades.

As entidades de energia importada e exportada geradas incluem:

• unit_of_measurement: kWh;
• device_class: energy;
• state_class: total_increasing.

Esses atributos fornecem os metadados necessários para uso no Painel de Energia do Home Assistant.

O MQTT Discovery é suportado por todos os medidores de energia IAMMETER atuais. Modelos monofásicos e trifásicos criam diferentes números de entidades de acordo com seus canais de medição.

• Configuração do Home Assistant MQTT Discovery
• Guia IAMMETER MQTT Discovery
• Atualizar para o firmware IAMMETER mais recente

Medidores de energia IAMMETER suportados

Todos os medidores de energia IAMMETER atuais suportam os métodos de integração descritos acima. A principal diferença no Home Assistant é o número de fases ou canais de medição e, portanto, o número de entidades criadas.

Model	Typical application	Home Assistant support	Important note
WEM3080	Single-phase energy monitoring	All methods	Single-phase entities
WEM2067	Single-phase home solar monitoring	All methods	Two measurement channels
WEM3080T	Three-phase energy monitoring	All methods	Three-phase entities
WEM3050T	Three-phase or split-phase home monitoring	All methods	Three measurement channels
WEM3080TD	Three-phase/three-wire and special wiring applications	All methods	Entity interpretation depends on wiring mode
WEM3046T / WEM3046TE	Three-phase metering with external 5 A CTs	All methods	Apply the external CT ratio to obtain primary-side values

Os WEM3046T e WEM3046TE medem a saída secundária de 5 A de transformadores de corrente externos. Aplicar a relação do TC é um requisito deste arranjo de medição, não uma limitação de compatibilidade com Home Assistant.

Usar entidades de energia IAMMETER no Painel de Energia

O Painel de Energia do Home Assistant precisa de entidades de energia importada e exportada acumuladas em kWh, normalmente com:

• device_class: energy;
• state_class: total_increasing.

As integrações atuais Core, HACS HTTP, HACS Modbus e MQTT Discovery fornecem os metadados necessários para suas entidades de energia importada/exportada. Com configuração Modbus manual ou MQTT Manual, você deve adicionar a unidade, classe de dispositivo e classe de estado corretas manualmente.

Não use uma entidade de potência instantânea em watts como substituta para uma entidade de energia acumulada em kWh.

Enviar dados de energia existentes do Home Assistant para o IAMMETER Cloud

Os métodos acima trazem dados do medidor IAMMETER para o Home Assistant. O IAMMETER-Link funciona na direção oposta: ele envia entidades de energia que já existem no Home Assistant para um Medidor Virtual IAMMETER e para o IAMMETER Cloud.

Isto é útil quando um inversor ou medidor de terceiros já possui uma integração com Home Assistant, mas você também quer painéis, relatórios ou acesso multi-site do IAMMETER Cloud.

O IAMMETER-Link atualmente oferece:

• configuração baseada em HACS e interface;

• mapeamento de medidor virtual monofásico e trifásico;

• intervalo de envio de 300 segundos com IAMMETER Basic;

• intervalo de envio de 60 segundos com IAMMETER Pro.

• Conectar dispositivos de energia do Home Assistant ao IAMMETER Cloud

• Repositório GitHub do IAMMETER-Link

Exemplos de monitoramento de energia com Home Assistant

Após a integração do medidor, seus dados de potência em tempo real e energia acumulada podem ser usados para:

• monitoramento de geração solar, consumo residencial e importação/exportação da rede;
• controle de relé em tempo real usando Modbus TCP;
• painéis do Home Assistant e Grafana;
• carregamento de VE com excedente solar;
• aquecimento de água com excedente solar.

Precisa de ajuda?

Se você tiver dúvidas sobre firmware, configuração de entidades, configuração do Painel de Energia ou escolha de um método de integração, visite o fórum da comunidade IAMMETER.