IAMMETER adiciona suporte a SunSpec Modbus/TCP: mapeamento de modelos e guia de integração

O firmware IAMMETER i.91.065.18 adiciona um mapa somente leitura de modelos inteiros de medidor SunSpec ao serviço Modbus/TCP já existente. Ele oferece aos softwares que entendem os modelos SunSpec uma forma padronizada de descobrir um medidor IAMMETER e ler valores elétricos selecionados pela rede local.

Esta é uma adição de interface, não um sistema de medição substituto. O medidor continua a coletar dados da mesma forma. Os registradores Modbus, a API HTTP, as cargas MQTT e as configurações NEM já existentes do IAMMETER permanecem inalterados.

O SunSpec define modelos padrão de informações de dispositivo que podem ser mapeados em registradores holding do Modbus. Seu mapa começa com um marcador SunS, seguido pelos modelos Common e específicos do dispositivo, que um cliente pode descobrir lendo o ID e o comprimento de cada modelo em sequência. O pacote de especificação SunSpec Modbus documenta o padrão de descoberta de modelos, incluindo as localizações do mapa Modbus com base 0 e as regras de valores não implementados. O SunSpec Modbus é usado em integrações de energia distribuída, incluindo medidores, inversores e equipamentos de armazenamento.

IAMMETER implementa um subconjunto focado e somente leitura para dados do medidor. Esta implementação não é certificada pela SunSpec. Não trate esse recurso como certificação, conformidade total com o SunSpec ou uma garantia de que todos os clientes SunSpec de terceiros funcionarão sem configuração.

Mapeamentos atuais do modelo de firmware

Estas linhas descrevem os mapeamentos atuais do modelo de firmware. A validação do dispositivo físico relatada aqui abrange apenas o WEM3080T; os outros modelos listados ainda exigem testes do dispositivo.

Para WEM2067, o Modelo 202 representa uma instalação genuína de fase dividida. Ele não descreve dois circuitos monofásicos não relacionados como o mesmo arranjo elétrico.

O código para o Modelo 204 tem cobertura de teste de host, mas o firmware ainda não o detecta e seleciona automaticamente para WEM3080TD. Este artigo, portanto, não reivindica a disponibilidade do Modelo 204. WEM3046TE também ainda não recebeu verificação de identificação de modelo dedicada. A primeira versão fornece apenas modelos inteiros: os modelos flutuantes 211 a 214 não estão disponíveis.

O que um cliente pode ler

Os modelos de medidores inteiros expõem tensão de fase, corrente de fase, potência ativa de fase, potência ativa total, frequência, fator de potência de fase e acumuladores de energia ativa de importação/exportação total e por fase. O Modelo Comum fornece dados de identificação do dispositivo, como modelo, versão de firmware e número de série.

A energia é representada em Wh no mapa SunSpec; o fator de potência é representado como uma porcentagem. Os pontos de energia total reutilizam os campos totais existentes do medidor e semântica NEM. O IAMMETER não recalcula um total trifásico adicionando os acumuladores de fase neste mapeamento. Como a configuração do NEM afeta o significado desses acumuladores, o cliente não deve assumir que a energia total é sempre igual à soma da energia da fase.

Alguns campos estão intencionalmente ausentes nesta primeira versão: potência reativa e energia reativa, potência aparente e energia aparente, fator de potência total multifásico e flags de eventos. Suas localizações padrão permanecem no modelo e retornam o marcador indisponível apropriado. Um cliente SunSpec deve reconhecer valores indisponíveis em vez de interpretá-los como medidas.

A interpretação da tensão importa

Os valores de fase vêm do medidor. Alguns pontos de tensão de linha são derivados para o mapeamento do modelo:

• A tensão de linha do Modelo 202 é UA + UB.
• A tensão de linha do Modelo 203 é uma aproximação da tensão de fase multiplicada por √3; não é uma medição direta entre fases. Um sistema desequilibrado ou um desvio de ângulo de fase pode gerar erro.

