Desenvolva Seu Próprio Sistema de Monitoramento de Energia com a IAMMETER

Desenvolva Seu Próprio Sistema de Monitoramento de Energia com a IAMMETER

Os medidores de energia Wi-Fi IAMMETER fornecem interfaces de dados abertas para desenvolvedores, integradores de sistemas e clientes que constroem seus próprios softwares de monitoramento de energia.

Você pode obter medições diretamente do medidor, permitir que o medidor envie dados para o seu servidor, implantar um serviço auto-hospedado IAMMETER ou construir uma aplicação sobre as APIs IAMMETER-Cloud.

Esta página é o guia de navegação do desenvolvedor para escolher uma arquitetura. Ela direciona para as definições de protocolo atuais e documentos de implementação, em vez de duplicar cada parâmetro de API.

Se sua primeira dúvida é se um medidor IAMMETER pode funcionar sem acesso à Internet ou ao IAMMETER-Cloud, comece com Usar um Medidor de Energia Wi-Fi Sem Internet ou Nuvem. Para uma comparação orientada a plataformas, veja Integração Auto-hospedada e Open-source.

1. Escolha Sua Arquitetura de Sistema

Existem quatro maneiras principais de usar os dados IAMMETER em sua própria aplicação.

Arquitetura	Fluxo de dados	Mais adequado para	IAMMETER-Cloud necessário?
Ler o medidor localmente	Aplicação → Medidor	Painéis LAN, automação, CLP e SCADA	Não
Deixar o medidor enviar dados	Medidor → Servidor ou broker do cliente	Nuvem personalizada, EMS, BMS e backends IoT	Não
Implantar software auto-hospedado IAMMETER	Medidor → IAMMETER-Docker ou IAMMETER-Central → Aplicação	Usuários que desejam armazenamento e APIs sem construir o backend completo	Não
Construir sobre APIs IAMMETER-Cloud	Medidor → IAMMETER-Cloud → Aplicação	Aplicações que desejam reutilizar dados e serviços do IAMMETER-Cloud	Sim

A escolha correta depende de onde os dados devem ser armazenados, se o projeto precisa operar independentemente da Internet, a taxa de atualização necessária e quanto desenvolvimento de backend você deseja manter.

2. Ler Dados Diretamente do Medidor

Escolha esta arquitetura quando a aplicação e o medidor estiverem na mesma rede local.

Medidor IAMMETER ← API HTTP Local ou Modbus TCP ← Sua aplicação

Sua aplicação controla o intervalo de polling e armazena qualquer histórico necessário. Nenhum serviço de nuvem IAMMETER é necessário para o caminho de dados local.

2.1 API HTTP Local

O medidor fornece endpoints HTTP locais para obter medições como tensão, corrente, potência ativa, energia importada e energia exportada.

Endpoints de medição comuns incluem:

• /api/monitorjson
• /api/monitor

O acesso à API HTTP local é um ponto de partida prático para:

• painéis personalizados;
• scripts executados em um PC, NAS ou Raspberry Pi;
• integrações low-code;
• aplicações locais que não exigem polling de um segundo.

Consulte o Guia de API Local e Interface Aberta IAMMETER para definições atuais de endpoints e exemplos.

2.2 Modbus TCP

Use Modbus TCP quando o projeto exigir:

• polling local de um segundo;
• integração com CLP ou SCADA;
• controle de energia em tempo real;
• integração com um EMS ou BMS industrial;
• um protocolo padrão baseado em registradores.

Consulte o Guia de Registradores Modbus TCP e Integração IAMMETER.

2.3 O Que Sua Aplicação Deve Fornecer

A leitura local direta retorna as medições do medidor. Sua aplicação continua responsável por quaisquer funções adicionais necessárias, incluindo:

• armazenamento de dados;
• agregação horária, diária e mensal;
• painéis e relatórios;
• usuários e permissões;
• alarmes e lógica de automação;
• backups e retenção.

Se você não deseja construir essas funções de backend desde o início, considere IAMMETER-Docker ou IAMMETER-Central.

3. Enviar Dados do Medidor Diretamente para Seu Servidor

Escolha esta arquitetura quando o medidor deve iniciar a conexão e enviar dados para um endpoint gerenciado por você.

Medidor IAMMETER → MQTT/MQTTS, HTTP/HTTPS ou TCP/TLS → Seu servidor

O firmware atual IAMMETER suporta várias interfaces de envio:

Interface	Componente do lado do cliente	Aplicação típica
MQTT / MQTTS	Broker MQTT e assinante	Plataformas IoT, automação e pipelines de mensagens
HTTP / HTTPS	Endpoint HTTP	Backend REST, serviço de nuvem ou EMS personalizado
TCP / TLS	Servidor TCP	Coletor personalizado e integração em nível de protocolo

O medidor e seu servidor usam uma estrutura JSON de medição IAMMETER consistente em todos os métodos de envio suportados. Revise a definição dos dados antes de implementar seu parser.

Recursos de implementação:

• Publicar Dados IAMMETER em Seu Broker MQTT
• Enviar Dados IAMMETER para um Servidor de Terceiros
• Definição JSON de Medição IAMMETER
• Firmware Atual, APIs Locais e Interfaces Abertas
• Informações sobre o Firmware IAMMETER e Atualizações

