Medidor de energia Wi-Fi IAMMETER: Guia de integração local e interface aberta

Medidor de energia Wi-Fi IAMMETER: Guia de integração local e interface aberta

Para desenvolvedores e integradores de sistemas que usam medidores IAMMETERsemIAMMETER-Nuvem.

Os medidores de energia Wi-Fi da IAMMETER são projetados para integrações locais e baseadas em nuvem, fornecendo APIs abertas (HTTP, MQTT, Modbus/TCP) que permitem aos desenvolvedores criar seus próprios Sistemas de Gerenciamento de Energia (EMS), Sistemas de Gerenciamento de Edifícios (BMS) ou plataformas de automação residencial inteligente.

O firmware do IAMMETER é atualizado continuamente. Este documento lista todos os recursos de integração local e aberta suportados pelo firmware mais recente.(Atualizado continuamente)

1) Atualização de firmware

Obtenha as últimas versões de firmware aqui:

• Página de lançamento de firmware (imeter.club): https://imeter.club/topic/11

2) Modos de execução (não nuvem)

Escolha um modo com base em como você integra ou usa o dispositivo.

Interface de usuário do firmware legado

Último firmwareInterface de usuário da Web

(O restante do seu documento continua inalterado em relação à sua versão mais recente.)

3) Integração TCP / TLS / MQTT

3.1 TCP e TLS

Os medidores podem enviar dados diretamente para seu ponto de extremidade TCP/TLS.

🔹 Nova configuração de firmware

O processo de configuração no firmware mais recente é semelhante ao das versões anteriores.

Modo de execução: TCP

Endereço:

• Para um servidor TCP — digite{domínio}:{porta}(por exemplo,abc.com:12345).
• Para um servidor TLS — usetls://{domínio}:{porta}(por exemplo,tls://abc.com:12345).

Intervalo de upload:O intervalo mínimo de upload é2 segundos.

🔹 Configuração de firmware legado

• Guia:Integração de servidores de terceiros (TCP/TLS)
• Vídeo:Carregar dados de energia para servidor de terceiros

3.2 MQTT

🔹 Nova configuração de firmware

Modo de execução: MQTT Endereço:Digite o IP ou domínio com a porta, por exemplo,192.168.11.163:1883 Nome de usuário / Senha:Credenciais do corretor MQTT (opcional se não for exigido pelo corretor)

Intervalo de upload:O intervalo mínimo é2 segundos. Descoberta HA MQTT: Habilitar descoberta MQTT no Home Assistant

🔹 Configuração de firmware legado

Publique telemetria em um broker MQTT local ou público.

• Guia:Guia de integração MQTT

4) Integração HTTP / HTTPS

🔹 Configuração de firmware legado

Os medidores podem postar dados diretamente no seu servidor personalizado.

• O formato de carga de dados é idêntico aos modos TCP/MQTT.
• Qualquer porta pode ser usada.
• Porta443habilita HTTPS automaticamente.
• Detalhes:Carregar via HTTP/HTTPS

🔹 Nova configuração de firmware

Endereço:O formato de entrada é o mesmo do firmware legado.

• Se nenhuma porta for especificada, a porta padrão será80.
• Somente porto443usa postagem HTTPS; todas as outras portas usam postagem HTTP.

5) API local (HTTP sobre LAN)

Acesse o medidor localmente por meio do IP da LAN — não é necessária conexão com a nuvem.

5.1 OBTER /api/monitorjson

Retorna dados de medição em tempo real.Campos:Tensão, corrente, potência ativa, kWh direto/reverso, frequência, fator de potência.

Exemplo:

{
"método": "uploadsn",
"mac": "B0F8933C4F94",
"versão": "i.75.97.9",
"servidor": "em",
"SN": "3E0BAF87",
"Dados": [
[220,0, 9,99, 2198, 11,337, 11,201, 49,99, 1,00],
[222,5, 9,99, 1100, 11,039, 10,908, 49,99, 0,50],
[263,5, 9,99, 1213, 10,975, 10,846, 49,99, 0,55]
]
}

📘 Extensão de Medição de Potência Reativa

5.2 OBTER /api/monitor