Essa distinção é importante para aplicações que precisam de uma tensão entre fases medida diretamente. Verifique a definição do ponto do modelo e o arranjo da conexão antes de usar um valor derivado para decisões de controle ou de conformidade.

Conecte-se com Modbus/TCP

Habilite o serviço Modbus/TCP existente do medidor e conecte-se ao seu endereço LAN:

Os endereços neste guia são endereços de solicitação Modbus baseados em 0. Algumas aplicações exibem números de registro baseados em 1, portanto verifique sua convenção antes de configurar uma leitura; um endereço off-by-one não retornará o marcador esperado.

Use o código de função 03 para cada leitura abaixo. As contagens de registros incluem o ID do modelo e o comprimento, quando aplicável.

Uma solicitação Modbus não pode ler mais que 125 registros, portanto leia os modelos Comum e medidor separadamente. Os clientes devem descobrir os IDs e comprimentos do modelo, em vez de codificar uma suposição sobre cada sequência futura do modelo.

Valores inteiros e fatores de escala

Os pontos inteiros SunSpec usam fatores de escala. Converta um inteiro bruto com:

valor real = inteiro do registrador × 10^fator de escala

Por exemplo:

W = 12345
W_SF = 1
potência ativa real = 123450 W

Os fatores de escala podem mudar conforme a faixa. Leia um modelo de medidor completo a cada ciclo de polling para que um valor e seu fator de escala venham da mesma resposta. Não faça cache dos fatores de escala indefinidamente.

Validação e limites atuais

A validação tem dois escopos separados:

• Validação de implementação: testes de host aprovados para layout de modelo, conversão, overflow, comportamento somente leitura e verificações de regressão para registros existentes. Um medidor de teste WEM3080T confirmou a descoberta do Modelo 203 e leituras contínuas, com tensão e potência verificadas em relação às interfaces HTTP e Modbus existentes. Outros modelos de medidores e clientes individuais de terceiros ainda precisam de mais testes físicos.
• Verificação do arquivo de lançamento: firmware i.91.065.18 foi construído, carregado e baixado novamente para verificação de arquivo. Este arquivo de lançamento exato não foi atualizado durante este ciclo de validação; os resultados de implementação acima não devem ser lidos como um teste de dispositivo do arquivo de lançamento baixado.

O firmware não inclui a melhoria de enquadramento TCP pendente. Atualmente espera uma solicitação completa em uma operação de recebimento. Solicitações TCP divididas ou combinadas podem encerrar a conexão. Envie uma solicitação e aguarde sua resposta antes da próxima, embora reconheça que isso não elimina todos os riscos de segmentação TCP.

Onde isso se encaixa em uma instalação IAMMETER

Para seleção de arquitetura, comece com Integração IAMMETER e soluções de auto-hospedagem. O guia de APIs locais e interface aberta compara as interfaces de medidores disponíveis.

Use o mapa SunSpec quando um cliente local for criado para descobrir e ler modelos de medidores SunSpec. Use o mapa de registro IAMMETER Modbus/TCP existente quando um aplicativo precisar de registros específicos do IAMMETER. O caminho Modbus local existente continua útil para integração do medidor de energia do Home Assistant, enquanto HTTP, MQTT e IAMMETER Cloud permanecem opções independentes.

Baixe o firmware: i.91.065.18.bin.

Antes de atualizar, siga as instruções de atualização do firmware IAMMETER e revise o modelo do seu medidor, método de conexão e acesso à rede local. Esta é uma interface de dados somente leitura; ele não fornece controle do inversor, operações de gravação ou reivindicação de interoperabilidade total do SunSpec com terceiros.

Compartilhe sua integração SunSpec

Você usou equipamento real para ler dados do medidor IAMMETER através do SunSpec? Junte-se à coleção de casos de integração IAMMETER SunSpec e compartilhe sua configuração com a comunidade. Os resultados baseados em simulador não são elegíveis.

Os participantes que fornecerem documentação detalhada de integração e publicá-la em um fórum público poderão receber 5.000–10.000 pontos de recompensa após a análise do IAMMETER. Abra a página de atividades e clique em Inscrever-se para participar.