APIs do WPC3700

Abreviação de termos WPC: Controlador de energia Wi-Fi

API do Controlador de Energia da Série WPC

Este artigo apresenta principalmente as APIs fornecidas pelos Controladores de Energia da Série WPC. Através destas APIs, os usuários podem realizar as seguintes operações:

• Configurar parâmetros do WPC
• Controlar a potência de saída do WPC

Quem Deve Ler Este Artigo

Esta seção está no início porque, embora tenhamos escrito este artigo, ele não é relevante para a maioria dos usuários do WPC.

Se você adquiriu um controlador de energia da série WPC, existem alguns modos de operação possíveis:

1. Você já instalou medidores IAMMETER no lado da rede e está usando diretamente o WPC3700 em conjunto com medidores IAMMETER (o WPC3700 opera em modo automático), permitindo que o WPC3700 funcione continuamente sob o impulso do excedente solar, que é a solução IAMMETER Sistema de Controle de Aquecimento PV.
2. Você não possui um medidor IAMMETER, mas está familiarizado com Home Assistant ou Node-RED e integrou o WPC3700 ao sistema de automação HA ou Node-RED (Ativar descoberta MQTT no Home Assistant com o firmware IAMMETER mais recente (i.76.058.8)).
3. Você precisa chamar a API para integrar o WPC3700 ao seu próprio sistema.

Apenas os usuários que precisam do terceiro modo de operação devem ler este artigo.

/api/setpower

/api/setpower?x=100

Introdução

Esta API controla a potência de saída do WPC.

Nota: Este parâmetro também pode ser modificado através da API setadv (chamada HTTP POST, parâmetro setPower).

Como o parâmetro setPower pode precisar ser modificado frequentemente com base nas leituras em tempo real da rede elétrica, esta interface adicional de API HTTP GET é fornecida.

URL e Método

URL: http://{{IP}}/api/setpower

Método: HTTP GET

/api/setadv

Introdução

Esta API é usada para definir os parâmetros do WPC.

Nota: Todos os parâmetros podem ser configurados diretamente através da IU. Apenas um pequeno número de clientes que precisam integrar produtos da série WPC em seus próprios sistemas utilizará esta API.

URL e Método

• URL: http://{{IP Local do WPC}}/api/setadv
• Método: HTTP POST

Parâmetros da Requisição

Abaixo está um exemplo dos parâmetros setadv.

Nota: Ao executar setadv, nem todos os parâmetros precisam ser enviados. Apenas os parâmetros que precisam ser modificados devem ser enviados. Parâmetros que não precisam de modificação não precisam ser enviados. Você pode primeiro usar getadv para ler a configuração atual e depois enviar apenas os parâmetros que precisam ser modificados.

{
  "maxPower": 3500,
  "setPower": 0,
  "restorePower": 0,
  "setPowerMode": 0,
  "meterAddress": "10.10.30.35",
  "threshold": 30,
  "hysteresis": 50,
  "startHour": 8,
  "stopHour": 18,
  "tzOffset": 8,
  "meterType": 0,
  "meterConfig": "3,2,1",
  "ntpServer": "ntp.aliyun.com",
  "haDiscovery": 1,
  "mqttEnabled": 1,
  "mqttAddress": "10.10.30.89:1883",
  "mqttUsername": "test",
  "mqttPassword": "123456",
  "uploadInterval": 6
}

Resposta

{
  "successful": 1,
  "message": "ok"
}

Descrição dos Parâmetros

/api/getadv

Introdução

Esta API lê todos os parâmetros do WPC (todos os parâmetros da API setadv podem ser lidos aqui).

URL e Método

• URL: http://{{IP Local do WPC}}/api/getadv
• Método: HTTP GET

Resposta

{
  "maxPower": 3500,
  "setPower": 0,
  "restorePower": 0,
  "setPowerMode": 0,
  "setPowerModeList": "Manual,Auto",
  "meterAddress": "10.10.30.35",
  "threshold": 20,
  "hysteresis": 30,
  "startHour": 8,
  "stopHour": 18,
  "tzOffset": 8,
  "meterType": 0,
  "meterConfig": "3,2,1",
  "meterList": "iMeter,virtualTCP",
  "ntpServer": "ntp.aliyun.com",
  "haDiscovery": 0,
  "mqttEnabled": 0,
  "mqttAddress": "192.168.1.22:1833",
  "mqttUsername": "test",
  "mqttPassword": "123456",
  "uploadInterval": 60
}

Consulte a descrição dos parâmetros em setadv.

/api/setwifiadv

Introdução

Esta API configura os parâmetros Wi-Fi para dispositivos WPC/WEM.

URL e Método

• URL: http://{{IP Local do WPC}}/api/setwifiadv
• Método: HTTP POST

Parâmetros da Requisição

{
    "ssid":"xxxx",
    "pwd":"xxxx",
    "ip":"xxxx",
    "netmask":"xxxxx",  
    "gw":"xxxx",
    "dns":"192.168.1.1",
    "dhcp":true,
    "runMode":"cloud", // cloud, tcp, http
    "uploadAddress":"http://myserver.com/upload" // Útil apenas se runMode não for cloud
}

Resposta

{
    "successful": true,
    "message": "ok"
}

Descrição dos Parâmetros

Documentação de Referência

Os recursos "ocultos" no firmware do medidor de energia Wi-Fi

Função avançada do IAMMETER

Bem-vindo a compartilhar sua opinião em nosso fórum. https://imeter.club

Sobre a IAMMETER

A IAMMETER é uma empresa focada em produtos e serviços de gestão de energia, oferecendo medidores de energia inteligentes, aplicativos de gestão e plataformas em nuvem.

Nosso objetivo é ajudar os clientes a gerenciar, utilizar e economizar energia de forma eficaz, reduzindo contas de eletricidade através de monitoramento e análise inteligentes.

Soluções

• Guia Rápido para as Soluções da IAMMETER
• Integrar IAMMETER com Outros Sistemas

Produtos

• Visão Geral dos Medidores de Energia IAMMETER
• WEM3080T – Medidor de Energia Wi-Fi Trifásico/Bifásico
• WEM3080 – Medidor de Energia Wi-Fi Monofásico
• WEM3050T – Medidor de Energia Trifásico
• WEM3046T – Medidor de Energia Wi-Fi Trifásico com Entrada CT Padrão de 5A

Sistema

• Serviço de Auto-Hospedagem