Um servidor na mesma LAN pode operar sem acesso à Internet. Um endpoint remoto ainda requer uma rota funcional através da Internet, uma WAN privada ou uma VPN.

4. Usar Software Auto-hospedado IAMMETER

A IAMMETER fornece duas opções auto-hospedadas para usuários que desejam implantação privada de dados sem implementar cada componente de backend por conta própria.

4.1 IAMMETER-Docker

IAMMETER-Docker é um sistema de monitoramento de energia auto-hospedado e open-source. Ele fornece coleta local de dados, funções básicas de monitoramento, gráficos e APIs.

É geralmente adequado para:

• indivíduos e desenvolvedores;
• implantações em Raspberry Pi, mini PC e NAS;
• monitoramento de energia residencial ou solar em uma rede privada;
• projetos que precisam de uma interface funcional além de APIs;
• usuários que desejam desenvolver uma UI personalizada sobre um backend pronto.

Continue com:

• Implantar IAMMETER-Docker
• Recursos Avançados do IAMMETER-Docker
• Modo Datalogger Offline

4.2 IAMMETER-Central

IAMMETER-Central é um middleware de dados auto-hospedado para usuários empresariais, instaladores e integradores de sistemas.

Ele foca em:

• registrar e gerenciar dispositivos IAMMETER;
• armazenar medições do medidor em um banco de dados controlado pelo cliente;
• fornecer APIs padronizadas para uma aplicação do cliente;
• separar a ingestão de dados do dispositivo do ERP, EMS, BMS ou front-end do cliente.

O IAMMETER-Central não tenta fornecer a lógica de negócios completa de uma aplicação de gerenciamento de energia. É útil quando o cliente deseja uma camada de middleware de dados mantida e construirá sua própria interface de usuário ou funções de negócios.

Consulte Opções de Auto-hospedagem IAMMETER para uma comparação entre IAMMETER-Docker, IAMMETER-Central, plataformas open-source e integração direta com servidor.

5. Construir sobre APIs IAMMETER-Cloud

Usar o IAMMETER-Cloud é outra maneira de desenvolver um painel ou aplicação personalizada. Nesta arquitetura, o medidor envia dados para o IAMMETER-Cloud e sua aplicação recupera os dados expostos pelas APIs IAMMETER-Cloud.

Medidor IAMMETER → IAMMETER-Cloud → API Cloud → Sua aplicação

Esta opção pode reduzir o desenvolvimento no lado do dispositivo e na ingestão de dados, mas não é uma arquitetura offline ou independente de nuvem.

É adequada quando:

• o medidor já reporta ao IAMMETER-Cloud;
• sua aplicação deseja reutilizar dados hospedados na nuvem;
• o acesso à Internet está disponível;
• manter o pipeline completo de dados dentro da rede local não é necessário.

Consulte a Documentação da API IAMMETER-Cloud para operações de API suportadas e requisitos de autenticação.

6. Integrar com uma Plataforma Open-source Existente

Antes de construir um sistema de monitoramento completo, verifique se uma plataforma existente já fornece as funções de armazenamento, painel e automação que você precisa.

O IAMMETER pode ser integrado com:

• Home Assistant
• Node-RED
• OpenHAB
• ioBroker
• Zabbix
• ThingsBoard

Estas páginas específicas de plataforma são os guias de implementação. Para uma comparação mais ampla, use a Visão Geral de Integração Auto-hospedada e Open-source.

7. Selecione o Melhor Ponto de Partida

Requisito do projeto	Ponto de partida recomendado
Script ou painel LAN simples	API HTTP Local
Dados locais de um segundo ou controle industrial	Modbus TCP
Infraestrutura MQTT existente	Envio MQTT ou MQTTS
Backend web existente	Envio HTTP ou HTTPS
Coletor socket personalizado	Envio TCP ou TLS
Monitoramento privado pronto para uso para um usuário individual	IAMMETER-Docker
Middleware empresarial para ERP, EMS ou BMS	IAMMETER-Central
Painel e automação para casa inteligente	Home Assistant
Aplicação construída sobre dados existentes do IAMMETER-Cloud	API IAMMETER-Cloud

8. Lista de Verificação de Desenvolvimento

Antes da implementação, confirme:

1. quais medições e fases o medidor selecionado fornece;
2. se os dados serão obtidos por polling ou enviados (push);
3. o intervalo de atualização necessário;
4. se o sistema deve operar durante uma interrupção de Internet;
5. onde os dados históricos serão armazenados;
6. se o transporte protegido por TLS é necessário;
7. como a aplicação autenticará usuários e dispositivos;
8. se o IAMMETER-Cloud deve permanecer parte da arquitetura;
9. a versão do firmware usada para validação;
10. como configuração, logs e dados serão submetidos a backup.

9. Documentação Relacionada

• Usar IAMMETER Sem Internet ou IAMMETER-Cloud
• APIs Locais e Interfaces Abertas IAMMETER
• Visão Geral de Integração Auto-hospedada e Open-source
• Enviar Dados para um Servidor de Terceiros
• Integração de Medidor de Energia MQTT
• Integração de Medidor de Energia Modbus TCP
• Opções de Auto-hospedagem IAMMETER

Última atualização: 16 de julho de 2026