APIs locais do firmware IAMMETER
IAMMETER oferece suporte a APIs HTTP locais. Consulte a documentação oficial para recursos de dispositivos reais. Este simulador implementa apenas o subconjunto listado abaixo.
Caminhos e sessões
Prefixe cada ponto final do medidor com /WEM3080, /WEM2067 ou /WEM3050T. As páginas e APIs do dispositivo suportam HTTP na porta 80, bem como HTTPS na porta 443. Os dispositivos físicos normalmente usam HTTP local.
As solicitações de medição públicas funcionam sem sessão e retornam a origem Inverter and grid padrão. As configurações privadas exigem o cookie meter-page existente. Uma solicitação curl separada não herda a fonte ou as configurações selecionadas do seu navegador.
HTTP e HTTPS usam sessões de navegador separadas. Abra a página do medidor usando o mesmo esquema antes de alterar as configurações. Leituras anônimas usam a origem Inverter and grid padrão.
Subconjunto de API de firmware compatível
| Método | Ponto final | Propósito | Modelos suportados |
|---|---|---|---|
| GET | /api/monitor | Leia tensão, corrente, potência e energia. | Todos os modelos |
| GET | /api/monitorjson · /monitorjson | Leia JSON legado, com dados reativos opcionais. | Todos os modelos |
| GET | /api/wifidata | Leia o Wi-Fi virtual e as configurações do dispositivo. | Todos os modelos |
| POST | /api/setwifiadv | Salve as configurações de Wi-Fi virtual para esta sessão e modelo. | Todos os modelos |
| GET | /api/getadv | Leia as configurações avançadas e de upload; a senha está vazia. | Todos os modelos |
| POST | /api/setadv | Salve as configurações de upload, sinalizadores Reactive e NEM. | Todos os modelos; NEM somente em WEM3050T |
Respostas de medição
WEM3080 retorna Data; WEM2067 e WEM3050T retornam Datas com uma linha por canal. A ordem dos campos é mostrada abaixo. Os exemplos são ilustrativos e não respostas ao vivo.
| Índice | Medição | Unidade |
|---|---|---|
| 0 | Tensão | V |
| 1 | Corrente | A |
| 2 | Potência ativa | W |
| 3 | Energia importada | kWh |
| 4 | Energia exportada | kWh |
| 5 | Frequência | Hz |
| 6 | Fator de potência | — |
Leia medições públicas
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Forma de resposta
{
"ssid": "IAMMETER-Simulator",
"sig": 100,
"mac": "020000003050",
"version": "simulator-1.0",
"server": "em",
"SN": "1AD9B537",
"model": "WEM3050T",
"Datas": [
[230.0,1.252,270.0,2.092,0.000,50.00,0.94],
[229.5,0.487,110.0,1.280,0.000,50.00,0.98],
[229.0,0.399,90.0,0.747,0.000,50.00,0.98]
]
}Configurações de Wi-Fi virtual
setwifiadv aceita ssid, pwd, dhcp (booleano), ip, máscara de rede, gw e dns. Esses valores alteram apenas o dispositivo virtual; eles não reconfiguram um adaptador de rede.
Exemplo de corpo de solicitação
{"ssid":"Test network","dhcp":true}Salvamento bem-sucedido
{"successful":1,"message":"ok"}Configurações avançadas
setadv aceita atualizações JSON parciais. Os campos não especificados mantêm seus valores atuais. O intervalo de upload é de 10 a 3.600 segundos.
Reactive adiciona EA.Reactive a monitorjson e carrega, não api/monitor. Cada linha é [var, kvarh indutivo, kvarh capacitivo].
NEM é compatível apenas com WEM3050T. Sua quarta linha Datas soma potência ativa, importa kWh e exporta kWh separadamente; todos os outros campos são zero.
| Parâmetro | Valores aceitos |
|---|---|
| runMode | 1 = TCP/TLS; 2 =HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone |
| uploadAddress | Endereço do destinatário; siga a dica de entrada Settings. |
| mqttUsername · mqttPassword | Credenciais do corretor; getadv nunca retorna a senha salva. |
| uploadInterval | 10–3600 segundos |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Somente texto armazenado; não altera a hora do servidor. |
| haDiscovery · ctcRatio | Apenas 0 e 1 respectivamente; recursos não são implementados. |
Habilite Reactive e NEM em WEM3050T
{"reactive":1,"netmetering":1}Verificando resultados
Um salvamento bem-sucedido retorna successful=1. Valores de configuração inválidos podem retornar HTTP 200 com successful=0; verifique o JSON e também o código de status. Sessões ausentes retornam 401; gravações de origem cruzada são rejeitadas.
Salvar as configurações de upload não prova a entrega. Verifique o status do upload de depuração e confirme as mensagens no seu receptor.
Não implementado
As funções abaixo são somente de exibição ou não são suportadas. Eles não fornecem APIs de gravação funcionais.
| Função | Comportamento atual |
|---|---|
| Verificação de Wi-Fi · reiniciar · redefinição de fábrica | Nenhuma operação real. |
| Segurança do dispositivo · atualização de firmware | Somente exibição. |
| Nuvem IAMMETER · Descoberta de HA · Downlink MQTT | Sem upload, descoberta ou configuração remota na nuvem. |
As ferramentas do simulador são documentadas separadamente
Os endpoints de depuração do simulador não são APIs de firmware IAMMETER. Eles estão excluídos da lista de APIs de firmware acima.