Versão avançada deMonitorjson, inclui informações sobre o sinal Wi-Fi:

• SSID(nome do AP conectado)
• assinatura(intensidade do sinal)

5.3 OBTER /api/wifidata

Retorna a configuração de Wi-Fi e rede.

{
"versão":"i.75.97.9", "SN":"3E0BAF87", "mac":"B0F8933C4F94",
"tipo":"PM", "ssid":"CMCC-laohe", "ip":"192.168.11.62",
"máscara de rede":"255.255.255.0", "gw":"192.168.11.253",
"dns":"114.114.114.114","dhcp":1","runMode":"tcp","intervalo de upload":60
}

5.4 OBTER /api/uploadinterval?x=<segundos>

Define o intervalo de upload (em segundos).

Funciona em modos não-nuvem (TCP/HTTP/MQTT).

NoÚltimo firmware, este parâmetro agora pode ser configurado diretamente doInterface WebUI, sem chamar a API manualmente.

5.5 OBTER /api/mqtt

Configura credenciais MQTT. 📘Documentação da API de configuração do MQTT

NoÚltimo firmware, este parâmetro agora pode ser configurado diretamente doInterface WebUI, sem chamar a API manualmente.

5.6 OBTER /api/netmetring

AlternaMedição de Energia Líquida (NEM)modo. 📘Habilitar modo NEM

NoÚltimo firmware, este parâmetro agora pode ser configurado diretamente doInterface WebUI, sem chamar a API manualmente.

5.7 OBTER /api/ctcratio

AjustaMultiplicador de fase Cpara cenários de fase dividida/balanceados.

• x=2duplica as leituras da Fase C (corrente, potência, kWh). 📘Explicação da relação CTC

NoÚltimo firmware, este parâmetro agora pode ser configurado diretamente doInterface WebUI, sem chamar a API manualmente.

5.8 OBTER /api/reativo

Habilita ou desabilitaPotência Reativa (Q)eEnergia Reativa (kVARh)medição. 📘Documentação de energia reativa

NoÚltimo firmware, este parâmetro agora pode ser configurado diretamente doInterface WebUI, sem chamar a API manualmente.

5.9 OBTER /api/ratio (disponível apenas para WEM3046T)

Desde oWEM3046Tusa TCs externas comSaídas secundárias 5A(por exemplo, 1000:5, 1500:5, 2000:5, etc.), os valores medidos (corrente, potência, energia) devem ser multiplicados pela relação TC.

Exemplo:

/api/razão?x=400

• Proporção definida: /api/proporção?x={ct_ratio}
• Proporção de consulta: /api/proporção

ApenasWEM3046Tsuporta TCs externos 5A — esta API é inválida para outros modelos.

6) Consistência do formato JSON

Todos os modos de comunicação —HTTP, TCP, MQTT, API local— use a mesma estrutura JSON. 📘Definição de dados JSON

7) Suporte Modbus/TCP

Os medidores IAMMETER suportam nativamenteModbus/TCP, permitindo integração direta comHome Assistant, PLCs, ouSCADAsistemas.

• Visão geral do Modbus/TCP
• Exemplo de Modbus do Home Assistant

8) Cenários de integração suportados

9) Recursos

• Lançamentos de firmware
• Tutoriais em vídeo
• Definição JSON
• Visão geral do Modbus/TCP
• Desenvolva Seu Próprio Sistema

10) Resumo do desenvolvedor

| Capacidade | Acesso | Notas | | --------------------- | ------------------- | ---------------------------------- | | Dados locais em tempo real | API local |/api/monitorjson, /api/monitor| | Upload de terceiros | TCP/TLS, HTTP/HTTPS | Mesmo esquema de payload | | Publicação MQTT | Corretor MQTT |/api/mqttpara definir credenciais | | Medição de rede | API local |/api/netmetring| | Potência/energia reativa | API local |/api/reativo| | Multiplicador de Fase C | API local |/api/ctcratio?x=1 | | Proporção CT (WEM3046T) | API local |/api/ratio?x=` | | Modbus/TCP | Cliente Modbus | Compatível com HA/PLC/SCADA |

Última atualização: 15 de outubro de 2025